Инструкция является типовой и описывает большинство настроек без привязки к какому-либо клиенту.

1 Настройка сервера SetRetail10
- 1.1 Заведение карт доступа в Set Retail 10
2 Сборка киоска и подключения к сети
3 Подключение пинпада
4 Установка кассового ПО
5 Первичная настройка
6 Инициализация
7 Вход по паролю в меню помощника
8 Настройка оборудования
9 Настройка параметров кассы
10 Настройка бизнес-процессов на кассе
11 Лояльность
- 11.1 Включение списания бонусов как скидки
- 11.2 Отключение запроса применения карты покупателя на экране добавления товаров

Настройка сервера SetRetail10

Перед тем как начать настраивать киоски самообслуживания, настройте сервер SetRetail10 для стандартных процессов работы торговой сети..

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

По всем остальным настройкам воспользуйтесь инструкциями по установке и настройке сервера SetRetail10.

1. Добавьте новый шаблон для касс самообслуживания.

2. Перейдите во вкладку Настройка меню → кнопка Редактировать конфигурацию.

Настройте меню согласно скриншотам:

3. Добавьте новые кассы во вкладке Настройки магазина, привязав их к новому шаблону.

4. Добавьте кассовое оборудование:

Фискальный регистратор Пирит 2Ф (ФФД 1.00/1.05)
Сканер штрихкодов
Внешний считыватель магнитных карт для мониторов ELO Et1515L

5. На вкладке Персонал → Роли кассиров, добавьте 3 новых роли:

Покупатель КСО
Помощник КСО
Администратор КСО

6. Для роли Сервисный инженер добавить привилегию Работа на кассе самообслуживания.

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

Покупатель КСО
- Документы:
  - Аннулирование чека (включается для автоматического аннулирования чека. В иных случаях привилегия не предоставляется).
  - Печать копии чека
  - Печать товарного чека
  - Повтор чека
- Меню:
  - Переход в меню
  - Переход в основной режим
  - Товарный справочник
- Работа с чеком:
  - Ввод кол-ва товара при добавлении
  - Отмена "недорогой" позиции в чеке
  - Отмена акцизного алкоголя в чеке
  - Отмена маркированного табака в чеке
  - Отмена первой позиции в чеке
  - Отмена позиции в чеке
  - Увеличение кол-ва позиций в чеке
  - Удаление "недорогой" позиций в чеке
  - Удаление товарной позиции
  - Уменьшение кол-ва позиций в чеке
- Самообслуживание:
  - Работа на кассе самообслуживания
- Управление:
  - Смена пользователя

Администратор КСО (Помощник КСО)
- Документы:
  - Аннулирование чека
  - Печать X-отчета
  - Печать копии чека
  - Печать товарного чека
  - Печать фискального отчета
  - Поиск чека
  - Чек коррекции
- Меню:
  - Меню банковских операций
  - Переход в меню
  - Переход в основной режим
  - Товарный справочник
  - Ввод кол-ва товара при добавлении
  - Отмена "недорогой" позиции в чеке
  - Отмена акцизного алкоголя в чеке
  - Отмена маркированного табака в чеке
  - Отмена первой позиции в чеке
  - Отмена позиции в чеке
  - Ручной ввод номеров дисконтных карт и купонов
  - Увеличение кол-ва позиций в чеке
  - Удаление "недорогой" позиций в чеке
  - Удаление товарной позиции
  - Уменьшение кол-ва позиций в чеке
- Самообслуживание:
  - Настройка бизнес-процессов самообслуживания
  - Печать банковских слипов
  - Работа на кассе самообслуживания
- Смены:
  - Закрытие смены (Для Администратора)
  - Открытие смены (Для Администратора)
  - Печать контрольной ленты
  - Сверка по банку
- Управление:
  - Перезагрузка и выключение кассы
  - Смена пользователя

7. Добавьте кассиров с ролью Покупатель КСО. Можно одного на все кассы или для каждой кассы или группы касс завести отдельного кассира.

