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

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

Описание#

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

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

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

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

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

Создайте бронирование через /api/avia/pnr_create и получите bookingId
Запросите детали бронирования через /api/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`
`CURRENCY_RATE_NOT_AVAILABLE`	Нет курса для конвертации сумм в валюту отображения	Повторите запрос позже
`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 - отмена бронирования