установка dll

Установка DLL ReMarked на r-keeper

Инструкция описывает состав ПО для интеграции r-keeper с ReMarked, порядок запуска кассы и полную установку компонентов: модуля выгрузки меню (menu_dump), модуля взаимодействия FarCards и агента мониторинга.

Состав ПО для r-keeper

Дистрибутивы поставляются по ссылке:

https://drive.google.com/drive/folders/1QS8B4qHjMhL7QRO3AMJd1jLnis7_DzPK

Компонент	Назначение
`remarked_farcards`	DLL для взаимодействия ReMarked и r-keeper
`menu_dump`	ПО для передачи структуры меню в ReMarked
`monitoring_agent`	ПО для мониторинга и удалённого администрирования DLL

Путь к FarCards на кассах (пример версии):

C:\REMARKED\remarked_farcards_v1.2.5

Порядок запуска r-keeper после перезагрузки

1. Сервер:        C:\rkeeper\Rk7MidServer\MIDSERV.exe
2. FC:            C:\rkeeper\Farcards-dll -desktop   (ярлык)
3. Касса:         C:\rkeeper\Касса
4. Менеджерская:  C:\rkeeper\Rk7Manager   (при необходимости)

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

Создать приложение «API Системы лояльности Remarked» со следующими настройками:

Ключ приложения — токен, используемый для взаимодействия с API.
Тип кассы — тип используемой кассы, в данном случае rkeeper.
Доступные варианты получения гостя — указать нужные варианты.

Настройка XML-интерфейса r-keeper

XML-интерфейс предоставляет удобный способ получения информации о системе r-keeper и сохранения данных в БД r-keeper 7. Для работы на чтение лицензировать XML-интерфейс не нужно.

HTTP XML интерфейс кассового сервера

Перейти в справочник «Сервис → Станции и устройства».
В дереве слева выбрать кассовый сервер, с которым будет работать ПО.
Перейти во вкладку «Свойства» выбранного кассового сервера.
В группе свойств «HTTP ограничения» для всех пунктов проставить значение (можно использовать стандартную привилегию, например «HTTP Access»).
В группе «HTTP Server» параметр «HTTP Data Port» установить в любой свободный порт на компьютере с кассовым сервером — этот порт используется при настройке ПО. Параметр «Use Free Listen Port» рекомендуется отключить.
Сохранить изменения и перезапустить кассовый сервер (или кассу).

Пользователь для HTTP XML интерфейса

Перейти в справочник «Персонал → Работники».
Выбрать существующую роль XML-Editing (именно её), дать ей привилегию на объект «HTTP Access» (или ту, что заведена ранее) в группе «Менеджерские ограничения».
Для роли создать пользователя с названием строго из латинских букв (регистр важен), задать пароль (цифры и латинские буквы).
Выдать этой роли полные кассовые права.
Учётные данные (название и пароль) потребуются для дальнейшей настройки ПО.

Проверка: в браузере перейти по адресу:

https://127.0.0.1:8026/webgui/iservxmltest.htm

где 127.0.0.1 — адрес кассового сервера, 8026 — порт интерфейса. При корректной настройке браузер сообщит о сертификате, после игнорирования спросит логин/пароль интерфейса и откроет страницу проверки с готовым XML-запросом.

Сервер синхронизации меню (menu_dump)

Модуль выгружает меню из r-keeper в CRM ReMarked: сначала выполняется первоначальная выгрузка всего доступного меню, далее — периодическая выгрузка меню и стоп-листов при изменении справочников.

Скачать последнюю версию:

https://drive.google.com/drive/folders/1SFYRKG0rn3xINgyx1t5XKLlVZou-cAXR

Поставка. ПО поставляется в zip-архиве. Установка — распаковкой архива в любую папку на диске. Не оставляйте номер версии в имени папки — это помешает обновлению. Рекомендуется устанавливать модуль на той же машине, где расположен кассовый сервер (мид).

Конфигурационный файл settings.yaml

Запустить сервер синхронизации remarked_menu_dump.exe в режиме /desktop (в поставке есть bat-файлы для запуска) — это сгенерирует необходимые файлы, в том числе settings.yaml.
Закрыть программу, открыть settings.yaml (находится в папке запуска) в блокноте и прописать параметры.

В файле настроек указать:

IP-адрес кассового сервера;
порт HTTP XML интерфейса кассового сервера;
имя пользователя и пароль для работы с XML-интерфейсом;
идентификатор классификации из r-keeper (по умолчанию 2560) — по нему выгружаются категории блюд и блюда. Важно: в классификации обязательно должны быть категории;
уровень логирования от 3 до 10 (10 — максимальный, использовать при первом запуске);
срок хранения логов (рекомендовано 7);
код станции, код стола и категорий — для корректных данных стоимости блюд (важно для сетевых ресторанов).

Раздел «Настройки API» (данные получаются от CRM ReMarked):

токен для работы с API CRM ReMarked;
URL API CRM ReMarked (app.remarked.ru);
время ожидания ответа от сервера (по умолчанию 10 секунд);
время в минутах для повторной синхронизации (рекомендовано 10 минут).

Сохранить и закрыть файл, запустить remarked_menu_dump.exe, проверить выгрузку.

Bat-файлы запуска

desktop.bat — запуск приложения в режиме /desktop;
install.bat — установка службы на ПК;
uninstall.bat — удаление службы с ПК.

Дальнейшие шаги

Настройка модуля взаимодействия FarCards и агента мониторинга описана в инструкции «Настройка FarCards и Telegram».
Работа кассира с картами — в инструкции «Работа с картами r-keeper».