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

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

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

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

URI

POST: /API/v1/ISO20022/ConfCertificates

XSD схема

auth.025.001.01

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

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

Секция 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

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

Ответ

auth.027.001.01

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

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

Пример неподписанного СПД
<?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>025001011700000000000000019</MsgId>
      <CreDtTm>2021-02-24T17:42:40.477+03:00</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>025001011700000000000000019</SpprtgDocId>
      <Cert>
        <Id>025001011700000000000000019</Id>
        <DtOfIsse>2021-02-24</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>20010160/1326/0000/2/1</RegdCtrctId>
      </CtrctRef>
      <Ntry>
        <NtryId>025001011700000000000000019</NtryId>
        <OrgnlDoc>
          <Id>025001011700000000000000019</Id>
          <DtOfIsse>2021-02-24</DtOfIsse>
        </OrgnlDoc>
        <DocTp>02_4</DocTp>
        <TtlAmt Ccy="RUR">100.00</TtlAmt>
        <ShipmntAttrbts>
          <Conds>
            <Prtry>3</Prtry>
          </Conds>
          <CtryOfCntrPty>RU</CtryOfCntrPty>
        </ShipmntAttrbts>
        <AddtlInf>тестирование h2h</AddtlInf>
      </Ntry>
    </SpprtgDoc>
    <SplmtryData>
      <Envlp>
      </Envlp>
    </SplmtryData>
  </CcyCtrlSpprtgDocDlvry>
</Document>
Пример СПД с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива