Интеграция с Altegio

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

Для настройки интеграции нужно выполнить следующие шаги:
1) На проекте должен быть подключен филиал Altegio

2) Переходим в Altegio, и слева сверху нажимаем на название филиала. Листаем в самый низ в поиске сети данного филиала. Скриншот:

3) Переходим в сеть. В открывшемся интерфейсе в левом меню выбираем Настройки - Пользователи - Пригласить существующего пользователя.
Указываем почту support@message.help (ОБЯЗАТЕЛЬНО указываем именно эту почту)
Также выставляем права доступа к следующим разделам:
- Лояльность (все права)
- Клиенты (все права)
- Счета клиентов (все права)

4) После того как пользователь добавлен, необходимо перейти слева в раздел Лояльность - Типы карт. Здесь добавляем новую карту - придумайте название, и обязательно укажите в каких филиалах карта будет действовать. 

См. скриншот - красные поля обязательны к заполнению;
зеленые - опционально;
черные - изменять нельзя.

5) Теперь можно настроить карту в message.help и связать её с Altegio.

Принцип работы интеграции 

Фактически у клиента появляется счет в Altegio, в котором просто записывается количество его баллов. А наша система отвечает за корректное начисление бонусов в рамках настройки карты. Такая система нужна для корректной фискализации (то есть чтобы оплата бонусными баллами учитывалась в чеке).
Таким образом баллы хранятся отдельно в Altegio и отдельно у нас, но их количество всегда одинаковое. 

Нюансы:
1. Altegio не присылает данные об изменении состояния бонусного счета. Это означает, что если начислить или списать баллы вручную в Altegio - мы об этом не узнаем, пока не получим какое-то событие по клиенту. Например, создание или изменение записи, или оплату визита.
2. В связи с пунктом 1 - при проведении оплаты, если есть необходимость списать бонусы то следует сначала списать именно их, и уже потом остаток оплаты провести наличными/картой. То есть бонусы - в первую очередь.

Также прикрепляем скриншот с окном оплаты - видно что можно выбрать тип оплаты бонусными баллами: