15. Получение подтверждения об операциях с внешнеторговым контрактом (УНК)

URI

Тип документа Метод Ссылка Комментарий

Подтверждение постановки на учет внешнеторгового контракта

GET

/API/v1/ISO20022/Contracts/Confirmations/<CtrctRegnOpngId>

Если в момент вызова контракт не поставлен на учет, возвращается 404 ошибка.

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

GET

/API/v1/ISO20022/Contracts/Confirmations/<RegdCtrctAmdmntId>

Если в момент вызова в контракт не внесены изменения, возвращается 404 ошибка.

Подтверждение снятия внешнеторгового контракта с учета

GET

/API/v1/ISO20022/Contracts/Confirmations/<RegdCtrctClsId>

Если в момент вызова контракт не снят с учета, возвращается 404 ошибка.

Схема XML-документа в ответе

auth.019.001.01

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

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

Document.CtrctRegnConf.GrpHdr

1

R

Идентификатор сообщения

MsgId

2

R

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

CreDtTm

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

3

R

Число элементов в сообщении

NbOfItms

4

R

Наименование организации получателя сообщения

NbOfItms

RcvgPty.Nm

5

R

ИНН организации получателя сообщения

RcvgPty.Id.OrgId.Othr.Id

6

R

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

RcvgPty.Id.OrgId.Othr.SchmeNm.Cd

Константа 'TXID'

7

R

ISO тип данных для БИК Банка

RegnAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

Константа 'RUCBC'

8

R

БИК Банка

RegnAgt.FinInstnId.ClrSysMmbId.MmbId

Константа '44525593'

9

R

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

RegnAgt.FinInstnId.Nm

Document.CtrctRegnConf.RegdCtrct

10

R

ID запроса при создании УНК

OrgnlCtrctRegnReq.MsgId

11

R

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

RptgPty.PtyId.Nm

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.TwnLctnNm

18

O

Регион

RptgPty.PtyId.PstlAdr.DstrctNm

19

O

Субъект

RptgPty.PtyId.PstlAdr.CtrySubDvsn

20

R

ИНН клиента

RptgPty.PtyId.Id.OrgId.Othr.Id

21

0

ОГРН

RptgPty.LglOrg.Id

22

0

Дата ОГРН

RptgPty.LglOrg.RegnDt

23

0

КПП

RptgPty.TaxPty.TaxTp

24

R

ISO тип данных для БИК банка

RegnAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

константа 'RUCBC'

25

R

БИК Банка

RegnAgt.FinInstnId.ClrSysMmbId.MmbId

константа '044525593'

26

R

Наименование банка отправившего сообщение

RegnAgt.FinInstnId.Nm

27

R

ISO тип данных для БИК банка

IssrFI.FinInstnId.ClrSysMmbId.ClrSysId.Cd

28

R

БИК Банка

IssrFI.FinInstnId.ClrSysMmbId.MmbId

константа '044525593'

29

R

Наименование банка выпустивший контракт

IssrFI.FinInstnId.Nm

30

R

Номер контракта

Ctrct.Trad.CtrctDocId.Id

31

R

Дата контракта

Ctrct.Trad.CtrctDocId.DtOfIsse

32

R

Сумма, валюта контракта

Ctrct.Trad.Amt Ccy

Если сумма не указана, то 0

33

R

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

Ctrct.Trad/[Buyr Sellr]/PtyId.Nm

34

R

ИНН клиента.контрагента

RegdCtrct.Ctrct.Trad.[Buyr Sellr].PtyId.Id.OrgId.Othr.Id

35

R

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

Ctrct/Trad/[Buyr Sellr]/PtyId/Id/OrgId/Othr/SchmeNm/Cd

Константа 'TXID'

36

R

Страна контрагента

Ctrct.Trad.[Buyr Sellr].PtyId.CtryOfRes

37

R

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

RegdCtrct.Ctrct.Trad/[Buyr Sellr]/PtyId.Nm

38

R

Дата окончания контракта

Ctrct.Trad.MtrtyDt

39

R

Изменение контракта

Ctrct.Trad.PrlngtnFlg

40

R

Дата начала контракта

Ctrct.Trad.StartDt

41

R

Валюта контракта

Ctrct.Trad.SttlmCcy

42

R

Номер УНК

RegdCtrctId.Id

43

R

Дата УНК

RegdCtrctId.DtOfIsse

44

O

Номер прошлого УНК

PrvsRegdCtrctId.Id

45

R

ISO тип данных для БИК банка

RegdCtrctJrnl.RegnAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

46

R

БИК Банка

RegdCtrctJrnl.RegnAgt.FinInstnId.ClrSysMmbId.MmbId

константа '044525593'

47

R

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

RegdCtrctJrnl.RegnAgt.FinInstnId.Nm

константа '044525593'

48

R

Дата снятия контракта с учета

RegdCtrctJrnl.ClsrDt

Если дата не заполнена, возвращается 0001-01-01

49

R

Код причины

RegdCtrctJrnl.ClsrRsn.Prtry

Если не заполнено, то возвращается NONE

50

R

Дата внесения изменений

