Назад

Инструкция по установке FarCards

2023-02-28

Установка FarCards на Ваш R_keeper

Интеграция системы кассового учета R_Keeper и системы Teyca осуществляется посредством распространяемого программного модуля FarCards, устанавливаемого в ресторане.
Интеграционный модуль предназначен для работы с единственным кассовым сервером R_Keeper.

Процесс установки

Установка модуля интеграции осуществляется путем распаковки распространяемого пакета на компьютер в локальной сети ресторана. После распаковки потребуется выполнить ряд дополнительных действий над конфигурационными файлами интеграционного модуля, а также в ПО Менеджерская станция R_Keeper. Все необходимые действия описаны в этой статье.

I. Настройка подключения R_Keeper к FarCards

1.1. Настройка физического интерфейса
  1. Перейдите в справочник “Сервис -> Станции и устройства”.
  2. В древовидном списке найдите кассовый сервер, для которого выполняется установка и перейдите на вкладку “Устройства”. Кликните правой кнопкой мыши на свободном участке окна и в контекстном меню выберите пункт “Список драйверов”.
  3. В списке интерфейсов в открывшемся окне найдите “PDS Interface” и добавьте его в список устройств кассового сервера.
  4. После добавления физического интерфейса выберите его в списке и укажите следующие параметры:
    PDS Server Name
    : TEYCA
    Look Up Card By Mail Addr
    : Yes, error on not found
  5. Остальные параметры оставьте со значениями по-умолчанию.
1.2. Настройка логического интерфейса
  1. Перейдите в справочник “Сервис -> Интерфейсы”.
  2. В открывшемся окне создайте новый интерфейс “TEYCA”. В группе параметров интерфейса “Файлы библиотек (DLL)” в параметре Общее имя DLL укажите pdsempty.dll, затем найдите название ресторана, для которого осуществляете настройку и в списке его кассовых серверов укажите только что добавленный физический интерфейс PDS Interface #N.
1.3. Перезапуск кассового сервера
  1. На этом этапе Вам необходимо перезапустить кассовый сервер, чтобы вновь добавленные физический и логический интерфейсы корректно проинициализировались и были готовы к обработке карт.

II. Настройка справочников R_Keeper

2.1. Настройка MCR алгоритма
  1. Перейдите в справочник “Сервис -> Обработка сигналов устройств -> MCR алгоритмы”
  2. В открывшемся окне создайте новый MCR алгоритм “TEYCA” и укажите следующие настройки:
    Тип алгоритма: Скрипт вер. 7.0
    Типы устройств:
    [Клавиатура, Магнитная карта, Штрих код]
    Область:
    Интерфейс
    Объект:
    TEYCA (логический интерфейс)
    Затем дважды кликните в поле ввода напротив параметра “Скрипт”
  3. В открывшееся окно вставьте следующий скрипт:
    Result := ((Length(Parameter) >= 6) and (Length(Parameter) <= 8 )) or (Length(Parameter) >= 11);

Описанный MCR алгоритм подходит для обработки штрих-кодов TEYCA и номеров телефонов длиной от 11 символов. Логика MCR алгоритма может быть усложнена для каждого конкретного случая установки, если описанный выше скрипт допускает коллизии с другими MCR алгоритмами, работающими в ресторане.

2.2. Настройка скидки

Этот пункт необходимо выполнить вне зависимости от того, используется ли механика скидок в системе лояльности ресторана. Настройка скидки в первую очередь техническое требование. Без нее авторизация карты в заказе будет невозможна.

  1. Перейдите в справочник “Деньги -> Скидки и Наценки”.
  2. Создайте новый тип скидок, или используйте существующий.
  3. В выбранном типе скидок создайте скидку “Карта TEYCA”, временно деактивируйте ее и укажите следующие настройки:
    Основное:
    Тип:
    Процент
    Нулевая действует:
    Да
    Ограничения:
    Не вручную:
    Да
    На заказ:
    Да
    Остальные параметры оставьте по-умолчанию.
  4. В древовидном списке слева раскройте тип скидок и выберете только что созданную скидку. Перейдите на вкладку “Детализации” и создайте новую детализацию.
  5. В поле “Процент” укажите значение 100.00, остальные параметры оставьте по-умолчанию.
  6. Переключитесь обратно на вкладку “Свойства” выбранной скидки и активируйте ее.
  7. Запомните значение из поля “Код”. Оно понадобится в дальнейшем для настройки модуля FarCards.
