Simple Loyalty Pass Документация Заявка

Как устроен Simple Loyalty Pass

Simple Loyalty Pass (SLP) — платформа лояльности для заведений, работающих на iiko. Гость носит клубную карту в телефоне, касса сама применяет его бонусы и условия в привычном интерфейсе, а заведение получает собственную базу гостей и аналитику.

Страница объясняет, из чего состоит платформа и как её части связаны между собой. Технических подробностей здесь нет — только то, что нужно понимать при принятии решения и на онбординге.

Четыре части системы#

ЧастьГде находитсяЧто делает
Приложение гостя (SP)телефон гостякарта и QR-код, баланс бонусов, уровень, история, витрина заведения, меню
Сервер платформынаши серверы в Россиибонусный движок (истина по балансам), база гостей, сегменты и рассылки, аналитика, брони
Плагин на кассеглавные кассы заведения, внутри iikoFrontопознаёт гостя в чеке, списывает его бонусы, применяет личную скидку и купоны, отправляет закрытые чеки на сервер
Кабинет заведениябраузернастройка программы, гости, сегменты, аналитика, роли сотрудников, журнал действий

Дополнительно к этому подключаются: Wi-Fi-портал (гость опознаётся при подключении к сети заведения), борд броней для хостес (отдельный экран на планшете) и связка с Simple Manage, если заведение им пользуется.

Схема#

flowchart TB
    subgraph Venue["Заведение"]
        POS["Главные кассы: iikoFront + плагин SLP"]
        AP["Точки доступа Wi-Fi"]
        BOARD["Планшет хостес: борд броней"]
    end

    subgraph Cloud["Платформа SLP (серверы в России)"]
        API["Ядро: бонусный движок, гости, сегменты, аналитика, брони"]
        DB[("База данных")]
        WIFI["Wi-Fi-портал"]
        CONN["Коннектор к облаку iiko: меню, стоп-листы, сверка"]
    end

    GUEST["Приложение гостя (SP)"] --> API
    CAB["Кабинет заведения"] --> API
    BOARD --> API
    POS <-->|"опознание, скидки, списание, чеки, возвраты"| API
    AP --> WIFI --> API
    API --> DB
    CONN <--> IIKO["Облако iiko вашего заведения"]

    LIC["Контур лицензий и подписки"] -.->|"право на работу"| Cloud
    SM["Simple Manage (опционально)"] <--> API

Как это работает на практике#

1. Гость попадает в базу. Есть три пути: подключился к Wi-Fi заведения и подтвердил номер телефона; установил приложение SP; пришёл по именному QR-коду официанта. Любой путь даёт одно и то же — карту заведения, привязанную к номеру телефона.

2. Гость приходит в заведение. Кассир сканирует QR-код с экрана телефона гостя (или вводит номер телефона). Плагин запрашивает у сервера баланс, уровень и лимит списания и показывает их кассиру.

3. Касса считает чек. Всё, что должно попасть в чек, приходит с сервера уже посчитанным и ложится обычными скидками iiko: списание бонусов (касса ставит его сама, на максимум, разрешённый этому гостю), личная скидка гостя, если она ему выдана, и купон, если кассир его погасил. Сколько можно списать, решает сервер: доля от чека, исключённые позиции, уровень и личные условия гостя. Кассир при желании уменьшает или снимает списание прямо в чеке.

4. Чек закрывается — бонусы начисляются сами. Кассиру не нужно ничего дополнительно нажимать: закрытый чек уходит на сервер, там считается начисление, гость получает уведомление.

5. Заведение видит результат. В кабинете: кто пришёл, сколько начислено и списано, сколько бонусов «висит» обязательством, какие гости остывают, что дала рассылка.

Что важно понимать#

Баланс живёт на сервере, а не в кассе. Касса — это «руки»: она показывает и исполняет, но все правила и весь учёт бонусов находятся на стороне платформы. Поэтому изменение настроек программы в кабинете действует сразу, без обновления касс.

Касса никогда не блокируется. Если связь с платформой пропала, чек закрывается как обычно — просто без лояльности: опознать гостя, списать бонусы и дать его скидку в этот момент нельзя, кассир видит сообщение «лояльность временно недоступна». Закрытые чеки копятся в очереди внутри плагина и доотправляются, когда связь вернётся: начисления догонят, гость получит их позже.

Плагин обновляется сам. Мы не приезжаем на точку ради обновлений — плагин сам забирает подписанные обновления.

Бонусы — не деньги. Бонусные баллы являются скидочной программой заведения и его обязательством перед гостем. Вывод баллов в деньги, переводы между гостями и продажа баллов не предусмотрены — ни сейчас, ни в будущих версиях.

Одна платформа на всех, но данные разделены. Заведения работают в общем сервисе, при этом данные каждого заведения изолированы на уровне базы данных: сотрудник видит только своё заведение. Подробнее — в разделе «Безопасность и персональные данные».

Что читать дальше#