Формирование выписки за период
/v2/statement/increment
Вовзращает данные об оборотах по списку счетов за текущий операционный день, начиная с указанного времени, а также удаленные записи выписки.
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка, номер счета (accountNumber
) и параметры, отвечающие за период выписки: (lastModifyDate
) или (statementDate
).
Выбор параметра, отвечающего за период выписки:
-
statementDate
: запрос вернет выписку за период с 00:00 часов текущего дня до времени момента запроса. -
lastModifiedDate
: запрос вернет выписку за период с момета времени, переданного в параметре, до времени момента запроса.
Параметры 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 включительно.
Для доступа к этому методу в параметре scope
ссылки авторизации пользователя должен быть ука зан сервис GET_STATEMENT_ACCOUNT
.
Запрос
Успешный возврат выписки.
"Запрос принят"
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 | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |