Частые проблемы и что делать

Плагин вообще не загружается#

Признак: в логе фронта нет строки SLP: плагин <версия> запущен, кнопки «SLP Лояльность» на экране заказа нет.

Проверьте по порядку:

1. Файлы на месте. В папке Plugins\SlpPlugin.V9\ лежит весь комплект, включая manifest.xml. Без манифеста фронт плагин не видит вовсе, а с другим именем папки на кассу не приходят обновления.
2. Лицензия модуля. Если в логе ошибка недостаточной лицензии (InsufficientLicenseException) — в лицензионном пакете точки нет модуля iikoAPIPayment (21016318). Разбираться через личный кабинет лицензий iiko.
3. Версия RMS. Плагин собран под API V9. На RMS 10.x требуется новая сборка — обратитесь в поддержку SLP.
4. Фронт перезапущен после копирования файлов.

Плагин загрузился, но лояльность не работает#

Признак: в логе строка о незаполненном конфиге, кнопка есть, но идентификация не проходит.

• Проверьте, что в slp-plugin.json заполнены и адрес облака, и токен терминала.
• Настройки читаются только при старте — после правки перезапустите iikoFront.
• Если файл повреждён (ошибка в JSON), плагин молча уходит в ограниченный режим. Проверьте файл на корректность.

«Лояльность временно недоступна»#

Облако не ответило за отведённое время. Это не ошибка кассира.

• Чек закрывается обычным способом, скидка и списание в этот момент недоступны;
• начисление гость получит позже автоматически;
• если сообщение появляется постоянно — проверьте интернет на кассе и доступность облака SLP с этой машины (исходящий HTTPS, TLS 1.2, отсутствие блокировок на прокси/файрволе).

«Гость не найден» / «Такого гостя не нашли»#

Облако ответило отказом — значит связь есть, а идентификатор не распознан.

• Перепроверьте номер телефона;
• при поиске попробуйте другие цифры номера или фамилию;
• попросите гостя обновить QR в приложении (QR динамический и живёт недолго);
• убедитесь, что гость зарегистрирован в программе этого заведения.

«У гостя пока нет карты этого заведения»#

Аккаунт в платформе есть, но карты вашего заведения гость не выпускал. Аккаунт общий, а карта — своя у каждой точки. Гость заводит её в приложении из каталога заведений; начисление пойдёт со следующего чека.

Бонусы не списались: скидки в чеке нет#

Списание происходит само, поэтому «кассир забыл» тут ни при чём. Проверьте по порядку:

1. Гость опознан? Без карты на чеке списывать не с чего.
2. Есть ли что списывать? Пустой чек в момент опознания — нормальная ситуация: скидка появится, когда пробьют позиции. Если не появилась через секунду после последней правки — смотрите дальше.
3. Настроен ли тип скидки под бонусы? Кабинет → «Касса» → «Скидка для списания бонусов». Не задан — касса списывать не может.
4. Лимит гостя не нулевой? У ступени или у самого гостя может стоять «0 %» — это законная настройка «бонусами платить нельзя».
5. Позиции чека не исключены целиком (алкоголь, табак): база лимита в этом случае нулевая.
6. Кассир не правил скидку руками в этом чеке: после ручной правки касса своё число больше не навязывает.

«Списание уменьшено до N баллов» / «Списание снято»#

Не ошибка. Кассир поставил сумму больше разрешённой, либо чек изменился так, что списывать стало не с чего. Касса привела сумму к допустимому максимуму и сообщила об этом.

«Скидка N% НЕ применена: на кассе не настроен тип скидки»#

Гостю выданы личные условия, но провести их нечем. Настраивается в кабинете: раздел «Касса», шаг «Скидка на чек в iikoOffice». До этого чеки проводятся без обещанной гостю скидки.

Купоны: «Скидка для купонов на этой кассе не настроена»#

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

Скидка задвоилась / не та скидка#

Плагин перед применением новой своей скидки снимает предыдущую того же типа. Если в чеке видно две скидки SLP одной роли — зафиксируйте номер чека и сообщите в поддержку.

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

Начисление не пришло гостю#

1. Проверьте, был ли гость опознан до закрытия чека. Если нет — начислять некому, чек ушёл без лояльности.
2. Проверьте связь кассы: при офлайне начисление лежит в очереди и придёт позже.
3. Проверьте время последней активности терминала в кабинете.
4. Если чек закрыт давно, гость опознан, касса на связи — обратитесь в поддержку с идентификатором чека.

Касса «молчит» в кабинете#

Терминал не отмечался дольше обычного. Причины: касса выключена, нет интернета, плагин не загрузился, токен терминала отозван (например, из-за неактивной подписки). Проверяется в указанном порядке.

Что приложить при обращении в поддержку#

• название заведения и номер/имя кассы;
• версию плагина (строка SLP: плагин <версия> запущен в логе, она же в кабинете);
• версию iikoRMS;
• дату, время и номер проблемного чека;
• текст сообщения, которое увидел кассир, — дословно;
• фрагмент лога плагина за нужный период.

Не пересылайте токен терминала — он поддержке не нужен.