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

Поддержана оплата одним видом оплаты на заказ: как на депозит, так и за наличные или по карте.

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

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

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

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

Готово.

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

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

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

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

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

Настройка связи с 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-сервер кассового сервера 


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

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

  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 установить значение Yes Always (fail if impossible), то при закрытии на любую валюту заказ будет передаваться в гостиничную систему. Для этого должны быть сделаны соответствующие настройки в гостиничном интерфейсе.


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

    Убедитесь, что только один интерфейс ссылается на экземпляр PDS Interface #... кассового сервера. Если таких ссылок несколько, то записи в гостиничной системе будут дублироваться.

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

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


    2. В fcTravelLine.ini в секции [ManagerStation] добавьте параметр ZeroDiscountCode со значением, равным коду скидки.

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

Настройки 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.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 — оплата с депозита комнаты гостя

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

[TaxCodes]

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

  • None — без налога
  • Vat0 — налог 0%
  • Vat10 — налог 10%
  • Vat110 — налог 10/110
  • Vat120 — налог 20/120
  • Vat20 — налог 20%

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

В секции [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

[TaxCodes]

None=
Vat0=3
Vat10=2
Vat110=
Vat120=
Vat20=6

[Rk7]

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

[Proxy]

UseProxy=0
ProxyIp=127.0.0.1
ProxyPort=8888
CODE

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

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

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

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

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

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