Farzoom Мультибанк
Документация API

Агентский API по банковским гарантиям

Входящий API для интеграции с агентами по выдаче банковских гарантий. Полный справочник эндпоинтов, схем данных и справочников по работе с заявкой через единый конвейер мультибанка.

Документ описывает методы запуска и сопровождения заявок на банковскую гарантию через интеграционный шлюз Farzoom. Заявка автоматически распределяется между банками-партнёрами; жизненный цикл и решения по каждому банку независимы.

Введение

Используемые типы запросов для работы с заявкой:

  • POST — старт заявки
  • PUT — любые изменения и ответы по заявке
  • GET — запрос статуса по заявке

Метод GET /masterOrder/{masterOrderId} позволяет получить консолидированный ответ о статусах заявки в разрезе банков одновременно. Для получения статуса заявки в конкретном банке используется метод GET /order/{orderId}. Для работы с заявкой в каждом из банков используется метод PUT /order/{orderId}.

Модель данных для методов POST и PUT идентичная. Отличие — для метода POST не требуется направлять decision.resultCode. При отправке новых данных старые данные будут перезаписаны.

Изменение данных ограничено стороной владельца заявки

Система не принимает изменения данных по заявке, если заявка находится на стороне банка или клиента. Изменение данных возможно только тогда, когда заявка находится на стороне агента — в этом случае в статусе заявки будут присутствовать decision.resultCode с описанием.

Базовый URL

Базовый URL интеграционного шлюза предоставляется куратором при подключении к партнёрской программе. В этой документации эндпоинты приведены как относительные пути от базового URL — например, POST {base-url}/order.

Авторизация

Для авторизации используется HTTP Basic Authentication. Логин и пароль (необходимо получить у своего куратора) передаются в заголовке запроса Authorization для совместимости со старым API банков.

HTTP Заголовки
POST /order HTTP/1.1
Host: {base-url}
Authorization: Basic <base64(login:password)>
Content-Type: application/json

Жизненный цикл заявки

После старта заявка проходит через несколько состояний. Заявки в разных банках в рамках одного запроса имеют независимый статус: при отказе по одной заявке статус других не изменяется.

Схема жизненного цикла заявки на банковскую гарантию в интеграционном шлюзе Farzoom
Маршрутизация по банкам-партнёрам, переходы между ролями (Агент / Банк / Клиент) и итоговые состояния.

Краткая схема перехода статусов:

POST /order InProcess PendingAgent PendingClient Executed
Поведение при выдаче гарантии

При выдаче одной из заявок в банке вместе со статусом приходит скан БГ и соответствующий статус Executed. При этом остальные заявки в рамках этого запроса переходят в статус RejectedByBank, работа с ними становится невозможна.

Запуск заявки

Отправьте запрос методом POST на /order. Тело запроса должно содержать необходимые для старта заявки данные (схема OrderRequest).

В случае успешного старта сервис вернёт 200 с идентификаторами и номерами заявок в банках (OrderResponse). Если валидация запроса не прошла, ответит 4XX.

Пример запроса (минимальный набор данных)

POST /order — application/json
{
  "principal": {
    "inn": "9721162149",
    "kpp": "773001001",
    "ogrn": "1227700208471",
    "fullName": "АКЦИОНЕРНОЕ ОБЩЕСТВО \"СТАРТ\""
  },
  "multiLotBankGuarantee": {
    "bankGuaranteeType": "participation",
    "purchaseNumber": "32514958721",
    "federalLaw": "223",
    "marketPlace": "ЭТП РТС-тендер",
    "tenderContractType": "state",
    "tenderType": "Аукцион в электронной форме, участниками которого могут быть только субъекты малого и среднего предпринимательства",
    "purchasePublishedDate": "2025-06-19",
    "startDate": "2025-06-19",
    "endDate": "2025-06-27",
    "requiredExecutionDate": "2025-06-19",
    "amount": 24242.35,
    "maxAmount": 242251.35,
    "finalAmount": 242251.35,
    "isSplittedByBeneficiaries": false,
    "url": "https://zakupki.gov.ru/epz/order/notice/notice223/common-info.html?noticeInfoId=18450681",
    "auctionType": "public",
    "isBigDeal": false,
    "isGuaranteeInBeneficiaryForm": false,
    "guaranteeReceivingWay": "bankOffice",
    "subject": "Поставка электроинструмента и ручного инструмента для нужд отряда ФПС ГПС – Амурский филиал ФГБУ «Управление ДП ФПС ГПС № 6»",
    "isSeparateLotProtocols": false,
    "lots": [
      {
        "lotNumber": "1",
        "lotSubject": "Поставка электроинструмента и ручного инструмента для нужд отряда ФПС ГПС – Амурский филиал ФГБУ «Управление ДП ФПС ГПС № 6»",
        "startAmount": 242251.35,
        "finalAmount": 242251.35,
        "ikzList": [
          ""
        ],
        "okpd": [
          {
            "name": "Инструменты ручные электрические",
            "code": "28.24.11.000"
          }
        ],
        "beneficiaries": [
          {
            "inn": "2722085818",
            "kpp": "272201001",
            "ogrn": "1092722003725",
            "fullName": "ФЕДЕРАЛЬНОЕ ГОСУДАРСТВЕННОЕ БЮДЖЕТНОЕ УЧРЕЖДЕНИЕ \"УПРАВЛЕНИЕ ДОГОВОРНЫХ ПОДРАЗДЕЛЕНИЙ ФЕДЕРАЛЬНОЙ ПРОТИВОПОЖАРНОЙ СЛУЖБЫ ГОСУДАРСТВЕННОЙ ПРОТИВОПОЖАРНОЙ СЛУЖБЫ № 6\"",
            "customerRegNum": "82722085818272201001",
            "deliveryPlace": "Амурская обл, Амурская область, г. Благовещенск, ул. Вокзальная, д. 61",
            "purchaseAmount": 242251.35,
            "amount": 24242.35,
            "legalAddress": "680000, ХАБАРОВСКИЙ КРАЙ, Г.О. ГОРОД ХАБАРОВСК, Г ХАБАРОВСК, УЛ ШЕВЧЕНКО, Д. 28",
            "actualAddress": "680000, ХАБАРОВСКИЙ КРАЙ, г.о. ГОРОД ХАБАРОВСК, Г. ХАБАРОВСК, УЛ ШЕВЧЕНКО, Д. 28",
            "phone": "9242172735",
            "email": "kanc@udp6.27.mchs.gov.ru",
            "contract": {
              "isConcluded": false
            }
          }
        ],
        "contractConditions": {
          "prepaymentExists": false,
          "isRequiredIndisputableDebiting": false,
          "isIncludedForfeit": false,
          "isRequiredSecurityForGuaranteePeriod": false
        }
      }
    ],
    "callbackUrl": "some_url"
  }
}

Пример успешного ответа

