Создание штрихкодов в 1С программно: от алгоритмов до печати

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

В этой статье мы разберём все этапы — от базовых принципов формирования штрихкодов до продвинутых сценариев с использованием внешних компонент и оборудования. Вы узнаете, как генерировать коды в форматах EAN-13, Code 128 или DataMatrix непосредственно в конфигураторе, а также как интегрировать их с документами ПоступлениеТоваров или РеализацияТоваров. Особое внимание уделено типичным ошибкам, которые приводят к нечитаемым кодам или конфликтам в базе.

Материал будет полезен как начинающим 1С-программистам, так и опытным специалистам, которые хотят оптимизировать существующие решения. Все примеры кода протестированы на платформе 1С:Предприятие 8.3.22 и актуальны для типовых конфигураций УТ 11, КА 2 и ERP 2.

1. Основные форматы штрихкодов и их применение в 1С

Прежде чем приступать к программированию, необходимо определиться с форматом штрихкода. От этого зависит не только алгоритм генерации, но и совместимость с оборудованием (сканерами, принтерами этикеток) и внешними системами (маркетплейсами, ЕГАИС).

В 1С чаще всего используются следующие стандарты:

• 📦 EAN-13/EAN-8 — для розничной торговли (обязателен для маркировки товаров в РФ с 2026 года). Поддерживает только цифры, длина фиксирована (13 или 8 символов).
• 🔢 Code 128 — универсальный формат для внутренней логистики. Позволяет кодировать буквы, цифры и специальные символы. Используется в GTIN и SSCC.
• 📊 DataMatrix — двухмерный код для маркировки лекарств, алкоголя (ЕГАИС) и сложных идентификаторов. Требует специальное оборудование для печати/сканирования.
• 🏷️ Code 39 — устаревший, но ещё встречающийся в legacy-системах. Прост в генерации, но занимает много места на этикетке.

Для России критично учитывать требования Федерального закона № 487-ФЗ "О маркировке товаров" — с 2026 года многие категории товаров (обувь, одежда, духи) должны маркироваться DataMatrix с передачей данных в систему Честный ЗНАК. В 1С это реализуется через интеграцию с Универсальным передаточным документом (УПД) или специализированными обработками.

2. Встроенные механизмы 1С для работы со штрихкодами

Платформа 1С:Предприятие 8.3 предоставляет базовые инструменты для работы со штрихкодами без подключения внешних библиотек. Основные объекты и методы:

• 🔹 Штрихкод — встроенный тип данных для хранения кодов в справочниках (например, в Справочник.Номенклатура).
• 🔹 ШтрихкодыКомпоновкиДанных — механизм для печати кодов в отчётах и документах.
• 🔹 ПечатьШтрихкодов — обработка для вывода на принтер (доступна в типовых конфигурациях).

Пример добавления штрихкода к номенклатуре программно:

Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Ноутбук ASUS");
НовыйШтрихкод = Номенклатура.Штрихкоды.Добавить();
НовыйШтрихкод.Тип = ТипШтрихкода.EAN13;
НовыйШтрихкод.Значение = "4607103721457";
Номенклатура.Записать();

Ограничения встроенных механизмов:

• ⚠️ Нет поддержки DataMatrix и некоторых версий Code 128 без внешних компонент.
• ⚠️ Генерация контрольной суммы для EAN-13 требует ручной реализации (см. раздел 4).
• ⚠️ Печать на термоэтикетках возможна только через драйвер принтера (нет прямой поддержки ZPL или EPL).

3. Генерация штрихкодов с помощью внешних компонент

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

Пример подключения BarcodeLib и генерации Code 128:

// Подключаем DLL (предварительно зарегистрировать в системе)
Barcode = Новый COMОбъект("BarcodeLib.Barcode");

// Настраиваем параметры
Barcode.Symbology = 16; // 16 = Code 128
Barcode.Data = "1234567890";
Barcode.BarHeight = 50;
Barcode.ShowText = Истина;

// Сохраняем в файл
Barcode.SaveImage("C:\Temp\code128.bmp");

⚠️ Внимание: При использовании внешних компонент убедитесь, что они совместимы с разрядностью вашей 1С (x86 или x64). Несоответствие приведёт к ошибке "Не найден класс COM-объекта".

4. Алгоритмы расчёта контрольных сумм для EAN-13 и Code 128

Корректная генерация штрихкода невозможна без правильного расчёта контрольной суммы (последняя цифра в EAN-13 или символ в Code 128). Ошибка в одном знаке сделает код нечитаемым.

Для EAN-13 алгоритм следующий:

1. Берём первые 12 цифр кода (например, 460710372145).
2. Суммируем цифры на чётных позициях (2, 4, 6...) и умножаем на 3.
3. Суммируем цифры на нечётных позициях (1, 3, 5...).
4. Складываем результаты п.2 и п.3.
5. Контрольная цифра = (10 - (сумма % 10)) % 10.

Реализация на встроенном языке 1С:

Функция РассчитатьКонтрольнуюСуммуEAN13(КодБезКонтрольнойСуммы)
Сумма = 0;
Для Индекс = 1 По 12 Цикл
Цифра = Сред(КодБезКонтрольнойСуммы, Индекс, 1);
Если Индекс % 2 = 0 Тогда
Сумма = Сумма + Цифра * 3;
Иначе
Сумма = Сумма + Цифра;
КонецЕсли;
КонецЦикла;
КонтрольнаяЦифра = (10 - (Сумма % 10)) % 10;
Возврат КодБезКонтрольнойСуммы + Формат(КонтрольнаяЦифра, "ЧГ=0");
КонецФункции

