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]	-

№

R/
O

Описание

Путь

Комментарий/
Пример

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

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

GrpHdr.MsgId

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

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

GrpHdr.CreDtTm

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

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

MsgSndr.Pty.Id.OrgId.Othr.Id

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

RptgReq.Id

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

RptgReq.ReqdMsgNmId

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

Номер счета

RptgReq.Acct.Id.Othr.Id

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

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

RptgReq.AcctOwnr.Pty.Nm

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

RptgReq.RptgPrd.FrToDt.FrDt

yyyy-mm-dd

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

RptgReq.RptgPrd.FrToDt.ToDt

yyyy-mm-dd

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

RptgReq.RptgPrd.FrToTm.FrTm

00:00:00

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

RptgReq.RptgPrd.FrToTm.ToTm

24:00:00

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

RptgReq.RptgPrd.Tp

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

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

Подпись

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	Шлюз не отвечает

HTTP код

Тип

Body

Описание

200

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

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>