Выписка и управление билетами#

Операции для выписки билетов и управления ими.

Доступные операции#

Выписка билета (Ticket Issue)#

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

Выписка билетов на основе созданного бронирования.

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

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

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

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

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

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

• Просмотр деталей билета
• Проверка статуса купонов
• Получение информации для пассажира

Войдирование билета (Ticket Cancel)#

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

Отмена (войдирование) выписанного билета.

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

• Аннуляция только что выписанного билета
• Отмена в пределах временного окна
• Исправление ошибок при выписке

Расчёт обмена (Ticket Exchange Calculation)#

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

Расчёт стоимости обмена билета на новые рейсы: варианты предложений, доплата, штрафы. Возвращает exchangeId, необходимый для выполнения обмена.

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

• Первый шаг обмена: показать клиенту варианты и стоимость до подтверждения
• Оценка доплаты при изменении дат или маршрута

Обмен билета (Ticket Exchange)#

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

Выполнение обмена по результату расчёта (exchangeId): аннуляция старого билета и выписка нового.

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

• Второй шаг обмена после подтверждения клиентом выбранного варианта
• Обмен по правилам тарифа

Расчёт возврата (Ticket Refund Calculation)#

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

Расчёт суммы к возврату по билету с учётом штрафов и такс.

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

• Первый шаг возврата: показать клиенту сумму до подтверждения
• Проверка условий возврата по правилам тарифа

Возврат билета (Ticket Refund)#

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

Выполнение возврата выписанного билета.

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

• Второй шаг возврата после подтверждения клиентом суммы
• Возврат неиспользованного билета по правилам тарифа

Типичный сценарий#

graph LR
    A[PNR Create] --> B[Ticket Issue]
    B --> C{Нужны изменения?}
    C -->|Войдирование| D[Ticket Cancel]
    C -->|Изменение| E1[Ticket Exchange Calculation]
    E1 --> E2[Ticket Exchange]
    C -->|Возврат| F1[Ticket Refund Calculation]
    F1 --> F2[Ticket Refund]
    C -->|Информация| G[Ticket Info]

1. Создайте бронирование через /api/avia/pnr_create
2. Выпишите билеты через /api/avia/ticket_issue
3. При необходимости:
   • Войдируйте билет через /api/avia/ticket_cancel
   • Обменяйте: сначала расчёт /api/avia/ticket_exchange_calculation, затем /api/avia/ticket_exchange с полученным exchangeId
   • Верните: сначала расчёт /api/avia/ticket_refund_calculation, затем /api/avia/ticket_refund