Вывод штрихкода в печатную форму 1С: полное руководство с примерами

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

В этой статье мы разберем все этапы — от выбора формата штрихкода (EAN-13, Code 128, QR-код) до внедрения его в печатные формы документов (РеализацияТоваровУслуг, СчетФактура, ТоварнаяНакладная). Особое внимание уделим двум ключевым подходам: использованию встроенных механизмов 1С (через шрифты штрихкодов) и программной генерации с помощью внешних библиотек. Также рассмотрим типичные ошибки, которые приводят к нечитаемым кодам, и способы их устранения.

Материал будет полезен как начинающим разработчикам 1С, так и опытным специалистам, которые хотят оптимизировать процесс печати документов со штрихкодами. Все примеры приведены для актуальных версий платформы 1С:Предприятие 8.3, но majority принципов применимы и к 8.2.

1. Выбор формата штрихкода: какой подходит для вашей задачи

Прежде чем настраивать печатную форму, определитесь с типом штрихкода. От этого зависит не только внешний вид, но и совместимость с оборудованием (сканерами, принтерами этикеток). В 1С чаще всего используют:

• 📦 EAN-13/EAN-8 — стандарт для розничной торговли (используется на упаковках товаров). Поддерживается всеми сканерами, но ограничен 13 или 8 цифрами.
• 📋 Code 128 — универсальный формат для логистики и складского учета. Позволяет кодировать буквы, цифры и спецсимволы, длина не ограничена.
• 🔗 QR-код — подходит для хранения большого объема данных (например, ссылок на документы или JSON-структур). Требует 2D-сканер.
• 🏷️ Code 39 — простой алфавитно-цифровой код, часто используется для внутренней маркировки.

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

⚠️ Внимание: Если вы работаете с маркетплейсами (Ozon, Wildberries, Яндекс Маркет), уточните требования к формату штрихкода в их документации. Некоторые платформы требуют обязательного наличия GS1-префикса в EAN-13.

При выборе формата учитывайте также ограничения оборудования. Например, дешевые сканеры могут не поддерживать QR-коды, а термотрансферные принтеры этикеток часто оптимизированы под Code 128.

2. Подготовка 1С: установка шрифтов и компонент для штрихкодов

Чтобы вывести штрихкод в печатную форму, необходимо обеспечить его визуализацию. В 1С это делается двумя способами:

1. Через специализированные шрифты (например, Free 3 of 9, IDAutomationHC39M). Штрихкод в этом случае — это текст, отображаемый особым шрифтом.
2. Через программную генерацию (с использованием внешних компонент или встроенных механизмов платформы).

Рассмотрим оба варианта подробнее.

2.1. Установка шрифтов штрихкодов

Это самый простой способ, не требующий программирования. Вам понадобится:

1. Скачать бесплатный шрифт (например, Free 3 of 9 для Code 39 или IDAutomationHC39M для Code 128).
2. Установить его на все рабочие станции, где будет происходить печать.
3. В макете печатной формы указать этот шрифт для поля со штрихкодом.

Где скачать шрифты:

• 🌐 DaFont (бесплатные шрифты, ищите по запросу "barcode").
• 🛒 IDAutomation (платные профессиональные шрифты с поддержкой всех форматов).

⚠️ Внимание: Бесплатные шрифты могут иметь ограничения на коммерческое использование. Перед установкой проверьте лицензию!

Пример кода для подключения шрифта в макете 1С (через конструктор печатной формы):

// В макете печатной формы:
ПолеШтрихкода.Шрифт = Новый Шрифт("Free 3 of 9", 12, Истина, Ложь, Ложь);
ПолеШтрихкода.Текст = "" + Штрихкод + ""; // Для Code 39 требуются звездочки по краям

2.2. Программная генерация штрихкодов

Если шрифты не подходят (например, нужен QR-код или динамическая генерация), используйте внешние компоненты:

• 📦 BarcodeLib — бесплатная библиотека для генерации штрихкодов (поддерживает EAN-13, Code 128, QR).
• 🔧 1C:Barcode — платное решение от фирмы "1С" с готовыми обработками.
• 🖥️ ZXing — открытая библиотека для генерации QR-кодов (можно подключить через HTTP-сервис).

Пример подключения BarcodeLib:

