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. Клиентам необходимо самим контролировать попадание текущей даты в период запроса для получения выписки в нужном формате.
URI
HTTP POST: /API/v1/ISO20022/Statements
XSD схема
camt.060.001.03
Описание схемы
Описание | Путь | Комментарий Пример |
|
---|---|---|---|
Общий путь Document.AcctRptgReq |
|||
1 |
Уникальный ID сообщения |
GrpHdr.MsgId |
Запрос выписки осуществляется по этому идентификатору |
2 |
Дата и время создания сообщения |
GrpHdr.CreDtTm |
Формат даты YYYY-MM-DDThh:mm:ss[.mmm]TZD (В случае, если часовой пояс не указан или указан отличный от московского, то время будет приведено к UTC +3). |
3 |
Уникальный ID пакета с запросом |
RptgReq.Id |
Запрос на выписку по каждому счету запрашивается в отдельном пакете |
4 |
Признак "Получить данные по типу "Выписка" |
RptgReq.ReqdMsgNmId |
|
5 |
Номер счета |
RptgReq.Acct.Id.Othr.Id |
|
6 |
Дата начала периода |
RptgReq.RptgPrd.FrToDt.FrDt |
|
7 |
Дата окончания периода |
RptgReq.RptgPrd.FrToDt.ToDt |
|
8 |
Время начала периода |
RptgReq.RptgPrd.FrToTm.FrTm |
00:00:00 |
9 |
Время окончания периода |
RptgReq.RptgPrd.FrToTm.ToTm |
24:00:00 |
10 |
Признак "Показать все операции" |
RptgReq.RptgPrd.Tp |
Константа 'ALLL' |
11 |
Наименование организации |
RptgReq.AcctOwnr.Pty.Nm |
Ответ
В ответ на запрос на формирование выписки приходит http код и описание статуса запроса
HTTP код | Тип | Body | Описание |
---|---|---|---|
200 |
OK |
- |
Запрос на выписку принят без ошибок. |
401 |
Err |
Wrong username or password |
Неверный логин или пароль |
401 |
Err |
User was not found |
Пользователь не найден |
403 |
Err |
User is disabled |
Пользователь заблокирован |
500 |
Err |
Warrant service error |
Сервис проверки доверенности не отвечает |
403 |
Err |
Internal error while verifying permissions |
Ошибка при проверке полномочий |
403 |
Err |
Signer is not allowed to sign this operation type |
У подписанта нет полномочий на такой тип операции |
403 |
Err |
User does not have permission |
Нет права на запрос выписки |
406 |
Err |
Signature is missing |
Нет подписи |
406 |
Err |
Signature is not allowed for this operation type |
Подпись не требуется для данной операции |
403 |
Err |
Certificate is not valid |
Сертификат подписи невалидный |
403 |
Err |
Signer’s warrant is expired |
Доверенность подписанта истекла |
403 |
Err |
Signer’s warrant is disabled |
Доверенность подписанта заблокирована |
403 |
Err |
Number of signatures is not enough for this operation type |
Недостаточно подписей для типа операции |
403 |
Err |
Certificate is disabled |
Сертификат заблокирован |
403 |
Err |
The signer certificate is not valid (revoked or not active) |
Сертификат подписанта отозван или невалидный |
406 |
Err |
Signature value is not valid |
Подпись невалидна |
406 |
Err |
Internal sign check state error |
Внутренняя ошибка сервиса |
502 |
Err |
Bad Gateway |
Ошибочный шлюз |
503 |
Err |
Service Unavailable |
Сервис недоступен |
504 |
Err |
Gateway Timeout |
Шлюз не отвечает |
500 |
Err |
Internal Error |
Внутренняя ошибка приложения |
400 |
Err |
FrDt/ToDt is in the future |
Дата начала/окончания периода запроса выписки позднее текущей даты |
400 |
Err |
A date period is not specified |
Не указан период запроса выписки |
400 |
Err |
FrDt is later than ToDt |
Дата начала периода запроса выписки позднее даты окончания |
409 |
Err |
MsgId is not unique |
Id запроса неуникальный |
400 |
Err |
XML does not match schema |
Документ не соответствует схеме |
Пример запроса выписки
<?xml version="1.0" encoding="utf-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03" xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<AcctRptgReq>
<GrpHdr>
<MsgId>H2H_TEST_STMT_112368042870658794832</MsgId>
<CreDtTm>2021-03-18T10:00:18+03:00</CreDtTm>
</GrpHdr>
<RptgReq>
<Id>H2H_TEST_STMT_112368042870658794832</Id>
<ReqdMsgNmId>HMQSTASCF</ReqdMsgNmId>
<Acct>
<Id>
<Othr>
<Id>40702810200000000083</Id>
</Othr>
</Id>
</Acct>
<AcctOwnr>
<Pty>
<Nm>Общество с ограниченной ответственностью "Тест Альфа-Линк"</Nm>
</Pty>
</AcctOwnr>
<RptgPrd>
<FrToDt>
<FrDt>2022-01-15</FrDt>
<ToDt>2022-02-01</ToDt>
</FrToDt>
<FrToTm>
<FrTm>00:00:00</FrTm>
<ToTm>24:00:00</ToTm>
</FrToTm>
<Tp>ALLL</Tp>
</RptgPrd>
</RptgReq>
<SplmtryData>
<Envlp>
<SgntrSt>
</SgntrSt>
</Envlp>
</SplmtryData>
</AcctRptgReq>
</Document>