Page History

...

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

Info

Если код оплаты "Оплата эквайрингом отеля" имеет признак безналичной - должен быть указан также профиль компании плательщика. Например, ООО "Комфорт букинг"

Info

title	Возвраты

В общем случае есть два варианта отменить бронь, поступившую от ТЛ с депозитом:

пользователь сам отменяет в ЛК
отель отменяет по запросу пользователя в своем экстранете
В обоих случаях бронирование в Logus приходилось отменять руками, так как бронирование с балансом. В этом случае пользователь Logus заходит и корректирует транзакцию оплаты в счете брони.
С версии 2.9.170 в момент коррекции транзакции происходит автоматический возврат денег на карту.

...

Warning

Внимание! Одна из ошибок, по причине которой брони с настроенными тарифами не попадают в Logus - тариф не выставлен на продажу.

Например, "Невозможно определить квоту для тарифа с кодом '380720'. Привяжите тариф к квоте"

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

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

...

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

...

Info

С версии 2.11.2.224, для работы с некоторыми агентами необходимо, чтобы Логус игнорировал стоимость брони, передаваемой от ТЛ, и проставлял в брони цены тех тарифов, к которым привязаны API коды в Мастере продаж, передаваемые в XML запросе ТЛ. Для этого, XML конфигурация внешнего канала продаж расширена полем IgnoreRoomRates, по умолчанию значение для всех каналов false, если в конфигурации не указано true (c маленькой буквы!!!) Также, добавлено поле ChannelConfiguration, которое хранит в себе конфигурацию мастера продаж в формате XML:

Code Block

language	css
title	Пример конфига

<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>

Параметр <IgnoreRoomRates>True</IgnoreRoomRates> не распространяется на конфигурацию TL из config файла.

DepositRules расширены полями Agent (агент брони) и Company (компания брони) по аналогии с полем Payee.
Установка конфигурации происходит в настройках профиля компании:
Image Added

Секция настроек перенесена на вкладку Расшир. настройки:
Image Added

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

Перейдите во вкладку "Типы комнат"
Выберите тип комнаты
Укажите внешний ID (коды можно посмотреть в личном кабинете или на вкладке Описание)

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

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

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

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

Image AddedImage Added

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

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

Note

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

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

Info

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

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

Warning

title	ВНИМАНИЕ!

У каждого Клиента с ролью "Агент" должна быть задана комиссия по умолчанию на вкладке "Настройка ролей" в карточке клиента.
Если сумма в заявке от канала поступает уже за вычетом комиссии, то в этом случае размер комиссии необходимо указать = 0%
Например, такая ситуация типична для канала Броневик и т.п.

Перейдите во вкладку "Квоты"
Добавьте каналы продаж, как это показано на скриншоте.

Если код агента отсутствует по ссылке ниже, тогда обратитесь в компанию ТЛ

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" />

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

Info

Если код оплаты "Оплата эквайрингом отеля" имеет признак безналичной - должен быть указан также профиль компании плательщика. Например, ООО "НКО Юмани" в поле "Компания-плательщик онлайн-платежей

Code Block

language	xml
title	для случаев, когда в Rule конфига указан Payee="Online"

        <Rule Name="09 Оплата на сайте отеля (депозит получен) - эквайринг отеля" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="Hotel" Payee="Guest" Payee="Online" DepositPayments="ReceivedPayment" LogusGuarantee="Prepay" />

Image Added

Info
Страница со всеми кодами каналов продаж - https://www.travelline.ru/support/knowledge-base/kody-kanalov-prodazh-dlya-integratsii-s-asu/

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

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

Note

title	Важно

Внимание! Перед выполнением данной операции необходимо проконсультироваться с вашим менеджером в Тревел Лайн.

Если при выгрузке цен вы видите в логе ошибку Price integration is disabled, значит в Travelline не включена синхронизация цен по тарифам.

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

Info
Для принудительного обновления доступности номеров нажмите кнопку "Обновить наличие"

Tip

title	Настройка завершена!

Дальнейшая инструкция предназначена для технического специалиста или сотрудника компании, осуществяющего поддержку системы Logus HMS

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

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

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

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

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

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

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

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

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

Note

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

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

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

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

Warning

title	ВНИМАНИЕ!

У каждого Клиента с ролью "Агент" должна быть задана комиссия по умолчанию на вкладке "Настройка ролей" в карточке клиента.
Если сумма в заявке от канала поступает уже за вычетом комиссии, то в этом случае размер комиссии необходимо указать = 0%
Например, такая ситуация типична для канала Броневик и т.п.

...

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" />

...

Info

Code Block

language	xml
title	для случаев, когда в Rule конфига указан Payee="TL"

        <Rule Name="07 Оплата на сайте отеля (депозит получен) - эквайринг ТЛ" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="TravelLine" Payee="Online" Agent="TL" Company="TL" DepositPayments="ReceivedPayment" LogusGuarantee="DirectBill" />

Image Removed

Info
Страница со всеми кодами каналов продаж - https://www.travelline.ru/support/knowledge-base/kody-kanalov-prodazh-dlya-integratsii-s-asu/

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

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

Note

title	Важно

Внимание! Перед выполнением данной операции необходимо проконсультироваться с вашим менеджером в Тревел Лайн.

Если при выгрузке цен вы видите в логе ошибку Price integration is disabled, значит в Travelline не включена синхронизация цен по тарифам.

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

Info
Для принудительного обновления доступности номеров нажмите кнопку "Обновить наличие"

...

title	Настройка завершена!

...

Expand

Настройка фискализации платежей от ООО "Комфорт букинг":

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

Если тип оплаты выбран "Безналичный", то в поле "Компания плательщик онлайн платежей" необходимо указать ООО "Комфорт букинг"

Note

В этом случае на профиле компании не должно быть заполнено ни одного реквизита из тех, что передаются обычно на фискал, включая Имя на счетах, ИНН, адрес и т.д.

А в локальном конфиге Логуса на рабочей станции должно быть отключено требование ИНН для юр.лиц при фискализации

Клиентам:
Перед выселением такого гостя необходимо руками объединить предоплату и услуги в финдок, либо через выделение и "оплатить" 0 руб. И провести фискализацию окночательного расчета. Все по инструкции. Либо включить фоновую фискализацию

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

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

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

Image Added

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>True</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="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

language	xml

<!-- Общие настройки внешних каналов бронирования -->
<ExternalChannels CheckNewReservationsCron="0 0/3 * * * ?" UpdateExternalChannelAvailabilityCron="0 0 3 * * ?"/>

Для проверки доступности TL при выгрузке можно использовать	https://www.travelline.ru/api/TLConnect.svc

Настройка основной квоты номеров в кабинете TL

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

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

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

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

Info

title

Гости в бронировании

С версии 3.11.1, доработан функционал сохранения брони на стороне сервиса.

В конфиг TL добавлен параметр GenerateGuests, который будет сверять гостей в брони со схемой размещения и добавлять недостающих:

Code Block

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

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

Space shortcuts

Page tree

Versions Compared

Old Version 111

New Version Current

Key

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

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

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

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

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

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

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

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

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

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

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

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

Настройка фискализации платежей от ООО "Комфорт букинг":

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

GuaranteeType - тип гарантии

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

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

Интервал проверки новых броней

Настройка основной квоты номеров в кабинете TL