Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To configure the joining, enable the "Sales master" role for the company.


Image RemovedImage Added


Use correct prepaid transaction codes for non-cash payments (from agents) and for direct payments via hotel acquiring (if such is connected in Travel Line).

...

With “Add new’ button create External sales channel.


Image Added


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

Типы комнат

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

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

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

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

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

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

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

    Info

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

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

Image Removed

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

Warning

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

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

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

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

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

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

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

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

...

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

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

Info
  1. Не стоит указывать те коды услуг, которые включены в тариф, если в настройке тарифов вы использовали комбинацию тариф+пакет.
  2. Не все внешние каналы передают ID услуги. Необходимо добавить услугу с ID EXTRA_SERVICE для случая, когда ID добавочной услуги не передается каналом, предварительно настроив универсальную услугу в Logus.
ContractsReservation rooms contracts. Usually used for the whole pool of MAIN rooms

Room types

Room types for booking
External ratesRates, set up in your TL account
External servicesExternal services codes
Comment

External API descriptions, got from TL

FeedGeneral changes / operations
Info

Make sure kids categories in Logus and TL are similar – age must me the same to get into a correct category

Rate setting

  1. Go to "External rates" tab.
  2. Select a rate plan from list.
  3. If rate contains some services packages, link the required package (You can find below how to link several packages at the same time).
  4. Specify the external rate code (API code) from TL (rate codes can be viewed in your personal account or on the Comment tab)
  5. Click "Add new"
  6. Go to the "Contracts" tab
  7. In the "Rates for sale" pop-up menu activate required rates.


Info

Each rate can be added in a separated lines. One rate in LOGUS can be compared with different rates codes from TL. For example, if TL rates from personal account set up as lined and prices do not downloading from LOGUS.



In cases where more than one package must be linked with tariff,  you need to add separated line for each package. On tab “External rates” you need to specify the same external identification as you can see on screen.


Image Added


In case when reservation comes with external code 200035, tariff with "NON-REF" reservation and 2 packages will be created.


Warning

Attention! One of the reason why reservations with set up rates don’t displayed in Logus – rate is not available for reservation

  1. Go to the "Contracts" tab
  2. Activate the required rates in ""Rates for sale" pop-up menu.

Room type setting

  1. Go to "Room types" tab.
  2. Select the room type.
  3. Specify the external code / API (codes can be viewed in your TL account or on the Comment tab).

Services setting

  1. Go to "External services" tab.
  2. Select an additional service.
  3. Specify an "Variants".
  4. Specify the external code / API of the additional service from the TL (the codes can be viewed in your account or on the Comment tab)


Info
  1. When use “rate + package” combination in the rate settings, it is not necessary to indicate service codes already used in this rate.
  2. Not all external channels can share service ID, so in case when additional service ID is not transmitted by the channel, it is necessary to add a service with ID "EXTRA_SERVICE", previously configure the universal service in Logus.



  1. 1. 
  2. 2. Add sales channels as shown in first screenshot.
  3. 3. If the agent code is missing from the link below, then contact TL.



Contracts setting


Warning

Attention! Each Client with the "Agent" role must have a default commission set.

  1. Go to "Contracts" tab.
  2. Add sales channels as shown on screenshot below.
  3. Add TL code of external channel. If the agent code is missing from the link below, then contact TL.


Image Added



Info

Page with all codes of sales channels 

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

Warning

Внимание! У каждого Клиента с ролью "Агент" должна быть задана комиссия по умолчанию.

...

Info

Страница со всеми кодами каналов продаж - https://docs.travelline.ru/pages/viewpage.action?pageId=14549221

BGC booking.com
EXP expedia.com *
OTG oktogo.ru
OTK ostrovok.ru *
HIN hotel-inn.ru
VHT vashotel.ru
BRN bronevik.com *
AGD agoda.com
101 101hotels.ru
HRS HRS
HSW Hostelworld
ANA Zabroniryi.ru
HRU Hotels.ru
ALN Alean.ru
RSR RusRooms
DNT Delfin-tour.ru
OBZ Orbitz.com
 *
HRS HRS
HBS Hotelbeds.com *
HCO RoomGuru/Revato
HUS Hotusa.com
PTB PeterBooking
FRB FreeBooking
OZN OZON.travel
GTA Gta-travel.com
VHL VHOTEL
CBC Городской центр бронирования
INT Intourist.ru
RKT RussiaKurort
UTS HotelBook.pro *
SKR Skayra
SCH Новый Сочи
THS TopHotels
MGM Magelan-M
AST Assist
FER Feratel Deskline
CBG CBooking
ARB Airbnb
HSC HostelsClub
STL Stels-Travel
OTL Oteling.ru
JAC JacTravel
KZK Kuzuk.ru
GSH Gesh.ru
HZN HotelZon.comCTP Ctrip.com
RSV Reservation.ru
MHS MyHotelshop
ACS Acase.ru *
H24 Hotels24.ua
SVT Svoy Hotel
TVL Tvil.ru
KTL Keytel
RTL Restel
SNR Санатории РФ
GLD Золотые купола
RSH Роза Хутор

AVI Отели Онлайн (avia-centr.ru)

OTT OneTwoTrip

DNT Дельфин

LSP Ласпи