8. Добавьте кассиров с ролью Администратор КСО и Помощник КСО, привяжите к ним номера карт доступа.

9. Остальные настройки не являются специфичными для касс самообслуживания. Выполните их согласно основной инструкции по настройке сервера.

Заведение карт доступа в Set Retail 10

Ниже показан пример заведения карты для роли администратора КСО

Пароль для карты не имеет значения, так как доступ для сотрудника должен быть только по ней, но без него нельзя создать учетную запись.
Создайте сложный неповторяющийся пароль не совпадающий с номером на карте.

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

Сборка киоска и подключения к сети

1. Достаньте оборудование из транспортировочных коробок.

2. Установите стойку на ровное основание. Отметьте на полу места для крепления.

Требования к крепежу:

Нагрузка на вырыв крепежа из пола (на 1 анкер) - не менее 1 кН
Нагрузка на срез (на 1 анкер) - не менее 2 кН

3. В зависимости от материала пола вы можете использовать крепеж другого типа с характеристиками не хуже требуемых.

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

Для деревянных полов - сантехнический болт.

В комплекте со стойкой идут 4 анкера втулочных раcпорных 8x100 типа FS8A.

Характеристика анкера FS8A для бетона марки B15:

На вырыв - 1,5 кН
На срез - 2,5 кН

В новых партиях анкер заменен на 12х100.

4. Подводка электричества и сети может быть выполнена либо с пола (провод выводится в центр основания стойки), либо со стены (провод выводится через основание стойки, для этого выламываются технологические отверстия в основании стойки для вывода кабеля).

5. Корпус киоска на вешается на стойку и закрепляется 6-ю винтами с внутренней стороны киоска.

Верхние и нижние винты закручивать в крайние позиции, чтобы исключить перекос корпуса при эксплуатации.

6. Кабель протягивается во внутренней полости стойки и выводится в корпус киоска.

7. Силовой кабель подключается к диф. автомату внутри корпуса киоска.

Подключение должен выполнять квалифицированный электрик с необходимыми уровнями доступа.

Для обеспечения безопасности пользователя и для сокращения выхода из строя оборудования, подключение линии заземления (PE) обязательно.

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

Гарантия на оборудование не распространяется при нарушении правил подключения к электросети.

8. В системном блоке два ethernet-разъема, касса должна подключаться к сети магазина через нижний разъем (с противоположной стороны от кнопки включения системного блока).

Ethernet-кабель обжимается вилкой RJ45 и подключается в ethernet-разъем со стороны разъемов питания на системном блоке киоска.

9. Витой кабель ручного сканера выводится через нижнее технологическое отверстие корпуса киоска и подключается к сканеру.

10. Крепление ручного сканера прикручивается с левой стороны киоска к точкам крепления.

Подключение пинпада

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

Блок питания пинпада должен быть подключен к ИБП через переходник на евровилку.

Установка кассового ПО

На кассу предварительно устанавливается актуальная версия ПО. Поэтому установка системы и первичная настройка указана в этой инструкции в ознакомительных целях и случаях, когда нужно переустановить ПО на чистый диск.

1. Запишите образ Set SCO на флешку используя программу Win32DiskImager или rufus (в режиме записи dd).

2. Установите записанную флешку в свободный USB-разъем на системном блоке кассы.

3. Подключите стандартную клавиатуру в свободный разъем на системном блоке кассы.

4. Перезагрузите системный блок.

5. В момент загрузки BIOS нажимайте кнопку F11, чтобы вызвать меню выбора загрузочного устройства.

6. В меню выберите вашу флешку и продолжите загрузку.

7. Выберите 2-й пункт меню Install Set SCO.

8. Начнется процесс установки.

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

9. После успешного начала процесса установки флешку можно отключить.

Первичная настройка

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

Если система “пропускает” калибровку сенсорного экрана, проверьте подключение проводов к экрану и еще раз перезагрузите кассу.

