Page History

...

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

...

<ChannelConfiguration>
<IgnoreRoomRates>true</IgnoreRoomRates>
<DepositRules>
<Rule Name="01 Выставлен счёт на юрлицо (автоматически)" GuaranteeCode="PrePay" PaymentSystemName="CASHLESS" PaymentSystemProfileAcquiringName="" DepositPayments="ExpectedPayment" />
<Rule Name="02 Выставлен счёт на юрлицо (отелем)" GuaranteeCode="PrePay" PaymentSystemName="MANUAL_CASHLESS" Payee="Channel" Agent="TL" Company="Guest" PaymentSystemProfileAcquiringName="" DepositPayments="ExpectedPayment" />
...
</DepositRules>
</ChannelConfiguration>

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

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

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

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

...

Предпочтения в номере

В личном кабинете ТЛ настройте внешние коды тегов на влкадке Интеграция с АСУ → Справочники → Предпочтения в номере

В поле "Код Travelline API"  необходимо указать код тега в Logus с применимостью "Бронь".

Image AddedImage Added

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

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

...

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

   
   

   Info

   Добавьте Компанию ООО "Комфорт Букинг" с кодом TLPAYEE в список агентов Code Block language xml title для случаев, когда в Rule конфига указан Payee="TL" <Rule Name="06 Оплата на сайте отеля (депозит ожидается) - эквайринг ТЛ" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="TravelLine" Payee="TL" DepositPayments="ExpectedPayment" /> <Rule Name="07 Оплата на сайте отеля (депозит получен) - эквайринг ТЛ" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="TravelLine" Payee="TL" DepositPayments="ReceivedPayment" LogusGuarantee="DirectBill" />

   
   

   В случае, если все онлайн-платежи через Тревеллайн осуществляются с помощью компании ООО "Комфорт Букинг" стороннего эквайринга, и на объекте необходимо при интеграции бронирований в поле Компания видеть профиль Тревеллайн, а в поле Компания-плательщик профиль Комфорт Букингауказывается юр.лицо провайдера эквайринг, то настройка в конфиге с правилом №7 №8 должны вноситься следующим образом: 
   
   

   Info

   Если код оплаты "Оплата эквайрингом отеля" имеет признак безналичной - должен быть указан также профиль компании плательщика. Например, ООО "НКО Юмани" в поле "Компания-плательщик онлайн-платежей Code Block language xml title для случаев, когда в Rule конфига указан Payee="Online" <Rule Name="0709 Оплата на сайте отеля (депозит получен) - эквайринг ТЛотеля" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="TravelLineHotel" Payee="OnlineGuest" AgentPayee="TL" Company="TL"Online" DepositPayments="ReceivedPayment" LogusGuarantee="DirectBillPrepay" />

...

Поддержка доставки изменений в проживающие брони

С версии 2.8.31 в CRS\TL, если в проживающие брони вносят изменения (например, о продлении или изменении тарифа), они потом синхронизируются и отображаются в Логусе.

Доставка изменений из ТЛ, когда ранее созданную (наличную) бронь оплатили

После появления у ТЛ функционала оплаты по ссылке, которая может быть произведена гостями в любой момент, появилась проблема при доставке подобных изменений в Логус. Т.к. у изначальной брони должны изменить и гарантия, и компания-плательщик. Для подобных ситуаций необходимо скорректировать правила в конфигураторе по примеру ниже (пример взят из конфигуратора отеля):

<Rule Name="14 Оплата при заезде" GuaranteeCode="Cash" Company="TL" LogusGuarantee="Cash" />

       <Rule Name="15 Оплата в офисе" GuaranteeCode="None" PaymentSystemName="AT_OFFICE" DepositPayments="ExpectedPayment" LogusGuarantee="Deposit" />

        <Rule Name="16 Оплата до заезда" GuaranteeCode="None" Payee="Online" Agent="Online" Company="TL" DepositPayments="ReceivedPayment" LogusGuarantee="Deposit" />

        <Rule Name="17 Без гарантии" GuaranteeCode="None" Company="TL" LogusGuarantee="Cash" />

Распределение оплат по броням

С версии  3.0.1, для упрощения процесса распределения предоплаты по броням из TravelLine, реализован автоматический режим распределения, аналогичный режиму "Последовательно по сумме проживания" при импорте банковской выписки. Функция настраивается сотрудниками ТП.

