Что делает плагин
Одно касание на заказе
Кнопка «Nearily» на экране заказа: 4-значный код гостя, номер телефона или QR — и визит засчитан.
Награды применяются сами
Когда гостю положена награда, касса предложит её — бесплатный напиток или кэшбэк лягут в открытый заказ скидкой.
Настройки с сервера
Правила лояльности приходят из Nearily и обновляются сами — без визитов к кассе и перезапусков.
Установка
Четыре шага на кассе. Займёт минут пять.
Скачайте и распакуйте архив
Скачайте nearily-iiko-plugin.zip — внутри папка Nearily с плагином и короткой инструкцией.
Скопируйте папку в iikoFront
Всю папку Nearily целиком — в C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Nearily\. Путь может отличаться от установки к установке — важно, чтобы папка попала в Plugins вашего iikoFront.
Перезапустите iikoFront
Полностью закройте iikoFront и откройте снова — плагин загружается только при старте.
Проверьте кнопку
Откройте заказ — на экране заказа появится кнопка Nearily. Если настройки ещё не заполнены, кнопка сама подскажет, чего не хватает.
Настройка
Что делает владелец кофейни — один раз, вместе с Nearily.
Запросите доступ у Nearily
Напишите на hello@nearily.com или вашему менеджеру Nearily. Мы заведём кофейню на платформе и выдадим данные для кассы: идентификатор кофейни и секретный ключ (выдаётся один раз на кофейню).
Заполните config.json
В папке плагина переименуйте config.example.json в config.json и впишите два полученных значения — cafeId и sharedSecret. baseUrl менять не нужно.
Типы скидок в iikoOffice
В iikoOffice (Розничные продажи → Типы скидок и надбавок) нужны две записи, обе с галочкой «Применяется вручную»: фиксированная скидка для бесплатного напитка и скидка произвольной суммой для кэшбэка. GUID обеих пришлите нам — они настраиваются централизованно, в config.json их вписывать не нужно.
Остальное — автоматически
Правила лояльности и все прочие настройки плагин получает с сервера Nearily при запуске и обновляет на ходу. Изменения доезжают до кассы сами — без визитов и перезапусков.
Полезно знать
Живёт внутри iikoFront
Плагин работает прямо на кассе, в iikoFront 8.x. Без дополнительного оборудования и планшетов у стойки.
Нужен интернет
Кассе нужен доступ в интернет, чтобы связываться с Nearily. Настройки кэшируются, так что короткий сбой сети кнопку не ломает.
Кнопки нет?
Чаще всего: папка не там, config.json отсутствует или с опечаткой, iikoFront не перезапускали. Подробности — в логе iikoFront (Front.Net\Logs).
Обновляется сам
Плагин сам проверяет обновления и скачивает новую версию в фоне. Она включается при следующем запуске iikoFront — прерывать смену не нужно. Если касса работает неделями без перезапуска, в заголовке окна ввода появится подпись «обновление готово»: значит, файл уже на кассе и ждёт удобного момента.
Экран обновлений
Нажмите «Nearily» на экране заказа и введите 000000 на вкладке «Код или телефон». Плагин покажет текущую версию, скачанное обновление и предложит проверить обновления прямо сейчас. Коды гостей всегда 4-значные, так что спутать нельзя.
Поддержка
Что-то не получается — напишите на hello@nearily.com, поможем с установкой и настройкой.
Вопросы о плагине для iiko
Сколько стоит плагин?
Плагин скачивается бесплатно. Платформа Nearily бесплатна для кофеен и гостей до конца 2026 года. С 2027 года начинается коммерциализация: платная подписка для пользователей и тарифы для кофеен.
Какая версия iikoFront нужна?
Плагин работает прямо на кассе, в iikoFront 8.x.
Нужен ли кассе интернет?
Да: касса связывается с Nearily через интернет. Настройки кэшируются, так что короткий сбой сети кнопку не ломает.
Нужно ли дополнительное оборудование?
Нет. Плагин живёт внутри iikoFront — без планшетов и отдельных устройств у стойки.
Как гость получает штамп или кэшбэк?
Бариста нажимает кнопку «Nearily» на экране заказа и вводит 4-значный код гостя или номер телефона либо использует QR — визит засчитан. Когда гостю положена награда, касса предложит её, и она ляжет в заказ скидкой.
Как обновляется плагин?
Сам: он проверяет обновления и скачивает новую версию в фоне, а включается она при следующем запуске iikoFront.