200 OK — application/json
{
  "orderId": "FzfFUAbJBHQOzPHIlmKWC",
  "orderNumber": "МБГ-1492",
  "bankOrders": [
    {
      "bankInn": "2539013067",
      "bankOrderId": "8EYEYxqZQ3y7u2DyMNs7e",
      "bankOrderNumber": "МБГ-1492@Примсоц",
      "status": "InProcess"
    },
    {
      "bankInn": "5902300072",
      "bankOrderId": "twD7tt8MuOuD06BDhqkQU",
      "bankOrderNumber": "МБГ-1492@УралФД",
      "status": "InProcess"
    },
    {
      "bankInn": "1653001805",
      "bankOrderId": "5BkEvzOAaHtmSyMRzCsrD",
      "bankOrderNumber": "МБГ-1492@АкБарс",
      "status": "InProcess"
    }
  ]
}

Запрос статуса

Отправьте запрос методом GET на /order/{orderId}. Ответ содержит комментарии валидации и возможные решения по заявке (StatusResponse). Заявки в разных банках в рамках одного запроса имеют независимый статус.

Справочник допустимых статусов заявки указан в разделе «Статусы заявки». Справочник допустимых taskDefinitionKey (детализированный статус) указан в разделе «TaskDefinitionKey».

Пример ответа

200 OK — application/json
{
  "orderId": "zhAyONl9OoNCpwWt5XRD7",
  "orderNumber": "МБГ-1491@АкБарс",
  "taskDefinitionKey": "AGENT_FILL_APPLICATION",
  "processDefinitionKey": "BG_AGENT_BANK",
  "comments": "Не удалось отправить заявку в банк: ИКЗ: Некорректный формат;",
  "decisionOptions": [
    {
      "code": "sendToBank",
      "text": "Отправить в банк",
      "isCommentRequired": false
    },
    {
      "code": "reject",
      "text": "Отказ",
      "isCommentRequired": false
    }
  ],
  "orderStatus": "PendingAgent"
}

Работа с заявкой

Для изменения данных по заявке используется метод PUT /order/{orderId}. Обязательно к отправке поле decision.resultCode (схема Decision).

Минимальный пример

PUT /order/{orderId} — application/json
{
  "decision": {
    "resultCode": "SEND_TO_BANK",
    "comment": "комментарий агента"
  }
}

Пример с обновлением документов

PUT /order/{orderId} — application/json
{
  "documents": [
    {
      "type": "customer_charter",
      "files": [
        {
          "fileName": "Устав.pdf",
          "fileId": "68d72j48gds62j4g66d3jjd"
        }
      ]
    }
  ],
  "decision": {
    "resultCode": "SEND_TO_BANK",
    "comment": "комментарий агента"
  }
}

Подписание документов

Подписание документов осуществляется только на странице подписания Системы. При запросе подписания документов банком в статус заявки придёт ссылка на страницу подписания. На этапе подписания управление заявкой ведётся со страницы подписания (подписано / не подписано / маршруты изменения этапа и параметров заявки).

Работа с файлами

Для загрузки файлов используется метод POST /file. В случае успешной загрузки сервис вернёт 200 и идентификатор файла (FileUploadInfo).

200 OK — application/json
{
  "fileId": "fds8fg73jd83h376d92j",
  "fileName": "test_doc.docx"
}

Для получения файлов используется метод GET /order/{orderId}/file/{fileId}. При успешном выполнении вернёт 200 и сам файл; если файл не найден — 404.

  • Размер файла ограничен 10 МБ. Количество файлов не ограничено.
  • Файлы загружаются в заявку в соответствующие доктайпы.
  • Если в свойствах доктайпа указано multiple: false, доктайп хранит только один файл. При отправке нового имеющийся будет перезаписан. При отправке нескольких файлов с multiple: false в доктайп будет сохранён только последний.

Коллбеки

При изменении статуса заявки Система направляет уведомление в виде HTTP-коллбека по указанному в запросе адресу — callbackUrl. Данные коллбека идентичны данным, получаемым при запросе статуса в один момент времени (StatusResponse).

Рекомендация

Принимающий обработчик коллбеков должен быть идемпотентным: при сетевых сбоях возможна повторная доставка одного и того же события. Используйте сочетание orderId + taskDefinitionKey + orderStatus как ключ дедупликации.

Эндпоинты

Полный справочник методов API. Все пути указаны относительно базового URL.

POST/order

Создать заявку во всех банках

Параметры
ИмяТипInОбязат.Описание
X-API-Login string header обязат.
X-API-Password string header обязат.
Тело запроса · application/json

Схема: OrderRequest

Ответы
КодОписаниеТело
400неверный запросstring
200запущено созданиеOrderResponse
401ошибка авторизацияErrorResponse

GET/order/{orderId}

Получить статус заявки в конкретном банке по orderId

Параметры
ИмяТипInОбязат.Описание
X-API-Login string header обязат.
X-API-Password string header обязат.
orderId string path обязат.
Ответы
КодОписаниеТело
400Bad Requestobject
200успешно полученStatusResponse
404заявка не найденаStatusResponse
401ошибка авторизацияStatusResponse

PUT/order/{orderId}

Обновить заявку в конкретном банке по orderId

Параметры
ИмяТипInОбязат.Описание
X-API-Login string header обязат.
X-API-Password string header обязат.
orderId string path обязат.
Тело запроса · application/json

Схема: OrderRequest

Ответы
КодОписаниеТело
400неверный запрос
200запущено обновление
404заявка не найдена
401ошибка авторизация

GET/masterOrder/{masterOrderId}

Информация о мастер-заявке

Параметры
ИмяТипInОбязат.Описание
X-API-Login string header обязат.
X-API-Password string header обязат.
masterOrderId string path обязат.
Ответы
КодОписаниеТело
400Bad Requestobject
200успешноOrderResponse
404мастер-заявка не найденаOrderResponse
401ошибка авторизацияOrderResponse

POST/file

Загрузить файл для последующей передачи

Параметры
ИмяТипInОбязат.Описание
X-API-Login string header обязат.
X-API-Password string header обязат.
Тело запроса · multipart/form-data
Ответы
КодОписаниеТело
400Bad Requestobject
200успешно загруженFileUploadInfo
401ошибка авторизацияFileUploadInfo

GET/order/{orderId}/file/{fileId}

Скачать файл по заявке

Параметры
ИмяТипInОбязат.Описание
X-API-Login string header обязат.
X-API-Password string header обязат.
orderId string path обязат.
fileId string path обязат.
Ответы
КодОписаниеТело
400Bad Requestobject
200успешно полученStreamingResponseBody
404заявка не найдена/файл не найденStreamingResponseBody
401ошибка авторизацияStreamingResponseBody

GET/banks

Получить список банков, доступных для подачи заявки

Параметры
ИмяТипInОбязат.Описание
X-API-Login string header обязат.
X-API-Password string header обязат.
Ответы
КодОписаниеТело
400Bad Requestobject
200список банковBankResponse[]
401ошибка авторизацииBankResponse[]

POST/banks/select

Подбор банков по параметрам БГ

Параметры
ИмяТипInОбязат.Описание
X-API-Login string header обязат.
X-API-Password string header обязат.
Тело запроса · application/json

