1. Введение

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

Важно

Для обеспечения безопасности обмена сообщениями по стандарту ISO 20022 не используйте протокол HTTP.
Весь обмен осуществляется исключительно через протокол HTTPS с применением шифрования TLS версии 1.2 и выше.

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

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

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

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

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

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

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

  • Письма

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

  • Депозиты

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

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

  • Две подписи

  • Три подписи

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

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

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

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

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

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

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

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

Важно

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

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

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

Для адреса тестового стенда установлен TSL сертификат безопасности Минцифры.
Чтобы не возникло проблем с доступом к функционалу Альфа-Линк, рекомендуем вручную установить корневой сертификат в операционную систему компьютера/сервера.
Подробнее об установке можно узнать по ссылке: 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

40702810100000000183

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

Счёт USD

40702840200000000529

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

Счёт EUR

40702978200000000064

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

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

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

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

AO "ALFA-BANK"

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

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

27, KALANCHYOVSKAYA UL. MOSCOW RUSSIAN FEDERATION

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

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

30101810200000000593

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

БИК банка

044525593

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

SWIFT-код банка

ALFARUMM

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

Идентификатор организации

1a1568e4305944879f779539b0f2069d

Для тестирования без расчетного счета

УНК

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

40702810900000001230

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

Счёт USD

40702840200000000820

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

Счёт EUR

40702978000000000099

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

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

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

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

AO "ALFA-BANK"

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

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

27, KALANCHYOVSKAYA UL. MOSCOW RUSSIAN FEDERATION

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

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

30101810200000000593

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

БИК банка

044525593

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

SWIFT-код банка

ALFARUMM

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

Идентификатор организации

f17261a75cf844eca97ab51a447a0dcf

Для тестирования без расчетного счета

УНК

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

40702810800000500132

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

Счёт USD

40702840600000000734

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

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

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

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

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

AO "ALFA-BANK"

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

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

27, KALANCHYOVSKAYA UL. MOSCOW RUSSIAN FEDERATION

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

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

30101810200000000593

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

БИК банка

044525593

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

SWIFT-код банка

ALFARUMM

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

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

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

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

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

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

ИНН

6306253384

КПП

212444844

Счёт RUB

40702810800000100053

Счёт USD

40702840700000000757

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

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

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

30101810200000000593

БИК банка

044525593

Идентификатор организации (для тестирования без расчетного счета)

c0be9471c3bf40bb9d845c6b17f0351a

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

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

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

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

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

ИНН

0664010623

КПП

051121188

Счёт RUB

40702810400000002221

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

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

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

30101810200000000593

БИК банка

044525593

SWIFT-код банка

ALFARUMM

Идентификатор организации (для тестирования без расчетного счета)

6a74311aeb854ee495a880e28280e714

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

00MP0M

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

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

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

40817810404040000640

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

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

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

40817810704040000641

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

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

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

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

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

ИНН

0435497780

КПП

036287882

Счёт RUB

40702810700000002222

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

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

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

30101810200000000593

БИК банка

044525593

SWIFT-код банка

ALFARUMM

Идентификатор организации (для тестирования без расчетного счета)

e2c9cc958afe4252a2d8217ef900fd67

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

00MP1A

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

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

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

40817810804040000680

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

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

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

40817810104040000681

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

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

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

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

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

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

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

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

Настоятельно рекомендуем использовать сертификаты из архива данной документации.

Если есть причина, по которой требуется использование собственных сертификатов, то обратите внимание, что для тестирования подходят только самоподписанные сертификаты!

Важно

Сертификаты, выпущенные в КриптоПро, НЕ подходят для тестирования.

Необходимо предоставить открытую часть ключа электронной подписи, который будет использоваться для подписания запросов, в формате *.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>

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

Платежи СБП для B2B

Get incoming b2b payments by link

GET

/API/v1/ISO20022/Payments/B2B/PaymentList

Запрос входящих платежей по ссылке/qr

Create b2b payment link

POST

/API/v1/ISO20022/Payments/B2B/Link

Создание платежной ссылки В2В

Get payment information by link

GET

/API/v1/ISO20022/Payments/B2B/LinkPaymentInfo/<qrcId>

Получение платежной информации по ссылке

Create outgoing payment

POST

/API/v1/ISO20022/Payments/B2B/Payment

Создание исходящего платежа В2В

Get outgoing payment status

GET

/API/v1/ISO20022/Payments/B2B/PaymentStatus/<PaymentId>

Получение статуса исходящего платежа

Платежи СБП для B2С

Create outgoing payment

POST

/API/v1/ISO20022/Payments/B2C/Payment

Создание исходящего платежа В2C

Get bank list for phone number

GET

/API/v1/ISO20022/Payments/B2C/BankList

Получение списка банков участников СБП из НСПК

Get report on payments by package/period/transaction

POST

/API/v1/ISO20022/Payments/B2C/Report

Получение отчёта по платежам в разрезе пакета/периода/транзакции

Депозиты

Get offers

POST

/API/v1/ISO20022/Deposits/Offers

Получение Оферты

Accept offer

POST

/API/v1/ISO20022/Deposits

Акцепт Оферты

Get Deal status by ID

GET

/API/v1/ISO20022/Deposits/<MsgId>

Статус Сделки

Get Deal Conclusion Report by ID

GET

/API/v1/ISO20022/Deposits/<MsgId>/Report

Отчет о заключении Сделки

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. Клиентам необходимо самим контролировать попадание текущей даты в период запроса для получения выписки в нужном формате.

Ограничение

С 17.04.2024 вводится ограничение на максимальный период выписки в одном запросе. Он составляет 14 календарных дней.
Для получения выписки за больший период выполните несколько разных запросов c разделением на несколько периодов.
Банк без предварительного уведомления клиентов может менять максимальный период по своему усмотрению.

Важно

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

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

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

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

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

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

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

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

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

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

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

URI

POST: /API/v1/ISO20022/Statements

XSD схема

camt.060.001.03

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

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

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

1

R

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

GrpHdr.MsgId

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

2

R

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

GrpHdr.CreDtTm

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

3

O

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

MsgSndr.Pty.Id.OrgId.Othr.Id

-

4

R

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

RptgReq.Id

-

5

R

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

RptgReq.ReqdMsgNmId

Константа "HMQSTASCF"

6

R

Номер счета

RptgReq.Acct.Id.Othr.Id

Номер счета по которому запрашивается выписка

7

R

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

RptgReq.AcctOwnr.Pty.Nm

-

8

R

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

RptgReq.RptgPrd.FrToDt.FrDt

yyyy-mm-dd

9

R

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

RptgReq.RptgPrd.FrToDt.ToDt

yyyy-mm-dd

10

R

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

RptgReq.RptgPrd.FrToTm.FrTm

00:00:00

11

R

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

RptgReq.RptgPrd.FrToTm.ToTm

24:00:00

12

R

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

RptgReq.RptgPrd.Tp

Константа "ALLL"

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

13

O

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Ответ

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

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

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

200

OK

-

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

400

Err

FrDt/ToDt is in the future

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

400

Err

A date period is not specified

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

400

Err

FrDt is later than ToDt

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

400

Err

XML does not match schema

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

400

Err

MsgId is not unique

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

400

Err

Duration period cannot exceed 14 days

Период не может превышать 14 дней

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

Шлюз не отвечает
Пример запроса выписки 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
    <AcctRptgReq>
        <GrpHdr>
            <MsgId>MsgId_Test_784817266</MsgId>
            <CreDtTm>2024-04-12T08:58:47.150</CreDtTm>
            <MsgSndr>
                <Pty>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                </Pty>
            </MsgSndr>
        </GrpHdr>
        <RptgReq>
            <Id>Id_Test_784817266</Id>
            <ReqdMsgNmId>HMQSTASCF</ReqdMsgNmId>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                    </Othr>
                </Id>
            </Acct>
            <AcctOwnr>
                <Pty>
                    <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
                </Pty>
            </AcctOwnr>
            <RptgPrd>
                <FrToDt>
                    <FrDt>2024-04-05</FrDt>
                    <ToDt>2024-04-12</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

O

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

Bal[1].Tp.CdOrPrtry.Cd

Константа 'OPBD'

17

O

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

Bal[1].Amt@Ccy

-

18

O

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

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

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

19

O

Дата баланса

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

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

20

O

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

Bal[1].Avlbty.Amt

Amt@Ccy="RUR"

21

O

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

Bal[2].Tp.CdOrPrtry.Cd

Константа 'CLBD'

22

O

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

Bal[2].Amt@Ccy

-

23

O

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

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

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

24

O

Дата баланса

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

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

25

O

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

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 символов
Детали строки выписки
№ R/
O		 Описание Путь Комментарий/
Пример

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

R

Дата перевода

RmtInf.Strd[1].RfrdDocInf.RltdDt

-

33

O

Код УИН (22)

RmtInf.Strd[1].CdtrRefInf.Ref

-

34

R

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

Purp.Prtry

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

35

R

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

Chrgs.Rcrd.Br

-

36

O

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

Chrgs.Rcrd.Agt.FinInstnId.Othr.Id

-

37

O

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

AmtDtls.PrtryAmt.Amt

@Ccy="RUB"

38

O

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

RmtInf.Strd.AddtlRmtInf[1..2]

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

39

R

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

Amt@Ccy

-

40

O

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

SplmtryData.Envlp.Notif.Nuved

-

41

O

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

SplmtryData.Envlp.Notif.Dtuv

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

42

O

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

SplmtryData.Envlp.Notif.Dtcpd

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

43

O

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

SplmtryData.Envlp.Notif.Bviol

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

44

O

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

SplmtryData.Envlp.NumSB

-

45

O

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

Refs.TxId

-

46

O

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

Tax.Rcrd.Tp

-

47

O

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

AmtDtls.PrtryAmt.Tp

-

48

O

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

AmtDtls.PrtryAmt.Amt@Ccy

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

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

49

O

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

Tax.Rcrd.DbtrSts

-

50

O

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

Tax.Dbtr.TaxTp

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

51

O

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

Tax.Cdtr.TaxTp

-

52

O

КБК (104)

Tax.Rcrd.CtgyDtls

-

53

O

ОКТМО (105)

Tax.AdmstnZn

-

54

O

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

Tax.Rcrd.Ctgy

-

55

O

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

Tax.Rcrd.Prd.Yr

-

56

O

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

Tax.Rcrd.Prd.Tp

-

57

O

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

Tax.Rcrd.Prd.FrToDt.FrDt

-

58

O

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

Tax.Rcrd.Prd.FrToDt.ToDt

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

59

O

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

Tax.Cdtr.RegnId

-

60

O

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

Tax.RefNb

-

61

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

R

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

RmtInf.Strd[1].RfrdDocInf.RltdDt

-

26

O

Код УИН (22)

RmtInf.Strd[1].CdtrRefInf.Ref

-

27

R

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

Purp.Prtry

-

28

O

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

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

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

29

O

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

RmtInf.Strd[1].TaxRmt.Dt

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

30

O

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

RmtInf.Strd[2].TaxRmt.AdmstnZone

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

31

O

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

RmtInf.Strd[3].TaxRmt.Dt

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

32

R

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

Chrgs.Rcrd.Amt@Ccy

-

33

R

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

Amt@Ccy

-

34

O

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

SplmtryData.Envlp.Notif.Nuved

-

35

O

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

SplmtryData.Envlp.Notif.Dtuv

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

36

O

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

SplmtryData.Envlp.Notif.Dtcpd

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

37

O

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

SplmtryData.Envlp.Notif.Bviol

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

38

O

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

SplmtryData.Envlp.NumSB

-

39

O

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

Refs.TxId

-

40

O

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

Tax.Rcrd.Tp

-

41

O

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

AmtDtls.PrtryAmt.Tp

-

42

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

R

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

RmtInf.Ustrd[1..2]

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

27

R

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

RmtInf.Strd.RfrdDocInf.RltdDt

-

28

О

Код УИН (22)

RmtInf.Strd.CdtrRefInf.Ref

-

29

R

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

SplmtryData.Envlp.DocRcvDt

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

30

R

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

SplmtryData.Envlp.DocWrOffDt

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

31

R

Вид платежа

SplmtryData.Envlp.PmtType

-

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

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

Tax.Dbtr.TaxTp

-

43

O

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

Tax.Cdtr.TaxTp

-

44

O

КБК (104)

Tax.Rcrd.CtgyDtls

-

45

O

ОКТМО (105)

Tax.AdmstnZn

-

46

O

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

Tax.Rcrd.Ctgy

-

47

O

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

Tax.Rcrd.Prd.Yr

-

48

O

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

Tax.Rcrd.Prd.Tp

49

O

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

Tax.Rcrd.Prd.FrToDt.FrDt

-

50

O

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

Tax.Rcrd.Prd.FrToDt.ToDt

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

51

O

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

Tax.Cdtr.RegnId

-

52

O

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

Tax.RefNb

-

53

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

O

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

Purp.Prtry

-

26

R

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

RmtInf.Ustrd[1..2]

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

27

R

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

RmtInf.Strd.RfrdDocInf.RltdDt

-

28

O

Составитель

RltdAgts.DbtrAgt.FinInstnId.Nm

-

29

O

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

SplmtryData.Envlp.CrdtSum

-

30

O

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

SplmtryData.Envlp.Notif.Nuved

-

31

O

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

SplmtryData.Envlp.Notif.Dtuv

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

32

O

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

SplmtryData.Envlp.Notif.Dtcpd

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

33

O

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

SplmtryData.Envlp.Notif.Bviol

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

34

O

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

SplmtryData.Envlp.NumSB

-

35

O

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

Refs.TxId

-

36

O

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

Tax.Rcrd.Tp

-

37

O

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

AmtDtls.PrtryAmt.Tp

-

38

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

R

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

RmtInf.Strd[1].RfrdDocInf.RltdDt

-

29

O

Код УИН (22)

RmtInf.Strd[1].CdtrRefInf.Ref

-

30

R

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

Purp.Prtry

-

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>

42

O

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

Tax.Rcrd.DbtrSts

-

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

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

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

CdtDbtInd

-

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

