Войдирование билета#
Отмена (войдирование/void) выписанного билета в течение 24 часов после выписки.
Эндпоинт: POST /avia/ticket_cancel
Описание#
Операция позволяет отменить (войдировать) выписанный билет без штрафов в течение установленного временного окна (обычно 24 часа). Войдирование доступно только для неиспользованных билетов.
Когда использовать#
- Аннуляция ошибочно выписанного билета
- Отмена билета сразу после выписки
- Исправление ошибок в данных билета
- Возврат средств без штрафов (в пределах временного окна)
Параметры запроса#
Обязательные параметры#
| Параметр | Тип | Описание |
|---|---|---|
bookingId | string (UUID) | Идентификатор бронирования |
ticketNumber | string | Номер билета для отмены (13 цифр) |
Пример запроса#
1{
2 "bookingId": "b1234567-89ab-cdef-0123-456789abcdef",
3 "ticketNumber": "5552123456789"
4}Примеры ответов#
Успешный ответ#
Развернуть пример
1{
2 "success": true,
3 "voidedAt": "2025-12-10T17:45:00Z"
4}Ответ с ошибкой - истекло время#
1{
2 "success": false,
3 "error": {
4 "code": "VOID_TIME_EXPIRED",
5 "message": "Время для войдирования истекло",
6 "description": "Билет может быть войдирован только в течение 24 часов после выписки"
7 }
8}Ответ с ошибкой - билет использован#
1{
2 "success": false,
3 "error": {
4 "code": "TICKET_USED",
5 "message": "Билет уже использован",
6 "description": "Невозможно войдировать билет с использованными купонами"
7 }
8}Структура ответа#
TicketCancelResponse#
| Поле | Тип | Описание |
|---|---|---|
success | boolean | Признак успешного войдирования |
voidedAt | string (datetime) | Дата и время войдирования |
error | Error | Информация об ошибке (если есть) |
Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|---|---|
TICKET_NOT_FOUND | Билет не найден | Проверьте номер билета |
VOID_TIME_EXPIRED | Истекло время для войдирования | Используйте операцию возврата |
TICKET_USED | Билет уже использован | Войдирование невозможно |
ALREADY_VOIDED | Билет уже войдирован | Билет был отменен ранее |
VOID_NOT_ALLOWED | Войдирование запрещено | Проверьте условия тарифа |
Важные замечания#
Важно:
- Войдирование доступно только в течение ограниченного времени (обычно 24 часа)
- После войдирования билет полностью аннулируется
- Деньги возвращаются без штрафов
- Войдированный билет нельзя восстановить
- Все купоны билета должны быть в статусе OK (не использованы)
Обратите внимание:
- Временное окно для войдирования зависит от авиакомпании (обычно 24 часа)
- Если время истекло, используйте операцию возврата
/avia/ticket_refund- Войдирование - это технический возврат без применения штрафов
- После войдирования места на рейсе освобождаются
Разница между Void и Refund#
| Характеристика | Void (Войдирование) | Refund (Возврат) |
|---|---|---|
| Временное окно | 24 часа после выписки | Любое время до вылета |
| Штрафы | Без штрафов | Согласно правилам тарифа |
| Условия | Билет не использован | По правилам тарифа |
| Скорость возврата | Мгновенно | Зависит от тарифа |
Процесс войдирования#
graph TD
A[Запрос на войдирование] --> B{Проверка времени}
B -->|> 24ч| C[Ошибка: VOID_TIME_EXPIRED]
B -->|≤ 24ч| D{Билет использован?}
D -->|Да| E[Ошибка: TICKET_USED]
D -->|Нет| F[Войдировать билет]
F --> G[Возврат средств]
G --> H[Успех]Связанные операции#
- Выписка билета (Ticket Issue) — для выписки билета
- Информация о билете (Ticket Info) — для проверки статуса
- Возврат билета (Ticket Refund) — для возврата с применением штрафов