Схема: BankSelectRequest

Ответы
КодОписаниеТело
400Bad Requestobject
200результат подбора банковBankSelectResponse[]
401ошибка авторизацииBankSelectResponse[]

Схемы данных

Все объекты модели, используемые в запросах и ответах API. Ссылки на дочерние схемы открываются как внутренние якоря.

Addressobject
СвойствоТипОбязат.Описание
addressType string опц. Тип адреса: * legal - Юридический * actual - Фактический * postal - Почтовый
legalactualpostal
address string опц. Адрес
addressOwnType string опц. Тип владения: * property - в собственности * rent - в аренде
propertyrent
Bankobject
СвойствоТипОбязат.Описание
name string опц. Название Банка
bik string опц. БИК. Формат: 9 цифр
corrNumber string опц. Корреспондентский счёт. Формат: 20 цифр
BankAccountobject
СвойствоТипОбязат.Описание
bank Bank опц. Банк
number string опц. Номер счета
cardFile2 boolean опц. Наличие картотеки № 2
cardFile2Amount number опц. Сумма задолженности (если имеется)
BankOrderobject
СвойствоТипОбязат.Описание
bankInn string опц. ИНН банка
bankOrderId string опц. ID заявки в банке
bankOrderNumber string опц. Номер заявки в банке
status string опц. Статус заявки в банке: * InProcess - в процессе * RejectedByBank - отказ * RejectedByAgent - клиент отказался от гарантии * Executed - гарантия предоставлена банком * PendingAgent - ожидает ответа от Агента * PendingClient - ожидает действий клиента * Failed - Процесс невозможно закончить
InProcessRejectedByBankRejectedByAgentPendingAgentPendingClientExecutedFailed
Пример: InProcess
BankResponseobject

Банк, доступный для подачи заявки

СвойствоТипОбязат.Описание
inn string опц. ИНН банка
name string опц. Наименование банка
BankSelectBeneficiaryobject

Бенефициар

СвойствоТипОбязат.Описание
inn string опц. ИНН бенефициара
BankSelectGuaranteeobject

Параметры гарантии

СвойствоТипОбязат.Описание
bgType string опц. Вид банковской гарантии: * participation - На участие в торгах * execution - На исполнение обязательств по контракту * returnAdvance - На возврат аванса * period - На обеспечение гарантийных обязательств
participationexecutionreturnAdvanceperiod
law string опц. Закон: * 44 - 44-ФЗ * 223 - 223-ФЗ * 185-615 - 185-ФЗ/615-ПП * commercial - Коммерческая закупка
44223185-615commercial
startDate string (date) опц. Дата начала банковской гарантии
endDate string (date) опц. Дата окончания банковской гарантии
amount number опц. Сумма гарантии
lots BankSelectLot[] опц. Информация о лотах
BankSelectLotobject

Лот

СвойствоТипОбязат.Описание
beneficiaries BankSelectBeneficiary[] опц. Бенефициары
okpd BankSelectOkpd[] опц. Коды ОКПД
BankSelectOkpdobject

ОКПД

СвойствоТипОбязат.Описание
code string опц. Код ОКПД
BankSelectPrincipalobject

Принципал

СвойствоТипОбязат.Описание
inn string опц. ИНН принципала
BankSelectRequestobject

Запрос на подбор банков

СвойствоТипОбязат.Описание
principal BankSelectPrincipal опц. Данные принципала
guarantee BankSelectGuarantee опц. Данные о гарантии
BankSelectResponseobject

Результат подбора банка

