Выгрузка продаж и выручки
Два похожих запроса решаются разными методами:
| Что нужно | Метод | Гранулярность |
|---|---|---|
| Сводная выручка по магазинам за дату | GET /v1/general-report-table |
магазин × дата |
| Разбивка по типам оплат | GET /v1/transaction-report-table |
транзакция |
Сводная выручка по магазинам
Заголовок раздела «Сводная выручка по магазинам»curl -X GET 'https://api-admin.billz.ai/v1/general-report-table?start_date=2026-08-22&end_date=2026-08-22&shop_ids=ID1,ID2¤cy=UZS&detalization=day&limit=50&page=1' \ -H 'Authorization: Bearer ТОКЕН'Строка отчёта — это пара «магазин × дата»:
| Поле | Что это |
|---|---|
date, shop_name |
дата и магазин |
gross_sales |
выручка |
net_gross_sales |
чистая выручка: gross_sales − скидки − возвраты |
gross_profit |
валовая прибыль |
discount_sum, discount_percent |
скидки |
transactions_count, orders_count, returns_count, exchanges_count |
количество транзакций по типам |
average_cheque, average_measurement_value |
средний чек и среднее число товаров в нём |
products_sold, products_returned |
штуки проданные и возвращённые |
Разбивка по типам оплат
Заголовок раздела «Разбивка по типам оплат»Когда нужно «сколько прошло наличными, сколько картой» — GET /v1/transaction-report-table,
итоги — GET /v1/transaction-report-totals. Справочник типов оплат для фильтра —
GET /v1/transaction-report-payments, названия типов — GET /v1/company-payment-type.
Готовый файл вместо постраничного чтения
Заголовок раздела «Готовый файл вместо постраничного чтения»У обоих отчётов есть парный метод, который собирает .xlsx в фоне и возвращает ссылку
на готовый файл: POST /v1/general-report-excel — сводный отчёт по магазину,
POST /v1/transaction-report-excel — транзакции. Один запрос вместо десятков страниц;
заголовок Billz-Response-Channel: HTTP при этом обязателен, без него ссылку
не получить. Параметры, колонки файла и полный список из шестнадцати отчётов —
в экспорте отчётов в Excel.
Все перечисленные отчёты входят в список маршрутов, доступных ключу интеграции.
Выдачу сужает список магазинов, доступных токену: переданные shop_ids пересекаются
с разрешёнными.
Регулярная выгрузка
Заголовок раздела «Регулярная выгрузка»- Вчерашний день забирается целиком один раз: продажа может быть отредактирована или возвращена задним числом.
- Даты в отчётах — в часовом поясе компании (Ташкент — UTC+5).
- Повтор с экспоненциальной выдержкой на
429нужен всегда.