Версия

1.0

Logus The BoxДа



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

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

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

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

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

ВАЖНО!!! HotelCode, который отображается в интерфейсе сайта TL может отличатся от внешнего кода отеля который мы прописываем в конфиге. Если не известен нужно уточнить в тп TL или у клиента. 

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

Название вкладкиНазначение
КвотыКвота номеров, выставленных на продажу. Обычно используется Весь пул номеров MAIN,

Типы комнат

Типы комнат, выставленные на продажу
Внешние тарифыТарифы, настроенные в личном кабинете ТЛ
Внешние услугиКоды внешних услуг.
ОписаниеОписание внешних кодов, полученных по протоколу стыковки.
Убедитесь, что категории детей в Тревеллайн совпадают  с настройками в Logus, чтобы гости попадали в Логус под правильной категорией и тарифы выгружались корректно. Посмотреть возрастные категории детей можно в настройках Объекта в разделе Администрирование.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. Укажите внешний ID (коды можно посмотреть в личном кабинете или на вкладке Описание)

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

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

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

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

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

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

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

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

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

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

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


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

101hotels.com

H1C

Acase.ru

ACS

Agoda

AGD

Airbnb

ARB

Airbnb (new)

AB2

Alean.ru

ALN

AllHotelsMarket

101

ALTAI TRAVEL GUIDE

ATG

Avia-centr.ru

AVI

Axis.travel

AXT

Azent

AZN

Bakuun

BKN

BelAgroTravel

BEL

Booking.com

BGC

Bronevik.com

BRN

Bukovel 24

B24

CBooking

CBG

Cosmos-Travel

CTL

Ctrip.com

CTP

CUVA

CUV

Delfin-tour.ru

DNT

Direct Rates

DRS

Dobovo.com

DBV

Dolores Travel Russia

DTL

DOTW

DTW

EduClub

EDC

Expedia.com

EXP

Feratel Deskline

FER

FUN

GSH

FUN&SUN (new)

FNS

Gta-travel.com

GTA

HostelsClub

HSC

Hostelworld

HSW

Hotel-inn.ru

HIN

Hotelbeds.com

HBS

HotelBook.pro

UTS

Hotels24.ua

H24

Hotels.ru

HRU

HotelZon.com

HZN

Hotusa.com

HUS

HRS

HRS

Intourist.ru — Tour Operator

IT3

Intourist.com — DMC Russia

IT2

JacTravel

JAC

KANDAGAR

KDH

Keytel

KLT

Kraspol.Club

KPC

Kurortix.ru/МирТурбаз.ру

MTB

Kuzuk.ru

KZK

LCI-MTC Group

JUN

LLC «Travel Company «MERCURY»

MCR

Metglobal

MGL

MG Bedbank

MGH

MIK.TRAVEL

MIK

Miki Travel

MKT

Mouzenidis Intour

MZD

Mybookit.ru

MBI

MyHotelshop

MHS

New Logic

NLG

OneTwoTrip

OTT

Online-Express.ru

ONE

Orientirum

ORT

Ostrovok.ru

OTK

Oteling.ru

OTL

OTS Globe

OTS

Ozon

OZO

PEGAS Touristik

PGS

Pegi Pegi

PEG

Reliztour

RLT

Restel

RTL

RUSSPASS

RSP

S7 Airlines (travel retail)

S7A

Sanatory.ru

STR

Seven.travel

SVN

Skayra

SKR

SMART ARKTUR ASLA

ARK

Smartway

SMW

SpecialTours

SPT

Svoy Hotel

SVT

Tickets.ua

TCK

Tiket.com

TKT

Topbelarus.com

TBS

Topservice Travel & Lifestyle

TTL

Travco

TVC

Traveloka

OKA

Trivio

TIO

TUI Россия

TUI

Tvil.ru

TVL

Vashotel.ru

VHT

VETLIVA

VTL

VHOTEL

VHL

Visit-Sochi

VSC

Zabroniryi.ru

ANA

Zdravo

ZDR

Авито

AVT

АЛЬЯНС ЮГ ТУР

ALT

Арт-Тревел

ART

ВЕДИ ГРУПП

VDG

ГАУК «МОСГОРТУР»

MGT

Городской центр бронирования

CBC

Едем в гости

EVG

ЗАО «Консолидация оздоровления населения»

KON

Здоровый мир-Сочи

ZMS

Золотые Купола

GLD

Клуб любимых туристов

CLT

Криптон

KPT

Крымский туроператор «Кенеш-тур»

KNS

Ласпи

LSP

Магазин Отдыха

MAT

Мультитур

MTT

Мультитур(new)

MT2

Наш.Travel

KRT

НеДома.ру

NDM

Новый Сочи

SCH

Онлайн-магазин rosakhutor.com

RH2

Отелло

OLO

ПАКС/PAKS

PKS

Пантеон

PTN

Планета Сочи

PSC

Региональный центр бронирования

RCR

Ривьера Сочи

RSC

Роза ветров

RST

Роза Хутор

RSH

РосЮгКурорт

RYK

Санатории-России.рф

SNR

Суточно.ру

SUT

Таларии

TLR

ТО Планета Travel

PTT

Травелата

TVA

Турбаза.ру

TBR

Туристическая фирма «Сусанин»

SSN

Туроператор Space Travel

SPL

ХотелСтар

VPS

Центр Внутреннего Туризма и Отдыха

TCM

Яндекс.Путешествия

YNDX_HTL

МАГТУР

MGR

РЭДИ-РЕСТ

RDR

Вкомандировке

VKM

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

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

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

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

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

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

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

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

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

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

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

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


Клиентам:
Перед выселением такого гостя необходимо руками объединить предоплату и услуги в финдок, либо через выделение и "оплатить" 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 - тип гарантии

 ЗначениеВ рулахВ логусе
0DirectBillБезналичная оплата
1CashНаличные
2DepositДепозит
3CreditCardКредитная Карта
      <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 = FalseSanatoriumRates = 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 при выгрузке можно использоватьhttps://www.travelline.ru/api/TLConnect.svc

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

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

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

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

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