Отмена бронирования (PNR Cancel)#
Отмена существующего бронирования.
Описание#
Эндпоинт: POST /avia/pnr_cancel
Отменяет бронирование и освобождает места на рейсе. После отмены бронирование становится недоступным для выписки билетов.
Использование#
Используйте этот запрос для отмены бронирования, если пассажир отказался от перелета или не оплатил билеты в срок.
Основной сценарий#
- Получите
bookingIdбронирования, которое нужно отменить - Отправьте запрос на отмену
- Получите подтверждение отмены
- Бронирование становится неактивным
Базовый пример#
Минимальный запрос для отмены бронирования:
1{
2 "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc"
3}Успешный ответ:
1{}Детальная документация#
- Параметры запроса — описание параметров запроса
- Структура ответа — детальное описание структуры ответа
Когда использовать#
Истечение срока оплаты#
Если пассажир не оплатил бронирование в установленный срок:
1{
2 "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc"
3}Отказ пассажира#
Когда пассажир отказывается от поездки до оплаты.
Освобождение мест#
Для освобождения мест на рейсе, если бронирование больше не актуально.
Ошибка при бронировании#
Если при создании бронирования были допущены критические ошибки.
Важные моменты#
Невозможность отмены#
Отмена может быть недоступна в следующих случаях:
- Билеты уже выписаны
- Бронирование уже отменено
- Перелет уже состоялся
- Перевозчик не разрешает отмену
Последствия отмены#
После отмены бронирования:
- Места освобождаются на рейсе
- Бронирование становится недоступным для выписки
- Восстановление может быть невозможно
- Для нового бронирования потребуется повторный поиск
Проверка перед отменой#
Перед отменой рекомендуется:
- Проверить статус бронирования через
/avia/pnr_retrieve - Убедиться, что билеты не выписаны
- Предупредить пассажира о последствиях
Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|---|---|
BOOKING_NOT_FOUND | Бронирование не найдено | Проверьте bookingId |
BOOKING_ALREADY_CANCELLED | Уже отменено | Бронирование уже неактивно |
TICKETS_ISSUED | Билеты выписаны | Используйте процедуру возврата билетов |
CANCELLATION_NOT_ALLOWED | Отмена запрещена | Свяжитесь с перевозчиком |
INVALID_BOOKING_ID | Некорректный ID | Проверьте формат bookingId |
Связанные операции#
- Создание PNR - создание бронирования
- Получение PNR - проверка статуса перед отменой
- Возврат билета - возврат выписанных билетов