// 1. Добавить библиотеку в внешние обработки
// 2. В модуле печатной формы:
БиблиотекаШтрихкодов = Новый COMОбъект("BarcodeLib.Barcode");
КартинкаШтрихкода = БиблиотекаШтрихкодов.Encode(ТипШтрихкода, Штрихкод, 300, 100);
Макет.ВставитьКартинку(КартинкаШтрихкода, "Штрихкод");

3. Добавление штрихкода в макет печатной формы

Теперь перейдем к практике. Рассмотрим, как внедрить штрихкод в печатную форму документа РеализацияТоваровУслуг на примере EAN-13.

3.1. Редактирование макета в конфигураторе

Откройте конфигуратор и выполните следующие шаги:

1. Перейдите в Объекты → Документы → РеализацияТоваровУслуг → Печатные формы.
2. Выберите нужную форму (например, ТоварнаяНакладная) и откройте её макет.
3. Добавьте новое текстовое поле в область таблицы с товарами.
4. Настройте поле:
   • Шрифт: IDAutomationHC39M (или другой, в зависимости от формата).
   • Выравнивание: по центру.
   • Размер: 10–12 пт (зависит от плотности печати).

Пример заполнения поля в макете:

// В модуле макета:
Процедура ПриКомпоновкеДанных(ДанныеРасшифровкиСтроки, ДанныеСтроки)
Если ДанныеРасшифровкиСтроки.СтрокиТоваров.Количество() > 0 Тогда
Для Каждого Товар Из ДанныеРасшифровкиСтроки.СтрокиТоваров Цикл
Товар.Штрихкод = СформироватьШтрихкодEAN13(Товар.Артикул);
КонецЦикла;
КонецЕсли;
КонецПроцедуры

Функция СформироватьШтрихкодEAN13(Артикул)
// Логика преобразования артикула в EAN-13
Возврат "2" + Формат(Артикул, "ЧГ=0; ЧЦ=12; ЧДЦ=0") + Строка(КонтрольнаяСуммаEAN13(Артикул));
КонецФункции

3.2. Альтернатива: вывод штрихкода как картинки

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

1. В макете добавьте поле типа Картинка.
2. В модуле формы сгенерируйте изображение и вставьте его в макет:

   КартинкаШтрихкода = БиблиотекаШтрихкодов.Encode(BarcodeLib.TYPE.EAN13, Штрихкод, 200, 80);
   Макет.Элементы.Штрихкод.Картинка = КартинкаШтрихкода;

⚠️ Внимание: При печати на термотрансферных принтерах (например, Zebra или TSC) может потребоваться настройка DPI (разрешения) картинки. Оптимальное значение — 200–300 dpi.

4. Генерация штрихкода для конкретных документов

Разберем, как автоматически формировать штрихкоды для разных типов документов.

4.1. Штрихкод для товарной накладной

В ТоварнаяНакладная штрихкод обычно выводится для каждой позиции товара. Алгоритм:

1. В табличной части документа добавьте реквизит Штрихкод (тип Строка, длина 20).
2. Заполните его при проведении документа:

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

3. В печатной форме выведите этот реквизит с нужным шрифтом.

4.2. Штрихкод для счета-фактуры

В СчетФактура штрихкод может использоваться для быстрой идентификации документа. Например, можно закодировать номер и дату счета в Code 128:

Функция СформироватьШтрихкодДляСчета(Номер, Дата)
ТекстДляКодирования = Формат(Дата, "ДФ=yyyyMMdd") + "-" + Номер;
Возврат ТекстДляКодирования;
КонецФункции

В печатной форме добавьте поле с текстом:

Макет.Параметры.ШтрихкодСчета = СформироватьШтрихкодДляСчета(Документ.Номер, Документ.Дата);

4.3. Динамический штрихкод для этикеток

Для печати этикеток на принтере (например, Zebra ZD420) используйте специализированные обработки. Пример структуры данных для этикетки:

Поле	Тип данных	Пример значения	Формат штрихкода
Артикул	Строка	AB12345	Code 128
Наименование	Строка	Ноутбук ASUS X515	—
Цена	Число	45990.00	—
Штрихкод (EAN-13)	Строка	4601234567894	EAN-13
Срок годности	Дата	31.12.2026	—

