Генерация QR-кодов в 1С 8.3: способы и примеры кода

QR-код в 1С 8.3 рисует встроенная компонента печати штрихкодов — она идёт в комплекте платформы и поддерживает двумерные коды. Проще всего обратиться к ней через модуль генерации штрихкодов из библиотеки стандартных подсистем (БСП): отдаёте ему строку, получаете объект Картинка, кладёте её в макет. Отдельная библиотека или сторонний сервис для этого не нужны.

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

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

Что умеет штатная компонента печати штрихкодов

Платформа 1С:Предприятие 8.3 поставляется с внешней компонентой печати штрихкодов. Она ставится вместе с платформой (в составе макетов библиотеки) и умеет рисовать как линейные коды (EAN-13, Code 128), так и двумерные — QR, DataMatrix, PDF417.

Компонента работает на сервере, поэтому картинку можно сформировать в серверном контексте и передать на клиент — это важно для веб-клиента и тонкого клиента . На серверах под Linux используется native-вариант компоненты, отдельной установки ActiveX не требуется.

Что компонента позволяет задать для QR:

• 🔤 содержимое — любая строка: ссылка, текст, реквизиты платежа;
• 📐 размер картинки в пикселях (ширина и высота);
• 🎯 уровень коррекции ошибок — чем выше, тем устойчивее код к повреждениям, но тем он плотнее;
• 🖼 прозрачный или белый фон, угол поворота, при необходимости — логотип в центре.

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

Где QR-код уже печатается без доработок

Прежде чем писать код, проверьте — возможно, нужный QR в типовой уже есть.

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

Акты, накладные, УПД. Здесь QR штатно не предусмотрен — это линейные формы. Если нужно добавить на них QR (например, ссылку на документ в учётной системе), это уже доработка макета, см. раздел про печатную форму.

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

Если готовой печати достаточно — дорабатывать ничего не нужно. Код ниже пригодится, когда QR требуется в своей форме или по своим правилам.

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

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

// Серверный контекст
Параметры = ГенерацияШтрихкода.ПараметрыФормированияШтрихкода();
Параметры.Штрихкод = "https://example.com/doc?id=1024";
Параметры.ТипКода  = 16;          // QR-код
Параметры.Ширина   = 150;
Параметры.Высота   = 150;
Параметры.УбратьЛишнийФон = Истина;

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

Если Результат.РезультатФормирования Тогда
    КартинкаQR = Результат.Картинка;  // тип Картинка — кладём в макет
Иначе
    Сообщить("Не удалось сформировать QR-код");
КонецЕсли;

Несколько пояснений по полям:

• ТипКода задаёт формат двумерного кода. В текущей компоненте значение для QR — 16; проверьте в справке к компоненте, если код не рисуется;
• УбратьЛишнийФон = Истина делает фон прозрачным — удобно, когда QR ложится на цветную подложку макета;
• для длинного содержимого поднимайте размер картинки, иначе модули QR станут слишком мелкими для сканера.

Генерацию картинки выполняйте на сервере, а не на клиенте — так код одинаково работает в тонком и веб-клиенте, а компонента гарантированно доступна.

Что положить внутрь QR

Содержимое — обычная строка. Частые варианты:

• 🔗 ссылка на документ или карточку товара на сайте;
• 💳 строка платёжных реквизитов по ГОСТ (см. раздел про оплату);
• 📄 произвольный текст — артикул, серийный номер, контакт.

Для кириллицы следите за кодировкой: приёмное приложение должно уметь её прочитать. Ссылки и латиница проблем не вызывают.

Сохранить QR в файл, а не в макет

Картинка нужна не только для печати. Полученный объект Картинка можно записать на диск или отдать как двоичные данные — например, чтобы вернуть QR во внешний сервис, вложить в письмо или показать на форме.

// КартинкаQR получена выше
ДвоичныеДанные = КартинкаQR.ПолучитьДвоичныеДанные();
ДвоичныеДанные.Записать("C:\Temp\qr.png");

На форме картинку показывают через реквизит с типом Картинка, связанный с элементом «Поле картинки». Для веб-клиента файл на диск сервера писать нельзя — используйте помещение во временное хранилище и механизм получения файлов на клиенте.

Как добавить QR-код в печатную форму (макет)

Картинка сама по себе бесполезна — её нужно вывести в табличный документ. Порядок такой:

1. Откройте макет печатной формы в конфигураторе (или в расширении, если правка типовой запрещена).
2. Добавьте в макет область с рисунком: вставьте объект типа Рисунок, задайте ему имя, например QRКод.
3. В модуле печати, после формирования картинки, присвойте рисунку изображение и выведите область в табличный документ.

Макет = ПолучитьОбщийМакет("МойМакетСчета");
Область = Макет.ПолучитьОбласть("Шапка");

// КартинкаQR получена в примере выше
Область.Рисунки.QRКод.Картинка = КартинкаQR;

ТабличныйДокумент.Вывести(Область);

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

Внешние обработки и расширения вместо правки типовой

Менять типовую конфигурацию снятием с поддержки — плохая идея: усложнятся обновления. Есть два аккуратных пути.

Внешняя обработка. Весь код генерации и вывода QR складывается во внешнюю обработку (.epf). Она подключается к документу как дополнительная печатная форма через механизм дополнительных отчётов и обработок. Типовая остаётся нетронутой, обработка живёт отдельным файлом и переносится между базами.

Расширение конфигурации . Если QR нужно встроить в существующую печать типового документа, используйте расширение. В нём можно:

• добавить рисунок в заимствованный макет;
• перехватить процедуру печати и дорисовать QR;
• добавить новую команду печати рядом со штатной.

Расширение подключается без снятия конфигурации с поддержки и переживает обновления (при условии, что изменённые объекты не конфликтуют с новой версией типовой).

QR для оплаты по ГОСТ и коды «Честного ЗНАКа» — не путать

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

QR для оплаты. Платёжный QR делается по ГОСТ Р 56042-2014. Внутри — текстовая строка с реквизитами, которая начинается со служебного заголовка ST00012 и содержит пары «поле=значение»: наименование получателя, расчётный счёт, БИК, корреспондентский счёт, сумма, назначение платежа.

ST00012|Name=ООО Ромашка|PersonalAcc=40702810...|BankName=Банк|BIC=044525...|CorrespAcc=30101810...|Sum=150000|Purpose=Оплата по счёту 42

Сумма (Sum) указывается в копейках. Эту строку вы и передаёте в генератор QR как содержимое. Банковское приложение распознаёт формат и подставляет реквизиты.

Коды «Честного ЗНАКа». Маркировка использует не QR, а DataMatrix — другой двумерный код. Его наносят на товар, а покупатель сканирует приложением «Честный ЗНАК». Код маркировки приходит из системы ГИС МТ (оператор — ЦРПТ) и содержит GTIN, серийный номер и криптографическую часть.

Та же компонента печати штрихкодов рисует и DataMatrix — меняется только тип кода в параметрах. Но путать форматы нельзя:

Массовая печать: как не уронить производительность

Один QR рисуется мгновенно. Проблемы начинаются на тиражах в тысячи этикеток — формирование картинок нагружает сервер.

Что помогает:

1. 🖥 Генерируйте на сервере пакетом. Соберите список строк для кодирования и обработайте их в одном серверном вызове, а не дёргайте сервер из клиента на каждую этикетку.
2. 🔁 Не подключайте компоненту в цикле. Подключение внешней компоненты — дорогая операция. В БСП модуль это учитывает; при прямой работе с компонентой подключайте её один раз до цикла.
3. 🗂 Кэшируйте одинаковые коды. Если в партии повторяются одни и те же значения (например, один артикул на сто этикеток), генерируйте картинку один раз и переиспользуйте.
4. ⏳ Большие тиражи — в фоновое задание. Печать десятков тысяч кодов выносите в фоновое задание, чтобы не блокировать сеанс пользователя.
5. 📏 Не завышайте размер картинки. Избыточное разрешение раздувает табличный документ и память. Для этикетки обычно хватает 100–200 пикселей на сторону.

Частые вопросы