18. Справка о подтверждающих документах

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

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

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

URI

POST: /API/v1/ISO20022/ConfCertificates

XSD схема

auth.025.001.01

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

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

Секция Document.CcyCtrlSpprtgDocDlvry.GrpHdr

1

R

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

MsgId

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

2

R

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

CreDtTm

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

3

R

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

NbOfItms

-

4

R

ИНН организации

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

-

5

R

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

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

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

6

R

Счет организации

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

-

7

R

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

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

Константа 'ACC'

Секция Document.CcyCtrlSpprtgDocDlvry.GrpHdr.SpprtgDoc

8

R

Уникальный ID СПД

SpprtgDocId

-

9

R

Уникальный id СПД (сквозной) во внешней системе

Cert.Id

-

10

R

Дата СПД

Cert.DtOfIsse

-

11

R

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

AcctOwnr.Nm

-

12

R

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

AcctOwnr.Id.OrgId.Othr.Id

-

13

R

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

AcctOwnr.Id.OrgId.Othr.SchmeNm.Cd

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

14

R

Признак использования БИК в качестве идентификатора Банка

AcctSvcr.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

15

R

БИК Банка

AcctSvcr.FinInstnId.ClrSysMmbId.MmbId

-

16

R

Номер УНК

CtrctRef.RegdCtrctId

-

Секция Document.CcyCtrlSpprtgDocDlvry.GrpHdr.SpprtgDoc.Ntry

17

R

Уникальный ID строки СПД

NtryId

-

18

R

Номер подтверждающего документа (графа 2)

OrgnlDoc.Id

-

19

O

Дата подтверждающего документа (графа 3)

OrgnlDoc.DtOfIsse

-

20

R

Код вида подтверждающего документа (графа 4)

DocTp

-

21

R

Код валюты документа (графа 5)

TtlAmt@Ccy

<TtlAmt Ccy="EUR">2000.00</TtlAmt>

22

R

Сумма по подтверждающему документу в единицах валюты документа (графа 6)

TtlAmt@Ccy

< TtlAmt Ccy="EUR"> 2000.00</TtlAmt>

23

О

Сумма аванса (при импорте) или сумма оплаты по факту (при экспорте) в единицах валюты документа (графа 6)

TtlAmtAftrShipmnt

-

24

О

Код валюты контракта (графа 7)

TtlAmtInCtrctCcy@Ccy

<TtlAmtInCtrctCcy Ccy="EUR">2000.00</TtlAmtInCtrctCcy>

25

О

Сумма по подтверждающему документу в единицах валюты контракта/договора (графа 8)

TtlAmtInCtrctCcy@Ccy

< TtlAmtInCtrctCcy Ccy="EUR"> 2000.00</TtlAmtInCtrctCcy>

26

О

Сумма аванса (при импорте) или сумма оплаты по факту (при экспорте) в единицах валюты контракта/договора (графа 8)

TtlAmtAftrShipmntInCtrctCcy

-

27

O

Признак поставки (графа 9)

ShipmntAttrbts.Conds.Prtry

-

28

O

Ожидаемый срок (графа 10)

ShipmntAttrbts.XpctdDt

-

29

O

Код страны грузоотправителя/грузополучателя (графа 11)

ShipmntAttrbts.CtryOfCntrPty

-

30

O

Примечание

AddtlInf

-

31

O

Вложения к СПД

Attchmnt

Описание файлов-вложений к СПД. Подробнее в разделе (Работа с вложенными файлами)

Секция Document.CcyCtrlSpprtgDocDlvry.GrpHdr.SpprtgDoc.SplmtryData/Envlp/SpprtgDocAddInf/NtryAddInfo

32

O

Идентификатор NtryId соответствующего объекта Ntry

NtryId

-

33

O

Признак оформления декларации на товары на бумажном носителе

DTnPpr

Возможные значение true/false

34

O

Признак представления документов и (или) информации по СФ подтверждающих безвозмездную поставку

DcFrPst

Возможные значение true/false

35

O

Код страны

CtryNmbrCd

Одно из возможных значений - 156 для Китая

Блок с подписью Document.CcyCtrlSpprtgDocDlvry

36

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Таблица кодов ответа

auth.027.001.01

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

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

Пример неподписанного СПД
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.025.001.01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CcyCtrlSpprtgDocDlvry>
        <GrpHdr>
            <MsgId>MSG_TEST_15-03-2024-20240315</MsgId>
            <CreDtTm>2024-03-15T17:11:13.951</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Pty>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                            <Othr>
                                <Id>40702810200000000083</Id>
                                <SchmeNm>
                                    <Cd>ACC</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Pty>
            </InitgPty>
        </GrpHdr>
        <SpprtgDoc>
            <SpprtgDocId>TEST_SPPRTG_15-03-2024-20240315</SpprtgDocId>
            <Cert>
                <Id>ID_TEST_15-03-2024-20240315</Id>
                <DtOfIsse>2024-03-15</DtOfIsse>
            </Cert>
            <AcctOwnr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </AcctOwnr>
            <AcctSvcr>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </AcctSvcr>
            <CtrctRef>
                <RegdCtrctId>22010012/1326/0000/1/1</RegdCtrctId>
            </CtrctRef>
            <Ntry>
                <NtryId>TEST_NTRY_15-03-2024-20240315</NtryId>
                <OrgnlDoc>
                    <Id>20220118</Id>
                    <DtOfIsse>2024-03-15</DtOfIsse>
                </OrgnlDoc>
                <DocTp>0023</DocTp>
                <TtlAmt Ccy="RUR">100.00</TtlAmt>
                <ShipmntAttrbts>
                    <Conds>
                        <Prtry>3</Prtry>
                    </Conds>
                    <CtryOfCntrPty>AU</CtryOfCntrPty>
                </ShipmntAttrbts>
                <AddtlInf>Тестирование h2h</AddtlInf>
            </Ntry>
            <SplmtryData>
                <Envlp>
                    <SpprtgDocAddInf>
                        <NtryAddInfo>
                            <NtryId>TEST_NTRY_15-03-2024-20240315</NtryId>
                            <CtryNmbrCd>156</CtryNmbrCd>
                            <DTnPpr>true</DTnPpr>
                            <DcFrPst>true</DcFrPst>
                        </NtryAddInfo>
                    </SpprtgDocAddInf>
                </Envlp>
            </SplmtryData>
        </SpprtgDoc>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CcyCtrlSpprtgDocDlvry>
</Document>
Пример СПД с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива