Проверка цены предложения (Offer Pricing)#

Верификация актуальной цены выбранного предложения перед бронированием.

Описание#

Эндпоинт: POST /api/hotels/offer_pricing

Проверяет и возвращает актуальную цену для выбранного предложения. Рекомендуется вызывать перед созданием бронирования для подтверждения цены.

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

Используйте этот запрос после выбора номера из результатов /api/hotels/hotel_pricing и перед созданием бронирования.

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

Получите searchId и offerId из результатов /api/hotels/hotel_pricing
Отправьте запрос на проверку цены
Получите актуальное предложение с подтвержденной ценой
Создайте бронирование через /api/hotels/create_booking

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

1{
2  "searchId": "search-xyz789",
3  "offerId": "offer-001"
4}

Ответ содержит:

1{
2  "hotelId": "hotel-001",
3  "checkinDate": "2025-12-15",
4  "checkoutDate": "2025-12-18",
5  "searchId": "search-xyz789",
6  "offer": { /* актуальное предложение */ }
7}

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

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

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

Код ошибки	Причина	Решение
`OFFER_NOT_FOUND`	Предложение не найдено или срок его действия истёк	Выполните новый поиск
`OFFER_BELOW_MIN_RETAIL_PRICE`	Предложение исключено: цена продажи ниже минимальной розничной цены поставщика	Проверьте настройки пресета ценообразования
`VALIDATION_ERROR`	Ошибка валидации запроса (HTTP 400)	Проверьте обязательные поля и форматы значений
`NO_TARGETS`	Под запрос не нашлось ни одного поставщика: ни один не настроен либо все отсеяны на этапе подготовки запроса	Проверьте настройки офисов и пресетов в личном кабинете; при сохранении ошибки обратитесь в поддержку
`SUPPLIER_ERROR`	Поставщик вернул ошибку. Причина — текстом поставщика в поле `message`	Разберите `message`; при необходимости повторите запрос позже
`SYSTEM_ERROR`	Внутренняя ошибка Travel API	Повторите запрос позже; при повторении обратитесь в поддержку с `errorId`

Помимо перечисленных TAPI-кодов, при ошибке на стороне поставщика в ответе может быть возвращён код ошибки поставщика без изменений (проброс) — набор таких кодов зависит от поставщика и не фиксирован.

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

Цены отеля — получение предложений
Создание бронирования — бронирование номера