Логика:
Если в рамках одной брони из TL приходит несколько броней (одна бронь ТЛ может содержать несколько броней Логуса), то оплата распределяется по броням.
Если в комнате проживает несколько гостей и создаётся разделённая бронь, то оплата разносится по броням в разделении.
Если сумма превышает расчётное значение по броням, то разница добавляется на первую бронь.

Начиная с версии протокола 1.14 правила гарантии и предоплат регулируются депозитными правилами, описанными в конфигурации:

Image Removed

Выборка рулов:
Порядок выбора рула и условия:
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 - тип гарантии

Выбор кода транзкации

Image Removed

      <DepositRules>

      <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="0701 ОплатаВыставлен счёт на сайте отеляюрлицо (депозит получен) - эквайринг ТЛавтоматически)" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringNamePaymentSystemName="TravelLineCASHLESS" PayeePaymentSystemProfileAcquiringName="Online" DepositPayments="ReceivedPaymentExpectedPayment" LogusGuarantee="DirectBill" />
        <Rule Name="0802 Выставлен Оплатасчёт на сайте отеляюрлицо (депозит ожидается) - эквайринг отеляотелем)" GuaranteeCode="PrePay" PaymentSystemName="MANUAL_CASHLESS" PaymentSystemProfileAcquiringName="Hotel" DepositPayments="ExpectedPayment" />
        <Rule Name="0903 ОплатаБронь наоплачена сайте отеля (депозит получен) - эквайринг отеляканалу бронирования" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringNamePaymentSystemName="HotelCM_CASHLESS" Payee="GuestChannel" DepositPayments="ReceivedPayment" LogusGuarantee="CreditCardDirectBill" />
        <Rule Name="1004 ГарантияВыставлен кредитнойсчёт картой - карта гостяфизлицу (автоматически)" GuaranteeCode="CcDcVoucherPrePay" PaymentSystemName="CM_CREDITCARD_GUARANTEEINDIVIDUAL_CASHLESS" PaymentSystemProfileAcquiringName="" LogusGuaranteeDepositPayments="CreditCardExpectedPayment" />
        <Rule Name="1105 ГарантияВыставлен кредитнойсчёт картой - виртуальная карта канала OTAфизлицу (отелем)" GuaranteeCode="CcDcVoucherPrePay" PaymentSystemName="CMMANUAL_PREPAYINDIVIDUAL_CREDITCARD_GUARANTEECASHLESS" PayeePaymentSystemProfileAcquiringName="Channel" LogusGuaranteeDepositPayments="CreditCardExpectedPayment" />
        <Rule Name="1206 ГарантияОплата кредитнойна картойсайте -отеля карта(депозит гостяожидается) через- сайтэквайринг отеляТЛ" GuaranteeCode="CcDcVoucherPrePay" LogusGuaranteePaymentSystemProfileAcquiringName="CreditCardTravelLine" />
 Payee="Online" DepositPayments="ExpectedPayment" />
        <Rule Name="1307 ГарантияОплата кредитнойна картойсайте -отеля канал(депозит передалполучен) детали- картыэквайринг в гостиницуТЛ" GuaranteeCode="PrePay" PaymentSystemNamePaymentSystemProfileAcquiringName="TravelLine" Payee="Online" DepositPayments="CM_CREDITCARDReceivedPayment" LogusGuarantee="CreditCardDirectBill" />
        <Rule Name="1408 Оплата прина заезде" GuaranteeCode="Cash" LogusGuarantee="Cashсайте отеля (депозит ожидается) - эквайринг отеля" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="Hotel" DepositPayments="ExpectedPayment" />
        <Rule Name="1509 Оплата в офисе на сайте отеля (депозит получен) - эквайринг отеля" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="NoneHotel" PaymentSystemNamePayee="AT_OFFICEGuest" DepositPayments="ExpectedPaymentReceivedPayment" LogusGuarantee="DepositCreditCard" />
        <Rule Name="1610 Без гарантииГарантия кредитной картой - карта гостя" GuaranteeCode="None"CcDcVoucher" PaymentSystemName="CM_CREDITCARD_GUARANTEE" LogusGuarantee="CashCreditCard" />
      </DepositRules>

