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

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

Обновлено 29 ноября 2024
Компаниям
Холдингам

Alt text /v1/bank-control-statements/change-curr-cred-contracts

Запрос позволяет создать заявление о внесении изменений в раздел I ВБК (кредитный договор с нерезидентом) в Банке через Sber API (Fintech API) по собственной/дочерней организации.

Для создания запроса на регистрацию документа «Заявление о внесении изменений в раздел I ВБК (кредитный договор с нерезидентом)» необходимо отправить POST-запрос (/v1/bank-control-statements/change-curr-cred-contracts), в котором передать авторизационный токен к данным собственной/дочерней организации (Access Token) и реквизиты документа. Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис BANK_CONTROL_STATEMENT_CHANGE_APPLICATION.

Для обращения к ресурсу необходимо отправлять запрос на:

  • Тестовый контур https://iftfintech.testsbi.sberbank.ru:9443

  • Промышленный контур https://fintech.sberbank.ru:9443

Шаги

1. Получить AccessToken.

2. Сформировать ЭП.

3. Отправить запрос.

4. Получить статус.

Модель запроса и ответа

НаименованиеОписание
Параметры заголовка
Authorization (String)Access token собственной/дочерней организации, полученный через SSO
Пример: Bearer daf9a14c-821d-4bde-9c10-0e56e63d54a0-1
Параметры тела запроса
CurrCredContractChangeApplication {
actualDebtAmount (number, optional)Сумма фактической задолженности по основному долгу,
amount (number, optional)Сумма контракта ,
bankComment (string, optional, read only)Банковский комментарий к статусу документа ,
bankControlStatementChangeApplicationInfo (BankControlStatementChangeApplicationInfo)Информация о заявлении о внесении изменений в I раздел ВБК ,
bankStatus (string, optional, read only)Статус документа ,
collateralAmount (number, optional)Сумма залогового или другого обеспечения ,
contractDate (string)Дата контракта ,
contractEndDate (string, optional)Дата окончания обязательств по контракту ,
contractNumber (string, optional)Номер контракта ,
credRepayPayments (Array[CredRepayPaymentChangeable], optional)График платежей по кредитному договору ,
creditAttractions (Array[CreditAttractionChangeable], optional)Привлечение кредита на синдицированной (консорциональной) основе ,
creditPayPeriodCode (string, optional)Код срока привлечения (предоставления) ,
currFixInterestRate (number, optional)Фиксированный размер процентной ставки ,
currencyCode (string, optional)Цифровой код валюты контракта ,
currencyEarningsAmount (number, optional)Сумма, подлежащая погашению за счет валютной выручки ,
date (string)Дата составления документа ,
digestSignatures (Array[Signature], optional)Электронные подписи по дайджесту документа ,
hasDirectInvesting (boolean, optional)Признак наличия отношений прямого инвестирования ,
increaseRate (number, optional)Размер процентной надбавки ,
liborRate (string, optional)Код ставки Libor ,
nonResidents (Array[BankControlStatementNonResident], optional)Информация о нерезидентах ,
number (string, optional)Номер документа ,
otherPayments (string, optional)Иные платежи, предусмотренные кредитным договором ,
otherRateMethod (string, optional)Описание метода определения ставки ,
tranches (Array[CurrCredTrancheChangeable], optional)Информация о траншах по кредиту ,
transferAmount (number, optional)Сумма, подлежащая зачислению на счета за рубежом
}BankControlStatementChangeApplicationInfo {
authPersonName (string)ФИО ответственного лица ,
authPersonTelfax (string)Телефон ответственного лица ,
basisDocs (Array[BankControlStatementChangeBasisDoc], optional)Документы-основания для внесения изменений ,
bfAttachments (Array[BfAttachment], optional)Прикрепленные большие файлы ,
contentInfo (string, optional)Информация об изменениях

При переуступке валютного кредитного договора физическому лицу - резиденту, в данном поле необходимо указать информацию о физ.лице - резиденте в следующем порядке: Переуступка физическому лицу - резиденту; <ФИО>; <ИНН>; <Субъект Российской Федерации>, <Район, город>, <Населенный пункт>, <Улица (проспект, переулок и т. д.)>, <Дом (владение)>, <Корпус (строение)>, <Офис (квартира)>.
При данном виде изменения необходимо обязательно добавить подтверждающие документы во вложение (блок BfAttachment) ,
contractExternalId (string)Идентификатор изменяемого контракта в организации-партнере ,
externalId (string)Идентификатор документа в организации-партнере ,
inUSRLE (boolean)Изменения в ЕГРЮЛ/ЕГРИП ,
prolongation (boolean)Пролонгация
}CredRepayPaymentChangeable {
condition (string, optional)Особые условия ,
currencyCode (string)Цифровой код валюты платежа ,
interestAmount (number, optional)Сумма платежа по процентам ,
interestDate (string, optional)Дата платежа (процентный) ,
principalAmount (number, optional)Сумма платежа по основному долгу ,
principalDate (string, optional)Дата платежа (основной долг)
}CreditAttractionChangeable {
amount (number, optional)Сумма привлечения резидентом кредита, предоставленного нерезидентами ,
interestCredit (number, optional)Доля в общей сумме кредита, % ,
nonResidentCountryCode (string, optional)Цифровой код страны нерезидента ,
nonResidentName (string, optional)Наименование нерезидента
}Signature {
base64Encoded (string)Значение электронной подписи, закодированное в Base64 ,
certificateUuid (string)Уникальный идентификатор сертификата ключа проверки электронной подписи (UUID)
}BankControlStatementNonResident {
countryCode (string)Цифровой код страны ,
countryName (string)Наименование страны ,
name (string)Наименование иностранного контрагента
}CurrCredTrancheChangeable {
amount (number, optional)Сумма ,
currencyCode (string, optional)Цифровой код валюты ,
entryDate (string, optional)Ожидаемая дата поступления ,
periodCode (string, optional)Код срока привлечения
}BankControlStatementChangeBasisDoc {
date (string)Дата документа-основания ,
number (string, optional)Номер документа-основания
}BfAttachment {
fileId (string, optional)Уникальный идентификатор файла ,
fileName (string, optional, read only)Имя файла
}

