13. Внесение изменений в I раздел ВБК (переоформление УНК)

Важная информация

Основания для внесения изменений в I раздел ВБК перечислены в главе 7 инструкции Банка России от 16.08.2017 №181-И. На стороне банка автоматически будет сформировано и отправлено от имени Вашей компании заявление о внесении изменений в I раздел ВБК.

Необходимо вносить изменения в раздел I ВБК в следующих случаях:

  • Изменение регистрационных данных резидента (наименование, ИНН, КПП, ОГРН). При смене юр.адреса – вносить изменения не надо;

Подтверждающие документы предоставлять не нужно.
  • Пролонгация контракта (без подписания дополнений);

Подтверждающие документы предоставлять не нужно.
  • Изменение сведений о контракте (валюта, сумма, дата) ;

Необходимо предоставить документы, подтверждающие изменения контракта.
  • Изменение сведений о контрагенте (наименование, страна) ;

Необходимо предоставить документы, подтверждающие изменения.
  • Уступка прав физическому лицу.

Необходимо предоставить документы, подтверждающие уступку требования по контракту другому резиденту либо перевод долга по контракту на другого резидента.

Подтверждающие документы необходимо прикладывать к запросу на внесение изменений
Подробнее в разделе [FILES_WITH]

Получение подтверждения о внесении изменений I раздел ВБК
GET /API/v1/ISO20022/Contracts/Confirmations/<RegdCtrctAmdmntId>

Если в момент вызова изменения в ВБК еще не внесены, возвращается 404 ошибка. Подробнее в разделе [ConConf_SCHEMA]

Информация для тестирования

Для получения статуса "Исполнен" [ACPT] необходимо корректно составить и подписать запрос (пример запроса есть ниже в настоящей документации). Затем необходимо написать на п/я h2h@alfabank.ru с просьбой провести операцию, поскольку все операции с валютой требуют авторизации.

Для получения статуса "Отклонен" [RJCT] достаточно, например, некорректно заполнить один из реквизитов.

URI

POST: /API/v1/ISO20022/Contracts/Reissue

XSD схема

auth.021.001.03

Описание схемы

Описание Путь Комментарий
Пример

Общий путь Document. CtrctRegnAmdmntReq.GrpHdr

1

R

Уникальный id сообщения

MsgId

Указывается идентификатор сообщения присвоенный во внешней системе

2

R

Дата и время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

R

Количество транзакций в сообщении

NbOfItms

Константа "1"

4

R

ИНН организации резидента

InitgPty.Id.OrgId.Othr[1].Id

ИНН, по которому определяется организация-инициатор внесения изменений в 1 раздел ВБК

5

R

Признак использования ИНН

InitgPty.Id.OrgId.Othr[1].SchmeNm.Cd

Константа "TXID"

6

R

Номер счета резидента

InitgPty.Id.OrgId.Othr[2].Id

Номер счета, по которому определяется организация-инициатор внесения изменений в 1 раздел ВБК

7

R

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

InitgPty.Id.OrgId.Othr[2].SchmeNm.Cd

Константа "ACC"

Общий путь Document.CtrctRegnAmdmntReq.CtrctRegnAmdmnt

8

R

Уникальный id пакета

CtrctRegnAmdmntId

