Транзакции
GET
/v1/transaction-report-table
const url = 'https://api-admin.billz.ai/v1/transaction-report-table?start_date=2026-08-01&end_date=2026-08-31&shop_ids=09737a5c-19ee-4eb2-af02-4bdabf8a15e5%2Cb03661ba-731a-4e50-8f37-d220b89d718e&page=1&limit=10&price_type=0';const options = { method: 'GET', headers: { 'platform-id': '7d4a4c38-dd84-4902-b744-0488b80a4c01', Authorization: 'Bearer <token>' }};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api-admin.billz.ai/v1/transaction-report-table?start_date=2026-08-01&end_date=2026-08-31&shop_ids=09737a5c-19ee-4eb2-af02-4bdabf8a15e5%2Cb03661ba-731a-4e50-8f37-d220b89d718e&page=1&limit=10&price_type=0' \ --header 'Authorization: Bearer <token>' \ --header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01'Коды ошибок: 400 — ошибка валидации входных данных; 404 — объект не найден; 401, 403, 429, 500 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.
Authorizations
Заголовок раздела «Authorizations»Parameters
Заголовок раздела «Parameters»Query Parameters
Заголовок раздела «Query Parameters»start_date
string format: date
Example
2026-08-01Пусто → сегодня; формат YYYY-MM-DD, без времени
end_date
string format: date
Example
2026-08-31Пусто → start_date; всегда +24h; формат YYYY-MM-DD, без времени
shop_ids
Array<string>
Каждый элемент обязан быть UUID, иначе 400
Example
[ "09737a5c-19ee-4eb2-af02-4bdabf8a15e5", "b03661ba-731a-4e50-8f37-d220b89d718e"]seller_ids
Array<string>
cashier_ids
Array<string>
payment_type_ids
Array<string>
order_types
Array<string>
Допустимы только SALE, RETURN, EXCHANGE; иное → 400
page
integer format: int32
Нечисловое значение молча даёт 1
Example
1limit
integer format: int32
Нечисловое значение молча даёт 10
Example
10price_type
integer format: int32
Header Parameters
Заголовок раздела «Header Parameters»platform-id
string
Идентификатор платформы. Для интеграций используется статичное значение.
Responses
Заголовок раздела «Responses»Успешный ответ
Media typeapplication/json
object
rows
Array<object>
object
row_id
string
date
string
external_id
string
order_id
string
shop_id
string
shop_name
string
customer_name
string
customer_id
string
seller_ids
Array<string>
seller_names
Array<string>
cashier_id
string
cashier_name
string
order_type
string
sold_measurement_value
number
returned_measurement_value
number
total_price
number
discount_percent
integer
gross_sales
number
average_product_price
number
comment
string
is_modified
boolean
payments
Array<object>
object
payment_type_id
string
payment_type_name
string
sum
number
count
integer format: int32
Examplegenerated
{ "rows": [ { "row_id": "example", "date": "example", "external_id": "example", "order_id": "example", "shop_id": "example", "shop_name": "example", "customer_name": "example", "customer_id": "example", "seller_ids": [ "example" ], "seller_names": [ "example" ], "cashier_id": "example", "cashier_name": "example", "order_type": "example", "sold_measurement_value": 1, "returned_measurement_value": 1, "total_price": 1, "discount_percent": 1, "gross_sales": 1, "average_product_price": 1, "comment": "example", "is_modified": true, "payments": [ { "payment_type_id": "example", "payment_type_name": "example", "sum": 1 } ] } ], "count": 1}