| Версия | 1.0 |
| Logus The Box | Да |
Общие настройки
Создайте профиль компании Трэвеллайн в разделе Клиенты.
Для настройки стыковки включите у Клиента роль Мастер продаж.
Выберите правильные коды транзакций предоплаты для безналичных платежей (от агентов) и для прямых оплат через эквайринг отеля (если такой подключен в Трэвеллайне).
Оплата эквайрингом отеля не может быть безналичной - такие брони будут попадать без компании-плательщика, и 150-й код на них принять невозможно. Код оплаты "Оплата эквайрингом отеля" не должна быть безналичной - это должен быть платёж с типом "Банк" или "Внешний"!
ВАЖНО!!! HotelCode, который отображается в интерфейсе сайта TL может отличатся от внешнего кода отеля который мы прописываем в конфиге. Если не известен нужно уточнить в тп TL или у клиента.
При помощи кнопки "Добавить" создайте Внешний канал продаж. (см. скриншот)
| Название вкладки | Назначение |
|---|---|
| Квоты | Квота номеров, выставленных на продажу. Обычно используется Весь пул номеров MAIN, |
Типы комнат | Типы комнат, выставленные на продажу |
| Внешние тарифы | Тарифы, настроенные в личном кабинете ТЛ |
| Внешние услуги | Коды внешних услуг. |
| Описание | Описание внешних кодов, полученных по протоколу стыковки. |
Настройка тарифов
- Перейдите во вкладку "Внешние тарифы"
- Выберите тарифный план
Если тарифный план содержит пакет услуг, привяжите нужный пакет (Как привязывать несколько пакетов одновременно см. ниже).
Укажите внешний код тарифа из ТЛ (коды тарифов можно посмотреть в личном кабинете или на вкладке Описание)
Нажмите "Добавить"
Перейдите во вкладку "Квоты"
В поле "Тарифы на продажу" активируйте нужные тарифы.
Каждый тариф добавляется отдельной записью. Один тариф в LOGUS может быть сопоставлен с кодами разных тарифов из ТЛ. Например, если в личном кабинете ТЛ тарифы настроены как зависимые, и их цены не выгружаются из LOGUS.
Для случаев, когда необходимо привязать более одного пакета к тарифу, необходимо добавить для каждого пакета отдельную строчку с одним и тем же внешним идентификатором на закладке "внешние тарифы", как показано на примере:
В этом случае при бронировании по внешнему коду тарифа 10999 будет создана бронь с тарифом "GROUP" и тремя пакетами (завтрак, обед и ужин) одновременно
Внимание! Одна из ошибок, по причине которой брони с настроенными тарифами не попадают в Logus - тариф не выставлен на продажу.
Перейдите во вкладку "Квоты"
В поле "Тарифы на продажу" активируйте нужные тарифы.
Настройка типов комнат
- Перейдите во вкладку "Типы комнат"
Выберите тип комнаты
Укажите внешний ID (коды можно посмотреть в личном кабинете или на вкладке Описание)
Первоначально, новые категории комнат добавляются в Личном кабинете ТЛ, им присваивается TL API, который в Логусе используется как Внешний ID.
Настройка услуг
В личном кабинете ТЛ настройте два варианта каждой услуги: включенный в стоимость и добавочный.
- Перейдите во вкладку "Внешние услуги"
- Выберите добавочную услугу
Укажите вариант
Укажите внешний код добавочной услуги из ТЛ (коды можно посмотреть в личном кабинете ТЛ)
- Не стоит указывать те коды услуг, которые включены в тариф, если в настройке тарифов вы использовали комбинацию тариф+пакет.
- Не все внешние каналы передают ID услуги. Необходимо добавить услугу с ID EXTRA_SERVICE для случая, когда ID добавочной услуги не передается каналом, предварительно настроив универсальную услугу в Logus.
Настройка каналов
ВНИМАНИЕ!
У каждого Клиента с ролью "Агент" должна быть задана комиссия по умолчанию на вкладке "Настройка ролей" в карточке клиента.
Если сумма в заявке от канала поступает уже за вычетом комиссии, то в этом случае размер комиссии необходимо указать = 0%
Например, такая ситуация типична для канала Броневик и т.п.
- Перейдите во вкладку "Квоты"
- Добавьте каналы продаж, как это показано на первом скриншоте.
- Если код агента отсутствует по ссылке ниже, тогда обратитесь в компанию ТЛ.
Страница со всеми кодами каналов продаж - https://www.travelline.ru/support/knowledge-base/kody-kanalov-prodazh-dlya-integratsii-s-asu/
Обновление тарифов и доступности номеров:
При нажатии на кнопку "Обновить тарифы" происходит выгрузка цен из Логуса в Тревел Лайн.
Важно
Внимание! Перед выполнением данной операции необходимо проконсультироваться с вашим менеджером в Тревел Лайн.
Если при выгрузке цен вы видите в логе ошибку Price integration is disabled, значит в Travelline не включена синхронизация цен по тарифам.
Принудительное обновление наличия
Для принудительного обновления доступности номеров нажмите кнопку "Обновить наличие"
ВНИМАНИЕ! КНОПКУ "НАСТРОИТЬ ПРЯМОЕ СООТВЕТСТВИЕ" НАЖИМАТЬ НЕ НУЖНО, Т.К. ЭТО ПРИВЕДЕТ К УДАЛЕНИЮ ВСЕХ ВНЕШНИХ ID, ВВЕДЕННЫХ РАНЕЕ.
Настройка завершена!
Дальнейшая инструкция предназначена для технического специалиста или сотрудника компании, осуществяющего поддержку системы Logus HMS
Настройка интерфейса:
Обработка гарантии начиная с версии протокола 1.0:
| Код гарантии | Вид гарантии в Логусе |
|---|---|
| PrePay | Есть предоплата. Детали предоплаты указываются в комментарии к брони. В случае с предоплатой на сайте отеля депозит отразится в счете брони. В качестве гарантии будет выбрана первая по списку гарантия с типом "Безналичная оплата". |
| CcDcVoucher | В качестве гарантии будет выбрана первая по списку с типом "Кредитная карта" |
| PayOnArrival | Гарантии нет, гость платит при заселении в гостиницу. В качестве гарантии будет выбран первая по списку с типом "Наличные". |
Если гарантия с требуемым видом не найдена, в этом поле будет использовано пустое значение. |
Начиная с версии протокола 1.14 правила гарантии и предоплат регулируются депозитными правилами, описанными в конфигурации:
Выборка рулов:
Порядок выбора рула и условия:
1. (GuaranteeCode пустой или равен null) или GuaranteeCode == guaranteeCode из xml
2. (PaymentSystemName пустой или равен null) или PaymentSystemName == paymentSystemName из xml
3. (PaymentSystemProfileAcquiringName пустой или равен null) или PaymentSystemProfileAcquiringName == paymentSystemProfileAcquiringName из xml
4. (DepositPayments == null) или DepositPayments == depositPayments из xml
GuaranteeType - тип гарантии
| Значение | В рулах | В логусе |
|---|---|---|
| 0 | DirectBill | Безналичная оплата |
| 1 | Cash | Наличные |
| 2 | Deposit | Депозит |
| 3 | CreditCard | Кредитная Карта |
<DepositRules>
<Rule Name="01 Выставлен счёт на юрлицо (автоматически)" GuaranteeCode="PrePay" PaymentSystemName="CASHLESS" PaymentSystemProfileAcquiringName="" DepositPayments="ExpectedPayment" />
<Rule Name="02 Выставлен счёт на юрлицо (отелем)" GuaranteeCode="PrePay" PaymentSystemName="MANUAL_CASHLESS" PaymentSystemProfileAcquiringName="" DepositPayments="ExpectedPayment" />
<Rule Name="03 Бронь оплачена каналу бронирования" GuaranteeCode="PrePay" PaymentSystemName="CM_CASHLESS" Payee="Channel" LogusGuarantee="DirectBill" />
<Rule Name="04 Выставлен счёт физлицу (автоматически)" GuaranteeCode="PrePay" PaymentSystemName="INDIVIDUAL_CASHLESS" PaymentSystemProfileAcquiringName="" DepositPayments="ExpectedPayment" />
<Rule Name="05 Выставлен счёт физлицу (отелем)" GuaranteeCode="PrePay" PaymentSystemName="MANUAL_INDIVIDUAL_CASHLESS" PaymentSystemProfileAcquiringName="" DepositPayments="ExpectedPayment" />
<Rule Name="06 Оплата на сайте отеля (депозит ожидается) - эквайринг ТЛ" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="TravelLine" Payee="Online" DepositPayments="ExpectedPayment" />
<Rule Name="07 Оплата на сайте отеля (депозит получен) - эквайринг ТЛ" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="TravelLine" Payee="Online" DepositPayments="ReceivedPayment" LogusGuarantee="DirectBill" />
<Rule Name="08 Оплата на сайте отеля (депозит ожидается) - эквайринг отеля" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="Hotel" DepositPayments="ExpectedPayment" />
<Rule Name="09 Оплата на сайте отеля (депозит получен) - эквайринг отеля" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="Hotel" Payee="Guest" DepositPayments="ReceivedPayment" LogusGuarantee="CreditCard" />
<Rule Name="10 Гарантия кредитной картой - карта гостя" GuaranteeCode="CcDcVoucher" PaymentSystemName="CM_CREDITCARD_GUARANTEE" LogusGuarantee="CreditCard" />
<Rule Name="11 Гарантия кредитной картой - виртуальная карта канала OTA" GuaranteeCode="CcDcVoucher" PaymentSystemName="CM_PREPAY_CREDITCARD_GUARANTEE" Payee="Channel" LogusGuarantee="CreditCard" />
<Rule Name="12 Гарантия кредитной картой - карта гостя через сайт отеля" GuaranteeCode="CcDcVoucher" LogusGuarantee="CreditCard" />
<Rule Name="13 Гарантия кредитной картой - канал передал детали карты в гостиницу" GuaranteeCode="PrePay" PaymentSystemName="CM_CREDITCARD" LogusGuarantee="CreditCard" />
<Rule Name="14 Оплата при заезде" GuaranteeCode="Cash" LogusGuarantee="Cash" />
<Rule Name="15 Оплата в офисе" GuaranteeCode="None" PaymentSystemName="AT_OFFICE" DepositPayments="ExpectedPayment" LogusGuarantee="Deposit" />
<Rule Name="16 Без гарантии" GuaranteeCode="None" LogusGuarantee="Cash" />
</DepositRules>
Эти правила не предназначены для ручного редактирования и описаны на случай будущего расширения интерфейса с ТЛ либо для случаев обнаружения ошибок - например когда появилась какая-либо комбинации кода гарантии, платёжной системы и профайла, которые не предусмотрены изначальной конфигурацией (в этом случае в логе загрузки брони из ТЛ будет сообщение "Rule not found!" - что говорит что среди описанных правил не удалось подобрать требуемое). Исходя из правил Логус подбирает подходящую гарантию из справочника гарантий (первую в порядке сортировки) и подбирает код оплаты (безнал или эквайринг отеля)., а также определяет кто будет являться плательщиком брони: Guest - сам гость (компания-плательщик пуста), TL - Компания Трэвеллайн или Channel - тогда это канал из которого пришла бронь.
Санаторный режим работы
В Трэвеллайн во второй половине 2018-го года появился "санаторный" режим работы. Он имеет несколько важных отличий:
- Позволяет бронировать гостей в один номер по разным тарифам
Изменён способ подсчёта цен на детей на основных местах.
Если в настройках объекта указано "Дети на основном месте влияют на общую схему размещения" в положении ВКЛ, то для корректной выгрузки цен в ТЛ, <SanatoriumRates>False</SanatoriumRates>SanatoriumRates = False SanatoriumRates = True <?xml version="1.0" encoding="utf-8"?> <OTA_HotelRateAmountNotifRQ xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <RateAmountMessages HotelCode="3439" xmlns="http://www.opentravel.org/OTA/2003/05"> <RateAmountMessage> <StatusApplicationControl RatePlanCode="13129" InvTypeCode="17634" /> <Rates> <Rate Start="2021-06-18" End="2021-10-23"> <BaseByGuestAmts> <BaseByGuestAmt AmountAfterTax="2500.00" NumberOfGuests="1" /> <BaseByGuestAmt AmountAfterTax="2900.00" NumberOfGuests="2" /> <BaseByGuestAmt AmountAfterTax="400.00" NumberOfGuests="1" MinAge="8" MaxAge="14" /> <BaseByGuestAmt AmountAfterTax="400.00" NumberOfGuests="1" MinAge="3" MaxAge="7" /> </BaseByGuestAmts> <AdditionalGuestAmounts /> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>Цены детей на основных местах подкорректированы таким образом, чтобы учесть особенности расчёта тарифа со стороны ТЛ для отельного режима
<OTA_HotelRateAmountNotifRQ xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <RateAmountMessages HotelCode="3439" xmlns="http://www.opentravel.org/OTA/2003/05"> <RateAmountMessage> <StatusApplicationControl RatePlanCode="13129" InvTypeCode="17634" /> <Rates> <Rate Start="2021-06-18" End="2021-10-23"> <BaseByGuestAmts> <BaseByGuestAmt AmountAfterTax="2500.00" NumberOfGuests="1" /> <BaseByGuestAmt AmountAfterTax="2900.00" NumberOfGuests="2" /> <BaseByGuestAmt AmountAfterTax="1450.00" NumberOfGuests="1" MinAge="8" MaxAge="14" /> <BaseByGuestAmt AmountAfterTax="1450.00" NumberOfGuests="1" MinAge="3" MaxAge="7" /> </BaseByGuestAmts> <AdditionalGuestAmounts /> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>Коррекция цен детей на основных местах не применяется в санаторном режиме, поскольку ТЛ рассчитывает цены ровно так же как и Логус
Чтобы активировать "санаторный" режим выгрузки в Логусе, необходимо в настройках модуля установить признак (он включен по-умолчанию)
<SanatoriumRates>True</SanatoriumRates>
Для активации режима со стороны ТЛ нужно обратиться к менеджеру.
Интервал проверки новых броней
<!-- Общие настройки внешних каналов бронирования --> <ExternalChannels CheckNewReservationsCron="0 0/3 * * * ?" UpdateExternalChannelAvailabilityCron="0 0 3 * * ?"/>
| Для проверки доступности TL при выгрузке можно использовать | https://www.travelline.ru/api/TLConnect.svc |
|---|
Настройка основной квоты номеров в кабинете TL
После включения интеграции для ограничения онлайн-доступности номерного фонда есть два параметра: квота и in house квота.
Необходимо параметру "квота" проставить 999 на все типы номеров на максимально длительный период.
Параметр "in house квота" может использоваться для уменьшения онлайн-доступности номеров для бронирования через ТЛ.
Поддержка доставки изменений в проживающие брони
С версии 2.8.31 в CRS\TL, если в проживающие брони вносят изменения (например, о продлении или изменении тарифа, они потом синхронизируются и отображаются в Логусе.