---
title: "Получить платёжный календарь и прогноз остатка"
method: GET
path: "/api/v1/finance/payment-calendar"
tags: ["Finance payment calendar"]
---

# Получить платёжный календарь и прогноз остатка

`GET /api/v1/finance/payment-calendar`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/payment-calendar`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Возвращает платёжный календарь и прогноз остатка денежных средств.

## Query parameters

- `business` string, uuid
- `from` string, date
- `to` string, date
- `currency` string
- `step` 'day' | 'month' | 'quarter'
- `company` string, uuid
- `project` string, uuid
- `view` 'full' | 'summary'

## Headers

- `X-Tenant` string, required

## Response `200`

Календарь целиком с разрезом по юрлицам и местам хранения денег

- FinancePaymentCalendar
  - `rnp_metrics` object
    - `minimum_balance` string
    - `minimum_on` string
    - `first_gap_on` string
  - `valuation_date` string, date: Дата доступных курсов для пересчёта прогноза без переоценки в главной книге
  - `project` string
  - `balance_available` boolean: При фильтре проекта false; opening/closing/balance пустые, остатки счетов проекту не приписываются
  - `from` string, date, required
  - `to` string, date, required
  - `currency` string, required
  - `derived_available` boolean, required
  - `derived_note` string, required
  - `opening` string, required
  - `inflow` string, required
  - `outflow` string, required
  - `closing` string, required
  - `overdue_in` string, required
  - `overdue_out` string, required
  - `overdue_net` string, required: overdue_in минус overdue_out; входит в closing и в остаток дней с первого дня окна
  - `done_in` string, required
  - `done_out` string, required
  - `committed_in` string, required: «Должны» — поступления, выведенные из регистра расчётов: долг записан, его можно требовать
  - `expected_in` string, required: «С ожиданиями» — то же плюс выставленные счета и этапы графиков договоров
  - `view` 'full' | 'summary': Вид ответа; в summary списки rows, overdue, days, undated.rows и клетки счетов пусты
  - `row_count` integer: Строк в окне календаря; в сводном виде сами строки не отдаются
  - `overdue_count` integer: Просроченных строк
  - `undated` object
    - `count_in` integer, required
    - `count_out` integer, required
    - `amount_in` string, required
    - `amount_out` string, required
    - `rows` FinancePaymentCalendarRow[], required
      - `original_amount` string
      - `original_currency` string
      - `project_id` string, uuid
      - `id` string, uuid, required
      - `origin` 'manual' | 'receivable' | 'payable' | 'payment_request' | 'contract_stage' | 'invoice' | 'contract_rule' | 'tax', required
      - `date` string, date, required
      - `direction` 'in' | 'out', required
      - `amount` string, required
      - `currency` string, required
      - `source_kind` 'bank' | 'cash' | 'unset', required
      - `source_id` string, uuid
      - `source_name` string, required
      - `title` string, required
      - `note` string, required
      - `contact_id` string, uuid
      - `contact_name` string, required
      - `item_id` string, uuid
      - `item_name` string, required
      - `company_id` string, uuid
      - `company_name` string, required
      - `status` string, required
      - `executed_on` string, date
      - `overdue` boolean, required
      - `document_id` string, uuid
      - `operation_id` string, uuid
      - `operation_kind` 'sale' | 'purchase'
      - `operation_version` integer
      - `contract_id` string, uuid
      - `invoice_id` string, uuid
      - `tax_kind` string: Вид налога у происхождения tax
      - `tax_period` string: Месяц начисления налога в виде ГГГГ-ММ
      - `tax_accrued` string: Полная начисленная сумма налога; amount — к реальной уплате за вычетом свободной переплаты ЕНС
      - `expectation` boolean: Строка ожидания, а не долга: счёт и этап договора обещают деньги, но требовать по ним нельзя
      - `undated` boolean: Обязательство без срока оплаты: рядом со шкалой, а не на ней
      - `withheld_from_payout` boolean: Сумма удерживается контрагентом из будущей выплаты нам, а не уходит переводом: строка стоит во входящих с отрицательной суммой (неделя маркетплейса с перевесом возвратов)
      - `request_status` 'planned' | 'sent' | 'awaiting_signature': Состояние заявки на оплату у происхождения payment_request: status строки всегда planned, а это поле говорит, лежит ли платёжка уже в банке
      - `fact` FinancePaymentFact
        - `document_id` string, uuid, required
        - `kind` 'bank' | 'cash', required
        - `number` string, required
        - `date` string, date, required
        - `direction` 'in' | 'out', required
        - `amount` string, required
        - `currency` string, required
        - `source_name` string, required
        - `counterparty` string, required
        - `purpose` string, required
        - `used_by_plan_id` string, uuid
        - `item` string, uuid
        - `item_name` string: Название статьи ДДС; пусто у неразнесённой операции
        - `allocated` boolean, required: Разнесена ли операция: есть ли у неё статья ДДС. Тот же признак отдаёт журнал кассы, и ответ на этот вопрос у обоих один.
  - `companies` FinancePaymentCalendarCompany[], required
    - `id` string, uuid
    - `name` string, required
    - `opening` string, required
    - `overdue_net` string, required: Просроченное по юрлицу — приход минус выплата; входит в closing с первого дня окна
    - `inflow` string, required
    - `outflow` string, required
    - `closing` string, required
    - `sources` FinancePaymentCalendarSource[], required
      - `id` string, uuid, required
      - `kind` 'bank' | 'cash' | 'unset', required
      - `name` string, required
      - `currency` string, required
      - `opening` string, required
      - `overdue_net` string, required: Просроченное по месту хранения — приход минус выплата; на шкалу не ложится и входит в closing с первого дня окна
      - `inflow` string, required
      - `outflow` string, required
      - `closing` string, required
      - `cells` FinancePaymentCalendarCell[], required
        - `inflow` string, required
        - `outflow` string, required
        - `delta` string, required
        - `balance` string, required
        - `negative` boolean, required
    - `cells` FinancePaymentCalendarCell[], required
      - `inflow` string, required
      - `outflow` string, required
      - `delta` string, required
      - `balance` string, required
      - `negative` boolean, required
  - `step` 'day' | 'month' | 'quarter', required
  - `periods` FinancePaymentCalendarPeriod[], required
    - `key` string, required
    - `from` string, date, required
    - `to` string, date, required
    - `partial` boolean, required
  - `totals` FinancePaymentCalendarCell[], required
    - `inflow` string, required
    - `outflow` string, required
    - `delta` string, required
    - `balance` string, required
    - `negative` boolean, required
  - `days` FinancePaymentCalendarDay[], required
    - `date` string, date, required
    - `inflow` string, required
    - `outflow` string, required
    - `balance` string, required
    - `negative` boolean, required
  - `rows` FinancePaymentCalendarRow[], required
    - `original_amount` string
    - `original_currency` string
    - `project_id` string, uuid
    - `id` string, uuid, required
    - `origin` 'manual' | 'receivable' | 'payable' | 'payment_request' | 'contract_stage' | 'invoice' | 'contract_rule' | 'tax', required
    - `date` string, date, required
    - `direction` 'in' | 'out', required
    - `amount` string, required
    - `currency` string, required
    - `source_kind` 'bank' | 'cash' | 'unset', required
    - `source_id` string, uuid
    - `source_name` string, required
    - `title` string, required
    - `note` string, required
    - `contact_id` string, uuid
    - `contact_name` string, required
    - `item_id` string, uuid
    - `item_name` string, required
    - `company_id` string, uuid
    - `company_name` string, required
    - `status` string, required
    - `executed_on` string, date
    - `overdue` boolean, required
    - `document_id` string, uuid
    - `operation_id` string, uuid
    - `operation_kind` 'sale' | 'purchase'
    - `operation_version` integer
    - `contract_id` string, uuid
    - `invoice_id` string, uuid
    - `tax_kind` string: Вид налога у происхождения tax
    - `tax_period` string: Месяц начисления налога в виде ГГГГ-ММ
    - `tax_accrued` string: Полная начисленная сумма налога; amount — к реальной уплате за вычетом свободной переплаты ЕНС
    - `expectation` boolean: Строка ожидания, а не долга: счёт и этап договора обещают деньги, но требовать по ним нельзя
    - `undated` boolean: Обязательство без срока оплаты: рядом со шкалой, а не на ней
    - `withheld_from_payout` boolean: Сумма удерживается контрагентом из будущей выплаты нам, а не уходит переводом: строка стоит во входящих с отрицательной суммой (неделя маркетплейса с перевесом возвратов)
    - `request_status` 'planned' | 'sent' | 'awaiting_signature': Состояние заявки на оплату у происхождения payment_request: status строки всегда planned, а это поле говорит, лежит ли платёжка уже в банке
    - `fact` FinancePaymentFact
      - `document_id` string, uuid, required
      - `kind` 'bank' | 'cash', required
      - `number` string, required
      - `date` string, date, required
      - `direction` 'in' | 'out', required
      - `amount` string, required
      - `currency` string, required
      - `source_name` string, required
      - `counterparty` string, required
      - `purpose` string, required
      - `used_by_plan_id` string, uuid
      - `item` string, uuid
      - `item_name` string: Название статьи ДДС; пусто у неразнесённой операции
      - `allocated` boolean, required: Разнесена ли операция: есть ли у неё статья ДДС. Тот же признак отдаёт журнал кассы, и ответ на этот вопрос у обоих один.
  - `overdue` FinancePaymentCalendarRow[], required
    - `original_amount` string
    - `original_currency` string
    - `project_id` string, uuid
    - `id` string, uuid, required
    - `origin` 'manual' | 'receivable' | 'payable' | 'payment_request' | 'contract_stage' | 'invoice' | 'contract_rule' | 'tax', required
    - `date` string, date, required
    - `direction` 'in' | 'out', required
    - `amount` string, required
    - `currency` string, required
    - `source_kind` 'bank' | 'cash' | 'unset', required
    - `source_id` string, uuid
    - `source_name` string, required
    - `title` string, required
    - `note` string, required
    - `contact_id` string, uuid
    - `contact_name` string, required
    - `item_id` string, uuid
    - `item_name` string, required
    - `company_id` string, uuid
    - `company_name` string, required
    - `status` string, required
    - `executed_on` string, date
    - `overdue` boolean, required
    - `document_id` string, uuid
    - `operation_id` string, uuid
    - `operation_kind` 'sale' | 'purchase'
    - `operation_version` integer
    - `contract_id` string, uuid
    - `invoice_id` string, uuid
    - `tax_kind` string: Вид налога у происхождения tax
    - `tax_period` string: Месяц начисления налога в виде ГГГГ-ММ
    - `tax_accrued` string: Полная начисленная сумма налога; amount — к реальной уплате за вычетом свободной переплаты ЕНС
    - `expectation` boolean: Строка ожидания, а не долга: счёт и этап договора обещают деньги, но требовать по ним нельзя
    - `undated` boolean: Обязательство без срока оплаты: рядом со шкалой, а не на ней
    - `withheld_from_payout` boolean: Сумма удерживается контрагентом из будущей выплаты нам, а не уходит переводом: строка стоит во входящих с отрицательной суммой (неделя маркетплейса с перевесом возвратов)
    - `request_status` 'planned' | 'sent' | 'awaiting_signature': Состояние заявки на оплату у происхождения payment_request: status строки всегда planned, а это поле говорит, лежит ли платёжка уже в банке
    - `fact` FinancePaymentFact
      - `document_id` string, uuid, required
      - `kind` 'bank' | 'cash', required
      - `number` string, required
      - `date` string, date, required
      - `direction` 'in' | 'out', required
      - `amount` string, required
      - `currency` string, required
      - `source_name` string, required
      - `counterparty` string, required
      - `purpose` string, required
      - `used_by_plan_id` string, uuid
      - `item` string, uuid
      - `item_name` string: Название статьи ДДС; пусто у неразнесённой операции
      - `allocated` boolean, required: Разнесена ли операция: есть ли у неё статья ДДС. Тот же признак отдаёт журнал кассы, и ответ на этот вопрос у обоих один.

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `503`: Учётные источники календаря недоступны

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)