Настройка CM Travel Line \ Тревеллайн

Общие настройки

Создайте профиль компании Трэвеллайн в разделе Клиенты.

Для настройки стыковки включите у Клиента роль Мастер продаж.

Выберите правильные коды транзакций предоплаты для безналичных платежей (от агентов) и для прямых оплат через эквайринг отеля (если такой подключен в Трэвеллайне). 

При помощи кнопки "Добавить" создайте   Внешний канал продаж. (см. скриншот)

Настройка тарифов

1. Перейдите во вкладку "Внешние тарифы"
2. Выберите тарифный план

3. Если тарифный план содержит пакет услуг, привяжите нужный пакет (Как привязывать несколько пакетов одновременно  см. ниже).

4. Укажите внешний код тарифа из ТЛ (коды тарифов можно посмотреть в личном кабинете или на вкладке Описание)

5. Нажмите "Добавить"

6. Перейдите во вкладку "Квоты"

7. В поле "Тарифы на продажу" активируйте нужные тарифы.

   Каждый тариф добавляется отдельной записью. Один тариф в LOGUS может быть сопоставлен с кодами разных тарифов из ТЛ. Например, если в личном кабинете ТЛ тарифы настроены как зависимые, и их цены не выгружаются из LOGUS.

Для случаев, когда необходимо привязать более одного пакета к тарифу, необходимо добавить для каждого пакета отдельную строчку с одним и тем же внешним идентификатором на закладке "внешние тарифы", как показано на примере:

В этом случае при бронировании по внешнему коду тарифа 10999 будет создана бронь с тарифом "GROUP" и тремя пакетами (завтрак, обед и ужин) одновременно

Настройка типов комнат

1. Перейдите во вкладку "Типы комнат"

2. Выберите тип комнаты

3. Укажите внешний ID (коды можно посмотреть в личном кабинете или на вкладке Описание)
   
   Первоначально, новые категории комнат добавляются в Личном кабинете ТЛ, им присваивается TL API, который в Логусе используется как Внешний ID.
   
   

Настройка услуг

В личном кабинете ТЛ настройте два варианта каждой услуги: включенный в стоимость и добавочный.

1. Перейдите во вкладку "Внешние услуги"
2. Выберите добавочную услугу

3. Укажите вариант

4. Укажите внешний код добавочной услуги из ТЛ (коды можно посмотреть в личном кабинете ТЛ)
   
   

   1. Не стоит указывать те коды услуг, которые включены в тариф, если в настройке тарифов вы использовали комбинацию тариф+пакет.
   2. Не все внешние каналы передают ID услуги. Необходимо добавить услугу с ID EXTRA_SERVICE для случая, когда ID добавочной услуги не передается каналом, предварительно настроив универсальную услугу в Logus.

   

   
   

Настройка каналов

1. Перейдите во вкладку "Квоты"
2. Добавьте каналы продаж, как это показано на первом скриншоте.
3. Если код агента отсутствует по ссылке ниже, тогда обратитесь в компанию ТЛ.
   
   

Обновление тарифов и доступности номеров:

При нажатии на кнопку "Обновить тарифы" происходит выгрузка цен из Логуса в Тревел Лайн.

Принудительное обновление наличия

ВНИМАНИЕ! КНОПКУ "НАСТРОИТЬ ПРЯМОЕ СООТВЕТСТВИЕ" НАЖИМАТЬ НЕ НУЖНО, Т.К. ЭТО ПРИВЕДЕТ К УДАЛЕНИЮ ВСЕХ ВНЕШНИХ ID, ВВЕДЕННЫХ РАНЕЕ.

Настройка интерфейса:

Обработка гарантии начиная с версии протокола 1.0:

Начиная с версии протокола 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 - тип гарантии

      <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-го года появился "санаторный" режим работы. Он имеет несколько важных отличий:

1. Позволяет бронировать гостей в один номер по разным тарифам

2. Изменён способ подсчёта цен на детей на основных местах. 

   Если в настройках объекта указано "Дети на основном месте влияют на общую схему размещения"  в положении ВКЛ, то для корректной выгрузки цен в ТЛ, <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

После включения интеграции для ограничения онлайн-доступности номерного фонда есть два параметра: квота и in house квота.

Необходимо параметру "квота" проставить 999 на все типы номеров на максимально длительный период.

Параметр "in house квота" может использоваться для уменьшения онлайн-доступности номеров для бронирования через ТЛ.