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

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

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

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Сообщение
}
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 в настройках своего браузера.