Как подключить Wallet к кассе iiko

Пройдите четыре этапа по порядку: подготовьте программу в LazyCRM, подключите кассу, проверьте работу и откройте выдачу карт. После этого плагин будет получать совместимые обновления через iiko Updater.

Инструкция относится к программе, в которой бонусы считает LazyCRM. Если баланс ведётся в iikoCard, уточните режим в поддержке перед настройкой.

Кто	Что делает
Владелец или маркетолог	Настраивает условия и карту в LazyCRM, публикует программу и размещает QR.
Специалист iiko или ИТ ресторана	Устанавливает плагин на кассу, настраивает оплату и скидки в iikoOffice. Нужны права администратора Windows и доступ к настройкам iiko.
Кассир или ответственный смены	Проверяет оплату и возврат после подключения.

Если установку выполняет LazyCRM удалённо, подготовьте AnyDesk с управлением и возможностью подтвердить запрос прав администратора. Сотрудник ресторана должен быть доступен для подтверждения доступа. Проводить установку следует в согласованное окно без незавершённых оплат и возвратов.

1. Настройка программы лояльности

Результат этапа: карта оформлена, условия проверены и сохранены как черновик. Публикация будет на этапе 3, после подключения кассы.

1.1. Откройте программу ресторана

1. Войдите в кабинет LazyCRM → Wallet. Убедитесь, что выбраны нужный ресторан и программа. Если Wallet ещё не подключён, обратитесь в поддержку через кабинет.
2. Проверьте точки и каталог блюд. Если подключение iiko ещё не настроено, начните с инструкции подключения iiko.
3. Определите условия: сколько начислять, какую часть покупки разрешать оплачивать бонусами, какие уровни и исключения использовать, давать ли бонус за регистрацию.

1.2. Оформите карту и уровни

1. Откройте «Карта лояльности» → «Дизайн и уровни».
2. Выберите основную карту, задайте фон, логотип, баннер и иконку. Заполните описание программы и ссылки на условия и политику обработки данных.
3. Если нужны уровни, добавьте их названия, пороги покупок и оформление. Название уровня само по себе не задаёт начисление или скидку: фактические условия настраиваются в правилах.
4. Проверьте предпросмотр и сохраните оформление.

1.3. Настройте правила и бонус за регистрацию

1. Откройте «Карта лояльности» → «Правила программы».
2. В блоке «Регистрация клиента» → «Бонус» задайте приветственные баллы. Значение 0 означает отсутствие приветственного начисления. Бонус выдаётся один раз после завершения регистрации.
3. Добавьте правила начисления, скидки и оплаты бонусами. Для каждого укажите условия, размер и область действия: весь чек или выбранные блюда. Если правило зависит от точки, времени или уровня, заполните эти условия.
4. В общих настройках выберите порядок совмещения правил, базу начисления, округление, ограничения бонусной оплаты и исключения.

1.4. Проверьте расчёт и сохраните черновик

1. В блоке «Проверить расчёт» добавьте блюда, количество и цены. Задайте уровень, точку, способ оплаты и сумму бонусов, если от них зависят правила.
2. Нажмите «Рассчитать на сервере» и сверьте скидку, денежную часть, списание и начисление. Например, при цене 100 ₽, скидке 10% и начислении 10% от денежной части оплата составит 90 ₽, начисление — 9 бонусов. Применяйте условия своего ресторана.
3. Проверьте покупку без списания и с бонусами, а также исключённые блюда, если они есть.
4. Нажмите «Сохранить черновик». К публикации вернитесь после настройки кассы.

2. Установка плагина и настройка iiko

Выполняет специалист iiko или ИТ ресторана. Для работы нужен модуль LazyCRM в лицензии предприятия. Установщик проверит совместимость кассы; текущий комплект поддерживает Front 9.4.6046.0 и 9.5.8011.0. Если установка или загрузка отклонена, передайте точное сообщение поддержке.

Порядок важен: сначала установите и подключите плагин. После перезапуска он зарегистрирует платёжную систему «Бонусы LazyCRM». Только после её появления можно создать связанный способ оплаты в Office.

2.1. Установите плагин и подключите кассу

Единый установщик сам выбирает подходящий вариант для iikoFront 8.7–10.2 с поддерживаемым SDK. Возвраты заказов с бонусами выполняйте через кнопки LazyCRM: плагин сверяет возвращаемые позиции и оплату с исходным заказом.

Скачайте установщик LazyCRM 0.3.11 или откройте Wallet → «Подключение» → «Подключить кассу» в кабинете.

