Как в 1С сгенерировать QR-код: пошаговая инструкция и примеры кода

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

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

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

Встроенные возможности платформы 1С 8.3

Начиная с версии платформы 8.3.10, в конфигурационном языке появился встроенный функционал для работы с QR-кодами. Это значительно упростило задачу для разработчиков, так как отпала необходимость подключать тяжелые внешние компоненты. Основным объектом, отвечающим за эту функцию, является QRCode.

Для генерации кода достаточно создать объект и вызвать метод генерации картинки. Важно отметить, что результат возвращается в виде объекта Картинка, который можно сразу отобразить в поле формы или сохранить в файл. Это позволяет реализовать динамическое создание кодов «на лету» без промежуточных файлов на диске.

⚠️ Внимание: В старых версиях платформы (ниже 8.3.10) встроенный объект QRCode отсутствует, и потребуется использование COM-объектов или внешних обработок.

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

КодировкаQR = Новый КодировкаQR;
КодировкаQR.Текст = "https://mysite.ru/invoice/123";
КодировкаQR.УровеньКоррекцииОшибок = УровеньКоррекцииОшибокQR.Средний;
Картинка = КодировкаQR.СгенерироватьКартинку(200);

Параметр УровеньКоррекцииОшибок играет критическую роль в читаемости кода сканерами. Чем выше уровень, тем больше данных можно восстановить при частичном повреждении изображения, но при этом увеличивается плотность точек. Для печати на этикетках часто выбирают уровень Средний или Высокий.

💡

Если вы планируете печатать QR-коды на термопринтере с низким разрешением, выбирайте уровень коррекции ошибок "Низкий" или "Средний", чтобы точки не сливались в сплошное пятно.

Использование внешних библиотек и COM-объектов

В случаях, когда встроенных средств недостаточно или требуется работа в старых версиях платформы, на помощь приходят внешние компоненты. Чаще всего разработчики используют библиотеки ZXing (Zebra Crossing) или QRCoder, обернутые для работы в среде .NET или через COM-интерфейс.

Подключение внешней обработки требует наличия DLL-файлов на клиентских машинах или на сервере, если генерация происходит в фоновом задании. Это создает дополнительные сложности при администрировании, так как необходимо контролировать версии библиотек на всех рабочих местах.

Однако использование сторонних библиотек дает доступ к расширенным настройкам, таким как выбор цветовой схемы, добавление логотипа в центр кода или изменение формы модулей (точек). Стандартный объект 1С генерирует только черно-белые квадратные матрицы.

Где скачать библиотеки для 1С?

Популярные сборки библиотек для работы с QR и штрих-кодами часто выкладываются на портале ИТС или в репозиториях GitHub. Ищите проекты с пометкой "1C QRCode Library" или "Z bar 1C".

При интеграции через COM-объект важно правильно зарегистрировать компоненту в системе. Ошибки регистрации часто приводят к тому, что код работает на машине разработчика, но падает с ошибкой «Объект не найден» у пользователя.

Генерация QR-кода для маркировки товаров

Одной из самых востребованных задач является формирование кодов для системы Честный ЗНАК. В этом случае QR-код должен содержать специфическую строку формата DataMatrix, хотя визуально он часто воспринимается пользователями как сложный квадратный штрих-код.

Строка маркировки имеет строгий формат и включает в себя идентификаторы применения (AI), такие как 01 для GTIN, 21 для серийного номера и 91 для ключа проверки. Ошибка в одном символе сделает код нечитаемым для приемки товара.

Для корректной генерации необходимо использовать специальные разделители групп данных. В 1С это реализуется через конкатенацию строк с использованием символа GS (Group Separator), который имеет код 29.

☑️ Проверка строки маркировки

Проверить длину GTIN (14 знаков)Убедиться в наличии серийного номераДобавить разделитель GS (символ 29)Проверить контрольную сумму ключа проверки

Выполнено: 0 / 4

Ниже приведен пример формирования строки для маркировки обуви или одежды:

СтрокаМаркировки = "01" + ГТин + "21" + СерийныйНомер + Симв(29) + "91" + КлючПроверки;

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

