Поиск бронирований (Search Bookings)#

Поиск существующих бронирований по различным критериям.

Описание#

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

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

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

Используйте этот запрос для получения списка бронирований.

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

Отправьте запрос с критериями фильтрации
Получите список бронирований с основной информацией
Для детальной информации используйте /api/hotels/view_booking

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

1{
2  "statusFilter": "Active"
3}

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

 1{
 2  "bookings": [
 3    {
 4      "supplierBookingNumber": "SUP-12345",
 5      "partnerOrderId": "ORDER-12345",
 6      "status": "Completed",
 7      "createdAt": "2025-11-20T10:30:00+00:00",
 8      "checkinAt": "2025-12-15"
 9    }
10  ]
11}

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

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

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

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

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

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

Просмотр бронирования — детальная информация о бронировании
Отмена бронирования — отмена бронирования