ym88659208ym87991671
statements | Документация для разработчиков

Выписки по счету

Обновлено 30 июля 2024

Информация о продукте

Банковская выписка — это документ, содержащий список всех операций по счету за определенный период (неделю, месяц, квартал). Она отражает состояние счета на начало и конец периода, приход и расход средств, а также адресатов и отправителей платежей.

Выписка нужна для того, чтобы видеть, когда и сколько денег переводили со счета и получали на счет, а также общее количество поступлений и списаний за период. Это помогает анализировать траты и поступления, корректировать деятельность и планировать финансы.


Авторизация

Все запросы в Sber API выполняются от имени конкретного пользователя СберБизнес, в том числе при интеграции для работы с информацией только по собственной компании. Запросы в Sber API в заголовке (Header) содержат параметр - Authorization. В нем требуется передавать токен доступа (access_token) пользователя. Получение токена доступа осуществляется с помощью сервиса СберБизнес ID. Подробно о подключении и работе сервиса авторизации рассказали в соответствующем разделе документации.

При интеграции по собственной компании потребуется выбрать одного пользователя СберБизнес и пройти им авторизацию через СберБизнес ID единоразово. В дальнейшем вам потребуется своевременно обновлять токен доступа при помощи токена обновления - обновить токен доступа.


Варианты реализации

Ниже будут приведены примеры реализации. Сценарии могут быть для вас отправной точкой и идеей для финального способа реализации функциональности.

Сценарии описали общие, для более легкого восприятия информации описания работы с продуктом Выписки по счету в Sber API.

Можно использовать разные триггеры запуска того или иного сценария - действия пользователя, регламентный запуск по времени, наступление определенных событий и другие варианты.

Варианты реализации
Получение выписки по счету

Шаги

  1. Получить информацию по счетам
  2. Запросить выписку
  3. Отразить выписку Пользователю

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках Платформы
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предусловия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID

Постусловия

  • Пользователь получил выписку по счету в рамках UI Платформы
Получение выписки по счету

Используемые ресурсы

МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/ic/sso/api/v2/oauth/user-infoПолучение информацииopenid1. Получить информацию по счетам
2Alt text/fintech/api/v2/statement/transactionsПолучить выписку по счетуGET_STATEMENT_ACCOUNT2. Запросить выписку
3Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid2. Запросить выписку
Получение реквизитов операции

Шаги

  1. Получить реквизиты операции

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках Платформы
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предусловия

  • Успешно выполнен сценарий "Получение выписки по счету"
  • В сценарии "Получение выписки по счету" Платформа сохранила идентификаторы операций из выписки (operationId) в своей БД

Постусловия

  • Пользователь получил информацию по операции

Используемые ресурсы

МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/fintech/api/v2/statement/transactionIdПолучить информацию из выписки по одной операцииGET_STATEMENT_ACCOUNT1. Получить реквизиты операции
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Получить реквизиты операции
Получение печатной формы операции

Шаги

  1. Запросить печатную форму
  2. Декодировать файл

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках Платформы
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предусловия

  • Успешно выполнен сценарий "Получение выписки по счету"
  • В сценарии "Получение выписки по счету" Платформа сохранила идентификаторы операций из выписки (operationId) в своей БД

Постусловия

  • Пользователь получил печатную форму по операции

Используемые ресурсы

МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/fintech/api/v2/statement/transactionId/printПолучить операцию из выписки в печатном формате файлаGET_STATEMENT_TRANSACTION1. Получить реквизиты операции
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Получить реквизиты операции
Получение информации по оборотам

Шаги

  1. Получить информацию по счетам
  2. Запросить информацию по оборотам
  3. Отразить информацию Пользователю

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках Платформы
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предусловия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID

Постусловия

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

Используемые ресурсы

МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/ic/sso/api/v2/oauth/user-infoПолучение информацииopenid1. Получить информацию по счетам
1Alt text/fintech/api/v2/statement/summaryПолучить информацию по оборотам счетаGET_STATEMENT_ACCOUNT2. Запросить информацию по оборотам
2Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid1. Получить информацию по счетам
Получение печатной формы выписки по счету

Шаги

  1. Получить информацию по счетам
  2. Запросить печатную форму выписки
  3. Скачать и отразить выписку в UI

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках Платформы
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предусловия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID

Постусловия

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

Используемые ресурсы

МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/ic/sso/api/v2/oauth/user-infoПолучение информацииopenid1. Получить информацию по счетам
2Alt text/fintech/api/v1/statement/printПолучить выписку в печатном формате файлаGET_STATEMENT_ACCOUNT2. Запросить печатную форму выписки
3Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid2. Запросить печатную форму выписки
4Alt text/fintech/api/v1/files/tasks-for-downloadПолучение ссылки для загрузки формыFILES3. Скачать и отразить выписку в UI
Выгрузка для экспорта в другие системы

Шаги

  1. Получить информацию по счетам
  2. Запросить файл выписки для экспорта
  3. Скачать и отразить выписку в UI

Участники usecase

  • Пользователь - сотрудник вашей компании либо представитель ЮЛ/ИП, от лица которого он работает в рамках Платформы
  • Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
  • Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа

Предусловия

  • Пользователь имеет пользовательский профиль в СберБизнес своей компании
  • Пользователь находится в пространстве Платформы
  • Пользователь прошел авторизацию с помощью СберБизнес ID

Постусловия

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

Используемые ресурсы

МетодТочка вызоваОписаниеОперация в scopeШаг в схеме
1Alt text/ic/sso/api/v2/oauth/user-infoПолучение информацииopenid1. Получить информацию по счетам
2Alt text/fintech/api/v1/statement/filesЗапросить выписку для экспорта в другие системыGET_STATEMENT_ACCOUNT2. Запросить печатную форму выписки
3Alt text/ic/sso/api/v2/oauth/tokenОбновление токена доступаopenid2. Запросить печатную форму выписки
4Alt text/v1/files/tasks-for-downloadПолучение ссылки для загрузки формыFILES3. Скачать и отразить выписку в UI

Получить выписку по счету

Alt text /fintech/api/v2/statement/transactions

Ресурс позволяет получить выписку по счету (рублевому или валютному) за выбранную дату. Необходимо запрашивать постранично данные операции, начиная с первой страницы.

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

  • Максимальное количество операций, возвращаемых на одной странице выписки, равно 100 операций для промышленного контура.
  • Дата запрашиваемой выписки не может быть ранее 1.01.2017.
  • В получаемой выписке внутри каждой операции сначала отображается информация по плательщику, а затем информация по получателю.

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


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

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

