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

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

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

Когда штатный механизм уже работает

В типовых конфигурациях «1С:Бухгалтерия», «1С:Управление торговлей» и других решениях на БСП (библиотека стандартных подсистем) печать QR-кода для оплаты по реквизитам организации встроена. При печати счёта на оплату внизу документа выводится QR-код по стандарту ГОСТ Р 56042-2014, который банковские приложения распознают как платёжное поручение.

Чтобы QR-код появился на счёте, проверьте настройки организации: должны быть заполнены ИНН, КПП, расчётный счёт, БИК банка и корреспондентский счёт. Если хотя бы одно поле пустое, код либо не сформируется, либо банковское приложение не сможет его прочитать как платёж.

Если QR-код на печатной форме отсутствует, откройте печатную форму счёта и проверьте, не используется ли внешняя печатная форма без поддержки QR. Внешние формы, созданные до появления механизма, часто не содержат области для кода.

Способ 1. Внешняя компонента генерации QR-кодов

Для вывода произвольных данных (ссылок, артикулов, серийных номеров) применяется внешняя компонента, реализующая интерфейс Native API. Известный вариант — компонента из поставки «1С:Библиотека подключаемого оборудования» или сторонние компоненты, распространяемые для платформы 1С.

Порядок подключения: компоненту упаковывают в ZIP-архив по правилам поставки внешних компонент, загружают в информационную базу через механизм «Подключаемые компоненты» (в БСП) или подключают программно методом ПодключитьВнешнююКомпоненту(). После подключения вызов метода генерации возвращает картинку в формате PNG.

Пример вызова в коде: создаётся объект компоненты, в него передаётся строка данных, уровень коррекции ошибок и размер изображения, а результат — двоичные данные картинки — помещается во временное хранилище и присваивается элементу макета типа «Картинка».

ПодключитьВнешнююКомпоненту("ОбщийМакет.QRCodeComponent", "QR", ТипВнешнейКомпоненты.Native);
Генератор = Новый("AddIn.QR.QRCodeExtension");
ДанныеКартинки = Генератор.GenerateQRCode(СтрокаДанных, 1, 200);

Способ 2. Генерация через веб-сервис или API

Если установка компоненты невозможна (например, сервер под Linux без подготовленной сборки компоненты), картинку можно получить из внешнего HTTP-сервиса генерации QR-кодов. Из 1С выполняется HTTP-запрос, возвращающий PNG-изображение, которое затем вставляется в макет.

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

Вставка QR-кода в макет печатной формы

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

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

Для этикеток и ценников в конфигурациях с подсистемой печати этикеток (например, в рознице и торговле) QR-код добавляется через редактор шаблона этикетки: в шаблон перетаскивается поле типа «Штрихкод», и в его параметрах выбирается тип QRCode. Это самый простой путь без программирования.

1. 1
   Откройте шаблон этикетки в редакторе шаблонов
2. 2
   Добавьте поле типа Штрихкод и укажите тип QRCode
3. 3
   Привяжите к полю данные: артикул, код номенклатуры или произвольную строку
4. 4
   Сохраните шаблон и выполните тестовую печать
5. 5
   Сканируйте результат камерой телефона и сверьте содержимое

Печать QR-кода на чеке и маркировка

На кассовых чеках QR-коды печатает сам фискальный регистратор по команде драйвера — 1С лишь передаёт данные. Это используется для маркированных товаров (код Data Matrix передаётся в составе позиции) и для произвольных QR-кодов в нефискальной части чека, например ссылки на акцию.

Для вывода произвольного QR-кода на чек в типовых конфигурациях используется механизм шаблонов чеков ККТ: в шаблон добавляется поле «Штрихкод» с типом QR, и драйвер ККТ отправляет команду печати на устройство. Учтите, что не все модели касс и версии драйверов поддерживают печать QR в нефискальной части — проверяйте документацию на вашу модель ККТ.

Коды маркировки (Data Matrix) обрабатываются отдельно: они передаются в кассу как реквизит позиции, и их корректность контролируется системой «Честный ЗНАК». Самостоятельно формировать такие коды нельзя — они запрашиваются из системы маркировки.

Проверка результата и типичные ошибки

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

Отдельная частая проблема — кодировка. Если в QR-коде кириллица, а сканер показывает «кракозябры», причина в несоответствии кодировки при генерации. Убедитесь, что строка данных формируется в UTF-8 и компонента это поддерживает.

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