СуперМагМарко

О продукте

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

Оборот маркированных товаров отслеживается государством на уровне каждого экземпляра в отдельности. Для этого на товар наносится КиЗ (контрольный идентифицирующий знак), который содержит уникальный номер экземпляра товара. Маркировка товаров происходит при их производстве или ввозе на территорию России. Существует единая государственная информационная система, которая аккумулирует информацию о движении маркированных товаров между юридическими лицами. Розничная продажа единицы маркированного товара приводит к его выбытию из оборота в этой информационной системе.

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

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

СуперМагМарко в режиме реального времени контролирует следующие параметры:

• Наличие марки в белом списке товаров и отсутствие в черном списке при ее реализации на кассе.

• Наличие марки в белом списке товаров и отсутствие в черном списке при ее возврате на кассе.

• Соответствие марки товару, с которым она реализуется на кассе.

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

СуперМагМарко – это система, созданная с применением современного стека технологий разработки ПО; она поставляется вкупе с бесплатными “Open source”-решениями Linux и MariaDB.       

СуперМагМарко может разворачивается в отказоустойчивый кластер с высокой степенью доступности на базе Kubernetes K8S.

Архитектура решения

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

1. Централизованная структура.

Централизованная архитектура подходит компаниям с централизованной приемкой товаров по правилам ЕГАИС 3.0 на третий регистр, а также тем, кто не готов создавать  дополнительные узлы системы на уровне торговых точек.

Централизованное размещение сервиса оправдано в случае, когда на уровне торговых объектов нет и не планируется размещать необходимое для работы СуперМагМарко  аппаратное обеспечение.

При централизованном размещении повышаются требования к доступности и отказоустойчивости сервиса СуперМагМарко, на что мы отвечаем развертыванием СуперМагМарко в кластере K8S, либо Докер-контейнере – Docker Compose.

2. Децентрализованная структура.

Децентрализованная архитектура подходит компаниям с приемкой товаров по правилам ЕГАИС 3.0 на третий регистр на уровне торговых объектов, а также тем, кто имеет или планирует иметь необходимые аппаратные мощности на уровне торговой точки.

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

Функциональные возможности

• Загрузка данных о марках и кодах товара через открытый REST API (HTTP).
• Обмен с кассовой системой через открытый REST API (HTTP).

• Выводим на  монитор данные о работоспособности.

• Не останавливаем продажи в случае недоступности сервиса.

• 1. Функциональные возможности: (Подробности в Swagger схемах)
  • 1.1. REST API импорта данных (Загрузка данных в СуперМарко) - “loader_service”
• Возможность: Добавлять КИЗ, корректировать параметры записи о КИЗ, удалять КИЗ
  • 1.2. REST API продажи (возврата) КИЗ на кассе - “validation_service”
• Возможность: контролировать валидность марки при продаже и возврате
  • 1.3. REST API экспорта записей об ошибках в обработке КИЗ - “errorlog”
• Возможность: По запросу получать перечень ошибок записанных в Журнале
  • 1.4. REST API экспорта истории изменения КИЗ - “statechangelog”
• Возможность: По запросу получать информацию об истории изменения записи о КИЗ

- дата-время изменения, статус, сопоставленные коды товара, коды магазина, ссылка на документ.

• 1. История изменения состояний марки:
• Продана - если марка была продана на кассе или ТС выгрузила ее в этом статусе
• Не продана - если марка не была продана на кассе или ТС выгрузила ее в этом статусе
• Время изменения состояния - дата и время изменения
• Источник (чек либо внешняя система) - кто был инициатором изменения

• 2. История событий:
• Попытка повторной продажи - Попытка повторного возврата
• Попытка продажи товара с несоответствующей ему КИЗ
• Попытка продажи товара с КИЗ другой торговой точки
• Попытка продажи товара с КИЗ отсутствующей в СуперМарко
• Внесение изменений в состояние КИЗ торговой системой

• 3. Информирование об ошибках:
• Попытка повторной продажи - «Товар с КИЗ (маркой) ХХХ уже был продан»
• Попытка повторного возврата - «Товар с КИЗ (маркой) ХХХ был возвращен или не был продан»
• Попытка продажи товара с несоответствующей ему КИЗ - «КИЗ (марка) не соответствует товару»
• Попытка продажи или возврата товара с КИЗ другой торговой точки - «КИЗ (марка) не может быть продана/возвращена в этом магазине»
• Попытка продажи товара с КИЗ, отсутствующей в базе - «КИЗ (марка) не принята на баланс»

• 4. Журнал событий:
  • 4.1. Период хранения информации в Журнале – 2 недели (не настраивается)
  • 4.2. События, которые регистрируются в Журнале: