Структура ответа#
Детальное описание структуры ответа от /avia/ticket_refund_calculation.
Успешный ответ#
При успешном расчёте возврата API возвращает HTTP 200 и объект с детализацией возврата.
Основная структура#
| Поле | Тип | Описание |
|---|
forRefund | Money | Итоговая сумма к возврату (используйте в /avia/ticket_refund) |
refundDetails | RefundDetails | Детализация расчёта возврата |
Структура RefundDetails#
| Поле | Тип | Описание |
|---|
fare | Money | Стоимость тарифа |
taxes | TaxInfo | Информация о сборах и таксах |
penalty | Money | Штраф за возврат согласно правилам тарифа |
Структура TaxInfo#
| Поле | Тип | Описание |
|---|
total | Money | Общая сумма возвратных сборов |
breakdown | Tax[] | Детализация сборов по кодам |
Структура Tax#
| Поле | Тип | Описание |
|---|
code | string | Код сбора/таксы (например, “RI”, “YQ”) |
amount | Money | Сумма данного сбора |
Примеры ответов#
Успешный расчёт#
Стандартный ответ с детализацией:
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 "code": "RI",
26 "amount": {
27 "currencyCode": "RUB",
28 "value": 60
29 }
30 }
31 ]
32 },
33 "penalty": {
34 "currencyCode": "RUB",
35 "value": 3500
36 }
37 }
38}
Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|
TICKET_NOT_FOUND | Билет не найден | Проверьте номер билета и bookingId |
TICKET_ALREADY_REFUNDED | Билет уже возвращен | Возврат уже выполнен |
TICKET_VOID | Билет войдирован | Билет отменен, возврат невозможен |
REFUND_NOT_ALLOWED | Возврат запрещен тарифом | Тариф не разрешает возврат |
TICKET_EXPIRED | Срок действия истёк | Проверьте правила тарифа |
Связанные операции#