О продукте
Требования к соблюдению правил реализации маркированной продукции ужесточаются день ото дня, а штрафы за нарушения доходят вплоть до лишения лицензии на ее реализацию.
Оборот маркированных товаров отслеживается государством на уровне каждого экземпляра в отдельности. Для этого на товар наносится КиЗ (контрольный идентифицирующий знак), который содержит уникальный номер экземпляра товара. Маркировка товаров происходит при их производстве или ввозе на территорию России. Существует единая государственная информационная система, которая аккумулирует информацию о движении маркированных товаров между юридическими лицами. Розничная продажа единицы маркированного товара фиксируется в данной системе как выбытие проданной единицы из оборота.
СуперМаг Марко – это сервер валидации всей маркированной продукции, который предназначен для контроля продажи маркированных товаров любых типов (в том числе, алкоголя).
СуперМаг Марко хранит в себе информацию о поставленных на учет марках, историю изменения статуса марок, информацию о событиях, возникающих при некорректной продаже маркированной продукции.
СуперМаг Марко в режиме реального времени контролирует следующие параметры:
- Наличие марки в белом списке товаров и отсутствие в черном списке при ее реализации на кассе.
- Наличие марки в белом списке товаров и отсутствие в черном списке при ее возврате на кассе.
- Соответствие марки товару, с которым она реализуется на кассе.
СуперМаг Марко постоянно развивается, чтобы соответствовать действующему законодательству, помогая розничным и оптовым продавцам соблюдать его требования легко и неукоснительно.
СуперМаг Марко – это система, созданная с применением современного стека технологий разработки ПО; она поставляется вместе с бесплатными “Open source”-решениями Linux и MariaDB.
СуперМаг Марко может разворачивается в отказоустойчивый кластер с высокой степенью доступности на базе Kubernetes K8S.
Архитектура решения
Существует два варианта организации системы валидации маркированной продукции с помощью СуперМаг Марко:
1. Централизованная структура
Централизованная архитектура подходит компаниям с централизованной приемкой товаров по правилам ЕГАИС 3.0 на третий регистр, а также тем, кто не готов создавать дополнительные узлы системы на уровне торговых точек.
Централизованное размещение сервиса оправдано в случае, когда на уровне торговых объектов нет и не планируется размещать необходимое для работы СуперМаг Марко аппаратное обеспечение.
При централизованном размещении повышаются требования к доступности и отказоустойчивости сервиса СуперМаг Марко, на что мы отвечаем развертыванием СуперМаг Марко в кластере K8S, либо Докер-контейнере – Docker Compose.
2. Децентрализованная структура
Децентрализованная архитектура подходит компаниям с приемкой товаров по правилам ЕГАИС 3.0 на третий регистр на уровне торговых объектов, а также тем, кто имеет или планирует иметь необходимые аппаратные мощности на уровне торговой точки.
При децентрализованном размещении требования к доступности и отказоустойчивости сервиса СуперМаг Марко снижаются, особенно в части сетевой инфраструктуры.
Функциональные возможности
В торговой сети может быть установлено несколько серверов валидации. Каждый сервер валидации обслуживает один или несколько магазинов. Один магазин обслуживается только одним сервером валидации. Серверы валидации независимы друг от друга. Возможен вывод на экран кассира данных о работоспособности СуперМаг Марко, что позволяет своевременно узнавать о его недоступности без необходимости приостанавливать продажи.
СуперМаг Марко получает информацию из внешней торговой системы о товарах с КиЗ, которые могут быть реализованы через кассу. Такие товары загружаются в систему с условным статусом «Не продан». Таким образом, в СуперМаг Марко хранится "связка" штрихкода определенного товара и его марки КиЗ, а также статус, показывающий, был ли продан товар, что позволяет добавлять не проданный ранее маркированный товар в чек на кассе считыванием одной только акцизной или контрольной марки, без считывания штрихкода. При считывании маркировки товара на кассе в процессе продажи или возврата, касса отправляет запрос на проверку возможности продажи/возврата считанного КиЗ, а сервер валидации обрабатывает такие запросы. В СуперМаг Марко также хранится информация об уже проданных КиЗ, что позволяет ему передавать в УКМ 4 данные о товарах, которые невозможно продать. СуперМаг Марко позволяет продать на кассе лишь те маркированные товары, которые не были проданы ранее, и оформить возврат только тех товаров с КиЗ, которые имеют статус «Продан». Помимо этого, СуперМаг Марко выгружает сводку об ошибках, возникших в процессе обработки запросов с касс и при приёме информации из торговой системы.
Загрузка данных о марках и кодах товара из торговой системы на сервер валидации, а также обмен данными между сервером валидации и кассовой системой осуществляются через открытый REST-API (HTTP), отраженный в следующих swagger-схемах:
| Схема | Функционал |
|---|---|
| loader_service – импорт данных (загрузка данных в СуперМаг Марко) | Добавлять КиЗ, корректировать параметры записи о КиЗ, удалять КиЗ |
validation_service – продажа (возврат) КиЗ на кассе | Контролировать валидность марки при продаже и возврате |
| errorlog – экспорт записей об ошибках в обработке КиЗ | По запросу получать перечень ошибок, записанных в журнале |
| statechangelog – экспорт истории изменения КиЗ | По запросу получать информацию об истории изменения записи о КиЗ: дата-время изменения, источник/инициатор изменения (чек или внешняя система), статус, сопоставленные коды товара, коды магазина, ссылка на документ |
В журнале СуперМаг Марко отражаются следующие события:
Попытка повторной активации КиЗ | Загрузка из торговой системы маркированного товара со статусом «Не продан», имеющего в СуперМаг Марко статус «Продан» |
| Попытка продажи неизвестного КиЗ | Попытка продажи маркированного товара, сведения и КиЗ которого отсутствуют |
Попытка повторной продажи КиЗ | Попытка продажи уже проданного маркированного товара |
| Попытка повторного возврата КиЗ | Попытка возврата уже возвращенного ранее маркированного товара |
Попытка возврата ранее не проданного КиЗ | Попытка возврата маркированного товара, данных о продаже которого нет |
| Попытка продажи/возврата КиЗ другого магазина | Попытка продажи/возврата в одной торговой точке маркированного товара, зарегистрированного в другой торговой точке (в случае, если продажа КиЗ ограничена магазином) – независимо от статуса КиЗ |
Несоответствие КиЗ товару | Попытка регистрации на кассе маркированного товара, КиЗ которого не прошёл проверку соответствия марки товару, осуществляемой по штрихкоду – независимо от статуса КиЗ |
Попытка ввода некорректного КиЗ | Попытка регистрации на кассе маркированного товара, КиЗ которого не прошёл проверку на корректность формата |
| Внесение изменений в состояние КиЗ, осуществляемое торговой системой | Фиксация даты и времени изменения, инициатора изменения (внешняя система), статуса КиЗ, сопоставленных кодов товара, кода магазина, а также ссылка на документ |
В случае разрыва связи между СуперМаг Марко и кассой, на экран кассира выводится сообщение о том, что сервер валидации марок недоступен. Приостановления процесса продаж при этом не требуется. В течение всего периода отсутствия online-связи с сервером валидации, на нем накапливается очередь на регистрацию КиЗ в режиме offline. После восстановления связи, все марки, проданные на кассе в режиме оffline, регистрируются в СуперМаг Марко как проданные, а все возвращенные – как возвращённые.
Функциональные ограничения СуперМаг Марко:
1. Контроль минимальной и максимальной цены реализован на уровне кассовой системы, а не сервера валидации.
2. Аналитика событий сервера СуперМаг Марко производится во внешней системе.
3. Период хранения событий в журнале сервера валидации составляет 2 недели и не регулируется пользователем.
Как начать работать с СуперМаг Марко
Для установки и корректной работы СуперМаг Марко необходимо выполнение определенных системных требований, которые рассчитываются командой разработки индивидуально для каждого конкретного случая и зависят от мощности и конфигурации сервера, а также от количества запросов на один сервер и требований к отказоустойчивости и доступности.
Для начала работы с сервером валидации, необходимо приобрести соответствующую лицензию, а также выполнить настройки по интеграции СуперМаг Марко с кассовой системой. Пример настроек интеграции сервера валидации с кассовой системой УКМ 4 приведен здесь.