Возврат билета#

Оформление возврата выписанного билета со штрафами и сборами согласно правилам тарифа.

Описание#

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

Операция возврата билета позволяет оформить возврат выписанного билета в любое время согласно правилам тарифа. В отличие от войдирования (void), возврат обычно сопровождается штрафами и сборами, но может быть выполнен и после истечения срока войдирования.

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

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

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

sequenceDiagram
    participant Client
    participant API

    Client->>API: POST /api/avia/ticket_refund_calculation
    API-->>Client: Сумма возврата

    Client->>API: POST /api/avia/ticket_refund<br/>{forRefund}
    API-->>Client: {}

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

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

1{
2  "bookingId": "019a0ce6-2633-787f-a6bc-5dbddc02cc1f",
3  "ticketNumber": "425-6170037294",
4  "forRefund": {
5    "currencyCode": "RUB",
6    "value": 5499
7  }
8}

Успешный ответ (пустой объект подтверждает выполнение):

1{}

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

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

Важные замечания#

Сумма возврата (forRefund)#

Параметр forRefund.value должен содержать рассчитанную сумму возврата с учетом:

Первоначальной стоимости билета
Штрафов за возврат
Невозвратных сборов
Использованных сегментов

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

Код ошибки	Причина	Решение
`BOOKING_NOT_FOUND`	Бронирование не найдено или не принадлежит клиенту	Проверьте `bookingId`
`VALIDATION_ERROR`	Ошибка валидации запроса (HTTP 400)	Проверьте обязательные поля и форматы значений
`NO_TARGETS`	Под запрос не нашлось ни одного поставщика: ни один не настроен либо все отсеяны на этапе подготовки запроса	Проверьте настройки офисов и пресетов в личном кабинете; при сохранении ошибки обратитесь в поддержку
`SUPPLIER_ERROR`	Поставщик вернул ошибку. Причина — текстом поставщика в поле `message`	Разберите `message`; при необходимости повторите запрос позже
`SYSTEM_ERROR`	Внутренняя ошибка Travel API	Повторите запрос позже; при повторении обратитесь в поддержку с `errorId`

Ошибки, пришедшие от GDS/NDC-поставщика, возвращаются под кодом SUPPLIER_ERROR: отдельного кода на каждую причину отказа Travel API не формирует, причина передаётся текстом поставщика в поле message. Не завязывайте логику на разбор message — его формат зависит от поставщика и не фиксирован.

Связанные операции#

Войдирование билета - отмена без штрафов
Информация о билете - проверка статуса билета и условий возврата
Правила тарифа - просмотр условий возврата для тарифа
Получение PNR - проверка бронирования после возврата