Search API — поиск доступных размещений

Ценообразование в TravelLine

Отель устанавливает цену на каждый тариф, категорию номера, тип места и дату. Например:

В поиске предоставляются данные на год вперед от текущей даты. Забронировать можно от 1 до 365 ночей.

Брутто и нетто цены

Передаются те цены, которые отельер настроит в своём личном кабинете. Мы передаем цены, не зная брутто это или нетто. Наценка реализовывается на стороне канала.

Передается ли НДС

На текущий момент информацию о НДС не передаем. Реализация запланирована на 4 квартал 2022 года.

Налоги и сборы (кроме НДС)

Поле taxAmount содержит сумму налогов и сборов, которую оплачивает гость при заезде согласно законодательству РФ (НДС не содержит). Например:

• Федеральный закон № 214-ФЗ от 29 июля 2017 года;

• Закон Краснодарского края № 3690-КЗ от 27.11.2017.

Продажа дополнительных услуг, которые не включены в тариф

Запланированное поле availableServices — это услуги которые можно докупить при бронировании. В планах на 4 квартал 2022 года.

Тип питания в размещении RoomStay

Для одного RoomStay доступно только одно питание. В системе TravelLine отель может добавить в тариф только одну услугу с типом питания. Поэтому mealPlanCode является строковым типом данных.

Что делать, если запрос в «api/search/v1/properties/ {propertyId}/room-stays» не содержит ошибок и на него не приходит ответ

Обратите внимание на поля «arrivalDate» и «departureDate» — в них должны быть указаны даты в будущем:

Расселение гостей в номере

В результатах поиска возвращаются поля:

• roomStays.fullPlacementsName;

• roomStays.roomType.placements.

В placements перечислены не конкретные места, а типы условий для размещения гостей. В ответе видно, что два взрослых размещаются на основных местах, ребенок в возрасте 2 года на основном месте, а ребенок в возрасте 5 лет на дополнительном месте.

Дети могут размещаться на взрослых местах — это происходит, если нет специальных условий для размещения детей или нет свободных детских мест. В таких случаях дети размещаются по цене взрослого размещения.

Расшифровка дополнительнительного места

Расшифровки дополнительных мест нет. Поэтому нельзя узнать — диван это или, например, детская кроватка.

Информация о кроватях в номере

Эта информация будет добавлена в описании категории номера — блок оснащение номеров. Добавление поля планируется в сентябре 2022 года. Поле будет не обязательным для заполнения отельером.

Статистика времени ответа на запросы

Поиск вариантов проживаний по конкретному средству размещения:

• 90 pt — 866 ms;

• 95 pt — 1050 ms.

Поиск вариантов проживания с минимальной ценой по всем доступным средствам размещения:

• 90 pt — 1111 ms;

• 95 pt — 1728 ms.