Как появляется QR-код в 1С: от стандартных печатных форм до программного кода

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

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

Встроенные механизмы генерации QR в типовых конфигурациях

Большинство современных типовых решений 1С уже содержат готовые механизмы для работы с QR-кодами. Их не нужно программировать с нуля — достаточно правильно настроить. Рассмотрим, где и как они реализованы.

В конфигурациях семейства "1С:Бухгалтерия" (начиная с версии 3.0) QR-коды автоматически формируются в следующих документах:

• 📄 Счета-фактуры (для маркировки в рамках 54-ФЗ и электронного документооборота)
• 📋 Товарные накладные (при интеграции с системами маркировки"Честный ЗНАК")
• 💰 Кассовые чеки (для фискальных регистраторов с поддержкой QR)
• 📦 Этикетки товаров (в модулях"Управление торговлей" и"Розница")

Для активации генерации обычно достаточно:

1. Обновить конфигурацию до актуальной версии (не ниже 3.0.120 для бухгалтерии)
2. Включить опцию"Использовать QR-коды" в настройках параметров учёта (Главное → Настройки → Параметры учёта → Печатные формы)
3. Убедиться, что в карточке организации заполнены реквизиты для формирования кодов (ИНН, КПП, адрес сайта ФНС)

⚠️ Внимание: В конфигурациях до версии 8.3.18 для генерации QR требовалось подключать внешние компоненты. Сейчас платформа использует встроенный механизм на основе библиотеки ZXing, но в устаревших базах могут сохраняться старые схемы формирования.

Техническая реализация: как платформа 1С создаёт QR

С точки зрения внутренней архитектуры, генерация QR-кодов в 1С:Предприятие 8.3 осуществляется через специализированные объекты и методы. Основные компоненты системы:

ШтрихКод = Новый ШтрихКод;
ШтрихКод.ТипШтрихКода = ТипШтрихКода.QRCode;

ПечатнаяФорма.ДобавитьШтрихКод(ШтрихКод,"QR_1");

Данные ="ИНН=1234567890&Сумма=1000";
ШтрихКод.Значение = ЗначениеВШтрихКод(Данные);

Параметры = Новый ПараметрыШтрихКода;
Параметры.УровеньКоррекции = 3; // Максимальная

Процесс генерации проходит в три этапа:

1. Формирование данных — сбор информации для кодирования (реквизиты документа, суммы, идентификаторы)
2. Кодирование — преобразование данных в графический QR через объект ШтрихКод
3. Визуализация — вывод на печатную форму или в электронный документ

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

Программное создание QR: примеры кода для разработчиков

Когда стандартных механизмов недостаточно, разработчики могут создавать QR-коды через встроенный язык. Рассмотрим типичные сценарии с готовыми примерами кода.

1. Простой QR с фиксированным текстом

Самый базовый вариант — генерация кода с заранее известным содержимым:

Процедура СформироватьПростойQR
ШтрихКод = Новый ШтрихКод;
ШтрихКод.ТипШтрихКода = ТипШтрихКода.QRCode;
ШтрихКод.Значение ="https://example.com/doc123";

// Настройка внешнего вида
Параметры = Новый ПараметрыШтрихКода;
Параметры.Высота = 100;
Параметры.ЦветШтрихов = ВебЦвет.Черный;
Параметры.ЦветФона = ВебЦвет.Белый;

ШтрихКод.Параметры = Параметры;
Картинка = ШтрихКод.ПолучитьИзображение;
Картинка.Записать("C:\Temp\qr_code.png");
КонецПроцедуры

2. Динамический QR на основе данных документа

Более практичный пример — формирование кода с данными из текущего документа:

Процедура СформироватьQRДляДокумента(Документ)
Данные = СтрШаблон("ИНН=%1&КПП=%2&Номер=%3&Дата=%4",
Документ.Организация.ИНН,
Документ.Организация.КПП,
Документ.Номер,
Формат(Документ.Дата,"ДФ=yyyyMMdd"));

