Запрос файла выписки в печатном формате

Обновлено 3 августа 2026

Возвращает идентификатор задачи (id) на формирование файла выписки в нужном печатном формате (PDF, EXCEL, DOCX, и RTF). Ссылку на скачивание файла можно получить с помощью ресурса /v1/statement/tasks-for-download/{taskId}.

Выписка в канале Sber API доступна за предыдущие 5 лет + текущий год. За выпиской глубиной более 5 лет, рекомендуем обратиться в офис банка.

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

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

Рекомендации по тестированию в песочнице

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

1. Чтобы получить положительный ответ с номером задачи на скачивание укажите валидные Query Parameters.

---

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

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

---

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

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

---

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

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

---

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

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

---

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

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

---

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

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

Запрос

Ответы

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

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

Cause	Message	Description
DESERIALIZATION_FAULT	Неверный формат запроса.	Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в response в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос.
WORKFLOW_FAULT	Дата выписки позже текущей. Нельзя запросить выписку за дату в будущем.
	Счет не является действующим на запрошенную дату.
	Запрошенной страницы с операциями не существует.	Проверьте контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next". Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".
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...