Почему штрихкод GS1-128 печатается некорректно в 1С и как это исправить?

← К списку

При работе с системой 1С многие из нас сталкиваются с необходимостью вывода на печать различных видов штрихкодов. Одним из таких является GS1-128 – мощный и гибкий стандарт, используемый для кодирования разнообразной информации, такой как глобальные идентификаторы продуктов (GTIN), серийные номера, сроки годности, номера партий и многое другое. Однако, как показывает практика, его корректная генерация и печать в 1С может вызвать ряд вопросов и затруднений.

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

Основные сложности и их решение

Давайте проанализируем ситуацию и выясним, какие нюансы чаще всего приводят к ошибкам при печати GS1-128.

Формат данных и идентификаторы применения (AI):

Штрихкод GS1-128 использует специальные идентификаторы применения (AI), заключенные в скобки, например, (00) для GTIN, (11) для даты производства. Эти скобки предназначены для удобства чтения человеком. Однако, при передаче данных в компоненту генерации штрихкода, возникает вопрос: нужны ли эти скобки в самой строке данных?

Наш опыт показывает, что в некоторых случаях, особенно при использовании ТипКода = 2 (EAN128), передача AI вместе со скобками может быть критичной для корректного формирования штрихкода. То есть, вместо строки 001234567890123456 может потребоваться (00)1234567890123456. Это расходится со стандартной практикой, где скобки обычно исключаются из закодированной строки, но в рамках 1С-компоненты это может быть необходимым шагом.
Служебный символ FNC1:

Каждый штрихкод GS1-128 начинается со служебного символа FNC1, который указывает сканеру, что перед ним последовательность данных стандарта GS1-128. Кроме того, FNC1 используется как разделитель полей данных переменной длины (например, AI (10) – номер партии, (21) – серийный номер) от следующих за ними идентификаторов применения. Если поле переменной длины является последним в штрихкоде, FNC1 после него не требуется.

В 1С этот невидимый символ часто представляется как Символ(29) (Group Separator). Важно убедиться, что ваша строка данных содержит FNC1 в нужных местах, иначе штрихкод может быть сформирован неверно или не прочитан сканером.
Выбор правильного типа кодирования (ТипКода):

В компоненте "1С:Печать штрихкодов" (часто входящей в Библиотеку стандартных подсистем - БСП) мы используем параметр ТипКода. Для GS1-128 существует несколько опций, которые могут ввести в заблуждение:
- ТипКода = 2: Соответствует EAN128, который является синонимом GS1-128. На практике именно этот тип кода часто дает корректный результат, особенно с учетом нюанса со скобками в AI.
- ТипКода = 24: Также предназначен для GS1-128. В некоторых случаях именно он может быть более подходящим, особенно если вы передаете уже декодированную строку из Base64.
Мы рассмотрим оба варианта, поскольку их поведение может зависеть от версии компоненты и специфики входных данных.
Обработка Base64-данных:

Нередко данные для штрихкода, например, код маркировки, приходят в формате Base64. Компонента 1С может поддерживать прямое указание типа входных данных как Base64-строки. Однако, по опыту, иногда требуется предварительно декодировать Base64-строку в обычную строку перед передачей в генератор штрихкода, используя функции Base64Значение() и ПолучитьСтрокуИзДвоичныхДанных().

Подробный разбор решения: пошаговое формирование GS1-128 в 1С

Давайте разберем по шагам, как мы можем добиться корректной печати штрихкода GS1-128, используя компоненту "1С:Печать штрихкодов". Предположим, что у вас уже подключена и доступна стандартная компонента генерации штрихкодов (например, через общий модуль ГенерацияШтрихкода или внешний объект AddIn.V8.Barcode).

Шаг 1: Подготовка данных для GS1-128

Прежде всего, нам нужно сформировать строку, которая будет содержать все необходимые данные для штрихкода. Мы должны учитывать идентификаторы применения (AI) и служебный символ FNC1.

Важный момент со скобками: Если вы используете ТипКода = 2 (EAN128) и сталкиваетесь с проблемами, попробуйте передавать AI вместе со скобками, как показано в примере ниже. Если же вы используете ТипКода = 24 или ваш штрихкод все равно печатается некорректно со скобками, попробуйте вариант без них, но с обязательным добавлением FNC1.

Рассмотрим пример, где нам нужно закодировать GTIN 01234567890128 (AI (01)) и серийный номер ABCDE12345 (AI (21)).

Первым делом, нам потребуется функция для получения символа FNC1:


Функция ПолучитьFNC1()
    Возврат Символ(29);
КонецФункции

Теперь соберем строку данных. Обратите внимание, что FNC1 ставится между AI переменной длины и следующим AI. Если AI фиксированной длины (как (01)), FNC1 не требуется.

Пример 1: Строка данных для ТипКода = 2 (EAN128) со скобками (вариант, который помог многим):


// Пример данных
GTIN = "01234567890128";
СерийныйНомер = "ABCDE12345";

