Начиная с версии 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. Проверьте, что лицензия сгенерирована. В карточке объекта перейдите во вкладку Лицензии. Под списком доступных мастер-лицензий перейдите во вкладку Активные лицензии. Лицензия должна быть в списке активных.

Готово.

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

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

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

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

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

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

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

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

  1. Перейдите в меню Сервис > Cтанции и устройства.
  2. Выберите нужный ресторан, перейдите в кассовый сервер.
  3. В поле Устройства вызовите контекстное меню, нажмите Список драйверов и добавьте PDS interface.
  4. В свойства интерфейса укажите следующие параметры:
    • PDS Server Name = rkfcsh — имя сервера FarCard, через который будет обеспечиваться связь с гостиничной системой
    • LookupCardByMailAddr = YES
    • Mail Addr Type Kind = 2
      Если параметр для Pass All Receipts XML data установить значение Yes Always (fail if impossible), то при закрытии на любую валюту заказ будет передаваться в гостиничную систему. Для этого должны быть сделаны соответствующие настройки в гостиничном интерфейсе.
      При настройке необходимо убедиться, что на вкладке Интерфейсы только один объект ссылается на экземпляр PDS Interface #... кассового сервера. Если таких ссылок несколько, то записи в гостиничной системе будут дублироваться.
  5. Зайдите в меню Сервис > Интерфейсы. Добавьте новый интерфейс, например, INTF Travelline FC. В интерфейсе укажите ранее заведенный PDS interface.
  6. Добавьте MCR алгоритм. В свойствах в блоке Основное укажите тип Интерфейс. В поле Объект укажите интерфейс INTF Travelline FC, созданный для интеграции.
  7. Создайте новое право. Право должно быть назначено работнику, который работает на кассе.
  8. Создайте 2 валюты:
    • Закрытие на номер
    • Закрытие на фолио — для гостей без поселения. Если закрытие на фолио не предусмотрено, то можно ограничиться одной валютой.
      Настройки для валют:
      • В блоке Ограничения выставьте право доступа Право TravelLine.
      • Выставьте флаг в поле Без сдачи.
      • В блоке Интерфейс выставьте флаг в поле Доп.инфо с клавиатуры.
      • В поле Автозаполнение выставьте Вся сумма + подтверждение.
      • Формат доп. инфо – в валюте Закрытие на номер: символ R и решетки по числу символов в номере — R######. В валюте Закрытие на фолио: символ F и решетки — F#########. Символы R и F являются ключевыми для определения типа идентификатора — комната или фолио.
      • Не учитывать в потратах ПДС – снимите флаг.
  9.  Укажите коды налоговых групп:
    1. НДС 20% — Код 6
    2. НДС 10% — Код 2
    3. НДС 0% — Код 3.
  10. Для того, чтобы при оплате наличными или картой (не с депозита TraveLine) передавались данные о постояльце:
    1. В менеджерской r_keeper создайте нулевую скидку на заказ
    2. В fcTravelLine.ini в секции [ManagerStation] добавьте параметр ZeroDiscountCode со значением, равным коду скидки.

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

Настройки FarCards.

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

Настройки FARCARDS.INI

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

[LinkDLL]
1 = pds_netk

[pds_netk]
NetServerName=rkfcsh
ininame=netk.ini
CODE

Настройки netk.ini

[netkern]
TESTMESSAGES=0
protocols=tcpsoc.dll

[TCPSOC]
port=2234
CODE

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

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

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

Секция [TravelLineAPI]
Настройки для API TravelLine.

  • X_API_KEY — для идентификации и авторизации клиента, предоставляется сотрудниками TravelLine
  • ServiceProviderId — идентификатор ресторана
  • Currency3LetterCode — 3-х буквенный код валюты, передаётся в API TravelLine вместе с суммой оплаты.

Секция [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]
Параметры для подключения к RK7 для проверки лицензии на TravelLine:

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

Секция [Proxy]
Использование прокси-сервера при подключения к r_ keeper 7 для проверки лицензии на TravelLine^

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

Ниже приведен пример настроек конфигурационного файла. В секции [TravelLineAPI] задаются параметры для подключения к системе Travel Line. В секциях [ManagerStation], [CurrencyCodes], [TaxCodes], [Rk7] указаны параметры, которые настраиваются в менеджерской RK7. В секции [Rk7] параметры для подключения к кассовому серверу для проверки лицензии. В секции [Proxy] параметры прокси сервера, если они используется. В файле fcTravelLine.log пишется лог библиотеки.

[TravelLineAPI]
X_API_KEY=X_API_KEY=fa1e32bf-5afd-46a7-8f51-d37fb5c3f25a
ServiceProviderId=BB0B9E72-11BD-4D7E-87CC-88CA38D150CE

[ManagerStation]
PrintDocumentCode=101
OnlyInterfaceCode=9

[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. Выполните Удаление или Аннуляцию чека.

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