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

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

Описание#

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

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

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

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

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

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

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

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

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

Сокращённый пример ответа (часть обязательных полей — legs, ticketingRequirements, validatingCarrier на уровне offer, fareAmount и details на уровне offerItem — опущена для краткости; полная структура — в Структуре ответа):

 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 из-за изменения условий.

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

Код ошибкиПричинаРешение
OFFER_NOT_FOUNDПредложение не найдено или срок его действия истёкВыполните новый поиск
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 — его формат зависит от поставщика и не фиксирован.

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

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