Тип транзакции
(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

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

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

RltdPties.Dbtr.Nm

-

3

O

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

RltdPties.Dbtr.PstlAdr.AdrLine

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

4

O

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

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

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

5

O

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

RltdPties.Dbtr.Id.OrgId.Othr.Id

-

6

O

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

RltdPties.DbtrAcct.Id.Othr.Id

-

7

R

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

RltdPties.Cdtr.Nm

-

8

O

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

RltdPties.Cdtr.PstlAdr.AdrLine

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

9

O

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

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

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

10

O

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

RltdPties.Cdtr.Id.OrgId.Othr.Id

-

11

R

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

RltdPties.CdtrAcct.Id.Othr.Id

-

12

O

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

RltdAgts.DbtrAgt.FinInstnId.BICFI

-

13

O

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

RltdAgts.DbtrAgt.FinInstnId.Othr.Issr

-

14

O

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

RltdAgts.DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

-

15

O

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

RltdAgts.DbtrAgt.FinInstnId.Othr.Id

-

16

O

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

RltdAgts.DbtrAgt.FinInstnId.Nm

-

17

O

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

RltdAgts.DbtrAgt.FinInstnId.PstlAdr.AdrLine

-

18

O

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

RltdAgts.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

-

19

O

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

RltdAgts.CdtrAgt.FinInstnId.BICFI

-

20

O

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

RltdAgts.CdtrAgt.FinInstnId.Othr.Issr

-

21

O

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

RltdAgts.CdtrAgt.FinInstnId.Othr.Id

-

22

О

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

RltdAgts.CdtrAgt.FinInstnId.Nm

-

23

O

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

RltdAgts.CdtrAgt.FinInstnId.PstlAdr.AdrLine

-

24

R

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

RmtInf.Ustrd[1..2]

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

25

R

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

RmtInf.Strd.RfrdDocInf.RltdDt

-

26

R

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

Purp.Prtry

-

27

O

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

Tax.Rcrd.Tp

-

28

O

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

AmtDtls.PrtryAmt.Tp

-

29

R

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

Amt@Ccy

-

30

O

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

AmtDtls.PrtryAmt.Amt@Ccy

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

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

-

Таблица соответствия вида операции с коллекцией документов 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

-

202

OK

The request had still being processed. Try later.

Выписка еще не сформирована. Обратитесь позднее.

401

Err

Wrong username or password

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

401

Err

User was not found

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

403

Err

User is disabled

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

404

Err

Request has not been found by MsgId

Запрос не найден по идентификатору MsgId

500

Err

Warrant service error

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

500

Err

Internal Error

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

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.

Выписка не была сформирована из-за ошибок (по всем счетам из запроса). Обратитесь в техподдержку

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

Шлюз не отвечает
Пример выписки 
<?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>20730d08326f4b8591d47b910da51d3e</MsgId>
            <CreDtTm>2024-03-07T10:54:14.189+03:00</CreDtTm>
            <OrgnlBizQry>
                <MsgId>MSG_TESTSTMT761892095</MsgId>
            </OrgnlBizQry>
        </GrpHdr>
        <Stmt>
            <Id>f51cee1dfe544953a7e6c7884a3cd1d5</Id>
            <CreDtTm>2024-03-07T10:54:14.189+03:00</CreDtTm>
            <FrToDt>
                <FrDtTm>2024-03-06T00:00:00Z</FrDtTm>
                <ToDtTm>2024-03-07T00: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, г.Москва, ул.Каланчевская, д.27</AdrLine>
                        </PstlAdr>
                        <Othr>
                            <Id>7728168971</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </FinInstnId>
                </Svcr>
            </Acct>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>OPBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">49944801.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-06</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2024-03-06</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">49944801.00</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>CLBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">49938945.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2024-03-07</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">49938945.00</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <TxsSummry>
                <TtlCdtNtries>
                    <Sum>0.00</Sum>
                </TtlCdtNtries>
                <TtlDbtNtries>
                    <Sum>5856.00</Sum>
                </TtlDbtNtries>
                <TtlNtriesPerBkTxCd>
                    <BkTxCd>
                        <Prtry>
                            <Cd>2024-03-05</Cd>
                        </Prtry>
                    </BkTxCd>
                    <Avlbty>
                        <Dt>
                            <ActlDt>2024-03-07</ActlDt>
                        </Dt>
                        <Amt Ccy="RUR">0.00</Amt>
                        <CdtDbtInd>CRDT</CdtDbtInd>
                    </Avlbty>
                    <Avlbty>
                        <Dt>
                            <ActlDt>2024-03-07</ActlDt>
                        </Dt>
                        <Amt Ccy="RUR">5856.00</Amt>
                        <CdtDbtInd>DBIT</CdtDbtInd>
                    </Avlbty>
                </TtlNtriesPerBkTxCd>
            </TxsSummry>
            <Ntry>
                <Amt Ccy="RUR">789.00</Amt>
                <CdtDbtInd>DBIT</CdtDbtInd>
                <Sts>BOOK</Sts>
                <BookgDt>
                    <Dt>2024-03-06</Dt>
                </BookgDt>
                <ValDt>
                    <Dt>2024-03-06</Dt>
                </ValDt>
                <BkTxCd>
                    <Domn>
                        <Cd>PMNT</Cd>
                        <Fmly>
                            <Cd>ICDT</Cd>
                            <SubFmlyCd>NTAV</SubFmlyCd>
                        </Fmly>
                    </Domn>
                    <Prtry>
                        <Cd>01</Cd>
                    </Prtry>
                </BkTxCd>
                <NtryDtls>
                    <TxDtls>
                        <Refs>
                            <EndToEndId>3</EndToEndId>
                            <TxId>61H8D24360000001</TxId>
                        </Refs>
                        <Amt Ccy="RUR">789.00</Amt>
                        <CdtDbtInd>DBIT</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>7013602245</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                            </Dbtr>
                            <DbtrAcct>
                                <Id>
                                    <Othr>
                                        <Id>40702810200000000083</Id>
                                    </Othr>
                                </Id>
                            </DbtrAcct>
                            <Cdtr>
                                <Nm>Акционерное общество "ДИКСИ Юг"</Nm>
                                <Id>
                                    <OrgId>
                                        <Othr>
                                            <Id>5036045205</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                            </Cdtr>
                            <CdtrAcct>
                                <Id>
                                    <Othr>
                                        <Id>40702810901300013927</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>Оплата по договору Основной договор Сумма 789-00 В т.ч. НДС (20%) 131-50</Ustrd>
                            <Strd>
                                <RfrdDocInf>
                                    <RltdDt>2024-03-06</RltdDt>
                                </RfrdDocInf>
                                <CdtrRefInf>
                                    <Ref>0</Ref>
                                </CdtrRefInf>
                            </Strd>
                        </RmtInf>
                        <CorpActn>
                            <EvtTp>электронно</EvtTp>
                            <EvtId>00</EvtId>
                        </CorpActn>
                        <SplmtryData>
                            <Envlp>
                                <NumSB>61H8D24360000001</NumSB>
                            </Envlp>
                        </SplmtryData>
                    </TxDtls>
                </NtryDtls>
            </Ntry>
            <Ntry>
                <Amt Ccy="RUR">67.00</Amt>
                <CdtDbtInd>DBIT</CdtDbtInd>
                <Sts>BOOK</Sts>
                <BookgDt>
                    <Dt>2024-03-06</Dt>
                </BookgDt>
                <ValDt>
                    <Dt>2024-03-06</Dt>
                </ValDt>
                <BkTxCd>
                    <Domn>
                        <Cd>PMNT</Cd>
                        <Fmly>
                            <Cd>ICDT</Cd>
                            <SubFmlyCd>NTAV</SubFmlyCd>
                        </Fmly>
                    </Domn>
                    <Prtry>
                        <Cd>01</Cd>
                    </Prtry>
                </BkTxCd>
                <NtryDtls>
                    <TxDtls>
                        <Refs>
                            <EndToEndId>2</EndToEndId>
                            <TxId>60FZD24360000001</TxId>
                        </Refs>
                        <Amt Ccy="RUR">67.00</Amt>
                        <CdtDbtInd>DBIT</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>7013602245</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                            </Dbtr>
                            <DbtrAcct>
                                <Id>
                                    <Othr>
                                        <Id>40702810200000000083</Id>
                                    </Othr>
                                </Id>
                            </DbtrAcct>
                            <Cdtr>
                                <Nm>Акционерное общество "Сибирская Угольная Энергетическая Компания"</Nm>
                                <Id>
                                    <OrgId>
                                        <Othr>
                                            <Id>7708129854</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                            </Cdtr>
                            <CdtrAcct>
                                <Id>
                                    <Othr>
                                        <Id>40702810801300000153</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>Оплата по договору 45-11/12/2023 от 27.01.2023 Сумма 67-00 В т.ч. НДС (20%) 11-17</Ustrd>
                            <Strd>
                                <RfrdDocInf>
                                    <RltdDt>2024-03-06</RltdDt>
                                </RfrdDocInf>
                                <CdtrRefInf>
                                    <Ref>0</Ref>
                                </CdtrRefInf>
                            </Strd>
                        </RmtInf>
                        <CorpActn>
                            <EvtTp>электронно</EvtTp>
                            <EvtId>00</EvtId>
                        </CorpActn>
                        <SplmtryData>
                            <Envlp>
                                <NumSB>60FZD24360000001</NumSB>
                            </Envlp>
                        </SplmtryData>
                    </TxDtls>
                </NtryDtls>
            </Ntry>
            <Ntry>
                <Amt Ccy="RUR">5000.00</Amt>
                <CdtDbtInd>DBIT</CdtDbtInd>
                <Sts>PDNG</Sts>
                <BookgDt>
                    <Dt>2024-03-07</Dt>
                </BookgDt>
                <ValDt>
                    <Dt>2024-03-07</Dt>
                </ValDt>
                <BkTxCd>
                    <Domn>
                        <Cd>PMNT</Cd>
                        <Fmly>
                            <Cd>MDOP</Cd>
                            <SubFmlyCd>COMM</SubFmlyCd>
                        </Fmly>
                    </Domn>
                    <Prtry>
                        <Cd>09</Cd>
                    </Prtry>
                </BkTxCd>
                <NtryDtls>
                    <TxDtls>
                        <Refs>
                            <EndToEndId>12</EndToEndId>
                            <TxId>1240307MOCOF6D0A00011</TxId>
                        </Refs>
                        <Amt Ccy="RUR">5000.00</Amt>
                        <CdtDbtInd>DBIT</CdtDbtInd>
                        <RltdPties>
                            <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>
                            <Cdtr>
                                <Nm>АО "Альфа-Банк"</Nm>
                                <Id>
                                    <OrgId>
                                        <Othr>
                                            <Id>7728168971</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                            </Cdtr>
                            <CdtrAcct>
                                <Id>
                                    <Othr>
                                        <Id>47423810300000000359</Id>
                                    </Othr>
                                </Id>
                            </CdtrAcct>
                        </RltdPties>
                        <RltdAgts>
                            <DbtrAgt>
                                <FinInstnId>
                                    <ClrSysMmbId>
                                        <MmbId>044525593</MmbId>
                                    </ClrSysMmbId>
                                    <Nm>АО "АЛЬФА-БАНК" 1</Nm>
                                </FinInstnId>
                            </DbtrAgt>
                            <CdtrAgt>
                                <FinInstnId>
                                    <ClrSysMmbId>
                                        <MmbId>044525593</MmbId>
                                    </ClrSysMmbId>
                                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                                </FinInstnId>
                            </CdtrAgt>
                        </RltdAgts>
                        <Purp>
                            <Prtry>5</Prtry>
                        </Purp>
                        <RmtInf>
                            <Ustrd>Комиссия за обслуживание р/с за период с 07ФЕВ24 по 06МАР24 Согласно тарифам Банка ООО "Тест Альфа-Линк"</Ustrd>
                            <Strd>
                                <RfrdDocInf>
                                    <RltdDt>2024-03-07</RltdDt>
                                </RfrdDocInf>
                            </Strd>
                        </RmtInf>
                        <Tax>
                            <Cdtr>
                                <TaxTp>770801001</TaxTp>
                            </Cdtr>
                            <Dbtr>
                                <TaxTp>215045470</TaxTp>
                            </Dbtr>
                        </Tax>
                        <SplmtryData>
                            <Envlp>
                                <NumSB>1240307MOCOF6D0A00011</NumSB>
                            </Envlp>
                        </SplmtryData>
                    </TxDtls>
                </NtryDtls>
            </Ntry>
        </Stmt>
    </BkToCstmrStmt>
</Document>

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

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

  • Базовый остаток

  • Расширенный остаток

Базовый остаток

  • Доступный баланс - Реальная сумма, доступная по счету

  • Зарезервированный баланс - зарезервированная сумма по счету

Расширенный остаток

  • Входящий баланс (Входящее сальдо) - остаток по счёту на начало текущего дня

  • Исходящий баланс (Исходящее сальдо) - рассчитывается как арифметическая сумма входящего сальдо и оборотов за текущий день

  • Доступный баланс - Реальная сумма, доступная по счету

  • Зарезервированный баланс - зарезервированная сумма по счету

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

Сформированный онлайн остаток приходит в ответ на POST-запрос в синхронном режиме.

Запрос онлайн остатка без подписи

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

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

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

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

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

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

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

Запрос

URI

POST: /API/v1/ISO20022/Statements/AccountBalance - базовый остаток

POST: /API/v1/ISO20022/Statements/AccountBalanceExtended - расширенный остаток

XML схема

camt.060.001.03

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

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

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

1

R

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

GrpHdr.MsgId

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

2

R

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

GrpHdr.CreDtTm

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

3

O

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

GrpHdr.MsgSndr.Pty.Id.OrgId.Othr.Id

-

4

R

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

RptgReq.Id

-

5

R

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

RptgReq.ReqdMsgNmId

Константа "HMQSTASCF"

6

R

Номер счета

RptgReq.Acct.Id.Othr.Id

-

7

R

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

RptgReq.AcctOwnr.Pty.Nm

-

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

8

O

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

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

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

Шлюз не отвечает
Пример запроса онлайн остатка 
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd: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>83a8cdb3e10e4148b08485e7cd2176cc</MsgId>
            <CreDtTm>2024-03-07T10:56:42.588+03:00</CreDtTm>
        </GrpHdr>
        <Rpt>
            <Id>baf5c220be6d412eb9ada2e4f5b18035</Id>
            <CreDtTm>2024-03-07T10:56:42.619+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">49926499.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>INFO</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">12446.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
            </Bal>
        </Rpt>
        <Rpt>
            <Id>4d10c3a0d73f4a349309fc04ff15876c</Id>
            <CreDtTm>2024-03-07T10:56:42.645+03:00</CreDtTm>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702840200000000529</Id>
                    </Othr>
                </Id>
                <Ccy>USD</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="USD">9999982.80</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>INFO</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="USD">0.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</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>e0ba1d35df79423d813c87f5317c9c39</MsgId>
            <CreDtTm>2024-03-07T10:57:58.655+03:00</CreDtTm>
        </GrpHdr>
        <Rpt>
            <Id>11f6665b1a70486cb391df4aee58eebd</Id>
            <CreDtTm>2024-03-07T10:57:58.689+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">49943945.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2024-03-07</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">49943945.00</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>CLBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">49938945.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2024-03-07</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">49938945.00</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>ITAV</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">49926499.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>INFO</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="RUR">12446.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
            </Bal>
        </Rpt>
        <Rpt>
            <Id>a10f84aae47d4dc8ab3eeaaa427bf67f</Id>
            <CreDtTm>2024-03-07T10:57:58.734+03:00</CreDtTm>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702840200000000529</Id>
                    </Othr>
                </Id>
                <Ccy>USD</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="USD">28865982.80</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2024-03-07</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">911602432.04</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>CLBD</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="USD">28865982.80</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
                <Avlbty>
                    <Dt>
                        <ActlDt>2024-03-07</ActlDt>
                    </Dt>
                    <Amt Ccy="RUR">903410446.13</Amt>
                    <CdtDbtInd>CRDT</CdtDbtInd>
                </Avlbty>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>ITAV</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="USD">9999982.80</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</Dt>
                </Dt>
            </Bal>
            <Bal>
                <Tp>
                    <CdOrPrtry>
                        <Cd>INFO</Cd>
                    </CdOrPrtry>
                </Tp>
                <Amt Ccy="USD">0.00</Amt>
                <CdtDbtInd>CRDT</CdtDbtInd>
                <Dt>
                    <Dt>2024-03-07</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

R

Адрес плательщика (8)

Dbtr.PstlAdr.AdrLine

-

13

R

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

Dbtr.Id.OrgId.Othr.Id

-

14

R

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

Dbtr.Id.OrgId.Othr.SchmeNm.Cd

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

15

О

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

Dbtr.CtctDtls.Nm

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

16

R

Счет плательщика (9)

DbtrAcct.Id.Othr.Id

-

17

R

Код клиринговой системы

DbtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

18

R

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

DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

-

19

R

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

DbtrAgt.FinInstnId.Nm

-

20

R

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

DbtrAgtAcct.Id.Othr.Id

-

21

R

Уникальный id платежа

CdtTrfTxInf.PmtId.InstrId

Идентификатор исходного поручения

22

R

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

CdtTrfTxInf.PmtId.EndToEndId

Целое число до 6 символов. Уникальность номера в течение дня проверяется исходя из уникальности группы параметров: дата платежа, номер платежа, счет плательщика, счет получателя, сумма платежа.

23

R

Вид платежа (5)

CdtTrfTxInf.PmtTpInf.SvcLvl.Cd

Принимаемые значения:
URGP - срочный платеж
NURG - обычный платеж

24

R

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

CdtTrfTxInf.Amt.InstdAmt

-

25

R

Валюта документа

CdtTrfTxInf.Amt.InstdAmt@Ccy

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

26

R

Код клиринговой системы

CdtTrfTxInf.CdtrAgt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

27

R

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

CdtTrfTxInf.CdtrAgt.FinInstnId.ClrSysMmbId.MmbId

-

28

R

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

CdtTrfTxInf.CdtrAgt.FinInstnId.Nm

-

29

O

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

CdtTrfTxInf.CdtrAgtAcct.Id.Othr.Id

-

30

R

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

CdtTrfTxInf.Cdtr.Nm

-

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

О

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

CdtTrfTxInf.Cdtr.CtctDtls.Nm

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

35

O

Счет получателя (17)

CdtTrfTxInf.CdtrAcct.Id.Othr.Id

-

36

R

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

CdtTrfTxInf.Purp.Prtry

-

37

O

Признак заполнения поля "Код вида дохода"

CdtTrfTxInf.RgltryRptg.Dtls.Tp

Константа 'PTCD'

38

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-У "О порядке указания кода вида дохода в распоряжениях о переводе денежных средств

39

O

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

CdtTrfTxInf.Tax.Cdtr.TaxTp

-

40

O

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

CdtTrfTxInf.Tax.Dbtr.TaxTp

-

Блок CdtTrfTxInf.Tax - Бюджетные реквизиты платежного поручения

Все бюджетные реквизиты становятся обязательными при заполнении поля 101 Статус составителя документа.
Обязательным также становится поле 22 Код платежа

41

O

ОКТМО (105)

CdtTrfTxInf.Tax.AdmstnZn

-

42

O

Номер налогового документа (108)

CdtTrfTxInf.Tax.RefNb

-

43

O

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

CdtTrfTxInf.Tax.Dt

Значения "0" или "00" необходимо указывать в PmtInf.CdtTrfTxInf.Tax.Mtd

44

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 Федерального закона «О национальной платежной системе»

45

O

Код основания налогового платежа (106)

CdtTrfTxInf.Tax.Rcrd.Ctgy

-

46

O

Код бюджетной классификации (104)

CdtTrfTxInf.Tax.Rcrd.CtgyDtls

-

47

O

Статус составителя документа (101)

CdtTrfTxInf.Tax.Rcrd.DbtrSts

-

Реквизит "Код таможенного органа (107)": код таможенного органа, показателя налогового периода, дата уплаты налогов.
Детали заполнения поля доступны - (Алгоритм заполнения и обработки параметра "Код таможенного органа (107)").

48

O

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

CdtTrfTxInf.Tax.Rcrd.Prd.Yr

-

49

O

Налоговый период в кодировке ISO20022

CdtTrfTxInf.Tax.Rcrd.Prd.Tp

MM - МС;
QTR - КВ;
HLF - ПЛ;
не указано - ГД.

50

O

Дата уплаты налогов

CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.FrDt

Алгоритм обработки приведен ниже

51

O

Конец периода
(не используется)

CdtTrfTxInf.Tax.Rcrd.Prd.FrToDt.ToDt

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

52

O

Код таможенного органа

CdtTrfTxInf.Tax.Cdtr.RegnId

-

53

O

Назначение платежа (24)

CdtTrfTxInf.RmtInf.Ustrd[1..2]

Количество полей Ustrd неограниченно, но длина каждого не должна превышать 140 символов. Общая длина поля (24) не должна превышать 210 символов

54

O

Тип записи

CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.Tp.CdOrPrtry.Prtry

Константа 'POD'

55

R

Дата документа (4)

CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt

Формат: YYYY-MM-DD

56

О

Код платежа (22)

CdtTrfTxInf.RmtInf.Strd.CdtrRefInf.Ref

-

57

О

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

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

Значения двух полей объединяются. Макс. длина каждого тега 140 символов. Макс. длина всего поля вместе 210 символов.

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

58

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Алгоритм заполнения и обработки параметра "Код таможенного органа (107)"

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

С 1 апреля 2026 года в поле 107 «Код налогового периода» в платежном поручении не используется 10‑значный код налогового периода в формате ХХ.ХХ.ХХХХ (МС, КВ, ГД и т.п.), а допустимы только два варианта: «0» (для налоговых платежей через ЕНП) и 8‑значный код таможенного органа (для таможенных платежей).

В поле 107 указывается нуль в следующих случаях:

  • при уплате налога через ЕНП (единый налоговый платеж) с подачей уведомления в налоговый орган;

  • при уплате налогов и взносов по новым правилам, где срок, КБК и основание платежа уже определены через ЕНП и уведомление, а не через старый 10‑значный код налогового периода.

Примеры заполнения по типам платежей
Тип платежа Поле 104 (КБК) Назначение платежа Поле 106 (Основание) Поле 107 (Код налогового периода) Поле 108 (Номер документа) Поле 109 (Дата документа)

Налог/взнос через ЕНП

18201061201010000510

«Единый налоговый платеж № 12345678, ИНН 1234567890, КПП 123456789, статус 01, сумма 100000 рублей»

0

0

0

0

Налог/взнос по требованию ФНС

18210202140011000110

«Оплата по требованию № 123 от 01.04.2026 по налогу X, ИНН 1234567890»

ТР

0

123

2026-04-01

Таможенная пошлина

19011601041040000000

«Пошлина за таможенное оформление, декларация № 1122334455, код таможни 12345678»

ТМ

12345678

1122334455

2026-04-01

Таможенный сбор (за оформление)

19011601041070000000

«Сбор за таможенное оформление, документ № 9988776655, код таможни 87654321»

ТМ

87654321

9988776655

2026-04-01

Административный штраф (ГИБДД)

18811505071060000000

«Штраф за нарушение ПДД, постановление № 789, от 01.04.2026, водитель Иванов И.И., рег. номер А123ВС99»

ШТ

0

789

2026-04-01

Страховые взносы в ПФР (без ЕНП)

18210202010061000160

«Страховые взносы за работников за март 2026 года, ИНН 1234567890»

ПП

0

0

0

Пени в ФНС по налогу

18210101100012000110

«Пени по налогу X, за период март 2026, ИНН 1234567890, по акту № 456 от 05.04.2026»

ПП

0

456

2026-04-05

Импортный акциз (таможня)

19021602021010000000

«Акциз на импортируемый товар, декларация № 1234567890, код таможни 13572468»

ТМ

13572468

1234567890

2026-04-01

===

Ответ

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

Описание схемы: Статусы по валютным переводам, платёжным поручениям и РСТС

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

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

Шлюз не отвечает
Пример платежа с подписью 
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd: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>
                <PstlAdr>
                    <AdrLine>Москва ул. Московская 1</AdrLine>
                </PstlAdr>
                <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="RUB">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>
                        <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="RUB">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>
          </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, не отображаются в АЛБО (ни в старой, ни в новой версии)

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

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

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

9

R

Валюта перевода
(буквенный код)

CdtTrfTxInf.Amt.InstdAmt@Ccy

<InstdAmt Ccy="USD">
1000.00
</InstdAmt>

10

R

Сумма перевода

CdtTrfTxInf.Amt.InstdAmt

<InstdAmt Ccy="USD">
1000.00
</InstdAmt>

11

R

Дата перевода

CdtTrfTxInf.RmtInf.Strd.RfrdDocInf.RltdDt

В случае отсутствия значения в RltdDt, брать из …​/ReqdExctnDt. Формат даты YYYY-MM-DD

12

R

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

DbtrAcct.Id.Othr.Id

-

13

R

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

Dbtr.Nm

-

14

R

Адрес плательщика

Dbtr.PstlAdr.AdrLine

-

15

R

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

Dbtr.Id.OrgId.Othr.Id

-

16

O

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

CdtTrfTxInf.IntrmyAgt1.FinInstnId.BICFI

-

17

O

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

CdtTrfTxInf.IntrmyAgt1.FinInstnId.Nm

-

18

O

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

CdtTrfTxInf.IntrmyAgt1.FinInstnId.PstlAdr.AdrLine

-

19

O

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

CdtTrfTxInf.IntrmyAgt1.FinInstnId.Othr.Issr

-

20

O

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

CdtTrfTxInf.IntrmyAgt1.FinInstnId.Othr.Id

Поле обязательно по схеме

21

O

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

CdtTrfTxInf.CdtrAgtAcct.Id.IBAN

-

22

O

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

CdtTrfTxInf.CdtrAgtAcct.Id.Othr.Id

-

23

O

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

CdtTrfTxInf.CdtrAgt.FinInstnId.BICFI

-

24

O

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

CdtTrfTxInf.CdtrAgt.FinInstnId.Othr.Issr

-

25

O

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

CdtTrfTxInf.CdtrAgt.FinInstnId.Nm

-

26

O

Адрес банка получателя

CdtTrfTxInf.CdtrAgt.FinInstnId.PstlAdr.AdrLine

-

27

O

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

CdtTrfTxInf.CdtrAcct.Id.IBAN

-

28

O

Номер счета получателя, в случае если счет не IBAN

CdtTrfTxInf.CdtrAcct.Id.Othr.Id

-

29

R

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

CdtTrfTxInf.Cdtr.Nm

-

30

R

Адрес получателя

CdtTrfTxInf.Cdtr.PstlAdr.AdrLine

-

31

R

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

CdtTrfTxInf.RmtInf.Ustrd

Макс. длина 140 символов

Условия заполнения для платежей в ОАЭ

Центральным Банком Объединенных Арабских Эмиратов (ОАЭ) определены правила оформления платежей в ОАЭ
согласно которым в каждом платеже требуется указание специального кода назначения платежа (далее- код)

При оформлении платежа в любой иностранной валюте укажите код в заявлении на перевод в начале поля в виде:

/BENEFRES/AE//КОД/далее укажите назначение платежа.

Пример: /BENEFRES/AE//SAL/ADDL NARRATIVE

32

R

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

CdtTrfTxInf.ChrgBr
или
ChrgBr

DEBT - со счета плательщика
CRED - из суммы платежа
SHAR - со счета плательщика и из суммы платежа

33

O

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

ChrgsAcct.Id.Othr.Id

-

34

R

Уникальный id ВП (сквозной)

CdtTrfTxInf.PmtId.EndToEndId

-

35

O

Признак "Срочность принятия на исполнение перевода банком"

PmtTpInf.InstrPrty
или
CdtTrfTxInf.PmtTpInf.InstrPrty
Приоритет за п.1

-

36

R

Признак "Срочный перевод"

PmtTpInf.SvcLvl.Cd
или
CdtTrfTxInf.PmtTpInf.SvcLvl.Cd

URGP - срочный платеж
NURG - обычный платеж

37

O

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

CdtTrfTxInf.RmtInf.Strd.AddtlRmtInf

-

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

38

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

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

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

Шлюз не отвечает
Пример Валютного Перевода 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.06" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<CstmrCdtTrfInitn>
		<GrpHdr>
			<MsgId>5077018948painMSG2021090100001</MsgId>
			<CreDtTm>2024-03-15T17: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>2024-03-15</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>2024-03-15</RltdDt>
						</RfrdDocInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
		</PmtInf>
		<SplmtryData>
			<Envlp>
                <SgntrSt>
                </SgntrSt>
			</Envlp>
		</SplmtryData>
	</CstmrCdtTrfInitn>
</Document>
Пример Валютного Перевода с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива

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

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

После успешного выполнения запроса на отзыв платежа (ответ с HTTP кодом 200) Вы можете выполнить запрос на получение статуса по конкретному платежу.

GET https://alfa-link-int.alfabank.ru/API/v1/ISO20022/Payments/Transactions/<InstrId>

где <InstrId> - идентификатор платежа.

Важно

Может возникнуть ситуация, когда ранее отправленный платеж находится в процессе выполнения проверок.
Вам вернется ответ с кодом HTTP 404.
Если идентификаторы отзываемого платежа заполнены верно - выполните запрос на получение статуса по конкретному платежу.
Если платеж перешел в статус ACSP "На обработке", выполните повторный запрос на отзыв платежа.

URI

PUT: /API/v1/ISO20022/Payments/Recall

XML схема

camt.055.001.06

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

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

Общий путь Document.CstmrPmtCxlReq.Assgnmt

1

R

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

Id

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

1

R

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

Assgnr.Pty.Nm

-

2

R

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

Assgnr.Pty.Id.OrgId.Othr.Id

-

3

R

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

Assgnr.Pty.Id.OrgId.Othr.SchmeNm.Cd

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

4

O

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

Assgne.Agt.FinInstnId.Nm

Константа 'АО АЛЬФА-БАНК'

5

R

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

CreDtTm

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

Общий путь Document.CstmrPmtCxlReq.Undrlyg.OrgnlPmtInfAndCxl

6

R

Id исходного пакета платежа

OrgnlPmtInfId

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

7

R

Id исходного сообщения платежа

OrgnlGrpInf.OrgnlMsgId

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

8

R

Тип исходного сообщения

OrgnlGrpInf.OrgnlMsgNmId

Константа 'pain.001.001.06'

9

R

Уникальный id запроса на отзыв

TxInf.CxlId

-

10

R

Id исходного платежа

TxInf.OrgnlInstrId

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

11

R

Сумма отзываемого платежа

TxInf.OrgnlInstdAmt

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

12

R

Код валюты отзываемого платежа

TxInf.OrgnlInstdAmt@Ccy

-

13

R

Номер счета

TxInf.OrgnlTxRef.DbtrAcct.Id.Othr.Id

-

14

R

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

TxInf.OrgnlTxRef.DbtrAcct.Id.Othr.SchmeNm.Cd

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

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

15

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Ответ

Ответом является XML-документ, соответствующий схеме camt.029.001.06.

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

Document.RsltnOfInvstgtn

1

R

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

Assgnmt.Id

-

2

R

SWIFT Альфа-Банка

Assgnmt.Assgne.Pty.Id.OrgId.AnyBIC.AnyBIC

Константа
'ALFARUMM'

3

R

БИК банка

Assgne.Pty.Id.OrgId.Othr.Id

Константа '044525593'

4

R

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

Assgnmt.CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD

5

R

Статус сообщения запроса на отзыв

Sts.Conf

CNCL - Запрос выполнен;
RJCR - Запрос не выполнен.

Document.RsltnOfInvstgtn.CxlDtls

6

R

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

OrgnlGrpInfAndSts.OrgnlMsgId

Константа 'camt.055.001.06'

7

R

Тип исходного сообщения

OrgnlGrpInfAndSts.OrgnlMsgNmId

Константа
'camt.055.001.06'

8

R

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

OrgnlPmtInfAndSts.OrgnlCreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD

9

R

Статус сообщения
(запроса)

OrgnlGrpInfAndSts.GrpCxlSts

ACCR - Запрос выполнен;
RJCR - Запрос не выполнен.

10

O

Код причины присвоения статуса сообщения

OrgnlGrpInfAndSts.CxlStsRsnInf.Rsn.Cd

NARR - Описание в поле AddtlInf.

11

O

Описание причины присвоения статуса

OrgnlGrpInfAndSts.CxlStsRsnInf.AddtlInf[1…​n]

Таблица с описанием причины присвоения статусов (CNCL, ACCR) и RJCR

12

O

Id исходного пакета

OrgnlPmtInfAndSts.OrgnlPmtInfId

-

13

O

Статус сообщения
(запроса)

OrgnlGrpInfAndSts.PmtInfCxlSts

ACCR - Запрос выполнен;
RJCR - Запрос не выполнен.

14

O

Статус сообщения
(запроса)

OrgnlPmtInfAndSts.TxInfAndSts.OrgnlInstrId

ACCR - Запрос выполнен;
RJCR - Запрос не выполнен.

15

O

Код причины присвоения статуса сообщения

OrgnlPmtInfAndSts.CxlStsRsnInf.Rsn.Cd

NARR - Описание в поле AddtlInf.

16

O

Описание причины присвоения статуса

OrgnlPmtInfAndSts.CxlStsRsnInf.AddtlInf[1…​n]

Таблица с описанием причины присвоения статусов (CNCL, ACCR) и RJCR

Таблица с описанием причины присвоения статусов (CNCL, ACCR) и RJCR

Статусы HTTP код Описание причины присвоения статуса

CNCL
ACCR

200

Запрос на отзыв платежа выполнен: платеж отозван

RJCR

200

Запрос на отзыв платежа не выполнен: платёж не может быть отозван из данного состояния

RJCR

208

Запрос на отзыв платежа не выполнен: платёж ранее был отклонён

RJCR

404

Платёж не найден! Проверьте идентификатор(ы) отзываемого платежа

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

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

200

OK

Запрос на отзыв платежа выполнен: платёж отозван

Платеж отозван

200

OK

Запрос на отзыв платежа не выполнен: платёж не может быть отозван из данного состояния

Платёж не может быть отозван

208

Already Reported

Запрос на отзыв платежа не выполнен: платёж ранее был отклонён

Платёж ранее был отклонён

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

404

Not Found

Платёж не найден! Проверьте идентификатор(ы) отзываемого платежа

Платеж по вашим данным не найден. Проверьте идентификатор(ы) исходного сообщения.

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

Шлюз не отвечает
Пример запроса на отзыв платежа 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.055.001.06">
    <CstmrPmtCxlReq>
        <Assgnmt>
            <!-- Уникальный идентификатор сообщения с запросом -->
            <Id>TEST_MSG_2024-03-15-111222333</Id>
            <Assgnr>
                <Pty>
                    <!-- Наименование организации -->
                    <Nm>ООО "Тест Альфа-Линк"</Nm>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- Идентификатор ( ИНН ) -->
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <!-- Код Типа идентификации -->
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Pty>
            </Assgnr>
            <Assgne>
                <Agt>
                    <FinInstnId>
                        <!-- Наименование Банка -->
                        <Nm>АО АЛЬФА-БАНК</Nm>
                    </FinInstnId>
                </Agt>
            </Assgne>
            <!-- Дата и время создания документа -->
            <CreDtTm>2024-03-15T16:14:03.105+03:00</CreDtTm>
        </Assgnmt>
        <Undrlyg>
            <OrgnlPmtInfAndCxl>
                <!-- Идентификатор пакета отзываемых документов -->
                <OrgnlPmtInfId>TEST_PCT_2024-03-15-33221132</OrgnlPmtInfId>
                <OrgnlGrpInf>
                    <!-- Уникальный идентификатор сообщения с отзываемым документом -->
                    <OrgnlMsgId>TEST_MSG_2024-03-15-33221132</OrgnlMsgId>
                    <!-- Тип сообщения с отзываемым документом -->
                    <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
                </OrgnlGrpInf>
                <TxInf>
                    <!-- Номер документа "Запрос на отзыв" -->
                    <CxlId>TEST_ID_2024-03-15-43434343</CxlId>
                    <!-- Идентификатор отзываемого документа -->
                    <OrgnlInstrId>TEST_PMT_2024-03-15-33221132</OrgnlInstrId>
                    <!-- Сумма по отзываемому документу в валюте документа/Код валюты -->
                    <OrgnlInstdAmt Ccy="RUR">100</OrgnlInstdAmt>
                    <OrgnlTxRef>
                        <DbtrAcct>
                            <Id>
                                <Othr>
                                    <!-- Номер счета -->
                                    <Id>40702978000000000001</Id>
                                    <SchmeNm>
                                        <!-- Код Типа идентификации -->
                                        <Cd>ACC</Cd>
                                    </SchmeNm>
                                </Othr>
                            </Id>
                        </DbtrAcct>
                    </OrgnlTxRef>
                </TxInf>
            </OrgnlPmtInfAndCxl>
        </Undrlyg>
        <SplmtryData>
            <Envlp>
                <!-- Подпись -->
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrPmtCxlReq>
</Document>
Пример ответа при успешном отзыве платежа 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.029.001.06">
	<RsltnOfInvstgtn>
		<Assgnmt>
			<Id>1a374fad403f4df2bdd6c307cb2512a3</Id>
			<Assgnr>
				<Agt>
					<FinInstnId>
						<BICFI>ALFARUMM</BICFI>
					</FinInstnId>
				</Agt>
			</Assgnr>
			<Assgne>
				<Pty>
					<Id>
						<OrgId>
							<Othr>
								<Id>044525593</Id>
							</Othr>
						</OrgId>
					</Id>
				</Pty>
			</Assgne>
			<CreDtTm>2024-03-15T16:20:03.105+03:00</CreDtTm>
		</Assgnmt>
		<Sts>
			<Conf>CNCL</Conf>
		</Sts>
		<CxlDtls>
			<OrgnlGrpInfAndSts>
				<OrgnlMsgId>TEST_MSG_2024-03-15-111222333</OrgnlMsgId>
				<OrgnlMsgNmId>camt.055.001.06</OrgnlMsgNmId>
				<OrgnlCreDtTm>2024-03-15T16:14:03.105+03:00</OrgnlCreDtTm>
				<GrpCxlSts>ACCR</GrpCxlSts>
			</OrgnlGrpInfAndSts>
			<OrgnlPmtInfAndSts>
				<OrgnlPmtInfId>TEST_PCT_2023-08-31-131401784</OrgnlPmtInfId>
				<PmtInfCxlSts>ACCR</PmtInfCxlSts>
				<TxInfAndSts>
					<OrgnlInstrId>TEST_PMT_2023-08-31-131401784</OrgnlInstrId>
					<TxCxlSts>ACCR</TxCxlSts>
					<CxlStsRsnInf>
						<Rsn>
							<Cd>NARR</Cd>
						</Rsn>
						<AddtlInf>Запрос на отзыв платежа выполнен: платёж отозван</AddtlInf>
					</CxlStsRsnInf>
				</TxInfAndSts>
			</OrgnlPmtInfAndSts>
		</CxlDtls>
	</RsltnOfInvstgtn>
</Document>
Пример ответа, когда платеж не найден 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document
	xmlns="urn:iso:std:iso:20022:tech:xsd:camt.029.001.06">
	<RsltnOfInvstgtn>
		<Assgnmt>
			<Id>72ae0b7246ae4377a82606b5795a82fb</Id>
			<Assgnr>
				<Agt>
					<FinInstnId>
						<BICFI>ALFARUMM</BICFI>
					</FinInstnId>
				</Agt>
			</Assgnr>
			<Assgne>
				<Pty>
					<Id>
						<OrgId>
							<Othr>
								<Id>044525593</Id>
							</Othr>
						</OrgId>
					</Id>
				</Pty>
			</Assgne>
			<CreDtTm>2024-03-15T16:18:03.105+03:00</CreDtTm>
		</Assgnmt>
		<Sts>
			<Conf>RJCR</Conf>
		</Sts>
		<CxlDtls>
			<OrgnlGrpInfAndSts>
				<OrgnlMsgId>time_id:1693476795322</OrgnlMsgId>
				<OrgnlMsgNmId>camt.055.001.06</OrgnlMsgNmId>
				<OrgnlCreDtTm>2024-03-15T16:14:03.105+03:00</OrgnlCreDtTm>
				<GrpCxlSts>RJCR</GrpCxlSts>
				<CxlStsRsnInf>
					<Rsn>
						<Cd>NARR</Cd>
					</Rsn>
					<AddtlInf>Платёж не найден! Проверьте идентификатор(ы) отзываемого платежа</AddtlInf>
				</CxlStsRsnInf>
			</OrgnlGrpInfAndSts>
		</CxlDtls>
	</RsltnOfInvstgtn>
</Document>
Пример ответа, когда платеж был отозван ранее 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document
	xmlns="urn:iso:std:iso:20022:tech:xsd:camt.029.001.06">
	<RsltnOfInvstgtn>
		<Assgnmt>
			<Id>be55c9080518484bbce931ad438ffbcb</Id>
			<Assgnr>
				<Agt>
					<FinInstnId>
						<BICFI>ALFARUMM</BICFI>
					</FinInstnId>
				</Agt>
			</Assgnr>
			<Assgne>
				<Pty>
					<Id>
						<OrgId>
							<Othr>
								<Id>044525593</Id>
							</Othr>
						</OrgId>
					</Id>
				</Pty>
			</Assgne>
			<CreDtTm>2024-03-15T16:16:03.105+03:00</CreDtTm>
		</Assgnmt>
		<Sts>
			<Conf>RJCR</Conf>
		</Sts>
		<CxlDtls>
			<OrgnlGrpInfAndSts>
				<OrgnlMsgId>TEST_MSG_2024-03-15-111222333</OrgnlMsgId>
				<OrgnlMsgNmId>camt.055.001.06</OrgnlMsgNmId>
				<OrgnlCreDtTm>2024-03-15T16:14:03.105+03:00</OrgnlCreDtTm>
				<GrpCxlSts>RJCR</GrpCxlSts>
			</OrgnlGrpInfAndSts>
			<OrgnlPmtInfAndSts>
				<OrgnlPmtInfId>TEST_PCT_2023-08-31-131300012</OrgnlPmtInfId>
				<PmtInfCxlSts>RJCR</PmtInfCxlSts>
				<TxInfAndSts>
					<OrgnlInstrId>TEST_PMT_2023-08-31-131300012</OrgnlInstrId>
					<TxCxlSts>RJCR</TxCxlSts>
					<CxlStsRsnInf>
						<Rsn>
							<Cd>NARR</Cd>
						</Rsn>
						<AddtlInf>Запрос на отзыв платежа не выполнен: платёж ранее был отклонён</AddtlInf>
					</CxlStsRsnInf>
				</TxInfAndSts>
			</OrgnlPmtInfAndSts>
		</CxlDtls>
	</RsltnOfInvstgtn>
</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 также является валютным.

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

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

Обязателен для заполнения, когда указан тип курса "AGRD" или "DTOD"

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 - обратный

32

R

Сумма покупки валюты ИЛИ Сумма продажи валюты

SplmtryData.Envlp.InstdAmt2

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

* Если код валюты (CCY) в InstdAmt = CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.CdtrAcct.Ccy, то записать InstdAmt2 в «Сумма покупки валюты» * Если код валюты (CCY) в InstdAmt = CstmrCdtTrfInitn.PmtInf.DbtrAcct.Ccy, то записать InstdAmt2 в «Сумма продажи валюты»

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

33

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Примеры с разными типами курса.

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_2024-03-13-202403131</MsgId>
            <CreDtTm>2024-03-13T16: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_2024-03-13-202403131</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-13</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_2024-03-13</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>2024-03-13</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_2024-03-13-202403132</MsgId>
            <CreDtTm>2024-03-13T16: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_2024-03-13-202403132</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-13</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_2024-03-13-202403132</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>2024-03-13</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_2024-03-13-202403133</MsgId>
            <CreDtTm>2024-03-13T09: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_2024-03-13-202403133</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-13</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_2024-03-13-202403133</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>2024-03-13</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_2024-03-13-202403134</MsgId>
            <CreDtTm>2024-03-13T09: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_2024-03-13-202403134</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-13</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_2024-03-13-202403134</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>2024-03-13</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_2024-03-13-202403135</MsgId>
            <CreDtTm>2024-03-13T09: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_2024-03-13-202403135</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-13</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_2024-03-13-202403135</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>2024-03-13</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_2024-03-13-202403136</MsgId>
            <CreDtTm>2024-03-13T09: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_2024-03-13-202403136</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-13</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_2024-03-13-202403136</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>2024-03-13</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[1…​n]

-

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[1…​n]

-

17

Идентификатор конверсионной операции

OrgnlPmtInfId.TxInfAndSts.OrgnlInstrId

-

18

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

OrgnlPmtInfId.TxInfAndSts.TxSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- ACSC Исполнен

19

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

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.Rsn

-

20

Описание ошибки обработки ПК (технических и бизнес- ошибок)

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.AddtlInf[1…​n]

-

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

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

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

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 является валютным.

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

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

-

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

O

КПП

Tax.Dbtr.TaxTp

-

20

R

Р/с в ин.валюте для зачисления

CdtrAcct.Id.Othr.Id

-

21

R

Код валюты

CdtrAcct.Ccy

-

22

R

Удерживать комиссию

Document.CstmrCdtTrfInitn.PmtInf.ChrgBr или Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf.ChrgBr

CRED - иное
DEBT -с расчетного счета в валюте РФ
SHAR - иное
Если указаны PmtInf.ChrgBr и CdtTrfTxInf.ChrgBr, используется из PmtInf.ChrgBr

23

R

Сумма покупки валюты

Amt.InstdAmt

Если требуется задать сумму покупаемой валюты, то поле CCY необходимо заполнить кодом покупаемой валюты, например:
<InstdAmt Ccy="USD">150</InstdAmt>

24

R

Сумма предварительно депонированных средств в валюте РФ

Amt.InstdAmt

Если неизвестно, сколько валюты требуется приобрести, но известно, сколько рублей требуется обменять, то поле CCY требуется задать кодом продаваемой валюты, например:
<InstdAmt Ccy="RUB">150</InstdAmt>

25

O

По курсу не выше

XchgRateInf.XchgRate

Обязателен для заполнения, когда указан тип курса "AGRD" или "DTOD"

26

O

Реквизиты банка, в котором открыт р/с в ин.валюте

CdtrAgt.FinInstnId.Nm

-

27

R

Тип курса

XchgRateInf.RateTp ИЛИ PmtInf.CdtTrfTxInf.SplmtryData.Envlp.RateTp2

SPOT - "по курсу Банка" (Не требуется указывать счет комиссии)
AGRD - "по курсу Дилера ТОМ" (Требуется указать счет комиссии)
SALE - "по текущему курсу АЛЬФА-ФОРЕКС TOD" (Требуется указать счет комиссии)
DTOD - "по курсу дилера TOD" (Требуется указать счет комисии. Значение типа курса указывается в параметре RateTp2)
TMRW - "по курсу банка России на завтра" (Требуется указать счет комисии. Значение типа курса указывается в параметре RateTp2)
Примеры приведены в конце таблицы

28

R

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

RmtInf.Strd.RfrdDocInf.RltdDt

Формат даты YYYY-MM-DD

29

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

30

О

Специальный раздел номинального счета списания

SplmtryData.Envlp.SpecSecCancel

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

31

О

Специальный раздел номинального счета зачисления

SplmtryData.Envlp.SpecSecIncm

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

32

О

Направление курса

SplmtryData.Envlp.RateDrct

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

1 - прямой,
0 - обратный

33

R

Сумма предварительно депонированных средств в валюте РФ ИЛИ Сумма покупки валюты

SplmtryData.Envlp.InstdAmt2

Внимание! Параметр заполняется только Форекс-дилером. Если ваша компания не Форекс-дилер, то оставьте параметр пустым

* Если код валюты (CCY) в InstdAmt <> RUB или RUR, то записать InstdAmt2 в «Сумма предварительно депонированных средств в валюте РФ»
* Если код валюты (CCY) в InstdAmt = RUB или RUR, то записать InstdAmt2 в «Сумма покупки валюты»

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

34

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Примеры с разными типами курса.

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_2024-03-14-202403141</MsgId>
            <CreDtTm>2024-03-14T16: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_2024-03-14-202403141</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-14</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_2024-03-14-202403141</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>2024-03-14</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_2024-03-14-202403142</MsgId>
            <CreDtTm>2024-03-14T16: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_2024-03-14-202403142</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-14</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_2024-03-14-202403141</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>2024-03-14</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_2024-03-14-202403143</MsgId>
            <CreDtTm>2024-03-14T09: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_2024-03-14-202403143</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-14</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_2024-03-14-202403143</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>2024-03-14</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_2024-03-14-202403144</MsgId>
            <CreDtTm>2024-03-14T09: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_2024-03-14-202403144</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-14</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_2024-03-14-202403144</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>2024-03-14</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_2024-03-14-202403145</MsgId>
            <CreDtTm>2024-03-14T09: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_2024-03-14-202403145</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-14</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_2024-03-14-202403145</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>2024-03-14</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_2024-03-14-202403146</MsgId>
            <CreDtTm>2024-03-14T09: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_2024-03-14-202403146</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-14</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_2024-03-14-202403146</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>2024-03-14</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[1…​n]

-

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[1…​n]

-

17

Идентификатор конверсионной операции

OrgnlPmtInfId.TxInfAndSts.OrgnlInstrId

-

18

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

OrgnlPmtInfId.TxInfAndSts.TxSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- ACSC Исполнен

19

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

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.Rsn

-

20

Описание ошибки обработки ПК (технических и бизнес- ошибок)

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.AddtlInf[1…​n]

-

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

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

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

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 является рублевым.

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

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

16

Общий путь Document.CstmrCdtTrfInitn.PmtInf.CdtTrfTxInf* - Уровень поручения

17

R

Уникальный id поручения

PmtId.InstrId

Указывается идентифкатор поручения

18

R

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

PmtId.EndToEndId

-

19

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

Обязателен для заполнения, когда указан тип курса "AGRD" или "DTOD"

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 в «Сумма продажи валюты»

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

33

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Примеры с разными типами курса.

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_2024-03-12-202403121</MsgId>
            <CreDtTm>2024-03-12T16: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_2024-03-12-202403121</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-12</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_2024-03-12-202403121</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>2024-03-12</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_2024-03-12-202403122</MsgId>
            <CreDtTm>2024-03-12T16: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_2024-03-12-202403122</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-12</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_2024-03-12-202403122</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>2024-03-12</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_2024-03-12-202403123</MsgId>
            <CreDtTm>2024-03-12T09: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_2024-03-12-202403123</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-12</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_2024-03-12-202403123</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>2024-03-12</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_2024-03-12-202403124</MsgId>
            <CreDtTm>2024-03-12T09: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_2024-03-12-202403124</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <PmtTpInf>
                <InstrPrty>NORM</InstrPrty>
                <SvcLvl>
                    <Cd>NURG</Cd>
                </SvcLvl>
                <LclInstrm>
                    <Prtry>RU-FX</Prtry>
                </LclInstrm>
            </PmtTpInf>
            <ReqdExctnDt>2024-03-12</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_2024-03-12-202403124</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>2024-03-12</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[1…​n]

-

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[1…​n]

-

17

Идентификатор конверсионной операции

OrgnlPmtInfId.TxInfAndSts.OrgnlInstrId

-

18

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

OrgnlPmtInfId.TxInfAndSts.TxSts

- RCVD Получено

- RJCT Отклонено

- ACSP Принято к исполнению

- ACTC Принято, проверены подлинность и формат

- ACSC Исполнен

19

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

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.Rsn

-

20

Описание ошибки обработки ПК (технических и бизнес- ошибок)

OrgnlPmtInfId.TxInfAndSts.StsRsnInf.AddtlInf[1…​n]

-

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

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

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

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, то резидент - продавец.

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

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

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

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

RptgPty.PtyId.Id.OrgId.Othr.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

O

Код типа контракта/договора

CtrctRegnOpng.SplmtryData.Envlp.AdditionalData.ContractType

1 - Экспорт товаров
2 - Импорт товаров
3 - Экспорт услуг
4 - Импорт услуг
9 - Смешанная сделка
Если тег не заполняется, то блок
SplmtryData.Envlp.AdditionalData.ContractType не используется. См. пример ниже.

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

O

Признак "Аффилированное лицо"

[Buyr Sellr<>InitgPty].PtyId.CtctDtls.Othr

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

42

R

Дата завершения контракта/договора

MtrtyDt

YYYY-MM-DD

43

R

Признак пролонгации

PrlngtnFlg

Обязательно к заполнению по схеме, на создание УНК не влияет.

44

R

Дата начала обязательств по торговому контракту

StartDt

YYYY-MM-DD.

45

R

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

SttlmCcy

Валюта расчетов должна совпадать с валютой в сумме контракта.

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

46

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-
Пример: Создание контракта 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.018.001.01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CtrctRegnReq>
        <GrpHdr>
            <MsgId>TEST_MSG_2024-03-15-20240315</MsgId>
            <CreDtTm>2024-03-15T17:18:19.516</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>
        <CtrctRegn>
            <CtrctRegnId>TEST_PCT_2024-03-15-20240315</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>
                            <Othr>
                                <Id>40702840200000000529</Id>
                                <SchmeNm>
                                    <Cd>ACC</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО Альфа-Банк</Nm>
                </FinInstnId>
            </RegnAgt>
            <CtrctRegnOpng>
                <CtrctRegnOpngId>TEST_ID_2024-03-15-20240315</CtrctRegnOpngId>
                <Prty>NORM</Prty>
                <Ctrct>
                    <Trad>
                        <CtrctDocId>
                            <Id>112233</Id>
                            <DtOfIsse>2024-03-07</DtOfIsse>
                        </CtrctDocId>
                        <Amt Ccy="USD">100.00</Amt>
                        <Buyr>
                            <PtyId>
                                <Nm>ООО "Тест Альфа-Линк"</Nm>
                                <Id>
                                    <OrgId>
                                        <Othr>
                                            <Id>7013602245</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                                <CtryOfRes>RU</CtryOfRes>
                                <CtctDtls>
                                    <Othr>true</Othr>
                                </CtctDtls>
                            </PtyId>
                        </Buyr>
                        <Sellr>
                            <PtyId>
                                <Nm>"Партнер по контракту 1"</Nm>
                                <Id>
                                    <OrgId>
                                        <Othr>
                                            <Id>9909349194</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                                <CtryOfRes>PL</CtryOfRes>
                            </PtyId>
                        </Sellr>
                        <MtrtyDt>2024-03-15</MtrtyDt>
                        <PrlngtnFlg>false</PrlngtnFlg>
                        <StartDt>2024-03-07</StartDt>
                        <SttlmCcy>USD</SttlmCcy>
                    </Trad>
                </Ctrct>
                <SplmtryData>
                    <Envlp>
                        <AdditionalData>
                            <ContractType>9</ContractType>
                        </AdditionalData>
                    </Envlp>
                </SplmtryData>
            </CtrctRegnOpng>
        </CtrctRegn>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CtrctRegnReq>
</Document>
Пример: Если не заполнен тег ContractType 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.018.001.01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CtrctRegnReq>
        <GrpHdr>
            <MsgId>TEST_MSG_2024-03-15-20240315</MsgId>
            <CreDtTm>2024-03-15T17:18:19.516</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>
        <CtrctRegn>
            <CtrctRegnId>TEST_PCT_2024-03-15-20240315</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>
                            <Othr>
                                <Id>40702840200000000529</Id>
                                <SchmeNm>
                                    <Cd>ACC</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО Альфа-Банк</Nm>
                </FinInstnId>
            </RegnAgt>
            <CtrctRegnOpng>
                <CtrctRegnOpngId>TEST_ID_2024-03-15-20240315</CtrctRegnOpngId>
                <Prty>NORM</Prty>
                <Ctrct>
                    <Trad>
                        <CtrctDocId>
                            <Id>112233</Id>
                            <DtOfIsse>2024-03-07</DtOfIsse>
                        </CtrctDocId>
                        <Amt Ccy="USD">100.00</Amt>
                        <Buyr>
                            <PtyId>
                                <Nm>ООО "Тест Альфа-Линк"</Nm>
                                <Id>
                                    <OrgId>
                                        <Othr>
                                            <Id>7013602245</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                                <CtryOfRes>RU</CtryOfRes>
                            </PtyId>
                        </Buyr>
                        <Sellr>
                            <PtyId>
                                <Nm>"Партнер по контракту 1"</Nm>
                                <Id>
                                    <OrgId>
                                        <Othr>
                                            <Id>9909349194</Id>
                                            <SchmeNm>
                                                <Cd>TXID</Cd>
                                            </SchmeNm>
                                        </Othr>
                                    </OrgId>
                                </Id>
                                <CtryOfRes>PL</CtryOfRes>
                            </PtyId>
                        </Sellr>
                        <MtrtyDt>2024-03-15</MtrtyDt>
                        <PrlngtnFlg>false</PrlngtnFlg>
                        <StartDt>2024-03-07</StartDt>
                        <SttlmCcy>USD</SttlmCcy>
                    </Trad>
                </Ctrct>
            </CtrctRegnOpng>
        </CtrctRegn>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CtrctRegnReq>
</Document>

Ответ

Ответ приходит по схеме:

auth.027.001.01

Структура ответа описана в разделе Статусы по документам валютного контроля (СВО, СПД, УНК)

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

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

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

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

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

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

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

-

47

O

Признак "Аффилированное лицо"

[Buyr Sellr<>InitgPty].PtyId.CtctDtls.Rspnsblty

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

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

-

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

44

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Ответ

Ответ приходит по схеме:

auth.027.001.01

Структура ответа описана в разделе Статусы по документам валютного контроля (СВО, СПД, УНК)

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

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

Шлюз не отвечает
Пример запроса на внесение изменений в 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>TEST_MSG_15-03-2024-20240315</MsgId><!-- Уникальный ID сообщения-->
            <CreDtTm>2024-03-15T10:11:13.951</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>TEST_PCT_15-03-2024-20240315</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>TEST_ID_15-03-2024-20240315</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>
                                <CtctDtls>
                                    <Rspnsblty>true</Rspnsblty>
                                </CtctDtls>                            </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

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

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

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

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

18

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Ответ

Ответ приходит по схеме:

auth.027.001.01

Структура ответа описана в разделе Статусы по документам валютного контроля (СВО, СПД, УНК)

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

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

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

504

Err

Gateway Timeout

Шлюз не отвечает
Пример запроса на снятие контракта с учета 
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.020.001.03" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CtrctRegnClsrReq>
        <GrpHdr>
            <MsgId>TEST_MSG_15-03-2024-15032024</MsgId>
            <CreDtTm>2024-03-15T12:14:16.951</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_15-03-2024-15032024</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 ошибка.

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

auth.019.001.01

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

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

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

Константа '044525593'

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

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

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

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

1

R

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

MsgId

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

2

R

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

CreDtTm

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

3

R

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

NbOfItms

-

4

R

ИНН

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

-

5

R

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

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

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

6

O

Номер счёта

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

-

7

0

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

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

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

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

8

R

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

TxNtfctnId

-

9

R

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

AcctOwnr.Nm

-

10

R

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

AcctOwnr.Id.OrgId.Othr.Id

-

11

R

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

AcctOwnr.Id.OrgId.Othr.SchmeNm.Cd

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

12

R

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

AcctSvcr.FinInstnId.ClrSysMmbId.ClrSysId.Cd

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

13

R

БИК Банка

AcctSvcr.FinInstnId.ClrSysMmbId.MmbId

-

14

R

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

TxCert.TxId

-

15

R

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

TxCert.Cert.Id

-

16

O

Дата СВО

TxCert.Cert.DtOfIsse

-

17

R

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

TxCert.Acct.Id.Othr.Id

-

18

R

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

TxCert.CertRcrd.CertRcrdId

-

19

O

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

TxCert.CertRcrd.Tx.RfrdDoc.Id.PmtInfId

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

20

R

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

TxCert.CertRcrd.Tx.RfrdDoc.Id.EndToEndId

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

21

R

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

TxCert.CertRcrd.Tx.RfrdDoc.Dt

-

22

R

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

TxCert.BkAcctDmcltnCtry

-

23

R

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

TxCert.CertRcrd.Tx.TxDt

-

24

R

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

TxCert.CertRcrd.Tx.TxTp

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

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

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

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

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

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

25

R

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

TxCert.CertRcrd.Tx.LclInstrm

-

26

R

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

TxCert.CertRcrd.Tx.Amt@Ccy

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

27

R

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

TxCert.CertRcrd.Tx.Amt@Ccy

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

28

O

Номер УНК

TxCert.CertRcrd.Ctrct.CtrctRef.RegdCtrctId

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

29

O

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

TxCert.CertRcrd.Ctrct.CtrctRef.Ctrct.Id

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

30

O

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

TxCert.CertRcrd.Ctrct.CtrctRef.Ctrct.DtOfIsse

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

31

O

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

TxCert.CertRcrd.Ctrct.TxAmtInCtrctCcy@Ccy

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

32

R

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

TxCert.CertRcrd.Ctrct.TxAmtInCtrctCcy@Ccy

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

33

O

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

TxCert.CertRcrd.Ctrct.XpctdAdvncPmtRtrDt

34

O

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

TxCert.CertRcrd.Ctrct.XpctdShipmntDt

35

O

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

TxCert.CertRcrd.Tx.RfrdDoc.Id.InstrId

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

36

O

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

TxCert.Amdmnt.OrgnlDocId

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

37

O

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

TxCert.Amdmnt.CrrctnId

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

38

O

Примечание

TxCert.CertRcrd.Ctrct.AddtlInf

39

O

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

TxCert.CertRcrd.Ctrct.AddtlInf

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

40

O

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

TxCert.CertRcrd.Ctrct.AddtlInf

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

41

O

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

TxCert.CertRcrd.Attchmnt

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

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

42

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

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

auth.027.001.01

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

200

OK

-

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

400

Err

XML does not match schema

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

401

Err

Wrong username or password

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

401

Err

User was not found

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

401

Err

Could not find signer by certificate

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

403

Err

User is disabled

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

403

Err

Internal error while verifying permissions

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

403

Err

Signer is not allowed to sign this operation type

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

403

Err

User does not have permission

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

403

Err

Certificate is not valid

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

403

Err

Signer’s warrant is expired

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

403

Err

Signer’s warrant is disabled

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

403

Err

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

406

Err

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

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

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

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

406

Err

Internal sign check state error

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

409

Err

MsgId is not unique

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

500

Err

Internal Error

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

500

Err

Warrant service error

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

502

Err

Bad Gateway

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

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает
Пример подписанных СВО 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.024.001.01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <PmtRgltryInfNtfctn>
        <GrpHdr>
            <MsgId>TEST_MSG_2024-03-15-20240315</MsgId>
            <CreDtTm>2024-03-05T11:12:13.516</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Pty>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        <Othr>
                            <Id>40702810200000000083</Id>
                            <SchmeNm>
                                <Cd>ACC</Cd>
                            </SchmeNm>
                        </Othr>
                        </OrgId>
                    </Id>
                </Pty>
            </InitgPty>
        </GrpHdr>
        <TxNtfctn>
            <TxNtfctnId>TEST_PCT_2024-03-15-20240315</TxNtfctnId>
            <AcctOwnr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </AcctOwnr>
            <AcctSvcr>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </AcctSvcr>
            <TxCert>
                <TxId>TEST_TXID_2024-03-15-20240315</TxId>
                <Cert>
                    <Id>011350</Id>
                    <DtOfIsse>2024-03-15</DtOfIsse>
                </Cert>
                <Acct>
                    <Id>
                        <Othr>
                            <Id>40702810200000000083</Id>
                        </Othr>
                    </Id>
                </Acct>
                <CertRcrd>
                    <CertRcrdId>TEST_CERT_RCRD_2024-03-15-20240315</CertRcrdId>
                    <Tx>
                        <RfrdDoc>
                            <Id>
                                <PmtInfId>TEST_PMT_INF_2022-03-02-154345504</PmtInfId>
                            </Id>
                            <Dt>2024-03-15</Dt>
                        </RfrdDoc>
                        <TxDt>2024-03-15</TxDt>
                        <TxTp>2</TxTp>
                        <LclInstrm>61135</LclInstrm>
                        <Amt Ccy="USD">100.00</Amt>
                    </Tx>
                    <Ctrct>
                        <CtrctRef>
                            <Ctrct>
                                <Id>МТ0000010</Id>
                                <DtOfIsse>2024-03-15</DtOfIsse>
                            </Ctrct>
                        </CtrctRef>
                        <AddtlInf>H2H Testing</AddtlInf>
                    </Ctrct>
                </CertRcrd>
            </TxCert>
        </TxNtfctn>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </PmtRgltryInfNtfctn>
</Document>
Пример СВО с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива

17. Корректирующие СВО

URI

POST: /API/v1/ISO20022/COCertificates

XSD схема

auth.024.001.01

Предварительные условия

Для создания корректирующих СВО, в системе расчетов банка, должно быть ранее созданы СВО в состоянии "Авторизовано". Корректирующие СВО, отличаются от СВО заполненным блоком "Amdmnt"

Описание схемы

№ Описание Путь Комментарий/
Пример

Общий путь Document.PmtRgltryInfNtfctn.GrpHdr

1

Указывается идентификатор сообщения присвоенный во внешней системе

MsgId

-

2

Дата и Время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

Количество транзакций в сообщении

NbOfItms

-

4

ИНН

InitgPty.Pty.Id.OrgId.Othr[1].Id

-

5

Признак использования ИНН

InitgPty.Pty.Id.OrgId.Othr[1].SchmeNm.Cd

Константа 'TXID'

6

Номер счёта

InitgPty.Pty.Id.OrgId.Othr[2].Id

-

7

Признак использования счёта

InitgPty.Pty.Id.OrgId.Othr[2].SchmeNm.Cd

Константа 'ACC'

Общий путь 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

Описание файлов-вложений к СВО. Подробнее в разделе (Работа с вложенными файлами)

Блок с подписью Document.PmtRgltryInfNtfctn

39

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Таблица кодов ответа

auth.027.001.01

HTTP код Тип Body Описание

200

OK

-

Запрос принят без ошибок.

400

Err

XML does not match schema

Документ не соответствует схеме

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

409

Err

MsgId is not unique

Id запроса неуникальный

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

18. Справка о подтверждающих документах

Информация для тестирования

Для получения статуса "Исполнен" [ACPT] необходимо корректно составить и подписать запрос (пример запроса есть ниже в настоящей документации). Затем необходимо написать на п/я h2h@alfabank.ru с просьбой провести операцию, поскольку все операции с валютой требуют авторизации.

Для получения статуса "Отклонен" [RJCT] достаточно, например, некорректно заполнить один из реквизитов.

URI

POST: /API/v1/ISO20022/ConfCertificates

XSD схема

auth.025.001.01

Описание схемы

№ R/
O		 Описание Путь Комментарий/
Пример

Секция Document.CcyCtrlSpprtgDocDlvry.GrpHdr

1

R

Уникальный ID сообщения

MsgId

Указывается идентификатор сообщения присвоенный во внешней системе

2

R

Дата и время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

R

Количество транзакций в сообщении

NbOfItms

-

4

R

ИНН организации

InitgPty.Pty.Id.OrgId.Othr[1].Id

-

5

R

Признак использования ИНН

InitgPty.Pty.Id.OrgId.Othr[1].SchmeNm.Cd

Константа 'TXID'

6

R

Счет организации

InitgPty.Pty.Id.OrgId.Othr[2].Id

-

7

R

Признак использования счета

InitgPty.Pty.Id.OrgId.Othr[2].SchmeNm.Cd

Константа 'ACC'

Секция Document.CcyCtrlSpprtgDocDlvry.GrpHdr.SpprtgDoc

8

R

Уникальный ID СПД

SpprtgDocId

-

9

R

Уникальный id СПД (сквозной) во внешней системе

Cert.Id

-

10

R

Дата СПД

Cert.DtOfIsse

-

11

R

Наименование резидента

AcctOwnr.Nm

-

12

R

ИНН резидента

AcctOwnr.Id.OrgId.Othr.Id

-

13

R

Признак использования ИНН

AcctOwnr.Id.OrgId.Othr.SchmeNm.Cd

Константа 'TXID'

14

R

Признак использования БИК в качестве идентификатора Банка

AcctSvcr.FinInstnId.ClrSysMmbId.ClrSysId.Cd

Константа 'RUCBC'

15

R

БИК Банка

AcctSvcr.FinInstnId.ClrSysMmbId.MmbId

-

16

R

Номер УНК

CtrctRef.RegdCtrctId

-

Секция Document.CcyCtrlSpprtgDocDlvry.GrpHdr.SpprtgDoc.Ntry

17

R

Уникальный ID строки СПД

NtryId

-

18

R

Номер подтверждающего документа (графа 2)

OrgnlDoc.Id

-

19

O

Дата подтверждающего документа (графа 3)

OrgnlDoc.DtOfIsse

-

20

R

Код вида подтверждающего документа (графа 4)

DocTp

-

21

R

Код валюты документа (графа 5)

TtlAmt@Ccy

<TtlAmt Ccy="EUR">2000.00</TtlAmt>

22

R

Сумма по подтверждающему документу в единицах валюты документа (графа 6)

TtlAmt@Ccy

< TtlAmt Ccy="EUR"> 2000.00</TtlAmt>

23

О

Сумма аванса (при импорте) или сумма оплаты по факту (при экспорте) в единицах валюты документа (графа 6)

TtlAmtAftrShipmnt

-

24

О

Код валюты контракта (графа 7)

TtlAmtInCtrctCcy@Ccy

<TtlAmtInCtrctCcy Ccy="EUR">2000.00</TtlAmtInCtrctCcy>

25

О

Сумма по подтверждающему документу в единицах валюты контракта/договора (графа 8)

TtlAmtInCtrctCcy@Ccy

< TtlAmtInCtrctCcy Ccy="EUR"> 2000.00</TtlAmtInCtrctCcy>

26

О

Сумма аванса (при импорте) или сумма оплаты по факту (при экспорте) в единицах валюты контракта/договора (графа 8)

TtlAmtAftrShipmntInCtrctCcy

-

27

O

Признак поставки (графа 9)

ShipmntAttrbts.Conds.Prtry

-

28

O

Ожидаемый срок (графа 10)

ShipmntAttrbts.XpctdDt

-

29

O

Код страны грузоотправителя/грузополучателя (графа 11)

ShipmntAttrbts.CtryOfCntrPty

-

30

O

Примечание

AddtlInf

-

31

O

Вложения к СПД

Attchmnt

Описание файлов-вложений к СПД. Подробнее в разделе (Работа с вложенными файлами)

Секция Document.CcyCtrlSpprtgDocDlvry.GrpHdr.SpprtgDoc.SplmtryData/Envlp/SpprtgDocAddInf/NtryAddInfo

32

O

Идентификатор NtryId соответствующего объекта Ntry

NtryId

-

33

O

Признак оформления декларации на товары на бумажном носителе

DTnPpr

Возможные значение true/false

34

O

Признак представления документов и (или) информации по СФ подтверждающих безвозмездную поставку

DcFrPst

Возможные значение true/false

35

O

Код страны

CtryNmbrCd

Одно из возможных значений - 156 для Китая

Блок с подписью Document.CcyCtrlSpprtgDocDlvry

36

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Таблица кодов ответа

auth.027.001.01

HTTP код Тип Body Описание

200

OK

-

Запрос принят без ошибок.

400

Err

XML does not match schema

Документ не соответствует схеме

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

409

Err

MsgId is not unique

Id запроса неуникальный

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает
Пример неподписанного СПД 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.025.001.01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CcyCtrlSpprtgDocDlvry>
        <GrpHdr>
            <MsgId>MSG_TEST_15-03-2024-20240315</MsgId>
            <CreDtTm>2024-03-15T17:11:13.951</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Pty>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                            <Othr>
                                <Id>40702810200000000083</Id>
                                <SchmeNm>
                                    <Cd>ACC</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Pty>
            </InitgPty>
        </GrpHdr>
        <SpprtgDoc>
            <SpprtgDocId>TEST_SPPRTG_15-03-2024-20240315</SpprtgDocId>
            <Cert>
                <Id>ID_TEST_15-03-2024-20240315</Id>
                <DtOfIsse>2024-03-15</DtOfIsse>
            </Cert>
            <AcctOwnr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>7013602245</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </AcctOwnr>
            <AcctSvcr>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </AcctSvcr>
            <CtrctRef>
                <RegdCtrctId>22010012/1326/0000/1/1</RegdCtrctId>
            </CtrctRef>
            <Ntry>
                <NtryId>TEST_NTRY_15-03-2024-20240315</NtryId>
                <OrgnlDoc>
                    <Id>20220118</Id>
                    <DtOfIsse>2024-03-15</DtOfIsse>
                </OrgnlDoc>
                <DocTp>0023</DocTp>
                <TtlAmt Ccy="RUR">100.00</TtlAmt>
                <ShipmntAttrbts>
                    <Conds>
                        <Prtry>3</Prtry>
                    </Conds>
                    <CtryOfCntrPty>AU</CtryOfCntrPty>
                </ShipmntAttrbts>
                <AddtlInf>Тестирование h2h</AddtlInf>
            </Ntry>
            <SplmtryData>
                <Envlp>
                    <SpprtgDocAddInf>
                        <NtryAddInfo>
                            <NtryId>TEST_NTRY_15-03-2024-20240315</NtryId>
                            <CtryNmbrCd>156</CtryNmbrCd>
                            <DTnPpr>true</DTnPpr>
                            <DcFrPst>true</DcFrPst>
                        </NtryAddInfo>
                    </SpprtgDocAddInf>
                </Envlp>
            </SplmtryData>
        </SpprtgDoc>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CcyCtrlSpprtgDocDlvry>
</Document>
Пример СПД с полями ISO
Изображения отображаются только при открытии документации из папки после разархивации архива

19. Распоряжение о списании средств с транзитного валютного счёта (РСТС)

Размер передаваемого в банк сообщения не должен превышать 50 МБ.
Информация для тестирования

Для получения статуса "Исполнен" [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

-

4

R

Общая сумма поручений в сообщении

CtrlSum

-

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

Если в поле указывается счёт плательщика, то проставляется тип списания комиссии: "с расчетного счета в валюте РФ". Если счёт не указывается - комиссия списывается с суммы сделки (проставляется тип: "Иное").
Обязателен для заполнения, когда параметр "Тип курса" отличен от "SPOT"

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

-

45

R

Тип секции

PmtTpInf.LclInstrm.Prtry

"FX"

46

R

Сумма продажи в валюте

Amt.InstdAmt

-

47

R

Код валюты

Amt.InstdAmt@Ccy

-

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

-

57

R

Код валюты (для возврата/перевода ошибочно поступивших средств)

Amt.InstdAmt@Ccy

-

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

-

63

R

Валюта суммы комиссии (Мнемоника валюты заявления на перевод)

Amt.InstdAmt@Ccy

-

64

R

Сумма (для перевода комитенту, принципалу, доверителю)

RmtInf.Strd.AddtlRmtInf[1..3]

(прописью) + код валюты Пример: «Десять тысяч долларов США 00 центов».

65

R

Дата заявления на перевод иностранной валюты

RmtInf.Strd.RfrdDocInf.RltdDt

Дата заявления на перевод документа Пример: «19.04.2013»

Блок с подписью Document.CstmrCdtTrfInitn

66

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Таблица кодов ответа

pain.002.001.06
Для РСТС заполняются только секции OrgnlGrpInfAndSts (статус сообщения) и OrgnlPmtInfAndSts (статус пакета).

HTTP код Тип Body Описание

200

OK

-

Запрос принят без ошибок.

400

Err

XML does not match schema

Документ не соответствует схеме

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

409

Err

MsgId is not unique

Id запроса неуникальный

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает
Пример неподписанного РСТС (часть средств на перевод, часть на продажу) 
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd: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_2024-03-15_0115032024</MsgId>
			<CreDtTm>2024-03-15T12: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_2024-03-15_0115032024</PmtInfId>
			<PmtMtd>TRF</PmtMtd>
			<PmtTpInf>
				<LclInstrm>
					<Prtry>RU-FCYRLS</Prtry>
				</LclInstrm>
			</PmtTpInf>
			<ReqdExctnDt>2024-03-15</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_2024-03-15_01150320241</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>2024-03-15</RltdDt>
						</RfrdDocInf>
						<RfrdDocAmt>
							<CdtNoteAmt Ccy="USD">24915.00</CdtNoteAmt>
						</RfrdDocAmt>
						<AddtlRmtInf>Двадцать четыре тысячи девятьсот пятнадцать долларов США 00 центов</AddtlRmtInf>
					</Strd>
					<Strd>
						<RfrdDocInf>
							<RltdDt>2024-03-15</RltdDt>
						</RfrdDocInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
			<!--часть суммы на перевод на текущий валютный счет (меньше или равно 20% от суммы поступления)-->
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>TEST_INSTRX_2024-03-15_0115032024</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>2024-03-15</RltdDt>
						</RfrdDocInf>
						<AddtlRmtInf>Четыре тысячи девятьсот восемьдесят три доллара США 00 центов</AddtlRmtInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
			<!--часть суммы на продажу (больше или равно 80% от суммы поступления)-->
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>TEST_INSTRX2_2024-03-15_0115032024</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>2024-03-15</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_2024-03-15_0215032024</MsgId>
			<CreDtTm>2024-03-15T12: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_2024-03-15_0215032024</PmtInfId>
			<PmtMtd>TRF</PmtMtd>
			<PmtTpInf>
				<LclInstrm>
					<Prtry>RU-FCYRLS</Prtry>
				</LclInstrm>
			</PmtTpInf>
			<ReqdExctnDt>2024-03-15</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_2024-03-15_0215032024</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>2024-03-15</RltdDt>
						</RfrdDocInf>
						<RfrdDocAmt>
							<CdtNoteAmt Ccy="USD">24915.00</CdtNoteAmt>
						</RfrdDocAmt>
						<AddtlRmtInf>Двадцать четыре тысячи девятьсот пятнадцать долларов США 00 центов</AddtlRmtInf>
					</Strd>
					<Strd>
						<RfrdDocInf>
							<RltdDt>2024-03-15</RltdDt>
						</RfrdDocInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
			<!--перевод всей суммы на текущий валютный счет-->
			<CdtTrfTxInf>
				<PmtId>
					<InstrId>TEST_INSTRX_2024-03-15_0215032024</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>2024-03-15</RltdDt>
						</RfrdDocInf>
						<AddtlRmtInf>Двадцать четыре тысячи девятьсот пятнадцать долларов США 00 центов</AddtlRmtInf>
					</Strd>
				</RmtInf>
			</CdtTrfTxInf>
		</PmtInf>
		<SplmtryData>
			<Envlp>
				<SgntrSt>
				</SgntrSt>
			</Envlp>
		</SplmtryData>
	</CstmrCdtTrfInitn>
</Document>

20. Отправка письма в Банк

Размер передаваемого в банк сообщения не должен превышать 50 МБ.
Отправленные ранее в банк письма отозвать нельзя.
Информация для тестирования

Для получения статуса "Принято" [ACPT] необходимо корректно составить и подписать запрос (пример запроса есть ниже в настоящей документации). Затем необходимо написать на п/я h2h@alfabank.ru с просьбой согласовать письмо.

Для получения статуса "Отклонен" [RJCT] достаточно, например, некорректно заполнить один из реквизитов.

URI

POST: /API/v1/ISO20022/Letters

XSD схема

auth.026.001.01

Описание схемы

№ R/
O		 Описание Путь Комментарий/
Пример

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

Описание файлов-вложений к письму. Подробнее в разделе (Работа с вложенными файлами)

Блок с подписью Document.CcyCtrlReqOrLttr

20

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-
Пример исходящего письма 
<?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_2024-03-16-20240316</MsgId>
            <CreDtTm>2024-03-16T13: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_2024-03-16-20240316</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>

Таблица кодов ответа

auth.027.001.01

HTTP код Тип Body Описание

200

OK

-

Запрос принят без ошибок.

400

Err

XML does not match schema

Документ не соответствует схеме

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

409

Err

MsgId is not unique

Id запроса неуникальный

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

Ответ

Ответом является XML-документ, соответствующий схеме 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>2024-03-16T13:21:23.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_2024-03-16-20240316</OrgnlMsgId>
                <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
                <OrgnlCreDtTm>2024-03-16T13:20:23.775+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_2024-03-16-20240316</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>2024-03-16T13:25:23.775+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_2024-03-16-20240316</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_2024-03-16-20240316</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

Отклонено

Таблица кодов ответа

HTTP код Тип ответа Ответ в body Описание ответа

200

OK

-

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

404

Err

Request has not been found by MsgId

Запрос не найден по идентификатору MsgId

404

Err

Request has not been found by ReqOrLttrId

Запрос не найден по идентификатору ReqOrLttrId

500

Err

Internal Error

Внутренняя ошибка приложения

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

22. Запрос списка входящих писем

URI

Запрос на получение списка писем (входящие письма и уведомления о поступлении выручки на транзитный валютный счет)

POST: /API/v1/ISO20022/Letters/Lists

После отправки запроса, в случае ответа 200 ОК, необходимо получить список писем с помощью GET запроса (подробнее в разделе "Получение списка входящих писем").

Запрос списка писем без подписи

Реализована возможность запроса списка писем без подписания УКЭП. Для этого необходимо:

1) В Headers передать параметры:

  • company-tin со значением ИНН компании

  • check-sign-message со значением false

2) Тэг <SgntrSt> оставить пустым.

3) При тестировании использовать данные тестовой компании ООО «Тест Альфа-Линк без подписи».

XSD схема

auth.026.001.01

Описание схемы

№ R/
O		 Описание Путь Комментарий/
Пример

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' - все, включая новые

Блок с подписью Document.CcyCtrlReqOrLttr

21

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-
Пример запроса списка писем 
<?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_2024-03-10-20240310</MsgId>
            <CreDtTm>2024-03-06T13:38:20.233</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_2024-03-10-20240310</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>
            <Desc>Запрос списка писем и уведомлений о пвв на твс</Desc>
            <RspnReqrd>false</RspnReqrd>
            <SplmtryData>
                <Envlp>
                    <AdditionalData>
                        <FrToDt>
                            <FrDt>2024-03-01</FrDt>
                            <ToDt>2024-03-10</ToDt>
                        </FrToDt>
                        <OnlyNew>false</OnlyNew>
                    </AdditionalData>
                </Envlp>
            </SplmtryData>
        </ReqOrLttr>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CcyCtrlReqOrLttr>
</Document>

Таблица кодов ответа

auth.027.001.01

HTTP код Тип Body Описание

200

OK

-

Запрос принят без ошибок.

400

Err

XML does not match schema

Документ не соответствует схеме

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

Не определен тип запрашиваемых документов

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

409

Err

MsgId is not unique

Id запроса неуникальный

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

23. Получение списка входящих писем

URI

Получение списка писем (входящие письма и уведомления о поступлении выручки на транзитный валютный счет)

GET: /API/v1/ISO20022/Letters/Lists/<MsgId>

Таблица кодов ответа

HTTP код Тип ответа Ответ в body Описание ответа

200

OK

-

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

404

Err

Request has not been found by MsgId

Запрос не найден по идентификатору MsgId

500

Err

Internal Error

Внутренняя ошибка приложения

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

XSD схема ответа

auth.026.001.01

Описание схемы

№ R/
O		 Описание Путь Комментарий/
Пример

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

Номер письма (номер уведомления ПВВ на ТВС)

LetterNumber

-

26

O

Номер транзитного валютного счета

CCER.NumTVS

-

27

O

Сумма, поступившая на транзитный валютный счет

CCER.SumTVS

-

28

O

Валюта, поступившая на транзитный валютный счет

CCER.SumTVS@Ccy

-

29

O

Дата окончания предоставления документов

CCER.LastDate

-

30

O

Дата начала действия нарушения

CCER.ViolationDate

-

31

O

Номер документа, по которому зачислены средства на транзитный валютный счет

CCER.DocNum

-

32

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

Размещение депозита (вклада)

16

ACPT

Акцепт

17

ISPD

Исполнительные документы

18

CPDC

Запрос из досье/ВБК

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

O

Расчетный счет для выбранного в ведомости зарплатного проекта

InitgPty.Id.OrgId.Othr[2].Id

-

9

O

Признак использования счёта

InitgPty.Id.OrgId.Othr[2].SchmeNm.Cd

Константа "ACC"

10

O

Если у клиента нет расчетного счета, то вместо счета должно передаваться значение "Идентификатор Клиента в Банке"

InitgPty.Id.OrgId.Othr[2].Id

-

11

O

Признак использования "Идентификатор Клиента в Банке"

InitgPty.Id.OrgId.Othr[2].SchmeNm.Cd

Константа "BOID"

Общий путь Document.CstmrDrctDbtInitn.PmtInf

12

R

Идентификатор ведомости

PmtInfId

-

13

R

Вид договора

PmtMtd

Поле обязательно по схеме (Константа 'DD')

14

R

Номер реестра

NbOfTxs

Макс. длина 11 цифр

15

R

Дата формирования реестра

ReqdColltnDt

-

16

R

Номер договора по зарплатному проекту (Сведения о договоре в АЗОН)

Cdtr.Nm

-

17

R

Вид зачисления

CdtrAcct.Id.Othr.Id

Актуальный справочник см. на странице https://alfabank.ru/sme/salaryproject/ →"Полезно знать"→"Управление зарплатным проектом"→"Начисление денежных средств"→"Перечень соответствия оснований начислений в рамках зарплатного проекта кодам вида дохода (КВД) и кодам вида валютных операций (КВО)…​"

18

R

БИК банка, указанного в зарплатном проекте

CdtrAgt.FinInstnId.Nm

-

19

R

Номер строки в ведомости

DrctDbtTxInf.PmtId.InstrId

Макс. длина 7 цифр. Нумерация начинается с единицы должна идти строго по порядку (1,2,3…​).

20

R

Идентификатор строки ведомости (внутр.)

DrctDbtTxInf.PmtId.EndToEndId

-

21

R

Сумма к выплате сотруднику

DrctDbtTxInf.InstdAmt

-

22

R

Цифровой код валюты

DrctDbtTxInf.InstdAmt@Ccy

На данный момент ведомости формируются только в рублях (код - 643)

23

R

Отделение банка зарплатного проекта

DrctDbtTxInf.DbtrAgt.FinInstnId.Nm

Возможно указание константы '0000'.
Список кодов отделений можно найти на странице https://alfabank.ru/sme/salaryproject/
Раздел "Полезно знать", вкладка "Управление зарплатным проектом", подраздел "Открытие счетов и выпуск зарплатных карт для сотрудников резидентов РФ", п.5 "Справочник отделений"
Скачать XLS файл, в нём таблица "Отделение доставки карты", столбец - "Цифровой код"
XLS файл периодически обновляется, рекомендуется проверять обновления раз в полгода
Макс. длина 4 цифры

24

R

Филиал отделения банка зарплатного проекта

DrctDbtTxInf.DbtrAgt.FinInstnId.Othr.Id

Константа '0000'. Макс. длина 4 цифры

25

O

БИК банка, в котором открыт счёт, в случае, если он отличается от банка зарплатного проекта

DrctDbtTxInf.DbtrAgt.BrnchId.Id

-

26

R

Фамилия сотрудника

DrctDbtTxInf.Dbtr.PstlAdr.Dept

Макс. длина 30 символов

27

R

Имя сотрудника

DrctDbtTxInf.Dbtr.PstlAdr.SubDept

Макс. длина 30 символов

28

0

Отчество сотрудника

DrctDbtTxInf.Dbtr.PstlAdr.StrtNm

Макс. длина 30 символов

29

R

Номер лицевого счета сотрудника

DrctDbtTxInf.DbtrAcct.Id.Othr.Id

-

30

0

Сумма удержания (взыскания)

DrctDbtTxInf.Tax.TtlTaxAmt@Ccy

-

Блок с подписью Document.CstmrDrctDbtInitn

31

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-

Ответ

Ответом является XML-документ, соответствующий схеме pain.002.001.06.

Описание схемы: Статусы по Зарплатным ведомостям

Таблица кодов ответа

HTTP код Тип Body Описание

200

OK

-

Запрос принят без ошибок.

400

Err

XML does not match schema

Документ не соответствует схеме

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

409

Err

MsgId is not unique

Id запроса неуникальный

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает
Пример Зарплатной ведомости 
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.008.001.05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrDrctDbtInitn>
        <GrpHdr>
            <MsgId>7421w6f13a01983593e8dffb71fa6d15</MsgId> <!-- Идентификатор сообщения -->
            <CreDtTm>2024-03-15T12: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>40702810400000002221</Id> <!-- Расчетный Счет Организации -->
                            <SchmeNm>
                                <Cd>ACC</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <PmtInfId>7421w6f13a01983593e8dffb71fa6d15</PmtInfId> <!-- Идентификатор ведомости -->
            <PmtMtd>DD</PmtMtd> <!-- Константа -->
            <NbOfTxs>1</NbOfTxs> <!-- Номер Реестра -->
            <ReqdColltnDt>2024-03-15</ReqdColltnDt> <!-- Дата Реестра -->
            <Cdtr>
                <Nm>00IDLM</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>40817810904050000004</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>40817810204050000005</Id> <!-- Лицевой Счет -->
                        </Othr>
                    </Id>
                </DbtrAcct>
                <Tax>
                    <TtlTaxAmt Ccy="RUB">23.00</TtlTaxAmt> <!-- Сумма удержания (Взыскания) -->
                </Tax>
            </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

O

Расчетный счет для выбранного зарплатного проекта в заявке на открытие лицевого счета

Org.OrgId.Othr[2].Id

-

15

O

Признак использования счёта

Org.OrgId.Othr[2].SchmeNm.Cd

Константа 'ACC'

16

O

Если у клиента нет расчетного счета, то вместо счета должно передаваться значение "Идентификатор Клиента в Банке"

Org.OrgId.Othr[2].Id

-

17

O

Признак использования "Идентификатор Клиента в Банке"

Org.OrgId.Othr[2].SchmeNm.Cd

Константа "BOID"

18

R

Количество строк в заявке на открытие лицевого счета

RefAcct.Nm

Макс. длина 7 цифр

Общий путь Document.AcctOpngReq.SplmtryData.Envlp.EmplInfo.Empl (по одному блоку Empl на сотрудника)

19

R

Идентификатор строки заявки на открытие ЛС для одного сотрудника

EmNum

Макс. длина 7 цифр. Нумерация начинается с единицы должна идти строго по порядку (1,2,3…​).

20

R

Фамилия сотрудника

LstNm

Макс. длина 30 символов

21

R

Имя сотрудника

FstNm

Макс. длина 30 символов

22

O

Отчество сотрудника

MdlNm

Макс. длина 30 символов

23

R

Отделение банка

BnkBrch

Список кодов отделений можно найти на странице https://alfabank.ru/sme/salaryproject/
Раздел "Полезно знать", вкладка "Управление зарплатным проектом", подраздел "Открытие счетов и выпуск зарплатных карт для сотрудников резидентов РФ", п.5 "Справочник отделений"
Скачать XLS файл, в нём таблица "Отделение доставки карты", столбец - "Цифровой код"
XLS файл периодически обновляется, рекомендуется проверять обновления раз в полгода
Макс. длина 4 цифры

24

R

Вид документа, удостоверяющего личность сотрудника

IdentityDoc.DocTp

Текстовое описание вида документа, например "Паспорт гражданина РФ". Макс. длина 75 символов

25

R

Серия документа

IdentityDoc.DocSr

Макс. 14 символов, для паспорта РФ допустимы варианты 4 цифры с пробелом и без (0000 и 00 00)

26

R

Номер документа

IdentityDoc.DocNmb

Макс. длина 14 символов

27

R

Дата выдачи документа

IdentityDoc.DocStartDate

-

28

R

Кем выдан документ

IdentityDoc.DocBy

Макс. длина 250 символов

29

R

Код подразделения

IdentityDoc.DocCd

Макс. длина 10 символов

30

R

Код вида документа

IdentityDoc.DocTpCd

Код вида документа по классификатору ФНС ПРИКАЗ от 13.10.2006 г. N САЭ-3-04/706 "ОБ УТВЕРЖДЕНИИ ФОРМЫ СВЕДЕНИЙ О ДОХОДАХ ФИЗИЧЕСКИХ ЛИЦ". Макс. длина 2 символа

31

R

Дата рождения сотрудника

BrsDate

-

32

R

Пол

Sex

M - мужской / F - женский

33

O

Должность

Pstn

Макс. длина 100 символов

34

O

Регион места рождения (полное)

BrthPlc.Reg.Nm

Необходимо указать как минимум один из тегов <Reg>, <City>, <Loc>, <Dist>. Макс. длина 45 символов

35

O

Регион места рождения (сокращение)

BrthPlc.Reg.NmShrt

Макс. длина 10 символов

36

O

Район места рождения (полное)

BrthPlc.Dist.Nm

Необходимо указать как минимум один из тегов <Reg>, <City>, <Loc>, <Dist>. Макс. длина 45 символов

37

O

Район места рождения (сокращение)

BrthPlc.Dist.NmShrt

Макс. длина 10 символов

38

O

Город места рождения (полное)

BrthPlc.City.Nm

Необходимо указать как минимум один из тегов <Reg>, <City>, <Loc>, <Dist>. Макс. длина 50 символов

39

O

Город места рождения (сокращение)

BrthPlc.City.NmShrt

Макс. длина 10 символов

40

O

Населённый пункт места рождения (полное)

BrthPlc.Loc.Nm

Необходимо указать как минимум один из тегов <Reg>, <City>, <Loc>, <Dist>. Макс. длина 50 символов

41

O

Населённый пункт места рождения (сокращение)

BrthPlc.Loc.NmShrt

Макс. длина 10 символов

Поле Эмбоссированный текст содержит имя сотрудника на зарплатной карте. Разделяется на три поля, третье может отсутствовать. Примеры заполнения: TATIANA M/IVANOVA или TANIA/IVANOVA/MRS

42

R

Эмбосированный текст Поле 1

Embsdtxt.Fld1

Макс. длина 25 символов

43

R

Эмбосированный текст Поле 2

Embsdtxt.Fld2

Макс. длина 25 символов

44

O

Эмбосированный текст Поле 3

Embsdtxt.Fld3

Макс. длина 25 символов

45

R

Код валюты зарплаты

CCy

Код валюты, в которой зачисляется зарплата. Код валюты российского рубля "643"

46

R

Резидент

Rsdnt

true - для резидентов. Иначе false

47

R

Гражданство сотрудника

CntrOrig

Макс. длина 64 символа

48

R

Мобильный телефон

Phone

10 цифр без указания кода страны, например: 9777777777

49

O

Табельный номер сотрудника в организации

EmpIdNumr

Макс. длина 255 символов

50

O

Дата оформления

EmpDt

-

51

O

Сумма заработной платы

SlryAmt

Размер заработной платы сотрудника организации в месяц, на момент формирования реестра. Без учета периодических премий.

52

O

Дата выплаты

PayDt

День выплаты заработной платы сотруднику организации (дата выплаты основной части зарплаты)

53

O

Контактный номер мобильного телефона

CtPhNmb

10 цифр без указания кода страны, например: 9777777777

Блок с подписью Document.AcctOpngReq

54

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-
Пример Заявки на открытие лицевых счетов с подписью 
<?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_2024-03-15-123321</Id> <!-- ИД сообщения -->
                <CreDtTm>2024-03-15T17:16:30.307</CreDtTm> <!-- Дата документа -->
            </MsgId>
            <PrcId>
                <Id>30307</Id> <!-- Номер реестра -->
                <CreDtTm>2024-03-15T17: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>40702810400000002221</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>2024-03-11</EmpDt> <!-- Дата оформления -->
                        <SlryAmt>1.00</SlryAmt> <!-- Сумма заработной платы -->
                        <PayDt>2024-03-20</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

-

Запрос принят без ошибок.

400

Err

XML does not match schema

Документ не соответствует схеме

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

409

Err

MsgId is not unique

Id запроса неуникальный

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

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

Описание схемы

№ R/
O		 Описание Путь Комментарий/
Пример

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'

Блок с подписью Document.CcyCtrlReqOrLttr

13

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-
Пример запроса на формирование архива со списком ВБК 
<?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_15-03-2024-03152024</MsgId>
            <!-- Дата и время создания сообщения -->
            <CreDtTm>2024-03-15T10:11:13.951</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_15-03-2024-03152024</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_15-03-2024-03152024</ReqOrLttrId>
            <!--Тип документа, по которому формируется ВБК-->
            <Sbjt>VBK</Sbjt>
            <!--Тип документа, по которому формируется ВБК-->
            <Tp>PDF</Tp>
            <!--Уникальный номер контракта, по которому нужно сформировать ВБК-->
            <Desc>22080915/1326/0000/1/1</Desc>
            <!--Признак необходимости предоставления ответа на запрос-->
            <RspnReqrd>true</RspnReqrd>
        </ReqOrLttr>
        <SplmtryData>
            <Envlp>
                <!--Блок для вставки подписи-->
                <SgntrSt>
                </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>2024-03-15T10:11:15.951+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_15-03-2024-03152024</OrgnlMsgId>
				<OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
				<!-- Дата и время исходного сообщения с запросом -->
				<OrgnlCreDtTm>2024-03-15T10:11:13.951+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_15-03-2024-03152024</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>2024-03-15T10:11:15.951+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_15-03-2024-03152024</OrgnlMsgId>
				<OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
				<!-- Дата и время исходного сообщения с запросом -->
				<OrgnlCreDtTm>2024-03-15T10:11:13.951+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 код Тип 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

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет права на запрос формирования архива с ВБК

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

409

Err

MsgId is not unique

Id запроса неуникальный

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

28. Статус обработки архива с Ведомостями банковского контроля

URI

Получение статуса обработки запроса на формирование архива со списком ВБК

GET: /API/v1/ISO20022/ContractReports/<MsgId>

Ответ

Ответом является XML-документ, соответствующий схеме auth.027.001.01. Описание параметров ответа доступно в разделе Описание схемы ответа.

В разделе Статусы Ведомости банковского контроля доступно описание статусов.

В разделе Таблица кодов ответа доступен список кодов ошибок с описанием.

Проверка значений УНК (см. Требования к Уникальному номеру контракта) происходит в два этапа:
1) Сначала проверяется само значение УНК на соответствие Инструкции Банка России. Если в значении найдена ошибка, то невалидному УНК проставляется статус "Отклонено" (RJCT), а запрос с оставшимися валидными УНК обрабатывается дальше.
2) Далее список УНК передается системе ТБСВК, где проверяется наличие данных по компании для них. Если данные не найдены хотя бы по одному УНК, то всему запросу и каждому УНК в нем проставляется статус "Отклонено" (RJCT).

Ответ для успешно обработанного запроса

Пример ответа с успешным статусом обработки 
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
	<CcyCtrlStsAdvc>
		<GrpHdr>
			<!-- Уникальный ID сообщения-->
			<MsgId>02aec2645110423b8aa074d1414e61cf</MsgId>
			<!-- Дата и время создания сообщения -->
			<CreDtTm>2024-03-15T11:11:15.951+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_15-03-2024-03152024</OrgnlMsgId>
				<OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
				<!-- Дата и время исходного сообщения с запросом -->
				<OrgnlCreDtTm>2024-03-15T10:11:13.951+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_15-03-2024-03152024</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).

Описание статусов доступно в разделе Статусы Ведомости банковского контроля.

В разделе Таблица кодов ответа доступен список кодов ошибок с описанием.

Ответ на успешно обработанный запрос

Запрос в статусах:

  • "Запрос успешно обработан" (ACPT)

  • "Частично обработан" (PART)

Метод вернет HTTP статус 200 и файл архива со списком ВБК.

Ответ для запроса без архива

Запрос в статусах:

  • "Обработка" (PDNG)

  • "Принят в обработку" (ACTC)

  • "Отклонен" (RJCT)

Метод вернет HTTP статус 404 со следующим телом ответа:

Message with <MsgId> not found

29. Платежи СБП для B2B

Термины и сокращения

Агент ТСП - Организация, обеспечивающая продавцу информационно-техническое сопровождение (Альфа Банк)
Мерчант - Торговая точка, идетификатор Клиента - Продавца
НСПК - Национальная система платёжных карт СБП - Сервис быстрых платежей
ТСП - Торгово-сервисное предприятие

Общая информация

Работа Клиента с СБП для B2B подразумевает вызов следующих доступных методов:

  • Формирование платежной ссылки/QR кода (одноразовой/многоразовой) и получение информации по ней;

  • Запрос списка входящих СБП платежей для B2B;

  • Исполнение исходящего СБП платежа для B2B и проверка его статуса.

Клиент предварительно должен быть зарегистрирован в СБП НСПК, где ему будет присвоен Идентификатор ТСП "merchantId".

Формирование платежной ссылки/QR кода

Обратите внимание

В зависимости от типа ссылки: одноразовая (ONETIME) или многоразовая (REUSABLE) зависит обязательность полей при заполнении данных ссылки.

URI

POST: /API/v1/ISO20022/Payments/B2B/Link

XML схема

auth.026.001.01

Описание схемы

№ R/
O		 Описание Путь Комментарий/
Пример

Document.CcyCtrlReqOrLttr.GrpHdr

1

R

Уникальный ID сообщения

MsgId

-

2

R

Дата и время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

R

Число элементов в сообщении

NbOfItms

Константа '1'

4

R

Идентификатор ТСП "merchantId"

InitgPty.Pty.Id.OrgId.Othr[0].Id

-

5

R

Признак использования "merchantId"

InitgPty.Pty.Id.OrgId.Othr[0].SchmeNm.Cd

Константа 'MRCH'

6

R

Номер счета Получателя

InitgPty.Pty.Id.OrgId.Othr[1].Id

-

7

R

Признак использования номера счета

InitgPty.Pty.Id.OrgId.Othr[1].SchmeNm.Cd

Константа 'ACC'

8

R

ИНН Получателя

InitgPty.Id.OrgId.Othr[2].Id

-

9

R

Признак использования ИНН

