Общее описание задачи

<Что просит сделать заказчик>

<Описание бизнес-цели изменений: что станет лучше если сделать изменение>

Необходимо решить несколько проблем:

1. Проверка разрешения продажи АМ на текущий момент проверяется только после добавления всех товаров в чек
   1. приводит к сложностям со сторнированием не прошедших проверку в УТМ товаров
2. Проверка разрешения продажи КМ строится на списке проданных КМ в данном магазине (черный список)
   1. приводит к возможностипродажи КМ не принадлежащих юр. лицу осуществляющему продажу
3. Отсутствует проверка соответствия ШК товара и АМ
   1. приводит к продаже товара ниже минимальной цены
4. Отсутствует возможность добавления товара в чек сканирование только АМ
   1. увеличивает время обслуживания

Как заказчик работает сейчас

<Конфигурация системы заказчика>

1. Какой клиент он использует (ukmclient или lillo)
2. Версия УКМ4
3. Общее количество касс
4. Используется ли внешняя система лояльности, если да, то какая

<Описание как заказчик работает с существующим функционалом>

User Stories

<Описание как будет использоваться измененный функционал заказчиком>

...

Для КиЗ уже имеется базовый режим добавления специального маркированного товара в чек
Если требуется  марки перед добавлением специального маркированного товара в чек:

1. Касса проверяет марку в СММ.
   a. Если марка проверена успешно, то товар добавляется в чек
   b. Если марка не проходит проверку, то кассиру показывается окно с сообщением "Марка товара не прошла проверку. Отложите данный товар". Товар не добавляется в чек.
   c. Если отсутствует связь с сервером проверки - переходим к US03.

Для алкогольного товара:

1. Кассир сканирует марку товара (определяется шаблоном ввода). Касса проверяет марку в СММ
   1. Если марка проверена успешно, то товар добавляется в чек
      
      1. Если товар не найден (сервер проверки возвращает пустой список ШК) , то кассиру показывается окно с сообщением "Товар не найден". Товар не добавляется в чек. 
         Для добавления товара можно воспользоваться сценарием US02.
      2. Если сервер проверки вернул список из нескольких штрих кодов товара - кассиру в открывшемся окне предлагается сканировать штрих код товара.
         - Если кассир закрывает окно - выдается сообщение "Товар не может быть добавлен в чек" и сценарий заканчивается. Товар не добавляется в чек. Для добавления товара можно воспользоваться сценарием US02.
         - Если считанный штрих код товара содержится в списке, присланном сервером проверки, товар добавляется в чек по этому штрих коду без повторного сканирования акцизной марки.
         - Если считанный штрих код товара НЕ содержится в списке, присланном сервером проверки - выдается сообщение "Товар не может быть добавлен в чек" сценарий заканчивается.
      3. Если отсутствует связь с сервером проверки, то кассиру показывается окно с сообщением "Сервер проверки марок недоступен. Сначала сканируйте штрих код товара". Товар не добавляется в чек. 
         Для добавления товара можно воспользоваться сценарием US02.
   2. Если марка не проходит проверку, то кассиру показывается окно с сообщением "Марка товара не прошла проверку. Отложите данный товар". Товар не добавляется в чек.

US02: Добавление товара сканирование штрих кода и акцизной марки

1. Кассир сканирует штрих код товара. Кассир сканирует акцизную марку товара. Касса проверяет марку, отправляя также информацию о штрих коде
   1. Если марка проверена успешно, то товар добавляется в чек
   2. Если марка не проходит проверку, то кассиру показывается окно с сообщением "Марка товара не прошла проверку. Отложите данный товар". Товар не добавляется в чек
   3. Если марка не соответсвует штрих коду, то кассиру показывается окно с сообщением "Товар не соответсвует акцизной марке. Отсканируйте повторно". Товар не добавляется в чек

US03: Строгое требование проверки марки (опция)

1. Запрет добавления товара не прошедшего проверку установлен
   1. - Если связь с проверяющим сервером отсутствует,  то кассиру показывается окно с сообщением "Сервер проверки марок недоступен. Отложите данный товар". Товар не добавляется в чек
2. Запрет добавления товара не прошедшего проверку не установлен
   1. - Если связь с проверяющим сервером отсутствует. Товар добавляется в чек

Концептуальное описание решения

Для всех способов добавления товаров в чек добавляется дополнительный шаг с отправкой марки в СММ для проверки

Для акцизной марки товар добавляется на основании информации от сервера проверки. Для контрольной марки товар добавляется на основании информации из самой марки

Техническое описание решения

В раздел "Параметры магазина и настройка операций/Интеграция" добавить новую интеграцию "СуперМагМарко"