DTW некий DOTW

S7A S7 Airlines (travel retail)

AXT Axis.travel

AZN Azent

BEL BelAgroTravel

BKN Bakuun

DBV Dobovo.com

DNT Delfin-tour.ru

EVG Едем в гости 

HCO RoomGuru/Revato

KZK Kuzuk.ru

PEG Pegi Pegi

TVC Travco

*** ВАЖНО!!! Каналы, отмеченные звездочкой, могут работать с отелем по схеме FREE SALE и в таком случае будут игнорировать данные по наличию комнат выгружаемые из Логус в ТЛ.

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


* IMPORTANT!!! Channels/website with asterisks can work with hotel on a FREE SALE conditions, in this case LOGUS data with room availability can be ignored


Rate updates and rooms availability:

When “Refresh rates” button is selected, prices from Logus to TL is unloadedПри нажатии на кнопку "Обновить тарифы" происходит выгрузка цен из Логуса в Тревел Лайн.


Note
titleВажноImportant

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

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

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

Info

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

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

Обработка гарантии начиная с версии протокола 1.0:

...

Есть предоплата. Детали предоплаты указываются в комментарии к брони.

В случае с предоплатой на сайте отеля депозит отразится в счете брони. В качестве гарантии будет выбрана первая по списку гарантия с типом "Безналичная оплата".

...

Если гарантия с требуемым видом не найдена, в этом поле будет использовано пустое значение.

Attantion! Please consult with your Travel Line manager before this action.

If you see error log “Price integration is disabled”, when unloading prices, it means Travelline doesn’t include price sync for tariffs.


Force availability update


Info

To force the update of room availability, click the “Update Availability” button

Image Added

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

...

Code Block
languagexml
titleФайл logus.local.config
<DepositRules>
    <Rule Name="Оплата при заезде" GuaranteeCode="Cash" LogusGuarantee="Cash" />
    <Rule Name="Без гарантии" GuaranteeCode="None" LogusGuarantee="Cash" />
    <Rule Name="Выставлен счёт на юрлицо (автоматически)" GuaranteeCode="PrePay" PaymentSystemName="CASHLESS" PaymentSystemProfileAcquiringName="Hotel" DepositPayments="ExpectedPayment" />
    <Rule Name="Выставлен счёт на юрлицо (отелем)" GuaranteeCode="PrePay" PaymentSystemName="MANUAL_CASHLESS" PaymentSystemProfileAcquiringName="Hotel" DepositPayments="ExpectedPayment" />
    <Rule Name="Бронь оплачена каналу бронирования" GuaranteeCode="PrePay" PaymentSystemName="CM_CASHLESS" Payee="Channel" LogusGuarantee="DirectBill" />
    <Rule Name="Выставлен счёт физлицу (автоматически)" GuaranteeCode="PrePay" PaymentSystemName="INDIVIDUAL_CASHLESS" PaymentSystemProfileAcquiringName="Hotel" DepositPayments="ExpectedPayment" />
    <Rule Name="Выставлен счёт физлицу (отелем)" GuaranteeCode="PrePay" PaymentSystemName="MANUAL_INDIVIDUAL_CASHLESS" PaymentSystemProfileAcquiringName="Hotel" DepositPayments="ExpectedPayment" />
    <Rule Name="Оплата на сайте отеля (депозит ожидается) - эквайринг ТЛ" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="TravelLine" Payee="TL" DepositPayments="ExpectedPayment" />
    <Rule Name="Оплата на сайте отеля (депозит получен) - эквайринг ТЛ" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="TravelLine" Payee="TL" DepositPayments="ReceivedPayment" LogusGuarantee="DirectBill" />
    <Rule Name="Оплата на сайте отеля (депозит ожидается) - эквайринг отеля" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="Hotel" DepositPayments="ExpectedPayment" />
    <Rule Name="Оплата на сайте отеля (депозит получен) - эквайринг отеля" GuaranteeCode="PrePay" PaymentSystemProfileAcquiringName="Hotel" Payee="Guest" DepositPayments="ReceivedPayment" LogusGuarantee="CreditCard" />
    <Rule Name="Гарантия кредитной картой - карта гостя" GuaranteeCode="CcDcVoucher" PaymentSystemName="CM_CREDITCARD_GUARANTEE" LogusGuarantee="CreditCard" />
    <Rule Name="Гарантия кредитной картой - виртуальная карта канала OTA" GuaranteeCode="CcDcVoucher" PaymentSystemName="CM_PREPAY_CREDITCARD_GUARANTEE" Payee="Channel" LogusGuarantee="CreditCard" />
    <Rule Name="Гарантия кредитной картой - карта гостя через сайт отеля" GuaranteeCode="CcDcVoucher" LogusGuarantee="CreditCard" />
</DepositRules>

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

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

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

  1. Позволяет бронировать гостей в один номер по разным тарифам
  2. Изменён способ подсчёта цен на детей на основных местах. 

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

Чтобы активировать "санаторный" режим выгрузки в Логусе, необходимо в настройках модуля установить признак (он включен по-умолчанию)

Code Block
<SanatoriumRates>True</SanatoriumRates>

Для активации режима со стороны ТЛ нужно обратиться к менеджеру.

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

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

...