Ключевые принципы работы с маркировкой (KM) в Smartup
Ключевые принципы — это базовые правила, на которых строится вся логика работы с маркировкой (KM) в Smartup. Понимание этих принципов позволяет правильно выстраивать процессы, быстрее находить причины ошибок и корректно работать с маркированным товаром на всех этапах.
Для чего важно знать ключевые принципы?
  • корректная работа с KM на всех этапах жизненного цикла товара;
  • быстрое выявление причин типовых ошибок;
  • снижение рисков блокировок операций;
  • понимание роли Smartup и внешних систем.
Основные принципы
Принцип 1.

Asl Belgisi / XTrace — единственный источник истины по статусу KM

Система Asl Belgisi (XTrace) является государственным контуром маркировки и единственным источником достоверной информации о кодах маркировки (KM).
Именно она определяет, где находится каждый KM, кому он принадлежит и в каком статусе он находится.
Smartup и другие учетные системы не принимают самостоятельных решений по статусу KM, а лишь запрашивают и отображают информацию, полученную из Asl Belgisi.

Что именно хранится и контролируется в Asl Belgisi
В системе Asl Belgisi для каждого KM фиксируется:
  • текущий владелец (организация);
  • уровень маркировки (штука / блок / паллет);
  • статус KM:
  • «в обороте»,
  • «на балансе компании»,
  • «на VAN»,
  • «выведен из оборота»;
  • история всех операций:
  • приёмка,
  • агрегация / дезагрегация,
  • отгрузка,
  • продажа.
Любая операция с маркированным товаром считается корректной только в том случае, если она подтверждена в Asl Belgisi.

Роль Smartup в этой логике

Smartup:
  • не создаёт коды маркировки;
  • не меняет их статус напрямую;
  • не хранит финальное состояние KM.
Задача Smartup — это:
  • контроль бизнес-процессов;
  • проверка KM через XTrace API;
  • предотвращение ошибочных действий;
  • корректная передача данных в ЭДО и ККМ.
Перед каждой ключевой операцией (отгрузка, доставка, продажа) Smartup делает онлайн-запрос в Asl Belgisi и принимает решение на основании ответа.

Почему это критично важно понимать

Большинство ошибок при работе с маркировкой возникают из-за неверного ожидания, что:
  • «KM есть в системе, значит он мой»;
  • «если в заказе есть KM, значит его можно отгружать»;
  • «если склад видит товар, значит код валиден».
На самом деле физическое наличие товара не имеет значения, если:
  • KM не числится на балансе компании в Asl Belgisi;
  • KM уже продан;
  • KM прикреплён к другому VAN;
  • KM был обработан в другой системе.
Как это проявляется на практике

Примеры типовых ситуаций:
  • 📦 Товар на складе, но отгрузка не проходит
  • → KM не на балансе компании в Asl Belgisi.
  • 🚚 Товар в машине, но доставка не завершается
  • → KM не закреплён за этим VAN.
  • 🧾 e-Faktura не отправляется
  • → В заказе нет KM, подтверждённых Asl Belgisi.
  • 🧾 Чек не печатается
  • → KM не прошёл финальную проверку или уже выведен из оборота.
Во всех случаях Smartup лишь отражает ответ Asl Belgisi, а не является источником ошибки.
Принцип 2.

Smartup не создаёт KM, а контролирует их движение

Smartup не генерирует и не выпускает коды маркировки (KM).
Все KM создаются и управляются во внешних государственных системах (Asl Belgisi / XTrace).

Роль Smartup — учёт, контроль и фиксация движения KM между:
  • процессами (закупка, отгрузка, доставка, продажа),
  • ролями (склад, доставщик, бухгалтер),
  • системами (Asl Belgisi, e-Faktura, ККМ).

Как работает контроль в Smartup

Smartup:
  • проверяет KM при сканировании;
  • фиксирует, к какому заказу, VAN или продаже относится KM;
  • блокирует операции при ошибках или несоответствиях;
  • передаёт данные о KM в ЭДО и кассовые системы.
При этом Smartup не меняет статус KM самостоятельно, а действует на основании ответов Asl Belgisi.


Почему это важно

Если возникает ошибка с маркировкой, её нельзя «исправить» вручную в Smartup.
Исправление всегда связано с:
  • корректной e-Faktura,
  • правильной отгрузкой,
  • повторной синхронизацией,
  • проверкой статуса KM во внешних системах.
Принцип 3.

Причины большинства ошибок при работе с маркировкой

На практике большинство ошибок при работе с маркированным товаром связано не с работой
Smartup, а с нарушением базовых требований процесса маркировки.
Ключевые причины повторяются из раза в раз.

1. Отсутствие KM в e-FakturaЕсли коды маркировки:

  • не указаны в электронной фактуре;
  • указаны не полностью;
  • фактура не подписана,
то KM не переходит на баланс компании.
В результате невозможны:
  • отгрузка,
  • доставка,
  • продажа.

2. Проблемы с XTrace Token

XTrace Token используется для проверки KM в Asl Belgisi.
Ошибки возникают, если:
  • токен истёк;
  • токен указан неверно;
  • используется токен другой организации.
При невалидном токене Smartup не может проверить ни один KM, и все операции с маркировкой блокируются.

3. Несоответствие баланса KM между системами

KM может числиться:
  • в заказе, но не на балансе компании;
  • на складе, но не на VAN;
  • в Smartup, но уже продан в другой системе.
Во всех таких случаях приоритет всегда у Asl Belgisi, и операция будет остановлена.

Ключевой вывод

Если при работе с маркировкой возникает ошибка, в первую очередь необходимо проверить:
  1. есть ли KM в подписанной e-Faktura;
  2. действует ли XTrace Token;
  3. совпадает ли баланс KM в Smartup и Asl Belgisi.
Понимание этих причин позволяет устранить большинство проблем без технической поддержки.
Полезные советы💡

  • Всегда проверяйте статус KM в Asl Belgisi / XTrace при спорных ситуациях.
  • Следите за актуальностью XTrace Token.
  • Перед выполнением операций сверяйте фактический баланс KM.
Часто задаваемые вопросы (FAQ):