https://crystals.atlassian.net/browse/SRTF-293

https://crystals.atlassian.net/browse/CR-13439

10.4.14.0

https://crystals.atlassian.net/browse/SRTF-310

https://crystals.atlassian.net/browse/CR-13600

10.4.15.0

https://crystals.atlassian.net/browse/SRTF-404

https://crystals.atlassian.net/browse/CR-14087

https://crystals.atlassian.net/browse/SRTF-424

https://crystals.atlassian.net/browse/CR-14501

10.4.19.0

https://crystals.atlassian.net/browse/SRTF-496

https://crystals.atlassian.net/browse/CR-14796

10.4.23.0

https://crystals.atlassian.net/browse/SRTF-526

https://crystals.atlassian.net/browse/CR-14239

10.4.24.0

1 Описание
2 Ценность
3 Пример работы успешного сценария
4 Пример работы отрицательного сценария
5 Ограничения
6 Настройка
7 Статьи по теме

Описание

Некоторые торговые сети устанавливают на более дорогие товары магнитные “антикражные” бирки. С версии 10.4.14.0 для КСО SetSCO v.3 добавлена возможность активация магнитного съемника для бирок.

Функциональность была доработана в версии 10.4.19.0: для удобства покупателей после завершения покупки отображается видео со звуком с инструкцией, например, по снятию магнитного съемника.

В версии 10.4.23.0 функциональность была доработана: добавлена возможность включать и выключать магнитный съёмник с помощью кнопки в меню консультанта, также был изменен процесс настройки и подключения устройства.

В версии 10.4.24.0 реализована возможность активации магнитного съемника по признаку товара. Теперь для каждого товара может быть установлен специальный признак — оснащён антикражной меткой. Это позволяет корректно активировать съёмник даже для товаров, которые были уценены и не соответствуют пороговой стоимости, но по-прежнему имеют антикражную бирку.

Ценность

Автоматическая активация магнитного съемника позволит упростить работу покупателя с КСО, так как пропадет необходимость вызывать на кассу консультанта для снятия бирки. Также функциональность позволит снять нагрузку с консультанта острова самообслуживания.

Пример работы успешного сценария

Основной сценарий. Покупатель снимает магнитную бирку самостоятельно

Если покупатель не успел\не захотел самостоятельно снять бирки, то он может воспользоваться помощью сотрудников через кнопку Вызвать консультанта. Подробности об этом сценарии в главе.

минимальная стоимость товара для активации съёмника = 5000;
Период активности магнитного съёмника для каждого товара, в десятках секунд = 3;
При активации показать инструкцию для пользователя на экране "Спасибо за покупку".

Покупатель приносит на КСО товар стоимостью 5500 руб., товар оснащён антикражной биркой.
Покупатель добавляет товар в чек → покупатель нажимает Перейти к оплате.

КСО переходит на экран выбора типов оплат → покупатель закрывает чек любым доступным способом.

Чек оплачен и фискализируется → КСО считает время активации съемника:
- количество товаров в чеке, цена которых превышает значение настройки Активация магнитного съемника по стоимости товара в чеке (для КСО без КВП) х значение настройки Время активации (в секундах). Округление выполняется в большую строну до ближайшего значения кратного 10 сек.

КСО отправляет команду “активировать съемник на рассчитанное время”.
На экране отображается видеоинструкция по снятию магнитной бирки (на скриншоте пример срабатывания проигрывания видео при необходимости снять антикражную бирку).

Обратите внимание, по умолчанию инструкция не загружена на КСО, поэтому даже при включенной настройке в шаблоне кассы будет воспроизводится дефолтный экран Спасибо за покупку.

Для отображения инструкции требуется включить соответствующую настройку в шаблоне кассы на сервере и загрузить инструкцию на кассу. Подробности в главе https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/5073305621/SetRetail+SCO+v.3#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B2%D0%B8%D0%B4%D0%B5%D0%BE%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D0%B8.

Покупатель снимает антикражную бирку → процесс продажи завершён

Автоактивация съёмника по признаку товара

Активация магнитного съемника по признаку товара;
Минимальная сумма товара для активации съёмника=100;
Период активности магнитного съёмника для каждого товара, в десятках секунд=3;
В карточке товара указан признак key="SecurityTag" value="true".

Покупатель приносит на КСО товар, оснащённый антикражной биркой вне зависимости от его текущей стоимости.
В карточке товара установлен признак key="SecurityTag" value="true".
Покупатель добавляет товара в чек → покупатель переходит к оплате и закрывает чек любым доступным способом.
После оплаты чека КСО определяет наличие товаров с признаком антикражной метки.
Магнитный съёмник активируется на время, заданное в настройке Период активности магнитного съёмника для каждого товара.
На экране отображается видеоинструкция по снятию бирки → покупатель снимает бирку с товара.
Если в чеке есть товары, подходящие под оба условия (по стоимости и по признаку), время активации не суммируется — используется максимальное из рассчитанных значений.