Инициализация

1. Введите номер магазина и номер кассы.

2. Начальное меню кассы выглядит таким образом:

Здесь доступны все необходимые инструменты для настройки кассы до подключения к серверу.

Настройка IP-адреса кассы

Перейдите в Меню → Настройка сети → Настройка сетевого соединения.

Рекомендуется настраивать статичный адрес вместо динамического.

Настройка IP-адреса сервера

Перейдите в Меню → Настройка сети → Настройка соединения с сервером.

Настройка пароля покупателя

На сервере SetCentrum/SetRetail10 предварительно должна быть настроена роль Покупателя и создан кассир с этой ролью. Под этой ролью касса будет автоматически регистрироваться.
По умолчанию пароль покупателя на кассе: 123456789.
Сервер должен быть предварительно настроен и быть в сети.

Убедитесь, что пароль покупателя на кассе соответствует паролю кассира, установленному на сервере. Иначе при запуске кассы будет ошибка доступа.

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

С обновлением 10.4.7.0 настройка пароля покупателя перенесена из xml-файла в базу данных.

Для изменения пароля покупателя выполните скрипт в базе данных catalog в таблице sales_management_properties.

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

До обновления на версию10.4.7.0 за изменение пароля отвечает параметр <property name="customerPassword" в файле /home/tc/crystal-cash/modules/techProcess/techProcess-system-config.xml.

Для изменения пароля установите требуемое значение для параметра, как указано в примере ниже → нажмите F2 для сохранения изменений.

<property name="customerPassword" value="123456789"/>

После сетевых настроек и логина покупателя необходимо получить данные на кассу с сервера SetRetail10.

Для этого в меню нажмите кнопку “Новая касса” - будет сформировано задание на загрузку данных.

Если при нажатии Новая касса выходит ошибка, тогда перезагрузите ОС и проверьте из командной строки, что сервер доступен по порту 8090 с помощью методик.

Примерно через 10 минут кассу нужно перезагрузить: Меню → Перезагрузка.

Вход по паролю в меню помощника

На кассе предусмотрена возможность войти в режим помощника по вводу пароля кассира без использования сканера ШК и картридера.

Мысленно разделите экран кассы на 9 равных частей, как на картинке:
- Экран может быть любой. На картинке дан только пример разметки.
- Ограничение - нельзя войти в меню в режиме оплаты.
- По умолчанию активация окна ввода пароля настроена на сочетание 3323.

Начиная с версии 10.4.5.0 изменить сервисный пароль (пароль для активации окна ввода пароля) можно можно в базе данных кассы catalog в таблице sales_management_properties, параметр UI_LOGIN_PASSWORD.

Информация об остальных изменениях в настройках после обновления на версию 10.4.5.0 в статье SetRetail SCO v.3◾миграция с SCO v.2 на SCO v.3 в главе Настройки для SetRetail SCO v. 2.

Касса переключится в окно ввода пароля кассира. Введите пароль согласно заведенному в Set Retail 10.

Настройка оборудования

Быстрая настройка/перенастройка оборудования может выполнена скриптом инициализации параметров командой sh /home/tc/storage/crystal-cash/init.sh

Начиная со сборки версии 10.3.1.1 скрипт init.sh доступен по пути /home/tc/storage/help/init.sh

Ссылка на скрипт сборок более старых версий - https://drive.google.com/file/d/1ZZfSEmDpMPMyOL_sEluDjz4pAV5i5vWf/view?usp=sharing

Настройка сканера Magellan 1500i

На кассе Меню → Сервис → Конфигуратор → Оборудование → Сканер → Сканер №2 → Сканер штриховых кодов → /dev/ttySC → 9600.

Настройка сканера CSI Scan Heart

На кассе Меню → Сервис → Конфигуратор → Оборудование → Сканер → Сканер №2 → Сканер штриховых кодов → /dev/usbSVe851P2102 → 9600.

Настройка ККТ Пирит 2Ф

