Интеграция PRIME HILL с r_keeper

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

PRIME HILL для r_keeper может выступать дисконт сервером, который будет рассчитывать и планировать различные акции и привилегии для гостей Вашего заведения. Для такой интеграции необходимо установить plugin PRIME HILL для r_keeper.

Скачать плагин

# Общее

Плагин PRIME HILL для r-keeper позволяет напрямую интегрировать r-keeper c PRIME HILL без использования r-keeper ПДС или CRM. Все рассчеты акций, скидок и бонусов производятся в PRIME HILL.

Возможные варианты акций:

  • Дисконтная (скидки)
  • Дисконтная накопительная (скидка 5% — от 0 рублей, скидка 10% — от 100 рублей)
  • Бонусная
  • Бонусная накопительная (кэшбэк 5% — от 0 рублей, кэшбэк 10% — от 100 рублей)
  • Ранговые программы (временное применение повышенного уровня, который необходимо поддерживать, соблюдая условия программы лояльности)
  • Депозитные системы
  • Сертификаты
  • Акции «1+1»
  • Акции «блюдо в подарок»

Любые акции могут иметь ограничения в применении на определенные категории/товары.

В рамках интеграции доступны все возможные комбинации взаимодействия с клиентом при построении сценариев программы лояльности PRIME HILL.

Электронные карты PRIME HILL позволяют создавать защищенные баркоды карт, при чекине гостя через Мобильный официант R-keeper, 2D сканер или через код с клавиатуры. Под защищенными баркодами подразумевается зашифрованный в баркод или выведенный в карту токен карты, который обновляется с заданной периодичностью и/или после каждой транзакции.

# Требования

  • r-keeper v.7 и новее;
  • Лицензия PH plugin – r-keeper — приобретается в PRIME HILL;
  • Исходящий̆ доступ с ПК с farcards в Интернет без прокси на внешние адреса к портам 80 и 443 (http и https);
  • Farcards v.6.n;
  • Оборудование для приема карт – 2D сканер или Мобильный официант r-keeper (не обязательны, но желательны для удобства).

# Установка плагина

Плагин работает через штатный Farcards

Для установки выполните следующие действия:

  • Установите FARCARDS версии не ниже 6.04 (Доступен в архиве с плагином);
  • Скопируйте файлы primehill.dll и primehill.ini в папку с FARCARDS;
  • В файле FARCARDS.ini пропишите следующие параметры:
Copy to Clipboard
  • Заполните файл primehill.ini со следующей структурой:
Copy to Clipboard

# Настройка соединения r-keeper и FARCARDS

Для применения карт PRIME HILL в r-keeper необходимо настроить взаимодействие кассовых станций с FARCARDS.

Принцип работы взаимодействия: при прокатке, скандировании, вводе номера карты с клавиатуры кассовой станции или на станции официанта, станция получает сигнал о попытке применить карту, станция направляет запрос в FARCARDS, который в свою очередь запрашивает информацию из PRIME HILL. Следовательно, необходимо настроить станции, обработку сигналов, интерфейс и прочие параметры для работы бонусов и скидок.

# Настройка станции

  1. Откройте Сервис → Станции и Устройства;
  2. Выберите ваш сервер в поле Устройства нажмите правой кнопкой мыши → Список драйверов → Выберите интерфейс – PDS interface;
  3. В свойствах интерфейса в поле PDS Server Name пропишите сервер, который указывали в FARCARDS.ini;
  4. Сохраните настройки.

# Создание интерфейса

  1. Откройте Сервис → Интерфейсы;
  2. В поле Интерфейсы нажмите правой кнопкой мыши → Новый интерфейс;
  3. Для вашего сервера укажите PDS интерфейс, созданный в пункте настройка станции;
  4. В поле Вывод нефискальных платежей в xml укажите Передавать как оплату;
  5. Сохраните изменения.

# Создание MCR алгоритма

В PRIME HILL картам может быть присвоен любой номер карты, но по умолчанию выставляется 6 значные номера карт. Следовательно в маске MCR алгоритма по умолчанию можно выставить iiiiii если вам не нужна иная нумерация для карт.

При проведении карты на кассовой станции или на станции официанта в PRIME HILL отправляется запрос с номером карты без маски. Следовательно, если номер пластиковой карты при прокатке в блокнот выглядит так: =199=1111 где 199 — маска карты, а 1111 — номер карты, то mcr-алгоритм должен настраиваться так, чтобы передавался только номер карты.

Если в заведении уже были распространены пластиковые карты и для их применения использовался MCR алгоритм с какой-либо маской, укажите параметры этой маски в настройках нумерации у макетов карт в PH.