Активация съёмника в режиме консультанта

Покупатель отказался снимать магнитную бирку самостоятельно → покупатель нажимает Вызвать консультанта.
Консультант подходит к КСО и авторизуется сканированием бейджа.
Консультант нажимает Активировать антикражное устройство → магнитный съёмник активирован.
Консультант снимает антикражные бирки.
Консультант выходит из режима консультанта -> устройство автоматически деактивируется.

Пример работы отрицательного сценария

минимальная стоимость товара для активации съёмника = 5000;

Покупатель приносит на КСО товар стоимостью 4999 руб., товар НЕ оснащён антикражной биркой.
Покупатель добавляет товар в чек → покупатель нажимает Перейти к оплате.
КСО переходит на экран выбора типов оплат → покупатель закрывает чек любым доступным способом.
Магнитный съёмник не активируется, т.к. сумма товара меньше 5000 руб.
На товаре отсутствует бирка, съём не требуется → процесс продажи завершён

Ограничения

На данный момент функциональность доступна только для касс самообслуживания на базе SetSCO v.3 без КВП.
Если к КСО подключена КВП (контрольно-весовая платформа), тогда видео с инструкцией НЕ воспроизводится.
Если на кассе отсутствует видео removeTag, тогда при закрытии чека воспроизводится стандартный экран Спасибо за покупку.
Инструкции могут быть только в видео формате.
Время активности магнитного съёмника не зависит от количества товаров в чеке, с которых требуется снять метку. Т. е. если для настройки Период активности магнитного съёмника для каждого товара, в десятках секунд на сервере задано значение = 3 (30 секунд), тогда съёмник будет активен всего 30 секунд после фискализации чека, даже если в чеке 10 товаров, с которых требуется снять метку. Значение настройки не умножается на количество товаров в чеке.
Признак антикражной метки (key="SecurityTag" value="true") должен быть корректно загружен для каждого товара через механизм импорта дополнительных свойств. Подробности в статье https://crystals.atlassian.net/wiki/spaces/INT/pages/1646280/ERP+SetRetail10#%D0%9F%D1%80%D0%B8%D0%B7%D0%BD%D0%B0%D0%BA-%D0%BD%D0%B0%D0%BB%D0%B8%D1%87%D0%B8%D1%8F-%D0%B0%D0%BD%D1%82%D0%B8%D0%BA%D1%80%D0%B0%D0%B6%D0%BD%D0%BE%D0%B9-%D0%BC%D0%B5%D1%82%D0%BA%D0%B8-SecurityTag.
Если признак не установлен или отсутствует в карточке товара, тогда активация по признаку не производится.
При одновременном использовании настройки по минимальной стоимости товара и по признаку, время активации магнитного съёмника не суммируется.
Передача признака осуществляется с помощью метода HTTP POST на сервер по адресу http://IP-адрес сервера:8090/SET-ERPIntegration/SET/WSGoodsCatalogImport с использованием XML-файла, закодированного в Base64.

Настройка

Описание магнитного съёмника

Съёмник антикражных бирок для КСО

Пример установки магнитного съёмника под столешницу

Комплектующие

съемник противокражных меток - 1 шт.;
кабель RJ45/USB-A 2 м - 1 шт.

Место установки

Установка магнитного съёмника возможна под столешницу или на столешницу.

Электромагнит устанавливается в столешницу в заранее подготовленное отверстие диаметром 72 мм. Питание устройство получает через интерфейсный usb-кабель, подключенный в свободный разъем USB на системном блоке КСО.

Пример установки съёмника под столешницу

Настройка на кассе

Также для настройки магнитного съёмника на кассе может быть использован инструмент .

Скрипт для автоматической настройки включает следующие шаги:

маппинг портов;
добавление новой настройки в базу данных;
включение использования денежного ящика (для более ранних версий).

Установка магнитного съемника

Откройте корпус КСО → подключите магнитный съёмник в свободный USB-порт.
Включите съёмник → рядом с портом устройства, слева, загорится зеленый индикатор.

Прошивка устройства

Отключите питание устройства.
С помощью скрепки зажмите кнопку сброса на устройстве (отверстие расположено слева от разъёма).

Внимание!

Не отжимайте кнопку при выполнении шагов со 2 по 5.

Подключите питание к устройству.
Скачайте актуальную прошивку устройства https://disk.360.yandex.ru/d/lUJjNslidu1ccQ.

На момент выхода версии 10.4.23.0 актуальная прошивка – gd_magnetic_lock_v7.hex.

С помощью команды ниже загрузите прошивку на устройство: адрес в конец

stm32flash. -v -b 115200 -w <полный путь к .hex файлу> <адрес устройства>