// Пример использования
Сообщить(РассчитатьКонтрольнуюСуммуEAN13("460710372145")); // Вернёт "4607103721457"

Для Code 128 контрольная сумма рассчитывается по модулю 103 с учётом весов символов. Готовые функции можно найти в публикациях Инфостарта (уточните актуальность кода под вашу версию платформы).

5. Интеграция с оборудованием: принтеры и сканеры

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

5.1. Печать на термоэтикетках через ZPL (Zebra)

Принтеры Zebra используют язык разметки ZPL для формирования этикеток. Пример команды для печати EAN-13:

^XA
^FO50,50^BY3
^BCN,100,Y,N,N
^FD4607103721457^FS
^XZ

В 1С отправка команды реализуется через порт или сетевой принтер:

ТекстКоманды = "^XA..."; // Полный ZPL-код
Порт = Новый COMОбъект("WScript.Network");
Порт.EnumPrinterConnections();
Принтер = Порт.AddWindowsPrinterConnection("\\\192.168.1.10\Zebra");
Порт.PrintFile(Принтер, "C:\Temp\label.prn", ТекстКоманды);

5.2. Чтение штрихкодов сканером в документы 1С

Сканеры эмулируют клавиатурный ввод, поэтому для автоматического заполнения полей нужно:

• 🖥️ Настроить фокус на поле ввода (например, ЭлементыФормы.Штрихкод.Активировать()).
• 🔍 Убедиться, что сканер отправляет данные с правильным суффиксом (обычно CR или TAB).
• 📋 Обработать событие ПриИзменении для поиска номенклатуры по штрихкоду.

⚠️ Внимание: При работе с DataMatrix проверьте, что ваш сканер поддерживает 2D-коды. Дешёвые модели (до 5 000 ₽) часто читают только линейные форматы (EAN, Code 128).

6. Автоматизация: генерация штрихкодов при поступлении товаров

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

Процедура ДокументОбъект_ПередЗаписью(Отказ, РежимЗаписи)
Для Каждого Строка Из Объект.Товары Цикл
Если НЕ ЗначениеЗаполнено(Строка.Номенклатура.Штрихкоды) Тогда
НовыйКод = СгенерироватьШтрихкодEAN13(Строка.Номенклатура);
Строка.Номенклатура.Штрихкоды.Добавить(НовыйКод);
КонецЕсли;
КонецЦикла;
КонецПроцедуры

Функция СгенерироватьШтрихкодEAN13(Номенклатура)
Префикс = "20"; // Префикс GS1 для внутреннего использования
УникальныйКод = Формат(Номенклатура.Ссылка.УникальныйИдентификатор(), "ЧГ=0; ТЧГ=0; ДЛ=5");
КодБезКонтрольнойСуммы = Префикс + УникальныйКод;
Возврат РассчитатьКонтрольнуюСуммуEAN13(КодБезКонтрольнойСуммы);
КонецФункции

Важные нюансы:

• 🔢 Используйте уникальные идентификаторы номенклатуры, чтобы избежать дублирования кодов.
• 📌 Для EAN-13 первые 2-3 цифры — это префикс компании (выдаётся в GS1 Russia). Не используйте случайные значения!
• 🔄 При обмене данными с маркетплейсами (Озон, Wildberries) штрихкоды должны соответствовать их требованиям (например, Ozon требует Code 128 с префиксом OZ).

Уточнить требования к формату у контрагентов|Проверить уникальность префиксов|Тестовая печать на 5-10 этикетках|Создать резервную копию базы-->

7. Типичные ошибки и их решение

Даже опытные разработчики сталкиваются с проблемами при работе со штрихкодами. Рассмотрим самые распространённые:

Особое внимание уделите обмену данными с внешними системами. Например, при интеграции с Честный ЗНАК штрихкоды должны соответствовать стандарту GS1 DataMatrix с обязательными полями:

• 📌 01 — GTIN (глобальный номер товара)
• 📌 21 — серийный номер
• 📌 91/92/93 — дополнительные идентификаторы

⚠️ Внимание: Требования к маркировке товаров в России регулярно обновляются. Перед массовой генерацией штрихкодов для ЕГАИС или Честного ЗНАКА сверьте актуальные правила на сайте crpt.ru.

FAQ: Частые вопросы по программной генерации штрихкодов

ВесВГраммах = Формат(Строка.Количество * 1000, "ЧГ=0; ТЧГ=0; ДЛ=5");
КодБезКонтрольнойСуммы = "2001234" + ВесВГраммах;

Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Номенклатура");
Таблица.Колонки.Добавить("Штрихкод");

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
Номенклатура.Наименование КАК Номенклатура,
Номенклатура.Штрихкоды.Значение КАК Штрихкод
ИЗ
Справочник.Номенклатура КАК Номенклатура";
Результат = Запрос.Выполнить();
Таблица.Загрузить(Результат);

ПакетXLS = Новый ПакетЗаписиXLS;
ПакетXLS.УстановитьИмяФайла("C:\Export\Штрихкоды.xlsx");
ПакетXLS.ЗаписатьТаблицу(Таблица);