‹

Штрих Помощник

Модуль логики «Штрих Помощник»

Модуль логики для работы Кассира 5 с Telegram-ботом «Штрих Помощник». Бот работает через веб-сервис (сервер бота), к которому подключаются кассы и в котором администратор регистрирует пользователей, склады и кассы. Функции на кассе:

подтверждение отсутствующего у кассира права запросом разрешения у администратора в Telegram — вместо чтения карты администратора; набор подтверждаемых прав и отправляемых данных настраивается;
отправка текстовых срочных оповещений администратору;
сбор и отправка оперативных показателей кассы по запросу из Telegram: текущий пользователь, время работы, количество и сумма чеков продажи и возврата, наличные в ящике, выручка (для платформы 1С 8.3.5 и выше).

Файл модуля — shtrih_helper.zip → shtrih_helper.epf в каталоге LogicalModules. В списке вкладки Модули логики отображается как Штрих Помощник.

Модуль подключается через Настройка → Касса → Мастер настройки → Выбор модулей логики (см. страницу «Способы подключения модулей логики»). После подключения и перезапуска Кассира 5 его настройки появляются на вкладке Настройка → Модули логики в списке слева.

Отключить модуль — если флаг установлен (значение по умолчанию), модуль не используется; снять для работы с сервисом.

Параметры сервиса

Адрес сервера — веб-адрес сервера бота, с указанием протокола и порта (например, http://192.168.0.10:3000).
Таймаут запросов, с — время ожидания ответа веб-сервиса в секундах; по умолчанию 15.
Идентификационный ключ — уникальный GUID доступа кассы к API сервиса. Выдаётся при регистрации кассы в панели администрирования сервера бота (поле Ключ на форме кассы). Кнопка × очищает поле.
Идентификационный номер — GUID аутентификации; касса создаёт его сама при первом обращении к сервису, поле недоступно для правки. В панели администрирования его можно сбросить кнопкой Очистить на форме кассы.
Интервал проверки статуса запроса: раз в … секунд — как часто касса опрашивает сервис о статусе отправленного запроса (разрешил ли администратор операцию); по умолчанию 1.
Разрешить отменять запросы при отсутствии связи — если установлен, кассир может прервать ожидание ответа администратора, когда связь с веб-сервисом не устанавливается; если снят — ожидание не прерывается.
Получать запросы состояния кассы и отвечать на них Помощнику (1С 8.3.5+) — если установлен, касса фоновым заданием получает из сервиса запросы оперативных показателей (команда бота /getOperationalIndicators) и отправляет в ответ данные; если снят — запросы показателей не обрабатываются.
Интервал получения запросов состояния и ответов на них: раз в … сек — период фонового задания получения запросов состояния и отправки ответов; по умолчанию 5.

Работа с правами

Подтверждать права через сервис — если установлен, при отсутствии права у пользователя касса запрашивает разрешение на операцию у администратора через бота; администратор получает сообщение с кнопками Разрешить / Запретить. Если снят — права подтверждаются как обычно (картой администратора).
Подтверждать все права — если установлен, разрешение запрашивается для любого отсутствующего права, даже если оно не входит в состав подтверждаемых; если снят — только для прав из списка.
Настроить состав подтверждаемых прав — кнопка открывает окно Настройка состава подтверждаемых прав (описано на отдельной странице).

Логировать работу модуля — если установлен, запросы к веб-сервису записываются в текстовые файлы (по одному на день); если снят — лог не ведётся.
Путь к каталогу логов — папка файлов лога; по умолчанию …\DB\ExtFiles\LogicalModules\shtrih_helper\. Логи модуля собирает также менеджер сбора логов: кнопка Логи в нижней части окна Настройка.
Загрузить предустановки — кнопка загружает в справочники и регистры данные, нужные модулю; нажать после первого подключения.

Порядок настройки

Создать Telegram-бота через @BotFather и получить токен.
Установить сервер бота (Node JS 14.17.6 LTS, СУБД SQLite или PostgreSQL), указать токен в файле .env и запустить сервер; сервер должен быть доступен по сети всем кассам и иметь выход к серверам Telegram.
В панели администрирования (конфигурация AdminPanel1C) зарегистрировать пользователей-менеджеров с правами Обработка запросов с касс и Получение оперативных показателей кассы, создать склады и кассы, привязать менеджеров к кассам; скопировать Ключ кассы.
В Кассире 5 подключить модуль, указать Адрес сервера и Идентификационный ключ, нажать Загрузить предустановки.
Включить Подтверждать права через сервис и настроить состав подтверждаемых прав.
Снять флаг Отключить модуль, нажать ОК.

Пользователи сервера связываются с пользователями Кассира 5 по полю Внешний ИД — коду элемента справочника Пользователи.

Для программистов

При запросе подтверждения права записывается транзакция с типом 220.

См. также: