Установка интеграции

Последние изменения: 10.09.2024

Применение системы возможно в любых организациях, работающих на программном обеспечении r_keeper v7 (совместимо с r_keeper 7.6.5 и выше; FARCARDS v 6.04)

Поставка

ПО поставляется в rar архиве. Установка на конечный компьютер осуществляется путем распаковки архива в любую папку на жестком диске компьютера.

Рекомендуется устанавливать модуль FarCards на той же машине где расположен кассовый сервер (мид).

Интерфейс для кассового сервера

В менеджерской станции перейдите в справочник «Сервис → Станции и Устройства».

Выберите кассовый сервер, для которого настраивается модуль и откройте вкладку «Устройства».

Нажмите на пустом месте правой кнопкой мыши и откройте «Список драйверов», в списке найдите «PDS interface» и перетащите его в список устройств кассового сервера. В настройках интерфейса в поле «PDS Server Name» укажите «SAMOSALE», это же название используется в настройке FarCards (FARCARDS.INI, поле NetServerName).

Логический интерфейс

Перейдите в справочник «Сервис → Интерфейсы».

На пустом месте нажмите правой кнопкой мыши и выберите «Новый интерфейс». В настройках интерфейса укажите название «SAMOSALE» и переведите статус в «Активный».

В разделе «Файлы библиотек (DLL)» во вкладке с названием ресторана укажите физический интерфейс из прошлого пункта для каждого кассового сервера.

ВНИМАНИЕ. Убедитесь, что к физическому интерфейсу (PDS interface) привязан только один логический интерфейс — тот, что был создан в этом пункте, SAMOSALE.

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

Перейдите в справочник «Сервис → Обработка сигналов устройств → MCR алгоритмы».

Создайте новый алгоритм, укажите в настройках тип алгоритма «Скрипт вер. 7.0». В типах устройств выберите типы «Клавиатура», «Скрипт» и «Штрих код». Выберите «Интерфейс» в поле «Область», в поле «Объект» выберите логический интерфейс из прошлого пункта.

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

«Result := False;» на

«begin if Length(Parameter) = 6 then begin

Parameter := '%' + Parameter;

Result := True; end

else if (Length(Parameter) > 8) and (Length(Parameter) < 14) then

Result := True; end;

», затем нажмите кнопки «Проверка» и «ОК».

Скидка

Перейдите в справочник «Деньги → Скидки и Наценки».

Добавьте новый тип скидок и в нем создайте новую скидку «SAMOSALE», поменяйте тип скидки на «Процент».

В свойствах скидки поставьте галочку на свойствах «Комб. с любой скидкой», «На заказ» и «Не вручную» Также в разделе «интерфейс» выберите «SAMOSALE».

Перейдите во вкладку «Детализации» и создайте новую детализацию с процент 100. После создания детализации скидку можно перевести из статуса «Черновик» в «Активный». Запомните код скидки, он понадобится в дальнейшем.

Валюта

Перейдите в справочник «Деньги → Валюты».

В типе валют «Платежные карты» создайте новую валюту «Бонусы».

Поставьте галочки на ограничениях «Не в сдаче», «Предоплаты».

Укажите тип фискальности «Фискальный чек».

В значении «Интерфейс» укажите логический интерфейс «SAMOSALE», который был создан ранее.

Установите значения «Макс. Процент» и «Минимальная сумма», их должны предоставить SAMOSALE.

Настройка FarCards

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

Откройте файл FARCARDS.INI и установите значение параметра NetServerName в соответствии с параметром PDS Server Name, который был указан в настройке физического интерфейса.

В файле netk.ini установите любой свободный TCP порт в параметр «port».

Откройте файл SAMOSALE.ini и отредактируйте значения в соответствии с рестораном, в котором устанавливается модуль.

Секция [PARAMS]

● BaseURL — адрес SAMOSALE API https://app.samosale.ru/ - ОБЯЗАТЕЛЬНО “/” в конце адреса.

● ApiKey — токен, предоставляемый SAMOSALE.

● RestID — Идентификатор участника системы.

● DiscCode — Код, который указан в разделе скидки.

Секция [LOG]

● LogLevel — уровень логирования. От 0 (только ошибки) до 10 (максимум подробностей).

● OldLogs — время жизни старых Log файлов в днях.

● LogMem — логировать ли используемую оперативную память.

Запуск приложения

ВНИМАНИЕ. После выполнения настроек необходимо перезапустить кассовый сервер и кассовую станцию r_keeper.

Первый запуск FarCards.exe нужно выполнить с ключом /desktop. Убедитесь, что статус SAMOSALE.dll Ok.

Во вкладке DLL есть строка с сетевым именем сервера и статусом Ok.

После этого запустите FarCards.exe с ключом /install и запустите в Windows установленную службу.

Замена кнопки в интерфейсе

Чтобы добавить в интерфейс кассы кнопку с название системы лояльности, нужно в менеджерской зайти в настройки => Графический интерфейс => функциональные клавиши.

В разделе слева выбрать общие => редактирование.