Запрос файла выписки в формате для экспорта
/v1/statement/files
Возвращает идентификатор задачи (id) на формирование файла выписки в нужном формате. Ссылку на скачивание файла можно получить с помощью ресурса /v1/files/tasks-for-download/{taskId}.
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка, номер счета (accountNumber), дату выписки (statementDate), кодировку (encoding) и формат (format) в параметрах запроса.
Для доступа к этому методу в параметре scope ссылки авторизации пользователя должен быть указан сервис GET_STATEMENT_ACCOUNT.
Запрос
Query Parameters
Номер счета (^[0-9]{20}$)
Дата выписки (yyyy-MM-dd)
Возможные значения: [DOS, WINDOWS, UTF8]
По умолчанию: WINDOWS
Кодировка выписки (по умолчанию WINDOWS)
Возможные значения: [1C, MT940]
По умолчанию: 1C
Формат запрашиваемой выписки
Header Parameters
Access token организации-клиента, полученный через SSO
Успешный код возврата
- application/json
- Схема
Schema
integer
"Ошибка в запросе"
| Cause | Message | Description |
|---|---|---|
| DESERIALIZATION_FAULT | Неверный формат запроса | Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос. |
| WORKFLOW_FAULT | Дата выписки позже текущей. Нельзя запросить выписку за дату в будущем. | |
| Счет не является действующим на запрошенную дату. | ||
| Запрошенной страницы с операциями не существует. | ||
| VALIDATION_FAULT | Ошибка при разборе параметров запроса | Данные не соответствуют требованиям валидации. Сведения о некорректных атрибутах request содержатся в массивах fieldNames и checks. Подробные требования к атрибутам описаны в request ресурса, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Уникальный идентификатор ошибки (UUID)
Сообщение
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
{
"referenceId": "string",
"message": "string",
"checks": [
{
"level": "ERROR",
"message": "string",
"fields": [
"string"
]
}
]
}
"Не авторизован"
| Cause | Message | Description |
|---|---|---|
| UNAUTHORIZED | accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
| 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 предложит пользователю снова подписать Согласие. Перед подписанием ему нужно будет отметить нужный счет как доступный для Платформы. |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
"Данные не найдены"
| Cause | Message | Description |
|---|---|---|
| DATA_NOT_FOUND_EXCEPTION | Выписка за указанную дату недоступна, пожалуйста, обратитесь в техническую поддержку | Необходимо собрать полный лог запроса и сформировать обращение в техническую поддержку Банка (supportdbo2@sberbank.ru) |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
"Превышен лимит запросов"
| Cause | Message | Description |
|---|---|---|
| TOO_MANY_REQUESTS | Превышен лимит запросов. Повторите операцию позже. | Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
"Внутренняя ошибка сервера"
| Cause | Message | Description |
|---|---|---|
| UNKNOWN_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
"Сервис временно недоступен"
| Cause | Message | Description |
|---|---|---|
| UNAVAILABLE_RESOURCE_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}