Request

/fintech/api/v2/statement/transactions
НаименованиеТипФорматRegexpОбязательностьОписание
HEADER
Authorizationstringstring^[a-zA-Z0-9]{38}$requiredAccess token пользователя собственной организации, полученный через SSO.
Acceptstringstring^(application/json|application/jose)optionalУказывает на формат данных, который вы готовы принять от Банка.
Если ответ не требуется в зашифрованном виде, то может быть не указан или передан со значением application/json.
Если необходимо получить ответ на запрос токена в зашифрованном виде, то необходимо передать параметр со значением application/jose.
Query-parameters
accountNumberstringstring^[0-9]{20}$requiredНомер счета.
statementDateDateTimeISO 8601 YYYY-MM-DD^([0-9]{4})-([0-9]{2})-([0-9]{2})$requiredДата запрашиваемой выписки.
pageintegerinteger^\d+$requiredНомер запрашиваемой страницы. По умолчанию 100 операций на странице.
curFormatstringstring^(curTransfer|swiftTransfer)$optionalФормат операции по валютному счету.

Если поле curFormat не заполнено, то в ответе на запрос по валютному счету будет передан объект swiftTransfer в формате МТ103.

Responses

200 (ОК)

На запрос первой страницы в ответе вернется список операций (если существуют операции за выбранную дату и счет) и контейнер links с параметром (href) на следующую страницу и признаком "rel": "next".

На запрос второй страницы в ответе вернется список операций и контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next". Получение последующих страниц производится по аналогии.

Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".

НаименованиеТипОбязательностьОписание
StatementTransactionsV2 {
   _linksArray[Link]optionalСсылки на связанные ресурсы,
   transactionsArray[StatementTransactionV2]optionalДанные по операциям выписки v2
}
Link {
   hrefstringrequiredАбсолютный или относительный адрес,
   relstringrequiredОтношение ссылки к текущей сущности (next, prev)
}
StatementTransactionV2 {
   amountAmountoptionalСумма в валюте счета,
   amountRubAmountoptionalСумма в рублях,
   correspondingAccountstringoptionalКорреспондирующий счет,
   curTransferCurTransferoptionalДанные валютной операции.

Объект заполняется, если:
- Данная операция валютная,
- В запросе параметр curFormat заполнен значением curTransfer,
   directionstringoptionalНаправление транзакции DEBIT/CREDIT,
   documentDatestringoptionalДата документа,
   filialstringoptionalНаименование филиала,
   numberstringoptionalНомер операции,
   operationCodestringoptionalТип операции,
   operationDatestringoptionalДата и время операции,
   operationIdstringoptionalИдентификатор операции,
   paymentPurposestringoptionalНазначение платежа,
   prioritystringoptionalОчередность платежа,
   revalnstringoptionalПризнак операции переоценки (ПК - пересчет курса, ДП - дооценка руб. покрытия),
   rurTransferRURTransferoptionalДанные рублевой операции.

Объект заполняется, если:
- Данная операция рублевая,
   swiftTransferSWIFTTransferoptionalДанные перевода SWIFT MT103.

Объект заполняется, если:
- Данная операция валютная,
- В запросе параметр curFormat не заполнен или заполнен значением swiftTransfer,
   transactionIdintegeroptionalИдентификатор операции,
   uuidstringoptionalУникальный идентификатор операции
}
Amount {
   amountnumberoptionalСумма,
   currencyNamestringoptionalБуквенный ISO-код валюты
}
CurTransfer {
   bankOperationCodestringoptionalКод банковской операции (формат MT103),
   beneficiaryBankAccountstringoptionalНомер счета банка бенефициара.
1-я часть значения поля 57 в формате MT103,
   beneficiaryBankNamestringoptionalКод BIC, расположение или название и адрес банка бенефициара. Содержимое поля 57 (за исключением номера счета, с разделителями) в формате MT103,
   beneficiaryBankOptionstringoptionalПризнак вида поля банка бенефициара (поле 57 в формате MT103).
Возможные значения: A, B, С, D,
   beneficiaryCustomerAccountstringoptionalНомер счета бенефициара.
1-я часть значения поля 59 в формате MT103,
   beneficiaryCustomerNamestringoptionalКод BIC/BEI или название и адрес бенефициара.
Содержимое поля 59 (за исключением номера счета, с разделителями) в формате MT103,
   detailsOfChargesstringoptionalСведения о расходах (формат MT103),
   exchangeRatestringoptionalКурс конвертации (формат MT103),
   instructedAmountstringoptionalВалюта/сумма по инструкции (формат MT103),
   instructionCodestringoptionalКод инструкции (формат MT103),
   intermediaryBankAccountstringoptionalНомер счета банка-посредника.
1-я часть значения поля 56 в формате MT103,
   intermediaryBankNamestringoptionalКод BIC или название банка-посредника.
Содержимое поля 56 (за исключением номера счета, с разделителями) в формате MT103,
   intermediaryBankOptionstringoptionalПризнак вида поля банка-посредника (поле 56 в формате MT103).
Возможные значения: A, С, D,
   messageDestinatorstringoptionalПолучатель сообщения SWIFT (формат MT103)
   messageIdentifierstringoptionalУникальный системный номер сообщения SWIFT (формат MT103),
   messageOriginatorstringoptionalОтправитель сообщения SWIFT (формат MT103),
   messageReceiveTimestringoptionalДата и время получения сообщения SWIFT (формат MT103),
   messageSendTimestringoptionalДата и время отправки сообщения SWIFT (формат MT103),
   messageTypestringoptionalТип сообщения SWIFT,
   orderingCustomerAccountstringoptionalНомер счета плательщика в формате IBAN или BBAN (для внутренних платежей).
1-я часть значения поля 50 в формате MT103,
   orderingCustomerNamestringoptionalКод BIC/BEI или название и адрес плательщика.
Содержимое поля 50 (за исключением номера счета, с разделителями) в формате MT103,
   orderingCustomerOptionstringoptionalПризнак вида поля плательщика (поле 50 в формате MT103).
Возможные значения: A, F, K,
   orderingInstitutionAccountstringoptionalНомер счета банка плательщика.
1-я часть значения поля 52 в формате MT103,
   orderingInstitutionNamestringoptionalКод BIC или название и адрес банка плательщика.
Содержимое поля 52 (за исключением номера счета, с разделителями) в формате MT103,
   orderingInstitutionOptionstringoptionalПризнак вида поля банка плательщика (поле 52 в формате MT-103).
Возможные значения: A, D,
   payeeAccountstringoptionalНомер счета получателя,
   payeeBankBicstringoptionalБИК банка получателя,
   payeeBankCorrAccountstringoptionalКорсчет банка получателя,
   payeeBankNamestringoptionalНаименование банка получателя,
   payeeInnstringoptionalИНН получателя,
   payeeKppstringoptionalКПП получателя,
   payeeNamestringoptionalНаименование получателя,
   payerAccountstringoptionalНомер счета плательщика,
   payerBankBicstringoptionalБИК банка плательщика,
   payerBankCorrAccountstringoptionalКорсчет банка плательщика,
   payerBankNamestringoptionalНаименование банка плательщика,
   payerInnstringoptionalИНН плательщика,
   payerKppstringoptionalКПП плательщика,
   payerNamestringoptionalНаименование плательщика,
   receiverChargesstringoptionalРасходы получателя (формат MT103),
   receiverCorrespondentAccountstringoptionalНомер счета корреспондента получателя.
1-я часть значения поля 54 в формате MT103,
   receiverCorrespondentNamestringoptionalКод BIC, расположение или название и адрес корреспондента получателя.
Содержимое поля 54 (за исключением номера счета, с разделителями) в формате MT103,
   receiverCorrespondentOptionstringoptionalПризнак вида поля корреспондента получателя (поле 54 в формате MT103).
Возможные значения: A, B, D,
   regulatoryReportingstringoptionalКонтрольная отчетность (формат MT103),
   remittanceInformationstringoptionalСведения о переводе (формат MT103),
   senderChargesstringoptionalРасходы отправителя (формат MT103),
   senderCorrespondentAccountstringoptionalНомер счета корреспондента отправителя.
1-я часть значения поля 53 в формате MT103,
   senderCorrespondentNamestringoptionalКод BIC, расположение или название и адрес корреспондента отправителя.
Содержимое поля 53 (за исключением номера счета, с разделителями) в формате MT103,
   senderCorrespondentOptionstringoptionalПризнак вида поля корреспондента отправителя (поле 53 в формате MT103).
Возможные значения: A, B, D,
   senderToReceiverInformationstringoptionalИнформация отправителя получателю (формат MT103),
   transactionReferenceNumberstringoptionalРеференс операции (формат MT103),
   transactionRelatedReferencestringoptionalСвязанный референс (формат MT103),
   transactionTypeCodestringoptionalКод типа операции (формат MT103),
   urgentstringoptionalПризнак срочности операции (формат MT103).
Возможные значения: URGENT, NORMAL,
   valueDateCurrencyInterbankSettledAmountstringoptionalДата валютирования, код валюты, сумма межбанковского расчета (формат MT103)
}
RURTransfer {
   cartInfoCartInfooptionalДополнительная информация о документе (картотека),
   deliveryKindstringoptionalСпособ отправки документа,
   departmentalInfoDepartmentalInfooptionalРеквизиты налогового, таможенного или иного бюджетного платежа,
   payeeAccountstringoptionalНомер счета получателя,
   payeeBankBicstringoptionalБИК банка получателя,
   payeeBankCorrAccountstringoptionalКорсчет банка получателя,
   payeeBankNamestringoptionalНаименование банка получателя,
   payeeInnstringoptionalИНН получателя,
   payeeKppstringoptionalКПП получателя,
   payeeNamestringoptionalНаименование получателя,
   payerAccountstringoptionalНомер счета плательщика,
   payerBankBicstringoptionalБИК банка плательщика,
   payerBankCorrAccountstringoptionalКорсчет банка плательщика,
   payerBankNamestringoptionalНаименование банка плательщика,
   payerInnstringoptionalИНН плательщика,
   payerKppstringoptionalКПП плательщика,
   payerNamestringoptionalНаименование плательщика,
   payingConditionstringoptionalУсловие оплаты (для 02),
   purposeCodestringoptionalКодовое назначение платежа

Коды:<br/ >1 - Заработная плата и иные доходы, в отношении которых ст. 99 229-ФЗ установлены ограничения размеров удержания.
2 - Периодические доходы, на которые в соответствии с ч. 1 ст. 101 229-ФЗ не может быть обращено взыскание, за исключением доходов, указанных в ч. 2 ст. 101 229-ФЗ.
3 - Периодические доходы, к которым согласно ч. 2 ст. 101 229-ФЗ ограничения по взысканию не применяются.
4 - Единовременный доход, на который в соответствии с ч. 1 ст. 101 229-ФЗ не может быть обращено взыскание, за исключением доходов, указанных в ч. 2 ст. 101 229-ФЗ.
5 - Единовременный доход, к которому согласно ч. 2 ст. 101 229-ФЗ ограничения по взысканию не применяются.
null - Код дохода указывать не нужно, если денежные средства не относятся к доходам с установленными ограничениями согласно ст. 99 и запретом согласно ст. 101 229-ФЗ.
   receiptDatestringoptionalДата поступления в банк плательщика,
   valueDatestringoptionalДата валютирования
}
**SWIFTTransfer {**
   bankOperationCodestringoptionalКод банковской операции (формат MT103),
   beneficiaryBankAccountstringoptionalНомер счета банка бенефициара.
1-я часть значения поля 57 в формате MT103,
   beneficiaryBankNamestringoptionalКод BIC, расположение или название и адрес банка бенефициара. Содержимое поля 57 (за исключением номера счета, с разделителями) в формате MT103,
   beneficiaryBankOptionstringoptionalПризнак вида поля банка бенефициара (поле 57 в формате MT103).
Возможные значения: A, B, С, D,
   beneficiaryCustomerAccountstringoptionalНомер счета бенефициара.
1-я часть значения поля 59 в формате MT103,
   beneficiaryCustomerNamestringoptionalКод BIC/BEI или название и адрес бенефициара.
Содержимое поля 59 (за исключением номера счета, с разделителями) в формате MT103,
   detailsOfChargesstringoptionalСведения о расходах (формат MT103),
   exchangeRatestringoptionalКурс конвертации (формат MT103),
   instructedAmountstringoptionalВалюта/сумма по инструкции (формат MT103),
   instructionCodestringoptionalКод инструкции (формат MT103),
   intermediaryBankAccountstringoptionalНомер счета банка-посредника.
1-я часть значения поля 56 в формате MT103,
   intermediaryBankNamestringoptionalКод BIC или название банка-посредника.
Содержимое поля 56 (за исключением номера счета, с разделителями) в формате MT103,
   intermediaryBankOptionstringoptionalПризнак вида поля банка-посредника (поле 56 в формате MT103).
Возможные значения: A, С, D,
   messageDestinatorstringoptionalПолучатель сообщения SWIFT (формат MT103)
   messageIdentifierstringoptionalУникальный системный номер сообщения SWIFT (формат MT103),
   messageOriginatorstringoptionalОтправитель сообщения SWIFT (формат MT103),
   messageReceiveTimestringoptionalДата и время получения сообщения SWIFT (формат MT103),
   messageSendTimestringoptionalДата и время отправки сообщения SWIFT (формат MT103),
   messageTypestringoptionalТип сообщения SWIFT,
   orderingCustomerAccountstringoptionalНомер счета плательщика в формате IBAN или BBAN (для внутренних платежей).
1-я часть значения поля 50 в формате MT103,
   orderingCustomerNamestringoptionalКод BIC/BEI или название и адрес плательщика.
Содержимое поля 50 (за исключением номера счета, с разделителями) в формате MT103,
   orderingCustomerOptionstringoptionalПризнак вида поля плательщика (поле 50 в формате MT103).
Возможные значения: A, F, K,
   orderingInstitutionAccountstringoptionalНомер счета банка плательщика.
1-я часть значения поля 52 в формате MT103,
   orderingInstitutionNamestringoptionalКод BIC или название и адрес банка плательщика.
Содержимое поля 52 (за исключением номера счета, с разделителями) в формате MT103,
   orderingInstitutionOptionstringoptionalПризнак вида поля банка плательщика (поле 52 в формате MT-103).
Возможные значения: A, D,
   receiverChargesstringoptionalРасходы получателя (формат MT103),
   receiverCorrespondentAccountstringoptionalНомер счета корреспондента получателя.
1-я часть значения поля 54 в формате MT103,
   receiverCorrespondentNamestringoptionalКод BIC, расположение или название и адрес корреспондента получателя.
Содержимое поля 54 (за исключением номера счета, с разделителями) в формате MT103,
   receiverCorrespondentOptionstringoptionalПризнак вида поля корреспондента получателя (поле 54 в формате MT103).
Возможные значения: A, B, D,
   regulatoryReportingstringoptionalКонтрольная отчетность (формат MT103),
   remittanceInformationstringoptionalСведения о переводе (формат MT103),
   senderChargesstringoptionalРасходы отправителя (формат MT103),
   senderCorrespondentAccountstringoptionalНомер счета корреспондента отправителя.
1-я часть значения поля 53 в формате MT103,
   senderCorrespondentNamestringoptionalКод BIC, расположение или название и адрес корреспондента отправителя.
Содержимое поля 53 (за исключением номера счета, с разделителями) в формате MT103,
   senderCorrespondentOptionstringoptionalПризнак вида поля корреспондента отправителя (поле 53 в формате MT103).
Возможные значения: A, B, D,
   senderToReceiverInformationstringoptionalИнформация отправителя получателю (формат MT103),
   transactionReferenceNumberstringoptionalРеференс операции (формат MT103),
   transactionRelatedReferencestringoptionalСвязанный референс (формат MT103),
   transactionTypeCodestringoptionalКод типа операции (формат MT103),
   urgentstringoptionalПризнак срочности операции (формат MT103).
Возможные значения: URGENT, NORMAL,
   valueDateCurrencyInterbankSettledAmountstringoptionalДата валютирования, код валюты, сумма межбанковского расчета (формат MT103)
}
CartInfo {
   documentCodestringoptionalШифр документа (картотека) (для 16),
   documentContentstringoptionalСодержание операции (для 16),
   documentDatestringoptionalДата документа (картотека) (для 16),
   documentNumberstringoptionalНомер документа (картотека) (для 16),
   paymentNumberstringoptionalНомер платежа (картотека) (для 16),
   restAmountnumberoptionalСумма остатка платежа (картотека) (для 16)
}
DepartmentalInfo {
   uipstringrequiredУникальный идентификатор платежа,
   drawerStatus101stringrequiredПоказатель статуса налогоплательщика (реквизит - 101),
   kbkstringrequiredКод бюджетной классификации (реквизит - 104),
   oktmostringrequiredКод OKTMO (реквизит - 105),
   reasonCode106stringrequiredПоказатель основания платежа (реквизит - 106),
   taxPeriod107stringrequiredНалоговый период / код таможенного органа (реквизит - 107),
   docNumber108stringrequiredНомер налогового документа (реквизит - 108),
   docDate109stringrequiredДата налогового документа (реквизит - 109),
   paymentKind110stringoptionalТип налогового платежа (реквизит - 110)
}
202 (Accepted)
CauseMessageDescription
STATEMENT_RESPONSE_PROCESSINGВыписка в процессе формирования, пожалуйста, запросите ее позже
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
400 (Bad request)
CauseMessageDescription
DESERIALIZATION_FAULTНеверный формат запросаДанные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос.
WORKFLOW_FAULTДата выписки позже текущей.