Пример команды:

stm32flash.exe -v -b 115200 -w "gd_magnetic_lock_v6.hex" COM5

Отожмите скрепку → обесточьте устройство.
Подключите устройство к питанию.

Маппинг портов

Так как устройство подключается к КСО вручную, то необходимо выполнить маппинг портов на кассе.

Откройте файл /etc/udev/rules.d/99-sco.rules для редактирования.

Добавьте в файл информацию ниже → сохраните изменения.

# Съемник аникражных бирок
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="7522", KERNEL=="ttyUSB[0-9]*", SYMLINK+="tagRemover"

Выполните команды.

sudo udevadm control --reload-rules.
sudo udevadm trigger

На кассе в папке /dev/ обнаружится устройство tagRemover.
Выполните скрипт ниже на кассе в базе данных catalog в таблице sales_management_properties для добавления порта.

INSERT INTO public.sales_management_properties
(module_name, plugin_name, property_key, property_value, description, transport_level, priority, send_status)
VALUES ('TAG_REMOVER',NULL,'settings','{"provider":"iTagRemover", "port": "/dev/tagRemover"}',NULL,NULL,NULL,NULL);

Перезагрузите кассу.

Логирование событий

Для включения логирования событий подключитесь к кассе и откройте для редактирования файл /home/tc/storage/crystal-cash/modules/loader/log4j.xml.

В блок <Loggers> вставьте секцию ниже → сохраните изменения в файле.

<Logger name="ru.crystals.pos.tag.remover.impl.itag" level="debug">
  <AppenderRef ref="file-root"/>
</Logger>

Перезагрузите кассу.

Пример логирования

Пример лог-файла с начала чека до закрытия (все события задваиваются):

В начале чека съемник деактивируется.
В конце чека съемник активируется с таймером на 3х10 секунд (триггер - товар в чеке с ценой более, чем задана в настройке). Съемник по истечении 30 секунд деактивируется автоматически без дополнительной команды.
После активации или деактивации идут опросы статуса устройства без изменения его состояния.

tc@box:~/storage/crystal-cash/logs$ grep '\[ITagRemoverClient\]' ./root.log | uniq
20.02 12:03:04.179 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=LOWER, holdTime=null) | #29 deactivating tag remover@dd03bc
20.02 12:03:04.285 DEBUG [ITagRemoverClient] Request sent, reading... | #29 deactivating tag remover@dd03bc
20.02 12:03:33.061 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=RAISE, holdTime=PT3S) | #29 activating tag remover@1640e3b
20.02 12:03:33.163 DEBUG [ITagRemoverClient] Request sent, reading... | #29 activating tag remover@1640e3b
20.02 12:03:33.664 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=DO_NOT_CHANGE, holdTime=null) | #29 activating tag remover@1640e3b
20.02 12:03:33.764 DEBUG [ITagRemoverClient] Request sent, reading... | #29 activating tag remover@1640e3b
20.02 12:03:34.264 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=DO_NOT_CHANGE, holdTime=null) | #29 activating tag remover@1640e3b
20.02 12:03:34.365 DEBUG [ITagRemoverClient] Request sent, reading... | #29 activating tag remover@1640e3b
20.02 12:03:34.865 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=DO_NOT_CHANGE, holdTime=null) | #29 activating tag remover@1640e3b
20.02 12:03:34.965 DEBUG [ITagRemoverClient] Request sent, reading... | #29 activating tag remover@1640e3b
20.02 12:03:35.466 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=DO_NOT_CHANGE, holdTime=null) | #29 activating tag remover@1640e3b
20.02 12:03:35.566 DEBUG [ITagRemoverClient] Request sent, reading... | #29 activating tag remover@1640e3b
20.02 12:03:36.066 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=DO_NOT_CHANGE, holdTime=null) | #29 activating tag remover@1640e3b
20.02 12:03:36.166 DEBUG [ITagRemoverClient] Request sent, reading... | #29 activating tag remover@1640e3b
20.02 12:03:36.667 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=DO_NOT_CHANGE, holdTime=null) | #29 activating tag remover@1640e3b
20.02 12:03:36.767 DEBUG [ITagRemoverClient] Request sent, reading... | #29 activating tag remover@1640e3b
20.02 12:03:37.267 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=DO_NOT_CHANGE, holdTime=null) | #29 activating tag remover@1640e3b
20.02 12:03:37.367 DEBUG [ITagRemoverClient] Request sent, reading... | #29 activating tag remover@1640e3b
20.02 12:03:37.868 DEBUG [ITagRemoverClient] Preparing to send request ITagRequest(magnetStatus=DO_NOT_CHANGE, holdTime=null) | #29 activating tag remover@1640e3b
20.02 12:03:37.968 DEBUG [ITagRemoverClient] Request sent, reading... | #29 activating tag remover@1640e3b

Настройка на кассе (до версии 10.4.23.0)

Эта глава актуальна только при настройке старой модели съёмника до обновления на версию 10.4.23.0.

Подключитесь к кассе → откройте для редактирования файл /home/tc/storage/crystal-cash/config/register-modules.xml.

В файле найдите блок cashDrawer → установите для него значение true → кликните F2 для сохранения изменений в файле.

Откройте для редактирования файл /home/tc/storage/crystal-cash/config/modules/cashDrawer-config.xml.

В файле для параметра property key="provider" укажите value="viaFiscalPrinter" → кликните F2 для сохранения изменений в файле.

Перезагрузите кассу.

Настройки на сервере

Войдите на сервер SetCentrum/SetRetail10 → перейдите в раздел Кассовый модуль → вкладка Шаблоны касс → выберите шаблон кассы самообслуживания SCO_3 → кликните на шаблон дважды для редактирования.

В шаблоне кассы перейдите в раздел ПРОЦЕСС ТОРГОВЛИ → вкладка НАСТРОЙКИ → меню Дополнительные настройки → включите требуемые настройки:
1. Активация магнитного съёмника по стоимости товара в чеке (для КСО без КВП) – магнитный съёмник будет активироваться автоматически в случае, если выполняется условие минимальный стоимости товара;
2. Активация магнитного съёмника по признаку товара – магнитный съёмник будет активироваться автоматически при наличии у товара признака key="SecurityTag" value="true" (товар оснащён магнитной меткой);
3. В поле ниже задайте значение для параметра Минимальная стоимость товара для активации съёмника, например, 2000 → задайте значение для поля Период активности магнитного съёмника для каждого товара, в десятках секунд, например, 3 = 30 секунд.

→ кликните СОХРАНИТЬ.

Обратите внимание, настройка Период активности магнитного съёмника для каждого товара, в десятках секунд в шаблоне кассы появится только после обновления сервера и кассы до версии 10.4.23.0, а настройка Активация магнитного съёмника по признаку товара – после обновления сервера и кассы до версии 10.4.24.0.

Перейдите в раздел ИНТЕРФЕЙС → кликните НАСТРОЙКА МЕНЮ КОНСУЛЬТАНТА.

С версии 10.4.23.0 доступна функциональность активации магнитного съёмника по нажатию кнопки в меню консультанта. При обновлении версии кассового ПО кнопка не появится автоматически, добавьте ее вручную в шаблоне кассы на сервере, как указано в шагах ниже.

На требуемой вкладке кликните на свободное место для кнопки.

Выберите Действие для типа кнопки → в поле Функция кассы введите Активировать антикражное устройство → поле Название кнопки заполнится автоматически → кликните ПРИМЕНИТЬ.

Кликните ПРИМЕНИТЬ.

Кликните СОХРАНИТЬ.

Диагностика магнитного съёмника

Инструмент используется для диагностики работы устройства (магнитного съёмника) на ОС Linux. Также доступна утилита для диагностики работы устройства на ОС Windows .

Скачайте утилиту на кассу в папку /home/tc/storage.
Сделайте файл исполняемым.
Запустите утилиту.

Настройка видеоинструкции

Требования для видео

Название файла	removeTag

Название файла	removeTag
Поддерживаемые форматы	mp4, m4v, m4p, webm, ogv, ogg, mkv;
Разрешение видео	1080 х 1920 px (видео полностью перекрывает экран);

Правила проигрывания видеоинструкции

Если длительность показа экрана Спасибо за покупку больше, чем длительность видео, тогда инструкция проигрывается по кругу, пока показывается экран.
Если длительность показа экрана Спасибо за покупку меньше, чем длительность видео, тогда инструкция проигрывается полностью один раз, после чего экран Спасибо за покупку закрывается.
Если во время проигрывания видеоинструкции коснуться экрана, тогда видео прервется, экран Спасибо за покупку закроется.

Включение и настройка длительности проигрывания видеоинструкции

Включите настройку включено на сервере.png При активации показать инструкцию для пользователя на экране "Спасибо за покупку" → в поле ниже введите требуемое время показа экрана “Спасибо за покупку” с инструкцией в секундах, например, 60 → кликните Сохранить.

Загрузка видеоконтента на КСО

Инструкция по загрузке видеоконтента с помощью сервиса SetSync, а также локально на КСО и требования для видео в статье https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/5126488065 в главе https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/5126488065/SetRetail+SCO+v.3+SetSync#%D0%97%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0-%D0%BC%D0%B5%D0%B4%D0%B8%D0%B0%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BD%D1%82%D0%B0-%D0%B4%D0%BB%D1%8F-%D0%BA%D0%B0%D1%81%D1%82%D0%BE%D0%BC%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8-%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81%D0%B0.

SetRetail SCO v.3◾Активация магнитного съемника