Плагины: скачать локальный агент заведения

Некоторые возможности WellCa работают не только через облако, но и напрямую с компьютера заведения: касса iikoFront в реальном времени, обмен с ЕГАИС через УТМ, отправка кодов в «Честный ЗНАК». Всё это обслуживает одна небольшая программа — локальный агент WellCa. Раздел «Плагины» — общее место, откуда её можно скачать и установить.

Где найти

Настройки → Плагины.

Раздел появляется, только если заведению нужен агент хотя бы для одного модуля: работа на iiko, подключённый ЕГАИС или Маркировка. Если ничего из этого в тарифе нет — агент не нужен, и раздел не показывается.

Раньше агент скачивался внутри раздела ЕГАИС. Теперь это общая точка в настройках — она доступна и тем, у кого нет доступа к разделам POS/ЕГАИС/Маркировки.

Кому открыть раздел

В правах доступа у раздела своя строка — «Плагины и агент кассы» (Настройки → Права

доступа). Её достаточно, чтобы скачать установщик, переустановить агента и посмотреть

статус кассы.

Раньше раздел открывался общим правом на настройки, а вместе с ним человек получал

«Оплату» и «Подписку и модули». Из-за этого плагин обычно ставили из-под владельца.

Теперь право можно выдать управляющему отдельно — реквизиты и тариф останутся закрытыми.

Тем, у кого доступ к настройкам уже был, ничего выдавать заново не нужно: право на

плагины они получили автоматически.

Статус агента

Вверху — карточка «Агент связи»:

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

Скачать установщик

В блоке «Установка на ПК заведения» отметьте нужные модули — показываются только те, что доступны по тарифу:

• Плагин iikoFront — реалтайм, контроль операций, брони (для заведений на iiko);
• ЕГАИС — приём алкогольных накладных через УТМ;
• Маркировка — обмен с «Честным ЗНАКом».

Нажмите «Скачать установщик» — соберётся архив wellca-installer.zip, токен уже вшит внутрь. На компьютере заведения распакуйте архив и запустите «Установить.bat» (двойной клик — Windows сам попросит права администратора).

Дальше вмешиваться не нужно: вопросов установщик не задаёт, открытую кассу не закрывает. Программа ставится в постоянную папку C:\WellCa\agent, прописывается в автозапуск (поднимается при включении компьютера, даже если в Windows никто не вошёл) и подключается к облаку.

В конце установщик сам проверяет результат и пишет одно из двух:

• ГОТОВО. Касса подключена: <название заведения> — всё работает. Сверьте название: если там чужое заведение, значит скачан установщик не той организации.
• УСТАНОВКА НЕ ЗАВЕРШЕНА — и конкретная причина: не запустилась программа, нет доступа в интернет или токен не совпадает с выпущенным в админке.

Через минуту статус выше станет «На связи».

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

Частые вопросы

Нужен ли публичный адрес/белый IP? Нет. Агент сам подключается к облаку — открывать порты на компьютере не требуется.

У меня только CRM и лояльность — где мой раздел «Плагины»? Если заведению не нужен локальный агент (нет iiko, ЕГАИС и Маркировки), раздел не показывается — это нормально.

Тот же установщик есть в «Интеграции → POS-система», рядом с подключением кассы и плагином iikoFront. Да, это одна и та же кнопка — можно качать откуда удобнее.

Дальше

• Плагин кассы iikoFront — что даёт плагин и как читать статусы «Касса/Облако».
• Смена тарифа — какие модули включены в вашем тарифе.

Если статус не стал «На связи»

Сначала посмотрите, что написал установщик в конце — он называет причину сам. Что делать дальше:

• «Облако отклонило токен» — токен на компьютере не совпадает с выпущенным в админке. Так бывает, если установщик качали дважды: каждое скачивание выпускает новый токен и гасит прежний. Скачайте установщик заново и поставьте поверх — переустановка безопасна, старая копия гасится автоматически.
• «Агент не отвечает» — программа не запустилась. Чаще всего на компьютере нет Node и не было интернета в момент установки. Повторите установку при работающем интернете.
• «Нет связи с облаком» — компьютер заведения не достучался до WellCa: проверьте интернет и, если сеть закрыта, разрешите исходящие соединения к адресу вашего кабинета.

Проверить состояние в любой момент можно на самом компьютере:

```

powershell -ExecutionPolicy Bypass -File "C:\WellCa\agent\verify-install.ps1" -AgentDir "C:\WellCa\agent"

```

Подробный лог программы — C:\WellCa\agent\agent.log; именно его стоит приложить к обращению в поддержку.

Папку C:\WellCa не переносите и не удаляйте: на неё настроен автозапуск.

Другая касса

Работаете на R-Keeper — доступы к нему запрашиваются отдельно: что запросить у поставщика.

Электронная подпись для СБИС

Чтобы принимать накладные прямо из WellCa, выберите существующий компьютер и переустановите агент с модулем «Электронная подпись». Рутокен и PIN остаются на компьютере заведения.

[Настроить электронную подпись]

Полная инструкция: Как настроить импорт накладных и чеков.