Массовая загрузка карточек товаров в Честный Знак: практические рекомендации
Обновлено:
Практические рекомендации по массовой загрузке карточек товаров в Честный Знак через CSV: подготовка файла, валидация, автоматизация загрузок и интеграция с 1С.
Почему массовая загрузка карточек важна для бизнеса
Сокращение ручного ввода
Каждая карточка товара, загруженная вручную, требует от сотрудника ввода от 10 до 30 строк данных. При большом ассортименте это легко превращается в часы, а то и дни работы. Массовая загрузка позволяет подготовить файл с несколькими тысячами записей и импортировать их за один клик, освобождая ресурсы для более стратегических задач – аналитики, маркетинга, работы с клиентами.
Уменьшение ошибок ввода
Человеческий фактор неизбежно приводит к опечаткам, пропуску полей или неверному формату дат. При массовой загрузке ошибки фиксируются уже на этапе подготовки файла: большинство редакторов автоматически проверяют обязательные поля, типы данных и уникальность артикулов. Это позволяет устранить проблемы до их появления в системе «Честный Знак», снижая риск отклонения карточек и дополнительных расходов на их исправление.
| Показатель | Ручной ввод | Массовая загрузка |
|---|---|---|
| Среднее время создания одной карточки | 2–3 минуты | 0,1 секунды (при импорте) |
| Кол‑во ошибок на 1000 записей | ≈ 45 | ≈ 5 (в зависимости от контроля данных) |
| Затраты на исправление | От 30 руб. до 150 руб. за запись | Минимальны, при правильной валидации |
Подготовка к масштабной маркировке
Сейчас нормативные требования к маркировке товаров усиливаются, и каждый новый продукт должен быть оснащён уникальным QR‑кодом. При масштабной маркировке система «Честный Знак» ожидает готовую к загрузке базу, где уже указываются все обязательные атрибуты: тип продукции, код маркируемого объекта, дата начала действия маркировки. Массовая загрузка позволяет собрать эту информацию в едином файле, быстро обновлять её при изменении состава ассортимента и поддерживать актуальность данных без ручных правок.
Подготовка CSV‑файла по шаблону «CSV для честного знака»
Структура столбцов: GTIN, количество, цена
Для загрузки карточек товаров в сервис Честный Знак CSV‑файл должен иметь строго фиксированный набор столбцов. В первом столбце указывается GTIN (глобальный торговый идентификационный номер) — 13‑значный код, который однозначно привязывает товар к сертификату. Во втором столбце – количество единиц товара, которое планируется загрузить (целое число, без дробей). Третий столбец – цена в рублях, без символов валюты, с точкой в качестве десятичного разделителя.
| GTIN | Количество | Цена |
|---|---|---|
| 4601234567890 | 10 | 1250.00 |
| 4600987654321 | 5 | 845.50 |
Важно, чтобы каждый из столбцов присутствовал в каждой строке. Пропуск любого столбца приводит к ошибке при импорте.
Требуемый разделитель и кодировка UTF‑8
Система Честный Знак принимает CSV‑файлы только в кодировке UTF‑8. При сохранении файла убедитесь, что редактор (например, Notepad++ или любой табличный процессор) действительно сохраняет данные в этой кодировке, иначе символы кириллицы могут стать нечитаемыми.
Разделителем полей является точка с запятой (;). Это отличает шаблон от привычных CSV‑файлов, где часто используют запятую. При формировании файла проверьте, что все ячейки разделены именно этим символом – даже пробелы вокруг него могут вызвать сбой.
- Откройте файл в текстовом редакторе, включите отображение невидимых символов и убедитесь, что строка выглядит так:
4601234567890;10;1250.00 - Сохраните файл как
UTF‑8 без BOM– это гарантирует корректную загрузку.
Проверка уникальности кодов
Каждый GTIN в файле должен быть уникален. Дублирование кода приводит к замещению предыдущей записи и может вызвать вопросы при проверке сертификатов. Для быстрой проверки рекомендуется использовать встроенные функции таблиц:
- В Excel – выделить столбец GTIN → Условное форматирование → Подсветка дубликатов.
- В Google Таблицах – формула
=UNIQUE(A2:A)покажет список без повторов; если количество строк в оригинальном столбце отличается от результата, значит есть дубли.
Если дубли обнаружены, уточните, действительно ли это один и тот же товар (например, разные упаковки одного продукта) и решите, каким GTIN использовать в каждом случае. После устранения дублирования файл готов к загрузке.
Загрузка CSV в личный кабинет Честного Знака
Путь: Документы → Загрузить из файла
Для массовой загрузки карточек товаров достаточно зайти в раздел Документы личного кабинета и выбрать пункт Загрузить из файла. На открывшейся странице предусмотрены два поля: Выбор файла и Формат импорта. В большинстве случаев выбирают формат CSV (UTF‑8), так как именно в этом виде система Честного Знака умеет автоматически сопоставлять колонки с обязательными полями.
После указания пути к файлу нажмите кнопку Загрузить. Система сразу проверит файл на наличие базовых ошибок (корректность кодировки, наличие заголовков, разделитель столбцов) и отобразит результат в виде списка предупреждений и ошибок.
Валидация файла системой
На этапе валидации система проверяет каждую строку CSV‑файла по следующему набору правил:
- Обязательные столбцы:
Код товара,Наименование,Штрих‑код (GTIN),Дата начала действия,Дата окончания действия. - Соответствие форматов: даты –
ГГГГ‑ММ‑ДД, цены – числа с точкой как разделителем десятичных долей. - Уникальность GTIN: система проверяет, что каждый GTIN встречается только один раз в загружаемом файле.
- Проверка соответствия требованиям ФЗ «О маркировке» (например, наличие кода маркировки, если товар относится к подлежащим маркировке группам).
Если ошибки обнаружены, система выводит их в табличном виде, указывая строку, номер столбца и тип проблемы. Ниже пример типичного отчёта валидации:
| Строка | Столбец | Ошибка |
|---|---|---|
| 12 | Дата окончания действия | Неверный формат даты (ожидается ГГГГ‑ММ‑ДД) |
| 27 | GTIN | Дублирующийся код товара |
Обработка ошибок и повторная загрузка
После получения отчёта валидации необходимо внести исправления в исходный CSV‑файл. Практический совет: сохраняйте «чистый» шаблон с заголовками в отдельном документе – так снизится риск добавить лишние столбцы или неверный порядок колонок.
Когда файл исправлен, вернитесь в тот же раздел Загрузить из файла и загрузите обновлённую версию. Система повторно выполнит проверку; если ошибок не обнаружено, появится сообщение «Файл успешно загружен. Карточки товаров обработаны». После этого они сразу становятся доступными в разделе Товары и могут быть переданы в маркировочную систему.
Если после исправления остаются ошибки, повторяйте процесс до тех пор, пока валидация не завершится без замечаний. При возникновении сложных проблем (например, несоответствие форматов дат в разных регионах) рекомендуется воспользоваться функцией Экспортировать журнал ошибок – в ней будет подробный CSV‑отчёт, который можно открыть в любом табличном редакторе и быстро найти проблемные ячейки.
Автоматизация повторных загрузок и интеграция с 1С
Настройка планировщика задач
Для обеспечения регулярных загрузок файлов с данными о товарах рекомендуется использовать штатный планировщик задач операционной системы. Создаём задачу, которая каждый день в заранее определённое время (например, в 03:00) запускает скрипт‑обработчик. Важно задать следующие параметры:
- Запуск от имени пользователя, имеющего права доступа к общей папке и к 1С.
- Условие «Запускать задачу только если сеть доступна», чтобы избежать ошибок при временных отказах соединения.
- Логирование результата выполнения в отдельный текстовый файл – это упрощает диагностику и позволяет быстро увидеть, какие файлы успешно загружены, а какие нет.
Если планировщик поддерживает повторный запуск задачи при неудаче, включите эту опцию: в случае сбоя система автоматически попытается выполнить загрузку ещё раз, что минимизирует риск пропуска обновлений.
Обмен файлами через общей папку
Общая сетьвая папка служит «буфером» между системой 1С и сервисом Честный Знак. Файлы выгружаются из 1С в эту папку, а скрипт‑загрузчик читает их и посылает в API Честного Знака. Для надёжной работы необходимо соблюсти несколько правил:
- Структура папки должна включать подкаталоги inbox (входящие файлы) и archive (архивированные после обработки). Это упрощает контроль и автоматическое удаление старых файлов.
- Файлы именуются по схеме
YYYYMMDD_HHMM_batch01.xml– такой формат позволяет быстро определить время создания и порядок обработки. - Разрешения на запись/чтение должны быть одинаковыми у всех участников процесса, иначе скрипт может не увидеть новые файлы или не сможет переместить их в архив.
Для ускорения обмена можно включить «watcher»‑службу, которая отслеживает появление новых файлов в inbox и сразу же инициирует их загрузку, не дожидаясь планировщика.
Синхронизация статусов в 1С
После успешной отправки пачки товаров в Честный Знак необходимо отразить результат в 1С – это удобно для контроля и последующего анализа. Вариант реализации:
| Статус в ЧЗ | Код статуса в 1С | Действие в 1С |
|---|---|---|
| Принят | 10 | Отметить карточку как «Загружено», активировать флаг подтверждения |
| Ошибка валидации | 20 | Сохранить сообщение об ошибке в поле «Комментарий», поставить статус «Требует исправления» |
| Отказ в приёме | 30 | Создать задачу для повторной проверки, уведомить ответственного |
Скрипт, получающий ответ от Честного Знака, записывает полученный код в поле статуса карточки товара. При необходимости 1С может автоматически сформировать список товаров с ошибками, чтобы менеджер мог оперативно их исправить и повторно загрузить.
Вопросы и ответы
Зачем нужна массовая загрузка карточек товаров в системе «Честный Знак»?
Массовая загрузка позволяет подготовить файл с тысячами записей и импортировать их за один клик, экономя время, снижая количество ручных ошибок и обеспечивая быструю подготовку к масштабной маркировке.
Какие обязательные столбцы должны присутствовать в CSV‑файле для загрузки?
Файл должен содержать столбцы GTIN, количество и цена. Кроме того, при импорте в личный кабинет требуются обязательные колонки: Код товара, Наименование, Штрих‑код (GTIN), Дата начала действия, Дата окончания действия.
В каком формате и кодировке следует сохранять CSV‑файл?
Файл должен быть сохранён в кодировке UTF‑8 (без BOM) с разделителем точка с запятой (;). Это гарантирует корректное чтение кириллических символов системой «Честный Знак».
Как проверять уникальность GTIN в подготовленном файле?
В Excel используйте условное форматирование → Подсветка дубликатов; в Google Таблицах – формулу =UNIQUE(A2:A) и сравните количество строк. Дублирующие коды необходимо устранить перед загрузкой.
Что делает система при валидации загруженного CSV‑файла?
Система проверяет наличие обязательных столбцов, соответствие форматов дат и цен, уникальность GTIN, а также соответствие требованиям ФЗ «О маркировке». При ошибках выводится таблица с указанием строки, столбца и типа проблемы.
Как исправлять ошибки после первой загрузки?
Скачайте журнал ошибок, исправьте записи в исходном CSV‑файле (рекомендовано хранить «чистый» шаблон с заголовками) и повторно загрузите файл через тот же раздел «Загрузить из файла». Процесс повторяется до полного отсутствия замечаний.
Каким образом автоматизировать повторные загрузки из 1С?
Настройте планировщик задач, который ежедневно запускает скрипт‑обработчик. Скрипт читает файлы из общей папки (inbox), отправляет их в API «Честный Знак» и перемещает обработанные файлы в archive. При сбое включите повторный запуск задачи.
Как синхронизировать статусы загрузки между «Честный Знак» и 1С?
После получения ответа от API скрипт записывает код статуса в поле карточки товара в 1С (например, 10 – Принят, 20 – Ошибка валидации, 30 – Отказ в приёме). По этим кодам формируются отчёты и задачи для исправления ошибок.
