Как получить динамический клиентский токен в СУЗ

Динамический clientToken нужен только для обмена с СУЗ через API. Если вы заказываете коды в веб-интерфейсе «Честного ЗНАКа», отдельный токен получать не нужно. Для программной интеграции сначала создают устройство в СУЗ и сохраняют его идентификаторы, затем получают временный clientToken методом единой аутентификации.

API — обычный рабочий способ автоматизировать заказ кодов и получать его результат в учётной системе. SelSup — программа для продавцов на маркетплейсах. Если собственной интеграции не требуется, в ней есть готовый маршрут для маркировки: получение кодов, печать, ввод в оборот, передача кодов на маркетплейсы и проверка статусов. Подготовка устройства в СУЗ из этой инструкции остаётся отдельной задачей для тех, кто работает с его API.

Источник проверен 15 сентября 2026 года. API и веб-интерфейс СУЗ — штатные способы работы с «Честным ЗНАКом». Токен действует не более 10 часов. Эта инструкция показывает подготовку в кабинете; сам запрос и продление реализуют по текущему описанию True API в разделе «Помощь» личного кабинета. Поэтому дочитайте статью до конца.

Когда нужен динамический токен СУЗ

Токен нужен, когда учётная система обращается к станции управления заказами программно. Через СУЗ интеграция заказывает коды маркировки и получает результаты по заказу. Устройство, его идентификаторы и временный clientToken относятся к этому маршруту API.

Для обычной работы в браузере этот маршрут не нужен. Пользователь с подходящей ролью получает расширенный функционал сразу после входа в СУЗ. Как устроены разные контуры, ключи и методы, разобрано в статье про API «Честного ЗНАКа».

Проверьте роль перед созданием устройства

Раздел «Устройства» открывается только для «Руководителя организации» или «Администратора». У ролей «Сотрудник» и «Сотрудник с правом подписи» этого пункта нет. Войдите в личный кабинет по УКЭП и проверьте роль до настройки. Если сертификат недавно меняли, сначала восстановите доступ по инструкции по смене сертификата УКЭП.

Создайте устройство в СУЗ

Шаг 1. В верхнем меню личного кабинета выберите «Управление заказами». Отсюда откроется станция управления заказами.

Шаг 2. Откройте раздел «Устройства». Именно здесь создают подключение для СУЗ API.

Шаг 3. Нажмите «Создать устройство». Если кнопки нет, вернитесь к проверке роли: сотруднику это действие недоступно.

Шаг 4. Введите понятное имя, выберите режим отправки «Автоматический» и нажмите «Создать». Название лучше связать с конкретной учётной системой или контуром, чтобы подключения не перепутались.

Шаг 5. Сохраните OMS ID и идентификатор соединения. Они понадобятся интеграции. Это разные значения: не заменяйте одно другим.

Где получить clientToken и как его обновлять

Прочерк в колонке «Токен» после создания устройства — штатный результат. clientToken не копируют из этой таблицы. Его получают обращением к методу единой аутентификации. Актуальное описание находится в личном кабинете в разделе «Помощь»: «Описание True API», пункт 1.5.1 — запрос авторизации при единой аутентификации.

Не смешивайте авторизацию СУЗ с доступами к другим контурам системы маркировки. Разницу между True API, СУЗ и Национальным каталогом, а также назначение их ключей, объясняет обзор API «Честного ЗНАКа».

Срок действия токена — не более 10 часов с момента получения. Владелец интеграции должен реализовать повторный запрос до истечения срока по текущей документации. Если настройку ведёт подрядчик или сервисная организация, передайте ей OMS ID, идентификатор соединения и требование к сценарию обновления; сам токен не отправляйте в общих чатах и таблицах.

Если собственная интеграция с СУЗ API не является вашей задачей, подключите SelSup для поддерживаемых операций с маркировкой. Он помогает получать и печатать коды, вводить их в оборот, передавать на маркетплейсы и контролировать статусы. Это не означает, что SelSup получает или продлевает описанный здесь clientToken: получение и обновление этого токена остаются в контуре СУЗ и текущего True API.

Что проверить перед первым заказом кодов

Проверьте полный маршрут, а не только успешную авторизацию. Сделайте контрольный заказ небольшого объёма, получите коды, убедитесь, что они сохранились в учётной системе, и проверьте печать. Для ручной сверки пригодится инструкция по заказу и печати кодов маркировки.

Разделите тестовое и промышленное подключение. Зафиксируйте для каждого контура его адрес, OMS ID, идентификатор соединения и ответственного за продление доступа. Это помогает найти причину сбоя до отправки заказа в неверный контур.

Если вы заказываете коды как производитель, отдельно проверьте условия их выдачи до работы в промышленном контуре. Причины, по которым производителю могут не выдать коды, собраны в инструкции о проверке производства в «Честном ЗНАКе».

Как продолжить работу с маркировкой в SelSup

После создания устройства работа не заканчивается. Ответственный за собственную интеграцию отслеживает срок токена, разделяет тестовый и промышленный контуры, проверяет результаты заказов и печать. Если пропустить срок действия токена или выбрать неверный контур, нужная операция может не пройти и её придётся разбирать до следующего заказа.

При нескольких устройствах, контурах или сотрудниках эти проверки повторяются для каждого подключения. Подключите SelSup как основную рабочую систему для поддерживаемых операций маркировки, если вам не нужна собственная разработка СУЗ API. Практический маршрут получения кодов, печати, ввода в оборот, передачи и проверки статусов описан в возможностях работы с маркировкой; ответственность за состояние СУЗ и его API остаётся у системы маркировки и выбранной интеграции.

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

Посчитайте трудозатраты на своих данных по формуле n × t × r / 60. Здесь n — число повторных проверок или эпизодов диагностики за выбранный период, t — замеренные вами минуты на один случай, r — фактическая полная стоимость часа сотрудника. Результат — сценарная оценка труда, а не тариф и не гарантированная сумма. В официальной инструкции о динамическом токене не установлены штраф или точная стоимость такого сбоя.

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

Частые причины, почему токен не удаётся получить

Ищут значение в колонке устройства. Прочерк там нормален: clientToken выдаёт единая аутентификация.

Настраивают доступ под ролью сотрудника. Нужен руководитель организации или администратор, иначе раздел «Устройства» не появится.

Считают токен постоянным. После срока до 10 часов авторизация перестанет работать, поэтому в интеграции нужен сценарий продления по актуальному True API.

Передают только токен без параметров устройства. Для подключения также нужны OMS ID, идентификатор соединения и корректный контур.

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