// Формируем строку штрихкода
СтрокаДляШтрихкода = "(01)" + GTIN + "(21)" + СерийныйНомер; 
// Здесь FNC1 не требуется, так как (01) и (21) - это AI фиксированной длины,
// а (21) является последним AI. Если бы после (21) был бы еще AI,
// и (21) был бы переменной длины, то понадобился бы FNC1.
// В данном случае, AI(21) имеет фиксированную длину 20 символов, но в тексте может быть разной.
// Если бы СерийныйНомер был переменной длины и не последним, то:
// СтрокаДляШтрихкода = "(01)" + GTIN + "(21)" + СерийныйНомер + ПолучитьFNC1() + "(17)" + СрокГодности;

Пример 2: Строка данных для ТипКода = 24 (GS1-128) или стандартный подход без скобок, но с FNC1:


// Пример данных
GTIN = "01234567890128";
СерийныйНомер = "ABCDE12345";

// Формируем строку штрихкода без скобок, но с FNC1
// AI (01) - фиксированной длины (14 цифр)
// AI (21) - переменной длины (до 20 символов). Если это последний AI, FNC1 не нужен.
// Если бы после него был еще AI, то FNC1 был бы нужен как разделитель.
СтрокаДляШтрихкода = "01" + GTIN + "21" + СерийныйНомер; 
// Если бы СерийныйНомер был переменной длины и не последним:
// СтрокаДляШтрихкода = "01" + GTIN + "21" + СерийныйНомер + ПолучитьFNC1() + "17" + СрокГодности;

Мы рекомендуем протестировать оба подхода с вашей компонентой, начиная с того, что оказался успешным у многих пользователей (со скобками для ТипКода = 2).

Шаг 2: Выбор правильного типа кодирования в 1С

После того как мы подготовили строку данных, нам необходимо указать компоненте генерации штрихкода, какой тип символики мы используем. Здесь нам пригодятся параметры ТипКода = 2 и ТипКода = 24.

Разберем оба варианта:

Вариант А: Использование ТипКода = 2 (EAN128)

Этот вариант часто оказывается рабочим, если строка данных формируется со скобками для AI, как в "Примере 1" выше.


// Создаем структуру параметров штрихкода
ПараметрыШтрихкода = Новый Структура();
ПараметрыШтрихкода.Вставить("ТипКода", 2); // EAN128
ПараметрыШтрихкода.Вставить("Штрихкод", СтрокаДляШтрихкода); // Строка со скобками, например: (01)01234567890128(21)ABCDE12345

// Дополнительные параметры (размер, разрешение и т.д.)
ПараметрыШтрихкода.Вставить("Высота", 200);
ПараметрыШтрихкода.Вставить("Ширина", 800);
ПараметрыШтрихкода.Вставить("Масштаб", 1);
ПараметрыШтрихкода.Вставить("Разрешение", 96);
ПараметрыШтрихкода.Вставить("ПоказыватьТекст", Истина);

// Получаем объект генератора штрихкода (зависит от вашей БСП или внешней компоненты)
// Например, если используется общий модуль ГенерацияШтрихкода:
РезультатШтрихкод = ГенерацияШтрихкода.ИзображениеШтрихкода(ПараметрыШтрихкода);

// РезультатШтрихкод будет содержать ДвоичныеДанные изображения штрихкода

Вариант Б: Использование ТипКода = 24 (GS1-128)

Этот вариант может быть более "правильным" с точки зрения стандартов, но требует, чтобы строка данных была сформирована без скобок AI, но с корректными FNC1, как в "Примере 2". Именно этот тип кода упоминался в контексте успешной обработки декодированных Base64-данных.


// Создаем структуру параметров штрихкода
ПараметрыШтрихкода = Новый Структура();
ПараметрыШтрихкода.Вставить("ТипКода", 24); // GS1-128
ПараметрыШтрихкода.Вставить("Штрихкод", СтрокаДляШтрихкода); // Строка без скобок, например: 010123456789012821ABCDE12345

// Дополнительные параметры (размер, разрешение и т.д.)
ПараметрыШтрихкода.Вставить("Высота", 200);
ПараметрыШтрихкода.Вставить("Ширина", 800);
ПараметрыШтрихкода.Вставить("Масштаб", 1);
ПараметрыШтрихкода.Вставить("Разрешение", 96);
ПараметрыШтрихкода.Вставить("ПоказыватьТекст", Истина);

// Получаем объект генератора штрихкода
РезультатШтрихкод = ГенерацияШтрихкода.ИзображениеШтрихкода(ПараметрыШтрихкода);

Шаг 3: Обработка Base64-данных (если применимо)

Если данные для вашего штрихкода приходят в формате Base64 (например, от системы маркировки), вам потребуется их преобразовать. Здесь есть два основных подхода:

Подход 1: Предварительное декодирование Base64 в строку

Этот метод оказался успешным для многих пользователей и предполагает использование стандартных функций 1С для декодирования перед передачей в генератор.


КодМаркировкиbase64 = "MDIwM...<ваша base64 строка>..."; // Пример Base64-строки

// Декодируем Base64 в двоичные данные, затем в строку
СтрокаДляШтрихкода = ПолучитьСтрокуИзДвоичныхДанных(Base64Значение(КодМаркировкиbase64));

// Теперь используем эту СтрокаДляШтрихкода с ТипКода = 24 (или 2, если экспериментируете)
ПараметрыШтрихкода = Новый Структура();
ПараметрыШтрихкода.Вставить("ТипКода", 24); 
ПараметрыШтрихкода.Вставить("Штрихкод", СтрокаДляШтрихкода);
// ... остальные параметры
РезультатШтрихкод = ГенерацияШтрихкода.ИзображениеШтрихкода(ПараметрыШтрихкода);

Важно: Убедитесь, что после декодирования строка СтрокаДляШтрихкода содержит все необходимые символы FNC1 в правильных местах. Вы можете проверить это, например, функцией СтрНайти(СтрокаДляШтрихкода, Символ(29)).

Подход 2: Передача Base64 напрямую (через ТипВходныхДанных)

Некоторые версии компоненты "1С:Печать штрихкодов" поддерживают прямое указание, что входные данные являются Base64-строкой. В этом случае, вам не нужно декодировать строку вручную.


КодМаркировкиbase64 = "MDIwM...<ваша base64 строка>..."; // Пример Base64-строки

ПараметрыШтрихкода = Новый Структура();
ПараметрыШтрихкода.Вставить("ТипКода", 24); // Или 2, в зависимости от требований
ПараметрыШтрихкода.Вставить("Штрихкод", КодМаркировкиbase64);
ПараметрыШтрихкода.Вставить("ТипВходныхДанных", 1); // 1 = Base64Строка (может отличаться в разных версиях БСП)
// ... остальные параметры
РезультатШтрихкода = ГенерацияШтрихкода.ИзображениеШтрихкода(ПараметрыШтрихкода);

Мы рекомендуем начинать с "Подхода 1", так как он показал себя более надежным по отзывам пользователей.

Шаг 4: Генерация изображения штрихкода

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


// Предполагаем, что ПараметрыШтрихкода уже заполнены согласно предыдущим шагам
// и содержат корректный ТипКода и СтрокаДляШтрихкода/КодМаркировкиbase64.

Попытка
    РезультатШтрихкод = ГенерацияШтрихкода.ИзображениеШтрихкода(ПараметрыШтрихкода);
    Если РезультатШтрихкод <> Неопределено Тогда
        // Штрихкод успешно сгенерирован. 
        // Теперь вы можете использовать РезультатШтрихкод (ДвоичныеДанные)
        // для печати (например, через макет или ТабличныйДокумент)
        // или для сохранения в файл.
        Сообщить("Штрихкод успешно сгенерирован!");
    Иначе
        Сообщить("Не удалось сгенерировать штрихкод. Проверьте параметры.", СтатусСообщения.Важное);
    КонецЕсли;
Исключение
    Сообщить("Ошибка при генерации штрихкода: " + ОписаниеОшибки(), СтатусСообщения.Важное);
КонецПопытки;

Альтернативные подходы к генерации GS1-128

Помимо стандартной компоненты 1С, существуют и другие способы генерации штрихкодов GS1-128, которые могут быть полезны в специфических случаях:

Внешние COM-объекты и компоненты: Мы можем использовать сторонние решения, такие как Ocvita Barcode ActiveX или StrokeScribe. Эти компоненты предоставляют более тонкую настройку и могут быть полезны, если стандартные средства 1С не справляются с вашими требованиями. Например, для StrokeScribe свойство Alphabet устанавливается в 17 для GS1-128.
Прямая печать на принтер: Для некоторых принтеров штрихкодов (например, Godex) можно использовать их собственный язык управления (например, EZPL). В этом случае мы формируем команду на языке принтера, которая включает данные штрихкода и его параметры, и отправляем ее напрямую на принтер. Этот метод требует глубокого понимания языка принтера, но позволяет добиться максимальной гибкости и скорости печати.

Важные рекомендации

В завершение, давайте рассмотрим несколько общих рекомендаций, которые помогут вам в работе с GS1-128:

Порядок AI: При формировании штрихкода GS1-128 рекомендуется сначала располагать идентификаторы применения фиксированной длины, а затем — переменной длины. Это может помочь в более компактном кодировании и более надежном считывании.
Формат дат: Все даты в GS1-128 указываются в формате ГГММДД (YYMMDD). Учитывайте это при подготовке данных.
Максимальная длина: Символика GS1-128 имеет максимальную длину до 48 символов, включая идентификаторы применения и специальные разделители. Следите за тем, чтобы не превысить это ограничение.
Тестирование: Всегда тщательно тестируйте сгенерированные штрихкоды с помощью реального сканера. Это единственный надежный способ убедиться в их корректности.

Надеемся, что этот подробный разбор поможет вам успешно справиться с задачей вывода на печать штрихкодов GS1-128 в 1С. Удачи в вашей работе!

← К списку