ym88659208ym87991671
Получить операцию из выписки в печатном формате файла | Документация для разработчиков

Получить операцию из выписки в печатном формате файла

Обновлено 29 ноября 2024
Компаниям
Холдингам
Платформам

Alt text /fintech/api/v2/statement/transactionId/print

Ресурс позволяет получить печатную форму выписки по одной операции в разных форматах. Полученный ответ необходимо декодировать с помощью алгоритма Base64 Encoding.

Для получения печатной формы операции необходимо отправить GET-запрос /fintech/api/v2/statement/transactionId/print с токеном доступа (access_token) пользователя в параметре Authorization заголовка, номером счета (accountNumber), датой выписки (statementDate), идентификатором операции (operationId) и форматом запрашиваемой печатной формы (format) в query-параметрах запроса.

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


Для обращения к ресурсу необходимо отправлять запрос на:

  • Тестовый контур https://iftfintech.testsbi.sberbank.ru:9443
  • Промышленный контур https://fintech.sberbank.ru:9443

Request

/fintech/api/v2/statement/transactionId/print
НаименованиеТипФорматRegexpОбязательностьОписание
HEADER
Authorizationstringstring^[a-zA-Z0-9]{38}$requiredAccess token пользователя, полученный через SSO.
Acceptstringstring^(application/json|application/jose)optionalУказывает на формат данных, который вы готовы принять от Банка.
Если ответ не требуется в зашифрованном виде, то может быть не указан или передан со значением application/json.
Если необходимо получить ответ на запрос токена в зашифрованном виде, то необходимо передать параметр со значением application/jose.
QUERY-PARAMETERS
idstringstringrequiredИдентификатор операции (operationId), который можно получить в ответе ресурса /fintech/api/v2/statement/transactions
accountNumberstringstring^[0-9]{20}$requiredНомер счета.
operationDateDateTimeISO 8601 YYYY-MM-DD^([0-9]{4}-[0-9]{2}-[0-9]{2})$requiredДата запрашиваемой платежки.
formatstringstring^(PDF|EXCEL|DOCX|RTF)$requiredФорматы запрашиваемой платежки.

Responses

200 (ОК)
НаименованиеТипОбязательностьОписание
FintechStatementPrint {
   filestringoptionalBase64 представление печатной формы операции
}
400 (Bad request)
CauseMessageDescription
DESERIALIZATION_FAULTНеверный формат запроса.Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве 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 метода, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос.
НаименованиеТипОбязательностьОписание
ResourceFault {
   referenceIdstringoptionalУникальный идентификатор ошибки (UUID),
   messagestringoptionalСообщение,
   checksArray[Check]optionalСписок проверок, приведших к ошибке,
   fieldNamesArray[string]optionalНазвания полей с некорректным значением (только для VALIDATION_FAULT)
}
Check {
   levelstringoptionalУровень результата \= ['ERROR', 'WARNING'],
   messagestringoptionalСообщение,
   fieldsArray[string]optionalНазвания полей (при наличии связи с моделью)
}
401 (Unauthorized Error)
CauseMessageDescription
UNAUTHORIZEDaccessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-хУказан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
403 (Forbidden)
CauseMessageDescription
ACTION_ACCESS_EXCEPTIONОперация не может быть выполнена: доступ к ресурсу запрещенИспользуемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API.
В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция GET_STATEMENT_ACCOUNT. Необходимо добавить эту операцию в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
404 (Not Found)
CauseMessageDescription
DATA_NOT_FOUND_EXCEPTIONОперация по выписке по переданному идентификатору: {operationId из запроса} не найдена. Выполните запрос GET /statement/transactions/ для получения актуальных идентификаторов.Выполните запрос /fintech/api/v2/statement/transactionId для получения актуальных идентификаторов.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
429 (Too Many Requests)
CauseMessageDescription
TOO_MANY_REQUESTSПревышен лимит запросов. Повторите операцию позже.Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее
НаименованиеТипОбязательностьОписание
Notice {
  causestringoptionalПричина или основание сообщения,
  referenceIdstringoptionalУникальный идентификатор ошибки (UUID),
  messagestringoptionalСообщение,
}
429 (Too Many Requests)
CauseMessageDescription
TOO_MANY_REQUESTSПревышен лимит запросов. Повторите операцию позже.Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее
НаименованиеТипОбязательностьОписание
Notice{
causestringoptionalПричина или основание сообщения,
referenceIdstringoptionalУникальный идентификатор ошибки (UUID),
messagestringoptionalСообщение,
}
500 (Internal Server Error)
CauseMessageDescription
UNKNOWN_EXCEPTIONВнутренняя ошибка сервераСделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
503 (Service Temporarily Unavailable)
CauseMessageDescription
UNKNOWN_EXCEPTIONВнутренняя ошибка сервераСделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.