Создание бронирования (PNR Create)#
Создание бронирования на основе выбранного предложения из результатов поиска.
Описание#
Эндпоинт: POST /avia/pnr_create
Создает бронирование с данными пассажиров для выбранного предложения. В ответе возвращается bookingId, pnrLocator и другие данные для последующих операций.
Использование#
Используйте этот запрос после выбора предложения из результатов поиска. Это второй шаг после search, перед выпиской билета.
Основной сценарий#
- Выполните поиск через
/avia/searchи получитеsearchId - Выберите подходящее предложение (получите
offerItemId) - Соберите данные пассажиров
- Отправьте запрос на создание бронирования
- Получите
bookingIdдля выписки билета
Базовый пример#
Минимальный запрос для создания бронирования:
1{
2 "searchId": "AAF6301E87DD7C73E7A8A636FDC77ED5",
3 "offerItemId": "DAB32144B940FCC65CC85E9BCE682346",
4 "passengers": [
5 {
6 "id": "P1",
7 "lastName": "IVANOV",
8 "firstName": "SVETLANA",
9 "type": "adt"
10 }
11 ]
12}Ответ содержит:
1{
2 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
3 "pnrLocator": "28C2D3",
4 "pnrOrderId": "69120-251022-OTT5447"
5}Детальная документация#
- Параметры запроса — полное описание всех параметров и примеры использования
- Структура ответа — детальное описание структуры ответа
Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|---|---|
OFFER_NOT_AVAILABLE | Предложение недоступно | Выполните новый поиск |
PRICE_CHANGED | Цена изменилась | Покажите новую цену пользователю |
INVALID_PASSENGER_DATA | Неверные данные пассажира | Проверьте формат данных |
DUPLICATE_PASSENGER_ID | Дублирующийся ID пассажира | Используйте уникальные ID |
MISSING_REQUIRED_SSR | Отсутствует обязательный SSR | Добавьте требуемый SSR |
Связанные операции#
- Поиск билетов - получение списка предложений
- Выписка билета - оформление билетов для бронирования
- Получение бронирования - получение деталей бронирования