Report sales
INFO
Every response arrives in the shared envelope — code, message, messages, status_code, time — with the payload in data. The tables below describe what is inside data.
POST /reports/trade/pagin
Paginated list of trades for the reporting window.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
| Field | Type | Description |
|---|---|---|
list | object[] | |
total | number |
json
{
"code": 0,
"message": "Success",
"status_code": 200,
"data": {
"list": [
{}
],
"total": 0
},
"time": "2025-05-01T12:00:00Z"
}POST /reports/trade/by-product/pagin
Trade aggregation grouped by product.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
Same response shape as POST /reports/trade/pagin.
POST /reports/trade/by-customer/pagin
Trade aggregation grouped by customer.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
Same response shape as POST /reports/trade/pagin.
POST /reports/trade/items/pagin
Paginated list of individual trade line items.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
Same response shape as POST /reports/trade/pagin.
POST /reports/sales/items/unsold-paging
Products that have not been sold in the reporting window.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
Same response shape as POST /reports/trade/pagin.
POST /reports/sales/by-employee-pagin
Sales aggregated by employee (salesperson).
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
Same response shape as POST /reports/trade/pagin.
POST /reports/sales/by-payment-method-pagin
Sales aggregated by payment method.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
Same response shape as POST /reports/trade/pagin.
POST /reports/sales/by-category-pagin
Sales aggregated by product category.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
Same response shape as POST /reports/trade/pagin.
POST /reports/sales/by-category-all
Sales aggregated by category (full / non-paged variant).
Request body
| Field | Type | Required | Description |
|---|---|---|---|
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
json
{
"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"
}Response
json
{
"code": 0,
"message": "Success",
"status_code": 200,
"data": {},
"time": "2025-05-01T12:00:00Z"
}POST /reports/sales/by-mediator-pagin
Sales aggregated by mediator (broker / referrer).
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
Same response shape as POST /reports/trade/pagin.
POST /reports/sales/by-supplier-pagin
Sales aggregated by supplier (for products sourced from each supplier).
Request body
| Field | Type | Required | Description |
|---|---|---|---|
page | number | Yes | Default: 1 |
limit | number | Yes | Default: 20 |
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
search | string | No |
json
{
"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"
}Response
Same response shape as POST /reports/trade/pagin.
POST /reports/sales/settlements
Sales settlements report (cash-vs-bank / settlement reconciliation).
Request body
| Field | Type | Required | Description |
|---|---|---|---|
date_from | string (date-time) | No | Start of the reporting window. |
date_to | string (date-time) | No | End of the reporting window. |
organization_ids | string[] | No | |
warehouse_ids | string[] | No | |
currency_id | string | No | |
responsible_ids | string[] | No | |
customer_ids | string[] | No | |
supplier_ids | string[] | No | |
product_ids | string[] | No | |
category_ids | string[] | No | |
payment_method_ids | string[] | No | |
sort_by | string | No | Field name to sort by. |
sort_order | string | No | One of: asc, desc. Default: "desc" |
json
{
"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"
}Response
Same response shape as POST /reports/sales/by-category-all.
This page is generated from the OpenAPI spec.