13. Внесение изменений в I раздел ВБК (переоформление УНК)
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 |
Описание файлов-вложений. |
Следующий блок добавляется только в случае переуступки прав/требований по контракту физ.лицу |
||||
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 |
Коды ответов
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>