Внешняя система лояльности. Смартомато заводит гостей в PrimeHill, начисляет и списывает баллы за онлайн-заказы и подтягивает баланс, если гость копил или тратил в офлайне.
Что нужно до подключения
- В PrimeHill создан шаблон программы лояльности, то есть бонусный макет.
- Если для разных категорий или уровней гостей используется несколько макетов, заранее понятно, какой макет какому уровню и проценту начисления соответствует.
- Одна организация Смартомато работает с одной бонусной системой и одним токеном. Если в организации два ресторана с разными юрлицами, подключить по токену на каждый нельзя.
Шаги на стороне PrimeHill
- Клиент выдаёт токен PrimeHill.
- Клиент создаёт бонусный макет и сообщает его id. Id можно узнать и самим:
GET https://open-api.p-h.app/api/v2/getTemplates?token=<токен>вернёт список макетов. У клиента уточняют, какой из них нужен. Id обычно выглядит как7255. - Если макетов несколько (разные уровни гостей), запросить все макеты тем же запросом и выписать их id. Зачем: каждый макет сопоставляется с уровнем гостя в Смартомато.
- Узнать у клиента, какое техническое значение PrimeHill подставляет в имя гостю, который не указал имя (например, «Не задано»). Зачем: иначе такое значение попадёт в карточку клиента как имя.
- Если новых гостей нужно заводить в PrimeHill с набором тегов, узнать id этих тегов в PrimeHill.
- Уточнить, кто начисляет бонусы за покупку. Если начисление делает PrimeHill или касса, Смартомато перестаёт отправлять начисление за заказ, но списание бонусов, использованных в заказе, по-прежнему уходит в PrimeHill.
- Если у клиента отдельный контур PrimeHill, узнать его адрес. По умолчанию используется базовый
https://open-api.p-h.app/api/v2/.
Документация PrimeHill
- Open API PrimeHill.
- Документация 2, ссылка на Google Drive из статьи.
- Коллекция Postman «Prime Hill.postman_collection.json» приложена к исходной статье.
Что передать в Смартомато
- Токен PrimeHill.
- Id бонусного макета, а при нескольких макетах — id каждого и уровень или процент, который ему соответствует.
- Техническое значение имени для гостей без имени.
- Id тегов PrimeHill для новых гостей, если они нужны.
- Кто начисляет бонусы за покупку: Смартомато или PrimeHill либо касса.
- Адрес отдельного контура, если он есть.
Типовые ошибки и вопросы клиентов
- Можно ли подключить разные токены в одной организации, например по одному на ресторан с отдельным юрлицом? Нет: одна организация — одна бонусная система и один токен.