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

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

Описание#

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

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

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

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

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

sequenceDiagram
    participant Client
    participant API

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

    Client->>API: POST /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 должен содержать рассчитанную сумму возврата с учетом:

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

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

Код ошибки	Причина	Решение
`REFUND_NOT_ALLOWED`	Возврат запрещен правилами тарифа	Проверьте условия тарифа
`TICKET_NOT_FOUND`	Билет не найден	Проверьте номер билета и bookingId
`TICKET_ALREADY_REFUNDED`	Билет уже возвращен	Операция уже выполнена
`INVALID_REFUND_AMOUNT`	Неверная сумма возврата	Пересчитайте сумму согласно тарифу
`TICKET_USED`	Все сегменты использованы	Возврат невозможен

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

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