InitgPty.Id.OrgId.Othr.[2]SchmeNm.Cd

Константа 'TXID'

Document.CcyCtrlReqOrLttr.ReqOrLttr - объект с данными платежной ссылки

10

R

Уникальный ID запроса

ReqOrLttrId

-

11

R

Наименование платежной ссылки

Sndr.Pty.Nm

-

12

O

Идентификатор платежа внешней системы

Sndr.Pty.Id.OrgId.Othr.Id

-

13

O

Ссылка для перехода после выполнения платежа "redirect_url"

Sndr.Pty.CtctDtls.EmailAdr

-

14

R

Тип ссылки: многоразовая или одноразовая

Sbjt

Возможные значения:
- 'ONETIME'
- 'REUSABLE'

15

R

Тип СБП платежа

Tp

Константа 'B2B'

16

R

Признак необходимости предоставления ответа на запрос.

RspnReqrd

Константа 'true'

17

R/O

Сумма комиссии в копейках

SplmtryData.Envlp.PmtInf.TaxAmt

Если тип ссылки = ONETIME, то R ,
Если тип ссылки = REUSABLE, то O

18

R

Валюта комиссии

SplmtryData.Envlp.PmtInf.TaxAmt@Ccy

Константа 'RUB', так как
СБП поддерживает только рублевые платежи

19

R/O

Сумма платежа в копейках

SplmtryData.Envlp.PmtInf.PmAmt

Если тип ссылки = ONETIME, то R ,
Если тип ссылки = REUSABLE, то O

20

R

Валюта платежа

SplmtryData.Envlp.PmtInf.PmAmt@Ccy

Константа 'RUB', так как
СБП поддерживает только рублевые платежи

21

O

Назначение платежа

SplmtryData.Envlp.PmtInf.PmPrps

-

22

O

Время жизни ссылки в минутах

SplmtryData.Envlp.PmtInf.Ttl

-

Блок с подписью Document.CcyCtrlReqOrLttr

23

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-
Пример запроса на создание платежной ссылки 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CcyCtrlReqOrLttr>
        <GrpHdr>
            <!-- Уникальный ID сообщения-->
            <MsgId>7TEST_MSG_2022-08-23-279190544</MsgId>
            <!-- Дата и время создания сообщения -->
            <CreDtTm>2022-08-23T12:44:40.624</CreDtTm>
            <!--Константа-->
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Pty>
                    <Id>
                        <OrgId>
                            <Othr>
                            <!--Идентификатор ТСП "merchantId" -->
                            <Id>MA0000118726</Id>
                            <SchmeNm>
                                <!--Контанта для признака "merchantId"-->
                                <Cd>MRCH</Cd>
                            </SchmeNm>

                            </Othr>
                            <Othr>
                                <!-- Номер счета -->
                                <Id>40802810400000000000</Id>
                                <SchmeNm>
                                    <Cd>ACC</Cd>
                                </SchmeNm>
                            </Othr>
                            <!-- ИНН компании-->
                            <Othr>
                                <Id>691202047705</Id>
                                <!-- Признак ИНН компании-->
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>

                </Pty>

            </InitgPty>
        </GrpHdr>
        <ReqOrLttr>

            <!-- Уникальный ID сообщения-->
            <ReqOrLttrId>7TEST_MSG_2022-08-23-279190544</ReqOrLttrId>

            <Sndr>
                <Pty>
                    <!-- Наименование платежной ссылки -->
                    <Nm>Одноразовая платежная ссылка 1</Nm>

                    <Id>
                        <OrgId>
                            <Othr>
                                <!--Идентификатор платежа внешней системы -->
                                <Id>123456</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                    <!-- Ссылка для перехода после выполнения платежа "redirect_url" -->
                    <CtctDtls>
                        <EmailAdr>https://www.google.com/search?q=Max2048Text+xmlsearch?q=Max2048Text+xmlseasearch?q=Max2048Text+xmlsearch?q=Max2048Text+xmlsearch?q=Max2048Text+xmlsearch?q=Max2048Text+xmlrch?q=Max2048Text+xmlsearch?q=Max2048Text+xml</EmailAdr>
                    </CtctDtls>
                </Pty>

            </Sndr>

            <!-- Тип ссылки: многоразовая (reusable) или одноразовая (one-time-pay)
                            * ONETIME
                            * REUSABLE
                        -->
            <Sbjt>ONETIME</Sbjt>

            <!-- Константа-->
            <Tp>B2B</Tp>
          <!-- Константа -->
            <RspnReqrd>true</RspnReqrd>
            <SplmtryData>
                <Envlp>
                    <PmtInf>
                        <!-- Комиссия "taxAmount" в копейках  -->
                        <TaxAmt Ccy="RUB">100</TaxAmt>
                        <!-- Сумма к зачислению "amount" в копейках -->
                        <PmAmt Ccy="RUB">100</PmAmt>
                        <!--Назначение платежа paymentPurpose-->
                        <PmPrps>Назначение платежа</PmPrps>
                        <!-- Время жизни ссылки в минутах "ttl" -->
                        <Ttl>100</Ttl>
                    </PmtInf>

                </Envlp>
            </SplmtryData>
        </ReqOrLttr>
        <SplmtryData>
            <Envlp>
                <!--Блок для вставки подписи-->
                <SgntrSt></SgntrSt>
            </Envlp>
        </SplmtryData>
    </CcyCtrlReqOrLttr>
</Document>

Описание схемы успешного ответа

Ответ соответствует схеме auth.027.001.01.

№ R/
O		 Описание Путь Комментарий/
Пример

Document.CcyCtrlStsAdvc.GrpHdr

1

R

Идентификатор сообщения

MsgId

-

2

R

Дата и время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

R

Число элементов в сообщении

NbOfItms

Константа '1'

4

R

Идентификатор ТСП "merchantId"

RcvgPty.Id.OrgId.OthrId[0].Id

-

5

R

Признак использования "merchantId"

RcvgPty.Pty.Id.OrgId.Othr[0].SchmeNm.Cd

Константа 'MRCH'

6

R

Номер счета Получателя

RcvgPty.Pty.Id.OrgId.Othr[1].Id

-

7

R

Признак использования номера счета

RcvgPty.Pty.Id.OrgId.Othr[1].SchmeNm.Cd

Константа 'ACC'

8

R

Пустой обязательный параметр

RegnAgt.FinInstnId

-

Document.CcyCtrlStsAdvc.GrpSts

9

R

Идентификатор созданной платежной ссылки

OrgnlRefs.OrgnlMsgId

-

10

R

Идентификатор наименования исходного сообщения

OrgnlMsgNmId

Константа 'auth.026.001.01'

11

R

Наименование ссылки

RptgPty.PtyId.Nm

-

12

R

Идентификатор платежа внешней системы

RptgPty.PtyId>.Id.OrgId.Othr[0].Id

-

13

R

Ссылка для перехода после выполнения платежа "redirect_url"

RptgPty.PtyId>.CtctDtls.EmailAdr

-

14

R

Пустой обязательный параметр

RegnAgt.FinInstnId

-

15

R

Статус исходного сообщения

Sts

-

16

R

Название поля "сумма"

StsRsn.VldtnRule[0].Id

Константа 'amount'

17

R

Значение поля "сумма"

StsRsn.VldtnRule[0].Issr

-

18

R

Название поля "комиссия"

StsRsn.VldtnRule[1].Id

Константа 'tax'

19

R

Значение поля "комиссия"

StsRsn.VldtnRule[1].Issr

-

20

R

Название поля "время жизни ссылки"

StsRsn.VldtnRule[2].Id

Константа 'ttl'

21

R

Значение поля "время жизни ссылки"

StsRsn.VldtnRule[2].Issr

-

22

R

Назначение платежа

StsRsn.AddtlInf[1…​n]

-

23

R

Дата присвоения статуса

StsDtTm

-

Document.CcyCtrlStsAdvc.PackgSts

24

R

Идентификатор пакета

PackgId

Константа 'undefined'

25

R

Статус обработки всего запроса

Sts

Дублирует значение из GrpSts.Sts.

26

R

Адрес платежной ссылки

StsRsn.Orgtr.CtctDtls.EmailAdr

-

Document.CcyCtrlStsAdvc.SplmtryData

27

O

QR код, зашифрованный в base64 строку

Envlp.Image

-

Описание схемы ответа с ошибкой

Ответ соответствует схеме auth.027.001.01.

№ R/
O		 Описание Путь Комментарий/
Пример

Document.CcyCtrlStsAdvc.GrpHdr

1

R

Идентификатор сообщения

MsgId

-

2

R

Дата и время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

R

Число элементов в сообщении

NbOfItms

Константа '1'

4

R

Пустой обязательный параметр

RegnAgt.FinInstnId

-

Document.CcyCtrlStsAdvc.GrpSts

5

R

Идентификатор исходного сообщения

OrgnlRefs.OrgnlMsgId

Константа 'auth.026.001.01'

6

R

Идентификатор наименования исходного сообщения

OrgnlRefs.OrgnlMsgNmId

Константа 'auth.026.001.01'

7

R

Пустой обязательный параметр

RegnAgt.FinInstnId

-

8

R

Статус исходного сообщения

Sts

-

9

O

Код причины ошибки в ISO

StsRsn.Rsn.Prtry

-

10

O

Описание причины присвоения статуса сообщения

StsRsn.AddtlInf[1…​n]

-
Пример ответа при успешном создании платежной ссылки 
<?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>9b65083cd2b6401abc9daab6c56401d5</MsgId>
            <CreDtTm>2024-06-28T16:34:19.597+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <RcvgPty>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>MA0000121526</Id>
                            <SchmeNm>
                                <Cd>MRCH</Cd>
                            </SchmeNm>
                        </Othr>
                        <Othr>
                            <Id>40802810400000000000</Id>
                            <SchmeNm>
                                <Cd>ACC</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </RcvgPty>
            <RegnAgt>
                <FinInstnId/>
            </RegnAgt>
        </GrpHdr>
        <GrpSts>
            <OrgnlRefs>
                <OrgnlMsgId>AS1B007MMREDVV4E8CB8RND810V463O6</OrgnlMsgId>
                <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
            </OrgnlRefs>
            <RptgPty>
                <PtyId>
                    <Nm>Одноразовая платежная ссылка 1</Nm>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>123456</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                    <CtctDtls>
                        <EmailAdr>https://www.google.com/search?q=Max2048Text+xmlsearch?q=Max2048Text+xmlseasearch?q=Max2048Text+xmlsearch?q=Max2048Text+xmlsearch?q=Max2048Text+xmlsearch?q=Max2048Text+xmlrch?q=Max2048Text+xmlsearch?q=Max2048Text+xml</EmailAdr>
                    </CtctDtls>
                </PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId/>
            </RegnAgt>
            <Sts>ACPT</Sts>
            <StsRsn>
                <VldtnRule>
                    <Id>amount</Id>
                    <Issr>1</Issr>
                </VldtnRule>
                <VldtnRule>
                    <Id>tax</Id>
                    <Issr>1</Issr>
                </VldtnRule>
                <VldtnRule>
                    <Id>ttl</Id>
                    <Issr>1000</Issr>
                </VldtnRule>
                <AddtlInf>Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laor</AddtlInf>
                <AddtlInf>eet dolore magna aliquam erat volut</AddtlInf>
            </StsRsn>
            <StsDtTm>2024-06-28T13:34:19.426Z</StsDtTm>
        </GrpSts>
        <PackgSts>
            <PackgId>7TEST_MSG_2022-08-23-279190544</PackgId>
            <Sts>ACPT</Sts>
            <StsRsn>
                <Orgtr>
                    <CtctDtls>
                        <EmailAdr>https://b2b.cbrpay.ru/AS1B007MMREDVV4E8CB8RND810V463O6</EmailAdr>
                    </CtctDtls>
                </Orgtr>
            </StsRsn>
        </PackgSts>
        <SplmtryData>
            <Envlp>
                <Image xmlns:ns2="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01" xmlns="">iVBORw0KGgoAAAANSUhEUgAAASwAAAEsCAYAAAB5fY51AAAsAklEQVR4Xu2d+7OmaVWe+RPyQ6JRNKgxiVoUhYqIgHL2gIrIQQELgpgYCQRBTDAgyFkcBxFBRARFENBiAA9EpYwDQWWcxOHgZAKMyDgIMogD6kxPT8+h3/Bt7J6vrz13399avd71ve/muaruwtp9rcPzfN1Pde9u4TbTYDAYrITb8AuDwWCwVMaDNRgMVsN4sAaDwWoYD9ZgMFgN48EaDAarYTxYg8FgNYwHazAYrIbxYA0Gg9UwHqzBYLAaxoM1GAxWw3iwBoPBahgP1mAwWA3jwRoMBqthPFiDwWA1jAdrMBishvFgDQaD1TAerMFgsBrGgzUYDFbDeLAGg8FqGA/WYDBYDePBGgwGq2E8WIPBYDWMB2swGKyG8WANBoPVMB6swWCwGsaDNRgMVkPrg3Wb29xmFVHQy/oqS4P7de3JedVz2TcbBT3nK1i/1HTSOo0HXWoU9LK+ytLgfl17cl71XPbNRkHP+QrWLzWdtE7jQZcaBb2sr7I0uF/XnpxXPZd9s1HQc76C9UtNJ63TeNClRkEv66ssDe7XtSfnVc9l32wU9JyvYP1S00nrNB50qVHQy/oqS4P7de3JedVz2TcbBT3nK1i/1HTSOo0HXWoU9LK+ytLgfl17cl71XPbNRkHP+QrWLzWdtE7jQfdx4G24h9uHXtaPRkEv66so6GV9FQU95ytY7/rQc76C9a4PPefPDffYxz6t03jQfRx4G+7h9qGX9aNR0Mv6Kgp6WV9FQc/5Cta7PvScr2C960PP+XPDPfaxT+s0HnQfB96Ge7h96GX9aBT0sr6Kgl7WV1HQc76C9a4PPecrWO/60HP+3HCPfezTOo0H3ceBt+Eebh96WT8aBb2sr6Kgl/VVFPScr2C960PP+QrWuz70nD833GMf+7RO40H3ceBtuIfbh17Wj0ZBL+urKOhlfRUFPecrWO/60HO+gvWuDz3nzw332Mc+rdN40H0ceBvu4fahl/WjUdDL+ioKellfRUHP+QrWuz70nK9gvetDz/lzwz32sU/rNB7UHZheNgp6Xb6Kgp6Lgl61r2C9SxXsW90/Cvdw+9DL+tEo6Dl/Dlqn8aDuwPSyUdDr8lUU9FwU9Kp9BetdqmDf6v5RuIfbh17Wj0ZBz/lz0DqNB3UHppeNgl6Xr6Kg56KgV+0rWO9SBftW94/CPdw+9LJ+NAp6zp+D1mk8qDswvWwU9Lp8FQU9FwW9al/Bepcq2Le6fxTu4fahl/WjUdBz/hy0TuNB3YHpZaOg1+WrKOi5KOhV+wrWu1TBvtX9o3APtw+9rB+Ngp7z56B1Gg/qDkwvGwW9Ll9FQc9FQa/aV7DepQr2re4fhXu4fehl/WgU9Jw/B63TeFB3YHrZKOg5f19wPxcFPecrWO/60KtOFNZXR0Gvy49GQc/5c9A6jQd1B6aXjYKe8/cF93NR0HO+gvWuD73qRGF9dRT0uvxoFPScPwet03hQd2B62SjoOX9fcD8XBT3nK1jv+tCrThTWV0dBr8uPRkHP+XPQOo0HdQeml42CnvP3BfdzUdBzvoL1rg+96kRhfXUU9Lr8aBT0nD8HrdN4UHdgetko6Dl/X3A/FwU95ytY7/rQq04U1ldHQa/Lj0ZBz/lz0DqNB3UHppeNgp7z9wX3c1HQc76C9a4PvepEYX11FPS6/GgU9Jw/B63TeFB3YHrZKOg5X8F6lyisd4nC+mwU9JxfBed1zVVwD7cPvawfjYKe8+egdRoP6g5MLxsFPecrWO8ShfUuUVifjYKe86vgvK65Cu7h9qGX9aNR0HP+HLRO40Hdgello6DnfAXrXaKw3iUK67NR0HN+FZzXNVfBPdw+9LJ+NAp6zp+D1mk8qDswvWwU9JyvYL1LFNa7RGF9Ngp6zq+C87rmKriH24de1o9GQc/5c9A6jQd1B6aXjYKe8xWsd4nCepcorM9GQc/5VXBe11wF93D70Mv60SjoOX8OWqfxoO7A9LJR0HO+gvUuUVjvEoX12SjoOb8Kzuuaq+Aebh96WT8aBT3nz0HrNB50Hwfehnu4fei5zA3nubn0nB+FfV2isN5FQS/rqyjoVftzwz32sU/rNB50Hwfehnu4fei5zA3nubn0nB+FfV2isN5FQS/rqyjoVftzwz32sU/rNB50Hwfehnu4fei5zA3nubn0nB+FfV2isN5FQS/rqyjoVftzwz32sU/rNB50Hwfehnu4fei5zA3nubn0nB+FfV2isN5FQS/rqyjoVftzwz32sU/rNB50Hwfehnu4fei5zA3nubn0nB+FfV2isN5FQS/rqyjoVftzwz32sU/rNB50Hwfehnu4fei5zA3nubn0nB+FfV2isN5FQS/rqyjoVftzwz32sU/rNB50qVHQG/6Z0Bv+mdDL+ktLJ63TeNClRkFv+GdCb/hnQi/rLy2dtE7jQZcaBb3hnwm94Z8Jvay/tHTSOo0HXWoU9IZ/JvSGfyb0sv7S0knrNB50qVHQG/6Z0Bv+mdDL+ktLJ63TeNClRkFv+GdCb/hnQi/rLy2d9E5bOfygXBT0XBT0XBT0nF8F57m59LK+ShTWZ/sMdmfcbgD+xHRR0HNR0HNR0HN+FZzn5tLL+ipRWJ/tM9idcbsB+BPTRUHPRUHPRUHP+VVwnptLL+urRGF9ts9gd8btBuBPTBcFPRcFPRcFPedXwXluLr2srxKF9dk+g90ZtxuAPzFdFPRcFPRcFPScXwXnubn0sr5KFNZn+wx2Z9xuAP7EdFHQc1HQc1HQc34VnOfm0sv6KlFYn+0z2J1F3y5/ImSjoFftzw33cFHQW5sfhX1df3ouUVifTRTWZ9NJ77QgvJhsFPSq/bnhHi4Kemvzo7Cv60/PJQrrs4nC+mw66Z0WhBeTjYJetT833MNFQW9tfhT2df3puURhfTZRWJ9NJ73TgvBislHQq/bnhnu4KOitzY/Cvq4/PZcorM8mCuuz6aR3WhBeTDYKetX+3HAPFwW9tflR2Nf1p+cShfXZRGF9Np30TgvCi8lGQa/anxvu4aKgtzY/Cvu6/vRcorA+myisz6aT3mkCXoC7CHpHxVepgn1dqmBfFwU9lyisr+6jEoX1Lgp61f4c9E4T8ALcRdA7Kr5KFezrUgX7uijouURhfXUflSisd1HQq/bnoHeagBfgLoLeUfFVqmBflyrY10VBzyUK66v7qERhvYuCXrU/B73TBLwAdxH0joqvUgX7ulTBvi4Kei5RWF/dRyUK610U9Kr9OeidJuAFuIugd1R8lSrY16UK9nVR0HOJwvrqPipRWO+ioFftz0HvNAEvwF0EvaPiq1TBvi5VsK+Lgp5LFNZX91GJwnoXBb1qfw5ap/GgLgp6WV9FQa8rVbBvtj/rXR96zlewvrpPVRT0nB+FfbP9WZ/tMwetW/ACXBT0sr6Kgl5XqmDfbH/Wuz70nK9gfXWfqijoOT8K+2b7sz7bZw5at+AFuCjoZX0VBb2uVMG+2f6sd33oOV/B+uo+VVHQc34U9s32Z322zxy0bsELcFHQy/oqCnpdqYJ9s/1Z7/rQc76C9dV9qqKg5/wo7Jvtz/psnzlo3YIX4KKgl/VVFPS6UgX7Zvuz3vWh53wF66v7VEVBz/lR2Dfbn/XZPnPQugUvwEVBL+urKOh1pQr2zfZnvetDz/kK1lf3qYqCnvOjsG+2P+uzfeZgGVsE4UV2XSjnVc9l37VFQc8lCuuzfargHkuNgp7zO1nGFkF4kV0XynnVc9l3bVHQc4nC+myfKrjHUqOg5/xOlrFFEF5k14VyXvVc9l1bFPRcorA+26cK7rHUKOg5v5NlbBGEF9l1oZxXPZd91xYFPZcorM/2qYJ7LDUKes7vZBlbBOFFdl0o51XPZd+1RUHPJQrrs32q4B5LjYKe8ztZxhZBeJFdF8p51XPZd21R0HOJwvpsnyq4x1KjoOf8Tlq34AW4RGG960MvmyrY1/Wn53wF66ujoOdSBfu6/vSyUdDr8lWWTOt2vBiXKKx3fehlUwX7uv70nK9gfXUU9FyqYF/Xn142CnpdvsqSad2OF+MShfWuD71sqmBf15+e8xWsr46CnksV7Ov608tGQa/LV1kyrdvxYlyisN71oZdNFezr+tNzvoL11VHQc6mCfV1/etko6HX5KkumdTtejEsU1rs+9LKpgn1df3rOV7C+Ogp6LlWwr+tPLxsFvS5fZcm0bseLcYnCeteHXjZVsK/rT8/5CtZXR0HPpQr2df3pZaOg1+WrLJlFbMcL64qCXtZXUdBzvoL12T4K9nX96WWjoJf1o4nCeteHXjZRWJ/tMweL2IIX0xUFvayvoqDnfAXrs30U7Ov608tGQS/rRxOF9a4PvWyisD7bZw4WsQUvpisKellfRUHP+QrWZ/so2Nf1p5eNgl7WjyYK610fetlEYX22zxwsYgteTFcU9LK+ioKe8xWsz/ZRsK/rTy8bBb2sH00U1rs+9LKJwvpsnzlYxBa8mK4o6GV9FQU95ytYn+2jYF/Xn142CnpZP5oorHd96GUThfXZPnOwiC14MV1R0Mv6Kgp6zlewPttHwb6uP71sFPSyfjRRWO/60MsmCuuzfeZgGVsIeGHu4uhl/aoo6LnMDee5ufSqE4X12T5ROM/NpecyOMyib4UfoPsg6WX9qijoucwN57m59KoThfXZPlE4z82l5zI4zKJvhR+g+yDpZf2qKOi5zA3nubn0qhOF9dk+UTjPzaXnMjjMom+FH6D7IOll/aoo6LnMDee5ufSqE4X12T5ROM/NpecyOMyib4UfoPsg6WX9qijoucwN57m59KoThfXZPlE4z82l5zI4zKJvhR+g+yDpZf2qKOi5zA3nubn0qhOF9dk+UTjPzaXnMjhM663wA8lGQc/5Udg325/1rg895ytY7/rQc1HQc34U9nVR0Mv6KlFY76Kg5/wl07o1LywbBT3nR2HfbH/Wuz70nK9gvetDz0VBz/lR2NdFQS/rq0RhvYuCnvOXTOvWvLBsFPScH4V9s/1Z7/rQc76C9a4PPRcFPedHYV8XBb2srxKF9S4Kes5fMq1b88KyUdBzfhT2zfZnvetDz/kK1rs+9FwU9JwfhX1dFPSyvkoU1rso6Dl/ybRuzQvLRkHP+VHYN9uf9a4PPecrWO/60HNR0HN+FPZ1UdDL+ipRWO+ioOf8JdO6NS8sGwU950dh32x/1rs+9JyvYL3rQ89FQc/5UdjXRUEv66tEYb2Lgp7zl8yit+YFu4umV+0rWL+2PvRcFPScr2B9dRT0nF8F57m59JyvYL3rQ8/5c9A7LQgvxl0QvWpfwfq19aHnoqDnfAXrq6Og5/wqOM/Nped8BetdH3rOn4PeaUF4Me6C6FX7CtavrQ89FwU95ytYXx0FPedXwXluLj3nK1jv+tBz/hz0TgvCi3EXRK/aV7C+s8+ll146XXTRRSMml1xyib1P3rvzq+A8N5ee8xWsd33oOX8OeqcF4cW4C6JX7StY39nn4osv5pcGt8Lmntx98t6dXwXnubn0nK9gvetDz/lz0DstCC/GXRC9al/B+s4+48HajfFgHYb1rg89589B6zQe1B2YnksV7Ov603O+gvWuz+bHxoO1G9sPVjQKel3+3FHQc/4ctE7jQd2B6blUwb6uPz3nK1jv+mx+bDxYuzEerN2joOf8OWidxoO6A9NzqYJ9XX96zlew3vXZ/Nh4sHZjPFi7R0HP+XPQOo0HdQem51IF+7r+9JyvYL3rs/mxqgfr5o++dzp53T/yy0eG8WDtHgU9589B6zQe1B2YnksV7Ov603O+gvWuz+bHqh6sm/78p6ZjP37P6caL/8c0nTzJH14948HaPQp6zp+D1mk8qDswPZcq2Nf1p+d8Betdn82PlT1Y//cnp+Mv+fLpmsd8xXTd+Y+Zbr7qCiqrZjxYu0dBz/lz0DstCC9mqVHQq/Y3VD5YJy744unaH/nKg0frmh+8w3TiN39umk4cp7pKtu+J9+vumZ7zo7Bvtj/rXdbIorfmBS81CnrV/obSB+tNXzQdf+W//uyD9U859mPfPN106Tupr47xYB3OGln01rzgpUZBr9rfUP1gbXLsabc8WAf5ga+cjr/sidPJT32cZathPFiHs0YWvTUveKlR0Kv2N8zxYF3/mi+brvkP//RHw61c+7g7TTe87dXTdPNNLF8848E6nDWy6K15wUuNgl61v0E9WDfedHK6OfCXfdsP1ibXveCOhx6s039MfOYDp5s+9B62WDTjwTqcNbLorXnBS42CXrW/QT1YV37kH6YnveKy6S8+cR1/6Fbhg3XTe58x3fh/fm+69sn3PPRgffaPiV81Xf/qp08nr/k0Wy2S8WAdzhpZ9Na8YHfR9JxfBed1Rj5YV/7D9KDH/N507/PeN/38hR+bjp24mcoZ3NqDteHk8Wun63/9BdM1//H2hx+tzR8Tf/iu0w1//ObPiGfvvys333zzdNNNN0833njTdOKGG6YbbriRSopzebAUrHd96GWjoOeioOfSSe+0ILwYd0H0nF8F53XmbA/WQx7y5unbnvau6Zte8N7pIS+7bPpfH/x7aqc5/GA9/fSPHfvdP5v++o4/NF15u+89nC992HT1018+nbxut9/J3RpXXfXJ6cee+oLpa7/uO6bbfeldpy++3V2m237xnacvvO3XTb/2urdQTzEerMNR0HPppHdaEF6MuyB6zq+C8zrjHqwHP/Kt0z1+8j0Hj9YmT3njh6ePffoE9Vt9sG78yCenqx5x/vSX/+zht5q/vttTpuN/+kG2CnHppR+YvuKr7j3988+746Hc9W7fffA7rQrGg3U4CnounfROC8KLcRdEz/lVcF5n3IO1yXf86DtPP1ibfPML/3x67bs+Md1w0y3fleeD9Y8vfuD04S989KFHapMrbvv909+/5K3TyRt2e0yOH79+ev8HPjRddtnl07Fjt/xO7Lrrjk9fc6dvP/1APfR7Hjv93Et+ZfqFl792+sVXvG56z3suO+2ePHnS5myMB+twFPRcOumdFoQX4y6InvOr4LzO7PJgPfjhvzXd6/nvPuPR2uSRv/SB6d1XXnPg88G6+gl3OfRQbXLVI39muvGjf4dpt85HP/bx6Yce+9SDP96depS+8IvuPP23pzz/4Md/6ZVvOP315z7vJdO11x47eNSuuOKvD76Xtc19v/kRB39EVPlXX/INh2q2GQ/W4SjouXTSOy0IL8ZdED3nV8F5ndnlwdrkAU+48NCDtck9PpPn/s6V099e/LyzPlgfueMPT8fe9m6OkWwena+6/X0O/TFvk5867xcOnAc9+Ac/+4h95sH5kSc/54yHbfM7r99/2ztO97vHvb7nUJ/tfMFt73TwzXrFeLAOR0HPpZPeaQJegIuCXtavShTW75JdH6xH/fu3Tq9658en+/z0+w49Wpvc/6f/ZLrg1Y+djr/pdp99sH746w8eqg9//qOmq5/969PJ667niLPyvQ9/3OnH5PH/5enThRf+yfSbv/m26QlPfObpPxbe/g73O+PR+bx/+TXT53/B15zxCL3vff/vwN1+sB7/hGdMT3/GC6cff/r5p/1dHiz3ufBuq/0qOC8bBT3nd7KILXgxLgp6Wb8qUVi/S3Z9sB796Ld+9utXXz896Q0fOvRgncp/evEF02VvuNf0qc88WH/znc+ZbvjgR9HZc801155+SL7zux7DHz7Nv/m39zj9CD3i+54wXf2pv5+uvvrTB9/LOvX1Jz7pWQfu9oN1+eVXHHxt832rze/OxoOVi4Ke8ztZxBa8GBcFvaxflSis3yXRB2vDiWM3TOc9813Ttz77kkMP1ib3esG7pxe98rema6/f7ZvqZPO9Kz44t8Zd7vrA097b33HR6a//3u+/4/TXv+MBn33wxoN1C5yXjYKe8ztZxBa8GBcFvaxflSis3yWRB2vzF2mXv+PK6RUPetP0wru/ZjrvXq+ffuBxfzjdc+ufPWznQT9/2XTh+z89nf3v3w6z+ceeX/bldz94SO5wx285+F3TKba/Mf64x//46UfoV179xtNf3/wt4amvP/JRTzz42niwboHzslHQc34ni9iCF+OioJf1qxKF9btk1wfr+7/vt6a3/Nc/PHiomJ94wAXTg577p4cerFP50d/4y+mjn4p9D+uZz3rR6Qdm8833zfedHv2YJ09f/bX3P/2AXXzxe6Z/8flffeB8yZfdbXr2c148PevZP3vwN36nai940+8euOPBugXOy0ZBz/mdLGILXoyLgl7Wr0oU1u+SXR+sp3z7bxx6qDZ56be8YXr3G98/vf7yl03f/RtPm+51/q0/XPc7/8+nV//xVdOJG3f7/daJEycOHqhTj8x2nvq080575/30y08/Wszmbw5P/fuq8WDdAudlo6Dn/E5at+AFZKOg56KgV50orN/OLg/Wox78pun8bzr8WL31J945XfO3xw78N3z4pdPD3nGn6Xv+4H7Tt73yVYcerFP5vle8f/qzK3b7H6vYPCib7009+Uefe/BPGDZ/c/i857/09INzij/64/89PfY/P226930fPt3nfg8/+L8vfPu7znB+9TUXTOe/8BUHOfU7tE3/F/3sKw++tvnPs/3jUXVP5wI/C/f50sv60SjoZdNJ6zQeNBsFPRcFvepEYf121C/Ej3zklgfrGd/662c8VL/8sLdMf3Xxx87wTz1Yp/Jjb3/h9IhffP+hB+tUnvXbfzX93TU3nNFjyah7Ohf4WbjPl17Wj0ZBL5tOWqfxoNko6Lko6FUnCuu3o34hnnqwfuC7Lzj9UL343q+b3vWq9043njj8t398sF51+QsO/vj3y3/08em+54t/u/WiS6c3XfLJ6eaz/M5mKah7Ohf4WbjPl17Wj0ZBL5tOWqfxoNko6Lko6FUnCuu3o34hbh6shz70zdNz7vv6g8fqgif9wfSpz3xNcWsP1imuvPr49MCXvWW6+3mvOSN3/alXH+QHX/vm6diJw/8P1UtC3dO5wM/Cfb70sn40CnrZdNI6jQfNRkHPRUGvOlFYvx31C3HzYD3ugRdMv/jAN04f+J9XTO7fJqgH6y8+ecX0yNc+fvp3z73breYRv/rY6QOf+BC6LQ91T+cCPwv3+dLL+tEo6GXTSes0HjQbBT0XBb3qRGH9dtQvxL/56D9Ov//SS6brr93t+0x8sF562U9M5//hy6bb/+Q9Dz1Sm9zlZ+4/XfDet37mj4P6b+aWhLqnc4Gfhft86WX9aBT0sumkd5qAF+AShfXZRGF9Nmej6hciH6y7vvwbDz1Sm3zl875xeurvPH/61DH9Xwa4RLb/WYOKgp6Lgp7zo7Bvdf8lsIjT8IJdorA+myisz+ZszPFgfddvf8Ohh2qTB7ziUdOffeR9LF0F48E6GiziNLxglyiszyYK67M5G9UP1sPf8XXTnX7uzN9dffV5951eddHrpxtvrvnvV98H48E6GiziNLxglyiszyYK67M5G9UP1v0vOPN3VY9/43+f/uYfrqK+OsaDdTRYxGl4wS5RWJ9NFNZnczYqH6zvffudpzucf/eDh+o+L33I9PbL/4TaahkP1tFgEafhBbtEYX02UVifzdmofLDu+7q7Hfyt4AsvfPl0/IbjVFbNeLCOBq2n4UW6KOitzY/CvtuperB+7YMvmx7zhicc/Luro8j2PfEOs58X67uioOd8BetdOmmdxoO6KOitzY/CvtuperA+ce0nppPuX5eumPFg7Q7rXTppncaDuijorc2Pwr7bqXqwjjrjwdod1rt00jqNB3VR0FubH4V9tzMerN0YD9busN6lk9ZpPKiLgt7a/Cjsu53xYO3GeLB2h/UunbRO40FdFPTW5kdh3+2MB2s3xoO1O6x36aR1Gg/qoqDXlSisd1HQ2854sHbjXB4setV+FZyXzZJp3Y4X46Kg15UorHdR0NvOpZdeOl100UUjJpdccom9TwW9ar8KzstmybRux4txUdDrShTWuyjouURhfXUfFQW9o+5XwXnZLJnW7XgxLgp6XYnCehcFPZcorK/uo6Kgd9T9KjgvmyXTuh0vxkVBrytRWO+ioOcShfXVfVQU9I66XwXnZbNkWrfjxbgo6HUlCutdFPRcorC+uo+Kgt5R96vgvGyWzKK340Xu+0K5R1fmhvNcqmDfbH/Wd/Wh51IF+2ajoOf8TpaxhYAXtu+L4x5dmRvOc6mCfbP9Wd/Vh55LFeybjYKe8ztZxhYCXti+L457dGVuOM+lCvbN9md9Vx96LlWwbzYKes7vZBlbCHhh+7447tGVueE8lyrYN9uf9V196LlUwb7ZKOg5v5NlbCHghe374rhHV+aG81yqYN9sf9Z39aHnUgX7ZqOg5/xOlrGFgBe274vjHl2ZG85zqYJ9s/1Z39WHnksV7JuNgp7zO2ndghfgoqDnfAXrXR96zlewvrrP0qKgt+9EYb3rQ8/5Cta7HCVaT8OLdFHQc76C9a4PPecrWF/dZ2lR0Nt3orDe9aHnfAXrXY4SrafhRboo6DlfwXrXh57zFayv7rO0KOjtO1FY7/rQc76C9S5HidbT8CJdFPScr2C960PP+QrWV/dZWhT09p0orHd96DlfwXqXo0TraXiRLgp6zlew3vWh53wF66v7LC0KevtOFNa7PvScr2C9y1Gi9TS8SBcFPecrWO/60HO+gvXVfZYWBb19JwrrXR96zlew3uUo0XoaXmRXorDe9aHX5avsC+7hEoX1LlFYX90nGgW9bBT0XDppncaDdiUK610fel2+yr7gHi5RWO8ShfXVfaJR0MtGQc+lk9ZpPGhXorDe9aHX5avsC+7hEoX1LlFYX90nGgW9bBT0XDppncaDdiUK610fel2+yr7gHi5RWO8ShfXVfaJR0MtGQc+lk9ZpPGhXorDe9aHX5avsC+7hEoX1LlFYX90nGgW9bBT0XDppncaDdiUK610fel2+yr7gHi5RWO8ShfXVfaJR0MtGQc+lk9ZpPKg7MD0XBb3qKOg5Pwr7ukRhfVcfei4KetW+gvXZVMG+Lgp6zp+D1mk8qDswPRcFveoo6Dk/Cvu6RGF9Vx96Lgp61b6C9dlUwb4uCnrOn4PWaTyoOzA9FwW96ijoOT8K+7pEYX1XH3ouCnrVvoL12VTBvi4Kes6fg9ZpPKg7MD0XBb3qKOg5Pwr7ukRhfVcfei4KetW+gvXZVMG+Lgp6zp+D1mk8qDswPRcFveoo6Dk/Cvu6RGF9Vx96Lgp61b6C9dlUwb4uCnrOn4PWaTyoOzA9FwW96ijoOT8K+7pEYX1XH3ouCnrVvoL12VTBvi4Kes6fg9ZpPGhXorC+qw+96swN57m59FyisN4lCutdorDe9aHnfAXrs33moHULXkBXorC+qw+96swN57m59FyisN4lCutdorDe9aHnfAXrs33moHULXkBXorC+qw+96swN57m59FyisN4lCutdorDe9aHnfAXrs33moHULXkBXorC+qw+96swN57m59FyisN4lCutdorDe9aHnfAXrs33moHULXkBXorC+qw+96swN57m59FyisN4lCutdorDe9aHnfAXrs33moHULXkBXorC+qw+96swN57m59FyisN4lCutdorDe9aHnfAXrs33moHULXkD2IljvoqDnEoX1LvuCe7h96Dlfwfqjkiis78oaad2aF5a9ONa7KOi5RGG9y77gHm4fes5XsP6oJArru7JGWrfmhWUvjvUuCnouUVjvsi+4h9uHnvMVrD8qicL6rqyR1q15YdmLY72Lgp5LFNa77Avu4fah53wF649KorC+K2ukdWteWPbiWO+ioOcShfUu+4J7uH3oOV/B+qOSKKzvyhpp3ZoXlr041rso6LlEYb3LvuAebh96zlew/qgkCuu7skZat+aFZS+O9S5VsG9XFPScPzfcw0VBz/lR2Lerf1WisH7ffc6F1mk8aPbArHepgn27oqDn/LnhHi4Kes6Pwr5d/asShfX77nMutE7jQbMHZr1LFezbFQU9588N93BR0HN+FPbt6l+VKKzfd59zoXUaD5o9MOtdqmDfrijoOX9uuIeLgp7zo7BvV/+qRGH9vvucC63TeNDsgVnvUgX7dkVBz/lzwz1cFPScH4V9u/pXJQrr993nXGidxoNmD8x6lyrYtysKes6fG+7hoqDn/Cjs29W/KlFYv+8+50LrNB7UHZiei4JeNlFYn+1TBfdY6j4qVbCvSxXsu9QsmdbteDHugui5KOhlE4X12T5VcI+l7qNSBfu6VMG+S82Sad2OF+MuiJ6Lgl42UVif7VMF91jqPipVsK9LFey71CyZ1u14Me6C6Lko6GUThfXZPlVwj6Xuo1IF+7pUwb5LzZJp3Y4X4y6InouCXjZRWJ/tUwX3WOo+KlWwr0sV7LvULJnW7Xgx7oLouSjoZROF9dk+VXCPpe6jUgX7ulTBvkvNkln2dguDH6yLgp7zFax3fei5KOhV+1VwXnYu66tTBfuurf8u9E5bOfygXBT0nK9gvetDz0VBr9qvgvOyc1lfnSrYd239d6F32srhB+WioOd8BetdH3ouCnrVfhWcl53L+upUwb5r678LvdNWDj8oFwU95ytY7/rQc1HQq/ar4LzsXNZXpwr2XVv/XeidtnL4Qbko6DlfwXrXh56Lgl61XwXnZeeyvjpVsO/a+u9C77SVww/KRUHP+QrWuz70XBT0qv0qOC87l/XVqYJ919Z/F1qn8aBLTRTWZ6Og5xKF9a4PPRcFPedHYV8XBb2sr6Kgt29/CbRux4tZaqKwPhsFPZcorHd96Lko6Dk/Cvu6KOhlfRUFvX37S6B1O17MUhOF9dko6LlEYb3rQ89FQc/5UdjXRUEv66so6O3bXwKt2/FilpoorM9GQc8lCutdH3ouCnrOj8K+Lgp6WV9FQW/f/hJo3Y4Xs9REYX02CnouUVjv+tBzUdBzfhT2dVHQy/oqCnr79pdA63a8mKUmCuuzUdBzicJ614eei4Ke86Owr4uCXtZXUdDbt78EWrfjxez7grhHdh/Wu1TBvtko6LlUwb7ZVMG+Lgp6zo/Cvi4Kei6dtE7jQfdx4G24R3Yf1rtUwb7ZKOi5VMG+2VTBvi4Kes6Pwr4uCnounbRO40H3ceBtuEd2H9a7VMG+2SjouVTBvtlUwb4uCnrOj8K+Lgp6Lp20TuNB93HgbbhHdh/Wu1TBvtko6LlUwb7ZVMG+Lgp6zo/Cvi4Kei6dtE7jQfdx4G24R3Yf1rtUwb7ZKOi5VMG+2VTBvi4Kes6Pwr4uCnounbRO40H3ceBtuEd2H9a7VMG+2SjouVTBvtlUwb4uCnrOj8K+Lgp6Lp20TuNB3YHpZaOgV+3PDfdw+9BzfhWc5+bS6/JVqmDfrkRhfbbPHLRuwQtwF0EvGwW9an9uuIfbh57zq+A8N5del69SBft2JQrrs33moHULXoC7CHrZKOhV+3PDPdw+9JxfBee5ufS6fJUq2LcrUVif7TMHrVvwAtxF0MtGQa/anxvu4fah5/wqOM/Npdflq1TBvl2Jwvpsnzlo3YIX4C6CXjYKetX+3HAPtw8951fBeW4uvS5fpQr27UoU1mf7zEHrFrwAdxH0slHQq/bnhnu4feg5vwrOc3PpdfkqVbBvV6KwPttnDlq34AW4i6CXjYJeta9gvetDz0VBrzpRWJ+Ngp7zo7Cv60/PRUHP+VVwXtfcbVqn8aDuwPSyUdCr9hWsd33ouSjoVScK67NR0HN+FPZ1/em5KOg5vwrO65q7Tes0HtQdmF42CnrVvoL1rg89FwW96kRhfTYKes6Pwr6uPz0XBT3nV8F5XXO3aZ3Gg7oD08tGQa/aV7De9aHnoqBXnSisz0ZBz/lR2Nf1p+eioOf8Kjiva+42rdN4UHdgetko6FX7Cta7PvRcFPSqE4X12SjoOT8K+7r+9FwU9JxfBed1zd2mdRoP6g5MLxsFvWpfwXrXh56Lgl51orA+GwU950dhX9efnouCnvOr4Lyuudu0TuNB3YHpZaOg1+WrKOhlo6Dn/Co4z82ll/VVFPSyUdDrioKe8ztp3YIX4C6CXjYKel2+ioJeNgp6zq+C89xcellfRUEvGwW9rijoOb+T1i14Ae4i6GWjoNflqyjoZaOg5/wqOM/NpZf1VRT0slHQ64qCnvM7ad2CF+Augl42CnpdvoqCXjYKes6vgvPcXHpZX0VBLxsFva4o6Dm/k9YteAHuIuhlo6DX5aso6GWjoOf8KjjPzaWX9VUU9LJR0OuKgp7zO2ndghfgLoJeNgp6Xb6Kgl42CnrOr4Lz3Fx6WV9FQS8bBb2uKOg5v5PWLXgB+74I7pHdh/UuVbCvSxTWuz70qrM0uJ/bk57zo7Bvtj/rs33moHULXsC+L4J7ZPdhvUsV7OsShfWuD73qLA3u5/ak5/wo7Jvtz/psnzlo3YIXsO+L4B7ZfVjvUgX7ukRhvetDrzpLg/u5Pek5Pwr7ZvuzPttnDlq34AXs+yK4R3Yf1rtUwb4uUVjv+tCrztLgfm5Pes6Pwr7Z/qzP9pmD1i14Afu+CO6R3Yf1LlWwr0sU1rs+9KqzNLif25Oe86Owb7Y/67N95qB1C17Avi+Ce2T3Yb1LFezrEoX1rg+96iwN7uf2pOf8KOyb7c/6bJ85aN2CF7DUfK7B82czN5zn5tJzUdBzmRvOq86Sad2OF7PUfK7B82czN5zn5tJzUdBzmRvOq86Sad2OF7PUfK7B82czN5zn5tJzUdBzmRvOq86Sad2OF7PUfK7B82czN5zn5tJzUdBzmRvOq86Sad2OF7PUfK7B82czN5zn5tJzUdBzmRvOq86Sad2OF7PUfK7B82czN5zn5tJzUdBzmRvOq86SWfZ2g8FgsMV4sAaDwWoYD9ZgMFgN48EaDAarYTxYg8FgNYwHazAYrIbxYA0Gg9UwHqzBYLAaxoM1GAxWw3iwBoPBahgP1mAwWA3jwRoMBqthPFiDwWA1jAdrMBishvFgDQaD1TAerMFgsBrGgzUYDFbDeLAGg8FqGA/WYDBYDePBGgwGq2E8WIPBYDWMB2swGKyG8WANBoPVMB6swWCwGsaDNRgMVsN4sAaDwWoYD9ZgMFgN/x92YT8CfWGwyQAAAABJRU5ErkJggg==</Image>
            </Envlp>
        </SplmtryData>
    </CcyCtrlStsAdvc>