СвойствоТипОбязат.Описание
inn string опц. ИНН банка
name string опц. Наименование банка
available boolean опц. Доступен ли банк для подачи заявки
terms Terms опц. Детали проверки по параметрам
Beneficiaryobject
СвойствоТипОбязат.Описание
inn string опц. ИНН
kpp string опц. КПП
ogrn string опц. ОГРН
fullName string опц. Наименование
customerRegNum string опц. Уникальный учетный номер бенефициара на zakupki.gov.ru
deliveryPlace string опц. Место доставки
purchaseAmount number опц. Сумма закупки по бенефициару
amount number опц. Сумма гарантии по бенефициару
legalAddress string опц. Юр. адрес бенефициара
actualAddress string опц. Факт. адрес бенефициара
phone string опц. Номер телефона бенефициара
email string опц. Email бенефициара
contract BeneficiaryContract опц. Информация о контракте принципала с бенефициаром
BeneficiaryContractobject
СвойствоТипОбязат.Описание
isConcluded boolean опц. Контракт заключен
contractAmount number опц. Сумма контракта
contractNumber string опц. № контракта
regNumber string опц. Реестровый № контракта
contractDate string (date) опц. Дата контракта
BeneficiaryOwnerobject
СвойствоТипОбязат.Описание
inn string опц. ИНН
lastName string опц. Фамилия
firstName string опц. Имя
secondName string опц. Отчество
identityDocument IdentityDocument опц. Паспортные данные
birthDate string (date) опц. Дата рождения
birthPlace string опц. Место рождения
registrationAddress string опц. Адрес регистрации
actualAddress string опц. Фактический адрес
contacts ContactData[] опц. Контактные данные (телефон, email)
personAttributes PersonAttributes опц. Доп. информация о ФЛ
sharePercent number (double) опц. Доля, %
shareSum number опц. Доля, руб
beneficiaryReason string опц. Основания наличия статуса: * controlOfActions - Возможность контролировать действия Клиента, * directCapitalParticipation - Прямое участие в капитале Клиента, * indirectCapitalParticipation - Косвенное участие в капитале Клиента, * companyHead - Единоличный исполнительный орган юридического лица
directCapitalParticipationindirectCapitalParticipationcompanyHeadcontrolOfActions
Companyobject
СвойствоТипОбязат.Описание
inn string опц. ИНН
kpp string опц. КПП
ogrn string опц. ОГРН
fullName string опц. Наименование
CompanyHeadobject
СвойствоТипОбязат.Описание
inn string опц. ИНН
lastName string опц. Фамилия
firstName string опц. Имя
secondName string опц. Отчество
identityDocument IdentityDocument опц. Паспортные данные
birthDate string (date) опц. Дата рождения
birthPlace string опц. Место рождения
registrationAddress string опц. Адрес регистрации
actualAddress string опц. Фактический адрес
contacts ContactData[] опц. Контактные данные (телефон, email)
personAttributes PersonAttributes опц. Доп. информация о ФЛ
position string опц. Должность: * director - Директор, * ceo - Генеральный директор, * actingCeo - ВРИО Генерального директора, * president - Президент, * other - значение из поля otherPosition
directorceoactingCeopresidentother
otherPosition string опц. Иная должность. Обязательно, если в поле position указано other
relationAttributes RelationAttributes опц. Доп. информация о сотруднике
authorizingDoc string опц. Основание полномочий
eioProtocolDate string (date) опц. Дата протокола о назначении ЕИО
eioProtocolNumber string опц. Номер протокола о назначении ЕИО
CompanyManagementobject
СвойствоТипОбязат.Описание
supremeGoverningBody string опц. Высший орган управления
Единственный участникОбщее собрание участников (несколько участников)Общее собрание акционеров (несколько акционеров)Единственный акционер (один акционер с долей 100%)
soleExecutiveBody string опц. Единоличный исполнительный орган. companyHead - руководитель, managementCompany - управляющая компания
companyHeadmanagementCompany
managementCompany Company опц. Управляющая компания
hasSupervisoryBoard boolean опц. Наличие наблюдательного совета (совета директоров)
supervisoryBoardName string опц. Наименование наблюдательного совета
supervisoryBoardMember PersonData[] опц. Члены наблюдательного совета
hasCollegialExecutiveBody boolean опц. Наличие коллегиального исполнительного органа
collegialExecutiveBodyName string опц. Наименование коллегиального исполнительного органа (Правление, Дирекция и т.д.)
collegialExecutiveBodyMember PersonData[] опц. Члены коллегиального исполнительного органа
ContactDataobject
СвойствоТипОбязат.Описание
email string опц. E-mail
phone string опц. Телефон
ContactPersonobject
СвойствоТипОбязат.Описание
lastName string опц. Фамилия
firstName string опц. Имя
secondName string опц. Отчество
workPhone string опц. Телефон рабочий
email string опц. E-mail
ContentDispositionobject
СвойствоТипОбязат.Описание
type string опц.
name string опц.
filename string опц.
charset string опц.
size integer (int64) опц.
creationDate string (date-time) опц.
modificationDate string (date-time) опц.
readDate string (date-time) опц.
inline boolean опц.
attachment boolean опц.
formData boolean опц.
ContractConditionsobject
СвойствоТипОбязат.Описание
prepaymentExists boolean опц. Контрактом предусмотрен аванс
prepaymentAmount number опц. Сумма аванса (если предусмотрен)
isRequiredIndisputableDebiting boolean опц. Контрактом предусмотрено бесспорное списание
isIncludedForfeit boolean опц. Контрактом предусмотрены неустойки
isRequiredSecurityForGuaranteePeriod boolean опц. Контракт содержи требование об обеспечении гарантийного периода
securityForGuaranteePeriodDays integer (int32) опц. Срок гарантийного периода в днях (если предусмотрен)
Decisionobject
СвойствоТипОбязат.Описание
resultCode string опц. Код решения агента
comment string опц. Комментарий агента
DefaultHttpStatusCodeobject
Documentobject
СвойствоТипОбязат.Описание
type string опц. Тип документа: * customer_charter - Устав юридического лица * customer_eioAuthorizingDoc - Решение и/или приказ о назначении на должность ЕИО (директора, ген.директора, президента компании и пр.) * customer_passports - Паспорт ЕИО * customer_passportsMember - Паспорта учредителей и бенефициарных владельцев * customer_passportsSigner - Паспорт представителя (лица, действующего по доверенности) * customer_finReport - Бухгалтерская отчётность (годовая) * customer_finReportQ - Бухгалтерская отчётность (последний квартал) * customer_signerConfirmingDoc - Доверенность / Документ, подтверждающий право подписи * customer_nonResidentDoc - Документ, подтверждающий право иностранного гражданина или лица без гражданства на пребывание (проживание) в РФ * customer_taxForm - Налоговая декларация за отчетный период с отметкой о принятии или заверенная ЭЦП налоговым органом или копией почтовой квитанции * customer_ledgerYear - Для Клиентов находящихся на УСН/ЕНВД - Книга доходов и расходов за последний завершенный год * customer_shareholdersExcerpt - Выписка из реестра акционеров * customer_premisesConfirmingDoc - Документ, подтверждающий право собственности или аренды помещения * customer_contractRegistry - Реестр исполненных контрактов * customer_orderCard51 - Карточка 51 счета за 6 полных календарных месяцев, предшествующих текущей дате (не отчетной) * customer_osv58 - ОСВ по 58 счету за прошедшие 12 месяцев от последней отчетной даты в разрезе субсчетов контрагентов с указанием ИНН/доходов или расходов (если применимо) и субсчетов * customer_osv60 - ОСВ по 60 счету за прошедшие 12 месяцев от последней отчетной даты в разрезе субсчетов контрагентов с указанием ИНН/доходов или расходов (если применимо) и субсчетов * customer_osv62 - ОСВ по 62 счету за прошедшие 12 месяцев от последней отчетной даты в разрезе субсчетов контрагентов с указанием ИНН/доходов или расходов (если применимо) и субсчетов * customer_osv66 - ОСВ по 66 счету за прошедшие 12 месяцев от последней отчетной даты в разрезе субсчетов контрагентов с указанием ИНН/доходов или расходов (если применимо) и субсчетов * customer_osv67 - ОСВ по 67 счету за прошедшие 12 месяцев от последней отчетной даты в разрезе субсчетов контрагентов с указанием ИНН/доходов или расходов (если применимо) и субсчетов * customer_osv76 - ОСВ по 76 счету за прошедшие 12 месяцев от последней отчетной даты в разрезе субсчетов контрагентов с указанием ИНН/доходов или расходов (если применимо) и субсчетов * customer_osv91 - ОСВ по 91 счету за прошедшие 12 месяцев от последней отчетной даты в разрезе субсчетов контрагентов с указанием ИНН/доходов или расходов (если применимо) и субсчетов * customer_osvCommon - Общая ОСВ по счетам и субсчетам с указанием наименования субсчетов за прошедшие 12 месяцев от последней отчетной даты * customer_otherDocs - Прочие документы клиента * bg_bill - Счет на оплату вознаграждения за выдачу банковской гарантии * bg_contract - Гарантийный договор * bg_guaranteeDraft - Макет БГ * bg_guaranteeDraftPaid - Платный макет БГ * bank_principalForm - Анкета клиента по форме банка * bg_finReportGenerated - Бухотчетность. Сгенерированный xlsx на основании данных БО, отправленных в анкете * bg_persDataConsent - Согласие на обработку персональных данных * bg_application - Заявка на банковскую гарантию * bg_edoRequest - Заявление о присоединении * bg_woAppLot - Справка об отсутствии необходимости одобрения сделки * bg_rulesAgreement - Заявление о присоединении к правилам предоставления продукта * bg_agentRelationAgreement - Согласие на работу с агентом * bg_declarationBenOwner - Декларация бенефициарного владельца * bg_limitRequest - Заявление на установление лимита * bg_account51analysis - Анализ 51 счета в разрезе банков * bg_passports - Верифицированные банком паспорта ЕИО, подписанта, бенефициарных владельцев * bg_finReport - Верифицированная банком бухгалтерская отчётность (годовая) * bg_finReportQ - Верифицированная банком бухгалтерская отчётность (последний квартал) * otherOrderDocs - Прочие документы по заявке
customer_chartercustomer_eioAuthorizingDoccustomer_passportscustomer_passportsMembercustomer_passportsSignercustomer_finReportcustomer_finReportQcustomer_signerConfirmingDoccustomer_nonResidentDoccustomer_taxFormcustomer_ledgerYearcustomer_shareholdersExcerptcustomer_premisesConfirmingDoccustomer_contractRegistrycustomer_orderCard51customer_osv58customer_osv60customer_osv62customer_osv66customer_osv67customer_osv76customer_osv91customer_osvCommoncustomer_otherDocsbg_billbg_contractbg_guaranteeDraftbg_guaranteeDraftPaidbank_principalFormbg_finReportGeneratedbg_persDataConsentbg_applicationbg_edoRequestbg_woAppLotbg_rulesAgreementbg_agentRelationAgreementbg_declarationBenOwnerbg_limitRequestbg_account51analysisbg_passportsbg_finReportbg_finReportQotherOrderDocs
files File[] опц. Список файлов по документу
DocumentResponseobject
СвойствоТипОбязат.Описание
group string опц. Группа документа
type string опц. Тип документа: * bg_guaranteeScan - Скан выданной гарантии * bg_guidance - Памятка для получения оригинала банковской гарантии * bg_eisExtract - Выписка из реестра ЕИС * bg_acceptanceAct - Акт приема-передачи банковской гарантии * bg_bill - Счет на оплату вознаграждения за выдачу банковской гарантии * bg_contract - Гарантийный договор * bg_guaranteeDraft - Макет БГ * bg_guaranteeDraftPaid - Платный макет БГ
otherOrderDocsbg_guaranteeScanbg_guidancebg_eisExtractbg_acceptanceActbg_billbg_contractbg_guaranteeDraftbg_guaranteeDraftPaid
comment string опц. Комментарий к документу
extra Extra опц. Дополнительные параметры
files File[] опц. Список файлов
ErrorResponseobject
СвойствоТипОбязат.Описание
typeMessageCode string опц.
detailMessageArguments object[] опц.
detailMessageCode string опц.
titleMessageCode string опц.
statusCode object опц.
body ProblemDetail опц.
headers Map<string, string[]> опц.
Extraobject
СвойствоТипОбязат.Описание
Надбавка за риск number опц.
Fileobject
СвойствоТипОбязат.Описание
fileName string опц. Наименование файла
fileId string опц. Предпочтительный вариант: ID файла, предварительно загруженного через метод POST /file
value string (byte) опц. Альтернативный вариант: Содержимое документа в формате BASE64 (в этом случае fileId заполнять не нужно)
FileUploadInfoobject
СвойствоТипОбязат.Описание
fileId string опц. ID файла для последующего использования в методах создания/обновления заявки
fileName string опц. Наименование файла
FinReportobject
СвойствоТипОбязат.Описание
b1110 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Нематериальные активы
b1120 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Результаты исследований и разработок
b1130 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Нематериальные поисковые активы
b1140 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Материальные поисковые активы
b1150 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Основные средства
b1160 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Доходные вложения в материальные ценности
b1170 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Финансовые вложения
b1180 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Отложенные налоговые активы
b1190 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Прочие внеоборотные активы
b1100 number опц. ВНЕОБОРОТНЫЕ АКТИВЫ. Итого по разделу I
b1210 number опц. ОБОРОТНЫЕ АКТИВЫ. Запасы
b1220 number опц. ОБОРОТНЫЕ АКТИВЫ. Налог на добавленную стоимость по приобретенным ценностям
b1230 number опц. ОБОРОТНЫЕ АКТИВЫ. Дебиторская задолженность
b1240 number опц. ОБОРОТНЫЕ АКТИВЫ. Финансовые вложения (за исключением денежных эквивалентов)
b1250 number опц. ОБОРОТНЫЕ АКТИВЫ. Денежные средства и денежные эквиваленты
b1260 number опц. ОБОРОТНЫЕ АКТИВЫ. Прочие оборотные активы
b1200 number опц. ОБОРОТНЫЕ АКТИВЫ. Итого по разделу II
b1600 number опц. БАЛАНС
b1310 number опц. КАПИТАЛ И РЕЗЕРВЫ. Уставный капитал (складочный капитал, уставный фонд, вклады товарищей)
b1320 number опц. КАПИТАЛ И РЕЗЕРВЫ. Собственные акции, выкупленные у акционеров
b1340 number опц. КАПИТАЛ И РЕЗЕРВЫ. Переоценка внеоборотных активов
b1350 number опц. КАПИТАЛ И РЕЗЕРВЫ. Добавочный капитал (без переоценки)
b1360 number опц. КАПИТАЛ И РЕЗЕРВЫ. Резервный капитал
b1370 number опц. КАПИТАЛ И РЕЗЕРВЫ. Нераспределенная прибыль (непокрытый убыток)
b1300 number опц. ИТОГО по разделу III
b1410 number опц. ДОЛГОСРОЧНЫЕ ОБЯЗАТЕЛЬСТВА. Заемные средства
b1420 number опц. ДОЛГОСРОЧНЫЕ ОБЯЗАТЕЛЬСТВА. Отложенные налоговые обязательства
b1430 number опц. ДОЛГОСРОЧНЫЕ ОБЯЗАТЕЛЬСТВА. Оценочные обязательства
b1450 number опц. ДОЛГОСРОЧНЫЕ ОБЯЗАТЕЛЬСТВА. Прочие обязательства
b1400 number опц. ИТОГО по разделу IV
b1510 number опц. КРАТКОСРОЧНЫЕ ОБЯЗАТЕЛЬСТВА. Заемные средства
b1520 number опц. КРАТКОСРОЧНЫЕ ОБЯЗАТЕЛЬСТВА. Кредиторская задолженность
b1530 number опц. КРАТКОСРОЧНЫЕ ОБЯЗАТЕЛЬСТВА. Доходы будущих периодов
b1540 number опц. КРАТКОСРОЧНЫЕ ОБЯЗАТЕЛЬСТВА. Оценочные обязательства
b1550 number опц. КРАТКОСРОЧНЫЕ ОБЯЗАТЕЛЬСТВА. Прочие обязательства
b1500 number опц. ИТОГО по разделу V
b1700 number опц. Общая стоимость пассивов организации
b2110 number опц. Выручка
b2120 number опц. Себестоимость продаж
b2100 number опц. Валовая прибыль
b2210 number опц. Коммерческие расходы
b2220 number опц. Управленческие расходы
b2200 number опц. Прибыль (убыток) от продаж
b2310 number опц. Доходы от участия в других организациях
b2320 number опц. Проценты к получению
b2330 number опц. Проценты к уплате
b2340 number опц. Прочие доходы
b2350 number опц. Прочие расходы
b2300 number опц. Прибыль (убыток) до налогообложения
b2410 number опц. Налог на прибыль
b2411 number опц. Текущий налог на прибыль
b2412 number опц. Отложенный налог на прибыль
b2430 number опц. Изменение отложенных налоговых обязательств
b2450 number опц. Изменение отложенных налоговых активов
b2460 number опц. Прочее
b2400 number опц. Чистая прибыль (убыток)
b2510 number опц. Результат от переоценки внеоборотных активов, не включаемый в чистую прибыль (убыток) периода
b2520 number опц. Результат от прочих операций, не включаемый в чистую прибыль (убыток) периода
b2530 number опц. Налог на прибыль от операций, результат которых не включается в чистую прибыль (убыток) периода
b2500 number опц. Совокупный финансовый результат периода
b2910 number опц. Базовая прибыль (убыток) на акцию
b2900 number опц. Разводненная прибыль (убыток) на акцию
b5640 number опц. Амортизация
FounderCompanyobject
СвойствоТипОбязат.Описание
inn string опц. ИНН
kpp string опц. КПП
ogrn string опц. ОГРН
fullName string опц. Наименование
sharePercent number (double) опц. Доля, %
shareSum number опц. Доля, руб
FounderPersonobject
СвойствоТипОбязат.Описание
inn string опц. ИНН
lastName string опц. Фамилия
firstName string опц. Имя
secondName string опц. Отчество
identityDocument IdentityDocument опц. Паспортные данные
birthDate string (date) опц. Дата рождения
birthPlace string опц. Место рождения
registrationAddress string опц. Адрес регистрации
actualAddress string опц. Фактический адрес
contacts ContactData[] опц. Контактные данные (телефон, email)
personAttributes PersonAttributes опц. Доп. информация о ФЛ
sharePercent number (double) опц. Доля, %
shareSum number опц. Доля, руб
Foundersobject
СвойствоТипОбязат.Описание
foundersPersons FounderPerson[] опц. Список учредителей - физ. лиц (если имеются)
foundersCompanies FounderCompany[] опц. Список учредителей - юр. лиц (если имеются)
HttpMethodobject
HttpRangeobject
HttpStatusobject
HttpStatusCodeobject
СвойствоТипОбязат.Описание
is4xxClientError boolean опц.
is5xxServerError boolean опц.
is1xxInformational boolean опц.
is2xxSuccessful boolean опц.
is3xxRedirection boolean опц.
error boolean опц.
IdentityDocumentobject
СвойствоТипОбязат.Описание
series string опц. Серия. Формат: 4 цифры
number string опц. Номер. Формат: 6 цифр
issuingAuthorityCode string опц. Код подразделения. Формат: (3 цифры)-(3 цифры)
issuingAuthority string опц. Кем выдан
issuedDate string (date) опц. Дата выдачи
validTillDate string (date) опц. Дата окончания срока действия
Lotobject
СвойствоТипОбязат.Описание
lotNumber string опц. Номер лота
lotSubject string опц. Предмет лота
startAmount number опц. Начальная (максимальная) цена контракта
finalAmount number опц. Итоговая сумма закупки
ikzList string[] опц. Идентификационные коды закупки (ИКЗ)
okpd Okpd[] опц. Список ОКПД
beneficiaries Beneficiary[] опц. Бенефициары
contractConditions ContractConditions опц. Условия контракта
MediaTypeobject
СвойствоТипОбязат.Описание
type string опц.
subtype string опц.
parameters Map<string, string> опц.
qualityValue number (double) опц.
wildcardType boolean опц.
wildcardSubtype boolean опц.
subtypeSuffix string опц.
concrete boolean опц.
charset string опц.
MultiLotBankGuaranteeobject
СвойствоТипОбязат.Описание
bankGuaranteeType string опц. Вид банковской гарантии: * participation - На участие в торгах * execution - На исполнение обязательств по контракту * returnAdvance - На возврат аванса * period - На обеспечение гарантийных обязательств
participationexecutionreturnAdvanceperiod
purchaseNumber string опц. Реестровый номер торгов
federalLaw string опц. Закон: * 44 - 44-ФЗ * 223 - 223-ФЗ * 185-615 - 185-ФЗ/615-ПП * commercial - Коммерческая закупка
44223185-615commercial
marketPlace string опц. Площадка
tenderType string опц. Способ размещения
purchasePublishedDate string (date) опц. Дата размещения
startDate string (date) опц. Дата начала банковской гарантии
endDate string (date) опц. Дата окончания банковской гарантии
amount number опц. Сумма гарантии
url string опц. Ссылка на закупку
auctionType string опц. Тип аукциона: * public - открытый * private - закрытый
publicprivate
gettingInfo string опц. Дополнительная информация по доставке / получению оригинала БГ
subject string опц. Предмет закупки
lots Lot[] опц. Информация о лотах
Okpdobject
СвойствоТипОбязат.Описание
name string опц. Название по ОКПД
code string опц. Код по ОКПД
Optionobject
СвойствоТипОбязат.Описание
code string опц. Код решения
Пример: ACCEPT
text string опц. Описание решения
Пример: Согласовано
isCommentRequired boolean опц. Требуется ли комментарий
Пример: False
OrderRequestobject
СвойствоТипОбязат.Описание
principal Principal опц. Данные принципала
multiLotBankGuarantee MultiLotBankGuarantee опц. Данные о закупке (поддерживается только 1 лот и 1 бенефициар)
documents Document[] опц. Документы для заявки на получение банковской гарантии
decision Decision опц. Решение агента
callbackUrl string опц. URL сервиса для получения изменений состояния заявки. На указанную URL будет отправлен POST-запрос с объектом типа StatusResponse в виде json
requestedBanks string[] опц. Список ИНН банков, в которые будет подана заявка. Если не указан — заявка подаётся во все доступные банки
OrderResponseobject
СвойствоТипОбязат.Описание
orderId string опц. ID мастер-заявки
orderNumber string опц. Номер мастер-заявки
bankOrders BankOrder[] опц. Список заявок в банках
PersonAttributesobject
СвойствоТипОбязат.Описание
citizenship string опц. Гражданство (значение из трех букв по справочнику ISO)
AFGALBATADZAASMANDAGOATGAZEARGAUSAUTBHSBHRBGDARMBRBBELBMUBTNBOLBIHBWABVTBRABLZIOTSLBVGBBRNBGRMMRBDIBLRKHMCMRCANCPVCYMCAFLKATCDCHLCHNTWNCXRCCKCOLCOMMYTCOGCODCOKCRIHRVCUBCYPCZEBENDNKDMADOMECUSLVGNQETHERIESTFROFLKSGSFJIFINALAFRAGUFPYFATFDJIGABGEOGMBPSEDEUGHAGIBKIRGRCGRLGRDGLPGUMGTMGINGUYHTIHMDVATHNDHKGHUNISLINDIDNIRNIRQIRLISRITACIVJAMJPNKAZJORKENPRKKORKWTKGZLAOLBNLSOLVALBRLBYLIELTULUXMACMDGMWIMYSMDVMLIMLTMTQMRTMUSMEXMCOMNGMDAMNEMSRMARMOZOMNNAMNRUNPLNLDCUWABWSXMBESNCLVUTNZLNICNERNGANIUNFKNORMNPUMIFSMMHLPLWPAKPANPNGPRYPERPHLPCNPOLPRTGNBTLSPRIQATREUROURUSRWABLMSHNKNAAIALCAMAFSPMVCTSMRSTPSAUSENSRBSYCSLESGPSVKVNMSVNSOMZAFZWEESPSSDSDNESHSURSJMSWZSWECHESYRTJKTHATGOTKLTONTTOARETUNTURTKMTCATUVUGAUKRMKDEGYGBRGGYJEYIMNTZAUSAVIRBFAURYUZBVENWLFWSMYEMZMB
snils string опц. СНИЛС
gender string опц. Пол: * male - Мужской * female - Женский
malefemale
countryOfResidence string опц. Страна проживания (значение из трех букв по справочнику ISO)
AFGALBATADZAASMANDAGOATGAZEARGAUSAUTBHSBHRBGDARMBRBBELBMUBTNBOLBIHBWABVTBRABLZIOTSLBVGBBRNBGRMMRBDIBLRKHMCMRCANCPVCYMCAFLKATCDCHLCHNTWNCXRCCKCOLCOMMYTCOGCODCOKCRIHRVCUBCYPCZEBENDNKDMADOMECUSLVGNQETHERIESTFROFLKSGSFJIFINALAFRAGUFPYFATFDJIGABGEOGMBPSEDEUGHAGIBKIRGRCGRLGRDGLPGUMGTMGINGUYHTIHMDVATHNDHKGHUNISLINDIDNIRNIRQIRLISRITACIVJAMJPNKAZJORKENPRKKORKWTKGZLAOLBNLSOLVALBRLBYLIELTULUXMACMDGMWIMYSMDVMLIMLTMTQMRTMUSMEXMCOMNGMDAMNEMSRMARMOZOMNNAMNRUNPLNLDCUWABWSXMBESNCLVUTNZLNICNERNGANIUNFKNORMNPUMIFSMMHLPLWPAKPANPNGPRYPERPHLPCNPOLPRTGNBTLSPRIQATREUROURUSRWABLMSHNKNAAIALCAMAFSPMVCTSMRSTPSAUSENSRBSYCSLESGPSVKVNMSVNSOMZAFZWEESPSSDSDNESHSURSJMSWZSWECHESYRTJKTHATGOTKLTONTTOARETUNTURTKMTCATUVUGAUKRMKDEGYGBRGGYJEYIMNTZAUSAVIRBFAURYUZBVENWLFWSMYEMZMB
PersonDataobject
СвойствоТипОбязат.Описание
inn string опц. ИНН
lastName string опц. Фамилия
firstName string опц. Имя
secondName string опц. Отчество
identityDocument IdentityDocument опц. Паспортные данные
birthDate string (date) опц. Дата рождения
birthPlace string опц. Место рождения
registrationAddress string опц. Адрес регистрации
actualAddress string опц. Фактический адрес
contacts ContactData[] опц. Контактные данные (телефон, email)
personAttributes PersonAttributes опц. Доп. информация о ФЛ
Principalobject
СвойствоТипОбязат.Описание
inn string опц. ИНН
kpp string опц. КПП
ogrn string опц. ОГРН
fullName string опц. Наименование
addresses Address[] опц. Адреса принципала
bankAccounts BankAccount[] опц. Сведения о счетах
principalBuh PrincipalBuh опц. Бухгалтерская отчетность
staffInfo StaffInfo опц. Сведения о персонале
contactPerson ContactPerson опц. Контактное лицо по гарантиям
companyHead CompanyHead опц. Руководитель
principalSigner PrincipalSigner опц. Подписант
companyBeneficiaries BeneficiaryOwner[] опц. Бенефициарные владельцы
founders Founders опц. Учредители
companyManagement CompanyManagement опц. Органы управления
PrincipalBuhobject
СвойствоТипОбязат.Описание
periods Map<string, FinReport> опц. Данные отчетности. Ассоциативный массив, где ключ - период отчетности в формате гггг-мм (гггг - год, мм - последний месяц квартала). Значение массива - объект FinReport
Пример: {'2025-03': {'b1110': 42, 'b1210': 1337}, '2024-12': {'b1110': 42, 'b1210': 1337}}
PrincipalSignerobject
СвойствоТипОбязат.Описание
inn string опц. ИНН
lastName string опц. Фамилия
firstName string опц. Имя
secondName string опц. Отчество
identityDocument IdentityDocument опц. Паспортные данные
birthDate string (date) опц. Дата рождения
birthPlace string опц. Место рождения
registrationAddress string опц. Адрес регистрации
actualAddress string опц. Фактический адрес
contacts ContactData[] опц. Контактные данные (телефон, email)
personAttributes PersonAttributes опц. Доп. информация о ФЛ
position string опц. Должность: * director - Директор, * ceo - Генеральный директор, * actingCeo - ВРИО Генерального директора, * president - Президент, * other - значение из поля otherPosition
directorceoactingCeopresidentother
otherPosition string опц. Иная должность. Обязательно, если в поле position указано other
relationAttributes RelationAttributes опц. Доп. информация о сотруднике
authorizingDoc string опц. Основание полномочий
byProxy boolean опц. Представитель действует по доверенности
proxyName string опц. Наименование доверенности
proxyNumber string опц. Номер доверенности
proxyDateStart string (date) опц. Дата доверенности
proxyDateEnd string (date) опц. Срок действия доверенности истекает
proxyGuaranteeAmount number опц. Ограничение по сумме гарантии
proxyAgreementAmount number опц. Ограничение по сумме договора
ProblemDetailobject
СвойствоТипОбязат.Описание
type string (uri) опц.
title string опц.
status integer (int32) опц.
detail string опц.
instance string (uri) опц.
properties object опц.
RelationAttributesobject
СвойствоТипОбязат.Описание
authorizationStartDate string (date) опц. Дата назначения на должность
authorizationExpirationDate string (date) опц. Дата истечения полномочий
StaffInfoobject
СвойствоТипОбязат.Описание
averageNumber integer (int64) опц. Штат сотрудников (общая численность сотрудников), чел.
wageFund number опц. Фонд оплаты, год, руб.
staffDebts number опц. Задолженность по зарплате, руб.
StatusResponseobject
СвойствоТипОбязат.Описание
orderId string опц. Идентификатор заявки
Пример: AWEs186CU22kNAUZhN1R
orderNumber string опц. Номер заявки
Пример: 000042
taskDefinitionKey string опц. Ключ задачи: * AGENT_FILL_APPLICATION - На заполнении * BANK_REVIEW_APPLICATION - На проверке в банке * CLIENT_SIGN_QUESTIONNAIRE - На подписании анкеты * AGENT_REWORK - На доработке * BANK_MAKING_DECISION - На рассмотрении в банке * CLIENT_SIGN_DOCS - На подписании документов * AGENT_APPROVE - Одобрено, согласовать текст и параметры гарантии * CLIENT_SIGN_CONTRACT - На подписании договора при выдаче * BANK_ISSUING - Оформление документов в банке
AGENT_FILL_APPLICATIONBANK_REVIEW_APPLICATIONCLIENT_SIGN_QUESTIONNAIREAGENT_REWORKBANK_MAKING_DECISIONCLIENT_SIGN_DOCSAGENT_APPROVECLIENT_SIGN_CONTRACTBANK_ISSUING
processDefinitionKey string опц. Ключ заявки
Пример: BG_AGENT_BANK
comments string опц. Комментарий банка
Пример: Банковский процесс успешно запущен
decisionOptions Option[] опц. Список возможных решений по задаче
Пример: [{'code': 'SEND_TO_BANK', 'text': 'Отправить в Банк', 'isCommentRequired': False}, {'code': 'REJECT', 'text': 'Отказ от гарантии', 'isCommentRequired': True}]
taskName string опц. Наименование текущей задачи агента
Пример: Доработать заявку, приложить документы
url string опц. Ссылка для дальнейших действий
Пример: http://qwe.asd
orderStatus string опц. Статус заявки: * InProcess - в процессе * RejectedByBank - отказ * RejectedByAgent - клиент отказался от гарантии * Executed - гарантия предоставлена банком * PendingAgent - ожидает ответа от Агента * PendingClient - ожидает действий клиента * Failed - Процесс невозможно закончить
InProcessRejectedByBankRejectedByAgentPendingAgentPendingClientExecutedFailed
Пример: InProcess
statusDescription string опц. Описание статуса
Пример: Заявка находится в процессе выполнения
commission number опц. Величина комиссии
Пример: 1234.56
minCommission number опц. Минимальная величина комиссии
Пример: 1234.56
documents DocumentResponse[] опц. Документы от банка
StreamingResponseBodyobject
Termsobject
СвойствоТипОбязат.Описание
law boolean опц. Соответствие по закону
bgType boolean опц. Соответствие по типу гарантии
bgAmount boolean опц. Соответствие по сумме гарантии
duration boolean опц. Соответствие по сроку
bgPrincipalOkved boolean опц. Соответствие по ОКВЭД принципала
bgPrincipalRegion boolean опц. Соответствие по региону принципала
bgBeneficiaryOkved boolean опц. Соответствие по ОКВЭД бенефициара
bgBeneficiaryRegion boolean опц. Соответствие по региону бенефициара

