Демонстрационный контур «Честного ЗНАКа» — это тестовая среда системы маркировки, которая позволяет отработать заказ кодов, нанесение Data Matrix и передачу сведений без риска испортить данные в рабочем (промышленном) контуре. Доступ к нему оформляется отдельно от основной учётной записи, а тестовые коды не имеют юридической силы и не привязаны к реальным товарам.
Такая «песочница» особенно полезна компаниям, которые только входят в оборот маркированной продукции: можно заранее проверить интеграцию учётной системы, настроить оборудование и обучить сотрудников. Далее разберём, как устроен демоконтур, чем он отличается от боевого и какие операции в нём стоит отработать в первую очередь.
Что такое демонстрационный контур и зачем он нужен
Демонстрационный контур — это изолированная копия ГИС МТ «Честный ЗНАК», работающая на отдельной инфраструктуре. Все данные в нём тестовые: коды маркировки, сведения о товарах и документы не попадают в промышленную систему и не влияют на реальный оборот.
Основные задачи, которые решает демоконтур:
- 🧪 Тестирование интеграции учётной системы (1С, ERP, WMS) с API «Честного ЗНАКа» до запуска в продакшен.
- 🖨️ Проверка оборудования: принтеров этикеток, сканеров 2D-кодов, терминалов сбора данных.
- 👥 Обучение персонала операциям: заказ кодов, агрегация, отгрузка, приёмка, вывод из оборота.
- 📄 Отработка документооборота с контрагентами через тестовый ЭДО.
Важно понимать: демоконтур не является «облегчённой версией» боевой системы. Функционально он повторяет промышленный контур, поэтому успешно отработанный сценарий с высокой вероятностью сработает и в реальной среде — при условии корректной настройки.
Чем демоконтур отличается от промышленного контура
Различия между контурами принципиальны, и их нужно учитывать, чтобы не допустить ошибок при переходе на реальный оборот.
| Параметр | Демонстрационный контур | Промышленный контур |
|---|---|---|
| Юридическая сила кодов | Нет, коды тестовые | Коды подтверждают легальность товара |
| Стоимость кодов | Бесплатно (в рамках тестирования) | Платно, тариф за код |
| Доступ | Тестовая учётная запись | УКЭП и регистрация участника |
| Влияние на реальный оборот | Отсутствует | Полное, данные фиксируются в ГИС МТ |
| Риски при ошибке | Можно удалить данные и начать заново | Штрафы, блокировка оборота |
Обратите внимание на подписание документов. В демоконтуре используется тестовая электронная подпись либо специальные тестовые сертификаты — рабочая УКЭП организации там не применяется. Порядок получения тестового доступа и сертификатов стоит уточнять в актуальной документации оператора, так как процедура может меняться.
Как получить доступ к демонстрационному контуру
Доступ к тестовой среде оформляется через официальные ресурсы оператора системы маркировки. Точные адреса тестовых стендов и порядок регистрации периодически обновляются, поэтому актуальную инструкцию следует брать в официальной документации «Честного ЗНАКа» и базе знаний для разработчиков.
Общий порядок действий выглядит так:
- 📝 Зарегистрируйте тестовую учётную запись на демонстрационном стенде системы.
- 🔑 Получите или сформируйте тестовую электронную подпись, если она требуется для подписания документов.
- ⚙️ Настройте в учётной системе подключение именно к тестовым адресам API, а не к промышленным.
- ✅ Выполните первую пробную операцию — например, заказ тестовых кодов маркировки.
☑️ Подготовка к работе с демоконтуром
⚠️ Внимание: не перепутайте адреса подключения. Если интеграционное решение случайно направить на промышленный контур вместо тестового, тестовые операции создадут реальные документы и коды в боевой системе. Перед запуском обмена всегда проверяйте, к какому контуру подключена учётная система.
Какие операции стоит отработать в первую очередь
Начинать тестирование лучше с базового цикла обращения кода маркировки, а затем переходить к специфике вашей товарной группы. Это позволит выявить ошибки настройки до того, как они повторятся в реальном обороте.
Рекомендуемый порядок отработки:
- 🏷️ Заказ и получение тестовых кодов маркировки через Станцию управления заказами (тестовую).
- 🖨️ Печать этикеток Data Matrix и проверка их читаемости сканером.
- 📦 Ввод товара в оборот и, при необходимости, формирование агрегатов (коробов, паллет).
- 🚚 Отгрузка товара с передачей УПД через тестовый ЭДО и приёмка на стороне покупателя.
- 🔄 Вывод из оборота по разным основаниям: розничная продажа, порча, возврат.
Для каждой операции фиксируйте результат: какие статусы получил код, какие ошибки вернула система, как отобразилась операция в личном кабинете. Эти наблюдения пригодятся при настройке промышленного контура.
Настройка интеграции и типичные ошибки
Интеграция учётной системы с тестовым контуром выполняется через API, описанный в официальной документации для разработчиков. Адреса тестовых сервисов отличаются от промышленных — это первое, что нужно проверить при подключении.
Типичные проблемы при работе с демоконтуром:
- 🔌 Ошибки авторизации — чаще всего из-за использования боевого токена или сертификата в тестовой среде.
- 📭 Документы не доходят до контрагента — возможная причина в том, что вторая сторона не зарегистрирована в тестовом ЭДО.
- 🏷️ Код не принимается системой — проверьте корректность структуры кода и соответствие товарной группе.
- ⏱️ Долгая обработка запросов — тестовый контур может работать медленнее промышленного, это не всегда признак ошибки вашей интеграции.
Почему тестовый ЭДО — отдельная задача
Для обмена УПД в демоконтуре оба участника должны быть подключены к тестовой среде оператора ЭДО. Не все операторы предоставляют такую возможность в полном объёме, поэтому сценарий «отгрузка-приёмка» иногда отрабатывают с тестовым контрагентом, предоставляемым оператором, или на двух собственных учётных записях.
Если операция завершилась ошибкой, смотрите код и текст ответа API в первую очередь. Описания кодов ошибок публикуются в официальной документации — не стоит гадать по косвенным признакам.
Ограничения демонстрационного контура
Демоконтур — это не полная копия реальной системы по качеству и стабильности. Возможны технические работы, очистка данных и обновления без предварительного уведомления, поэтому хранить там важные тестовые наборы долго не стоит.
⚠️ Внимание: успешное тестирование в демоконтуре не гарантирует отсутствие ошибок в промышленном. Различия в нагрузке, версиях ПО и настройках товарных групп могут проявиться только в боевой среде. Первые реальные операции выполняйте малыми партиями с контролем статусов.
Также учтите, что тестовые коды нельзя наносить на реальную продукцию и выводить в торговый зал — этикетки из демоконтура годятся только для внутренних проверок оборудования и процессов.
Переход от демоконтура к промышленному
После завершения тестирования потребуется перенастроить интеграцию на боевые адреса API, заменить тестовую подпись на действующую УКЭП организации и зарегистрироваться в промышленном контуре «Честного ЗНАКа» как полноценный участник оборота.
Проверьте перед запуском: корректность данных организации (ИНН, адреса), настройку товарных групп, подключение Станции управления заказами и договор с оператором ЭДО. Первые реальные отгрузки делайте ограниченными партиями, сверяя статусы кодов в личном кабинете.
Частые вопросы
Платный ли доступ к демонстрационному контуру?
Доступ к тестовой среде и тестовые коды маркировки предоставляются бесплатно — это одно из ключевых отличий от промышленного контура, где за каждый код взимается тариф. Условия могут меняться, актуальные правила уточняйте в документации оператора.
Можно ли использовать свою УКЭП в демоконтуре?
Как правило, для тестовой среды используется отдельная тестовая электронная подпись, а не боевая УКЭП организации. Порядок её получения описан в документации для участников тестирования.
Сохранятся ли данные из демоконтура в промышленном контуре?
Нет. Контуры полностью изолированы: тестовые коды, товары и документы не переносятся в боевую систему. Все справочники и настройки в промышленном контуре придётся заводить заново.
Подходит ли демоконтур для проверки сканеров и принтеров?
Да, это одна из основных задач. Тестовые коды Data Matrix позволяют проверить печать этикеток и чтение сканерами без расхода платных кодов. Важно лишь не наносить такие этикетки на реальную продукцию.
Где найти адреса тестового API?
Адреса тестовых сервисов публикуются в официальной документации «Честного ЗНАКа» для разработчиков. Они отличаются от промышленных и могут обновляться, поэтому не зашивайте их в код жёстко без возможности быстрой смены.