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

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

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

Параметры запроса​

Пример запроса​

Параметры ответа​

Пример успешного ответа​

Примеры неуспешных ответов​

date_from не равна date_to​

date_from больше date_to​

Невалидная дата в date_from или в date_to​

Невалидный запрос по формату JSON​

Внутренняя ошибка​