Перейти к основному содержимому

Выписки

Для работы с выписками должно быть выдано разрешение ReadStatements.

С помощью методов вы можете запросить выписку по счёту в формате JSON. Как и в выписке из интернет-банка, в ней содержатся:

  • Остаток на начало и конец заданного периода
  • Список транзакций

Как получить выписку

Init Statement — этот метод позволяет создавать выписку по счёту за определённый период: в запросе нужно указать accountId, дату начала и конца периода.
В ответ на запрос вы получите идентификатор выписки statementId.

Далее вызовите один из следующих методов:

  • Get Statement — метод, который формирует конкретную выписку. Он запрашивается через идентификатор statementId
  • Get Statements List — метод, вызывающий список всех доступных выписок

Некоторые особенности:

Метод Init Statement отрабатывает асинхронно.
Отражаются только операции, находящиеся в финальном статусе — Ready. Выписки, инициированные этим методом, доступны для получения в течение 24 часов, после — они удаляются.

Общая сумма транзакций в теле выписки приходит в двух полях:

  • amount — в валюте счёта
  • amountNat — в рублях при пересчёте по курсу Центробанка

Исходящие и входящие платежи отличаются по полю creditDebitIndicator, где credit — приход, а debit — расход.

В некоторых случаях в списке операций в поле transactionTypeCode вместо платёжного поручения указан мемориальный ордер.

инфо

Мемориальный ордер — это вид платёжного документа, означающий, что банк обязан перечислить деньги получателю.
В таком статусе платёж ещё не отправлен вашему контрагенту — он только проходит все статусы перед отправкой.

Чтобы получить актуальный статус платежа, нужно запросить выписку повторно. Обычно уже через несколько секунд в новой выписке будет указан статус «Платёжное поручение».