/
SetRetail SCO v.3◾миграция с SCO v.2 на SCO v.3

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

SetRetail SCO v.3◾миграция с SCO v.2 на SCO v.3

https://crystals.atlassian.net/browse/SCOD-1189

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

10.4.5.0

Обратите внимание, процесс миграции с версии SetRetail SCO v. 2 на SCO v. 3 находится в разработке. 

Статья будет дополняться по мере выхода функциональности. 

Описание

В данной статье представлено описание процесса миграции с версии кассового ПО SetRetail SCO v.2 на новую версию SetRetail SCO v. 3.

Объединение настроек для касс самообслуживания

На данный момент несколько настроек в базах данных касс самообслуживания SCO v. 2 и SCO v. 3 дублируются, что значительно усложняет процесс миграции на новую версию. В обновлении 10.4.5.0 часть настроек были удалены или объединены, что позволило упростить процесс миграции и уменьшить количество возникающих ошибок. 

Настройки для SetRetail SCO v. 3

Начиная с версии 10.4.5.0 из базы данных _DB.pngcatalog кассы SCO v. 3 из таблицы _Table.jpgsales_management_properties удалены следующие настройки:

  • RECEIPT_AUTO_CANCELLATION_ON → КСО отправляет запрос на сервер для проверки у покупателя наличия привилегии на отмену чека. Если привилегия есть, тогда настройка считается включенной.

  • RECEIPT_AUTO_CANCELLATION_ON_TIMEOUT_SEC → Начиная с версии 10.4.5.0 используется параметр screenSaverTime. Значение параметра по умолчанию = 30.
    С версии 10.4.19.0 настройки автоаннулирования были визуализированы на сервере в шаблоне кассы: Кассовый модуль → Шаблоны касс → шаблон кассы SCO v.3 → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Автоаннулирование.

  • RECEIPT_AUTO_CANCELLATION_NOTIFICATION_BEFORE_TIMEOUT_SEC → Начиная с версии 10.4.5.0 используется параметр timeoutNotifyForCancelingOpenedCheck. Значение параметра по умолчанию = 20.
    С версии 10.4.19.0 настройки автоаннулирования были визуализированы на сервере в шаблоне кассы: Кассовый модуль → Шаблоны касс → шаблон кассы SCO v.3 → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Автоаннулирование.

  • PACKAGE_ENABLED → Для включения продажи пакетов на кассе используется параметр enablePacketsOnSCO.
    Также включение продажи пакетов на КСО визуализировано в шаблоне кассы: Кассовый модуль → Шаблоны касс → шаблон кассы SCO v.3 → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Настройки пакетов.

  • PACKAGE_CONFIG → Для настройки пакетов используется параметр packetSetting.
    Также настройка пакетов на КСО визуализирована в шаблоне кассы: Кассовый модуль → Шаблоны касс → шаблон кассы SCO v.3 → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Настройки пакетов.

  • ALARM_ON_PURCHASE_FISCALIZED → КСО проверяет параметр beepDuration. Если property_key = beepDuration, property_value > 0, тогда настройка считается включенной.

Настройки для SetRetail SCO v. 2

Начиная с версии 10.4.5.0 из базы данных _DB.pngcatalog кассы SCO v. 3 из таблицы _Table.jpgsales_management_properties и из файла /home/tc/storage/crystal-cash/modules/visualization/visualization-system-config.xml удалены следующие настройки: 

  • Из /home/tc/storage/crystal-cash/modules/visualization/visualization-system-config.xml удалена настройка touchSequence. → Для настройки используется параметр UI_LOGIN_PASSWORD в базе данных _DB.pngcatalog.

  • showPickList → Для включения пик-листа на КСО используется параметр catalogEnabled в базе данных _DB.pngcatalog.
    Также включение пик-листов визуализировано в шаблоне кассы: Кассовый модуль → Шаблоны касс → шаблон кассы самообслуживания → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Дополнительные настройки.

  • enableGlobalSearch → Для включения глобального поиска по каталогу используется параметр globalSearchEnabled в базе данных _DB.pngcatalog в таблице _Table.jpgsales_management_properties.
    Также включение глобального поиска по каталогу визуализировано в шаблоне кассы: Кассовый модуль → Шаблоны касс → шаблон кассы самообслуживания → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Дополнительные настройки.

  • allowAddCardByPhone → В базе данных _DB.pngcatalog для параметра allowAddCardByPhone изменен модуль  SCO → CASH_CONFIG. 
    Также включение кнопки Поиск по номеру телефона визуализировано в шаблоне кассы: Кассовый модуль → Шаблоны касс → шаблон кассы самообслуживания → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Дополнительные настройки. С версии 10.4.23.0: Кассовый модуль → Шаблоны касс → шаблон кассы самообслуживания → ПРОЦЕСС ТОРГОВЛИ → вкладка НАСТРОЙКИ → меню Настройки лояльности

  • callAttendantToReturnProduct → В базе данных _DB.pngcatalog для параметра callAttendantToReturnProduct изменен модуль  SCO → CASH_CONFIG. 
    Также включение настройки Вызов помощника для возврата удаленных покупателем товаров (SCO) визуализировано в шаблоне кассы: Кассовый модуль → Шаблоны касс → шаблон кассы самообслуживания → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Дополнительные настройки.

  • isCallAttendantOnGiftCardScan → Для настройки используется параметр callAttendantForGiftCardConfirmatio.
    Также включение настройки Вызов помощника для подтверждения применения подарочной карты визуализировано в шаблоне кассы: Кассовый модуль → Шаблоны касс → шаблон кассы самообслуживания → ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → Дополнительные настройки.

  • Из /home/tc/storage/crystal-cash/modules/visualization/visualization-system-config.xml удалена настройка enableCoupons. → Для настройки используется параметр SHOW_COUPONS_ON_PAYMENT_SCREEN в базе данных _DB.pngcatalog.

