Выгрузка данных из «Честный Знак» в 1С: полная инструкция с примерами

Система маркировки товаров «Честный Знак»** стала обязательной для большинства категорий продукции в России, а интеграция её данных с 1С:Предприятие — критически важным этапом для бизнеса. Без корректной выгрузки кодов маркировки в учётную систему невозможно вести прозрачный учёт, формировать отчётность и избегать штрафов. Однако процесс обмена данными между двумя системами часто вызывает вопросы: как настроить выгрузку, какие форматы использовать, и как избежать типичных ошибок?

В этой статье мы разберём все этапы интеграции — от подготовки 1С до автоматической синхронизации с «Честным Знаком», включая обработку кодов маркировки (GTIN, Serial Number), настройку обмена через EDI-сообщения и решение распространённых проблем. Материал актуален для 1С:Управление торговлей 11, 1С:ERP и 1С:Бухгалтерия 3.0 с последними обновлениями платформы.

Особое внимание уделим автоматической выгрузке данных через API «Честного Знака», которая позволяет сократить ручной ввод на 80% и минимизировать ошибки. Если вы ещё не настроили обмен или сталкиваетесь с проблемами при загрузке кодов — эта инструкция поможет разобраться во всех нюансах.

1. Подготовка 1С к работе с «Честным Знаком»

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

• 📌 Версию платформы 1С — должна быть не ниже 8.3.18 (для полноценной работы с JSON-форматами и HTTPS-запросами).
• 📦 Типовую конфигурацию — в 1С:УТ 11.5 и 1С:ERP 2.5 уже есть встроенные механизмы для маркировки, а для 1С:Бухгалтерия 3.0 может потребоваться доработка.
• 🔑 Права доступа — пользователь, выполняющий выгрузку, должен иметь роль «Администратор» или специальные права на работу с Веб-сервисами и Обменом данными.

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

⚠️ Внимание: Если вы используете облачную версию 1С (1С:Fresh), проверьте, включена ли в вашем тарифе поддержка API-интеграций. В некоторых случаях для работы с «Честным Знаком» потребуется переход на расширенный тариф.

Также подготовьте справочники номенклатуры в 1С:

• 🏷️ Убедитесь, что для каждого маркируемого товара указаны:
  • GTIN (глобальный идентификатор торговой единицы),
  • Артикул производителя,
  • Категория товара (соответствует классификатору «Честного Знака»).
• 📊 Для групп товаров (например, обуви или лекарств) настройте дополнительные реквизиты: Размер, Цвет, Серия.

2. Регистрация в личном кабинете «Честный Знак» и получение ключей API

Для обмена данными между 1С и «Честным Знаком» необходимо зарегистрироваться в личном кабинете системы маркировки и получить доступ к API. Процесс состоит из нескольких шагов:

1. Регистрация компании — если вы ещё не зарегистрированы, пройдите процедуру через Единый личный кабинет (используйте данные из ЕГАИС или ГИС МТ).
2. Подтверждение прав на товарные группы — в разделе Мои товары добавьте категории, с которыми работаете (например, «Обувь», «Лекарства», «Табачная продукция»).
3. Получение ключей API — перейдите в Настройки → Интеграции → API и сгенерируйте:
   • Client ID (идентификатор клиента),
   • Client Secret (секретный ключ),
   • Token (токен доступа, действует 1 год).

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

Параметр	Где взять	Пример значения
Client ID	Личный кабинет «Честный Знак» → Настройки → API	a1b2c3d4-5678-90ef-1234-567890abcdef
Client Secret	Личный кабинет «Честный Знак» → Настройки → API	xYz123!@#qWeRTY
Token	Генерируется после авторизации по Client ID/Secret	eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
URL API	Документация «Честного Знака»	https://markirovka.ru/api/v3

⚠️ Внимание: Токен доступа к API действует ограниченное время (обычно 1 год). Настройте в 1С уведомление о его истечении, чтобы избежать прерывания обмена данными. В некоторых конфигурациях (например, 1С:ERP) это делается автоматически через механизм Планировщик заданий.

3. Настройка обмена данными в 1С

После подготовки ключей API переходим к настройке обмена в 1С. Рассмотрим два основных способа:

