Публичное пространство
SetRetail SCO v.3◾Работа с RFID-считывателем через UPOS
https://crystals.atlassian.net/browse/SRTG-138
https://crystals.atlassian.net/browse/CR-13906
10.4.18.0
https://crystals.atlassian.net/browse/SRTB-10038
https://crystals.atlassian.net/browse/CR-14574
10.4.21.0
Описание
В некоторых торговых сетях используются RFID-метки для идентификации товаров на кассе. Каждая RFID-метка кроме штрих-кода имеет свой уникальный номер. После продажи (возврата) товара необходимо передавать информацию о метках в сервис RFID, чтобы антикражные ворота, которые интегрированы с этим сервисом, выпустили добросовестного покупателя и не привлекали внимание охраны.
Начиная с версии 10.4.18.0 возможно использование RFID-считывателей на кассах самообслуживания SetSCO v.3.
В версии 10.4.21.0 реализована интеграция для КСО с с RFID-ридером Keonn AdvanReader-70.
Ценность
Доработка позволит ускорить обслуживание покупателей на кассах самообслуживания.
Пример работы
После подключения и настройки RFID-считывателя на экране КСО появится иконка, отображающая статус считывателя в данный момент.
В зависимости от состояния сканера цвет иконки будет меняться:
Зеленая - RFID-ридер активирован, готов к считыванию меток;
Красная - RFID-ридер подключен, но не активирован;
Серая - RFID-ридер не инициализирован, т. е подключен на сервере как оборудование, но касса не смогла установить с ним корректную связь.
Если на сервере RFID-ридер не подключен как оборудование, то RFID-кнопка-иконка не отображается на панели кнопок кассы.
Работа покупателя с RFID-считывателем
КСО находится в режиме ожидания покупателя → RFID считыватель не активирован (редко моргает лампочка com).
Покупатель подходит к КСО и касается экрана → КСО переходит на экран добавления товаров → RFID-считыватель активировался (быстро мигает лампочка com) → цвет иконки на экране кассы - Зеленый.
Покупатель сканирует RFID-метку на товаре → RFID-считыватель издал звуковой сигнал → товар добавлен в чек.
Покупатель нажимает Перейти к оплате → КСО переходит на экран выбора типов оплаты → покупатель закрывает чек любым доступным способом.
Чек завершен → RFID-сканер деактивирован.
Ограничения
У считывателей ограниченный ресурс работы, поэтому подключенный RFID-сканер должен активен только тогда, когда покупатель может добавлять товар в чек
Устройство всегда считывает RFID-метки, если оно включено.
RFID-метки интегрированы с воротами на выходе из магазина. Считанные RFID-метки после регистрации чека отправляются на сервер и деактивируются, чтобы для покупателя сработала сигнализация на воротах при выходе из магазина. При этом кроме считанных через RFID, отправляются и те что были считаны ручным (или встроенным) сканером.
Одну RFID-метку нельзя добавить в чек больше 1 раза, при этом если удалить марку из чека, ее можно добавить еще раз (аналогично, например, алкоголю).
Настройка
Настройка и подключение RFID-сканера
Перед настройкой функциональности убедитесь, что на КСО установлен актуальный модуль службы UPOS.
Если служба отсутствует, тогда скачайте установщик и загрузите на кассу в директорию /home/tc/storage/3rd-party.
Запустите установку командами ниже:
cd /home/tc/sorage/3rd-party
sh upos-4.3.10_install.runАктивируйте службу командой:
sudo systemctl enable cashtill-uposОбратите внимание, при отключении RFID-сканера требуется также отключить службу UPOS. После отключения выполните на кассе команды ниже.
sudo systemctl stop cashtill-upos
sudo systemctl disable cashtill-uposОткройте корпус КСО и подключите RFID-сканер в свободный USB-разъем на кассе.
Подключитесь к КСО → перейдите в папку /home/tc/storage/crystal-cash/config → откройте для редактирования файл register-modules.xml.
Включите модуль RFID → сохраните изменения.
Перейдите в папку /home/tc/storage/crystal-cash/config/modules → откройте для редактирования файл rfidScanner-config.xml.
Для параметра
property key="comPort"укажите порт, в который подключен считыватель → для параметраproperty key="servicePath"укажите директорию, в которую загружена служба UPOS → сохраните изменения.
Перезагрузите кассу.
cash restartНастройка RFID-ридера Keonn AdvanReader-70 для подключения к SetRetail10
Для сканера также требуется включить использование RFID-считывателя в конфигурационном файле, как указано в главе https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/5255462996/SetRetail+SCO+v.3+RFID-+UPOS#%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B8-%D0%BF%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-RFID-%D1%81%D0%BA%D0%B0%D0%BD%D0%B5%D1%80%D0%B0 в п. 2 и 3.
Подключение к устройству
Откройте корпус КСО и подключите RFID-ридер Keonn AdvanReader-70 в свободный USB-разъем на кассе.
Выполните настройку статического IP-адреса для считывателя, как указано в руководстве .
В браузере перейдите по адресу http://статический IP-адрес считывателя, например, http://192.168.7.2.
Откроется страница считывателя → перейдите в раздел CONFIGURATION -> вкладка Services → меню AdvanNetRestService → используйте для входа следующие учетные данные:
Логин (username): admin
Пароль (password): admin
Настройка сетевых параметров
Для изменения IP-адреса считывателя перейдите на вкладку Network & Time → введите новый требуемый IP-адрес → кликните Save.
Настройка рабочих параметров
Перейдите на вкладку RFID → установите параметры, как указано в таблице ниже → кликните Save.
Параметр | Значение |
Region | Выберите требуемый регион |
Power (dBm) | 17.0 |
Sensitivity (dBm) | -61.0 |
Write power (dBm) | 27.0 |
Session | S1 |
Target | A |
Проверка работы антенн
Перейдите в раздел HOME → вкладка Monitor.
Положите RFID-метку на антенну.
Кликните на кнопку RF is OFF → надпись изменится на RF is ON → цвет кнопки изменится на зеленый → антенны активированы.
Наблюдайте список меток: в столбце Port указан номер антенны, считывающей метку.
Настройка считывателя в базе данных
Для включения использования считывателя Keonn AdvanReader-70 выполните скрипт ниже на кассе в базе данных
catalog в таблице
sales_management_properties.
UPDATE sales_management_properties
SET property_value='ADVAN_READER', send_status=0
WHERE module_name='RFID' and property_key='provider';Для настройки номера магазина и касс, на которых используется считыватель, выполните следующие скрипт ниже на кассе в базе данных
catalog в таблице
sales_management_properties.
UPDATE sales_management_properties
SET property_value='{
"rfidInShop": [
{
"shop": 8241,
"cashes": [
{
"cash": 82,
"rfidReader": "http://IP-адрес_считывателя"
}
]
}
]
}', send_status=0
WHERE module_name='RFID' and plugin_name='ADVAN_READER' and property_key='devices.addresses';Перезагрузите кассу.
Статьи по теме
https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/3377004621
https://crystals.atlassian.net/wiki/spaces/SR10SUPPORT/pages/4536074377