Выписка по счету
Вы можете запросить выписку по расчетному или номинальному счету в рублях. Выписку можно получить по данным за одни сутки.
Чтобы получить выписку, используйте метод account_statement
.
Параметры запроса
Название | Обязательность | Тип | Описание |
---|---|---|---|
X-PARTNER-PROJECT | + | string | Идентификатор проекта. Выдается менеджером Банка 131 |
X-PARTNER-SIGN | + | string | Подпись запроса |
date_from | + | date | Дата начала выписки. Пример: 2023-06-01 |
date_to | + | date | Дата окончания выписки. Пример: 2023-06-01 |
account_number | + | string | Номер счета (20 цифр), по которому запрашивается выписка |
Значения в
date_from
иdate_to
должны совпадать.
Пример запроса
https://demo.bank131.ru/api/v1/report/account_statement \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: 721af394d5a7aefd0e91f5390abc4d7e20fb2b5784b091fef621f3c61b7abb4b' \
-d '{
"date_from": "2023-06-01",
"date_to": "2023-06-01",
"account_number": "40702810600200000014"
}
Параметры ответа
Название | Обязательность | Тип | Описание |
---|---|---|---|
status | + | string | {"ok","error"} |
name | + | string | Название метода account_statement |
account_statement | + | AccountStatement | Детали выписки |
date_from | + | date | Дата начала выписки |
date_to | + | date | Дата окончания выписки |
account_number | + | string | Номер счёта (20 цифр), по которому сформирована выписка |
total_turnover | + | TotalTurnover | Информация по движению средств |
debet | + | int | Сумма списаний по счёту за период выписки |
credit | + | int | Сумма пополнений по счёту за период выписки |
total_balance | + | TotalBalance | Информация по балансу |
opening | + | int | Входящий остаток по счёту на дату начала выписки |
closing | + | int | Исходящий остаток по счёту на дату окончания выписки |
transactions | + | Transactions | Список транзакций |
amount | + | int | Сумма операции (для списаний со знаком "-", для пополнений без знака) |
base_amount | + | int | Сумма операции в базовой валюте |
currency | + | string | Валюта операции |
payment_date | + | date | Дата операции |
bank_system_id | + | string | Идентификатор платежа. Указывается для любого движения денежных средств по счету: - для платежей, отправленных по API - для переводов из другого банка - для платежей, совершенных через ДБО |
transaction_id | - | string | Идентификатор транзакции. Передается для платежей, отправленных по API |
session_id | - | string | Идентификатор сессии. Передается для платежей, отправленных по API |
purpose | + | string | Назначение платежа |
counter_party | + | CounterParty | Информация о контрагенте |
kpp | - | string | КПП контрагента |
inn | - | string | ИНН контрагента |
name | + | string | Наименование контрагента |
account_number | + | string | Номер счета контрагента |
bank_code | + | string | БИК банка контрагента |
Пример успешного ответа
{
"status": "ok",
"account_statement": {
"date_from": "2023-06-01",
"date_to": "2023-06-01",
"account_number": "40702810900000000011",
"total_turnover": {
"debet": 14616,
"credit": 0
},
"total_balance": {
"opening": 499138708,
"closing": 499124092
},
"transactions": [
{
"amount": -808,
"base_amount": 808,
"currency": "RUB",
"payment_date": "2023-06-01",
"bank_system_id": "2080040124597537",
"transaction_id": "pm_771797",
"session_id": "ps_1062395",
"purpose": "Выплата на карту 430000******0777",
"counter_party": {
"kpp": "165501001",
"inn": "1655415696",
"name": "ООО \"Банк 131\"",
"account_number": "30233810100000000002",
"bank_code": "049205131"
}
},
{
"amount": -808,
"base_amount": 808,
"currency": "RUB",
"payment_date": "2023-06-01",
"bank_system_id": "2080040124597553",
"transaction_id": "pm_771799",
"session_id": "ps_1062397",
"purpose": "Выплата на карту 430000******0777",
"counter_party": {
"kpp": "165501001",
"inn": "1655415696",
"name": "ООО \"Банк 131\"",
"account_number": "30233810100000000002",
"bank_code": "049205131"
}
},
{
"amount": -6500,
"base_amount": 6500,
"currency": "RUB",
"payment_date": "2023-06-01",
"bank_system_id": "2080040124597554",
"transaction_id": "pm_771799",
"session_id": "ps_1062397",
"purpose": "Сумма комиссионного вознаграждения Банка за осуществление переводов денежных средств по договору №2pr Rko test от 20.01.2020 , НДС не облагается",
"counter_party": {
"kpp": "165501001",
"inn": "1655415696",
"name": "ООО \"Банк 131\"",
"account_number": "70601810000002740201",
"bank_code": "049205131"
}
},
{
"amount": -6500,
"base_amount": 6500,
"currency": "RUB",
"payment_date": "2023-06-01",
"bank_system_id": "2080040124597538",
"transaction_id": "pm_771797",
"session_id": "ps_1062395",
"purpose": "Сумма комиссионного вознаграждения Банка за осуществление переводов денежных средств по договору №2pr Rko test от 20.01.2020 , НДС не облагается",
"counter_party": {
"kpp": "165501001",
"inn": "1655415696",
"name": "ООО \"Банк 131\"",
"account_number": "70601810000002740201",
"bank_code": "049205131"
}
}
]
}
}
Примеры неуспешных ответов
date_from
не равна date_to
{
"status": "error",
"error": {
"description": "Invalid input request parameters: (max interval is 1 day)",
"code": "invalid_request"
}
}
date_from
больше date_to
{
"status": "error",
"error": {
"description": "Invalid input request parameters: (date_to must be greater than date_from); (max interval is 1 day)",
"code": "invalid_request"
}
}
Невалидная дата в date_from
или в date_to
{
"status": "error",
"error": {
"description": "Invalid value in date_from",
"code": "invalid_request"
}
}
или
{
"status": "error",
"error": {
"description": "Invalid value in date_to",
"code": "invalid_request"
}
}
Невалидный запрос по формату JSON
{
"status": "error",
"error": {
"description": "Invalid request",
"code": "invalid_request"
}
}
Внутренняя ошибка
Данный ответ возвращается в следующих случаях:
- номер счета указан неверно,
- запрашивается выписка по несуществующему счету,
- счет, по которому запрошена выписка, не принадлежит клиенту.
{
"status": "error",
"error": {
"description": "Internal error",
"code": "internal_error"
}
}