Пример запроса

{
   "actualDebtAmount":1.01,
   "amount":1.01,
   "bankComment":"string",
   "bankControlStatementChangeApplicationInfo":{
      "authPersonName":"Иванов Иван Иванович",
      "authPersonTelfax":"4955005550",
      "basisDocs":[
         {
            "date":"2018-12-31",
            "number":"2222222222"
         }
      ],
      "bfAttachments":[
         {
            "fileId":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
            "fileName":"SB_7718830000_40702810038290010000_T18.txt"
         }
      ],
      "contentInfo":"Изменение траншей и процентных платежей по кредитному договору",
      "contractExternalId":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
      "externalId":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
      "inUSRLE":false,
      "prolongation":false
   },
   "bankStatus":"string",
   "collateralAmount":1.01,
   "contractDate":"2018-12-31",
   "contractEndDate":"2018-12-31",
   "contractNumber":"123АБВ",
   "credRepayPayments":[
      {
         "condition":"АБВ123",
         "currencyCode":"840",
         "interestAmount":1.01,
         "interestDate":"2018-12-31",
         "principalAmount":1.01,
         "principalDate":"2018-12-31"
      }
   ],
   "creditAttractions":[
      {
         "amount":1.01,
         "interestCredit":1.01,
         "nonResidentCountryCode":"643",
         "nonResidentName":"Kazan"
      }
   ],
   "creditPayPeriodCode":"1",
   "currFixInterestRate":1.01,
   "currencyCode":"840",
   "currencyEarningsAmount":1.01,
   "date":"2018-12-31",
   "digestSignatures":[
      {
         "base64Encoded":"HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT+/T24S0mPfVCU75sieOMt71TBS7w==",
         "certificateUuid":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6"
      }
   ],
   "hasDirectInvesting":false,
   "increaseRate":1.01,
   "liborRate":"Л06",
   "nonResidents":[
      {
         "countryCode":"643",
         "countryName":"РОССИЯ",
         "name":"Kazan"
      }
   ],
   "number":"1",
   "otherPayments":"АБВ123",
   "otherRateMethod":"АБВ123",
   "tranches":[
      {
         "amount":1.01,
         "currencyCode":"840",
         "entryDate":"2018-12-31",
         "periodCode":"1"
      }
   ],
   "transferAmount":1.01
}

В случае, если необходимо:

  • Удалить бизнес-данные - отправляется параметр со значением null "a": null

  • Удалить json объект:

    • отправляется json объект в виде "creditAttractions": [{"a": 1}, null, {"b": 1}]
    • сортировка объектов в массиве должна соответствовать сортировке в контракте, которую требуется изменить
    • новый объект в массив добавляется последним.

  • Изменить бизнес-данные - отправляется параметр/объект с измененными значениями

  • Добавить бизнес-данные - добавить параметр со значением НЕ null

Заявление о внесении изменений, в котором абсолютно все бизнес-данные соответствуют валютному контракту, обработано не будет, т.е. документ должен содержать дельту.

Алгоритм сортировки дайджеста

Теги дайджеста должны быть отсортированы по алфавиту. В таблице bfAttachments UUID-ы сортируются по возрастанию.
В таблице NonResidents данные сортируются аналогично сортировке в исходном документе. В дайджесте не указываются значения Number и блок linkedDocs.

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