ШтрихКод = Новый ШтрихКод;
ШтрихКод.ТипШтрихКода = ТипШтрихКода.QRCode;
ШтрихКод.Значение = ЗначениеВШтрихКод(Данные);

Возврат ШтрихКод.ПолучитьИзображение;
КонецПроцедуры

3. QR с логотипом компании

Для брендирования можно добавлять логотип в центр QR-кода:

Процедура СформироватьQRСЛоготипом(Текст, ПутьКЛоготипу)
ШтрихКод = Новый ШтрихКод;
ШтрихКод.ТипШтрихКода = ТипШтрихКода.QRCode;
ШтрихКод.Значение = Текст;

// Загружаем логотип и масштабируем
Логотип = Новый Картинка(ПутьКЛоготипу);
Логотип.ИзменитьРазмер(50, 50);

// Добавляем логотип в центр QR
Параметры = Новый ПараметрыШтрихКода;
Параметры.ДополнительноеИзображение = Логотип;
ШтрихКод.Параметры = Параметры;

Возврат ШтрихКод.ПолучитьИзображение;
КонецПроцедуры

Сканер успешно читает код с первого раза|Данные в коде соответствуют исходным|Размер кода не менее 2x2 см для печати|Цветовая схема обеспечивает контрастность|Код сохраняет читаемость при масштабировании-->

QR в печатных формах: настройка и типичные ошибки

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

Добавление QR в макет печатной формы

Инструкция для конфигуратора:

1. Откройте макет печатной формы в режиме редактирования (Файл → Открыть → Макет)
2. Добавьте новый элемент типа"Поле штрихкода" (Вставка → Штрихкод)
3. В свойствах элемента укажите:
   • 📌 Тип штрихкода = QRCode
   • 📌 Источник данных = выражение или реквизит с данными
   • 📌 Размер = не менее 30x30 мм для печати

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

Проблемы с QR-кодами в печатных формах обычно сводятся к нескольким типовым ситуациям:

⚠️ Внимание: При выводе QR на термопринтеры (например, для этикеток) обязательно тестируйте коды на реальном оборудовании. Многие термоголовки искажают мелкие детали, что делает коды нечитаемыми. Оптимальный размер для термопечати — не менее 25x25 мм.

QR для маркировки товаров: особенности работы с"Честный ЗНАК"

С 2026 года обязательная маркировка распространилась на большинство групп товаров, и 1С стала ключевым инструментом для работы с этой системой. QR-коды здесь выполняют особую роль — они содержат уникальные идентификаторы маркировки (GTIN), которые проверяются через систему Честный ЗНАК.

Для корректной работы необходимо:

• 📦 Настроить интеграцию с Честный ЗНАК через 1С:Диадок или прямое подключение
• 🔄 Автоматизировать получение кодов маркировки при поступлении товаров
• 🖨️ Настроить печать этикеток с QR на складе
• 📊 Организовать учёт остатков по маркированным товарам

Пример кода для формирования QR с кодом маркировки:

Процедура СформироватьQRМаркировки(КодМаркировки)
// Код маркировки должен быть в формате DataMatrix или GS1
Если Не РегВыр.Проверка("^\d{14}$", КодМаркировки) Тогда
ВызватьИсключение"Некорректный формат кода маркировки";
КонецЕсли;

ШтрихКод = Новый ШтрихКод;
ШтрихКод.ТипШтрихКода = ТипШтрихКода.DataMatrix; // Или QRCode для совместимости
ШтрихКод.Значение = КодМаркировки;

// Для маркировки важно соблюдать размеры
Параметры = Новый ПараметрыШтрихКода;
Параметры.Высота = 15; // мм
Параметры.Ширина = 15; // мм

Возврат ШтрихКод.ПолучитьИзображение;
КонецПроцедуры

