| Widget Connector |
|---|
| url | https://www.youtube.com/watch?v=KHlo_uBQ2b0 |
|---|
|
| |
|---|
Общие настройки
Создайте профиль компании Трэвеллайн в разделе Клиенты.
Для настройки стыковки включите у Клиента роль Мастер продаж.
Выберите правильные коды транзакций предоплаты для безналичных платежей (от агентов) и для прямых оплат через эквайринг отеля (если такой подключен в Трэвеллайне).
| Info |
|---|
Оплата эквайрингом отеля не может быть безналичной - такие брони будут попадать без компании-плательщика, и 150-й код на них принять невозможно. Код оплаты "Оплата эквайрингом отеля" не должна быть безналичной - это должен быть платёж с типом "Банк" или "Внешний"! |
| Info |
|---|
ВАЖНО!!! HotelCode, который отображается в интерфейсе сайта TL может отличатся от внешнего кода отеля который мы прописываем в конфиге. Если не известен нужно уточнить в тп TL или у клиента. |
При помощи кнопки "Добавить" создайте Внешний канал продаж. (см. скриншот)
| Название вкладки | Назначение |
|---|
| Квоты | Квота номеров, выставленных на продажу. Обычно используется Весь пул номеров MAIN, |
Типы комнат | Типы комнат, выставленные на продажу |
| Внешние тарифы | Тарифы, настроенные в личном кабинете ТЛ |
| Внешние услуги | Коды внешних услуг. |
| Описание | Описание внешних кодов, полученных по протоколу стыковки. |
| Info |
|---|
| Убедитесь, что категории детей в Логусе и в ТЛ совпадают - возраст должен быть одинаковым, чтобы гости попадали в Логус под правильной категорией. |
Настройка тарифов
- Перейдите во вкладку "Внешние тарифы"
- Выберите тарифный план
Если тарифный план содержит пакет услуг, привяжите нужный пакет (Как привязывать несколько пакетов одновременно см. ниже).
Укажите внешний код тарифа из ТЛ (коды тарифов можно посмотреть в личном кабинете или на вкладке Описание)
Нажмите "Добавить"
Перейдите во вкладку "Квоты"
В поле "Тарифы на продажу" активируйте нужные тарифы.
| Info |
|---|
Каждый тариф добавляется отдельной записью. Один тариф в LOGUS может быть сопоставлен с кодами разных тарифов из ТЛ. Например, если в личном кабинете ТЛ тарифы настроены как зависимые, и их цены не выгружаются из LOGUS. |
Для случаев, когда необходимо привязать более одного пакета к тарифу, необходимо добавить для каждого пакета отдельную строчку с одним и тем же внешним идентификатором на закладке "внешние тарифы", как показано на примере:
В этом случае при бронировании по внешнему коду тарифа 10999 будет создана бронь с тарифом "GROUP" и тремя пакетами (завтрак, обед и ужин) одновременно
| Warning |
|---|
Внимание! Одна из ошибок, по причине которой брони с настроенными тарифами не попадают в Logus - тариф не выставлен на продажу. Перейдите во вкладку "Квоты" В поле "Тарифы на продажу" активируйте нужные тарифы.
|
Настройка типов комнат
- Перейдите во вкладку "Типы комнат"
Выберите тип комнаты
Укажите внешний ID (коды можно посмотреть в личном кабинете или на вкладке Описание)
Первоначально, новые категории комнат добавляются в Личном кабинете ТЛ, им присваивается TL API, который в Логусе используется как Внешний ID.
Настройка услуг
В личном кабинете ТЛ настройте два варианта каждой услуги: включенный в стоимость и добавочный.
| Note |
|---|
Настройка маппинга необходима только для добавочных услуг.
Не стоит указывать в настройках внешние ID тех услуг, которые включены в тариф. Потому что произойдет их дублирование, если в маппинге тарифов вы использовали комбинацию тариф+пакет. |
- Перейдите во вкладку "Внешние услуги"
- Выберите добавочную услугу
Укажите вариант
Укажите внешний код добавочной услуги из ТЛ (коды можно посмотреть в личном кабинете ТЛ)
| Info |
|---|
Не все внешние каналы передают ID услуги. Необходимо добавить услугу с ID EXTRA_SERVICE для случая, когда ID добавочной услуги не передается каналом, предварительно настроив универсальную услугу в Logus. |
Настройка каналов
| Warning |
|---|
|
У каждого Клиента с ролью "Агент" должна быть задана комиссия по умолчанию на вкладке "Настройка ролей" в карточке клиента.
Если сумма в заявке от канала поступает уже за вычетом комиссии, то в этом случае размер комиссии необходимо указать = 0%
Например, такая ситуация типична для канала Броневик и т.п. |
- Перейдите во вкладку "Квоты"
- Добавьте каналы продаж, как это показано на скриншоте.
- Если код агента отсутствует по ссылке ниже, тогда обратитесь в компанию ТЛ.
Обновление тарифов и доступности номеров:
При нажатии на кнопку "Обновить тарифы" происходит выгрузка цен из Логуса в Тревел Лайн.
| Note |
|---|
|
Внимание! Перед выполнением данной операции необходимо проконсультироваться с вашим менеджером в Тревел Лайн. Если при выгрузке цен вы видите в логе ошибку Price integration is disabled, значит в Travelline не включена синхронизация цен по тарифам. |
Принудительное обновление наличия
| Info |
|---|
Для принудительного обновления доступности номеров нажмите кнопку "Обновить наличие" |
ВНИМАНИЕ! КНОПКУ "НАСТРОИТЬ ПРЯМОЕ СООТВЕТСТВИЕ" НАЖИМАТЬ НЕ НУЖНО, Т.К. ЭТО ПРИВЕДЕТ К УДАЛЕНИЮ ВСЕХ ВНЕШНИХ ID, ВВЕДЕННЫХ РАНЕЕ.
| Tip |
|---|
| title | Настройка завершена! |
|---|
|
Дальнейшая инструкция предназначена для технического специалиста или сотрудника компании, осуществяющего поддержку системы Logus HMS |
| Expand |
|---|
Настройка интерфейса:Обработка гарантии начиная с версии протокола 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 | Кредитная Карта |
| Code Block |
|---|
| language | xml |
|---|
| title | Файл logus.local.config |
|---|
| <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-го года появился "санаторный" режим работы. Он имеет несколько важных отличий: - Позволяет бронировать гостей в один номер по разным тарифам
Изменён способ подсчёта цен на детей на основных местах. | Note |
|---|
| Если в настройках объекта указано "Дети на основном месте влияют на общую схему размещения" в положении ВКЛ, то для корректной выгрузки цен в ТЛ, <SanatoriumRates>False</SanatoriumRates> |
| SanatoriumRates = False | SanatoriumRates = True |
|---|
| Code Block |
|---|
| <?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 |
|---|
| <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> |
Коррекция цен детей на основных местах не применяется в санаторном режиме, поскольку ТЛ рассчитывает цены ровно так же как и Логус |
Чтобы активировать "санаторный" режим выгрузки в Логусе, необходимо в настройках модуля установить признак (он включен по-умолчанию) | Code Block |
|---|
<SanatoriumRates>True</SanatoriumRates> |
Для активации режима со стороны ТЛ нужно обратиться к менеджеру.
Интервал проверки новых броней
| Code Block |
|---|
| <!-- Общие настройки внешних каналов бронирования -->
<ExternalChannels CheckNewReservationsCron="0 0/3 * * * ?" UpdateExternalChannelAvailabilityCron="0 0 3 * * ?"/> |
Настройка основной квоты номеров в кабинете TLПосле включения интеграции для ограничения онлайн-доступности номерного фонда есть два параметра: квота и in house квота. Необходимо параметру "квота" проставить 999 на все типы номеров на максимально длительный период. Параметр "in house квота" может использоваться для уменьшения онлайн-доступности номеров для бронирования через ТЛ. 
| Info |
|---|
| title | Поддержка доставки изменений в проживающие брони |
|---|
| С версии 2.8.31 в CRS\TL, если в проживающие брони вносят изменения (например, о продлении или изменении тарифа, они потом синхронизируются и отображаются в Логусе. |
|