12. Постановка на учет внешнеторгового контракта (УНК)
URI
POST: /API/v1/ISO20022/Contracts
XSD схема
auth.018.001.01
Алгоритм определения продавца и покупателя
Особенностью схемы auth.018 является возможность заполнения данных по контрагенту (с кем заключается контракт) в разделе Buyr или Sellr на усмотрение пользователя.
-
ИНН резидента (CtrctRegnReq.GrpHdr.InitgPty.Id.OrgId.Othr.Id), где SchmeNm.Cd = 'TXID' — обязательное поле
-
Одно из полей ИНН является обязательным (SchmeNm.Cd = 'TXID'):
-
Buyr.PtyId.Id.OrgId.Othr.Id
-
Sellr.PtyId.Id.OrgId.Othr.Id
-
-
Если значение ИНН из п.1 равно ИНН из Buyr, то резидент - покупатель. Если из Sellr, то резидент - продавец.
Описание схемы
Описание | Путь | Комментарий Пример |
||
---|---|---|---|---|
Общий путь Document.CtrctRegnReq.GrpHdr |
||||
1 |
R |
Уникальный id сообщения |
MsgId |
Указывается идентификатор сообщения присвоенный во внешней системе |
2 |
R |
Дата и время создания сообщения |
CreDtTm |
Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3). |
3 |
R |
Количество транзакций в сообщении |
NbOfItms |
Общее число контрактов (секций CtrctRegnOpng) в сообщении |
4 |
R |
ИНН организации резидента |
InitgPty.Id.OrgId.Othr[1].Id |
ИНН, по которому определяется организация-инициатор контракта |
5 |
R |
Признак использования ИНН |
InitgPty.Id.OrgId.Othr[1].SchmeNm.Cd |
Константа "TXID" |
6 |
R |
Номер счета резидента |
InitgPty.Id.OrgId.Othr[2].Id |
Номер счета, по которому определяется организация-инициатор контракта |
7 |
R |
Признак использования счета |
InitgPty.Id.OrgId.Othr[2].SchmeNm.Cd |
Константа "ACC" |
Общий путь Document.CtrctRegnReq.CtrctRegn |
||||
8 |
R |
Уникальный id пакета |
CtrctRegnId |
Указывается идентификатор группы контрактов |
9 |
R |
Наименование резидента |
RptgPty.PtyId.Nm |
Не более 140 символов |
10 |
R |
Секция адрес резидента |
RptgPty.PtyId.PstlAdr |
|
11 |
O |
Тип адреса |
RptgPty.PtyId.PstlAdr.AdrTp |
Константа ADDR |
12 |
O |
Корпус/строение |
RptgPty.PtyId.PstlAdr.Dept |
|
13 |
O |
Квартира/офис |
RptgPty.PtyId.PstlAdr.SubDept |
|
14 |
O |
Улица |
RptgPty.PtyId.PstlAdr.StrtNm |
|
15 |
O |
Номер дома |
RptgPty.PtyId.PstlAdr.BldgNb |
|
16 |
O |
Город |
RptgPty.PtyId.PstlAdr.TwnNm |
|
17 |
O |
Регион |
RptgPty.PtyId.PstlAdr.DstrctNm |
Щекинский район |
18 |
O |
Субъект |
RptgPty.PtyId.PstlAdr.CtrySubDvsn |
Санкт-Петербург |
19 |
O |
Код страны |
RptgPty.PtyId.PstlAdr.Ctry |
RU |
20 |
O |
Полный адрес |
RptgPty.PtyId.PstlAdr.AdrLine |
Максимум 70 символов |
21 |
R |
ИНН организации резидента |
RptgPty.PtyId.Id.OrgId.Othr.Id |
ИНН, по которому определяется организация-инициатор контракта |
22 |
R |
Признак использования ИНН |
RcvgPty.Id.OrgId.Othr[1].SchmeNm.Cd |
Константа "TXID" |
23 |
O |
Код страны резидента |
RptgPty.PtyId.CtryOfRes |
RU |
24 |
R |
ОГРН |
RptgPty.LglOrg.Id |
|
25 |
R |
Дата регистрации ОГРН |
RptgPty.LglOrg.RegnDt |
|
26 |
R |
КПП |
RptgPty.TaxPty.TaxTp |
|
27 |
R |
Код клиринговой системы |
RegnAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd |
Константа "RUCBC" |
28 |
R |
БИК банка/отделения обслуживающего счет |
RegnAgt.FinInstnId.ClrSysMmbId.MmbId |
|
29 |
R |
Наименование банка |
RegnAgt.FinInstnId.Nm |
Требуется указать филиал банка, где обслуживается организация |
Общий путь Document.CtrctRegnReq.CtrctRegn |
||||
30 |
R |
Уникальный id контракта |
CtrctRegnOpng.CtrctRegnOpngId |
|
31 |
R |
Срочность оформления УНК |
CtrctRegnOpng.Prty |
HIGH - в течение дня, NORM - в течение 3 дней |
32 |
O |
Номер ранее оформленного номера УНК |
CtrctRegnOpng.PrvsRegnId.Id |
Заполняется только по п.10.2 Инструкции № 181-И (при уступке/переводе долга по контракту с нерезидентом резидентом на другого резидента). Пример: 11111111/3333/4444/1/1 |
33 |
R |
Код типа контракта/договора |
CtrctRegnOpng.SplmtryData.Envlp.AdditionalData.ContractType |
1 - Экспорт товаров |
34 |
O |
Вложения к контракту |
CtrctRegnOpng.Attchmnt |
Описание файлов-вложений к контракту. Подробнее в разделе (Работа с вложенными файлами) |
Общий путь Document.CtrctRegnReq.CtrctRegn.CtrctRegnOpng.Ctrct.Trad |
||||
35 |
R |
Номер контракта |
CtrctDocId.Id |
|
36 |
R |
Дата контракта |
CtrctDocId.DtOfIsse |
YYYY-MM-DD |
37 |
O |
Сумма контракта |
Amt Ccy |
|
38 |
O |
ИНН покупателя |
[Buyr Sellr<>InitgPty].PtyId.Id.OrgId.Othr.Id, где SchmeNm/Cd=TXID |
Обязательно к заполнению, если ИНН равен CtrctRegnReq.GrpHdr.InitgPty.Id.OrgId.Othr.Id, где SchmeNm.Cd = 'TXID' Один из тегов с этим замечанием должен быть обязательно и содержать ИНН клиента |
39 |
O |
ИНН продавца |
[Buyr Sellr<>InitgPty].PtyId.Id.OrgId.Othr.Id, где SchmeNm/Cd=TXID |
Обязательно к заполнению, если ИНН равен CtrctRegnReq.GrpHdr.InitgPty.Id.OrgId.Othr.Id, где SchmeNm.Cd = 'TXID' Один из тегов с этим замечанием должен быть обязательно и содержать ИНН клиента |
40 |
O |
Код страны контрагента |
[Buyr Sellr<>InitgPty].PtyId.CtryOfRes |
Обязательно к заполнению один из тегов |
41 |
O |
Наименование контрагента |
[Buyr Sellr<>InitgPty].PtyId.Nm |
|
42 |
R |
Дата завершения контракта/договора |
MtrtyDt |
YYYY-MM-DD |
43 |
R |
Признак пролонгации |
PrlngtnFlg |
Обязательно к заполнению по схеме, на создание УНК не влияет. |
44 |
R |
Дата начала обязательств по торговому контракту |
StartDt |
YYYY-MM-DD. Обязательно к заполнению по схеме, на создание УНК не влияет. |
45 |
R |
Валюта контракта |
SttlmCcy |
Валюта расчетов должна совпадать с валютой в сумме контракта. |
Пример: Создание контракта
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.018.001.01" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<CtrctRegnReq>
<GrpHdr>
<MsgId>ABC-CRR-20200324_2</MsgId>
<CreDtTm>2020-03-23T12:22:10+03:00</CreDtTm>
<NbOfItms>1</NbOfItms>
<InitgPty>
<Id>
<OrgId>
<Othr>
<Id>40702810200000000083</Id>
<SchmeNm>
<Cd>ACC</Cd>
</SchmeNm>
</Othr>
<Othr>
<Id>7013602245</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
</InitgPty>
</GrpHdr>
<CtrctRegn>
<CtrctRegnId>ABC-CRR-20200324-04451111</CtrctRegnId>
<RptgPty>
<PtyId>
<Nm>ООО "Тест Альфа-Линк"</Nm>
<PstlAdr>
<Dept>1</Dept>
<SubDept>11</SubDept>
<StrtNm>Уличная</StrtNm>
<TwnNm>Городской</TwnNm>
<CtrySubDvsn>Московская область</CtrySubDvsn>
</PstlAdr>
<Id>
<OrgId>
<Othr>
<Id>7013602245</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
<CtryOfRes>RU</CtryOfRes>
</PtyId>
<LglOrg>
<Id>10000000321</Id>
<RegnDt>2015-01-01</RegnDt>
</LglOrg>
<TaxPty>
<TaxTp>123000009</TaxTp>
</TaxPty>
</RptgPty>
<RegnAgt>
<FinInstnId>
<ClrSysMmbId>
<ClrSysId>
<Cd>RUCBC</Cd>
</ClrSysId>
<MmbId>044525593</MmbId>
</ClrSysMmbId>
<Nm>АО Альфа-Банкк</Nm>
</FinInstnId>
</RegnAgt>
<CtrctRegnOpng>
<CtrctRegnOpngId>ABC-CRR-20200324-044511111-02</CtrctRegnOpngId>
<Prty>HIGH</Prty>
<Ctrct>
<Trad>
<CtrctDocId>
<Id>23032020</Id>
<DtOfIsse>2020-03-08</DtOfIsse>
</CtrctDocId>
<Amt Ccy="USD">1400000.00</Amt>
<Buyr>
<PtyId>
<Id>
<OrgId>
<Othr>
<Id>7013602245</Id>
<SchmeNm>
<Cd>TXID</Cd>
</SchmeNm>
</Othr>
</OrgId>
</Id>
<CtryOfRes>RU</CtryOfRes>
</PtyId>
</Buyr>
<Sellr>
<PtyId>
<Nm>ООО Альфа-Линк корпорашн</Nm>
<CtryOfRes>KZ</CtryOfRes>
</PtyId>
</Sellr>
<MtrtyDt>2021-07-04</MtrtyDt>
<PrlngtnFlg>false</PrlngtnFlg>
<StartDt>2099-02-01</StartDt>
<SttlmCcy>USD</SttlmCcy>
</Trad>
</Ctrct>
<PrvsRegnId>
<Id>11111111/3333/4444/1/1</Id>
</PrvsRegnId>
<SplmtryData>
<Envlp>
<AdditionalData>
<ContractType>3</ContractType>
</AdditionalData>
</Envlp>
</SplmtryData>
</CtrctRegnOpng>
</CtrctRegn>
<SplmtryData>
<Envlp>
<SgntrSt>
</SgntrSt>
</Envlp>
</SplmtryData>
</CtrctRegnReq>
</Document>
Коды ответов
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 |
Документ не соответствует схеме |