| Оглавление |
|---|
Описание
| Устаревшая версия Jira | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
SetKit с заданной периодичностью отправляет сообщения о созданных и отмененных заказах.
Условия
- SetKit и SetRetail доступны.
- В SetKit установлены настройки отправки сообщений.
Схема работы
Дополнительная информация и ограничения
- Входящие параметры WS передачи сообщений на кассы
Входящий параметр Обязательность Тип данных Ограничения\особенности Сообщение кассиру Да Строка Максимально 50 символов Номера магазинов Нет Число Несколько номеров магазинов передаются через запятую. Если атрибут отсутствует, то сообщение будет отправлено на все магазины сети Номера касс Нет Число Несколько номеров касс передаются через запятую. Если атрибут отсутствует, то сообщение будет отправлено на все кассы - Возможность отправки сообщений из SetKit по умолчанию выключена и настраивается согласно инструкции ниже.
- В случае отсутствия связи между SetKit и сервером SetRetail, сообщения доставлены не будут.
- Время отображения сообщений на кассе настраиваемое (по умолчанию 1 минута).
- Сообщения кассиру не отображаются когда на кассе не авторизован кассир или касса находится в простое (запущен скринсейвер).
Пример работы
Визуализация на кассе
Кейс 1. Информирование о созданных заказах
- Покупатель создал новый заказ в интернет-магазине. Данный заказ передался и сохранился в SetKit со статусом "создан" [created]
- Планировщик в SetKit согласно заданному интервалу времени при опросе получил информацию о новом созданном заказе и передал сообщение на сервер Set
- Проверяем, что на кассе отобразилось сообщение:
Заказы Создано: 1 Отменено: 0
- Проверяем, что через указанный период времени сообщение повторно было отправлено и отобразилось на кассе
- Продавец собрал заказ и изменил статус в Интернет-магазине на "собран"
- В SetKit поступило изменение статуса заказа на "Готов к оплате" [ready_to_payment]
- Проверяем, что из SetKit более не поступало сообщений для отображения на кассе
Кейс 2. Информирование об отмененных заказах
...
- .
...
...
- В SetKit по этому заказу пришла команда на его удаление
...
Настройка SetKit
| Устаревшая версия Jira | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
Конфигурирование уведомлений производится следющими следующими свойствами:
| Свойство | Определение | Тип | По умолчанию |
|---|---|---|---|
| notification.SetRetail.enabled | включение Включение уведомлений | boolean | false |
| notification.SetRetail.delayMinutes | периодичность Периодичность отправки сообщений (в минутах) | integer | 15 минут |
| notification.SetRetail.ipAddresses | адреса Адреса, на которые рассылать, формат 255.255.255.255, можно указать с портом 255.255.255.255:8080, порт по умолчанию 8090 Для топологии SetCentrum ↔ Кассы указать адрес сервера SetCentrum. При этом уведомления приходят на те кассы, магазин которых указан в самом мягком чеке. Если не указан никакой, то придет на все кассы сети. | list(разделитель ',') | не определено |
| notification.SetRetail.cashNumbers | номера Номера касс | list(разделитель ',') | не определено |
| notification.SetRetail.message | сообщениеСообщение | string | 'Заказы Создано: #{"type": "COUNT","value": "softcheck.status='CREATED'"} Отменено: #{"type": "COUNT","value": "softcheck.status='CANCELED'"}' |
Свойство notification.SetRetail.message - правила определения сообщения:
- Для успешного формирования сообщения необхожимо необходимо чтобы были заданы подстановки #{}
- Подстановка формируется из типа (на данный момент только COUNT - регистр важен) и значение значения самой подстановки value, например
#{"type": "COUNT","value": "softcheck.status='CREATED'"}подстановка будет заменена на кол-во мягких чеков со статусом CREATED.
Windows
Для 1. Для включения рассылки необходимо перейти перейдите в директорию с установленным SetKit. Открыть Откройте файл ./dist/set-kit.xml и добавить добавьте свойства.
Пример:
| Блок кода | ||
|---|---|---|
| ||
<service>
...
<argument>--notification.SetRetail.enabled=true</argument>
<argument>--notification.SetRetail.delayMinutes=15</argument>
<argument>--notification.SetRetail.ipAddresses=127.0.0.1,127.0.0.2:8090</argument> <!--для примера задано 2 адреса, второй адрес указан с портом-->
<argument>--notification.SetRetail.cashNumbers=1,2,3</argument> <!--заданы 3 кассы-->
<argument>--notification.SetRetail.message=Создано'Заказы создано: #{"type": "COUNT","value": "softcheck.status='CREATEDREADY_TO_PAYMENT'"}'</argument> <!--сообщение для отправки-->
...
</service> |
2. Перезапустите службу SetKit.
Linux
Под 1. Под линукс приложение запускается в контейнере docker, переходим перейдите в директорию, где находится docker-compose.yml и добавляем добавьте свойства.
| Блок кода | ||||
|---|---|---|---|---|
| ||||
version: "2.0"
services:
backend:
...
environment:
...
- notification.SetRetail.enabled=true
- notification.SetRetail.delayMinutes=15
- notification.SetRetail.ipAddresses=127.0.0.1,127.0.0.2:8090
- notification.SetRetail.cashNumbers=1,2,3
- notification.SetRetail.message=Создано'Заказы создано: #{"type": "COUNT","value": "softcheck.status='CREATEDREADY_TO_PAYMENT'"}'
...
... |
2. Перезапустите службу SetKit.
Пример работы
Визуализация на кассе
Кейс 1. Информирование о созданных заказах
- Покупатель создал новый заказ в интернет-магазине. Данный заказ передался и сохранился в SetKit со статусом "создан" [created]
- Планировщик в SetKit согласно заданному интервалу времени при опросе получил информацию о новом созданном заказе и передал сообщение на сервер Set
- Проверяем, что на кассе отобразилось сообщение:
Заказы Создано: 1 Отменено: 0
- Проверяем, что через указанный период времени сообщение повторно было отправлено и отобразилось на кассе
- Продавец собрал заказ и изменил статус в Интернет-магазине на "собран"
- В SetKit поступило изменение статуса заказа на "Готов к оплате" [ready_to_payment]
- Проверяем, что из SetKit более не поступало сообщений для отображения на кассе
Кейс 2. Информирование об отмененных заказах
- Покупатель отменил свой заказ в интернет-магазине. Данный заказ передался и сохранился в SetKit со статусом "отменен" [canceled]
- Планировщик в SetKit согласно заданному интервалу времени при опросе получил информацию об отмененном заказе и передал сообщение на сервер Set
- Проверяем, что на кассе отобразилось сообщение:
Заказы Создано: 0 Отменено: 1
- Проверяем, что через указанный период времени сообщение повторно было отправлено и отобразилось на кассе
- Продавец расформировал заказ и изменил статус в Интернет-магазине на "Расформирован"
- В SetKit по этому заказу пришла команда на его удаление
- Проверяем, что из SetKit более не поступало сообщений для отображения на кассе