На кассе Меню → Сервис → Конфигуратор → Оборудование → Фискальный регистратор/принтер чеков → Пирит 2Ф(ФФД 1.00/1.05) → /dev/ttyS1 ⇒ 57600. (ttyS1, если ФР подключен к COM2)

Настройка ККТ VikiPrint F

На кассе Меню → Сервис → Конфигуратор → Оборудование → Фискальный регистратор/принтер чеков → VikiPrint F → /dev/ttyS1 ⇒ 57600. (ttyS1, если ФР подключен к COM2)

Внимание! Подключайте ФР к системному блоку кабелем, который идет в комплекте с ФР, черного цвета. Кабель в составе системного блока предназначен для подключения Пирит 2Ф.

Настройка картридера

На кассе Меню → Сервис → Конфигуратор → Оборудование → Внешний считыватель магнитных карт → для тач-монитора Elo ET1515L.

Настройка сигнального фонаря

Выполните скрипт для настройки сигнального фонаря.

1. Скачайте скрипт на кассу:

2. Скопируйте скрипт в папку кассы, например: /home/tc/storage/

3. Запустите скрипт командой:

sh /home/tc/storage/tricolor_enable.sh

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

Настройка часового пояса

На кассе Меню → Конфигуратор -> Настройка времени.

Рекомендуется устанавливать часовой пояс с сервера SetRetail10, который должен соответствовать локальной временной зоне.

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

Настройка юридического лица

На кассе Сервис → Конфигуратор → Юридическое лицо.

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

Настройка процессинга банка

На кассе Сервис → Конфигуратор → Банки.

Задействуйте процессинг банка.

Нельзя задействовать более одного процессинга.

Настройка количества одновременно сканируемых товаров

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

Данная настройка включена в скрипт init.sh

Для включения настройки выполните следующее:

Перейдите в меню Сервис.
Раздел Конфигуратор.
Раздел Настройки SCO.
Раздел Модуль самообслуживания.
Пункт Размер списка товаров на подтверждение → установите значение 3.
Намите Сохранить.
Перейдите в Общие настройки → Настройки SCO.
Проверьте, что в пункте Интервал расчета двойного сканирования штрих-кода установлено значение = 1500 (если не установлено, тогда введите его).
Пункт Скорость анимации → установите значение = 9 (если не установлено).
Нажмите Сохранить.
Перезагрузите кассу.

Настройка бизнес-процессов на кассе

Настройка экрана запроса дисконтной карты

Настройка на КСО

По умолчанию касса показывает экран запроса дисконтной карты при переходе к оплате, если она еще не была применена.

1. Для отключения экрана перейдите в Меню консультанта → раздел Меню → Конфигуратор → Настройки SCO → Общие настройки.

2. Включите настройку Показывать экран запроса ДК → кликните Сохранить.

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

Настройка через xml-файл

1. На кассе перейдите в папку /mnt/sda1/tce/storage/crystal-cash/modules/techProcess → откройте для редактирования файл techProcess-system-config.xml.

2. В файле измените значение параметра property name="enableDCMode".

При включенном запросе добавления дисконтной карты строчка будет выглядеть следующим образом:

<property name="enableDCMode" value="true"/>

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

Экран запроса количества пакетов для упаковки товара

Вы также можете настроить экран запроса количества пакетов через редактирование файла и изменить способ его отображения (добавление пакета на отдельном экране или на главном экране). Подробную инструкцию для этого вы найдете в статье Добавление пакетов через добавление товаров.

По умолчанию этот экран выключен. Нужно добавить код или штрихкод пакета в меню настройки:

1. На Сервис → Конфигуратор → Настройки SCO → Общие настройки → Запрос покупки пакетов.

2. Добавьте пакеты и задайте их максимальное количество для выбора покупателем:

3. Создайте файлы с картинками пакетов в формате [код_товара].png и скопируйте их на кассу в папку /home/tc/storage/crystal-cash/images.