Способ 1: Через встроенный функционал (для типовых конфигураций)

В 1С:УТ 11.5 и 1С:ERP 2.5 есть готовые обработки для работы с «Честным Знаком». Чтобы их активировать:

1. Откройте раздел Администрирование → Настройки программы → Маркировка товаров.
2. Установите флажок Использовать маркировку товаров и выберите Честный Знак в качестве оператора.
3. Введите полученные ранее Client ID, Client Secret и URL API.
4. Настройте График обмена (рекомендуется ежедневная синхронизация в нерабочее время).

Способ 2: Через внешнюю обработку (для нетиповых конфигураций)

Если ваша 1С не поддерживает маркировку «из коробки», используйте внешние решения:

• 🔧 Обработка «Честный Знак для 1С» от Атол — бесплатная версия доступна на сайте производителя.
• 🛠️ Решение «Клеверенс: Маркировка» — платное, но с расширенными возможностями (например, работа с DataMatrix-кодами).
• 📥 Самостоятельная доработка — если у вас есть программист 1С, можно написать обработку на основе документации 1С и API «Честного Знака».

Для подключения внешней обработки:

1. Скачайте файл обработки (обычно имеет расширение .epf или .cf).
2. В 1С откройте Файл → Открыть и выберите скачанный файл.
3. Заполните параметры подключения (ключи API, URL сервера).
4. Сохраните настройки и запустите тестовое соединение.

Установлена актуальная версия 1С|Получены ключи API «Честного Знака»|Справочник номенклатуры заполнен GTIN и артикулами|Проверено подключение к интернету (для облачных версий 1С)|Создана резервная копия базы-->

4. Выгрузка данных из «Честного Знака» в 1С: пошаговый процесс

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

Ручная выгрузка кодов маркировки

Этот способ подходит, если вам нужно загрузить в 1С ограниченное количество кодов (например, для новой партии товара). Алгоритм действий:

1. В личном кабинете «Честного Знака» перейдите в раздел Коды маркировки → Экспорт.
2. Выберите формат выгрузки:
   • Excel (.xlsx) — удобно для небольших партий,
   • JSON или XML — для автоматизированной загрузки в 1С.
• Укажите период и категории товаров, которые нужно выгрузить.
• Скачайте файл и сохраните его на компьютере.

Для загрузки в 1С:

5. В 1С откройте обработку обмена (например, Маркировка товаров → Загрузка кодов).
6. Выберите скачанный файл и укажите параметры сопоставления полей (например, GTIN → Артикул).
7. Запустите загрузку и проверьте результат в справочнике Коды маркировки.

Автоматическая выгрузка через API

Для регулярного обмена настройте автоматическую синхронизацию. В типовых конфигурациях это делается через Планировщик заданий:

1. Перейдите в Администрирование → Поддержка и обслуживание → Планировщик заданий.
2. Создайте новое задание с типом Обмен данными с Честным Знаком.
3. Укажите параметры:
   • Расписание (например, ежедневно в 2:00),
   • Тип операции (Выгрузка кодов, Загрузка статусов),
   • Фильтры по номенклатуре (если нужно выгружать только определённые группы товаров).
4. Сохраните задание и запустите его в тестовом режиме.

Для проверки корректности обмена используйте Журнал регистрации (меню Администрирование → Журналы → Журнал регистрации). Обратите внимание на ошибки с кодом 401 (проблемы с авторизацией) или 404 (неверный URL API).

5. Обработка ошибок и типичные проблемы

При обмене данными между 1С и «Честным Знаком» могут возникать ошибки. Рассмотрим наиболее распространённые и способы их решения:

