Создание бронирования (Create Booking)#

Создание бронирования отеля на основе выбранного предложения.

Описание#

Эндпоинт: POST /hotels/create_booking

Создает бронирование с данными гостей для выбранного предложения. В ответе возвращается bookingId для последующих операций.

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

Используйте этот запрос после проверки цены через /hotels/offer_pricing. Это ключевой шаг оформления бронирования.

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

1. Выполните поиск через /hotels/search
2. Получите предложения через /hotels/hotel_pricing
3. Проверьте цену через /hotels/offer_pricing
4. Соберите данные гостей и контактную информацию
5. Отправьте запрос на создание бронирования
6. Получите bookingId для просмотра и управления

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

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

 1{
 2  "searchId": "search-xyz789",
 3  "offerId": "offer-001",
 4  "partnerInfo": {
 5    "partnerOrderId": "ORDER-12345"
 6  },
 7  "paymentType": {
 8    "type": "online",
 9    "amount": {
10      "amount": 15000.00,
11      "currency": "RUB"
12    }
13  },
14  "guests": [
15    {
16      "firstName": "IVAN",
17      "lastName": "IVANOV",
18      "isChild": false,
19      "gender": "Male"
20    }
21  ],
22  "customer": {
23    "firstName": "Ivan",
24    "lastName": "Ivanov",
25    "email": "ivan@example.com",
26    "phone": "+79991234567"
27  }
28}

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

1{
2  "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
3  "supplierOrderId": "SUP-789",
4  "partnerOrderId": "ORDER-12345"
5}

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

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

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

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

• Проверка цены — верификация цены перед бронированием
• Просмотр бронирования — получение деталей бронирования
• Отмена бронирования — отмена бронирования