Report finance
INFO
Каждый ответ приходит в общем конверте — code, message, messages, status_code, time — а полезная нагрузка лежит в data. Таблицы ниже описывают содержимое data.
POST /reports/balance/get
Current cashbox / account balance snapshot.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
{
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc"
}Ответ
{
"code": 0,
"message": "Success",
"status_code": 200,
"data": {},
"time": "2025-05-01T12:00:00Z"
}POST /reports/balance/get-at
Balance at a specific point in time.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
at | string (date-time) | Да |
{
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc",
"at": "2025-05-01T12:00:00Z"
}Ответ
Структура ответа совпадает с POST /reports/balance/get.
POST /reports/balance/items
Per-currency / per-account balance breakdown.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
{
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc"
}Ответ
| Поле | Тип | Описание |
|---|---|---|
list | object[] | |
total | number |
{
"code": 0,
"message": "Success",
"status_code": 200,
"data": {
"list": [
{}
],
"total": 0
},
"time": "2025-05-01T12:00:00Z"
}POST /reports/cashflow/get
Cashflow report for the reporting window (in + out + net).
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
{
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc"
}Ответ
Структура ответа совпадает с POST /reports/balance/get.
POST /reports/customer-debt/get
Aggregate of outstanding customer debt.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
{
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc"
}Ответ
Структура ответа совпадает с POST /reports/balance/get.
POST /reports/profit-loss/get
P&L report (revenue, COGS, expenses, net profit).
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
{
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc"
}Ответ
Структура ответа совпадает с POST /reports/balance/get.
POST /reports/finance/installment-plan/get-summary
Summary of installment-plan installments (debt, paid, due).
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
{
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc"
}Ответ
Структура ответа совпадает с POST /reports/balance/get.
POST /reports/finance/installment-plan/get-paging
Paginated list of installment plans.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
page | number | Да | По умолчанию: 1 |
limit | number | Да | По умолчанию: 20 |
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
search | string | Нет |
{
"page": 1,
"limit": 20,
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc",
"search": "string"
}Ответ
Структура ответа совпадает с POST /reports/balance/items.
POST /reports/finance/installment-plan/completed
Completed installment plans within the reporting window.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
page | number | Да | По умолчанию: 1 |
limit | number | Да | По умолчанию: 20 |
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
search | string | Нет |
{
"page": 1,
"limit": 20,
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc",
"search": "string"
}Ответ
Структура ответа совпадает с POST /reports/balance/items.
POST /reports/finance/customers-payment-overview/get-summary
Aggregate payment-overview metrics per customer.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
{
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc"
}Ответ
Структура ответа совпадает с POST /reports/balance/get.
POST /reports/finance/customers-payment-overview/get-paging
Paginated payment-overview rows per customer.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
page | number | Да | По умолчанию: 1 |
limit | number | Да | По умолчанию: 20 |
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
search | string | Нет |
{
"page": 1,
"limit": 20,
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc",
"search": "string"
}Ответ
Структура ответа совпадает с POST /reports/balance/items.
POST /reports/finance/customers-payment-overview/completed
Customers whose payment plan completed in the window.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
page | number | Да | По умолчанию: 1 |
limit | number | Да | По умолчанию: 20 |
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
search | string | Нет |
{
"page": 1,
"limit": 20,
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc",
"search": "string"
}Ответ
Структура ответа совпадает с POST /reports/balance/items.
POST /reports/summary/income/pagin
Paginated income summary rows.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
page | number | Да | По умолчанию: 1 |
limit | number | Да | По умолчанию: 20 |
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
search | string | Нет |
{
"page": 1,
"limit": 20,
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc",
"search": "string"
}Ответ
Структура ответа совпадает с POST /reports/balance/items.
POST /reports/summary/income-expense/stats
Aggregate income/expense statistics for the window.
Тело запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
date_from | string (date-time) | Нет | Start of the reporting window. |
date_to | string (date-time) | Нет | End of the reporting window. |
organization_ids | string[] | Нет | |
warehouse_ids | string[] | Нет | |
currency_id | string | Нет | |
responsible_ids | string[] | Нет | |
customer_ids | string[] | Нет | |
supplier_ids | string[] | Нет | |
product_ids | string[] | Нет | |
category_ids | string[] | Нет | |
payment_method_ids | string[] | Нет | |
sort_by | string | Нет | Field name to sort by. |
sort_order | string | Нет | Допустимые значения: asc, desc. По умолчанию: "desc" |
{
"date_from": "2025-05-01T12:00:00Z",
"date_to": "2025-05-01T12:00:00Z",
"organization_ids": [
"64b7f4d9e2b3b6a0b7c5d80a"
],
"warehouse_ids": [
"string"
],
"currency_id": "string",
"responsible_ids": [
"string"
],
"customer_ids": [
"string"
],
"supplier_ids": [
"string"
],
"product_ids": [
"string"
],
"category_ids": [
"string"
],
"payment_method_ids": [
"string"
],
"sort_by": "string",
"sort_order": "asc"
}Ответ
Структура ответа совпадает с POST /reports/balance/get.
Эта страница сгенерирована из спецификации OpenAPI.