Начиная с версии r_keeper 7.7.0.242 реализована интеграция с гостиничными системами TravelLine.

При интеграции поддержаны оплата на депозит и в кредит при закрытии заказа на номер в TravelLine.

ЛицензированиеLink to Лицензирование

Для работы интеграции с TravelLine нужна лицензия R-Keeper модуль Интеграция «Гостиничные системы TravelLine» 12 мес. — код 3510 или 3511.

Лицензию необходимо активировать:

  1. В системе лицензирования перейдите в меню Справочники > Объекты
  2. Найдите свой объект и перейдите в его карточку
  3. Нажмите кнопку Новая лицензия
  4. В всплывающем окне Генерация лицензии убедитесь, что в поле Тип лицензии указано Генерировать лицензию и нажмите кнопку Далее.
  5. В следующем окне:
    • В поле Программа выберите R-Keeper модуль Интеграция «Гостиничные системы TravelLine» 12 мес ПО
    • Нажмите кнопку MaxDate
    • Выберите необходимое количество лицензий. Для интеграции необходима одна лицензия.
    • Нажмите Далее.
  6. В открывшемся окне нажмите ОК, чтобы сгенерировать лицензию.
  7. Проверьте, что лицензия сгенерирована. В карточке объекта перейдите во вкладку Лицензии. Под списком доступных мастер-лицензий перейдите во вкладку Активные лицензии. Лицензия должна быть в списке активных.

Готово.

Требования к программному обеспечениюLink to Требования к программному обеспечению

Для связи с гостиничной системой Travelline используется библиотека fcTravelLine.dll.

Требуемая версия FarCards — 6.04.

На текущий момент поддержана оплата одним видом оплаты на заказ: как на депозит, так и за наличные/по карте.

Для работы требуется конфигурационный файл fcTravelLine.ini и библиотеки ssl: ssleay32.dll, libeay32.dll.

Настройка связи с r_keeperLink to Настройка связи с r_keeper

Для настройки связи модуля TravelLine с r_keeper 7 в файле конфигурации fcTravelLine.ini укажите параметры подключения.

Пример:

[Rk7]
Rk7Ip=127.0.0.1
Rk7Port=7333
Rk7User=http
Rk7Password=1
CODE

Описание параметров:

Имя параметра

Описание

Rk7IpIP-адрес компьютера, где работает кассовый сервер
Rk7UserИмя пользователя для авторизации 
Rk7PasswordПароль пользователя для авторизации
Rk7PortПорт, на котором запущен HTTP-сервер кассового сервера 


Настройка интеграцииLink to Настройка интеграции

Для настройки связи выполните настройки в менеджерской станции:

  1. Перейдите в меню Сервис > Cтанции и устройства. Выберите нужный ресторан, перейдите в кассовый сервер. В поле Устройства вызовите контекстное меню, нажмите Список драйверов и добавьте ещё одно устройство PDS interface #....
    В свойства интерфейса укажите следующие параметры:
    • PDS Server Name — имя сервера FarCard, через который будет обеспечиваться связь с гостиничной системой
    • Maximal Discount Value = 0 = No limits
    • Look Up Card By Mail Addr = Yes, try as card code on not found

    • Mail Addr Type Kind = 1

    • Pass All Receipts XML data установите одно из значений:

      • By script  —  отправлять только те чеки, которые удовлетворяют условию описанному в скрипте (скрипт "Условие отправки заказа" из справочника "Скрипты").
      • On special pays, if possible — отправлять только те чеки, в которых есть скидка/оплата валютой данного интерфейса. Игнорировать ошибки при передаче данных чека во внешнюю систему.
      • On special pays, always (fail if impossible) — отправлять только те чеки, в которых есть скидка/оплата валютой данного интерфейса. Выдавать ошибку, если не удалось отправить данные чеков во внешнюю систему.
      • Yes, if possible — отправлять все чеки. Игнорировать ошибки при передаче данных чека во внешнюю систему.

      • Yes, always (fail if impossible) — отправлять все чеки. Выдавать ошибку, если не удалось отправить данные чеков во внешнюю систему.

        Если параметр для Pass All Receipts XML data установить значение Yes, Always (fail if impossible), то в гостиничную систему будут передаваться все чеки (в том числе оплаченные без выбора гостя). 

        Если установить значение On special pays, always (fail if impossible) — будут отправляться только чеки по заказам, в которых был выбран гость. В этом случае гостиничная система не узнает о заказах, в которых гость выбран не был.


  2. Зайдите в меню Сервис > Интерфейсы. В предустановленном интерфейсе TravelLine укажите ранее заведенный PDS interface. И формат максимального платежа — %0:s: %1:s

    Убедитесь, что только один интерфейс ссылается на экземпляр PDS Interface #... кассового сервера. Если таких ссылок несколько, то записи в гостиничной системе будут дублироваться.
  3. Добавьте MCR алгоритм. В свойствах в блоке Основное укажите тип Интерфейс. В поле Объект укажите интерфейс TravelLine.
  4. Создайте валюту с настройками:
    1. Валюту для поиска постояльца в системе TravelLine: 
      • Выставьте флаг в поле Без сдачи
      • В блоке Интерфейс в поле Способ ввода доп.инфо выберите Карта или клавиатура
      • В блоке Интерфейс в разделе Интерфейс выберите интерфейс, описанный ранее
      • В поле Автозаполнение выставьте Вся сумма + подтверждение или Вся сумма
      • Не учитывать в потратах ПДС – снимите флаг
      • Формат доп. инфо –  символ 'R' и символы 'c' по максимальному числу символов в номере — Rcccccccccccccccc, либо использовать специальные символы из списка ниже для кодирования в маске произвольного формата номера комнаты (цифры, буквы и проч.)
        Значение поля Формат доп. инфо является маской ввода номера комнаты и формируется на основе следующих правил:

    2. Валюту для оплаты заказа. Валюты создаются и настраиваются стандартным способом. Для оплаты на депозит и в кредит при закрытии заказа на номер в TravelLine должны быть созданы две разные валюты.
  5. Для того, чтобы при оплате наличными или картой (не с депозита TraveLine) передавались данные о постояльце:
    1. В менеджерской r_keeper создайте нулевую скидку на заказ


    2. В fcTravelLine.ini в секции [ManagerStation] добавьте параметр ZeroDiscountCode со значением, равным коду скидки.
  6. Проверьте, чтобы у работников, работающих на кассовой станции, не стояло право Возврат товара.

