Отчёты: OLAP продаж #

Отчёты нужны, чтобы загружать данные заведения в свою аналитику: Power BI, Looker Studio, Metabase, Excel или собственный дашборд.

В разделе три вида методов:

Доступ #

Отчёты содержат выручку, себестоимость и зарплаты, поэтому обычный ключ их не видит. Заведение включает доступ на конкретном ключе: Интеграции → API-ключи → ключ → «Доступ к отчётам».

Без галочки любой метод раздела вернёт 403:

{ "message": "У ключа нет доступа к отчётам. Включите его в кабинете: Интеграции → API-ключи" }

Как считаются цифры #

Отчёты считаются по тем же правилам, что аналитика в кабинете Mison, поэтому ваши цифры совпадут с тем, что видит заведение.

• Бизнес-день. Чек относится к дню своего закрытия. Если у точки день начинается не в полночь (например, в 03:00), чек, закрытый 25.09 в 02:00, попадёт в 24.09.
• Только закрытые чеки. Открытые, отменённые и удалённые чеки в продажи не входят.
• Возврат — отдельный документ. Он ложится на дату возврата, а не на дату чека: продажи прошлого месяца после возврата не меняются. Поэтому в отчётах есть отдельные показатели return_* и net_* — выручка за вычетом возвратов.
• Обслуживание и доставка входят в выручку чека (ORDERS), но не в продажи товаров (SALES).
• Сегодняшний день неполный. Его можно запрашивать, но цифры будут расти до закрытия дня. Для хранилища перезагружайте последние 2–3 дня каждую ночь: касса может досылать чеки с опозданием, а возврат может прийти через несколько дней.
• Деньги — в валюте заведения, числами с точностью до 2 знаков.

Поля отчёта #

GET /reports/olap/columns
GET /reports/olap/columns?report_type=SALES

Список группировок и показателей. Без параметра — по всем видам отчёта сразу.

{
  "report_type": "SALES",
  "title": "Продажи товаров: строка чека",
  "dimensions": [
    { "name": "date", "title": "Бизнес-день", "columns": ["date"] },
    { "name": "product", "title": "Товар (блюдо, модификатор)", "columns": ["product_id", "product_name"] }
  ],
  "measures": [
    { "name": "quantity", "title": "Продано, в единицах товара" }
  ]
}

columns — какие колонки появятся в строке ответа, если группировать по этому полю.

OLAP-отчёт #

POST /reports/olap

Вы выбираете вид отчёта, группировки и показатели — сервер возвращает таблицу. Метод ничего не меняет, повторять его безопасно.

{
  "report_type": "SALES",
  "date_from": "2026-09-01",
  "date_to": "2026-09-30",
  "group_by": ["date", "category"],
  "measures": ["quantity", "net_amount", "cost", "return_amount", "net_revenue"],
  "filters": {
    "point_ids": ["f40d9ea6-bb66-4d8a-9185-219916b68224"],
    "order_type_ids": [3]
  },
  "include_totals": true
}

{
  "report_type": "SALES",
  "date_from": "2026-09-01",
  "date_to": "2026-09-30",
  "group_by": ["date", "category"],
  "measures": ["quantity", "net_amount", "cost", "return_amount", "net_revenue"],
  "rows": [
    {
      "date": "2026-09-01",
      "category_id": 117,
      "category_name": "Донеры",
      "quantity": 412,
      "net_amount": 12360000,
      "cost": 5190000,
      "return_amount": 30000,
      "net_revenue": 12330000
    }
  ],
  "totals": {
    "quantity": 11840,
    "net_amount": 355200000,
    "cost": 149180000,
    "return_amount": 420000,
    "net_revenue": 354780000
  },
  "data_freshness": [
    {
      "point_id": "0e180d32-aa78-46b0-999e-4e10f4947d03",
      "point_name": "Чиланзар",
      "last_sync_at": "2026-10-05 21:26:04"
    }
  ]
}

data_freshness приходит всегда, по каждой точке запроса: last_sync_at — когда касса последний раз отдала чек в облако (время сервера, Ташкент).

Параметры #

Без order_by строки отсортированы по полям группировки в порядке group_by.

Фильтры #

Все фильтры — массивы чисел (у point_ids — строк). Точка чужого бренда в point_ids вернёт 404, а не пустой отчёт.

Виды отчёта #

Каждый вид считается по своей строке фактов. Разные виды не смешиваются в одном запросе — у каждого свои показатели.

SALES — продажи товаров #

Строка — позиция чека: блюдо или модификатор. Для меню, ABC-анализа и фудкоста.

Группировки: date, week, month, weekday, hour, point, order_type, order_type_sub, source, waiter, cashier, client, organization, region, district, product, category, menu.

Скидка на весь чек раскладывается на позиции пропорционально их сумме. Так net_amount по всем товарам сходится с суммой чеков после скидки.

Себестоимость берётся из чека — по средней цене ингредиентов на складе точки в момент продажи. Если ингредиент или заготовку списали в минус без прихода или приняли по нулевой цене, себестоимость блюда на этой точке занижена. Сравнивайте avg_cost в группировке point: сильный разброс между точками у одного блюда — повод проверить приходы.

ORDERS — чеки #

Строка — чек целиком. Для выручки, среднего чека, гостей и сравнения каналов.

Группировки: date, week, month, weekday, hour, point, order_type, order_type_sub, source, waiter, cashier, client, organization, region, district.

SALES считается по позициям, ORDERS — по итогам чеков. Если у чека итог не совпадает с позициями (так бывает у единичных чеков, исправленных на кассе), суммы двух отчётов разойдутся на доли процента. Для выручки берите ORDERS, для товаров — SALES.

Обслуживание входит в revenue, а в SALES не попадает: это не товар. Сколько обслуживания собрал официант — service_amount с группировкой waiter. Это сумма надбавки в чеках, а не зарплата: какая её доля положена официанту, задаёт его мотивационная программа — см. GET /reports/payroll.

PAYMENTS — оплаты #

Строка — оплата чека. Чек, оплаченный наличными и картой, даёт две строки.

Группировки: date, week, month, weekday, hour, point, order_type, order_type_sub, source, waiter, cashier, client, organization, region, district, payment_type, payment_category.

Сумма amount по всем типам оплат равна revenue из ORDERS за тот же период.

Группировки #

Возврат наследует у исходного чека тип заказа, подтип, источник, официанта и кассира, а дату и час берёт свои.

Идентификатор может быть null, например у чека без официанта. У чека без клиента client_id — null, у чека, не оплаченного в долг организации, null — organization_id. Регион и район берутся из карточки организации, поэтому у чека без организации они тоже null.

Папки меню #

GET /api/integrations/v1/reports/menu-folders
Authorization: Bearer <access_token>

Действующие папки меню бренда — id для фильтра menu_ids и группировки menu. Меню общее на бренд, поэтому без point_id.

{
  "folders": [
    { "id": 43037, "name": "Блюда", "parent_id": null, "path": "Блюда", "products_count": 32 },
    { "id": 43580, "name": "MANGAL", "parent_id": 43037, "path": "Блюда / MANGAL", "products_count": 19 }
  ]
}

Фильтр menu_ids берёт папку вместе со всеми вложенными. Товар, проданный из папки, которую потом удалили, в отчёте остаётся: группировка menu покажет и удалённую папку.

Примеры #

Выручка по дням и каналам:

{
  "report_type": "ORDERS",
  "date_from": "2026-09-01",
  "date_to": "2026-09-30",
  "group_by": ["date", "order_type", "source"],
  "measures": ["cheques_count", "revenue", "avg_cheque", "net_revenue"]
}

Тепловая карта по дням недели и часам:

{
  "report_type": "ORDERS",
  "date_from": "2026-07-01",
  "date_to": "2026-09-30",
  "group_by": ["weekday", "hour"],
  "measures": ["cheques_count", "revenue"]
}

ABC-анализ блюд с фудкостом:

{
  "report_type": "SALES",
  "date_from": "2026-09-01",
  "date_to": "2026-09-30",
  "group_by": ["product"],
  "measures": ["quantity", "net_revenue", "gross_profit", "food_cost_percent"],
  "include_totals": true
}

Самые и наименее прибыльные товары (запрос с order_by и limit; для «наименее» — "direction": "asc"):

{
  "report_type": "SALES",
  "date_from": "2026-09-01",
  "date_to": "2026-09-30",
  "group_by": ["product"],
  "measures": ["quantity", "gross_profit", "margin_percent"],
  "order_by": { "measure": "gross_profit", "direction": "desc" },
  "limit": 10
}

gross_profit — разница выручки и себестоимости. Себестоимость берётся из остатков склада: если у товара средняя цена закупки равна цене продажи, прибыль окажется нулевой — это данные склада, а не ошибка отчёта.

Кому в долг и сколько отпущено (организации-должники с товарами; строки без organization_id — обычные продажи, их отбросьте):

{
  "report_type": "SALES",
  "date_from": "2026-10-01",
  "date_to": "2026-10-01",
  "group_by": ["organization", "product"],
  "measures": ["quantity", "net_amount"],
  "filters": { "category_ids": [101] }
}

Продажи официантов:

{
  "report_type": "ORDERS",
  "date_from": "2026-09-01",
  "date_to": "2026-09-30",
  "group_by": ["point", "waiter"],
  "measures": ["cheques_count", "guests", "revenue", "avg_cheque"],
  "filters": { "order_type_ids": [1] }
}

Обслуживание по официантам за неделю:

{
  "report_type": "ORDERS",
  "date_from": "2026-09-28",
  "date_to": "2026-10-04",
  "group_by": ["point", "waiter"],
  "measures": ["cheques_count", "revenue", "service_cheques_count", "service_amount", "service_percent"],
  "order_by": { "measure": "service_amount", "direction": "desc" },
  "include_totals": true
}

Сколько продано из раздела меню (id папки — из GET /reports/menu-folders):

{
  "report_type": "SALES",
  "date_from": "2026-10-01",
  "date_to": "2026-10-04",
  "group_by": ["product"],
  "measures": ["quantity", "net_amount"],
  "filters": { "menu_ids": [43580] },
  "include_totals": true
}

Наличные и безнал по дням:

{
  "report_type": "PAYMENTS",
  "date_from": "2026-09-01",
  "date_to": "2026-09-30",
  "group_by": ["date", "payment_category"],
  "measures": ["amount", "return_amount", "net_amount"]
}

Ограничения #

Если запрос не укладывается, сервер вернёт 400 с объяснением. Сократите период, уберите группировку или разбейте запрос по точкам. Длинную историю загружайте помесячно.