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

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

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

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

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

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

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

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

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

User Stories

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

US01: Добавление товара сканированием марки

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

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

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

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

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

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

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

1. Функционал поиска товара по КМ уже реализован в УКМ4, поэтому данный сценарий для СММ не будет реализован
2. На кассе происходит только проверка марок, фиксация марки происходит на сервере магазина после репликации чека
3. Проверка происходит однократно при добавлении нового товара в чек