ym88659208ym87991671
Запрос выписки с заданным временным интервалом в пределах операционного дня | Документация для разработчиков

Запрос выписки с заданным временным интервалом в пределах операционного дня

Обновлено 12 марта 2026

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

Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка, номер счета (accountNumber) и параметры, отвечающие за период выписки: (lastModifyDate) или (statementDate).

Выбор параметра, отвечающего за период выписки:

  • statementDate: запрос вернет выписку за период с 00:00 часов текущего дня до времени момента запроса.

  • lastModifiedDate: запрос вернет выписку за период с момента времени, переданного в параметре, до времени момента запроса.

  • lastModifyDateTo: параметр передается только совместно с заполненным значением lastModifiedDate. Запрос вернет выписку за период с момента времени, переданного в параметре lastModifiedDate, до времени, переданного в параметре lastModifyDateTo.

Параметры statementDate и lastModifyDate запрещено передавать в одном запросе.

Пример:

Потребовалось получить выписку с 00:00 до 10:00 и организовать непрерывное получение выписок далее каждый час до 19:00.

  1. 10:00 ч. Выполните запрос с атрибутом statementDate. В атрибуте укажите дату текущего дня в формате YYYY-MM-DD. Получите все операции на день запроса в промежутке с 00:00 текущего дня по 10:00 текущего дня. Сохраните дату и время запроса в формате YYYY-MM-DDThh:mm:ss[.SSS].

Далее требуется получить выписку за период с 10:00 до 11:00.

  1. 11:00 ч. Выполните запрос с атрибутом lastModifyDate. В атрибуте укажите текущую дата и время начала периода выписки (10:00) в формате YYYY-MM-DDThh:mm:ss[.SSS]. Возвращаются все операции на день запроса в промежутке с 10:00 до 11:00. Сохраните дату и время запроса в формате YYYY-MM-DDThh:mm:ss[.SSS].

  2. Повторяйте запросы с атрибутом lastModifyDate каждый час до 19:00 включительно.

Далее потребовалось повторно получить часть выписки за этот же день.

  1. 20:00 ч. Выполните запрос указав начало запрашиваемого периода lastModifyDate (10:00) в формате YYYY-MM-DDThh:mm:ss[.SSS] и конец запрашиваемого периода lastModifyDateTo (12:24) в формате YYYY-MM-DDThh:mm:ss[.SSS]. Получите все операции по выписке за день, который указан в lastModifyDate за период с 10:00 до 12:24.
Рекомендации по тестированию в песочнице

Для тестирования сценариев используйте фиксированные значения accountNumber,statementDate, lastModifyDate и lastModifyDateTo.


1. Для получения пустой выписки укажите произвольные значения параметров accountNumber и lastModifyDate.


2. Чтобы получить выписку, по которой были корректировки в операциях, нужно указать lastModifyDate = текущая дата -1 и время T13:40:48.780, а accountNumber можно указать любой.

Пример:

GET https://fintech-test.sberbank.ru:9443/fintech/api/v2/statement/increment?accountNumber=40702810638003360381&page=1&lastModifyDate=2025-12-01T13:40:48.780


3. Чтобы получить выписку за период, где дата создания вчерашний день, а исполнение на следующий день, нужно указать lastModifyDate = текущий день-1 и время T23:30:50.780 и lastModifyDateTo = текущий день и время T00:59:59.780, а accountNumber можно указать любой.

Пример:

GET https://fintech-test.sberbank.ru:9443/fintech/api/v2/statement/increment?accountNumber=40702810638003360381&page=1&lastModifyDate=2025-12-01T23:30:50.780&lastModifyDateTo=2025-12-02T00:59:59.780

4. Чтобы получить выписку за промежуток времени в 1 час, нужно указать lastModifyDate = текущая дата + время T05:00:00.000 и lastModifyDateTo = текущая дата + время T06:00:00.000, а accountNumber можно указать любой.

Пример:

GET https://fintech-test.sberbank.ru:9443/fintech/api/v2/statement/increment?accountNumber=40702810638003360381&page=1&lastModifyDate=2025-12-02T05:00:00.780&lastModifyDateTo=2025-12-02T06:00:00.780


5. Чтобы получить выписку с заполненным полем reloadTime, нужно указать statementDate = текущая дата - 5 дней, accountNumber можно указать любой.

Пример:

GET https://fintech-test.sberbank.ru:9443/fintech/api/v2/statement/increment?accountNumber=40702810638003360381&page=1&statementDate=2025-11-27


6. Чтобы получить выписку за текущий день, нужно указать statementDate указать текущим днем, accountNumber можно указать любой.

Пример:

GET https://fintech-test.sberbank.ru:9443/fintech/api/v2/statement/increment?accountNumber=40702810638003360381&page=1&statementDate=2025-12-02

7. Чтобы получить ошибку "Выписка доступна за предыдущие 5 лет + текущий год", нужно указать валидный accountNumber, а statementDate запросить за пределами этого периода (например, в 2025 году — выписка за 2019 год уже недоступна).

Причина в ответе: "cause": "WORKFLOW_FAULT"


8. Чтобы получить ошибку "Для внешнего сервиса недоступны операции по счету...", нужно указать валидное значение statementDate, а в параметре accountNumber передать значение 40702810222222222221.

Причина в ответе: "cause": "ACCESS_EXCEPTION"


9. Чтобы получить ошибку "Счет с номером ... не найден.", нужно указать валидное значение statementDate, а в параметре accountNumber передать значение 40702810222222222221.

Причина в ответе: "cause": "WORKFLOW_FAULT"


10. Чтобы получить ошибку "Счет не является действующим на запрошенную дату.", нужно в параметре accountNumber передать значение 40702810222222222222 и в параметре statementDate указать дату ранее 2025-01-02 или позже 2025-06-30.

Причина в ответе: "cause": "WORKFLOW_FAULT"


11. Чтобы получить ошибку "Выписка по счету за указанную дату не найдена.", нужно в параметре accountNumber передать значение 40702810222222222223 и в параметре statementDate указать дату 2025-01-01.

Причина в ответе: "cause": "DATA_NOT_FOUND"


12. Чтобы получить ошибку "При выполнении операции произошла ошибка...", нужно в параметре accountNumber передать значение 40702810999999999999, statementDate при этом можно указать любой.

Причина в ответе: "cause": "UNAVAILABLE_RESOURCE_EXCEPTION"

Запрос

Ответы

Успешный возврат выписки.

На запрос первой страницы в ответе вернется список операций (если существуют операции за выбранную дату и счет) и контейнер links с параметром (href) на следующую страницу и признаком "rel": "next". На запрос второй страницы в ответе вернется список операций и контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next". Получение последующих страниц производится по аналогии. Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".
Loading...
Это полезный материал?
Заметили ошибку?
Выделите текст и нажмите
Ctrl
+
Enter
, чтобы сообщить нам об ошибке
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.