Структура ответа#

Детальное описание структуры ответа от /avia/fare_rules.

Основная структура#

Ответ содержит массив правил для запрошенного предложения.

ПолеТипОписание
rulesarrayМассив правил тарифа

Структура Rule#

Каждый элемент массива rules содержит:

ПолеТипОписание
fareBasisstringКод базового тарифа
ticketDesignatorstringДескриптор билета
categoriesarrayМассив категорий правил

Структура RuleCategory#

Каждая категория содержит:

ПолеТипОписание
categorystringНомер категории (от 0 до 33)
captionstringНазвание категории на русском языке
textstringДетальное описание правил категории

Примеры ответов#

Успешный ответ#

 1{
 2  "rules": [
 3    {
 4      "fareBasis": "ILTOW",
 5      "categories": [
 6        {
 7          "category": "0",
 8          "caption": "Применение",
 9          "text": "НАЗВАНИЕ УПТ - ТАРИФЫ ГРУППЫ SMART LIGHT\nДАННЫЕ ТАРИФЫ ПРИМЕНЯЮТСЯ ДЛЯ ЭКОНОМИЧЕСКОГО КЛАССА ОБСЛУЖИВАНИЯ..."
10        },
11        {
12          "category": "5",
13          "caption": "Бронирование и оформление билета",
14          "text": "Бронирование разрешается не позднее чем за 7 сут до отправления воздушного судна..."
15        },
16        {
17          "category": "16",
18          "caption": "Сборы при расторжении договора",
19          "text": "ДОБРОВОЛЬНОЕ ИЗМЕНЕНИЕ УСЛОВИЙ ДОГОВОРА ПЕРЕВОЗКИ РАЗРЕШАЕТСЯ..."
20        }
21      ]
22    }
23  ]
24}

Структура с несколькими базовыми тарифами#

Если предложение содержит несколько участков с разными тарифами:

 1{
 2  "rules": [
 3    {
 4      "fareBasis": "ILTOW",
 5      "categories": [...]
 6    },
 7    {
 8      "fareBasis": "XLTRT",
 9      "categories": [...]
10    }
11  ]
12}

Категории правил#

Основные категории, которые могут присутствовать в ответе:

КатегорияНазваниеОписание
0ПрименениеОбщие условия применения тарифа
1ИзбираемостьКто может использовать тариф
4Применение рейсовОграничения по рейсам
5Бронирование и оформлениеСроки бронирования и выписки
7Максимальное пребываниеОграничения по срокам пребывания
8ОстановкиУсловия остановок в пути
10Построения и комбинацииПравила комбинирования тарифов
14Ограничения на перевозкуОбщие ограничения
15Ограничения по продажеГде можно оформить билет
16Сборы при расторженииУсловия обмена и возврата
18Важные уведомленияТекст для билета
19Скидки для детейУсловия перевозки детей и младенцев
20Скидки для руководителей группУсловия групповых скидок
21Скидки для агентовУсловия скидок для агентов
22Другие скидкиПрочие скидки
26ГруппыУсловия для групповых бронирований
31Добровольные измененияДетали добровольного обмена
33Добровольные возвратыДетали добровольного возврата

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

Код ошибкиПричинаРешение
SEARCH_EXPIREDПоиск устарелВыполните новый поиск
OFFER_NOT_FOUNDПредложение не найденоПроверьте offerItemId
INVALID_SEARCH_IDНекорректный searchIdПроверьте формат searchId
RULES_NOT_AVAILABLEПравила недоступныНе все предложения имеют детальные правила

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