Нельзя запросить выписку за дату в будущем.
Счет не является действующим на запрошенную дату.
Запрошенной страницы с операциями не существует.Проверьте контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next".

Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".
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.
ACCESS_EXCEPTIONДля внешнего сервиса недоступны операции по счету: {номер счета}В процессе авторизации через СберБизнес ID пользователь должен подписать Согласие и указать счета, к которым Платформа получит доступ.
Однако для данного счета доступ не был предоставлен при подписании Согласия.

Чтобы решить эту проблему, пользователю необходимо войти в СберБизнес, отменить текущее Согласие, затем заново авторизоваться в Платформе, используя СберБизнес ID.
Затем СберБизнес ID предложит пользователю снова подписать Согласие. Перед подписанием ему нужно будет отметить нужный счет как доступный для Платформы.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
404 (Not Found)
CauseMessageDescription
DATA_NOT_FOUND_EXCEPTIONВыписка за указанную дату недоступна, пожалуйста, обратитесь в техническую поддержкуНеобходимо собрать полный лог запроса и сформировать обращение в техническую поддержку Банка (supportdbo2@sberbank.ru)
НаименованиеТипОбязательностьОписание
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Сообщение
}

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

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

Ресурс позволяет получить реквизиты операции из выписки.

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

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


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

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

Request

/fintech/api/v2/statement/transactionId
НаименованиеТипФормат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Дата запрашиваемой выписки.

Responses