1. Распакуйте архив на компьютере кассы. Запустите connect.cmd от имени администратора. Front заранее закрывать не нужно: мастер найдёт его папку и пользователя, затем попросит штатно закрыть Front. Если Front уже закрыт, укажите его папку и пользователя Windows.
2. Выполните шаги мастера и дождитесь успешной установки. Для существующей установки сохраните прежнее подключение и журналы; повторно подключать её как новую кассу не требуется.
3. Запустите Front. В кабинете LazyCRM получите код подключения кассы; он действует 20 минут.
4. В меню плагинов Front выберите «Подключить LazyCRM» и введите код. После сообщения о сохранённом подключении перезапустите Front.
5. Обновите справочники iikoOffice и проверьте появление платёжной системы «Бонусы LazyCRM». Если её нет, проверьте загрузку плагина и лицензию с поддержкой. К созданию оплаты переходите после её появления.

2.2. Создайте бонусную оплату и платёжную скидку

1. В iikoOffice откройте «Дисконтная система» → «Скидки и надбавки». Создайте отдельную скидку «Бонусы LazyCRM» для бонусной оплаты. Отключите ручное назначение и назначение по карте.
2. Откройте «Розничные продажи» → «Типы оплат» → «Добавить». Назовите способ оплаты «Бонусы LazyCRM».
3. Выберите «Безналичный расчёт», а в поле платёжной системы — «Бонусы LazyCRM», зарегистрированную плагином.
4. Включите «Проводить как скидку» и выберите созданную платёжную скидку. Бонусная оплата должна быть нефискальной.
5. Проверьте доступность нужным подразделениям и совместимость с денежными способами оплаты. Сохраните настройки.

2.3. Создайте отдельную скидку для правил

Нужны две разные скидки: «Бонусы LazyCRM» привязана к оплате бонусами, а «Правила LazyCRM» применяется для скидок программы.

1. В «Дисконтная система» → «Скидки и надбавки» создайте скидку «Правила LazyCRM».
2. Она должна быть активной, ручной, с гибкой суммой и выборочным применением к позициям. Автоматическое назначение и привязка к карте лояльности должны быть выключены. Не привязывайте её к типу оплаты.
3. Проверьте нужные места продаж и совместимость с денежными оплатами. Сохраните.
4. Обновите справочники Front. Откройте меню плагинов → «Настроить LazyCRM» и выберите «Правила LazyCRM» по названию.
5. Подтвердите выбор и перезапустите Front, чтобы применить настройку.

2.4. Завершите привязку и проверьте кассу

1. В кабинете откройте Wallet → «Подключение» → «Кассы и точки» и обновите список.
2. Выберите нужную точку, проверьте название скидки, которое сообщил плагин, и сохраните настройку.
3. Дождитесь обновления состояния и нажмите «Проверить» у кассы. Дождитесь нового ответа: связь, лицензия, оплата и правила должны пройти проверку.
4. Если проверка указывает ошибку, исправьте названный пункт и повторите её. При необходимости обратитесь в поддержку через кабинет.

Результат этапа: касса подключена, настроены две скидки и бонусная оплата, получен успешный ответ «Проверить». Эта кнопка проверяет состояние кассы; оплату и возврат она не выполняет.

3. Запуск программы

3.1. Опубликуйте условия

1. Вернитесь в «Правила программы», проверьте черновик и нажмите «Опубликовать программу».
2. Убедитесь, что появилась действующая версия. Если публикация отклонена, выполните указанные требования готовности кассы.
3. Снова нажмите «Проверить» у подключённых касс: ответ должен относиться к опубликованным условиям.

3.2. Получите собственную карту для проверки

1. Проверьте готовность выпуска карт в кабинете и включите выдачу, если она выключена. В разделе «Ссылки и QR» создайте ссылку для регистрации и откройте её сами. Пока не размещайте ссылку и QR публично.
2. Подтвердите телефон кодом из SMS. Подключите и подтвердите мессенджер, если это обязательное условие вашей программы.
3. На iPhone добавьте карту в Apple Wallet; на Android откройте веб-карту. Сверьте название ресторана, уровень, QR и бонус за регистрацию.
4. Повторно откройте карту: повторного приветственного начисления быть не должно.

Для Apple Wallet должен быть готов сертификат выпуска карт; материал подписи готовит LazyCRM, собственный Apple Developer ресторану не нужен. Если карта не выпускается, обратитесь в поддержку через кабинет.

3.3. Проверьте оплату и возврат

Эти действия выполняет сотрудник с правами оплаты и возврата в открытой смене. Это настоящие кассовые операции. До начала выберите простые товары и подготовьте карту из предыдущего шага.

Оплата и начисление

1. Запишите исходный баланс карты. Создайте заказ с одним простым товаром без размеров и модификаторов. Рассчитайте ожидаемые скидку и начисление по опубликованным условиям.
2. В заказе нажмите «Карта LazyCRM» и считайте QR карты. В открывшемся диалоге укажите 0 бонусов и сверьте расчёт.
3. Перейдите к оплате, выберите наличные для денежной суммы и нажмите «Оплатить LazyCRM».
4. Сохраните номер заказа и чек. Проверьте скидку и денежную сумму в чеке, затем обновите карту и сверьте начисление в LazyCRM.

Оплата бонусами

1. Если правила разрешают списание и на карте уже есть бонусы, создайте второй простой заказ.
2. Привяжите ту же карту, укажите разрешённую сумму бонусов и сверьте показанный денежный остаток.
3. Выберите наличные для остатка и нажмите «Оплатить LazyCRM».
4. Проверьте чек и баланс: прежний баланс минус списанные бонусы плюс новое начисление.

Полный возврат

1. В той же смене откройте последний проверочный закрытый заказ и нажмите «Полный возврат LazyCRM». Проверьте заказ и подтвердите возврат один раз. Если было два заказа, сначала верните второй, затем первый.
2. Проверьте чек возврата и выданные деньги: денежная сумма должна соответствовать оплате возвращаемого заказа. Скидка и бонусы не превращаются в дополнительную денежную выплату.
3. Сверьте карту: списанные бонусы возвращены, начисленные за этот заказ — отменены. После возврата обоих заказов баланс должен совпасть с исходным, если других операций не было.

Частичный возврат — дополнительная проверка

1. Создайте и оплатите заказ с двумя различными простыми товарами. Для этой проверки используйте наличные или наличные вместе с бонусами; у каждой возвращаемой строки должна быть положительная денежная часть.
2. Через «Частичный возврат LazyCRM» верните один товар. Проверьте количество, деньги и соответствующие обратные бонусные операции.
3. Оставшийся товар возвращайте той же кнопкой. Не сочетайте частичный возврат с последующим стандартным полным возвратом iiko.

Если результат неизвестен: не повторяйте выплату стандартной кнопкой iiko и не очищайте очередь. Сохраните номер заказа, чеки, время и сообщение на экране; обратитесь к ответственному смены или в поддержку LazyCRM.

Что учитывать при возвратах

Для самостоятельной первоначальной проверки используйте описанные простые заказы в текущей смене. Возвраты прошлых смен, составные товары и другие способы денежной оплаты требуют проверки соответствующего сценария для вашей кассы. Одинаковые позиции выбираются отдельно; плагин сохраняет возвращённое количество по каждой позиции.

3.4. При необходимости включите работу без связи с LazyCRM

На плагине 0.3.9 или новее откройте «Карта лояльности» → «Дизайн и уровни» → «Работа кассы без связи с LazyCRM». Включите режим, задайте срок офлайн-доступа и резерв бонусов на карту на одну кассу, сохраните. Перезапуск Front для этих настроек не нужен.

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

Неизвестная карта, истёкший срок или недостаточный резерв требуют связи либо оплаты без карты лояльности. Возвраты доступны по сохранённым на кассе продажам. После восстановления связи продажи и возвраты доставляются автоматически, без повторной денежной выплаты. Не удаляйте локальную очередь и настройки.

3.5. Откройте выдачу карт гостям

1. Убедитесь, что карта выдаётся, кассы проходят проверку, а оплата и возврат дают ожидаемые суммы и бонусные операции.
2. Проверьте, что выдача карт включена. При сообщении о неготовности устраните указанную причину с поддержкой.
3. Создайте ссылки и QR с понятными названиями для стойки, сайта и других мест размещения. При необходимости задайте точку.
4. Разместите QR и передайте кассирам порядок работы с картой, оплатой и возвратом.

4. Обновление плагина

Установщик добавляет источник обновлений LazyCRM. Для автоматической доставки нужен включённый и лицензированный iiko Updater. Существующий режим работы Updater сохраняется.

1. После первой установки специалист iiko проверяет, что Updater включён и источник LazyCRM добавлен. Если Updater отсутствует или выключен, обратитесь к своему специалисту iiko.
2. Оставляйте кассу включённой с работающим Front и доступом в интернет. В штатном автоматическом режиме обновление устанавливается при закрытой смене и заблокированной кассе. Согласуйте такое окно, чтобы оно не пересекалось с обслуживанием гостей.
3. Updater проверит источник и установит совместимую более новую версию. Подключение кассы, настройки и очередь операций сохраняются; получать новый код и создавать кассу повторно не нужно.
4. После обновления откройте Wallet → «Подключение» → «Кассы и точки», обновите список, проверьте сообщённую версию и нажмите «Проверить».
5. Если версия не изменилась или появилась ошибка, передайте поддержке название кассы, её версию и сообщение Updater. Повторная регистрация кассы для устранения ошибки обновления не требуется.

Результат: касса сообщает новую версию плагина и успешно проходит проверку подключения.