Настройки хранить на уровне магазина (аналогично CWV)

Список настроек:

1. Включение/выключение интеграции
2. URL сервера СММ
3. Таймаут ожидания ответа (по умолчанию 2 секунды)
4. Тайм-аут ожидания ответа с изменением статуса марки (по умолчанию 30 секунд)
5. Опция "Тип маркированного товара для проверки" с мультивыбором из типов маркировки. Опция показывает какой тип маркированного товара следует проверять в СММ
   1. На текущий момент это будут:
      • Акцизный маркированный товар
      • Специальный маркированный товар
6. Опция "Запрет добавления товара не прошедшего проверку"

Добавить работу с АМ на уровне ШВ

На кассе в соответствии с настройками добавить асинхронную отправку марки в СММ коммитером.
Особенность:
Проверка алкогольной марки по сценарию US02 и асинхронная отправка марки в СММ не производится если не включена и не настроена интеграция с ЕГАИС.

Компоненты для изменения

<Перечень компонентов, которые будут затронуты изменением>

Версии ОС: Windows и Linux

Версии ПО: Ukmserver, Ukmclient и Lillo 

Функционал: интеграция с новым сервисом

Экранные формы: нет

Настройки: web

Импорт и экспорт: нет

Оборудование (с учетом прошивок): нет

Дополнительное логирование: подробный лог работы с новым сервисом под отдельной меткой

Лицензирование функционала: отдельная новая лицензия

Ограничения предложения

...

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

СуперМаг Марко получает информацию из внешней торговой системы о товарах с КиЗ, которые могут быть реализованы через кассу. Такие товары загружаются в систему с условным статусом «Не продан». Таким образом, в СуперМаг Марко хранится "связка" штрихкода определенного товара и его марки КиЗ, а также статус, показывающий, был ли продан товар, что позволяет добавлять не проданный ранее маркированный товар в чек на кассе считыванием одной только акцизной или контрольной марки, без считывания штрихкода. При считывании маркировки товара на кассе в процессе продажи или возврата, касса отправляет запрос на проверку возможности продажи/возврата считанного КиЗ, а сервер валидации обрабатывает такие запросы. В СуперМаг Марко также хранится информация об уже проданных КиЗ, что позволяет ему передавать в УКМ 4 данные о товарах, которые невозможно продать. СуперМаг Марко позволяет продать на кассе лишь те маркированные товары, которые не были проданы ранее, и оформить возврат только тех товаров с КиЗ, которые имеют статус «Продан». Помимо этого, СуперМаг Марко выгружает сводку об ошибках, возникших в процессе обработки запросов с касс и при приёме информации из торговой системы.

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

В торговой сети может быть установлено несколько серверов валидации. Каждый сервер валидации обслуживает один или несколько магазинов. Один магазин обслуживается только одним сервером валидации. Серверы валидации независимы друг от друга. 

Для начала работы с сервером валидации СуперМаг Марко необходимо приобрести соответствующую лицензию, а также убедиться в том, что для магазина приобретен и действует функционал ЕГАИС и на кассовом сервере УКМ 4 настроены необходимые шаблоны ввода для распознавания кассой соответствующих разновидностей марок.

Ниже приведены настройки шаблонов ввода для распознавания акцизной марки старого образца (68 символов) и нового образца (150 символов), необходимых для работы СуперМаг Марко с алкогольной продукцией. 

Режим интеграции с сервером валидации СуперМаг Марко настраивается на кассовом сервере УКМ 4 в разделе: Параметры магазина и настройка операций – Интеграция – СуперМарко (вкладка слева). По умолчанию, работа с СуперМаг Марко выключена. Активировать работу сервера можно, нажав кнопку Вкл:

Image Added

Поле активации СуперМаг Марко станут доступны следующие его настройки:

Image Added

Значения параметров Адрес сервера СуперМарко и Ид. торгового объекта предоставляются провайдером сервиса СуперМаг Марко. Тайм-аут ожидания информационного ответа, с, а также Тайм-аут ожидания ответа с изменением статуса марки, с указываются в секундах. Все поля обязательны для заполнения.

Далее, в настройках необходимо указать, какие виды товаров подлежат валидации через СуперМаг Марко:

Проверять Специальный маркированный товар – сервер будет использоваться для проверки товаров, маркированных КиЗ.

Запретить продажу, если сервер валидации недоступен – если данная настройка активирована, то в случае отсутствия связи с сервером валидации, на кассе невозможно будет продать не проверенный через СуперМаг Марко маркированный товар.

По окончании настроек, не забудьте нажать кнопку Сохранить.