Расчет возврата билета#

Расчёт суммы возврата билета с детализацией штрафов, сборов и возвратных сумм перед оформлением возврата.

Описание#

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

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

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

Используйте этот запрос для предварительного расчёта возврата перед фактическим оформлением возврата билета через /avia/ticket_refund.

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

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

1{
2  "bookingId": "019a0b29-8fc8-703a-9845-50c7ce2b1322",
3  "ticketNumber": "555-6170036806"
4}

Ответ с детализацией возврата:

 1{
 2  "forRefund": {
 3    "currencyCode": "RUB",
 4    "value": 5867
 5  },
 6  "refundDetails": {
 7    "fare": {
 8      "currencyCode": "RUB",
 9      "value": 8950
10    },
11    "taxes": {
12      "total": {
13        "currencyCode": "RUB",
14        "value": 417
15      },
16      "breakdown": [
17        {
18          "code": "RI",
19          "amount": {
20            "currencyCode": "RUB",
21            "value": 357
22          }
23        }
24      ]
25    },
26    "penalty": {
27      "currencyCode": "RUB",
28      "value": 3500
29    }
30  }
31}

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

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

Процесс расчёта возврата#

Полный workflow#

sequenceDiagram
    participant Client
    participant API

    Client->>API: POST /avia/ticket_refund_calculation
    API-->>Client: forRefund + refundDetails

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

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

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

Значение forRefund из ответа необходимо использовать в запросе /avia/ticket_refund:

1{
2  "bookingId": "019a0b29-8fc8-703a-9845-50c7ce2b1322",
3  "ticketNumber": "555-6170036806",
4  "forRefund": {
5    "currencyCode": "RUB",
6    "value": 5867
7  }
8}

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

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

• Возврат билета - фактическое оформление возврата с указанием суммы
• Информация о билете - проверка статуса билета перед возвратом
• Правила тарифа - просмотр условий возврата для тарифа
• Расчёт обмена - альтернатива возврату через обмен