Правила тарифа (Fare Rules)#

Получение детальных условий применения тарифа для выбранного предложения.

Описание#

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

Возвращает подробные правила тарифа, включая условия бронирования, обмена, возврата, ограничения и другие важные условия перевозки.

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

Используйте этот запрос для получения детальной информации о правилах тарифа перед созданием бронирования или после выбора предложения.

Основной сценарий#

  1. Выполните поиск через /avia/search и получите searchId
  2. Выберите интересующее предложение (получите offerItemId)
  3. Запросите правила тарифа для этого предложения
  4. Покажите пользователю условия обмена, возврата и другие ограничения
  5. Если условия подходят — создайте бронирование

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

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

1{
2  "searchId": "0E8AC7882BECA40467A7047BEDCE3FEC",
3  "offerItemId": "571B2E9333EA93F9365BB4FB0C1492A2"
4}

Ответ содержит набор правил по категориям:

 1{
 2  "rules": [
 3    {
 4      "fareBasis": "ILTOW",
 5      "categories": [
 6        {
 7          "category": "0",
 8          "caption": "Применение",
 9          "text": "..."
10        },
11        {
12          "category": "16",
13          "caption": "Сборы при расторжении договора",
14          "text": "..."
15        }
16      ]
17    }
18  ]
19}

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

Типичные категории правил#

КатегорияНазваниеОписание
0ПрименениеОбщие условия применения тарифа
5Бронирование и оформлениеСроки бронирования и выписки билета
7Максимальное пребываниеОграничения по срокам пребывания
16Сборы при расторженииУсловия обмена и возврата билета
19Скидки для детейУсловия перевозки детей и младенцев

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

Backward Структура ответа Параметры запроса Forward