1. Введение

Документ описывает правила электронного документооборота корпораций и банков необходимого для осуществления платежей, конверсии валюты, функций валютного контроля и предоставления банками корпорациям отчетов, связанных с перечисленными выше сервисами и продуктами, на основе международного стандарта ISO 20022.

Обратите внимание

Банк оставляет за собой право по своему усмотрению добавлять необязательные тэги и не отображать это в данной документации. Ваша система должна корректно обрабатывать такую ситуацию.

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

Документы делятся на несколько бизнес-групп:

  • Выписка (Рублёвая и Валютная) и онлайн остаток

  • Платёжные поручения и Валютные переводы

  • Валютный контроль (СВО, СПД, УНК, РСТС, Поручения на конверсию, ВБК)

  • Письма

  • Управление зарплатным проектом (з/п ведомость, открытие ЛС)

Для каждой группы можно выбрать одно из правил подписания:

  • Единоличная подпись

  • Две подписи

  • Три подписи

  • Без подписи (только для запроса выписки и онлайн остатка)

Это влияет на то, сколько подписей необходимо поставить перед отправкой на документ данной бизнес-группы.

Также есть бизнес-группа Организация канала связи. Эта группа даёт только доступ на отправку запроса по http в банк.

Обратите внимание

Все документы, которые отправляются в систему Host-to-Host, должны быть подписаны как минимум одной подписью (зависит от правила подписания). Исключения: запрос выписки и онлайн остатка. Эти документы можно запросить без подписи. Подробнее в соответствующих разделах 3. Запрос на формирование выписки и 5. Онлайн остаток .

На остальных документах должна ставиться Усиленная квалифицированная электронная подпись (УКЭП) по формату xmldsig (подробнее в разделе 33. Электронная подпись)

Данные для тестирования интеграции

Тестирование проводится на тестовом стенде:

Важно

Адрес тестового стенда:

https://alfa-link-int.alfabank.ru

Стенд не имеет пользовательского интерфейса! Это НЕ сайт. Обращение происходит через методы из раздела 2. REST

Для адреса тестового стенда установлен SSL сертификат безопасности Минцифры.
Чтобы не возникло проблем с доступом к функционалу Альфа-Линк, рекомендуем вручную установить корневой сертификат в операционную систему компьютера/сервера.
Подробнее об установке можно узнать по ссылке: https://www.gosuslugi.ru/crt

Авторизационные данные тестового стенда:

Для авторизации используется basic-авторизация, данные представлены ниже:

Логин: 643223
Пароль: 123456

Тестовый стенд не имеет UI!

Например,

Для тестирования интеграции по правилу подписания "Единоличная подпись" рекомендуется использовать тестовую организацию:

Поле Значение Комментарий

Полное наименование

Общество с ограниченной ответственностью "Тест Альфа-Линк"

Сокращённое наименование

ООО "Тест Альфа-Линк"

Для рублевых платежей

Наименование на латинице

"Test Alfa-Link" Limited Liability Company

Для валютных платежей

Адрес

Москва ул. Московская 1

Для рублевых платежей

Адрес на латинице

Moscow, Moscovskaya st. 1, RUSSIAN FEDERATION

Для валютных платежей

ИНН

7013602245

Для рублевых и валютных платежей

ОГРН

1092940217001

КПП

215045470

Счёт RUB

40702810200000000083

Для рублевых платежей

Счёт USD

40702840200000000529

Для валютных платежей

Счёт EUR

40702978200000000064

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

АО "АЛЬФА-БАНК"

Для рублевых платежей

Наименование банка на латинице

AO "ALFA-BANK"

Для валютных платежей

Адрес банка на латинице

27, KALANCHYOVSKAYA UL. MOSCOW RUSSIAN FEDERATION

Для валютных платежей

Корсчет банка

30101810200000000593

Для рублевых платежей

БИК банка

044525593

Для рублевых и валютных платежей

SWIFT-код банка

ALFARUMM

Для валютных платежей

УНК

20010160/1326/0000/2/1

Для тестирования интеграции по правилу подписания "Две подписи" рекомендуется использовать тестовую организацию:

Поле Значение Комментарий

Полное наименование

Общество с ограниченной ответственностью "Тест Альфа-Линк 2 подписи"

Сокращённое наименование

ООО "Тест Альфа-Линк 2 подписи"

Для рублевых платежей

Наименование на латинице

"Test Alfa-Link 2 signs" Limited Liability Company

Для валютных платежей

Адрес

Москва ул. Московская 1

Для рублевых платежей

Адрес на латинице

Moscow, Moscovskaya st. 1, RUSSIAN FEDERATION

Для валютных платежей

ИНН

4739069021

КПП

215401682

Счёт RUB

40702810700000000130

Для рублевых платежей

Счёт USD

40702840200000000820

Для валютных платежей

Счёт EUR

40702978000000000099

Для валютных платежей

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

АО "АЛЬФА-БАНК"

Наименование банка на латинице

AO "ALFA-BANK"

Для валютных платежей

Адрес банка на латинице

27, KALANCHYOVSKAYA UL. MOSCOW RUSSIAN FEDERATION

Для валютных платежей

Корсчет банка

30101810200000000593

Для рублевых платежей

БИК банка

044525593

Для рублевых и валютных платежей

SWIFT-код банка

ALFARUMM

Для валютных платежей

УНК

22080204/1326/0000/9/1 22080758/1326/0000/1/1 22080915/1326/0000/1/1 22080182/1326/0000/9/1 22090062/1326/0000/9/1

Для запроса ВБК

При формировании платежей рекомендуется использовать в качестве получателя реквизиты организации:

Поле Значение Комментарий

Полное наименование

Общество с ограниченной ответственностью "Тест Альфа-Линк Получатель"

Сокращённое наименование

ООО "Тест Альфа-Линк Получатель"

Для рублевых платежей

Наименование на латинице

"Test Alfa-Link Recipient" Limited Liability Company

Для валютных платежей

Адрес

Москва ул. Московская 1

Для рублевых платежей

Адрес на латинице

Moscow, Moscovskaya st. 1, RUSSIAN FEDERATION

Для валютных платежей

ИНН

4689269939

Для рублевых платежей

КПП

355701009

Счёт RUB

40702810300000000132

Для рублевых платежей

Счёт USD

40702840600000000734

Для валютных платежей

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

АО "АЛЬФА-БАНК"

Для рублевых платежей

Наименование банка на латинице

AO "ALFA-BANK"

Для валютных платежей

Адрес банка на латинице

27, KALANCHYOVSKAYA UL. MOSCOW RUSSIAN FEDERATION

Для валютных платежей

Корсчет банка

30101810200000000593

Для рублевых и валютных платежей

БИК банка

044525593

Для рублевых и валютных платежей

SWIFT-код банка

ALFARUMM

Для валютных платежей

Для тестирования запроса выписки и онлайн остатка по правилу подписания "Без подписи" рекомендуется использовать тестовую организацию:

Полное наименование

Общество с ограниченной ответственностью "Тест Альфа-Линк без подписи"

Сокращённое наименование

ООО "Тест Альфа-Линк без подписи"

ИНН

6306253384

КПП

212444844

Счёт RUB

40702810500000000848

Счёт USD

40702840700000000757

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

АО "АЛЬФА-БАНК"

Корсчет банка

30101810200000000593

БИК банка

044525593

Для тестирования документов ЗУП по правилу подписания "Единоличная подпись" рекомендуется использовать тестовую организацию:

Полное наименование

Общество с ограниченной ответственностью "Тест Альфа-Линк ЗУП"

Сокращённое наименование

ООО "Тест Альфа-Линк ЗУП"

ИНН

0664010623

КПП

051121188

Счёт RUB

40702810800000000111

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

АО "АЛЬФА-БАНК"

Корсчет банка

30101810200000000593

БИК банка

044525593

SWIFT-код банка

ALFARUMM

Номер зарплатного договора

009544

ФИО сотрудника [1]

Матросова Алина Николаевна

Счёт сотрудника [1]

40817810704040000010

ФИО сотрудника [2]

Печкин Евгений Алексеевич

Счёт сотрудника [2]

40817810004040000011

Для тестирования документов ЗУП по правилу подписания "Две подписи" рекомендуется использовать тестовую организацию:

Полное наименование

Общество с ограниченной ответственностью "Тест Альфа-Линк ЗУП (2 подписи)"

Сокращённое наименование

ООО "Тест Альфа-Линк ЗУП (2 подписи)"

ИНН

0435497780

КПП

036287882

Счёт RUB

40702810100000000222

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

АО "АЛЬФА-БАНК"

Корсчет банка

30101810200000000593

БИК банка

044525593

SWIFT-код банка

ALFARUMM

Номер зарплатного договора

00953Z

ФИО сотрудника [1]

Аликова Евгения Марковна

Счёт сотрудника [1]

40817810604040000000

ФИО сотрудника [2]

Петров Николай Васильевич

Счёт сотрудника [2]

40817810804980000326

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

Для подписания запросов вы можете воспользоваться тестовыми сертификатами из архива гайда, либо выпустить свой.

Тестовые сертификаты

Готовые тестовые сертификаты находятся в папке certificates архива данной документации.

Для тестирования по правилу подписания "Единоличная подпись" необходим один сертификат (single_sign_h2h_psw_123456.pfx).

Для правила подписания "Две подписи" - два сертификата (first_sign_h2h_psw_123456.pfx и second_sign_h2h_psw_123456.pfx).

При необходимости вы можете установить в доверенные корневые центры сертификации сертификаты УЦ Банка (cacerts.p7b), в котором были выпущены тестовые сертификаты.

Как выпустить сертификаты самостоятельно

Необходимо предоставить открытую часть ключа электронной подписи, который будет использоваться для подписания запросов, в формате *.cer в кодировке DER.

Сертификат электронной подписи должен быть выпущен в аккредитованном Удостоверяющем Центре (для тестового стенда достаточно выпустить тестовый сертификат, к примеру в УЦ КриптоПро)

Более подробная инструкция о выпуске своего тестового сертификата предложена в разделе Получение тестовых сертификатов.

2. REST

В рамках системы Host-to-Host предлагаются следующие ресурсы:

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

Валютный перевод
Платёжное поручение

Create Payments

POST

/API/v1/ISO20022/Payments

Создание пакета ВП/ПП

Get Message Status by Id

GET

/API/v1/ISO20022/Payments/<MsgId>

Получение статуса по пакету ВП/ПП

Get Payment Status by Id

GET

/API/v1/ISO20022/Payments/Transactions/<InstrId>

Получение статуса по конкретному ВП/ПП

Get Payment printed form by Id

GET

/API/v1/ISO20022/Payments/Print/<InstrId>

Получение печатной формы ВП/ПП (подробнее: Печатная форма рублёвого/валютного платежа)

Отзыв платежа

Create Recall Payment

PUT

/API/v1/ISO20022/Payments/Recall

Отзыв платежа

Выписка

Post Request for Statement

POST

/API/v1/ISO20022/Statements

Запрос выписки

Get Statement by Id

GET

/API/v1/ISO20022/Statements/<MsgID>

Получение выписки

Онлайн остаток

Post Request for Account Balance

POST

/API/v1/ISO20022/Statements/AccountBalance

Запрос базового остатка

Post Request for Extended Account Balance

POST

/API/v1/ISO20022/Statements/AccountBalanceExtended

Получение расширенного остатка

СПД

Create ConfCertitficate

POST

/API/v1/ISO20022/ConfCertificates

Создание пакета СПД

Get Message Status by Id

GET

/API/v1/ISO20022/ConfCertificates/<MsgId>

Получение статуса по пакету СПД

Get ConfCertitficate Status by Id

GET

/API/v1/ISO20022/ConfCertificates/Transactions/<TxId>

Получение статуса по конкретной СПД

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

Load attaches to Certificate

POST

/API/v1/ISO20022/ConfCertificates/Transactions/Files/<SpprtgDocId>

Отправка вложенных файлов в СПД

(Выводится из эксплуатации, используйте: Отправка вложенных файлов вместе с документом (POST))

Get attaches' list to Certificate

GET

/API/v1/ISO20022/ConfCertificates/Transactions/Files/<SpprtgDocId>

Получение списка файлов, приложенных к СПД

Get attach to Certificate

GET

/API/v1/ISO20022/ConfCertificates/Transactions/Files/<SpprtgDocId>/<FileId>

Получение контента файла, приложенного к СПД

СВО

Create COCertificates

POST

/API/v1/ISO20022/COCertificates

Создание пакета СВО

Get Message Status by Id

GET

/API/v1/ISO20022/COCertificates/<MsgId>

Получение статуса по пакету СВО

Get COCertificate Status by Id

GET

/API/v1/ISO20022/COCertificates/Transactions/<TxId>

Получение статуса по конкретным СВО

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

Load attaches to Certificate

POST

/API/v1/ISO20022/COCertificates/Transactions/Files/<TxId>

Отправка вложенных файлов в СВО

(Выводится из эксплуатации, используйте: Отправка вложенных файлов вместе с документом (POST))

Get attaches' list to Certificate

GET

/API/v1/ISO20022/COCertificates/Transactions/Files/<TxId>

Получение списка файлов, приложенных к СВО

Get attach to Certificate

GET

/API/v1/ISO20022/COCertificates/Transactions/Files/<TxId>/<FileId>

Получение контента файла, приложенного к СВО

РСТС

Create FCYRLS

POST

/API/v1/ISO20022/FCYRLS

Создание РСТС

Get Message Status by Id

GET

/API/v1/ISO20022/FCYRLS/<MsgId>

Получение статуса по сообщению, содержащему одно или несколько РСТС

Get RLS Status by Id

GET

/API/v1/ISO20022/FCYRLS/Order/<PmtInfId>

Получение статуса по конкретному РСТС

Письмо

Create official letter

POST

/API/v1/ISO20022/Letters

Создание письма

Get message status

GET

/API/v1/ISO20022/Letters/<MsgId>

Получение статуса по пакету писем

Get letter status

GET

/API/v1/ISO20022/Letters/OutLetters/<ReqOrLttrId>

Получение статуса по конкретному письму

Вложения к письму

Load attaches to letter

POST

/API/v1/ISO20022/Letters/OutLetters/Files/<ReqOrLttrId>

Отправка вложенных файлов

(Выводится из эксплуатации, используйте: Отправка вложенных файлов вместе с документом (POST))

Get attach’s content to incoming letter

GET

/API/v1/ISO20022/Letters/InLetters/Files/<ReqOrLttrId>/<DocNb>

Получение контента файла, приложенного к входящему письму

Список входящих писем

Post request for list of letters

POST

/API/v1/ISO20022/Letters/Lists

Запрос на получение списка писем (входящих+ув-ия о ПВВ)

Get list of letters

GET

/API/v1/ISO20022/Letters/Lists/<MsgId>

Получение списка писем (входящих+ув-ия о ПВВ)

Контракт (УНК)

Create Contract

POST

/API/v1/ISO20022/Contracts

Постановка на учет внешнеторгового контракта (УНК)

Get Message Status by Id

GET

/API/v1/ISO20022/Contracts/<MsgId>

Получение статуса по пакету Контракта (УНК)

Get Contract Status by Id

GET

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

Получение статуса по конкретному Контракту (УНК)

Get Сonfirmed Сontract by Id

GET

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

Получение подтвержденного Контракта с номером УНК

Внесение изменений в I раздел ВБК (переоформление УНК)

Create Reissue contract

POST

/API/v1/ISO20022/Contracts/Reissue

Запрос на внесение изменений в I раздел ВБК

Get Message Status by Id

GET

/API/v1/ISO20022/Contracts/Reissue/<MsgId>

Получение статуса по сообщению

Get Reissue Status request by Id

GET

/API/v1/ISO20022/Contracts/Reissue/Contract/<RegdCtrctAmdmntId>

Получение статуса по запросу на внесение изменений в I раздел ВБК

Get Сonfirmed Reissue Сontract by Id

GET

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

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

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

Create contract closing

POST

/API/v1/ISO20022/Contracts/Close

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

Get Message Status by Id

GET

/API/v1/ISO20022/Contracts/Close/<MsgId>

Получение статуса по сообщению

Get Close Status request by Id

GET

/API/v1/ISO20022/Contracts/Close/Contract/<RegdCtrctClsrId>

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

Get Сonfirmed Сontract by Id

GET

/API/v1/ISO20022/Contracts/Close/Confirmations/<RegdCtrctClsrId>

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

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

Load attaches to contract

POST

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

Отправка вложенных файлов (Выводится из эксплуатации, используйте: Отправка вложенных файлов вместе с документом (POST))

Get attaches' list to contract

GET

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

Получение списка файлов, приложенных к Контракту

Get attach’s content to contract

GET

/API/v1/ISO20022/Contracts/Files/<CtrctRegnOpngId>/<FileId>

Получение контента файла, приложенного к полученному контракту

Вложения к переоформленному контракту (внесены изменения в I раздел ВБК)

Get attaches' list to contract

GET

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

Получение списка файлов, приложенных к Контракту

Get attach’s content to contract

GET

/API/v1/ISO20022/Contracts/Files/<RegdCtrctAmdmntId>/<FileId>

Получение контента файла, приложенного к полученному контракту

Вложения к контракту снятому с учета

Get attaches' list to contract

GET

/API/v1/ISO20022/Contracts/Files/<RegdCtrctClsrId>

Получение списка файлов, приложенных к Контракту

Get attach’s content to contract

GET

/API/v1/ISO20022/Contracts/Files/<RegdCtrctClsrId>/<FileId>

Получение контента файла, приложенного к полученному контракту

Поручение на конверсионную операцию

Create FX

POST

/API/v1/ISO20022/ForeignExchanges

Создание поручения

Get Message Status by Id

GET

/API/v1/ISO20022/ForeignExchanges/<MsgId>

Получение статуса по сообщению, содержащему одну или несколько конверсионных операций

Get FX Status by Id

GET

/API/v1/ISO20022/ForeignExchanges/Instructions/<InstrId>

Получение статуса по поручению

Зарплатная ведомость

Send payroll

POST

/API/v1/ISO20022/Payroll

Отправить ЗП ведомость

Get message status

GET

/API/v1/ISO20022/Payroll/<MsgId>

Получить статус сообщения с зарплатной ведомостью

Открытие ЛС

Send Employee account application

POST

/API/v1/ISO20022/EmployeeAccount

Отправить заявку на открытие ЛС

Get message status

GET

/API/v1/ISO20022/EmployeeAccount/<MsgId>

Получить статус сообщения с заявкой на открытие ЛС

Формирование архива со списком ВБК

Create an archive of bank control statements

POST

/API/v1/ISO20022/ContractReports

Создание архива с ВБК по контрактам

Get Message Status by Id

GET

/API/v1/ISO20022/ContractReports/<MsgId>

Получение статуса по сообщению, содержащему все переданные номера контрактов

Download file by Id

GET

/API/v1/ISO20022/ContractReports/Files/<MsgId>

Скачивание архива со списком ВБК

3. Запрос на формирование выписки

У клиентов есть возможность получить запрашиваемую выписку в двух форматах:

  • Финальная выписка [camt.053.001.05]

  • Промежуточная выписка [camt.052.001.05]

Для получения выписки в формате camt.052.001.05 со стороны клиента, при запросе на выписку, необходимо будет передавать новый необязательный header: stmt-format = 'camt052', если он указан - выписка формируется в camt.052.

Если header не был передан или передан, но stmt-format не равен 'camt052', то выписка сформируется в camt.053. Клиентам необходимо самим контролировать попадание текущей даты в период запроса для получения выписки в нужном формате.

Важно

Необходимо понимать, что выписка в формате camt.053.001.05 не будет финальной (некоторые операции в выписке могут пропасть или могут появиться новые), в случае, если в период запроса попадает текущая дата. Например, выписка в таком формате, запрошенная за сегодня, будет финальной (окончательной) только на утро следующего дня.

Запрос выписки без подписи

Реализована возможность запроса выписки без подписания УКЭП. Для этого необходимо:

1) В Headers передать параметры:

  • company-tin со значением ИНН компании

  • check-sign-message со значением false

2) Тэг <SgntrSt> оставить пустым.

3) При тестировании использовать данные тестовой компании ООО «Тест Альфа-Линк без подписи».

4) При подключении к промышленному стенду в Заявлении о назначении/изменении прав доступа для функциональности Получение информации (выписки) о движениях по Счету выбрать правило подписания – "Без подписи" (роль «Оператор»).

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

Для получения сформированной выписки необходимо корректно составить и подписать запрос (пример запроса есть ниже в настоящей документации). Для получения отклоненной выписки достаточно, например, некорректно заполнить реквизиты.

URI

HTTP POST: /API/v1/ISO20022/Statements

XSD схема

camt.060.001.03

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

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

Общий путь Document.AcctRptgReq

1

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

GrpHdr.MsgId

Запрос выписки осуществляется по этому идентификатору

2

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

GrpHdr.CreDtTm

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

3

Уникальный ID пакета с запросом

RptgReq.Id

Запрос на выписку по каждому счету запрашивается в отдельном пакете

4

Признак "Получить данные по типу "Выписка"

RptgReq.ReqdMsgNmId

5

Номер счета

RptgReq.Acct.Id.Othr.Id

6

Дата начала периода

RptgReq.RptgPrd.FrToDt.FrDt

7

Дата окончания периода

RptgReq.RptgPrd.FrToDt.ToDt

8

Время начала периода

RptgReq.RptgPrd.FrToTm.FrTm

00:00:00

9

Время окончания периода

RptgReq.RptgPrd.FrToTm.ToTm

24:00:00

10

Признак "Показать все операции"

RptgReq.RptgPrd.Tp

Константа 'ALLL'

11

Наименование организации

RptgReq.AcctOwnr.Pty.Nm

Ответ

В ответ на запрос на формирование выписки приходит http код и описание статуса запроса

Таблица кодов ответа
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

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature is not allowed for this operation type

Подпись не требуется для данной операции

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

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

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

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

400

Err

FrDt/ToDt is in the future

Дата начала/окончания периода запроса выписки позднее текущей даты

400

Err

A date period is not specified

Не указан период запроса выписки

400

Err

FrDt is later than ToDt

Дата начала периода запроса выписки позднее даты окончания

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:camt.060.001.03" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
	<AcctRptgReq>
		<GrpHdr>
			<MsgId>H2H_TEST_STMT_112368042870658794832</MsgId>
			<CreDtTm>2021-03-18T10:00:18+03:00</CreDtTm>
		</GrpHdr>
		<RptgReq>
			<Id>H2H_TEST_STMT_112368042870658794832</Id>
			<ReqdMsgNmId>HMQSTASCF</ReqdMsgNmId>
			<Acct>
				<Id>
					<Othr>
						<Id>40702810200000000083</Id>
					</Othr>
				</Id>
			</Acct>
			<AcctOwnr>
				<Pty>
					<Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
				</Pty>
			</AcctOwnr>
			<RptgPrd>
				<FrToDt>
					<FrDt>2022-01-15</FrDt>
					<ToDt>2022-02-01</ToDt>
				</FrToDt>
				<FrToTm>
					<FrTm>00:00:00</FrTm>
					<ToTm>24:00:00</ToTm>
				</FrToTm>
				<Tp>ALLL</Tp>
			</RptgPrd>
		</RptgReq>
		<SplmtryData>
			<Envlp>
				<SgntrSt>
                </SgntrSt>
			</Envlp>
		</SplmtryData>
	</AcctRptgReq>
</Document>

4. Получение сформированной выписки

URI

GET: /API/v1/ISO20022/Statements/<MsgId>

XSD схемы

camt.053.001.05 - финальная выписка

camt.052.001.05 - промежуточная выписка

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

Заголовок сообщения с выпиской (GrpHdr)

R/O Описание Путь

Общий путь
Document.BkToCstmrStmt.GrpHdr [camt.053]
Document.BkToCstmrAcctRpt.GrpHdr [camt.052]

1

R

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

MsgId

2

R

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

CreDtTm

3

O

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

OrgnlBizQry.MsgId

4

R

Наименование получателя выписки

MsgRcpt.Nm

5

R

ИНН получателя выписки

MsgRcpt.Id.OrgId.Othr.Id

Секция с выпиской (Stmt/Rpt)

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

Общий путь
Document.BkToCstmrStmt.Stmt [camt.053]
Document.BkToCstmrAcctRpt.Rpt [camt.052]

1

R

ID выписки в банке

Id

2

R

Дата и время формирования выписки

CreDtTm

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

3

R

Дата начала периода

FrToDt.FrDtTm

4

R

Дата конца периода

FrToDt.ToDtTm

5

R

Номер счета

Acct.Id.Othr.Id

20-й номер счёта

6

O

Буквенный код валюты счета

Acct.Ccy

7

R

Наименование владельца счета

Acct.Ownr.Nm

Наименование клиента (организации). Максимум 140 символов.

8

R

ИНН/КИО владельца счета

Acct.Ownr.Id.OrgId.Othr.Id

ИНН Клиента

9

O

ISO код типа данных для ИНН

Acct.Ownr.Id.OrgId.Othr.SchmeNm.Cd

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

Реквизиты обслуживающего банка

10

R

BIC банка, обслуживающего счет

Acct.Svcr.FinInstnId.BICFI

Указываются SWIFT-ы для валютных документов. Информация по БИКам см. "БИК банка/отделения обслуживающего счет".

11

R

Обозначение российской расчетной системы

Acct.Svcr.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

12

R

БИК банка/отделения обслуживающего счет

Acct.Svcr.FinInstnId.ClrSysMmbId.MmbId

13

R

Наименование банка/отделения обслуживающего счет

Acct.Svcr.FinInstnId.Nm

Обрезается до 140 символов.

14

R

Адрес банка/отделения обслуживающего счет

Acct.Svcr.FinInstnId.PstlAdr.AdrLine

Обрезается до 70 символов.

15

R

ИНН банка/отделения обслуживающего счет

Acct.Svcr.FinInstnId.Othr.Id

Информация об остатках (блок Bal необязателен для промежуточной выписки)

16

R

Тип баланса (входящий)
(1й блок)

Bal[1].Tp.CdOrPrtry.Cd

Константа "OPBD"

17

R

Баланс входящий
(валюта счета)

Bal[1].Amt@Ccy

18

R

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[1].CdtDbtInd и Bal[1].Avlbty.CdtDbtInd

Указывается одно из значений
'DBIT' - Дебет 'CRDT' - Кредит

19

R

Дата баланса

Bal[1].Dt.Dt и Bal[1].Avlbty.Dt.ActlDt

Формат: YYYY-mm-dd

20

R

Вход. ост. в руб. эквив.

Bal[1].Avlbty.Amt

Amt@Ccy="RUR"

21

R

Тип баланса (исходящий)
(2й блок)

Bal[2].Tp.CdOrPrtry.Cd

Константа "CLBD"

22

R

Баланс исходящий
(валюта счета)

Bal[2].Amt@Ccy

23

R

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[2].CdtDbtInd и Bal[2].Avlbty.CdtDbtInd

Указывается одно из значений
'DBIT' - Дебет 'CRDT' - Кредит

24

R

Дата баланса

Bal[2].Dt.Dt и Bal[2].Avlbty.Dt.ActlDt

Формат: YYYY-mm-dd

25

R

Исход. ост. в руб. эквив.

Bal[2].Avlbty.Amt

Amt@Ccy="RUR"

26

R

Обороты по кредиту

TxsSummry.TtlCdtNtries.Sum

27

R

Обороты по дебету

TxsSummry.TtlDbtNtries.Sum

28

O

Дата предыдущей операции по счету

TxsSummry.TtlNtriesPerBkTxCd.BkTxCd.Prtry.Cd

29

R

Код транзакции

TxsSummry.TtlNtriesPerBkTxCd.BkTxCd

Обязательное поле по схеме. Всегда имеет значение null.

30

R

Дата исходящего баланса

TxsSummry.TtlNtriesPerBkTxCd/Avlbty[1]/Dt/ActlDt

Указывается в обоих блоках. Совпадает с датой выписки.

31

R

Оборот по кредиту в руб. эквив. (1-й блок)

TxsSummry.TtlNtriesPerBkTxCd/Avlbty[1]/Amt

32

R

Индикатор Кредит (1-й блок)

TxsSummry.TtlNtriesPerBkTxCd/Avlbty[1]/CdtDbtInd

Константа 'CRDT'

33

R

Оборот по дебету в руб. эквив. (2-й блок)

TxsSummry.TtlNtriesPerBkTxCd/Avlbty[2]/Amt

34

R

Индикатор Дебет (2-й блок)

TxsSummry.TtlNtriesPerBkTxCd/Avlbty[2]/CdtDbtInd

Константа 'DBIT'

35

R

Валюта рубли

TxsSummry.TtlNtriesPerBkTxCd/Avlbty[1,2]/Amt/Ccy

Указывается в обоих блоках. Константа 'RUR'.

Секция с транзакцией в зависимости от типа платёжного документа (Ntry)

Валютный перевод/платёжное поручение
Информация о транзакции
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry [camt.052]

1

R

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

Amt

<Amt Ccy="USD">1500.00<.Amt>

2

R

Валюта операции

Amt@Ccy

<Amt Ccy="USD">1500.00<.Amt>

3

R

Индикатор:
Дебет ('DBIT');
Кредит ('CRDT').

CdtDbtInd

4

R

Статус операции:
"PDNG" - исполняется;
"BOOK" - исполнено.

Sts

Для промежуточной выписки 'PDNG'.
Для финальной выписки 'BOOK'.

5

R

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

BookgDt.Dt

6

O

Дата валютирования

ValDt.Dt

7

R

Код транзакции
(Domain ISO Transaction Codification)

BkTxCd.Domn.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

8

R

Тип транзакции
(Family ISO Transaction Codification)

BkTxCd.Domn.Fmly.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

9

O

Подтип транзакции

BkTxCd.Domn.Fmly.SubFmlyCd

см. таблицу соответствия вида операции
с коллекцией документов ISO

10

O

Код операции

BkTxCd.Prtry.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

11

O

Рублевый эквивалент суммы к оплате

AmtDtls.PrtryAmt.Amt@Ccy

Ccy в данном случае равно RUR

12

O

Описание типа

AmtDtls.PrtryAmt.Tp

Константа "Operation Amount in Rubles"

13

O

Код дебитора

AcctSvcrRef

5 символов

14

O

Код дебитора (расширенный)

AddtlNtryInf

8 символов

Детали строки выписки
Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry.NtryDtls.TxDtls [camt.052]

1

R

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

Refs.EndToEndId

2

R

Наименование плательщика

RltdPties.Dbtr.Nm

3

O

Наименование плательщика*

RltdPties.Dbtr.PstlAdr.AdrLine

Заполняется в случае, если наименование плательщика больше 140 символов

4

O

ИНН / КИО плательщика

RltdPties.Dbtr.Id.OrgId.Othr.Id

5

O

ISO код типа данных для ИНН плательщика

RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН. Константа 'TXID'

6

R

Номер счета плательщика

RltdPties.DbtrAcct.Id.Othr.Id

7

R

Наименование получателя

RltdPties.Cdtr.Nm

8

O

Наименование получателя*

RltdPties.Cdtr.PstlAdr.AdrLine

Символы со 141 по 160 наименования получателя. Заполняется в случае, если наименование получателя больше 140 символов

9

O

Наименование получателя*

RltdPties.Cdtr.CtctDtls.Nm

Символы со 141 по 160 наименования получателя (дублирует RltdPties.Cdtr.PstlAdr.AdrLine).

10

O

ИНН / КИО получателя

RltdPties.Cdtr.Id.OrgId.Othr.Id

11

O

ISO код типа данных для ИНН получателя

RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН. Константа 'TXID'

12

R

Номер счета получателя

RltdPties.CdtrAcct.Id.Othr.Id

13

O

SWIFT банка плательщика

RltdAgts.DbtrAgt.FinInstnId.BICFI

14

O

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

RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

15

O

БИК банка плательщика

RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

16

O

Корр.счёт банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Id

17

O

Клиринговый код банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Issr

18

O

Наименование банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Nm

19

O

Наименование банка плательщика*

RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine

Заполняется в случае, если наименование банка плательщика больше 140 символов

20

O

SWIFT банка получателя

RltdAgts.CdtrAgt.FinInstnId.BICFI

21

О

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

RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

22

О

БИК банка получателя

RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

23

О

Клиринговый код банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Issr

24

О

Наименование банка получателя

RltdAgts.CdtrAgt.FinInstnId.Nm

25

O

Наименование банка получателя*

RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine

26

О

Корр.счёт банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Id

27

О

SWIFT банка-корреспондента

RltdAgts.IntrmyAgt1.FinInstnId.BICFI

28

О

Клиринговый код банка-корреспондента

RltdAgts.IntrmyAgt1.FinInstnId.ClrSysMmbId.ClrSysId.Cd

29

О

Наименование банка-корреспондента

RltdAgts.IntrmyAgt1.FinInstnId.Nm

30

О

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

RltdAgts.IntrmyAgt1.FinInstnId.Othr.Id

31

R

Назначение платежа

RmtInf.Ustrd[1..2]

Если значение по длине превышает 140 символов, то часть строки > 140 символов указывается во втором теге Ustrd

32

O

Код УИН (22)

RmtInf.Strd[1].CdtrRefInf.Ref

33

R

Очередность платежа (21)

Purp.Prtry

Поле обязательно только валюте операции = "RUR"

34

R

Тип списания комиссии

Chrgs.Rcrd.Br

35

O

Счет списания комиссии

Chrgs.Rcrd.Agt.FinInstnId.Othr.Id

36

O

Рублевый эквивалент суммы к оплате

AmtDtls.PrtryAmt.Amt

@Ccy="RUB"

37

O

Информация отправителя получателю

RmtInf.Strd.AddtlRmtInf[1..2]

Если значение по длине превышает 140 символов, то часть строки > 140 символов указывается во втором теге AddtlRmtInf

38

R

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

Amt@Ccy

39

O

Номер уведомления о зачислении на транзитный счет

SplmtryData.Envlp.Notif.Nuved

40

O

Дата уведомления NUVED

SplmtryData.Envlp.Notif.Dtuv

Дата в формате ISO: YYYY-MM-DD.

41

O

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

SplmtryData.Envlp.Notif.Dtcpd

Дата в формате ISO: YYYY-MM-DD.

42

O

Дата начала действия нарушения

SplmtryData.Envlp.Notif.Bviol

Дата в формате ISO: YYYY-MM-DD.

43

O

ID документа СР

SplmtryData.Envlp.NumSB

44

O

ID документа СР (2)

Refs.TxId

45

O

Код выплат (110)

Tax.Rcrd.Tp

46

O

Код вида дохода (20)

AmtDtls.PrtryAmt.Tp

47

O

Расходы отправителя сообщения (константа)

AmtDtls.PrtryAmt.Amt@Ccy

Заполняется значением 0, если указан Код вида дохода (20)
<Amt Ccy="RUB">0</Amt>

Заполняется только для рублевых платёжных поручений

48

O

Cтатус налогоплательщика (101)

Tax.Rcrd.DbtrSts

49

O

КПП плательщика (102)

Tax.Dbtr.TaxTp

Значением может быть ноль.

50

O

КПП получателя (103)

Tax.Cdtr.TaxTp

51

O

КБК (104)

Tax.Rcrd.CtgyDtls

52

O

ОКТМО (105)

Tax.AdmstnZn

53

O

Основание налогового платежа (106)

Tax.Rcrd.Ctgy

54

O

Год налогового периода (107)

Tax.Rcrd.Prd.Yr

55

O

Тип налогового периода (107)

Tax.Rcrd.Prd.Tp

Может принимать одно из значений:
MM01 - MM12;
QTR1; QTR2; QTR3; QTR4;
HLF1; HLF2.

56

O

Дата налогового периода (107)

Tax.Rcrd.Prd.FrToDt.FrDt

57

O

Дата налогового периода (107)

Tax.Rcrd.Prd.FrToDt.ToDt

Указывается для соблюдения формата.
В обработке поручения не используется.

58

O

Код таможенного органа (107)

Tax.Cdtr.RegnId

59

O

Номер налогового платежа (108)

Tax.RefNb

60

O

Дата налогового документа (109)

Tax.Dt, значения "0" или "00" указываются в Tax.Mtd

Платёжное требование
Информация о транзакции
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry [camt.052]

1

R

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

Amt

2

R

Код валюты

Amt@Ccy

3

R

Индикатор Дебет/Кредит

CdtDbtInd

Константа "DBIT" или "CRDT"

4

R

Статус операции:
"PDNG" - исполняется;
"BOOK" - исполнено.

Sts

Для промежуточной выписки 'PDNG'.
Для финальной выписки 'BOOK'.

5

R

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

BookgDt.Dt

6

O

Дата валютирования

ValDt.Dt

7

R

Код транзакции

BkTxCd.Domn.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

8

R

Тип транзакции

BkTxCd.Domn.Fmly.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

9

O

Подтип транзакции

BkTxCd.Domn.Fmly.SubFmlyCd

см. таблицу соответствия вида операции
с коллекцией документов ISO

10

O

Код операции

BkTxCd.Prtry.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

11

О

Рублевый эквивалент суммы к оплате

AmtDtls.PrtryAmt.Amt@Ccy

Amt - сумма
@Ccy = "RUR"

12

O

Описание типа

AmtDtls.PrtryAmt.Tp

Константа "Operation Amount in Rubles"

13

O

Код дебитора

AcctSvcrRef

5 символов

14

O

Код дебитора (расширенный)

AddtlNtryInf

8 символов

Детали строки выписки
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry.NtryDtls.TxDtls [camt.052]

1

R

Номер документа (3)

Refs.EndToEndId

2

R

Наименование плательщика

RltdPties.Dbtr.Nm

3

O

Наименование плательщика*

RltdPties.Dbtr.PstlAdr.AdrLine

Заполняется в случае, если наименование больше 140 символов

4

O

ИНН / КИО плательщика

RltdPties.Dbtr.Id.OrgId.Othr.Id

5

O

ISO код типа данных для ИНН плательщика

RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН.
Константа "TXID"

6

O

Номер счета плательщика

RltdPties.DbtrAcct.Id.Othr.Id

7

O

SWIFT банка плательщика

RltdAgts.DbtrAgt.FinInstnId.BICFI

8

O

Клиринговый код банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.*Issr

9

O

БИК банка плательщика

RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

10

O

Корреспондентский счёт банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Id

11

O

Наименование банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Nm

12

O

Наименование банка плательщика*

RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine

Заполняется в случае, если наименование больше 140 символов

13

R

Наименование получателя

RltdPties.Cdtr.Nm

14

O

Наименование получателя*

RltdPties.Cdtr.PstlAdr.AdrLine

Заполняется в случае, если наименование больше 140 символов

15

O

ИНН / КИО получателя

RltdPties.Cdtr.Id.OrgId.Othr.Id

16

O

ISO код типа данных для ИНН получателя

RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН.
Константа "TXID"

17

R

Номер счета получателя

RltdPties.CdtrAcct.Id.Othr.Id

18

O

БИК банка получателя

RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

19

O

Клиринговый код банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Issr

20

O

SWIFT банка получателя

RltdAgts.CdtrAgt.FinInstnId.BICFI

21

O

Корреспондентский счёт банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Id

22

О

Наименование банка получателя

RltdAgts.CdtrAgt.FinInstnId.Nm

23

O

Наименование банка получателя*

RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine

24

R

Назначение платежа

RmtInf.Ustrd[1..2]

Если значение по длине превышает 140 символов, то часть строки > 140 символов указывается во втором теге Ustrd

25

O

Код УИН (22)

RmtInf.Strd[1].CdtrRefInf.Ref

26

R

Очер. плат. (21)

Purp.Prtry

27

O

Условие оплаты (35)

RmtInf.Strd[1].AddtlRmtInf[1..2]

Если значение по длине превышает 140 символов, то часть строки > 140 символов указывается во втором теге AddtlRmtInf

28

O

Поступ. в банк плат (62)

RmtInf.Strd[1].TaxRmt.Dt

Дата в формате ISO: YYYY-MM-DD

29

O

Срок для акцепта

RmtInf.Strd[2].TaxRmt.AdmstnZone

Дата в формате ISO: YYYY-MM-DD

30

O

Оконч. срока акцепта

RmtInf.Strd[3].TaxRmt.Dt

Дата в формате ISO: YYYY-MM-DD

31

R

Сумма комиссии
Валюта комиссии

Chrgs.Rcrd.Amt@Ccy

32

R

Сумма операции
Валюта операции

Amt@Ccy

33

O

Номер уведомления о зачислении на транзитный счет

SplmtryData.Envlp.Notif.Nuved

34

O

Дата уведомления NUVED

SplmtryData.Envlp.Notif.Dtuv

Дата в формате ISO: YYYY-MM-DD

35

O

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

SplmtryData.Envlp.Notif.Dtcpd

Дата в формате ISO: YYYY-MM-DD

36

O

Дата начала действия нарушения

SplmtryData.Envlp.Notif.Bviol

Дата в формате ISO: YYYY-MM-DD

37

O

ID документа СР

SplmtryData.Envlp.NumSB

38

O

ID документа СР (2)

Refs.TxId

39

O

Код выплат (110)

Tax.Rcrd.Tp

40

O

Код вида дохода (20)

AmtDtls.PrtryAmt.Tp

41

O

Расходы отправителя сообщения (константа)

AmtDtls.PrtryAmt.Amt@Ccy

Заполняется значением 0, если указан Код вида дохода (20)
<Amt Ccy="RUB">0</Amt>

Инкассовое поручение
Информация о транзакции
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry [camt.052]

1

R

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

Amt

<Amt Ccy="USD">1500.00<.Amt>

2

R

Валюта операции

Amt@Ccy

<Amt Ccy="USD">1500.00<.Amt>

3

R

Индикатор Дебет/Кредит

CdtDbtInd

Константа "DBIT" или "CRDT"

4

R

Статус операции:
"PDNG" - исполняется;
"BOOK" - исполнено.

Sts

Для промежуточной выписки 'PDNG'.
Для финальной выписки 'BOOK'.

5

R

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

BookgDt.Dt

6

R

Дата валютирования

ValDt.Dt

7

R

Код транзакции (Domain ISO Transaction Codification)

BkTxCd.Domn.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

8

R

Тип транзакцииn (Family ISO Transaction Codification)

BkTxCd.Domn.Fmly.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

9

O

Подтип транзакции (Subfamily ISO Transaction Codification)

BkTxCd.Domn.Fmly.SubFmlyCd

см. таблицу соответствия вида операции
с коллекцией документов ISO

10

R

Код операции

BkTxCd.Prtry.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

11

O

Код дебитора

AcctSvcrRef

5 символов

12

O

Код дебитора (расширенный)

AddtlNtryInf

8 символов

Детали строки выписки
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry.NtryDtls.TxDtls [camt.052]

1

R

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

Refs.EndToEndId

2

R

Сумма операции
Мнемоника валюты

Amt@Ccy

3

R

Наименование плательщика

RltdPties.Dbtr.Nm

4

O

Наименование плательщика*

RltdPties.Dbtr.PstlAdr.AdrLine

Заполняется в случае, если наименование больше 140 символов

5

O

ИНН плательщика

RltdPties.Dbtr.Id.OrgId.Othr.Id

6

О

ISO код типа данных для ИНН плательщика

RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН.
Константа 'TXID'

7

O

Номер счета плательщика

RltdPties.DbtrAcct.Id.Othr.Id

8

R

Наименование банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Nm

9

O

Наименование банка плательщика*

RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine

Заполняется в случае, если наименование больше 140 символов

10

О

SWIFT-код банка плательщика

RltdAgts.DbtrAgt.FinInstnId.BICFI

11

О

БИК банка плательщика

RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

12

О

Корреспондентский счёт банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Id

13

О

Клиринговый код банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Issr

14

R

Наименование получателя

RltdPties.Cdtr.Nm

15

O

Наименование получателя*

RltdPties.Cdtr.PstlAdr.AdrLine

Заполняется в случае, если наименование получателя больше 140 символов

16

O

ИНН получателя

RltdPties.Cdtr.Id.OrgId.Othr.Id

17

О

ISO код типа данных для ИНН получателя

RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН
Константа 'TXID'

18

R

Номер счета получателя

RltdPties.CdtrAcct.Id.Othr.Id

19

О

SWIFT банка получателя

RltdAgts.CdtrAgt.FinInstnId.BICFI

20

R

Наименование банка получателя

RltdAgts.CdtrAgt.FinInstnId.Nm

21

O

Наименование банка получателя*

RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine

22

R

БИК банка получателя

RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

23

O

Клиринговый код банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Issr

24

R

Корреспондентский счёт банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Id

25

R

Очередность платежа

Purp.Prtry

26

О

Код УИН (22)

RmtInf.Strd.CdtrRefInf.Ref

27

R

Назначение платежа

RmtInf.Ustrd[1..2]

Если значение по длине превышает 140 символов, то часть строки > 140 символов указывается во втором теге Ustrd

28

R

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

SplmtryData.Envlp.DocRcvDt

Дата в формате ISO: YYYY-MM-DD

29

R

Дата списания со счета плательщика

SplmtryData.Envlp.DocWrOffDt

Дата в формате ISO: YYYY-MM-DD

30

R

Вид платежа

SplmtryData.Envlp.PmtType

31

O

Номер уведомления о зачислении на транзитный счет

SplmtryData.Envlp.Notif.Nuved

32

O

Дата уведомления NUVED

SplmtryData.Envlp.Notif.Dtuv

Дата в формате ISO: YYYY-MM-DD

33

O

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

SplmtryData.Envlp.Notif.Dtcpd

Дата в формате ISO: YYYY-MM-DD

34

O

Дата начала действия нарушения

SplmtryData.Envlp.Notif.Bviol

Дата в формате ISO: YYYY-MM-DD

35

O

ID документа СР

SplmtryData.Envlp.NumSB

36

O

ID документа СР (2)

Refs.TxId

37

O

Код выплат (110)

Tax.Rcrd.Tp

38

O

Код вида дохода (20)

AmtDtls.PrtryAmt.Tp

39

O

Расходы отправителя сообщения (константа)

AmtDtls.PrtryAmt.Amt@Ccy

Заполняется значением 0, если указан Код вида дохода (20)
<Amt Ccy="RUB">0</Amt>

40

O

Cтатус налогоплательщика (101)

Tax.Rcrd.DbtrSts

41

O

КПП плательщика (102)

Tax.Dbtr.TaxTp

42

O

КПП получателя (103)

Tax.Cdtr.TaxTp

43

O

КБК (104)

Tax.Rcrd.CtgyDtls

44

O

ОКТМО (105)

Tax.AdmstnZn

45

O

Основание налогового платежа (106)

Tax.Rcrd.Ctgy

46

O

Год налогового периода (107)

Tax.Rcrd.Prd.Yr

47

O

Тип налогового периода (107)

Tax.Rcrd.Prd.Tp

Может принимать одно из значений:
MM01 - MM12;
QTR1; QTR2; QTR3; QTR4;
HLF1; HLF2

48

O

Дата налогового периода (107)

Tax.Rcrd.Prd.FrToDt.FrDt

49

O

Дата налогового периода (107)

Tax.Rcrd.Prd.FrToDt.ToDt

Указывается для соблюдения формата.
В обработке не используется.

50

O

Код таможенного органа (107)

Tax.Cdtr.RegnId

51

O

Номер налогового платежа (108)

Tax.RefNb

52

O

Дата налогового документа (109)

Tax.Dt, значения "0" или "00" указываются в Tax.Mtd

Мемориальный ордер
Информация о транзакции
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry [camt.052]

1

R

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

Amt

<Amt Ccy="USD">1500.00</Amt>

2

R

Валюта операции

Amt@Ccy

<Amt Ccy="USD">1500.00</Amt>

3

R

Индикатор Дебет/Кредит

CdtDbtInd

Константа "DBIT" или "CRDT"

4

R

Статус операции:
"PDNG" - исполняется;
"BOOK" - исполнено.

Sts

Для промежуточной выписки 'PDNG'.
Для финальной выписки 'BOOK'.

5

R

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

BookgDt.Dt

6

R

Дата валютирования

ValDt.Dt

7

R

Код транзакции (Domain ISO Transaction Codification)

BkTxCd.Domn.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

8

R

Тип транзакцииn (Family ISO Transaction Codification)

BkTxCd.Domn.Fmly.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

9

O

Подтип транзакции (Subfamily ISO Transaction Codification)

BkTxCd.Domn.Fmly.SubFmlyCd

см. таблицу соответствия вида операции
с коллекцией документов ISO

10

O

Код операции

BkTxCd.Prtry.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

11

О

Рублевый эквивалент суммы к оплате

AmtDtls.PrtryAmt.Amt@Ccy

В данном случае, Ccy = RUR
<Amt Ccy="RUR">1200.00</Amt>

12

O

Описание типа

AmtDtls.PrtryAmt.Tp

"Operation Amount in Rubles"

13

O

Код дебитора

AcctSvcrRef

5 символов

14

O

Код дебитора (расширенный)

AddtlNtryInf

8 символов

Детали строки выписки
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry.NtryDtls.TxDtls [camt.052]

1

R

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

Refs.EndToEndId

2

R

Сумма операции
Мнемоника валюты

Amt@Ccy

3

R

Наименование плательщика

RltdPties.Dbtr.Nm

4

O

Наименование плательщика*

RltdPties.Dbtr.PstlAdr.AdrLine

Заполняется в случае, если наименование плательщика больше 140 символов.

5

O

ИНН / КИО плательщика

RltdPties.Dbtr.Id.OrgId.Othr.Id

6

О

ISO код типа данных для ИНН плательщика

RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН.
Константа 'TXID'

7

O

Номер счета плательщика

RltdPties.DbtrAcct.Id.Othr.Id

8

R

Наименование получателя

RltdPties.Cdtr.Nm

9

O

Наименование получателя*

RltdPties.Cdtr.PstlAdr.AdrLine

Заполняется в случае, если наименование получателя больше 140 символов.

10

O

ИНН / КИО получателя

RltdPties.Cdtr.Id.OrgId.Othr.Id

11

О

ISO код типа данных для ИНН получателя

RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН.
Константа "TXID".

12

R

Номер счета получателя

RltdPties.CdtrAcct.Id.Othr.Id

13

O

SWIFT банка получателя

RltdAgts.CdtrAgt.FinInstnId.BICFI

14

O

БИК банка получателя

RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

15

O

Клиринговый код банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Issr

16

O

Корреспондентский счёта банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Id

17

О

Наименование банка получателя

RltdAgts.CdtrAgt.FinInstnId.Nm

18

O

Наименование банка получателя*

RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine

19

O

SWIFT банка плательщика

RltdAgts.DbtrAgt.FinInstnId.BICFI

20

O

БИК банка плательщика

RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

21

O

Корреспондентский cчёт банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Id

22

O

Клиринговый код банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Issr

23

R

Наименование банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Nm

24

O

Наименование банка плательщика*

RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine

Заполняется в случае, если наименование больше 140 символов

25

R

Назначение платежа

RmtInf.Ustrd[1..2]

Если значение по длине превышает 140 символов, то часть строки > 140 символов указывается во втором теге Ustrd

26

O

Очерёдность платежа (21)

Purp.Prtry

27

O

Составитель

RltdAgts.DbtrAgt.FinInstnId.Nm

28

O

Сумма по кредиту

SplmtryData.Envlp.CrdtSum

29

O

Номер уведомления о зачислении на транзитный счет

SplmtryData.Envlp.Notif.Nuved

30

O

Дата уведомления NUVED

SplmtryData.Envlp.Notif.Dtuv

Дата в формате ISO: YYYY-MM-DD.

31

O

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

SplmtryData.Envlp.Notif.Dtcpd

Дата в формате ISO: YYYY-MM-DD.

32

O

Дата начала действия нарушения

SplmtryData.Envlp.Notif.Bviol

Дата в формате ISO: YYYY-MM-DD.

33

O

ID документа СР

SplmtryData.Envlp.NumSB

34

O

ID документа СР (2)

Refs.TxId

35

O

Код выплат (110)

Tax.Rcrd.Tp

36

O

Код вида дохода (20)

AmtDtls.PrtryAmt.Tp

37

O

Расходы отправителя сообщения (константа)

AmtDtls.PrtryAmt.Amt@Ccy

Заполняется значением 0, если указан Код вида дохода (20)
<Amt Ccy="RUB">0</Amt>

Платежный ордер
Информация о транзакции
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry [camt.052]

1

R

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

Amt@Ccy

2

R

Валюта операции

Amt@Ccy

3

R

Индикатор Дебет/Кредит

CdtDbtInd

"DBIT" / "CRDT"

4

R

Статус операции:
"PDNG" - исполняется;
"BOOK" - исполнено.

Sts

Для промежуточной выписки 'PDNG'.
Для финальной выписки 'BOOK'.

5

R

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

BookgDt.Dt

6

R

Дата валютирования

ValDt.Dt

7

R

Код транзакции

BkTxCd.Domn.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

8

R

Тип транзакции

BkTxCd.Domn.Fmly.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

9

O

Подтип транзакции

BkTxCd.Domn.Fmly.SubFmlyCd

см. таблицу соответствия вида операции
с коллекцией документов ISO

10

O

Код операции

BkTxCd.Prtry.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

11

O

Код дебитора

AcctSvcrRef

5 символов

12

O

Код дебитора (расширенный)

AddtlNtryInf

8 символов

Детали строки выписки
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry.NtryDtls.TxDtls [camt.052]

1

R

Номер документа (3)

Refs.EndToEndId

2

R

Сумма операции (7)
Мнемоника валюты

Amt@Ccy

3

R

Наименование плательщика (8)

RltdPties.Dbtr.Nm

4

O

Наименование плательщика (8)*

RltdPties.Dbtr.PstlAdr.AdrLine

Заполняется в случае, если наименование больше 140 символов

5

O

ИНН плательщика (60)

RltdPties.Dbtr.Id.OrgId.Othr.Id

6

O

ISO код типа данных для ИНН плательщика

RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН.
Константа "TXID"

7

O

Номер счета плательщика (9)

RltdPties.DbtrAcct.Id.Othr.Id

8

O

SWIFT банка плательщика

RltdAgts.DbtrAgt.FinInstnId.BICFI

9

O

Клиринговый код банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Issr

10

O

БИК банка плательщика (11)

RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

11

O

Корреспондетский счёт банка плательщика (12)

RltdAgts.DbtrAgt.FinInstnId.Othr.Id

12

O

Наименование банка плательщика (10)

RltdAgts.DbtrAgt.FinInstnId.Nm

13

O

Наименование банка плательщика (10)*

RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine

Заполняется в случае, если наименование больше 140 символов

14

R

Наименование получателя (16)

RltdPties.Cdtr.Nm

15

O

Наименование получателя (16)*

RltdPties.Cdtr.PstlAdr.AdrLine

Заполняется в случае, если наименование больше 140 символов

16

O

ИНН получателя (61)

RltdPties.Cdtr.Id.OrgId.Othr.Id

17

O

ISO код типа данных для ИНН получателя

RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН.
Константа "TXID"

18

R

Номер счета получателя (17)

RltdPties.CdtrAcct.Id.Othr.Id

19

O

БИК банка получателя (14)

RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

20

O

SWIFT банка получателя

RltdAgts.CdtrAgt.FinInstnId.BICFI

21

O

Клиринговый код банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Issr

22

O

Корреспондентский счёт банка получателя (15)

RltdAgts.CdtrAgt.FinInstnId.Othr.Id

23

О

Наименование банка получателя (13)

RltdAgts.CdtrAgt.FinInstnId.Nm

24

O

Наименование банка получателя (13)*

RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine

25

O

КПП получателя (103)

Tax.Cdtr.TaxTp

26

O

КПП плательщика (102)

Tax.Dbtr.TaxTp

27

R

Назначение платежа

RmtInf.Ustrd[1..2]

Если значение по длине превышает 140 символов, то часть строки > 140 символов указывается во втором теге Ustrd

28

O

Код УИН (22)

RmtInf.Strd[1].CdtrRefInf.Ref

29

R

Очер. плат. (21)

Purp.Prtry

30

R

Сумма комиссии
Валюта комиссии

Chrgs.Rcrd.Amt@Ccy

31

R

Сумма операции
Валюта операции

Amt@Ccy

32

O

Номер уведомления о зачислении на транзитный счет

SplmtryData.Envlp.Notif.Nuved

33

O

Дата уведомления NUVED

SplmtryData.Envlp.Notif.Dtuv

Дата в формате ISO: YYYY-MM-DD

34

O

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

SplmtryData.Envlp.Notif.Dtcpd

Дата в формате ISO: YYYY-MM-DD

35

O

Дата начала действия нарушения

SplmtryData.Envlp.Notif.Bviol

Дата в формате ISO: YYYY-MM-DD

36

O

ID документа СР

SplmtryData.Envlp.NumSB

37

O

ID документа СР (2)

Refs.TxId

38

O

Код выплат (110)

Tax.Rcrd.Tp

39

O

Код вида дохода (20)

AmtDtls.PrtryAmt.Tp

40

O

Расходы отправителя сообщения (константа)

AmtDtls.PrtryAmt.Amt@Ccy

Заполняется значением 0, если указан Код вида дохода (20)
<Amt Ccy="RUB">0</Amt>

41

O

Cтатус налогоплательщика (101)

Tax.Rcrd.DbtrSts

42

O

КБК (104)

Tax.Rcrd.CtgyDtls

43

O

ОКТМО (105)

Tax.AdmstnZn

44

O

Основание налогового платежа (106)

Tax.Rcrd.Ctgy

45

O

Год налогового периода (107)

Tax.Rcrd.Prd.Yr

46

O

Тип налогового периода (107)

Tax.Rcrd.Prd.Tp

Может принимать одно из значений:
MM01 - MM12;
QTR1; QTR2; QTR3; QTR4;
HLF1; HLF2.

47

O

Дата налогового периода (107)

Tax.Rcrd.Prd.FrToDt.FrDt

48

O

Дата налогового периода (107)

Tax.Rcrd.Prd.FrToDt.ToDt

Указывается для соблюдения формата.

49

O

Код таможенного органа (107)

Tax.Cdtr.RegnId

50

O

Номер налогового платежа (108)

Tax.RefNb

51

O

Дата налогового документа (109)

Tax.Dt, значения "0" или "00" указываются в Tax.Mtd

Банковский ордер
Информация о транзакции
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry [camt.052]

15

R

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

Amt

<Amt Ccy="USD">1500.00</Amt>

16

R

Валюта операции

Amt@Ccy

<Amt Ccy="USD">1500.00</Amt>

17

R

Индикатор Дебет ('DBIT')/Кредит ('CRDT')

CdtDbtInd

18

R

Статус операции:
"PDNG" - исполняется;
"BOOK" - исполнено.

Sts

Для промежуточной выписки 'PDNG'.
Для финальной выписки 'BOOK'.

19

R

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

BookgDt.Dt

20

R

Дата валютирования

ValDt.Dt

21

R

Код транзакции
(Domain ISO Transaction Codification)

BkTxCd.Domn.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

22

R

Тип транзакции
(Family ISO Transaction Codification)

BkTxCd.Domn.Fmly.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

23

O

Подтип транзакции
(Subfamily ISO Transaction Codification)

BkTxCd.Domn.Fmly.SubFmlyCd

см. таблицу соответствия вида операции
с коллекцией документов ISO

24

O

Код операции

BkTxCd.Prtry.Cd

см. таблицу соответствия вида операции
с коллекцией документов ISO

25

О

Рублевый эквивалент суммы к оплате

AmtDtls.PrtryAmt.Amt@Ccy

Ccy в данном случае равно RUR

26

O

Описание типа

AmtDtls.PrtryAmt.Tp

Константа "Operation Amount in Rubles"

27

O

Код дебитора

AcctSvcrRef

5 символов

28

O

Код дебитора (расширенный)

AddtlNtryInf

8 символов

Детали строки выписки
R/O Описание Путь Комментарий
Пример

Общий путь
Document.BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls [camt.053]
Document.BkToCstmrAcctRpt.Rpt.Ntry.NtryDtls.TxDtls [camt.052]

42

R

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

Refs.EndToEndId

43

R

Наименование плательщика

RltdPties.Dbtr.Nm

44

O

Наименование плательщика*

RltdPties.Dbtr.PstlAdr.AdrLine

Заполняется в случае, когда наименование плательщика больше 140 символов

45

O

ISO код типа данных для ИНН плательщика

RltdPties.Dbtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН
Константа 'TXID'

46

O

ИНН / КИО плательщика

RltdPties.Dbtr.Id.OrgId.Othr.Id

47

O

Номер счета плательщика

RltdPties.DbtrAcct.Id.Othr.Id

48

R

Наименование получателя

RltdPties.Cdtr.Nm

49

O

Наименование получателя*

RltdPties.Cdtr.PstlAdr.AdrLine

Заполняется в случае, когда наименование получателя больше 140 символов

50

O

ISO код типа данных для ИНН получателя

RltdPties.Cdtr.Id.OrgId.Othr.SchmeNm.Cd

Обязателен при указании ИНН
Константа 'TXID'

51

O

ИНН / КИО получателя

RltdPties.Cdtr.Id.OrgId.Othr.Id

52

R

Номер счета получателя

RltdPties.CdtrAcct.Id.Othr.Id

53

O

SWIFT банка плательщика

RltdAgts.DbtrAgt.FinInstnId.BICFI

54

O

Клиринговый код банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Issr

55

O

БИК банка плательщика (11)

RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

56

O

Корреспондентский счёт банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Othr.Id

57

O

Наименование банка плательщика

RltdAgts.DbtrAgt.FinInstnId.Nm

58

O

Наименование банка плательщика*

RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine

59

O

БИК банка получателя (14)

RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

60

O

SWIFT банка получателя

RltdAgts.CdtrAgt.FinInstnId.BICFI

61

O

Клиринговый код банка получателя

RltdAgts.CdtrAgt.FinInstnId.Othr.Issr

62

O

Корреспондентский счёт банка получателя (15)

RltdAgts.CdtrAgt.FinInstnId.Othr.Id

63

О

Наименование банка получателя (13)

RltdAgts.CdtrAgt.FinInstnId.Nm

64

O

Наименование банка получателя (13)*

RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine

65

R

Назначение платежа

RmtInf.Ustrd[1..2]

Если значение по длине превышает 140 символов, то часть строки > 140 символов указывается во втором теге Ustrd

66

R

Очередность платежа (21)

Purp.Prtry

67

O

Код выплат (110)

Tax.Rcrd.Tp

68

O

Код вида дохода (20)

AmtDtls.PrtryAmt.Tp

69

R

Сумма операции
Валюта операции

Amt@Ccy

70

O

Расходы отправителя сообщения (константа)

AmtDtls.PrtryAmt.Amt@Ccy

Заполняется значением 0, если указан Код вида дохода (20)
<Amt Ccy="RUB">0</Amt>

71

O

Номер уведомления о зачислении на транзитный счет

SplmtryData.Envlp.Notif.Nuved

72

O

Дата уведомления NUVED

SplmtryData.Envlp.Notif.Dtuv

Дата в формате ISO: YYYY-MM-DD

73

O

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

SplmtryData.Envlp.Notif.Dtcpd

Дата в формате ISO: YYYY-MM-DD

74

O

Дата начала действия нарушения

SplmtryData.Envlp.Notif.Bviol

Дата в формате ISO: YYYY-MM-DD

75

O

ID документа СР

SplmtryData.Envlp.NumSB

76

O

ID документа СР (2)

Refs.TxId

Таблица соответствия вида операции с коллекцией документов ISO

Обратите внимание!

Документы, вид операции которых не: "01", "02", "06", "16", "17", - разбираются как мемориальный ордер с видом операции "09".

Код Вид операции Domain Code Set Family Code Set Sub-Family Code Set

01

Валютный перевод Платежное поручение

PMNT

ICDT - дебет
RCDT - кредит

NTAV

02

Платёжное требование

PMNT

CHRG

NTAV

06

Инкассовое поручение

PMNT

ICCN - дебет
RCCN - кредит

NTAV

16

Платёжный ордер

DERV

OSWP

SWPP

17

Банковский ордер

PMNT

RDDT

NTAV

09

Мемориальный ордер

PMNT

MDOP - дебет
MCOP - кредит

COMM

Документы ниже формируются как мемориальный ордер

04

Объявление на взнос наличными

PMNT

CNTR

NTAV

03

Расходный кассовый ордер

PMNT

ICHQ

NTAV

04

Приходный кассовый ордер

PMNT

RCHQ

NTAV

08

Аккредитив

PMNT

DRFT

NTAV

Ответ

Сервис возвращает код и описание ответа. Также, в случае успешной обработки запроса, сервис возвращает XML-документ, соответствующий форматам camt.053.001.05 или camt.052.001.05.

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

200

OK

The request had still being processed. Try later.

Выписка еще не сформирована. Обратитесь позднее.

401

Err

Wrong username or password

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

401

Err

User is not found

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

403

Err

User is disabled

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

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

500

Err

Internal Error

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

400

Err

Request has not been found by MsgId

Запрос не найден по идентификатору MsgId

500

Err

The statement is not final and has incorrect closing date: <текущая бизнес-дата>

Выписка не финальная и не может быть сформирована

500

Err

The request has not been processed due to errors. Please contact the service support.

Выписка не была сформирована из-за ошибок (по всем счетам из запроса). Обратитесь в техподдержку

Пример выписки
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.053.001.05">
	<BkToCstmrStmt>
		<GrpHdr>
			<MsgId>e584449c1e094e7190abfde65bd33c91</MsgId>
			<CreDtTm>2021-03-18T15:01:30.385+03:00</CreDtTm>
		</GrpHdr>
		<Stmt>
			<Id>25efb2a4c4ef4fa6a0a981ac35f56ac2</Id>
			<CreDtTm>2021-03-18T15:01:30.385+03:00</CreDtTm>
			<FrToDt>
				<FrDtTm>2021-03-18T00:00:00Z</FrDtTm>
				<ToDtTm>2021-03-18T00:00:00Z</ToDtTm>
			</FrToDt>
			<Acct>
				<Id>
					<Othr>
						<Id>40702810200000000083</Id>
					</Othr>
				</Id>
				<Ccy>RUR</Ccy>
				<Ownr>
					<Nm>ООО “Тест Альфа-Линк”</Nm>
					<Id>
						<OrgId>
							<Othr>
								<Id>7013602245</Id>
								<SchmeNm>
									<Cd>TXID</Cd>
								</SchmeNm>
							</Othr>
						</OrgId>
					</Id>
				</Ownr>
				<Svcr>
					<FinInstnId>
						<BICFI>ALFARUMMXXX</BICFI>
						<ClrSysMmbId>
							<ClrSysId>
								<Cd>RUCBC</Cd>
							</ClrSysId>
							<MmbId>044525593</MmbId>
						</ClrSysMmbId>
						<Nm>АО"АЛЬФА-БАНК"</Nm>
						<PstlAdr>
							<AdrLine>107078,Россия, г.Москва, ул.Маши   Порываевой д.34</AdrLine>
						</PstlAdr>
						<Othr>
							<Id>7728168971</Id>
						</Othr>
					</FinInstnId>
				</Svcr>
			</Acct>
			<Bal>
				<Tp>
					<CdOrPrtry>
						<Cd>OPBD</Cd>
					</CdOrPrtry>
				</Tp>
				<Amt Ccy="RUR">103719670.32</Amt>
				<CdtDbtInd>CRDT</CdtDbtInd>
				<Dt>
					<Dt>2021-03-18</Dt>
				</Dt>
				<Avlbty>
					<Dt>
						<ActlDt>2021-03-18</ActlDt>
					</Dt>
					<Amt Ccy="RUR">103719670.32</Amt>
					<CdtDbtInd>CRDT</CdtDbtInd>
				</Avlbty>
			</Bal>
			<Bal>
				<Tp>
					<CdOrPrtry>
						<Cd>CLBD</Cd>
					</CdOrPrtry>
				</Tp>
				<Amt Ccy="RUR">103719672.78</Amt>
				<CdtDbtInd>CRDT</CdtDbtInd>
				<Dt>
					<Dt>2021-03-18</Dt>
				</Dt>
				<Avlbty>
					<Dt>
						<ActlDt>2021-03-18</ActlDt>
					</Dt>
					<Amt Ccy="RUR">103719672.78</Amt>
					<CdtDbtInd>CRDT</CdtDbtInd>
				</Avlbty>
			</Bal>
			<TxsSummry>
				<TtlCdtNtries>
					<Sum>2.46</Sum>
				</TtlCdtNtries>
				<TtlDbtNtries>
					<Sum>0.00</Sum>
				</TtlDbtNtries>
			</TxsSummry>
			<Ntry>
				<Amt Ccy="RUR">1.23</Amt>
				<CdtDbtInd>CRDT</CdtDbtInd>
				<Sts>PDNG</Sts>
				<BookgDt>
					<Dt>2021-03-18</Dt>
				</BookgDt>
				<ValDt>
					<Dt>2021-03-18</Dt>
				</ValDt>
				<BkTxCd>
					<Domn>
						<Cd>PMNT</Cd>
						<Fmly>
							<Cd>RCDT</Cd>
							<SubFmlyCd>NTAV</SubFmlyCd>
						</Fmly>
					</Domn>
				</BkTxCd>
				<NtryDtls>
					<TxDtls>
						<Refs>
							<EndToEndId>84798</EndToEndId>
						</Refs>
						<Amt Ccy="RUR">1.23</Amt>
						<CdtDbtInd>CRDT</CdtDbtInd>
						<Chrgs>
							<Rcrd>
								<Amt Ccy="RUR">0.00</Amt>
								<Br>CRED</Br>
								<Agt>
									<FinInstnId/>
								</Agt>
							</Rcrd>
						</Chrgs>
						<RltdPties>
							<Dbtr>
								<Nm>Муравьев Иван Евгеньевич</Nm>
								<Id>
									<OrgId>
										<Othr>
											<Id>500909451727</Id>
											<SchmeNm>
												<Cd>TXID</Cd>
											</SchmeNm>
										</Othr>
									</OrgId>
								</Id>
							</Dbtr>
							<DbtrAcct>
								<Id>
									<Othr>
										<Id>40817810415170000004</Id>
									</Othr>
								</Id>
							</DbtrAcct>
							<Cdtr>
								<Nm>Общество с ограниченной ответственностью “Тест Альфа-Линк”</Nm>
								<Id>
									<OrgId>
										<Othr>
											<Id>7013602245</Id>
											<SchmeNm>
												<Cd>TXID</Cd>
											</SchmeNm>
										</Othr>
									</OrgId>
								</Id>
							</Cdtr>
							<CdtrAcct>
								<Id>
									<Othr>
										<Id>40702810200000000083</Id>
									</Othr>
								</Id>
							</CdtrAcct>
						</RltdPties>
						<RltdAgts>
							<DbtrAgt>
								<FinInstnId>
									<ClrSysMmbId>
										<ClrSysId>
											<Cd>RUCBC</Cd>
										</ClrSysId>
										<MmbId>044525593</MmbId>
									</ClrSysMmbId>
									<Nm>АО "АЛЬФА-БАНК"</Nm>
									<Othr>
										<Id>30101810200000000593</Id>
									</Othr>
								</FinInstnId>
							</DbtrAgt>
							<CdtrAgt>
								<FinInstnId>
									<ClrSysMmbId>
										<ClrSysId>
											<Cd>RUCBC</Cd>
										</ClrSysId>
										<MmbId>044525593</MmbId>
									</ClrSysMmbId>
									<Nm>АО "АЛЬФА-БАНК"</Nm>
									<Othr>
										<Id>30101810200000000593</Id>
									</Othr>
								</FinInstnId>
							</CdtrAgt>
							<IntrmyAgt1>
								<FinInstnId/>
							</IntrmyAgt1>
						</RltdAgts>
						<Purp>
							<Prtry>5</Prtry>
						</Purp>
						<RmtInf>
							<Ustrd>Перевод по договору 1751-19/РМ Специальный раздел НС $$99982810014870001318$$</Ustrd>
							<Strd>
								<RfrdDocInf>
									<RltdDt>2021-03-18</RltdDt>
								</RfrdDocInf>
							</Strd>
						</RmtInf>
						<SplmtryData>
							<Envlp>
								<NumSB>D851803210000011</NumSB>
							</Envlp>
						</SplmtryData>
					</TxDtls>
				</NtryDtls>
			</Ntry>
		</Stmt>
	</BkToCstmrStmt>
</Document>

5. Онлайн остаток

У клиентов есть возможность получить остатки по счетам в режиме реального времени в двух форматах:

  • Базовый остаток

  • Расширенный остаток

Базовый остаток
  • Доступный баланс - Реальная сумма, доступная по счету

  • Зарезервированный баланс - зарезервированная сумма по счету

Расширенный остаток
  • Входящий баланс (Входящее сальдо) - остаток по счёту на начало текущего дня

  • Исходящий баланс (Исходящее сальдо) - рассчитывается как арифметическая сумма входящего сальдо и оборотов за текущий день

  • Доступный баланс - Реальная сумма, доступная по счету

  • Зарезервированный баланс - зарезервированная сумма по счету

Обратите внимание!

Сформированный онлайн остаток приходит в ответ на POST-запрос в синхронном режиме.

Запрос онлайн остатка без подписи

Реализована возможность запроса онлайн остатка без подписания УКЭП. Для этого необходимо:

1) В Headers передать параметры:

  • company-tin со значением ИНН компании

  • check-sign-message со значением false

2) Тэг <SgntrSt> оставить пустым.

3) При тестировании использовать данные тестовой компании ООО «Тест Альфа-Линк без подписи».

4) При подключении к промышленному стенду в Заявлении о назначении/изменении прав доступа для функциональности Получение информации (выписки) о движениях по Счету выбрать правило подписания – "Без подписи" (роль «Оператор»).

Запрос

URI

HTTP POST: /API/v1/ISO20022/Statements/AccountBalance - базовый остаток

HTTP POST: /API/v1/ISO20022/Statements/AccountBalanceExtended - расширенный остаток

XML схема

camt.060.001.03

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

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

Общий путь Document.AcctRptgReq

1

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

GrpHdr.MsgId

2

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

GrpHdr.CreDtTm

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

3

Уникальный ID пакета с запросом

RptgReq.Id

4

Признак "Получить данные по типу "Выписка"

RptgReq.ReqdMsgNmId

5

Номер счета

RptgReq.Acct.Id.Othr.Id

6

Наименование организации

RptgReq.AcctOwnr.Pty.Nm

Пример запроса онлайн остатка
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
    <AcctRptgReq>
        <GrpHdr>
            <MsgId>H2H_TEST_STMT_112368042870656700001</MsgId>
            <CreDtTm>2022-05-24T10:00:18</CreDtTm>
        </GrpHdr>
        <RptgReq>
            <Id>H2H_TEST_STMT_112368042870656700001</Id>
            <ReqdMsgNmId>HMQSTASCF</ReqdMsgNmId>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                    </Othr>
                </Id>
            </Acct>
            <AcctOwnr>
                <Pty>
                    <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
                </Pty>
            </AcctOwnr>
        </RptgReq>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </AcctRptgReq>
</Document>

Ответ

XSD схема

camt.052.001.05

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

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

Общий путь Document.BkToCstmrAcctRpt

1

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

GrpHdr.MsgId

2

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

GrpHdr.CreDtTm

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

Общий путь Document.BkToCstmrAcctRpt.Rpt

3

ID

Id

4

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

CreDtTm

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

5

Номер счета

Acct.Id.Othr.Id

6

Буквенный код валюты счета

Acct.Ccy

7

Наименование владельца счета

Acct.Ownr.Nm

Наименование клиента (организации)

8

ИНН / КИО владельца счета

Acct.Ownr.Id.OrgId.Othr.Id

ИНН Клиента

9

ISO код типа данных для ИНН

Acct.Ownr.Id.OrgId.Othr.SchmeNm.Cd

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

Реквизиты обслуживающего банка

10

BIC банка, обслуживающего счет

Acct.Svcr.FinInstnId.BICFI

11

Обозначение российской расчетной системы

Acct.Svcr.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

12

БИК банка/отделения обслуживающего счет

Acct.Svcr.FinInstnId.ClrSysMmbId.MmbId

13

Наименование банка/отделения обслуживающего счет

Acct.Svcr.FinInstnId.Nm

Секция с информацией о балансах для Базового остатка

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

Доступный баланс

14

Тип баланса (доступный баланс)
(1 блок)

Bal[1].Tp.CdOrPrtry.Cd

Константа "ITAV"

15

Доступный баланс

Bal[1].Amt

16

Код валюты доступного баланса

Bal[1].Amt@Ccy

17

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[1].CdtDbtInd

18

Дата баланса

Bal[1].Dt.Dt

Зарезервированный баланс

19

Тип баланса (Зарезервированный баланс)
(2 блок)

Bal[2].Tp.CdOrPrtry.Cd

Константа "INFO"

20

Зарезервированный баланс

Bal[2].Amt

21

Код валюты зарезервированного баланса

Bal[2].Amt@Ccy

22

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[2].CdtDbtInd

23

Дата баланса

Bal[2].Dt.Dt

Секция с информацией о балансах для Расширенного остатка

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

Входящий баланс

24

Тип баланса (Входящий)
(1 блок)

Bal[1].Tp.CdOrPrtry.Cd

Константа "OPBD"

25

Входящий баланс

Bal[1].Amt@Ccy

26

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[1].CdtDbtInd

27

Дата формирования входящего баланса

Bal[1].Dt.Dt

28

Дата формирования входящего баланса в рублёвом эквиваленте

Bal[1].Avlbty.Dt.ActlDt

29

Входящий баланс в рублёвом эквиваленте

Bal[1].Avlbty.Amt

30

Код валюты входящего остатка в рублёвом эквиваленте

Bal[1].Avlbty.Amt@Ccy

31

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[1].Avlbty.CdtDbtInd

Исходящий баланс

32

Тип баланса (Исходящий)
(2 блок)

Bal[2].Tp.CdOrPrtry.Cd

Константа "CLBD"

33

Исходящий баланс

Bal[2].Amt

34

Код валюты исходящего баланса

Bal[2].Amt@Ccy

35

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[2].CdtDbtInd

36

Дата формирования исходящего баланса

Bal[2].Dt.Dt

37

Дата формирования исходящего баланса в рублёвом эквиваленте

Bal[2].Avlbty.Dt.ActlDt

38

Исходящий баланс в рублёвом эквиваленте

Bal[2].Avlbty.Amt

39

Код валюты исходящего баланса в рублёвом эквиваленте

Bal[2].Avlbty.Amt@Ccy

40

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[2].Avlbty.CdtDbtInd

Доступный баланс

41

Тип баланса (Доступный баланс)
(3 блок)

Bal[3].Tp.CdOrPrtry.Cd

Константа "ITAV"

42

Доступный баланс

Bal[3].Amt

43

Код валюты доступного баланса

Bal[3].Amt@Ccy

44

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[3].CdtDbtInd

45

Дата баланса

Bal[3].Dt.Dt

Зарезервированный баланс

46

Тип баланса (Зарезервированный баланс)
(4 блок)

Bal[4].Tp.CdOrPrtry.Cd

Константа "INFO"

47

Зарезервированный баланс

Bal[4].Amt

48

Код валюты зарезервированного баланса

Bal[4].Amt@Ccy

49

Индикатор Дебет ('DBIT') /Кредит ('CRDT')

Bal[4].CdtDbtInd

50

Дата баланса

Bal[4].Dt.Dt

Пример сформированного Базового остатка
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.052.001.05">
    <BkToCstmrAcctRpt>
        <GrpHdr>
            <MsgId>37f79863e8424f1a92d0632fbd4a71b0</MsgId>
            <CreDtTm>2022-05-24T11:50:18.091+03:00</CreDtTm>
        </GrpHdr>
        <Rpt>
            <Id>a83b805424404f0394fbf273807ac75a</Id>
            <CreDtTm>2022-05-24T11:50:18.377+03:00</CreDtTm>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
                <Ownr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Ownr>
                <Svcr>
                    <FinInstnId>
                        <BICFI>ALFARUMMXXX</BICFI>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                    </FinInstnId>
                </Svcr>
            </Acct>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>ITAV</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">15996923005.30</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>INFO</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">1565224.78</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
            </Bal>
        </Rpt>
    </BkToCstmrAcctRpt>
</Document>
Пример сформированного Расширенного остатка
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.052.001.05">
    <BkToCstmrAcctRpt>
        <GrpHdr>
            <MsgId>e4d6975f5c6e46fca732fb7597c46fc9</MsgId>
            <CreDtTm>2022-05-24T11:57:38.231+03:00</CreDtTm>
        </GrpHdr>
        <Rpt>
            <Id>042100f056b84f8da5ddfcde0a54ccfb</Id>
            <CreDtTm>2022-05-24T11:57:38.341+03:00</CreDtTm>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
                <Ownr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Ownr>
                <Svcr>
                    <FinInstnId>
                        <BICFI>ALFARUMMXXX</BICFI>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                    </FinInstnId>
                </Svcr>
            </Acct>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>OPBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">15998489805.08</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2022-05-24</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">15998489805.08</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>CLBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">15998489019.08</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2022-05-24</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">15998489019.08</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>ITAV</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">15996923005.30</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>INFO</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">1565224.78</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2022-05-24</Dt>
                </Dt>
            </Bal>
        </Rpt>
    </BkToCstmrAcctRpt>
</Document>

6. Платёжное поручение

URI

POST: /API/v1/ISO20022/Payments

XML схема

pain.001.001.06

Обратите внимание

Host-to-Host - самостоятельная система, поэтому платежи, отправленные через H2H, не отображаются в АЛБО (ни в старой, ни в новой версии)

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

Для получения статуса "Исполнен" [ACSC] необходимо корректно составить и подписать платежное поручение (пример запроса есть ниже в настоящей документации). Для получения статуса "Отклонен" [RJCT] достаточно, например, некорректно заполнить один из реквизитов.

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

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

Общий путь Document.CstmrCdtTrfInitn.GrpHdr

1

R

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

MsgId

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

2

R

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

CreDtTm

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

3

R

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

NbOfTxs

Общее число поручений (секций CdtTrfTxInf) в сообщении

4

O

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

CtrlSum

Сумма всех отдельных сумм, включенных в сообщение, независимо от валюты.

5

R

Полное название организации

InitgPty.Nm

6

R

ИНН

InitgPty.Id.OrgId.Othr.Id

7

R

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

InitgPty.Id.OrgId.Othr.SchmeNm.Cd

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

Общий путь Document.CstmrCdtTrfInitn.PmtInf

8

R

Уникальный id пакета платежей

PmtInfId

Указывается идентифкатор группы распоряжений. Идентификатор не должен совпадать с MsgId и другими идентификаторами

9

R

Метод оплаты

PmtMtd

Значение "TRF" по умолчанию

10

R

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

ReqdExctnDt

Используется в случае отсутствия тега Pmtlnf.CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt

11

R

Наименование плательщика (8)

Dbtr.Nm

12

О

Наименование плательщика (8)*

Dbtr.CtctDtls.Nm

Заполняется в случае, если наименование плательщика больше 140 символов.

13

R

ИНН плательщика (60)

Dbtr.Id.OrgId.Othr.Id

14

R

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

Dbtr.Id.OrgId.Othr.SchmeNm.Cd

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

15

R

Счет плательщика (9)

DbtrAcct.Id.Othr.Id

16

R

Код клиринговой системы

DbtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

17

R

БИК банка плательщика (11)

DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

18

R

Наименование банка плательщика (10)

DbtrAgt.FinInstnId.Nm

19

R

Корсчет банка плательщика (12)

DbtrAgtAcct.Id.Othr.Id

20

R

Уникальный id платежа

CdtTrfTxInf.PmtId.InstrId

Идентификатор исходного поручения

21

R

Номер документа (3)

CdtTrfTxInf.PmtId.EndToEndId

Целое число до 6 символов. Уникальность номера в течение дня проверяется исходя из уникальности группы параметров: дата платежа, номер платежа, счет плательщика, счет получателя, сумма платежа.

22

R

Вид платежа (5)

CdtTrfTxInf.PmtTpInf.SvcLvl.Cd

Принимаемые значения:
URGP - срочный платеж
NURG - обычный платеж

23

R

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

CdtTrfTxInf.Amt.InstdAmt

24

R

Валюта документа

CdtTrfTxInf.Amt.InstdAmt@Ccy

Для рублёвых платежей "RUR"

25

R

Код клиринговой системы

CdtTrfTxInf.CdtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

26

R

БИК банка получателя (14)

CdtTrfTxInf.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

27

R

Наименование банка получателя (13)

CdtTrfTxInf.CdtrAgt.FinInstnId.Nm

28

O

Корсчет банка получателя (15)

CdtTrfTxInf.CdtrAgtAcct.Id.Othr.Id

29

R

Наименование получателя (16)

CdtTrfTxInf.Cdtr.Nm

30

О

Наименование получателя (16)*

CdtTrfTxInf.Cdtr.CtctDtls.Nm

Заполняется в случае, если наименование получателя больше 140 символов.

31

R

Адрес получателя

CdtTrfTxInf.Cdtr.PstlAdr.AdrLine

32

R

ИНН получателя (61)

CdtTrfTxInf.Cdtr.Id.OrgId.Othr.Id

Для платежей, получателями которых являются ИП/ЮЛ, не являющиеся банками или территориальными органами казначейства данное поле должно быть обязательно заполнено (заполнение 12 нулями недопустимо)

33

R

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

CdtTrfTxInf.Cdtr.Id.OrgId.Othr.SchmeNm.Cd

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

34

O

Счет получателя (17)

CdtTrfTxInf.CdtrAcct.Id.Othr.Id

35

R

Очередность платежа (21)

CdtTrfTxInf.Purp.Prtry

36

O

Признак заполнения поля "Код вида дохода"

CdtTrfTxInf.RgltryRptg.Dtls.Tp

Константа "PTCD"

37

O

Код вида дохода (20)

CdtTrfTxInf.RgltryRptg.Dtls.Cd

Также необходимо заполнить поле PmtInf.CdtTrfTxInf.RgltryRptg.Dtls.Tp = "PTCD"
Данная константа является признаком того, что заполнено поле Код вида дохода

Правило заполнения Чтобы корректно заполнить поле, определите тип дохода, который получит физ. лицо в результате перевода. Если ваш платёж не подпадает под список из ФЗ, поле заполнять не нужно.

Код "1" - при переводе денежных средств, являющихся заработной платой и (или) иными доходами, в отношении которых статьей 99 Федерального закона от 2.10.2007 N 229-ФЗ установлены ограничения размеров удержания. При наличии исполнительного документа укажите взысканную вами сумму в поле «Назначение платежа (24)».

Код "2" - при переводе денежных средств, являющихся доходами, на которые в соответствии со статьей 101 Федерального закона от 2.10. 2007 N 229-ФЗ не может быть обращено взыскание, за исключением доходов, к которым в соответствии с частью 2 статьи 101 Федерального закона от 2.10.2007 N 229-ФЗ ограничения по обращению взыскания не применяются.

Код "3" - при переводе денежных средств, являющихся доходами, к которым в соответствии с частью 2 статьи 101 Федерального закона от 2.10. 2007 N 229-ФЗ ограничения по обращению взыскания не применяются. При наличии исполнительного листа укажите в поле «Назначение платежа (24)» взысканную вами сумму. Обратите внимание, что по доходам с кодом 3 взыскания могут совершаться только по алиментным обязательствам в отношении несовершеннолетних лиц или по обязательствам о возмещении вреда в связи со смертью кормильца.

В остальных случаях код не указывается

Как указать взысканную сумму в поле «Назначение платежа (24)»? Если из переводимых физическому лицу денежных средств, составляющих доходы, указанные в ст. 99 или 101 Федерального закона "Об исполнительном производстве", вами произведено удержание по исполнительному документу, то в поле «Назначение платежа (24)» укажите взысканную сумму в формате: //ВЗС//рубли-копейки//. Например, //ВЗС//100000-00//.

Закон и порядок Подробная информация в Федеральном законе от 21.02.2019 N 12-ФЗ "О внесении изменений в Федеральный закон "Об исполнительном производстве", Указании Банка России от 14.10.2019 N 5286-У "О порядке указания кода вида дохода в распоряжениях о переводе денежных средств

38

O

КПП плательщика (102)

CdtTrfTxInf.Tax.Dbtr.TaxTp

39

O

КПП получателя (103)

CdtTrfTxInf.Tax.Cdtr.TaxTp

Блок CdtTrfTxInf.Tax - Бюджетные реквизиты платежного поручения

Все бюджетные реквизиты становятся обязательными при заполнении поля 101 Статус составителя документа.
Обязательным также становится поле 22 Код платежа

40

O

ОКТМО (105)

CdtTrfTxInf.Tax.AdmstnZn

41

O

Номер налогового документа (108)

CdtTrfTxInf.Tax.RefNb

42

O

Дата налогового документа (109)

CdtTrfTxInf.Tax.Dt

Значения "0" или "00" необходимо указывать в PmtInf.CdtTrfTxInf.Tax.Mtd

43

O

Код выплат (110)

CdtTrfTxInf.Tax.Rcrd.Tp

Правило заполнения

Чтобы корректно заполнить поле «Код выплат (110)», определите тип дохода, который получит физ. лицо в результате перевода. Если ваш платёж не подпадает под перечень из Постановления, код указывать не нужно.

Код 1 проставляется в случае выплат на счёт физ. лица:

1. Пособия по временной нетрудоспособности (только в отношении граждан, подвергшихся воздействию радиации);

2. Пособия по беременности и родам;

3. Единовременного пособия женщинам, вставшим на учёт в медицинских организациях в ранние сроки беременности;

4. Единовременного пособия при рождении ребенка;

5. Ежемесячного пособия по уходу за ребёнком.

Все виды доходов, подпадающих под код 1, перечислены в частях 5.5 и 5.6 статьи 30.5 Федерального закона «О национальной платёжной системе».

В остальных случаях код не указывается. В случае некорректного заполнения поля возможны претензии со стороны физических лиц и/или контролирующих органов.

Закон и порядок Подробная информация в статье 30.5 Закона РФ от 27.06.2011 № 161-ФЗ «О национальной платёжной системе», Постановлении Правительства РФ от 01.12.2018 № 1466 «Об утверждении перечня иных выплат за счет средств бюджетов бюджетной системы Российской Федерации для целей применения частей 5 и 5.1 статьи 30.5 Федерального закона «О национальной платежной системе»

44

O

Код основания налогового платежа (106)

CdtTrfTxInf.Tax.Rcrd.Ctgy

45

O

Код бюджетной классификации (104)

CdtTrfTxInf.Tax.Rcrd.CtgyDtls

46

O

Статус составителя документа (101)

CdtTrfTxInf.Tax.Rcrd.DbtrSts

Реквизит "Код налогового периода (107)": код таможенного органа, показателя налогового периода, дата уплаты налогов.
Данное поле является составным и формируется системой Альфа-Линк по алгоритму, указанному после таблицы (Алгоритм заполнения и обработки параметра "Код налогового периода (107)").

47

O

Год налогового периода

CdtTrfTxInf.Tax.Rcrd.Prd.Yr

48

O

Налоговый период в кодировке ISO20022

CdtTrfTxInf.Tax.Rcrd.Prd.Tp

MM - МС;
QTR - КВ;
HLF - ПЛ;
не указано - ГД.

49

O

Дата уплаты налогов

CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt

Алгоритм обработки приведен ниже

50

O

Конец периода
(не используется)

CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.ToDt

Не используется, указывается только для соблюдения формата.

51

O

Код таможенного органа

CdtTrfTxInf.Tax.Cdtr.RegnId

52

O

Назначение платежа (24)

CdtTrfTxInf.RmtInf.Ustrd[1..2]

Количество полей Ustrd неограниченно, но длина каждого не должна превышать 140 символов. Общая длина поля (24) не должна превышать 210 символов

53

O

Тип записи

CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.Tp.CdOrPrtry.Prtry

Константа "POD"

54

R

Дата документа (4)

CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt

Формат: YYYY-MM-DD

55

О

Код платежа (22)

CdtTrfTxInf.RmtInf.Strd.CdtrRefInf.Ref

56

О

Информация отправителя получателю

CdtTrfTxInf.RmtInf.Strd.AddtlRmtInf[1..2]

Значения двух полей объединяются. Макс. длина каждого тега 140 символов. Макс. длина всего поля вместе 210 символов.

Алгоритм заполнения и обработки параметра "Код налогового периода (107)"

Заполнение на стороне клиента

Код налогового периода указывается в следующих тегах:

  • FrDt - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt - дата налогового периода

  • Yr - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.Yr - год налогового периода

  • Tp - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.Tp - налоговый период

  • RegnId - PmtInf.CdtTrfTxInf.Tax.Cdtr.RegnId - код налогового органа
    (прим. ToDt - Не используется, указывается для соблюдения формата)

Код состоит из 10 знаков, все значения между собой разделяются точками: XX.YY.ZZZZ

XX. - периодичность платежа.
YY. - порядковый номер периода. Для месячных платежей порядковый номер месяца с 1 до 12, для квартальных — номер квартала от 1 до 4, для полугодовых платежей — 01 и 02 полугодие. Для годовых платежей всегда — 00;
ZZZZ - год, к которому относится налоговый платеж.

  • Если XX. = {МС.,КВ.,ПЛ.,ГД.}

МС КВ ПЛ ГД

Tp

MM + {01-12} (YY)

QTR + {1-4} (YY без нуля)

HLF + {1,2} (YY без нуля)

Не указывается

FrDt

Не указывается

Yr

ZZZZ

  • Если период представляет из себя конкретную дату, то заполняется поле CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt, остальные не учитываются.

  • Если имеется только код налогового органа, то он указывается в теге PmtInf.CdtTrfTxInf.Tax.Cdtr.RegnId

Примеры:

Tp

FrDt

Yr

RegnId

12.03.2016

12.03.2016

ГД.00.2016

2016

ПЛ.01.2015

HLF1

2015

КВ.03.2016

QTR3

2016

МС.10.2014

MM10

2014

10001010

10001010

Обработка на стороне банка

Если FrDt содержит значение, то необходимо FrDt, преобразовать к формату ДД.ММ.ГГГГ. Иначе:

  1. Если Tp начинается с 'MM', то Код налогового периода = ''МС.'+substring(Tp,3,2)+YEAR(Yr);

  2. Если Tp начинается с 'QTR', Код налогового периода = ''КВ.0'+substring(Tp,4,1)+YEAR(Yr);

  3. Если Tp начинается с 'HLF', Код налогового периода = ''ПЛ.0'+substring(Tp,4,1)+YEAR(Yr);

  4. Если Tp не указано, то Код налогового периода = 'ГД.00.'+YEAR(Yr).

Иначе, если RegnId содержит значение, то Код налогового периода = RegnId. Если не заполнены RegnId, FrDt, Yr, Tp, то Код налогового периода = 0.

Где:
- FrDt - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt - дата налогового периода
- Yr - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.Yr - год налогового периода
- Tp - PmtInf.CdtTrfTxInf.Tax.Rcrd.Prd.Tp - налоговый период
- RegnId - PmtInf.CdtTrfTxInf.Tax.Cdtr.RegnId - код налогового органа
(прим. ToDt - Не используется, указывается для соблюдения формата)

Примеры:

12.03.2016
ГД.00.2016
ПЛ.01.2015
КВ.03.2016
МС.10.2014
10001010

Ответ

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

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

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

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

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:pain.001.001.06">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2021-08-18-141541737</MsgId>
            <CreDtTm>2021-08-26T14:10:41.727+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <CtrlSum>100.00</CtrlSum>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_MSG_2021-08-18-141541737</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <ReqdExctnDt>2021-08-26</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                    </Othr>
                </Id>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО АЛЬФА-БАНК</Nm>
                </FinInstnId>
            </DbtrAgt>
            <DbtrAgtAcct>
                <Id>
                    <Othr>
                        <Id>30101810200000000593</Id>
                    </Othr>
                </Id>
            </DbtrAgtAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_MSG_2021-08-18-141541737</InstrId>
                    <EndToEndId>141547</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                      <Cd>NURG</Cd>
                    </SvcLvl>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">100</InstdAmt>
                </Amt>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО АЛЬФА-БАНК</Nm>
                    </FinInstnId>
                </CdtrAgt>
                <CdtrAgtAcct>
                    <Id>
                        <Othr>
                            <Id>30101810200000000593</Id>
                        </Othr>
                    </Id>
                </CdtrAgtAcct>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк Получатель"</Nm>
                    <PstlAdr>
                        <AdrLine>г Москва ул. Московская, 1</AdrLine>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>4689269939</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702810300000000132</Id>
                        </Othr>
                    </Id>
                </CdtrAcct>
                <Purp>
                    <Prtry>5</Prtry>
                </Purp>
                <RgltryRptg>
                    <Dtls>
                        <Tp>PTCD</Tp>
                        <Cd>3</Cd>
                    </Dtls>
                </RgltryRptg>
                <RmtInf>
                    <Ustrd>тестирование</Ustrd>
                    <Ustrd>h2h</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2021-08-26</RltdDt>
                        </RfrdDocInf>
                        <CdtrRefInf>
                            <Ref>0</Ref>
                        </CdtrRefInf>
                        <AddtlRmtInf>тестирование h2h</AddtlRmtInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="sigID1"><ds:SignedInfo><ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/><ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/><ds:Reference URI=""><ds:Transforms><ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></ds:Transforms><ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/><ds:DigestValue>qhGYqvIvdyMlKwKyJzPz8QpsLdzJGJBEUakH/nipCcc=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue>jhv2MNb8YoBtT8OZqWEpdc81p5sNzy1z5U8f9B+joVsGDXVvgjpkF11FndFXdkKw2mIGnfA+cZtzC4NRby8DpQ==</ds:SignatureValue><ds:KeyInfo><ds:X509Data><ds:X509Certificate>MIIJAzCCCLCgAwIBAgIRBTd/twDprFm+QYXHcVcbqLQwCgYIKoUDBwEBAwIwggELMRgwFgYFKoUDZAESDTEwMjc3MDAwNjczMjgxGjAYBggqhQMDgQMBARIMMDA3NzI4MTY4OTcxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxKjAoBgNVBAkMIdCj0LsuINCa0LDQu9Cw0L3Rh9C10LLRgdC60LDRjyAyNzEPMA0GA1UECwwG0KPQmNCRMSEwHwYDVQQKDBjQkNCeINCQ0JvQrNCk0JAt0JHQkNCd0JoxNTAzBgNVBAMMLNCi0JXQodCiINCj0KYgMi4wINCQ0J4gItCQ0JvQrNCk0JAt0JHQkNCd0JoiMB4XDTIxMDMxMjEwNTgwNloXDTIyMDYxMjExMDgwNlowggH5MTIwMAYDVQQqDCnQodC10YDRgtC40YTQuNC60LDRgiDQodC+0YLRgNGD0LTQvdC40LrQsDEZMBcGA1UEBAwQ0KLQtdGB0YLQvtCy0YvQuTFJMEcGA1UECQxAMTA3MDc4LCDQsy4g0JzQvtGB0LrQstCwLCDRg9C7LiDQmtCw0LvQsNC90YfQtdCy0YHQutCw0Y8sINC0LiAyNzEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODE0MDIGA1UEDAwr0JDRgNGF0LjRgtC10LrRgtC+0YAg0L3QsNC/0YDQsNCy0LvQtdC90LjRjzEmMCQGCSqGSIb3DQEJARYXdmJ1cm1pc3Ryb3ZAYWxmYWJhbmsucnUxCzAJBgNVBAYTAlJVMRUwEwYDVQQIDAzQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEjMCEGA1UECgwa0JDQniAi0JDQu9GM0YTQsC3QkdCw0L3QuiIxUDBOBgNVBAsMR9CU0LjRgNC10LrRhtC40Y8g0YDQsNC30YDQsNCx0L7RgtC60Lgg0YbQuNGE0YDQvtCy0YvRhSDRgdC10YDQstC40YHQvtCyMRcwFQYDVQQDDA4xdHJ1c3Rjb3JlLTI1NjBmMB8GCCqFAwcBAQEBMBMGByqFAwICJAAGCCqFAwcBAQICA0MABEA8fBN/QZKE4T03YEHTMTldxRHPF/SdYGSPFEmUMGlrEuLFycdkDBxSFTaFfewyYVTDpJ53/1JGp60sKVFvyvIxo4IE9DCCBPAwDgYDVR0PAQH/BAQDAgOoMB8GCSsGAQQBgjcVBwQSMBAGCCqFAwICLgAIAgEBAgEAMB0GA1UdDgQWBBSXVVvUtLRiPz8231/48DKMZsLbVDAdBgNVHSUEFjAUBggrBgEFBQcDAgYIKwYBBQUHAwQwJwYJKwYBBAGCNxUKBBowGDAKBggrBgEFBQcDAjAKBggrBgEFBQcDBDBxBggrBgEFBQcBAQRlMGMwYQYIKwYBBQUHMAKGVWh0dHA6Ly90ZXN0LXVjMi5tb3Njb3cuYWxmYWludHJhLm5ldC9haWEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcnQwHQYDVR0gBBYwFDAIBgYqhQNkcQEwCAYGKoUDZHECMIIBQwYFKoUDZHAEggE4MIIBNAw00KHQmtCX0JggItCa0YDQuNC/0YLQvtCf0YDQviBDU1AiICjQstC10YDRgdC40Y8gNC4wKQxa0J/QkNCaICLQo9C00L7RgdGC0L7QstC10YDRj9GO0YnQuNC5INGG0LXQvdGC0YAgItCa0YDQuNC/0YLQvtCf0YDQviDQo9CmIiDQstC10YDRgdC40LggMi4wDE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI0LTMwMTAg0L7RgiAzMC4xMi4yMDE2DE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI4LTI5ODMg0L7RgiAxOC4xMS4yMDE2MD8GBSqFA2RvBDYMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQuMCkwgb0GA1UdHwSBtTCBsjBboFmgV4ZVaHR0cDovL3Rlc3QtdWMyLm1vc2Nvdy5hbGZhaW50cmEubmV0L2NkcC82ZjBiMGQ1MjVkMTlhNzQ4YmUwNTE4OTM5N2Q4MDk1NTdkMzg4Y2EyLmNybDBToFGgT4ZNaHR0cDovL2NhLmFsZmFpbnRyYS5uZXQvY2VydGRhdGEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcmwwggFNBgNVHSMEggFEMIIBQIAUbwsNUl0Zp0i+BRiTl9gJVX04jKKhggETpIIBDzCCAQsxGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEqMCgGA1UECQwh0KPQuy4g0JrQsNC70LDQvdGH0LXQstGB0LrQsNGPIDI3MQ8wDQYDVQQLDAbQo9CY0JExITAfBgNVBAoMGNCQ0J4g0JDQm9Cs0KTQkC3QkdCQ0J3QmjE1MDMGA1UEAwws0KLQldCh0KIg0KPQpiAyLjAg0JDQniAi0JDQm9Cs0KTQkC3QkdCQ0J3QmiKCEQWXkJ8A26z9j0tjSIs3FfK5MCsGA1UdEAQkMCKADzIwMjEwMzEyMTA1ODA1WoEPMjAyMjA2MTIxMDU4MDVaMAoGCCqFAwcBAQMCA0EAHvrxKAto/T3htcx89MTL17HjVlLFJMt1rjCg2lg1jhUof6rY4FVArNEOsIRWxhwG8hV8j3rhl15wvpTgmOTvLg==</ds:X509Certificate></ds:X509Data></ds:KeyInfo></ds:Signature></SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
Пример бюджетного платежа
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06">
  <CstmrCdtTrfInitn>
    <GrpHdr>
      <MsgId>MSGPT77281424692108310912040000000</MsgId>
      <CreDtTm>2021-08-31T09:12:04+03:00</CreDtTm>
      <NbOfTxs>1</NbOfTxs>
      <InitgPty>
        <!-- Наименование организации отправителя сообщения -->
        <Nm>ООО "Тест Альфа-Линк"</Nm>
        <Id>
          <OrgId>
            <Othr>
              <!-- ИНН организации отправителя сообщения -->
              <Id>7013602245</Id>
              <SchmeNm>
                <Cd>TXID</Cd>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
      </InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>MSGPT77281424692108310912040000000</PmtInfId>
      <PmtMtd>TRF</PmtMtd>
      <ReqdExctnDt>2021-08-26</ReqdExctnDt>
      <Dbtr>
        <!-- (Реквизит 8) Наименование организации плательщика -->
        <Nm>ООО "Тест Альфа-Линк"</Nm>
        <Id>
          <OrgId>
            <Othr>
              <!-- (Реквизит 60) ИНН плательщика -->
              <Id>7013602245</Id>
              <SchmeNm>
                <Cd>TXID</Cd>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
      </Dbtr>
      <DbtrAcct>
        <Id>
          <Othr>
            <!-- (Реквизит 9) Счет плательщика -->
            <Id>40702810200000000083</Id>
          </Othr>
        </Id>
      </DbtrAcct>
      <DbtrAgt>
        <FinInstnId>
          <ClrSysMmbId>
            <ClrSysId>
              <Cd>RUCBC</Cd>
            </ClrSysId>
            <!-- (Реквизит 11) БИК банка плательщика -->
            <MmbId>044525593</MmbId>
          </ClrSysMmbId>
          <!-- (Реквизит 10) Наименование банка плательщика -->
          <Nm>АО "АЛЬФА-БАНК"</Nm>
        </FinInstnId>
      </DbtrAgt>
      <DbtrAgtAcct>
        <Id>
          <Othr>
            <!-- (Реквизит 12) Корсчет банка плательщика -->
            <Id>30101810200000000593</Id>
          </Othr>
        </Id>
      </DbtrAgtAcct>
      <CdtTrfTxInf>
        <PmtId>
          <InstrId>MSGPT77281424692108310912040000000</InstrId>
          <!-- (Реквизит 3) Номер документа -->
          <EndToEndId>00335</EndToEndId>
        </PmtId>
        <PmtTpInf>
          <SvcLvl>
            <!-- Вид платежа: NURG - обычные; URGP - срочные -->
            <Cd>NURG</Cd>
          </SvcLvl>
        </PmtTpInf>
        <Amt>
          <InstdAmt Ccy="RUR">100.00</InstdAmt>
        </Amt>
        <CdtrAgt>
          <FinInstnId>
            <ClrSysMmbId>
              <ClrSysId>
                <Cd>RUCBC</Cd>
              </ClrSysId>
              <!-- (Реквизит 14) БИК банка получателя -->
              <MmbId>004525988</MmbId>
            </ClrSysMmbId>
            <!-- (Реквизит 13) Наименование банка получателя -->
            <Nm>ГУ БАНКА РОССИИ ПО ЦФО//УФК ПО Г. МОСКВЕ г. Москва</Nm>
          </FinInstnId>
        </CdtrAgt>
        <Cdtr>
          <!-- (Реквизит 16) Наименование получателя -->
          <Nm>ИФНС № 3 по г.Москве</Nm>
          <PstlAdr>
            <AdrLine>г Москва ул. Московская, 1</AdrLine>
          </PstlAdr>
          <Id>
            <OrgId>
              <Othr>
                <!-- (Реквизит 61) ИНН получателя -->
                <Id>7703037470</Id>
                <SchmeNm>
                  <Cd>TXID</Cd>
                </SchmeNm>
              </Othr>
            </OrgId>
          </Id>
        </Cdtr>
        <CdtrAcct>
          <Id>
            <Othr>
              <!-- (Реквизит 17) Счет получателя -->
              <Id>03100643000000017300</Id>
            </Othr>
          </Id>
        </CdtrAcct>
        <Purp>
          <!-- (Реквизит 21) Очередность платежа -->
          <Prtry>5</Prtry>
        </Purp>
        <Tax>
          <Cdtr>
            <!-- (Реквизит 103) КПП получателя -->
            <TaxTp>770301001</TaxTp>
          </Cdtr>
          <Dbtr>
            <!-- (Реквизит 102) КПП плательщика -->
            <TaxTp>770301001</TaxTp>
          </Dbtr>
          <!-- (Реквизит 105) Код ОКТМО -->
          <AdmstnZn>45380000</AdmstnZn>
          <!-- (Реквизит 108) Номер налогового документа -->
          <RefNb>0</RefNb>
          <!-- (Реквизит 109) Дата налогового документа -->
          <Dt>2021-08-31</Dt>
          <Rcrd>
            <!-- (Реквизит 106) Код основания налогового платежа -->
            <Ctgy>ТП</Ctgy>
            <!-- (Реквизит 104) Код бюджетной классификации -->
            <CtgyDtls>18210102080011000110</CtgyDtls>
            <!-- (Реквизит 101) Статус составителя документа -->
            <DbtrSts>02</DbtrSts>
            <Prd>
              <!-- (Реквизит 107) Год налогового периода -->
              <Yr>2021-08-30</Yr>
              <!-- (Реквизит 107) Код налогового периода -->
              <!-- <Tp>MM12</Tp> -->
              <!--Заполняем FrDt в случае, если должна быть указана дата в 107 -->
              <!--<FrToDt><FrDt>2018-10-10</FrDt><ToDt>2018-10-10</ToDt></FrToDt>-->
            </Prd>
          </Rcrd>
        </Tax>
        <RmtInf>
          <Ustrd>Пример бюджетного платежа</Ustrd>
          <Strd>
            <RfrdDocInf>
              <Tp>
                <CdOrPrtry>
                  <Prtry>POD</Prtry>
                </CdOrPrtry>
              </Tp>
              <!-- (Реквизит 4) Дата документа -->
              <RltdDt>2021-08-31</RltdDt>
            </RfrdDocInf>
            <CdtrRefInf>
              <!-- (Реквизит 22) Код платежа (УИН)-->
              <Ref>0</Ref>
            </CdtrRefInf>
          </Strd>
        </RmtInf>
      </CdtTrfTxInf>
    </PmtInf>
    <SplmtryData>
      <Envlp>
        <SgntrSt/>
      </Envlp>
    </SplmtryData>
  </CstmrCdtTrfInitn>
</Document>
Пример квитанции на платеж pain.002.001.06
В случае успеха:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.06">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>3c402c01c9b849a0ac5c0434299aecc1</MsgId>
            <CreDtTm>2019-01-30T16:13:24.665+03:00</CreDtTm>
            <InitgPty>
                <Id>
                    <OrgId>
                        <AnyBIC>ALFARUMM</AnyBIC>
                        <Othr>
                            <Id>044525593</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>0b94215ea5604a5ab00aad436dad0900</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
            <OrgnlCreDtTm>2019-01-29T15:25:53.000+03:00</OrgnlCreDtTm>
            <GrpSts>RCVD</GrpSts>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>PKG31d00a62a203465095f93ed1c924ca67</OrgnlPmtInfId>
            <PmtInfSts>RCVD</PmtInfSts>
            <TxInfAndSts>
                <OrgnlInstrId>PMTec020f8f93884a8baad2361eaf13f70b</OrgnlInstrId>
                <TxSts>ACTC</TxSts>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>
Пример платежного поручения с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива

7. Валютный перевод

URI

POST: /API/v1/ISO20022/Payments

XSD схема

pain.001.001.06

Обратите внимание

Host-to-Host - самостоятельная система, поэтому платежи, отправленные через H2H, не отображаются в АЛБО (ни в старой, ни в новой версии)

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

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

1

R

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

Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm

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

2

R

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

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

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

3

R

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

Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs

Общее число поручений (секций CdtTrfTxInf) в сообщении

4

O

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

Document.CstmrCdtTrfInitn.GrpHdr.CtrlSum

Сумма всех отдельных сумм, включенных в сообщение, независимо от валюты.

5

R

Уникальный id пакета платежей

Document.CstmrCdtTrfInitn.PmtInf.PmtInfId

Указывается идентифкатор группы распоряжений

6

R

Уникальный id платежа

Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId

Идентифкатор исходного поручения

7

R

Метод оплаты

Document.CstmrCdtTrfInitn.PmtInf.PmtMtd

Значение "TRF" по умолчанию

8

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

Общий путь Document.CstmrCdtTrfInitn.PmtInf

10

R

Валюта перевода
(буквенный код)

CdtTrfTxInf.Amt.InstdAmt@Ccy

<InstdAmt Ccy="USD">
1000.00
</InstdAmt>

11

R

Сумма перевода

CdtTrfTxInf.Amt.InstdAmt

<InstdAmt Ccy="USD">
1000.00
</InstdAmt>

12

R

Дата перевода

CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt

В случае отсутствия значения в RltdDt, брать из …​/ReqdExctnDt. Формат даты YYYY-MM-DD

13

R

Номер счета плательщика

DbtrAcct.Id.Othr.Id

14

R

Наименование плательщика

Dbtr.Nm

15

R

Адрес плательщика

Dbtr.PstlAdr.AdrLine

16

R

ИНН плательщика

Dbtr.Id.OrgId.Othr.Id

17

O

SWIFT-код банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.BICFI

18

O

Наименование банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.Nm

19

O

Адрес банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.PstlAdr.AdrLine

20

O

Клиринговый код банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.Othr.Issr

21

O

Клиринговый код банка-корреспондента

CdtTrfTxInf.IntrmyAgt1.FinInstnId.Othr.Id

Поле обязательно по схеме

22

O

Номер счета банка получателя

CdtTrfTxInf.CdtrAgtAcct.Id.IBAN

23

O

Номер счета в банке-корреспонденте

CdtTrfTxInf.CdtrAgtAcct.Id.Othr.Id

24

O

SWIFT код банка получателя

CdtTrfTxInf.CdtrAgt.FinInstnId.BICFI

25

O

Клиринговый код банка получателя

CdtTrfTxInf.CdtrAgt.FinInstnId.Othr.Issr

26

O

Наименование банка получателя

CdtTrfTxInf.CdtrAgt.FinInstnId.Nm

27

O

Адрес банка получателя

CdtTrfTxInf.CdtrAgt.FinInstnId.PstlAdr.AdrLine

28

O

Номер счета получателя IBAN

CdtTrfTxInf.CdtrAcct.Id.IBAN

29

O

Номер счета получателя, в случае если счет не IBAN

CdtTrfTxInf.CdtrAcct.Id.Othr.Id

30

R

Наименование получателя

CdtTrfTxInf.Cdtr.Nm

31

R

Адрес получателя

CdtTrfTxInf.Cdtr.PstlAdr.AdrLine

32

R

Назначение платежа

CdtTrfTxInf.RmtInf.Ustrd

Условия заполнения для платежей в ОАЭ

Центральным Банком Объединенных Арабских Эмиратов (ОАЭ) определены правила оформления платежей в ОАЭ
согласно которым в каждом платеже требуется указание специального кода назначения платежа (далее- код)

При оформлении платежа в любой иностранной валюте укажите код в заявлении на перевод в начале поля в виде:

/BENEFRES/AE//КОД/далее укажите назначение платежа.

Пример: /BENEFRES/AE//SAL/ADDL NARRATIVE

33

R

Тип списания комиссии

CdtTrfTxInf.ChrgBr
или
ChrgBr

DEBT - со счета плательщика
CRED - из суммы платежа
SHAR - со счета плательщика и из суммы платежа

34

O

Номер счета списания комиссии

ChrgsAcct.Id.Othr.Id

35

R

Уникальный id ВП (сквозной)

CdtTrfTxInf.PmtId.EndToEndId

36

O

Признак "Срочность принятия на исполнение перевода банком"

PmtTpInf.InstrPrty
или
CdtTrfTxInf.PmtTpInf.InstrPrty
Приоритет за п.1

37

R

Признак "Срочный перевод"

PmtTpInf.SvcLvl.Cd
или
CdtTrfTxInf.PmtTpInf.SvcLvl.Cd

URGP - срочный платеж
NURG - обычный платеж

38

O

Информация отправителя получателю

CdtTrfTxInf.RmtInf.Strd.AddtlRmtInf

Ответ

Ответом является XML-документ, соответвующий схеме pain.002.001.06.

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:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <CstmrCdtTrfInitn>
    <GrpHdr>
      <MsgId>5077018948painMSG2021090100001</MsgId>
      <CreDtTm>2021-09-01T17:08:04+03:00</CreDtTm>
      <NbOfTxs>1</NbOfTxs>
      <CtrlSum>10000</CtrlSum>
      <InitgPty>
        <Nm>"Test Alfa-Link" Limited Liability Company</Nm>
        <Id>
          <OrgId>
            <Othr>
              <Id>7013602245</Id>
              <SchmeNm>
                <Cd>TXID</Cd>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
      </InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>5077018948painMSG2021090100001</PmtInfId>
      <PmtMtd>TRF</PmtMtd>
      <PmtTpInf>
        <InstrPrty>NORM</InstrPrty>
      </PmtTpInf>
      <ReqdExctnDt>2021-09-01</ReqdExctnDt>
      <Dbtr>
        <Nm>"Test Alfa-Link" Limited Liability Company</Nm>
        <PstlAdr>
          <Ctry>RU</Ctry>
          <AdrLine>Moscow, Moscovskaya st. 1, RUSSIAN FEDERATION</AdrLine>
        </PstlAdr>
        <Id>
          <OrgId>
            <Othr>
              <Id>7013602245</Id>
              <SchmeNm>
                <Cd>TXID</Cd>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
      </Dbtr>
      <DbtrAcct>
        <Id>
          <Othr>
            <Id>40702840200000000529</Id>
          </Othr>
        </Id>
        <Ccy>USD</Ccy>
      </DbtrAcct>
      <DbtrAgt>
        <FinInstnId>
          <BICFI>ALFARUMM</BICFI>
        </FinInstnId>
      </DbtrAgt>
      <ChrgsAcct>
        <Id>
          <Othr>
            <Id>40702840200000000529</Id>
          </Othr>
        </Id>
      </ChrgsAcct>
      <CdtTrfTxInf>
        <PmtId>
          <InstrId>5077018948painMSG2021090100001</InstrId>
          <EndToEndId>01372</EndToEndId>
        </PmtId>
        <PmtTpInf>
          <SvcLvl>
            <Cd>NURG</Cd>
          </SvcLvl>
        </PmtTpInf>
        <Amt>
          <InstdAmt Ccy="USD">10000</InstdAmt>
        </Amt>
        <ChrgBr>DEBT</ChrgBr>
        <CdtrAgt>
          <FinInstnId>
            <BICFI>ALFARUMM</BICFI>
            <Nm>AO "ALFA-BANK"</Nm>
            <PstlAdr>
              <Ctry>RU</Ctry>
              <AdrLine>27, KALANCHYOVSKAYA UL. MOSCOW RUSSIAN FEDERATION</AdrLine>
            </PstlAdr>
          </FinInstnId>
        </CdtrAgt>
        <Cdtr>
          <Nm>"Test Alfa-Link Recipient" Limited Liability Company</Nm>
          <PstlAdr>
            <Ctry>RU</Ctry>
            <AdrLine>Moscow, Moscovskaya st. 1, RUSSIAN FEDERATION</AdrLine>
          </PstlAdr>
          <CtryOfRes>RU</CtryOfRes>
        </Cdtr>
        <CdtrAcct>
          <Id>
            <Othr>
              <Id>40702840600000000734</Id>
            </Othr>
          </Id>
        </CdtrAcct>
        <RmtInf>
          <Ustrd>{VO50000} Withdrawal of property from the trust management of the contract</Ustrd>
          <Strd>
            <RfrdDocInf>
              <Tp>
                <CdOrPrtry>
                  <Prtry>POD</Prtry>
                </CdOrPrtry>
              </Tp>
              <RltdDt>2021-09-01</RltdDt>
            </RfrdDocInf>
          </Strd>
        </RmtInf>
      </CdtTrfTxInf>
    </PmtInf>
    <SplmtryData>
      <Envlp>
        <SgntrSt/>
      </Envlp>
    </SplmtryData>
  </CstmrCdtTrfInitn>
</Document>
Пример Валютного Перевода с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива

8. Отзыв платежа

Обратите внимание

После успешного выполнения запроса на отзыв платежа (ответ с HTTP кодом 200) Вы можете выполнить запрос на получение статуса по конкретному платежу.

GET https://alfa-link-int.alfabank.ru/API/v1/ISO20022/Payments/Transactions/<InstrId>

где <InstrId> - идентификатор платежа.

Если платеж не удалось отозвать, то на стороне банка автоматически будет сформировано и отправлено от имени Вашей компании официальное письмо.
Шаблон письма:
Тема: Отзыв платежного документа № (Номер документа) от (Дата документа).
Текст: Прошу отозвать платежный документ № (Номер документа) от (Дата документа) на сумму (Сумма) (Валюта).
Категория: "Срочно! Отзыв платежа"

В этом случае в ответ на запрос отзыва платежа Вы получите HTTP код 201 и header Location c URL на получение статуса по пакету писем.
Подробнее в разделе 21. Запрос статуса письма.

Важно

Может возникнуть ситуация, когда ранее отправленный платеж находится в процессе выполнения проверок.
Вам вернется ответ с кодом HTTP 404.
Если идентификаторы отзываемого платежа заполнены верно - выполните запрос на получение статуса по конкретному платежу.
Если платеж перешел в статус ACSP "На обработке", выполните повторный запрос на отзыв платежа.

URI

PUT: /API/v1/ISO20022/Payments/Recall

XML схема

pacs.004.001.11

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

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

1

R

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

Document.PmtRtr.GrpHdr.MsgId

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

2

R

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

Document.PmtRtr.GrpHdr.CreDtTm

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

3

R

Количество отзываемых платежей

Document.PmtRtr.GrpHdr.NbOfTxs

Константа "1"

4

R

Метод

Document.PmtRtr.GrpHdr.SttlmInf.SttlmMtd

Константа "INDA"

5

R

Название организации

Document.PmtRtr.GrpHdr.SttlmInf.InstgRmbrsmntAgt.FinInstnId.Nm

6

R

Номер счета

Document.PmtRtr.GrpHdr.SttlmInf.InstgRmbrsmntAgt.FinInstnId.Othr.Id

7

R

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

Document.PmtRtr.GrpHdr.SttlmInf.InstgRmbrsmntAgt.FinInstnId.Othr.SchmeNm.Cd

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

8

R

ИНН

Document.PmtRtr.GrpHdr.SttlmInf.InstdRmbrsmntAgt.FinInstnId.Othr.Id

9

R

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

Document.PmtRtr.GrpHdr.SttlmInf.InstdRmbrsmntAgt.FinInstnId.Othr.SchmeNm.Сd

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

10

R

Уникальный id запроса на отзыв

Document.PmtRtr.TxInf.RtrId

11

R

Id исходного сообщения платежа

Document.PmtRtr.TxInf.OrgnlGrpInf.OrgnlMsgId

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

12

R

Тип исходного сообщения

Document.PmtRtr.TxInf.OrgnlGrpInf.OrgnlMsgNmId

Константа "pain.001.001.06"

13

R

Id исходного пакета платежа

Document.PmtRtr.TxInf.OrgnlInstrId

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

14

R

Id исходного платежа

Document.PmtRtr.TxInf.OrgnlTxId

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

15

R

Сумма отзываемого платежа

Document.PmtRtr.TxInf.RtrdIntrBkSttlmAmt

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

16

R

Код валюты отзываемого платежа

Document.PmtRtr.TxInf.RtrdIntrBkSttlmAmt@Ccy

17

R

Подпись

Document.PmtRtr.TxInf.SplmtryData.Envlp.SgntrSt[1..n]

Ответ

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

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

Document.CstmrPmtStsRpt.GrpHdr

1

R

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

MsgId

2

R

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

CreDtTm

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

3

R

SWIFT Альфа-Банка

InitgPty.Id.OrgId.AnyBIC

константа
"ALFARUMM"

4

R

БИК Альфа-Банка

InitgPty.Id.OrgId.Othr.Id

константа
"044525593"

Document.CstmrPmtStsRpt.OrgnlGrpInfAndSts

5

R

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

OrgnlMsgId

pacs.004.001.11
Document/CcyCtrlReqOrLttr/GrpHdr/MsgId

6

R

Тип исходного сообщения

OrgnlMsgNmId

константа
"pacs.004.001.11"

7

R

Дата и время формирования исходного сообщения

OrgnlCreDtTm

pacs.004.001.11
Document/CcyCtrlReqOrLttr/GrpHdr/CreDtTm

8

R

Статус исходного сообщения

GrpSts

ACSC - Запрос выполнен;
RJCT - Запрос не выполнен.

9

R

Код причины присвоения статуса сообщения

StsRsnInf.Rsn.Cd

NARR - Описание в поле AddtlInf.

10

R

Описание причины присвоения статуса сообщения

StsRsnInf.AddtlInf

Таблица с описанием причины присвоения статусов ACSC и RJCT

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts

11

O

Идентификатор пакета отзываемого платежа

OrgnlPmtInfId

pacs.004.001.11 Document.PmtRtr.TxInf.OrgnlInstrId

12

O

Статус пакета отзываемого платежа

PmtInfSts

ACSC - Запрос выполнен;
RJCT - Запрос не выполнен.

13

O

Идентификатор отзываемого платежа

TxInfAndSts.OrgnlInstrId

pacs.004.001.11
Document.PmtRtr.TxInf.OrgnlInstrId

15

O

Статус отзываемого платежа

TxInfAndSts.TxSts

ACSC - Запрос выполнен;
RJCT - Запрос не выполнен.

16

O

Код причины присвоения статуса

TxInfAndSts.StsRsnInf.Rsn.Cd

NARR - Описание в поле AddtlInf.

19

O

Описание кода причины присвоения статуса

TxInfAndSts.StsRsnInf.AddtlInf

Таблица с описанием причины присвоения статусов ACSC и RJCT

20

O

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

TxInfAndSts.AccptncDtTm

Если платеж был ранее исполнен, то будет передана дата исполнения платежа.
В других случаях, будет передана дата запроса на отзыв.

Таблица с описанием причины присвоения статусов ACSC и RJCT

Статусы HTTP код Описание причины присвоения статуса

ACSC

200

Запрос на отзыв платежа выполнен: платеж отозван

ACSC

201

Запрос на отзыв платежа выполнен: идентификатор официального письма в банк указан в header Location

RJCT

208

Запрос на отзыв платежа не выполнен: платёж ранее был отклонён

RJCT

404

Платёж не найден! Проверьте идентификатор(ы) отзываемого платежа

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

200

OK

Запрос на отзыв платежа выполнен: платёж отозван

Платеж отозван автоматически

201

Created

Запрос на отзыв платежа выполнен: идентификатор официального письма в банк указан в header Location

Для отзыва платежа было отправлено письмо. В header Location сформирован URL

208

Already Reported

Запрос на отзыв платежа не выполнен: платёж ранее был отклонён

Платёж ранее был отклонён

404

Not Found

Платёж не найден! Проверьте идентификатор(ы) отзываемого платежа

Платеж по вашим данным не найден. Проверьте идентификатор(ы) исходного сообщения.

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

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

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

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

400

Err

XML does not match schema

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

Пример запроса на отзыв платежа
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pacs.004.001.11">
  <PmtRtr>
    <GrpHdr>
        <MsgId>db810eeabf0b43a890f3b9943f2ce7bf</MsgId>
        <CreDtTm>2022-07-11T10:12:12</CreDtTm>
        <NbOfTxs>1</NbOfTxs>
        <SttlmInf>
            <SttlmMtd>INDA</SttlmMtd>
            <InstgRmbrsmntAgt>
                <FinInstnId>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <Othr>
                        <Id>40702810200000000083</Id>
                        <SchmeNm>
                            <Cd>ACC</Cd>
                        </SchmeNm>
                    </Othr>
                </FinInstnId>
            </InstgRmbrsmntAgt>
            <InstdRmbrsmntAgt>
                <FinInstnId>
                    <Othr>
                        <Id>7013602245</Id>
                        <SchmeNm>
                            <Cd>TXID</Cd>
                        </SchmeNm>
                    </Othr>
                </FinInstnId>
            </InstdRmbrsmntAgt>
        </SttlmInf>
    </GrpHdr>
    <TxInf>
        <RtrId>TEST_ID_2022-07-13-150752711</RtrId>
        <OrgnlGrpInf>
            <OrgnlMsgId>TEST_MSG_2022-07-13-938247209</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
        </OrgnlGrpInf>
        <OrgnlInstrId>TEST_PCT_2022-07-13-938247209</OrgnlInstrId>
        <OrgnlTxId>TEST_PMT_2022-07-13-938247209</OrgnlTxId>
        <RtrdIntrBkSttlmAmt Ccy="RUR">100</RtrdIntrBkSttlmAmt>
    </TxInf>
    <SplmtryData>
      <Envlp>
        <SgntrSt>
        </SgntrSt>
      </Envlp>
    </SplmtryData>
  </PmtRtr>
</Document>
Пример ответа при автоматическом отзыве платежа
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.06">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>660de3219004491397a5904ea486fd0e</MsgId>
            <CreDtTm>2022-08-10T11:36:11.977+03:00</CreDtTm>
            <InitgPty>
                <Id>
                    <OrgId>
                        <AnyBIC>ALFARUMM</AnyBIC>
                        <Othr>
                            <Id>044525593</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>TEST_MSG_2022-08-10-476153300</OrgnlMsgId>
            <OrgnlMsgNmId>pacs.004.001.11</OrgnlMsgNmId>
            <OrgnlCreDtTm>2022-08-10T11:36:11.882+03:00</OrgnlCreDtTm>
            <GrpSts>ACSC</GrpSts>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>TEST_PCT_2022-08-10-564604871</OrgnlPmtInfId>
            <PmtInfSts>ACSC</PmtInfSts>
            <TxInfAndSts>
                <OrgnlInstrId>TEST_PMT_2022-08-10-564604871</OrgnlInstrId>
                <TxSts>ACSC</TxSts>
                <StsRsnInf>
                    <Rsn>
                        <Cd>NARR</Cd>
                    </Rsn>
                    <AddtlInf>Запрос на отзыв платежа выполнен: платёж отозван</AddtlInf>
                </StsRsnInf>
                <AccptncDtTm>2022-08-10T11:36:11.907+03:00</AccptncDtTm>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>
Пример ответа при отзыве платежа письмом
Headers
    ...
    Location = /API/v1/ISO20022/Letters/TEST_MSG_2022-07-21-170531660636652
    ...
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.06">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>7c1af40c934b4cad809a645ded03d081</MsgId>
            <CreDtTm>2022-08-10T11:33:41.112+03:00</CreDtTm>
            <InitgPty>
                <Id>
                    <OrgId>
                        <AnyBIC>ALFARUMM</AnyBIC>
                        <Othr>
                            <Id>044525593</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>TEST_MSG_2022-08-10-476153318</OrgnlMsgId>
            <OrgnlMsgNmId>pacs.004.001.11</OrgnlMsgNmId>
            <OrgnlCreDtTm>2022-08-10T11:33:40.629+03:00</OrgnlCreDtTm>
            <GrpSts>ACSC</GrpSts>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>TEST_PCT_2022-08-10-999494950</OrgnlPmtInfId>
            <PmtInfSts>ACSC</PmtInfSts>
            <TxInfAndSts>
                <OrgnlInstrId>TEST_PMT_2022-08-10-999494950</OrgnlInstrId>
                <TxSts>ACSC</TxSts>
                <StsRsnInf>
                    <Rsn>
                        <Cd>NARR</Cd>
                    </Rsn>
                    <AddtlInf>Запрос на отзыв платежа выполнен: идентификатор официального письма в банк указан в header Location</AddtlInf>
                </StsRsnInf>
                <AccptncDtTm>2022-08-10T11:32:50.476+03:00</AccptncDtTm>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>
Пример ответа, когда платеж не найден
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.06">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>56a130f1bedd4bd38be5b9b7dedcb24d</MsgId>
            <CreDtTm>2022-08-09T09:55:54.524+03:00</CreDtTm>
            <InitgPty>
                <Id>
                    <OrgId>
                        <AnyBIC>ALFARUMM</AnyBIC>
                        <Othr>
                            <Id>044525593</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>time_id:1660028154520</OrgnlMsgId>
            <OrgnlMsgNmId>pacs.004.001.11</OrgnlMsgNmId>
            <OrgnlCreDtTm>2022-08-09T09:55:54.520+03:00</OrgnlCreDtTm>
            <GrpSts>RJCT</GrpSts>
            <StsRsnInf>
                <Rsn>
                    <Cd>NARR</Cd>
                </Rsn>
                <AddtlInf>Платёж не найден! Проверьте идентификатор(ы) отзываемого платежа</AddtlInf>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
    </CstmrPmtStsRpt>
</Document>

9. Поручение на конвертацию валют

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

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

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

URI

POST: /API/v1/ISO20022/ForeignExchanges

XSD схема

pain.001.001.06

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

Документ является конвертацией, если счет списания Document.CstmrCdtTrfInitn.PmtInf.DbtrAcct.Id.Othr.Id является валютным, счет зачисления Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAcct.Id.Othr.Id также является валютным.

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

1

R

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

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

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

2

R

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

Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm

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

3

R

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

Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs

Общее число поручений (секций CdtTrfTxInf) в сообщении

Общий путь Document.CstmrCdtTrfInitn.PmtInf - Уровень пакета документов

4

R

Уникальный id пакета поручений на конвертацию

PmtInfId

Указывается идентифкатор группы поручений

5

R

Уникальный id поручения

CdtTrfTxInf.PmtId.InstrId

Идентифкатор исходного поручения

6

R

Метод оплаты

PmtMtd

Значение "TRF" по умолчанию

7

R

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

PmtTpInf.LclInstrm.Prtry

Константа "RU-FX"

8

R

Наименование организации

Dbtr.Nm

9

R

Расчетный счет в иностранной валюте в продаваемой валюте

DbtrAcct.Id.Othr.Id

10

R

Валюта суммы выдачи(Код продаваемой валюты)

DbtrAcct.Ccy

11

R

Вид счета

DbtrAcct.Id.Other.SchmeNm.Cd

Константа 'BBAN'

12

O

Счет списания комиссии

ChrgsAcct.Id.Othr.Id

Обязателен для заполнения, когда параметр "Тип курса" отличен от "SPOT"

13

R

Срок действия поручения до

ReqdExctnDt

Формат даты YYYY-MM-DD

14

O

Адрес

Dbtr.PstlAdr.AdrLine

15

O

Контактный телефон

Dbtr.CtctDtls.PhneNb

16

O

ФИО сотрудника, уполномоченного на решение вопросов по сделке

Dbtr.CtctDtls.Nm

Общий путь Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf - Уровень поручения

17

R

Уникальный id поручения

PmtId.InstrId

Указывается идентифкатор поручения

18

R

Номер поручения

PmtId.EndToEndId

19

R

Тип поручения

PmtTpInf.LclInstrm.Prtry

Константа "RU-FX"

20

R

Расчетный счет в иностранной валюте в покупаемой валюте

CdtrAcct.Id.Othr.Id

21

R

Код валюты покупки

CdtrAcct.Ccy

22

R

Сумма покупки валюты

Amt.InstdAmt

Для этого необходимо указать CCY = CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAcct.Ccy <InstdAmt Ccy="USD">150</InstdAmt>

23

R

Сумма продажи валюты

Amt.InstdAmt

Для этого необходимо указать CCY = CstmrCdtTrfInitn.PmtInf.DbtrAcct.Ccy <InstdAmt Ccy="EUR">150</InstdAmt>

24

O

По курсу не выше

XchgRateInf.XchgRate

25

R

Тип курса

XchgRateInf.RateTp ИЛИ PmtInf.CdtTrfTxInf.SplmtryData.Envlp.RateTp2

SPOT - "по курсу Банка" (Не требуется указывать счет комиссии)
AGRD - "по курсу Дилера ТОМ" (Требуется указать счет комиссии)
SALE - "по текущему курсу АЛЬФА-ФОРЕКС TOD" (Требуется указать счет комиссии)
DTOD - "по курсу дилера TOD" (Требуется указать счет комисии. Значение типа курса указывается в параметре RateTp2)
TMRW - "по курсу банка России на завтра" (Требуется указать счет комисии. Значение типа курса указывается в параметре RateTp2)
Примеры приведены в конце таблицы

26

R

Удерживать комиссию

Document.CstmrCdtTrfInitn.PmtInf.ChrgBr или Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.ChrgBr

CRED - иное
DEBT -с расчетного счета в валюте РФ
SHAR - иное.
Если указаны PmtInf.ChrgBr и CdtTrfTxInf.ChrgBr, используется из PmtInf/ChrgBr

27

R

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

RmtInf.Strd.RfrdDocInf.RltdDt

Формат даты YYYY-MM-DD

28

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

29

О

Специальный раздел номинального счета списания

SplmtryData.Envlp.SpecSecCancel

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

30

О

Специальный раздел номинального счета зачисления

SplmtryData.Envlp.SpecSecIncm

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

31

О

Направление курса

SplmtryData.Envlp.RateDrct

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

1 - прямой,
0 - обратный

33

R

Сумма покупки валюты ИЛИ Сумма продажи валюты

SplmtryData.Envlp.InstdAmt2

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

* Если код валюты (CCY) в InstdAmt = CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAcct.Ccy, то записать InstdAmt2 в «Сумма покупки валюты» * Если код валюты (CCY) в InstdAmt = CstmrCdtTrfInitn.PmtInf.DbtrAcct.Ccy, то записать InstdAmt2 в «Сумма продажи валюты»

Примеры с разными типами курса.

SPOT ("по курсу Банка")

продаем 10 евро, чтобы получить Х долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-20-164353520</MsgId>
            <CreDtTm>2020-05-20T16:43:53.520+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-20-164353520</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-20</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702978200000000064</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>EUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-20-164353520</InstrId>
                    <EndToEndId>164353</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="EUR">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SPOT</RateTp>
                </XchgRateInf>
                <ChrgBr>SHAR</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем 10 евро, чтобы получить Х долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-20</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
продаем Х евро, чтобы получить 10 долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-20-164353520</MsgId>
            <CreDtTm>2020-05-20T16:43:53.520+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-20-164353520</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-20</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702978200000000064</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>EUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-20-164353520</InstrId>
                    <EndToEndId>164353</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="USD">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SPOT</RateTp>
                </XchgRateInf>
                <ChrgBr>SHAR</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем X евро, чтобы получить 10 долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-20</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

SALE ("по текущему курсу АЛЬФА-ФОРЕКС TOD")

продаем 10 евро, чтобы получить Х долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702978200000000064</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>EUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="EUR">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SALE</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем 10 евро, чтобы получить Х долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
продаем Х евро, чтобы получить 10 долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702978200000000064</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>EUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="USD">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SALE</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем Х евро, чтобы получить 10 долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

Тип курса AGRD ("по курсу Дилера ТОМ")

продаем 10 евро, чтобы получить Х долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702978200000000064</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>EUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="EUR">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>AGRD</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем 10 евро, чтобы получить Х долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
продаем Х евро, чтобы получить 10 долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702978200000000064</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>EUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="USD">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>AGRD</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем Х евро, чтобы получить 10 долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

Ответ

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

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

Путь Document.CstmrPmtStsRpt.GrpHdr

1

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

MsgId

2

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

CreDtTm

3

SWIFT-код банка

InitgPty.Id.OrgId.AnyBIC

константа ALFARUMM

4

Российский БИК банка

InitgPty.Id.OrgId.Othr.Id

константа 044525593

5

Код типа идентификатора

InitgPty.Id.OrgId.Othr.SchmeNm.Cd

константа RUCBC

Путь Document.CstmrPmtStsRpt.OrgnlGrpInfAndSts

6

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

OrgnlMsgId

7

Тип исходного сообщения

OrgnlMsgNmId

8

Дата создания исходного сообщения

OrgnlCreDtTm

9

Число поручений в исходном сообщении

OrgnlNbOfTxs

10

Статус исходного сообщения

GrpSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- PART Принято, подтверждена часть поручений

11

Код причины присвоения статуса

StsRsnInf.Rsn.Cd

- DS08 - Ошибка распаковки

- DS09 - Ошибка расшифровки

- TD03 - Некорректная структура файла

- NARR - Описание в поле AddtlInf

12

Описание причины присвоения статуса

StsRsnInf.AddtlInf

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts
Если был запрос сообщения (http get message), то количество секций OrgnlPmtInfAndSts равно количеству пакетов в этом сообщении.
Если был запрос статуса поручения (http get order), то секция OrgnlPmtInfAndSts одна.

13

Идентификатор пакета конверсионных операций

OrgnlPmtInfId

14

Статус пакета поручений

PmtInfSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- PART Принято, подтверждена часть поручений

- ACSC Исполнен

15

Код причины присвоения статуса

StsRsnInf.Rsn.Cd

16

Описание причины присвоения статуса

StsRsnInf.AddtlInf

17

Идентификатор конверсионной операции

OrgnlPmtInfId.TxInfAndSts.OrgnlInstrId

18

Статус поручения

OrgnlPmtInfId.TxInfAndSts.TxSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- ACSC Исполнен

19

Код причины присвоения статуса в случае ошибки

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.Rsn

20

Описание ошибки обработки ПК (технических и бизнес- ошибок)

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.AddtlInf

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

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

10. Поручение на покупку валюты

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

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

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

URI

POST: /API/v1/ISO20022/ForeignExchanges

XSD схема

pain.001.001.06

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

Документ является покупкой, если счет списания Document.CstmrCdtTrfInitn.PmtInf.DbtrAcct.Id.Othr.Id является рублевым, а счет зачисления Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAcct.Id.Othr.Id является валютным.

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

1

R

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

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

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

2

R

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

Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm

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

3

R

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

Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs

Общее число поручений (секций CdtTrfTxInf) в сообщении

Общий путь Document.CstmrCdtTrfInitn.PmtInf - Уровень пакета документов

4

R

Уникальный id пакета поручений на покупку валюты

PmtInfId

Указывается идентифкатор группы поручений

5

R

Уникальный id поручения

CdtTrfTxInf.PmtId.InstrId

Идентифкатор исходного поручения

6

R

Метод оплаты

PmtMtd

Значение "TRF" по умолчанию

7

R

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

PmtTpInf.LclInstrm.Prtry

Константа "RU-FX"

8

R

ИНН

Dbtr.Id.OrgId.Othr.Id

9

R

Наименование организации

Dbtr.Nm

Не более 140 символов

10

R

Р/с в валюте РФ для списания

DbtrAcct.Id.Othr.Id

11

R

Вид счета

DbtrAcct.Id.Other.SchmeNm.Cd

Константа 'BBAN'

12

O

Счет списания комисии

ChrgsAcct.Id.Othr.Id

Обязателен для заполнения, когда параметр "Тип курса" отличен от "SPOT"

13

R

Срок действия поручения до

ReqdExctnDt

Формат даты YYYY-MM-DD

14

O

Контактный телефон

Dbtr.CtctDtls.PhneNb

15

O

ФИО сотрудника, уполномоченного на решение вопросов по сделке

Dbtr.CtctDtls.Nm

16

O

Почтовый адрес

Dbtr.PstlAdr.AdrLine

Общий путь Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf - Уровень поручения

17

R

Уникальный id поручения

PmtId.InstrId

Указывается идентифкатор поручения

18

R

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

PmtId.EndToEndId

19

R

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

PmtTpInf.LclInstrm.Prtry

Константа "RU-FX"

20

O

КПП

Tax.Dbtr.TaxTp

21

R

Р/с в ин.валюте для зачисления

CdtrAcct.Id.Othr.Id

22

R

Код валюты

CdtrAcct.Ccy

23

R

Удерживать комиссию

Document.CstmrCdtTrfInitn.PmtInf.ChrgBr или Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.ChrgBr

CRED - иное
DEBT -с расчетного счета в валюте РФ
SHAR - иное
Если указаны PmtInf.ChrgBr и CdtTrfTxInf.ChrgBr, используется из PmtInf.ChrgBr

24

R

Сумма покупки валюты

Amt.InstdAmt

Если требуется задать сумму покупаемой валюты, то поле CCY необходимо заполнить кодом покупаемой валюты, например:
<InstdAmt Ccy="USD">150</InstdAmt>

25

R

Сумма предварительно депонированных средств в валюте РФ

Amt.InstdAmt

Если неизвестно, сколько валюты требуется приобрести, но известно, сколько рублей требуется обменять, то поле CCY требуется задать кодом продаваемой валюты, например:
<InstdAmt Ccy="RUB">150</InstdAmt>

26

O

По курсу не выше

XchgRateInf.XchgRate

27

O

Реквизиты банка, в котором открыт р/с в ин.валюте

CdtrAgt.FinInstnId.Nm

28

R

Тип курса

XchgRateInf.RateTp ИЛИ PmtInf.CdtTrfTxInf.SplmtryData.Envlp.RateTp2

SPOT - "по курсу Банка" (Не требуется указывать счет комиссии)
AGRD - "по курсу Дилера ТОМ" (Требуется указать счет комиссии)
SALE - "по текущему курсу АЛЬФА-ФОРЕКС TOD" (Требуется указать счет комиссии)
DTOD - "по курсу дилера TOD" (Требуется указать счет комисии. Значение типа курса указывается в параметре RateTp2)
TMRW - "по курсу банка России на завтра" (Требуется указать счет комисии. Значение типа курса указывается в параметре RateTp2)
Примеры приведены в конце таблицы

29

R

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

RmtInf.Strd.RfrdDocInf.RltdDt

Формат даты YYYY-MM-DD

30

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

31

О

Специальный раздел номинального счета списания

SplmtryData.Envlp.SpecSecCancel

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

32

О

Специальный раздел номинального счета зачисления

SplmtryData.Envlp.SpecSecIncm

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

33

О

Направление курса

SplmtryData.Envlp.RateDrct

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

1 - прямой,
0 - обратный

34

R

Сумма предварительно депонированных средств в валюте РФ ИЛИ Сумма покупки валюты

SplmtryData.Envlp.InstdAmt2

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

* Если код валюты (CCY) в InstdAmt <> RUB или RUR, то записать InstdAmt2 в «Сумма предварительно депонированных средств в валюте РФ»
* Если код валюты (CCY) в InstdAmt = RUB или RUR, то записать InstdAmt2 в «Сумма покупки валюты»

Примеры с разными типами курса.

SPOT ("по курсу Банка")

за Х рублей покупаем 10 долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-20-160003717</MsgId>
            <CreDtTm>2020-05-20T16:00:03.717</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-20-160003717</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-20</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-20-160003717</InstrId>
                    <EndToEndId>160003</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="USD">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SPOT</RateTp>
                </XchgRateInf>
                <ChrgBr>SHAR</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>за X рублей покупаем 10 долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-20</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
за 100 рублей покупаем Х долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-20-160003717</MsgId>
            <CreDtTm>2020-05-20T16:00:03.717+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-20-160003717</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-20</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-20-160003717</InstrId>
                    <EndToEndId>160003</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">100.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SPOT</RateTp>
                </XchgRateInf>
                <ChrgBr>SHAR</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>за 100 рублей покупаем Х долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-20</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

SALE ("по текущему курсу АЛЬФА-ФОРЕКС TOD")

за Х рублей покупаем 10 долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="USD">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SALE</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>за Х рублей покупаем 10 долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
за 100 рублей покупаем Х долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">100.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SALE</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>за 100 рублей покупаем Х долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

Тип курса AGRD ("по курсу Дилера ТОМ")

за Х рублей покупаем 10 долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="USD">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>AGRD</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>за Х рублей покупаем 10 долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
за 100 рублей покупаем Х долларов
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">100.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>AGRD</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>USD</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>за 100 рублей покупаем Х долларов</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

Ответ

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

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

Путь Document.CstmrPmtStsRpt.GrpHdr

1

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

MsgId

2

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

CreDtTm

3

SWIFT-код банка

InitgPty.Id.OrgId.AnyBIC

константа ALFARUMM

4

Российский БИК банка

InitgPty.Id.OrgId.Othr.Id

константа 044525593

5

Код типа идентификатора

InitgPty.Id.OrgId.Othr.SchmeNm.Cd

константа RUCBC

Путь Document.CstmrPmtStsRpt.OrgnlGrpInfAndSts

6

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

OrgnlMsgId

7

Тип исходного сообщения

OrgnlMsgNmId

8

Дата создания исходного сообщения

OrgnlCreDtTm

9

Число поручений в исходном сообщении

OrgnlNbOfTxs

10

Статус исходного сообщения

GrpSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- PART Принято, подтверждена часть поручений

11

Код причины присвоения статуса

StsRsnInf.Rsn.Cd

- DS08 - Ошибка распаковки

- DS09 - Ошибка расшифровки

- TD03 - Некорректная структура файла

- NARR - Описание в поле AddtlInf

12

Описание причины присвоения статуса

StsRsnInf.AddtlInf

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts
Если был запрос сообщения (http get message), то количество секций OrgnlPmtInfAndSts равно количеству пакетов в этом сообщении.
Если был запрос статуса поручения (http get order), то секция OrgnlPmtInfAndSts одна.

13

Идентификатор пакета конверсионных операций

OrgnlPmtInfId

14

Статус пакета поручений

PmtInfSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- PART Принято, подтверждена часть поручений

- ACSC Исполнен

15

Код причины присвоения статуса

StsRsnInf.Rsn.Cd

16

Описание причины присвоения статуса

StsRsnInf.AddtlInf

17

Идентификатор конверсионной операции

OrgnlPmtInfId.TxInfAndSts.OrgnlInstrId

18

Статус поручения

OrgnlPmtInfId.TxInfAndSts.TxSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- ACSC Исполнен

19

Код причины присвоения статуса в случае ошибки

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.Rsn

20

Описание ошибки обработки ПК (технических и бизнес- ошибок)

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.AddtlInf

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

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

11. Поручение на продажу валюты

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

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

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

URI

POST: /API/v1/ISO20022/ForeignExchanges

XSD схема

pain.001.001.06

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

Документ является продажей валюты, если счет списания Document.CstmrCdtTrfInitn.PmtInf.DbtrAcct.Id.Othr.Id является валютным, а счет зачисления Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAcct.Id.Othr.Id является рублевым.

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

1

R

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

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

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

2

R

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

Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm

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

3

R

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

Document.CstmrCdtTrfInitn.GrpHdr.NbOfTxs

Общее число поручений (секций CdtTrfTxInf) в сообщении

Общий путь Document.CstmrCdtTrfInitn.PmtInf - Уровень пакета документов

4

R

Уникальный id пакета поручений на покупку валюты

PmtInfId

Указывается идентифкатор группы поручений

5

R

Уникальный id поручения

CdtTrfTxInf.PmtId.InstrId

Идентифкатор исходного поручения

6

R

Метод оплаты

PmtMtd

Значение "TRF" по умолчанию

7

R

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

PmtTpInf.LclInstrm.Prtry

Константа "RU-FX"

8

R

Наименование организации

Dbtr.Nm

Не более 140 символов

9

R

Расчетный счет в ин. валюте для списания

DbtrAcct.Id.Othr.Id

10

R

Вид счета

DbtrAcct.Id.Other.SchmeNm.Cd

Константа 'BBAN'

11

O

Счет списания комиссии

ChrgsAcct.Id.Othr.Id

Обязателен для заполнения, когда параметр "Тип курса" отличен от "SPOT"

12

R

Срок действия поручения до

ReqdExctnDt

Формат даты YYYY-MM-DD

13

O

Контактный телефон

Dbtr.CtctDtls.PhneNb

14

O

ФИО сотрудника, уполномоченного на решение вопросов по сделке

Dbtr.CtctDtls.Nm

15

O

Почтовый адрес

Dbtr.PstlAdr.AdrLine

Общий путь Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf - Уровень поручения

16

R

Уникальный id поручения

PmtId.InstrId

Указывается идентифкатор поручения

17

R

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

PmtId.EndToEndId

18

R

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

PmtTpInf.LclInstrm.Prtry

Константа "RU-FX"

19

R

Расчетный счет в валюте РФ для зачисления

CdtrAcct.Id.Othr.Id

20

R

Код валюты

Document.CstmrCdtTrfInitn.PmtInf.DbtrAcct.Ccy

21

R

Удерживать комиссию

Document.CstmrCdtTrfInitn.PmtInf.ChrgBr или Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.ChrgBr

CRED - иное
DEBT -с расчетного счета в валюте РФ
SHAR - Из суммы рублевых средств.
Если указаны PmtInf.ChrgBr и CdtTrfTxInf.ChrgBr, используется из PmtInf.ChrgBr

22

R

Сумма продажи валюты

Amt.InstdAmt

Если требуется задать сумму продаваемой валюты, то поле CCY необходимо заполнить кодом продаваемой валюты, например:
<InstdAmt Ccy="USD">150</InstdAmt>

23

R

Сумма в валюте РФ по курсу сделки

Amt.InstdAmt

Если неизвестно, сколько валюты требуется продать, но известно, сколько рублей требуется купить, то поле CCY требуется задать кодом покупаемой валюты, например:
<InstdAmt Ccy="RUB">150</InstdAmt>

24

O

По курсу не выше

XchgRateInf.XchgRate

25

O

Реквизиты банка, в котором открыт р/с в ин.валюте

CdtrAgt.FinInstnId.Nm

26

R

Тип курса

XchgRateInf.RateTp ИЛИ PmtInf.CdtTrfTxInf.SplmtryData.Envlp.RateTp2

SPOT - "по курсу Банка" (Не требуется указывать счет комиссии)
AGRD - "по курсу Дилера ТОМ" (Требуется указать счет комиссии)
SALE - "по текущему курсу АЛЬФА-ФОРЕКС TOD" (Требуется указать счет комиссии)
DTOD - "по курсу дилера TOD" (Требуется указать счет комисии. Значение типа кусра указывается в параметре RateTp2)
TMRW - "по курсу банка России на завтра" (Требуется указать счет комисии. Значение типа курса указывается в параметре RateTp2)
Примеры приведены в конце таблицы

27

R

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

RmtInf.Strd.RfrdDocInf.RltdDt

Формат даты YYYY-MM-DD

28

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

29

О

Специальный раздел номинального счета списания

SplmtryData.Envlp.SpecSecCancel

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

30

О

Специальный раздел номинального счета зачисления

SplmtryData.Envlp.SpecSecIncm

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

31

О

Направление курса

SplmtryData.Envlp.RateDrct

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

1 - прямой,
0 - обратный

32

О

Сумма продажи ИЛИ Сумма в валюте РФ по курсу сделки

SplmtryData.Envlp.InstdAmt2

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

* Если код валюты (CCY) в InstdAmt <> RUB или RUR, то записать InstdAmt2 в «Сумма в валюте РФ по курсу сделки»
* Если код валюты (CCY) в InstdAmt = RUB или RUR, то записать InstdAmt2 в «Сумма продажи валюты»

Примеры с разными типами курса.

SPOT ("по курсу Банка")

продаем Х долларов, чтобы получить 100 рублей
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-20-163719981</MsgId>
            <CreDtTm>2020-05-20T16:37:19.981+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-20-163719981</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-20</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702840200000000529</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>USD</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-20-163719981</InstrId>
                    <EndToEndId>163719</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">100.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SPOT</RateTp>
                </XchgRateInf>
                <ChrgBr>SHAR</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702810200000000083</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>RUR</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем Х долларов, чтобы получить 100 рублей</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-20</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
продаем 10 долларов, чтобы получить Х рублей
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-20-163719981</MsgId>
            <CreDtTm>2020-05-20T16:37:19.981+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-20-163719981</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-20</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702840200000000529</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>USD</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-20-163719981</InstrId>
                    <EndToEndId>163719</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="USD">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SPOT</RateTp>
                </XchgRateInf>
                <ChrgBr>SHAR</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702810200000000083</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>RUR</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем 10 долларов, чтобы получить X рублей</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-20</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

SALE ("по текущему курсу АЛЬФА-ФОРЕКС TOD")

продаем Х долларов, чтобы получить 100 рублей
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702840200000000529</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>USD</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">100.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SALE</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702810200000000083</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>RUR</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем Х долларов, чтобы получить 100 рублей</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
продаем 10 долларов, чтобы получить Х рублей
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702840200000000529</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>USD</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="USD">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>SALE</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702810200000000083</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>RUR</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем 10 долларов, чтобы получить Х рублей</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

Тип курса AGRD ("по курсу Дилера ТОМ")

продаем Х долларов, чтобы получить 100 рублей
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702840200000000529</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>USD</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">100.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>AGRD</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702810200000000083</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>RUR</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем Х долларов, чтобы получить 100 рублей</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>
продаем 10 долларов, чтобы получить Х рублей
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>TEST_MSG_2020-05-21-095818751</MsgId>
            <CreDtTm>2020-05-21T09:58:18.751+03:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>TEST_PCT_2020-05-21-095818751</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2020-05-21</ReqdExctnDt>
            <Dbtr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <Id>40702840200000000529</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>USD</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
			<ChrgsAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
			</ChrgsAcct>
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>TEST_ID_2020-05-21-095818751</InstrId>
                    <EndToEndId>095818</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <Cd>NURG</Cd>
                    </SvcLvl>
                    <LclInstrm>
                        <Prtry>RU-FX</Prtry>
                    </LclInstrm>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="USD">10.00</InstdAmt>
                </Amt>
                <XchgRateInf>
                    <RateTp>AGRD</RateTp>
                </XchgRateInf>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>044525593</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "АЛЬФА-БАНК"</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <Id>40702810200000000083</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                    <Ccy>RUR</Ccy>
                </CdtrAcct>
                <RmtInf>
                    <Ustrd>продаем 10 долларов, чтобы получить Х рублей</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <RltdDt>2020-05-21</RltdDt>
                        </RfrdDocInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

Ответ

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

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

Путь Document.CstmrPmtStsRpt.GrpHdr

1

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

MsgId

2

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

CreDtTm

3

SWIFT-код банка

InitgPty.Id.OrgId.AnyBIC

константа ALFARUMM

4

Российский БИК банка

InitgPty.Id.OrgId.Othr.Id

константа 044525593

5

Код типа идентификатора

InitgPty.Id.OrgId.Othr.SchmeNm.Cd

константа RUCBC

Путь Document.CstmrPmtStsRpt.OrgnlGrpInfAndSts

6

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

OrgnlMsgId

7

Тип исходного сообщения

OrgnlMsgNmId

8

Дата создания исходного сообщения

OrgnlCreDtTm

9

Число поручений в исходном сообщении

OrgnlNbOfTxs

10

Статус исходного сообщения

GrpSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- PART Принято, подтверждена часть поручений

11

Код причины присвоения статуса

StsRsnInf.Rsn.Cd

- DS08 - Ошибка распаковки

- DS09 - Ошибка расшифровки

- TD03 - Некорректная структура файла

- NARR - Описание в поле AddtlInf

12

Описание причины присвоения статуса

StsRsnInf.AddtlInf

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts
Если был запрос сообщения (http get message), то количество секций OrgnlPmtInfAndSts равно количеству пакетов в этом сообщении.
Если был запрос статуса поручения (http get order), то секция OrgnlPmtInfAndSts одна.

13

Идентификатор пакета конверсионных операций

OrgnlPmtInfId

14

Статус пакета поручений

PmtInfSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- PART Принято, подтверждена часть поручений

- ACSC Исполнен

15

Код причины присвоения статуса

StsRsnInf.Rsn.Cd

16

Описание причины присвоения статуса

StsRsnInf.AddtlInf

17

Идентификатор конверсионной операции

OrgnlPmtInfId.TxInfAndSts.OrgnlInstrId

18

Статус поручения

OrgnlPmtInfId.TxInfAndSts.TxSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- ACSC Исполнен

19

Код причины присвоения статуса в случае ошибки

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.Rsn

20

Описание ошибки обработки ПК (технических и бизнес- ошибок)

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.AddtlInf

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

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

12. Постановка на учет внешнеторгового контракта (УНК)

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

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

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

URI

POST: /API/v1/ISO20022/Contracts

XSD схема

auth.018.001.01

Алгоритм определения продавца и покупателя

Особенностью схемы auth.018 является возможность заполнения данных по контрагенту (с кем заключается контракт) в разделе Buyr или Sellr на усмотрение пользователя.

  1. ИНН резидента (CtrctRegnReq.GrpHdr.InitgPty.Id.OrgId.Othr.Id), где SchmeNm.Cd = 'TXID' — обязательное поле

  2. Одно из полей ИНН является обязательным (SchmeNm.Cd = 'TXID'):

    • Buyr.PtyId.Id.OrgId.Othr.Id

    • Sellr.PtyId.Id.OrgId.Othr.Id

  3. Если значение ИНН из п.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 - Экспорт товаров
2 - Импорт товаров
3 - Экспорт услуг
4 - Импорт услуг
9 - Смешанная сделка

34

O

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

CtrctRegnOpng.Attchmnt

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

Общий путь Document.CtrctRegnReq.CtrctRegn.CtrctRegnOpng.Ctrct.Trad

35

R

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

CtrctDocId.Id

36

O

Сумма контракта

Amt Ccy

37

O

ИНН покупателя

[Buyr Sellr<>InitgPty].PtyId.Id.OrgId.Othr.Id, где SchmeNm/Cd=TXID

Обязательно к заполнению, если ИНН равен CtrctRegnReq.GrpHdr.InitgPty.Id.OrgId.Othr.Id, где SchmeNm.Cd = 'TXID'

Один из тегов с этим замечанием должен быть обязательно и содержать ИНН клиента

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

Обязательно к заполнению один из тегов

40

O

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

[Buyr Sellr<>InitgPty].PtyId.Nm

41

R

Дата завершения контракта/договора

MtrtyDt

YYYY-MM-DD

42

R

Признак пролонгации

PrlngtnFlg

Обязательно к заполнению по схеме, на создание УНК не влияет.

43

R

Дата начала обязательств по торговому контракту

StartDt

YYYY-MM-DD.

44

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>
            </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>2020-03-08</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>

Ответ

Ответ приходит по схеме:

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

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

13. Внесение изменений в I раздел ВБК (переоформление УНК)

Важная информация

Основания для внесения изменений в I раздел ВБК перечислены в главе 7 инструкции Банка России от 16.08.2017 №181-И. На стороне банка автоматически будет сформировано и отправлено от имени Вашей компании заявление о внесении изменений в I раздел ВБК.

Необходимо вносить изменения в раздел I ВБК в следующих случаях:

  • Изменение регистрационных данных резидента (наименование, ИНН, КПП, ОГРН). При смене юр.адреса – вносить изменения не надо;

Подтверждающие документы предоставлять не нужно.
  • Пролонгация контракта (без подписания дополнений);

Подтверждающие документы предоставлять не нужно.
  • Изменение сведений о контракте (валюта, сумма, дата) ;

Необходимо предоставить документы, подтверждающие изменения контракта.
  • Изменение сведений о контрагенте (наименование, страна) ;

Необходимо предоставить документы, подтверждающие изменения.
  • Уступка прав физическому лицу.

Необходимо предоставить документы, подтверждающие уступку требования по контракту другому резиденту либо перевод долга по контракту на другого резидента.

Подтверждающие документы необходимо прикладывать к запросу на внесение изменений
Подробнее в разделе Отправка вложенных файлов вместе с документом (POST)

Получение подтверждения о внесении изменений I раздел ВБК
GET /API/v1/ISO20022/Contracts/Confirmations/<RegdCtrctAmdmntId>

Если в момент вызова изменения в ВБК еще не внесены, возвращается 404 ошибка. Подробнее в разделе Описание схемы

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

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

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

URI

POST: /API/v1/ISO20022/Contracts/Reissue

XSD схема

auth.021.001.03

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

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

Общий путь Document. CtrctRegnAmdmntReq.GrpHdr

1

R

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

MsgId

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

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Константа "1"

4

R

ИНН организации резидента

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

ИНН, по которому определяется организация-инициатор внесения изменений в 1 раздел ВБК

5

R

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

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

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

6

R

Номер счета резидента

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

Номер счета, по которому определяется организация-инициатор внесения изменений в 1 раздел ВБК

7

R

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

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

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

Общий путь Document.CtrctRegnAmdmntReq.CtrctRegnAmdmnt

8

R

Уникальный id пакета

CtrctRegnAmdmntId

Параметры (#9-14) отвечают за изменение регистрационных данных (пункты 1.1, 1.3-1.5 в печатной форме заявления). Заполнение обязательно, даже если данные не меняются.

9

R

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

RptgPty.PtyId.Nm

Не более 140 символов.

10

R

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

RptgPty.PtyId.Id.OrgId.Othr.Id

11

R

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

RptgPty.PtyId.Id.OrgId.Othr.SchmeNm.Cd

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

12

R

КПП резидента

RptgPty.TaxPty.TaxTp

Не обязателен по схеме, но обязателен для корректного запроса.

13

R

ОГРН резидента

RptgPty.LglOrg.Id

Не обязателен по схеме, но обязателен для корректного запроса.

14

R

Дата регистрации ОГРН

RptgPty.LglOrg.RegnDt

Не обязателен по схеме, но обязателен для корректного запроса.

15

R

Код клиринговой системы

RegnAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

16

R

БИК банка/отделения обслуживающего счет

RegnAgt.FinInstnId.ClrSysMmbId.MmbId

17

R

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

RegnAgt.FinInstnId.Nm

Требуется указать филиал банка, где обслуживается организация

Общий путь Document.CtrctRegnAmdmntReq.RegdCtrctAmdmnt

18

R

Уникальный id запроса

RegdCtrctAmdmntId

19

R

Номер УНК

OrgnlRegdCtrctId

Пример: 11111111/3333/4444/1/1

20

R

Срочность

Prty

HIGH - в течение дня, NORM - в течение 3 дней

21

R

Номер договора

Ctrct.Trad.CtrctDocId.Id

22

О

Сумма и валюта договора

Ctrct.Trad.Amt@Ccy

Пример: <Amt Ccy="USD">1500.00<.Amt>

Следующие параметры Buyer/Seller необходимо заполнять только если у Вас меняется контрагент или информация по нему. Если нет, оставляйте тэги Buyr.PtyId и Sellr.PtyId пустыми. Если контрагент изменяется, то необходимо заполнить один из параметров Buyr/Sellr (в зависимости от того, кем является контрагент) данными контрагента (Например: Buyr.PtyId.Nm и Buyr.PtyId.CtryOfRes). А в другом параметре необходимо указать ИНН Вашей компании и константу (Например: Sellr.PtyId.Id.OrgId.Othr.Id и Sellr.PtyId.Id.OrgId.Othr.SchmeNm.Cd, где Cd=TXID)

23

O

ИНН покупателя

[Buyr Sellr<>InitgPty].PtyId.Id.OrgId.Othr.Id, где SchmeNm/Cd=TXID

Если тэги Buyr/Sellr не пустые, то один из них должен обязательно содержать ИНН клиента

24

O

ИНН продавца

[Buyr Sellr<>InitgPty].PtyId.Id.OrgId.Othr.Id, где SchmeNm/Cd=TXID

Если тэги Buyr/Sellr не пустые, то один из них должен обязательно содержать ИНН клиента

25

O

Код страны контрагента

[Buyr Sellr<>InitgPty].PtyId.CtryOfRes

26

O

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

[Buyr Sellr<>InitgPty].PtyId.Nm

27

R

Дата завершения контракта/договора

Ctrct.Trad.MtrtyDt

YYYY-MM-DD

28

О

Пролонгация договора

Ctrct.Trad.PrlngtnFlg

TrueFalseIndicator 'True' – при пролонгации, без изменений условий контракта, 'False' – во всех остальных случаях

29

R

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

Ctrct.Trad.StartDt

YYYY-MM-DD.

30

O

Вложения

Attchmnt

Описание файлов-вложений.
Отправка вложенных файлов вместе с документом (POST)

Следующий блок добавляется только в случае переуступки прав/требований по контракту физ.лицу

31

О

Номер документа подтверждающего переход прав (требований) по контракту

SplmtryData.Envlp.AdditionalData.DocNum

В случае переуступки физ.лицу тэг является обязательным к заполнению

32

О

Дата документа подтверждающего переход прав (требований) по контракту

SplmtryData.Envlp.AdditionalData.DocDt

В случае переуступки физ.лицу тэг является обязательным к заполнению

33

О

ФИО физ.лица, которому переходят права (требования) (на которое переводится долг) по контракту

SplmtryData.Envlp.AdditionalData.IndNm

В случае переуступки физ.лицу тэг является обязательным к заполнению

34

О

ИНН физ.лица

SplmtryData.Envlp.AdditionalData.Inn

Блок с адресом физ.лица должен быть заполнен по максимуму

35

О

Корпус/строение

SplmtryData.Envlp.AdditionalData.PstlAdr.Dept

36

О

Квартира

SplmtryData.Envlp.AdditionalData.PstlAdr.SubDept

37

О

Улица

SplmtryData.Envlp.AdditionalData.PstlAdr.StrtNm

38

О

Дом

SplmtryData.Envlp.AdditionalData.PstlAdr.BldgNb

В случае переуступки физ.лицу тэг является обязательным к заполнению

39

О

Город

SplmtryData.Envlp.AdditionalData.PstlAdr.TwnNm

В случае переуступки физ.лицу обязателен к заполнению один из тегов: TwnNm или TwnLctnNm

40

О

Населенный пункт

SplmtryData.Envlp.AdditionalData.PstlAdr.TwnLctnNm

В случае переуступки физ.лицу обязателен к заполнению один из тегов: TwnNm или TwnLctnNm

41

О

Район

SplmtryData.Envlp.AdditionalData.PstlAdr.DstrctNm

42

О

Субъект в котором зарегистрировано физ.лицо

SplmtryData.Envlp.AdditionalData.PstlAdr.CtrySubDvsn

43

О

Полный адрес регистрации физ.лица

SplmtryData.Envlp.AdditionalData.PstlAdr.AdrLine

Ответ

Ответ приходит по схеме:

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

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

Пример запроса на внесение изменений в I раздел ВБК
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.021.001.03"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CtrctRegnAmdmntReq>
        <GrpHdr>
            <MsgId>746d6e4c-1f55-409d-a1a8-4a32553ff</MsgId><!-- Уникальный ID сообщения-->
            <CreDtTm>2023-01-01T18:13:51.0</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>ACC</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <CtrctRegnAmdmnt>
            <CtrctRegnAmdmntId>746d6e4c-1f55-409d-a1a8-4a32553ff</CtrctRegnAmdmntId><!-- Уникальный ID пакета-->
            <RptgPty>
                <PtyId>
                    <Nm>ООО "Тест Альфа-Линк"</Nm><!-- наименование резидента, отправившего запрос-->
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id><!-- ИНН резидента-->
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
                <LglOrg>
                    <Id>1092940217001</Id> <!-- ОГРН резидента-->
                    <RegnDt>2022-01-09</RegnDt> <!-- Дата ОГРН-->
                </LglOrg>
                <TaxPty>
                    <TaxTp>215045470</TaxTp> <!-- КПП резидента-->
                </TaxPty>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО Альфа-Банк</Nm>
                </FinInstnId>
            </RegnAgt>
            <RegdCtrctAmdmnt>
                <RegdCtrctAmdmntId>746d6e4c-1f55-409d-a1a8-4a32553ff</RegdCtrctAmdmntId><!-- Уникальный ID запроса на внесение изменений -->
                <OrgnlRegdCtrctId>23020018/1326/0000/9/1</OrgnlRegdCtrctId> <!-- УНК-->
                <Prty>NORM</Prty> <!-- Срочность внесения изменений-->
                <Ctrct>
                    <Trad>
                        <CtrctDocId>
                            <Id>123</Id> <!-- Номер контракта-->
                        </CtrctDocId>
                        <Amt Ccy="USD">80000.00</Amt> <!-- валюта и сумма контракта-->
                        <Buyr>
                           <PtyId>
                                <Id>
                                    <OrgId>
                                        <Othr>
                                            <Id>7013602245</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                            </PtyId>
                        </Buyr>
                        <Sellr>
                            <PtyId>
                                <Nm>TESTING COMPANY LIMITED</Nm><!-- Наименование контрагента-->
                                <CtryOfRes>AU</CtryOfRes> <!-- Страна резидентства контрагента-->
                            </PtyId>
                        </Sellr>
                        <MtrtyDt>2023-12-27</MtrtyDt> <!-- Дата окончания контракта-->
                        <PrlngtnFlg>false</PrlngtnFlg> <!-- Пролонгация-->
                        <StartDt>2023-01-20</StartDt> <!-- Дата начала контракта-->
                    </Trad>
                </Ctrct>
                <Attchmnt><!-- Документы, подтверждающие изменения-->
                    <DocTp>CСDC</DocTp> <!-- Константа-->
                    <DocNb>12A</DocNb> <!-- Номер документа-обоснования -->
                    <IsseDt>2023-01-27</IsseDt> <!-- Дата документа-обоснования -->
                    <URL>test.pdf</URL>
                    <AttchdBinryFile>
                        <MIMETp>NONE</MIMETp>
                    </AttchdBinryFile>
                </Attchmnt>
            </RegdCtrctAmdmnt>
        </CtrctRegnAmdmnt>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
  </CtrctRegnAmdmntReq>
</Document>

14. Снятие контракта с учета

Важная информация

На стороне банка автоматически будет сформировано и отправлено от имени Вашей компании заявление о снятии с учета контракта.

Основания для снятия с учета контракта перечислены в пункте 6.1 инструкции Банка России от 16.08.2017 №181-И.

Снять контракт с учета необходимо в следующих случаях:

6.1.1 При переводе из банка УК контракта на обслуживание в другой уполномоченный банк:

  • из одного филиала Альфа-Банка в другой

  • из головного офиса Альфа-Банка в филиал Альфа-Банка

  • из филиала Альфа-Банка в головной офис Альфа-Банка

а также при закрытии резидентом всех расчетных счетов в банке УК.

6.1.2 При исполнении сторонами всех обязательств по контракту, включая исполнение обязательств третьим лицом.

6.1.3 При уступке резидентом требования по контракту другому лицу - резиденту либо при переводе долга резидентом по контракту на другое лицо - резидента.

Необходимо предоставить

документы, подтверждающие уступку требования по контракту другому резиденту либо перевод долга по контракту на другого резидента.
  • 6.1.4 При уступке резидентом требования по контракту нерезиденту либо при переводе долга резидентом по контракту на нерезидента.

Необходимо предоставить

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

документы, подтверждающие перевод долга по контракту на нерезидента.
  • 6.1.5 При исполнении (прекращении) обязательств по контракту по иным, не указанным в подпункте 6.1.2 настоящего пункта основаниям, предусмотренным законодательством Российской Федерации.

Необходимо предоставить

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

документы со сведениями, которые подтверждают исполнение (прекращение) обязательств по контракту по иным основаниям, предусмотренным законодательством РФ.
  • 6.1.6 При прекращении оснований постановки на учет контракта в соответствии с Инструкцией, в том числе вследствие внесения соответствующих изменений и (или) дополнений в контракт, а также в случае если контракт был ошибочно принят на учет при отсутствии в контракте оснований его принятия на учет.

Необходимо предоставить

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

Документы необходимо прикладывать к запросу на снятие контракта с учета
Подробнее в разделе Отправка вложенных файлов вместе с документом (POST)

Получение подтверждения о снятии с учета внешнеторгового контракта
GET /API/v1/ISO20022/Contracts/Close/Confirmations/<RegdCtrctClsrId>
Если в момент вызова контракт не снят с учета, возвращается 404 ошибка.

В ответе будут заполнены поля:

  • Дата снятия контракта с учета (RegdCtrctJrnl.ClsrDt)

  • Код причины (RegdCtrctJrnl.ClsrRsn.Prtry)

Описание схемы ответа Описание схемы

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

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

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

URI

POST: /API/v1/ISO20022/Contracts/Close

XSD схема

auth.020.001.03

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

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

Общий путь Document.CtrctRegnClsrReq.GrpHdr

1

R

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

MsgId

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

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Константа "1"

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.CtrctRegnClsrReq.RegdCtrctClsr

8

R

Уникальный id запроса

RegdCtrctClsrId

9

R

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

RptgPty.PtyId.Nm

Не более 140 символов

10

R

Код клиринговой системы

RegnAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

11

R

БИК банка/отделения обслуживающего счет

RegnAgt.FinInstnId.ClrSysMmbId.MmbId

12

R

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

RegnAgt.FinInstnId.Nm

Требуется указать филиал банка, где обслуживается организация

13

R

Номер УНК

OrgnlRegdCtrct.Id

14

R

Дата УНК

OrgnlRegdCtrct.DtOfIsse

15

R

Срочность

OrgnlRegdCtrct.Prty

HIGH - в течение дня, NORM - в течение 3 дней

16

R

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

ClsrRsn.Prtry

Указать один из вариантов:
6.1.1
6.1.2
6.1.3
6.1.4
6.1.5
6.1.6

17

O

Вложения

Attchmnt

Описание файлов-вложений.
Отправка вложенных файлов вместе с документом (POST)

Ответ

Ответ приходит по схеме:

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.020.001.03"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CtrctRegnClsrReq>
        <GrpHdr>
            <MsgId>TEST_MSG_2023-02-03-190295741</MsgId>
            <CreDtTm>2023-02-03T11:03:12.030</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                        <Othr>
                            <Id>40702840200000000529</Id>
                            <SchmeNm>
                                <Cd>ACC</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <RegdCtrctClsr>
            <RegdCtrctClsrId>TEST_ID_2023-02-03-190295741</RegdCtrctClsrId>
            <RptgPty>
                <PtyId>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                </PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                </FinInstnId>
            </RegnAgt>
            <OrgnlRegdCtrct>
                <Id>22120054/1326/0000/1/1</Id>
                <DtOfIsse>2022-12-28</DtOfIsse>
            </OrgnlRegdCtrct>
            <Prty>NORM</Prty>
            <ClsrRsn>
                <Prtry>6.1.4</Prtry>
            </ClsrRsn>
            <Attchmnt>
                <DocTp>CCDC</DocTp>
                <DocNb>0</DocNb>
                <URL>test.pdf</URL>
                <AttchdBinryFile>
                    <MIMETp>NONE</MIMETp>
                </AttchdBinryFile>
            </Attchmnt>
        </RegdCtrctClsr>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CtrctRegnClsrReq>
</Document>

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 ошибка.

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

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

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>

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

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

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

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

URI

POST: /API/v1/ISO20022/COCertificates

XSD схема

auth.024.001.01

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

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

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

1

R

ИНН

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

2

R

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

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

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

3

R

Номер счёта

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

4

R

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

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

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

5

R

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

MsgId

6

R

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

CreDtTm

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

7

R

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

NbOfItms

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

8

R

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

AcctOwnr.Nm

9

R

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

AcctOwnr.Id.OrgId.Othr.Id

10

R

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

AcctOwnr.Id.OrgId.Othr.SchmeNm.Cd

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

11

R

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

AcctSvcr.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

12

R

БИК Банка

AcctSvcr.FinInstnId.ClrSysMmbId.MmbId

13

R

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

TxCert.TxId

14

R

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

TxCert.Cert.Id

15

O

Дата СВО

TxCert.Cert.DtOfIsse

16

R

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

TxCert.Acct.Id.Othr.Id

17

R

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

TxCert.BkAcctDmcltnCtry

18

R

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

TxCert.CertRcrd.Tx.RfrdDoc.Id.EndToEndId

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

19

R

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

TxCert.CertRcrd.Tx.RfrdDoc.Dt

20

R

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

TxCert.CertRcrd.Tx.TxDt

21

R

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

TxCert.CertRcrd.Tx.TxTp

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

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

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

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

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

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

22

R

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

TxCert.CertRcrd.Tx.LclInstrm

23

R

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

TxCert.CertRcrd.Tx.Amt@Ccy

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

24

R

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

TxCert.CertRcrd.Tx.Amt@Ccy

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

25

O

Номер УНК

TxCert.CertRcrd.Ctrct.CtrctRef.RegdCtrctId

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

26

O

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

TxCert.CertRcrd.Ctrct.CtrctRef.Ctrct.Id

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

27

O

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

TxCert.CertRcrd.Ctrct.CtrctRef.Ctrct.DtOfIsse

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

28

O

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

TxCert.CertRcrd.Ctrct.TxAmtInCtrctCcy@Ccy

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

29

R

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

TxCert.CertRcrd.Ctrct.TxAmtInCtrctCcy@Ccy

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

30

O

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

TxCert.CertRcrd.Ctrct.XpctdAdvncPmtRtrDt

31

O

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

TxCert.CertRcrd.Ctrct.XpctdShipmntDt

32

R

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

TxNtfctnId

33

R

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

TxCert.CertRcrd.CertRcrdId

34

O

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

TxCert.CertRcrd.Tx.RfrdDoc.Id.PmtInfId

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

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

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

Ответ

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

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

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

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

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

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

403

Err

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

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

Пример подписанных СВО
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.024.001.01" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <PmtRgltryInfNtfctn>
    <GrpHdr>
      <MsgId>024001011700000000000000016</MsgId>
      <CreDtTm>2021-02-10T14:10:10+03:00</CreDtTm>
      <NbOfItms>1</NbOfItms>
      <InitgPty>
        <Pty>
          <Id>
            <OrgId>
              <Othr>
                <Id>40701810301600000105</Id>
                <SchmeNm>
                  <Cd>ACC</Cd>
                </SchmeNm>
              </Othr>
              <Othr>
                <Id>7728142469</Id>
                <SchmeNm>
                  <Cd>TXID</Cd>
                </SchmeNm>
              </Othr>
            </OrgId>
          </Id>
          <CtctDtls>
            <Nm>Иванов Иван Иванович</Nm>
            <PhneNb>+7-(495)1234567</PhneNb>
          </CtctDtls>
        </Pty>
      </InitgPty>
    </GrpHdr>
    <TxNtfctn>
      <TxNtfctnId>024001011700000000000000016</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>024001011700000000000000016</TxId>
        <Cert>
          <Id>81</Id>
          <DtOfIsse>2021-02-10</DtOfIsse>
        </Cert>
        <Acct>
          <Id>
            <Othr>
              <Id>40702810200000000083</Id>
              <SchmeNm>
                <Cd>BBAN</Cd>
              </SchmeNm>
            </Othr>
          </Id>
        </Acct>
        <CertRcrd>
          <CertRcrdId>TESTRUMM-CTCNTF-20201009-0010102</CertRcrdId>
          <Tx>
            <RfrdDoc>
              <Id>
                <PmtInfId>PT01978001600000088201208081207543</PmtInfId>
                <EndToEndId>0109</EndToEndId>
              </Id>
              <Dt>2021-02-10</Dt>
            </RfrdDoc>
            <TxDt>2021-02-10</TxDt>
            <TxTp>1</TxTp>
            <LclInstrm>57010</LclInstrm>
            <Amt Ccy="USD">1990</Amt>
          </Tx>
          <Ctrct>
            <CtrctRef>
              <RegdCtrctId>20010160/1326/0000/2/1</RegdCtrctId>
            </CtrctRef>
            <TxAmtInCtrctCcy Ccy="USD">1</TxAmtInCtrctCcy>
            <AddtlInf>/NOPD/</AddtlInf>
          </Ctrct>
        </CertRcrd>
      </TxCert>
    </TxNtfctn>
    <SplmtryData>
      <Envlp>
        <SgntrSt>
          <ds:Signature Id="sigID1" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
            <ds:SignedInfo>
              <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
              <ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>
              <ds:Reference URI="">
                <ds:Transforms>
                  <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
                  <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
                  <ds:Transform Algorithm="http://www.w3.org/2002/06/xmldsig-filter2">
                    <dsig-xpath:XPath Filter="subtract" xmlns:dsig-xpath="http://www.w3.org/2002/06/xmldsig-filter2">//ds:Signature</dsig-xpath:XPath>
                  </ds:Transform>
                </ds:Transforms>
                <ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>
                <ds:DigestValue>VtraGipgI0wpMZwC7uVsHt5+w5ylA4ionFQBrFITEPw=</ds:DigestValue>
              </ds:Reference>
            </ds:SignedInfo>
            <ds:SignatureValue>ItoZ3ZlTqmk3WxJNdcT7xV/SEz9SHK8YrLl0/e63Zt7KUS2UZLOS9fmEY6AC4sBT11JIxS1J3cIu/J9E8SIFpQ==</ds:SignatureValue>
            <ds:KeyInfo>
              <ds:X509Data>
                <ds:X509Certificate>MIIHaDCCBtSgAwIBAgIRAzlhn1ZQAAyd6hHgoEDuI28wCgYIKoUDBwEBAwMwggELMRgwFgYFKoUDZAESDTEwMjc3MDAwNjczMjgxGjAYBggqhQMDgQMBARIMMDA3NzI4MTY4OTcxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxKjAoBgNVBAkMIdCj0LsuINCa0LDQu9Cw0L3Rh9C10LLRgdC60LDRjyAyNzEPMA0GA1UECwwG0KPQmNCRMSEwHwYDVQQKDBjQkNCeINCQ0JvQrNCk0JAt0JHQkNCd0JoxNTAzBgNVBAMMLNCi0JXQodCiINCj0KYgMi4wINCQ0J4gItCQ0JvQrNCk0JAt0JHQkNCd0JoiMB4XDTIwMDUyODEyMzA0NVoXDTIxMDgyODEyNDA0NVowHzELMAkGA1UEBhMCUlUxEDAOBgNVBAMMB2FubmFrb3AwZjAfBggqhQMHAQEBATATBgcqhQMCAiQABggqhQMHAQECAgNDAARARYKNpmlgHzZRaS84q1FK4VJBFQvaqZ6lT2ybx8G6SXglpBD6Pqij+UZJ4HB/Tt7spNBk19v41zw8joz6LNgEdKOCBPQwggTwMA4GA1UdDwEB/wQEAwIDqDAfBgkrBgEEAYI3FQcEEjAQBggqhQMCAi4ACAIBAQIBADAdBgNVHQ4EFgQUIEXW0BE7Gzwz5RksyWsto//mTegwggFNBgNVHSMEggFEMIIBQIAUrpyoHGSzKRGAaUSGwGMbWe0G9m2hggETpIIBDzCCAQsxGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEqMCgGA1UECQwh0KPQuy4g0JrQsNC70LDQvdGH0LXQstGB0LrQsNGPIDI3MQ8wDQYDVQQLDAbQo9CY0JExITAfBgNVBAoMGNCQ0J4g0JDQm9Cs0KTQkC3QkdCQ0J3QmjE1MDMGA1UEAwws0KLQldCh0KIg0KPQpiAyLjAg0JDQniAi0JDQm9Cs0KTQkC3QkdCQ0J3QmiKCEQM5YZ9WUAB4hucRH7Ps34tFMB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEFBQcDBDAnBgkrBgEEAYI3FQoEGjAYMAoGCCsGAQUFBwMCMAoGCCsGAQUFBwMEMB0GA1UdIAQWMBQwCAYGKoUDZHEBMAgGBiqFA2RxAjCCAUMGBSqFA2RwBIIBODCCATQMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQuMCkMWtCf0JDQmiAi0KPQtNC+0YHRgtC+0LLQtdGA0Y/RjtGJ0LjQuSDRhtC10L3RgtGAICLQmtGA0LjQv9GC0L7Qn9GA0L4g0KPQpiIg0LLQtdGA0YHQuNC4IDIuMAxP0KHQtdGA0YLQuNGE0LjQutCw0YIg0YHQvtC+0YLQstC10YLRgdGC0LLQuNGPIOKEliDQodCkLzEyNC0zMDEwINC+0YIgMzAuMTIuMjAxNgxP0KHQtdGA0YLQuNGE0LjQutCw0YIg0YHQvtC+0YLQstC10YLRgdGC0LLQuNGPIOKEliDQodCkLzEyOC0yOTgzINC+0YIgMTguMTEuMjAxNjA/BgUqhQNkbwQ2DDTQodCa0JfQmCAi0JrRgNC40L/RgtC+0J/RgNC+IENTUCIgKNCy0LXRgNGB0LjRjyA0LjApMIG9BgNVHR8EgbUwgbIwW6BZoFeGVWh0dHA6Ly90ZXN0LXVjMi5tb3Njb3cuYWxmYWludHJhLm5ldC9jZHAvYWU5Y2E4MWM2NGIzMjkxMTgwNjk0NDg2YzA2MzFiNTllZDA2ZjY2ZC5jcmwwU6BRoE+GTWh0dHA6Ly9jYS5hbGZhaW50cmEubmV0L2NlcnRkYXRhL2FlOWNhODFjNjRiMzI5MTE4MDY5NDQ4NmMwNjMxYjU5ZWQwNmY2NmQuY3JsMHEGCCsGAQUFBwEBBGUwYzBhBggrBgEFBQcwAoZVaHR0cDovL3Rlc3QtdWMyLm1vc2Nvdy5hbGZhaW50cmEubmV0L2FpYS9hZTljYTgxYzY0YjMyOTExODA2OTQ0ODZjMDYzMWI1OWVkMDZmNjZkLmNydDArBgNVHRAEJDAigA8yMDIwMDUyODEyMzA0NFqBDzIwMjEwODI4MTIzMDQ0WjAKBggqhQMHAQEDAwOBgQDUr8lTWXEs0nA2eIWMzRGXm1qB+hUloOvu0N3d+81cxIwpeHeShj+klkfgMjyStKvkVGeaCi59zkOX94V/KWTx4ZQBmmFGRsjrz3kOPYv9mWc/pCxOkVjpenyfsEZ/UDGzKOnz7D9C5VHc/DE7H9J2J37sgLQLBPIMwtAdik6u9g==</ds:X509Certificate>
              </ds:X509Data>
            </ds:KeyInfo>
          </ds:Signature>
          <ds:Signature Id="sigID2" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
            <ds:SignedInfo>
              <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
              <ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>
              <ds:Reference URI="">
                <ds:Transforms>
                  <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
                  <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
                  <ds:Transform Algorithm="http://www.w3.org/2002/06/xmldsig-filter2">
                    <dsig-xpath:XPath Filter="subtract" xmlns:dsig-xpath="http://www.w3.org/2002/06/xmldsig-filter2">//ds:Signature</dsig-xpath:XPath>
                  </ds:Transform>
                </ds:Transforms>
                <ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>
                <ds:DigestValue>VtraGipgI0wpMZwC7uVsHt5+w5ylA4ionFQBrFITEPw=</ds:DigestValue>
              </ds:Reference>
            </ds:SignedInfo>
            <ds:SignatureValue>B5g8VUzO4lxk13AamaMYVJN6qywCWKOMjCjI/AlpwfgY7ac7DNntpu3k+WSPyy7aLMbZ322CJVNEd+fwtyt1YA==</ds:SignatureValue>
            <ds:KeyInfo>
              <ds:X509Data>
                <ds:X509Certificate>MIIHaDCCBtSgAwIBAgIRAzlhn1ZQAAyd6hHgoCjuI28wCgYIKoUDBwEBAwMwggELMRgwFgYFKoUDZAESDTEwMjc3MDAwNjczMjgxGjAYBggqhQMDgQMBARIMMDA3NzI4MTY4OTcxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxKjAoBgNVBAkMIdCj0LsuINCa0LDQu9Cw0L3Rh9C10LLRgdC60LDRjyAyNzEPMA0GA1UECwwG0KPQmNCRMSEwHwYDVQQKDBjQkNCeINCQ0JvQrNCk0JAt0JHQkNCd0JoxNTAzBgNVBAMMLNCi0JXQodCiINCj0KYgMi4wINCQ0J4gItCQ0JvQrNCk0JAt0JHQkNCd0JoiMB4XDTIwMDUyODEyMzA0M1oXDTIxMDgyODEyNDA0M1owHzELMAkGA1UEBhMCUlUxEDAOBgNVBAMMB2FubmFrb3AwZjAfBggqhQMHAQEBATATBgcqhQMCAiQABggqhQMHAQECAgNDAARAP5j3vVGoiX82v9YUQY/I2qq+2HaH0/6pqAxMD4kWLYgb5ZMb21PmV73fpxuTtInqMphaynJ0omGfgGYebbzflKOCBPQwggTwMA4GA1UdDwEB/wQEAwIDqDAfBgkrBgEEAYI3FQcEEjAQBggqhQMCAi4ACAIBAQIBADAdBgNVHQ4EFgQUB+MvYD81EaEYTwdcvhsu91FQ7NgwggFNBgNVHSMEggFEMIIBQIAUrpyoHGSzKRGAaUSGwGMbWe0G9m2hggETpIIBDzCCAQsxGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEqMCgGA1UECQwh0KPQuy4g0JrQsNC70LDQvdGH0LXQstGB0LrQsNGPIDI3MQ8wDQYDVQQLDAbQo9CY0JExITAfBgNVBAoMGNCQ0J4g0JDQm9Cs0KTQkC3QkdCQ0J3QmjE1MDMGA1UEAwws0KLQldCh0KIg0KPQpiAyLjAg0JDQniAi0JDQm9Cs0KTQkC3QkdCQ0J3QmiKCEQM5YZ9WUAB4hucRH7Ps34tFMB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEFBQcDBDAnBgkrBgEEAYI3FQoEGjAYMAoGCCsGAQUFBwMCMAoGCCsGAQUFBwMEMB0GA1UdIAQWMBQwCAYGKoUDZHEBMAgGBiqFA2RxAjCCAUMGBSqFA2RwBIIBODCCATQMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQuMCkMWtCf0JDQmiAi0KPQtNC+0YHRgtC+0LLQtdGA0Y/RjtGJ0LjQuSDRhtC10L3RgtGAICLQmtGA0LjQv9GC0L7Qn9GA0L4g0KPQpiIg0LLQtdGA0YHQuNC4IDIuMAxP0KHQtdGA0YLQuNGE0LjQutCw0YIg0YHQvtC+0YLQstC10YLRgdGC0LLQuNGPIOKEliDQodCkLzEyNC0zMDEwINC+0YIgMzAuMTIuMjAxNgxP0KHQtdGA0YLQuNGE0LjQutCw0YIg0YHQvtC+0YLQstC10YLRgdGC0LLQuNGPIOKEliDQodCkLzEyOC0yOTgzINC+0YIgMTguMTEuMjAxNjA/BgUqhQNkbwQ2DDTQodCa0JfQmCAi0JrRgNC40L/RgtC+0J/RgNC+IENTUCIgKNCy0LXRgNGB0LjRjyA0LjApMIG9BgNVHR8EgbUwgbIwW6BZoFeGVWh0dHA6Ly90ZXN0LXVjMi5tb3Njb3cuYWxmYWludHJhLm5ldC9jZHAvYWU5Y2E4MWM2NGIzMjkxMTgwNjk0NDg2YzA2MzFiNTllZDA2ZjY2ZC5jcmwwU6BRoE+GTWh0dHA6Ly9jYS5hbGZhaW50cmEubmV0L2NlcnRkYXRhL2FlOWNhODFjNjRiMzI5MTE4MDY5NDQ4NmMwNjMxYjU5ZWQwNmY2NmQuY3JsMHEGCCsGAQUFBwEBBGUwYzBhBggrBgEFBQcwAoZVaHR0cDovL3Rlc3QtdWMyLm1vc2Nvdy5hbGZhaW50cmEubmV0L2FpYS9hZTljYTgxYzY0YjMyOTExODA2OTQ0ODZjMDYzMWI1OWVkMDZmNjZkLmNydDArBgNVHRAEJDAigA8yMDIwMDUyODEyMzA0MlqBDzIwMjEwODI4MTIzMDQyWjAKBggqhQMHAQEDAwOBgQBCvhFSUReg9ZgKYrrsAOu4q/ByWYbWca7uPlIGeR3zBZahJnOZ4rv/FjwEJFVywf7iFYeUF2+XoWU1+cJyhylsdNDuy5m67eOex3yy1XHmEQ0NPiwh2ZLqjVpRJNxPHfhCKSTde1e1+MYsjMDBmzTsvjK3TU/qMEXBy8LHE0wQQw==</ds:X509Certificate>
              </ds:X509Data>
            </ds:KeyInfo>
          </ds:Signature>
        </SgntrSt>
      </Envlp>
    </SplmtryData>
  </PmtRgltryInfNtfctn>
</Document>
Пример СВО с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива

17. Корректирующие СВО

URI

POST: /API/v1/ISO20022/COCertificates

XSD схема

auth.024.001.01

Предварительные условия

Для создания корректирующих СВО, в системе расчетов банка, должно быть ранее созданы СВО в состоянии "Авторизовано". Корректирующие СВО, отличаются от СВО заполненным блоком "Amdmnt"

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

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

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

1

ИНН

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

2

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

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

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

3

Номер счёта

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

4

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

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

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

5

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

MsgId

6

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

CreDtTm

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

7

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

NbOfItms

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

8

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

AcctOwnr.Nm

9

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

TxCert.Cert.TxId

10

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

TxCert.Cert.Id

11

Дата СВО

TxCert.Cert.DtOfIsse

12

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

TxCert.Acct.Id.Othr.Id

13

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

TxCert.BkAcctDmcltnCtry

14

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

TxCert.CertRcrd.Tx.RfrdDoc.Id.EndToEndId

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

15

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

TxCert.CertRcrd.Tx.RfrdDoc.Dt

16

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

TxCert.CertRcrd.Tx.TxTd

17

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

TxCert.CertRcrd.Tx.TxTp

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

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

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

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

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

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

18

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

TxCert.CertRcrd.Tx.LclInstrm

19

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

TxCert.CertRcrd.Tx.Amt@Ccy

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

20

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

TxCert.CertRcrd.Tx.Amt@Ccy

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

21

Номер УНК

TxCert.CertRcrd.Ctrct.CtrctRef.RegdCtrctId

22

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

TxCert.CertRcrd.Ctrct.CtrctRef.Ctrct.Id

23

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

TxCert.CertRcrd.Ctrct.CtrctRef.Ctrct.DtOfIsse

24

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

TxCert.CertRcrd.Ctrct.TxAmtInCtrctCcy@Ccy

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

25

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

TxCert.CertRcrd.Ctrct.TxAmtInCtrctCcy@Ccy

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

26

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

TxCert.CertRcrd.Ctrct.XpctdAdvncPmtRtrDt

27

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

TxCert.CertRcrd.Ctrct.XpctdShipmntDt

28

Примечание

TxCert.CertRcrd.Ctrct.AddtlInf

29

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

TxNtfctnId

30

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

TxCert.CertRcrd.CertRcrdId

31

Уникальный id сообщения с ВП

TxCert.CertRcrd.Tx.RfrdDoc.Id.MsgId

pain.001.001.006:
Document.CstmrCdtTrfInitn.GrpHdr.MsgId

32

Уникальный id пакета ВП

TxCert.CertRcrd.Tx.RfrdDoc.Id.PmtInfId

pain.001.001.006:
Document.CstmrCdtTrfInitn.PmtInf.PmtInfId

33

Уникальный id ВП

TxCert.CertRcrd.Tx.RfrdDoc.Id.InstrId

pain.001.001.006:
Document.CstmrCdtTrfInitn.PmtInf.
CdtTrfTxInf.PmtId.InstrId

34

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

TxCert.Amdmnt.OrgnlDocId

Указывается TxId исходного документа

35

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

TxCert.Amdmnt.CrrctnId

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

36

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

TxCert.CertRcrd.Ctrct.AddtlInf

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

37

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

TxCert.CertRcrd.Ctrct.AddtlInf

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

38

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

TxCert.CertRcrd.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

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

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
Изображения отображаются только при открытии документации из папки после разархивации архива

19. Распоряжение о списании средств с транзитного валютного счёта (РСТС)

Размер передаваемого в банк сообщения не должен превышать 100 МБ.
Информация для тестирования

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

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

URI

POST: /API/v1/ISO20022/FCYRLS

XSD схема

pain.001.001.06

Термины и сокращения

  • В формате ISO 20022 распоряжением о списании средств с транзитного валютного счета является пакет PmtInf.

  • Запись вида Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf[NTF] подразумевает такую секцию CdtTrfTxInf, для которой выполняется условие: CdtTrfTxInf.PmtTpInf.LclInstrm.Prtry = "NTF".

  • NTF - Информация об уведомлениях о поступлении на транзитный валютный счет.

  • TRF - Перечисление, на печатной форме это секция "Просим списать с нашего транзитного валютного счета с кодом вида операции «61100» для перечисления на наш расчетный счет в иностранной валюте")

  • RMT - Перевод, на печатной форме это секция "Просим списать с нашего транзитного валютного счета для перевода комитенту, принципалу, доверителю".

  • RFD - Возврат, на печатной форме это секция "Просим списать с нашего транзитного валютного счета для возврата ошибочно поступивших средств".

  • FX - Продажа, на печатной форме это секция "Просим списать с нашего транзитного валютного счета для осуществления продажи (с кодом вида операции "01010") и перечисления на расчетный счет в иностранной валюте".

Примечание

При распределении средств из одного начисления комбинации перечисление/перевод/возврат/продажа допустимы. В NTF указывается общая сумма, в остальных - части общей суммы.

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

Заголовок распоряжения

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

Секция: Реквизиты сообщения. Общий путь Document.CstmrCdtTrfInitn.GrpHdr

1

R

Уникальный идентификатор сообщения

MsgId

"TESTRUMM-MSG-20151101010101-00001"

2

R

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

CreDtTm

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

3

R

Общее число поручений (секций CdtTrfTxInf) в сообщении

NbOfTxs

1

4

R

Общая сумма поручений в сообщении

CtrlSum

1000

5

R

Полное название организации

InitgPty.Nm

6

R

ИНН

InitgPty.Id.OrgId.Othr.Id

7

R

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

InitgPty.Id.OrgId.Othr.SchmeNm.Cd

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

8

R

Транзитный счет компании

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

9

R

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

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

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

Секция: Пакет распоряжений. Document.CstmrCdtTrfInitn.PmtInf

10

R

Уникальный идентификатор распоряжения

PmtInfId

"TESTRUMM-PKG-20151101010101-00001"

11

R

Вариант перевода денежных средств.

PmtMtd

Константа "TRF" - Credit Transfer (перевод денежных средств). Перевод суммы денежных средств на балансе банка, обслуживающего счет.

12

R

Тип документа

Prtry

Константа "RU-FCYRLS"

13

R

Дата исполнения

ReqdExctnDt

В секции PmtInf могут объединяться заявки с одинаковым сроком действия.

Секция: Плательщик Document.CstmrCdtTrfInitn.PmtInf.Dbtr

14

R

Наименование плательщика

Nm

15

R

Адрес плательщика

PstlAdr.AdrLine

16

R

ИНН

Id.OrgId.Othr.Id

17

R

Код типа данных в поле Id

Id.OrgId.Othr.SchmeNm.Cd

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

18

O

Код страны регистрации

CtryOfRes

"RU"

Секция: Счет плательщика Document.CstmrCdtTrfInitn.PmtInf.DbtrAcct

19

R

Транзитный счет

Id.Othr.Id

"40702840100010000002"

20

R

Валюта счета

Ccy

"USD"

Секция: Банк плательщика Document.CstmrCdtTrfInitn.PmtInf.DbtrAgt

21

R

BIC (SWIFT адрес)

FinInstnId.BICFI

"ABCDRUMMXXX" Указывается либо SWIFT код либо российский БИК

22

R

Код страны

FinInstnId.PstlAdr.Ctry

"RU"

Секция: Cчет комиссии Document.CstmrCdtTrfInitn.PmtInf

23

O

Счет для списания комиссии

ChrgsAcct.Id.Othr.Id

Если в поле указывается счёт плательщика, то проставляется тип списания комиссии: "с расчетного счета в валюте РФ". Если счёт не указывается - комиссия списывается с суммы сделки (проставляется тип: "Иное").

LclInstrm.Prtry = "NTF" - секция обязательна

"Информация о зачислениях" Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf[NTF]

24

R

Уникальный номер поручения

PmtId.InstrId

"TESTRUMM-PMT-20151101010101-00001"

25

R

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

PmtId.EndToEndId

"26"

26

R

Код тип секции

PmtTpInf.LclInstrm.Prtry

"NTF"

27

R

Общая сумма поступившей валюты

Amt.InstdAmt

60000

28

R

Код валюты

Amt.InstdAmt@Ccy

"USD"

"Информация о зачислениях" Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf[NTF].RmtInf.Strd[1]

29

R

Номер уведомления

RfrdDocInf.Nb

"CAMT2015-11-01"

30

R

Дата уведомления

RfrdDocInf.RltdDt

2015-11-01

31

R

Сумма уведомления

RfrdDocAmt.CdtNoteAmt

10000

32

R

Код валюты

RfrdDocAmt.CdtNoteAmt@Ccy

10000

LclInstrm.Prtry = "TRF"

"Поручение на перевод на текущий счет" Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf[2]

33

R

Уникальный номер поручения

PmtId.InstrId

Отправитель должен обеспечивать уникальность. Формат определяется по договоренности сторон. Может использоваться GUID

34

R

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

PmtId.EndToEndId

Заполняется в случае если заполнено значение CdtrAgt.FinInstnId.BICFI

35

R

Код тип секции

LclInstrm.Prtry

"TRF"

36

R

Указывается сумма перевода в валюте

Amt.InstdAmt

50000

37

R

Код валюты

Amt.InstdAmt@Ccy

"USD"

38

R

Текущий валютный счет для перечисления валюты

CdtrAcct.Id.Othr.Id

39

R

Сумма (прописью) (для списания с транзитного валютного счета клиента и перечисления на расчетный счет клиента в иностранной валюте)

RmtInf.Strd.AddtlRmtInf[1..3]

40

R

Дата заявления на перевод иностранной валюты (для осуществления списания с транзитного валютного счета)

RmtInf.Strd.RfrdDocInf.RltdDt

Заполняется в случае если заполнено значение CdtrAgt.FinInstnId.BICFI

"Поручение на перевод на текущий счет": Банк посредник. Заполняется при наличии банка посредника

41

R

BIC (SWIFT адрес)

IntrmyAgt1.FinInstnId.BIC

"COBADEFF302"

42

R

Код страны

IntrmyAgt1.FinInstnId.PstlAdr.Ctry

"DE"

LclInstrm.Prtry = "FX"

"Поручение на продажу валюты". Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf[3]

43

R

Уникальный номер поручения

PmtId.InstrId

"TESTRUMM-PMT-20151101010101-00001"

44

R

Номер платежного поручения

PmtId.EndToEndId

10

45

R

Тип секции

PmtTpInf.LclInstrm.Prtry

"FX"

46

R

Сумма продажи в валюте

Amt.InstdAmt

10000

47

R

Код валюты

Amt.InstdAmt@Ccy

"USD"

48

R

Вариант покупки/продажи

XchgRateInf.RateTp

"AGRD" - Обмен по курсу Дилера ТОМ. "SALE" - Обмен по текущему курсу АЛЬФА-ФОРЕКС TOD. "SPOT" - Обмен по курсу Банка. (указывается, если не указан RateTp2)

49

R

Вариант покупки/продажи

SplmtryData.Envlp.RateTp2

"TMRW" - Обмен по курсу Банка России на завтра. "DTOD" - Обмен по курсу Дилера TOD. (указывается, если не указан RateTp)

50

R

Указывается рублевый счет

CdtrAcct.Id.Othr.Id

"40702810000010000001"

51

R

Сумма (прописью)

RmtInf.Strd.AddtlRmtInf[1..3]

52

R

SWIFT код банка получателя

CdtTrfTxInf.CdtrAgt.FinInstnId.BICFI

LclInstrm.Prtry = "RFD"

"Возврат". Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf[3]

53

R

Уникальный номер поручения

PmtId.InstrId

"TESTRUMM-PMT-20151101010101-00001"

54

R

Номер платежного поручения

PmtId.EndToEndId

Если CdtrAgt.FinInstnId.BICFI пуст и RmtInf.Strd.RfrdDocInf.Tp.CdOrPrtry.Prtry пуст - № заявления на перевод иностранной валюты (для возврата ошибочно поступивших средств), иначе № заявления на перевод иностранной валюты на счет Клиента в другой Банк (для перевода ошибочно поступивших средств)

55

R

Тип секции

PmtTpInf.LclInstrm.Prtry

"RFD"

56

R

Сумма (цифрами) (для возврата/перевода ошибочно поступивших средств)

Amt.InstdAmt

10000

57

R

Код валюты (для возврата/перевода ошибочно поступивших средств)

Amt.InstdAmt@Ccy

"USD"

58

R

Сумма (прописью) (для возврата/перевода ошибочно поступивших средств)

RmtInf.Strd.AddtlRmtInf[1..3]

LclInstrm.Prtry = "RMT"

"Перевод". Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf[3]

59

R

Уникальный номер поручения

PmtId.InstrId

"TESTRUMM-PMT-20151101010101-00001"

60

R

№ заявления на перевод иностранной валюты (для перевода комитенту, принципалу, доверителю)

PmtId.EndToEndId

Если CdtrAgt.FinInstnId.BICFI пуст и RmtInf.Strd.RfrdDocInf.Tp.CdOrPrtry.Prtry пуст - № заявления на перевод иностранной валюты (для возврата ошибочно поступивших средств), иначе № заявления на перевод иностранной валюты на счет Клиента в другой Банк (для перевода ошибочно поступивших средств)

61

R

Тип секции

PmtTpInf.LclInstrm.Prtry

"RMT"

62

R

Сумма (для перевода комитенту, принципалу, доверителю) (цифрами)

Amt.InstdAmt

10000

63

R

Валюта суммы комиссии (Мнемоника валюты заявления на перевод)

Amt.InstdAmt@Ccy

"USD"

64

R

Сумма (для перевода комитенту, принципалу, доверителю)

RmtInf.Strd.AddtlRmtInf[1..3]

(прописью) + код валюты Пример: «Десять тысяч долларов США 00 центов».

65

R

Дата заявления на перевод иностранной валюты

RmtInf.Strd.RfrdDocInf.RltdDt

Дата заявления на перевод документа Пример: «19.04.2013»

Ответ банка

pain.002.001.06

Для РСТС заполняются только секции OrgnlGrpInfAndSts (статус сообщения) и OrgnlPmtInfAndSts (статус пакета).

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

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

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:pain.001.001.06" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<CstmrCdtTrfInitn>
		<GrpHdr>
			<MsgId>TEST_MSG_2022_03_02_1000053111</MsgId>
			<CreDtTm>2022-03-03T12:09:45+03:00</CreDtTm>
			<NbOfTxs>2</NbOfTxs>
            <CtrlSum>24915</CtrlSum>
			<InitgPty>
				<Nm>ООО "Тест Альфа-Линк"</Nm>
				<Id>
					<OrgId>
						<Othr>
							<Id>7013602245</Id>
							<SchmeNm>
								<Cd>TXID</Cd>
							</SchmeNm>
						</Othr>
						<Othr>
							<Id>40702840100000000043</Id>
							<SchmeNm>
								<Cd>ACC</Cd>
							</SchmeNm>
						</Othr>
					</OrgId>
				</Id>
			</InitgPty>
			<FwdgAgt>
				<FinInstnId>
					<BICFI>ALFARUMMXXX</BICFI>
					<Nm>АО "АЛЬФА-БАНК"</Nm>
				</FinInstnId>
			</FwdgAgt>
		</GrpHdr>
		<PmtInf>
			<PmtInfId>TEST_PMT_2022_03_02_1000053111</PmtInfId>
			<PmtMtd>TRF</PmtMtd>
			<PmtTpInf>
				<LclInstrm>
					<Prtry>RU-FCYRLS</Prtry>
				</LclInstrm>
			</PmtTpInf>
			<ReqdExctnDt>2022-03-03</ReqdExctnDt>
			<Dbtr>
				<Nm>ООО "Тест Альфа-Линк"</Nm>
				<PstlAdr>
					<AdrLine>Москва ул. Московская 1</AdrLine>
				</PstlAdr>
				<Id>
					<OrgId>
						<Othr>
							<Id>7013602245</Id>
							<SchmeNm>
								<Cd>TXID</Cd>
							</SchmeNm>
						</Othr>
						<Othr>
							<Id>40702840100000000043</Id>
							<SchmeNm>
								<Cd>ACC</Cd>
							</SchmeNm>
						</Othr>
					</OrgId>
				</Id>
				<CtryOfRes>RU</CtryOfRes>
				<CtctDtls>
					<Nm>Тестов Тест</Nm>
					<PhneNb>+7-(495)3763062</PhneNb>
				</CtctDtls>
			</Dbtr>
			<DbtrAcct>
				<Id>
					<Othr>
						<Id>40702840100000000043</Id>
						<SchmeNm>
							<Cd>BBAN</Cd>
						</SchmeNm>
					</Othr>
				</Id>
				<Ccy>USD</Ccy>
			</DbtrAcct>
			<DbtrAgt>
				<FinInstnId>
					<ClrSysMmbId>
						<ClrSysId>
							<Cd>RUCBC</Cd>
						</ClrSysId>
						<MmbId>044525593</MmbId>
					</ClrSysMmbId>
					<Nm>АО "АЛЬФА-БАНК"</Nm>
					<PstlAdr>
						<Ctry>RU</Ctry>
					</PstlAdr>
				</FinInstnId>
			</DbtrAgt>
			<DbtrAgtAcct>
				<Id>
					<Othr>
						<Id>30101810200000000593</Id>
					</Othr>
				</Id>
			</DbtrAgtAcct>
			<ChrgsAcct>
				<Id>
					<Othr>
						<Id>40702810200000000083</Id>
					</Othr>
				</Id>
			</ChrgsAcct>
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>TEST_INSTR_2022_03_02_1000053111</InstrId>
					<EndToEndId>11111</EndToEndId>
				</PmtId>
				<PmtTpInf>
					<LclInstrm>
						<Prtry>NTF</Prtry>
					</LclInstrm>
				</PmtTpInf>
				<Amt>
					<InstdAmt Ccy="USD">24915.00</InstdAmt>
				</Amt>
				<RmtInf>
					<Strd>
						<RfrdDocInf>
							<Nb>1097</Nb>
							<RltdDt>2022-03-03</RltdDt>
						</RfrdDocInf>
						<RfrdDocAmt>
							<CdtNoteAmt Ccy="USD">24915.00</CdtNoteAmt>
						</RfrdDocAmt>
						<AddtlRmtInf>Двадцать четыре тысячи девятьсот пятнадцать долларов США 00 центов</AddtlRmtInf>
					</Strd>
					<Strd>
						<RfrdDocInf>
							<RltdDt>2022-03-03</RltdDt>
						</RfrdDocInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
			<!--часть суммы на перевод на текущий валютный счет (меньше или равно 20% от суммы поступления)-->
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>TEST_INSTRX_2022_03_02_1000053111</InstrId>
					<EndToEndId>11111</EndToEndId>
				</PmtId>
				<PmtTpInf>
					<LclInstrm>
						<Prtry>TRF</Prtry> <!--признак перевода на текущий счет-->
					</LclInstrm>
				</PmtTpInf>
				<Amt>
					<InstdAmt Ccy="USD">4983.00</InstdAmt>
				</Amt>
				<CdtrAgt>
					<FinInstnId>
						<ClrSysMmbId>
							<ClrSysId>
								<Cd>RUCBC</Cd>
							</ClrSysId>
							<MmbId>044525593</MmbId>
						</ClrSysMmbId>
						<Nm>АО "АЛЬФА-БАНК"</Nm>
						<PstlAdr>
							<Ctry>RU</Ctry>
						</PstlAdr>
					</FinInstnId>
				</CdtrAgt>
				<CdtrAcct>
					<Id>
						<Othr>
							<Id>40702840200000000529</Id>
						</Othr>
					</Id>
				</CdtrAcct>
				<RmtInf>
					<Ustrd>Perevod s tranzitnogo scheta</Ustrd>
					<Strd>
						<RfrdDocInf>
							<Nb>1097</Nb>
							<RltdDt>2022-03-03</RltdDt>
						</RfrdDocInf>
						<AddtlRmtInf>Четыре тысячи девятьсот восемьдесят три доллара США 00 центов</AddtlRmtInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
			<!--часть суммы на продажу (больше или равно 80% от суммы поступления)-->
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>TEST_INSTRX2_2022_03_02_1000053111</InstrId>
					<EndToEndId>10711</EndToEndId>
				</PmtId>
				<PmtTpInf>
					<LclInstrm>
						<Prtry>FX</Prtry> <!--признак продажи валюты-->
					</LclInstrm>
				</PmtTpInf>
				<Amt>
					<InstdAmt Ccy="USD">19932.00</InstdAmt>
				</Amt>
				<XchgRateInf>
                    <RateTp>AGRD</RateTp> <!-- курс сделки (AGRD-курс дилера)-->
                </XchgRateInf>
				<CdtrAgt>
					<FinInstnId>
						<ClrSysMmbId>
							<ClrSysId>
								<Cd>RUCBC</Cd>
							</ClrSysId>
							<MmbId>044525593</MmbId>
						</ClrSysMmbId>
						<Nm>АО "АЛЬФА-БАНК"</Nm>
						<PstlAdr>
							<Ctry>RU</Ctry>
						</PstlAdr>
					</FinInstnId>
				</CdtrAgt>
				<CdtrAcct>
					<Id>
						<Othr>
							<Id>40702810200000000083</Id>
						</Othr>
					</Id>
				</CdtrAcct>
				<RmtInf>
					<Ustrd>Perevod s tranzitnogo scheta</Ustrd>
					<Strd>
						<RfrdDocInf>
							<Nb>1097</Nb>
							<RltdDt>2022-02-25</RltdDt>
						</RfrdDocInf>
						<AddtlRmtInf>Девятнадцать тысячь девятьсот тридцать два доллара США 00 центов</AddtlRmtInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
		</PmtInf>
		<SplmtryData>
			<Envlp>
				<SgntrSt>
				</SgntrSt>
			</Envlp>
		</SplmtryData>
	</CstmrCdtTrfInitn>
</Document>
Пример неподписанного РСТС с полным переводом средств
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<CstmrCdtTrfInitn>
		<GrpHdr>
			<MsgId>TEST_MSG_2022_03_02_1000053112</MsgId>
			<CreDtTm>2022-03-03T12:09:45+03:00</CreDtTm>
			<NbOfTxs>2</NbOfTxs>
            <CtrlSum>24915</CtrlSum>
			<InitgPty>
				<Nm>ООО "Тест Альфа-Линк"</Nm>
				<Id>
					<OrgId>
						<Othr>
							<Id>7013602245</Id>
							<SchmeNm>
								<Cd>TXID</Cd>
							</SchmeNm>
						</Othr>
						<Othr>
							<Id>40702840100000000043</Id>
							<SchmeNm>
								<Cd>ACC</Cd>
							</SchmeNm>
						</Othr>
					</OrgId>
				</Id>
			</InitgPty>
			<FwdgAgt>
				<FinInstnId>
					<BICFI>ALFARUMMXXX</BICFI>
					<Nm>АО "АЛЬФА-БАНК"</Nm>
				</FinInstnId>
			</FwdgAgt>
		</GrpHdr>
		<PmtInf>
			<PmtInfId>TEST_PMT_2022_03_02_1000053112</PmtInfId>
			<PmtMtd>TRF</PmtMtd>
			<PmtTpInf>
				<LclInstrm>
					<Prtry>RU-FCYRLS</Prtry>
				</LclInstrm>
			</PmtTpInf>
			<ReqdExctnDt>2022-03-03</ReqdExctnDt>
			<Dbtr>
				<Nm>ООО "Тест Альфа-Линк"</Nm>
				<PstlAdr>
					<AdrLine>Москва ул. Московская 1</AdrLine>
				</PstlAdr>
				<Id>
					<OrgId>
						<Othr>
							<Id>7013602245</Id>
							<SchmeNm>
								<Cd>TXID</Cd>
							</SchmeNm>
						</Othr>
						<Othr>
							<Id>40702840100000000043</Id>
							<SchmeNm>
								<Cd>ACC</Cd>
							</SchmeNm>
						</Othr>
					</OrgId>
				</Id>
				<CtryOfRes>RU</CtryOfRes>
				<CtctDtls>
					<Nm>Тестов Тест</Nm>
					<PhneNb>+7-(495)3763062</PhneNb>
				</CtctDtls>
			</Dbtr>
			<DbtrAcct>
				<Id>
					<Othr>
						<Id>40702840100000000043</Id>
						<SchmeNm>
							<Cd>BBAN</Cd>
						</SchmeNm>
					</Othr>
				</Id>
				<Ccy>USD</Ccy>
			</DbtrAcct>
			<DbtrAgt>
				<FinInstnId>
					<ClrSysMmbId>
						<ClrSysId>
							<Cd>RUCBC</Cd>
						</ClrSysId>
						<MmbId>044525593</MmbId>
					</ClrSysMmbId>
					<Nm>АО "АЛЬФА-БАНК"</Nm>
					<PstlAdr>
						<Ctry>RU</Ctry>
					</PstlAdr>
				</FinInstnId>
			</DbtrAgt>
			<DbtrAgtAcct>
				<Id>
					<Othr>
						<Id>30101810200000000593</Id>
					</Othr>
				</Id>
			</DbtrAgtAcct>
			<ChrgsAcct>
				<Id>
					<Othr>
						<Id>40702810200000000083</Id>
					</Othr>
				</Id>
			</ChrgsAcct>
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>TEST_INSTR_2022_03_02_1000053112</InstrId>
					<EndToEndId>11112</EndToEndId>
				</PmtId>
				<PmtTpInf>
					<LclInstrm>
						<Prtry>NTF</Prtry>
					</LclInstrm>
				</PmtTpInf>
				<Amt>
					<InstdAmt Ccy="USD">24915.00</InstdAmt>
				</Amt>
				<RmtInf>
					<Strd>
						<RfrdDocInf>
							<Nb>1097</Nb>
							<RltdDt>2022-03-03</RltdDt>
						</RfrdDocInf>
						<RfrdDocAmt>
							<CdtNoteAmt Ccy="USD">24915.00</CdtNoteAmt>
						</RfrdDocAmt>
						<AddtlRmtInf>Двадцать четыре тысячи девятьсот пятнадцать долларов США 00 центов</AddtlRmtInf>
					</Strd>
					<Strd>
						<RfrdDocInf>
							<RltdDt>2022-03-03</RltdDt>
						</RfrdDocInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
			<!--перевод всей суммы на текущий валютный счет-->
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>TEST_INSTRX_2022_03_02_1000053112</InstrId>
					<EndToEndId>11113</EndToEndId>
				</PmtId>
				<PmtTpInf>
					<LclInstrm>
						<Prtry>TRF</Prtry> <!--признак перевода на текущий счет-->
					</LclInstrm>
				</PmtTpInf>
				<Amt>
					<InstdAmt Ccy="USD">24915.00</InstdAmt>
				</Amt>
				<CdtrAgt>
					<FinInstnId>
						<ClrSysMmbId>
							<ClrSysId>
								<Cd>RUCBC</Cd>
							</ClrSysId>
							<MmbId>044525593</MmbId>
						</ClrSysMmbId>
						<Nm>АО "АЛЬФА-БАНК"</Nm>
						<PstlAdr>
							<Ctry>RU</Ctry>
						</PstlAdr>
					</FinInstnId>
				</CdtrAgt>
				<CdtrAcct>
					<Id>
						<Othr>
							<Id>40702840200000000529</Id>
						</Othr>
					</Id>
				</CdtrAcct>
				<RmtInf>
					<Ustrd>Perevod s tranzitnogo scheta</Ustrd>
					<Strd>
						<RfrdDocInf>
							<Nb>1097</Nb>
							<RltdDt>2022-03-03</RltdDt>
						</RfrdDocInf>
						<AddtlRmtInf>Двадцать четыре тысячи девятьсот пятнадцать долларов США 00 центов</AddtlRmtInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
		</PmtInf>
		<SplmtryData>
			<Envlp>
				<SgntrSt>
				</SgntrSt>
			</Envlp>
		</SplmtryData>
	</CstmrCdtTrfInitn>
</Document>

20. Отправка письма в Банк

Размер передаваемого в банк сообщения не должен превышать 100 МБ.
Отправленные ранее в банк письма отозвать нельзя.
Информация для тестирования

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

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

URI

POST: /API/v1/ISO20022/Letters

XSD схема

auth.026.001.01

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

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

Document.CcyCtrlReqOrLttr.GrpHdr

1

R

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

MsgId

-

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Кол-во блоков ReqOrLttr

4

R

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

InitgPty.Pty.Nm

-

5

R

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

InitgPty.Pty.Id.OrgId.Othr.Id

-

6

R

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

InitgPty.Pty.Id.OrgId.Othr.SchmeNm.Cd

Константа TXID

7

R

Номер счёта

InitgPty.Pty.Id.OrgId.Othr.Id

-

8

R

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

InitgPty.Pty.Id.OrgId.Othr.SchmeNm.Cd

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

Document.CcyCtrlReqOrLttr.ReqOrLttr

9

R

Уникальный ID запроса на создание письма

ReqOrLttrId

-

10

R

Наименование организации отправителя запроса на создание письма

Sndr.Pty.Nm

-

11

R

Номер счета (Идентификация отправителя запроса)

Sndr.Pty.Id.OrgId.Othr.Id

-

12

R

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

Sndr.Pty.Id.OrgId.Othr.SchmeNm.Cd

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

13

R

ИНН Организации отправителя запроса на создание письма

Sndr.Pty.Id.OrgId.Othr.Id

-

14

R

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

Sndr.Pty.Id.OrgId.Othr.SchmeNm.Cd

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

15

R

Тема

Sbjt

-

16

R

Тип запроса

Tp

категория письма

17

R

Текст письма

Desc

-

18

R

Признак необходимости предоставления ответа на запрос

RspnReqrd

-

19

O

Вложения к письму

Attchmnt

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

Пример исходящего письма
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01">
    <CcyCtrlReqOrLttr>
        <GrpHdr>
            <MsgId>TEST_MSG_2023-03-22-858600253</MsgId>
            <CreDtTm>2022-01-14T13:20:23.775</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Pty>
                    <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
                    <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>
        <ReqOrLttr>
            <ReqOrLttrId>TEST_ID_2023-03-22-858600253</ReqOrLttrId>
            <Sndr>
                <Pty>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>40702810200000000083</Id>
                                <SchmeNm>
                                    <Cd>ACC</Cd>
                                </SchmeNm>
                            </Othr>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Pty>
            </Sndr>
            <Sbjt>Запрос на отзыв платежа</Sbjt>
            <Tp>RJCT</Tp>
            <Desc>Текст запроса на отзыв платежа</Desc>
            <RspnReqrd>true</RspnReqrd>
        </ReqOrLttr>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CcyCtrlReqOrLttr>
</Document>

Ответ

Ответом является XML-документ, соответствующий схеме auth.027.001.01

Пример ответа при отправке письма
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
    <CcyCtrlStsAdvc>
        <GrpHdr>
            <MsgId>fb39d65990e24f049232c9e5f78a1205</MsgId>
            <CreDtTm>2023-03-22T22:49:24.342+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <RcvgPty/>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                    <ClrSysMmbId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </RegnAgt>
        </GrpHdr>
        <GrpSts>
            <OrgnlRefs>
                <OrgnlMsgId>TEST_MSG_2023-03-22-858600253</OrgnlMsgId>
                <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
                <OrgnlCreDtTm>2023-03-22T22:49:21.622+03:00</OrgnlCreDtTm>
            </OrgnlRefs>
            <RptgPty>
                <PtyId>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>044525593</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                </FinInstnId>
            </RegnAgt>
            <Sts>RCVD</Sts>
        </GrpSts>
        <PackgSts>
            <PackgId>undefined</PackgId>
            <Sts>RCVD</Sts>
            <RcrdSts>
                <RcrdId>TEST_ID_2023-03-22-858600253</RcrdId>
                <Sts>RCVD</Sts>
            </RcrdSts>
        </PackgSts>
    </CcyCtrlStsAdvc>
</Document>

21. Запрос статуса письма

URI

Получение статуса по пакету писем

GET: /API/v1/ISO20022/Letters/<MsgId>

Получение статуса по конкретному письму

GET: /API/v1/ISO20022/Letters/OutLetters/<ReqOrLttrId>

Ответ

Ответом является XML-документ, соответствующий схеме auth.027.001.01.

Пример письма в статусе ACTC
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
    <CcyCtrlStsAdvc>
        <GrpHdr>
            <MsgId>49e579932da240ee87b9f45b60ef4fd1</MsgId>
            <CreDtTm>2023-03-22T22:52:03.608+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <RcvgPty/>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                    <ClrSysMmbId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </RegnAgt>
        </GrpHdr>
        <GrpSts>
            <OrgnlRefs>
                <OrgnlMsgId>TEST_MSG_2023-03-22-858600253</OrgnlMsgId>
                <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
                <OrgnlCreDtTm>2023-03-22T22:49:21.000+03:00</OrgnlCreDtTm>
            </OrgnlRefs>
            <RptgPty>
                <PtyId>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>044525593</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                </FinInstnId>
            </RegnAgt>
            <Sts>ACTC</Sts>
        </GrpSts>
        <PackgSts>
            <PackgId>undefined</PackgId>
            <Sts>ACTC</Sts>
            <RcrdSts>
                <RcrdId>TEST_ID_2023-03-22-858600253</RcrdId>
                <Sts>ACTC</Sts>
                <StsDtTm>2023-03-22T22:49:27.028+03:00</StsDtTm>
            </RcrdSts>
        </PackgSts>
    </CcyCtrlStsAdvc>
</Document>
Пример письма в статусе RJCT
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
    <CcyCtrlStsAdvc>
        <GrpHdr>
            <MsgId>535298c401684c62aa467bcb6bfabe13</MsgId>
            <CreDtTm>2023-03-22T22:54:08.005+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <RcvgPty/>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                    <ClrSysMmbId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </RegnAgt>
        </GrpHdr>
        <GrpSts>
            <OrgnlRefs>
                <OrgnlMsgId>TEST_MSG_2023-03-22-858600253</OrgnlMsgId>
                <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
                <OrgnlCreDtTm>2023-03-22T22:49:21.000+03:00</OrgnlCreDtTm>
            </OrgnlRefs>
            <RptgPty>
                <PtyId>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>044525593</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                </FinInstnId>
            </RegnAgt>
            <Sts>RJCT</Sts>
        </GrpSts>
        <PackgSts>
            <PackgId>undefined</PackgId>
            <Sts>RJCT</Sts>
            <RcrdSts>
                <RcrdId>TEST_ID_2023-03-22-858600253</RcrdId>
                <Sts>RJCT</Sts>
                <StsRsn>
                    <Rsn>
                        <Cd>NARR</Cd>
                    </Rsn>
                    <AddtlInf>Причина</AddtlInf>
                </StsRsn>
                <StsDtTm>2023-03-22T22:54:08.003+03:00</StsDtTm>
            </RcrdSts>
        </PackgSts>
    </CcyCtrlStsAdvc>
</Document>

Статусная модель для сообщения

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

1

RCVD

Получено

Хотя бы один документ в сообщении находятся в статусе RCVD

2

ACTC

На обработке

Все остальные случаи, когда статусы документов не удовлетворяют условиям п.1, 3, 4, 5 данной таблицы

3

PART

Частично принято

Хотя бы один документ в сообщении находятся в статусе ACPT

4

ACPT

Принято

Все документы в сообщении находятся в статусе ACPT

5

RJCT

Отклонено

Все документы в сообщении находятся в статусе RJCT

Статусная модель для письма

ISO статус Описание

RCVD

Документ получен, приступаем к обработке

ACTC

На обработке

ACPT

Принято

RJCT

Отклонено

22. Запрос списка входящих писем

Размер передаваемого в банк сообщения не должен превышать 100 МБ.

URI

Запрос на получение списка писем (входящие письма и уведомления о поступлении выручки на транзитный валютный счет)

POST: /API/v1/ISO20022/Letters/Lists

После отправки запроса, в случае ответа 200 ОК, необходимо получить список писем с помощью GET запроса (подробнее в разделе "Получение списка входящих писем").

XSD схема

auth.026.001.01

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

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

Document.CcyCtrlReqOrLttr.GrpHdr

1

R

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

MsgId

-

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Кол-во блоков ReqOrLttr

4

R

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

InitgPty.Pty.Nm

-

5

R

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

InitgPty.Pty.Id.OrgId.Othr.Id

-

6

R

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

InitgPty.Pty.Id.OrgId.Othr.SchmeNm.Cd

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

7

R

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

InitgPty.Pty.Id.OrgId.Othr.Id

-

8

R

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

InitgPty.Pty.Id.OrgId.Othr.SchmeNm.Cd

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

Document.CcyCtrlReqOrLttr.ReqOrLttr

9

R

Уникальный ID запроса на на получения списка писем/ув-ий

ReqOrLttrId

-

10

R

Наименование организации отправителя запроса на получения списка писем/ув-ий

Sndr.Pty.Nm

-

11

R

ИНН Организации отправителя запроса на получения списка писем/ув-ий

Sndr.Pty.Id.OrgId.Othr.Id

-

12

R

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

Sndr.Pty.Id.OrgId.Othr.SchmeNm.Cd

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

13

R

Номер счета (Идентификация отправителя запроса)

Sndr.Pty.Id.OrgId.Othr.Id

-

14

R

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

Sndr.Pty.Id.OrgId.Othr.SchmeNm.Cd

константа 'ACC'

15

R

Тема

Sbjt

Параметр обязателен по схеме. Указывается "Запрос списка входящих писем"

16

R

Тип запроса

Tp

константа 'ALLL' (получение всех типов писем) или 'CCER' (получение только уведомлений о поступлении средств на транзитный счет)

17

R

Признак необходимости предоставления ответа на запрос

RspnReqrd

Параметр обязателен по схеме. Указывается константа 'false'

Document.CcyCtrlReqOrLttr.SplmtryData.Envlp.AdditionalData

18

R

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

FrToDt.FrDt

-

19

R

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

FrToDt.ToDt

-

20

R

Признак "Только новые"

OnlyNew

TrueFalseIndicator

'True' - только новые (не запрошенные ранее) 'False' - все, включая новые

Пример запроса списка писем
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<CcyCtrlReqOrLttr>
    <GrpHdr>
        <MsgId>TEST_MSG_2023-03-21-150544530</MsgId>
        <CreDtTm>2023-03-21T15:05:44.530</CreDtTm>
        <NbOfItms>1</NbOfItms>
        <InitgPty>
            <Pty>
                <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
                <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>
    <ReqOrLttr>
        <ReqOrLttrId>TEST_ID_2023-03-21-150544530</ReqOrLttrId>
        <Sndr>
            <Pty>
                <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
                <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>
        </Sndr>
        <Sbjt>Запрос списка входящих писем</Sbjt>
        <Tp>ALLL</Tp>
        <RspnReqrd>false</RspnReqrd>
        <SplmtryData>
            <Envlp>
                <AdditionalData>
                    <FrToDt>
                        <FrDt>2022-07-14</FrDt>
                        <ToDt>2022-07-14</ToDt>
                    </FrToDt>
                    <OnlyNew>false</OnlyNew>
                </AdditionalData>
            </Envlp>
        </SplmtryData>
    </ReqOrLttr>
    <SplmtryData>
        <Envlp>
            <SgntrSt>
            </SgntrSt>
        </Envlp>
    </SplmtryData>
</CcyCtrlReqOrLttr>
</Document>

Таблица синхронных ответов сервиса "Запрос списка входящих писем"

HTTP код Тип ответа Ответ в body Описание ответа

200

OK

-

Запрос на получение списка принят без ошибок

401

Error

Wrong username or password

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

401

Error

User was not found

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

403

Error

User is disabled

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

500

Error

Warrant service error

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

401

Error

Signer is not allowed to sign this operation type

Пользователь не имеет право подписывать документы такого типа

401

Error

Number of signatures is not enough for this operation type

Недостаточное количество подписей для данного типа документов

403

Err

Certificate is disabled

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

403

Err

Signer’s warrant is disabled

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

403

Err

Signer’s warrant is expired

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

403

Error

User does not have permission

Нет права на запрос Списка писем в host-to-host

406

Error

Data signature is required

Нет подписи

403

Error

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

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

406

Error

Signature value is not valid

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

406

Error

Internal sign check state error

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

500

Error

Internal Error

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

400

Error

FrDt/ToDt is in the future

Дата начала/окончания периода запроса списка позднее текущей даты

400

Error

A date period is not specified

Не указан период запроса списка

400

Error

FrDt is later than ToDt

Дата начала периода запроса списка позднее даты окончания

400

Error

ReqOrLttrMessage with id: <Msg_Id> ИЛИ <ReqOrLttrId> already exists

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

400

Error

Document type wasn’t defined

Не определен тип запрашиваемых документов

23. Получение списка входящих писем

URI

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

GET: /API/v1/ISO20022/Letters/Lists/<MsgId>

Таблица http кодов

HTTP код Тип ответа Ответ в body Описание ответа

200

OK

The request is still being processed. Try later.

Запрос все еще обрабатывается

500

Error

Internal Error

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

500

Error

<текст с причиной отклонения>

-

500

Error

MsgId was not found

Не найден указанный MsgId

XSD схема ответа

auth.026.001.01

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

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

Document.CcyCtrlReqOrLttr.GrpHdr

1

R

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

MsgId

-

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Кол-во блоков ReqOrLttr

4

R

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

InitgPty.Agt.FinInstnId.Nm

константа 'АО "Альфа-Банк"'

5

R

SWIFT код банка

InitgPty.Agt.FinInstnId.BICFI

константа 'ALFARUMM'

6

R

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

InitgPty.Agt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

7

R

БИК Банка

InitgPty.Agt.FinInstnId.ClrSysMmbId.MmbId

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

Document.CcyCtrlReqOrLttr.ReqOrLttr

8

R

Уникальный ID письма

ReqOrLttrId

-

9

R

Дата и время создания письма

Dt

-

10

R

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

Sndr.Agt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

11

R

БИК Банка

Sndr.Agt.FinInstnId.ClrSysMmbId.MmbId

константа '44525593'

12

R

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

Sndr.Agt.FinInstnId.Nm

константа 'АО "Альфа-Банк"'

13

R

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

Rcvr.Pty.Id.OrgId.Othr.Id

-

14

R

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

Rcvr.Pty.Id.OrgId.Othr.SchmeNm.Cd

константа 'TXID'

15

R

ID запроса на предоставление списка писем

OrgnlRefs.OrgnlMsgId

константа 'TXID'

16

R

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

OrgnlRefs.OrgnlCreDtTm

константа 'TXID'

17

R

Тема письма

Sbjt

-

18

R

Тип запроса

Tp

заполняется в соответствии с таблицей "Категории писем"

19

O

Текст письма

Desc

-

20

R

Признак необходимости предоставления ответа на запрос

RspnReqrd

Параметр обязателен по схеме. Указывается константа 'false'

21

O

Тип вложенного файла

Attchmnt.DocTp

константа 'NONE'

22

O

Уникальный ID вложенного файла

Attchmnt.DocNb

23

O

Наименование вложенного файла

Attchmnt.URL

Document.CcyCtrlReqOrLttr.SplmtryData.Envlp.AdditionalData

24

O

Комментарий сотрудника банка

Comment

25

O

Номер транзитного валютного счета

CCER.NumTVS

26

O

Сумма, поступившая на транзитный валютный счет

CCER.SumTVS

27

O

Валюта, поступившая на транзитный валютный счет

CCER.SumTVS@Ccy

28

O

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

CCER.LastDate

29

O

Дата начала действия нарушения

CCER.ViolationDate

30

O

Номер документа, по которому зачислены средства на транзитный валютный счет

CCER.DocNum

31

O

Дата документа, по которому зачислены средства на транзитный валютный счет

CCER.DocDate

Пример ответа со списком писем
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01">
   <CcyCtrlReqOrLttr>
      <GrpHdr>
         <MsgId>1f850ba58b8046c6a2bb7dea052718bc</MsgId>
         <CreDtTm>2021-08-06T19:02:58.039+03:00</CreDtTm>
         <NbOfItms>2</NbOfItms>
         <InitgPty>
            <Agt>
               <FinInstnId>
                  <BICFI>ALFARUMM</BICFI>
                  <ClrSysMmbId>
                     <ClrSysId>
                        <Cd>RUCBC</Cd>
                     </ClrSysId>
                     <MmbId>044525593</MmbId>
                  </ClrSysMmbId>
                  <Nm>АО "Альфа-Банк"</Nm>
               </FinInstnId>
            </Agt>
         </InitgPty>
      </GrpHdr>
      <ReqOrLttr>
         <ReqOrLttrId>26de598739a24aca87c3567eb0dd6700</ReqOrLttrId>
         <Dt>2021-08-06</Dt>
         <Sndr>
            <Agt>
               <FinInstnId>
                  <ClrSysMmbId>
                     <ClrSysId>
                        <Cd>RUCBC</Cd>
                     </ClrSysId>
                     <MmbId>044525593</MmbId>
                  </ClrSysMmbId>
                  <Nm>АО "Альфа-Банк"</Nm>
               </FinInstnId>
            </Agt>
         </Sndr>
         <Rcvr>
            <Pty>
               <Id>
                  <OrgId>
                     <Othr>
                        <Id>7013602245</Id>
                        <SchmeNm>
                           <Cd>TXID</Cd>
                        </SchmeNm>
                     </Othr>
                  </OrgId>
               </Id>
            </Pty>
         </Rcvr>
         <OrgnlRefs>
            <OrgnlMsgId>TEST__DEV_MSG_234322222223</OrgnlMsgId>
            <OrgnlCreDtTm>2021-08-06T13:34:14.000+03:00</OrgnlCreDtTm>
         </OrgnlRefs>
         <Sbjt>тест456</Sbjt>
         <Tp>OTHR</Tp>
         <Desc>тест456</Desc>
         <RspnReqrd>false</RspnReqrd>
         <Attchmnt>
            <DocTp>NONE</DocTp>
            <DocNb>73001</DocNb>
            <URL>Документы для клиента.zip</URL>
         </Attchmnt>
         <SplmtryData>
            <Envlp>
               <AdditionalData/>
            </Envlp>
         </SplmtryData>
      </ReqOrLttr>
      <ReqOrLttr>
         <ReqOrLttrId>b3f595b42d28495a9b56d210a9f4d7da</ReqOrLttrId>
         <Dt>2021-08-06</Dt>
         <Sndr>
            <Agt>
               <FinInstnId>
                  <ClrSysMmbId>
                     <ClrSysId>
                        <Cd>RUCBC</Cd>
                     </ClrSysId>
                     <MmbId>044525593</MmbId>
                  </ClrSysMmbId>
                  <Nm>АО "Альфа-Банк"</Nm>
               </FinInstnId>
            </Agt>
         </Sndr>
         <Rcvr>
            <Pty>
               <Id>
                  <OrgId>
                     <Othr>
                        <Id>7013602245</Id>
                        <SchmeNm>
                           <Cd>TXID</Cd>
                        </SchmeNm>
                     </Othr>
                  </OrgId>
               </Id>
            </Pty>
         </Rcvr>
         <OrgnlRefs>
            <OrgnlMsgId>TEST__DEV_MSG_234322222223</OrgnlMsgId>
            <OrgnlCreDtTm>2021-08-06T13:34:14.000+03:00</OrgnlCreDtTm>
         </OrgnlRefs>
         <Sbjt>тест123</Sbjt>
         <Tp>OTHR</Tp>
         <Desc>тест123</Desc>
         <RspnReqrd>false</RspnReqrd>
         <Attchmnt>
            <DocTp>NONE</DocTp>
            <DocNb>72998</DocNb>
            <URL>Документы для клиента.zip</URL>
         </Attchmnt>
         <SplmtryData>
            <Envlp>
               <AdditionalData/>
            </Envlp>
         </SplmtryData>
      </ReqOrLttr>
   </CcyCtrlReqOrLttr>
</Document>
Пример ответа с пустым списком писем
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01">
   <CcyCtrlReqOrLttr>
      <GrpHdr>
         <MsgId>21ab4a3d886c4fa5892f4f7fb8004ab0</MsgId>
         <CreDtTm>2021-08-13T18:02:37.908+03:00</CreDtTm>
         <NbOfItms>0</NbOfItms>
         <InitgPty>
            <Agt>
               <FinInstnId>
                  <BICFI>ALFARUMM</BICFI>
                  <ClrSysMmbId>
                     <ClrSysId>
                        <Cd>RUCBC</Cd>
                     </ClrSysId>
                     <MmbId>044525593</MmbId>
                  </ClrSysMmbId>
                  <Nm>АО "Альфа-Банк"</Nm>
               </FinInstnId>
            </Agt>
         </InitgPty>
      </GrpHdr>
   </CcyCtrlReqOrLttr>
</Document>

Получение вложения к входящему письму из банка

Вложения к входящим из банка письмам следует запрашивать (скачивать) отдельным сервисом:

/API/v1/ISO20022/Letters/InLetters/Files/<ReqOrLttrId>/<DocNb>

24. Категории писем

Для запроса списка писем из Банка необходимо использовать следующие категории:

"Код ISO Описание

1

ALLL

Получение всех типов писем

2

CCER

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

Для отправки писем в Банк необходимо использовать следующие категории:

Код ISO Описание в Банке

1

CCDC

Валютный контроль

2

OTHR

Без категории

3

BPRC

Реестр расчетных документов

4

FCTR

Документы Факторинга

5

FREX

Операции FX в рамках генеральных соглашений

6

LOAN

Сопровождение кредитных сделок

7

PAYR

Зарплатный проект

8

PMTM

Уточнение реквизитов платежа

9

RJCT

Срочно! Отзыв платежа

10

SECU

Депозиты в рамках генеральных соглашений

11

LTBK

Комплаенс - финмониторинг

12

FDOC

Подтверждающие документы. Застройщик

13

LCFC

Аккредитивы/гарантии/инкассо

14

LTOZ

Запрос на справку/дубликаты документов

15

DEPT

Размещение депозита (вклада)

25. Зарплатная ведомость

URI

POST: /API/v1/ISO20022/Payroll

XSD схема

pain.008.001.05

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

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

Общий путь Document.CstmrDrctDbtInitn.GrpHdr

1

R

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

MsgId

2

R

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

CreDtTm

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

3

R

Количество строк в ведомости

NbOfTxs

4

R

Общая сумма строк ведомости

CtrlSum

5

R

Краткое наименование для выбранной в ведомости организации

InitgPty.Nm

6

R

ИНН выбранной в ведомости организации

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

7

R

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

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

Константа TXID

8

R

Расчетный счет для выбранного в ведомости зарплатного проекта

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

9

R

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

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

Костанта ACC

Общий путь Document.CstmrDrctDbtInitn.PmtInf

10

R

Идентификатор ведомости

PmtInfId

11

R

Вид договора

PmtMtd

Поле обязательно по схеме (константа DD)

12

R

Номер реестра

NbOfTxs

Макс. длина 11 цифр

13

R

Дата формирования реестра

ReqdColltnDt

14

R

Номер договора по зарплатному проекту (Сведения о договоре в АЗОН)

Cdtr.Nm

15

R

Вид зачисления

CdtrAcct.Id.Othr.Id

16

R

БИК банка, указанного в зарплатном проекте

CdtrAgt.FinInstnId.Nm

17

R

Номер строки в ведомости

DrctDbtTxInf.PmtId.InstrId

Макс. длина 7 цифр. Нумерация начинается с единицы должна идти строго по порядку (1,2,3…​).

18

R

Идентификатор строки ведомости (внутр.)

DrctDbtTxInf.PmtId.EndToEndId

19

R

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

DrctDbtTxInf.InstdAmt

20

R

Цифровой код валюты

DrctDbtTxInf.InstdAmt@Ccy

На данный момент ведомости формируются только в рублях (код - 643)

21

R

Отделение банка зарплатного проекта

DrctDbtTxInf.DbtrAgt.FinInstnId.Nm

Возможно указание константы '0000'.
Список кодов отделений можно найти на странице https://alfabank.ru/sme/salaryproject/
Раздел "Полезно знать", вкладка "Управление зарплатным проектом", подраздел "Открытие счетов и выпуск зарплатных карт для сотрудников резидентов РФ", п.5 "Справочник отделений"
Скачать XLS файл, в нём таблица "Отделение доставки карты", столбец - "Цифровой код"
XLS файл периодически обновляется, рекомендуется проверять обновления раз в полгода
Макс. длина 4 цифры

22

R

Филиал отделения банка зарплатного проекта

DrctDbtTxInf.DbtrAgt.FinInstnId.Othr.Id

Константа '0000'. Макс. длина 4 цифры

23

O

БИК банка, в котором открыт счёт, в случае, если он отличается от банка зарплатного проекта

DrctDbtTxInf.DbtrAgt.BrnchId.Id

24

R

Фамилия сотрудника

DrctDbtTxInf.Dbtr.PstlAdr.Dept

Макс. длина 30 символов

25

R

Имя сотрудника

DrctDbtTxInf.Dbtr.PstlAdr.SubDept

Макс. длина 30 символов

26

O

Отчество сотрудника

DrctDbtTxInf.Dbtr.PstlAdr.StrtNm

Макс. длина 30 символов

27

R

Номер лицевого счета сотрудника

DrctDbtTxInf.DbtrAcct.Id.Othr.Id

Ответ

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

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

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

200

OK

-

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

403

Err

User is disabled

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

401

Err

Signer is not allowed to sign this operation type

Пользователь не имеет право подписывать документы такого типа

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

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

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:pain.008.001.05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <CstmrDrctDbtInitn>
    <GrpHdr>
      <MsgId>7421w6f13a01983593e8dffb71fa6d15</MsgId> <!-- Идентификатор сообщения -->
      <CreDtTm>2022-03-30T12:00:00+03:00</CreDtTm> <!-- Дата Формирования -->
      <NbOfTxs>2</NbOfTxs>
      <CtrlSum>200.00</CtrlSum>
      <InitgPty>
        <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк ЗУП"</Nm> <!-- Наименование Организации -->
        <Id>
          <OrgId>
            <Othr>
              <Id>0664010623</Id> <!-- ИНН -->
              <SchmeNm>
                <Cd>TXID</Cd>
              </SchmeNm>
            </Othr>
            <Othr>
              <Id>40702810800000000111</Id> <!-- Расчетный Счет Организации -->
              <SchmeNm>
                <Cd>ACC</Cd>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
      </InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>7421w6f13a01983593e8dffb71fa6d15</PmtInfId> <!-- Идентификатор ведомости -->
      <PmtMtd>DD</PmtMtd> <!-- Константа -->
      <NbOfTxs>1</NbOfTxs> <!-- Номер Реестра -->
      <ReqdColltnDt>2022-03-30</ReqdColltnDt> <!-- Дата Реестра -->
      <Cdtr>
        <Nm>00753Z</Nm> <!-- Номер Договора -->
      </Cdtr>
      <CdtrAcct>
        <Id>
          <Othr>
            <Id>01</Id> <!-- Вид Зачисления -->
          </Othr>
        </Id>
      </CdtrAcct>
      <CdtrAgt>
        <FinInstnId>
          <Nm>044525593</Nm> <!-- БИК -->
        </FinInstnId>
      </CdtrAgt>
      <DrctDbtTxInf>
        <PmtId>
          <InstrId>1</InstrId>  <!-- Номер строки ведомости -->
          <EndToEndId>7421w6f13a01983593e8dffb71fa6d15</EndToEndId> <!-- Идентификатор строки ведомости -->
        </PmtId>
        <InstdAmt Ccy="RUB">100.00</InstdAmt> <!-- Код Валюты + Сумма -->
        <DbtrAgt>
          <FinInstnId>
            <Nm>0000</Nm> <!-- Отделение Банка -->
            <Othr>
              <Id>0000</Id> <!-- Филиал Отделения Банка -->
            </Othr>
          </FinInstnId>
        </DbtrAgt>
        <Dbtr>
          <PstlAdr>
            <!-- Фамилия сотрудника -->
            <Dept>Матросова</Dept>
            <!-- Имя сотрудника -->
            <SubDept>Алина</SubDept>
            <!-- Отчество сотрудника -->
            <StrtNm>Николаевна</StrtNm>
          </PstlAdr>
        </Dbtr>
        <DbtrAcct>
          <Id>
            <Othr>
              <Id>40817810904980000006</Id> <!-- Лицевой Счет -->
            </Othr>
          </Id>
        </DbtrAcct>
      </DrctDbtTxInf>
      <DrctDbtTxInf>
        <PmtId>
          <InstrId>2</InstrId>  <!-- Номер строки ведомости -->
          <EndToEndId>7421w6f13a01983593e8dffb71fa6d16</EndToEndId> <!-- Идентификатор строки ведомости -->
        </PmtId>
        <InstdAmt Ccy="RUB">100.00</InstdAmt> <!-- Код Валюты + Сумма -->
        <DbtrAgt>
          <FinInstnId>
            <Nm>0000</Nm> <!-- Отделение Банка -->
            <Othr>
              <Id>0000</Id> <!-- Филиал Отделения Банка -->
            </Othr>
          </FinInstnId>
        </DbtrAgt>
        <Dbtr>
           <PstlAdr>
            <!-- Фамилия сотрудника -->
            <Dept>Печкин</Dept>
            <!-- Имя сотрудника -->
            <SubDept>Евгений</SubDept>
            <!-- Отчество сотрудника -->
            <StrtNm>Алексеевич</StrtNm>
          </PstlAdr>
        </Dbtr>
        <DbtrAcct>
          <Id>
            <Othr>
              <Id>40817810504980000011</Id> <!-- Лицевой Счет -->
            </Othr>
          </Id>
        </DbtrAcct>
      </DrctDbtTxInf>
    </PmtInf>
    <SplmtryData>
      <Envlp>
        <SgntrSt>
        </SgntrSt>
      </Envlp>
    </SplmtryData>
  </CstmrDrctDbtInitn>
</Document>

26. Заявка на открытие лицевых счетов

URI

POST: /API/v1/ISO20022/EmployeeAccount

XSD схема

acmt.007.001.04

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

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

Общий путь Document.AcctOpngReq

1

R

Идентификатор сообщения (заявки на открытие ЛС)

MsgId.Id

2

R

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

Refs.MsgId.CreDtTm

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

3

R

Номер реестра

Refs.PrcId.Id

Макс. длина 11 цифр

4

R

Дата реестра

Refs.PrcId.CreDtTm

5

R

Валюта зарплаты

Acct.Cсy

6

R

Номер ЗП договора

AcctSvcrId.FinInstnId.ClrSysMmbId.MmbId

7

R

БИК

AcctSvcrId.FinInstnId.Othr.Id

8

R

Константа БИК

AcctSvcrId.FinInstnId.Othr.Issr

Указывается константа "BIC"

9

R

Наименование организации

Org.FullLglNm

Макс. длина 160 символов

10

R

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

Org.CtryOfOpr

11

R

Адрес организации

Org.LglAdr.AdrLine

Макс. длина 70 символов. Остальные символы обрезаются

12

R

ИНН для выбранной организации в заявке на открытие лицевого счета

Org.OrgId.Othr[1].Id

13

R

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

Org.OrgId.Othr[1].SchmeNm.Cd

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

14

R

Расчетный счет для выбранного зарплатного проекта в заявке на открытие лицевого счета

Org.OrgId.Othr[2].Id

15

R

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

Org.OrgId.Othr[2].SchmeNm.Cd

Костанта "ACC"

16

R

Количество строк в заявке на открытие лицевого счета

RefAcct.Nm

Макс. длина 7 цифр

Общий путь Document.AcctOpngReq.SplmtryData.Envlp.EmplInfo.Empl (по одному блоку Empl на сотрудника)

17

R

Идентификатор строки заявки на открытие ЛС для одного сотрудника

EmNum

Макс. длина 7 цифр. Нумерация начинается с единицы должна идти строго по порядку (1,2,3…​).

18

R

Фамилия сотрудника

LstNm

Макс. длина 30 символов

19

R

Имя сотрудника

FstNm

Макс. длина 30 символов

20

O

Отчество сотрудника

MdlNm

Макс. длина 30 символов

21

R

Отделение банка

BnkBrch

Список кодов отделений можно найти на странице https://alfabank.ru/sme/salaryproject/
Раздел "Полезно знать", вкладка "Управление зарплатным проектом", подраздел "Открытие счетов и выпуск зарплатных карт для сотрудников резидентов РФ", п.5 "Справочник отделений"
Скачать XLS файл, в нём таблица "Отделение доставки карты", столбец - "Цифровой код"
XLS файл периодически обновляется, рекомендуется проверять обновления раз в полгода
Макс. длина 4 цифры

22

R

Вид документа, удостоверяющего личность сотрудника

IdentityDoc.DocTp

Текстовое описание вида документа, например "Паспорт гражданина РФ". Макс. длина 75 символов

23

R

Серия документа

IdentityDoc.DocSr

Макс. 14 символов, для паспорта РФ допустимы варианты 4 цифры с пробелом и без (0000 и 00 00)

24

R

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

IdentityDoc.DocNmb

Макс. длина 14 символов

25

R

Дата выдачи документа

IdentityDoc.DocStartDate

26

R

Кем выдан документ

IdentityDoc.DocBy

Макс. длина 250 символов

27

R

Код подразделения

IdentityDoc.DocCd

Макс. длина 10 символов

28

R

Код вида документа

IdentityDoc.DocTpCd

Код вида документа по классификатору ФНС ПРИКАЗ от 13.10.2006 г. N САЭ-3-04/706 "ОБ УТВЕРЖДЕНИИ ФОРМЫ СВЕДЕНИЙ О ДОХОДАХ ФИЗИЧЕСКИХ ЛИЦ". Макс. длина 2 символа

29

R

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

BrsDate

30

R

Пол

Sex

M - мужской / F - женский

31

O

Должность

Pstn

Макс. длина 100 символов

32

O

Регион места рождения (полное)

BrthPlc.Reg.Nm

Необходимо указать как минимум один из тегов <Reg>, <City>, <Loc>, <Dist>. Макс. длина 45 символов

33

O

Регион места рождения (сокращение)

BrthPlc.Reg.NmShrt

Макс. длина 10 символов

34

O

Район места рождения (полное)

BrthPlc.Dist.Nm

Необходимо указать как минимум один из тегов <Reg>, <City>, <Loc>, <Dist>. Макс. длина 45 символов

35

O

Район места рождения (сокращение)

BrthPlc.Dist.NmShrt

Макс. длина 10 символов

36

O

Город места рождения (полное)

BrthPlc.City.Nm

Необходимо указать как минимум один из тегов <Reg>, <City>, <Loc>, <Dist>. Макс. длина 50 символов

37

O

Город места рождения (сокращение)

BrthPlc.City.NmShrt

Макс. длина 10 символов

38

O

Населённый пункт места рождения (полное)

BrthPlc.Loc.Nm

Необходимо указать как минимум один из тегов <Reg>, <City>, <Loc>, <Dist>. Макс. длина 50 символов

39

O

Населённый пункт места рождения (сокращение)

BrthPlc.Loc.NmShrt

Макс. длина 10 символов

Поле Эмбоссированный текст содержит имя сотрудника на зарплатной карте. Разделяется на три поля, третье может отсутствовать. Примеры заполнения: TATIANA M/IVANOVA или TANIA/IVANOVA/MRS

40

R

Эмбосированный текст Поле 1

Embsdtxt.Fld1

Макс. длина 25 символов

41

R

Эмбосированный текст Поле 2

Embsdtxt.Fld2

Макс. длина 25 символов

42

O

Эмбосированный текст Поле 3

Embsdtxt.Fld3

Макс. длина 25 символов

43

R

Код валюты зарплаты

CCy

Код валюты, в которой зачисляется зарплата. Код валюты российского рубля "643"

44

R

Резидент

Rsdnt

true - для резидентов. Иначе false

45

R

Гражданство сотрудника

CntrOrig

Макс. длина 64 символа

46

R

Мобильный телефон

Phone

10 цифр без указания кода страны, например: 9777777777

47

O

Табельный номер сотрудника в организации

EmpIdNumr

Макс. длина 255 символов

48

O

Дата оформления

EmpDt

49

O

Сумма заработной платы

SlryAmt

Размер заработной платы сотрудника организации в месяц, на момент формирования реестра. Без учета периодических премий.

50

O

Дата выплаты

PayDt

День выплаты заработной платы сотруднику организации (дата выплаты основной части зарплаты)

51

O

Контактный номер мобильного телефона

CtPhNmb

10 цифр без указания кода страны, например: 9777777777

Пример Заявки на открытие лицевых счетов с подписью
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:acmt.007.001.04" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <AcctOpngReq>
        <Refs>
            <MsgId>
                <Id>TEST_MSG_2022-06-06-1716303</Id> <!-- ИД сообщения -->
                <CreDtTm>2022-06-06T17:16:30.307</CreDtTm> <!-- Дата документа -->
            </MsgId>
            <PrcId>
                <Id>30307</Id> <!-- Номер реестра -->
                <CreDtTm>2022-06-06T17:16:30.307</CreDtTm> <!-- Дата реестра -->
            </PrcId>
        </Refs>
        <Acct>
            <Ccy>RUB</Ccy> <!-- Валюта зарплаты (неисп.) -->
        </Acct>
        <AcctSvcrId>
            <FinInstnId>
                <ClrSysMmbId>
                    <MmbId>00753Z</MmbId> <!-- Номер ЗП договора -->
                </ClrSysMmbId>
                <Othr>
                    <Id>044525593</Id> <!-- БИК -->
                    <Issr>BIC</Issr> <!-- Константа БИК -->
                </Othr>
            </FinInstnId>
        </AcctSvcrId>
        <Org>
            <FullLglNm>Общество с ограниченной ответственностью "Тест Альфа-Линк ЗУП"</FullLglNm> <!-- Наименование организации -->
            <CtryOfOpr>RU</CtryOfOpr> <!-- Страна организации (неисп.) -->
            <LglAdr>
                <AdrLine>Москва</AdrLine> <!-- Адрес организации (неисп.) -->
            </LglAdr>
            <OrgId>
                <Othr>
                    <Id>0664010623</Id> <!-- ИНН -->
                    <SchmeNm>
                        <Cd>TXID</Cd> <!-- Константа ИНН -->
                    </SchmeNm>
                </Othr>
                <Othr>
                    <Id>40702810800000000111</Id> <!-- Счёт -->
                    <SchmeNm>
                        <Cd>ACC</Cd> <!-- Константа счёта -->
                    </SchmeNm>
                </Othr>
            </OrgId>
        </Org>
        <RefAcct>
            <Nm>1</Nm> <!-- Кол-во строк -->
        </RefAcct>
        <SplmtryData>
            <Envlp>
                <EmplInfo>
                    <Empl>
                        <EmNum>1</EmNum> <!-- НПП Сотрудника -->
                        <LstNm>Рермантов</LstNm> <!-- Фамилия сотрудника -->
                        <FstNm>Иван</FstNm> <!-- Имя сотрудника -->
                        <MdlNm>Иванович</MdlNm>  <!-- Отчество сотрудника -->
                        <BnkBrch>0410</BnkBrch> <!-- Отделение банка -->
                        <IdentityDoc>
                            <DocTp>Паспорт гражданина РФ</DocTp> <!-- Вид документа -->
                            <DocSr>30 30</DocSr> <!-- Серия паспорта -->
                            <DocNmb>223070</DocNmb> <!-- Номер паспорта -->
                            <DocStartDate>2018-04-23</DocStartDate> <!-- Дата выдачи паспорта -->
                            <DocBy>Отделом УФМС России по г. Краснодар</DocBy> <!-- Кем выдан паспорт -->
                            <DocCd>920-491</DocCd> <!-- Код подразделения -->
                            <DocTpCd>21</DocTpCd> <!-- Код вида документа -->
                        </IdentityDoc>
                        <BrsDate>1984-06-26</BrsDate> <!-- Дата рождения сотрудника -->
                        <Sex>M</Sex>  <!-- Пол -->
                        <Pstn>Бухгалтер</Pstn> <!-- Должность -->
                        <BrthPlc>
                            <Loc>
                                <Nm>Новобратцевский</Nm> <!-- Населённый пункт места рождения (полное) -->
                            </Loc>
                        </BrthPlc>
                        <Embsdtxt>
                            <Fld1>IVAN</Fld1> <!-- Эмбосированный текст.Поле1 -->
                            <Fld2>RERMONTOV</Fld2> <!-- Эмбосированный текст.Поле 2 -->
                            <Fld3>MR</Fld3> <!-- Эмбосированный текст.Поле 3 -->
                        </Embsdtxt>
                        <CСy>643</CСy> <!-- Код валюты -->
                        <Rsdnt>true</Rsdnt> <!-- Резидент -->
                        <CntrOrig>РОССИЯ</CntrOrig> <!-- Гражданство -->
                        <Phone>9060630307</Phone> <!-- Мобильный телефон -->
                        <EmpIdNumr>0000-30307</EmpIdNumr> <!-- Табельный номер сотрудника -->
                        <EmpDt>2022-04-05</EmpDt> <!-- Дата оформления -->
                        <SlryAmt>1.00</SlryAmt> <!-- Сумма заработной платы -->
                        <PayDt>2022-01-05</PayDt> <!-- Дата выплаты -->
                        <CtPhNmb>9060630307</CtPhNmb> <!-- Контактный номер мобильного телефона -->
                    </Empl>
                </EmplInfo>
            </Envlp>
        </SplmtryData>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="sigID1"><ds:SignedInfo><ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/><ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/><ds:Reference URI=""><ds:Transforms><ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></ds:Transforms><ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/><ds:DigestValue>+4eNxy3qqylP7Njmt+UHeKnEI4jh6z2BJaUVacN8TrA=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue>yG3sOT7KgEDCe9mjMdefFMMsaGV1ipLkx13IMzuztqYiWHOXeOo1BqqaFluEGx7cQSXAb8sQlhivXTBXNwE8fg==</ds:SignatureValue><ds:KeyInfo><ds:X509Data><ds:X509Certificate>MIIJAzCCCLCgAwIBAgIRBTd/twDprFm+QYXHcVcbqLQwCgYIKoUDBwEBAwIwggELMRgwFgYFKoUDZAESDTEwMjc3MDAwNjczMjgxGjAYBggqhQMDgQMBARIMMDA3NzI4MTY4OTcxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxKjAoBgNVBAkMIdCj0LsuINCa0LDQu9Cw0L3Rh9C10LLRgdC60LDRjyAyNzEPMA0GA1UECwwG0KPQmNCRMSEwHwYDVQQKDBjQkNCeINCQ0JvQrNCk0JAt0JHQkNCd0JoxNTAzBgNVBAMMLNCi0JXQodCiINCj0KYgMi4wINCQ0J4gItCQ0JvQrNCk0JAt0JHQkNCd0JoiMB4XDTIxMDMxMjEwNTgwNloXDTIyMDYxMjExMDgwNlowggH5MTIwMAYDVQQqDCnQodC10YDRgtC40YTQuNC60LDRgiDQodC+0YLRgNGD0LTQvdC40LrQsDEZMBcGA1UEBAwQ0KLQtdGB0YLQvtCy0YvQuTFJMEcGA1UECQxAMTA3MDc4LCDQsy4g0JzQvtGB0LrQstCwLCDRg9C7LiDQmtCw0LvQsNC90YfQtdCy0YHQutCw0Y8sINC0LiAyNzEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODE0MDIGA1UEDAwr0JDRgNGF0LjRgtC10LrRgtC+0YAg0L3QsNC/0YDQsNCy0LvQtdC90LjRjzEmMCQGCSqGSIb3DQEJARYXdmJ1cm1pc3Ryb3ZAYWxmYWJhbmsucnUxCzAJBgNVBAYTAlJVMRUwEwYDVQQIDAzQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEjMCEGA1UECgwa0JDQniAi0JDQu9GM0YTQsC3QkdCw0L3QuiIxUDBOBgNVBAsMR9CU0LjRgNC10LrRhtC40Y8g0YDQsNC30YDQsNCx0L7RgtC60Lgg0YbQuNGE0YDQvtCy0YvRhSDRgdC10YDQstC40YHQvtCyMRcwFQYDVQQDDA4xdHJ1c3Rjb3JlLTI1NjBmMB8GCCqFAwcBAQEBMBMGByqFAwICJAAGCCqFAwcBAQICA0MABEA8fBN/QZKE4T03YEHTMTldxRHPF/SdYGSPFEmUMGlrEuLFycdkDBxSFTaFfewyYVTDpJ53/1JGp60sKVFvyvIxo4IE9DCCBPAwDgYDVR0PAQH/BAQDAgOoMB8GCSsGAQQBgjcVBwQSMBAGCCqFAwICLgAIAgEBAgEAMB0GA1UdDgQWBBSXVVvUtLRiPz8231/48DKMZsLbVDAdBgNVHSUEFjAUBggrBgEFBQcDAgYIKwYBBQUHAwQwJwYJKwYBBAGCNxUKBBowGDAKBggrBgEFBQcDAjAKBggrBgEFBQcDBDBxBggrBgEFBQcBAQRlMGMwYQYIKwYBBQUHMAKGVWh0dHA6Ly90ZXN0LXVjMi5tb3Njb3cuYWxmYWludHJhLm5ldC9haWEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcnQwHQYDVR0gBBYwFDAIBgYqhQNkcQEwCAYGKoUDZHECMIIBQwYFKoUDZHAEggE4MIIBNAw00KHQmtCX0JggItCa0YDQuNC/0YLQvtCf0YDQviBDU1AiICjQstC10YDRgdC40Y8gNC4wKQxa0J/QkNCaICLQo9C00L7RgdGC0L7QstC10YDRj9GO0YnQuNC5INGG0LXQvdGC0YAgItCa0YDQuNC/0YLQvtCf0YDQviDQo9CmIiDQstC10YDRgdC40LggMi4wDE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI0LTMwMTAg0L7RgiAzMC4xMi4yMDE2DE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI4LTI5ODMg0L7RgiAxOC4xMS4yMDE2MD8GBSqFA2RvBDYMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQuMCkwgb0GA1UdHwSBtTCBsjBboFmgV4ZVaHR0cDovL3Rlc3QtdWMyLm1vc2Nvdy5hbGZhaW50cmEubmV0L2NkcC82ZjBiMGQ1MjVkMTlhNzQ4YmUwNTE4OTM5N2Q4MDk1NTdkMzg4Y2EyLmNybDBToFGgT4ZNaHR0cDovL2NhLmFsZmFpbnRyYS5uZXQvY2VydGRhdGEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcmwwggFNBgNVHSMEggFEMIIBQIAUbwsNUl0Zp0i+BRiTl9gJVX04jKKhggETpIIBDzCCAQsxGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEqMCgGA1UECQwh0KPQuy4g0JrQsNC70LDQvdGH0LXQstGB0LrQsNGPIDI3MQ8wDQYDVQQLDAbQo9CY0JExITAfBgNVBAoMGNCQ0J4g0JDQm9Cs0KTQkC3QkdCQ0J3QmjE1MDMGA1UEAwws0KLQldCh0KIg0KPQpiAyLjAg0JDQniAi0JDQm9Cs0KTQkC3QkdCQ0J3QmiKCEQWXkJ8A26z9j0tjSIs3FfK5MCsGA1UdEAQkMCKADzIwMjEwMzEyMTA1ODA1WoEPMjAyMjA2MTIxMDU4MDVaMAoGCCqFAwcBAQMCA0EAHvrxKAto/T3htcx89MTL17HjVlLFJMt1rjCg2lg1jhUof6rY4FVArNEOsIRWxhwG8hV8j3rhl15wvpTgmOTvLg==</ds:X509Certificate></ds:X509Data></ds:KeyInfo></ds:Signature></SgntrSt>
            </Envlp>
        </SplmtryData>
    </AcctOpngReq>
</Document>

Ответ

Ответом является XML-документ, соответствующий схеме acmt.014.001.04.

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

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

200

OK

-

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

403

Err

User is disabled

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

401

Err

Signer is not allowed to sign this operation type

Пользователь не имеет право подписывать документы такого типа

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

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

27. Ведомость банковского контроля

Метод предоставляет возможность запросить список ведомостей банковского контроля (далее ВБК) по уникальным номерам контракта (далее УНК) компании. Сформированные ведомости добавляются в единый архив для последующего скачивания.

Термины и определения

ВБК - Ведомость банковского контроля
УНК - Уникальный номер контракта (валютного договора) между двумя участниками импортной сделки
ТБСВК - Таможенно-банковская система валютного контроля, Сторонний сервис, в котором находится информация по контрактам компаний и где непосредственно формируются Ведомости Банковского Контроля.

Требования к Уникальному номеру контракта

1) Количество контрактов в запросе, по которым можно сформировать ВБК, не должно превышать 100;

2) Значение УНК регламентируется Инструкцией Банка России от 16.08.2017 N 181-И (ред. от 05.07.2018) «О порядке представления резидентами и нерезидентами уполномоченным банкам подтверждающих документов и информации при осуществлении валютных операций, о единых формах учета и отчетности по валютным операциям, порядке и сроках их представления» (Зарегистрировано в Минюсте России 31.10.2017 N 48749).

Если значение УНК не отвечает требованиям Инструкции, то невалидному УНК ставится статус "Отклонено" (RJCT) с текстом ошибки UNK mustn’t be empty and must have only digits filled in accordance with the law , сам запрос с остальными валидными УНК будут обрабатываться дальше.

3) Каждый контракт должен находится в системе ТБСВК (быть поставлен на учет и принадлежать компании);

Если хотя бы по одному из 100 УНК не будет выполняться условие выше, то обработка всего запроса останавливается, всему запросу, а также каждой записи с УНК проставляется статус "Отклонено" (RJCT);

Сформированный архив будет доступен для скачивания в течение суток, если запрос на скачивание архива сделать позже этого срока - необходимо будет запросить формирование архива ВБК заново.

URI

POST: /API/v1/ISO20022/ContractReports

XSD схема

auth.026.001.01

Описание схемы запроса

N Обязательность Описание Путь Комментарий/Пример

Document.CcyCtrlReqOrLttr.GrpHdr

1

R

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

MsgId

-

2

R

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

CreDtTm

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

3

R

Количество УНК в сообщении

NbOfItms

Кол-во блоков ReqOrLttr, каждый из которых содержит конкретный УНК.

4

R

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

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

-

5

R

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

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

Константа TXID

6

R

ОГРН организации отправителя сообщения

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

-

7

R

Признак использования ОГРН

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

Константа PSRN

Document.CcyCtrlReqOrLttr.ReqOrLttr - массив объектов для каждого передаваемого УНК

8

R

Уникальный ID запроса на формирование ВБК по Уникальному номеру контракта (далее УНК)

ReqOrLttrId

-

9

R

Тип запрашиваемого документа.

Sbjt

Константа VBK

10

R

Формат файла ВБК

Tp

Возможные значения: ["XML", "PDF"]

11

R

УНК, по которому будет сформирована ВБК

Desc

-

12

R

Данное поле не используется, но обязательно по схеме. Признак необходимости предоставления ответа на запрос.

RspnReqrd

Константа true

Пример запроса на формирование архива со списком ВБК
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01">
    <CcyCtrlReqOrLttr>
        <GrpHdr>
            <!-- Уникальный ID сообщения-->
            <MsgId>TEST_MSG_2022-08-23-279190544</MsgId>
            <!-- Дата и время создания сообщения -->
            <CreDtTm>2022-08-23T12:44:40.624</CreDtTm>
            <!--Неиспользуемое поле -->
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Pty>
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!--ИНН организации (Идентификация отправителя запроса) -->
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <!--Признак использования ИНН -->
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                            <Othr>
                                <!--ОГРН организации отправителя сообщения -->
                                <Id>1092940217001</Id>
                                <SchmeNm>
                                    <!--Признак использования ОГРН -->
                                    <Cd>PSRN</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Pty>
            </InitgPty>
        </GrpHdr>
        <!-- 1я из 100 возможных запись с контрактом, по которому нужно сформировать ВБК -->
        <ReqOrLttr>
            <!--Уникальный ID записи с контрактом -->
            <ReqOrLttrId>TEST_ID_2022-08-23-2791905441</ReqOrLttrId>
            <!--Тип документа, по которому формируется ВБК-->
            <Sbjt>VBK</Sbjt>
            <!--Тип документа, по которому формируется ВБК-->
            <Tp>PDF</Tp>
            <!--Уникальный номер контракта, по которому нужно сформировать ВБК-->
            <Desc>22080758/1326/0000/1/1</Desc>
            <!--Признак необходимости предоставления ответа на запрос-->
            <RspnReqrd>true</RspnReqrd>
        </ReqOrLttr>
        <!-- 2я из 100 возможных запись с контрактом, по которому нужно сформировать ВБК -->
        <ReqOrLttr>
            <!--Уникальный ID записи контракта -->
            <ReqOrLttrId>TEST_ID_2022-08-23-2791905442</ReqOrLttrId>
            <!--Тип документа, по которому формируется ВБК-->
            <Sbjt>VBK</Sbjt>
            <!--Тип документа, по которому формируется ВБК-->
            <Tp>PDF</Tp>
            <!--Уникальный номер контракта, по которому нужно сформировать ВБК-->
            <Desc>22080915/1326/0000/1/1</Desc>
            <!--Признак необходимости предоставления ответа на запрос-->
            <RspnReqrd>true</RspnReqrd>
        </ReqOrLttr>
        <SplmtryData>
            <Envlp>
                <!--Блок для вставки подписи-->
                <SgntrSt/>
            </Envlp>
        </SplmtryData>
    </CcyCtrlReqOrLttr>
</Document>

Ответ

Ответом является XML-документ, соответствующий схеме auth.027.001.01. Описание параметров ответа доступно в разделе Описание схемы ответа.

В разделе Статусы Ведомости банковского контроля доступно описание статусов.

Пример ответа на запрос с успешно пройденными проверками
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
  <CcyCtrlStsAdvc>
    <GrpHdr>
      <!-- Уникальный ID сообщения-->
      <MsgId>c342c72069784594adb34ae362643742</MsgId>
      <!-- Дата и время создания сообщения -->
      <CreDtTm>2022-08-23T15:45:01.819+03:00</CreDtTm>
      <!--Количество блоков ReqOrLttr в исходном сообщении -->
      <NbOfItms>1</NbOfItms>
       <RegnAgt>
                <FinInstnId>
                    <!-- SWIFT код банка -->
                    <BICFI>ALFARUMM</BICFI>
                    <ClrSysMmbId>
                     <!-- БИК Банка  -->
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </RegnAgt>
    </GrpHdr>
    <GrpSts>
      <OrgnlRefs>
        <!-- Уникальный ID исходного сообщения с запросом-->
        <OrgnlMsgId>TEST_MSG_2022-08-23-279190544</OrgnlMsgId>
        <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
        <!-- Дата и время исходного сообщения с запросом -->
        <OrgnlCreDtTm>2022-08-23T15:44:40.624+03:00</OrgnlCreDtTm>
      </OrgnlRefs>
      <RptgPty>
                <PtyId>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- БИК Банка  -->
                                <Id>044525593</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
            </RptgPty>
      <RegnAgt>
        <FinInstnId>
          <!-- SWIFT код банка -->
          <BICFI>ALFARUMM</BICFI>
        </FinInstnId>
      </RegnAgt>
      <!-- Статус обработки всего сообщения -->
        <Sts>RCVD</Sts>
    </GrpSts>
    <PackgSts>
      <!-- Неиспользуемое поле -->
      <PackgId>undefined</PackgId>
      <!--Статус обработки всего сообщения (дублирует статус GrpSts.Sts) -->
      <Sts>RCVD</Sts>
      <!-- 1я Запись с контрактом, по которому нужно сформировать ВБК -->
      <RcrdSts>
        <!--Уникальный ID записи контракта -->
        <RcrdId>TEST_ID_2022-08-23-2791905441</RcrdId>
        <!--Статус обработки ВБК, соответствующей записи с контрактом -->
        <Sts>RCVD</Sts>
      </RcrdSts>
      <!-- 2я Запись с контрактом, по которому нужно сформировать ВБК -->
      <RcrdSts>
        <RcrdId>TEST_ID_2022-08-23-2791905442</RcrdId>
        <!--Статус обработки ВБК, соответствующей записи с контрактом -->
        <Sts>RCVD</Sts>
      </RcrdSts>
    </PackgSts>
  </CcyCtrlStsAdvc>
</Document>
Пример ответа на запрос с ошибками
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
    <CcyCtrlStsAdvc>
        <GrpHdr>
            <!-- Уникальный ID сообщения-->
            <MsgId>96009149ae5e4794b700173ef32295d0</MsgId>
            <!-- Дата и время создания сообщения -->
            <CreDtTm>2022-08-29T10:46:28.209+03:00</CreDtTm>
            <!--Количество блоков ReqOrLttr в исходном сообщении -->
            <NbOfItms>1</NbOfItms>
            <RcvgPty/>
            <RegnAgt>
                <FinInstnId>
                    <!-- SWIFT код банка -->
                    <BICFI>ALFARUMM</BICFI>
                    <ClrSysMmbId>
                        <!-- БИК Банка  -->
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </RegnAgt>
        </GrpHdr>
        <GrpSts>
            <OrgnlRefs>
                <!-- Уникальный ID исходного сообщения с запросом-->
                <OrgnlMsgId>TEST_MSG_2022-08-29-604177661</OrgnlMsgId>
                <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
                <!-- Дата и время исходного сообщения с запросом -->
                <OrgnlCreDtTm>2022-08-29T10:46:06.663+03:00</OrgnlCreDtTm>
            </OrgnlRefs>
            <RptgPty>
                <PtyId>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- БИК Банка  -->
                                <Id>044525593</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <!-- SWIFT код банка -->
                    <BICFI>ALFARUMM</BICFI>
                </FinInstnId>
            </RegnAgt>
            <!-- Статус обработки всего сообщения -->
            <Sts>RJCT</Sts>
            <StsRsn>
                <Rsn>
                    <!-- Код причины ошибки в ISO  -->
                    <Cd>NARR</Cd>
                </Rsn>
                <!-- Описание причины присвоения статуса сообщения-->
                <AddtlInf>The number of documents is more than the maximum allowed. Allowed 100. Passed 101</AddtlInf>
            </StsRsn>
        </GrpSts>
    </CcyCtrlStsAdvc>
</Document>

HTTP статусы ответов от сервиса Ведомость банковского контроля

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

200

OK

-

Если хотя бы один УНК в запросе валиден, то запрос на формирование архива со списком ВБК может быть принят в обработку.
Для невалидного УНК в массиве ответа вернется статус "Отклонено" (RJCT) и ошибка UNK mustn’t be empty and must have only digits filled in accordance with the law

400

Err

The № DP/UC is incorrect or DP has been archived

Если хотя бы один УНК отсутствует в базе ТБСВК или не принадлежит компании, то всему запросу и каждому элементу массива ReqOrLttr будут присвоены статусы "RJCT" с текстом ошибки: Номер УНК/ПС указан неверно или ПС, закрытые до 01.10.2012 в ТБСВК не хранятся и к поиску и формированию из ТБСВК недоступны

400

Err

All entities in the message <MsgId> are rejected

Если все переданные значения УНК - невалидны, то всему запросу и каждому элементу массива ReqOrLttr будут присвоены статусы "RJCT".

400

Err

The number of documents is more than the maximum allowed. Allowed 100. Passed 101

Если количество УНК превышает 100

400

Err

INN mustn’t be empty and must have 10 or 12 digits

Ошибка в переданных данных компании: ИНН

400

Err

OGRN mustn’t be empty and must have 13 or 15 digits

Ошибка в переданных данных компании: ОГРН

400

Err

Error in parameters

Ошибка в параметрах запроса

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

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

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

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

403

Err

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

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

406

Err

Signature is missing

Нет подписи

403

Err

Certificate is not valid

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

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

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

500

Err

Internal Error

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

28. Статус обработки архива с Ведомостями банковского контроля

URI

Получение статуса обработки запроса на формирование архива со списком ВБК

GET: /API/v1/ISO20022/ContractReports/<MsgId>

Ответ

Ответом является XML-документ, соответствующий схеме auth.027.001.01. Описание параметров ответа доступно в разделе Описание схемы ответа.

В разделе Статусы Ведомости банковского контроля доступно описание статусов.

В разделе HTTP статусы ответов от сервиса Ведомость банковского контроля доступен список кодов ошибок с описанием.

Проверка значений УНК (см. Требования к Уникальному номеру контракта) происходит в два этапа:
1) Сначала проверяется само значение УНК на соответствие Инструкции Банка России. Если в значении найдена ошибка, то невалидному УНК проставляется статус "Отклонено" (RJCT), а запрос с оставшимися валидными УНК обрабатывается дальше.
2) Далее список УНК передается системе ТБСВК, где проверяется наличие данных по компании для них. Если данные не найдены хотя бы по одному УНК, то всему запросу и каждому УНК в нем проставляется статус "Отклонено" (RJCT).

Ответ для успешно обработанного запроса

Пример ответа с успешным статусом обработки
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
  <CcyCtrlStsAdvc>
    <GrpHdr>
      <!-- Уникальный ID сообщения-->
      <MsgId>02aec2645110423b8aa074d1414e61cf</MsgId>
      <!-- Дата и время создания сообщения -->
      <CreDtTm>2022-08-23T15:45:01.819+03:00</CreDtTm>
      <!--Количество блоков ReqOrLttr в исходном сообщении -->
      <NbOfItms>1</NbOfItms>
      <RegnAgt>
        <FinInstnId>
          <!-- SWIFT код банка -->
          <BICFI>ALFARUMM</BICFI>
          <ClrSysMmbId>
            <!-- БИК Банка  -->
            <MmbId>044525593</MmbId>
          </ClrSysMmbId>
        </FinInstnId>
      </RegnAgt>
    </GrpHdr>
    <GrpSts>
      <OrgnlRefs>
        <!-- Уникальный ID исходного сообщения с запросом-->
        <OrgnlMsgId>TEST_MSG_2022-08-23-279190544</OrgnlMsgId>
        <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
        <!-- Дата и время исходного сообщения с запросом -->
        <OrgnlCreDtTm>2022-08-23T15:44:40.624+03:00</OrgnlCreDtTm>
      </OrgnlRefs>
      <RptgPty>
        <PtyId>
          <Id>
            <OrgId>
              <Othr>
                <!-- БИК Банка  -->
                <Id>044525593</Id>
              </Othr>
            </OrgId>
          </Id>
        </PtyId>
      </RptgPty>
      <RegnAgt>
        <FinInstnId>
          <!-- SWIFT код банка -->
          <BICFI>ALFARUMM</BICFI>
        </FinInstnId>
      </RegnAgt>
      <!-- Статус обработки всего сообщения -->
      <Sts>ACPT</Sts>
    </GrpSts>
    <PackgSts>
      <!-- Неиспользуемое поле -->
      <PackgId>undefined</PackgId>
      <!--Статус обработки всего сообщения (дублирует статус GrpSts.Sts) -->
        <Sts>ACPT</Sts>
      <!-- 1я Запись с контрактом, по которому нужно сформировать ВБК -->
      <RcrdSts>
        <!--Уникальный ID записи контракта -->
        <RcrdId>TEST_ID_2022-08-23-2791905441</RcrdId>
        <!--Статус обработки ВБК, соответствующей записи с контрактом -->
        <Sts>ACPT</Sts>
      </RcrdSts>
      <!-- 2я Запись с контрактом, по которому нужно сформировать ВБК -->
      <RcrdSts>
        <!--Уникальный ID записи контракта -->
        <RcrdId>TEST_ID_2022-08-23-2791905442</RcrdId>
        <!--Статус обработки ВБК, соответствующей записи с контрактом -->
       <Sts>ACPT</Sts>
      </RcrdSts>
    </PackgSts>
  </CcyCtrlStsAdvc>
</Document>

Ответ для неуспешной обработки запроса

Пример ответа с текстом ошибки в запросе
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
  <CcyCtrlStsAdvc>
    <GrpHdr>
      <!-- Уникальный ID сообщения-->
      <MsgId>02aec2645110423b8aa074d1414e61cf</MsgId>
      <!-- Дата и время создания сообщения -->
      <CreDtTm>2022-08-23T15:45:01.819+03:00</CreDtTm>
      <!--Количество блоков ReqOrLttr в исходном сообщении -->
      <NbOfItms>1</NbOfItms>
      <RegnAgt>
        <FinInstnId>
          <!-- SWIFT код банка -->
          <BICFI>ALFARUMM</BICFI>
          <ClrSysMmbId>
            <!-- БИК Банка  -->
            <MmbId>044525593</MmbId>
          </ClrSysMmbId>
        </FinInstnId>
      </RegnAgt>
    </GrpHdr>
    <GrpSts>
      <OrgnlRefs>
        <!-- Уникальный ID исходного сообщения с запросом-->
        <OrgnlMsgId>TEST_MSG_2022-08-23-279190544</OrgnlMsgId>
        <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
        <!-- Дата и время исходного сообщения с запросом -->
        <OrgnlCreDtTm>2022-08-23T15:44:40.624+03:00</OrgnlCreDtTm>
      </OrgnlRefs>
      <RptgPty>
        <PtyId>
          <Id>
            <OrgId>
              <Othr>
                <!-- БИК Банка  -->
                <Id>044525593</Id>
              </Othr>
            </OrgId>
          </Id>
        </PtyId>
      </RptgPty>
      <RegnAgt>
        <FinInstnId>
          <!-- SWIFT код банка -->
          <BICFI>ALFARUMM</BICFI>
        </FinInstnId>
      </RegnAgt>
      <!-- Статус обработки всего сообщения -->
      <Sts>RJCT</Sts>
      <StsRsn>
        <Rsn>
          <Cd>NARR</Cd>
        </Rsn>
        <AddtlInf>Ошибка в параметрах запроса: RUS: Номер УНК/ПС указан неверно или  ПС, закрытые до 01.10.2012 в ТБСВК не хранятся и к поиску и формированию из ТБСВК недоступны / ENG: The № DP/UC is incorrect or DP has been archived</AddtlInf>
      </StsRsn>
    </GrpSts>
    <PackgSts>
      <!-- Неиспользуемое поле -->
      <PackgId>undefined</PackgId>
      <!--Статус обработки всего сообщения (дублирует статус GrpSts.Sts) -->
      <Sts>RJCT</Sts>
      <!-- 1я Запись с контрактом, по которому нужно сформировать ВБК -->
      <RcrdSts>
        <!--Уникальный ID записи контракта -->
        <RcrdId>TEST_ID_2022-08-23-2791905441</RcrdId>
        <!--Статус обработки ВБК, соответствующей записи с контрактом -->
        <Sts>RJCT</Sts>
        <StsRsn>
          <Rsn>
            <!-- -->
            <Cd>NARR</Cd>
          </Rsn>
          <!-- Описание ошибки -->
          <AddtlInf>Ошибка в параметрах запроса: RUS: Номер УНК/ПС указан неверно или  ПС, закрытые до 01.10.2012 в ТБСВК не </AddtlInf>
          <AddtlInf>хранятся и к поиску и формированию из ТБСВК недоступны / ENG: The № DP/UC is incorrect or DP has been arc</AddtlInf>
          <AddtlInf>hived </AddtlInf>
        </StsRsn>
      </RcrdSts>
      <!-- 2я Запись с контрактом, по которому нужно сформировать ВБК -->
      <RcrdSts>
        <!--Уникальный ID записи контракта -->
        <RcrdId>TEST_ID_2022-08-23-2791905442</RcrdId>
        <!--Статус обработки ВБК, соответствующей записи с контрактом -->
        <Sts>RJCT</Sts>
        <StsRsn>
          <Rsn>
            <Cd>NARR</Cd>
          </Rsn>
          <!-- Описание ошибки -->
          <AddtlInf>Ошибка в параметрах запроса: RUS: Номер УНК/ПС указан неверно или  ПС, закрытые до 01.10.2012 в ТБСВК не </AddtlInf>
          <AddtlInf>хранятся и к поиску и формированию из ТБСВК недоступны / ENG: The № DP/UC is incorrect or DP has been arc</AddtlInf>
          <AddtlInf>hived </AddtlInf>
        </StsRsn>
      </RcrdSts>
    </PackgSts>
  </CcyCtrlStsAdvc>
</Document>

29. Скачивание архива с Ведомостями банковского контроля

URI

GET: /API/v1/ISO20022/ContractReports/Files/<MsgId>

Ответ

Скачивание файла доступно только при статусе всего запроса "Запрос успешно обработан" (ACPT) или "Частично обработан" (PART).

Описание статусов доступно в разделе Статусы Ведомости банковского контроля.

В разделе HTTP статусы ответов от сервиса Ведомость банковского контроля доступен список кодов ошибок с описанием.

Ответ на успешно обработанный запрос

Запрос в статусах:

  • "Запрос успешно обработан" (ACPT)

  • "Частично обработан" (PART)

Метод вернет HTTP статус 200 и файл архива со списком ВБК.

Ответ для запроса без архива

Запрос в статусах:

  • "Обработка" (PDNG)

  • "Принят в обработку" (ACTC)

  • "Отклонен" (RJCT)

Метод вернет HTTP статус 404 со следующим телом ответа:

Message with <MsgId> not found

30. Работа с вложенными файлами

URI

Работа с вложенными файлами может производиться для документов:
- Письма
- Сведения о валютных операциях (СВО)
- Справки о подтверждающих документах (СПД)
- Постановка на учет внешнеторгового контракта (УНК)
- Внесение изменений в I раздел ВБК (переоформление УНК)
- Снятие внешнеторгового контракта с учета

Отправка вложенных файлов вместе с документом (POST)

ВНИМАНИЕ!

Отправка вложенных файлов вместе с документом — предпочтительный способ отправки вложения .

При формировании запроса необходимо указать:

  • Заголовок (header) Content-Type должен начинаться с multipart/.. (например multipart/form-data )

  • Тип Body = form-data

  • Для файла с сообщением contentId/type/key = message

  • Для каждого вложения contentId/type/key = attachment

Пример заполнения полей в программе postman (Контракт с подписанным вложением):

Изображения отображаются только при открытии документации из папки после разархивации архива

Для документа названия вложений должны быть прописаны в самом файле сообщения:

Документ Тег для вложений

Письма

Document.CcyCtrlReqOrLttr.ReqOrLttr.Attchmnt

СВО

Document.PmtRgltryInfNtfctn.TxNtfctn.TxCert.CertRcrd.Attchmnt

СПД

Document.CcyCtrlSpprtgDocDlvry.GrpHdr.SpprtgDoc.Ntry.Attchmnt

Контракт (УНК)

В одном из трёх: Document.CtrctRegnReq.CtrctRegn.CtrctRegnOpng.Attchmnt

Document.CtrctRegnReq.CtrctRegn.CtrctRegnOpng.Ctrct.Trad.Attchmnt

Document.CtrctRegnReq.CtrctRegn.CtrctRegnOpng.Ctrct.Ln.Attchmnt

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

Document.CtrctRegnClsrReq.RegdCtrctClsr.Attchmnt

Внесение изменений в I раздел ВБК

Document.CtrctRegnAmdmntReq.CtrctRegnAmdmnt.RegdCtrctAmdmnt.Attchmnt

Пример простейшего корректного блока Attchmnt (для всех документов, кроме переоформления УНК) :

<Attchmnt>
  <DocTp>CCDC</DocTp>
  <DocNb>0</DocNb>
  <URL>attach_auth.024_003275_SVO_CCDC-1.pdf</URL>
  <AttchdBinryFile>
    <MIMETp>NONE</MIMETp>
  </AttchdBinryFile>
</Attchmnt>

Пример корректного блока Attchmnt для внесения изменений в I раздел ВБК (переоформление УНК):

<Attchmnt>
    <DocTp>CСDC</DocTp>
    <DocNb>12A</DocNb> <!-- Номер документа-обоснования. Если номера нет, указать "БН" -->
    <IsseDt>2023-01-27</IsseDt> <!-- Дата документа-обоснования -->
    <URL>attach_reissue_test.pdf</URL>
    <AttchdBinryFile>
        <MIMETp>NONE</MIMETp>
    </AttchdBinryFile>
</Attchmnt>
Пример подписанного СПД с блоком вложения
<?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>TEST_MSG_2021-06-25-1</MsgId>
      <CreDtTm>2021-06-25T12:42:04.270+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>TEST_SPPRTG_2021-06-25-1</SpprtgDocId>
      <Cert>
        <Id>TEST_ID_2021-06-25-1</Id>
        <DtOfIsse>2021-06-25</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>TEST_REG_CTRCT_2021-06-25-1</RegdCtrctId>
      </CtrctRef>
      <Ntry>
        <NtryId>TEST_NTRY_2021-06-25-1</NtryId>
        <OrgnlDoc>
          <Id>TEST_ORGDOC_2021-06-25-1</Id>
          <DtOfIsse>2021-05-26</DtOfIsse>
        </OrgnlDoc>
        <DocTp>0023</DocTp>
        <TtlAmt Ccy="RUR">100.00</TtlAmt>
        <ShipmntAttrbts>
          <Conds>
            <Prtry>3</Prtry>
          </Conds>
        </ShipmntAttrbts>
        <AddtlInf>тестирование h2h</AddtlInf>
        <Attchmnt>
          <DocTp>1</DocTp>
          <DocNb>1</DocNb>
          <URL>attach.xml</URL>
          <AttchdBinryFile>
            <MIMETp>NONE</MIMETp>
          </AttchdBinryFile>
        </Attchmnt>
      </Ntry>
    </SpprtgDoc>
    <SplmtryData>
      <Envlp>
        <SgntrSt>
          <ds:Signature Id="sigID1" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
            <ds:SignedInfo>
              <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
              <ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>
              <ds:Reference URI="">
                <ds:Transforms>
                  <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
                  <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
                </ds:Transforms>
                <ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>
                <ds:DigestValue>OKG/2l9G6Jd2aNmcBJdQlTfVRsyUlAGYbbzrabBWluI=</ds:DigestValue>
              </ds:Reference>
            </ds:SignedInfo>
            <ds:SignatureValue>qwGl2JeSJcLekHwiUKpjlIB5lgNGbb2yUDNuhtfC5ykK0yG2crSRhw4WHElwWMnKXvFo8PKG08fkA7dVYMWbMg==</ds:SignatureValue>
            <ds:KeyInfo>
              <ds:X509Data>
                <ds:X509Certificate>MIIJAzCCCLCgAwIBAgIRBTd/twDprFm+QYXHcVcbqLQwCgYIKoUDBwEBAwIwggELMRgwFgYFKoUDZAESDTEwMjc3MDAwNjczMjgxGjAYBggqhQMDgQMBARIMMDA3NzI4MTY4OTcxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxKjAoBgNVBAkMIdCj0LsuINCa0LDQu9Cw0L3Rh9C10LLRgdC60LDRjyAyNzEPMA0GA1UECwwG0KPQmNCRMSEwHwYDVQQKDBjQkNCeINCQ0JvQrNCk0JAt0JHQkNCd0JoxNTAzBgNVBAMMLNCi0JXQodCiINCj0KYgMi4wINCQ0J4gItCQ0JvQrNCk0JAt0JHQkNCd0JoiMB4XDTIxMDMxMjEwNTgwNloXDTIyMDYxMjExMDgwNlowggH5MTIwMAYDVQQqDCnQodC10YDRgtC40YTQuNC60LDRgiDQodC+0YLRgNGD0LTQvdC40LrQsDEZMBcGA1UEBAwQ0KLQtdGB0YLQvtCy0YvQuTFJMEcGA1UECQxAMTA3MDc4LCDQsy4g0JzQvtGB0LrQstCwLCDRg9C7LiDQmtCw0LvQsNC90YfQtdCy0YHQutCw0Y8sINC0LiAyNzEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODE0MDIGA1UEDAwr0JDRgNGF0LjRgtC10LrRgtC+0YAg0L3QsNC/0YDQsNCy0LvQtdC90LjRjzEmMCQGCSqGSIb3DQEJARYXdmJ1cm1pc3Ryb3ZAYWxmYWJhbmsucnUxCzAJBgNVBAYTAlJVMRUwEwYDVQQIDAzQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEjMCEGA1UECgwa0JDQniAi0JDQu9GM0YTQsC3QkdCw0L3QuiIxUDBOBgNVBAsMR9CU0LjRgNC10LrRhtC40Y8g0YDQsNC30YDQsNCx0L7RgtC60Lgg0YbQuNGE0YDQvtCy0YvRhSDRgdC10YDQstC40YHQvtCyMRcwFQYDVQQDDA4xdHJ1c3Rjb3JlLTI1NjBmMB8GCCqFAwcBAQEBMBMGByqFAwICJAAGCCqFAwcBAQICA0MABEA8fBN/QZKE4T03YEHTMTldxRHPF/SdYGSPFEmUMGlrEuLFycdkDBxSFTaFfewyYVTDpJ53/1JGp60sKVFvyvIxo4IE9DCCBPAwDgYDVR0PAQH/BAQDAgOoMB8GCSsGAQQBgjcVBwQSMBAGCCqFAwICLgAIAgEBAgEAMB0GA1UdDgQWBBSXVVvUtLRiPz8231/48DKMZsLbVDAdBgNVHSUEFjAUBggrBgEFBQcDAgYIKwYBBQUHAwQwJwYJKwYBBAGCNxUKBBowGDAKBggrBgEFBQcDAjAKBggrBgEFBQcDBDBxBggrBgEFBQcBAQRlMGMwYQYIKwYBBQUHMAKGVWh0dHA6Ly90ZXN0LXVjMi5tb3Njb3cuYWxmYWludHJhLm5ldC9haWEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcnQwHQYDVR0gBBYwFDAIBgYqhQNkcQEwCAYGKoUDZHECMIIBQwYFKoUDZHAEggE4MIIBNAw00KHQmtCX0JggItCa0YDQuNC/0YLQvtCf0YDQviBDU1AiICjQstC10YDRgdC40Y8gNC4wKQxa0J/QkNCaICLQo9C00L7RgdGC0L7QstC10YDRj9GO0YnQuNC5INGG0LXQvdGC0YAgItCa0YDQuNC/0YLQvtCf0YDQviDQo9CmIiDQstC10YDRgdC40LggMi4wDE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI0LTMwMTAg0L7RgiAzMC4xMi4yMDE2DE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI4LTI5ODMg0L7RgiAxOC4xMS4yMDE2MD8GBSqFA2RvBDYMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQuMCkwgb0GA1UdHwSBtTCBsjBboFmgV4ZVaHR0cDovL3Rlc3QtdWMyLm1vc2Nvdy5hbGZhaW50cmEubmV0L2NkcC82ZjBiMGQ1MjVkMTlhNzQ4YmUwNTE4OTM5N2Q4MDk1NTdkMzg4Y2EyLmNybDBToFGgT4ZNaHR0cDovL2NhLmFsZmFpbnRyYS5uZXQvY2VydGRhdGEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcmwwggFNBgNVHSMEggFEMIIBQIAUbwsNUl0Zp0i+BRiTl9gJVX04jKKhggETpIIBDzCCAQsxGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEqMCgGA1UECQwh0KPQuy4g0JrQsNC70LDQvdGH0LXQstGB0LrQsNGPIDI3MQ8wDQYDVQQLDAbQo9CY0JExITAfBgNVBAoMGNCQ0J4g0JDQm9Cs0KTQkC3QkdCQ0J3QmjE1MDMGA1UEAwws0KLQldCh0KIg0KPQpiAyLjAg0JDQniAi0JDQm9Cs0KTQkC3QkdCQ0J3QmiKCEQWXkJ8A26z9j0tjSIs3FfK5MCsGA1UdEAQkMCKADzIwMjEwMzEyMTA1ODA1WoEPMjAyMjA2MTIxMDU4MDVaMAoGCCqFAwcBAQMCA0EAHvrxKAto/T3htcx89MTL17HjVlLFJMt1rjCg2lg1jhUof6rY4FVArNEOsIRWxhwG8hV8j3rhl15wvpTgmOTvLg==</ds:X509Certificate>
              </ds:X509Data>
            </ds:KeyInfo>
          </ds:Signature>
        </SgntrSt>
      </Envlp>
    </SplmtryData>
  </CcyCtrlSpprtgDocDlvry>
</Document>

Отправка вложенных файлов отдельно от документа (POST)

ВНИМАНИЕ!

Данный способ является устаревшим и не рекомендуется к использованию

Для отправки файлов вложением отдельно от документа необходимо в Headers передать параметры:

  1. Media Type: multipart/form-data

  2. В самом запросе для вложенных файлов необходимо указывать ContentID = attachment (маркер для определения файла - вложения)

URL для отправки вложений отдельно от документа и для получения вложений (GET)

Можно запросить вложения любого типа: как отправленные отдельно от документа, так и вместе с ним.

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

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

Load attaches to Certificate

POST

/API/v1/ISO20022/COCertificates/Transactions/Files/<TxId>

Отправка вложенных файлов в СВО

Get attaches' list to Certificate

GET

/API/v1/ISO20022/COCertificates/Transactions/Files/<TxId>

Получение списка файлов, приложенных к СВО

Get attach to Certificate

GET

/API/v1/ISO20022/COCertificates/Transactions/Files/<TxId>/<FileId>

Получение контента файла, приложенного к СВО

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

Load attaches to Certificate

POST

/API/v1/ISO20022/ConfCertificates/Transactions/Files/<SpprtgDocId>

Отправка вложенных файлов в СПД

Get attaches' list to Certificate

GET

/API/v1/ISO20022/ConfCertificates/Transactions/Files/<SpprtgDocId>

Получение списка файлов, приложенных к СПД

Get attach to Certificate

GET

/API/v1/ISO20022/ConfCertificates/Transactions/Files/<SpprtgDocId>/<FileId>

Получение контента файла, приложенного к СПД

Вложения к письму

Load attaches to letter

POST

/API/v1/ISO20022/Letters/OutLetters/Files/<ReqOrLttrId>

Отправка вложенных файлов

Get attach’s content to incoming letter

GET

/API/v1/ISO20022/Letters/InLetters/Files/<ReqOrLttrId>/<DocNb>

Получение контента файла, приложенного к входящему письму

Вложения к Контракту (УНК)

Load attaches to Contract

POST

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

Отправка вложенных файлов в Контракт (УНК)

Get attaches' list to Contract

GET

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

Получение списка файлов, приложенных к Контракту (УНК)

Get attach to Contract

GET

/API/v1/ISO20022/Contracts/Files/<CtrctRegnOpngId>/<FileId>

Получение контента файла, приложенного к Контракту (УНК)

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

Get attaches' list to Contract

GET

/API/v1/ISO20022/Contracts/Close/Files/<RegdCtrctClsrId>

Получение списка файлов

Get attach to Contract

GET

/API/v1/ISO20022/Contracts/Close/Files/<RegdCtrctClsrId>/<FileId>

Получение контента файла

Внесение изменений в I раздел ВБК

Get attaches' list to Contract

GET

/API/v1/ISO20022/Contracts/Reissue/Files/<RegdCtrctAmdmntId>

Получение списка файлов

Get attach to Contract

GET

/API/v1/ISO20022/Contracts/Reissue/Files/<RegdCtrctAmdmntId>/<FileId>

Получение контента файла

Отправка вложенных файлов с подписью

Файлы возможно отправлять как с подписью, так и без нее. При отправке вложения одновременно с документом - главное, чтобы был подписан сам документ.

Для отправки вложенных файлов с подписью используйте рекомендации ниже.

Необходимо в Headers передать параметры:
1. check-sign-attach со значением true
2. company-tin (не обязательный параметр) со значением ИНН компании
3. В самом запросе для файлов-подписей (.pkcs7) необходимо указывать ContentId = sign (маркер для определения подписей)

Может быть 2 варианта установки подписи:
1. Все подписи в одном файле .pkcs7
2. Каждая подпись в отдельном файле .pkcs7

Наименование файлов подписи должны соответствовать формату:
sign_filename.pkcs7 или signX_filename.pkcs7 , где
X - это цифра от 1 до 3 в случае, если подписей на файле несколько и каждая из них в отдельном файле (.pkcs7),
filename - название подписываемого файла

31. Печатные формы

Где искать примеры печатных форм?

Все примеры печатных форм можно найти в папке print example в архиве инструкции

Обратите внимание!

На данный момент есть возможность запросить печатную форму только по отдельному платежу.

Сервис самостоятельно определяет тип платежа: валютный перевод или рублёвое платёжное поручение.

URI

GET: /API/v1/ISO20022/Payments/Print/<InstrId>

Входные параметры

InstrId - идентификатор рублёвого/валютного платежа из поля Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.PmtId.InstrId в схеме pain.001.001.06.

Ответ

PDF файл в виде массива байт

Пример печатной формы рублёвого платежа: ./print example/Ruble_payment_print_example.pdf

Пример печатной формы валютного платежа: ./print example/Currency_payment_print_example.pdf

HTTP-коды ответов

Код ответа Текст ответа Описание

200

-

Печатная форма успешно сформирована

400

Error in parameters

Ошибка в параметрах запроса

400

Error in report generating

Ошибка при формировании печатной формы

401

Wrong username or password

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

401

User was not found

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

403

User is disabled

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

403

Warrant is expired

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

403

Internal error while verifying permissions

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

404

InstrId was not found

Идентификатор платежа не найден

500

Warrant service error

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

502

Bad Gateway

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

503

Service Unavailable

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

504

Gateway Timeout

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

500

Internal Error

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

32. Статусы

Статусы по валютным переводам, платёжным поручениям и РСТС

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

Описание XSD Ссылка на ВП/ПП

Document.CstmrPmtStsRpt.GrpHdr

1

R

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

MsgId

2

R

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

CreDtTm

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

3

R

SWIFT Альфа-Банка

Пример:
ALFARUMM

InitgPty.Id.OrgId.AnyBIC

4

R

БИК Альфа-Банка

Пример:
044525593

InitgPty.Id.OrgId.Othr.Id

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts

5

R

Уникальный id исходного сообщения с (пакетом) ВП/ПП

OrgnlMsgId

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

6

R

Тип исходного сообщения с (пакетом) ВП/ПП

Указывается формат, в котором был загружен ВП/ПП

OrgnlMsgNmId

"pain.001.001.06"

7

R

Дата и время формирования исходного сообщения с (пакетом) ВП/ПП

OrgnlCreDtTm

Document.CstmrCdtTrfInitn.
GrpHdr.CreDtTm (по МСК времени)

8

R

Статус исходного сообщения с (пакетом) ВП/ПП:
RCVD - Получено;
RJCT - Отклонено;
ACSP - Принято к исполнению;
PART - Принято, подтверждена часть поручений;
ACSC - Исполнено.

GrpSts

9

O

Код причины присвоения статуса сообщения с (пакетом) ВП/ПП:
DS08 - Ошибка распаковки;
DS09 - Ошибка расшифровки;
TD03 - Некорректная структура файла;
NARR - Описание в поле AddtlInf.

StsRsnInf.Rsn.Cd

10

O

Описание причины присвоения статуса сообщения с (пакетом) ВП/ПП

StsRsnInf.AddtlInf

11

O

Идентификатор исходного пакета ВП/ПП

OrgnlPmtInfId

Document.CstmrCdtTrfInitn.
PmtInf.PmtInfId

12

O

Статус исходного пакета ВП/ПП:
RCVD - Получено;
RJCT - Отклонено;
ACSP - Принято к исполнению;
PART - Принято, подтверждена часть поручений;
ACSC - Исполнено.

PmtInfSts

13

О

Код причины присвоения статуса пакета ВП/ПП

StsRsnInf.Rsn.Cd

14

O

Описание причины присвоения статуса пакета ВП/ПП

StsRsnInf.AddtlInf

15

O

Идентификатор исходного ВП/ПП

TxInfAndSts.OrgnlInstrId

Document.CstmrCdtTrfInitn.
PmtInf.CdtTrfTxInf.PmtId.InstrId

16

O

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

TxInfAndSts.OrgnlEndToEndId

Document.CstmrCdtTrfInitn.
PmtInf.CdtTrfTxInf.PmtId.EndToEndId

17

O

Статус исходного ВП/ПП:
RJCT - Отклонено;
ACSP - Принято к исполнению;
ACTC - Принято, проверены реквизиты плательщика;
ACSC - Исполнено.

TxInfAndSts.TxSts

18

O

Код причины присвоения статуса ВП/ПП:
DS0D - Неправильный Ключ ЭП;
DS0H - Неправильный счет плательщика;
DS0G - Неправильный тип платежа;
DS17 - Ошибка при проверке ЭП;
DS19 - Недостаточно прав для подписи.

TxInfAndSts.StsRsnInf.Rsn.Cd

19

O

Описание кода причины присвоения статуса ВП/ПП

TxInfAndSts.StsRsnInf.AddtlInf

20

O

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

TxInfAndSts.AccptncDtTm

Статусы по Зарплатным ведомостям

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

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

Общий путь: Document.CstmrPmtStsRpt

1

R

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

GrpHdr.MsgId

2

R

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

GrpHdr.CreDtTm

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

3

R

Уникальный id исходного сообщения с ведомостью

OrgnlGrpInfAndSts.OrgnlMsgId

4

R

Схема исходного сообщения

OrgnlGrpInfAndSts.OrgnlMsgNmId

5

R

Дата и время формирования исходного сообщения с ведомостью

OrgnlGrpInfAndSts.OrgnlCreDtTm

ISODate (YYYY-MM-DD) + время

6

R

Статус исходного сообщения

OrgnlGrpInfAndSts.GrpSts

Если не было ошибок, то совпадает со статусом ведомости

7

O

Описание причины присвоения статуса сообщения

OrgnlGrpInfAndSts.StsRsnInf.AddtlInf

8

O

Идентификатор исходного пакета с ведомостью

OrgnlPmtInfAndSts.OrgnlPmtInfId

9

О

Статус исходного пакета с ведомостью

OrgnlPmtInfAndSts.PmtInfSts

Описание статусов в таблице Статусы ведомости

10

О

Описание причины присвоения статуса пакета с ведомостью

OrgnlPmtInfAndSts.StsRsnInf.AddtlInf

Описание ошибки при обработке ведомости или одно из значений таблицы Статусы ведомости

11

O

Номер начисления в ведомости

OrgnlPmtInfAndSts.TxInfAndSts.OrgnlInstrId

12

O

Статус начисления

OrgnlPmtInfAndSts.TxInfAndSts.TxSts

Описание статусов в таблице Статусы начислений

13

O

Описание кода причины присвоения статуса начисления

OrgnlPmtInfAndSts.TxInfAndSts.StsRsnInf.AddtlInf

14

O

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

OrgnlPmtInfAndSts.TxInfAndSts.AccptncDtTm

Статусы ведомости

Поле OrgnlPmtInfAndSts.PmtInfSts Поле OrgnlPmtInfAndSts.StsRsnInf.AddtlInf Описание статуса ведомости

ACSP

На обработке

Документ успешно отправлен в АЗОН

ACSP

Принят

Документ на обработке, принят АЗОНом

ACSP

Приостановлен

Недостаточно средств на счёте

ACSP

Не подтвержден

Требуется подписание SMS в АЗОНе

RJCT

Отклонен банком

Окончательный статус

RJCT

Аннулирован

Окончательный статус. Аннулирован по инициативе пользователя

PART

Исполнен (Частичное начисление)

Окончательный статус. Есть неисполненные начисления.

ACSC

Исполнен

Окончательный статус

Статусы начислений

Поле OrgnlPmtInfAndSts.TxInfAndSts.TxSts Описание статуса начисления

RCVD

Получено банком

ACSP

На обработке

RJCT

Незачислено

ACSC

Зачислено

Пример статуса Зарплатной ведомости
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.06">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>3c402c01c9b849a0ac5c0434299aecc1</MsgId>
            <CreDtTm>2022-03-30T16:13:24.665+03:00</CreDtTm>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>7421w6f13a01983593e8dffb71fa6d15</OrgnlMsgId>
            <OrgnlMsgNmId>pain.008.001.05</OrgnlMsgNmId>
            <OrgnlCreDtTm>2022-03-30T15:25:53.000+03:00</OrgnlCreDtTm>
            <GrpSts>ACSP</GrpSts>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>7421w6f13a01983593e8dffb71fa6d15</OrgnlPmtInfId>
            <PmtInfSts>ACSP</PmtInfSts>
            <StsRsnInf>
                <AddtlInf>Приостановлен</AddtlInf>
            </StsRsnInf>
            <TxInfAndSts>
                <OrgnlInstrId>7421w6f13a01983593e8dffb71fa6d15</OrgnlInstrId>
                <TxSts>ACSP</TxSts>
                <AccptncDtTm>2022-03-30T15:25:53.000+03:00</AccptncDtTm>
            </TxInfAndSts>
            <TxInfAndSts>
                <OrgnlInstrId>7421w6f13a01983593e8dffb71fa6d16</OrgnlInstrId>
                <TxSts>ACSP</TxSts>
                <AccptncDtTm>2022-03-30T15:25:53.000+03:00</AccptncDtTm>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>

Статусы по открытию лицевых счетов

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

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

Общий путь: Document.AcctRpt

1

R

Тип заявки

Refs.ReqTp

Константа "OPEN" - заявка на открытие ЛС

2

R

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

Refs.MsgId.Id

3

R

Дата и Время формирования статуса сообщения

Refs.MsgId.CreDtTm

ISODate (YYYY-MM-DD) + время

4

R

Номер реестра

Refs.PrcId.Id

5

R

Дата реестра

Refs.PrcId.CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD

6

R

Статус сообщения (заявки на открытие ЛС)

Refs.Sts

Описание статусов в таблице Статусы заявки на открытие ЛС

7

O

Описание статуса сообщения (заявки на открытие ЛС)

Refs.AttchdDocNm

8

R

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

Fr.Othr.Id

9

R

Номер ЗП договора

AcctSvcrId.FinInstnId.ClrSysMmbId.MmbId

10

О

Количество записей

AcctSvcrId.FinInstnId.Nm

11

R

Наименование организации

Org.FullLglNm

12

R

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

Org.CtryOfOpr

CountryCode: константа = RU

13

R

Адрес организации

Org.LglAdr

Обязательно по схеме, не используется, не заполняется, пустой тег

14

R

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

Org.LglAdr.OrgId.Othr.Id

15

R

Константа ИНН

Org.LglAdr.OrgId.Othr.SchmeNm.Cd

Константа : TXID

Общий путь Document.AcctRpt.SplmtryData.Envlp.EmplInfo.Empl (по одному блоку Empl на сотрудника)

16

R

НПП Сотрудника

EmNum

17

R

Фамилия сотрудника

LstNm

18

R

Имя сотрудника

FstNm

19

O

Отчество сотрудника

MdlNm

20

R

Открытый лицевой счёт сотрудника

Acct

21

R

Статус открытия ЛС сотрудника

Sts

Описание статусов в таблице Статусы открытия ЛС

23

R

Описание статуса открытия ЛС сотрудника

StsDesc

Статусы заявки на открытие ЛС

Поле Document.AcctRpt. Refs.Sts Поле Document.AcctRpt.Refs.AttchdDocNm Описание статуса заявки на открытие ЛС

ACSP

На обработке

Документ успешно отправлен в АЗОН

ACSP

Принят

Документ на обработке, принят АЗОН

RJCT

Отклонен банком

Окончательный статус

PART

Исполнен (Частичное начисление)

Окончательный статус. Есть неоткрытые счета.

ACSC

Исполнен

Окончательный статус. Все счета открыты

Статусы открытия ЛС

Поле Document.AcctRpt.SplmtryData.Envlp.EmplInfo.Empl.Sts Описание статуса открытия ЛС

RCVD

Получено банком

ACSP

На обработке

RJCT

Счёт открыт

ACSC

Счёт не открыт

Пример статуса Заявки на открытие ЛС
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:acmt.014.001.04">
  <AcctRpt>
    <Refs>
      <ReqTp>OPEN</ReqTp>
      <MsgId>
        <Id>TEST_MSG_2022-06-06-1716303</Id>
        <CreDtTm>2022-06-06T17:16:30.307+03:00</CreDtTm>
      </MsgId>
      <PrcId>
        <Id>30307</Id>
        <CreDtTm>2022-06-06T17:16:30.307+03:00</CreDtTm>
      </PrcId>
      <Sts>RCVD</Sts>
    </Refs>
    <Fr>
      <Othr>
        <Id>TEST_MSG_2022-06-06-1716303</Id>
      </Othr>
    </Fr>
    <AcctSvcrId>
      <FinInstnId>
        <ClrSysMmbId>
          <MmbId>00753Z</MmbId>
        </ClrSysMmbId>
        <Nm>1</Nm>
      </FinInstnId>
    </AcctSvcrId>
    <Org>
      <FullLglNm>Общество с ограниченной ответственностью &quot;Тест Альфа-Линк ЗУП&quot;</FullLglNm>
      <CtryOfOpr>RU</CtryOfOpr>
      <LglAdr/>
      <OrgId>
        <Othr>
          <Id>0664010623</Id>
          <SchmeNm>
            <Cd>TXID</Cd>
          </SchmeNm>
        </Othr>
      </OrgId>
    </Org>
    <SplmtryData>
      <Envlp>
        <EmplInfo>
          <Empl>
            <EmNum>1</EmNum>
            <LstNm>Рермантов</LstNm>
            <FstNm>Иван</FstNm>
            <MdlNm>Иванович</MdlNm>
            <Sts>ACTC</Sts>
          </Empl>
        </EmplInfo>
      </Envlp>
    </SplmtryData>
  </AcctRpt>
</Document>

Статусы по документам валютного контроля (СВО, СПД, УНК)

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

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

Document.CcyCtrlStsAdvc.GrpHdr

1

R

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

MsgId

-

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Количество блоков GrpSts

4

R

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

RcvgPty.Id.OrgId.Othr.Id

-

5

R

SWIFT код банка

RegnAgt.FinInstnId.BICFI

Константа 'ALFARUMM'

6

R

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

RegnAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

7

R

БИК Банка

RegnAgt.FinInstnId.ClrSysMmbId.MmbId

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

Document.CcyCtrlStsAdvc.GrpSts

8

R

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

OrgnlRefs.OrgnlMsgId

-

9

R

Тип исходного сообщения

OrgnlRefs.OrgnlMsgNmId

"auth.024.001.01" - СВО
"auth.025.001.01" - СПД;
"auth.018.001.01" - УНК;
"auth.020.001.03" - Снятие контракта с учета.

10

R

Время создания исходного сообщения

OrgnlRefs.OrgnlCreDtTm

11

R

БИК Банка

OrgnlRefs.RptgPty.PtyId.Id.OrgId.Othr.Id

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

12

R

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

OrgnlRefs.RptgPty.PtyId.Id.OrgId.Othr.SchmeNm.Cd

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

13

R

SWIFT код банка

RegnAgt.FinInstnId.BICFI

Константа 'ALFARUMM'

14

R

Статус исходного сообщения

Sts

см. таблицу "Статус исходного сообщения"

15

O

Код причины присвоения статуса сообщения

StsRsn.Rsn.Cd

-

16

O

Описание причины присвоения статуса сообщения

StsRsn.AddtlInf

-

Document.CcyCtrlStsAdvc.PackgSts

17

О

Идентификатор исходного пакета документов

PackgId

18

О

Статус исходного пакета документов

Sts

см. таблицу "Статус исходного документа"

19

O

Код причины присвоения статуса пакета документов

StsRsn.Rsn.Cd

-

20

O

Описание причины присвоения статуса пакета документов

StsRsn.AddtlInf

-

Document.CcyCtrlStsAdvc.PackgSts.RcrdSts

21

О

Идентификатор исходного документа

RcrdId

-

22

О

Статус исходной документа

Sts

-

23

O

Код причины присвоения статуса документа

StsRsn.Rsn.Cd

Константа 'NARR'

24

O

Описание пункта 138-И, согласно которому отклонен документа

VldtnRule.Desc

-

25

O

Описание причины присвоения статуса документа

StsRsn.AddtlInf

-

Статус исходного сообщения

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

RCVD

Report has been received

Получено

Хотя бы один документ в сообщении/пакете находятся в статусе RCVD

ACTC

AcceptedTechnicalValidation

На обработке

Все остальные случаи

ACPT

Accepted

Принято

Все документы в сообщении/пакете находятся в статусе ACPT

RJCT

Rejected

Отклонено

Все документы в сообщении/пакете находятся в статусе RJCT

PART

Report has been partially accepted. A number of transactions have been accepted, whereas another number of transactions have not yet been accepted.

Частично принято

Хотя бы один документ в сообщении/пакете находятся в статусе ACPT

Статус исходного документа

ISO статус ISO описание Описание

RCVD

Report has been received

Получен

ACTC

AcceptedTechnicalValidation

На обработке

ACPT

Accepted

Принят

RJCT

Rejected

Отклонен

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

Описание схемы ответа

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

Document.CcyCtrlStsAdvc.GrpHdr

1

R

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

MsgId

-

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Кол-во блоков ReqOrLttr, каждый из которых соответствует переданному УНК.

4

R

SWIFT код банка

RegnAgt.FinInstnId.BICFI

Константа 'ALFARUMM'

5

R

БИК Банка

RegnAgt.FinInstnId.ClrSysMmbId.MmbId

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

Document.CcyCtrlStsAdvc.GrpSts

6

R

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

OrgnlRefs.OrgnlMsgId

-

7

R

Тип исходного сообщения

OrgnlRefs.OrgnlMsgNmId

"auth.026.001.01"

8

R

Время создания исходного сообщения

OrgnlRefs.OrgnlCreDtTm

9

R

БИК банка

RptgPty.PtyId.Id.OrgId.Othr.Id

Константа '044525593'

10

R

SWIFT код банка

RegnAgt.FinInstnId.BICFI

Константа 'ALFARUMM'

11

R

Статус исходного сообщения

Sts

см. таблицу Статусы Ведомости банковского контроля

12

O

Код причины ошибки в ISO

StsRsn.Rsn.Cd

-

13

O

Описание причины присвоения статуса сообщения

StsRsn.AddtlInf

-

Document.CcyCtrlStsAdvc.PackgSts

14

R

Неиспользуемое поле

PackgId

Константа "undefined"

15

R

Статус обработки всего запроса

Sts

Дублирует значение из GrpSts.Sts. См. таблицу Статусы Ведомости банковского контроля

Document.CcyCtrlStsAdvc.PackgSts.RcrdSts

16

R

Идентификатор ReqOrLttrId элемента в массиве контрактов ReqOrLttr исходного запроса

RcrdId

-

17

R

Статус обработки ВБК по УНК соответствующего блока ReqOrLttr

Sts

См. таблицу Статусы Ведомости банковского контроля

18

O

Код причины ошибки в ISO

StsRsn.Rsn.Cd

-

19

O

Описание причины присвоения статуса

StsRsn.AddtlInf

-

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

Передается в Document.GrpSts.Sts схемы auth.027.001.01

ISO статус всего запроса Описание Комментарий ISO статус записи с УНК Комментарий

57

RCVD

Получено

Запрос на формирование архива со списком ВБК получен

RCVD

Запрос на формирование файла ВБК принят в получен

58

ACTC

Технические проверки пройдены, запрос принят в обработку

Запрос принят в обработку

ACTC

Запись УНК принята в обработку

59

PDNG

Начало формирования архива ВБК

По списку УНК были сформированы файлы ВБК

RJCT

Не сформирован файл ВБК по УНК, либо при формировании произошла ошибка

PDNG

По УНК был сформирован файл ВБК

60

ACPT

Архив успешно сформирован

По всем УНК были сформированы файлы ВБК и добавлены в архив для скачивания

ACPT (каждая запись находится в статусе ACPT)

По каждой записи с УНК была сформирована ВБК и добавлена в архив

61

PART

Архив частично сформирован

В архив добавлен хотя бы один файл ВБК

ACPT/RJCT (хотя бы одна запись находится в статусе ACPT)

Хотя бы по одной записи с УНК из списка была успешно сформирована ВБК и добавлена в архив

62

RJCT

Отклонено

Запрос не прошел проверку на соответствие схеме/в процессе обработки произошла ошибка/невалидные реквизиты компании

RJCT (все записи находятся в статусе RJCT)

хотя бы один УНК невалиден/снят с учета, либо не принадлежит компании

33. Электронная подпись

Электронная Подпись формируется с использованием алгоритма ГОСТ Р 34.10-2012 по стандарту XMLDSig. Секция Signature, содержащая ЭП, сформированную по стандарту XMLDSig, помещается в секцию SgntrSt внутри секции SplmtryData , предназначенной для размещения произвольных данных. Каждая секция Signature содержит ссылку на подписываемую секцию(ии) внутри xml документа. Сообщение подписывается целиком, включая секцию

<SplmtryData>
    <Envlp>
        <SgntrSt>
        </SgntrSt>
    </Envlp>
</SplmtryData>

Общие рекомендации по формированию XMLDSig подписи:

1) Можно использовать сертифицированную связку криптографического провайдера КриптоПро CSP и API из Java к нему КриптоПро JavaCSP, но в своем ПО обязательно указывать JavaCSP

2) А можно использовать КриптоПро JCP 2.0. В его дистрибутиве есть jar c примерами: samples.jar samples-sources.jar в том числе xmlSign.

3) Поле Signature@Id в подписи заполняется значениями типа: "SigId1", "SigId2" и т.д.

При подписании двумя ключами, подписываются только сами данные. При подписании второй подписью, первая наложенная подпись не подписывается

Чтобы избежать ошибки "UnrecoverableKeyException: Get Key failed", нужно перенести ключи и сертификат из хранилища *.pfx в хранилище HDImageStore (это будет папка с 6-ю файлами *.key), которое понимает Java c установленным КриптоПро (подробнее https://www.cryptopro.ru/forum2/default.aspx?g=posts&t=8271)

Примеры реализации и подписанных документов: https://github.com/Host-to-Host-Instructions/iso20022-signature

Пример формирования подписи
<CstmrCdtTrfInitn>
    ...
    <SplmtryData>
        <Envlp>
            <SgntrSt>
                <Signature хmlns="http://www.w3.org/2000/09/xmldsig#">
                    {ЭП #1 …}
                </Signature>

                <Signature хmlns="http://www.w3.org/2000/09/xmldsig#">
                    {ЭП #2 …}
                </Signature>
            </SgntrSt>
        </Envlp>
    </SplmtryData>
</CstmrCdtTrfInitn>
Пример запроса мультивыписки с подписью
<?xml version="1.0" encoding="UTF-8"?>
<p:Document xmlns:p="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03">
    <p:AcctRptgReq>
        <p:GrpHdr>
            <p:MsgId>MSG_20170830_test_55</p:MsgId>
            <p:CreDtTm>2017-05-26T12:00:00</p:CreDtTm>
        </p:GrpHdr>
        <p:RptgReq>
            <p:Id>REQ_20170830_test_55</p:Id>
            <p:ReqdMsgNmId>HMQSTASCF</p:ReqdMsgNmId>
            <p:Acct>
                <p:Id>
                    <p:Othr>
                        <p:Id>40702810200000000083</p:Id>
                    </p:Othr>
                </p:Id>
            </p:Acct>
            <p:AcctOwnr>
                <p:Pty>
                    <p:Nm>ООО "Тест Альфа-Линк"</p:Nm>
                </p:Pty>
            </p:AcctOwnr>
            <p:RptgPrd>
                <p:FrToDt>
                    <p:FrDt>2017-02-23</p:FrDt>
                    <p:ToDt>2017-02-23</p:ToDt>
                </p:FrToDt>
                <p:FrToTm>
                    <p:FrTm>00:00:00</p:FrTm>
                    <p:ToTm>24:00:00</p:ToTm>
                </p:FrToTm>
                <p:Tp>ALLL</p:Tp>
            </p:RptgPrd>
        </p:RptgReq>
        <p:RptgReq>
            <p:Id>REQ_20170830_test_56</p:Id>
            <p:ReqdMsgNmId>HMQSTASCF</p:ReqdMsgNmId>
            <p:Acct>
                <p:Id>
                    <p:Othr>
                        <p:Id>40702810100000000921</p:Id>
                    </p:Othr>
                </p:Id>
            </p:Acct>
            <p:AcctOwnr>
                <p:Pty>
                    <p:Nm>ООО "Тест Альфа-Линк"</p:Nm>
                </p:Pty>
            </p:AcctOwnr>
            <p:RptgPrd>
                <p:FrToDt>
                    <p:FrDt>2017-02-23</p:FrDt>
                    <p:ToDt>2017-02-23</p:ToDt>
                </p:FrToDt>
                <p:FrToTm>
                    <p:FrTm>00:00:00</p:FrTm>
                    <p:ToTm>24:00:00</p:ToTm>
                </p:FrToTm>
                <p:Tp>ALLL</p:Tp>
            </p:RptgPrd>
        </p:RptgReq>
        <p:SplmtryData>
            <p:Envlp>
                <SgntrSt>
                    <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="sigID1">
                        <ds:SignedInfo>
                            <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
                            <ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>
                            <ds:Reference URI="">
                                <ds:Transforms>
                                    <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
                                    <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
                                </ds:Transforms>
                                <ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>
                                <ds:DigestValue>shrzDUfCWE3IuU1r3igsZSTY/chNfeR7XRZYd9ZjKSE=</ds:DigestValue>
                            </ds:Reference>
                        </ds:SignedInfo>
                        <ds:SignatureValue>Q/8xBLzlFsDGhnRUC+MMKC9sTItfPabn0TF9yIPsM7vzElUL4j7rdZxLOuH1yOLEJB/e9zoOWzsfPVoyAnJXLg==</ds:SignatureValue>
                        <ds:KeyInfo>
                            <ds:X509Data>
                                <ds:X509Certificate>MIIJAzCCCLCgAwIBAgIRBTd/twDprFm+QYXHcVcbqLQwCgYIKoUDBwEBAwIwggELMRgwFgYFKoUDZAESDTEwMjc3MDAwNjczMjgxGjAYBggqhQMDgQMBARIMMDA3NzI4MTY4OTcxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxKjAoBgNVBAkMIdCj0LsuINCa0LDQu9Cw0L3Rh9C10LLRgdC60LDRjyAyNzEPMA0GA1UECwwG0KPQmNCRMSEwHwYDVQQKDBjQkNCeINCQ0JvQrNCk0JAt0JHQkNCd0JoxNTAzBgNVBAMMLNCi0JXQodCiINCj0KYgMi4wINCQ0J4gItCQ0JvQrNCk0JAt0JHQkNCd0JoiMB4XDTIxMDMxMjEwNTgwNloXDTIyMDYxMjExMDgwNlowggH5MTIwMAYDVQQqDCnQodC10YDRgtC40YTQuNC60LDRgiDQodC+0YLRgNGD0LTQvdC40LrQsDEZMBcGA1UEBAwQ0KLQtdGB0YLQvtCy0YvQuTFJMEcGA1UECQxAMTA3MDc4LCDQsy4g0JzQvtGB0LrQstCwLCDRg9C7LiDQmtCw0LvQsNC90YfQtdCy0YHQutCw0Y8sINC0LiAyNzEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODE0MDIGA1UEDAwr0JDRgNGF0LjRgtC10LrRgtC+0YAg0L3QsNC/0YDQsNCy0LvQtdC90LjRjzEmMCQGCSqGSIb3DQEJARYXdmJ1cm1pc3Ryb3ZAYWxmYWJhbmsucnUxCzAJBgNVBAYTAlJVMRUwEwYDVQQIDAzQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEjMCEGA1UECgwa0JDQniAi0JDQu9GM0YTQsC3QkdCw0L3QuiIxUDBOBgNVBAsMR9CU0LjRgNC10LrRhtC40Y8g0YDQsNC30YDQsNCx0L7RgtC60Lgg0YbQuNGE0YDQvtCy0YvRhSDRgdC10YDQstC40YHQvtCyMRcwFQYDVQQDDA4xdHJ1c3Rjb3JlLTI1NjBmMB8GCCqFAwcBAQEBMBMGByqFAwICJAAGCCqFAwcBAQICA0MABEA8fBN/QZKE4T03YEHTMTldxRHPF/SdYGSPFEmUMGlrEuLFycdkDBxSFTaFfewyYVTDpJ53/1JGp60sKVFvyvIxo4IE9DCCBPAwDgYDVR0PAQH/BAQDAgOoMB8GCSsGAQQBgjcVBwQSMBAGCCqFAwICLgAIAgEBAgEAMB0GA1UdDgQWBBSXVVvUtLRiPz8231/48DKMZsLbVDAdBgNVHSUEFjAUBggrBgEFBQcDAgYIKwYBBQUHAwQwJwYJKwYBBAGCNxUKBBowGDAKBggrBgEFBQcDAjAKBggrBgEFBQcDBDBxBggrBgEFBQcBAQRlMGMwYQYIKwYBBQUHMAKGVWh0dHA6Ly90ZXN0LXVjMi5tb3Njb3cuYWxmYWludHJhLm5ldC9haWEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcnQwHQYDVR0gBBYwFDAIBgYqhQNkcQEwCAYGKoUDZHECMIIBQwYFKoUDZHAEggE4MIIBNAw00KHQmtCX0JggItCa0YDQuNC/0YLQvtCf0YDQviBDU1AiICjQstC10YDRgdC40Y8gNC4wKQxa0J/QkNCaICLQo9C00L7RgdGC0L7QstC10YDRj9GO0YnQuNC5INGG0LXQvdGC0YAgItCa0YDQuNC/0YLQvtCf0YDQviDQo9CmIiDQstC10YDRgdC40LggMi4wDE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI0LTMwMTAg0L7RgiAzMC4xMi4yMDE2DE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI4LTI5ODMg0L7RgiAxOC4xMS4yMDE2MD8GBSqFA2RvBDYMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQuMCkwgb0GA1UdHwSBtTCBsjBboFmgV4ZVaHR0cDovL3Rlc3QtdWMyLm1vc2Nvdy5hbGZhaW50cmEubmV0L2NkcC82ZjBiMGQ1MjVkMTlhNzQ4YmUwNTE4OTM5N2Q4MDk1NTdkMzg4Y2EyLmNybDBToFGgT4ZNaHR0cDovL2NhLmFsZmFpbnRyYS5uZXQvY2VydGRhdGEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcmwwggFNBgNVHSMEggFEMIIBQIAUbwsNUl0Zp0i+BRiTl9gJVX04jKKhggETpIIBDzCCAQsxGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEqMCgGA1UECQwh0KPQuy4g0JrQsNC70LDQvdGH0LXQstGB0LrQsNGPIDI3MQ8wDQYDVQQLDAbQo9CY0JExITAfBgNVBAoMGNCQ0J4g0JDQm9Cs0KTQkC3QkdCQ0J3QmjE1MDMGA1UEAwws0KLQldCh0KIg0KPQpiAyLjAg0JDQniAi0JDQm9Cs0KTQkC3QkdCQ0J3QmiKCEQWXkJ8A26z9j0tjSIs3FfK5MCsGA1UdEAQkMCKADzIwMjEwMzEyMTA1ODA1WoEPMjAyMjA2MTIxMDU4MDVaMAoGCCqFAwcBAQMCA0EAHvrxKAto/T3htcx89MTL17HjVlLFJMt1rjCg2lg1jhUof6rY4FVArNEOsIRWxhwG8hV8j3rhl15wvpTgmOTvLg==</ds:X509Certificate>
                            </ds:X509Data>
                        </ds:KeyInfo>
                    </ds:Signature>
                </SgntrSt>
            </p:Envlp>
        </p:SplmtryData>
    </p:AcctRptgReq>
</p:Document>
Пример запроса на создание платежа с подписью
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06">
    <CstmrCdtTrfInitn>
        <GrpHdr>
            <MsgId>5077018948_pain_MSG_20170609_00009</MsgId>
            <CreDtTm>2016-12-29T10:10:10+04:00</CreDtTm>
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Nm>Общество с ограниченной ответственностью "Тест"Д.У.</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7728142469</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>5077018948_pain_PKG_20170609_00009</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
            </PmtTpInf>
            <ReqdExctnDt>2016-12-29</ReqdExctnDt>
            <Dbtr>
                <!-- (Реквизит 8) Наименование плательщика: первые 140 символов-->
                <Nm>Общество с ограниченной ответственностью "Тест"Д.У.</Nm>
                <PstlAdr>
                    <Ctry>RU</Ctry>
                </PstlAdr>
                <Id>
                    <OrgId>
                        <Othr>
                            <!-- (Реквизит 60) ИНН плательщика -->
                            <Id>7728142469</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
                <!-- Наименование плательщика: оставшиеся 20 символов  -->
                <!-- <CtctDtls><Nm>BEGIN12345678901END</Nm></CtctDtls> -->

            </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <!-- (Реквизит 9) Счет плательщика -->
                        <Id>40701810101600000059</Id>
                        <SchmeNm>
                            <Cd>BBAN</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>RUR</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <!-- (Реквизит 11) БИК банка плательщика -->
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <!-- (Реквизит 10) Наименование банка плательщика -->
                    <Nm>АО "АЛЬФА-БАНК" Г МОСКВА</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                </FinInstnId>
            </DbtrAgt>
            <DbtrAgtAcct>
                <Id>
                    <Othr>
                        <!-- (Реквизит 12) Корсчет банка плательщика -->
                        <Id>30101810200000000593</Id>
                    </Othr>
                </Id>
            </DbtrAgtAcct>
            <!--  Бюджетный платеж 1 -->
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>5077018948_pain_PMT_20170609_00043</InstrId>
                    <!--(Реквизит 3) Номер документа -->
                    <EndToEndId>20039</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <!-- Вид платежа: NURG - обычные; URGP - срочные -->
                        <Cd>NURG</Cd>
                    </SvcLvl>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">2000.00</InstdAmt>
                </Amt>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <!-- (Реквизит 14) БИК банка получателя -->
                            <MmbId>044525000</MmbId>
                        </ClrSysMmbId>
                        <!-- (Реквизит 13) Наименование банка получателя -->
                        <Nm>ГУ БАНКА РОССИИ ПО ЦФО МОСКВА 35</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <!-- (Реквизит 16) Наименование получателя -->
                    <Nm>УФК ПО Г. МОСКВЕ (ДЕПАРТАМЕНТ ФИНАНСОВ Г.МОСКВЫ, ГКУ ЦССВ "ЮНОНА" ЛС 0314811000930318</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- (Реквизит 61) ИНН получателя -->
                                <Id>7727050871</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <!-- (Реквизит 17) Счет получателя -->
                            <Id>40201810445250000179</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                </CdtrAcct>
                <Purp>
                    <!-- (Очередность 21) Очередность платежа -->
                    <Prtry>5</Prtry>
                </Purp>
                <Tax>
                    <Cdtr>
                        <!-- КПП получателя (103) -->
                        <TaxTp>770301001</TaxTp>
                    </Cdtr>
                    <Dbtr>
                        <!-- КПП плательщика (102) -->
                        <TaxTp>772701001</TaxTp>
                    </Dbtr>
                    <!-- Код ОКТМО (105) -->
                    <AdmstnZn>45908000</AdmstnZn>
                    <!-- Номер налогового документа (108) -->
                    <RefNb>0</RefNb>
                    <!-- Дата налогового документа (109) -->
                    <!-- <Dt>0</Dt> -->
                    <Rcrd>
                        <!-- Код налогового периода (107) -->
                        <!-- <Tp>MM10</Tp> -->
                        <!-- Код основания налогового платежа (106) -->
                        <Ctgy>ТП</Ctgy>
                        <!-- Код бюджетной классификации (104) -->
                        <CtgyDtls>00000000000000000221</CtgyDtls>
                        <!-- Статус составителя документа (101) -->
                        <DbtrSts>08</DbtrSts>
                        <Prd>
                            <!--<Yr>2016-10-01</Yr>-->
                            <FrToDt>
                                <FrDt>2016-10-10</FrDt>
                                <ToDt>2016-10-10</ToDt>
                            </FrToDt>
                        </Prd>
                    </Rcrd>
                </Tax>
                <RmtInf>
                    <Ustrd>КБК 148100204Д0908100244221 л/сч 02732592000 Возврат аванса с договора 243648338 за 2016 год  на основании письм</Ustrd>
                    <Ustrd>а 236от 18.05.17. НДС не облагается.</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <!--4) Дата документа -->
                            <RltdDt>2016-12-29</RltdDt>
                        </RfrdDocInf>
                        <CdtrRefInf>
                            <!-- 22) Код платежа (УИН)-->
                            <Ref>0</Ref>
                        </CdtrRefInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
            <!--  Бюджетный платеж 2-->
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>5077018948_pain_PMT_20170609_00044</InstrId>
                    <!--(Реквизит 3) Номер документа -->
                    <EndToEndId>20040</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <!-- Вид платежа: NURG - обычные; URGP - срочные -->
                        <Cd>NURG</Cd>
                    </SvcLvl>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">800.00</InstdAmt>
                </Amt>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <!-- (Реквизит 14) БИК банка получателя -->
                            <MmbId>044525000</MmbId>
                        </ClrSysMmbId>
                        <!-- (Реквизит 13) Наименование банка получателя -->
                        <Nm>ГУ БАНКА РОССИИ ПО ЦФО МОСКВА 35</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <!-- (Реквизит 16) Наименование получателя -->
                    <Nm>УФК ПО Г. МОСКВЕ (ДЕПАРТАМЕНТ ФИНАНСОВ Г.МОСКВЫ, ГКУ ЦССВ "ЮНОНА" ЛС 0314811000930318</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- (Реквизит 61) ИНН получателя -->
                                <Id>7727050871</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <!-- (Реквизит 17) Счет получателя -->
                            <Id>40201810445250000179</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                </CdtrAcct>
                <Purp>
                    <!-- (Очередность 21) Очередность платежа -->
                    <Prtry>5</Prtry>
                </Purp>
                <Tax>
                    <Cdtr>
                        <!-- КПП плательщика (102) -->
                        <TaxTp>770301001</TaxTp>
                    </Cdtr>
                    <Dbtr>
                        <!-- КПП получателя (103) -->
                        <TaxTp>772701001</TaxTp>
                    </Dbtr>
                    <!-- Код ОКТМО (105) -->
                    <AdmstnZn>45908000</AdmstnZn>
                    <!-- Номер налогового документа (108) -->
                    <RefNb>0</RefNb>
                    <!-- Дата налогового документа (109) -->
                    <!-- <Dt>0</Dt> -->
                    <Rcrd>
                        <!-- Код основания налогового платежа (106) -->
                        <Ctgy>ТП</Ctgy>
                        <!-- Код бюджетной классификации (104) -->
                        <CtgyDtls>00000000000000000221</CtgyDtls>
                        <!-- Статус составителя документа (101) -->
                        <DbtrSts>08</DbtrSts>
                        <Prd>
                            <Yr>2016-10-01</Yr>
                            <!-- Код налогового периода (107) -->
                            <Tp>MM10</Tp>
                        </Prd>
                    </Rcrd>
                </Tax>
                <RmtInf>
                    <Ustrd>КБК 148100204Д0908100244221 л/сч 02732592000 Возврат аванса с договора 243648338 за 2016 год  на основании письм</Ustrd>
                    <Ustrd>а 236от 18.05.17. НДС не облагается.</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <!--4) Дата документа -->
                            <RltdDt>2016-12-29</RltdDt>
                        </RfrdDocInf>
                        <CdtrRefInf>
                            <!-- 22) Код платежа (УИН)-->
                            <Ref>0</Ref>
                        </CdtrRefInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
            <!--  Бюджетный платеж 3 -->
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>5077018948_pain_PMT_20170609_00045</InstrId>
                    <!--(Реквизит 3) Номер документа -->
                    <EndToEndId>20041</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <!-- Вид платежа: NURG - обычные; URGP - срочные -->
                        <Cd>NURG</Cd>
                    </SvcLvl>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">800.00</InstdAmt>
                </Amt>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <!-- (Реквизит 14) БИК банка получателя -->
                            <MmbId>044525000</MmbId>
                        </ClrSysMmbId>
                        <!-- (Реквизит 13) Наименование банка получателя -->
                        <Nm>ГУ БАНКА РОССИИ ПО ЦФО МОСКВА 35</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <!-- (Реквизит 16) Наименование получателя -->
                    <Nm>УФК ПО Г. МОСКВЕ (ДЕПАРТАМЕНТ ФИНАНСОВ Г.МОСКВЫ, ГКУ ЦССВ "ЮНОНА" ЛС 0314811000930318</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- (Реквизит 61) ИНН получателя -->
                                <Id>7727050871</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <!-- (Реквизит 17) Счет получателя -->
                            <Id>40201810445250000179</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                </CdtrAcct>
                <Purp>
                    <!-- (Очередность 21) Очередность платежа -->
                    <Prtry>5</Prtry>
                </Purp>
                <Tax>
                    <Cdtr>
                        <!-- КПП плательщика (102) -->
                        <TaxTp>770301001</TaxTp>
                    </Cdtr>
                    <Dbtr>
                        <!-- КПП получателя (103) -->
                        <TaxTp>772701001</TaxTp>
                    </Dbtr>
                    <!-- Код ОКТМО (105) -->
                    <AdmstnZn>45908000</AdmstnZn>
                    <!-- Номер налогового документа (108) -->
                    <RefNb>0</RefNb>
                    <!-- Дата налогового документа (109) -->
                    <!-- <Dt>0</Dt> -->
                    <Rcrd>
                        <!-- Код основания налогового платежа (106) -->
                        <Ctgy>ТП</Ctgy>
                        <!-- Код бюджетной классификации (104) -->
                        <CtgyDtls>00000000000000000221</CtgyDtls>
                        <!-- Статус составителя документа (101) -->
                        <DbtrSts>08</DbtrSts>
                        <Prd>
                            <Yr>2016-10-01</Yr>
                            <!-- Код налогового периода (107) -->
                            <Tp>QTR2</Tp>
                        </Prd>
                    </Rcrd>
                </Tax>
                <RmtInf>
                    <Ustrd>КБК 148100204Д0908100244221 л/сч 02732592000 Возврат аванса с договора 243648338 за 2016 год  на основании письм</Ustrd>
                    <Ustrd>а 236от 18.05.17. НДС не облагается.</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <!--4) Дата документа -->
                            <RltdDt>2016-12-29</RltdDt>
                        </RfrdDocInf>
                        <CdtrRefInf>
                            <!-- 22) Код платежа (УИН)-->
                            <Ref>0</Ref>
                        </CdtrRefInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
            <!--  Бюджетный платеж 4 -->
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>5077018948_pain_PMT_20170609_00046</InstrId>
                    <!--(Реквизит 3) Номер документа -->
                    <EndToEndId>20042</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <!-- Вид платежа: NURG - обычные; URGP - срочные -->
                        <Cd>NURG</Cd>
                    </SvcLvl>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">800.00</InstdAmt>
                </Amt>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <!-- (Реквизит 14) БИК банка получателя -->
                            <MmbId>044525000</MmbId>
                        </ClrSysMmbId>
                        <!-- (Реквизит 13) Наименование банка получателя -->
                        <Nm>ГУ БАНКА РОССИИ ПО ЦФО МОСКВА 35</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <!-- (Реквизит 16) Наименование получателя -->
                    <Nm>УФК ПО Г. МОСКВЕ (ДЕПАРТАМЕНТ ФИНАНСОВ Г.МОСКВЫ, ГКУ ЦССВ "ЮНОНА" ЛС 0314811000930318</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- (Реквизит 61) ИНН получателя -->
                                <Id>7727050871</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <!-- (Реквизит 17) Счет получателя -->
                            <Id>40201810445250000179</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                </CdtrAcct>
                <Purp>
                    <!-- (Очередность 21) Очередность платежа -->
                    <Prtry>5</Prtry>
                </Purp>
                <Tax>
                    <Cdtr>
                        <!-- КПП плательщика (102) -->
                        <TaxTp>770301001</TaxTp>
                    </Cdtr>
                    <Dbtr>
                        <!-- КПП получателя (103) -->
                        <TaxTp>772701001</TaxTp>
                    </Dbtr>
                    <!-- Код ОКТМО (105) -->
                    <AdmstnZn>45908000</AdmstnZn>
                    <!-- Номер налогового документа (108) -->
                    <RefNb>0</RefNb>
                    <!-- Дата налогового документа (109) -->
                    <!-- <Dt>0</Dt> -->
                    <Rcrd>
                        <!-- Код основания налогового платежа (106) -->
                        <Ctgy>ТП</Ctgy>
                        <!-- Код бюджетной классификации (104) -->
                        <CtgyDtls>00000000000000000221</CtgyDtls>
                        <!-- Статус составителя документа (101) -->
                        <DbtrSts>08</DbtrSts>
                        <Prd>
                            <Yr>2016-10-01</Yr>
                            <!-- Код налогового периода (107) -->
                            <Tp>HLF1</Tp>
                        </Prd>
                    </Rcrd>
                </Tax>
                <RmtInf>
                    <Ustrd>КБК 148100204Д0908100244221 л/сч 02732592000 Возврат аванса с договора 243648338 за 2016 год  на основании письм</Ustrd>
                    <Ustrd>а 236от 18.05.17. НДС не облагается.</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <!--4) Дата документа -->
                            <RltdDt>2016-12-29</RltdDt>
                        </RfrdDocInf>
                        <CdtrRefInf>
                            <!-- 22) Код платежа (УИН)-->
                            <Ref>0</Ref>
                        </CdtrRefInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
            <!--  Бюджетный платеж 5-->
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>5077018948_pain_PMT_20170609_00047</InstrId>
                    <!--(Реквизит 3) Номер документа -->
                    <EndToEndId>20043</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <!-- Вид платежа: NURG - обычные; URGP - срочные -->
                        <Cd>NURG</Cd>
                    </SvcLvl>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">800.00</InstdAmt>
                </Amt>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <!-- (Реквизит 14) БИК банка получателя -->
                            <MmbId>044525000</MmbId>
                        </ClrSysMmbId>
                        <!-- (Реквизит 13) Наименование банка получателя -->
                        <Nm>ГУ БАНКА РОССИИ ПО ЦФО МОСКВА 35</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <!-- (Реквизит 16) Наименование получателя -->
                    <Nm>УФК ПО Г. МОСКВЕ (ДЕПАРТАМЕНТ ФИНАНСОВ Г.МОСКВЫ, ГКУ ЦССВ "ЮНОНА" ЛС 0314811000930318</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- (Реквизит 61) ИНН получателя -->
                                <Id>7727050871</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <!-- (Реквизит 17) Счет получателя -->
                            <Id>40201810445250000179</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                </CdtrAcct>
                <Purp>
                    <!-- (Очередность 21) Очередность платежа -->
                    <Prtry>5</Prtry>
                </Purp>
                <Tax>
                    <Cdtr>
                        <!-- КПП плательщика (102) -->
                        <TaxTp>770301001</TaxTp>
                    </Cdtr>
                    <Dbtr>
                        <!-- КПП получателя (103) -->
                        <TaxTp>772701001</TaxTp>
                    </Dbtr>
                    <!-- Код ОКТМО (105) -->
                    <AdmstnZn>45908000</AdmstnZn>
                    <!-- Номер налогового документа (108) -->
                    <RefNb>0</RefNb>
                    <!-- Дата налогового документа (109) -->
                    <!-- <Dt>0</Dt> -->
                    <Rcrd>
                        <!-- Код основания налогового платежа (106) -->
                        <Ctgy>ТП</Ctgy>
                        <!-- Код бюджетной классификации (104) -->
                        <CtgyDtls>00000000000000000221</CtgyDtls>
                        <!-- Статус составителя документа (101) -->
                        <DbtrSts>08</DbtrSts>
                        <Prd>
                            <Yr>2016-10-01</Yr>
                            <!-- Код налогового периода (107) -->
                            <!--<Tp>HLF01</Tp>-->

                        </Prd>
                    </Rcrd>
                </Tax>
                <RmtInf>
                    <Ustrd>КБК 148100204Д0908100244221 л/сч 02732592000 Возврат аванса с договора 243648338 за 2016 год  на основании письм</Ustrd>
                    <Ustrd>а 236от 18.05.17. НДС не облагается.</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <!--4) Дата документа -->
                            <RltdDt>2016-12-29</RltdDt>
                        </RfrdDocInf>
                        <CdtrRefInf>
                            <!-- 22) Код платежа (УИН)-->
                            <Ref>0</Ref>
                        </CdtrRefInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
            <!--  Бюджетный платеж 6 -->
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>5077018948_pain_PMT_20170609_00048</InstrId>
                    <!--(Реквизит 3) Номер документа -->
                    <EndToEndId>20044</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <!-- Вид платежа: NURG - обычные; URGP - срочные -->
                        <Cd>NURG</Cd>
                    </SvcLvl>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">800.00</InstdAmt>
                </Amt>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <!-- (Реквизит 14) БИК банка получателя -->
                            <MmbId>044525000</MmbId>
                        </ClrSysMmbId>
                        <!-- (Реквизит 13) Наименование банка получателя -->
                        <Nm>ГУ БАНКА РОССИИ ПО ЦФО МОСКВА 35</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <!-- (Реквизит 16) Наименование получателя -->
                    <Nm>УФК ПО Г. МОСКВЕ (ДЕПАРТАМЕНТ ФИНАНСОВ Г.МОСКВЫ, ГКУ ЦССВ "ЮНОНА" ЛС 0314811000930318</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- (Реквизит 61) ИНН получателя -->
                                <Id>7727050871</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <!-- (Реквизит 17) Счет получателя -->
                            <Id>40201810445250000179</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                </CdtrAcct>
                <Purp>
                    <!-- (Очередность 21) Очередность платежа -->
                    <Prtry>5</Prtry>
                </Purp>
                <Tax>
                    <Cdtr>
                        <!-- Код таможенного органа -->
                        <RegnId>10001010</RegnId>
                        <!-- КПП плательщика (102) -->
                        <TaxTp>770301001</TaxTp>
                    </Cdtr>
                    <Dbtr>
                        <!-- КПП получателя (103) -->
                        <TaxTp>772701001</TaxTp>
                    </Dbtr>
                    <!-- Код ОКТМО (105) -->
                    <AdmstnZn>45908000</AdmstnZn>
                    <!-- Номер налогового документа (108) -->
                    <RefNb>0</RefNb>
                    <!-- Дата налогового документа (109) -->
                    <!-- <Dt>0</Dt> -->
                    <Rcrd>
                        <!-- Код основания налогового платежа (106) -->
                        <Ctgy>ТП</Ctgy>
                        <!-- Код бюджетной классификации (104) -->
                        <CtgyDtls>00000000000000000221</CtgyDtls>
                        <!-- Статус составителя документа (101) -->
                        <DbtrSts>08</DbtrSts>
                        <!--<Prd>-->
                        <!--<Yr>2016-10-01</Yr>-->
                        <!-- Код налогового периода (107) -->
                        <!--<Tp>HLF01</Tp>-->
                        <!--</Prd>-->

                    </Rcrd>
                </Tax>
                <RmtInf>
                    <Ustrd>КБК 148100204Д0908100244221 л/сч 02732592000 Возврат аванса с договора 243648338 за 2016 год  на основании письм</Ustrd>
                    <Ustrd>а 236от 18.05.17. НДС не облагается.</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <!--4) Дата документа -->
                            <RltdDt>2016-12-29</RltdDt>
                        </RfrdDocInf>
                        <CdtrRefInf>
                            <!-- 22) Код платежа (УИН)-->
                            <Ref>0</Ref>
                        </CdtrRefInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
            <!--  Бюджетный платеж 7 -->
            <CdtTrfTxInf>
                <PmtId>
                    <InstrId>5077018948_pain_PMT_20170609_00049</InstrId>
                    <!--(Реквизит 3) Номер документа -->
                    <EndToEndId>20045</EndToEndId>
                </PmtId>
                <PmtTpInf>
                    <SvcLvl>
                        <!-- Вид платежа: NURG - обычные; URGP - срочные -->
                        <Cd>NURG</Cd>
                    </SvcLvl>
                </PmtTpInf>
                <Amt>
                    <InstdAmt Ccy="RUR">800.00</InstdAmt>
                </Amt>
                <ChrgBr>DEBT</ChrgBr>
                <CdtrAgt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <!-- (Реквизит 14) БИК банка получателя -->
                            <MmbId>044525000</MmbId>
                        </ClrSysMmbId>
                        <!-- (Реквизит 13) Наименование банка получателя -->
                        <Nm>ГУ БАНКА РОССИИ ПО ЦФО МОСКВА 35</Nm>
                        <PstlAdr>
                            <Ctry>RU</Ctry>
                        </PstlAdr>
                    </FinInstnId>
                </CdtrAgt>
                <Cdtr>
                    <!-- (Реквизит 16) Наименование получателя -->
                    <Nm>УФК ПО Г. МОСКВЕ (ДЕПАРТАМЕНТ ФИНАНСОВ Г.МОСКВЫ, ГКУ ЦССВ "ЮНОНА" ЛС 0314811000930318</Nm>
                    <PstlAdr>
                        <Ctry>RU</Ctry>
                    </PstlAdr>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- (Реквизит 61) ИНН получателя -->
                                <Id>7727050871</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Cdtr>
                <CdtrAcct>
                    <Id>
                        <Othr>
                            <!-- (Реквизит 17) Счет получателя -->
                            <Id>40201810445250000179</Id>
                            <SchmeNm>
                                <Cd>BBAN</Cd>
                            </SchmeNm>
                        </Othr>
                    </Id>
                </CdtrAcct>
                <Purp>
                    <!-- (Очередность 21) Очередность платежа -->
                    <Prtry>5</Prtry>
                </Purp>
                <Tax>
                    <Cdtr>
                        <!-- Код таможеного органа -->
                        <!--<RegnId>10001010</RegnId>-->
                        <!-- КПП плательщика (102) -->
                        <TaxTp>770301001</TaxTp>
                    </Cdtr>
                    <Dbtr>
                        <!-- КПП получателя (103) -->
                        <TaxTp>772701001</TaxTp>
                    </Dbtr>
                    <!-- Код ОКТМО (105) -->
                    <AdmstnZn>45908000</AdmstnZn>
                    <!-- Номер налогового документа (108) -->
                    <RefNb>0</RefNb>
                    <!-- Дата налогового документа (109) -->
                    <!-- <Dt>0</Dt> -->
                    <Rcrd>
                        <!-- Код основания налогового платежа (106) -->
                        <Ctgy>ТП</Ctgy>
                        <!-- Код бюджетной классификации (104) -->
                        <CtgyDtls>00000000000000000221</CtgyDtls>
                        <!-- Статус составителя документа (101) -->
                        <DbtrSts>08</DbtrSts>
                        <!--<Prd>-->
                        <!--<Yr>2016-10-01</Yr>-->
                        <!-- Код налогового периода (107) -->
                        <!--<Tp>HLF01</Tp>-->
                        <!--</Prd>-->

                    </Rcrd>
                </Tax>
                <RmtInf>
                    <Ustrd>КБК 148100204Д0908100244221 л/сч 02732592000 Возврат аванса с договора 243648338 за 2016 год  на основании письм</Ustrd>
                    <Ustrd>а 236от 18.05.17. НДС не облагается.</Ustrd>
                    <Strd>
                        <RfrdDocInf>
                            <Tp>
                                <CdOrPrtry>
                                    <Prtry>POD</Prtry>
                                </CdOrPrtry>
                            </Tp>
                            <!--4) Дата документа -->
                            <RltdDt>2016-12-29</RltdDt>
                        </RfrdDocInf>
                        <CdtrRefInf>
                            <!-- 22) Код платежа (УИН)-->
                            <Ref>0</Ref>
                        </CdtrRefInf>
                    </Strd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                    <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="sigID1">
                        <ds:SignedInfo>
                            <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
                            <ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>
                            <ds:Reference URI="">
                                <ds:Transforms>
                                    <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
                                    <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
                                </ds:Transforms>
                                <ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>
                                <ds:DigestValue>G9fMRgLYB7W1cNesvibvobx7O9hETbAuHOM0OutMlbk=</ds:DigestValue>
                            </ds:Reference>
                        </ds:SignedInfo>
                        <ds:SignatureValue>SmiHpm6DaKWHXD1sQKSdRjSUtBTUhBgSVxf8Zm87LyrzKlU4oQmZzI125/L+lZp6GJrDFv96aP7u0W1US8IxgA==</ds:SignatureValue>
                        <ds:KeyInfo>
                            <ds:X509Data>
                                <ds:X509Certificate>MIIJAzCCCLCgAwIBAgIRBTd/twDprFm+QYXHcVcbqLQwCgYIKoUDBwEBAwIwggELMRgwFgYFKoUDZAESDTEwMjc3MDAwNjczMjgxGjAYBggqhQMDgQMBARIMMDA3NzI4MTY4OTcxMQswCQYDVQQGEwJSVTEYMBYGA1UECAwPNzcg0JzQvtGB0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxKjAoBgNVBAkMIdCj0LsuINCa0LDQu9Cw0L3Rh9C10LLRgdC60LDRjyAyNzEPMA0GA1UECwwG0KPQmNCRMSEwHwYDVQQKDBjQkNCeINCQ0JvQrNCk0JAt0JHQkNCd0JoxNTAzBgNVBAMMLNCi0JXQodCiINCj0KYgMi4wINCQ0J4gItCQ0JvQrNCk0JAt0JHQkNCd0JoiMB4XDTIxMDMxMjEwNTgwNloXDTIyMDYxMjExMDgwNlowggH5MTIwMAYDVQQqDCnQodC10YDRgtC40YTQuNC60LDRgiDQodC+0YLRgNGD0LTQvdC40LrQsDEZMBcGA1UEBAwQ0KLQtdGB0YLQvtCy0YvQuTFJMEcGA1UECQxAMTA3MDc4LCDQsy4g0JzQvtGB0LrQstCwLCDRg9C7LiDQmtCw0LvQsNC90YfQtdCy0YHQutCw0Y8sINC0LiAyNzEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODE0MDIGA1UEDAwr0JDRgNGF0LjRgtC10LrRgtC+0YAg0L3QsNC/0YDQsNCy0LvQtdC90LjRjzEmMCQGCSqGSIb3DQEJARYXdmJ1cm1pc3Ryb3ZAYWxmYWJhbmsucnUxCzAJBgNVBAYTAlJVMRUwEwYDVQQIDAzQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEjMCEGA1UECgwa0JDQniAi0JDQu9GM0YTQsC3QkdCw0L3QuiIxUDBOBgNVBAsMR9CU0LjRgNC10LrRhtC40Y8g0YDQsNC30YDQsNCx0L7RgtC60Lgg0YbQuNGE0YDQvtCy0YvRhSDRgdC10YDQstC40YHQvtCyMRcwFQYDVQQDDA4xdHJ1c3Rjb3JlLTI1NjBmMB8GCCqFAwcBAQEBMBMGByqFAwICJAAGCCqFAwcBAQICA0MABEA8fBN/QZKE4T03YEHTMTldxRHPF/SdYGSPFEmUMGlrEuLFycdkDBxSFTaFfewyYVTDpJ53/1JGp60sKVFvyvIxo4IE9DCCBPAwDgYDVR0PAQH/BAQDAgOoMB8GCSsGAQQBgjcVBwQSMBAGCCqFAwICLgAIAgEBAgEAMB0GA1UdDgQWBBSXVVvUtLRiPz8231/48DKMZsLbVDAdBgNVHSUEFjAUBggrBgEFBQcDAgYIKwYBBQUHAwQwJwYJKwYBBAGCNxUKBBowGDAKBggrBgEFBQcDAjAKBggrBgEFBQcDBDBxBggrBgEFBQcBAQRlMGMwYQYIKwYBBQUHMAKGVWh0dHA6Ly90ZXN0LXVjMi5tb3Njb3cuYWxmYWludHJhLm5ldC9haWEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcnQwHQYDVR0gBBYwFDAIBgYqhQNkcQEwCAYGKoUDZHECMIIBQwYFKoUDZHAEggE4MIIBNAw00KHQmtCX0JggItCa0YDQuNC/0YLQvtCf0YDQviBDU1AiICjQstC10YDRgdC40Y8gNC4wKQxa0J/QkNCaICLQo9C00L7RgdGC0L7QstC10YDRj9GO0YnQuNC5INGG0LXQvdGC0YAgItCa0YDQuNC/0YLQvtCf0YDQviDQo9CmIiDQstC10YDRgdC40LggMi4wDE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI0LTMwMTAg0L7RgiAzMC4xMi4yMDE2DE/QodC10YDRgtC40YTQuNC60LDRgiDRgdC+0L7RgtCy0LXRgtGB0YLQstC40Y8g4oSWINCh0KQvMTI4LTI5ODMg0L7RgiAxOC4xMS4yMDE2MD8GBSqFA2RvBDYMNNCh0JrQl9CYICLQmtGA0LjQv9GC0L7Qn9GA0L4gQ1NQIiAo0LLQtdGA0YHQuNGPIDQuMCkwgb0GA1UdHwSBtTCBsjBboFmgV4ZVaHR0cDovL3Rlc3QtdWMyLm1vc2Nvdy5hbGZhaW50cmEubmV0L2NkcC82ZjBiMGQ1MjVkMTlhNzQ4YmUwNTE4OTM5N2Q4MDk1NTdkMzg4Y2EyLmNybDBToFGgT4ZNaHR0cDovL2NhLmFsZmFpbnRyYS5uZXQvY2VydGRhdGEvNmYwYjBkNTI1ZDE5YTc0OGJlMDUxODkzOTdkODA5NTU3ZDM4OGNhMi5jcmwwggFNBgNVHSMEggFEMIIBQIAUbwsNUl0Zp0i+BRiTl9gJVX04jKKhggETpIIBDzCCAQsxGDAWBgUqhQNkARINMTAyNzcwMDA2NzMyODEaMBgGCCqFAwOBAwEBEgwwMDc3MjgxNjg5NzExCzAJBgNVBAYTAlJVMRgwFgYDVQQIDA83NyDQnNC+0YHQutCy0LAxFTATBgNVBAcMDNCc0L7RgdC60LLQsDEqMCgGA1UECQwh0KPQuy4g0JrQsNC70LDQvdGH0LXQstGB0LrQsNGPIDI3MQ8wDQYDVQQLDAbQo9CY0JExITAfBgNVBAoMGNCQ0J4g0JDQm9Cs0KTQkC3QkdCQ0J3QmjE1MDMGA1UEAwws0KLQldCh0KIg0KPQpiAyLjAg0JDQniAi0JDQm9Cs0KTQkC3QkdCQ0J3QmiKCEQWXkJ8A26z9j0tjSIs3FfK5MCsGA1UdEAQkMCKADzIwMjEwMzEyMTA1ODA1WoEPMjAyMjA2MTIxMDU4MDVaMAoGCCqFAwcBAQMCA0EAHvrxKAto/T3htcx89MTL17HjVlLFJMt1rjCg2lg1jhUof6rY4FVArNEOsIRWxhwG8hV8j3rhl15wvpTgmOTvLg==</ds:X509Certificate>
                            </ds:X509Data>
                        </ds:KeyInfo>
                    </ds:Signature>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

Получение тестовых сертификатов

Для выпуска тестовых сертификатов необходимо:

  1. Перейти по ссылке: https://www.cryptopro.ru/certsrv/certrqma.asp

  2. Ответить "да" на сообщение: разрешить ли эту операцию?

  3. Заполнить все поля (используются латинские буквы):

    • Имя - для кого выдается сертификат

    • Электронная почта

    • Организация

    • Подразделение

    • Город

    • Штат

    • Страна (RU)

    • Использование ключей: Подпись

    • Заданное пользователем имя контейнера

  4. Нажать "Выдать"

  5. Появится окно КриптоПро CSP с выбором носителя. Выбирать путь для хранения (если устанавливается ключ на компьютер, необходимо выбрать папку «Личное»).

  6. Биологический датчик: необходимо случайным образом перемещать курсор мыши внутри окна до заполнения полосы загрузки.

  7. Нажать "Установить этот сертификат"

  8. Ввести пароль.

  9. На носителе должна сохраниться папка с ключами.

Для выгрузки открытого ключа сертификата необходимо:

  1. Открыть программу Certificates от КриптоПро

  2. Перейти "Certificates - Current User" → "Личное" → "Сертификаты"

  3. Найти сертификат по имени

  4. Открыть "Мастер экспорта сертификатов" (Кликнуть правой кнопкой мыши по сертификату и перейти "Все задачи" → "Экспорт…​")

  5. Нажать кнопку "Далее"

  6. Выбрать пункт "Нет, не экспортировать закрытый ключ" и нажать "Далее"

  7. Выбрать пункт "Файлы Х.509 (.CER) в кодировке DER" и нажать "Далее"

  8. Нажать обзор, указать директорию, куда сохранится файл, указать имя файла, нажать кнопку "Сохранить" и нажать "Далее"

  9. Нажать кнопку "Готово"

  10. Экспорт успешно выполнен.

  11. Отправить открытый ключ в архиве .zip на адрес akopyltsova@alfabank.ru с темой «Подключение к тестовому стенду Host-to-host»

34. FAQ

Вопрос Решение

При запросе статуса документа текст в теге AddtInf имеет неправильную кодировку.

Необходимо отправлять запрос, явно указывая кодировку UTF-8. Например, при тестировании в SOAPUI необходимо в properties указать Encoding=UTF-8.

Ответы на запросы платежей и выписок от банка должны приходить подписанными.

Необходимо добавить в запрос хедер sign = true.

Какой сертификат нужно отправить для подключения к Альфа-Линк?

Необходимо на почту alfa-link@alfabank.ru прислать публичный (открытый) ключ квалифицированного сертификата (алгоритм подписи ГОСТ-2012) для подписания платежей. Подходят сертификаты, которые используются, например, для сдачи отчетности в налоговую. Сертификат должен быть выпущен на уполномоченное лицо, которое подключается к Альфа-линк. Если сертификата нет, то его можно выпустить в любом аккредитованном удостоверяющем центре.

В статусе документа ошибка:

…​ '<значение поля>' is not a valid value for '<тег>'.

или

…​ The value '<значение поля>' of attribute '<тег>' on element '<родительский тег>' is not valid with respect to its type, '<тег>'.

и похожие.

Отправленный документ не соответствует схеме.

Проверьте, что указанные в ошибке поля не пропущены и заполнены в соответствии с документацией.

В статусах документов приходит ошибка:

…​ '0' is not a valid value for 'NCName'. …​ The value '0' of attribute 'Id' on element 'Signature' is not valid with respect to its type, 'ID'.

Ошибка возникает из-за неверного значения в поле Signature@Id, рекомендуется использовать нумерацию "SigId1", "SigId2", "SigId3" и т.д.

35. ChangeLog

Текущая версия: V1.21

V 1.21 (10.05.2023)

  • Обновлено описание раздела внесения изменений в I раздел ВБК.

  • Тэг "Дата начала договора" изменен с "DtOfIsse" на "StartDt" в постановке на учет внешнеторгового контракта

  • Добавлен пример корректного блока Attchmnt для внесения изменений в I раздел ВБК

V 1.20 (17.04.2023)

  • Обновлено описание выписки (запроса и ответа).

  • Обновлены тестовые данные.

  • Исправлена ошибка в обязательности поля "Отчество сотрудника" в зарплатной ведомости.

  • Добавлена информация об SSL сертификате от Минцифры.

V 1.19 (29.03.2023)

  • Добавлено описание запроса на снятие контракта с учета.

  • Добавлено описание запроса на внесение изменений в I раздел ВБК.

  • Обновлена Postman коллекция.

  • В зп ведомость добавлен БИК для отправки зарплаты в сторонние банки.

  • Удален тэг "Rcvr" для отправки писем в Банк и при запросе списка входящих писем.

  • Обновлены примеры запроса писем из Банка и получения статуса по ним.

  • Описание категорий писем приведено к формату Клиент-банка.

  • Обновлена английская версия (добавлены: зарплатная ведомость, онлайн остаток и запрос выписки без подписи).

V 1.18 (07.12.2022)

  • Обновлена документация платёжного поручения.

  • Исправлен пример печатной формы СПД.

V 1.17 (14.11.2022)

  • Изменен адрес тестового стенда

  • Добавлено описание сервиса получения печатной формы ВП/ПП.

  • Поле "ФИО сотрудника" в зарплатной ведомости разделено на 3 разных тега.

  • Добавлено описание запроса выписки без подписи.

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

  • Скорректирована информация по бизнес группам.

  • Обновлены тестовые данные по компаниям ООО "Тест Альфа-Линк ЗУП" и ООО "Тест Альфа-Линк ЗУП (2 подписи)".

  • Скорректирована информация по статусам ведомости банковского контроля.

V 1.16 (25.08.2022)

  • Добавлено описание работы отзыва платежа.

  • Внесены корректировки об обязательности некоторых элементов.

  • Добавлены примеры заполнения Платежного поручения, Валютного перевода, СВО, СПД полями ISO.

  • Добавлено описание получения Ведомости банковского контроля

V 1.15 (10.06.2022)

  • Добавлено описание работы с открытием ЛС.

  • Обновлена ссылка с примерами реализации и подписанных документов.

  • Внесены корректировки в таблицу кодов ответа зарплатной ведомости.

  • Добавлена бизнес группа "Управление зарплатным проектом (з/п ведомость, открытие ЛС)".

  • Изменен порядок полей в описании схемы зарплатной ведомости.

  • Добавлена информация о получении онлайн остатков по счету.

  • В тестовых компаниях добавлены комментарии для каких платежей используются поля.

  • Исправлены ошибки в описании РСТС.

  • Для получателя исправлен номер счёта USD при формировании платежей.

  • Добавлены примеры методов для работы с вложенными файлами в постман-коллекцию.

  • Изменены хедеры, содержащие нижние подчёркивания.

V 1.14 (03.03.2022)

  • Добавлена справочная информация о необязательных тегах.

  • Добавлена Postman-коллекция для облегчения процесса тестирования.

  • Добавлена информация о получении финальных статусов документов.

  • Добавлена информация об отображении платежей в АЛБО.

  • Скорректирован раздел Обмен валют.

  • Обновлены примеры подписи.

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

  • Исправлены опечатки.

  • Добавлены авторизационные данные для тестового стенда.

  • Изменены категории для запроса списка писем.

  • Скорректирован список возможных ошибок для выписки, добавлено описание поля Код операции.

  • Скорректировано описание полей для СВО.

  • Доработано описание формата РСТС.

  • Добавлено описание работы с зарплатной ведомостью.

V 1.13 (06.09.2021)

  • Используются реквизиты новых тестовых организаций.

  • Переработан раздел Письма.

  • Добавлены примеры для документов.

  • Описана связка СВО с ВП и РСТС.

  • Исправлены поля валютного перевода.

  • Обновлён пример валютного перевода.

  • Добавлена информация по тестированию во Введении.

  • Добавлены тестовые сертификаты.

  • Добавлена инструкция по получению сертификата.

V 1.12 (16.08.2021)

  • Обновлена английская версия (добавлены платежи и выписка).

  • Добавлены примеры документов.

  • Исправлены описания полей для контрактов.

  • Добавлено описание промежуточной выписки.

  • Обновлён раздел с письмами.

  • Обновлены реквизиты тестовой компании во всех примерах.

  • Описаны теги для связывания СВО с ВП и РСТС.

  • Добавлено описание тегов для вложений.

  • Пронумерованы разделы первого уровня.

V 1.11 (21.05.2021)

  • Исправлена опечатка в URL СПД.

  • Добавлен пример СПД.

  • Добавлен раздел FAQ.

  • В платёжном поручении в полях 5 и 6 исправлен путь.

  • Добавлена информация о поле Signature@Id и исправлена вёрстка блока с подписью.

  • В выписку добавлены поля по рублёвым эквивалентам для оборотов.

  • Добавлено поле CtctDtls.Nm в выписку с платёжным поручением.