Инструменты пользователя

Инструменты сайта


кассир5:всевнешниемодули:штрихпомощник

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

Функциональность в Кассир 5:

  1. Подтверждение отсутствующих прав пользователя запросом разрешения выполнения операции у администратора с настройкой набора прав и отправляемых данных
  2. Отправка текстовых оповещений администратору
  3. Сбор и отправка показателей кассы администратору: текущего пользователя, время работы, кол-во и сумму чеков продажи, кол-во и сумму чеков возврата, наличных в ящике, выручку (для 1С 8.3.5+)


Данный модуль взаимодействует с веб-сервисом, в котором выполняется настройка для работы с телеграм-ботом.
Подробная инструкция по установке и настройке веб-сервиса доступна по ссылке.

Настройка

Перед началом работы

Для взаимодействия с телеграм-ботом необходимо установить и настроить веб-сервис, который будет выполнять взаимодействие с телеграм-ботом.
После того, как телеграм-бот создан и веб-сервис установлен и настроен, необходимо подключить и настроить модуль логики shtrih_helper.

Для возможности работы с Штрих Помощник требуется разархивировать обработку в каталоге «БД Кассир5\ExtFiles\LogicalModules\shtrih_helper.zip».
Это можно сделать вручную или выбрать модуль при установке/обновлении конфигурации Кассир 5 или выбрать через Мастер настройки.

Основные

Настройки работы с сервисом выполняются в настройках Кассир 5, на закладке «Модули логики»-«Штрих Помощник».
«Отключить модуль» - флаг нужно снять для включения работы с сервисом.
«Логировать работу модуля» - опция, позволяющая включить запись актуальной информации запросов в веб-сервис в виде текстовых файлов.
«Путь к каталогу логов» - путь к папке хранения текстовых файлов с данными запросов. Файлы хранятся в разрезе дней. По умолчанию БД Кассир5\ExtFiles\LogicalModules\shtrih_helper\
«Загрузить предустановки» - кнопка, загружающая нужные модулю данные в справочники и регистры.

Группа "Параметры сервиса"

Адрес сервера - веб-адрес сервиса.
Таймаут запросов, с - время в секундах, в течение которого будет ожидаться ответ от веб-сервиса. По умолчанию 15.
Идентификационный ключ - уникальный GUID для получения доступа к API сервиса. Выдается при регистрации кассы в сервисе.
Идентификационный номер - неуникальный GUID для доступа к API сервиса. Создается кассой один раз при начале работы с сервисом.
Интервал проверки статуса запроса - время в секундах, раз в которое будет проверяться статус последнего запроса в веб-сервисе. По умолчанию 1.
Разрешить отменять запросы при отсутствии связи - опция, позволяющая отменить ожидание ответа администратора на запрос, если не удается установить связь с веб-сервисом.
Получать запросы состояния кассы и отвечать на них Помощнику (1С 8.3.5+) - опция, позволяющая запрашивать актуальные запросы состояния кассы из веб-сервиса, и отправлять в ответ необходимые данные.
Интервал получения запросов состояния и ответов на них - время в секундах, раз в которое будет начинаться фоновое задание на получение запросов состояния кассы, а если такие запросы уже были получены - фоновое задание на отправку необходимых данных. По умолчанию 5.

Группа "Работа с правами"

Подтверждать права через сервис - опция, позволяющая при отсутствии права у пользователя запросить разрешение на проведение операции у администратора. Заменяет чтение карты администратора.
Подтверждать все права - опция, позволяющая запрашивать разрешение на проведение операции у администратора даже при условии, если подтверждаемое право отсутствует в составе подтверждаемых прав.
Настроить состав подтверждаемых прав - кнопка, открывающая форму настройки списка подтверждаемых прав.

Настройка состава подтверждаемых прав

Подтверждаемые права - таблица, строки которых являются подтверждаемыми в сервисе правами. Право - имя права в справочнике «Права пользователей». Наименование права - наименование, которое отобразится администратору в телеграме при получении им запроса на подтверждение.
Отправляемые поля - таблица, строки которых являются данными, отправляемыми в запросе подтверждения права. Каждое право имеет свой набор отправляемых полей. Значение поля - отправляемое значение параметра чека. Наименование поля - отправляемое наименование параметра чека.

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

Транзакции операций

При запросе подтверждения права записывается транзакция с типом 220
Описание формата транзакций Кассир 5

кассир5/всевнешниемодули/штрихпомощник.txt · Последнее изменение: 2023/07/19 13:02 — dzayonchkovskiy