Готово, настройки в r_keeper завершены.

Настройки FarCards.Link to Настройки FarCards.

FarCards устанавливается на любом компьютере в одной сети с кассой и кассовым сервером. Более подробную инструкцию по установке FarCards можно найти в статье о ПДС.

Настройте FARCARDS.INI следующим образом:

[FarServer]
Type = 1
DLL = fcTravelLine.dll
Gate = 2
XMLCP=1251

[LinkDLL]
1 = pds_netk

[pds_netk]
NetServerName=TravelLine
ininame=netk.ini
DebugMessages=1
CODE

Настройка fcTravelLine.dllLink to Настройка fcTravelLine.dll

FarCards обращается к fcTravelLine.dll, которая должна находиться в папке с FarCards.

Настройки осуществляются в файле fcTravelLine.ini.

В секции [TravelLineAPI] задаются параметры для API Travel Line:

В секциях [ManagerStation], [CurrencyCodes], [TaxCodes], [Rk7] указаны параметры, которые настраиваются в менеджерской r_keeper.

[ManagerStation]

  • PrintDocumentCode — указывается 101
  • OnlyInterfaceCode — указывается код интерфейса, указанный в поле Код в окне свойств интерфейса TravelLine.
  • ZeroDiscountCode — указывается код нулевой скидки, указанный в поле Код в свойствах скидки.

[CurrencyCodes]

В каждом поле:

  • Cash — оплата наличными
  • Card — оплата картой или другими FarCards системами или другими способами оплаты
  • Deposit — оплата с депозита комнаты гостя
  • Credit — оплата в кредит на комнату гостя.

Указывается код соответствующей валюты. Код валюты необходимо посмотреть в поле Код окна свойств валюты. Можно указать несколько кодов валют через запятую для каждого типа оплаты.

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

В раздел Deposit можно внести и код валюты для поиска гостя, и код отдельной валюты.

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

В секции [Rk7] параметры для подключения к кассовому серверу для проверки лицензии на TravelLine:

  • Rk7Ip — IP-адрес сервера r_keeper 7
  • Rk7Port — порт подключения
  • Rk7User — имя HTTP-пользователя
  • Rk7Password — пароль от этого пользователя.

В секции [Proxy] задаются параметры прокси сервера (если используется):

  • UseProxy — 0/1 (использовать прокси: нет/да)
  • ProxyIp — IP-адрес прокси-сервера
  • ProxyPort — порт подключения.

Пример:

[TravelLineAPI]

X_API_KEY=aa22aa22-1111-4c4c-aa22-1234abcd1a1a

URL=https://partner.tlintegration-as.com/api/webpms

; URL=https://partner.tlintegration.com/api/webpms/v1/ для клиентов НЕ в евросоюзе

; URL=https://partner.tlintegration-as.com/api/webpms/v1/  для клиентов в евросоюзе
 ServiceProviderId=AA11AA11-CBCB-4242-1A1A-1234ABCD1234

Currency3LetterCode=RUB

[ManagerStation]

PrintDocumentCode=101
OnlyInterfaceCode=9

ZeroDiscountCode=4

[CurrencyCodes]

Cash=1
Card=
Deposit=98,99
Credit=149

[Rk7]

Rk7Ip=127.0.0.1
Rk7Port=7333
Rk7User=http
Rk7Password=1

[Proxy]

UseProxy=0
ProxyIp=127.0.0.1
ProxyPort=8888
CODE

Алгоритм работыLink to Алгоритм работы

Ниже рассмотрен алгоритм работы на примере быстрого чека.

  1. Создайте заказ и нажмите кнопку Расчет заказа.
  2. Зайдите в группу Платежные карты и выберите тип оплаты Закрытие на номер. Валюта этого типа используется для поиска гостя в системе TravelLine.
  3. Введите номер комнаты. Например, 90. Буква R уже предопределена настройками.
  4. На экране отображается список гостей, проживающих в этом номере. И суммы их депозитов.
  5. Выберите одного гостя, и на экране отобразится информация о его поселении.
  6. Если на счете гостя есть депозит, он применится и заказ закроется, в случае нехватки средств на депозите остальную часть заказа можно оплатить другим способом оплаты, в том числе закрыть на кредит. Если на счете гостя нет депозита, после определения гостя, выберите валюту, на которую хотите закрыть заказ, и стол закроется. Данные передадутся в гостиничную систему.
  7. На фолио данного гостя формируется транзакция о начисленной услуге.

Если заказ был закрыт ошибочно и его нужно удалить:

  1. Зайдите в список закрытых чеков
  2. Выберите нужный чек
  3. Выполните Удаление или Аннуляцию чека.

Эти действия приводят к коррекции услуги на фолио. 

FAQLink to FAQ

Проблема
Решение
При настройке интеграции с travelLine, при запуске фаркардса - не видит лицензию ( лицензия активна) 
  1. Перелицензировать ref с удалением лицензии с виртуального ключа и генерацией нового виртуального ключа.
  2. При использовании физического ключа, необходимо перейти на виртуальный ключ.