SetRetail SCO v.3◾Работа с RFID-считывателем через UPOS

Публичное пространство

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-кнопка-иконка не отображается на панели кнопок кассы.

image-20250815-134348.png
image-20250815-134500.png

 

Работа покупателя с RFID-считывателем

  1. КСО находится в режиме ожидания покупателя → RFID считыватель не активирован (редко моргает лампочка com).

  2. Покупатель подходит к КСО и касается экрана → КСО переходит на экран добавления товаров → RFID-считыватель активировался (быстро мигает лампочка com) → цвет иконки на экране кассы - Зеленый.

  3. Покупатель сканирует RFID-метку на товаре → RFID-считыватель издал звуковой сигнал → товар добавлен в чек.

image-20250815-150635.png
image-20250815-135400.png

 

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

  2. Чек завершен → RFID-сканер деактивирован.

Ограничения

  1. У считывателей ограниченный ресурс работы, поэтому подключенный RFID-сканер должен активен только тогда, когда покупатель может добавлять товар в чек

  2. Устройство всегда считывает RFID-метки, если оно включено.

  3. RFID-метки интегрированы с воротами на выходе из магазина. Считанные RFID-метки после регистрации чека отправляются на сервер и деактивируются, чтобы для покупателя сработала сигнализация на воротах при выходе из магазина. При этом кроме считанных через RFID, отправляются и те что были считаны ручным (или встроенным) сканером.

  4. Одну 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
  1. Откройте корпус КСО и подключите RFID-сканер в свободный USB-разъем на кассе.

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

image-20250814-135100.png
  1. Включите модуль RFID → сохраните изменения.

image-20250814-135236.png
  1. Перейдите в папку /home/tc/storage/crystal-cash/config/modules → откройте для редактирования файл rfidScanner-config.xml.

image-20250814-143327.png
  1. Для параметра property key="comPort" укажите порт, в который подключен считыватель → для параметра property key="servicePath" укажите директорию, в которую загружена служба UPOS → сохраните изменения.

image-20250814-145235.png
  1. Перезагрузите кассу.

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.

Подключение к устройству

  1. Откройте корпус КСО и подключите RFID-ридер Keonn AdvanReader-70 в свободный USB-разъем на кассе.

  2. Выполните настройку статического IP-адреса для считывателя, как указано в руководстве .

  3. В браузере перейдите по адресу http://статический IP-адрес считывателя, например, http://192.168.7.2.

  4. Откроется страница считывателя → перейдите в раздел CONFIGURATION -> вкладка Services → меню AdvanNetRestService → используйте для входа следующие учетные данные:

  • Логин (username): admin

  • Пароль (password): admin

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

Для изменения IP-адреса считывателя перейдите на вкладку Network & Time → введите новый требуемый IP-адрес → кликните Save.

image-20251104-123811.png

Настройка рабочих параметров

Перейдите на вкладку RFID → установите параметры, как указано в таблице ниже → кликните Save.

Параметр

Значение

Region

Выберите требуемый регион

Power (dBm)

17.0

Sensitivity (dBm)

-61.0

Write power (dBm)

27.0

Session

S1

Target

A

image-20260204-134227.png

Проверка работы антенн

  1. Перейдите в раздел HOME → вкладка Monitor.

  2. Положите RFID-метку на антенну.

  3. Кликните на кнопку RF is OFF → надпись изменится на RF is ON → цвет кнопки изменится на зеленый → антенны активированы.

image-20260204-135238.png
  1. Наблюдайте список меток: в столбце Port указан номер антенны, считывающей метку.

Настройка считывателя в базе данных

  1. Для включения использования считывателя Keonn AdvanReader-70 выполните скрипт ниже на кассе в базе данных _DB.pngcatalog в таблице _Table.jpgsales_management_properties.

UPDATE sales_management_properties SET property_value='ADVAN_READER', send_status=0 WHERE module_name='RFID' and property_key='provider';
  1. Для настройки номера магазина и касс, на которых используется считыватель, выполните следующие скрипт ниже на кассе в базе данных _DB.pngcatalog в таблице _Table.jpgsales_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';
  1. Перезагрузите кассу.

Статьи по теме