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

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

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

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

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

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

Важно

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

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

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

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

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

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

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

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

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

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

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

URI

HTTP POST: /API/v1/ISO20022/Statements

XSD схема

camt.060.001.03

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

Table 1. Заголовок (GrpHdr)
Описание Путь Комментарий
Пример

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