1 Информация о продукте
2 Инсталляция и первоначальная настройка
3 Функциональные возможности и сценарии использования
4 Работа с сервисом SetKit через API
5 Восстановление, аннулирование и гашение мягкого чека на кассе
6 Обработка признаков запрета действий и изменений на кассе
7 Работа с акцизными алкогольными товарами из мягкого чека на кассе
8 Сопровождение
9 Описание таблиц базы данных SetKit
10 Хранение мягкого чека в SetRetail10

Информация о продукте

Set Kit – это сервис для работы с заказами покупателя.

Заказ покупателя - предварительно оформленный список товаров в одном из каналов продажи. Может также содержать дополнительную информацию о покупателе, примененных акциях и рассчитанных скидках. Заказ можно сформировать как в онлайн-канале продаж, будь то интернет-магазин или мобильное приложение покупателя, так и в торговом зале, через рабочее место продавца или терминал сканирования данных (SelfScan).

Сервис Set Kit выступает связующим звеном между Вашими информационными системами и кассовыми местами. Он позволяет реализовать обработку мягких чеков в Вашей торговой сети как на физических кассах включая Mobile POS, так и в онлайн-кассах.

Инсталляция и первоначальная настройка

Системные требования

Операционная система (предпочтительно x64) - Linux CentOS не ниже 7
PostgreSQL 9.4. (входит в состав SetRetail10, установка не требуется)
Java8
.NetFrameWork 3.5
1Гб оперативной памяти
Достаточное место на жестком диске: от 50Гб
Версия SetRetail10 - не ниже 10.2.42.0

ВАЖНО

Первоначальная инсталляция сервиса SetKit осуществляется специалистами CSI в рамках проектных работ

После инсталляции в списке служб появится SetKit service

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

Откройте на редактирование файл {Disk}:\dist\set-kit.xml
Установите необходимые параметры для работы со службой SetKit

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

Пример файла настройки dist\set-kit.xml

set-kit.xml

<service>
    <id>SetKit</id>
    <name>SetKit service</name>
    <description>SetKit service</description>
    <workingdirectory>%BASE%\</workingdirectory>
    <logpath>%BASE%\logs</logpath>
    <logmode>rotate</logmode>
    <executable>%SET_JAVA_HOME%\bin\java</executable>
    <argument>-Xms256m</argument>
    <argument>-jar</argument>
    <argument>set-kit.war</argument>
    <argument>--server.port=8081</argument> <!--порт сервиса-->
    <argument>--database.host=localhost</argument> <!--хост на котором находится бд-->
    <argument>--database.port=5432</argument> <!--порт на котором находится бд-->
    <argument>--scheduler.delay=43200000</argument> <!--с какой задержкой запускается удаление МЧ(в мс)-->
    <argument>--scheduler.maxDays=100</argument> <!--время жизни МЧ в днях-->
    <onfailure action="restart" delay="20 sec"/>
    <argument>--generator.prefix=SK</argument> <!--Префикс для guid мягких чеков в случае генерации SetKit-->
    <argument>--generator.length=16</argument> <!--Длина (с учетом префикса) для guid мягких чеков в случае генерации SetKit-->
    <argument>--license.agentAddress=http://localhost:5522/rmi</argument><!--IP-адрес агента лицензирования-->
    <!--<argument>scheduler.maxMinutes=100</argument>--> <!--время жизни МЧ в минутах, если заданы дни то они приоритетнее-->
</service>

3. Для вступления настроек в силу необходимо перезапустить службу SetKit service

Настройка SetRetail для работы с SetKit

Откройте Управление продажами
Внешние системы
Внешние процессинги
Нажмите кнопку Добавить оператора
Выберите из левой части списка Мягкие чеки
Выберите Служба мягких чеков SetKit X
Нажмите кнопку Зарегистрировать нового оператора. Далее перейдите к Настройкам оператора
Заполните необходимые поля для мягкого чека и нажмите кнопку К списку операторов.
Значения полей:
- [Адрес сервера SET Kit] задайте IP-адрес сервера SetRetail10 в формате http://XXX.XXX.XXX.XXX:ПОРТ
- [Префикс мягкого чека] - установите префикс, благодаря которому касса будет распознавать, что введенной значение является мягким чеком.
- [Длина номер мягкого чека (без префикса)] - введите допустимую длину мягких чеков.
- [Обрезать префикс перед отправкой] - необходимо использовать в случаях хранения номеров заказов без префикса
- [Разрешить добавление акцизных алкогольных товаров]- возможность добавления алкогольных товаров с вводом акцизных марок на кассе
- [Производить поиск мягкого чека с индексом своего магазина]- необходимо использовать в случаях, когда нумерация заказов происходит в каждом магазине
Для быстрого вызова поиска мягкого чека можно сделать функциональную клавишу на прикассовой клавиатуре, для этого перейдите в настройки клавиатуры, нажав на кнопу Настройки.
Из списка на вкладке функции кассы выберите поиск мягкого чека.
Непосредственно на кассе в сервисном меню Конфигуратор
Внешние процессинги проверьте, что наименование процессинга Служба мягких чеков SetKit X присутствует в списке.
ВАЖНО
Статус процессинга мягких чеков Службы мягких чеков SetKit X всегда будет в статусе не подключен. Проверка подключения к службе проверяется запросом мягкого чека на кассе
После того, как вы убедились, что необходимые процессинг мягких чеков отображается на кассе, перезагрузите кассовые модуль.
Касса готова к работе с сервисом SetKit

Функциональные возможности и сценарии использования

Работа с сервисом SetKit через API

Восстановление, аннулирование и гашение мягкого чека на кассе

Обработка признаков запрета действий и изменений на кассе

Работа с акцизными алкогольными товарами из мягкого чека на кассе

Сопровождение

Описание таблиц базы данных SetKit

Хранение мягкого чека в SetRetail10

SetKit ◾️ Подробное описание