Перейти к содержимому

Выгрузка продаж и выручки

Два похожих запроса решаются разными методами:

Что нужно Метод Гранулярность
Сводная выручка по магазинам за дату 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&currency=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 нужен всегда.