Для создания нового или редактирования, действующего MCR алгоритма выполните следующие действия:

  • Откройте Сервис → Обработка сигналов устройств → MCR алгоритмы;
  • Создайте новый или выберите существующий MCR алгоритм;
  • В свойствах MCR алгоритма пропишите:
    • Тип алгоритма – Обработка по маске;
    • Объект – интерфейс, который был создан в пункте создание интерфейса;
    • Типы устройств укажите те, благодаря которым будут приниматься карты (в большинстве случаев это Штрихкод и Клавиатура);
    • Укажите маску обработки (например iiiiii, для 6-ти символьных кодов карт или =190=iiiiii – если в баркоде карты должна быть маска =190= по мимо кода карты);
    • Выберите Область – интерфейс
  • Сохраните изменения.

# Создание валюты

Для применения скидок и бонусов в r-keeper необходимо создать не фискальную валюту, по которой будут учитываться проведенные скидки и бонусы. Для создания такой валюты необходимо провести следующие действия:

  • Откройте Деньги → Валюты;
  • Выберите группу Платежные карты → Нажмите провой кнопкой мыши по полю Валюты → Новая валюта
  • В свойствах валюты укажите:
    • Интерфейс, который был создан в пункте создание интерфейса;
    • Как скидка: Оплата как скидка;
    • Укажите Автозаполнение: Вся сумма — если необходимо, чтобы сумма бонусов к списанию подставлялась автоматически, Без автозаполнения — если необходимо указывать сумму к списанию вручную;
    • Субсчет FarCards: 1;
  • Сохраните и активируйте эту валюту.

# Настройка применения бонусов

  • Откройте Настройки → Параметры → Использование опций → Бонусы;
  • В свойствах бонусов установите чекбокс в поле «Логический»
  • Сохраните изменения

# Создание бонусной программы

  • Откройте Деньги → Типы бонусов;
  • Создайте новый тип бонусов;
  • Активируйте созданный тип бонусов
  • Откройте Деньги → Скидки и наценки;
  • Создайте новую группу скидок «Бонусы» (Если такая группа уже существует, создавать новую не требуется);
  • В созданной группе создайте новую скидку;
  • В свойствах скидки укажите:
    • Интерфейс, созданный в пункте создание интерфейса;
    • Уберите галочку в чекбоксе у ограничения «Не вручную»;
  • Сохраните изменения;
  • Создайте детализацию для созданной скидки;
  • В параметрах детализации укажите:
    • Процент бонуса;
    • Тип бонуса, созданный в пункте выше;
  • Сохраните детализацию и активируйте скидку.

# Создание скидки

  • Откройте Деньги → Скидки и наценки;
  • Создайте группу Скидки (Если такая группа уже существует, создавать новую не требуется);
  • В созданной группе создайте новую скидку;
  • В свойствах скидки укажите:
    • Интерфейс, созданный в пункте создание интерфейса;
    • Уберите галочку в чекбоксе у ограничения «Не вручную»;
  • Сохраните изменения;
  • Создайте детализацию для созданной скидки;
  • В параметрах детализации укажите процент;
  • Сохраните детализацию и активируйте скидку.

# Активация скидок и бонусов

Для применения скидок и накопления бонусов разрешите использовать созданные ранее скидки. Для этого сделайте следующие действия:

  • Откройте Деньги » Использование скидок и наценок;
  • Выберите скидку, которую создали ранее;
  • Перетащите пункт «Разрешить» в центр поля «Использования»;
  • Сохраните настройки.

# Настройка rkMobWaiter

Для работы необходим TMS версии не ниже 7.4.318
  • В MCR алгоритме настроенном для работы с PH нужно поставить галочку Магнитные карты
  • В файле tms.ini пропишите следующие значения:
Copy to Clipboard
  • Перезапустите TMS

# Пример настройки печати пречека

  • Откройте Настройки → Печать → Документы и Макеты;
  • Выберите макет пречека, используемый для печати;
Документы и макеты
  • Нажмите по нему дважды, чтобы открыть редактор;
  • Добавьте поле под добавляемый текст;
  • В добавленном поле кликните правой кнопкой мыши → Нажмите Создать бендВиртуальный бенд;
  • В добавленном поле кликните правой кнопкой мыши → Нажмите Создать мемо;
  • Кликните дважды по сознанному мемо;
  • Заполните его;
  • При редактировании мемо кликните на кнопку Глобальные переменные, чтобы вставить данные, передаваемые из PRIME HILL;
  • Добавьте и заполните необходимое количество мемо под ваш шаблон;