⚠️ Внимание: С 1 января 2026 года изменяются требования к формату QR-кодов для маркированных лекарств и обуви. Уточните актуальные технические условия на сайте Честный ЗНАК, так как в новых версиях 1С:Управление торговлей могут появиться дополнительные настройки для этих категорий.

QR в мобильных приложениях 1С

С развитием мобильных решений на базе 1С:Предприятие (например, 1С:Мобильная платформа или 1С:Мобильный склад) появилась возможность работать с QR-кодами со смартфонов. Это особенно востребовано для:

• 📱 Инвентаризации на складе (сканирование кодов товаров)
• 🛒 Приёмки заказов курьерами
• 📄 Подтверждения выполнения работ (QR в актах)
• 🔄 Обмена данными между мобильным и десктопным приложением

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

1. Встроенный сканер платформы (доступен с версии 8.3.20)
2. Сторонние компоненты (например, ZXing через Native API)
3. Интеграцию с камерой устройства через МобильноеПриложениеКлиент

Пример кода для сканирования QR в мобильном приложении:

Процедура СканироватьQRНаМобильномУстройстве
Сканер = Новый СканерШтрихКодов;
Сканер.ТипыШтрихКодов = Новый Массив;
Сканер.ТипыШтрихКодов.Добавить(ТипШтрихКода.QRCode);

Попытка
Результат = Сканер.Считать;
Если Результат.Успех Тогда
Сообщить("Прочитан QR:" + Результат.Значение);
// Обработка данных из QR
Иначе
Сообщить("Ошибка сканирования:" + Результат.ОписаниеОшибки);
КонецЕсли;
Исключение
Сообщить("Ошибка при инициализации сканера:" + ОписаниеОшибки);
КонецПопытки;
КонецПроцедуры

Важные нюансы мобильной работы с QR:

• 🔋 Сканирование сильно разряжает батарею — оптимизируйте частоту опроса камеры
• 📶 Для работы в offline-режиме нужно кэшировать данные из QR на устройстве
• 🔒 На Android требуется разрешение CAMERA в манифесте приложения
• 🍎 На iOS сканирование работает только в портретной ориентации экрана

Оптимизация QR-кодов для разных задач

Универсального QR-кода не существует — для каждой задачи требуется своя настройка. Рассмотрим ключевые параметры, которые нужно учитывать.

1. Выбор уровня коррекции ошибок

QR-коды поддерживают 4 уровня коррекции (от L до H), которые определяют, сколько повреждений код может выдержать и остаться читаемым:

• 🟢 L (7%) — для идеальных условий (электронные документы)
• 🟡 M (15%) — стандарт для печати на бумаге
• 🔴 Q (25%) — для грубых поверхностей (картон, дерево)
• ⚫ H (30%) — для экстремальных условий (металл, уличная реклама)

2. Оптимальный размер для разных носителей

3. Цветовые схемы и контрастность

Стандартный QR-код — чёрный на белом фоне, но иногда требуются другие комбинации. Главное правило: контраст между модулями и фоном должен быть не менее 70%. Допустимые варианты:

• 🔵 Тёмно-синий на светло-сером
• 🟢 Зелёный на белом
• 🟣 Фиолетовый на жёлтом

Недопустимые:

• ❌ Красный на зелёном
• ❌ Серый на белом
• ❌ Жёлтый на светло-оранжевом

4. Формат данных в QR

От формата зависит, сколько информации поместится в код:

• 🔢 Числовой (до 7089 цифр) — для идентификаторов
• 🔤 Алфавитно-цифровой (до 4296 символов) — для смешанных данных
• 📜 Байтовый (до 2953 байт) — для бинарных данных
• 🈁 Кандзи (до 1817 символов) — для иероглифов

FAQ: Частые вопросы о QR-кодах в 1С

Параметры = Новый ПараметрыШтрихКода;
Логотип = Новый Картинка("C:\logo.png");
Логотип.ИзменитьРазмер(30, 30); // Размер в пикселях
Параметры.ДополнительноеИзображение = Логотип;
ШтрихКод.Параметры = Параметры;