Описание

https://crystals.atlassian.net/browse/SR-2564

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

10.2.61.0

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

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

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

Условия

SetKit и SetRetail доступны.
В SetKit установлены настройки отправки сообщений.

Схема работы

Дополнительная информация и ограничения

1. Входящие параметры WS передачи сообщений на кассы

Входящий параметр	Обязательность	Тип данных	Ограничения\особенности

Входящий параметр	Обязательность	Тип данных	Ограничения\особенности
Сообщение кассиру	Да	Строка	Максимально 50 символов
Номера магазинов	Нет	Число	Несколько номеров магазинов передаются через запятую. Если атрибут отсутствует, то сообщение будет отправлено на все магазины сети
Номера касс	Нет	Число	Несколько номеров касс передаются через запятую. Если атрибут отсутствует, то сообщение будет отправлено на все касс

2. Возможность отправки сообщений из SetKit по умолчанию выключена и настраивается согласно инструкции ниже.

3. В случае отсутствия связи между SetKit и сервером SetRetail, сообщения доставлены не будут.

4. Время отображения сообщений на кассе настраиваемое (по умолчанию 1 минута).

5. Сообщения кассиру не отображаются когда на кассе не авторизован кассир или касса находится в простое (запущен скринсейвер).

Настройка SetKit

https://crystals.atlassian.net/browse/KIT-51

1.0.4

SetKit предоставляет возможность отправлять в SetRetail10 информацию по мягким чекам. Каждые N минут происходит отправка сформированного сообщения.

По умолчанию рассылка на SetKit выключена.

Конфигурирование уведомлений производится следующими свойствами:

Свойство	Определение	Тип	По умолчанию

Свойство	Определение	Тип	По умолчанию
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'"}'` Дополнительный пример для всех статусов: `'Заказы Созд:#{"type":"COUNT","value":"softcheck.status='CREATED'"} К оплате:#{"type":"COUNT","value":"softcheck.status='READY_TO_PAYMENT'"} Отм:#{"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='READY_TO_PAYMENT'"}'</argument> <!--сообщение для отправки-->
	...
</service>

2. Перезапустите службу SetKit.

Linux

1. Под линукс приложение запускается в контейнере docker, перейдите в директорию, где находится docker-compose.yml и добавьте свойства.

Linux 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='READY_TO_PAYMENT'"}'
      ...
    ...

2. Перезапустите службу SetKit.

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

По умолчанию на POS-кассе всплывающее сообщение отображается 60 секунд. Если кассиру требуется видеть уведомление о наличии созданных или отмененных заказов дольше, необходимо изменить время жизни кассового сообщения.

Настройка нужна для того, чтобы уведомления SetKit не исчезали слишком быстро и кассир успевал отреагировать на новые заказы: принять их в работу, собрать заказ или обработать отмену. Это особенно важно, если кассир находится в режиме продажи и не может сразу переключиться на обработку заказа.

Для изменения времени отображения добавьте в SMP кассы свойство cash.message.live.time и укажите требуемое значение в секундах.

Скрипт добавления свойства со значением по умолчанию 60 секунд:

SELECT add_property('SET_CASH', 'cash.message.live.time', '60', 'Время отображения всплывающего сообщения на кассе в сек.', 10, 2, 0);

После добавления свойства задайте нужное значение параметра cash.message.live.time в настройках кассы.

Настройка применима для POS-касс. Для Touch-решения на версии 10.4.19.7 настройка также работает. При использовании неблокирующих уведомлений, доработанных с 10.4.23.0, время отображения составляет 7 секунд и данной настройкой не управляется.

Пример работы

Визуализация на кассе

Кейс 1. Информирование о созданных заказах

Покупатель создал новый заказ в интернет-магазине. Данный заказ передался и сохранился в SetKit со статусом "создан" [created]
Планировщик в SetKit согласно заданному интервалу времени при опросе получил информацию о новом созданном заказе и передал сообщение на сервер Set
Проверяем, что на кассе отобразилось сообщение: Заказы Создано: 1 Отменено: 0
Проверяем, что через указанный период времени сообщение повторно было отправлено и отобразилось на кассе
Продавец собрал заказ и изменил статус в Интернет-магазине на "собран"
- В SetKit поступило изменение статуса заказа на "Готов к оплате" [ready_to_payment]
Проверяем, что из SetKit более не поступало сообщений для отображения на кассе

Кейс 2. Информирование об отмененных заказах

Покупатель отменил свой заказ в интернет-магазине. Данный заказ передался и сохранился в SetKit со статусом "отменен" [canceled]
Планировщик в SetKit согласно заданному интервалу времени при опросе получил информацию об отмененном заказе и передал сообщение на сервер Set
Проверяем, что на кассе отобразилось сообщение: Заказы Создано: 0 Отменено: 1
Проверяем, что через указанный период времени сообщение повторно было отправлено и отобразилось на кассе
Продавец расформировал заказ и изменил статус в Интернет-магазине на "Расформирован"
- В SetKit по этому заказу пришла команда на его удаление
Проверяем, что из SetKit более не поступало сообщений для отображения на кассе

SetKit ◾️ Уведомления кассиров о созданных и отмененных заказах из SetKit на кассы