Миграция с SetRetail SCO v.2 на SetRetail SCO v.3

https://crystals.atlassian.net/browse/SCOD-851

https://crystals.atlassian.net/browse/SCOD-1129

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

10.4.6.0

Описание

Ниже представлена подробная инструкция по миграции с кассового ПО SetRetail SCO v.2 на SetRetail SCO v.3.

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

Процесс миграции

Ниже приведен пример работы с переводным патчем SetRetail SCO v.2 10.4.5.3 → SetRetail SCO v.3 10.4.5.8.

Так как переводной патч собирается индивидуально по запросу клиента, то исходная и целевая версии будут зависеть от запроса.

1. Перед началом перевода убедитесь, что на КСО на базе SetRetail SCO v.2 установлена версия 10.4.5.3.

Проверить версию ПО можно на кассе в режиме консультанта → версия будет указана в левом нижнем углу экрана.

2. Получите переводной патч SetRetail SCO v.2 10.4.5.3 → SetRetail SCO v.3 10.4.5.8 → следуя инструкции в статье Обновление SetRetail (Менеджер управления конфигурацией), загрузите переводной патч на сервер SetCentrum/SetRetail10 → подождите несколько минут.

3. Перейдите в МУК (http://IP-адрес сервера SetCentrum/SetRetail10:8092) → выберите КСО на базе SetRetail SCO v.2 с версией 10.4.5.3 → выполните обновление на версию 10.4.5.8, как указано в главе Обновление касс.

4. На КСО начнется процесс обновления → на экране появится соответствующее информационное сообщение.

5. Через несколько минут (примерно 5-7 минут) появится экран загрузки SetRetail SCO v.3, это значит, что КСО была успешно мигрирована → после загрузки отобразится экран ожидания покупателя для SetRetail SCO v.3.

После обновления

Переключение шаблона кассы

Для корректной работы любой функциональности КСО должна быть привязана к шаблону кассы SCO_3 касса. 

Если к моменту миграции КСО такого шаблона на сервере не заведено, тогда необходимо его создать, при этом выбрав тип кассы SCO_3 касса. 

Для создания нового шаблона перейдите в раздел Кассовый модуль → вкладка Шаблоны касс → кликните 

для создания нового шаблона. 

  1. Перейдите на сервер SetCentrum → раздел Магазины → вкладка Поиск магазинов → выберите требуемый магазин → кликните Редактировать.

  1. Перейдите на вкладку Кассы → выберите кассу самообслуживания, которая была мигрирована → кликните Удалить.

  1. Кликните Добавить кассу → установите количество касс, которые нужно создать → выберите стандартную раскладку → в поле Шаблон выберите Касса самообслуживания SCO v.3 → кликните СОХРАНИТЬ.

  1. Если после миграции номер КСО изменился, тогда необходимо изменить его в настройках кассы. 

Для этого авторизуйтесь на КСО → нажмите Меню консультанта в левом нижнем углу экрана → перейдите на вкладку Сервис → Конфигуратор → Настройки SCO → Конфигурация POS.

image-20260623-123448.png
image-20260623-123357.png

 

  1. Введите новый номер в поле Номер кассы → кликните .

Если включена функциональность

Инициировать новую кассу, тогда на сервере будут созданы задания на выгрузку ВСЕХ данных, включая весь товарный каталог.

Если этого делать не нужно (данные уже есть на кассе), тогда уберите галочку (отключите функциональность).

image-20260623-124130.png
image-20260623-124305.png

 

  1. Нажмите Да для перезагрузки КСО и применения изменений.

image-20260623-124629.png
image-20260623-124540.png

 

Переключение шаблона пик-листа 

Для касс самообслуживания SetRetail SCO v.3 необходимо создать новый пик-лист для типа устройства SCO_3 и привязать его к соответствующим кассам. Инструкция по созданию и наполнению пик-листа в статье SetRetail SCO v.3◾Пик-лист.

Проверка оборудования

  • Переводной патч включает в себя скрипт для автоопределения настроенного оборудования на КСО: сканеров (ручного и встроенного), фонаря и весов. Если на КСО было настроено оборудование, тогда после миграции оно будет определено автоматически. 
    Вы можете проверить, определилось ли оборудование, локально на кассе самообслуживания: авторизуйтесь на КСО → нажмите на кнопку Меню консультанта в левом нижнем углу экрана → перейдите на вкладку Сервис → выберите Конфигуратор → Настройки SCO → Оборудование КСО. Убедитесь, что все оборудование было определено корректно.

image-20260623-124817.png
image-20260623-124858.png

 

  • Обратите внимание, автоопределено будет только то оборудование, которое официально поддерживается для использования с КСО на базе SetRetail SCO v.3.

  • Если ваше оборудование не было автоопределено при миграции, тогда добавьте его вручную в Меню консультанта → вкладка Сервис → Конфигуратор → Настройки SCO → Оборудование КСО.

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