ym88659208ym87991671
Создание справки о подтверждающих документах | Документация для разработчиков

Создание справки о подтверждающих документах

Обновлено 26 мая 2026

Для создания СПД необходимо отправить POST-запрос /fintech/api/v1/confirmatory-documents-inquiries с токеном доступа (access_token) пользователя в параметре Authorization заголовка и реквизитами документа в теле.

В параметре scope ссылки авторизации пользователя должен быть указан сервис CONFIRMATORY_DOCUMENTS_INQUIRY для получения доступа к этому запросу.

  • Если в запросе на создание заявления передать ЭП к документу (объект digestSignatures), то Банк сразу начнет обработку документа.
  • Если в запросе не передавать ЭП к документу, то заявление будет создано в статусе черновик. Для начала обработки документа Банком потребуется зайти в интерфейс СберБизнес и подписать его.
Дайджест

Дайджест – это текстовый документ, содержащий перечень и значения полей запроса, к которому он относится и предназначенный для подписания ЭП. Сохраняйте порядок и количество полей дайджеста, как показано в примере ниже, иначе подписать его не получится.

Формат дайджеста:

Наименование поляОписание поляПример
authPersonNameФИО уполномоченного сотрудника организации клиентаИванов Иван Иванович
authPersonTelfaxНомер телефона, факса уполномоченного сотрудника организации клиента4955005550
customerBankBicБИК банка клиента44525225
customerINNИНН клиента2406877205
customerNameНаименование резидентаОбщество с ограниченной ответственностью "Клиент"
customerOKPOОКПО клиента3698203661
dateДата документа20.05.2019
dealDateСправка от (дата справки)20.05.2019
externalIdИдентификатор документа в организации-партнере14d62475-e8da-4f24-bcc7-68e4add64131
psNumberУникальный номер контракта (Кредитного договора)11111111/0011/0000/1
TABLES
Table=BfAttachmentsЗначение указывается при наличии UUID-ов больших файлов
fileIdUUID больших файлов08ba3412-118a-4f4d-be23-e93f81d58fdc
#Разделитель строк таблицы
fileIdUUID больших файловe0687514-2c3d-471d-917c-f3e8f9fde1e0
#Разделитель строк таблицы
Table=Docs
addInfoПримечания по данной строкеДополнительная информация
confDocDateДата подтверждающего документа20.05.2019
confDocNumberНомер подтверждающего документа123
contractSum.amountСумма04.03
contractSum.currencyCodeЦифровой код валюты840
contractSum.currencyNameТрехбуквенный код валюты ISO-код валютыUSD
contractSumDelСумма, соответствующая признаку поставки 2 или 3, в валюте цены контракта (кредитного договора)01.01
correctionDateДата корректируемой СПД20.05.2019
correctionNumberНомер корректировки1
countryCodeКод страны826
countryNameНаименование страныСОЕДИНЕННОЕ КОРОЛЕВСТВО
docCodeКод вида документа03_3
docNameНаименование вида документаО передаче резидентом на территории Российской Федерации товаров и оказании услуг нерезиденту по контрактам, указанным в подпункте 5.1.2 пункта 5.1 настоящей Инструкции
docSum.amountСумма04.03
docSum.currencyCodeЦифровой код валюты840
docSum.currencyNameТрехбуквенный код валюты ISO-код валютыUSD
docSumDelСумма, соответствующая признаку поставки 2 или 3, в валюте документа02.02
expectedLifeОжидаемый срок20.05.2019
hasConfDocNumberПризнак номера документа:true
true - документ имеет номер;
false - документ без номера
ordinalNumberПорядковый номер строки в справке15
supplyFeatureПризнак поставки2

Пример дайджеста

authPersonName=Иванов Иван Иванович
authPersonTelfax=4955005550
customerBankBic=044525225
customerBankName=ПАО "СБЕРБАНК"
customerINN=2406877205
customerName=Общество с ограниченной ответственностью "Клиент"
customerOKPO=3698203661
date=2019-05-20
dealDate=2019-05-20
externalId=14d62475-e8da-4f24-bcc7-68e4add64131
psNumber=11111111/0011/0000/1
TABLES
Table=BfAttachments
fileId=3e7333db-dbb4-4bc1-a2e2-49cbc5ab834d
#
fileId=e0687514-2c3d-471d-917c-f3e8f9fde1e0
#
Table=Docs
addInfo=Примечание
confDocDate=2019-05-20
confDocNumber=123
contractSum.amount=4.03
contractSum.currencyCode=840
contractSum.currencyName=USD
contractSumDel=1.01
correctionDate=2019-05-20
countryCode=826
countryName=СОЕДИНЕННОЕ КОРОЛЕВСТВО
docCode=03_3
docName=О передаче резидентом на территории Российской Федерации товаров и оказании услуг нерезиденту по контрактам,
указанным в подпункте 5.1.2 пункта 5.1 настоящей Инструкции
docSum.amount=4.03
docSum.currencyCode=840
docSum.currencyName=USD
docSumDel=2.02
expectedLife=2019-05-20
hasConfDocNumber=1
ordinalNumber=0
supplyFeature=2
#
addInfo=Примечание
confDocDate=2019-05-20
confDocNumber=135
contractSum.amount=4.03
contractSum.currencyCode=840
contractSum.currencyName=USD
contractSumDel=2.02
correctionDate=2019-05-20
correctionNumber=1
countryCode=826
countryName=СОЕДИНЕННОЕ КОРОЛЕВСТВО
docCode=03_3
docName=О передаче резидентом на территории Российской Федерации товаров и оказании услуг нерезиденту по контрактам,
docSum.amount=8.08
docSum.currencyCode=840
docSum.currencyName=USD
docSumDel=2.02
expectedLife=2019-05-20
hasConfDocNumber=true
ordinalNumber=2
supplyFeature=3
#
Рекомендации по тестированию в песочнице

При тестировании создания справки о подтверждающих документах в Песочнице соблюдайте правила:

  • Не нужно устанавливать промышленные сертификаты электронной подписи (ЭП) — Песочница использует тестовые идентификаторы ЭП (certificateUuid).
  • Все остальные поля запроса заполняйте произвольными данными (реквизиты, суммы) в соответствии с требованиями в документации.

Сценарии тестирования

Для тестирования сценариев используйте фиксированные значения certificateUuid. При использовании любых других значений certificateUuid вернется ошибка INVALIDEDS.


1. Чтобы создать черновик СПД, отправьте запрос без объекта digestSignatures.

2. Для отправки документа с единственной или двумя подписями передайте в объекте digestSignatures тестовые certificateUuid.

Параметры:

  • bb014b5d-8159-40be-97c1-eafeed4a8c3d (единственная подпись)
  • d5d4f811-f4d4-4205-a70f-58f772eeab72 (первая подпись)
  • 4f29c8ef-b55d-43c7-a321-f2b1303a29cd (вторая подпись)

Статус в ответе: bankStatus: "EXPORTED"

Пример:

#Единственная подпись
  "digestSignatures": [
    \{
      "certificateUuid": "bb014b5d-8159-40be-97c1-eafeed4a8c3d",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \}
  ],


#Первая и вторая подпись
  "digestSignatures": [
    \{
      "certificateUuid": "d5d4f811-f4d4-4205-a70f-58f772eeab72",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \},
    \{
      "certificateUuid": "4f29c8ef-b55d-43c7-a321-f2b1303a29cd",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \}
  ],

Запрос

Ответы

Успешный код возврата

Loading...
Это полезный материал?
Заметили ошибку?
Выделите текст и нажмите
Ctrl
+
Enter
, чтобы сообщить нам об ошибке