Получение бронирования (PNR Retrieve)#

Получение полной информации о существующем бронировании.

Описание#

Эндпоинт: POST /avia/pnr_retrieve

Возвращает актуальную информацию о бронировании: данные пассажиров, маршрут, цены, статус, номера билетов (если выписаны).

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

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

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

Создайте бронирование через /avia/pnr_create и получите bookingId
Запросите детали бронирования через /avia/pnr_retrieve
Получите полную информацию: пассажиры, маршрут, цены, статус
При необходимости — используйте данные для отображения или модификации

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

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

1{
2  "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66"
3}

Ответ содержит полную информацию:

 1{
 2  "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
 3  "pnr": {
 4    "pnrLocator": "28C2D3",
 5    "cancelled": false,
 6    "passengers": [...],
 7    "itinerary": [...],
 8    "fareInfo": {...},
 9    "contacts": [...],
10    "tickets": [...]
11  }
12}

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

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

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

После создания бронирования#

Получите детали сразу после создания для отображения пользователю:

1{
2  "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66"
3}

Перед выпиской билета#

Проверьте актуальность данных перед оформлением билетов.

Проверка статуса#

Периодически проверяйте статус бронирования, особенно если оно долго не оплачивается.

Отображение истории#

Показывайте пользователю историю его бронирований.

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

Код ошибки	Причина	Решение
`BOOKING_NOT_FOUND`	Бронирование не найдено	Проверьте bookingId
`BOOKING_CANCELLED`	Бронирование отменено	Показано в поле cancelled
`INVALID_BOOKING_ID`	Некорректный bookingId	Проверьте формат ID
`ACCESS_DENIED`	Нет доступа к бронированию	Проверьте права пользователя

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

Создание PNR - создание бронирования
Выписка билета - оформление билетов для бронирования
Отмена PNR - отмена бронирования