Сверка продаж
Метод GET /reports/sales строит отчёт о ваших продажах за период. По нему удобно сверять взаиморасчёты с Ticket.kg.
bash
curl "https://gateway.ticket.kg/api/v1/reports/sales?from=2026-10-01&to=2026-10-31" \
-H "X-API-Key: $KEY"Период
fromиto— даты в форматеYYYY-MM-DD, обе включительно, по времени Бишкека (+06:00).- Длина периода — от 1 до 366 дней.
- В ответе поле
to— исключающая граница: дляto=2026-10-31вернётся2026-11-01T00:00:00+06:00.
Как считается отчёт
| Показатель | Что входит |
|---|---|
Продажи (sold_*) | Билеты, подтверждённые в этом периоде, — по дате подтверждения. Включая билеты, возвращённые позже |
Возвраты (refunded_*) | Билеты, возвращённые в этом периоде, — по дате возврата |
Нетто (net_amount) | Продажи минус возвраты |
Комиссия (commission) | net_amount × commission_rate / 100, округление до 2 знаков |
К перечислению (payable_amount) | net_amount − commission |
Возврат учитывается в том периоде, когда он произошёл. Поэтому отчёт за уже закрытый период не меняется задним числом, если билет вернули позже.
Пример
Билет за 1 500 сом продан 28 сентября и возвращён 3 октября.
- В отчёте за сентябрь: продажа 1 500, возврат 0.
- В отчёте за октябрь: продажа 0, возврат 1 500.
В отчёт попадают только билеты, проданные через шлюз вашим партнёрским аккаунтом.
Разбивка по сеансам
Поле lines содержит строку на каждый сеанс, по которому были продажи или возвраты в периоде. Строки отсортированы по дате сеанса.
Если по сеансу в периоде были только возвраты, а продажи — в другом периоде, в строке будет только event_item_id без названия и даты мероприятия.
Пример ответа и описание полей — в справочнике.