Как получить API Key и party_id Национального каталога

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

Главное различие: API Key — ключ доступа к API, а party_id — идентификатор участника, который может требоваться конкретному интеграционному решению. Не подставляйте вместо одного реквизита другой и не публикуйте реальные значения в переписке, снимках экрана или примерах.

Инструкция проверена по официальной базе знаний «Честного ЗНАКА» 10 сентября 2026 года. В первоисточнике есть три экрана интерфейса и нет встроенного YouTube-видео. Ниже — безопасный маршрут получения реквизитов и проверка перед подключением.

Что такое API Key и party_id

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

party_id обозначает участника интеграционного обмена.В разных программах поле может называться «party_id», «идентификатор участника» или «ID участника».Официальная справка по рассматриваемому сценарию не описывает самостоятельное получение party_id в интерфейсе и рекомендует обратиться к обслуживающей организации или разработчику программы.

• API Key: получают в профиле Национального каталога при наличии нужной роли.
• party_id: запрашивают у специалиста, который настраивает конкретное ПО или интеграцию.
• УКЭП: нужна для входа в личный кабинет системы маркировки.
• Документация API: открывается внутри промышленного контура по нужной товарной группе через «Помощь» → «API».

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

Кто может увидеть API Key

Ключ отображается только пользователям с ролью «Руководитель организации» или «Администратор».Сотрудник и сотрудник с правом подписи не увидят поле с ключом в своём профиле Национального каталога.Это не ошибка браузера и не повод заново устанавливать сертификат.

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

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

Как получить API Key: пошагово

1. Подготовьте УКЭП. Войдите в продуктивный личный кабинет системы маркировки. Для разработки и проверки может использоваться демонстрационный контур, но его реквизиты не нужно смешивать с рабочими.
2. Откройте Национальный каталог. Используйте меню в левой верхней части экрана.
3. Откройте профиль. Нажмите имя пользователя в правом верхнем углу и выберите пункт «Профиль».
4. Перейдите к данным участника. На вкладке «Данные участника» найдите блок «Ключ доступа» и поле API KEY.
5. Скопируйте ключ. Нажмите значок копирования справа от поля. Не перепечатывайте длинное значение вручную.
6. Сохраните назначение. Запишите отдельно, к какой организации, среде и интеграции относится ключ, не добавляя само секретное значение в общую таблицу.

Не вставляйте ключ в текст статьи, задачу или снимок экрана.Если настройку выполняет подрядчик, передайте значение по согласованному защищённому каналу и ограничьте круг получателей.Это практическая мера безопасности: официальный экран показывает ключ, но не делает его публичным реквизитом.

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

Где взять party_id

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

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

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

Как безопасно хранить и передавать реквизиты

Храните API Key как секрет доступа.Укажите владельца, систему-получателя, среду и дату передачи, а само значение держите в защищённом хранилище секретов или в настройках программы с ограниченным доступом.Не сохраняйте его в открытом документе, общей CRM-заметке или инструкции для всех сотрудников.

• Разделяйте среды. Рабочий и тестовый контуры должны быть подписаны явно.
• Скрывайте значение. В журналах, задачах и скриншотах оставляйте только несколько последних символов, если они нужны для сверки.
• Фиксируйте получателя. Должно быть понятно, кто и для какой программы запросил реквизит.
• Проверяйте доступы. После увольнения сотрудника или смены подрядчика пересмотрите, кто может читать настройки интеграции.
• Реагируйте на утечку. Если ключ попал в публичный файл или переписку с лишними участниками, прекратите его использование и уточните у ответственного администратора порядок замены.

Не отправляйте API Key вместе с УКЭП, паролем или кодом подтверждения.Для настройки API достаточно тех реквизитов, которые действительно запрашивает программа.Виды кодов для товаров отдельно описаны в статье про коды маркировки «Честного ЗНАКА»: Data Matrix также не является API Key.

Как проверить подключение

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

1. Ошибка доступа: проверьте, что API Key скопирован полностью, без пробелов и переносов.
2. Участник не найден: перепроверьте party_id у обслуживающей организации и соответствие организации.
3. Метод не найден или запрещён: сверяйте путь и требования с актуальной документацией внутри личного кабинета.
4. Данные товара не проходят: проверьте GTIN, категорию, обязательные атрибуты и статус карточки.
5. Ошибка остаётся: отправьте специалисту безопасный фрагмент ответа, время запроса и название метода без ключа.

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

Как связать маркировку с рабочими процессами

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

SelSup — самостоятельная WMS со встроенным товарным и складским учётом для работы с маркетплейсами.В одном процессе можно связать товары, остатки, заказы, складские операции и маркировку.Возможности собраны на странице автоматизации маркировки SelSup. Запись на встречу работает через кнопки страницы, поэтому отдельные демо-ссылки в статье не нужны.

Перед запуском зафиксируйте пять пунктов: организацию, среду, владельца доступа, перечень разрешённых операций и способ проверки. Руководителю это даёт контроль над реквизитами и подрядчиками, а сотруднику — понятный маршрут диагностики без пересылки секретов.

Итоговая проверка: API Key получен руководителем или администратором в профиле Национального каталога; party_id подтверждён обслуживающей организацией для конкретного ПО; рабочий и тестовый контуры не перепутаны; ключ хранится закрыто; тестовый запрос выполнен без публикации реквизитов.

Частые вопросы

Почему в профиле нет API Key?Сначала проверьте роль.Поле показывается руководителю организации и администратору, но не сотруднику и не сотруднику с правом подписи. Если роль подходит, убедитесь, что открыт именно профиль Национального каталога нужной организации и выбран правильный контур.

Можно ли использовать API Key как party_id? Нет. Это разные реквизиты: ключ подтверждает доступ, а идентификатор связывает запрос с участником. Подмена одного значения другим обычно приводит к ошибке авторизации или поиску не того участника. Формат и место ввода party_id уточняйте у разработчика интеграции.

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

Что передать интегратору для диагностики?Название организации, ИНН, выбранный контур, название программы, время запроса, метод и очищенный текст ошибки.API Key, УКЭП, пароль и коды подтверждения в обычное письмо или чат не добавляйте. Если специалисту действительно нужен секрет, согласуйте отдельный защищённый способ передачи.

Где смотреть актуальные методы API? Официальная инструкция указывает маршрут внутри промышленного личного кабинета: выберите нужную товарную группу, откройте «Помощь», затем «API» и раздел API Национального каталога. Так документация соответствует контуру и доступам участника.