Наименование поляОписание поляПример
actualDebtAmountСумма фактической задолженности по основному долгу1.00
amountСумма кредитного договора1.00
bankControlStatementChangeApplicationInfo.authPersonNameФИО ответственного лицаИванов Иван Иванович
bankControlStatementChangeApplicationInfo.authPersonTelfaxТелефон ответственного лица4955005550
bankControlStatementChangeApplicationInfo.contentInfoИнформация об измененияхИзменение траншей и процентных платежей по кредитному договору
bankControlStatementChangeApplicationInfo.contractExternalIdИдентификатор документа, по которому отправляется ЗОВИ
bankControlStatementChangeApplicationInfo.externalIdИдентификатор документа в организации-партнереc18835bc-c43e-425c-80ba-354d62094e93
bankControlStatementChangeApplicationInfo.inUSRLEНаименование организации клиентаООО "ТЕСТ"
bankControlStatementChangeApplicationInfo.prolongationИНН организации клиента7707083893
collateralAmountСумма залогового или другого обеспечения1.00
contractDateДата кредитного договора26.09.2019
contractEndDateДата окончания обязательств по договору26.09.2019
contractNumberНомер кредитного договора123АБВ
creditPayPeriodCodeКод срока привлечения (предоставления)1
currFixInterestRateФиксированный размер процентной ставки1.0000
currencyCodeЦифровой код валюты кредитного договора840
currencyEarningsAmountСумма, подлежащая погашению за счет валютной выручки1.00
dateДата создания документа по местному времени в формате YYYY-MM-DD26.09.2019
hasDirectInvestingПризнак наличия отношений прямого инвестированияtrue
hasSchedulePaymentsInCreditОснования для заполнения графика платежей (п. 8.2 181-И)true
increaseRateРазмер процентной надбавки1.0000
liborRateКод ставки LiborЛ06
Заполняется, если interestRateMethod=1
otherPaymentsИные платежи, предусмотренные кредитным договоромАБВ123
otherRateMethodОписание метода определения ставкиАБВ123
transferAmountСумма, подлежащая зачислению на счета за рубежом1.00
TABLESЗначение указывается при наличии UUID-ов больших файлов или данных по платежам/траншам/нерезидентам
Table=BasicDocsДокументы-основания для внесения изменений в ВБК
dateДата документа-основания26.09.2019
numberНомер документа-основания12
Table=BfAttachmentsЗначение указывается при наличии UUID-ов больших файлов
fileIdUUID БФ853b4bf6-2c6e-4020-a18f-289df39f78b8
#Разделитель
Table=CredRepayPaymentsГрафик платежей по кредитному договору
conditionОсобые условияАБВ123
currencyCodeЦифровой код валютыUSD
interestAmountСумма платежа по процентам1.00
interestDateДата платежа (процентный)26.09.2019
principalAmountСумма платежа по основному долгу1.00
principalDateДата платежа (основной долг)26.09.2019
#
Table=CreditAttractionsПривлечение кредита на синдицированной (консорциональной) основе
amountСумма1.00
currencyCodeЦифровой код валюты840
interestCreditДоля в общей сумме кредита, %1.00
nonResidentCountryCodeЦифровой код страны нерезидента38
nonResidentNameНаименование нерезидентаKazan
#Разделитель
Table=NonResidents
countryCodeЦифровой код страны38
countryNameНаименование страныКазахстан
nameНаименование нерезидентаKazan
#Разделитель
Table=TranchesИнформация о траншах по кредиту
amountСумма транша1.00
currencyCodeЦифровой код валюты транша840
entryDateОжидаемая дата поступления26.09.2019
periodCodeКод срока привлечения1
#Разделитель

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

actualDebtAmount=1.00
amount=1.00
bankControlStatementChangeApplicationInfo.authPersonName=Иванов Иван Иванович
bankControlStatementChangeApplicationInfo.authPersonTelfax=4955005550
bankControlStatementChangeApplicationInfo.contentInfo=Изменение траншей и процентных платежей по кредитному договору
bankControlStatementChangeApplicationInfo.contractExternalId=1e86c524-4c7b-4bbb-9af5-eb86d22760bd
bankControlStatementChangeApplicationInfo.externalId=d48d95e9-ae3e-491e-a9b3-53d6d5bc683b
bankControlStatementChangeApplicationInfo.inUSRLE=false
bankControlStatementChangeApplicationInfo.prolongation=false
collateralAmount=1.00
contractDate=2019-09-26
contractEndDate=2019-09-26
contractNumber=123АБВ
creditPayPeriodCode=1
currFixInterestRate=1.0000
currencyCode=840
currencyEarningsAmount=1.00
date=2019-09-26
hasDirectInvesting=true
hasSchedulePaymentsInCredit=true
increaseRate=1.0000
liborRate=Л06
otherPayments=АБВ123
otherRateMethod=АБВ123
transferAmount=1.00
TABLES
Table=BasicDocs
date=2019-09-26
number=123АБВ
#
Table=BfAttachments
fileId=853b4bf6-2c6e-4020-a18f-289df39f78b8
#
Table=CredRepayPayments
condition=АБВ123
currencyCode=840
interestAmount=1.00
interestDate=2019-09-26
principalAmount=1.00
principalDate=2019-09-26
#
Table=CreditAttractions
amount=1.00
currencyCode=840
interestCredit=1.00
nonResidentCountryCode=038
nonResidentName=Kazan
#
Table=NonResidents
countryCode=038
countryName=Казахстан
name=Kazan
#
Table=Tranches
amount=1.00
currencyCode=840
entryDate=2019-09-26
periodCode=1
#
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.