iikoCard
iikoCard — бонусно-депозитная система iiko: работа с постоянными гостями и схемы корпоративного питания. Смартомато
работает только с бонусными программами iikoCard.
Что нужно до подключения
- iiko, к которой подключён iikoCard, и бонусная программа в iikoCard с заданными условиями начисления. Условия задаёт
клиент в программе лояльности iikoCard.
- Выбран способ, которым списанные онлайн бонусы попадут в чек iiko: скидка со свободной ценой или тип оплаты. Шаги
для обоих способов описаны ниже.
- Если в Смартомато уже копились бонусы, их выгружают отчётом по клиентам до подключения и передают дилеру или
клиенту, чтобы он начислил их в iikoCard вручную. Зачем: после подключения баланс каждого гостя заменяется
балансом из iikoCard, см. Внешние системы лояльности.
Шаги на стороне iiko и iikoCard
Вариант 1: бонусы передаются скидкой
1. В backOffice iiko завести скидку с произвольной суммой и назвать её «Бонусы».
2. Проверить, что скидка отдаётся методом API iiko api/1/discounts (справочник API, статья iiko). Зачем: Смартомато
берёт скидку оттуда по её id.
Вариант 2: бонусы передаются типом оплаты
1. В бонусной программе iikoCard включить чекбокс «Разрешать холдирование» (статья iiko о холдировании).
2. Создать тип оплаты «Бонусы».
3. В дополнительных настройках этого типа оплаты обязательно включить «Бонусная программа: Программа с холдированием
(холдирование)». Зачем: без холдирования бонусы списываются дважды, см. «Типовые ошибки».
Название программы лояльности
Название бонусной программы запрашивают у клиента. Его, а заодно условия начисления и списания, можно посмотреть
запросом к API iiko, см. ниже.
Проверка через API iiko (Postman)
1. Токен: POST https://api-ru.iiko.services/api/1/access_token, в теле {"apiLogin": "<апи-логин>"}.
2. Дальше запросы идут с авторизацией Bearer Token.
3. Баланс конкретного гостя: POST https://api-ru.iiko.services/api/1/loyalty/iiko/customer/info, в теле phone (телефон
гостя), "type": "phone" (не менять) и organizationId (id организации iiko, где настроен iikoCard). В ответе нужен
walletBalances → balance.
4. Программы лояльности организации: POST https://api-ru.iiko.services/api/1/loyalty/iiko/program, в теле
organizationId. В ответе массив Programs с активными программами, их названиями и условиями.
Что передать в Смартомато
- API-логин iiko, к которой подключён iikoCard. Он может отличаться от логина, который используется в интеграции с
iiko.
- Id организации iiko, в которой настроен iikoCard. Если брендов несколько (логистический центр), для всех передаётся
один и тот же id — той организации, где подключён iikoCard.
- Название программы лояльности в iikoCard.
- Id скидки «Бонусы» (вариант 1) или id типа оплаты «Бонусы» (вариант 2).
- Клиент зарубежный или нет: для зарубежных клиентов используется отдельный адрес API iiko,
https://api-eu.iiko.services/api/1/.
- Проводит ли касса сама бонусные операции через тип оплаты. От этого зависит, будет ли Смартомато отправлять в
iikoCard начисления и списания или только синхронизировать баланс.
Типовые ошибки и вопросы клиентов
- Бонусы списываются дважды: сначала холдируются, потом списываются ещё раз при закрытии заказа в iiko. Дилер включает
в программе лояльности iikoCard «Разрешить холдирование», а в типе оплаты для бонусов, в дополнительных настройках,
— пункт о холдировании.
- Ошибка **IikoCardPayment can't be externally processed** при импорте заказа в iiko. Исправляется в настройках
интеграции на нашей стороне, см. Внешние системы лояльности.
- Двойное списание, когда касса сама списывает бонусы по типу оплаты. На нашей стороне включается режим, в котором
Смартомато только синхронизирует баланс. В этом режиме Смартомато не начисляет за заказы, за программы
лояльности и вручную из карточки клиента.
Связанные статьи
- Внешние системы лояльности
- Карта лояльности гостя
- Уровни лояльности (бонусные категории)
- Ручное начисление бонусов