Интеграция с TravelLine
Начиная с версии r_keeper 7.7.0.242 реализована интеграция с гостиничными системами TravelLine.
Поддержана оплата одним видом оплаты на заказ: как на депозит, так и за наличные или по карте.
Лицензирование
Для работы интеграции с TravelLine нужна лицензия R-Keeper модуль Интеграция «Гостиничные системы TravelLine» 12 мес. — код 3510 или 3511.
Лицензию необходимо активировать:
- В системе лицензирования перейдите в меню Справочники > Объекты
- Найдите свой объект и перейдите в его карточку
- Нажмите кнопку Новая лицензия
- В всплывающем окне Генерация лицензии убедитесь, что в поле Тип лицензии указано Генерировать лицензию и нажмите кнопку Далее.
- В следующем окне:
- В поле Программа выберите R-Keeper модуль Интеграция «Гостиничные системы TravelLine» 12 мес ПО
- Нажмите кнопку MaxDate
- Выберите необходимое количество лицензий. Для интеграции необходима одна лицензия.
- Нажмите Далее.
- В открывшемся окне нажмите ОК, чтобы сгенерировать лицензию.
- Проверьте, что лицензия сгенерирована. В карточке объекта перейдите во вкладку Лицензии. Под списком доступных мастер-лицензий перейдите во вкладку Активные лицензии. Лицензия должна быть в списке активных.
Готово.
Настройка связи с r_keeper
Для настройки связи модуля TravelLine с r_keeper 7 в файле конфигурации fcTravelLine.ini укажите параметры подключения.
Пример:
[Rk7]
Rk7Ip=127.0.0.1
Rk7Port=7333
Rk7User=http
Rk7Password=1
Описание параметров:
Имя параметра | Описание |
---|---|
Rk7Ip | IP-адрес компьютера, где работает кассовый сервер |
Rk7User | Имя пользователя для авторизации |
Rk7Password | Пароль пользователя для авторизации |
Rk7Port | Порт, на котором запущен HTTP-сервер кассового сервера |
Требования к программному обеспечению
Для связи с гостиничной системой Travelline используется библиотека fcTravelLine.dll.
Требуемая версия FarCards — 6.04.
На текущий момент поддержана оплата одним видом оплаты на заказ: как на депозит, так и за наличные/по карте.
Для работы требуется конфигурационный файл fcTravelLine.ini и библиотеки ssl: ssleay32.dll, libeay32.dll.
Настройка интеграции
Для настройки связи выполните настройки в менеджерской станции:
- Перейдите в меню Сервис > Cтанции и устройства.
- Выберите нужный ресторан, перейдите в кассовый сервер.
- В поле Устройства вызовите контекстное меню, нажмите Список драйверов и добавьте PDS interface.
- В свойства интерфейса укажите следующие параметры:
- PDS Server Name = rkfcsh — имя сервера FarCard, через который будет обеспечиваться связь с гостиничной системой
- LookupCardByMailAddr = YES
- Mail Addr Type Kind = 2
Если параметр для Pass All Receipts XML data установить значение Yes Always (fail if impossible), то при закрытии на любую валюту заказ будет передаваться в гостиничную систему. Для этого должны быть сделаны соответствующие настройки в гостиничном интерфейсе.
При настройке необходимо убедиться, что на вкладке Интерфейсы только один объект ссылается на экземпляр PDS Interface #... кассового сервера. Если таких ссылок несколько, то записи в гостиничной системе будут дублироваться.
- Зайдите в меню Сервис > Интерфейсы. Добавьте новый интерфейс, например, INTF Travelline FC. В интерфейсе укажите ранее заведенный PDS interface.
- Добавьте MCR алгоритм. В свойствах в блоке Основное укажите тип Интерфейс. В поле Объект укажите интерфейс INTF Travelline FC, созданный для интеграции.
- Создайте новое право. Право должно быть назначено работнику, который работает на кассе.
- Создайте 2 валюты:
- Закрытие на номер
- Закрытие на фолио — для гостей без поселения. Если закрытие на фолио не предусмотрено, то можно ограничиться одной валютой.
Настройки для валют:- В блоке Ограничения выставьте право доступа Право TravelLine.
- Выставьте флаг в поле Без сдачи.
- В блоке Интерфейс выставьте флаг в поле Доп.инфо с клавиатуры.
- В поле Автозаполнение выставьте Вся сумма + подтверждение.
- Формат доп. инфо – в валюте Закрытие на номер: символ R и решетки по числу символов в номере — R######. В валюте Закрытие на фолио: символ F и решетки — F#########. Символы R и F являются ключевыми для определения типа идентификатора — комната или фолио.
- Не учитывать в потратах ПДС – снимите флаг.
- Закрытие на номер
- Укажите коды налоговых групп:
- НДС 20% — Код 6
- НДС 10% — Код 2
- НДС 0% — Код 3.
- Для того, чтобы при оплате наличными или картой (не с депозита TraveLine) передавались данные о постояльце:
- В менеджерской r_keeper создайте нулевую скидку на заказ
- В 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
Настройки netk.ini
[netkern]
TESTMESSAGES=0
protocols=tcpsoc.dll
[TCPSOC]
port=2234
Настройка 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
Алгоритм работы
Ниже рассмотрен алгоритм работы на примере быстрого чека.
- Создайте заказ и нажмите кнопку Расчет заказа.
- Зайдите в группу Платежные карты и выберите тип оплаты Закрытие на номер.
- Введите номер комнаты. Например, 90. Буква R уже предопределена настройками.
- На экране отображается список гостей, проживающих в этом номере.
- Выберите одного гостя, и на экране отобразится информация о его поселении.
- Нажмите кнопку Оплата картой, и стол закроется. Данные передадутся в гостиничную систему.
- На фолио данного гостя формируется транзакция о начисленной услуге.
Если заказ был закрыт ошибочно и его нужно удалить:
- Зайдите в список закрытых чеков
- Выберите нужный чек
- Выполните Удаление или Аннуляцию чека.
Эти действия приводят к коррекции услуги на фолио.