Структура ответа#
Детальное описание структуры ответа от /hotels/create_booking.
Основная структура#
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
bookingId | guid | Нет | Идентификатор созданного бронирования (формат UUID) |
supplierOrderId | string | Нет | Идентификатор заказа у поставщика |
partnerOrderId | string | Нет | Идентификатор заказа партнера |
Примеры ответов#
Успешный ответ#
1{
2 "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
3 "supplierOrderId": "SUP-12345",
4 "partnerOrderId": "ORDER-12345"
5}Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|---|---|
OFFER_NOT_FOUND | Предложение не найдено в кэше или истёк срок действия searchId/offerId | Выполните offer_pricing заново и повторите бронирование |
OFFER_NOT_VERIFIED | Предложение не было подтверждено через offer_pricing перед бронированием | Вызовите offer_pricing для данного оффера перед create_booking |
ECLC_NOT_AVAILABLE | Запрошен ранний заезд/поздний выезд (upsells с checkinTime/checkoutTime), но у предложения нет пары для раннего заезда/позднего выезда | Уберите соответствующий upsell или выберите другое предложение |
HOTEL_TIME_UNKNOWN | Не удалось определить стандартное время заезда/выезда отеля (актуально для поставщика Acase) | Передайте upsells[].checkinTime с type = "earlyCheckin" и/или upsells[].checkoutTime с type = "lateCheckout" и повторите запрос |
VALIDATION_ERROR | Ошибка валидации запроса | Проверьте формат и обязательность полей запроса |
Помимо перечисленных TAPI-кодов, при ошибке на стороне поставщика в ответе может быть возвращён код ошибки поставщика без изменений (проброс) — набор таких кодов зависит от поставщика и не фиксирован.
Связанные операции#
- Просмотр бронирования — получение деталей бронирования
- Отмена бронирования — отмена бронирования
- Поиск бронирований — поиск бронирований