Отображение и печать в печатных формах

После того как объект Картинка сгенерирован, его необходимо отобразить пользователю или отправить на принтер. В макетах печатных форм (табличный документ) для этого используется поле типа Картинка.

В коде модуля объекта или отчета вы присваиваете этому полю сгенерированное значение. Если вы используете СКД (Систему Компоновки Данных), то поле вывода также должно иметь тип Картинка. Это гарантирует, что изображение не исказится при масштабировании.

При печати на этикет-принтерах часто возникает проблема с инверсией цветов или нечеткостью. Чтобы избежать этого, рекомендуется явно задавать разрешение изображения при генерации, ориентируясь на DPI принтера (обычно 203 или 300 dpi).

Параметр	Значение для этикеток	Значение для А4
Размер (пиксели)	200x200	400x400
Формат файла	PNG (без сжатия)	JPG/PNG
Уровень коррекции	Низкий/Средний	Высокий
Цвет фона	Прозрачный/Белый	Белый

💡

Качество печати QR-кода напрямую зависит от разрешения исходной картинки и типа принтера. Для термопринтеров всегда используйте формат PNG без сжатия.

Считывание QR-кодов с помощью ТСД

Не только генерация, но и считывание кодов является важной частью бизнес-процессов. Терминалы сбора данных (ТСД) на базе Android или Windows CE могут передавать распознанное содержимое прямо в поле ввода 1С.

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

В мобильной платформе 1С существуют встроенные методы для работы с камерой устройства. Это позволяет создать собственное приложение для инвентаризации, которое будет сканировать коды и сразу сверять их с базой данных.

📱 Режим эмуляции клавиатуры: самый простой способ, не требует программирования на стороне 1С.
🔌 Прямое подключение через Bluetooth/USB: требует написания кода для обработки событий сканера.
📷 Использование камеры смартфона: доступно только в мобильных клиентах 1С на Android/iOS.

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

Частые ошибки и способы их решения

В процессе внедрения генерации QR-кодов разработчики сталкиваются с рядом типовых проблем. Одной из самых распространенных является ошибка кодировки, когда вместо ссылки или цифр в коде отображаются «кракозябры».

Это происходит, если при формировании строки используется неверная кодировка символов. Для кириллицы и специальных символов необходимо явно указывать кодировку UTF-8 при передаче данных во внешнюю компоненту или при сохранении в файл.

⚠️ Внимание: Если QR-код не считывается сканером, проверьте, не содержит ли строка недопустимых символов управления (например, перенос строки или табуляцию), которые могли случайно попасть в переменную.

Еще одна проблема — слишком маленький размер кода. Если данных много (например, длинная ссылка с UTM-метками), а размер картинки задан маленьким (100x100 пикселей), плотность точек станет слишком высокой для обычного сканера.

В таких случаях следует либо увеличить размер генерируемого изображения, либо сократить объем зашифрованных данных. Для ссылок можно использовать сервисы сокращения URL перед передачей строки в 1С.

Почему QR-код в печатной форме отображается как красный крест?

Обычно это означает, что поле в макете имеет тип «Строка» или «Число», а в него пытаются записать объект типа «Картинка». Проверьте свойства поля в редакторе макетов.

Можно ли сгенерировать цветной QR-код?

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

Как ускорить генерацию при печати большого количества этикеток?

Генерируйте коды в фоновом задании или кэшируйте результаты, если содержимое кодов повторяется. Не генерируйте картинку в цикле печати для каждой строки, если это возможно.

Зависит ли работа QR-кода от версии 1С?

Да, встроенный объект QRCode появился только в версии 8.3.10. На более старых версиях (8.2 или ранние 8.3) придется использовать внешние обработки или обновления платформы.

Что делать, если сканер не видит код с экрана монитора?

Экраны имеют другую структуру пикселей (RGB) и частоту обновления, чем бумага. Попробуйте увеличить яркость, изменить масштаб изображения или использовать специализированные сканеры для считывания с экранов (Image-based scanners).

Как в 1С сгенерировать QR-код: полное руководство