Войдирование билета#

Аннулирование (войдирование) выписанного билета без штрафов и сборов.

Описание#

Эндпоинт: POST /api/avia/ticket_cancel

Операция войдирования позволяет отменить выписанный билет без взимания штрафов (см. условия).

Использование#

Используйте этот запрос для отмены ошибочно выписанного билета или при отказе клиента от покупки сразу после выписки.

Основной сценарий#

Билет был выписан через /api/avia/ticket_issue
Обнаружена ошибка или клиент отказался от покупки
Выполните войдирование билета в течение допустимого времени
Билет аннулируется без штрафов
Средства возвращаются на баланс

Базовый пример#

Минимальный запрос для войдирования билета:

1{
2  "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc",
3  "ticketNumber": "555-6170036872"
4}

Успешный ответ (пустой объект подтверждает выполнение):

1{}

Детальная документация#

Параметры запроса — описание параметров запроса
Структура ответа — детальное описание структуры ответа

Когда использовать#

Ошибка при выписке#

Если билет выписан с ошибкой (неправильные данные пассажира, даты):

1{
2  "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc",
3  "ticketNumber": "555-6170036872"
4}

Отказ клиента сразу после покупки#

Клиент передумал покупать билет сразу после оплаты.

Тестовая выписка#

Войдирование тестовых билетов в тестовой среде.

Важные ограничения#

Временные рамки#

Критично: Войдирование возможно только в день выписки:

До конца суток по времени GDS (обычно до 23:59 локального времени системы)
Билет не должен быть использован (ни один купон)
Билет не должен изменяться после выписки
Зависит от: Правил авиакомпании и типа тарифа

Корнер-кейсы: Войдирование может быть недоступно, даже если билет выписан сегодня:
За 2-3 часа до вылета - некоторые авиакомпании запрещают void (билет в системе регистрации)
После check-in пассажира - войдирование невозможно
Решение: используйте возврат /api/avia/ticket_refund по правилам тарифа

Условия войдирования#

Условие	Требование
Время после выписки	В пределах допустимого окна
Использование билета	Ни один купон не использован
Статус бронирования	Активное бронирование
Тип операции	Первичная выписка (не обмен)

Отличие от возврата#

Операция	Войдирование (Void)	Возврат (Refund)
Временные рамки	В день выписки (до конца суток)	В любое время
Штрафы	Нет	Да (обычно)
Возврат средств	Полный	Частичный

Типичные ошибки#

Код ошибки	Причина	Решение
`BOOKING_NOT_FOUND`	Бронирование не найдено или не принадлежит клиенту	Проверьте `bookingId`
`VALIDATION_ERROR`	Ошибка валидации запроса (HTTP 400)	Проверьте обязательные поля и форматы значений
`NO_TARGETS`	Под запрос не нашлось ни одного поставщика: ни один не настроен либо все отсеяны на этапе подготовки запроса	Проверьте настройки офисов и пресетов в личном кабинете; при сохранении ошибки обратитесь в поддержку
`SUPPLIER_ERROR`	Поставщик вернул ошибку. Причина — текстом поставщика в поле `message`	Разберите `message`; при необходимости повторите запрос позже
`SYSTEM_ERROR`	Внутренняя ошибка Travel API	Повторите запрос позже; при повторении обратитесь в поддержку с `errorId`

Ошибки, пришедшие от GDS/NDC-поставщика, возвращаются под кодом SUPPLIER_ERROR: отдельного кода на каждую причину отказа Travel API не формирует, причина передаётся текстом поставщика в поле message. Не завязывайте логику на разбор message — его формат зависит от поставщика и не фиксирован.

Связанные операции#

Выписка билета - выписка билетов
Информация о билете - проверка статуса
Возврат билета - возврат с штрафами (если войдирование невозможно)
Получение PNR - проверка статуса бронирования