Для настройки интеграции вам потребуется:
1. Настроенная программа лояльности в iikoCard.
2. Стартовый номер электронных карт, должен быть больше номеров созданных ранее карт.
3. Список категорий программ лояльности с процентами.
4. API-ключ из iikoTransport (шаблон прав: все права, e-mail: hello@cardpr.com).
Задайте в настройках CARDPR стартовый номер электронных карт, должен быть больше номеров созданных ранее карт в CRM-системе. Перейдите в раздел Интеграция. Если у вас активирован демо-период, завершите его.
Кликните поле CRM-система, в выпадающем списке выберите iikotransport.
В поле Сервер укажите https://api-ru.iiko.services/
В поле Логин укажите API-ключ из iikoTransport.
Нажмите кнопку Проверить и Сохранить, поля Сервер и Логин должны стать зелеными.
В поле ID организации выберите вашу организацию, где подключена программа лояльности.
В поле ID программы выберите вашу программу лояльности. Нажмите кнопку Сохранить.
Перейдите во вкладку Категории. Нажмите Добавить категорию. В поле Название выберите из выпадающего списка нужную категорию. В поле Тип выберите из выпадающего списка соответствующий тип вашей программы лояльности - скидка или бонус. В поле Процент укажите соответствующий категории процент, например, 5.00.
Аналогично добавьте остальные категории, которые вы используете. Далее нажмите кнопку Сохранить и включите интеграцию.
Если у вас есть выпущенные карты в личном кабинете CARDPR, перейдите в раздел Клиенты и нажмите кнопку в правом нижнем углу Записать в CRM.
Добавление Webhook в iiko.biz / m1.iiko.cards
Для автоматического обновления бонусов на картах у гостей необходимо в iiko.biz / m1.iiko.cards зайти в раздел Настройки -> Webhook уведомления. Выбрать организацию, с которой выполнена интеграция.
Далее нажать кнопку Создать.
Указать название CARDPR
Указать URL отправки webhook-уведомлений: https://core.codepr.ru/api/v2/iikotransport/hook
Установить чекбоксы:
- смена баланса пользователя;
- смена категории гостя;
- смена карты пользователя;
- смена участия пользователя.
Далее сохранить настройки.
Особенности интеграции:
• Начисление/списание бонусов, предоставление скидок настраивается и происходит на стороне вашей системы iiko.
• При получении карты информация о госте и его карте обычно появляется в системе iikoCard от нескольких минут до нескольких часов. Максимальное время появления — 24 часа. Время появления зависит от загрузки систем и очереди на обновление.
• При изменении бонусного баланса или скидки в iikoCard информация в CARDPR и на карте гостя обновляется от нескольких минут до нескольких часов. Время появления зависит от загрузки систем и очереди на обновление.
• Если вы планируете изменить порядок начисления бонусов или предоставления скидок, сообщите нам, чтобы мы обновили настройки интеграции. Может потребоваться доступ к iikoCard с правами к разделам Гости и Счета гостей.
• Нельзя редактировать номер карты в iikoCard. Бонусы и скидки гостя не будут передаваться в CARDPR и отображаться на карте. Если у гостя изменился телефонный номер — гостю нужно получить новую карту через CARDPR.