Структура ответа#
Детальное описание структуры ответа от /api/avia/ticket_refund_calculation.
Успешный ответ#
При успешном расчёте возврата API возвращает HTTP 200 и объект с детализацией возврата.
Основная структура#
| Поле | Тип | Описание |
|---|
forRefund | MonetaryAmount | Итоговая сумма к возврату (используйте в /api/avia/ticket_refund); может отсутствовать (null) |
refundDetails | RefundDetails | Детализация расчёта возврата; может отсутствовать (null) |
Структура RefundDetails#
| Поле | Тип | Описание |
|---|
fare | MonetaryAmount | Стоимость тарифа |
taxes | Taxes | Информация о сборах и таксах |
penalty | MonetaryAmount | Штраф за возврат согласно правилам тарифа |
Структура Taxes#
| Поле | Тип | Описание |
|---|
total | MonetaryAmount | Общая сумма возвратных сборов; обязательное поле |
breakdown | Tax[] | Детализация сборов по кодам; опционально (может отсутствовать) |
Структура Tax#
| Поле | Тип | Описание |
|---|
code | string | Код сбора/таксы (например, “RI”, “YQ”) |
amount | MonetaryAmount | Сумма данного сбора |
Примеры ответов#
Успешный расчёт#
Стандартный ответ с детализацией:
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": "YQ",
26 "amount": {
27 "currencyCode": "RUB",
28 "value": 60
29 }
30 }
31 ]
32 },
33 "penalty": {
34 "currencyCode": "RUB",
35 "value": 3500
36 }
37 }
38}
Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|
BOOKING_NOT_FOUND | Бронирование не найдено или не принадлежит клиенту | Проверьте bookingId |
CURRENCY_RATE_NOT_AVAILABLE | Нет курса для конвертации сумм в валюту отображения | Повторите запрос позже |
VALIDATION_ERROR | Ошибка валидации запроса (HTTP 400) | Проверьте обязательные поля и форматы значений |
NO_TARGETS | Под запрос не нашлось ни одного поставщика: ни один не настроен либо все отсеяны на этапе подготовки запроса | Проверьте настройки офисов и пресетов в личном кабинете; при сохранении ошибки обратитесь в поддержку |
SUPPLIER_ERROR | Поставщик вернул ошибку. Причина — текстом поставщика в поле message | Разберите message; при необходимости повторите запрос позже |
SYSTEM_ERROR | Внутренняя ошибка Travel API | Повторите запрос позже; при повторении обратитесь в поддержку с errorId |
Ошибки, пришедшие от GDS/NDC-поставщика, возвращаются под кодом SUPPLIER_ERROR: отдельного кода на каждую причину отказа Travel API не формирует, причина передаётся текстом поставщика в поле message. Не завязывайте логику на разбор message — его формат зависит от поставщика и не фиксирован.
Связанные операции#