Информация о билете (Ticket Info)#
Получение полной информации о выписанном билете.
Описание#
Эндпоинт: POST /avia/ticket_info
Возвращает детальную информацию о выписанном билете: данные пассажира, маршрут, цену, условия тарифа, номера купонов.
Использование#
Используйте этот запрос для получения полной информации о билете по его номеру.
Основной сценарий#
- Получите номер билета из ответа
/avia/ticket_issueили/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
- Дата выписки
- Офис продаж
- Локатор бронирования
Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|---|---|
TICKET_NOT_FOUND | Билет не найден | Проверьте номер билета |
BOOKING_NOT_FOUND | Бронирование не найдено | Проверьте bookingId |
INVALID_TICKET_NUMBER | Некорректный номер | Проверьте формат номера |
ACCESS_DENIED | Нет доступа | Проверьте права |
Связанные операции#
- Выписка билета - оформление билетов
- Получение PNR - получение номеров билетов из бронирования
- Обмен билета - изменение билета
- Возврат билета - возврат билета