2.3. Настройка бонусной валюты
  1. Перейдите в справочник “Деньги -> Валюты”.
  2. В группе валют “Платежные карты” создайте новую валюту “Бонусы TEYCA” и укажите следующие параметры:
    Печать:
    *Тип фискальности:
    Фискальная скидка
    Интерфейс:
    Автозаполнение:
    Вся сумма + подтверждение
    Способ ввода доп.инфо:
    Карта
    Интерфейс:
    TEYCA (Логический интерфейс, созданный ранее)

*Поле “Тип фискальности” определяет как именно оплата данной валютой будет проведена на фискальном чеке при закрытии заказа с ее использованием. В инструкции указан типовой пример настройки. Значение в этом поле может быть изменено на другое в зависимости от прочих настроек фискализации в каждом конкретном случае.
Неправильная настройка может привести к некорректной фискализации выручки рестораном и избыточным налоговым взысканиям в дальнейшем.
Вся ответственность за неправильную настройку фискализации оплат ложится на исполнителя данного пункта настройки.

Поле “Тип фискальности” доступно только для дилерской учетной записи UCS. Рекомендуется оставить этот пункт настройки квалифицированному специалисту R_Keeper, имеющему собственную дилерскую учетную запись.

III. Добавление окна выдачи карты на кассе

Данный пункт настройки возможно сделать только через дилерскую учетную запись UCS.

  1. Перейдите в меню “Настройки -> Параметры”.
  2. В древовидном меню слева пройдите по следующему пути:
    Установочные -> Связь с другими системами -> Сервисы
    Из списка Сервис 1..4 выберите не занятый и раскройте его
    В значение параметра “Имя web-сервиса” укажите “Выдача карты TEYCA”
  3. В значение параметра “URL web-сервиса” укажите следующую строку:
    https://rkeeper.teyca.ru/createcard/*APIKey*
    Где *APIKey* замените на ключ авторизации API, доступный в настройках интеграции в личном кабинете TEYCA.

После сохранения изменений в главном меню кассовой станции R_Keeper в группе “Сервисы” появится кнопка “Выдача карты TEYCA”, при нажатии на которую откроется анкета для ввода данных о госте.

IV. Создание пречека с суммой оплаты с учетом списания баллов

- Перейдите в справочник “Настройки -> Печать -> Документы и макеты”
- В древовидном списке слева пройдите по пути “Расчет с покупателем -> Пречек”
- Выберите предустановленный макет пречека и скопируйте его
- В свойствах макета пречека найдите поле “Макет” и откройте редактор двойным кликом
- В открывшемся окне редактора найдите бенд “Чеки” с текстом “Итого к оплате” и удалите его

- В освободившемся месте создайте новый виртуальный бенд

- Добавьте новый Memo внутри созданного бенда на две строки с выключкой влево и содержимым как на скриншоте ниже

- Добавьте новую переменную "teyca" с типом string
- Добавьте новый Memo внутри созданного бенда на две строки с выключкой вправо и содержимым как на скриншоте ниже
- Во второе поле добавьте короткий скрипт:
httpget('https://rkeeper.teyca.ru/print/precheck?operation='+[Чеки.GUID], teyca);

- Для поддержания декорации на печати скопируйте любой из Memo с прочерками в конец созданного бенда и сохраните изменения в макете кнопкой “Ок” в правом нижнем углу редактора макета

V. Вывод пречека на печать

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

- Откройте справочник “Настройки -> Печать -> Схемы печати
- В открывшемся окне в списке слева выберите используемую в ресторане схему печати и в списке представлений документов найдите “Пречек”. Удалите его
- Кликните правой кнопкой мыши в пустом месте представлений документов и выберите пункт “Добавить представление документа”

- В открывшемся списке найдите только что созданный пречек, выберите его, и нажмите кнопку “Ок” в нижнем правом углу окна

VI. Настройка интеграционного модуля

Модуль FarCards может работать как в режиме настольного приложения, так и в качестве win32 сервиса. Первый запуск рекомендуется сделать в настольном режиме. Для этого запустите исполняемый файл Farcards.exe с ключом /desktop
cmd> .\Farcards.exe /desktop

- Модуль запустится свернутым в трей. Откройте его окно чтобы убедиться, что библиотека интеграции загружена корректно

- Убедитесь, что сетевой протокол для соединения с R_Keeper запущен и работает без ошибок

В случае ошибок запуска протокола убедитесь, что в локальной сети не запущен другой экземпляр этого модуля, и что порт, указанный в файле netk.ini не занят на компьютере с текущим экземпляром FarCards.
После этих проверок модуль может быть установлен в качестве службы путем запуска с ключом /install (Потребуется запуск с правами администратора).
cmd> .\Farcards.exe /install

После этого установленная служба FarCards может быть запущена, на чем настройку интеграции можете считать завершенной.