Эти правила не предназначены для ручного редактирования и описаны на случай будущего расширения интерфейса с ТЛ либо для случаев обнаружения ошибок - например когда появилась какая-либо комбинации кода гарантии, платёжной системы и профайла, которые не предусмотрены изначальной конфигурацией (в этом случае в логе загрузки брони из ТЛ будет сообщение "Rule not found!" - что говорит что среди описанных правил не удалось подобрать требуемое). Исходя из правил Логус подбирает подходящую гарантию из справочника гарантий (первую в порядке сортировки) и подбирает код оплаты (безнал или эквайринг отеля)., а также определяет кто будет являться плательщиком брони: Guest - сам гость (компания-плательщик пуста), TL - Компания Трэвеллайн или Channel - тогда это канал из которого пришла бронь.

Санаторный режим работы

В Трэвеллайн во второй половине 2018-го года появился "санаторный" режим работы. Он имеет несколько важных отличий:

  <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. Изменён способ подсчёта цен на детей на основных местах. 

   Note
   Если в настройках объекта указано "Дети на основном месте влияют на общую схему размещения"  в положении ВКЛ, то для корректной выгрузки цен в ТЛ, <SanatoriumRates>True</SanatoriumRates>

   SanatoriumRates = False	SanatoriumRates = True
   Code Block language xml <?xml version="1.0" encoding="utf-8"?> <OTA_HotelRateAmountNotifRQ xmlns:xsd="http://www.w3.

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

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

   Note
   Если в настройках объекта указано "Дети на основном месте влияют на общую схему размещения"  в положении ВКЛ, то для корректной выгрузки цен в ТЛ, <SanatoriumRates>False</SanatoriumRates>

   SanatoriumRates = False

   SanatoriumRates = True

   Code Block language xml <?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> Цены детей на основных местах подкорректированы таким образом, чтобы учесть особенности расчёта тарифа со стороны ТЛ для отельного режима Code Block language xml <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="1450400.00" NumberOfGuests="1" MinAge="8" MaxAge="14" /> <BaseByGuestAmt AmountAfterTax="1450400.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 квота" может использоваться для уменьшения онлайн-доступности номеров для бронирования через ТЛ.

Image Removed

Поддержка доставки изменений в проживающие брони

С версии 2.8.31 в CRS\TL, если в проживающие брони вносят изменения (например, о продлении или изменении тарифа), они потом синхронизируются и отображаются в Логусе.

Доставка изменений из ТЛ, когда ранее созданную (наличную) бронь оплатили

После появления у ТЛ функционала оплаты по ссылке, которая может быть произведена гостями в любой момент, появилась проблема при доставке подобных изменений в Логус. Т.к. у изначальной брони должны изменить и гарантия, и компания-плательщик. Для подобных ситуаций необходимо скорректировать правила в конфигураторе по примеру ниже (пример взят из конфигуратора отеля):

<Rule Name="14 Оплата при заезде" GuaranteeCode="Cash" Company="TL" LogusGuarantee="Cash" />

       <Rule Name="15 Оплата в офисе" GuaranteeCode="None" PaymentSystemName="AT_OFFICE" DepositPayments="ExpectedPayment" LogusGuarantee="Deposit" />

        <Rule Name="16 Оплата до заезда" GuaranteeCode="None" Payee="Online" Agent="Online" Company="TL" DepositPayments="ReceivedPayment" LogusGuarantee="Deposit" />

        <Rule Name="17 Без гарантии" GuaranteeCode="None" Company="TL" LogusGuarantee="Cash" />

Распределение оплат по броням

С версии  3.0.1, для упрощения процесса распределения предоплаты по броням из TravelLine, реализован автоматический режим распределения, аналогичный режиму "Последовательно по сумме проживания" при импорте банковской выписки. Функция настраивается сотрудниками ТП.

1. подкорректированы таким образом, чтобы учесть особенности расчёта тарифа со стороны ТЛ для отельного режима

   Code Block language xml <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 квота" может использоваться для уменьшения онлайн-доступности номеров для бронирования через ТЛ.

Image Added

<!-- Генерировать всех гостей по схеме размещения -->
            <GenerateGuests>False</GenerateGuests>