Отмена бронирования (PNR Cancel)#

Отмена существующего бронирования.

Описание#

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

Отменяет бронирование и освобождает места на рейсе. После отмены бронирование становится недоступным для выписки билетов.

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

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

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

Получите bookingId бронирования, которое нужно отменить
Отправьте запрос на отмену
Получите подтверждение отмены
Бронирование становится неактивным

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

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

1{
2  "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc"
3}

Успешный ответ:

1{}

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

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

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

Истечение срока оплаты#

Если пассажир не оплатил бронирование в установленный срок:

1{
2  "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc"
3}

Отказ пассажира#

Когда пассажир отказывается от поездки до оплаты.

Освобождение мест#

Для освобождения мест на рейсе, если бронирование больше не актуально.

Ошибка при бронировании#

Если при создании бронирования были допущены критические ошибки.

Важные моменты#

Невозможность отмены#

Отмена может быть недоступна в следующих случаях:

Билеты уже выписаны
Бронирование уже отменено
Перелет уже состоялся
Перевозчик не разрешает отмену

Последствия отмены#

После отмены бронирования:

Места освобождаются на рейсе
Бронирование становится недоступным для выписки
Восстановление может быть невозможно
Для нового бронирования потребуется повторный поиск

Проверка перед отменой#

Перед отменой рекомендуется:

Проверить статус бронирования через /api/avia/pnr_retrieve
Убедиться, что билеты не выписаны
Предупредить пассажира о последствиях

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

Код ошибки	Причина	Решение
`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 - создание бронирования
Получение PNR - проверка статуса перед отменой
Возврат билета - возврат выписанных билетов