Получение операции по выписке
/v2/statement/transactionId
Возвращает реквизиты операции из выписки.
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка, номер счета (accountNumber), дату выписки (statementDate) и идентификатор операции (operationId) в параметрах запроса.
Для доступа к этому методу в параметре scope
ссылки авторизации пользователя должен быть указан сервис GET_STATEMENT_ACCOUNT
.
Запрос
Query Parameters
Идентификатор операции
Номер счета (^[0-9]{20}$)
Дата выписки (yyyy-MM-dd)
Header Parameters
Access token организации-клиента, полученный через SSO
Успешный код возврата
- application/json
- Схема
- Пример из схемы
Schema
amount
FintechAmount
Сумма
Возможные значения: >= 0
и <= 16 characters
Сумма
Буквенный ISO-код валюты
amountRub
FintechAmount
Сумма
Возможные значения: >= 0
и <= 16 characters
Сумма
Буквенный ISO-код валюты
Корреспондирующий счет
Возможные значения: [DEBIT
, CREDIT
]
Направление транзакции DEBIT/CREDIT
Дата документа
Наименование филиала
Номер операции
Тип операции
Дата и время операции
Назначение платежа
Очередность платежа
Признак операции переоценки (ПК - пересчет курса, ДП - дооценка руб. покрытия)
Уникальный идентификатор операции (UUID)
rurTransfer
FintechRURTransfer
Данные рублевой операции
cartInfo
FintechCartInfo
Дополнительная информация о документе (картотека)
Шифр документа (картотека) (для 16)
Содержание операции (для 16)
Дата документа (картотека) (для 16)
Номер документа (картотека) (для 16)
Номер платежа (картотека) (для 16)
Возможные значения: <= 16 characters
Сумма остатка платежа (картотека) (для 16)
Способ отправки документа
departmentalInfo
object
Реквизиты налогового, таможенного или иного бюджетного платежа
Возможные значения: <= 25 characters
, Value must match regular expression [A-ZА-Я0-9]+
Уникальный идентификатор платежа
Возможные значения: <= 2 characters
Показатель статуса налогоплательщика (реквизит - 101)
Возможные значения: Value must match regular expression ([A-ZА-Я0-9]{1,20})$
Код бюджетной классификации (реквизит - 104)
Возможные значения: Value must match regular expression (.{1,11})$
Код OKTMO (реквизит - 105)
Возможные значения: <= 2 characters
Показатель основания платежа (реквизит - 106)
Возможные значения: Value must match regular expression ^(0|[0-9]{8}|([0-9]{2}|МС|КВ|ПЛ|ГД)\.[0-9]{2}\.[0-9]{4})$
Налоговый период / код таможенного органа (реквизит - 107)
Возможные значения: <= 15 characters
Номер налогового документа (реквизит - 108)
Возможные значения: Value must match regular expression ^(0|00|[0-9]{2}\.[0-9]{2}\.[0-9]{4})$
Дата налогового документа (реквизит - 109)
Возможные значения: <= 2 characters
Тип налогового платежа (реквизит - 110)
Номер счета получателя
БИК банка получателя
Корсчет банка получателя
Наименование банка получателя
ИНН получателя
КПП получателя
Наименование получателя
Номер счета плательщика
БИК банка плательщика
Корсчет банка плательщика
Наименование банка плательщика
ИНН плательщика
КПП плательщика
Наименование плательщика
Условие оплаты (для 02)
Код вида дохода получателей выплаты по 229-ФЗ
Дата поступления в банк плательщика
Дата валютирования
curTransfer
FintechCurTransfer
Данные валютной операции
Номер счета получателя
БИК банка получателя
Корсчет банка получателя
Наименование банка получателя
ИНН получателя
КПП получателя
Наименование получателя
Номер счета плательщика
БИК банка плательщика
Корсчет банка плательщика
Наименование банка плательщика
ИНН плательщика
КПП плательщика
Наименование плательщика
Код банковской операции (формат MT103)
Номер счета банка бенефициара. 1-я часть значения поля 57 в формате MT103
Код BIC, расположение или название и адрес банка бенефициара. Содержимое поля 57 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля банка бенефициара (поле 57 в формате MT103). Возможные значения: A, B, С, D
Номер счета бенефициара. 1-я часть значения поля 59 в формате MT103
Код BIC/BEI или название и адрес бенефициара. Содержимое поля 59 (за исключением номера счета, с разделителями) в формате MT103
Сведения о расходах (формат MT103)
Курс конвертации (формат MT103)
Валюта/сумма по инструкции (формат MT103)
Код инструкции (формат MT103)
Номер счета банка-посредника.1-я часть значения поля 56 в формате MT103
Код BIC или название банка-посредника.Содержимое поля 56 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля банка-посредника, (поле 56 в формате MT103). Возможные значе ния: A, С, D
Получатель сообщения SWIFT (формат MT103)
Уникальный системный номер сообщения SWIFT (формат MT103)
Отправитель сообщения SWIFT (формат MT103)
Дата и время получения сообщения SWIFT (формат MT103)
Дата и время отправки сообщения SWIFT (формат MT103)
Тип сообщения SWIFT
Номер счета плательщика в формате IBAN или BBAN (для внутренних платежей). 1-я часть значения поля 50 в формате MT103
Код BIC/BEI или название и адрес плательщика.Содерж имое поля 50 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля плательщика (поле 50 в формате MT103). Возможные значения: A, F, K
Номер счета банка плательщика.1-я часть значения поля 52 в формате MT103
Код BIC или название и адрес банка плательщика.Содержимое поля 52 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля банка плательщика (поле 52 в формате MT-103). Возможные значения A, D
Расходы получателя (формат MT103)
Номер счета корреспондента получателя.1-я часть значения поля 54 в формате MT103
Код BIC, расположение или название и адрес корреспондента получателя. Содержимое по ля 54 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля корреспондента получателя (поле 54 в формате MT103). Возможные значения: A, B, D
Контрольная отчетность (формат MT103)
Сведения о переводе (формат MT103)
Расходы отправителя (формат MT103)
Номер счета корреспондента отправителя.1-я часть значения поля 53 в формате MT103
Код BIC, расположение или название и адрес корреспондента отправителя. Содержимое поля 53 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля корреспондента отправителя (поле 53 в формате MT103). Возможные значения: A, B, D
Информация отправителя получателю (формат MT103)
Референс операции (формат MT103)
Связанный референс (формат MT103)
Код типа операции (формат MT103)
Признак срочности операции (формат MT103). Возможные значения: URGENT, NORMAL
Дата валютирования, код валюты, сумма межбанковского расчета (формат MT103)
Идентификатор операции
Идентификатор операции
swiftTransfer
FintechSWIFTTransfer
Данные перевода SWIFT MT103 (только для валютных операций)
Код банковской операции (формат MT103)
Номер счета банка бенефициара. 1-я часть значения поля 57 в формате MT103
Код BIC, расположение или название и адрес ба нка бенефициара. Содержимое поля 57 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля банка бенефициара (поле 57 в формате MT103). Возможные значения: A, B, С, D
Номер счета бенефициара. 1-я часть значения поля 59 в формате MT103
Код BIC/BEI или название и адрес бенефициара. Содержимое поля 59 (за исключением номера счета, с разделителями) в формате MT103
Сведения о расходах (формат MT103)
Курс конвертации (формат MT103)
Валюта/сумма по инструкции (формат MT103)
Код инструкции (формат MT103)
Номер счета банка-посредника.1-я часть значения поля 56 в формате MT103
Код BIC или название банка-посредника.Содержимое поля 56 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля банка-посредника, (поле 56 в формате MT103). Возможные значения: A, С, D
Получатель сообщения SWIFT (формат MT103)
Уникальный системный номер сообщения SWIFT (формат MT103)
Отправитель сообщения SWIFT (формат MT103)
Дата и время получения сообщения SWIFT (формат MT103)
Дата и время отправки сообщения SWIFT (формат MT103)
Тип сообщения SWIFT
Номер счета плательщика в формате IBAN или BBAN (для внутренних платежей). 1-я часть значения поля 50 в формате MT103
Код BIC/BEI или название и адрес плательщика.Содержимое поля 50 (за исключением номера счета, с разделителями) в формате MT103
Признак в ида поля плательщика (поле 50 в формате MT103). Возможные значения: A, F, K
Номер счета банка плательщика.1-я часть значения поля 52 в формате MT103
Код BIC или название и адрес банка плательщика.Содержимое поля 52 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля банка плательщика (поле 52 в формате MT-103). Возможные значения A, D
Расходы получателя (формат MT103)
Номер счета корреспондента получателя.1-я часть значения поля 54 в формате MT103
Код BIC, расположение или название и адрес корреспондента получателя. Содержимое поля 54 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля корреспондента получателя (поле 54 в формате MT103). Возможные значения: A, B, D
Контрольная отчетность (формат MT103)
Сведения о переводе (формат MT103)
Расходы отправителя (формат MT103)
Номер счета корреспондента отправителя.1-я часть значения поля 53 в формате MT103
Код BIC, расположение или название и адрес корреспондента отправителя. Содержимое поля 53 (за исключением номера счета, с разделителями) в формате MT103
Признак вида поля корреспондента отправителя (поле 53 в формате MT103). Возможные значения: A, B, D
Информация отправителя получателю (формат MT103)
Референс операции (формат MT103)
Связанный референс (формат MT103)
Код типа операции (формат MT103)
Признак срочности операции (формат MT103). Возможные значения: URGENT, NORMAL
Дата валютирования, код валюты, сумма межбанковского расчета (формат MT103)
{
"amount": {
"amount": 1.01,
"currencyName": "USD"
},
"amountRub": {
"amount": 1.01,
"currencyName": "USD"
},
"correspondingAccount": "30101810400000000225",
"direction": "CREDIT",
"documentDate": "2018-12-31",
"filial": "ОСБ 3",
"number": "4",
"operationCode": "01",
"operationDate": "2018-12-31T23:59:59",
"paymentPurpose": "Оплата заказа №123. НДС нет.",
"priority": "5",
"revaln": "ПК",
"uuid": "55daccdf-de87-3879-976c-8b8415c8caf9",
"rurTransfer": {
"cartInfo": {
"documentCode": "string",
"documentContent": "string",
"documentDate": "2025-03-21",
"documentNumber": "string",
"paymentNumber": "string",
"restAmount": 1.01
},
"deliveryKind": "электронно",
"departmentalInfo": {
"uip": 0,
"drawerStatus101": 1,
"kbk": 18210102010011000000,
"oktmo": 1701000,
"reasonCode106": "ТП",
"taxPeriod107": "ГД.00.2018",
"docNumber108": 123,
"docDate109": "31.12.2022",
"paymentKind110": "ПН"
},
"payeeAccount": "40802810600000200000",
"payeeBankBic": "044525225",
"payeeBankCorrAccount": "30101810400000000225",
"payeeBankName": "ПАО СБЕРБАНК",
"payeeInn": "7707083893",
"payeeKpp": "222201001",
"payeeName": "Общество с ограниченной ответственностью Клиент",
"payerAccount": "40802810600000200000",
"payerBankBic": "044525225",
"payerBankCorrAccount": "30101810400000000225",
"payerBankName": "ПАО СБЕРБАНК",
"payerInn": "7707083893",
"payerKpp": "222201001",
"payerName": "Общество с ограниченной ответственностью Клиент",
"payingCondition": "string",
"purposeCode": "1",
"receiptDate": "2018-12-31",
"valueDate": "2018-12-31"
},
"curTransfer": {
"payeeAccount": "40802810600000200000",
"payeeBankBic": "044525225",
"payeeBankCorrAccount": "30101810400000000225",
"payeeBankName": "ПАО СБЕРБАНК",
"payeeInn": "7707083893",
"payeeKpp": "222201001",
"payeeName": "Общество с ограниченной ответственностью Клиент",
"payerAccount": "40802810600000200000",
"payerBankBic": "044525225",
"payerBankCorrAccount": "30101810400000000225",
"payerBankName": "ПАО СБЕРБАНК",
"payerInn": "7707083893",
"payerKpp": "222201001",
"payerName": "Общество с ограниченной ответственностью Клиент",
"bankOperationCode": "CRED",
"beneficiaryBankAccount": "LOYDGB21321",
"beneficiaryBankName": "BANCO DE SABADELL, S.A. 1, PLAZA CATALUNYA SABADELL ES ",
"beneficiaryBankOption": "D",
"beneficiaryCustomerAccount": "string",
"beneficiaryCustomerName": "/FI8850000120266333",
"detailsOfCharges": "OUR",
"exchangeRate": "67,74",
"instructedAmount": "USD70,",
"instructionCode": "URGP",
"intermediaryBankAccount": "COBADEFF",
"intermediaryBankName": "BANCA POPOLARE DELL'ETRURIA E DEL LAZIO (SEDE DI MILANO) MILANO ",
"intermediaryBankOption": "D",
"messageDestinator": "LAPBLV2X",
"messageIdentifier": "S000013082900014",
"messageOriginator": "SABRRU2P",
"messageReceiveTime": "15-05-27 14:01",
"messageSendTime": "15-05-27 13:21",
"messageType": "103",
"orderingCustomerAccount": "/08251801040004813",
"orderingCustomerName": "DONGNING JIXIN INDUSTRY AND TRADE(GROUP) CO.,LTD. NO.98 FANRONG STREET DONGNING COUNTY",
"orderingCustomerOption": "K",
"orderingInstitutionAccount": "ABOCBNBJ080",
"orderingInstitutionName": "AGRICULTURAL BANK OF CHINA, THE(HEILONGJIANG BRANCH) HARBIN",
"orderingInstitutionOption": "A",
"receiverCharges": "EUR13,19",
"receiverCorrespondentAccount": "string",
"receiverCorrespondentName": "CHASDEFX",
"receiverCorrespondentOption": "D",
"regulatoryReporting": "/N10/NS/N4/12345678901234567890/N5/12345678901/N6/TP/N7/МS.05.2003/N8/123456789012345/N9/12.05.2003",
"remittanceInformation": "CONTRACT NO SE/00233 DATED 06.03.2012, INVOICE NO 4783",
"senderCharges": "USD7,03",
"senderCorrespondentAccount": "BOTKGB2L",
"senderCorrespondentName": "CITIBANK N.A. NEW YORK,NY ",
"senderCorrespondentOption": "D",
"senderToReceiverInformation": "/NZP/OT 15.03.2009. NDS NE OBLAGAETSYA",
"transactionReferenceNumber": "S380609091426498",
"transactionRelatedReference": "S380609091426498",
"transactionTypeCode": "N1",
"urgent": "NORMAL",
"valueDateCurrencyInterbankSettledAmount": "130824EUR5447,34"
},
"transactionId": 11111,
"operationId": "7678987654678",
"swiftTransfer": {
"bankOperationCode": "CRED",
"beneficiaryBankAccount": "LOYDGB21321",
"beneficiaryBankName": "BANCO DE SABADELL, S.A. 1, PLAZA CATALUNYA SABADELL ES ",
"beneficiaryBankOption": "D",
"beneficiaryCustomerAccount": "string",
"beneficiaryCustomerName": "/FI8850000120266333",
"detailsOfCharges": "OUR",
"exchangeRate": "67,74",
"instructedAmount": "USD70,",
"instructionCode": "URGP",
"intermediaryBankAccount": "COBADEFF",
"intermediaryBankName": "BANCA POPOLARE DELL'ETRURIA E DEL LAZIO (SEDE DI MILANO) MILANO ",
"intermediaryBankOption": "D",
"messageDestinator": "LAPBLV2X",
"messageIdentifier": "S000013082900014",
"messageOriginator": "SABRRU2P",
"messageReceiveTime": "15-05-27 14:01",
"messageSendTime": "15-05-27 13:21",
"messageType": "103",
"orderingCustomerAccount": "/08251801040004813",
"orderingCustomerName": "DONGNING JIXIN INDUSTRY AND TRADE(GROUP) CO.,LTD. NO.98 FANRONG STREET DONGNING COUNTY",
"orderingCustomerOption": "K",
"orderingInstitutionAccount": "ABOCBNBJ080",
"orderingInstitutionName": "AGRICULTURAL BANK OF CHINA, THE(HEILONGJIANG BRANCH) HARBIN",
"orderingInstitutionOption": "A",
"receiverCharges": "EUR13,19",
"receiverCorrespondentAccount": "string",
"receiverCorrespondentName": "CHASDEFX",
"receiverCorrespondentOption": "D",
"regulatoryReporting": "/N10/NS/N4/12345678901234567890/N5/12345678901/N6/TP/N7/МS.05.2003/N8/123456789012345/N9/12.05.2003",
"remittanceInformation": "CONTRACT NO SE/00233 DATED 06.03.2012, INVOICE NO 4783",
"senderCharges": "USD7,03",
"senderCorrespondentAccount": "BOTKGB2L",
"senderCorrespondentName": "CITIBANK N.A. NEW YORK,NY ",
"senderCorrespondentOption": "D",
"senderToReceiverInformation": "/NZP/OT 15.03.2009. NDS NE OBLAGAETSYA",
"transactionReferenceNumber": "S380609091426498",
"transactionRelatedReference": "S380609091426498",
"transactionTypeCode": "N1",
"urgent": "NORMAL",
"valueDateCurrencyInterbankSettledAmount": "130824EUR5447,34"
}
}
"Ошибка в запросе"
Cause | Message | Description |
---|---|---|
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 ресурса, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Уникальный идентификатор ошибки (UUID)
Сообщение
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
{
"referenceId": "string",
"message": "string",
"checks": [
{
"level": "ERROR",
"message": "string",
"fields": [
"string"
]
}
]
}
"Не авторизован"
Cause | Message | Description |
---|---|---|
UNAUTHORIZED | accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
Cause | Message | Description |
---|---|---|
ACTION_ACCESS_EXCEPTION | Операция не может быть выполнена: доступ к ресурсу запрещен | Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция GET_STATEMENT_ACCOUNT . Необходимо добавить эту операцию в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token. |
ACCESS_EXCEPTION | Для внешнего сервиса недоступны операции по счету: {номер счета} | В процессе авторизации через СберБизнес ID пользователь должен подписать Согласие и указать счета, к которым Платформа получит доступ. Однако для данного счета доступ не был предоставлен при подписании Согласия. Чтобы решить эту проблему, пользователю необходимо войти в СберБизнес, отменить текущее Согласие, затем заново авторизоваться в Платформе, используя СберБизнес ID. Затем СберБизнес ID предложит пользователю снова подписать Согласие. Перед подписанием ему нужно будет отметить нужный счет как доступный для Платформы. |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
"Данные не найдены"
Cause | Message | Description |
---|---|---|
DATA_NOT_FOUND_EXCEPTION | Операция по выписке по переданному идентификатору: operationId из запроса не найдена. Выполните запрос GET /statement/transactions/ для получения актуальных идентификаторов. | Выполните запрос /fintech/api/v2/statement/transactionId для получения актуальных идентификаторов. |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
"Превышен лимит запросов"
Cause | Message | Description |
---|---|---|
TOO_MANY_REQUESTS | Превышен лимит запросов. Повторите операцию позже. | Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
"Внутренняя ошибка сервера"
Cause | Message | Description |
---|---|---|
UNKNOWN_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
"Сервис временно недоступен"
Cause | Message | Description |
---|---|---|
UNAVAILABLE_RESOURCE_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}