200 (ОК)
НаименованиеТипОбязательностьОписание
StatementTransactionV2 {
   amountAmountoptionalСумма в валюте счета,
   amountRubAmountoptionalСумма в рублях,
   correspondingAccountstringoptionalКорреспондирующий счет,
   curTransferCurTransferoptionalДанные валютной операции.

Объект заполняется, если:
- Данная операция валютная,
- В запросе параметр curFormat заполнен значением curTransfer,
   directionstringoptionalНаправление транзакции DEBIT/CREDIT,
   documentDatestringoptionalДата документа,
   filialstringoptionalНаименование филиала,
   numberstringoptionalНомер операции,
   operationCodestringoptionalТип операции,
   operationDatestringoptionalДата и время операции,
   operationIdstringoptionalИдентификатор операции,
   paymentPurposestringoptionalНазначение платежа,
   prioritystringoptionalОчередность платежа,
   revalnstringoptionalПризнак операции переоценки (ПК - пересчет курса, ДП - дооценка руб. покрытия),
   rurTransferRURTransferoptionalДанные рублевой операции.

Объект заполняется, если:
- Данная операция рублевая,
   swiftTransferSWIFTTransferoptionalДанные перевода SWIFT MT103.

Объект заполняется, если:
- Данная операция валютная,
- В запросе параметр curFormat не заполнен или заполнен значением swiftTransfer,
   transactionIdintegeroptionalИдентификатор операции,
   uuidstringoptionalУникальный идентификатор операции
}
Amount {
   amountnumberoptionalСумма,
   currencyNamestringoptionalБуквенный ISO-код валюты
}
CurTransfer {
   bankOperationCodestringoptionalКод банковской операции (формат MT103),
   beneficiaryBankAccountstringoptionalНомер счета банка бенефициара.
1-я часть значения поля 57 в формате MT103,
   beneficiaryBankNamestringoptionalКод BIC, расположение или название и адрес банка бенефициара. Содержимое поля 57 (за исключением номера счета, с разделителями) в формате MT103,
   beneficiaryBankOptionstringoptionalПризнак вида поля банка бенефициара (поле 57 в формате MT103).
Возможные значения: A, B, С, D,
   beneficiaryCustomerAccountstringoptionalНомер счета бенефициара.
1-я часть значения поля 59 в формате MT103,
   beneficiaryCustomerNamestringoptionalКод BIC/BEI или название и адрес бенефициара.
Содержимое поля 59 (за исключением номера счета, с разделителями) в формате MT103,
   detailsOfChargesstringoptionalСведения о расходах (формат MT103),
   exchangeRatestringoptionalКурс конвертации (формат MT103),
   instructedAmountstringoptionalВалюта/сумма по инструкции (формат MT103),
   instructionCodestringoptionalКод инструкции (формат MT103),
   intermediaryBankAccountstringoptionalНомер счета банка-посредника.
1-я часть значения поля 56 в формате MT103,
   intermediaryBankNamestringoptionalКод BIC или название банка-посредника.
Содержимое поля 56 (за исключением номера счета, с разделителями) в формате MT103,
   intermediaryBankOptionstringoptionalПризнак вида поля банка-посредника (поле 56 в формате MT103).
Возможные значения: A, С, D,
   messageDestinatorstringoptionalПолучатель сообщения SWIFT (формат MT103)
   messageIdentifierstringoptionalУникальный системный номер сообщения SWIFT (формат MT103),
   messageOriginatorstringoptionalОтправитель сообщения SWIFT (формат MT103),
   messageReceiveTimestringoptionalДата и время получения сообщения SWIFT (формат MT103),
   messageSendTimestringoptionalДата и время отправки сообщения SWIFT (формат MT103),
   messageTypestringoptionalТип сообщения SWIFT,
   orderingCustomerAccountstringoptionalНомер счета плательщика в формате IBAN или BBAN (для внутренних платежей).
1-я часть значения поля 50 в формате MT103,
   orderingCustomerNamestringoptionalКод BIC/BEI или название и адрес плательщика.
Содержимое поля 50 (за исключением номера счета, с разделителями) в формате MT103,
   orderingCustomerOptionstringoptionalПризнак вида поля плательщика (поле 50 в формате MT103).
Возможные значения: A, F, K,
   orderingInstitutionAccountstringoptionalНомер счета банка плательщика.
1-я часть значения поля 52 в формате MT103,
   orderingInstitutionNamestringoptionalКод BIC или название и адрес банка плательщика.
Содержимое поля 52 (за исключением номера счета, с разделителями) в формате MT103,
   orderingInstitutionOptionstringoptionalПризнак вида поля банка плательщика (поле 52 в формате MT-103).
Возможные значения: A, D,
   payeeAccountstringoptionalНомер счета получателя,
   payeeBankBicstringoptionalБИК банка получателя,
   payeeBankCorrAccountstringoptionalКорсчет банка получателя,
   payeeBankNamestringoptionalНаименование банка получателя,
   payeeInnstringoptionalИНН получателя,
   payeeKppstringoptionalКПП получателя,
   payeeNamestringoptionalНаименование получателя,
   payerAccountstringoptionalНомер счета плательщика,
   payerBankBicstringoptionalБИК банка плательщика,
   payerBankCorrAccountstringoptionalКорсчет банка плательщика,
   payerBankNamestringoptionalНаименование банка плательщика,
   payerInnstringoptionalИНН плательщика,
   payerKppstringoptionalКПП плательщика,
   payerNamestringoptionalНаименование плательщика,
   receiverChargesstringoptionalРасходы получателя (формат MT103),
   receiverCorrespondentAccountstringoptionalНомер счета корреспондента получателя.
1-я часть значения поля 54 в формате MT103,
   receiverCorrespondentNamestringoptionalКод BIC, расположение или название и адрес корреспондента получателя.
Содержимое поля 54 (за исключением номера счета, с разделителями) в формате MT103,
   receiverCorrespondentOptionstringoptionalПризнак вида поля корреспондента получателя (поле 54 в формате MT103).
Возможные значения: A, B, D,
   regulatoryReportingstringoptionalКонтрольная отчетность (формат MT103),
   remittanceInformationstringoptionalСведения о переводе (формат MT103),
   senderChargesstringoptionalРасходы отправителя (формат MT103),
   senderCorrespondentAccountstringoptionalНомер счета корреспондента отправителя.
1-я часть значения поля 53 в формате MT103,
   senderCorrespondentNamestringoptionalКод BIC, расположение или название и адрес корреспондента отправителя.
Содержимое поля 53 (за исключением номера счета, с разделителями) в формате MT103,
   senderCorrespondentOptionstringoptionalПризнак вида поля корреспондента отправителя (поле 53 в формате MT103).
Возможные значения: A, B, D,
   senderToReceiverInformationstringoptionalИнформация отправителя получателю (формат MT103),
   transactionReferenceNumberstringoptionalРеференс операции (формат MT103),
   transactionRelatedReferencestringoptionalСвязанный референс (формат MT103),
   transactionTypeCodestringoptionalКод типа операции (формат MT103),
   urgentstringoptionalПризнак срочности операции (формат MT103).
Возможные значения: URGENT, NORMAL,
   valueDateCurrencyInterbankSettledAmountstringoptionalДата валютирования, код валюты, сумма межбанковского расчета (формат MT103)
}
RURTransfer {
   cartInfoCartInfooptionalДополнительная информация о документе (картотека),
   deliveryKindstringoptionalСпособ отправки документа,
   departmentalInfoDepartmentalInfooptionalРеквизиты налогового, таможенного или иного бюджетного платежа,
   payeeAccountstringoptionalНомер счета получателя,
   payeeBankBicstringoptionalБИК банка получателя,
   payeeBankCorrAccountstringoptionalКорсчет банка получателя,
   payeeBankNamestringoptionalНаименование банка получателя,
   payeeInnstringoptionalИНН получателя,
   payeeKppstringoptionalКПП получателя,
   payeeNamestringoptionalНаименование получателя,
   payerAccountstringoptionalНомер счета плательщика,
   payerBankBicstringoptionalБИК банка плательщика,
   payerBankCorrAccountstringoptionalКорсчет банка плательщика,
   payerBankNamestringoptionalНаименование банка плательщика,
   payerInnstringoptionalИНН плательщика,
   payerKppstringoptionalКПП плательщика,
   payerNamestringoptionalНаименование плательщика,
   payingConditionstringoptionalУсловие оплаты (для 02),
   purposeCodestringoptionalКодовое назначение платежа

Коды:<br/ >1 - Заработная плата и иные доходы, в отношении которых ст. 99 229-ФЗ установлены ограничения размеров удержания.
2 - Периодические доходы, на которые в соответствии с ч. 1 ст. 101 229-ФЗ не может быть обращено взыскание, за исключением доходов, указанных в ч. 2 ст. 101 229-ФЗ.
3 - Периодические доходы, к которым согласно ч. 2 ст. 101 229-ФЗ ограничения по взысканию не применяются.
4 - Единовременный доход, на который в соответствии с ч. 1 ст. 101 229-ФЗ не может быть обращено взыскание, за исключением доходов, указанных в ч. 2 ст. 101 229-ФЗ.
5 - Единовременный доход, к которому согласно ч. 2 ст. 101 229-ФЗ ограничения по взысканию не применяются.
null - Код дохода указывать не нужно, если денежные средства не относятся к доходам с установленными ограничениями согласно ст. 99 и запретом согласно ст. 101 229-ФЗ.
   receiptDatestringoptionalДата поступления в банк плательщика,
   valueDatestringoptionalДата валютирования
}
**SWIFTTransfer {**
   bankOperationCodestringoptionalКод банковской операции (формат MT103),
   beneficiaryBankAccountstringoptionalНомер счета банка бенефициара.
1-я часть значения поля 57 в формате MT103,
   beneficiaryBankNamestringoptionalКод BIC, расположение или название и адрес банка бенефициара. Содержимое поля 57 (за исключением номера счета, с разделителями) в формате MT103,
   beneficiaryBankOptionstringoptionalПризнак вида поля банка бенефициара (поле 57 в формате MT103).
Возможные значения: A, B, С, D,
   beneficiaryCustomerAccountstringoptionalНомер счета бенефициара.
1-я часть значения поля 59 в формате MT103,
   beneficiaryCustomerNamestringoptionalКод BIC/BEI или название и адрес бенефициара.
Содержимое поля 59 (за исключением номера счета, с разделителями) в формате MT103,
   detailsOfChargesstringoptionalСведения о расходах (формат MT103),
   exchangeRatestringoptionalКурс конвертации (формат MT103),
   instructedAmountstringoptionalВалюта/сумма по инструкции (формат MT103),
   instructionCodestringoptionalКод инструкции (формат MT103),
   intermediaryBankAccountstringoptionalНомер счета банка-посредника.
1-я часть значения поля 56 в формате MT103,
   intermediaryBankNamestringoptionalКод BIC или название банка-посредника.
Содержимое поля 56 (за исключением номера счета, с разделителями) в формате MT103,
   intermediaryBankOptionstringoptionalПризнак вида поля банка-посредника (поле 56 в формате MT103).
Возможные значения: A, С, D,
   messageDestinatorstringoptionalПолучатель сообщения SWIFT (формат MT103)
   messageIdentifierstringoptionalУникальный системный номер сообщения SWIFT (формат MT103),
   messageOriginatorstringoptionalОтправитель сообщения SWIFT (формат MT103),
   messageReceiveTimestringoptionalДата и время получения сообщения SWIFT (формат MT103),
   messageSendTimestringoptionalДата и время отправки сообщения SWIFT (формат MT103),
   messageTypestringoptionalТип сообщения SWIFT,
   orderingCustomerAccountstringoptionalНомер счета плательщика в формате IBAN или BBAN (для внутренних платежей).
1-я часть значения поля 50 в формате MT103,
   orderingCustomerNamestringoptionalКод BIC/BEI или название и адрес плательщика.
Содержимое поля 50 (за исключением номера счета, с разделителями) в формате MT103,
   orderingCustomerOptionstringoptionalПризнак вида поля плательщика (поле 50 в формате MT103).
Возможные значения: A, F, K,
   orderingInstitutionAccountstringoptionalНомер счета банка плательщика.
1-я часть значения поля 52 в формате MT103,
   orderingInstitutionNamestringoptionalКод BIC или название и адрес банка плательщика.
Содержимое поля 52 (за исключением номера счета, с разделителями) в формате MT103,
   orderingInstitutionOptionstringoptionalПризнак вида поля банка плательщика (поле 52 в формате MT-103).
Возможные значения: A, D,
   receiverChargesstringoptionalРасходы получателя (формат MT103),
   receiverCorrespondentAccountstringoptionalНомер счета корреспондента получателя.
1-я часть значения поля 54 в формате MT103,
   receiverCorrespondentNamestringoptionalКод BIC, расположение или название и адрес корреспондента получателя.
Содержимое поля 54 (за исключением номера счета, с разделителями) в формате MT103,
   receiverCorrespondentOptionstringoptionalПризнак вида поля корреспондента получателя (поле 54 в формате MT103).
Возможные значения: A, B, D,
   regulatoryReportingstringoptionalКонтрольная отчетность (формат MT103),
   remittanceInformationstringoptionalСведения о переводе (формат MT103),
   senderChargesstringoptionalРасходы отправителя (формат MT103),
   senderCorrespondentAccountstringoptionalНомер счета корреспондента отправителя.
1-я часть значения поля 53 в формате MT103,
   senderCorrespondentNamestringoptionalКод BIC, расположение или название и адрес корреспондента отправителя.
Содержимое поля 53 (за исключением номера счета, с разделителями) в формате MT103,
   senderCorrespondentOptionstringoptionalПризнак вида поля корреспондента отправителя (поле 53 в формате MT103).
Возможные значения: A, B, D,
   senderToReceiverInformationstringoptionalИнформация отправителя получателю (формат MT103),
   transactionReferenceNumberstringoptionalРеференс операции (формат MT103),
   transactionRelatedReferencestringoptionalСвязанный референс (формат MT103),
   transactionTypeCodestringoptionalКод типа операции (формат MT103),
   urgentstringoptionalПризнак срочности операции (формат MT103).
Возможные значения: URGENT, NORMAL,
   valueDateCurrencyInterbankSettledAmountstringoptionalДата валютирования, код валюты, сумма межбанковского расчета (формат MT103)
}
CartInfo {
   documentCodestringoptionalШифр документа (картотека) (для 16),
   documentContentstringoptionalСодержание операции (для 16),
   documentDatestringoptionalДата документа (картотека) (для 16),
   documentNumberstringoptionalНомер документа (картотека) (для 16),
   paymentNumberstringoptionalНомер платежа (картотека) (для 16),
   restAmountnumberoptionalСумма остатка платежа (картотека) (для 16)
}
DepartmentalInfo {
   uipstringrequiredУникальный идентификатор платежа,
   drawerStatus101stringrequiredПоказатель статуса налогоплательщика (реквизит - 101),
   kbkstringrequiredКод бюджетной классификации (реквизит - 104),
   oktmostringrequiredКод OKTMO (реквизит - 105),
   reasonCode106stringrequiredПоказатель основания платежа (реквизит - 106),
   taxPeriod107stringrequiredНалоговый период / код таможенного органа (реквизит - 107),
   docNumber108stringrequiredНомер налогового документа (реквизит - 108),
   docDate109stringrequiredДата налогового документа (реквизит - 109),
   paymentKind110stringoptionalТип налогового платежа (реквизит - 110)
}
400 (Bad request)
CauseMessageDescription
DESERIALIZATION_FAULTНеверный формат запросаДанные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос.
WORKFLOW_FAULTДата выписки позже текущей.

Нельзя запросить выписку за дату в будущем.
Счет не является действующим на запрошенную дату.
Запрошенной страницы с операциями не существует.Проверьте контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next".

Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".
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Сообщение
}
500 (Internal Server Error)
CauseMessageDescription
UNKNOWN_EXCEPTIONВнутренняя ошибка сервераСделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
503 (Service Temporarily Unavailable)
CauseMessageDescription
UNKNOWN_EXCEPTIONВнутренняя ошибка сервераСделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}

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

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Сообщение
}
500 (Internal Server Error)
CauseMessageDescription
UNKNOWN_EXCEPTIONВнутренняя ошибка сервераСделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
503 (Service Temporarily Unavailable)
CauseMessageDescription
UNKNOWN_EXCEPTIONВнутренняя ошибка сервераСделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}

Получить информацию по оборотам счета

Alt text /fintech/api/v2/statement/summary

Ресурс позволяет получить информацию о входящих/исходящих остатках и суммарных оборотах за один день по счету. Дата запрашиваемой информации об остатках не может быть ранее 01.01.2017.

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

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


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

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

Request

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

Responses

200 (ОК)
НаименованиеТипОбязательностьОписание
StatementSummary {
   closingBalanceAmountoptionalИсходящий остаток в валюте счета
   closingBalanceRubAmountoptionalИсходящий остаток в рублях
   composedDateTimestringoptionalДата и время составления сводки
   creditTransactionsNumberintegeroptionalКоличество кредитовых операций по счету
   creditTurnoverAmountoptionalКредитовый оборот в валюте счета
   creditTurnoverRubAmountoptionalКредитовый оборот в рублях
   debitTransactionsNumberintegeroptionalКоличество дебетовых операций по счету
   debitTurnoverAmountoptionalДебетовый оборот в валюте счета
   debitTurnoverRubAmountoptionalДебетовый оборот в рублях
   lastMovementDatestringoptionalДата последней операции по счету за запрошенный период
   openingBalanceAmountoptionalВходящий остаток в валюте счета
   openingBalanceRubAmountoptionalВходящий остаток в рублях
   openingRateNumberoptionalКурс ЦБ за единицу валюты на начало периода
}
Amount {
   amountNumberoptionalСумма
   currencyNamestringoptionalБуквенный ISO-код валюты
}
202 (Accepted)
CauseMessageDescription
STATEMENT_RESPONSE_PROCESSINGСводка по выписке не готова или данные в ней неактуальны. Следует запросить позже.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
400 (Bad request)
CauseMessageDescription
DESERIALIZATION_FAULTНеверный формат запросаДанные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос.
WORKFLOW_FAULTДата выписки позже текущей.
Нельзя запросить выписку за дату в будущем.
Счет не является действующим на запрошенную дату.
Запрошенной страницы с операциями не существует.
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.
ACCESS_EXCEPTIONДля внешнего сервиса недоступны операции по счету: {номер счета}В процессе авторизации через СберБизнес ID пользователь должен подписать Согласие и указать счета, к которым Платформа получит доступ.
Однако для данного счета доступ не был предоставлен при подписании Согласия.

Чтобы решить эту проблему, пользователю необходимо войти в СберБизнес, отменить текущее Согласие, затем заново авторизоваться в Платформе, используя СберБизнес ID.
Затем СберБизнес ID предложит пользователю снова подписать Согласие. Перед подписанием ему нужно будет отметить нужный счет как доступный для Платформы.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
404 (Not Found)
CauseMessageDescription
DATA_NOT_FOUND_EXCEPTIONВыписка за указанную дату недоступна, пожалуйста, обратитесь в техническую поддержкуНеобходимо собрать полный лог запроса и сформировать обращение в техническую поддержку Банка (supportdbo2@sberbank.ru)
НаименованиеТипОбязательностьОписание
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Сообщение
}

Запросить выписку для экспорта в другие системы

Alt text /fintech/api/v1/statement/files

Ресурс позволяет запросить формирование выписки для экспорта в другие системы в разных форматах. При выполнении запроса в ответ получаете идентификатор задачи (id) на формирование выписки в необходимом формате. При готовности выписки ссылку на скачивание можно получить с помощью ресурса /v1/files/tasks-for-download.

Для осуществления запроса на формирование выписки в нужном формате необходимо отправить GET-запрос /fintech/api/v1/statement/files с токеном доступа (access_token) пользователя в параметре Authorization заголовка, номером счета (accountNumber), датой выписки (statementDate), необходимой кодировкой (encoding) и форматом (format) в query-параметрах запроса.

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


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

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

