| Версия | 1.0 |
| Logus The Box | Да |
Создайте профиль компании Трэвеллайн в разделе Клиенты.
Для настройки стыковки включите у Клиента роль Мастер продаж.
Выберите правильные коды транзакций предоплаты для безналичных платежей (от агентов) и для прямых оплат через эквайринг отеля (если такой подключен в Трэвеллайне).
В общем случае есть два варианта отменить бронь, поступившую от ТЛ с депозитом:
|
ВАЖНО!!! HotelCode, который отображается в интерфейсе сайта TL может отличатся от внешнего кода отеля который мы прописываем в конфиге. Если не известен нужно уточнить в тп TL или у клиента. |
При помощи кнопки "Добавить" создайте Внешний канал продаж. (см. скриншот)
| Название вкладки | Назначение |
|---|---|
| Квоты | Квота номеров, выставленных на продажу. Обычно используется Весь пул номеров MAIN, |
Типы комнат | Типы комнат, выставленные на продажу |
| Внешние тарифы | Тарифы, настроенные в личном кабинете ТЛ |
| Внешние услуги | Коды внешних услуг. |
| Описание | Описание внешних кодов, полученных по протоколу стыковки. |
| Убедитесь, что категории детей в Тревеллайн совпадают с настройками в Logus, чтобы гости попадали в Логус под правильной категорией и тарифы выгружались корректно. Посмотреть возрастные категории детей можно в настройках Объекта в разделе Администрирование. |
Если тарифный план содержит пакет услуг, привяжите нужный пакет (Как привязывать несколько пакетов одновременно см. ниже).
Укажите внешний код тарифа из ТЛ (коды тарифов можно посмотреть в личном кабинете или на вкладке Описание)
Нажмите "Добавить"
Перейдите во вкладку "Квоты"
В поле "Тарифы на продажу" активируйте нужные тарифы.
Каждый тариф добавляется отдельной записью. Один тариф в LOGUS может быть сопоставлен с кодами разных тарифов из ТЛ. Например, если в личном кабинете ТЛ тарифы настроены как зависимые, и их цены не выгружаются из LOGUS. |
Для случаев, когда необходимо привязать более одного пакета к тарифу, необходимо добавить для каждого пакета отдельную строчку с одним и тем же внешним идентификатором на закладке "внешние тарифы", как показано на примере:
В этом случае при бронировании по внешнему коду тарифа 10999 будет создана бронь с тарифом "GROUP" и тремя пакетами (завтрак, обед и ужин) одновременно
Внимание! Одна из ошибок, по причине которой брони с настроенными тарифами не попадают в Logus - тариф не выставлен на продажу. Например, "Невозможно определить квоту для тарифа с кодом '380720'. Привяжите тариф к квоте"
|
С версии 2.11.2.224, для работы с некоторыми агентами необходимо, чтобы Логус игнорировал стоимость брони, передаваемой от ТЛ, и проставлял в брони цены тех тарифов, к которым привязаны API коды в Мастере продаж, передаваемые в XML запросе ТЛ. Для этого, XML конфигурация внешнего канала продаж расширена полем
Параметр <IgnoreRoomRates>True</IgnoreRoomRates> не распространяется на конфигурацию TL из config файла.
Секция настроек перенесена на вкладку Расшир. настройки: |
Выберите тип комнаты
Укажите внешний ID (коды можно посмотреть в личном кабинете или на вкладке Описание)
Первоначально, новые категории комнат добавляются в Личном кабинете ТЛ, им присваивается TL API, который в Логусе используется как Внешний ID.
В личном кабинете ТЛ настройте два варианта каждой услуги: включенный в стоимость и добавочный.
Настройка маппинга необходима только для добавочных услуг. |
Укажите вариант
Укажите внешний код добавочной услуги из ТЛ (коды можно посмотреть в личном кабинете ТЛ)
Не все внешние каналы передают ID услуги. Необходимо добавить услугу с ID EXTRA_SERVICE для случая, когда ID добавочной услуги не передается каналом, предварительно настроив универсальную услугу в Logus. |
У каждого Клиента с ролью "Агент" должна быть задана комиссия по умолчанию на вкладке "Настройка ролей" в карточке клиента. |
Добавьте Компанию ООО "Комфорт Букинг" с кодом TLPAYEE в список агентов
|
В случае, если онлайн-платежи через Тревеллайн осуществляются с помощью стороннего эквайринга, и на объекте необходимо при интеграции бронирований в поле Компания видеть профиль Тревеллайн, а в поле Компания-плательщик указывается юр.лицо провайдера эквайринг, то настройка в конфиге с правилом №8 должны вноситься следующим образом:
Если код оплаты "Оплата эквайрингом отеля" имеет признак безналичной - должен быть указан также профиль компании плательщика. Например, ООО "НКО Юмани" в поле "Компания-плательщик онлайн-платежей
|
Страница со всеми кодами каналов продаж - https://www.travelline.ru/support/knowledge-base/kody-kanalov-prodazh-dlya-integratsii-s-asu/ |
При нажатии на кнопку "Обновить тарифы" происходит выгрузка цен из Логуса в Тревел Лайн.
Внимание! Перед выполнением данной операции необходимо проконсультироваться с вашим менеджером в Тревел Лайн. Если при выгрузке цен вы видите в логе ошибку Price integration is disabled, значит в Travelline не включена синхронизация цен по тарифам. |
Принудительное обновление наличия
Для принудительного обновления доступности номеров нажмите кнопку "Обновить наличие" |
Дальнейшая инструкция предназначена для технического специалиста или сотрудника компании, осуществяющего поддержку системы Logus HMS |
С версии 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 приходит несколько броней (одна бронь ТЛ может содержать несколько броней Логуса), то оплата распределяется по броням.
Если в комнате проживает несколько гостей и создаётся разделённая бронь, то оплата разносится по броням в разделении.
Если сумма превышает расчётное значение по броням, то разница добавляется на первую бронь.
Настройка фискализации платежей от ООО "Комфорт букинг":Если будут обращаться клиенты по фискализации "авансов" от комфорт букинга: Если тип оплаты выбран "Безналичный", то в поле "Компания плательщик онлайн платежей" необходимо указать ООО "Комфорт букинг"
|
| Код гарантии | Вид гарантии в Логусе |
|---|---|
| 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
| Значение | В рулах | В логусе |
|---|---|---|
| 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 | ||
|---|---|---|---|
Цены детей на основных местах подкорректированы таким образом, чтобы учесть особенности расчёта тарифа со стороны ТЛ для отельного режима |
Коррекция цен детей на основных местах не применяется в санаторном режиме, поскольку ТЛ рассчитывает цены ровно так же как и Логус |
Чтобы активировать "санаторный" режим выгрузки в Логусе, необходимо в настройках модуля установить признак (он включен по-умолчанию)
<SanatoriumRates>True</SanatoriumRates> |
Для активации режима со стороны ТЛ нужно обратиться к менеджеру.
<!-- Общие настройки внешних каналов бронирования --> <ExternalChannels CheckNewReservationsCron="0 0/3 * * * ?" UpdateExternalChannelAvailabilityCron="0 0 3 * * ?"/> |
| Для проверки доступности TL при выгрузке можно использовать | https://www.travelline.ru/api/TLConnect.svc |
|---|
После включения интеграции для ограничения онлайн-доступности номерного фонда есть два параметра: квота и in house квота.
Необходимо параметру "квота" проставить 999 на все типы номеров на максимально длительный период.
Параметр "in house квота" может использоваться для уменьшения онлайн-доступности номеров для бронирования через ТЛ.
С версии 3.11.1, доработан функционал сохранения брони на стороне сервиса. В конфиг TL добавлен параметр GenerateGuests, который будет сверять гостей в брони со схемой размещения и добавлять недостающих:
|
