SetTouch ◾️ Плагин проверки остатков по характеристикам товара

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

SetTouch ◾️ Плагин проверки остатков по характеристикам товара

https://crystals.atlassian.net/browse/SRTF-529

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

10.4.24.0

Описание

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

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

Ценность

Плагин решает ключевую задачу оперативного информирования покупателей:

  • Повышает качество обслуживания за счет актуальной информации об остатках.

  • Позволяет быстро находить товар в других магазинах сети.

 

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

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

1. Кассир нажимает кнопку, добавленную в меню.

image-20260630-121952.png

 

2. Открывается форма поиска товара. На ней можно искать товар по части кода товара, ШК или названию. Форма поиска стандартная.

Форма содержит столбцы: Товар (название, цвет и размер), Штрихкод, Склад, В наличии.

image-20260319-104122.png

 

3. После нахождения товара и выбора кассиром конкретного товара (выделение конкретного товара), откроется форма с данными по найденному товару в текущем магазине.

image-20260630-123352.png

 

4. Остатки по разным складам объединяются под одним товаром, без лишних повторов.

  • Поиск товара по всей сети. Для поиска товара по всей сети необходимо нажать на нужную позицию.

  • По кнопке Закрыть форма закрывается, и касса возвращается в режим продажи.

image-20260630-124304.png

 

 

Получение остатка по товару во всех магазинах сети

При выборе конкретного товара на форме 1 и нажатии на него открывается форма 2 с названием магазина/склада и остатками по конкретному ШК в магазинах сети.

  • [К выбору товара] — возвращает на форму с остатками в текущем магазине.

  • [Закрыть] — форма закрывается, и касса возвращается в режим продажи.

image-20260630-124500.png

Ограничения

  • Работает только на SetTouch

  • Требуемая версия кассы: 10.4.24+

  • Топология: Centrum-POS

  • Корректная работа возможна только при:

    • привязке всех ШК (цвет/размер) к одному артикулу

  • Порядок отображения магазинов:

    • Название → Город → Адрес

Настройки

Плагин находится на кассе по умолчанию.

1. На сервере SetCentrum/SetRetail10 перейдите в раздел ИнтеграцияВнешние процессинги → кликните .

image-20260630-085009.png

 

2. Добавьте процессинг.

image-20260630-085246.png

 

3. Кликните процессинг для настройки.

image-20260630-085403.png

 

4. Введите данные для подключения к процессингу.

Настройка

Описание

Обязательный

Настройка

Описание

Обязательный

Адрес процессинга

URL подключения к сервису остатков

Да

Таймаут соединения (сек.)

Время ожидания установки соединения

Нет

Таймаут ответа (сек.)

Время ожидания ответа от сервиса

Нет

Логин

Логин для Basic-аутентификации

Нет

Пароль

Пароль для Basic-аутентификации

Нет

Аутентификация опциональна: если поле Логин не заполнено, запросы отправляются без аутентификации. Если логин указан, при обращении к процессингу добавляется HTTP-заголовок Authorization: Basic <логин:пароль в Base64>.

image-20260630-085613.png

 

5. Перейдите в Кассовый модуль → Настройки интерфейса → добавьте или откройте существующий шаблон кассы SetTouch.

image-20260630-085853.png

 

6. Кликните по любой кнопке для добавления функции → добавьте процессинг Сервис проверки остатков по характеристикам товара.

Кнопка загрузится в интерфейс кассы без перезагрузки.

image-20260630-121659.png

Интеграция с сервисом остатков

Запросы к сервису выполняются через HTTP POST в формате JSON. Для получения остатков в текущем магазине передаются артикул товара и номер магазина:

{ "article": "00001", "shop": "6502" }

Для получения остатков по всем магазинам сети передается штрихкод товара без номера магазина:

{ "barcode": "12345679" }

Ответ сервиса должен содержать массив shops с данными по магазинам и массивом balance по остаткам товара.

{ "shops": [ { "name": "Магазин", "address": "Адрес магазина", "number": "224", "balance": [ { "barcode": "978020137962445", "name": "Куртка спортивная черная размер XL", "stock": 10 } ] } ] }

Для сценариев с несколькими складами одного магазина сервис может вернуть несколько остатков по одному товару. На кассе повторяющиеся строки по ШК и товару скрываются, а остатки отображаются сгруппированно по складам.