Параметры (#9-14) отвечают за изменение регистрационных данных (пункты 1.1, 1.3-1.5 в печатной форме заявления). Заполнение обязательно, даже если данные не меняются.

9

R

Наименование резидента

RptgPty.PtyId.Nm

Не более 140 символов.

10

R

ИНН резидента

RptgPty.PtyId.Id.OrgId.Othr.Id

11

R

Признак использования ИНН

RptgPty.PtyId.Id.OrgId.Othr.SchmeNm.Cd

Константа "TXID"

12

R

КПП резидента

RptgPty.TaxPty.TaxTp

Не обязателен по схеме, но обязателен для корректного запроса.

13

R

ОГРН резидента

RptgPty.LglOrg.Id

Не обязателен по схеме, но обязателен для корректного запроса.

14

R

Дата регистрации ОГРН

RptgPty.LglOrg.RegnDt

Не обязателен по схеме, но обязателен для корректного запроса.

15

R

Код клиринговой системы

RegnAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

Константа "RUCBC"

16

R

БИК банка/отделения обслуживающего счет

RegnAgt.FinInstnId.ClrSysMmbId.MmbId

17

R

Наименование банка

RegnAgt.FinInstnId.Nm

Требуется указать филиал банка, где обслуживается организация

Общий путь Document.CtrctRegnAmdmntReq.RegdCtrctAmdmnt

18

R

Уникальный id запроса

RegdCtrctAmdmntId

19

R

Номер УНК

OrgnlRegdCtrctId

Пример: 11111111/3333/4444/1/1

20

R

Срочность

Prty

HIGH - в течение дня, NORM - в течение 3 дней

21

R

Номер договора

Ctrct.Trad.CtrctDocId.Id

22

О

Сумма и валюта договора

Ctrct.Trad.Amt@Ccy

Пример: <Amt Ccy="USD">1500.00<.Amt>

Следующие параметры Buyer/Seller необходимо заполнять только если у Вас меняется контрагент или информация по нему. Если нет, оставляйте тэги Buyr.PtyId и Sellr.PtyId пустыми. Если контрагент изменяется, то необходимо заполнить один из параметров Buyr/Sellr (в зависимости от того, кем является контрагент) данными контрагента (Например: Buyr.PtyId.Nm и Buyr.PtyId.CtryOfRes). А в другом параметре необходимо указать ИНН Вашей компании и константу (Например: Sellr.PtyId.Id.OrgId.Othr.Id и Sellr.PtyId.Id.OrgId.Othr.SchmeNm.Cd, где Cd=TXID)

23

O

ИНН покупателя

[Buyr Sellr<>InitgPty].PtyId.Id.OrgId.Othr.Id, где SchmeNm/Cd=TXID

Если тэги Buyr/Sellr не пустые, то один из них должен обязательно содержать ИНН клиента

24

O

ИНН продавца

[Buyr Sellr<>InitgPty].PtyId.Id.OrgId.Othr.Id, где SchmeNm/Cd=TXID

Если тэги Buyr/Sellr не пустые, то один из них должен обязательно содержать ИНН клиента

25

O

Код страны контрагента

[Buyr Sellr<>InitgPty].PtyId.CtryOfRes

26

O

Наименование контрагента

[Buyr Sellr<>InitgPty].PtyId.Nm

27

R

Дата завершения контракта/договора

Ctrct.Trad.MtrtyDt

YYYY-MM-DD

28

О

Пролонгация договора

Ctrct.Trad.PrlngtnFlg

TrueFalseIndicator 'True' – при пролонгации, без изменений условий контракта, 'False' – во всех остальных случаях

29

R

Дата начала контракта/договора

Ctrct.Trad.StartDt

YYYY-MM-DD.

30

O

Вложения

Attchmnt

Описание файлов-вложений.
[FILES_WITH]

Следующий блок добавляется только в случае переуступки прав/требований по контракту физ.лицу

31

О

Номер документа подтверждающего переход прав (требований) по контракту

SplmtryData.Envlp.AdditionalData.DocNum

В случае переуступки физ.лицу тэг является обязательным к заполнению

32

О

Дата документа подтверждающего переход прав (требований) по контракту

SplmtryData.Envlp.AdditionalData.DocDt

В случае переуступки физ.лицу тэг является обязательным к заполнению

33

О

ФИО физ.лица, которому переходят права (требования) (на которое переводится долг) по контракту

SplmtryData.Envlp.AdditionalData.IndNm

В случае переуступки физ.лицу тэг является обязательным к заполнению

34

О

ИНН физ.лица

SplmtryData.Envlp.AdditionalData.Inn

Блок с адресом физ.лица должен быть заполнен по максимуму

35

О

Корпус/строение

SplmtryData.Envlp.AdditionalData.PstlAdr.Dept

36

О

Квартира

SplmtryData.Envlp.AdditionalData.PstlAdr.SubDept

37

О

Улица

SplmtryData.Envlp.AdditionalData.PstlAdr.StrtNm

38

О

Дом

SplmtryData.Envlp.AdditionalData.PstlAdr.BldgNb

В случае переуступки физ.лицу тэг является обязательным к заполнению

39

О

Город

SplmtryData.Envlp.AdditionalData.PstlAdr.TwnNm

В случае переуступки физ.лицу обязателен к заполнению один из тегов: TwnNm или TwnLctnNm

40

О

Населенный пункт

SplmtryData.Envlp.AdditionalData.PstlAdr.TwnLctnNm

В случае переуступки физ.лицу обязателен к заполнению один из тегов: TwnNm или TwnLctnNm

41

О

Район

SplmtryData.Envlp.AdditionalData.PstlAdr.DstrctNm

42

О

Субъект в котором зарегистрировано физ.лицо

SplmtryData.Envlp.AdditionalData.PstlAdr.CtrySubDvsn

43

О

Полный адрес регистрации физ.лица

SplmtryData.Envlp.AdditionalData.PstlAdr.AdrLine

Ответ

Ответ приходит по схеме:

auth.027.001.01

Структура ответа описана в разделе [STS_AUTH]

Коды ответов

HTTP код Тип Body Описание

200

OK

-

Запрос принят без ошибок.

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

500

Err

Warrant service error

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

403

Err

User does not have permission

Нет прав на выполнение запроса

406

Err

Signature is missing

Нет подписи

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

403

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

500

Err

Internal Error

Внутренняя ошибка приложения

409

Err

MsgId is not unique

Id запроса неуникальный

400

Err

XML does not match schema

Документ не соответствует схеме

Пример запроса на внесение изменений в I раздел ВБК
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.021.001.03"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CtrctRegnAmdmntReq>
        <GrpHdr>
            <MsgId>746d6e4c-1f55-409d-a1a8-4a32553ff</MsgId><!-- Уникальный ID сообщения-->
            <CreDtTm>2023-01-01T18:13:51.0</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>ACC</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <CtrctRegnAmdmnt>
            <CtrctRegnAmdmntId>746d6e4c-1f55-409d-a1a8-4a32553ff</CtrctRegnAmdmntId><!-- Уникальный ID пакета-->
            <RptgPty>
                <PtyId>
                    <Nm>ООО "Тест Альфа-Линк"</Nm><!-- наименование резидента, отправившего запрос-->
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id><!-- ИНН резидента-->
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
                <LglOrg>
                    <Id>1092940217001</Id> <!-- ОГРН резидента-->
                    <RegnDt>2022-01-09</RegnDt> <!-- Дата ОГРН-->
                </LglOrg>
                <TaxPty>
                    <TaxTp>215045470</TaxTp> <!-- КПП резидента-->
                </TaxPty>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО Альфа-Банк</Nm>
                </FinInstnId>
            </RegnAgt>
            <RegdCtrctAmdmnt>
                <RegdCtrctAmdmntId>746d6e4c-1f55-409d-a1a8-4a32553ff</RegdCtrctAmdmntId><!-- Уникальный ID запроса на внесение изменений -->
                <OrgnlRegdCtrctId>23020018/1326/0000/9/1</OrgnlRegdCtrctId> <!-- УНК-->
                <Prty>NORM</Prty> <!-- Срочность внесения изменений-->
                <Ctrct>
                    <Trad>
                        <CtrctDocId>
                            <Id>123</Id> <!-- Номер контракта-->
                        </CtrctDocId>
                        <Amt Ccy="USD">80000.00</Amt> <!-- валюта и сумма контракта-->
                        <Buyr>
                           <PtyId>
                                <Id>
                                    <OrgId>
                                        <Othr>
                                            <Id>7013602245</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                            </PtyId>
                        </Buyr>
                        <Sellr>
                            <PtyId>
                                <Nm>TESTING COMPANY LIMITED</Nm><!-- Наименование контрагента-->
                                <CtryOfRes>AU</CtryOfRes> <!-- Страна резидентства контрагента-->
                            </PtyId>
                        </Sellr>
                        <MtrtyDt>2023-12-27</MtrtyDt> <!-- Дата окончания контракта-->
                        <PrlngtnFlg>false</PrlngtnFlg> <!-- Пролонгация-->
                        <StartDt>2023-01-20</StartDt> <!-- Дата начала контракта-->
                    </Trad>
                </Ctrct>
                <Attchmnt><!-- Документы, подтверждающие изменения-->
                    <DocTp>CСDC</DocTp> <!-- Константа-->
                    <DocNb>12A</DocNb> <!-- Номер документа-обоснования -->
                    <IsseDt>2023-01-27</IsseDt> <!-- Дата документа-обоснования -->
                    <URL>test.pdf</URL>
                    <AttchdBinryFile>
                        <MIMETp>NONE</MIMETp>
                    </AttchdBinryFile>
                </Attchmnt>
            </RegdCtrctAmdmnt>
        </CtrctRegnAmdmnt>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
  </CtrctRegnAmdmntReq>
</Document>