База знаний
Узнайте о главных возможностях наших решений. Получите помощь, когда вам понадобится.
Reservation API — бронирование
Как происходит бронирование
Поиск по минимальной цене списка объектов → поиск по конкретному объекту → verify → booking.

Требуемые поля:
Checksum — берется из поиска по конкретному объекту в DetailedRoomStay. Это контрольная hash-сумма стоимости проживания, даты начала и суммы штрафа. Checksum не уникальна для каждого конкретного варианта проживания.
CreateBookingToken — из api/reservation/v1/bookings/verify в VerifyBookingRs. При создании бронирования указывается уникальный токен createBookingToken, позволяющий создать только 1 бронирование. Время жизни createBookingToken — 24 часа.
Уведомления о бронировании или его отмене
Канал продаж не получает уведомлений, так как сам создает бронирование через API и, соответственно, знает, что оно создано. Гость также не получает уведомлений, так как это логика канала. Уведомления отправляются только отельеру.
Подтверждение бронирования
Exely Connect работает по системе «моментального подтверждения». Если бронирование создалось — это гарантия доступности.
Изменение бронирования
Данные в полях, которые не влияют на стоимость проживания, можно изменить. Например:
Данные гостей (за исключением возраста детей) — booking.roomStays.guests, booking.roomStays.guestCount.
Данные заказчика — booking.customer.
Комментарии агента — booking.bookingComments.
Информация по предоплате — booking.prepayment.
Количество изменений не ограничено. При изменении данных необходимо ориентироваться на структуру метода modify.

Оплата броней
Exely не участвует во взаиморасчетах между гостем, каналом и отелем. Бронирование номера отеля в канале полностью регулируется договорными отношениями между каналом продаж и отелем в рамках прямого договора.
Мы также не предоставляем эквайринг для каналов продаж. Эквайринг — это технология безналичного приема платежей с использованием банковских карт и систем бесконтактной оплаты.
Канал продаж может принимать как частичную, так и полную оплату, перечисляя потом эти деньги в отель. Exely передает условия отмены в канал в соответствии с тарифом. Если бронирование при отмене будет попадать под штрафные правила, то эта информация также будет передана через API.
При активации канала отель выбирает сам, какие тарифы передать в канал. Это могут быть как возвратные, так и невозвратные тарифы. По общепринятым правилам, все бронирования становятся невозвратными, если бронирование делается меньше, чем за 24 часа до заезда.
Фактический размер оплаты бронирования гостем
При создании бронирования можно указать фактический размер оплаты, полученной от гостя в канале — booking.prepayment.prepaidSum.
Информация будет отображаться в подтверждении бронирования:

И на шахматке в Exely PMS:

Дополнительно можно также указать:
Комментарий к оплате — booking.prepayment.remark;
Тип оплаты — booking.prepayment.paymentType. «PrePay» — оплата произведена в канале, «Cash» — оплата осуществляется в отеле.
Комментарий гостя и агента к бронированию
При создании бронирования можно указать комментарий гостя к бронированию — booking.customer.comment. (максимум 250 символов) и комментарий агента к бронированию — booking.bookingComment. (максимальное количество комментариев — 5 по 250).
Информация будет отображаться в подтверждении бронирования:

И на шахматке в Exely PMS:

Минимальное и максимальное значение параметра childAges
0-18 лет.
Информации о гостях
Важно заполнить информацию по всем гостям, так как эти данные сразу отправляются в АСУ отеля:

Модификация бронирования до заезда
Отель не может редактировать канальное бронирование. Модификацию с изменением стоимости бронирования необходимо производить через отмену.
Модификация после наступления даты заезда
В случае незаезда или изменений условий проживания, средство размещения самостоятельно сообщает каналу эту информацию, например, по email. Далее канал на этапе сверки «Канал — Exely» меняет сумму по бронированию в зависимости от размера оплаты и штрафа.
Отмена бронирования
Отель не может отменить канальное бронирование в личном кабинете Exely. Отмена происходит на стороне канала через API.
Штраф при отмене бронирования
Есть метод API — api/reservation/v1/bookings/{number}/calculate-cancellation-penalty, который позволяет рассчитать сумму штрафу за отмену бронирования.

Расторжение договора на бронирование со стороны отельера
Как правило, если отельер расторгает договор, то в этом случае он все равно должен заселить гостей по броням на будущие даты и провести сверку. Обычно это фиксируется в договоре.
Статистика времени ответа на запросы
Создание бронирования:
90 pt — 3695 ms;
95 pt — 4332 ms.
Получение бронирования:
90 pt — 638 ms;
95 pt — 721 ms.
Расчет суммы штрафа за отмену:
90 pt — 652 ms;
95 pt — 798 ms.
Проверка возможности создать бронирование:
90 pt — 725 ms;
95 pt — 854 ms.