18. Отправка письма в Банк
Размер передаваемого в банк сообщения не должен превышать 100 МБ. |
Отправленные ранее в банк письма отозвать нельзя. |
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 |
Запрос/оферта/акцепт, связанные с обслуживанием Депозита |