Справочник доктайпов

Перечень типов документов, в которые можно загружать файлы по заявке. Колонка multiple указывает, может ли доктайп хранить несколько файлов одновременно.

ДоктайпСущностьНазваниеmultiple
customer_chartercustomerУстав юридического лица
customer_contractRegistrycustomerРеестр исполненных контрактов
customer_eioAuthorizingDoccustomerРешение и/или приказ о назначении на должность ЕИО (директора, ген.директора, президента компании и пр.)
customer_finReportcustomerБухгалтерская отчётность (годовая)
customer_finReportQcustomerБухгалтерская отчётность (последний квартал)
customer_ledgerYearcustomerДля Клиентов находящихся на УСН/ЕНВД - Книга доходов и расходов за последний завершенный год
customer_nonResidentDoccustomerДокумент, подтверждающий право иностранного гражданина или лица без гражданства на пребывание (проживание) в РФ
customer_orderCard51customerКарточка 51 счета за 6 полных календарных месяцев, предшествующих текущей дате (не отчетной)
customer_osv58customerОСВ по 58 счету за прошедшие 12 месяцев
customer_osv60customerОСВ по 60 счету за прошедшие 12 месяцев
customer_osv62customerОСВ по 62 счету за прошедшие 12 месяцев
customer_osv66customerОСВ по 66 счету за прошедшие 12 месяцев
customer_osv67customerОСВ по 67 счету за прошедшие 12 месяцев
customer_osv76customerОСВ по 76 счету за прошедшие 12 месяцев
customer_osv91customerОСВ по 91 счету за прошедшие 12 месяцев
customer_osvCommoncustomerОбщая ОСВ по счетам и субсчетам
customer_otherDocscustomerПрочие документы клиента
customer_passportscustomerПаспорт ЕИО
customer_passportsMembercustomerПаспорта учредителей и бенефициарных владельцев
customer_passportsSignercustomerПаспорт представителя (лица, действующего по доверенности)
customer_premisesConfirmingDoccustomerДокумент, подтверждающий право собственности или аренды помещения
customer_shareholdersExcerptcustomerВыписка из реестра акционеров
customer_signerConfirmingDoccustomerДоверенность / Документ, подтверждающий право подписи
customer_taxFormcustomerНалоговая декларация за отчетный период
bank_principalFormordersАнкета клиента по форме банка
bgScanordersСкан банковской гарантии
bg_account51analysisordersАнализ 51 счета в разрезе банков
bg_agentRelationAgreementordersСогласие на работу с агентом
bg_applicationordersЗаявка на банковскую гарантию
bg_billordersСчет на оплату вознаграждения
bg_commissionDecreaseReasonordersОбоснование понижения комиссии
bg_contractordersГарантийный договор
bg_declarationBenOwnerordersДекларация бенефициарного владельца
bg_edoRequestordersЗаявление о присоединении
bg_finReportordersВерифицированная бухгалтерская отчётность (годовая)
bg_finReportGeneratedordersБухотчетность (сгенерированный xlsx)
bg_finReportQordersВерифицированная бухгалтерская отчётность (квартал)
bg_guaranteeDraftordersМакет БГ
bg_guaranteeDraftPaidordersПлатный макет БГ
bg_guaranteeScanordersСкан выданной гарантии
bg_limitRequestordersЗаявление на установление лимита
bg_passportsordersВерифицированные паспорта ЕИО
bg_persDataConsentordersСогласие на обработку персональных данных
bg_rulesAgreementordersЗаявление о присоединении к правилам
bg_woAppLotordersСправка об отсутствии необходимости одобрения сделки
billordersСчёт
otherOrderDocsordersПрочие документы по заявке

Справочник статусов заявки

Допустимые значения поля orderStatus в ответах API и коллбеках.

КодОписание
InProcessНа стороне Банка
RejectedByBankОтказ Банка
RejectedByAgentИнициатор отказался от гарантии
ExecutedГарантия предоставлена банком
PendingAgentОжидает ответа от Агента
PendingClientОжидает подписания клиентом
FailedТехнический сбой

Справочник TaskDefinitionKey

Детализированный статус заявки. Колонки «Подписано Клиентом» и «Одобрено Банком» указывают, наступило ли соответствующее событие в жизненном цикле заявки.

КодОписаниеПодписано КлиентомОдобрено Банком
AGENT_FILL_APPLICATIONНа заполнении у Агента
BANK_REVIEW_APPLICATIONНа проверке в банке
CLIENT_SIGN_QUESTIONNAIREНа подписании анкеты у Клиента
AGENT_REWORKНа доработке
BANK_MAKING_DECISIONНа рассмотрении в банке
CLIENT_SIGN_DOCSНа подписании документов
AGENT_APPROVEОдобрено, согласовать текст и параметры гарантии
CLIENT_SIGN_CONTRACTНа подписании договора при выдаче
BANK_ISSUINGОформление документов в банке