Для генерации этикеток можно использовать обработку ПечатьЭтикеток.epf (доступна на Infostart).

Как проверить корректность штрихкода EAN-13?

Контрольная сумма EAN-13 рассчитывается по алгоритму:

1. Суммируйте цифры на четных позициях (2, 4, 6...) и умножьте на 3.

2. Суммируйте цифры на нечетных позициях (1, 3, 5...).

3. Сложите результаты п.1 и п.2.

4. Контрольная цифра = (10 - (сумма % 10)) % 10.

Пример для кода 4601234567894:

(6+1+3+6+8) * 3 + (4+0+2+4+7+9) = 111 + 26 = 137 → 137 % 10 = 7 → 10 - 7 = 3 → контрольная цифра 4 (совпадает с последней цифрой кода).

5. Типичные ошибки и их устранение

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

• 🔍 Штрихкод не сканируется:
  • Проверьте, что используется правильный шрифт (например, для Code 39 обязательны звездочки * по краям).
  • Увеличьте высоту штрихкода в макете (минимум 30 мм для EAN-13).
  • Проверьте разрешение печати (для термопринтеров — не менее 203 dpi).
• 🖨️ Штрихкод обрезается при печати:
  • Увеличьте поля страницы в настройках печати.
  • Проверьте, что поле штрихкода не выходит за границы ячейки в макете.
• 📉 Некорректная контрольная сумма (для EAN-13):
  • Используйте функцию расчета контрольной суммы (пример приведен в спойлере выше).
  • Проверьте, что артикул не содержит букв (EAN-13 поддерживает только цифры).
• 🔤 Штрихкод отображается как обычный текст:
  • Убедитесь, что шрифт штрихкода установлен на ПК, с которого происходит печать.
  • Проверьте, что в макете для поля указан именно этот шрифт.

⚠️ Внимание: Если вы печатаете на термопринтере, убедитесь, что в драйвере принтера отключен параметр "Оптимизация для текста". Это может искажать штрихкоды, сгенерированные как картинки.

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

• 🌐 Barcode.is (проверка EAN-13, Code 128).
• 🌐 ZXing Decoder (для QR-кодов).

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

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

1. Добавьте в справочник Номенклатура реквизит Штрихкод (тип Строка, длина 20).
2. Создайте обработку заполнения штрихкода при записи элемента:

   Процедура ПриЗаписи(Отказ)
   Если ПустаяСтрока(Штрихкод) Тогда
   Штрихкод = СгенерироватьШтрихкодEAN13(Артикул);
   КонецЕсли;
   КонецПроцедуры
   
   Функция СгенерироватьШтрихкодEAN13(Артикул)
   // Логика генерации (например, префикс компании + артикул + контрольная сумма)
   Префикс = "20"; // Префикс GS1 вашей компании
   ОсновнаяЧасть = Формат(Артикул, "ЧГ=0; ЧЦ=10; ЧДЦ=0");
   КонтрольнаяЦифра = РассчитатьКонтрольнуюСуммуEAN13(Префикс + ОсновнаяЧасть);
   Возврат Префикс + ОсновнаяЧасть + КонтрольнаяЦифра;
   КонецФункции

3. Настройте уникальность штрихкодов (проверка на дубли в базе).

Для генерации GS1-совместимых штрихкодов вам потребуется:

• 📌 Зарегистрироваться в GS1 Russia и получить префикс компании.
• 📊 Следовать правилам формирования EAN-13 (первые 2–3 цифры — префикс, следующие — артикул, последняя — контрольная сумма).

⚠️ Внимание: Если вы работаете с международными поставщиками, уточните, требуется ли регистрация штрихкодов в GS1. Незарегистрированные коды могут не пройти проверку на некоторых маркетплейсах.

7. Печать штрихкодов на специализированном оборудовании

Для массовой печати этикеток используйте термотрансферные или термопринтеры (например, Zebra, TSC, Godex). Особенности настройки:

• 🖨️ Принтеры Zebra:
  • Используйте язык разметки ZPL или EPL.
  • Пример команды для печати штрихкода Code 128:

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

• 📋 Принтеры TSC:
  • Используйте язык TSPL.
  • Пример:

    SIZE 50 mm, 30 mm
    GAP 2 mm, 0
    BARCODE 100,50,"128",50,1,0,2,5,"12345678"

