Отчёт о продажах

GET /api/v1/reports/sales?from={YYYY-MM-DD}&to={YYYY-MM-DD}

Продажи, возвраты, комиссия и сумма к перечислению за период с разбивкой по сеансам. Правила расчёта — в руководстве Сверка продаж.

Параметры запроса

Параметр	Тип	Описание
from	date	Начало периода, YYYY-MM-DD, включительно. Обязателен
to	date	Конец периода, YYYY-MM-DD, включительно. Обязателен

Даты трактуются по времени Бишкека (+06:00). Период — от 1 до 366 дней.

Пример

curl "https://gateway.ticket.kg/api/v1/reports/sales?from=2026-10-01&to=2026-10-31" \
  -H "X-API-Key: $KEY"

{
  "data": {
    "from": "2026-10-01T00:00:00+06:00",
    "to": "2026-11-01T00:00:00+06:00",
    "currency": "KGS",
    "commission_rate": 5,
    "sold_count": 42,
    "sold_amount": 63000,
    "refunded_count": 2,
    "refunded_amount": 3000,
    "net_amount": 60000,
    "commission": 3000,
    "payable_amount": 57000,
    "lines": [
      {
        "event_item_id": 2505,
        "event_id": 1978,
        "event_name": "Симфонический оркестр. Осенний концерт",
        "event_date": "2026-11-15T19:00:00+06:00",
        "sold_count": 30,
        "sold_amount": 45000,
        "refunded_count": 2,
        "refunded_amount": 3000,
        "net_amount": 42000,
        "commission": 2100
      },
      {
        "event_item_id": 2610,
        "event_id": 2011,
        "event_name": "Детский спектакль «Щелкунчик»",
        "event_date": "2026-12-20T12:00:00+06:00",
        "sold_count": 12,
        "sold_amount": 18000,
        "refunded_count": 0,
        "refunded_amount": 0,
        "net_amount": 18000,
        "commission": 900
      }
    ]
  }
}

Поля ответа

Поле	Тип	Описание
from	datetime	Начало периода (включительно)
to	datetime	Конец периода (не включительно) — следующий день после to из запроса
currency	string	KGS
commission_rate	number	Комиссия партнёра, %
sold_count	integer	Продано билетов
sold_amount	integer	Сумма продаж
refunded_count	integer	Возвращено билетов
refunded_amount	integer	Сумма возвратов
net_amount	integer	sold_amount − refunded_amount
commission	number	net_amount × commission_rate / 100
payable_amount	number	net_amount − commission — сумма к перечислению
lines	object[]	Разбивка по сеансам, по дате сеанса

Поля строки lines[]:

Поле	Тип	Описание
event_item_id	integer	ID сеанса
event_id	integer	ID мероприятия. Нет в строках только с возвратами
event_name	string	Название мероприятия. Нет в строках только с возвратами
event_date	datetime	Дата сеанса. Нет в строках только с возвратами
sold_count, sold_amount	integer	Продажи по сеансу
refunded_count, refunded_amount	integer	Возвраты по сеансу
net_amount	integer	Нетто по сеансу
commission	number	Комиссия по сеансу

INFO

Комиссия в строках и в итоге округляется до двух знаков отдельно, поэтому сумма lines[].commission может отличаться от commission на копейки.

Ошибки

HTTP	code	Причина
400	validation_error	from или to не в формате YYYY-MM-DD
400	validation_error	to раньше from или период длиннее 366 дней