Finance reports

Построить отчёт о прибылях и убытках

ОПиУ читает начисления, а не банковские операции; layout выбирает форму отчёта.

get/api/v1/finance/reports/pnl

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/finance/reports/pnl
  • 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

businessstring uuid

UUID управленческого бизнеса; без параметра — консолидация «Весь бизнес»

fromstring date
tostring date
layoutstring uuid
companystring

Разрез по юрлицу (UUID) или none — только движения без юрлица; без него — по всем.

projectstring

Разрез по проекту или путешествию; без него — по всем.

step'month' | 'quarter' | 'total'

Ширина колонки отчёта; неизвестное значение означает месяцы.

view'full' | 'summary'

Вид ответа: full (по умолчанию) — витрина целиком в каждой колонке; summary — итог периода один раз в корне, колонки с границами, ключевыми цифрами (figures) и системными строками макета (system_rows).

columnsstring

Колонки отчёта: period (по умолчанию, по шагу step) или ключ разреза, включённого в «Режимах учёта» (project, department, cfo). При разрезе период один: колонка на элемент верхнего уровня вместе с веткой, колонка none — без разреза, затем итог; сумма колонок равна отчёту без разбивки. Остатки денег — только в итоге. Больше 60 колонок — 400 finance.report.columns_too_many; выключенный разрез — 400 finance.report.columns_invalid.

parentstring

С columns=<древовидный разрез>: UUID узла, ветку которого раскрыть — колонки становятся его детьми (каждый с веткой) плюс node:<id> для сумм на самом узле; отчёт ограничен этой веткой.

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Response

ОПиУ за период и колонки по выбранному шагу

rnp_metricsobject

Показатели из системных ролей макета; revenue — строка «Выручка» макета, а без неё — revenue отчёта

currencystring
view'summary'

Есть только в сводном виде

fromstring date required
tostring date required
revenuestring required

Сумма положительных оборотов статей на счетах результата: выручка, прочие доходы, положительная курсовая; не строка «Выручка» макета

expensestring required

Сумма отрицательных оборотов статей и налогов раздела «Налоги»

profitstring required

revenue + expense — прибыль по книге и управленческим суммам вне книги

unclassified_instring required
unclassified_outstring required
taxes_totalstring

Итог строки «Налоги»; входит в расходы и прибыль

taxes_not_allocatedboolean

Отбор по проекту или разрезу учёта — налоги начислены на юрлицо и на этот разрез не распределяются

accounting_basis'cash' | 'accrual' | 'mixed'

Основание, на котором сведён отчёт: метод учёта бизнесов его разреза. cash — выручку признают деньги, accrual — выручку создаёт сделка, mixed — в разрез попали оба основания (разные бизнесы либо период, пересекающий дату перехода). Поля нет, когда подписывать нечем: бизнесов в разрезе не нашлось. Кассовые ОПиУ и баланс правдивы, но отвечают не на тот вопрос, что отчёты по начислению, и обязаны быть отличимы по подписи, а не по догадке читателя.

Changes

No recorded changes to this operation across all 1 revision of this API.