ym88659208ym87991671
Создание заявления о внесении изменений в I раздел ВБК | Документация для разработчиков

Создание заявления о внесении изменений в I раздел ВБК

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

Для создания заявления о внесении изменений в I раздел ВБК необходимо отправить POST-запрос /fintech/api/v1/bank-control-statements/curr-contract-change-application с токеном доступа (access_token) пользователя в параметре Authorization заголовка и реквизитами заявления о внесении изменений.

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

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

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

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

Наименование поляОписание поляПример
externalIdИдентификатор документа в организации-партнере550e8400-e29b-41d4-a716-446655440000
dateДата создания документа по местному времени2019-05-16
numberНомер документа9263OUT-30-12
authPersonNameФИО ответственного лицаПетров Петр Иванович
authPersonTelfaxТелефон ответственного лица79263689379
TABLESЗначение указывается при наличии вложенных коллекций
Table=StatementSetЗначение указывается при наличии УНК или идентификатора ВБК в Банке
controlStatementUniqueNumberУНК25120002/1481/1948/9/1
controlBaseIdидентификатор ВБК в Банке7113689325
BankControlStatementInfo.contractDateДата договора2019-05-16
BankControlStatementInfo.amountСумма контракта1.01
BankControlStatementInfo.contractEndDateДата окончания договора2019-05-16
BankControlStatementInfo.contractNumberНомер контракта2442
BankControlStatementInfo.currencyCodeЦифровой код валюты договора840
BankControlStatementInfo.ResidentInfo.changeDateДата внесения изменений в ЕГРЮЛ2026-02-02
BankControlStatementInfo.ResidentInfo.nameНаименование резидентаООО "АТЛАНТИС НОВИКОМ"
BankControlStatementInfo.ResidentInfo.innИНН7733580074
BankControlStatementInfo.ResidentInfo.kppКПП773401002
BankControlStatementInfo.ResidentInfo.regDateДата регистрации в ЕГРЮЛ2026-02-02
BankControlStatementInfo.ResidentInfo.ogrnОГРН1026605606620
Table=StatementSet.BankControlStatementInfo.NonResidentsЗначение указывается при заполнении кода и наименования страны или наименования контрагента
countryCodeЦифровой код страны иностранного контрагента38
countryNameНаименование страны иностранного контрагентаКазахстан
nameНаименование иностранного контрагентаKazan
#Разделитель нерезидентов
Table=StatementSet.DocBaseSetЗначение указывается при заполнении даты документа
docDateДата документа-основания для внесения изменений. Формат YYYY-MM-DD2019-05-16
#Разделитель дат документов
Table=StatementSet.BfAttachmentsЗначение указывается при наличии UUID-ов больших файлов
fileIdUUID большого файла
#Разделитель значений UUID-ов больших файлов
#Разделитель значений ВБК

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

externalId=2a3e1375-1e23-409f-b1e6-50a552e512e1
date=2025-12-29
number=9263OUT-30-12
authPersonName=Петров Петр Иванович
authPersonTelfax=79263689379
TABLES
Table=StatementSet
controlStatementUniqueNumber=25120002/1481/1948/9/1
controlBaseId=7113689325
BankControlStatementInfo.contractDate=2025-12-29
BankControlStatementInfo.amount=182474598771.00
BankControlStatementInfo.contractEndDate=2025-12-29
BankControlStatementInfo.contractNumber=2442
BankControlStatementInfo.currencyCode=840
BankControlStatementInfo.ResidentInfo.changeDate=2026-01-29
BankControlStatementInfo.ResidentInfo.name=ООО "АТЛАНТИС НОВИКОМ" 1
BankControlStatementInfo.ResidentInfo.inn=7733580074
BankControlStatementInfo.ResidentInfo.kpp=773401002
Table=StatementSet.BankControlStatementInfo.NonResidents
countryCode=38
countryName=Казахстан
name=Kazan
#
countryCode=38
countryName=Казахстан
name=Kazan1
#
countryCode=38
countryName=Казахстан
name=Kazan2
#
countryCode=38
countryName=Казахстан
name=Kazan3
#
Table=StatementSet.DocBaseSet
docdate=2025-12-29
#
docdate=2025-12-29
#
docdate=2025-12-29
#
docdate=2025-12-29
#
docdate=2025-12-29
#
Table=StatementSet.BfAttachments
fileId=31663ef5-7115-5015-b0f3-f1d70a4e9c11
#
fileId=51663ef6-7225-6016-c0f3-f1c70a4e9c12
#
fileId=61663ef7-7335-7017-d0f3-f1b70a4e9c22
#
fileId=71663ef8-7475-8018-f0f3-f1f70a4e9c32
#
fileId=81663ef9-7575-9019-a0f3-f1g70a4e9c42
#
#
controlStatementUniqueNumber=24120002/1481/1948/9/1
controlBaseId=7113689326
BankControlStatementInfo.contractDate=2025-12-29
BankControlStatementInfo.amount=2084454925.00
BankControlStatementInfo.contractEndDate=2025-12-29
BankControlStatementInfo.contractNumber=2441
BankControlStatementInfo.currencyCode=978
Table=StatementSet.BankControlStatementInfo.NonResidents
countryCode=38
countryName=Казахстан
name=Kazan
#
countryCode=38
countryName=Казахстан
name=Kazan1
#
countryCode=38
countryName=Казахстан
name=Kazan2
#
countryCode=38
countryName=Казахстан
name=Kazan3
#
Table=StatementSet.DocBaseSet
docdate=2025-12-29
#
docdate=2025-12-29
#
docdate=2025-12-29
#
docdate=2025-12-29
#
docdate=2025-12-29
#
Table=StatementSet.BfAttachments
fileId=31663ef5-7115-5015-b0f3-f1d70a4e9c11
#
fileId=51663ef6-7225-6016-c0f3-f1c70a4e9c12
#
fileId=61663ef7-7335-7017-d0f3-f1b70a4e9c22
#
fileId=71663ef8-7475-8018-f0f3-f1f70a4e9c32
#
fileId=81663ef9-7575-9019-a0f3-f1g70a4e9c42
#
#
Рекомендации по тестированию в песочнице

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

  • Не нужно устанавливать промышленные сертификаты электронной подписи (ЭП) — Песочница использует тестовые идентификаторы ЭП (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
, чтобы сообщить нам об ошибке
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.