/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
- Модель
- Пример
Наименование | Тип | Формат | Regexp | Обязательность | Описание |
---|---|---|---|---|---|
HEADER | |||||
Authorization | string | string | ^[a-zA-Z0-9]38$ | required | Access token пользователя собственной организации, полученный через SSO. |
Accept | string | string | ^(application/json|application/jose) | optional | Указывает на формат данных, который вы готовы принять от Банка. Если ответ не требуется в зашифрованном виде, то может быть не указан или передан со значением application/json. Если необходимо получить ответ на запрос токена в зашифрованном виде, то необходимо передать параметр со значением application/jose. |
Query-parameters | |||||
accountNumber | string | string | ^[0-9]20$ | required | Номер счета. |
statementDate | DateTime | ISO 8601 YYYY-MM-DD | ^([0-9]4)-([0-9]2)-([0-9]2)$ | required | Дата запрашиваемой выписки. |
page | integer | integer | ^\d+$ | required | Номер запрашиваемой страницы. По умолчанию 100 операций на странице. |
curFormat | string | string | ^(curTransfer|swiftTransfer)$ | optional | Формат операции по валютному счету. Если поле curFormat не заполнено, то в ответе на запрос по валютному счету будет передан объект swiftTransfer в формате МТ103. |
GET /fintech/api/v2/statement/transactions?accountNumber=40802810706000000087&statementDate=2023-11-14&page=1 HTTP/1.1
Accept: application/json
Authorization: Bearer a80e9443a795e34c7dvb707z3bd97f80b1e053
Responses
На запрос первой страницы в ответе вернется список операций (если существуют операции за выбранную дату и счет) и контейнер links с параметром (href) на следующую страницу и признаком "rel": "next".
На запрос второй страницы в ответе вернется список операций и контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: "rel": "prev", "rel": "next". Получение последующих страниц производится по аналогии.
Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком "rel": "next".
- Модель
- Пример (рублевый)
- Пример (валютный)
Наименование | Тип | Обязательность | Описание |
---|---|---|---|
StatementTransactionsV2 { | |||
_links | Array[Link] | optional | Ссылки на связанные ресурсы, |
transactions | Array[StatementTransactionV2] | optional | Данные по операциям выписки v2 |
} | |||
Link { | |||
href | string | required | Абсолютный или относительный адрес, |
rel | string | required | Отношение ссылки к текущей сущности (next, prev) |
} | |||
StatementTransactionV2 { | |||
amount | Amount | optional | Сумма в валюте счета, |
amountRub | Amount | optional | Сумма в рублях, |
correspondingAccount | string | optional | Корреспондирующий счет, |
curTransfer | CurTransfer | optional | Данные валютной операции. Объект заполняется, если: - Данная операция валютная, - В запросе параметр curFormat заполнен значением curTransfer, |
direction | string | optional | Направление транзакции DEBIT/CREDIT, |
documentDate | string | optional | Дата документа, |
filial | string | optional | Наименование филиала, |
number | string | optional | Номер операции, |
operationCode | string | optional | Тип операции, |
operationDate | string | optional | Дата и время операции, |
operationId | string | optional | Идентификатор операции, |
paymentPurpose | string | optional | Назначение платежа, |
priority | string | optional | Очередность платежа, |
revaln | string | optional | Признак операции переоценки (ПК - пересчет курса, ДП - дооценка руб. покрытия), |
rurTransfer | RURTransfer | optional | Данные рублевой операции. Объект заполняется, если: - Данная операция рублевая, |
swiftTransfer | SWIFTTransfer | optional | Данные перевода SWIFT MT103. Объект заполняется, если: - Данная операция валютная, - В запросе па раметр curFormat не заполнен или заполнен значением swiftTransfer, |
transactionId | integer | optional | Идентификатор операции, |
uuid | string | optional | Уникальный идентификатор операции |
} | |||
Amount { | |||
amount | number | optional | Сумма, |
currencyName | string | optional | Буквенный ISO-код валюты |
} | |||
CurTransfer { | |||
bankOperationCode | string | optional | Код банковской операции (формат MT103), |
beneficiaryBankAccount | string | optional | Номер счета банка бенефициара. 1-я часть значения поля 57 в формате MT103, |
beneficiaryBankName | string | optional | Код BIC, расположение или название и адрес банка бенефициара. Содержимое поля 57 (за исключением номера счета, с разделителями) в формате MT103, |
beneficiaryBankOption | string | optional | Признак вида поля банка бенефициара (поле 57 в форма те MT103). Возможные значения: A, B, С, D, |
beneficiaryCustomerAccount | string | optional | Номер счета бенефициара. 1-я часть значения поля 59 в формате MT103, |
beneficiaryCustomerName | string | optional | Код BIC/BEI или название и адрес бенефициара. Содержимое поля 59 (за исключением номера счета, с разделителями) в формате MT103, |
detailsOfCharges | string | optional | Сведения о расходах (формат MT103), |
exchangeRate | string | optional | Курс конвертации (формат MT103), |
instructedAmount | string | optional | Валюта/сумма по инструкции (формат MT103), |
instructionCode | string | optional | Код инструкции (формат MT103), |
intermediaryBankAccount | string | optional | Номер счета банка-посредника. 1-я часть значения поля 56 в формате MT103, |
intermediaryBankName | string | optional | Код BIC или название банка-посредника. Содержимое поля 56 (за исключением номера счета, с разделителями) в формате MT103, |
intermediaryBankOption | string | optional | Признак вида поля банка-посредника (поле 56 в формате MT103). Возможные значения: A, С, D, |
messageDestinator | string | optional | Получатель сообщения SWIFT (формат MT103) |
messageIdentifier | string | optional | Уникальный системный номер сообщения SWIFT (формат MT103), |
messageOriginator | string | optional | Отправитель сообщения SWIFT (формат MT103), |
messageReceiveTime | string | optional | Дата и время получения сообщения SWIFT (формат MT103), |
messageSendTime | string | optional | Дата и время отправки сообщения SWIFT (формат MT103), |
messageType | string | optional | Тип сообщения SWIFT, |
orderingCustomerAccount | string | optional | Номер счета плательщика в формате IBAN или BBAN (для внутренних платежей). 1-я часть значения поля 50 в формате MT103, |
orderingCustomerName | string | optional | Код BIC/BEI или название и адрес плательщика. Содержимое поля 50 (за исключением номера счета, с разделителями) в формате MT103, |
orderingCustomerOption | string | optional | Признак вида поля плательщика (поле 50 в формате MT103). Возможные значения: A, F, K, |
orderingInstitutionAccount | string | optional | Номер счета банка плательщика. 1-я часть значения поля 52 в формате MT103, |
orderingInstitutionName | string | optional | Код BIC или название и адрес банка плательщика. Содержимое поля 52 (за исключением номера счета, с разделителями) в формате MT103, |
orderingInstitutionOption | string | optional | Признак вида поля банка плательщика (поле 52 в формате MT-103). Возможные значения: A, D, |
payeeAccount | string | optional | Номер счета получателя, |
payeeBankBic | string | optional | БИК банка получателя, |
payeeBankCorrAccount | string | optional | Корсчет банка получателя, |
payeeBankName | string | optional | Наименование банка получателя, |
payeeInn | string | optional | ИНН получателя, |
payeeKpp | string | optional | КПП получателя, |
payeeName | string | optional | Наименование получателя, |
payerAccount | string | optional | Номер счета плательщика, |
payerBankBic | string | optional | БИК банка плательщика, |
payerBankCorrAccount | string | optional | Корсчет банка плательщика, |
payerBankName | string | optional | Наименование банка плательщик а, |
payerInn | string | optional | ИНН плательщика, |
payerKpp | string | optional | КПП плательщика, |
payerName | string | optional | Наименование плательщика, |
receiverCharges | string | optional | Расходы получателя (формат MT103), |
receiverCorrespondentAccount | string | optional | Номер счета корреспондента получателя. 1-я часть значения поля 54 в формате MT103, |
receiverCorrespondentName | string | optional | Код BIC, расположение или название и адрес корреспондента получателя. Содержимое поля 54 (за исключением номера счета, с разделителями) в формате MT103, |
receiverCorrespondentOption | string | optional | Признак вида поля корреспондента получателя (поле 54 в формате MT103). Возможные значения: A, B, D, |
regulatoryReporting | string | optional | Контрольная отчетность (формат MT103), |
remittanceInformation | string | optional | Сведения о переводе (формат MT103), |
senderCharges | string | optional | Расходы отправителя (формат MT103), |
senderCorrespondentAccount | string | optional | Номер счета корреспондента отправителя. 1-я часть значения поля 53 в формате MT103, |
senderCorrespondentName | string | optional | Код BIC, расположение или название и адрес корреспондента отправителя. Содержимое поля 53 (за исключением номера счета, с разделителями) в формате MT103, |
senderCorrespondentOption | string | optional | Признак вида поля корреспондента отправителя (поле 53 в формате MT103). Возможные значения: A, B, D, |
senderToReceiverInformation | string | optional | Информация отправителя получателю (формат MT103), |
transactionReferenceNumber | string | optional | Референс операции (формат MT103), |
transactionRelatedReference | string | optional | Связанный референс (формат MT103), |
transactionTypeCode | string | optional | Код типа операции (формат MT103), |
urgent | string | optional | Признак срочности операции (формат MT103). Возможные значения: URGENT, NORMAL, |
valueDateCurrencyInterbankSettledAmount | string | optional | Дата валютирования, код валюты, сумма межбанковского расчета (формат MT103) |
} | |||
RURTransfer { | |||
cartInfo | CartInfo | optional | Дополнительная информация о документе (картотека), |
deliveryKind | string | optional | Способ отправки документа, |
departmentalInfo | DepartmentalInfo | optional | Реквизиты налогового, таможенного или иного бюджетного платежа, |
payeeAccount | string | optional | Номер счета получателя, |
payeeBankBic | string | optional | БИК банка получателя, |
payeeBankCorrAccount | string | optional | Корсчет банка получателя, |
payeeBankName | string | optional | Наименование банка получателя, |
payeeInn | string | optional | ИНН получателя, |
payeeKpp | string | optional | КПП получателя, |
payeeName | string | optional | Наименование получателя, |
payerAccount | string | optional | Номер счета плательщика, |
payerBankBic | string | optional | БИК банка плательщика, |
payerBankCorrAccount | string | optional | Корсчет банка плательщика, |
payerBankName | string | optional | Наименование банка плательщика, |