Настройка связи с гостиничной системой Logus HMS (новая интеграция)

Для связи с гостиничной системой Logus HMS используется только программа Libra.dll.
Сервер, к которому подключается FarCards, предоставляют специалисты компании Logus HMS.

Модуль не поддерживает интеграцию с Fidelio

Версия станции и кассового сервера 7.25.02.0
Версия FarCards 6.04

Настройки r_keeper

Перейдите в меню Сервис > Cтанции и устройства. Выберите нужный ресторан, перейдите в кассовый сервер. В поле Устройства вызовите контекстное меню, нажмите Список драйверов и добавьте ещё одно устройство PDS interface #....
В свойства интерфейса укажите следующие параметры:
- PDS Server Name = Logus HMS – имя сервера FarCard, через который будет обеспечиваться связь с гостиничной системой.
- Look Up Card By Mail Addr = Yes, try as card code on not found (не поддерживается в данной интеграции)
- Look Up Card By Mail Addr = On special pays, if possible (при данной настройке в гостиничную систему передаются только чеки, в которых выбран постоялец)
- Look Up Card By Mail Addr = On special pays, always (fail if impossible) (при данной настройке в гостиничную систему передаются только чеки, в которых выбран постоялец, в случае ошибок, система блокирует закрытие заказа)
- Mail Addr Type Kind = 1
Зайдите в меню Сервис > Интерфейсы. В предустановленном интерфейсе Logus HMS укажите ранее заведенный PDS interface.

Убедитесь, что только один интерфейс ссылается на экземпляр PDS Interface #... кассового сервера. Если таких ссылок несколько, то записи в гостиничной системе будут дублироваться.
Добавьте MCR алгоритм. В свойствах в блоке Основное укажите тип Интерфейс. В поле Объект укажите интерфейс Logus HMS
Заполнение файла appsettings.json:
```
{

  "Libra": {
    "Url": "http://",
    "Login": "",
    "Password": "",

    "InfoFields": [ "PropertyName", "ArrivalDate", "DepartureDate", "Limit", "Tags" ]
  },


  "SendFiscalData":  true, 
  "DefDiscountCode": 10


}
```
CODE
Заполните URL, логин и пароль для входа Logus HMS.
SendFiscalData - отправлять ли марки (ЧЗ) в Logus HMS.

Если при закрытии чека на номер в r_keeper печатается фискальный чек с признаком «передача в кредит» — необходимо отключить передачу маркировки "SendFiscalData": false, иначе будет ошибка на стороне Logus HMS.

DefDiscountCode - код нулевой скидки r_k ( заранее создайте скидку, с нулевой детализацией).
Создайте валюту с настройками:

Валюту для закрытия заказа в Logus HMS нужно создавать в Типе валют - Платежные карты

- Выставьте флаг в поле Без сдачи
- В блоке Интерфейс в поле Способ ввода доп.инфо выберите Карта или клавиатура
- В блоке Интерфейс в разделе Интерфейс выберите интерфейс, описанный ранее
- В поле Автозаполнение выставьте Вся сумма + подтверждение или Вся сумма
- Не учитывать в потратах ПДС – снимите флаг

6. Для определения классификации, по которой будут выгружаться блюда в гостиничную систему, зайдите в Настройки > Параметры > Установочные > Связь с другими системами > KDS и VDU и выберите параметр Классификация для КДС и VDU, укажите в свойствах ссылку на необходимую классификацию.

Для возможности продавать маркированную продукцию с закрытием на номер, сделайте дополнительные настройки на валюте в соответствии со статьёй Продажа в кредит.

Настройки FarCards.

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

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

[LinkDLL]
1 = pds_netk

[pds_netk]
NetServerName=Libra
ininame=netk.ini
DebugMessages=1

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

Рассмотрим на примере быстрого чека:

Создайте заказ и нажмите Расчет заказа
Зайдите в группу Платежные карты и выберите необходимую валюту. В нашем примере Logus HMS
Введите данные для поиска: номер комнаты, фолио, фамилию гостя
Выберите тип введенных данных
Выберите гостя
Нажмите кнопку Оплата картой, и стол закроется. Данные передадутся в гостиничную систему.
На фолио данного гостя формируется транзакция о начисленной услуге.