Получение печатной формы одной операции по счету
Возвращает печатную форму выписки по одной операции в разных форматах. Полученный ответ необходимо декодировать с помощью алгоритма Base64 Encoding.
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка, номер счета (accountNumber), дату выписки (statementDate) и формат запрашиваемой печатной формы (format) в параметрах запроса.
Для доступа к этому методу в параметре scope ссылки авторизации пользователя должен быть указан сервис GET_STATEMENT_ACCOUNT.
Для тестирования сценариев используйте фиксированные значения accountNumber, operationDate и format.
1. Чтобы получить операции в разных форматах, нужно указать валидные значения operationDate, id и accountNumber, а в парамер format передать значения:
- EXCEL
- DOCX
- RTF
2. Чтобы получить ошибку "Выписка доступна за предыдущие 5 лет + текущий год", нужно указать валидные accountNumber, format и id, а operationDate запросить за пределами этого периода (например, в 2025 году — выписка за 2019 год уже недоступна).
Причина в ответе: "cause": "WORKFLOW_FAULT"
3. Чтобы получить ошибку "Для внешнего сервиса недоступны операции по счету...", нужно указать валидное значения format, id и operationDate, а в параметре accountNumber передать значение 40702810222222222221.
Причина в ответе: "cause": "ACCESS_EXCEPTION"
4. Чтобы получить ошибку "Счет с номером ... не найден.", нужно указать валидное значения format, id и operationDate, а в параметре accountNumber передать значение 40702810222222222221.
Причина в ответе: "cause": "WORKFLOW_FAULT"
5. Чтобы получить ошибку "Счет не является действующим на запрошенную дату.", нужно в параметре accountNumber передать значение 40702810222222222222 и в параметре operationDate указать дату ранее 2025-01-02 или позже 2025-06-30.
Причина в ответе: "cause": "WORKFLOW_FAULT"
6. Чтобы получить ошибку "Выписка по счету за указанную дату не найдена.", нужно в параметре accountNumber передать значение 40702810222222222223 и в параметре operationDate указать дату 2025-01-01.
Причина в ответе: "cause": "DATA_NOT_FOUND"
7. Чтобы получить ошибку "При выполнении операции произошла ошибка...", нужно в параметре accountNumber передать значение 40702810999999999999, а format, id, operationDate при этом можно указать любые.
Причина в ответе: "cause": "UNAVAILABLE_RESOURCE_EXCEPTION"
Запрос
Ответы
Успешный код возврата
"Ошибка в запросе"
| Cause | Message | Description |
|---|---|---|
| DESERIALIZATION_FAULT | Неверный формат запроса. | Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в response в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос. |
| WORKFLOW_FAULT | Параметр "accountNumber" не соответствует регулярному выражению: ^[0-9]{20}$ | Проверьте корректность заполнения атрибута accountNumber. При необходимости дополнительной проверки получите информацию о доступных счета для работы в Sber API с помощью ресурса /fintech/api/v2/oauth/user-info |
| Дата выписки позже текущей. Нельзя запросить выписку за дату в будущем. | ||
| Счет не является действующим на запрошенную дату. | ||
| Запрошенной страницы с операциями не существует. | Проверьте контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next". Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next". | |
| Неверный тип [значение из атрибута format]! | Допустимые значения для атрибута format: PDF, RTF, EXCEL, DOCX | |
| 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 | Операция по выписке по переданному идентификатору: {operationId из запроса} не найдена. Выполните запрос GET |
"Превышен лимит запросов"
| Cause | Message | Description |
|---|---|---|
| TOO_MANY_REQUESTS | Превышен лимит запросов. Повторите операцию позже. | Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее |
"Внутренняя ошибка сервера"
| Cause | Message | Description |
|---|---|---|
| UNKNOWN_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
"Сервис временно недоступен"
| Cause | Message | Description |
|---|---|---|
| UNAVAILABLE_RESOURCE_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |