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

Обновлено 21 марта 2025

GET

/v2/statement/transactions

Возвращает выписку по счету (рублевому или валютному) за выбранную дату.

Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка, номер счета (accountNumber), дату выписки (statementDate) и номер запрашиваемой страницы (page) в параметрах запроса.

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

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

Запрос

Query Parameters

accountNumber

string

required

Номер счета (^[0-9]{20}$)

Example: 40802810600000200000

statementDate

string

required

Дата выписки (yyyy-MM-dd)

Example: 2022-04-03

page

integer

required

По умолчанию: 1

Номер страницы (начиная с 1)

Example: 1

curFormat

string

Формат операции по валютному счету

Example: curTransfer

Header Parameters

Authorization

string

required

Access token организации-клиента, полученный через SSO

Example: f8ad3141-b7e8-4924-92de-3de4fd0a464e-1

Ответы

Выписка получена

application/json

Схема
Пример из схемы

Schema

_links

FintechLink[]

Ссылки на связанные ресурсы

Array [

href

string

required

Абсолютный или относительный адрес

rel

string

required

Отношение ссылки к текущей сущности (next, prev)

]

transactions

object[]

Данные по операциям выписки

{
  "_links": [
    {
      "href": "?accountNumber=40702810500006103990&statementDate=2018-03-15&page=3",
      "rel": "string"
    }
  ],
  "transactions": [
    {
      "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
STATEMENT_RESPONSE_PROCESSING	Сводка по выписке не готова или данные в ней неактуальны. Следует запросить позже.

application/json

Схема
Пример из схемы

Schema

referenceId

string

Уникальный идентификатор ошибки (UUID)

message

string

Сообщение

checks

object[]

Список проверок, приведших к ошибке

Array [

level

string

Уровень результата

message

string

Сообщение

fields

string[]

Названия полей (при наличии связи с моделью)

]

{
  "referenceId": "string",
  "message": "string",
  "checks": [
    {
      "level": "ERROR",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}

"Ошибка в запросе"

Cause	Message	Description
DESERIALIZATION_FAULT	Неверный формат запроса	Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в responce в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request ресурса. Скорректируйте заполнение атрибутов и повторите запрос.
WORKFLOW_FAULT	Дата выписки позже текущей. Нельзя запросить выписку за дату в будущем.
	Счет не является действующим на запрошенную дату.
	Запрошенной страницы с операциями не существует.
VALIDATION_FAULT	Ошибка при разборе параметров запроса	Данные не соответствуют требованиям валидации. Сведения о некорректных атрибутах request содержатся в массивах fieldNames и checks. Подробные требования к атрибутам описаны в request ресурса, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос.

application/json

Схема
Пример из схемы

Schema

referenceId

string

Уникальный идентификатор ошибки (UUID)

message

string

Сообщение

checks

object[]

Список проверок, приведших к ошибке

Array [

level

string

Уровень результата

message

string

Сообщение

fields

string[]

Названия полей (при наличии связи с моделью)

]

{
  "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

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "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

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

"Данные не найдены"

Cause	Message	Description
DATA_NOT_FOUND_EXCEPTION	Выписка за указанную дату недоступна, пожалуйста, обратитесь в техническую поддержку	Необходимо собрать полный лог запроса и сформировать обращение в техническую поддержку Банка (supportdbo2@sberbank.ru)

application/json

Схема
Пример из схемы

Schema

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

"Превышен лимит запросов"

Cause	Message	Description
TOO_MANY_REQUESTS	Превышен лимит запросов. Повторите операцию позже.	Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее

application/json

Схема
Пример из схемы

Schema

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

"Внутренняя ошибка сервера"

Cause	Message	Description
UNKNOWN_EXCEPTION	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

application/json

Схема
Пример из схемы

Schema

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

"Сервис временно недоступен"

Cause	Message	Description
UNAVAILABLE_RESOURCE_EXCEPTION	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

application/json

Схема
Пример из схемы

Schema

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

Это полезный материал?

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

Запрос﻿

Query Parameters

Header Parameters

Ответы﻿

Запрос

Ответы