Выписка

Значения полей для создания платежа и получения выписки:

  • counterparty_account_number — счёт контрагента
  • counterparty_bank_bic — БИК банка контрагента
  • counterparty_bank_name — название банка контрагента
  • counterparty_inn — ИНН контрагента
  • counterparty_kpp — КПП контрагента
  • counterparty_name — наименование контрагента
  • operation_type — тип операции
  • payment_amount — сумма платежа
  • payment_bank_system_id — ID платёжного документа
  • payment_charge_date — дата проведения платежа
  • payment_date — дата платежа
  • payment_number — номер платежа
  • payment_purpose — назначение платежа
  • supplier_bill_id — код УИН
  • tax_info_document_date — дата бюджетного документа
  • tax_info_document_number — номер документа
  • tax_info_kbk — КБК
  • tax_info_okato — код ОКАТО/ОКТМО
  • tax_info_period — налоговый период
  • tax_info_reason_code — основание платежа
  • tax_info_status — статус плательщика
  • x_payment_id — ID транзакции

Создание запроса

Запрос:

POST /api/v1/statement HTTP/1.1
Host: enter.tochka.com
Accept: application/json
Content-Type: application/json
Authorization:Bearer <access_token>

 {
        "account_code": "Номер счета",
        "bank_code": "БИК банка",
        "date_end": "Дата окончания срока выписки, формат даты ГГГГ-ММ-ДД",
        "date_start": "Дата начала срока выписки, формат даты ГГГГ-ММ-ДД"
 }

Параметры:

  • access_token — получен на шаге «Получение access_token».
  • account_code — номер счёта.
  • bank_code — БИК банка.
  • date_end — дата окончания срока выписки, формат даты ГГГГ-ММ-ДД.
  • date_start — дата начала срока выписки, формат даты ГГГГ-ММ-ДД.

Ответ:

HTTP/1.1 200 OK
Content-Type: application/json

{
        "request_id":  "БИК банка.Дата окончания срока выписки.Дата начала срока выписки.Номер счета"
}

Сообщения об ошибках:

HTTP/1.1 400 OK
Content-Type: application/json

{
        "message": "Bad JSON"
}
HTTP/1.1 403 OK
Content-Type: application/json

{
        "message": "Operation not allowed"
}
HTTP/1.1 422 OK
Content-Type: application/json

{
        "message": "Validation failed"
}

Cтатус запроса

Запрос:

GET /api/v1/statement/status/<request_id> HTTP/1.1
Host: enter.tochka.com
Accept: application/json
Authorization:Bearer <access_token>

Параметры:

  • request_id — id запроса, получен на шаге «Создание запроса».
  • access_token — получен на шаге «Получение access_token».

Ответ:

Запрос находится в обработке.

HTTP/1.1 200 OK
Content-Type: application/json

{
        "status": "queued"
}

Запрос выполнен.

HTTP/1.1 200 OK
Content-Type: application/json

{
        "status": "ready"
}

Сообщения об ошибках:

HTTP/1.1 400 OK
Content-Type: application/json

{
        "status": "Bad JSON"
}
HTTP/1.1 403 OK
Content-Type: application/json

{
        "message": "Operation not allowed"
}

Результат запроса

Запрос:

GET /api/v1/statement/result/<request_id> HTTP/1.1
Host: enter.tochka.com
Accept: application/json
Authorization:Bearer <access_token>

Параметры:

  • request_id — id запроса, получен на шаге «Создание запроса».
  • access_token — получен на шаге «Получение access_token».

Ответ

HTTP/1.1 200 OK
Content-Type: application/json

{
        "balance_closing": "Сумма на момент закрытия выписки",
        "balance_opening": "Сумма на момент начала выписки",
        "payments": ["список платежей"]
}