Актуализация цены (Offer Price)#

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

Описание#

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

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

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

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

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

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

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

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

1{
2  "searchId": "AAF6301E87DD7C73E7A8A636FDC77ED5",
3  "offerItemId": "1691A9FCFD85DC8DB9D6093D7E75C5C0"
4}

Ответ содержит полную информацию о предложении:

 1{
 2  "searchId": "699C55215661822C2EC828B0F661A304",
 3  "offers": [
 4    {
 5      "offerId": "3F4CF01BC668FA5F51BC21B1142B26F9",
 6      "offerItems": [
 7        {
 8          "offerItemId": "1691A9FCFD85DC8DB9D6093D7E75C5C0",
 9          "totalAmount": {
10            "currencyCode": "RUB",
11            "value": 1499
12          },
13          "timeLimit": "2025-10-22T19:05:47",
14          "offerExpiration": "2025-10-22T19:05:47"
15        }
16      ]
17    }
18  ],
19  "flights": {...},
20  "fareFamilies": {...}
21}

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

• Параметры запроса — описание параметров запроса
• Структура ответа — детальное описание структуры ответа

Зачем нужна актуализация цены#

Проверка доступности#

Между поиском и бронированием может пройти время. За это время:

• Цена может измениться
• Места могут закончиться
• Условия тарифа могут обновиться

Информирование пользователя#

Если цена изменилась, покажите пользователю актуальную стоимость до создания бронирования.

Снижение отказов#

Проверка цены перед бронированием снижает количество отказов при создании PNR из-за изменения условий.

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

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

• Поиск билетов - получение списка предложений
• Создание PNR - создание бронирования после проверки цены
• Правила тарифа - получение условий тарифа