Структура ответа#
Детальное описание структуры ответа от /avia/fare_rules.
Основная структура#
Ответ содержит массив правил для запрошенного предложения.
| Поле | Тип | Описание |
|---|---|---|
rules | array | Массив правил тарифа |
Структура Rule#
Каждый элемент массива rules содержит:
| Поле | Тип | Описание |
|---|---|---|
fareBasis | string | Код базового тарифа |
ticketDesignator | string | Дескриптор билета |
categories | array | Массив категорий правил |
Структура RuleCategory#
Каждая категория содержит:
| Поле | Тип | Описание |
|---|---|---|
category | string | Номер категории (от 0 до 33) |
caption | string | Название категории на русском языке |
text | string | Детальное описание правил категории |
Примеры ответов#
Успешный ответ#
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 | Правила недоступны | Не все предложения имеют детальные правила |
Связанные операции#
- Поиск рейсов - получение searchId и offerItemId
- Проверка цены - проверка актуальной цены
- Создание бронирования - создание PNR после проверки правил