Перейти к основному содержимому

Выписка по счету

Вы можете запросить выписку по расчетному или номинальному счету в рублях. Выписку можно получить по данным за одни сутки.

Чтобы получить выписку, используйте метод 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"
}
}