Reservation API — бронирование

Как происходит бронирование

Поиск по минимальной цене списка объектов → поиск по конкретному объекту → verify → booking.

Требуемые поля:

• Checksum — берется из поиска по конкретному объекту в DetailedRoomStay. Это контрольная hash-сумма стоимости проживания, даты начала и суммы штрафа. Checksum не уникальна для каждого конкретного варианта проживания.

• CreateBookingToken — из api/reservation/v1/bookings/verify в VerifyBookingRs. При создании брони указывается уникальный токен createBookingToken, позволяющий создать только 1 бронь. Время жизни createBookingToken — 24 часа.

Уведомления о бронировании или его отмене

Канал продаж не получает уведомлений, так как сам создает бронирование через API и, соответственно, знает, что оно создано. Гость также не получает уведомлений, так как это логика канала. Уведомления отправляются только отельеру.

Подтверждение бронирования

Partner API работает по системе «моментального подтверждения». Если бронь создалась — это гарантия доступности.

Изменение бронирования

Данные в полях, которые не влияют на стоимость проживания, можно изменить. Например: 

• Данные гостей (за исключением возраста детей) — booking.roomStays.guests, booking.roomStays.guestCount.

• Данные заказчика — booking.customer.

• Комментарии агента — booking.bookingComments.

• Информация по предоплате — booking.prepayment.

Количество изменений не ограничено. При изменении данных необходимо ориентироваться на структуру метода modify.

Оплата броней

TravelLine не участвует во взаиморасчетах между гостем, каналом и отелем. Бронирование номера отеля в канале полностью регулируется договорными отношениями между каналом продаж и отелем в рамках прямого договора.

Мы также не предоставляем эквайринг для каналов продаж. Эквайринг — это технология безналичного приема платежей с использованием банковских карт и систем бесконтактной оплаты.

Канал продаж может принимать как частичную, так и полную оплату, перечисляя потом эти деньги в отель. TravelLine передает условия отмены в канал в соответствии с тарифом. Если бронь при отмене будет попадать под штрафные правила, то эта информация также будет передана через API.

При активации канала отель выбирает сам, какие тарифы передать в канал. Это могут быть как возвратные, так и невозвратные тарифы. По общепринятым правилам, все бронирования становятся невозвратными, если бронь делается меньше, чем за 24 часа до заезда.

Фактический размер оплаты брони гостем

При создании бронирования можно указать фактический размер оплаты, полученной от гостя в канале — booking.prepayment.prepaidSum.

Информация будет отображаться в подтверждении брони:

И на шахматке в TL: WebPMS:

Дополнительно можно также указать:

• Комментарий к оплате — booking.prepayment.remark;

• Тип оплаты — booking.prepayment.paymentType. «PrePay» — оплата произведена в канале, «Cash» — оплата осуществляется в отеле.

Комментарий гостя и агента к бронированию

При создании бронирования можно указать комментарий гостя к бронированию — booking.customer.comment. (максимум 250 символов) и комментарий агента к бронированию — booking.bookingComment. (максимальное количество комментариев — 5 по 250).

Информация будет отображаться в подтверждении брони:

И на шахматке в TL: WebPMS:

Минимальное и максимальное значение параметра childAges

0-18 лет.

Информации о гостях

Важно заполнить информацию по всем гостям, так как эти данные сразу отправляются в АСУ отеля:

Модификация бронирования до заезда

Отель не может редактировать канальное бронирование. Модификацию с изменением стоимости бронирования необходимо производить через отмену. 

Модификация после наступления даты заезда

В случае незаезда или изменений условий проживания, средство размещения самостоятельно сообщает каналу эту информацию, например, по email. Далее канал на этапе сверки «Канал — TL» меняет сумму по бронированию в зависимости от размера оплаты и штрафа.
 

Отмена брони

Отель не может отменить канальное бронирование в личном кабинете TravelLine. Отмена происходит на стороне канала через 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.