</Document>
Пример ответа с ошибкой при создании платежной ссылки 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CcyCtrlStsAdvc>
        <GrpHdr>
            <MsgId>3c402c01c9b849a0ac5c0434299aecc1</MsgId>
            <CreDtTm>2019-01-30T16:13:24.665+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <RcvgPty/>
            <RegnAgt>
                <FinInstnId/>
            </RegnAgt>
        </GrpHdr>
        <GrpSts>
            <OrgnlRefs>
                <OrgnlMsgId>auth.026.001.01</OrgnlMsgId>
                <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
            </OrgnlRefs>
            <RptgPty>
                <PtyId></PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId></FinInstnId>
            </RegnAgt>
            <Sts>RJCT</Sts>
            <StsRsn>
                <Rsn>
                    <Prtry>ENTITY_NOT_FOUND_ERROR</Prtry>
                </Rsn>
                <AddtlInf>error_description</AddtlInf>
            </StsRsn>
        </GrpSts>
    </CcyCtrlStsAdvc>
</Document>

Таблица кодов ответа

HTTP код Тип Body Описание

200

OK

Платежная ссылка была успешно создана

-

400

Err

XML does not match schema

Документ не соответствует схеме

400

Err

The specified merchant is not registered with the client. Указанное ТСП не зарегистрировано у клиента.

Клиент не зарегистрирован в системе СБП (НСПК)

400

Err

invalid data type for attributes: merchantId. Некорректный тип входных параметров запроса.

Переданы невалидные данные

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

Статусы создания платежной ссылки

Передается в Document.GrpSts.Sts схемы auth.027.001.01

№ ISO статус всего запроса Описание Комментарий

1

ACPT

Запрос обработан

Платежная ссылка успешно создана

2

RJCT

Отклонено

Запрос не прошел проверку на соответствие схеме/в процессе обработки произошла ошибка/невалидные реквизиты компании

Получение платежной информации по ссылке

URI

GET: /API/v1/ISO20022/Payments/B2B/LinkPaymentInfo/{qrcId} ,
где qrcId - идентификатор платежной ссылки

Заголовки

account-number - Номер счета компании

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

ИНН получателя

InitgPty.Id.OrgId.Othr[0].Id

-

4

R

Признак отправки ИНН

InitgPty.Id.OrgId.Othr[0].SchmeNm.Cd

Константа 'TXID'

5

R

Номер мерчанта

InitgPty.Id.OrgId.Othr[1].Id

-

6

R

Признак отправки мерчанта

InitgPty.Id.OrgId.Othr[1].SchmeNm.Cd

Константа 'MRCH'

Document.CstmrPmtStsRpt.OrgnlGrpInfAndSts

7

R

Идентификатор сообщения

OrgnlMsgId

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

8

R

Идентификатор наименования исходного сообщения

OrgnlMsgNmId

Константа 'pain.001.001.06'

9

R

Дата запроса

OrgnlCreDtTm

-

10

R

Статус обработки запроса

GrpSts

Возможные значения:
RJCT - Запрос невалиден или при его обработке произошла ошибка;
ACSC - Запрос успешно обработан.

11

R

Торговое наименование ТСП

StsRsnInf.Orgtr.Nm

-

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts

12

R

Идентификатор платежной ссылки

OrgnlPmtInfId

-

13

R

Тип ссылки СБП

StsRsnInf.Orgtr.Nm

Возможные значение для типа ссылки:
- REUSABLE - многоразовая
- ONETIME - одноразовая

14

R

Вид деятельности ТСП (mcc код)

StsRsnInf.Orgtr.PstlAdr.PstCd.Nm

-

15

R

Фактический адрес ТСП

StsRsnInf.Orgtr.PstlAdr.AdrLine

-

16

R

Сокращенное наименование Получателя

StsRsnInf.Orgtr.CtctDtls.Nm

-

17

R

Регистрационный номер ЮЛ или ИП (Получателя)

StsRsnInf.Orgtr.CtctDtls.Othr

-

18

R

Ссылка для перехода после выполнения платежа "redirect_url"

StsRsnInf.Orgtr.CtctDtls.EmailAdr

-

19

O

Идентификатор Агента ТСП, который зарегистрировал платежную
ссылку СБП (Банк Получателя)

StsRsnInf.Rsn.Prtry

-

20

R

Назначение платежа

StsRsnInf.AddtlInf[1…​n]

-

21

R

Уникальный идентификатор платежа, назначаемый Получателем

TxInfAndSts.StsId

-

22

O

Индикатор подозрительной операции Агента ТСП (опционально)

TxInfAndSts.StsRsnInf.Rsn.Prtry

-

23

R

Сумма в копейках

TxInfAndSts.ChrgsInf.Amt

-

24

R

Валюта платежа

TxInfAndSts.ChrgsInf.Amt@Ccy

Константа 'RUB'

25

R

Пустой обязательный параметр

TxInfAndSts.ChrgsInf.Agt.FinInstnId

-

26

R

Сумма НДС в копейках

TxInfAndSts.OrgnlTxRef.Amt.InstdAmt

-

27

R

Валюта комиссии

TxInfAndSts.OrgnlTxRef.Amt.InstdAmt@Ccy

Константа 'RUB'
Пример ответа с платежной информацией по ссылке 
<?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>

                        <Othr>
                            <!--ИНН организации (Идентификация отправителя запроса) -->
                            <Id>911006876365</Id>
                            <SchmeNm>
                                <!--Признак использования ИНН -->
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                        <Othr>
                            <!-- Идентификатор ТСП Клиента -->
                            <Id>MA0000118726</Id>
                            <SchmeNm>
                                <!--Признак merchant_id-->
                                <Cd>MRCH</Cd>
                            </SchmeNm>
                        </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>ACPT</GrpSts>

            <StsRsnInf>
                <Orgtr>
                    <!--  Торговое наименование ТСП "brandName" -->
                    <Nm>Ника</Nm>
                </Orgtr>
            </StsRsnInf>

        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>

            <!--Идентификатор платежной ссылки qrcId -->
            <OrgnlPmtInfId>AS1B005EJONVNVMK9ALQJFOVSHR1GI8T</OrgnlPmtInfId>

            <StsRsnInf>
                <Orgtr>
                    <!-- Тип ссылки СБП: одноразовая или многоразовая qrcType-->
                    <Nm>REUSABLE</Nm>


                    <PstlAdr>

                        <!-- Вид деятельности ТСП mcc -->
                        <PstCd>6513</PstCd>

                        <!-- Фактический адрес ТСП  -->
                        <AdrLine>Ленина                             , 1</AdrLine>
                        <AdrLine>Ленина                             , 1</AdrLine>
                    </PstlAdr>


                    <CtctDtls>
                        <!-- Сокращенное наименование Получателя legalName -->
                        <Nm>НИКА</Nm>

                        <!-- Регистрационный номер ЮЛ или ИП (Получателя) legalId -->
                        <Othr>LA0000046897</Othr>

                        <!-- Ссылка для перехода после выполнения платежа "redirect_url" -->
                        <EmailAdr>https://www.google.com/search?q=Max2048Text+xmlsearch?q=Max2048Text+xmlseasearch?q=Max2048Text+xmlsearch?q=Max2048Text+xmlsearch?q=Max2048Text+xmlsearch?q=Max2048Text+xmlrch?q=Max2048Text+xmlsearch?q=Max2048Text+xml</EmailAdr>
                    </CtctDtls>
                </Orgtr>

                <!-- Идентификатор Агента ТСП, который зарегистрировал платежную ссылку СБП (Банк Получателя) agentId -->
                <Rsn>
                    <Prtry>A02000000089</Prtry>
                </Rsn>

                <!-- Назначение платежа paymentPurpose -->
                <AddtlInf>Назначение платежа </AddtlInf>
                <AddtlInf>Назначение платежа </AddtlInf>
            </StsRsnInf>

            <TxInfAndSts>
                <!-- Уникальный идентификатор платежа, назначаемый Получателем uip -->
                <StsId>AS1B005EJONVNVMK9ALQJFOVSHR1GI8TAA</StsId>
                <StsRsnInf>
                    <Rsn>
                        <!-- Индикатор подозрительной операции Агента ТСП (опционально) fraudScore -->
                        <Prtry>DDDDDDDDDDDDDDDD</Prtry>
                    </Rsn>
                </StsRsnInf>
                <ChrgsInf>
                    <!-- Сумма в копейках amount -->
                    <Amt Ccy="RUB">1000</Amt>
                    <Agt>
                        <FinInstnId/>
                    </Agt>
                </ChrgsInf>

                <OrgnlTxRef>
                    <!-- Сумма НДС в копейках taxAmount -->
                    <Amt>
                        <InstdAmt Ccy="RUB">10000</InstdAmt>
                    </Amt>
                </OrgnlTxRef>
            </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>00ea170805ba4b8aa40bce5335ad5e5d</MsgId>
            <CreDtTm>2024-07-01T19:00:58.110+03:00</CreDtTm>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>pain.001.001.06</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
            <GrpSts>RJCT</GrpSts>
            <StsRsnInf>
                <Rsn>
                    <Prtry>ERROR</Prtry>
                </Rsn>
                <AddtlInf>Payment data for the specified qrcId not found. Не найдены платежные данные по указанной ссылке.</AddtlInf>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
    </CstmrPmtStsRpt>
</Document>

Платеж СБП для B2B

URI

POST: /API/v1/ISO20022/Payments/B2B/Payment

XML схема запроса

pain.001.001.06

Обратите внимние

Клиент предварительно должен быть зарегистрирован в СБП НСПК, где ему будет присвоен Идентификатор ТСП "merchantId".

В зависимости от типа ссылки: одноразовая (ONETIME) или многоразовая (REUSABLE) зависит применение проверок: платежные данные одноразовой ссылки должны совпадать с платежом (сумма, комиссия, назначение).

Описание схемы

№ R/
O		 Описание Путь Комментарий/
Пример

Общий путь Document.CstmrCdtTrfInitn.GrpHdr

1

R

Уникальный id сообщения

MsgId

Указывается идентификатор сообщения присвоенный во внешней системе.

2

R

Дата и Время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

R

Количество транзакций в пакете

NbOfTxs

Константа '1'

4

R

ИНН клиента

InitgPty.Id.OrgId.Othr.Id

-

5

R

Признак использования ИНН

InitgPty.Id.OrgId.Othr.SchmeNm.Cd

Константа 'TXID'

Общий путь Document.CstmrCdtTrfInitn.PmtInf

6

R

Идентификатор платежной ссылки

PmtInfId

-

7

R

Метод оплаты

PmtMtd

Значение "TRF" по умолчанию

8

R

Дата документа

ReqdExctnDt

-

9

R

Пустой обязательный параметр

Dbtr

-

10

R

Счет плательщика

DbtrAcct.Id.Othr[0].Id

-

11

R

Константа 'ACC'

DbtrAcct.Id.Othr[0].SchmeNm.Cd

Признак использования номера счета

12

R

Валюта платежа

DbtrAcct.Ccy

Константа 'RUB'

13

R

Пустой обязательный параметр

DbtrAgt.FinInstnId

-

14

R

Идентификатор платежной ссылки

CdtTrfTxInf.PmtId.EndToEndId

-

15

R

Сумма платежа в копейках

CdtTrfTxInf.Amt.InstdAmt

-

16

R

Валюта платежа

CdtTrfTxInf.Amt.InstdAmt@Ccy

Константа 'RUB', так как СБП поддерживает только рубли.

17

R

Комиссия в копейках

CdtTrfTxInf.Tax.TtlTaxAmt

Если при создании платежной ссылки была указана Комиссия, то ее значение обязано совпадать со значением в платеже, иначе система СБП вернет ошибку. Если в ссылке не было указано Комиссии, то его значение в платеже уже не будет принято.

18

R

Валюта комиссии

CdtTrfTxInf.Tax.TtlTaxAmt@Ccy

Константа 'RUB', так как СБП поддерживает только рубли.

19

R

Назначение платежа

CdtTrfTxInf.RmtInf.Ustrd

Если при создании платежной ссылки было указано значение Назначение платежа, то оно обязано совпадать со значением в платеже, иначе СБП вернет ошибку.

Блок с подписью Document.CstmrCdtTrfInitn

20

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-
Пример запроса на создание платежа B2B 
<?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>
            <!-- Уникальный ID сообщения-->
            <MsgId>7TEST_MSG_2022-08-23-279190544</MsgId>
            <!-- Дата и время создания сообщения -->
            <CreDtTm>2024-05-28T12:44:40.624</CreDtTm>

            <!--Константа 1-->
            <NbOfTxs>1</NbOfTxs>
            <InitgPty>
                <Id>
                    <OrgId>
                            <!-- ИНН компании-->
                            <Othr>
                                <Id>691202047705</Id>
                                <SchmeNm>
                                    <!-- Признак ИНН компании-->
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>

                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <PmtInf>
            <!--Идентификатор платежной ссылки qrcId -->
            <PmtInfId>AS1B0026CNJAQ7QF9BCB78I19430NA2O</PmtInfId>
            <PmtMtd>TRF</PmtMtd>
            <ReqdExctnDt>2024-05-28</ReqdExctnDt>
            <Dbtr> </Dbtr>
            <DbtrAcct>
                <Id>
                    <Othr>
                        <!-- Номер счета "account"-->
                        <Id>40802810400000000000</Id>
                        <SchmeNm>
                            <Cd>ACC</Cd>
                        </SchmeNm>
                    </Othr>
                </Id>
                <Ccy>RUB</Ccy>
            </DbtrAcct>
            <DbtrAgt>
                <FinInstnId/>
            </DbtrAgt>
            <CdtTrfTxInf>
                <PmtId>
                    <!--Идентификатор платежной ссылки qrcId -->
                    <EndToEndId>AS1B0026CNJAQ7QF9BCB78I19430NA2O</EndToEndId>

                </PmtId>
                <!-- Cумма в копейках "amount" -->
                <Amt>
                    <InstdAmt Ccy="RUB">1000</InstdAmt>
                </Amt>

                <!-- Комиссия "taxAmount" для пары takeTax = true -->
                <Tax>
                    <TtlTaxAmt Ccy="RUB">100</TtlTaxAmt>
                </Tax>

                <!--Назначение платежа "paymentPurpose" -->
                <RmtInf>
                    <Ustrd>
                        Несколько объектов Ustrd по 140 символов, будут укрочены в сумме до 180ти символов для НСПК
                    </Ustrd>
                    <Ustrd>
                        Несколько объектов Ustrd по 140 символов, будут укрочены в сумме до 180ти символов для НСПК
                    </Ustrd>
                </RmtInf>
            </CdtTrfTxInf>
        </PmtInf>
        <SplmtryData>
            <Envlp>
                <!--Блок для вставки подписи-->
                <SgntrSt></SgntrSt>
            </Envlp>
        </SplmtryData>
    </CstmrCdtTrfInitn>
</Document>

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

Статус сообщения

GrpSts

Возможные значения:
RJCT - Отклонено;
ACSP - Исполнено.

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts

4

R

Идентификатор исходного сообщения

OrgnlMsgId

Константа 'pain.001.001.06'

5

R

Идентификатор наименования исходного сообщения

OrgnlMsgNmId

Константа 'pain.001.001.06'

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts

6

R

Идентификатор платежной ссылки

OrgnlPmtInfId

-

7

R

Статус СБП платежа

PmtInfSts

Возможные значения:
RJCT - Отклонено;
ACSP - Исполнено.

8

R

Идентификатор платежа в системе СБП

StsRsnInf.AddtlInf

-
Пример ответа на создание B2B платежа 
<?xml version="1.0" encoding="UTF-8"?>
<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>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>pain.001.001.06</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
            <!-- Статус сообщения -->
            <GrpSts>ACSP</GrpSts>
            <StsRsnInf>
                <!-- Если при обработке запроса произошла ошибка, то в тэге приводится описание,
                    иначе тэг AddtlInf - отсутствует -->
                <AddtlInf>Текст ошибки</AddtlInf>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <!--Идентификатор платежной ссылки qrcId -->
            <OrgnlPmtInfId>AS1B005EJONVNVMK9ALQJFOVSHR1GI8T</OrgnlPmtInfId>
            <!-- Статус платежа  -->
            <PmtInfSts>ACSP</PmtInfSts>
          <StsRsnInf>
              <!-- Уникальный идентификатор платежа b2b outcomingPaymentId -->
              <AddtlInf>0d9efccb-8fb5-4b60-bc3a-15ad9517f926</AddtlInf>
          </StsRsnInf>
        </OrgnlPmtInfAndSts>

    </CstmrPmtStsRpt>
</Document>

Таблица кодов ответа

HTTP код Тип Body Описание

200

OK

-

СБП платеж успешно исполнен.

200

Err

-

Превышен лимит по платежам.

200

Err

-

Платежная ссылка не найдена.

400

Err

-

Payment data for the specified qrcId not found. Не найдены платежные данные по указанной ссылке.

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

Статусы создания платежа

Доступны в разделе Статусная модель B2B платежа

Получение статуса исходящего B2B платежа

URI

GET: /API/v1/ISO20022/Payments/B2B/PaymentStatus/{PaymentId},
где PaymentId - идентификатор платежа

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).

Document.CstmrPmtStsRpt.OrgnlGrpInfAndSts

3

R

Идентификатор сообщения

OrgnlMsgId

Константа 'pain.001.001.06'

4

R

Идентификатор наименования исходного сообщения

OrgnlMsgNmId

Константа 'pain.001.001.06'

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts

5

R

Идентификатор платежной ссылки

OrgnlPmtInfId

-

6

R

Статус СБП платежа

PmtInfSts

Возможные значения:
RJCT - Запрос невалиден или при обработке запроса произошла ошибка
ACSP - Платеж исполнен в системе СБП

7

R

Идентификатор платежа

StsRsnInf.AddtlInf

-
Пример ответа со статусом платежа 
<?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>6d9d6a3264d549a29f61cc3b70b4afea</MsgId>
            <CreDtTm>2024-07-01T19:06:28.803+03:00</CreDtTm>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>pain.001.001.06</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>AS1B006J2R71OEDU99RP5EA83VPFF9HR</OrgnlPmtInfId>
            <PmtInfSts>ACSP</PmtInfSts>
            <StsRsnInf>
                <AddtlInf>6614bd68-d91a-471b-b09e-ec5f2aa8e933</AddtlInf>
            </StsRsnInf>
        </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>203b82612e814f6d8d85d897f4fc3c2c</MsgId>
            <CreDtTm>2024-07-01T19:12:01.976+03:00</CreDtTm>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>pain.002.001.06</OrgnlMsgId>
            <OrgnlMsgNmId>pain.002.001.06</OrgnlMsgNmId>
            <GrpSts>RJCT</GrpSts>
            <StsRsnInf>
                <Rsn>
                    <Prtry>ERROR</Prtry>
                </Rsn>
                <AddtlInf>Payment is not found. По указанному идентификатору платеж не найден.</AddtlInf>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
    </CstmrPmtStsRpt>
</Document>

Статусная модель B2B платежа

Передается в Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts.PmtInfSts схемы pain.002.001.06

№ ISO статус всего запроса Описание Комментарий

1

ACSP

B2B платеж успешно исполнен в системе СБП

-

2

RJCT

Отклонено

Запрос не прошел проверку на соответствие схеме/в процессе обработки произошла ошибка/невалидные реквизиты компании

Получение списка входящих B2B платежей

URI

GET: API/v1/ISO20022/Payments/B2B/PaymentList

Заголовки

account-number - Номер счета компании

Параметры GET запроса

Передается в параметрах GET запроса

№ Название поля Где передается Описание Комментарий

1

account-number

header

Номер счета Получателя

-

2

qrcId

query

Идентификатор платежной ссылки

-

3

sort

query

Возможные поля для сортировки:
- qrcId - идентификатор ссылки
- taxAmount - сумма комиссии
- paymentPurpose - назначение платежа
- timestamp - дата и время платежа
- amount - сумма платежа

Не более 3 полей для сортировки.
Начиная с 4го поля, будет игнорироваться.
Пример: 'sort=field1,desc&sort=field2,asc'

4

limit

query

Количество платежей в выборке

-

5

offset

query

Смещение выборки

-

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

Смещение выборки offset

FwdgAgt.FinInstnId.Othr[0].Id

-

4

R

Количество платежей totalCount

FwdgAgt.FinInstnId.Othr[0].SchmeNm.Prtry

-

5

R

Ограничение платежей в выборке limit

FwdgAgt.FinInstnId.Othr[0].Issr

-

Document.CstmrPmtStsRpt.OrgnlGrpInfAndSts

6

R

Идентификатор исходного сообщения

OrgnlMsgId

Константа 'pain.001.001.06'

7

R

Идентификатор наименования исходного сообщения

OrgnlMsgNmId

Константа 'pain.001.001.06'

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts

8

R

Идентификатор платежной ссылки

OrgnlPmtInfId

-

9

R

Наименование плательщика

StsRsnInf.Orgtr.Nm

-

10

R

Счет списания платежа

StsRsnInf.Orgtr.Id.OrgId.Othr[0].Id

-

11

R

Признак передачи номера счета

StsRsnInf.Orgtr.Id.OrgId.Othr[0].SchmeNm.Cd

Константа 'ACC'

12

R

ИНН плательщика

StsRsnInf.Orgtr.Id.OrgId.Othr[1].Id

-

13

R

Признак передачи ИНН

StsRsnInf.Orgtr.Id.OrgId.Othr[1].SchmeNm.Cd

Константа 'TXID'

14

R

БИК плательщика

StsRsnInf.Orgtr.Id.OrgId.Othr[2].Id

-

15

R

Признак передачи БИК

StsRsnInf.Orgtr.Id.OrgId.Othr[2].SchmeNm.Cd

Константа 'BIC'

16

R

Счет зачисления платежа

StsRsnInf.Orgtr.Rsn.Prtry

-

17

R

Назначение платежа

StsRsnInf.AddtlInf[1…​n]

-

18

R

Сумма платежа

TxInfAndSts.ChrgsInf.Amt

-

19

R

Валюта платежа

TxInfAndSts.ChrgsInf.Amt@Ccy

Константа 'RUB'

20

R

Пустой обязательный параметр

TxInfAndSts.ChrgsInf.Agt.FinInstnId

-

21

R

Дата и время выполнения Операции СБП B2B

TxInfAndSts.AccptncDtTm

-

22

R

Сумма НДС в копейках

TxInfAndSts.OrgnlTxRef.Amt.InstdAmt

-

23

R

Валюта комиссии

TxInfAndSts.OrgnlTxRef.Amt.InstdAmt@Ccy

Константа 'RUB'
Пример ответа со списком платежей 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.002.001.06"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CstmrPmtStsRpt>
        <GrpHdr>
            <MsgId>3c402c01c9b849a0ac5c0434299aecc1</MsgId>
            <CreDtTm>2019-01-30T16:13:24.665+03:00</CreDtTm>
            <FwdgAgt>

                <FinInstnId>
                    <Othr>
                        <!-- offset -->
                        <Id>1</Id>
                        <!-- totalCount -->
                        <SchmeNm>
                            <Prtry>10</Prtry>
                        </SchmeNm>
                        <!-- limit-->
                        <Issr>1</Issr>
                    </Othr>
                </FinInstnId>

            </FwdgAgt>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>pain.001.001.06</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <!--Идентификатор платежной ссылки qrcId -->
            <OrgnlPmtInfId>AS1B005EJONVNVMK9ALQJFOVSHR1GI8T</OrgnlPmtInfId>
            <StsRsnInf>
                <Orgtr>
                    <!-- Наименование плательщика payerInfo.name -->
                    <Nm>Ника</Nm>
                    <Id>
                        <OrgId>
                            <Othr>
                                <!-- Счет списания платежа "payerAccount"-->
                                <Id>40802810400000000000</Id>
                                <SchmeNm>
                                    <Cd>ACC</Cd>
                                </SchmeNm>
                            </Othr>
                            <Othr>
                                <!-- ИНН плательщика "inn" -->
                                <Id>9203001165</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                            <Othr>
                                <!-- БИК плательщика "bik" -->
                                <Id>044525593</Id>
                                <SchmeNm>
                                    <Cd>BIC</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Orgtr>
                <Rsn>
                    <!-- Счет зачисления платежа "account"-->
                    <Prtry>40802810400000000000</Prtry>
                </Rsn>
                <!-- Назначение платежа paymentPurpose -->
                <AddtlInf>Назначение платежа </AddtlInf>
                <AddtlInf>Назначение платежа </AddtlInf>
            </StsRsnInf>
            <TxInfAndSts>
                <ChrgsInf>
                    <!-- Сумма в копейках amount -->
                    <Amt Ccy="RUB">100</Amt>
                    <Agt>
                        <FinInstnId/>
                    </Agt>
                </ChrgsInf>
                <!-- Дата и время выполнения Операции СБП B2B  timestamp -->
                <AccptncDtTm>2024-02-09T13:24:25.689994Z</AccptncDtTm>
                <OrgnlTxRef>
                    <!-- Сумма НДС в копейках taxAmount -->
                    <Amt>
                        <InstdAmt Ccy="RUB">10000</InstdAmt>
                    </Amt>
                </OrgnlTxRef>
            </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>601827734d974ef18421856bbcf2ea8f</MsgId>
            <CreDtTm>2024-07-01T19:50:55.187+03:00</CreDtTm>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>pain.001.001.06</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
            <GrpSts>RJCT</GrpSts>
            <StsRsnInf>
                <Rsn>
                    <Prtry>ERROR</Prtry>
                </Rsn>
                <AddtlInf>invalid data type for attributes: amount1,desc. Некорректный тип входных параметров запроса.</AddtlInf>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
    </CstmrPmtStsRpt>
</Document>

30. Платежи СБП для B2C

Термины и сокращения

СБП - Сервис быстрых платежей
ТСП - Торгово-сервисное предприятие
НСПК - Национальная система платёжных карт.

Общая информация

Работа Клиента с СБП для B2C подразумевает вызов следующих доступных методов:

  • Получение списка банков;

  • Исходящий B2C платеж;

  • Получение отчетности по входящим B2C платежам.

Клиент предварительно должен быть зарегистрирован в СБП НСПК, где ему будет присвоен Идентификатор ТСП "merchantId".

Список банков

URI

GET: /API/v1/ISO20022/Payments/B2C/BankList

XML схема ответа

admi.010.001.02

№ R/
O		 Описание Путь Комментарий/
Пример

Document.StatcDataRpt

1

R

Уникальный id сообщения

MsgId

-

2

R

Заголовок списка

RptDtls.Tp

Константа 'Bank List'

3

R

-

RptDtls.ReqRef

Константа 'Client INN'

Описание для ответа со списком банков для Document.StatcDataRpt.RptDtls

4

R

Текстовый заголовок
объекта с данными банка

RptKey.Key

Константа 'Bank Info'

5

R

Идентификатор банка в СБП

RptKey.RptData.Nm

-

6

R

Наименование банка в СБП

RptKey.RptData.Val

-

Описание для ответа с ошибкой для Document.StatcDataRpt.RptDtls

7

R

Результат обработки запроса

RptKey.Key

Константа 'Error'

8

R

HTTP статус ошибки

RptKey.RptData.Nm

-

9

R

Описание ошибки

RptKey.RptData.Val

-
Пример ответа со списком банков 
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:admi.010.001.02" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <StatcDataRpt>
    <MsgId>MSG_STS_TEST_2024_02_13T00_00_00</MsgId>
    <RptDtls>
      <Tp>Bank List</Tp>
      <ReqRef>Client INN</ReqRef>
      <RptKey>
        <Key>Bank Info</Key>
        <RptData>
          <Nm>100000000008</Nm>
          <Val>Альфа-Банк</Val>
        </RptData>
      </RptKey>
      <RptKey>
        <Key>Bank Info</Key>
        <RptData>
          <Nm>100000000007</Nm>
          <Val>Райффайзенбанк</Val>
        </RptData>
      </RptKey>
      <RptKey>
        <Key>Bank Info</Key>
        <RptData>
          <Nm>100000000006</Nm>
          <Val>АК БАРС БАНК</Val>
        </RptData>
      </RptKey>
      <RptKey>
        <Key>Bank Info</Key>
        <RptData>
          <Nm>100000000005</Nm>
          <Val>ВТБ Банк</Val>
        </RptData>
      </RptKey>
      <RptKey>
        <Key>Bank Info</Key>
        <RptData>
          <Nm>100000000004</Nm>
          <Val>Тинькофф Банк</Val>
        </RptData>
      </RptKey>
    </RptDtls>
  </StatcDataRpt>
</Document>
Пример ответа с ошибкой запроса 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:admi.010.001.02">
    <StatcDataRpt>
        <MsgId>8a969779cf8147208768ab06675a81ba</MsgId>
        <RptDtls>
            <Tp>Bank List</Tp>
            <ReqRef>Client INN</ReqRef>
            <RptKey>
                <Key>Error</Key>
                <RptData>
                    <Nm>500</Nm>
                    <Val>Exception BadRequest msg: [400 Bad Request] during [POST] to [http://corp-gateway-test/b2cpay-payments-api/client/banklist/get] [SbpB2cPaymentGateway#getBankList(BankListReqDto)]: [{"Error":{"errorCode":1705,"errorMessage":"Поле 'BankList' является обязательным"}}]</Val>
                </RptData>
            </RptKey>
        </RptDtls>
    </StatcDataRpt>
</Document>

Платеж СБП для B2C

URI

POST: /API/v1/ISO20022/Payments/B2C/Payment

Схема запроса

pain.001.001.06

№ R/
O		 Описание Путь Комментарий/
Пример

Общий путь Document.CstmrCdtTrfInitn.GrpHdr

1

R

Уникальный id сообщения

MsgId

Указывается идентификатор сообщения присвоенный во внешней системе.

2

R

Дата и Время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

R

Количество транзакций в пакете

NbOfTxs

Константа '1', так как числовое значение
не проверяется на соответствие

4

R

Общая сумма платежей в пакете

CtrlSum

-

5

R

Наименование клиента

InitgPty.Nm

-

6

R

ИНН клиента

InitgPty.Id.OrgId.Othr[0].Id

-

7

R

Признак использования ИНН

InitgPty.Id.OrgId.Othr[0].SchmeNm.Cd

Константа 'TXID'

8

R

Номер счета Получателя

InitgPty.Id.OrgId.Othr[1].Id

-

9

R

Признак использования номера счета

InitgPty.Id.OrgId.Othr[1].SchmeNm.Cd

Константа 'ACC'

10

R

Флаг необходимости совпадения переданного ФИО
получателя и
зарегистрированного ФИО получателя в НСПК

CtctDtls.Othr

Значение true/false

Общий путь Document.CstmrCdtTrfInitn.PmtInf

11

R

Идентификатор платежа

PmtInfId

-

12

R

Метод оплаты

PmtMtd

Значение "TRF" по умолчанию

13

R

Дата документа

ReqdExctnDt

-

14

R

Наименование Компании

Dbtr.Nm

-

15

R

Счет плательщика

DbtrAcct.Id.Othr[0].Id

-

16

R

Код вида дохода

DbtrAgt.FinInstnId.ClrSysMmbId.MmbId

-

17

R

Идентификатор платежа внутри пакета.
Формируется потребителем сервиса B2C-переводы

CdtTrfTxInf.PmtId.EndToEndId

-

18

R

Сумма платежа в копейках

CdtTrfTxInf.Amt.InstdAmt

-

19

R

Валюта платежа

CdtTrfTxInf.Amt.InstdAmt@Ccy

Константа 'RUB', так как СБП поддерживает только рубли.

20

O

ФИО Получателя

CdtTrfTxInf.Cdtr.PstlAdr

Если значение передается, а также "Флаг необходимости проверки" отмечен в true, то необходимо совпадение передаваемого ФИО с зарегистрированным в НСПК.

21

R

ID банка получателя

CdtTrfTxInf.Cdtr.Id.OrgId.Othr[0].Id

Значение берется вызовом метода "Список Банков" Список банков

22

R

Телефон получателя

CdtTrfTxInf.CtctDtls.MobNb

Формат +7-000-000-00-00

Блок с подписью Document.CstmrCdtTrfInitn

23

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-
Пример запроса на создание B2C платежа 
<?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>MSG_TEST_2024_02_13T00_00_00</MsgId>
      <CreDtTm>2024-02-13T00:00:00.00</CreDtTm>
      <NbOfTxs>1</NbOfTxs>
      <CtrlSum>1000703</CtrlSum> <!-- Общая сумма платежей в пакете -->
      <InitgPty>
        <Nm>ООО "Тест Альфа-Линк"</Nm>
        <Id>
          <OrgId>
            <Othr>
              <Id>691202047705</Id> <!-- ИНН клиента -->
              <SchmeNm>
                <Cd>TXID</Cd>
              </SchmeNm>
            </Othr>
            <Othr>
              <Id>40802810300000000074</Id> <!-- Номер счета отправителя -->
              <SchmeNm>
                <Cd>ACC</Cd>
              </SchmeNm>
            </Othr>
          </OrgId>
        </Id>
        <CtctDtls>
          <Othr>true</Othr> <!-- Флаг необходимости проверки совпадения переданного ФИО получателя и зарегестрированного ФИО получателя в НСПК -->
        </CtctDtls>
      </InitgPty>
    </GrpHdr>
    <PmtInf>
      <PmtInfId>PMT_TEST_2024_02_13T00_00_00</PmtInfId>
      <PmtMtd>TRF</PmtMtd>
      <ReqdExctnDt>2024-02-13</ReqdExctnDt>
      <Dbtr>
        <Nm>ООО "Тест Альфа-Линк"</Nm>
      </Dbtr>
      <DbtrAcct>
        <Id>
          <Othr>
            <Id>40802810300000000074</Id>
          </Othr>
        </Id>
      </DbtrAcct>
      <DbtrAgt>
        <FinInstnId>
          <ClrSysMmbId>
            <MmbId>1</MmbId> <!-- Код вида дохода -->
          </ClrSysMmbId>
        </FinInstnId>
      </DbtrAgt>
      <CdtTrfTxInf>
        <PmtId>
          <EndToEndId>PMT_TEST_2024_02_13T00_00_00</EndToEndId> <!-- Идентификатор платежа внутри пакета. Формируется потребителем сервиса B2C-переводы -->
        </PmtId>
        <Amt>
          <InstdAmt Ccy="RUB">1000703</InstdAmt> <!-- Сумма платежа -->
        </Amt>
        <Cdtr>
          <PstlAdr>
            <!-- Фамилия -->

          </PstlAdr>
          <Id>
            <OrgId>
              <Othr>
                <Id>1crt88888881</Id> <!-- ID банка получателя -->
              </Othr>
            </OrgId>
          </Id>
          <CtctDtls>
            <MobNb>+7-905-601-03-38</MobNb> <!-- Телефон получателя -->
          </CtctDtls>
        </Cdtr>
        <RmtInf>
          <Ustrd>Платеж по договору ХХХ</Ustrd> <!-- Описание платежа -->
        </RmtInf>
      </CdtTrfTxInf>
    </PmtInf>
       <SplmtryData>
            <Envlp>
                <!--Блок для вставки подписи-->
                <SgntrSt></SgntrSt>
            </Envlp>
        </SplmtryData>
  </CstmrCdtTrfInitn>
</Document>

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[0].Id

Константа '044525593'

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts

5

R

Идентификатор исходного сообщения

OrgnlMsgId

Document.CstmrCdtTrfInitn.GrpHdr.MsgId

6

R

Идентификатор наименования исходного сообщения

OrgnlMsgNmId

Константа 'pain.001.001.06'

7

R

Дата исходного сообщения

OrgnlCreDtTm

-

8

R

Статус СБП платежа

GrpSts

Возможные значения:
RJCT - Отклонено;
PART - Часть статусов платежей в статусе RCVD, остальные в статусе RJCT; RCVD - Принято.

9

R

Уникальный идентификатор пакета платежей присваивается сервисом b2cpay.

StsRsnInf.Orgtr.Nm

Равен для всех платежей коллекции в запросе.

Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts

10

O

Идентификатор платежа

OrgnlPmtInfId

-

11

O

Статус СБП платежа

PmtInfSts

Возможные варианты
RJCT - Отклонено;
RCVD - Платеж принят в обработку системой СБП.

12

O

Идентификатор платежа в пакете, заданный системой потребителя

TxInfAndSts.OrgnlInstrId

-

13

O

Идентификатор платежа в пакете, заданный системой СБП

TxInfAndSts.OrgnlEndToEndId

-

14

O

Сумма комиссии в копейках

TxInfAndSts.ChrgsInf.Amt

-

15

O

Валюта комиссии

TxInfAndSts.ChrgsInf.Amt@Ccy

Константа 'RUB' , так как СБП
принимает только в рублях

16

O

Пустой обязательный параметр

TxInfAndSts.ChrgsInf.Agt.FinInstnId

-

17

O

Дата и время создания платежа

TxInfAndSts.AccptncDtTm

-

18

O

Сумма платежа в копейках

TxInfAndSts.OrgnlTxRef.IntrBkSttlmAmt

-

19

O

Валюта платежа

TxInfAndSts.OrgnlTxRef.IntrBkSttlmAmt@Ccy

Константа 'RUB' , так как СБП
принимает только в рублях

20

O

Описание платежа

TxInfAndSts.OrgnlTxRef.RmtInf.Ustrd

-

21

O

ФИО получателя

TxInfAndSts.OrgnlTxRef.Cdtr.Nm

-

22

O

Признак совпадения ФИО в запросе и данными
при регистрации Клиента в системе НСПК

TxInfAndSts.OrgnlTxRef.Cdtr.CtryOfRes

Значение TR, если совпадения по ФИО есть, FS при несовпадении ФИО в запросе и в НСПК

23

O

Номер телефона получателя

TxInfAndSts.OrgnlTxRef.Cdtr.CtctDtls.PhneNb

-
Пример ответа на принятый в обработку B2C платеж 
<?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>1fc8841aab27444291f62e5056bb1be2</MsgId>
            <CreDtTm>2024-07-05T07:41:20.531+03:00</CreDtTm>
            <InitgPty>
                <Id>
                    <OrgId>
                        <AnyBIC>ALFARUMM</AnyBIC>
                        <Othr>
                            <Id>044525593</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>MSG_TEST_2024_02_13T00_00_00</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
            <OrgnlCreDtTm>2024-02-13T03:00:00.000+03:00</OrgnlCreDtTm>
            <GrpSts>RCVD</GrpSts>
            <StsRsnInf>
                <Orgtr>
                    <Nm>35603</Nm>
                </Orgtr>
            </StsRsnInf>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>PMT_TEST_2024_02_13T00_00_00</OrgnlPmtInfId>
            <PmtInfSts>RCVD</PmtInfSts>
            <TxInfAndSts>
                <OrgnlInstrId>PMT_TEST_2024_02_13T00_00_00</OrgnlInstrId>
                <OrgnlEndToEndId>35932</OrgnlEndToEndId>
                <ChrgsInf>
                    <Amt Ccy="RUB">100</Amt>
                    <Agt>
                        <FinInstnId/>
                    </Agt>
                </ChrgsInf>
                <AccptncDtTm>2024-07-05T07:41:20.507+03:00</AccptncDtTm>
                <OrgnlTxRef>
                    <IntrBkSttlmAmt Ccy="RUB">1000703</IntrBkSttlmAmt>
                    <RmtInf>
                        <Ustrd>Перевод СБП.Платеж по договору ХХХ</Ustrd>
                    </RmtInf>
                    <Cdtr>
                        <CtryOfRes>TR</CtryOfRes>
                        <CtctDtls>
                            <PhneNb>+7-905-601-03-38</PhneNb>
                        </CtctDtls>
                    </Cdtr>
                </OrgnlTxRef>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>
Пример ответа при ошибке запроса 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:admi.010.001.02">
    <StatcDataRpt>
        <MsgId>8a969779cf8147208768ab06675a81ba</MsgId>
        <RptDtls>
            <Tp>Bank List</Tp>
            <ReqRef>Client INN</ReqRef>
            <RptKey>
                <Key>Error</Key>
                <RptData>
                    <Nm>500</Nm>
                    <Val>Exception BadRequest msg: [400 Bad Request] during [POST] to [http://corp-gateway-test/b2cpay-payments-api/client/banklist/get] [SbpB2cPaymentGateway#getBankList(BankListReqDto)]: [{"Error":{"errorCode":1705,"errorMessage":"Поле 'BankList' является обязательным"}}]</Val>
                </RptData>
            </RptKey>
        </RptDtls>
    </StatcDataRpt>
</Document>

Таблица кодов ответа

HTTP код Тип Body Описание

200

OK

-

Запрос успешно отбработан.

200

Err

Данные платежа валидны, но в сторонней системе СБП не был найден переданный идентификтор Банка.

Не найден банк-получатель

200

Err

-

Общая сумма указана неверно

400

Err

Номер счета в тэгах InitgPty и DbtrAcct должны совпадать

Account numbers in InitgPty and DbtrAcct must be same

400

Err

Неверный формат переданного номера телефона

lineNumber: 72; columnNumber: 32; cvc-pattern-valid: Value '+999' is not facet-valid with respect to pa

401

Err

Wrong username or password

Неверный логин или пароль

401

Err

User was not found

Пользователь не найден

401

Err

Could not find signer by certificate

По сертификату пользователь не найден

403

Err

User is disabled

Пользователь заблокирован

403

Err

Internal error while verifying permissions

Ошибка при проверке полномочий

403

Err

Signer is not allowed to sign this operation type

У подписанта нет полномочий на такой тип операции

403

Err

User does not have permission

Нет прав на выполнение запроса

403

Err

Certificate is not valid

Сертификат подписи невалидный

403

Err

Signer’s warrant is expired

Доверенность подписанта истекла

403

Err

Signer’s warrant is disabled

Доверенность подписанта заблокирована

403

Err

Number of signatures is not enough for this operation type

Недостаточно подписей для типа операции

403

Err

Certificate is disabled

Сертификат заблокирован

406

Err

The signer certificate is not valid (revoked or not active)

Сертификат подписанта отозван или невалидный

406

Err

Signature is missing

Нет подписи

406

Err

Signature value is not valid

Подпись невалидна

406

Err

Internal sign check state error

Внутренняя ошибка сервиса

500

Err

Internal Error

Внутренняя ошибка приложения

500

Err

Warrant service error

Сервис проверки доверенности не отвечает

502

Err

Bad Gateway

Ошибочный шлюз

503

Err

Service Unavailable

Сервис недоступен

504

Err

Gateway Timeout

Шлюз не отвечает

Статусная модель B2C платежа

Передается в Document.CstmrPmtStsRpt.OrgnlPmtInfAndSts.PmtInfSts схемы pain.002.001.06

№ ISO статус всего запроса Описание Комментарий

1

RCVD

B2C платеж успешно исполнен в системе СБП

-

2

PART

Часть B2C платежей успешно исполнена в системе СБП

-

3

RJCT

Отклонено

Запрос не прошел проверку на соответствие схеме/в процессе обработки произошла ошибка/невалидные реквизиты компании

Отчетность по СБП платежам

Общая информация

Отчетность позволяет запросить список платежей по следующим критериям:

  • период создания платежей;

  • по пакету платежей;

  • идентификатор конкретной транзакции.

URI

POST: /API/v1/ISO20022/Payments/B2C/Report

Описание схемы запроса

camt.060.001.03

№ R/
O		 Описание Путь Комментарий/
Пример

Общий путь Document.AcctRptgReq.GrpHdr

1

R

Уникальный id сообщения

MsgId

Указывается идентификатор сообщения присвоенный во внешней системе.

2

R

Дата и Время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

R

ИНН клиента

MsgSndr.Pty.Id.OrgId.Othr.Id

-

4

R

Признак использования ИНН

MsgSndr.Pty.Id.OrgId.Othr.SchmeNm

Константа 'TXID'

5

R

Идентификатор запроса

RptgReq.Id

-

6

R

Идентификатор пакета платежей

RptgReq.ReqdMsgNmId

Если не по конкретному платежу, то передавать значение 0

7

R

Счет клиента

Acct.Id.OrgId.Othr.Id

-

8

R

Наименование организации

AcctOwnr.Pty.Nm

-

9

O

Дата начала периода

RptgPrd.FrToDt.FrDt

-

10

O

Дата конца периода

RptgPrd.FrToDt.ToDt

-

11

O

Признак запроса отчетности по периоду

RptgPrd.Tp

Константа 'ALLL', указывается, если фильтр по периоду

12

O

Идентификатор транзакции для случая отчетности по + конкретному платежу

CdOrPrtry.Prtry

-

Блок с подписью Document.AcctRptgReq

13

R

Подпись

SplmtryData.Envlp.SgntrSt[1..n]

-
Пример запроса отчетности 
<?xml version="1.0" encoding="UTF-8"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03">
  <AcctRptgReq>
    <GrpHdr>
      <MsgId>MsgId</MsgId>
      <CreDtTm>1998-08-04T01:07:15.54</CreDtTm>
    </GrpHdr>
    <RptgReq>
      <Id>PacketId</Id>
      <ReqdMsgNmId>33472</ReqdMsgNmId>
      <!-- Идентификатор  пакета платежей. 0, если фильтр не по платежам. Мой пакет при разработке 29964-->
      <Acct>
        <Id>
          <Othr>
            <Id>40802810300000000074</Id>
          </Othr>
        </Id>
      </Acct>
      <AcctOwnr>
        <Pty>
          <Nm>OrgName</Nm>
        </Pty>
      </AcctOwnr>
      <RptgPrd>
        <FrToDt>
          <FrDt>2024-08-13</FrDt>
          <ToDt>2024-06-13</ToDt>
        </FrToDt>
        <FrToTm>
          <FrTm>00:00:00</FrTm>
          <ToTm>23:59:59</ToTm>
        </FrToTm>
        <Tp>ALLL</Tp>
      </RptgPrd>
      <!-- Идентификатор транзакции для случая отчетности по конкретному платежу-->
      <!-- <ReqdBalTp>
        <CdOrPrtry>
          <Prtry>32244</Prtry>
        </CdOrPrtry>
      </ReqdBalTp> -->

    </RptgReq>
    <SplmtryData>
      <Envlp>
        <SgntrSt></SgntrSt>
      </Envlp>
    </SplmtryData>
  </AcctRptgReq>
</Document>

Описание схемы ответа

camt.052.001.05

№ R/
O		 Описание Путь Комментарий/
Пример

Общий путь Document.BkToCstmrAcctRpt.GrpHdr

1

R

Уникальный id сообщения

MsgId

Указывается идентификатор сообщения присвоенный во внешней системе.

2

R

Дата и Время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3).

3

R

Идентификатор запроса отчета

Rpt.Id

-

4

R

Идентификатор отчета

Rpt.CreDtTm

-

5

R

Идентификатор пакета платежей

RptgReq.ReqdMsgNmId

Если не по конкретному платежу, то передавать значеие 0

6

R

Счет клиента

Acct.Id.OrgId.Othr.Id

-

7

R

Наименование организации

AcctOwnr.Pty.Nm

-

8

O

Дата начала периода

RptgPrd.FrToDt.FrDt

-

9

O

Дата конца периода

RptgPrd.FrToDt.ToDt

-

10

O

Константа 'ALLL', указывается, если фильтр по периоду

RptgPrd.Tp

-

11

O

Идентификатор транзакции для случая отчетности по конкретному платежу

CdOrPrtry.Prtry

-
Пример ответа c отчетом 
<?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>3f519b04ea954762b415046049f14326</MsgId>
            <CreDtTm>2024-07-02T16:48:46.187+03:00</CreDtTm>
        </GrpHdr>
        <Rpt>
            <Id>MsgId</Id>
            <CreDtTm>1998-08-04T05:07:15.540+04:00</CreDtTm>
            <FrToDt>
                <FrDtTm>2024-08-13T00:00:00.000+03:00</FrDtTm>
                <ToDtTm>2024-06-13T23:59:59.000+03:00</ToDtTm>
            </FrToDt>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40802810300000000074</Id>
                    </Othr>
                </Id>
            </Acct>
            <Ntry>
                <Amt Ccy="RUB">1000703</Amt>
                <CdtDbtInd>DBIT</CdtDbtInd>
                <Sts>BOOK</Sts>
                <BookgDt>
                    <DtTm>2024-06-24T13:21:29.355+03:00</DtTm>
                </BookgDt>
                <BkTxCd>
                    <Prtry>
                        <Cd>33520</Cd>
                    </Prtry>
                </BkTxCd>
                <AmtDtls>
                    <PrtryAmt>
                        <Tp>1</Tp>
                        <Amt Ccy="RUB">100</Amt>
                    </PrtryAmt>
                </AmtDtls>
                <NtryDtls>
                    <TxDtls>
                        <Refs>
                            <TxId>33472</TxId>
                            <AcctOwnrTxId>PMT_TEST_2024_02_13T00_00_00</AcctOwnrTxId>
                        </Refs>
                        <Amt Ccy="RUB">100</Amt>
                        <CdtDbtInd>DBIT</CdtDbtInd>
                        <RltdPties>
                            <Cdtr>
                                <PstlAdr>
                                    <Dept>0079056010338</Dept>
                                </PstlAdr>
                            </Cdtr>
                        </RltdPties>
                        <RmtInf>
                            <Strd>
                                <AddtlRmtInf>Перевод СБП.Платеж по договору ХХХ</AddtlRmtInf>
                            </Strd>
                        </RmtInf>
                    </TxDtls>
                </NtryDtls>
            </Ntry>
        </Rpt>
    </BkToCstmrAcctRpt>
</Document>

31. Депозиты

Общая информация

Работа Клиента с разделом Депозиты представляет собой дистанционное размещение денежных средств на депозитных счетах на индивидуальных условиях. Клиенту доступны следующие документы:

  • Получение Оферты

  • Акцепт Оферты

  • Статус Сделки

  • Отчет о заключении Сделки

Все участники процесса должны иметь соответствующие права на работу с депозитными сделками в интернет-банке. Для технического пользователя достаточно роли оператора.

Получение Оферты

Запрос списка Оферт без подписи

Реализована возможность запроса списка Оферт без подписания УКЭП. Для этого необходимо оставить тег <SgntrSt> пустым.

URI

POST: /API/v1/ISO20022/Deposits/Offers

XML схема запроса

camt.060.001.03

№ R/
O		 Описание Путь Комментарий/
Пример

Document/AcctRptgReq/GrpHdr

1

R

Уникальный ID сообщения

MsgId

-

2

R

Дата и время создания

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD

3

R

ИНН организации

MsgSndr/Pty/Id/OrgId/Othr[1]/Id

-

4

R

ISO код типа данных для ИНН

MsgSndr/Pty/Id/OrgId/Othr[1]/SchmeNm/Cd

Константа "TXID"

5

R

Идентификатор Клиента в Банке

MsgSndr/Pty/Id/OrgId/Othr[2]/Id

Используется, если не заполнен тег Document/AcctRptgReq/RptgReqAcct/Id/Othr/Id

6

R

ISO код типа данных для идентификатора

MsgSndr/Pty/Id/OrgId/Othr[2]/SchmeNm/Cd

Константа "BOID"
Используется, если не заполнен тег Document/AcctRptgReq/RptgReqAcct/Id/Othr/Id

Document/AcctRptgReq/RptgReq

7

R

Тип документа

ReqdMsgNmId

Константа "DEPOSIT"

8

O

Номер счета компании

Acct/Id/Othr/Id

Заполняется обязательно, если у компании есть расчетный счет в Альфа-Банке. Если нет, заполняются теги Document/AcctRptgReq/GrpHdr/MsgSndr/Pty/Id/OrgId/Othr[2]/Id и Document/AcctRptgReq/GrpHdr/MsgSndr/Pty/Id/OrgId/Othr[2]/SchmeNm/Cd

9

R

Наименование клиента

AcctOwnr/Pty/Nm

-

Блок с подписью Document/AcctRptgReq/SplmtryData/Envlp

10

R

Подпись

SgntrSt

-
Пример запроса списка Оферт 
<?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>TEST_MSG_2025-05-19-00000001</MsgId>
            <CreDtTm>2025-05-19T12:00:00.000+03:00</CreDtTm>
            <MsgSndr>
                <Pty>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>7013602245</Id>
                                <SchmeNm>
                                    <Cd>TXID</Cd>
                                </SchmeNm>
                            </Othr>
                        </OrgId>
                    </Id>
                </Pty>
            </MsgSndr>
        </GrpHdr>
        <RptgReq>
            <ReqdMsgNmId>DEPOSIT</ReqdMsgNmId>
            <Acct>
                <Id>
                    <Othr>
                        <Id>40702810200000000083</Id>
                    </Othr>
                </Id>
            </Acct>
            <AcctOwnr>
                <Pty>
                    <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
                </Pty>
            </AcctOwnr>
        </RptgReq>
        <SplmtryData>
            <Envlp>
                <SgntrSt/>
            </Envlp>
        </SplmtryData>
    </AcctRptgReq>
</Document>

Схема ответа на запрос списка Оферт

trea.320.001.01

№ R/
O		 Описание Путь Комментарий/
Пример

Общий путь Document/DpstRq/GrpHdr

1

R

Уникальный ID сообщения

MsgId

-

2

R

Дата и время создания сообщения

CreDtTm

YYYY-MM-DDThh:mm:ss[.mmm]TZD

3

R

Количество Оферт

NbOfItms

-

4

R

Наименование отправителя

InitgPty/Nm

Константа "АО "АЛЬФА-БАНК"

5

R

ID исходного сообщения

InitgPty/Id/OrgId/Othr/Id

-

Document/DpstRq/DpstOrdr

6

R

Уникальный ID пакета

DpstOrdrId

-

7

R

Наименование компании, размещающей депозит

AcctOwnr/Nm

-

8

R

Обозначение российской расчетной системы

AcctSvcr/FinInstnId/ClrSysMmbId/ClrSysId/Cd

Константа "RUCBC"

9

R

БИК банка/отделения обслуживающего счет

AcctSvcr/FinInstnId/ClrSysMmbId/MmbId

Константа "044525593"

10

R

Наименование банка

AcctSvcr/FinInstnId/Nm

Константа "АО "АЛЬФА-БАНК"

Document/DpstRq/DpstOrdr/DpstDtls

11

R

Уникальный ID заявки

DpstDtlsId

-

12

R

Номер заявки

DpstOrdrId/Id

Идентификатор Оферты в Банке

13

O

Тип депозита

DpstTpInf/DpstTp/Cd

CCCB - срочный депозит
CCDS - срочный депозит с возможностью частичного/полного возврата
CCPS - срочный пополняемый депозит с возможностью частичного возврата
CCPL - срочный депозит с возможностью пополнения
FC - фиксированный остаток на счете

14

O

Минимальный остаток на Депозитном счете

DpstTpInf/CtrctAmt/MinAmt

-

15

O

Валюта минимального остатка на Депозитном счете

DpstTpInf/CtrctAmt/MinAmt@Ccy

-

16

O

Максимальная сумма Депозита с учетом всех дополнительных взносов

DpstTpInf/CtrctAmt/MaxAmt

-

17

O

Валюта максимальной суммы Депозита

DpstTpInf/CtrctAmt/MaxAmt@Ccy

-

18

O

Минимальная сумма дополнительного взноса во Вклад

DpstTpInf/AmndmntInf/IncrAmt/MinAmt

-

19

O

Валюта минимальной суммы дополнительного взноса во Вклад

DpstTpInf/AmndmntInf/IncrAmt/MinAmt@Ccy

-

20

O

Сумма процентов к выплате

DpstTpInf/AmndmntInf/IncrAmt/MaxAmt

-

21

O

Валюта суммы процентов к выплате

DpstTpInf/AmndmntInf/IncrAmt/MaxAmt@Ccy

-

22

O

Минимальная сумма частичного возврата Депозита

DpstTpInf/AmndmntInf/DecrAmt/MinAmt

-

23

O

Валюта минимальной суммы частичного возврата

DpstTpInf/AmndmntInf/DecrAmt/MinAmt@Ccy

-

24

R

Счет Клиента, с которого переводятся денежные средства в сумме Депозита на Депозитный счет

SrcAcct/Acct/Id/Othr/Id

Константа "undefined"
Для типа Депозита "FC" указывается "Номер Банковского счета"

25

R

Сумма Депозита

Amt

Для типа Депозита "FC" указывается "Сумма Фиксированного остатка"

26

R

Валюта Депозита

Amt@Ccy

Для типа Депозита "FC" указывается "Валюта Фиксированного остатка"

27

R

Дата размещения Депозита

Prd/FrDt

YYYY-MM-DD (часовой пояс Москвы UTC+3)
Для типа Депозита "FC" указывается "Дата начала срока"

28

O

Дата возврата Депозита

Prd/ToDt

YYYY-MM-DD (часовой пояс Москвы UTC+3)
Для типа Депозита "FC" указывается "Дата окончания срока"

29

R

Процентная ставка за пользование Депозитом (% годовых)

IntrstInf/IntrstRate/Fxd

Для типа Депозита "FC" указывается "Процентная ставка за пользование Фиксированным остатком (% годовых)"

30

O

Порядок выплаты процентов

IntrstInf/PmtFrqncy/Prtry

-

31

O

Причина отклонения запроса

Ustrd[1…​5]

-

32

O

Возможность досрочного возврата Депозита

SplmtryData/Envlp/OthrConds/EarlyTrmntn/Allwd

false/true

33

O

Возможность пополнения Депозита

SplmtryData/Envlp/OthrConds/Refill/Allwd

false/true

34

O

Предельная дата внесения дополнительных взносов во Вклад

SplmtryData/Envlp/OthrConds/Refill/Dt

YYYY-MM-DD (часовой пояс Москвы UTC+3)

35

O

Возможность частичного возврата депозита

SplmtryData/Envlp/OthrConds/EarlyRtrn/Allwd

false/true

36

O

Дата начала возможности досрочного возврата Депозита

SplmtryData/Envlp/OthrConds/EarlyRtrn/Dt

YYYY-MM-DD (часовой пояс Москвы UTC+3)

37

O

Возможность возврата депозита в первый месяц

SplmtryData/Envlp/OthrConds/EarlyRtrn/FrstMnth/Allwd

-

38

O

Срок фактического нахождения средств во вкладе

SplmtryData/Envlp/OthrConds/EarlyRtrn/Rts[1…​n]/PrdTp

"RT01" - от 1 мес. (вкл.) до 2 мес.
"RT02" - от 2 мес. (вкл.) до 3 мес.
"RT03" - от 3 мес. (вкл.) до 4 мес.
"RT04" - от 4 мес. (вкл.) до 5 мес.
"RT05" - от 5 мес. (вкл.) до 6 мес.
"RT06" - от 6 мес. (вкл.) до 7 мес.
"RT07" - от 7 мес. (вкл.) до 8 мес.
"RT08" - от 8 мес. (вкл.) до 9 мес.
"RT09" - от 9 мес. (вкл.) до 10 мес.
"RT10" - от 10 мес. (вкл.) до 11 мес.
"RT11" - от 11 мес. (вкл.) до 12 мес.
"RT12" - от 12 мес. (вкл.) до 18 мес.
"RT18" - от 18 мес. (вкл.) до 24 мес.
"RT24" - от 24 мес. (вкл.) до 36 мес.
"RT36" - от 36 мес. (вкл.) до 48 мес.
"RT48" - от 48 мес. (вкл.) до 60 мес.

39

O

Ставка для досрочного возврата (в %)

SplmtryData/Envlp/OthrConds/EarlyRtrn/Rts[1…​n]/Rt

-

40

O

Иные условия сделки, согласованные Сторонами

SplmtryData/Envlp/OthrConds/AddtnlConds

-

41

O

Время окончания действия предложения

SplmtryData/Envlp/OthrConds/ExprtnTm

YYYY-MM-DDThh:mm:ss[.mmm]TZD
Пример ответа со списком Оферт 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:trea.320.001.01">
    <DpstRq>
        <GrpHdr>
            <!--Уникальный ID сообщения-->
            <MsgId>f42031c317ad44b89a5b1bbd486af774</MsgId>
            <!--Дата и время создания сообщения-->
            <CreDtTm>2023-11-09T17:02:04+03:00</CreDtTm>
            <!--Количество оферт-->
            <NbOfItms>2</NbOfItms>
            <InitgPty>
                <!--Наименование отправителя-->
                <Nm>АО "АЛЬФА-БАНК"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <!--ID исходного сообщения-->
                            <Id>MSG_TEST_20250624001</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <DpstOrdr>
            <!--Уникальный ID пакета-->
            <DpstOrdrId>f42031c317ad44b89a5b1bbd486af774</DpstOrdrId>
            <AcctOwnr>
                <!--Наименование компании, размещающей депозиты-->
                <Nm>ООО "Тест Альфа-Линк"</Nm>
            </AcctOwnr>
            <AcctSvcr>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <!--Обозначение российской расчетной системы-->
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <!--БИК банка/отделения обслуживающего счет-->
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <!--Наименование банка-->
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                </FinInstnId>
            </AcctSvcr>
            <DpstDtls>
                <!--Уникальный ID заявки-->
                <DpstDtlsId>f42031c317ad44b89a5b1bbd486af774</DpstDtlsId>
                <DpstOrdrId>
                    <!--Номер заявки-->
                    <Id>10000595</Id>
                </DpstOrdrId>
                <DpstTpInf>
                    <DpstTp>
                        <!--Тип Депозита-->
                        <Cd>CCCB</Cd>
                    </DpstTp>
                    <CtrctAmt>
                        <!--Минимальный остаток на Депозитном счете-->
                        <MinAmt Ccy="RUB">10000.00</MinAmt>
                        <!--Максимальная сумма Депозита с учетом всех дополнительных взносов-->
                        <MaxAmt Ccy="RUB">100000.00</MaxAmt>
                    </CtrctAmt>
                    <AmndmntInf>
                        <IncrAmt>
                            <!--Минимальная сумма дополнительного взноса во Вклад-->
                            <MinAmt Ccy="RUB">6000.00</MinAmt>
                            <!--Сумма процентов к выплате-->
                            <MaxAmt Ccy="RUB">16578.00</MaxAmt>
                        </IncrAmt>
                        <DecrAmt>
                            <!--Минимальная сумма частичного возврата Депозита-->
                            <MinAmt Ccy="RUB">5000.00</MinAmt>
                        </DecrAmt>
                    </AmndmntInf>
                </DpstTpInf>
                <SrcAcct>
                    <Acct>
                        <Id>
                            <Othr>
                                <!--Счет Клиента, с которого переводятся денежные средства в сумме Депозита на Депозитный счет-->
                                <Id>undefined</Id>
                            </Othr>
                        </Id>
                    </Acct>
                </SrcAcct>
                <!--Сумма Депозита-->
                <Amt Ccy="RUB">50000</Amt>
                <Prd>
                    <!--Дата размещения Депозита-->
                    <FrDt>2025-03-01</FrDt>
                    <!--Дата возврата Депозита-->
                    <ToDt>2025-03-06</ToDt>
                </Prd>
                <IntrstInf>
                    <IntrstRate>
                        <!--Процентная ставка за пользование Депозитом (% годовых)-->
                        <Fxd>7.5</Fxd>
                    </IntrstRate>
                    <PmtFrqncy>
                        <!--Порядок выплаты процентов-->
                        <Prtry>В конце срока</Prtry>
                    </PmtFrqncy>
                </IntrstInf>
                <SplmtryData>
                    <Envlp>
                        <OthrConds>
                            <EarlyTrmntn>
                                <!--Возможность досрочного возврата Депозита-->
                                <Allwd>true</Allwd>
                             </EarlyTrmntn>
                            <Refill>
                                <!--Возможность пополнения Депозита-->
                                <Allwd>false</Allwd>
                            </Refill>
                            <EarlyRtrn>
                                <!--Возможность частичного возврата Депозита-->
                                <Allwd>true</Allwd>
                                <!--Дата начала возможности досрочного возврата Депозита-->
                                <Dt>2023-11-09</Dt>
                             </EarlyRtrn>
                            <!--Иные условия сделки, согласованные Сторонами-->
                            <AddtnlConds/>
                            <!--Время окончания действия предложения-->
                            <ExprtnTm>2023-11-09T17:02:04+03:00</ExprtnTm>
                        </OthrConds>
                    </Envlp>
                </SplmtryData>
            </DpstDtls>
            <DpstDtls>
                <!--Уникальный ID заявки-->
                <DpstDtlsId>f42031c317ad44b89a5b1bbd486af775</DpstDtlsId>
                <DpstOrdrId>
                    <!--Номер заявки-->
                    <Id>10000596</Id>
                </DpstOrdrId>
                <DpstTpInf>
                    <DpstTp>
                        <!--Тип Депозита-->
                        <Cd>CCPL</Cd>
                    </DpstTp>
                    <CtrctAmt>
                        <!--Минимальный остаток на Депозитном счете-->
                        <MinAmt Ccy="RUB">10000.00</MinAmt>
                        <!--Максимальная сумма Депозита с учетом всех дополнительных взносов-->
                        <MaxAmt Ccy="RUB">100000.00</MaxAmt>
                    </CtrctAmt>
                    <AmndmntInf>
                        <IncrAmt>
                            <!--Минимальная сумма дополнительного взноса во Вклад-->
                            <MinAmt Ccy="RUB">6000.00</MinAmt>
                            <!--Сумма процентов к выплате-->
                            <MaxAmt Ccy="RUB">16578.00</MaxAmt>
                        </IncrAmt>
                        <DecrAmt>
                            <!--Минимальная сумма частичного возврата Депозита-->
                            <MinAmt Ccy="RUB">5000.00</MinAmt>
                        </DecrAmt>
                        <PrlngInf>
                            <Prtry>true</Prtry>
                        </PrlngInf>
                    </AmndmntInf>
                </DpstTpInf>
                <SrcAcct>
                    <Acct>
                        <Id>
                            <Othr>
                                <!--Счет Клиента, с которого переводятся денежные средства в сумме Депозита на Депозитный счет-->
                                <Id>undefined</Id>
                            </Othr>
                        </Id>
                    </Acct>
                </SrcAcct>
                <!--Сумма Депозита-->
                <Amt Ccy="RUB">50000.00</Amt>
                <Prd>
                    <!--Дата размещения Депозита-->
                    <FrDt>2025-03-01</FrDt>
                    <!--Дата возврата Депозита-->
                    <ToDt>2025-03-06</ToDt>
                </Prd>
                <IntrstInf>
                    <IntrstRate>
                        <!--Процентная ставка за пользование Депозитом (% годовых)-->
                        <Fxd>7.5</Fxd>
                    </IntrstRate>
                    <PmtFrqncy>
                        <!--Порядок выплаты процентов-->
                        <Prtry>В конце срока</Prtry>
                    </PmtFrqncy>
                </IntrstInf>
                <SplmtryData>
                    <Envlp>
                        <OthrConds>
                            <EarlyTrmntn>
                                <!--Возможность досрочного возврата Депозита-->
                                <Allwd>true</Allwd>
                            </EarlyTrmntn>
                            <Refill>
                                <!--Возможность пополнения Депозита-->
                                <Allwd>true</Allwd>
                                <!--Предельная дата внесения дополнительных взносов во Вклад-->
                                <Dt>2025-05-07</Dt>
                            </Refill>
                            <!--Возможность частичного возврата Депозита-->
                            <EarlyRtrn>
                                <Allwd>true</Allwd>
                                <!--Дата начала возможности досрочного возврата Депозита-->
                                <Dt>2025-05-07</Dt>
                            </EarlyRtrn>
                            <!--Иные условия сделки, согласованные Сторонами-->
                            <AddtnlConds/>
                            <!--Время окончания действия предложения-->
                            <ExprtnTm>2023-11-09T17:02:04+03:00</ExprtnTm>
                        </OthrConds>
                    </Envlp>
                </SplmtryData>
            </DpstDtls>
        </DpstOrdr>
    </DpstRq>
</Document>
Пример ответа с ошибкой 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:trea.320.001.01">
    <DpstRq>
        <GrpHdr>
            <MsgId>5d17ba913cb9482aa76b34b159056b4c</MsgId>
            <CreDtTm>2024-10-17T18:54:17.673+03:00</CreDtTm>
            <NbOfItms>0</NbOfItms>
            <InitgPty>
                <Nm>АО "Альфа-Банк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>MSG_TEST_20250624001</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <DpstOrdr>
            <DpstOrdrId>f81a57176f7d4bb683db08e8d258fd52</DpstOrdrId>
            <AcctOwnr>
                <Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
            </AcctOwnr>
            <AcctSvcr>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "Альфа-Банк"</Nm>
                </FinInstnId>
            </AcctSvcr>
            <DpstDtls>
                <DpstDtlsId>baa9727ee2be416bbb36e5ac96220250</DpstDtlsId>
                <DpstOrdrId>
                    <Id>0</Id>
                </DpstOrdrId>
                <SrcAcct>
                    <Acct>
                        <Id>
                            <Othr>
                                <Id>undefined</Id>
                            </Othr>
                        </Id>
                    </Acct>
                </SrcAcct>
                <Amt Ccy="RUB">0</Amt>
                <Prd>
                    <FrDt>2024-10-17</FrDt>
                </Prd>
                <IntrstInf>
                    <IntrstRate>
                        <Fxd>0</Fxd>
                    </IntrstRate>
                </IntrstInf>
                <Ustrd>У пользователя недостаточно прав в интернет-банке на работу с этим типом документов.</Ustrd>
            </DpstDtls>
        </DpstOrdr>
    </DpstRq>
</Document>

Таблицы кодов ответа

Получение Оферты

HTTP код Тип Body Описание

200

OK

-

Запрос на список оферт успешно обработан.

400

Err

XML does not match schema. Please check the document.

Документ не соответствует XSD-схеме или не заполнены обязательные теги.

400

Err

Не заполнен ИНН компании. Заполните теги Document/AcctRptgReq/GrpHdr/MsgSndr/Pty/Id/OrgId/Othr/SchmeNm/Cd = "TXID" и Document/AcctRptgReq/GrpHdr/MsgSndr/Pty/Id/OrgId/Othr/Id и направьте запрос заново.

400

Err

IDs consistency error. ACCOUNT_NUMBER {account_number} and INN {inn}} corresponds to different companies

Номер счета и ИНН не принадлежат одной компании

400

Err

В документе не указан идентификатор компании. Пожалуйста, добавьте идентификатор и повторите запрос

400

Err

Failed to get company by profile id {profile_id}

Невозможно определить компанию по идентификатору.

403

Err

User doesn’t have permissions

У пользователя недостаточно прав в интернет-банке на работу с депозитами.

400

Err

Failed to get company by account number

400

Err

Account number mustn’t be empty

200

Err

No offers are available for your company. Please contact your personal manager.

Для компании не найдено ни одной доступной оферты.

500

Err

Technical exception. Please call service desk.

Техническая ошибка при обработке запроса или вызове смежного сервиса.

Акцепт Оферты

Важно

Акцепт Оферты формируется Клиентом на основании списка Оферт, полученных из Банка по схеме trea.320.001.01. Сообщение должно содержать только один пакет только с одной заявкой.
В блоке "Document/DpstRq/DpstOrdr/DpstDtls" Клиент:

  • заполняет тег с номером счета списания (</SrcAcct/Acct/Id/Othr/Id>)

  • указывает реквизиты для возврата Депозита и процентов по нему

  • меняет уникальный идентификатор заявки (<DpstDtlsId>)

  • убирает время окончания действия предложения (</SplmtryData/Envlp/OthrConds/ExprtnTm>)

Остальные поля в блоке "Document/DpstRq/DpstOrdr/DpstDtls" остаются без изменений. В случае внесения изменений в условия сделки документ "Акцепт Оферты" будет отклонен.

URI

POST: /API/v1/ISO20022/Deposits

Схема запроса

trea.320.001.01

№ R/
O		 Описание Путь Комментарий/
Пример

Document/DpstRq/GrpHdr

1

R

Уникальный ID сообщения

MsgId

-

2

R

Дата и время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD

3

R

Количество Оферт

NbOfItms

Константа "1"

4

R

Наименование отправителя

InitgPty/Nm

-

5

R

ИНН организации

InitgPty/Id/OrgId/Othr[[1]/Id

ИНН компании клиента

6

R

ISO код типа данных для ИНН

InitgPty/Id/OrgId/Othr[1]/SchmeNm/Cd

Константа "TXID"

7

O

Номер счета организации

InitgPty/Id/OrgId/Othr[2]/Id

Номер расчетного счета компании клиента
Заполняется, если тег Document/DpstRq/DpstOrdr/DpstDtls/SrcAcct/Acct/Id/Othr/Id = "undefined" и у компании есть расчетный счет в Альфа-Банке

8

O

ISO код типа данных для номера счета

InitgPty/Id/OrgId/Othr[2]/SchmeNm/Cd

Константа "ACC"
Заполняется, если тег Document/DpstRq/DpstOrdr/DpstDtls/SrcAcct/Acct/Id/Othr/Id = "undefined" и у компании есть расчетного счета в Альфа-Банке

9

O

Идентификатор Клиента в Банке

InitgPty/Id/OrgId/Othr[3]/Id

Заполняется, если у компании нет расчетного счета в Альфа-Банке

10

O

ISO код типа данных для идентификатора компании

InitgPty/Id/OrgId/Othr[3]/SchmeNm/Cd

Константа "BOID"
Заполняется, если у компании нет расчетного счета в Альфа-Банке

Document/DpstRq/DpstOrdr

11

R

Уникальный ID пакета

DpstOrdrId

=Document/DpstRq/GrpHdr/MsgId

12

R

Наименование компании, размещающей депозит

AcctOwnr/Nm

Наименование компании клиента

13

R

Обозначение российской расчетной системы

AcctSvcr/FinInstnId/ClrSysMmbId/ClrSysId/Cd

Константа "RUCBC"

14

R

БИК банка/отделения обслуживающего счет

AcctSvcr/FinInstnId/ClrSysMmbId/ClrSysId/MmbId

Константа "044525593"

15

R

Наименование банка

AcctSvcr/FinInstnId/Nm

Константа "АО "АЛЬФА-БАНК""

Document/DpstRq/DpstOrdr/DpstDtls

16

R

Уникальный ID заявки

DpstDtlsId

=Document/DpstRq/GrpHdr/MsgId

17

R

Номер заявки

DpstOrdrId/Id

Идентификатор Оферты в Банке

18

R

Тип депозита

DpstTpInf/DpstTp/Cd

CCCB - срочный депозит
CCDS - срочный депозит с возможностью
частичного/полного возврата
CCPS - срочный пополняемый депозит с возможностью частичного возврата
CCPL - срочный депозит с возможностью пополнения
FC - фиксированный остаток на счете

19

O

Минимальный остаток на Депозитном счете

DpstTpInf/CtrctAmt/MinAmt

-

20

O

Валюта минимального остатка на Депозитном счете

DpstTpInf/CtrctAmt/MinAmt@Ccy

-

21

O

Максимальная сумма Депозита с учетом всех дополнительных вносов

DpstTpInf/CtrctAmt/MaxAmt

-

22

O

Валюта максимальной суммы Депозита

DpstTpInf/CtrctAmt/MaxAmt@Ccy

-

23

O

Минимальная сумма дополнительного взноса во Вклад

DpstTpInf/AmndmntInf/IncrAmt/MinAmt

-

24

O

Валюта минимальной суммы дополнительного взноса во Вклад

DpstTpInf/AmndmntInf/IncrAmt/MinAmt@Ccy

-

25

R

Сумма процентов к выплате

DpstTpInf/AmndmntInf/IncrAmt/MaxAmt

-

26

R

Валюта суммы процентов к выплате

DpstTpInf/AmndmntInf/IncrAmt/MaxAmt@Ccy

-

27

O

Минимальная сумма частичного возврата Депозита

DpstTpInf/AmndmntInf/DecrAmt/MinAmt

-

28

O

Валюта минимальной суммы частичного возврата

DpstTpInf/AmndmntInf/DecrAmt/MinAmt@Ccy

-

29

R

Счет Клиента, с которого переводятся денежные средства в сумме Депозита на Депозитный счет

SrcAcct/Acct/Id/Othr/Id

- Для типа Депозита "FC" указывается "Номер Банковского счета"
- При указании расчетного счета в Альфа-Банке клиент поручает банку самостоятельно осуществить перевод денежных средств в сумме Депозита на Депозитный счет с указанного счета
- Для перевода денежных средств клиентом на депозитный счет со счета в другом банке указывается константа "undefined"

30

R

Сумма Депозита

Amt

Для типа Депозита "FC" указывается "Сумма Фиксированного остатка"

31

R

Валюта Депозита

Amt@Ccy

Для типа Депозита "FC" указывается "Валюта Фиксированного остатка"

32

R

Дата размещения Депозита

Prd/FrDt

Формат даты YYYY-MM-DD (часовой пояс Москвы UTC+3)
Для типа Депозита "FC" указывается "Дата начала срока"

33

R

Дата возврата Депозита

Prd/ToDt

Формат даты YYYY-MM-DD (часовой пояс Москвы UTC+3)
Для типа Депозита "FC" указывается "Дата окончания срока"

34

R

Процентная ставка за пользование Депозитом (% годовых)

IntrstInf/IntrstRate/Fxd

Формат записи должен точно соответствовать формату, полученному в документе "Получение Оферты"
Для типа Депозита "FC" указывается "Процентная ставка за пользование Фиксированным остатком (% годовых)"

35

R

Порядок выплаты процентов

IntrstInf/PmtFrqncy/Prtry

-

36

O

Счет Клиента для возврата Депозита и процентов по нему

RtrnAcct/Acct/Id/Othr/Id

Номер расчетного счета в Альфа-Банке. Обязателен, если не заполнен тег Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/Acct/Id/Othr/Id. Один из тегов обязателен к заполнению
Константа "undefined" для типа Депозита "FC"

37

O

Счет юридического лица в банке получателе

RtrnAcct/XtrnAcc/Acct/Id/Othr/Id

Номер расчетного счета, открытого не в Альфа-Банке. Обязателен, если не заполнен тег Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/Acct/Id/Othr/Id. Один из тегов обязателен к заполнению

38

O

БИК банка получателя

RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/ClrSysMmbId/MmbId

Обязателен при заполнении тега Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/Acct/Id/Othr/Id

39

O

Корреспондентский счет банка получателя

RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/Othr/Id

Обязателен при заполнении тега Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/Acct/Id/Othr/Id

40

O

Наименование банка получателя*

RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/Nm

Зарезервирован

41

O

Наименование банка получателя*

RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/PstlAdr/AdrLine[1…​7]

Зарезервирован

42

R

Возможность досрочного возврата Депозита

SplmtryData/Envlp/OthrConds/EarlyTrmntn/Allwd

false/true

43

R

Возможность пополнения Депозита

SplmtryData/Envlp/OthrConds/Refill/Allwd

false/true

44

O

Предельная дата внесения дополнительных взносов во Вклад

SplmtryData/Envlp/OthrConds/Refill/Dt

YYYY-MM-DD (часовой пояс Москвы UTC+3)

45

R

Возможность частичного возврата Депозита

SplmtryData/Envlp/OthrConds/EarlyRtrn/Allwd

false/true

46

O

Дата начала возможности досрочного возврата Депозита

SplmtryData/Envlp/OthrConds/EarlyRtrn/Dt

Формат даты YYYY-MM-DD (часовой пояс Москвы UTC+3)

47

O

Возможность возврата депозита в первый месяц

SplmtryData/Envlp/OthrConds/EarlyRtrn/FrstMnth/Allwd

-

48

O

Срок фактического нахождения средств во вкладе

SplmtryData/Envlp/OthrConds/EarlyRtrn/Rts[1…​n]/PrdTp

"RT01" - от 1 мес. (вкл.) до 2 мес.
"RT02" - от 2 мес. (вкл.) до 3 мес.
"RT03" - от 3 мес. (вкл.) до 4 мес.
"RT04" - от 4 мес. (вкл.) до 5 мес.
"RT05" - от 5 мес. (вкл.) до 6 мес.
"RT06" - от 6 мес. (вкл.) до 7 мес.
"RT07" - от 7 мес. (вкл.) до 8 мес.
"RT08" - от 8 мес. (вкл.) до 9 мес.
"RT09" - от 9 мес. (вкл.) до 10 мес.
"RT10" - от 10 мес. (вкл.) до 11 мес.
"RT11" - от 11 мес. (вкл.) до 12 мес.
"RT12" - от 12 мес. (вкл.) до 18 мес.
"RT18" - от 18 мес. (вкл.) до 24 мес.
"RT24" - от 24 мес. (вкл.) до 36 мес.
"RT36" - от 36 мес. (вкл.) до 48 мес.
"RT48" - от 48 мес. (вкл.) до 60 мес.

49

O

Ставка для досрочного возврата (в %)

SplmtryData/Envlp/OthrConds/EarlyRtrn/Rts[1…​n]/Rt

Формат записи должен точно соответствовать формату, полученному в документе "Получение Оферты"

50

O

Иные условия сделки, согласованные Сторонами

SplmtryData/Envlp/OthrConds/AddtnlConds

-

Блок с подписью Document/DpstRq/SplmtryData/Envlp

51

R

Подпись

SgntrSt

-
Пример запроса на размещение Депозита 
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:trea.320.001.01" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
    <DpstRq>
        <GrpHdr>
            <MsgId>MSG_ID_20250411_nPha4E</MsgId>
            <CreDtTm>2025-04-11T14:10:17.609+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>691202047705</Id>
                            <SchmeNm>
                                <Cd>TXID</Cd>
                            </SchmeNm>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <DpstOrdr>
            <DpstOrdrId>MSG_ID_20250411_nPha4E</DpstOrdrId>
            <AcctOwnr>
                <Nm>ООО "Тест Альфа-Линк"</Nm>
            </AcctOwnr>
            <AcctSvcr>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>ALFARUMM</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                </FinInstnId>
            </AcctSvcr>
            <DpstDtls>
                <DpstDtlsId>MSG_ID_20250411_nPha4E</DpstDtlsId>
                <DpstOrdrId>
                    <Id>10000647</Id>
                </DpstOrdrId>
                <DpstTpInf>
                    <DpstTp>
                        <Cd>CCCB</Cd>
                    </DpstTp>
                    <AmndmntInf>
                        <IncrAmt>
                            <MaxAmt Ccy="RUB">628.77</MaxAmt>
                        </IncrAmt>
                    </AmndmntInf>
                </DpstTpInf>
                <SrcAcct>
                    <Acct>
                        <Id>
                            <Othr>
                                <Id>40702810201880012070</Id>
                            </Othr>
                        </Id>
                    </Acct>
                </SrcAcct>
                <Amt Ccy="RUB">102000.00</Amt>
                <Prd>
                    <FrDt>2025-04-11</FrDt>
                    <ToDt>2025-05-26</ToDt>
                </Prd>
                <IntrstInf>
                    <IntrstRate>
                        <Fxd>5.0</Fxd>
                    </IntrstRate>
                    <PmtFrqncy>
                        <Prtry>В конце срока</Prtry>
                    </PmtFrqncy>
                </IntrstInf>
                <RtrnAcct>
                    <Acct>
                        <Id>
                            <Othr>
                                <Id>40702810701890087922</Id>
                            </Othr>
                        </Id>
                    </Acct>
                </RtrnAcct>
                <SplmtryData>
                    <Envlp>
                        <OthrConds>
                            <EarlyTrmntn>
                            	<Allwd>false</Allwd>
                            </EarlyTrmntn>
                            <Refill>
                                <Allwd>true</Allwd>
                                <Dt>2025-05-25</Dt>
                            </Refill>
                            <EarlyRtrn>
                            	<Allwd>false</Allwd>
                            </EarlyRtrn>
                        </OthrConds>
                    </Envlp>
                </SplmtryData>
            </DpstDtls>
        </DpstOrdr>
        <SplmtryData>
            <Envlp>
                <SgntrSt/>
            </Envlp>
        </SplmtryData>
    </DpstRq>
</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>5e1d1799799e40278638fb95103436c9</MsgId>
            <CreDtTm>2025-03-25T17:26:40.601+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <RcvgPty/>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                    <ClrSysMmbId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </RegnAgt>
        </GrpHdr>
        <GrpSts>
            <OrgnlRefs>
                <OrgnlMsgId>MSG_ID_20250325_FzgvTW</OrgnlMsgId>
                <OrgnlMsgNmId>trea.320.001.01</OrgnlMsgNmId>
                <OrgnlCreDtTm>2025-03-25T14:54:41.774+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>MSG_ID_20250325_FzgvTW</PackgId>
            <Sts>RCVD</Sts>
            <RcrdSts>
                <RcrdId>MSG_ID_20250325_FzgvTW</RcrdId>
                <Sts>RCVD</Sts>
            </RcrdSts>
        </PackgSts>
    </CcyCtrlStsAdvc>
</Document>
Пример ответа c ошибкой 
<?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>89376786b2884bbbad7f519ae195e7f5</MsgId>
            <CreDtTm>2025-09-21T22:41:54.914+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <RcvgPty/>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                    <ClrSysMmbId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </RegnAgt>
        </GrpHdr>
        <GrpSts>
            <OrgnlRefs>
                <OrgnlMsgId>MSG_ID_20250921_0000000000000000001</OrgnlMsgId>
                <OrgnlMsgNmId>trea.320.001.01</OrgnlMsgNmId>
            </OrgnlRefs>
            <RptgPty>
                <PtyId>
                    <Id>
                        <OrgId>
                            <Othr>
                                <Id>044525593</Id>
                            </Othr>
                        </OrgId>
                    </Id>
                </PtyId>
            </RptgPty>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                </FinInstnId>
            </RegnAgt>
            <Sts>RJCT</Sts>
            <StsRsn>
                <Rsn>
                    <Cd>NARR</Cd>
                </Rsn>
                <AddtlInf>Document/DpstRq/DpstOrdr/DpstDtls/SplmtryData/Envlp/OthrConds/EarlyTrmntn/Allwd mustn't be empty</AddtlInf>
            </StsRsn>
        </GrpSts>
        <PackgSts>
            <PackgId>MSG_ID_20250921_0000000000000000001</PackgId>
            <Sts>RJCT</Sts>
            <StsRsn>
                <Rsn>
                    <Cd>NARR</Cd>
                </Rsn>
                <AddtlInf>Document/DpstRq/DpstOrdr/DpstDtls/SplmtryData/Envlp/OthrConds/EarlyTrmntn/Allwd mustn't be empty</AddtlInf>
            </StsRsn>
            <RcrdSts>
                <RcrdId>MSG_ID_20250921_0000000000000000001</RcrdId>
                <Sts>RJCT</Sts>
                <StsRsn>
                    <Rsn>
                        <Cd>NARR</Cd>
                    </Rsn>
                    <AddtlInf>Document/DpstRq/DpstOrdr/DpstDtls/SplmtryData/Envlp/OthrConds/EarlyTrmntn/Allwd mustn't be empty</AddtlInf>
                </StsRsn>
            </RcrdSts>
        </PackgSts>
    </CcyCtrlStsAdvc>
</Document>

Таблица кодов ответа

Акцепт Оферты

HTTP код Тип Body Описание

200

OK

-

Заявка на размещение депозита принята в обработку.

400

Err

Невалидный номер счёта списания. Поле может содержать номер расчётного счёта из 20 цифр или константу "undefined". Пожалуйста, исправьте значение поля и направьте запрос заново.

400

Err

Некорректно заполнены реквизиты для возврата суммы депозита и процентов по нему. Заполните или тег Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/Acct/Id/Othr/Id, или теги Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/Acct/Id/Othr/Id, Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/ClrSysMmbId/MmbId, Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/Othr/Id и направьте документ заново.

Если текст длиннее 105 символов, передается в нескольких тегах AddtlInf

400

Err

Некорректно заполнены реквизиты для возврата суммы депозита и процентов по нему в другой банк. Заполните теги Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/ClrSysMmbId/MmbId, Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/Othr/Id и направьте документ заново.

Если текст длиннее 105 символов, передается в нескольких тегах AddtlInf

400

Err

Некорректно заполнены реквизиты для возврата суммы депозита и процентов по нему в другой банк. Заполните тег Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/ClrSysMmbId/MmbId и направьте документ заново.

Если текст длиннее 105 символов, передается в нескольких тегах AddtlInf

400

Err

Некорректно заполнены реквизиты для возврата суммы депозита и процентов по нему в другой банк. Заполните тег Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/Othr/Id и направьте документ заново.

Если текст длиннее 105 символов, передается в нескольких тегах AddtlInf

400

Err

Невалидное значение номера счёта для возврата в Альфа-Банк. Номер должен состоять из 20 цифр или принимать значение "undefined" (для фиксированного остатка). Пожалуйста, исправьте значение поля и направьте запрос заново.

Если текст длиннее 105 символов, передается в нескольких тегах AddtlInf

400

Err

Невалидное значение счёта юридического лица в банке получателя. Номер должен состоять из 20 цифр. Пожалуйста, исправьте значение поля и направьте запрос заново.

Если текст длиннее 105 символов, передается в нескольких тегах AddtlInf

400

Err

Некорректно заполнены реквизиты для возврата суммы депозита и процентов по нему в другой банк. Заполните тег Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/Othr/Id и направьте документ заново.

Если текст длиннее 105 символов, передается в нескольких тегах AddtlInf

400

Err

Корсчёт {номер корреспондентского счёта} не принадлежит банку с БИК <номер БИК>. Пожалуйста, исправьте корсчёт банка-получателя и направьте документ заново.

Если текст длиннее 105 символов, передается в нескольких тегах AddtlInf

400

Err

Failed to get company by account number {account_number}

400

Err

XML does not match schema. Please check the document.

Документ не соответствует XSD-схеме или не заполнены обязательные теги.

400

Err

"Документ содержит более одного блока DpstDtls. Разрешен только один блок DpstDtls. Пожалуйста, отправьте каждый блок в отдельном сообщении."

В сообщении передано более одной заявки на размещение депозита.

400

Err

Invalid value for tag Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/Acct/Id/Othr/Id (refund account). The field must be 'undefined' for deposit type FC.

Для депозита типа FC в счете возврата должно быть передано значение undefined.

400

Err

Не заполнены реквизиты для возврата суммы депозита и процентов по нему. Заполните или тег Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/Acct/Id/Othr/Id, или теги Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/Acct/Id/Othr/Id, Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/ClrSysMmbId/MmbId, Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/Othr/Id и направьте документ заново.

Если текст длиннее 105 символов, передается в нескольких тегах AddtlInf

400

Err

XML contains incorrect company details. Please check tags <тег счета> and <тег ИНН> to ensure their correctness.

ИНН организации не соответствует номеру счета.

403

Err

User doesn’t have permissions

У пользователя недостаточно прав для размещения депозита или подписания операции.

403

Err

Number of signatures is not enough for this operation type

Для операции недостаточно подписей.

404

Err

Could not find offer by number <dealNumber>. Please check the number of offer. If it is correct contact your personal manager.

Оферта с указанным номером сделки не найдена.

404

Err

Не найден банк по указанному БИК. Пожалуйста, исправьте реквизиты возврата суммы депозита и проентов по нему и направьте документ заново.

409

Err

DepositMessage with id: <MsgId> already exists.

Документ с таким MsgId был обработан ранее.

409

Err

The details of the offer are not valid. Please submit the offer as it was presented and try again.

Условия заявки отличаются от условий исходной оферты банка.

500

Err

Technical exception. Please call service desk.

Техническая ошибка при обработке запроса, подписи или вызове смежного сервиса.

Статус Сделки

URI

GET: /API/v1/ISO20022/Deposits/{MsgId}

XML схема с Отчетом о заключении Сделки

auth.027.001.01

№ R/
O		 Описание Путь Комментарий/
Пример

Общий путь Document/CcyCtrlStsAdvc/GrpHdr

1

R

Идентификатор сообщения

MsgId

2

R

Дата и время создания сообщения

CreDtTm

3

R

Число элементов в сообщении

NbOfItms

Константа 1

4

O

ИНН организации получателя сообщения

RcvgPty/Id/OrgId/Othr/Id

5

R

SWIFT код банка

RegnAgt/FinInstnId/BICFI

Константа ALFARUMM

6

R

БИК банка

RegnAgt/FinInstnId/ClrSysMmbId/MmbId

Константа 044525593

Общий путь Document/CcyCtrlStsAdvc/GrpSts

7

R

Идентификатор исходного сообщения

OrgnlRefs/OrgnlMsgId

8

R

Тип исходного сообщения

OrgnlRefs/OrgnlMsgNmId

Константа trea.320.001.01

9

R

БИК банка

RptgPty/PtyId/Id/OrgId/Othr/Id

Константа 044525593

10

R

SWIFT код банка

RegnAgt/FinInstnId/BICFI

Константа ALFARUMM

11

R

Статус исходного сообщения

Sts

В разделе Статусы Депозита доступно описание статусов.

12

O

Код причины присвоения статуса сообщения

StsRsn/Rsn/Cd

13

O

Описание причины присвоения статуса сообщения

StsRsn/AddtlInf[1…​n]

Если текст длиннее 105 символов, разбивается на несколько тегов AddtlInf

Общий путь Document/CcyCtrlStsAdvc/PackgSts

14

R

Идентификатор исходного пакета документов

PackgId

15

R

Статус исходного пакета документов

Sts

16

O

Код причины присвоения статуса пакета

StsRsn/Rsn/Cd

17

O

Описание причины присвоения статуса пакета

StsRsn/AddtlInf[1…​n]

Если текст длиннее 105 символов, разбивается на несколько тегов AddtlInf

Общий путь Document/CcyCtrlStsAdvc/PackgSts/RcrdSts

18

R

Идентификатор исходного документа

RcrdId

19

R

Статус исходного документа

Sts

20

O

Код причины присвоения статуса документа

StsRsn/Rsn/Cd

Заполняется только при наличии причины/ошибки. Правила заполнения совпадают с GrpSts/StsRsn/Rsn/Cd

21

O

Описание причины присвоения статуса документа

StsRsn/AddtlInf[1…​n]

Если текст длиннее 105 символов, разбивается на несколько тегов AddtlInf

22

O

Номер сделки

DocId/Id

-

23

O

Дата сделки

DocId/DtOfIsse

Заполняется значением signDate, переведенным в часовой пояс Москвы UTC+3, в формате YYYY-MM-DD

Таблица кодов

Статус сделки

HTTP код Тип Body Описание

200

OK

-

Статус сделки успешно получен.

200

Err

Ошибка в номере счета. Пожалуйста, убедитесь, что счет списания и счет возврата в документе указаны правильно, что они являются действующими расчетными счетами и их валюты соответствует валюте депозита.

200

Err

Некорректно заполнены реквизиты списания и/или возврата депозита. Пожалуйста, исправьте документ и направьте его заново.

200

Err

В реквизитах возврата в другой банк указаны реквизиты Альфа-Банка. Для возврата суммы депозита и процентов по нему на счёт в Альфа-Банке заполните поле для внутреннего счёта. Для фиксированного остатка заполните поле константой "undefined". Направьте исправленный документ заново в банк.

200

Err

Размещение депозита с зачислением средств на депозитный счёт со счёта в другом банке недоступно из-за ограничений ФНС, но вы можете разместить депозит, указав в качестве счёта списания расчётный счёт, открытый в Альфа-Банке.

200

Err

В связи с неисполнением условий сделки No <dealNumber> от <signDate> в части своевременного перечисления денежных средств на депозитный счет No <dealAccountNumber>, уведомляем Вас об отказе от исполнения сделки и закрытии депозитного счета

200

Err

1000001 Недостаточно прав в интернет-банке для работы с документами. Операция невозможна. Пожалуйста, обратитесь к ЕИО компании.

200

Err

1000002 Недостаточно прав в интернет-банке для работы с документами. Операция невозможна. Пожалуйста, обратитесь к персональному менеджеру.

200

Err

1000003 Ваши права в интернет-банке ограничены. Операция невозможна. Пожалуйста, обратитесь к персональному менеджеру.

200

Err

1000004 Ваши права в интернет-банке ограничены. Операция невозможна. Пожалуйста, обратитесь к персональному менеджеру.

200

Err

1000005 Ваши права ограничены в интернет-банке. Операция невозможна. Пожалуйста, обратитесь к ЕИО компании.

200

Err

1000006 Недостаточно прав в интернет-банке для работы с документами. Операция невозможна. Пожалуйста, обратитесь к ЕИО компании.

200

Err

1000007 У пользователя недостаточно прав в интернет-банке для выполнения операции. Операция невозможна. Пожалуйста, обратитесь к ЕИО компании.

200

Err

1000008 Пользователь ранее уже подписал заявку. Размещение депозита невозможно. Обратитесь к персональному менеджеру для получения нового индивидуального предложения.

200

Err

1000009 У пользователя нет прав в интернет-банке на подписание документа. Пожалуйста, обратитесь к ЕИО компании.

200

Err

1000010 Документ уже подписан. Размещение депозита невозможно. Обратитесь к персональному менеджеру для получения нового индивидуального предложения.

200

Err

1000011 Документ уже подписан. Размещение депозита невозможно. Обратитесь к персональному менеджеру для получения нового индивидуального предложения.

200

Err

1000013 Операции по счетам компании временно недоступны в интернет-банке. Направьте в банк письмом копию актуального паспорта и сможете продолжить осуществлять операции не позднее следующего рабочего дня.

200

Err

1000014 Операции по счетам компании временно недоступны в интернет-банке. Направьте в банк письмом копии актуальных документов по организации и сможете продолжить осуществлять операции не позднее следующего рабочего дня. Перечень необходимых документов находится в разделе Письма.

200

Err

1000015 Операция подписания недоступна в связи с истечением срока действия полномочий пользователя в ЛК компании в интернет-банке. Обратитесь в Банк для актуализации сведений.

200

Err

1000018 Нет полномочий в интернет-банке на подписание этого типа документа. Пожалуйста, обратитесь к ЕИО компании.

200

Err

1000019 Нет полномочий в интернет-банке на подписание этого типа документа. Пожалуйста, обратитесь к ЕИО компании.

200

Err

User doesn’t have permissions

У пользователя недостаточно прав в интернет-банке на работу с этим типом документов.

404

Err

Could not find message by id <MsgId>.

По указанному MsgId не найдена запись о сделке.

500

Err

Technical exception. Please call service desk.

Техническая ошибка при обработке запроса или вызове смежного сервиса.

Отчет о заключении Сделки

URI

GET: /API/v1/ISO20022/Deposits/<MsgId>/Report

XML схема с Отчетом о заключении Сделки

trea.320.001.01

№ R/
O		 Описание Путь Комментарий/
Пример

Общий путь Document/DpstRq/GrpHdr

1

R

Уникальный ID сообщения

MsgId

-

2

R

Дата и время создания сообщения

CreDtTm

YYYY-MM-DDThh:mm:ss[.mmm]TZD

3

R

Количество отчетов

NbOfItms

-

4

R

Наименование отправителя

InitgPty/Nm

Константа "АО "АЛЬФА-БАНК"

5

R

ID исходного сообщения

InitgPty/Id/OrgId/Othr/Id

-

Document/DpstRq/DpstOrdr

6

R

Уникальный ID пакета

DpstOrdrId

-

7

R

Наименование организации получателя сообщения

AcctOwnr/Nm

-

8

R

Обозначение российской расчетной системы

AcctSvcr/FinInstnId/ClrSysMmbId/ClrSysId/Cd

Константа "RUCBC"

9

R

БИК банка/отделения обслуживающего счет

AcctSvcr/FinInstnId/ClrSysMmbId/MmbId

Константа "044525593"

10

R

Наименование банка

AcctSvcr/FinInstnId/Nm

Константа "АО "АЛЬФА-БАНК"

Document/DpstRq/DpstOrdr/DpstDtls

11

R

Уникальный ID отчета

DpstDtlsId

-

12

R

Номер заявки

DpstOrdrId/Id

Идентификатор Оферты в Банке

13

O

Тип депозита

DpstTpInf/DpstTp/Cd

CCCB - срочный депозит
CCDS - срочный депозит с возможностью частичного/полного возврата
CCPS - срочный пополняемый депозит с возможностью частичного возврата
CCPL - срочный депозит с возможностью пополнения
FC - фиксированный остаток на счете

14

O

Минимальный остаток на Депозитном счете

DpstTpInf/CtrctAmt/MinAmt

-

15

O

Валюта минимального остатка на Депозитном счете

DpstTpInf/CtrctAmt/MinAmt@Ccy

-

16

O

Максимальная сумма Депозита с учетом всех дополнительных взносов

DpstTpInf/CtrctAmt/MaxAmt

-

17

O

Валюта максимальной суммы Депозита

DpstTpInf/CtrctAmt/MaxAmt@Ccy

-

18

O

Минимальная сумма дополнительного взноса во Вклад

DpstTpInf/AmndmntInf/IncrAmt/MinAmt

-

19

O

Валюта минимальной суммы дополнительного взноса во Вклад

DpstTpInf/AmndmntInf/IncrAmt/MinAmt@Ccy

-

20

O

Сумма процентов к выплате

DpstTpInf/AmndmntInf/IncrAmt/MaxAmt

-

21

O

Валюта суммы процентов к выплате

DpstTpInf/AmndmntInf/IncrAmt/MaxAmt@Ccy

-

22

O

Минимальная сумма частичного возврата Депозита

DpstTpInf/AmndmntInf/DecrAmt/MinAmt

-

23

O

Валюта минимальной суммы частичного возврата

DpstTpInf/AmndmntInf/DecrAmt/MinAmt@Ccy

-

24

O

Текущая сумма Депозита

DpstTpInf/AmndmntInf/DecrAmt/MaxAmt

Для типа депозита "FC" эта сумма = Document/DpstRq/DpstOrdr/DpstDtls/Amt

25

O

Валюта текущей суммы Депозита

DpstTpInf/AmndmntInf/DecrAmt/MaxAmt@Ccy

Для типа депозита "FC" эта сумма = Document/DpstRq/DpstOrdr/DpstDtls/Amt@Ccy

26

O

Статус Депозита

DpstTpInf/AmndmntInf/PrlngInf/Prtry

В разделе Статусы Депозита доступно описание статусов.

27

O

Номер сделки

CtrctRef/Id

-

28

O

Дата подписания

CtrctRef/DtOfIsse

-

29

R

Счет Клиента, с которого переводятся денежные средства в сумме Депозита на Депозитный счет

SrcAcct/Acct/Id/Othr/Id

- Для типа Депозита "FC" указывается "Номер Банковского счета"
- Заполняется константой "undefined", если денежные средства переводятся/переведены на депозитный счет из другого банка.

30

R

Сумма Депозита

Amt

В начале срока
Для типа Депозита "FC" указывается "Сумма Фиксированного остатка"

31

R

Валюта Депозита

Amt@Ccy

Для типа Депозита "FC" указывается "Валюта Фиксированного остатка"

32

R

Дата размещения Депозита

Prd/FrDt

YYYY-MM-DD (часовой пояс Москвы UTC+3)
Для типа Депозита "FC" указывается "Дата начала срока"

33

O

Дата возврата Депозита

Prd/ToDt

YYYY-MM-DD (часовой пояс Москвы UTC+3)
Для типа Депозита "FC" указывается "Дата окончания срока"

34

R

Процентная ставка за пользование Депозитом (% годовых)

IntrstInf/IntrstRate/Fxd

Для типа Депозита "FC" указывается "Процентная ставка за пользование Фиксированным остатком (% годовых)"

35

O

Порядок выплаты процентов

IntrstInf/PmtFrqncy/Prtry

-

36

R

Номер Депозитного счета Клиента

IntrstInf/IntrstAcct/Acct/Id/Othr/Id

Для типа Депозита "FC" указывается константа "undefined"

37

O

Счет Клиента для возврата Депозита и процентов по нему

RtrnAcct/Acct/Id/Othr/Id

Номер расчетного счета в Альфа-Банке. Обязателен, если не заполнен тег Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/Acct/Id/Othr/Id. Один из тегов обязателен к заполнению
Константа "undefined" для типа Депозита "FC".
Заполняется значением на момент заключения сделки.

38

O

Счет юридического лица в банке получателе

RtrnAcct/XtrnAcc/Acct/Id/Othr/Id

Номер расчетного счета, открытого не в Альфа-Банке. Обязателен, если не заполнен тег Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/Acct/Id/Othr/Id. Один из тегов обязателен к заполнению.
Заполняется значением на момент заключения сделки.

39

O

БИК банка получателя

RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/ClrSysMmbId/MmbId

Обязателен при заполнении тега Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/Acct/Id/Othr/Id.
Заполняется значением на момент заключения сделки.

40

O

Корреспондентский счёт банка получателя

RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/Othr/Id

Обязателен при заполнении тега Document/DpstRq/DpstOrdr/DpstDtls/RtrnAcct/XtrnAcc/Acct/Id/Othr/Id.
Заполняется значением на момент заключения сделки.

41

O

Наименование банка получателя*

RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/Nm

Зарезервирован

42

O

Наименование банка получателя*

RtrnAcct/XtrnAcc/AcctSvcr/FinInstnId/PstlAdr/AdrLine[1…​7]

Зарезервирован

43

O

Причина отклонения запроса

Ustrd[1…​5]

-

44

O

Возможность досрочного возврата Депозита

SplmtryData/Envlp/OthrConds/EarlyTrmntn/Allwd

false/true

45

O

Возможность пополнения Депозита

SplmtryData/Envlp/OthrConds/Refill/Allwd

false/true

46

O

Предельная дата внесения дополнительных взносов во Вклад

SplmtryData/Envlp/OthrConds/Refill/Dt

YYYY-MM-DD (часовой пояс Москвы UTC+3)

47

O

Возможность частичного возврата депозита

SplmtryData/Envlp/OthrConds/EarlyRtrn/Allwd

false/true

48

O

Дата начала возможности досрочного возврата Депозита

SplmtryData/Envlp/OthrConds/EarlyRtrn/Dt

YYYY-MM-DD (часовой пояс Москвы UTC+3)

49

O

Возможность возврата депозита в первый месяц

SplmtryData/Envlp/OthrConds/EarlyRtrn/FrstMnth/Allwd

false/true

50

O

Ставка при возврате депозита в первый месяц

SplmtryData/Envlp/OthrConds/EarlyRtrn/FrstMnth/Rt

-

51

O

Срок фактического нахождения средств во вкладе

SplmtryData/Envlp/OthrConds/EarlyRtrn/Rts[1…​n]/PrdTp

"RT01" - от 1 мес. (вкл.) до 2 мес.
"RT02" - от 2 мес. (вкл.) до 3 мес.
"RT03" - от 3 мес. (вкл.) до 4 мес.
"RT04" - от 4 мес. (вкл.) до 5 мес.
"RT05" - от 5 мес. (вкл.) до 6 мес.
"RT06" - от 6 мес. (вкл.) до 7 мес.
"RT07" - от 7 мес. (вкл.) до 8 мес.
"RT08" - от 8 мес. (вкл.) до 9 мес.
"RT09" - от 9 мес. (вкл.) до 10 мес.
"RT10" - от 10 мес. (вкл.) до 11 мес.
"RT11" - от 11 мес. (вкл.) до 12 мес.
"RT12" - от 12 мес. (вкл.) до 18 мес.
"RT18" - от 18 мес. (вкл.) до 24 мес.
"RT24" - от 24 мес. (вкл.) до 36 мес.
"RT36" - от 36 мес. (вкл.) до 48 мес.
"RT48" - от 48 мес. (вкл.) до 60 мес.

52

O

Ставка для досрочного возврата (в %)

SplmtryData/Envlp/OthrConds/EarlyRtrn/Rts[1…​n]/Rt

-

53

O

Условие о выплате процентов при досрочном частичном возврате Депозита

SplmtryData/Envlp/OthrConds/EarlyRtrn/AddtnlConds

-

54

O

Иные условия сделки, согласованные Сторонами

SplmtryData/Envlp/OthrConds/AddtnlConds

-

55

O

Сумма Депозита в конце срока

SplmtryData/Envlp/OthrConds/FnlAmt

-

56

O

Валюта суммы Депозита в конце срока

SplmtryData/Envlp/OthrConds/FnlAmt@Ccy

-

57

O

Наименование продукта

SplmtryData/Envlp/OthrConds/PrdctNm

-
Пример ответа c Отчетом 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:trea.320.001.01">
    <DpstRq>
        <GrpHdr>
            <MsgId>2525a25f56cb45e5adb5530fc75be47d</MsgId>
            <CreDtTm>2025-07-23T17:22:18.757+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Nm>АО "АЛЬФА-БАНК"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>TEST_MSG_2025-07-22-000000000000002</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <DpstOrdr>
            <DpstOrdrId>05b24b688b7f4e5ca4e1d6bbfde82679</DpstOrdrId>
            <AcctOwnr/>
            <AcctSvcr>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                </FinInstnId>
            </AcctSvcr>
            <DpstDtls>
                <DpstDtlsId>140df9592ff349e19a99f595db625d10</DpstDtlsId>
                <DpstOrdrId>
                    <Id>10004312</Id>
                </DpstOrdrId>
                <DpstTpInf>
                    <DpstTp>
                        <Cd>CCPS</Cd>
                    </DpstTp>
                    <CtrctAmt>
                        <MinAmt Ccy="RUB">31500.00</MinAmt>
                        <MaxAmt Ccy="RUB">189000.00</MaxAmt>
                    </CtrctAmt>
                    <AmndmntInf>
                        <IncrAmt>
                            <MinAmt Ccy="RUB">25000.00</MinAmt>
                            <MaxAmt Ccy="RUB">1083.51</MaxAmt>
                        </IncrAmt>
                        <DecrAmt>
                            <MaxAmt Ccy="RUB">63000.00</MaxAmt>
                        </DecrAmt>
                        <PrlngInf>
                            <Prtry>OPEN</Prtry>
                        </PrlngInf>
                    </AmndmntInf>
                </DpstTpInf>
                <CtrctRef>
                    <Id>CB62207250000001</Id>
                </CtrctRef>
                <SrcAcct>
                    <Acct>
                        <Id>
                            <Othr>
                                <Id>40702810200000000083</Id>
                            </Othr>
                        </Id>
                    </Acct>
                </SrcAcct>
                <Amt Ccy="RUB">63000.00</Amt>
                <Prd>
                    <FrDt>2025-07-22</FrDt>
                    <ToDt>2025-10-23</ToDt>
                </Prd>
                <IntrstInf>
                    <IntrstRate>
                        <Fxd>6.75</Fxd>
                    </IntrstRate>
                    <PmtFrqncy>
                        <Prtry>В конце срока</Prtry>
                    </PmtFrqncy>
                    <IntrstAcct>
                        <Acct>
                            <Id>
                                <Othr>
                                    <Id>42104810600000000153</Id>
                                </Othr>
                            </Id>
                        </Acct>
                    </IntrstAcct>
                </IntrstInf>
                <RtrnAcct>
                    <Acct>
                        <Id>
                            <Othr>
                                <Id>40702810200000000083</Id>
                            </Othr>
                        </Id>
                    </Acct>
                </RtrnAcct>
                <SplmtryData>
                    <Envlp>
                        <OthrConds>
                            <EarlyTrmntn>
                                <Allwd>false</Allwd>
                            </EarlyTrmntn>
                            <Refill>
                                <Allwd>true</Allwd>
                                <Dt>2025-09-17</Dt>
                            </Refill>
                            <EarlyRtrn>
                                <Allwd>true</Allwd>
                                <Dt>2025-04-11</Dt>
                            </EarlyRtrn>
                        </OthrConds>
                    </Envlp>
                </SplmtryData>
            </DpstDtls>
        </DpstOrdr>
    </DpstRq>
</Document>
Пример ответа c ошибкой 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:trea.320.001.01">
    <DpstRq>
        <GrpHdr>
            <MsgId>991df0195ae54c2c964e6b4cdedfb13a</MsgId>
            <CreDtTm>2025-07-25T00:10:59.163+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <InitgPty>
                <Nm>АО "АЛЬФА-БАНК"</Nm>
                <Id>
                    <OrgId>
                        <Othr>
                            <Id>TEST_MSG_2025-07-11-170629034</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <DpstOrdr>
            <DpstOrdrId>6c67ae3f23434cd59a290c83d1562afc</DpstOrdrId>
            <AcctOwnr/>
            <AcctSvcr>
                <FinInstnId>
                    <ClrSysMmbId>
                        <ClrSysId>
                            <Cd>RUCBC</Cd>
                        </ClrSysId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                    <Nm>АО "АЛЬФА-БАНК"</Nm>
                </FinInstnId>
            </AcctSvcr>
            <DpstDtls>
                <DpstDtlsId>5b8dafee5aeb4aa595c14ec5be264ee3</DpstDtlsId>
                <DpstOrdrId>
                    <Id>0</Id>
                </DpstOrdrId>
                <SrcAcct>
                    <Acct>
                        <Id>
                            <Othr>
                                <Id>undefined</Id>
                            </Othr>
                        </Id>
                    </Acct>
                </SrcAcct>
                <Amt Ccy="RUB">0</Amt>
                <Prd>
                    <FrDt>2025-07-25</FrDt>
                </Prd>
                <IntrstInf>
                    <IntrstRate>
                        <Fxd>0</Fxd>
                    </IntrstRate>
                </IntrstInf>
                <Ustrd>Нельзя сформировать ЭД "Отчет о заключении Сделки". Пожалуйста, проверьте статус сделки TraceId: 19b1819edd6685cdf43a0d86d1ff0f95</Ustrd>
            </DpstDtls>
        </DpstOrdr>
    </DpstRq>
</Document>

Таблица кодов ответа

Отчет о заключении Сделки

HTTP код Тип Body Описание

200

OK

-

Отчет о заключении сделки успешно сформирован.

200

Err

Нельзя сформировать ЭД "Отчет о заключении Сделки". Пожалуйста, проверьте статус сделки.

Отчет нельзя сформировать, если заявка была отклонена или статус сделки не позволяет выдачу отчета.

200

Err

Нельзя сформировать ЭД "Отчет о заключении Сделки". Пожалуйста, повторите запрос позже или обратитесь к персональному менеджеру для уточнения статуса Депозита.

403

Err

У пользователя недостаточно прав в интернет-банке на работу с этим типом документов.

404

Err

Could not find deal for document with id <MsgId>.

500

Err

Technical exception. Please call service desk.

Техническая ошибка при обработке запроса или вызове смежного сервиса.

32. Работа с вложенными файлами

URI

Работа с вложенными файлами может производиться для документов:
- Письма
- Сведения о валютных операциях (СВО)
- Справки о подтверждающих документах (СПД)
- Постановка на учет внешнеторгового контракта (УНК)
- Внесение изменений в I раздел ВБК (переоформление УНК)
- Снятие внешнеторгового контракта с учета

Максимальная длина наименования вложенного файла — 100 символов. Допустимые символы: латинские/кириллица, цифры, пробел и специальные символы: . - _ @ ! [ ] { } ( )

Отправка вложенных файлов вместе с документом (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>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>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 - название подписываемого файла

33. Печатные формы

Где искать примеры печатных форм?

Все примеры печатных форм можно найти в папке 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

Internal Error

Внутренняя ошибка приложения

500

Warrant service error

Сервис проверки доверенности не отвечает

502

Bad Gateway

Ошибочный шлюз

503

Service Unavailable

Сервис недоступен

504

Gateway Timeout

Шлюз не отвечает

34. Статусы

Статусы по валютным переводам, платёжным поручениям и РСТС

Схема 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 Альфа-Банка

Пример:
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[1…​n]

Для платежей в статус ACSP, которые прошли проверки и успешно был отправлены на исполнение может возвращаться набор тэгов AddtlInf, внутри которых содержится расширенное текстовое описание этапа обработки платежа.

11

O

Идентификатор исходного пакета ВП/ПП

OrgnlPmtInfId

Document.CstmrCdtTrfInitn.
PmtInf.PmtInfId

12

O

Статус исходного пакета ВП/ПП:
RCVD - Получено;
RJCT - Отклонено;
ACSP - Принято к исполнению;
PART - Принято, подтверждена часть поручений;
ACSC - Исполнено.

PmtInfSts

-

13

О

Код причины присвоения статуса пакета ВП/ПП

StsRsnInf.Rsn.Cd

-

14

O

Описание причины присвоения статуса пакета ВП/ПП

StsRsnInf.AddtlInf[1…​n]

-

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[1…​n]

-

20

O

Дата и время присвоения статуса

TxInfAndSts.AccptncDtTm

-
Пример статуса ПП 
<?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>8fd7097caa2847d5be56e2f79a0c8479</MsgId>
            <CreDtTm>2025-12-05T18:04:14.199+03:00</CreDtTm>
            <InitgPty>
                <Id>
                    <OrgId>
                        <AnyBIC>ALFARUMM</AnyBIC>
                        <Othr>
                            <Id>044525593</Id>
                        </Othr>
                    </OrgId>
                </Id>
            </InitgPty>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>50f65bc825ae466088acde5fbd6d1f9f</OrgnlMsgId>
            <OrgnlMsgNmId>pain.001.001.06</OrgnlMsgNmId>
            <OrgnlCreDtTm>2025-12-05T16:35:07.470+03:00</OrgnlCreDtTm>
            <GrpSts>ACSP</GrpSts>
        </OrgnlGrpInfAndSts>
        <OrgnlPmtInfAndSts>
            <OrgnlPmtInfId>f009e929e7d55b7896a7d999d15d66fb</OrgnlPmtInfId>
            <PmtInfSts>ACSP</PmtInfSts>
            <TxInfAndSts>
                <OrgnlInstrId>a61a9971cf4b5ccd977b3e775027bb4f</OrgnlInstrId>
                <TxSts>ACSP</TxSts>
                <StsRsnInf>
                    <AddtlInf>Платёж на проверке у валютного контролера. После успешной проверки, отправим не позднее следующего рабоче</AddtlInf>
                    <AddtlInf>го дня.</AddtlInf>
                </StsRsnInf>
                <AccptncDtTm>2025-12-05T16:35:15.378+03:00</AccptncDtTm>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>

Статусы по Зарплатным ведомостям

Схема XML-документа

pain.002.001.06

Описание схемы

№ 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[1…​n]

-

8

O

Идентификатор исходного пакета с ведомостью

OrgnlPmtInfAndSts.OrgnlPmtInfId

-

9

О

Статус исходного пакета с ведомостью

OrgnlPmtInfAndSts.PmtInfSts

Описание статусов в таблице Статусы ведомости

10

О

Описание причины присвоения статуса пакета с ведомостью

OrgnlPmtInfAndSts.StsRsnInf.AddtlInf[1…​n]

Описание ошибки при обработке ведомости или одно из значений таблицы Статусы ведомости. Может содержать несколько элементов AddtlInf для длинного текста.

11

O

Номер начисления в ведомости

OrgnlPmtInfAndSts.TxInfAndSts.OrgnlInstrId

-

12

O

Статус начисления

OrgnlPmtInfAndSts.TxInfAndSts.TxSts

Описание статусов в таблице Статусы начислений

13

O

Описание кода причины присвоения статуса начисления

OrgnlPmtInfAndSts.TxInfAndSts.StsRsnInf.AddtlInf[1…​n]

-

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>2024-03-15T16:13:24.665+03:00</CreDtTm>
        </GrpHdr>
        <OrgnlGrpInfAndSts>
            <OrgnlMsgId>7421w6f13a01983593e8dffb71fa6d15</OrgnlMsgId>
            <OrgnlMsgNmId>pain.008.001.05</OrgnlMsgNmId>
            <OrgnlCreDtTm>2024-03-15T16:11:20.665+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>2024-03-15T16:11:20.665+03:00</AccptncDtTm>
            </TxInfAndSts>
            <TxInfAndSts>
                <OrgnlInstrId>7421w6f13a01983593e8dffb71fa6d16</OrgnlInstrId>
                <TxSts>ACSP</TxSts>
                <AccptncDtTm>2024-03-15T16:11:20.665+03:00</AccptncDtTm>
            </TxInfAndSts>
        </OrgnlPmtInfAndSts>
    </CstmrPmtStsRpt>
</Document>

Статусы по открытию лицевых счетов

Схема XML-документа

acmt.014.001.04

Описание схемы

№ 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

Константа '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

Описание статусов в таблице Статусы открытия ЛС

22

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_2023-03-16-1716303</Id>
				<CreDtTm>2023-03-16T17:16:30.307+03:00</CreDtTm>
			</MsgId>
			<PrcId>
				<Id>30307</Id>
				<CreDtTm>2023-03-16T17:16:30.307+03:00</CreDtTm>
			</PrcId>
			<Sts>RCVD</Sts>
		</Refs>
		<Fr>
			<Othr>
				<Id>TEST_MSG_2023-03-16-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>
Пример ответа с ошибкой Заявки на открытие ЛС 
<?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>envelope_id:1234567789</Id>
                <CreDtTm>2026-01-23T11:33:22.425+03:00</CreDtTm>
            </MsgId>
            <PrcId>
                <Id>time_id:1769157202449</Id>
                <CreDtTm>2026-01-23T11:33:22.449+03:00</CreDtTm>
            </PrcId>
            <Sts>RJCT</Sts>
            <AttchdDocNm>; lineNumber: 14; columnNumber: 28; cvc-pattern-valid: Value 'RUB1' is</AttchdDocNm>
            <AttchdDocNm> not facet-valid with respect to pattern '[A-Z]{3,3}' for type 'Active</AttchdDocNm>
            <AttchdDocNm>CurrencyCode'.
; lineNumber: 14; columnNumber: 28; cvc-type.3.1.3: The</AttchdDocNm>
            <AttchdDocNm> value 'RUB1' of element 'Ccy' is not valid.
</AttchdDocNm>
        </Refs>
        <Fr>
            <Othr>
                <Id>envelope_id:1234567789</Id>
            </Othr>
        </Fr>
        <AcctSvcrId>
            <FinInstnId/>
        </AcctSvcrId>
        <Org>
            <FullLglNm>undefined</FullLglNm>
            <CtryOfOpr>RU</CtryOfOpr>
            <LglAdr/>
            <OrgId/>
        </Org>
    </AcctRpt>
</Document>

Статусы по документам валютного контроля (СВО, СПД, УНК)

Схема XML-документа

auth.027.001.01

Описание схемы

№ R/
O		 Описание Путь Комментарий/
Пример

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[1…​n]

-

Document.CcyCtrlStsAdvc.PackgSts

17

О

Идентификатор исходного пакета документов

PackgId

-

18

О

Статус исходного пакета документов

Sts

см. таблицу "Статус исходного документа"

19

O

Код причины присвоения статуса пакета документов

StsRsn.Rsn.Cd

-

20

O

Описание причины присвоения статуса пакета документов

StsRsn.AddtlInf[1…​n]

-

Document.CcyCtrlStsAdvc.PackgSts.RcrdSts

21

О

Идентификатор исходного документа

RcrdId

-

22

О

Статус исходной документа

Sts

-

23

O

Код причины присвоения статуса документа

StsRsn.Rsn.Cd

Константа 'NARR'

24

O

Описание пункта 138-И, согласно которому отклонен документа

VldtnRule.Desc

-

25

O

Описание причины присвоения статуса документа

StsRsn.AddtlInf[1…​n]

-

Статус исходного сообщения

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

Отклонен

Статусы по Ведомости банковского контроля

Схема XML-документа

auth.027.001.01

Описание схемы ответа

№ R/
O		 Описание Путь Комментарий/
Пример

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[1…​n]

-

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[1…​n]

-

Статусы Ведомости банковского контроля

Передается в Document.GrpSts.Sts схемы auth.027.001.01

№ ISO статус всего запроса Описание Комментарий ISO статус записи с УНК Комментарий

1

RCVD

Получено

Запрос на формирование архива со списком ВБК получен

RCVD

Запрос на формирование файла ВБК принят в получен

2

ACTC

Технические проверки пройдены, запрос принят в обработку

Запрос принят в обработку

ACTC

Запись УНК принята в обработку

3

PDNG

Начало формирования архива ВБК

По списку УНК были сформированы файлы ВБК

RJCT

Не сформирован файл ВБК по УНК, либо при формировании произошла ошибка

PDNG

По УНК был сформирован файл ВБК

4

ACPT

Архив успешно сформирован

По всем УНК были сформированы файлы ВБК и добавлены в архив для скачивания

ACPT (каждая запись находится в статусе ACPT)

По каждой записи с УНК была сформирована ВБК и добавлена в архив

5

PART

Архив частично сформирован

В архив добавлен хотя бы один файл ВБК

ACPT/RJCT (хотя бы одна запись находится в статусе ACPT)

Хотя бы по одной записи с УНК из списка была успешно сформирована ВБК и добавлена в архив

6

RJCT

Отклонено

Запрос не прошел проверку на соответствие схеме/в процессе обработки произошла ошибка/невалидные реквизиты компании

RJCT (все записи находятся в статусе RJCT)

хотя бы один УНК невалиден/снят с учета, либо не принадлежит компании

Статусы по Депозитам

Схема XML-документа

auth.027.001.01

Описание схемы ответа

№ R/
O		 Описание Путь Комментарий/
Пример

Document.CcyCtrlStsAdvc.GrpHdr

1

R

Уникальный ID сообщения

MsgId

-

2

R

Дата и время создания сообщения

CreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD

3

R

Число элементов в сообщении

NbOfItms

-

4

R

ИНН организации получателя сообщения

RcvgPty/Id/OrgId/Othr/Id

-

5

R

SWIFT код банка

RegnAgt/FinInstnId/BICFI

Константа "ALFARUMM"

6

R

БИК Банка

RegnAgt/FinInstnId/ClrSysMmbId/MmbId

Константа "044525593"

Document.CcyCtrlStsAdvc.GrpSts

7

R

ID исходного сообщения

OrgnlRefs/OrgnlMsgId

-

8

R

Тип исходного сообщения

OrgnlRefs/OrgnlMsgNmId

Константа "trea.320.001.01"

9

R

Время создания исходного сообщения

OrgnlRefs/OrgnlCreDtTm

Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD

10

R

БИК Банка

RptgPty/PtyId/Id/OrgId/Othr/Id

Константа '044525593'

11

R

SWIFT код банка

RegnAgt/FinInstnId/BICFI

Константа "ALFARUMM"

12

R

Статус исходного сообщения

Sts

См. таблицу Статусы Депозита

13

O

Код причины присвоения статуса пакета документов

StsRsn/Rsn/Cd

-

14

O

Описание причины присвоения статуса пакета документов

StsRsn/AddtlInf[1…​n]

-

Document/CcyCtrlStsAdvc/PackgSts

15

R

ID исходного пакета документов

PackgId

-

16

R

Статус исходного пакета документов

Sts

Дублирует Document.CcyCtrlStsAdvc.GrpSts.Sts. См. таблицу Статусы Депозита

17

O

Код причины присвоения статуса пакета документов

StsRsn/Rsn/Cd

Дублирует Document.CcyCtrlStsAdvc.GrpSts.StsRsn.Rsn.Cd

18

O

Описание причины присвоения статуса пакета документов

StsRsn/AddtlInf[1…​n]

Дублирует Document.CcyCtrlStsAdvc.GrpSts.StsRsn.AddtlInf[1…​n]

Document/CcyCtrlStsAdvc/PackgSts/RcrdSts

19

R

ID исходного документа

RcrdId

-

20

R

Статус исходного документа

Sts

Дублирует Document.CcyCtrlStsAdvc.GrpSts.Sts. См. таблицу Статусы Депозита

21

O

Код причины присвоения статуса документа

StsRsn/Rsn/Cd

Дублирует Document.CcyCtrlStsAdvc.GrpSts.StsRsn.Rsn.Cd

22

O

Описание причины присвоения статуса документа

StsRsn/AddtlInf[1…​n]

Дублирует Document.CcyCtrlStsAdvc.GrpSts.StsRsn.AddtlInf[1…​n]

23

O

Номер сделки

DocId/Id

-

24

O

Дата сделки

DocId/DtOfIsse

-

Статусы Депозита

Передается в Document.GrpSts.Sts схемы auth.027.001.01

ISO статус Описание

RCVD

Заявка принята

PDNG

В процессе

ACTC

Заявка прошла технические и бизнес проверки

ACPT

Заявка исполнена

RJCT

Отклонено

35. Электронная подпись

Электронная Подпись формируется с использованием алгоритма ГОСТ Р 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>
                        <!-- Код основания налогового платежа (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>
                    </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>
                    </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>
                    </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>
                    </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>
                    </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>
                    </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>

Получение тестовых сертификатов

Для тестирования настоятельно рекомендуется использовать сертификаты из папки certificates архива данной документации.

Если есть причина, по которой требуется использование собственных сертификатов, то ниже вы найдете инструкцию по выпуску самоподписанных сертификатов на MacOs.

Для выпуска самоподписанных тестовых сертификатов на MacOs необходимо:

  • Выполнить в терминале:

brew install openssl
brew install cmake
brew install git
git clone https://github.com/gost-engine/engine
cd engine
git submodule update --init
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release .. -DOPENSSL_ENGINES_DIR=/usr/local/opt/openssl@3/lib/engines-3
cmake --build . --target install --config Release

  • Проверить что появился файл "gost.dylib" командой

ls -l /usr/local/opt/openssl@3/lib/engines-3/

  • Добавить в файле /usr/local/etc/openssl@3/openssl.cnf строку openssl_conf = openssl_def :

    1. если openssl_conf = openssl_init есть, то после этой строки

    2. если openssl_conf = openssl_init нет, то в начало файла

  • В конец файла добавить следующие 3 раздела:

[openssl_def]
engines = engine_section

[engine_section]
gost = gost_section

[gost_section]
engine_id = gost
dynamic_path = /usr/local/opt/openssl@3/lib/engines-3/gost.dylib
default_algorithms = ALL
CRYPT_PARAMS = id-Gost28147-89-CryptoPro-A-ParamSet

/usr/local/opt/openssl@3/lib/engines-3/gost.dylib - это путь до библиотеки сформированной выше

  • Сохранить файл

Если есть уже ранее установленные версии openssl, то необходимо обращаться именно к /usr/local/opt/openssl@3/bin/openssl. Иначе может быть обращение к иной утилите "openssl" из-за чего может возникнуть ошибка "файл не найден".

  • Переоткрыть терминал

  • Сгенерировать ключ

Расширение на выбор: pem/key/crt

openssl req -x509 -nodes -days 365 -newkey gost2012_256 -pkeyopt paramset:A -keyout privateKey.key -out certificate.crt

  • Заполнить все поля (используются латинские буквы):

    1. Country Name (2 letter code) [AU]: - Страна, в виде двухсимвольного ISO-кода. Для России: RU.

    2. State or Province Name (full name) [Some-State]: - Область, в которой официально зарегистрирована организация

    3. Locality Name (eg, city) []: - город, где официально зарегистрирована организация

    4. Organization Name (eg, company) [Internet Widgits Pty Ltd]: - Наименование организации в соответствии с Уставом организации

    5. Organizational Unit Name (eg, section) []: - Наименование отдела/подразделения

    6. Common Name (e.g. server FQDN or YOUR name) []: - ФИО сотрудника на которого выпускается сертификат

    7. Email Address []: - эл.почта сотрудника, на которого выпускается сертификат

  • Собрать файл pkcs12 либо pfx

openssl pkcs12 -export -in certificate.crt -inkey privateKey.key \
-out privateKey.p12 -name privateKey \
-CAfile ca.crt -caname root

Отправить открытый ключ (файл формата .crt/.cer) в архиве .zip на адрес ASedov@alfabank.ru с темой «Подключение к тестовому стенду Host-to-Host»

36. МЧД

МЧД (машиночитаемая доверенность) - это доверенность в электронном виде, которую руководитель компании выпускает на сотрудников для передачи части полномочий.

МЧД необходима, когда представитель юридического лица или ИП (чаще всего это сотрудник организации) подписывает документы/операции от имени ЮЛ/ИП с помощью УКЭП, выпущенной на физлицо аккредитованным удостоверяющим центром.

Рекомендации по работе с МЧД

Выпустить МЧД можно в любом сервисе по созданию МЧД, интегрированном с Распределенным реестром ФНС:

  • На сайте ФНС https://m4d.nalog.gov.ru/emchd/create

  • Астрал.Доверенность

  • Контур.Доверенность

  • ITCOM сервис управления машиночитаемыми доверенностями

  • Таском-МЧД
    и т.д.

Инструкция по выпуску МЧД

  1. Выберите Единую форму доверенности (формат 003)

  2. Заполните сведения о доверителе, сведения о представителе. МЧД должна быть с одним доверителем и с одним представителем

  3. МЧД должна быть выпущена руководителем компании, то есть выдана не в порядке передоверия

  4. Выберите из единого классификатора полномочий (Минцифры России) необходимые коды полномочий по таблице ниже. Вы можете не ограничиваться ими и добавить другие под ваши задачи

  5. Разместите МЧД в Распределенном реестре ФНС

После регистрации МЧД в Распределенном реестре ФНС направьте МЧД в формате .xml и .pdf на адрес alfa-link@alfabank.ru или через интернет-банк Альфа-бизнес в составе письма (категория «Прочее», подкатегория «Подключение к Альфа-Линк (1С:Директбанк, Host-to-Host)»), тема письма «МЧД»).

При проверке МЧД проверяется код полномочия из классификатора ЕСНСИ

Документ Код полномочия

Запрос на формирование выписки
Онлайн остаток
Платёжное поручение
Валютный перевод
Отзыв платежа
СБП Платежи для B2B и B2C

BBDOCS_CNTRCT_ACCNT_BACCNT_DOCSBACCNT1
или
BBDOCS_DOCS_DCSALL_SRCDOC_SOURCEDOCS30

Поручение на конверсию/покупку-продажу валюты

BBDOCS_CNTRCT_SALE_CURRNC_CNTRCTCURRNC2
BBDOCS_CNTRCT_SALE_CURRNC_CNTRCTCURRNC1

Отправка письма в Банк
Запрос списка входящих писем

BBDOCS_DOCS_DCSALL_DCSYES_DOCSYES2
или
BBDOCS_DOCS_DCSALL_DCSYES_DOCSYES6

Поручение на конвертацию валют
Поручение на покупку валюты
Поручение на продажу валюты

BBDOCS_CNTRCT_SALE_CURRNC_CNTRCTCURRNC1
или
BBDOCS_CNTRCT_SALE_CURRNC_CNTRCTCURRNC2

Зарплатная ведомость
Заявка на открытие лицевых счетов

BBDOCS_CNTRCT_SRVC_BANK_DOCSBANK1

Получение оферты
Акцепт оферты

BBDOCS_CNTRCT_DPST_SVNGS_DOCSSVNGS1
BBDOCS_CNTRCT_DPST_SVNGS_DOCSSVNGSGENERAL

Постановка на учет внешнеторгового контракта (УНК)
Внесение изменений в I раздел ВБК (переоформление УНК)
Снятие контракта с учета
Сведения о валютных операциях
Корректирующие СВО
Справка о подтверждающих документах
Распоряжение о списании средств с транзитного валютного счёта (РСТС)
Ведомость банковского контроля

BBDOCS_CNTRCT_SRVC_BANK_DOCSBANKGENERAL
Пример МЧД с полномочиями 
<?xml version="1.0" encoding="UTF-8"?>
<Доверенность xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" ВерсФорм="EMCHD_1" ПрЭлФорм="00000000" ИдФайл="ON_EMCHD_20240306_c79ef321-7ce9-43c7-a79a-79307f58d9dc" xmlns="urn://x-artefacts/EMCHD_1">
  <Документ>
    <Довер>
      <СвДов ВидДовер="1" ПрПередов="1" ВнНомДовер="123" НомДовер="c79ef321-7ce9-43c7-a79a-79307f58d9dc" ДатаВыдДовер="2024-03-15" СрокДейст="2028-10-07">
        <СведСист>https://m4d.gnivc.ru/emchd/check-status?guid=c79ef321-7ce9-43c7-a79a-79307f58d9dc</СведСист>
      </СвДов>
      <СвДоверит ТипДоверит="1">
        <Доверит>
          <РосОргДовер ЕИОУК="1" ЕИОФЛ="0" ЕИОИП="0">
            <СвРосОрг НаимОрг="ООО &quot;ТЕСТ АЛЬФА-ЛИНК&quot;" ИННЮЛ="7013602245" КПП="215045470" ОГРН="7108420229262">
              <АдрРег Регион="77">
                <АдрРФ>Москва ул. Московская 1</АдрРФ>
              </АдрРег>
            </СвРосОрг>
            <ЛицоБезДов ПолнЮЛ="1">
              <СВЮЛ>
                <СвЮЛЕИО НаимОрг="ООО &quot;ТЕСТ АЛЬФА-ЛИНК&quot;" ИННЮЛ="7013602245" КПП="215045470" ОГРН="7108420229262">
                  <АдрРег Регион="77">
                    <АдрРФ>Москва ул. Московская 1</АдрРФ>
                  </АдрРег>
                </СвЮЛЕИО>
                <СвФЛ ИННФЛ="236509761589" СНИЛС="563-539-822 23" Должность="Директор">
                  <СведФЛ>
                    <ФИО Фамилия="ИВАНОВ" Имя="ИВАН" Отчество="ИВАНОВИЧ" />
                  </СведФЛ>
                </СвФЛ>
              </СВЮЛ>
            </ЛицоБезДов>
          </РосОргДовер>
        </Доверит>
      </СвДоверит>
      <СвУпПред ТипПред="3">
        <Пред>
          <СведФизЛ ИННФЛ="758485759556" СНИЛС="578-438-022 32">
            <СведФЛ ДатаРожд="1995-10-15">
              <ФИО Фамилия="ПЕТРОВ" Имя="ПЕТР" Отчество="ПЕТРОВИЧ" />
              <УдЛичнФЛ КодВидДок="21" СерНомДок="45 22 657213" ДатаДок="2018-11-11" ВыдДок="МВД по ЮАО" КодВыдДок="770-770" />
            </СведФЛ>
          </СведФизЛ>
        </Пред>
      </СвУпПред>
      <СвПолн ТипПолн="1" ПрСовмПолн="1">
        <МашПолн КодПолн="BBDOCS_CNTRCT_SALE_CURRNC_CNTRCTCURRNC2" НаимПолн="Заключать и подписывать договоры покупки иностранной валюты" />
        <МашПолн КодПолн="BBDOCS_DOCS_DCSALL_SRCDOC_SOURCEDOCS30" НаимПолн="Подписывать расчетные документы" />
        <МашПолн КодПолн="BBDOCS_CNTRCT_ACCNT_BACCNT_DOCSBACCNT1" НаимПолн="Распоряжаться денежными средствами на банковских счетах" />
        <МашПолн КодПолн="BBDOCS_CNTRCT_SALE_CURRNC_CNTRCTCURRNC1" НаимПолн="Заключать и подписывать договоры на продажу иностранной валюты" />
        <МашПолн КодПолн="BBDOCS_CNTRCT_SRVC_BANK_DOCSBANK1" НаимПолн="Заключать, изменять, расторгать договоры на оказание услуг в рамках зарплатного/социального проекта, а также подписывать иные документы в рамках данных договоров" />
        <МашПолн КодПолн="BBDOCS_DOCS_DCSALL_DCSYES_DOCSYES6" НаимПолн="Подписывать, направлять и получать письма" />
        <МашПолн КодПолн="BBDOCS_DOCS_DCSALL_DCSYES_DOCSYES2" НаимПолн="Подписывать, направлять и получать корреспонденцию" />
        <МашПолн КодПолн="BBDOCS_CNTRCT_SRVC_BANK_DOCSBANKGENERAL" НаимПолн="Подписывать документы, связанные с исполнением/неисполнением обязательств по договорам банковских услуг" />
      </СвПолн>
    </Довер>
  </Документ>
</Доверенность>

Возможные ошибки при проверке МЧД

HTTP код Ошибка Описание

403

Signer does not have active POA

У пользователя нет активных МЧД
Пример ошибки "Signer does not have active POA" 
<?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>aba1f2d7e92544f89d3a25e50dbd6515</MsgId>
            <CreDtTm>2024-03-07T10:04:17.096+03:00</CreDtTm>
            <NbOfItms>1</NbOfItms>
            <RcvgPty/>
            <RegnAgt>
                <FinInstnId>
                    <BICFI>ALFARUMM</BICFI>
                    <ClrSysMmbId>
                        <MmbId>044525593</MmbId>
                    </ClrSysMmbId>
                </FinInstnId>
            </RegnAgt>
        </GrpHdr>
        <GrpSts>
            <OrgnlRefs>
                <OrgnlMsgId>323342342342342</OrgnlMsgId>
                <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
                <OrgnlCreDtTm>2024-03-07T10:04:17.086+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>
            <StsRsn>
                <Rsn>
                    <Cd>NARR</Cd>
                </Rsn>
                <AddtlInf>Signer does not have active POA</AddtlInf>
            </StsRsn>
        </GrpSts>
    </CcyCtrlStsAdvc>
</Document>

37. FAQ

Вопрос Решение

При запросе статуса документа текст в теге AddtInf имеет неправильную кодировку.

Необходимо отправлять запрос, явно указывая кодировку UTF-8. Например, при тестировании в SOAPUI необходимо в properties указать Encoding=UTF-8.

Ответы на запросы платежей и выписок от банка должны приходить подписанными.

Необходимо добавить в запрос хедер sign = true.

Какой сертификат нужно отправить для подключения к Альфа-Линк?

Для использования в промышленной среде подходят сертификаты, которые используются, например, для сдачи отчетности в налоговую. Сертификат должен быть выпущен на уполномоченное лицо, которое подключается к Альфа-линк. Если сертификата нет, то его можно выпустить в любом аккредитованном удостоверяющем центре. Предоставление сертификатов УКЭП (алгоритм подписи ГОСТ-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" и т.д.

38. ChangeLog

Текущая версия: V1.39

V 1.39 (30.04.2026)

  • Добавлен запрос списка оферт без подписи.

  • Добавлены ошибки при работе с депозитными документами.

  • Обновлен файл с корневыми сертификатами УЦ.

  • Добавлен актуальный список отзыва сертификатов.

V 1.38 (03.04.2026)

  • Добавлены тексты ошибок в раздел "Депозиты".

  • Добавлены теги в документ "Отчет о заключении сделки".

  • Изменено описание заполнения поля Код налогового периода (107) согласно приказу Минфина России от 16.05.2025 № 58н

V 1.37 (10.03.2026)

  • Установлено ограничение на символы в наименовании вложенных файлов.

  • Добавлены идентификаторы тестовых компаний для тестирования без расчетного счета.

  • Добавлена возможность работать с депозитами без расчётного счёта.

  • Добавлено размещение депозита с переводом из другого банка.

  • Добавлены реквизиты для возврата суммы депозита и процентов по нему в другой банк.

V 1.36 (09.02.2026)

  • Обновлены тестовые данные.

  • Обновлен файл с корневыми сертификатами УЦ.

  • Добавлен актуальный список отзыва сертификатов.

  • Добавлен пример ответа с ошибкой при открытии счета сотруднику.

V 1.35 (30.12.2025)

  • Добавлены теги в документы "СПД".

  • Номер счета для "СВО" теперь необязательный.

  • Добавлен тег для создания и изменения "Контракта".

  • Обновлены сертификаты пользователей и УЦ.

  • Добавлена информация об "Идентификаторе Клиента в Банке" для компаний, у которых нет расчетного счета в Банке для ЗП документов.

V 1.34 (28.10.2025)

  • Добавлены теги в документы "Получение оферты" и "Акцепт оферты".

  • В документах для работы с депозитами обновлен формат даты.

  • В коллекцию postman добавлены вызовы для работы с документами по зарплатному проекту.

V 1.33 (23.09.2025)

  • Добавлены новые типы документов "Статус Сделки" и "Отчет о заключении Сделки".

  • Обновлены документы "Получение Оферты", "Акцепт Оферты", список ошибок.

  • В Депозиты добавлен новый тип - Фиксированный остаток.

  • Изменена обязательность тегов в блоке с остатками в выписке.

  • Добавлено уточнение по используемому протоколу обмена.

  • Уточнены условия заполнения тегов в поручениях на конвертацию/продажу/покупку валют, РСТС.

  • Добавлены коды видов зачислений в зарплатной ведомости.

  • Обновлены тестовые данные.

  • Обновлена коллекция postman.

  • Обновлен файл с корневыми сертификатами УЦ.

  • Добавлен актуальный список отзыва сертификатов.

V 1.32 (19.05.2025)

  • Добавлен раздел Депозиты (получение и размещение Оферты).

  • Добавлены коды МЧД для работы с депозитами.

  • Обновлена коллекция postman.

  • Добавлено описание тега <RltdDt> в выписке.

  • Обновлены тестовые данные.

  • Обновлен файл с корневыми сертификатами УЦ.

  • Добавлен актуальный список отзыва сертификатов.

V 1.31 (01.04.2025)

  • Изменено ограничение размера входящих писем.

  • Изменены условия обязательности заполнения полей для документов на конвертацию валюты.

  • Изменен контакт для тестирования со стороны банка.

  • Обновлен файл с корневыми сертификатами УЦ.

  • Добавлен актуальный список отзыва сертификатов.

V 1.30 (17.02.2025)

  • Обновлены тестовые данные.

  • Обновлен файл с корневыми сертификатами УЦ.

  • Добавлен актуальный список отзыва сертификатов.

V 1.29 (16.12.2024)

  • Добавлены коды полномочий на обмен валют для МЧД.

  • Обновлен файл с корневыми сертификатами УЦ.

  • Добавлен актуальный список отзыва сертификатов.

V 1.28 (20.11.2024)

  • Добавлены запросы без подписи в коллекцию postman.

  • Добавлено ограничение на длину наименования вложенного файла.

  • Обновлены тестовые данные.

  • Обновлен файл с корневыми сертификатами УЦ.

  • Добавлен актуальный список отзыва сертификатов.

V 1.27 (23.10.2024)

  • Актуализирована информация о МЧД.

  • Обновлены тестовые данные.

  • Выпущены новые тестовые сертификаты.

  • Обновлен файл с корневыми сертификатами УЦ.

  • Добавлен актуальный список отзыва сертификатов.

V 1.26 (19.07.2024)

  • Добавлено описание СБП платежей для B2B.

  • Добавлено описание СБП платежей для B2C.

  • Добавлено поле LetterNumber в список писем.

V 1.25 (15.04.2024)

  • Добавлено ограничение по максимальному периоду запроса выписки.

  • Добавлена новая категория письма "Копии документов из досье ВК".

  • Добавлена информация по работе с МЧД.

  • Добавлен необязательный тег "ИНН организации" для запроса выписки и онлайн остатка.

  • Обновлен файл с корневыми сертификатами УЦ Альфа-Банка.

  • Обновлены тестовые данные.

V 1.24 (31.01.2024)

  • Добавлена новая категория письма "Исполнительные документы".

  • Обновлен файл с корневыми сертификатами УЦ Альфа-Банка.

  • Добавлен отдельный файл список отзыва сертификатов.

  • Актуализирована информация по сертификатам для тестирования.

  • Добавлено описание способа получения списка писем без подписи.

V 1.23 (26.10.2023)

  • Добавлена новая категория письма "Акцепт".

  • Актуализированы http-коды ответов.

  • Обновлены тестовые данные.

V 1.22 (19.09.2023)

  • В платежном поручении добавлен тег адрес плательщика.

  • Внесены изменения в Отзыв платежа. Изменены схемы запроса и ответа.

  • В зарплатной ведомости добавлен тег с указанием суммы удержания (Взыскания).

  • Обновлены сертификаты для электронной подписи.

  • При постановке на учет внешнеторгового контракта поле "Код типа контракта/договора" теперь является необязательным.

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 в выписку с платёжным поручением.