Запрос выписки с заданным временным интервалом в пределах операционного дня
Возвращает данные об оборотах по счету за текущий операционный день, начиная с указанного времени, а также измененные записи выписки.
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка, номер счета (accountNumber) и параметры, отвечающие за период выписки: (lastModifyDate) или (statementDate).
Выбор параметра, отвечающего за период выписки:
-
statementDate: запрос вернет выписку за период с 00:00 часов текущего дня до времени момента запроса. -
lastModifiedDate: запрос вернет выписку за период с момента времени, переданного в параметре, до времени момента запроса. -
lastModifyDateTo: параметр передается только совместно с заполненным значениемlastModifiedDate. Запрос вернет выписку за период с момента времени, переданного в параметреlastModifiedDate, до времени, переданного в параметреlastModifyDateTo.
Параметры statementDate и lastModifyDate запрещено передавать в одном запросе.
Пример:
Пот ребовалось получить выписку с 00:00 до 10:00 и организовать непрерывное получение выписок далее каждый час до 19:00.
- 10:00 ч. Выполните запрос с атрибутом
statementDate. В атрибуте укажите дату текущего дня в формате YYYY-MM-DD. Получите все операции на день запроса в промежутке с 00:00 текущего дня по 10:00 текущего дня. Сохраните дату и время запроса в форматеYYYY-MM-DDThh:mm:ss[.SSS].
Далее требуется получить выписку за период с 10:00 до 11:00.
-
11:00 ч. Выполните запрос с атрибутом
lastModifyDate. В атрибуте укажите текущую дата и время начала периода выписки (10:00) в форматеYYYY-MM-DDThh:mm:ss[.SSS]. Возвращаются все операции на день запроса в промежутке с 10:00 до 11:00. Сохраните дату и время запроса в форматеYYYY-MM-DDThh:mm:ss[.SSS]. -
Повторяйте запросы с атрибутом
lastModifyDateкаждый час до 19:00 включительно.
Далее потребовалось повторно получить часть выписки за этот же день.
- 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"
Запрос
Ответы
Успешный возврат выписки.
"Запрос принят"
| Cause | Message | Description |
|---|---|---|
| STATEMENT_RESPONSE_PROCESSING | Сводка по выписке не готова или данные в ней неактуальны. Следует запросить позже. |
"Ошибка в запросе"
| Cause | Message | Description |
|---|---|---|
| DESERIALIZATION_FAULT | Неверный формат запроса | Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в response в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос. |
| WORKFLOW_FAULT | Дата выписки позже текущей. Нельзя запросить выписку за дату в будущем. | |
| Счет не является действующим на запрошенную дату. | ||
| Запрошенной страницы с операциями не существует. | ||
| VALIDATION_FAULT | Ошибка при разборе параметров запроса | Данные не соответствуют требованиям валидации. Сведения о некорректных атрибутах request содержатся в массивах fieldNames и checks. Подробные требования к атрибутам описаны в request ресурса, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос. |
"Не авторизован"
| Cause | Message | Description |
|---|---|---|
| UNAUTHORIZED | accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
| Cause | Message | Description |
|---|---|---|
| ACTION_ACCESS_EXCEPTION | Операция не может быть выполнена: доступ к ресурсу запрещен | Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция GET_STATEMENT_ACCOUNT. Необходимо добавить эту операцию в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token. |
| ACCESS_EXCEPTION | Для внешнего сервиса недоступны операции по счету: {номер счета} | В процессе авторизации через СберБизнес ID пользователь должен подписать Согласие и указать счета, к которым Платформа получит доступ. Однако для данного счета доступ не был предоставлен при подписании Согласия. Чтобы решить эту проблему, пользователю необходимо войти в СберБизнес, отменить текущее Согласие, затем заново авторизоваться в Платформе, используя СберБизнес ID. Затем СберБизнес ID предложит пользователю снова подписать Согласие. Перед подписанием ему нужно будет отметить нужный счет как доступный для Платформы. |
"Данные не найдены"
| Cause | Message | Description |
|---|---|---|
| DATA_NOT_FOUND_EXCEPTION | Выписка за указанную дату недоступна, пожалуйста, обратитесь в техническую поддержку | Необходимо собрать полный лог запроса и сформировать обращение в техническую поддержку Банка (supportdbo2@sberbank.ru) |
"Превышен лимит запросов"
| Cause | Message | Description |
|---|---|---|
| TOO_MANY_REQUESTS | Превышен лимит запросов. Повторите операцию позже. | Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее |
"Внутренняя ошибка сервера"
| Cause | Message | Description |
|---|---|---|
| UNKNOWN_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
"Сервис временно недоступен"
| Cause | Message | Description |
|---|---|---|
| UNAVAILABLE_RESOURCE_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |