История страницы

Пользование данным продуктом требует наличия соответствующего вида лицензии!

О продукте

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

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

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

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

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

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

• Наличие марки в белом списке товаров (согласно документам поступления, полученным с помощью систем электронного документооборота) и отсутствие в черном списке (согласно документам отгрузки юр. лицам и документам списания) при ее реализации на кассе.

...

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

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

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

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

...

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

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

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

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

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

...

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

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

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

Image Modified

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

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

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

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

...

• 1.1. REST API импорта данных (Загрузка данных в СуперМарко) - “loader_service”

...

• 1.2. REST API продажи (возврата) КИЗ на кассе - “validation_service”

...

• 1.3. REST API экспорта записей об ошибках в обработке КИЗ - “errorlog”

...

• 1.4. REST API экспорта истории изменения КИЗ - “statechangelog”

...

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

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

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

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

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

Один раз в сутки, в 1:00 ночи, система автоматически удаляет марки товаров в статусе «Продан», если с момента перевода их в этот статус прошло более 1 месяца (при необходимости, данный срок можно продлить, изменив настройки СуперМаг Марко). Помимо всего перечисленного, СуперМаг Марко выгружает сводку об ошибках, возникших в процессе обработки запросов с касс и при приёме информации из торговой системы.

Загрузка данных о марках и кодах товара из торговой системы на сервер валидации, а также обмен данными между сервером валидации и кассовой системой осуществляются через открытый REST-API (HTTP), отраженный в следующих swagger-схемах:

...

...

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

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

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

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

...

Повторная активизация КИЗ

...

Загрузка из ТС КИЗ со статусом «не продан», но в СММ он имеет статус «продан»

...

Повторная продажа

...

Попытка продажи уже проданного КИЗ.

...

Возврат ранее непроданного КИЗ

...

Попытка возврата КИЗ, которого нет в проданных.

...

Продажа/возврат КИЗ другого магазина

...

Если продажа КИЗ ограничена магазином и не пройдена проверка на соответствие КИЗ и магазина (независимо от статуса КИЗ)

...

КИЗ не соответствует товару

...

Если к КИЗ привязан код (коды) товара, к которому он относится, и не пройдена проверка соответствия КИЗ и товара по коду (штрихкоду) (независимо от статуса КИЗ)

...

Введён некорректный КИЗ

...

КИЗ не прошёл проверку на корректность формата

• 1. Работа в режиме Offline на кассе УКМ4\УКМ5:
  • 1.1. Вывод сообщения на экран кассира, что сервер валидации марок недоступен
• “Сервис валидации марок недоступен, обратитесь в тех. поддержку и продолжайте работу”
  • 1.2. Очередь на регистрацию марок в СММ в режиме offline
  • 1.3. После восстановления связи, все проданные в режиме Offline на кассе марки, должны быть записаны на СММ как проданные, все возвращенные, как возвращённые.

1. Ограничения:

• 1. Контроль минимальной, максимальной цены, реализован на уровне кассовой системы
• 2. Аналитика событий сервиса СММ, производится во внешней системе
• 3. Период хранению в журнале информации о событиях - 2 недели

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

...

В журнале СуперМаг Марко отражаются следующие события:

В случае разрыва связи между СуперМаг Марко и кассой, на экран кассира выводится сообщение о том, что сервер валидации марок недоступен. Приостановления процесса продаж при этом не требуется. В течение всего периода отсутствия online-связи с сервером валидации, на нем накапливается очередь на регистрацию КиЗ в режиме offline. После восстановления связи, все марки, проданные на кассе в режиме оffline, регистрируются в СуперМаг Марко как проданные, а все возвращенные – как возвращённые.

Функциональные ограничения СуперМаг Марко:

1. Контроль минимальной и максимальной цены реализован на уровне кассовой системы, а не сервера валидации.

2. Аналитика событий сервера СуперМаг Марко производится во внешней системе.

3. Период хранения событий в журнале сервера валидации составляет 2 недели и не регулируется пользователем.

Как начать работать с СуперМаг Марко

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

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

API интеграции с системой можно найти здесь.