Request

/fintech/api/v1/statement/files
НаименованиеТипФорматRegexpОбязательностьОписание
HEADER
Authorizationstringstring^[a-zA-Z0-9]{38}$requiredAccess token пользователя, полученный через SSO.
Acceptstringstring^(application/json|application/jose)optionalУказывает на формат данных, который вы готовы принять от Банка.
Если ответ не требуется в зашифрованном виде, то может быть не указан или передан со значением application/json.
Если необходимо получить ответ на запрос токена в зашифрованном виде, то необходимо передать параметр со значением application/jose.
QUERY-PARAMETERS
accountNumberstringstring^[0-9]{20}$requiredНомер счета.
statementDateDateTimeISO 8601 YYYY-MM-DD^([0-9]{4}-[0-9]{2}-[0-9]{2})$optionalДата запрашиваемой выписки.
Если не заполнять, по умолчанию текущий день.
formatstringstring^(1C|MT940|camt053)$requiredФорматы запрашиваемой выписки.
encodinstringstring^(DOS|WINDOWS|UTF8)$optionalКодировка выписки.
Если не заполнять, по умолчанию WINDOWS

Responses

200 (ОК)
НаименованиеТипОбязательностьОписание
 numberrequiredИдентификатор задачи для получения ссылки на скачивание. Возвращается один идентификатор задачи на все выбранные форматы.

Для проверки готовности выписки и получения ссылки на скачивание используется ресурс /v1/files/tasks-for-download/{taskId}
400 (Bad request)
CauseMessageDescription
DESERIALIZATION_FAULTНеверный формат запроса.Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос.
WORKFLOW_FAULTДата выписки позже текущей.
Нельзя запросить выписку за дату в будущем.
Счет не является действующим на запрошенную дату.
Запрошенной страницы с операциями не существует.Проверьте контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next".

Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".
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.
ACCESS_EXCEPTIONДля внешнего сервиса недоступны операции по счету: {номер счета}В процессе авторизации через СберБизнес ID пользователь должен подписать Согласие и указать счета, к которым Платформа получит доступ.
Однако для данного счета доступ не был предоставлен при подписании Согласия.

Чтобы решить эту проблему, пользователю необходимо войти в СберБизнес, отменить текущее Согласие, затем заново авторизоваться в Платформе, используя СберБизнес ID.
Затем СберБизнес ID предложит пользователю снова подписать Согласие. Перед подписанием ему нужно будет отметить нужный счет как доступный для Платформы.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
404 (Not Found)
CauseMessageDescription
DATA_NOT_FOUND_EXCEPTIONВыписка за указанную дату недоступна, пожалуйста, обратитесь в техническую поддержкуНеобходимо собрать полный лог запроса и сформировать обращение в техническую поддержку Банка (supportdbo2@sberbank.ru)
НаименованиеТипОбязательностьОписание
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Сообщение
}

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

Alt text /fintech/api/v1/statement/print

Ресурс позволяет запросить формирование выписки за нужную дату в форматах PDF, EXCEL, DOCX, и RTF. При выполнении запроса в ответ получаете идентификатор задачи (id) на формирование выписки в необходимом формате. При готовности выписки ссылку на скачивание можно получить с помощью ресурса /fintech/api/v1/files/tasks-for-download.

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

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


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

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

Request

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

Возможно передать запрос на предоставление выписки в нескольких форматах:
- с использованием перечисления форматов через символ & format=PDF&format=EXCEL&format=DOCX&format=RTF
- с использованием перечисления форматов через запятую format=PDF,EXCEL,DOCX,RTF

Responses

200 (ОК)
НаименованиеТипОбязательностьОписание
 numberrequiredИдентификатор задачи для получения ссылки на скачивание. Возвращается один идентификатор задачи на все выбранные форматы.

Для проверки готовности выписки и получения ссылки на скачивание используется ресурс /v1/files/tasks-for-download/{taskId}
400 (Bad request)
CauseMessageDescription
DESERIALIZATION_FAULTНеверный формат запроса.Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос.
WORKFLOW_FAULTДата выписки позже текущей.
Нельзя запросить выписку за дату в будущем.
Счет не является действующим на запрошенную дату.
Запрошенной страницы с операциями не существует.Проверьте контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next".

Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".
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.
ACCESS_EXCEPTIONДля внешнего сервиса недоступны операции по счету: {номер счета}В процессе авторизации через СберБизнес ID пользователь должен подписать Согласие и указать счета, к которым Платформа получит доступ.
Однако для данного счета доступ не был предоставлен при подписании Согласия.

Чтобы решить эту проблему, пользователю необходимо войти в СберБизнес, отменить текущее Согласие, затем заново авторизоваться в Платформе, используя СберБизнес ID.
Затем СберБизнес ID предложит пользователю снова подписать Согласие. Перед подписанием ему нужно будет отметить нужный счет как доступный для Платформы.
НаименованиеТипОбязательностьОписание
Notice {
   causestringoptionalПричина или основание сообщения,
   referenceIdstringoptionalУникальный идентификатор (UUID),
   messagestringoptionalСообщение
}
404 (Not Found)
CauseMessageDescription
DATA_NOT_FOUND_EXCEPTIONВыписка за указанную дату недоступна, пожалуйста, обратитесь в техническую поддержкуНеобходимо собрать полный лог запроса и сформировать обращение в техническую поддержку Банка (supportdbo2@sberbank.ru)
НаименованиеТипОбязательностьОписание
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 в настройках своего браузера.