Информация о билете (Ticket Info)#

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

Описание#

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

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

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

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

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

Получите номер билета из ответа /api/avia/ticket_issue или /api/avia/pnr_retrieve
Запросите детальную информацию о билете
Получите полный документ билета с купонами и ценой
Используйте для отображения или печати билета

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

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

1{
2  "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
3  "ticketNumber": "425-6170037281"
4}

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

 1{
 2  "ticketDocument": {
 3    "ticket": {
 4      "number": "6170037281",
 5      "vendor": "425"
 6    },
 7    "passenger": {
 8      "firstName": "SVETLANA",
 9      "lastName": "IVANOV",
10      "type": "adt"
11    },
12    "coupons": [...],
13    "price": {
14      "total": {
15        "currencyCode": "RUB",
16        "value": 100
17      }
18    }
19  }
20}

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

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

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

Отображение билета пользователю#

Получите полную информацию для отображения билета:

1{
2  "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
3  "ticketNumber": "425-6170037281"
4}

Генерация PDF билета#

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

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

Проверьте использование купонов билета.

Получение условий тарифа#

Получите информацию об ограничениях и условиях (endorsements).

Информация в билете#

Документ билета содержит:

Данные пассажира#

ФИО
Тип пассажира (взрослый, ребенок, младенец)
Номер документа

Маршрут перевозки#

Список купонов (сегментов)
Информация о рейсах
Даты и время вылета/прилета
Терминалы

Ценовая информация#

Базовый тариф
Таксы и сборы
Общая стоимость
НДС

Условия и ограничения#

Код тарифа (fare basis)
Норма багажа
Ограничения (endorsements)
Класс бронирования

Служебная информация#

Номер билета
Код BSP/ARC
Дата выписки
Офис продаж
Локатор бронирования

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

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