16. Сведения о валютных операциях

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

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

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

URI

POST: /API/v1/ISO20022/COCertificates

XSD схема

auth.024.001.01

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

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

Общий путь Document.PmtRgltryInfNtfctn.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

O

Номер счёта

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

-

7

0

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

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

Константа "ACC"

Общий путь Document.PmtRgltryInfNtfctn.TxNtfctn

8

R

Уникальный id пакета СВО во внешней системе

TxNtfctnId

-

9

R

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

AcctOwnr.Nm

-

10

R

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

AcctOwnr.Id.OrgId.Othr.Id

-

11

R

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

AcctOwnr.Id.OrgId.Othr.SchmeNm.Cd

Константа "TXID"

12

R

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

AcctSvcr.FinInstnId.ClrSysMmbId.ClrSysId.Cd

Константа "RUCBC"

13

R

БИК Банка

AcctSvcr.FinInstnId.ClrSysMmbId.MmbId

-

14

R

Уникальный идентификатор СВО

TxCert.TxId

-

15

R

ID СВО во внешней системе

TxCert.Cert.Id

-

16

O

Дата СВО

TxCert.Cert.DtOfIsse

-

17

R

Номер счета резидента в уполномоченном банке

TxCert.Acct.Id.Othr.Id

-

18

R

Уникальный id строки СВО

TxCert.CertRcrd.CertRcrdId

-

19

O

Связка СВО с РСТС

TxCert.CertRcrd.Tx.RfrdDoc.Id.PmtInfId

Должно совпадать с полем в РСТС Document.CstmrCdtTrfInitn.PmtInf.PmtInfId (схема pain.001.01.06)

20

R

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

TxCert.CertRcrd.Tx.RfrdDoc.Id.EndToEndId

Допустимо значение БН (без номера)

21

R

Дата документа

TxCert.CertRcrd.Tx.RfrdDoc.Dt

-

22

R

Код страны банка-нерезидента

TxCert.BkAcctDmcltnCtry

-

23

R

Дата операции

TxCert.CertRcrd.Tx.TxDt

-

24

R

Признак платежа

TxCert.CertRcrd.Tx.TxTp

1 - зачисление денежных средств на счет резидента, в том числе не в банке УК;

2 - списание денежных средств со счета резидента, в том числе не в банке УК;

7 - зачисление денежных средств от нерезидента на счет финансового агента (фактора) - резидента;

8 - зачисление денежных средств на счет другого лица - резидента или резидента, являющегося стороной по контракту (кредитному договору), но не осуществляющего его постановку на учет;

9 - списание денежных средств со счета третьего лица - резидента, другого лица - резидента или резидента, являющегося стороной по контракту (кредитному договору), но не осуществляющего его постановку на учет;

0 - перевод денежных средств при исполнении аккредитива в пользу получателя нерезидента

25

R

Код вида валютной операции

TxCert.CertRcrd.Tx.LclInstrm

-

26

R

Сумма операции

TxCert.CertRcrd.Tx.Amt@Ccy

<Amt Ccy="EUR">1000.00</Amt>

27

R

Код валюты операции

TxCert.CertRcrd.Tx.Amt@Ccy

<Amt Ccy="EUR">1000.00</Amt>

28

O

Номер УНК

TxCert.CertRcrd.Ctrct.CtrctRef.RegdCtrctId

Не указывается, если есть блок TxCert.CertRcrd.Ctrct.CtrctRef.Ctrct.Id

29

O

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

TxCert.CertRcrd.Ctrct.CtrctRef.Ctrct.Id

Не указывается, если есть блок TxCert.CertRcrd.Ctrct.CtrctRef.RegdCtrctId

30

O

Дата контракта/договора

TxCert.CertRcrd.Ctrct.CtrctRef.Ctrct.DtOfIsse

Не указывается, если есть блок TxCert.CertRcrd.Ctrct.CtrctRef.RegdCtrctId

31

O

Сумма операции в единицах валюты контракта/договора

TxCert.CertRcrd.Ctrct.TxAmtInCtrctCcy@Ccy

<TxAmtInCtrctCcy Ccy="EUR">
70000.00
</TxAmtInCtrctCcy>

32

R

Код валюты контракта/договора

TxCert.CertRcrd.Ctrct.TxAmtInCtrctCcy@Ccy

<TxAmtInCtrctCcy Ccy="EUR">
70000.00
</TxAmtInCtrctCcy>

33

O

Срок возврата аванса

TxCert.CertRcrd.Ctrct.XpctdAdvncPmtRtrDt

34

O

Ожидаемый срок

TxCert.CertRcrd.Ctrct.XpctdShipmntDt

35

O

Связка СВО с Платежом (Валютным или Рублёвым в адрес нерезидента)

TxCert.CertRcrd.Tx.RfrdDoc.Id.InstrId

Должно совпадать с полем в Платеже: Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId (схема pain.001.01.06)

36

O

ID корректируемых СВО

TxCert.Amdmnt.OrgnlDocId

Только для корректирующего СВО

37

O

Порядковый номер изменения записи

TxCert.Amdmnt.CrrctnId

Передается порядковый номер корректировки (только для корректирующих СВО)

38

O

Примечание

TxCert.CertRcrd.Ctrct.AddtlInf

39

O

Признак "Документы будут предоставлены позднее"

TxCert.CertRcrd.Ctrct.AddtlInf

код /LATERPD/ в поле "Примечание"

40

O

Признак "Без документов"

TxCert.CertRcrd.Ctrct.AddtlInf

код /NOPD/ в поле "Примечание"

41

O

Вложения к СВО

TxCert.CertRcrd.Attchmnt

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

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

42

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.024.001.01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <PmtRgltryInfNtfctn>
        <GrpHdr>
            <MsgId>TEST_MSG_2024-03-15-20240315</MsgId>
            <CreDtTm>2024-03-05T11:12:13.516</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>
        <TxNtfctn>
            <TxNtfctnId>TEST_PCT_2024-03-15-20240315</TxNtfctnId>
            <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>
            <TxCert>
                <TxId>TEST_TXID_2024-03-15-20240315</TxId>
                <Cert>
                    <Id>011350</Id>
                    <DtOfIsse>2024-03-15</DtOfIsse>
                </Cert>
                <Acct>
                    <Id>
                        <Othr>
                            <Id>40702810200000000083</Id>
                        </Othr>
                    </Id>
                </Acct>
                <CertRcrd>
                    <CertRcrdId>TEST_CERT_RCRD_2024-03-15-20240315</CertRcrdId>
                    <Tx>
                        <RfrdDoc>
                            <Id>
                                <PmtInfId>TEST_PMT_INF_2022-03-02-154345504</PmtInfId>
                            </Id>
                            <Dt>2024-03-15</Dt>
                        </RfrdDoc>
                        <TxDt>2024-03-15</TxDt>
                        <TxTp>2</TxTp>
                        <LclInstrm>61135</LclInstrm>
                        <Amt Ccy="USD">100.00</Amt>
                    </Tx>
                    <Ctrct>
                        <CtrctRef>
                            <Ctrct>
                                <Id>МТ0000010</Id>
                                <DtOfIsse>2024-03-15</DtOfIsse>
                            </Ctrct>
                        </CtrctRef>
                        <AddtlInf>H2H Testing</AddtlInf>
                    </Ctrct>
                </CertRcrd>
            </TxCert>
        </TxNtfctn>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </PmtRgltryInfNtfctn>
</Document>
Пример СВО с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива