18. Отправка письма в Банк

Размер передаваемого в банк сообщения не должен превышать 100 МБ.
Отправленные ранее в банк письма отозвать нельзя.
Информация для тестирования

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

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

URI

POST: /API/v1/ISO20022/Letters

XSD схема

auth.026.001.01

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

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

Document.CcyCtrlReqOrLttr.GrpHdr

1

R

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

MsgId

-

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Кол-во блоков ReqOrLttr

4

R

Наименование организации отправителя сообщения

InitgPty.Pty.Nm

-

5

R

ИНН организации отправителя сообщения

InitgPty.Pty.Id.OrgId.Othr.Id

-

6

R

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

InitgPty.Pty.Id.OrgId.Othr.SchmeNm.Cd

Константа TXID

Document.CcyCtrlReqOrLttr.ReqOrLttr

7

R

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

ReqOrLttrId

-

8

R

Наименование организации отправителя запроса на создание письма

Sndr.Pty.Nm

-

9

R

ИНН Организации отправителя запроса на создание письма

Sndr.Pty.Id.OrgId.Othr.Id

-

10

R

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

Sndr.Pty.Id.OrgId.Othr.SchmeNm.Cd

константа 'TXID'

11

R

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

Sndr.Pty.Id.OrgId.Othr.Id

-

12

R

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

Sndr.Pty.Id.OrgId.Othr.SchmeNm.Cd

константа 'ACC'

13

R

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

Rcvr.Agt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

константа 'RUCBC'

14

R

БИК Банка

Rcvr.Agt.FinInstnId.ClrSysMmbId.MmbId

-

15

R

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

Rcvr.Agt.FinInstnId.Nm

-

16

R

Тема

Sbjt

-

17

R

Тип запроса

Tp

категория письма

18

R

Текст письма

Desc

-

19

R

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

RspnReqrd

-

20

O

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

Attchmnt

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

Пример исходящего письма
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01">
  <CcyCtrlReqOrLttr>
    <GrpHdr>
      <!-- Уникальный ID сообщения-->
      <MsgId>7013602245_lett_MSG_2021-08-06_0001</MsgId>
      <!-- Дата и время создания сообщения -->
      <CreDtTm>2021-08-06T14:50:10+03:00</CreDtTm>
      <!--Количество транзакций в сообщении -->
      <NbOfItms>1</NbOfItms>
      <InitgPty>
        <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>
      </InitgPty>
    </GrpHdr>
    <ReqOrLttr>
      <!--Уникальный ID запроса на получения списка писем/ув-ий -->
      <ReqOrLttrId>7013602245_lett_PKG_2021-08-06_0001</ReqOrLttrId>
      <Dt>2021-08-06</Dt>
      <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>
      <Rcvr>
        <Agt>
          <FinInstnId>
            <ClrSysMmbId>
              <ClrSysId>
                <Cd>RUCBC</Cd>
                <MmbId>
                  <MmbId>044525593</MmbId>
                </MmbId>
              </ClrSysId>
            </ClrSysMmbId>
            <Nm>АО "АЛЬФА-БАНК"</Nm>
          </FinInstnId>
        </Agt>
      </Rcvr>
      <!--Тема письма-->
      <Sbjt>Зарплатный реестр</Sbjt>
      <!--Категория письма-->
      <Tp>PAYR</Tp>
      <!--Текст письма-->
      <Desc>Зарплатный реестр</Desc>
      <!--Признак необходимости предоставления ответа на запрос-->
      <RspnReqrd>false</RspnReqrd>
      <!--Блок с описанием вложенных к письму файлов. Если файлов несколько, указывается несколько блоков Attchmnt-->
      <Attchmnt>
        <!--Константа-->
        <DocTp>NONE</DocTp>
        <!--Константа-->
        <DocNb>0</DocNb>
        <!--Название файла вложения-->
        <URL>реестр.xlsx</URL>
        <AttchdBinryFile>
          <!--Константа-->
          <MIMETp>NONE</MIMETp>
        </AttchdBinryFile>
      </Attchmnt>
    </ReqOrLttr>
    <!--Блок для вставки подписи-->
    <SplmtryData>
      <Envlp>
        <SgntrSt/>
      </Envlp>
    </SplmtryData>
  </CcyCtrlReqOrLttr>
</Document>

Ответ

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

Пример статуса письма
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
   <CcyCtrlStsAdvc>
      <GrpHdr>
         <MsgId>0bca453067494f169279755a2966beae</MsgId>
         <CreDtTm>2017-07-07T18:54:27.639+03:00</CreDtTm>
         <NbOfItms>1</NbOfItms>
         <RcvgPty/>
         <RegnAgt>
            <FinInstnId>
               <BICFI>ALFARUMM</BICFI>
               <ClrSysMmbId>
                  <ClrSysId>
                     <Cd>RUCBC</Cd>
                  </ClrSysId>
                  <MmbId>044525593</MmbId>
               </ClrSysMmbId>
            </FinInstnId>
         </RegnAgt>
      </GrpHdr>
      <GrpSts>
         <OrgnlRefs>
            <OrgnlMsgId>MSGSV77281424692504241437150000001</OrgnlMsgId>
            <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
            <OrgnlCreDtTm>2017-04-25T06:19:15.000+03:00</OrgnlCreDtTm>
         </OrgnlRefs>
         <RegnAgt>
            <FinInstnId>
               <BICFI>ALFARUMM</BICFI>
            </FinInstnId>
         </RegnAgt>
         <Sts>RJCT</Sts>
      </GrpSts>
      <PackgSts>
         <PackgId>LT40701978401600000028170425143715</PackgId>
         <Sts>RJCT</Sts>
         <StsRsn>
             <Rsn>
                <Cd>NARR</Cd>
             </Rsn>
             <AddtlInf>нет верного расчетного документа. Предоставьте копии договора. с уважением УВК</AddtlInf>
         </StsRsn>
      </PackgSts>
   </CcyCtrlStsAdvc>
</Document>

19. Запрос статуса письма

URI

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

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

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

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

Ответ

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

Пример статуса письма
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.027.001.01">
   <CcyCtrlStsAdvc>
      <GrpHdr>
         <MsgId>0bca453067494f169279755a2966beae</MsgId>
         <CreDtTm>2017-07-07T18:54:27.639+03:00</CreDtTm>
         <NbOfItms>1</NbOfItms>
         <RcvgPty/>
         <RegnAgt>
            <FinInstnId>
               <BICFI>ALFARUMM</BICFI>
               <ClrSysMmbId>
                  <ClrSysId>
                     <Cd>RUCBC</Cd>
                  </ClrSysId>
                  <MmbId>044525593</MmbId>
               </ClrSysMmbId>
            </FinInstnId>
         </RegnAgt>
      </GrpHdr>
      <GrpSts>
         <OrgnlRefs>
            <OrgnlMsgId>MSGSV77281424692504241437150000001</OrgnlMsgId>
            <OrgnlMsgNmId>auth.026.001.01</OrgnlMsgNmId>
            <OrgnlCreDtTm>2017-04-25T06:19:15.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>LT40701978401600000028170425143715</PackgId>
         <Sts>RJCT</Sts>
         <StsRsn>
             <Rsn>
                <Cd>NARR</Cd>
             </Rsn>
             <AddtlInf>нет верного расчетного документа. Предоставьте копии договора. с уважением УВК</AddtlInf>
         </StsRsn>
      </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

Отклонено

20. Запрос списка входящих писем

Размер передаваемого в банк сообщения не должен превышать 100 МБ.

URI

Запрос на получение списка писем (входящие письма и уведомления о поступлении выручки на транзитный валютный счет)

POST: /API/v1/ISO20022/Letters/Lists

После отправки запроса, в случае ответа 200 ОК, необходимо получить список писем с помощью GET запроса (подробнее в разделе "Получение списка входящих писем").

XSD схема

auth.026.001.01

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

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

Document.CcyCtrlReqOrLttr.GrpHdr

1

R

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

MsgId

-

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Кол-во блоков ReqOrLttr

4

R

Наименование организации отправителя сообщения

InitgPty.Pty.Nm

-

5

R

ИНН организации отправителя сообщения

InitgPty.Pty.Id.OrgId.Othr.Id

-

6

R

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

InitgPty.Pty.Id.OrgId.Othr.SchmeNm.Cd

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

Document.CcyCtrlReqOrLttr.ReqOrLttr

7

R

Уникальный ID запроса на на получения списка писем/ув-ий

ReqOrLttrId

-

8

R

Наименование организации отправителя запроса на получения списка писем/ув-ий

Sndr.Pty.Nm

-

9

R

ИНН Организации отправителя запроса на получения списка писем/ув-ий

Sndr.Pty.Id.OrgId.Othr.Id

-

10

R

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

Sndr.Pty.Id.OrgId.Othr.SchmeNm.Cd

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

11

R

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

Sndr.Pty.Id.OrgId.Othr.Id

-

12

R

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

Sndr.Pty.Id.OrgId.Othr.SchmeNm.Cd

константа 'ACC'

13

R

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

Rcvr.Agt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

константа 'RUCBC'

14

R

БИК Банка

Rcvr.Agt.FinInstnId.ClrSysMmbId.MmbId

-

15

R

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

Rcvr.Agt.FinInstnId.Nm

-

16

R

Тема

Sbjt

Параметр обязателен по схеме. Указывается "Запрос списка входящих писем"

17

R

Тип запроса

Tp

константа 'ALLL' (получение всех типов писем) или 'CCER' (получение только уведомлений о поступлении средств на транзитный счет)

18

R

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

RspnReqrd

Параметр обязателен по схеме. Указывается константа 'false'

Document.CcyCtrlReqOrLttr.SplmtryData.Envlp.AdditionalData

19

R

Дата начала отбора

FrToDt.FrDt

-

20

R

Дата окончания отбора

FrToDt.ToDt

-

21

R

Признак "Только новые"

OnlyNew

TrueFalseIndicator

'True' - только новые (не запрошенные ранее) 'False' - все, включая новые

Пример запроса списка писем
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01">
    <CcyCtrlReqOrLttr>
        <GrpHdr>
            <MsgId>TEST__DEV_MSG_1010101</MsgId>
            <CreDtTm>2018-10-12T13:34:14+03:00</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_20191028123500</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>
            <Rcvr>
                <Agt>
                    <FinInstnId>
                        <ClrSysMmbId>
                            <ClrSysId>
                                <Cd>RUCBC</Cd>
                            </ClrSysId>
                            <MmbId>643223</MmbId>
                        </ClrSysMmbId>
                        <Nm>АО "Альфа-Банк"</Nm>
                    </FinInstnId>
                </Agt>
            </Rcvr>
            <Sbjt>Запрос списка входящих писем</Sbjt>
            <Tp>ALLL</Tp>
            <RspnReqrd>true</RspnReqrd>
                <SplmtryData>
            <Envlp>
                <AdditionalData>
                    <FrToDt>
                        <FrDt>2019-08-01</FrDt>
                        <ToDt>2019-10-30</ToDt>
                    </FrToDt>
                    <OnlyNew>false</OnlyNew>
                </AdditionalData>
            </Envlp>
        </SplmtryData>
        </ReqOrLttr>
        <SplmtryData>
            <Envlp>
                <SgntrSt>
                </SgntrSt>
            </Envlp>
        </SplmtryData>
    </CcyCtrlReqOrLttr>
</Document>

Таблица синхронных ответов сервиса "Запрос списка входящих писем"

HTTP код Тип ответа Ответ в body Описание ответа

200

OK

-

Запрос на получение списка принят без ошибок

401

Error

Wrong username or password

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

401

Error

User was not found

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

403

Error

User is disabled

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

500

Error

Warrant service error

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

401

Error

Signer is not allowed to sign this operation type

Пользователь не имеет право подписывать документы такого типа

401

Error

Number of signatures is not enough for this operation type

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

403

Err

Certificate is disabled

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

403

Err

Signer’s warrant is disabled

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

403

Err

Signer’s warrant is expired

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

403

Error

User does not have permission

Нет права на запрос Списка писем в host-to-host

406

Error

Data signature is required

Нет подписи

403

Error

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

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

406

Error

Signature value is not valid

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

406

Error

Internal sign check state error

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

500

Error

Internal Error

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

400

Error

FrDt/ToDt is in the future

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

400

Error

A date period is not specified

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

400

Error

FrDt is later than ToDt

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

400

Error

ReqOrLttrMessage with id: <Msg_Id> ИЛИ <ReqOrLttrId> already exists

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

400

Error

Document type wasn’t defined

Не определен тип запрашиваемых документов

21. Получение списка входящих писем

URI

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

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

Таблица http кодов

HTTP код Тип ответа Ответ в body Описание ответа

200

OK

The request is still being processed. Try later.

Запрос все еще обрабатывается

500

Error

Internal Error

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

500

Error

<текст с причиной отклонения>

-

500

Error

MsgId was not found

Не найден указанный MsgId

XSD схема ответа

auth.026.001.01

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

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

Document.CcyCtrlReqOrLttr.GrpHdr

1

R

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

MsgId

-

2

R

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

CreDtTm

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

3

R

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

NbOfItms

Кол-во блоков ReqOrLttr

4

R

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

InitgPty.Agt.FinInstnId.Nm

константа 'АО "Альфа-Банк"'

5

R

SWIFT код банка

InitgPty.Agt.FinInstnId.BICFI

константа 'ALFARUMM'

6

R

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

InitgPty.Agt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

константа 'RUCBC'

7

R

БИК Банка

InitgPty.Agt.FinInstnId.ClrSysMmbId.MmbId

константа '044525593'

Document.CcyCtrlReqOrLttr.ReqOrLttr

8

R

Уникальный ID письма

ReqOrLttrId

-

9

R

Дата и время создания письма

Dt

-

10

R

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

Sndr.Agt.FinInstnId.ClrSysMmbId.ClrSysId.Cd

константа 'RUCBC'

11

R

БИК Банка

Sndr.Agt.FinInstnId.ClrSysMmbId.MmbId

константа '44525593'

12

R

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

Sndr.Agt.FinInstnId.Nm

константа 'АО "Альфа-Банк"'

13

R

ИНН организации получателя сообщения

Rcvr.Pty.Id.OrgId.Othr.Id

-

14

R

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

Rcvr.Pty.Id.OrgId.Othr.SchmeNm.Cd

константа 'TXID'

15

R

ID запроса на предоставление списка писем

OrgnlRefs.OrgnlMsgId

константа 'TXID'

16

R

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

OrgnlRefs.OrgnlCreDtTm

константа 'TXID'

17

R

Тема письма

Sbjt

-

18

R

Тип запроса

Tp

заполняется в соответствии с таблицей "Категории писем"

19

O

Текст письма

Desc

-

20

R

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

RspnReqrd

Параметр обязателен по схеме. Указывается константа 'false'

21

O

Тип вложенного файла

Attchmnt.DocTp

константа 'NONE'

22

O

Уникальный ID вложенного файла

Attchmnt.DocNb

23

O

Наименование вложенного файла

Attchmnt.URL

Document.CcyCtrlReqOrLttr.SplmtryData.Envlp.AdditionalData

24

O

Комментарий сотрудника банка

Comment

25

O

Номер транзитного валютного счета

CCER.NumTVS

26

O

Сумма, поступившая на транзитный валютный счет

CCER.SumTVS

27

O

Валюта, поступившая на транзитный валютный счет

CCER.SumTVS@Ccy

28

O

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

CCER.LastDate

29

O

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

CCER.ViolationDate

30

O

Номер документа, по которому зачислены средства на транзитный валютный счет

CCER.DocNum

31

O

Дата документа, по которому зачислены средства на транзитный валютный счет

CCER.DocDate

Пример ответа со списком писем
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01">
   <CcyCtrlReqOrLttr>
      <GrpHdr>
         <MsgId>1f850ba58b8046c6a2bb7dea052718bc</MsgId>
         <CreDtTm>2021-08-06T19:02:58.039+03:00</CreDtTm>
         <NbOfItms>2</NbOfItms>
         <InitgPty>
            <Agt>
               <FinInstnId>
                  <BICFI>ALFARUMM</BICFI>
                  <ClrSysMmbId>
                     <ClrSysId>
                        <Cd>RUCBC</Cd>
                     </ClrSysId>
                     <MmbId>044525593</MmbId>
                  </ClrSysMmbId>
                  <Nm>АО "Альфа-Банк"</Nm>
               </FinInstnId>
            </Agt>
         </InitgPty>
      </GrpHdr>
      <ReqOrLttr>
         <ReqOrLttrId>26de598739a24aca87c3567eb0dd6700</ReqOrLttrId>
         <Dt>2021-08-06</Dt>
         <Sndr>
            <Agt>
               <FinInstnId>
                  <ClrSysMmbId>
                     <ClrSysId>
                        <Cd>RUCBC</Cd>
                     </ClrSysId>
                     <MmbId>044525593</MmbId>
                  </ClrSysMmbId>
                  <Nm>АО "Альфа-Банк"</Nm>
               </FinInstnId>
            </Agt>
         </Sndr>
         <Rcvr>
            <Pty>
               <Id>
                  <OrgId>
                     <Othr>
                        <Id>7013602245</Id>
                        <SchmeNm>
                           <Cd>TXID</Cd>
                        </SchmeNm>
                     </Othr>
                  </OrgId>
               </Id>
            </Pty>
         </Rcvr>
         <OrgnlRefs>
            <OrgnlMsgId>TEST__DEV_MSG_234322222223</OrgnlMsgId>
            <OrgnlCreDtTm>2021-08-06T13:34:14.000+03:00</OrgnlCreDtTm>
         </OrgnlRefs>
         <Sbjt>тест456</Sbjt>
         <Tp>OTHR</Tp>
         <Desc>тест456</Desc>
         <RspnReqrd>false</RspnReqrd>
         <Attchmnt>
            <DocTp>NONE</DocTp>
            <DocNb>73001</DocNb>
            <URL>Документы для клиента.zip</URL>
         </Attchmnt>
         <SplmtryData>
            <Envlp>
               <AdditionalData/>
            </Envlp>
         </SplmtryData>
      </ReqOrLttr>
      <ReqOrLttr>
         <ReqOrLttrId>b3f595b42d28495a9b56d210a9f4d7da</ReqOrLttrId>
         <Dt>2021-08-06</Dt>
         <Sndr>
            <Agt>
               <FinInstnId>
                  <ClrSysMmbId>
                     <ClrSysId>
                        <Cd>RUCBC</Cd>
                     </ClrSysId>
                     <MmbId>044525593</MmbId>
                  </ClrSysMmbId>
                  <Nm>АО "Альфа-Банк"</Nm>
               </FinInstnId>
            </Agt>
         </Sndr>
         <Rcvr>
            <Pty>
               <Id>
                  <OrgId>
                     <Othr>
                        <Id>7013602245</Id>
                        <SchmeNm>
                           <Cd>TXID</Cd>
                        </SchmeNm>
                     </Othr>
                  </OrgId>
               </Id>
            </Pty>
         </Rcvr>
         <OrgnlRefs>
            <OrgnlMsgId>TEST__DEV_MSG_234322222223</OrgnlMsgId>
            <OrgnlCreDtTm>2021-08-06T13:34:14.000+03:00</OrgnlCreDtTm>
         </OrgnlRefs>
         <Sbjt>тест123</Sbjt>
         <Tp>OTHR</Tp>
         <Desc>тест123</Desc>
         <RspnReqrd>false</RspnReqrd>
         <Attchmnt>
            <DocTp>NONE</DocTp>
            <DocNb>72998</DocNb>
            <URL>Документы для клиента.zip</URL>
         </Attchmnt>
         <SplmtryData>
            <Envlp>
               <AdditionalData/>
            </Envlp>
         </SplmtryData>
      </ReqOrLttr>
   </CcyCtrlReqOrLttr>
</Document>
Пример ответа с пустым списком писем
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:auth.026.001.01">
   <CcyCtrlReqOrLttr>
      <GrpHdr>
         <MsgId>21ab4a3d886c4fa5892f4f7fb8004ab0</MsgId>
         <CreDtTm>2021-08-13T18:02:37.908+03:00</CreDtTm>
         <NbOfItms>0</NbOfItms>
         <InitgPty>
            <Agt>
               <FinInstnId>
                  <BICFI>ALFARUMM</BICFI>
                  <ClrSysMmbId>
                     <ClrSysId>
                        <Cd>RUCBC</Cd>
                     </ClrSysId>
                     <MmbId>044525593</MmbId>
                  </ClrSysMmbId>
                  <Nm>АО "Альфа-Банк"</Nm>
               </FinInstnId>
            </Agt>
         </InitgPty>
      </GrpHdr>
   </CcyCtrlReqOrLttr>
</Document>

Получение вложения к входящему письму из банка

Вложения к входящим из банка письмам следует запрашивать (скачивать) отдельным сервисом:

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

22. Категории писем

[ВАЖНО] При запросе списка писем возможны только категории "ALLL" и "CCER", в противном случае будет получена соотвествующая ошибка.

Код ISO Описание в Банке

CCER

Уведомления по валютному контролю

CCDC

Документы по валютному контролю

OTHR

Без категории

LCFC

Заявления на открытие аккредитива/выдачу гарантии и иные документы по сделкам

FDOC

Финансовые документы. Документы застройщика

BPRC

Реестр Bulk Payments/ответ по реестру

FCTR

Запрос/информация связанные с обслуживанием по Факторингу

FREX

Запрос/Подтверждение по Конверсионной сделке

LOAN

Запрос, связанный с обслуживанием Кредита

PAYR

Зарплатный файл

PMTM

Запрос на изменение реквизитов платежа

RJCT

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

SECU

Запрос в Депозитарий

LTBK

Запрос/письмо по финансовому мониторингу

LTOZ

Запрос документов по счету (справки, дубликаты)

DEPT

Запрос/оферта/акцепт, связанные с обслуживанием Депозита