ОПИСАНИЕ ДАННЫХ БИЛЕТА
отправляемых по триггеру "билет возвращен" через систему уведомлений на URL в формате JSON
версия от 01.10.2024
ОПИСАНИЕ ДАННЫХ БИЛЕТА
отправляемых по триггеру "билет возвращен" через систему уведомлений на URL в формате JSON
версия от 01.10.2024
Система уведомлений отправляет данные методом POST. На указанном адресе система пользователя должна принимать передаваемые платформой данные, и в случае успеха, присылать в ответ код 200 ОК.
Иначе, в течение суток сервер BIL24 будет периодически повторять отправку уведомления.
Типы полей:
число int - целое значение в диапазоне от -2 147 483 648 до 2 147 483 647
число Uint - целое беззнаковое значение в диапазоне от 0 до 2 147 483 647
число long - целое значение в диапазоне от -9 223 372 036 854 775 808 до 9 223 372 036 854 775 807
число Ulong - целое беззнаковое значение в диапазоне от 0 до 9 223 372 036 854 775 807
число cur - вещественное значение, содержащее до 4 знаков после точки, например 134.7445
boolean - литерал принимающий значения true или false
строка - строковое значение неограниченной длины
Состав полей уведомления:
| Поле | Тип | Обязательность | Описание |
| id | число Ulong | Обязательное | id уведомления |
| created | строка | Обязательное | дата и время создания уведомления в формате ISO-8601 в часовом поясе UTC+00:00 |
| type | строка | Обязательное | тип триггера, например, ticket.refunded (билет возвращен) |
| data | объект | Обязательное | Данные билета для триггера "билет возвращен" ( ticket.refunded) |
data:
| Поле | Тип | Обязательность | Описание |
| id | число Ulong | Обязательное | id билета |
| seatId | число Ulong | Обязательное | id места |
| orderId | число Ulong | Обязательное | id заказа |
| seatLocation | объект | Необязательное | координаты мест (сектор, ряд, место), только для мест с размещением |
| category | строка | Обязательное | название ценовой категории |
| tariff | строка | Необязательное | название тарифа |
| price | число cur | Обязательное | номинальная цена билета |
| discount | число cur | Обязательное | размер скидки в денежных единицах (валюте) |
| charge | число cur | Обязательное | сервисный сбор в денежных единицах (валюте) |
| totalPrice | число cur | Обязательное | итоговая стоимость билета с учетом скидки и сервисного сбора |
| discountReason | строка | Необязательное | причина скидки |
| barcode | строка | Обязательное | штрихкод билета |
| barcodeFormat | объект | Обязательное | формат штрихкода |
| actionEvent | объект | Обязательное | сеанс, на который приобретен билет |
| holderStatus | строка | Обязательное | Статус использования билетов |
| refundDate | строка | Необязательное | дата и время возврата в формате ISO-8601 в часовом поясе UTC+00:00 |
| refundPrice | число cur | Необязательное | сумма возврата |