Код ошибки	Описание	Решение
401 Unauthorized	Неверные ключи API или истёк токен.	Обновите Token в личном кабинете «Честного Знака» и пересохраните настройки в 1С.
400 Bad Request	Некорректный формат запроса (например, отсутствует обязательное поле GTIN).	Проверьте структуру передаваемых данных в Журнале регистрации.
404 Not Found	Неверный URL API или ресурс не найден.	Убедитесь, что используете актуальный адрес (например, https://markirovka.ru/api/v3).
500 Internal Server Error	Ошибка на стороне «Честного Знака».	Повторите запрос позже или обратитесь в поддержку через личный кабинет.

Другие типичные проблемы:

• 🔄 Дублирование кодов — возникает, если один и тот же Serial Number загружается повторно. Проверьте настройки фильтрации в обработке обмена.
• ⏳ Долгая обработка больших партий — при выгрузке более 10 000 кодов разбейте задачу на несколько этапов или используйте фоновые задания.
• 📉 Несовпадение остатков — если количество кодов в 1С и «Честном Знаке» не сходится, запустите Сверку остатков в ручном режиме.

⚠️ Внимание: Если после выгрузки коды маркировки не отображаются в документах 1С (например, в Реализации товаров), проверьте настройки Правил отбора в справочнике Коды маркировки. Возможно, фильтр исключает нужные позиции.

Что делать, если «Честный Знак» не принимает коды из 1С?

Если при отправке кодов маркировки в «Честный Знак» вы получаете ошибку 400 с текстом «Некорректный GTIN», проверьте:

1. Правильность введённого кода (должен состоять из 14 цифр).

2. Соответствие GTIN категории товара (например, для обуви используются коды из диапазона 46000000000000–46999999999999).

3. Актуальность данных в справочнике номенклатуры — возможно, GTIN был изменён производителем, но не обновлён в 1С.

6. Автоматизация и оптимизация обмена

Чтобы минимизировать ручной труд и ускорить обработку данных, используйте следующие инструменты:

• ⚡ Фоновые задания — настройте выгрузку кодов в нерабочие часы, чтобы не нагружать систему днём.
• 🤖 Роботы 1С — в 1С:ERP можно создать Бизнес-процесс, который будет автоматически обрабатывать новые коды маркировки.
• 📊 Отчёты по маркировке — используйте стандартные отчёты Анализ маркировки или Сверка с Честным Знаком, чтобы оперативно выявлять расхождения.
• 🔄 Интеграция с оборудованием — если вы используете сканеры штрихкодов или терминалы сбора данных (например, Атол или CipherLab), настройте прямой ввод кодов в 1С через COM-порт или Wi-Fi.

Для крупных предприятий с большим оборотом маркируемых товаров рекомендуется:

• 📈 Настроить кластерную обработку — разделить выгрузку по группам товаров (например, отдельно для обуви, лекарств, табака).
• 🔗 Использовать промежуточный сервер — если прямая интеграция с 1С тормозит, организуйте обмен через прокси-сервер или облачное хранилище (например, Yandex Object Storage).

Пример настройки фонового задания для автоматической выгрузки:

// Код для создания фонового задания в 1С (конфигуратор)
Процедура СоздатьЗаданиеВыгрузки()
Задание = ПланировщикЗаданий.СоздатьЗадание();
Задание.Наименование = "Выгрузка кодов маркировки в Честный Знак";
Задание.ТипЗадания = ТипЗаданияОбменаДанными.ЧестныйЗнакВыгрузка;
Задание.Расписание.ДобавитьЕжедневноеВремя(Час(2), Минута(0)); // Каждый день в 2:00
Задание.Параметры.Установить("ФильтрПоНоменклатуре", Истина);
Задание.Запустить();
КонецПроцедуры

💡

Автоматическая выгрузка через API сокращает время обработки кодов маркировки в 5–10 раз по сравнению с ручным вводом и снижает риск ошибок до 1–2%.

7. Проверка и контроль данных после выгрузки

После выгрузки кодов маркировки в 1С необходимо убедиться в их корректности. Для этого:

1. Сверьте количество кодов — сравните данные в 1С (Справочник → Коды маркировки) с отчётом в личном кабинете «Честного Знака» (Отчёты → Коды маркировки).
2. Проверьте статусы кодов — в 1С должен отображаться статус Активен или В обороте. Коды со статусом Отозван или Утилизация требуют дополнительной проверки.
3. Тестируйте документы — создайте тестовый документ Реализация товаров и убедитесь, что коды маркировки подтягиваются автоматически.

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

• 🔍 Несовпадение GTIN — код в 1С не совпадает с кодом в «Честном Знаке». Решение: обновите справочник номенклатуры.
• 📅 Устаревшие данные — коды были выгружены до их активации в системе маркировки. Решение: повторите выгрузку после изменения статуса.
• 🔄 Дублирование — один и тот же код загружен дважды. Решение: настройте фильтр по уникальному Serial Number.

Для удобства контроля создайте в 1С отчёт по маркировке с следующими полями:

Поле	Источник данных	Пример значения
GTIN	Справочник номенклатуры	46012345678901
Serial Number	Справочник кодов маркировки	010460123456789021ABCD1234
Статус	«Честный Знак»	В обороте
Дата выгрузки	Журнал регистрации	15.05.2026 14:30:00

💡

Для быстрой проверки статусов кодов используйте мобильное приложение «Честный Знак» (доступно для iOS и Android). С его помощью можно отсканировать DataMatrix-код и убедиться, что он активен в системе.

8. Обновление и поддержка интеграции

Система маркировки «Честный Знак» регулярно обновляется: добавляются новые категории товаров, изменяются форматы обмена, вводятся дополнительные требования к отчётности. Чтобы интеграция с 1С работала без сбоев:

• 🔄 Обновляйте 1С — устанавливайте релизы платформы и конфигураций не реже 1 раза в квартал. В новых версиях часто исправляются ошибки обмена с «Честным Знаком».
• 📢 Следите за новостями — подпишитесь на рассылку «Честного Знака» и проверяйте раздел Новости в личном кабинете.
• 🛠️ Тестируйте изменения — перед массовой выгрузкой проверяйте новые функции на тестовой базе 1С.
• 📞 Используйте поддержку — при критических ошибках обращайтесь в службу поддержки 1С или «Честного Знака» (контакты есть в личном кабинете).

Пример типичных изменений, которые могут повлиять на обмен:

• 📦 Добавление новых категорий товаров (например, с 2026 года маркировка распространяется на велосипеды и электросамокаты).
• 🔑 Обновление форматов API (например, переход с API v2 на v3).
• 📑 Введение новых отчётов (например, Отчёт о движении маркированных товаров).

⚠️ Внимание: Если вы используете нетиповую конфигурацию 1С, после обновления платформы может потребоваться доработка обработок обмена. Перед обновлением обязательно создайте резервную копию базы!

FAQ: Частые вопросы по выгрузке данных из «Честного Знака» в 1С

Можно ли выгрузить коды маркировки в 1С без использования API?

Да, но это менее удобно. Вы можете экспортировать коды из личного кабинета «Честного Знака» в формате Excel или CSV, а затем загрузить их в 1С через обработку Импорт из табличного документа. Однако при большом объёме данных этот способ занимает много времени и чреват ошибками.

Почему в 1С не отображаются статусы кодов маркировки?

Наиболее вероятные причины:

• Не настроена обратная синхронизация (выгрузка статусов из «Честного Знака» в 1С).
• В настройках обмена не указан параметр Загружать статусы.
• Ошибка авторизации (проверьте актуальность Token).

Решение: запустите ручную синхронизацию статусов через Маркировка товаров → Обновить статусы.

Как исправить ошибку «Некорректный формат GTIN»?

Ошибка возникает, если:

• В 1С указан GTIN, не соответствующий стандарту (должен быть 14 цифр).
• Код не зарегистрирован в «Честном Знаке» для вашей компании.
• В справочнике номенклатуры указан Артикул вместо GTIN.

Проверьте данные в справочнике Номенклатура и при необходимости обновите их через Загрузку из Excel.

Нужно ли выгружать в 1С коды маркировки для возвратов товара?

Да, если товар был продан с маркировкой, то при возврате необходимо:

1. Зафиксировать возврат в документе Возврат товаров от покупателя.
2. Обновить статус кода в «Честном Знаке» на Возврат.
3. Синхронизировать данные в 1С, чтобы избежать расхождений.

В некоторых конфигурациях (например, 1С:ERP) это делается автоматически при проведении документа возврата.

Можно ли настроить выгрузку кодов маркировки в 1С:Бухгалтерия 3.0?
В 1С:Бухгалтерия 3.0 нет встроенного функционала для работы с «Честным Знаком», но вы можете:
• Использовать внешнюю обработку (например, от Атол или Клеверенс).
• Настроить обмен через промежуточный файл (экспорт из «Честного Знака» в Excel