О продукте
Требования к соблюдению правил реализации маркированной продукции ужесточаются день ото дня, а штрафы за нарушения доходят вплоть до лишения лицензии на ее реализацию.
Оборот маркированных товаров отслеживается государством на уровне каждого экземпляра в отдельности. Для этого на товар наносится КиЗ (контрольный идентифицирующий знак), который содержит уникальный номер экземпляра товара. Маркировка товаров происходит при их производстве или ввозе на территорию России. Существует единая государственная информационная система, которая аккумулирует информацию о движении маркированных товаров между юридическими лицами. Розничная продажа единицы маркированного товара фиксируется в данной системе как выбытие проданной единицы из оборота.
СуперМагМарко – это сервер валидации всей маркированной продукции, который предназначен для контроля продажи маркированных товаров любых типов (в том числе, алкоголя).
СуперМагМарко хранит в себе информацию о поставленных на учет марках, историю изменения статуса марок, информацию о событиях, возникающих при некорректной продаже маркированной продукции.
СуперМагМарко в режиме реального времени контролирует следующие параметры:
- Наличие марки в белом списке товаров и отсутствие в черном списке при ее реализации на кассе.
- Наличие марки в белом списке товаров и отсутствие в черном списке при ее возврате на кассе.
- Соответствие марки товару, с которым она реализуется на кассе.
СуперМагМарко постоянно развивается, чтобы соответствовать действующему законодательству, помогая розничным и оптовым продавцам соблюдать его требования легко и неукоснительно.
СуперМагМарко – это система, созданная с применением современного стека технологий разработки ПО; она поставляется вместе с бесплатными “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 приведен здесь.