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

https://crystals.atlassian.net/browse/SRTS-4700

1 Описание
2 Ценность
- 2.1 Для покупателя:
3 Примеры работы
- 3.1 Сценарий 1: Клиенту подходит размер, но нужна помощь
- 3.2 Сценарий 2: Нужен другой цвет или размер
4 Варианты экрана
- 4.1 Экран «Состав товара»
- 4.2 Пример экрана с кнопкой вызова
5 Ограничения
6 Настройки

Описание

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

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

Ценность

Ускорение обслуживания. Консультант получает точный запрос и приходит уже с нужным товаром.
Снижение нагрузки на персонал. Продавцы не отвлекаются на вопросы «сколько стоит?» или «есть ли размер?» — киоск отвечает автоматически.
Повышение клиентского опыта. Современный, цифровой сценарий формирует лояльность.

Для покупателя:

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

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

Сценарий 1: Клиенту подходит размер, но нужна помощь

Покупатель в примерочной сканирует штрихкод товара на прайсчекере.
На экране появляется карточка: цена, скидка, состав, статус «В магазине: последний товар».
Покупатель нажимает кнопку «Вызвать консультанта» (без выбора конкретного размера).
Текст кнопки меняется на «Скоро придем», а в SetGalya уведомление: «Подойдите в примерочную №3».
Консультант приходит с тем же товаром.

Сценарий 2: Нужен другой цвет или размер

Покупатель сканирует товар → открывается карточка.
Он видит, что нужного размера нет на витрине, но нажимает «Все размеры и цвета».
Система показывает остатки по магазину: «Размер L — 2 шт., цвет черный — в наличии».
Покупатель выбирает вариант и нажимает «Попросить принести».
В SetGalya отправляется детальное сообщение по шаблону bringProductMessageTemplateWithFittingRoom:
«Принесите в примерочную №3,
Кроссовки RalfRinger,
ШК: 4601234567890,
Артикул: RR-001»
Шаблон поддерживает подстановки: {fittingRoom}, {title}, {barcode}, {marking}. Размер и цвет не передаются отдельными полями — консультант определяет их по артикулу и штрихкоду варианта товара.
Консультант приносит товар, определив размер и цвет по артикулу и штрихкоду.

Варианты экрана

Реализовано на четырех ключевых состояниях интерфейса:

Экран	Что видит пользователь	Действия

Экран	Что видит пользователь	Действия
Стартовый экран	Инструкция по сканированию, логотип, область для штрихкода	Ожидание сканирования товара (ШК / DataMatrix)
Карточка товара	Фото, название, цена старая/новая, % скидки, наличие, кнопки: «Состав», «Все размеры и цвета», «Вызвать консультанта»	Запрос консультанта, переход к размерам, просмотр состава
Все размеры и цвета	Список доступных вариантов с указанием количества в магазине	Выбор конкретного размера/цвета и отправка запроса на принесение
Состав товара	Информация о составе и/или описании товара (переиспользуется текущая реализация SetKiosk)	Просмотр состава, кнопка «Назад» для возврата к карточке товара

Экран «Состав товара»

При нажатии на кнопку «Состав» на карточке товара прайсчекер отображает экран с информацией о составе и/или описании товара. Данный экран переиспользует текущую реализацию SetKiosk — дополнительная настройка не требуется. Для возврата к карточке товара покупатель нажимает кнопку «Назад».

Также предусмотрен экран ошибки (если данные не загружены за 30 секунд) — с автоматическим возвратом на стартовый экран.

Пример экрана с кнопкой вызова

Ограничения

Требуется интеграция с SetCentrum (получение карточки товара) и SetMark / SetStock (получение остатков по магазинам).
Необходимо подключение к SetGalya для доставки сообщений консультантам. Без этого вызов консультанта работать не будет.
Наличие подключенного сканера штрихкодов / DataMatrix на прайсчекере.
Номер примерочной должен быть задан в конфигурации терминала, иначе сообщения будут отправляться без номера (что снижает эффективность).
Защита от множественных нажатий — при быстром повторном клике повторный запрос не отправляется.

Настройки

1. Откройте на редактирование конфигурационный файл службы SetKiosk /opt/set-kiosk/application.yaml

Настройка номера примерочной

Номер примерочной задаётся на этапе первоначальной настройки терминала одним из двух способов:

Ручной ввод — введите номер примерочной в поле ввода на экране настройки.
Сканирование QR-кода — отсканируйте QR-код, в котором закодирована переменная fittingRoom.

Номер примерочной подставляется в шаблоны сообщений SetGalya: bringProductMessageTemplateWithFittingRoom и callConsultantMessageWithFittingRoom. Если номер не задан, система использует шаблоны без номера примерочной: bringProductMessageTemplateWithoutFittingRoom и callConsultantMessageWithoutFittingRoom.

Настройки лицензирования

Установите параметры подключения к Агенту лицензирования.

Параметр	Значение / Пример	Описание

Параметр	Значение / Пример	Описание
`address`	`testsetagent.domain.local:8089`	Адрес Агента лицензирования (хост:порт)
`shopNumber`	`1698`	Номер магазина или `0` для SetCentrum

Настройки SetRetail10

Установите параметры подключения к серверу SetRetail10 для получения информации о товаре: карточки товара, цены, скидки и изображений.

Параметр	Значение / Пример	Описание

Параметр	Значение / Пример	Описание
`enabled`	`true`	Включение / отключение интеграции с Set10
`baseUrl`	`http://172.29.16.98:8090/SetKiosk-API/json/details`	Адрес сервиса Set10. Если задан `storeMap`, адрес формируется по данным маппинга
`connectionTimeout`	`5000`	Таймаут установки соединения (в миллисекундах)
`readTimeout`	`5000`	Таймаут чтения данных (в миллисекундах)
`storeMap`	Закомментирован: `# 1: 172.27.64.37`	Сопоставление номеров магазинов с IP-адресами серверов Set10. Если не задано, используется `baseUrl`

Настройки SetMark

Установите параметры подключения к SetMark для получения остатков товара по размерам и цветам в магазине. Без этих настроек экран «Все размеры и цвета» работать не будет.

Параметр	Значение / Пример	Описание

Параметр	Значение / Пример	Описание
`enabled`	`true`	Включение / отключение интеграции с SetMark
`baseUrl`	`http://172.29.12.225:9000`	Базовый URL сервиса SetMark (хост и порт)
`connectionTimeout`	`5000`	Таймаут установки соединения (в миллисекундах)
`readTimeout`	`5000`	Таймаут чтения данных (в миллисекундах)
`stockPathPrefix`	`api/internal/v1/stock/shop`	Путь к API остатков. Итоговый URL: `GET {baseUrl}/{stockPathPrefix}/{номер магазина}?code={артикул}&searchType=...&searchArea=...`
`searchType`	`SKU`	Тип поиска товара. Допустимые значения: `GTIN`, `SKU`, `ERP`. По умолчанию `GTIN`
`searchArea`	`SHOP`	Зона поиска остатков. Допустимые значения: `SHOP`, `CITY`, `REGION`, `NETWORK`. Для примерочной всегда `SHOP`
`storeMap`	Закомментирован: `# "1": 172.29.16.105`	Сопоставление номеров магазинов с IP-адресами серверов SetMark. Если не задано, используется `baseUrl`

2. Установите параметры подключения к SetGalya для уведомления консультанта.

Параметр	Значение / Пример	Описание

Параметр	Значение / Пример	Описание
`enabled`	`true`	Включение / отключение функциональности (логическое значение)
`apiServiceUrl`	`http://172.27.64.83:8087/core`	Базовый URL для API-сервиса (ядро)
`authServiceUrl`	`http://172.27.64.83:8087/auth`	Базовый URL для сервиса аутентификации
`login`	`crystal`	Логин для авторизации
`password`	`Запросите пароль в службе поддержки CSI`	Пароль для авторизации
`socketTimeout`	`25000`	Таймаут сокета (в миллисекундах)
`connectionTimeout`	`25000`	Таймаут установки соединения (в миллисекундах)
`connectionRequestTimeout`	`25000`	Таймаут ожидания соединения из пула (в миллисекундах)
`readTimeout`	`25000`	Таймаут чтения данных (в миллисекундах)
`intentTitle`	`"Внимание"`	Заголовок сообщения / интента
`bringProductMessageTemplateWithFittingRoom`	Многострочный текст с подстановками `{fittingRoom}`, `{title}`, `{barcode}`, `{marking}`	Шаблон сообщения для приноса товара с указанием номера примерочной
`bringProductMessageTemplateWithoutFittingRoom`	Многострочный текст с подстановками `{title}`, `{barcode}`, `{marking}`	Шаблон сообщения для приноса товара без указания номера примерочной (если `fittingRoom` не передан в запросе)
`callConsultantMessageWithFittingRoom`	`"Подойдите в примерочную №{fittingRoom}"`	Шаблон вызова консультанта с указанием номера примерочной
`callConsultantMessageWithoutFittingRoom`	`"Подойдите в примерочную"`	Шаблон вызова консультанта без указания номера примерочной (если `fittingRoom` не передан в запросе)
`storeMap`	Закомментирован: `# "1": 172.29.16.105`	Сопоставление (маппинг) идентификаторов магазинов с IP-адресами (в данном примере отключено)

Дополнительные настройки

Тексты на кнопках («Вызвать консультанта» / «Попросить принести» и их изменённые состояния «Скоро придем» / «Уже идут»).
Визуальное оформление брендовой зоны (логотип, цветовая схема).
Поведение при отсутствии номера примерочной (отправлять сообщение без номера или блокировать вызов).

SetKiosk ◾️SetKiosk ◾️ Вызов консультанта в примерочную