Формирование выписки за период

Обновлено 7 мая 2025

GET

/v2/statement/increment

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

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

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

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

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

Параметры 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.

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

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

Для доступа к этому методу в параметре scope ссылки авторизации пользователя должен быть указан сервис GET_STATEMENT_ACCOUNT.

Запрос

Ответы

• 200
• 202
• 400
• 401
• 403
• 404
• 429
• 500
• 503

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

На запрос первой страницы в ответе вернется список операций (если существуют операции за выбранную дату и счет) и контейнер links с параметром (href) на следующую страницу и признаком "rel": "next". На запрос второй страницы в ответе вернется список операций и контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next". Получение последующих страниц производится по аналогии. Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".

"Запрос принят"

Cause	Message	Description
STATEMENT_RESPONSE_PROCESSING	Сводка по выписке не готова или данные в ней неактуальны. Следует запросить позже.

"Ошибка в запросе"

Cause	Message	Description
DESERIALIZATION_FAULT	Неверный формат запроса	Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве 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	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

Loading...

Loading...