Автоматизация · 12 мин
Как подключить QR-код в 1С: полное руководство
Практическая инструкция по подключению QR-кодов в 1С: печать на чеках и счетах, оплата по СБП, сканирование маркировки. Настройка, типовые ошибки и проверка результата.
QR-коды в 1С используются в нескольких сценариях: печать платёжных кодов на счетах и квитанциях, приём оплаты через Систему быстрых платежей (СБП), сканирование кодов маркировки «Честный ЗНАК» и Data Matrix на товарах, а также вывод произвольных QR-кодов на печатные формы. Способ подключения зависит от задачи: где-то достаточно типовой настройки конфигурации, а где-то потребуется доработка макета или внешняя компонента.
Большинство типовых конфигураций (1С:Бухгалтерия, Управление торговлей, Комплексная автоматизация, Розница) уже содержат встроенные механизмы работы с QR-кодами. Задача пользователя — правильно их включить, заполнить необходимые реквизиты и проверить результат на тестовом документе. Ниже разобраны все основные сценарии с конкретными шагами.
Перед началом работы убедитесь, что конфигурация обновлена до актуального релиза: механизмы СБП и маркировки активно дорабатываются, и в старых версиях часть функций может отсутствовать или работать некорректно.
Определите, какой сценарий QR-кода вам нужен
Под фразой «подключить QR-код в 1С» обычно скрывается одна из четырёх задач. Первая — приём оплаты от покупателей по QR-коду через СБП: код выводится на экран кассы, печатается на чеке или счёте. Вторая — печать платёжного QR-кода (по стандарту ГОСТ Р 56042-2014) на квитанциях и счетах, чтобы клиент мог оплатить через приложение банка. Третья — сканирование QR и Data Matrix кодов маркировки товаров. Четвёртая — вывод произвольного QR-кода (ссылка, текст, идентификатор) на печатную форму.
От сценария зависит и инструмент: оплата по СБП требует договора с банком или платёжным агрегатором, маркировка — регистрации в «Честном ЗНАКе» и 2D-сканера, а печать произвольного кода — только корректного макета. Определите задачу до начала настройки, чтобы не настраивать лишние подсистемы.
Как выбрать действие
Подключение оплаты по QR-коду через СБП
Для приёма оплаты через Систему быстрых платежей нужен договор с банком-участником СБП или с платёжным агрегатором. Банк выдаёт реквизиты подключения: идентификатор торговой точки (мерчанта), параметры доступа к API. Без договора настроить оплату не получится — 1С лишь передаёт данные в платёжную систему.
В типовых конфигурациях перейдите в раздел настроек: в 1С:Бухгалтерии это «Администрирование» → «Обмен электронными документами» → «Система быстрых платежей», в Управлении торговлей и Рознице — «Настройки» → «Продажи» → «Оплата по СБП» (названия пунктов могут отличаться в зависимости от релиза). Включите функциональность и создайте настройку подключения, указав полученные от банка идентификаторы.
После сохранения настройки выполните тестовую операцию: сформируйте счёт или пробейте чек на небольшую сумму, выведите QR-код и оплатите его из приложения своего банка. Успешная оплата должна автоматически отразиться в документе — статус изменится на «Оплачен». Если статус не обновляется, проверьте, запущен ли регламентный обмен с платёжной системой.
- 1Заключите договор с банком-участником СБП или агрегатором и получите идентификатор торговой точки
- 2Обновите конфигурацию до актуального релиза
- 3Включите функциональность СБП в настройках программы
- 4Создайте настройку подключения и введите реквизиты от банка
- 5Сформируйте тестовый документ и выведите QR-код
- 6Оплатите код из банковского приложения и проверьте автоматическое зачисление оплаты в 1С
Печать платёжного QR-кода на счетах и квитанциях
Платёжный QR-код по ГОСТ содержит реквизиты получателя: наименование, ИНН, расчётный счёт, БИК банка, назначение платежа и сумму. Клиент сканирует его камерой телефона или приложением банка, и платёжное поручение заполняется автоматически. Такой код удобен для счетов на оплату, квитанций за ЖКХ, счетов-фактур.
В ряде типовых решений печать платёжного QR-кода уже встроена в макет счёта — достаточно проверить, что в карточке организации заполнены ИНН, расчётный счёт и банковские реквизиты. Если код на печатной форме отсутствует, его добавляют в макет: в конфигураторе в макет печатной формы вставляют картинку, а в модуле формирования печати генерируют QR из строки платёжных реквизитов.
Важно формировать содержимое кода строго по стандарту: поля разделяются символом «|», порядок полей фиксирован. Ошибка в структуре строки приведёт к тому, что банковское приложение не распознает код или подставит неверные реквизиты. После доработки макета обязательно протестируйте код в приложениях нескольких разных банков.
Сканирование QR и Data Matrix кодов маркировки
Для работы с маркированными товарами (обувь, одежда, молочная продукция, вода и другие группы) 1С должна считывать коды Data Matrix с помощью 2D-сканера. Обычный линейный сканер штрихкодов не подойдёт — нужен двумерный имидж-сканер, поддерживающий передачу служебных символов GS.
Подключение сканера выполняется через «Администрирование» → «Подключаемое оборудование». Установите драйвер (штатный «1С:Сканеры штрихкода» или драйвер производителя), добавьте устройство и проверьте считывание. Сканер должен работать в режиме эмуляции клавиатуры с суффиксом Enter или через COM-порт — в зависимости от модели и драйвера.
Критичный момент — корректная передача символа GS (разделителя групп в коде Data Matrix). Если сканер «съедает» этот символ, 1С не сможет разобрать код маркировки и выдаст ошибку. В настройках сканера включите передачу GS как управляющего символа (обычно ASCII 29) — это делается через конфигурационные штрихкоды из инструкции к сканеру.
Как проверить результат
Код разбирается, товар и код маркировки определяются корректно
Ошибка разбора кода или лишние символы в строке — проблема с передачей GS
Оплата прошла, статус документа изменился автоматически
Оплата прошла в банке, но в 1С не отразилась — проверяйте регламентные задания обмена
Код читается приложениями разных банков, реквизиты подставляются верно
Код не читается или реквизиты неверные — ошибка в строке формирования
Вывод произвольного QR-кода на печатную форму
Если нужно вывести на печать произвольный QR-код — ссылку на оплату, идентификатор заказа, текст — используется программная генерация. В платформе 1С:Предприятие для этого применяется подсистема генерации штрихкодов из библиотеки стандартных подсистем (БСП): функция формирует картинку QR-кода из переданной строки, и её можно вставить в табличный документ.
Порядок доработки: в конфигураторе откройте макет печатной формы, добавьте область с параметром-картинкой для QR-кода, в модуле менеджера печати сформируйте строку данных, получите картинку через функцию генерации двумерного кода и выведите её в область. Тип кода укажите «QR», размер подберите экспериментально — слишком мелкий код плохо читается с бумаги.
Если конфигурация не содержит БСП или доработка в конфигураторе недоступна, альтернатива — внешняя печатная форма: её можно разработать и подключить без изменения основной конфигурации, что безопаснее для обновлений. Для совсем простых случаев подойдёт генерация картинки QR внешними средствами и вставка её в шаблон, но это неудобно при массовой печати.
Типовые ошибки и их устранение
Самая частая проблема со сканированием маркировки — нечитаемый код из-за потери символа GS. Лечится настройкой сканера через сервисные штрихкоды производителя: включите распознавание GS как ASCII 29 и отключите замену символов. Вторая распространённая ошибка — попытка использовать 1D-сканер для Data Matrix: такое оборудование физически не считывает двумерные коды.
При оплате по СБП типичны две ситуации: деньги пришли в банк, но документ в 1С остался неоплаченным (проверьте регламентное задание обмена и логи подключения), и QR-код не формируется вовсе (чаще всего не заполнен идентификатор торговой точки или не выбрана настройка СБП в виде операции). При печати платёжных QR ошибки обычно связаны с нарушением формата строки — лишние пробелы, неверный порядок полей, отсутствие обязательных реквизитов.
Ещё одна группа проблем — устаревшие релизы: механизмы СБП и маркировки меняются по требованиям регуляторов, и старая версия конфигурации может перестать корректно обмениваться данными. Перед поиском ошибки в настройках убедитесь, что конфигурация и платформа обновлены.
Проверка результата и безопасная работа
Каждый сценарий завершайте контрольной проверкой. Для СБП — реальная оплата тестового документа с последующим возвратом; для платёжного QR — сканирование кода приложениями минимум двух разных банков и сверка подставленных реквизитов; для маркировки — сканирование нескольких кодов разных товарных групп с проверкой разбора в 1С.
Все доработки выполняйте сначала на копии базы. Перед изменением макетов или подключением внешних компонент сделайте резервную копию. Если настройка требует правки кода, обращения к API банка или интеграции с «Честным ЗНАКом» сверх типовых механизмов — это зона ответственности специалиста по 1С: ошибка в финансовых интеграциях может привести к потере платежей или расхождению учёта.
Что важно запомнить
Сценарий определяет инструмент: СБП настраивается через договор с банком и штатные настройки, платёжный QR — через макет печатной формы, маркировка — через 2D-сканер с корректной передачей символа GS. Все изменения тестируйте на копии базы, доработки делайте через расширения и внешние печатные формы, а результат проверяйте реальной операцией.
Часто задаваемые вопросы
Можно ли подключить оплату по QR-коду без договора с банком?
Нет. Формирование платёжного QR для приёма средств через СБП возможно только при наличии договора с банком-участником системы или платёжным агрегатором — именно они выдают идентификатор торговой точки, без которого 1С не сможет зарегистрировать платёж. Альтернатива без договора — печать обычного платёжного QR-кода по ГОСТ с реквизитами счёта: клиент оплатит его как обычный банковский перевод.
Почему сканер считывает Data Matrix, но 1С выдаёт ошибку разбора кода?
Почти всегда причина в том, что сканер не передаёт служебный символ GS (ASCII 29), который разделяет поля внутри кода маркировки. Включите его передачу в настройках сканера через конфигурационные штрихкоды из руководства производителя. Также проверьте, что сканер работает в той раскладке и кодировке, которую ожидает драйвер.
Нужно ли дорабатывать конфигурацию для печати QR на счёте?
Зависит от конфигурации и релиза: в ряде типовых решений платёжный QR уже встроен в печатную форму счёта, и достаточно заполнить банковские реквизиты организации. Если кода нет — потребуется добавить его в макет. Чтобы не снимать конфигурацию с поддержки, делайте это через внешнюю печатную форму или расширение.
Подойдёт ли обычный сканер штрихкодов для маркировки?
Нет. Линейные (1D) сканеры считывают только одномерные штрихкоды типа EAN-13. Коды маркировки «Честный ЗНАК» — это двумерные Data Matrix, для них нужен 2D-имидж-сканер. При покупке проверяйте поддержку Data Matrix и корректную передачу символов GS.
Оплата по СБП прошла в банке, но в 1С документ не отмечен как оплаченный. Что делать?
Проверьте, что в настройках подключения к СБП включён автоматический обмен и работает соответствующее регламентное задание. Выполните ручное обновление статуса из формы документа или настройки СБП. Если статусы не приходят систематически — смотрите журнал регистрации на предмет ошибок обмена и проверяйте актуальность релиза конфигурации.
Можно ли сформировать QR-код в 1С без программирования?
Частично да: типовые механизмы (СБП, маркировка, встроенный платёжный QR в счёте) работают через настройки без написания кода. Но вывод произвольного QR-кода на нестандартную печатную форму требует доработки макета или внешней печатной формы, то есть участия разработчика.