Размер картинки для пакета 145 х 145 пикселей.

Пример работы на кассе:

Пиклист 1.0

Пиклист - это иерархически структурированное дерево товаров без штрихкода ну упаковке для самостоятельного выбора и добавления в чек покупателем.

Внимание!

В пик-лист можно добавлять только штучные штрихкодированные товары.
Мерные и весовые товары, требующие для расчета стоимости взвешивания будут работать только при наличиий весового модуля (см. пункт “Прикассовое взвешивание”).
У товара обязательно должен быть один штрихкод с параметром “default”. Иначе такой товар в пиклисте не отобразится.

Товары могут быть двух типов - весовые и штучные.
Для весовых товаров обязательно требуется подключенный весовой модуль, без него товарные ячейки становятся неактивными.
Для штучных товаров нет ограничений.
Структура пик-листа устанавливается на кассе в файле /home/tc/storage/crystal-cash/config/plugins/weightCatalog-xml-config.xml.
Теги <good item=”[код_товара]” name=”[наименование_ячейки]”/> описывают товары.
Картинки для товаров должны быть скопированы на кассу в папку /home/tc/storage/crystal-cash/images в формате [код_товара].png.
Размер картинки 200 х 144 пиксела.
Теги <group name=”[наименование_ячейки]”/> описывают папки, в них могут быть вложены другие папки и товары.
Картинки для папок должны быть скопированы на кассу в /home/tc/storage/crystal-cash/images в формате [наименование_ячейки].png.
Размер картинки 200 х 144 пикселя.

Пример группы с вложенными товарами:

Тег <property key=”sort” value=”true”/> позволяет включить или выключить сортировку товаров по наименованию (в рамках каждой папки).

Измените параметр типа пиклиста на кассе в файле /home/tc/storage/crystal-cash/config/modules/weightCatalog-config.xml

<property key="provider" value="xml" />

Для активации пиклиста выполните скрипт в базе данных catalog на кассе:

UPDATE  sales_management_properties
SET     property_value = 'true'
WHERE   module_name='SCO' AND plugin_name='ITAB' AND property_key='showPickList';
INSERT INTO    sales_management_properties (module_name, plugin_name, property_key, property_value, priority)
SELECT  'SCO', 'ITAB', 'showPickList', 'true', 2
WHERE   'showPickList' NOT IN
        (
        SELECT  property_key
        FROM    sales_management_properties
			WHERE module_name = 'SCO' AND plugin_name='ITAB'
        );

Ниже представлен пример включенного пиклиста. На этом экране заданы только две группы.

Можно перейти в одну из групп, например в группу “Выпечка”.

Прикассовое взвешивание

Данный функциональность доступна начиная с версии 10.3.1.0

Внимание! Данная настройка работает только с пиклистом. Товар, который необходимо взвешивать на кассе, должен быть в пиклисте.

Внимание! Если в пиклист добавлен ШК весового товара, в составе которого есть вес, то касса передаст в чек тот вес, который указан в ШК. Взвешивание вызываться не будет.

0. Подключение контроллера весов к системному блоку

Проверьте, что устройство определяется в системе. Выполните в консоли команду lsusb

Контроллер прикассовых весов должен определиться в системе с ID 0483:5740

Правилом /etc/udev/rules.d/99-crystals.rules устройство переопределяется как /dev/ttyUSB61 , этот порт следует выбирать в настройках плагина весов.

1. Включение работы с весовым модулем

Проверьте, что в файле home/tc/storage/crystal-cash/config/register-modules.xml активирован модуль scale

<module active="true">
  <name>scale</name>
  <dir>scale-config.xml</dir>
</module>

2. Настройка модуль на плагин Масса-К Протокол 100

Установив в файле /home/tc/storage/crystal-cash/config/modules/scale-config.xml значение атрибута value="massa-k_protocol100"

<property key="provider" value="massa-k_protocol100"/>

3. Настройка порта подключения в плагине

