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

Прямая интеграция с Frontol при помощи PriorityAPI

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

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

# Общее

Приложение PRIME HILL для Frontol позволяет напрямую интегрировать Frontol c PRIME HILL.
В рамках интеграции весь расчет бонусов и скидок происходит на стороне PRIME HILL

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

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

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

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

# Требования

  • Frontol v.6;
  • Лицензия Frontol Priority API — приобретается у поставщика Frontol , есть 45 дней демо доступа;
  • Лицензия приложение PH для Frontol — приобретается в PRIME HILL;
  • Исходящий доступ в Интернет без прокси на внешние адреса к портам 80 и 443 (http и https);
  • Оборудование для приема карт – 2D сканер (не обязательно, но желательно для удобства).

# Настройка подключения

  • Откройте Frontol Администратор.
  • Откройте Настройки → Во вкладке Системные откройте РМ и оборудование
  • Выберите Платежные системы → Установите галочку «Оплата скидкой по бонусной карте перед входом в режим расчета».
  • Выберите Платежные системы → Устройства
  • В разделе Устройства нажмите кнопку Создать
  • В открывшемся окне во вкладке «Основное» укажите обязательные параметры:
    • Наименование: «PRIME HILL»
    • Группа печати: Выберите необходимую группу
    • Состояние: «Подключено»
  • Заполните остальные параметры по мере необходимости ваших настроек.
  • Во вкладке «Назначение» выберите «Бонусы и скидки», настройте параметры списания бонусов согласно вашей программе лояльности.
  • Далее нажмите Свойства
  • В открывшемся окне укажите следующие параметры:
    • Наименование: «PRIME HILL»
    • Тип АС: Frontol Priority API
  • Далее нажмите Параметры АС… 
  • В открывшемся оне укажите следующие параметры:
    • Веб-адрес сервера лояльности: «https://frontol.p-h.app/TOKEN«, где токен — API Token полученный в PRIME HILL.
    • Идентификатор организации: API Token полученный в PRIME HILL
    • Идентифицировать клиента по: «Номер карты или телефона»
    • Данные карты в магнитной полосе: «Вся магнитная полоса»
    • Таймаут отправки запросов, мс: «1000»
    • Снимите галочку «Отправлять документы продажи и возврата без карт лояльности»

# Настройка раскладки

  • Откройте Настройки → Во вкладке интерфейс откройте Раскладки;
  • Далее откройте на редактирование клавиатуру, которая у вас используется;
  • Добавьте новую комбинацию клавиш, для этого нажмите кнопку Создать;
  • Укажите клавишу или комбинацию, которая будет отвечать за использование программы лояльности.
  • В качестве Функции укажите Операции платежной системы → Меню;

# Прямая синхронизация DB Frontol с PRIME HILL

Для синхронизации категорий и товаров установите plugin DB exporter от PRIME HILL. Задача данного плагина синхронизировать вручную или по заданному расписанию все категории и товары из вашей базы Frontol с PRIME HILL.

Синхронизация точек продаж

Плагин синхронизирует базу Frontol напрямую с PRIME HILL минуя API Frontol.

При синхронизации плагин регистрирует базу Frontol как точку продаж в ЛК PH, при этом присваивает наименованию точки продаж имя рабочего места полученному из Frontol → Настройки → Системные → РМ и оборудование → Рабочие места → Рабочее место → Наименование.

В случае наличия нескольких баз и создания таких баз путем копирования убедитесь, что организации имеют уникальные GUID (OrganizationId) в БД Frontol, сделать это можно следующим запросом к БД:

Copy to Clipboard

Синхронизация товаров и категорий

В качестве товаров и блюд передается номенклатура из Frontol → Справочники → Товары → Товаром и блюдом считается товар любого типа в данном справочнике. Категорией товара считается конечная группа, в которой данный товар состоит.

При структуре справочника Напитки

— Газированные напитки
— — Вода бренда «А»
— — Вода бренда «Б»

— Алкоголь
— — Вино
— — — Вино бренда «А»
— — — Вино бренда «Б»
— — Пиво
— — — Пиво бренда «А»
— — Коньяк бренда «А»

Для товаров Вода бренда «А» и Вода бренда «Б» категорией является «Газированные напитки»
Для товаров Вино бренда «А» и Вино бренда «Б» категорией является «Вино»
Для товаров Пиво бренда «А» категорией является «Пиво»
Для товаров Коньяк бренда «А» категорией является «Алкоголь»

Установка и запуск plugin DB exporter:

  • Скачайте архив с плагином;
  • Распакуйте архив с плагином в удобном месте;
  • Заполните файл conf.xml;

Обязательные данные для заполнения в файле config.xml:

ApiAddress Адрес сервера PRIME HILL.
LoyltyApiToken loyaltyAPI токен, полученный в PRIME HILL.
PathDB Путь к базе данных Frontol.
LoginDB Логин от базы данных Frontol.
PassDB Пароль от базы данных Frontol.

Пример config.xml файла:

Copy to Clipboard

Настройка автоматического запуска

  • Откройте панель Пуск → В поиске найдите «Планировщик заданий» (Task Scheduler) → Запустите его;
  • Нажмите «Создать простую задачу» → Укажите наименование задачи, например «Экспорт DB в PH» → Нажмите далее;
  • Укажите периодичность выполнения синхронизации, например «Ежедневно» → Нажмите далее;
  • Укажите время выполнения синхронизации, например 08:00 и периодичность выполнения, например каждый 1 день → Нажмите далее;
  • Выберите действие «Запустить программу» → Нажмите далее;
  • Укажите путь до файла DB exporter PrimeHill.exe → Укажите путь к рабочей папке с плагином → Нажмите далее;
  • Проверьте корректность заполнения данных → Нажмите готово;