Для интеграции принтера с 1С:

1. Установите драйвер принтера на сервер 1С.
2. Настройте порт печати (например, \\server\Zebra_ZD420).
3. Используйте обработку печати, которая отправляет команды ZPL/EPL напрямую на принтер:

   ТекстКоманды = "^XA^FO50,50^BY3^BCN,100,Y,N,N^FD" + Штрихкод + "^FS^XZ";
   Порт = Новый COMОбъект("WScript.Network").EnumPrinterConnections();
   ЗначениеПорта = Порт.Item(0); // Например, "\\server\Zebra_ZD420"
   Файл = Новый ЗаписьТекста();
   Файл.Открыть(ЗначениеПорта);
   Файл.ЗаписатьСтроку(ТекстКоманды);
   Файл.Закрыть();

Для упрощения интеграции можно использовать готовые обработки:

• 📦 Печать этикеток на принтерах Zebra из 1С (Infostart).
• 🛒 1С:Печать штрихкодов и этикеток (официальное решение).

8. Продвинутые сценарии: динамические штрихкоды и QR-коды

Если стандартных штрихкодов недостаточно, рассмотрите продвинутые варианты:

8.1. QR-коды с данными документа

QR-код может содержать:

• 📄 Ссылку на документ в 1С (например, http://server/hs/exchange/guid/123e4567-e89b-12d3-a456-426614174000).
• 📋 JSON-структуру с реквизитами (например, для мобильного приложения сканирования).
• 🔗 Данные для быстрой оплаты (номер счета, сумма, реквизиты банка).

Пример генерации QR-кода через ZXing:

// 1. Подключите библиотеку ZXing.Net (через HTTP-сервис или COM)
// 2. Сформируйте данные для QR-кода
Данные = "{""document"": ""Накладная №123"", ""date"": ""2026-05-20"", ""sum"": 10000}";
QRКод = ГенераторQR.Сгенерировать(Данные, 200, 200);
// 3. Вставьте в макет
Макет.Элементы.QRКод.Картинка = QRКод;

8.2. Динамические штрихкоды с изменяемыми данными

Иногда требуется, чтобы штрихкод содержал актуальные данные, например:

• 📅 Дату печати (для этикеток с ограниченным сроком действия).
• 📦 Номер партии или серию товара.
• 🔄 Статус документа (например, "Оплачено" или "Отгружено").

Пример для этикетки с датой:

Функция СформироватьДинамическийШтрихкод(Артикул, ДатаПечати)
Текст = Артикул + Формат(ДатаПечати, "ДФ=yyyyMMdd");
Возврат Текст;
КонецФункции

// В печатной форме:
Штрихкод = СформироватьДинамическийШтрихкод(Товар.Артикул, ТекущаяДата());

8.3. Интеграция со сканерами штрихкодов

Для автоматизации ввода данных настройте взаимодействие 1С со сканерами:

• 📡 Эмуляция клавиатуры: большинство сканеров отправляют данные как набор символов (как будто их ввели с клавиатуры). В 1С достаточно сфокусироваться на поле ввода.
• 🔌 COM-порт: для промышленных сканеров (например, Cognex) может потребоваться написание обработки для чтения данных с порта.
• 🌐 Сетевые сканеры: некоторые модели (например, Honeywell) передают данные по Wi-Fi напрямую в 1С через HTTP-запросы.

Пример обработки данных от сканера в форме документа:

Процедура ПолеВводаШтрихкодаПриИзменении(Элемент)
Штрихкод = Элемент.Значение;
Если Длина(Штрихкод) = 13 Тогда // Проверка на EAN-13
Номенклатура = Справочники.Номенклатура.НайтиПоРеквизиту("Штрихкод", Штрихкод);
Если Номенклатура.Пустая() Тогда
Сообщить("Товар не найден!");
Иначе
ТекущаяСтрока.Номенклатура = Номенклатура;
ТекущаяСтрока.Количество = 1;
КонецЕсли;
КонецЕсли;
КонецПроцедуры

FAQ: Ответы на частые вопросы

Как проверить, что штрихкод EAN-13 корректен?

Используйте калькулятор контрольной суммы GS1 или проверьте вручную:

1. Суммируйте цифры на четных позициях (вторая, четвертая и т.д.), умножьте сумму на 3.