Внимание! Для правильной работы весового модуля, пирит должен быть подключен по RS-232.

Измените в файле crystal-cash/config/plugins/scale-massaK_protocol100-config.xml значение атрибута value="/dev/ttyACM0" на локальный путь до весов /dev/ttyUSB61

<property key="port" value="/dev/ttyUSB61" type="port" visible="true" description="Порт"/>

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

Касса блокируется, если в конце чека весы не будут в нуле с учетом заданного допуска.

Настройка на кассе в БД catalog, таблица sales_management_properties

параметр timeoutToBlockScoDueToIncorrectWeight

Значение задается в секундах, по умолчанию 60 секунд.

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

Настройка на кассе в БД catalog, таблица sales_management_properties, параметр maxAllowedWeightDeviation

допустимое отклонение веса задается в граммах, по умолчанию 10 грамм.

т.е. весы в конце чека автоматически оттарируются, если вес на них будет от -10 до 10 грамм.

6. Тарирование весовой платформы

На сервере Set Retail 10 в шаблоне кассы добавьте в меню помощника кнопку “Тарирование контрольных весов”.

У ролей помощника и администратора и покупателя должно быть право на тарирование весовой платформы.

Кнопка вызова помощника

Начиная с версии 10.2.97.0 добавлена настройка, которая отвечает за отображение/скрытие кнопки вызова помощника на всех КСО и станциях оплаты под управлением SetSCO (ITAB, PS-17, Drive, CSI-K, CSI-T).

Название настройки hideAttendantButton, находится на кассе в базе данных catalog в таблице sales_management_properties.
По умолчанию установлена в false (кнопка вызова помощника отображается).
Что бы выключить отображение кнопки вызова помощника, необходимо для данной настройки установить значение true

UPDATE public.sales_management_properties
   SET property_value='true'
WHERE property_key='hideAttendantButton';

Автоматическое аннулирование чека

https://crystals.atlassian.net/browse/SCO-2473

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

10.2.97.0

Подробная инструкция по настройке автоматического аннулирования чека и примеры работы на КСО в статье CSI K ◾️ Как настроить автоматическое аннулирование чека на CSI K?.

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

1. Выдайте кассиру Покупатель КСО привилегию Аннулирование чека.

2. В базе данных catalog на кассе задайте в секундах значения для параметров:

screenSaverTime - время ожидания кассы до автоматического аннулирования чека;
timeoutNotifyForCancelingOpenedCheck - таймаут отмены автоматического аннулирования покупателем.

При этом, если значение параметра = 0, тогда функциональность будет отключена.

Лояльность

Включение списания бонусов как скидки

Начиная с версии 10.2.96.0

Для включения функциональности списания бонусов SetAPI или SetRetail10, установите в файле /home/tc/crystal-cash/modules/techProcess/techProcess-system-config.xml свойству bonusAsDiscountType следующие значения:

<property name="bonusAsDiscountType" value="BONUS_SR10"/> - для бонусов SetRetail10.
<property name="bonusAsDiscountType" value="SET_API"/> - для бонусов SetAPI.
удалите или закомментируйте этот тег, если эта функциональность не используется.

Тег должен быть добавлен в файл как дочерний элемент тега <bean id="techProcess"/>

Тип оплаты бонусами должен быть отключен в настройках шаблона кассы на сервере

Отключение запроса применения карты покупателя на экране добавления товаров

Начиная с версии 10.2.98.0

По умолчанию, всегда появляется красная полоса с напоминанием применить карту покупателя.

Чтобы убрать это напоминание, выполните скрипт на кассе в базе данных catalog, в таблице sales_management_properties для записи со значением property_key=showScanDiscountCardMessage, который установит параметр property_value=false.

UPDATE public.sales_management_properties
SET    property_value = 'false'
WHERE  property_key = 'showScanDiscountCardMessage'
       AND module_name = 'SCO';

CSI K ◾️ Инструкция по установке и настройке