Report pos
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/pos/summary/chart
POS summary chart (sales + income + expense combined time series).
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": [
{
"label": "string",
"value": 0
}
],
"time": "2025-05-01T12:00:00Z"
}POST /reports/pos/summary/sale/chart
POS sales chart over the reporting window.
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/pos/summary/chart.
POST /reports/pos/summary/income/chart
POS income chart over the reporting window.
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/pos/summary/chart.
POST /reports/pos/summary/expense/chart
POS expense chart over the reporting window.
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/pos/summary/chart.
POST /reports/pos/summary/debt/get-summary
Aggregate POS-issued customer debt.
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/pos/summary/credit/get-summary
Aggregate POS-issued customer credit.
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/pos/summary/debt/get-summary.
POST /reports/pos/summary/debt/paging
Paginated POS debt rows.
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/pos/summary/credit/paging
Paginated POS credit rows.
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/pos/summary/debt/paging.
POST /reports/pos/summary/product/get-summary
Aggregate POS product (finished-goods) summary.
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/pos/summary/debt/get-summary.
POST /reports/pos/summary/material/get-summary
Aggregate POS material (raw-material) summary.
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/pos/summary/debt/get-summary.
POST /reports/pos/summary/semi-product/get-summary
Aggregate POS semi-product (work-in-progress) summary.
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/pos/summary/debt/get-summary.
POST /reports/pos/summary/product/chart-paging
Paginated POS product chart data.
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/pos/summary/debt/paging.
POST /reports/pos/summary/material/chart-paging
Paginated POS material chart data.
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/pos/summary/debt/paging.
POST /reports/pos/summary/semi-product/chart-paging
Paginated POS semi-product chart data.
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/pos/summary/debt/paging.
POST /reports/pos/summary/goods/by-price/total
Total goods valuation grouped by price.
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/pos/summary/debt/get-summary.
POST /reports/pos/summary/goods/by-price/paging
Paginated goods rows grouped by price.
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/pos/summary/debt/paging.
POST /reports/pos/sales/by-payment-method-paging
POS 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/pos/summary/debt/paging.
POST /reports/pos/cashbox/income-expense
Cashbox income vs expense rollup for the POS.
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/pos/summary/debt/get-summary.
POST /reports/pos/sale/summary
POS sale summary (aggregate KPIs).
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/pos/summary/debt/get-summary.
POST /reports/pos/sale/summary/chart
POS sale summary chart time series.
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/pos/summary/chart.
POST /reports/pos/product/top
Top-N best-selling products in the POS.
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/pos/summary/debt/paging.
POST /reports/pos/employee/top
Top-N best-performing employees in the POS.
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/pos/summary/debt/paging.
POST /reports/pos/product/stock/summary
Product stock summary across the POS.
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/pos/summary/debt/get-summary.
POST /reports/pos/production/by-product/produced
Manufacturing 'produced' totals 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/pos/summary/debt/paging.
POST /reports/pos/production/by-product/used
Manufacturing 'used' totals grouped by product (raw materials).
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/pos/summary/debt/paging.
POST /reports/pos/cashflow/get
Cashflow report scoped to the POS.
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/pos/summary/debt/get-summary.
POST /reports/pos/finance/installment/get-summary
Installment summary for POS-issued sales.
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/pos/summary/debt/get-summary.
POST /reports/pos/finance/installment/get-paging
Paginated installment rows for POS-issued sales.
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/pos/summary/debt/paging.
POST /reports/pos/finance/installment/completed
Installments completed in the reporting window (POS).
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/pos/summary/debt/paging.
POST /reports/pos/dashboard/top/{key}
Top-N for the POS dashboard, by the given key.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | Yes |
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/pos/summary/debt/paging.
POST /reports/pos/trade/by-product/pagin
POS trade rollup 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/pos/summary/debt/paging.
This page is generated from the OpenAPI spec.