Kontentga o'tish

Yig'ma

GET
/v1/general-report-table
curl --request GET \
--url 'https://api-admin.billz.ai/v1/general-report-table?start_date=2026-08-01&end_date=2026-08-31&shop_ids=fbfb9d6c-cbb2-43ab-8c90-e97d2eeb34d6%2C92302dfb-fa33-4e6a-8d19-87214852b25d&page=1&limit=10&detalization=day&currency=UZS&price_type=0&record=false' \
--header 'Authorization: Bearer <token>' \
--header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01'

Xato kodlari: 400 — kiruvchi ma’lumotlar validatsiya xatosi; 404 — obyekt topilmadi; 401, 403, 429, 500 — barcha metodlar uchun umumiy. Tana formatlari va semantikasi: Javob kodlari va xatolar.

start_date
string format: date
Example
2026-08-01

Format YYYY-MM-DD, vaqtsiz

end_date
string format: date
Example
2026-08-31

Format YYYY-MM-DD, vaqtsiz

shop_ids
Array<string>
Example
[
"fbfb9d6c-cbb2-43ab-8c90-e97d2eeb34d6",
"92302dfb-fa33-4e6a-8d19-87214852b25d"
]
page
integer format: int32
default: 1
Example
1
limit
integer format: int32
default: 10
Example
10
detalization
required
string
Allowed values: day week month year

Day|week|month|year

Example
day
currency
string
Example
UZS
price_type
integer format: int32
0
record
boolean
sort_field
string
sort_direction
string
platform-id
string
default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Platforma identifikatori. Integratsiyalar uchun statik qiymat ishlatiladi.

Muvaffaqiyatli javob

Media typeapplication/json
object
shop_stats_by_date

Jadval qatorlari

Array<object>
object
date
string
shop_id
string
shop_name
string
gross_sales
number
discount_sum
integer
discount_percent
integer
products_returned
number
products_exchanged
integer
returned_supply_price
number
returned_discount_price
integer
returned_retail_price
number
sales_supply_price
number
net_gross_sales
number
gross_profit
number
average_cheque
number
average_price
number
sales
number
average_measurement_value
number
average_discount
integer
average_extra_charge
number
products_sold
number
imported_measurement_value
number
imported_retail_price
number
imported_supply_price
number
transactions_count
integer
orders_count
integer
returns_count
integer
exchanges_count
integer
sales_per_square
number
left_products_start_date
number
left_products_supply_price_start_date
number
left_products_retail_price_start_date
number
left_products_end_date
number
left_products_supply_price_end_date
number
left_products_retail_price_end_date
number
target
integer
count

Qatorlarning umumiy soni

integer format: int32
Examplegenerated
{
"shop_stats_by_date": [
{
"date": "example",
"shop_id": "example",
"shop_name": "example",
"gross_sales": 1,
"discount_sum": 1,
"discount_percent": 1,
"products_returned": 1,
"products_exchanged": 1,
"returned_supply_price": 1,
"returned_discount_price": 1,
"returned_retail_price": 1,
"sales_supply_price": 1,
"net_gross_sales": 1,
"gross_profit": 1,
"average_cheque": 1,
"average_price": 1,
"sales": 1,
"average_measurement_value": 1,
"average_discount": 1,
"average_extra_charge": 1,
"products_sold": 1,
"imported_measurement_value": 1,
"imported_retail_price": 1,
"imported_supply_price": 1,
"transactions_count": 1,
"orders_count": 1,
"returns_count": 1,
"exchanges_count": 1,
"sales_per_square": 1,
"left_products_start_date": 1,
"left_products_supply_price_start_date": 1,
"left_products_retail_price_start_date": 1,
"left_products_end_date": 1,
"left_products_supply_price_end_date": 1,
"left_products_retail_price_end_date": 1,
"target": 1
}
],
"count": 1
}