Amdmnt.AmdmntDt

51

О

Номер документа на основании которого внесены изменения

Amdmnt.Doc.Id

52

R

Дата документа на основании которого внесены изменения

Amdmnt.Doc.DtOfIsse

53

R

Номер переоформления

Amdmnt.AddtlInf

54

R

Способ предоставления документов

Submissn.Mtd

ONLI константа

55

R

Дата предоставления документов

Submissn.Dt

56

R

Способ отправки документов

Dlvry.Mtd

57

R

Дата отправки документов

Dlvry.Dt

58

R

Указывает характер приведенных дат: оценочный.нет

EstmtdDtInd

true - константа, заполняется т.к. обязательно по схеме

59

R

Признак внутрикорпоративного займа (заемщик и кредитор являются частями одной корпорации)

IntrCpnyLn

false - константа, заполняется т.к. обязательно по схеме

Пример: Подтвержданный контракт (УНК)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.019.001.01">
    <CtrctRegnConf>
        <GrpHdr>
            <MsgId>0ee922735d2a4624bf03dd361713ec55</MsgId>
            <CreDtTm>2023-02-08T15:09:47.685+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <RcvgPty>
                <Nm>Общество с ограниченной ответсвенностью "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </RcvgPty>
            <RegnAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "Альфа-Банк"</Nm>
                </FinInstnId>
            </RegnAgt>
        </GrpHdr>
        <RegdCtrct>
            <OrgnlCtrctRegnReq>
                <MsgId>TEST_ID_2023-02-08-181163</MsgId>
            </OrgnlCtrctRegnReq>
            <RptgPty>
                <PtyId>
                    <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Dept>1</Dept>
                        <SubDept>11</SubDept>
                        <StrtNm>Уличная</StrtNm>
                        <BldgNb>111</BldgNb>
                        <TwnNm>Городской</TwnNm>
                        <TwnLctnNm>Городское место</TwnLctnNm>
                        <DstrctNm>Городской район</DstrctNm>
                        <CtrySubDvsn>Московская область</CtrySubDvsn>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
                <LglOrg>
                    <Id>1092940217001</Id>
                    <RegnDt>2022-07-01</RegnDt>
                </LglOrg>
                <TaxPty>
                    <TaxTp>215045470</TaxTp>
                </TaxPty>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "Альфа-Банк"</Nm>
                </FinInstnId>
            </RegnAgt>
            <IssrFI>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "Альфа-Банк"</Nm>
                </FinInstnId>
            </IssrFI>
            <Ctrct>
                <Trad>
                    <CtrctDocId>
                        <Id>556437874</Id>
                        <DtOfIsse>2022-05-17</DtOfIsse>
                    </CtrctDocId>
                    <Amt Ccy="EUR">170170.8</Amt>
                    <Buyr>
                        <PtyId>
                            <Nm>Партнер1</Nm>
                            <Id>
                                <OrgId>
                                    <Othr>
                                        <Id>0000000000</Id>
                                        <SchmeNm>
                                            <Cd>TXID</Cd>
                                        </SchmeNm>
                                    </Othr>
                                </OrgId>
                            </Id>
                            <CtryOfRes>DE</CtryOfRes>
                        </PtyId>
                    </Buyr>
                    <Sellr>
                        <PtyId>
                            <Nm>Общество с ограниченной ответсвенностью "Тест Альфа-Линк"</Nm>
                            <Id>
                                <OrgId>
                                    <Othr>
                                        <Id>7013602245</Id>
                                        <SchmeNm>
                                            <Cd>TXID</Cd>
                                        </SchmeNm>
                                    </Othr>
                                </OrgId>
                            </Id>
                        </PtyId>
                    </Sellr>
                    <MtrtyDt>2023-02-08</MtrtyDt>
                    <PrlngtnFlg>false</PrlngtnFlg>
                    <StartDt>2022-05-17</StartDt>
                    <SttlmCcy>EUR</SttlmCcy>
                </Trad>
            </Ctrct>
            <RegdCtrctId>
                <Id>23020078/1326/0000/1/1</Id>
                <DtOfIsse>2023-02-08</DtOfIsse>
            </RegdCtrctId>
            <RegdCtrctJrnl>
                <RegnAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "Альфа-Банк"</Nm>
                    </FinInstnId>
                </RegnAgt>
                <ClsrDt>0001-01-01</ClsrDt>
                <ClsrRsn>
                    <Prtry>NONE</Prtry>
                </ClsrRsn>
            </RegdCtrctJrnl>
            <Submissn>
                <Mtd>ONLI</Mtd>
                <Dt>2023-02-08</Dt>
            </Submissn>
            <Dlvry>
                <Mtd>ONLI</Mtd>
                <Dt>2023-02-08</Dt>
            </Dlvry>
            <EstmtdDtInd>true</EstmtdDtInd>
            <IntrCpnyLn>false</IntrCpnyLn>
            <SplmtryData>
                <Envlp>
                    <ContractType>1</ContractType>
                </Envlp>
            </SplmtryData>
        </RegdCtrct>
    </CtrctRegnConf>
</Document>