К статье
Практический материал

Торговля и Склад · 9 мин

Как загрузить QR-код в 1С

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

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

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

Ниже разобраны оба подхода, настройка оборудования, проверка результата и типовые ошибки, из-за которых код «не читается».

Определите, какая задача стоит: сканирование или распознавание файла

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

Третий вариант — коды маркировки из системы «Честный ЗНАК». Их можно не только сканировать, но и загружать списком через обмен с ГИС МТ, что удобно при больших объёмах приёмки. В типовых конфигурациях («Управление торговлей», «Розница», «ERP») для этого есть встроенные механизмы обмена.

Маршрут решения

Как выбрать действие

Код нужно считывать с товаров на рабочем местеПодключите сканер штрихкодов через подключаемое оборудование
Код пришёл файлом или картинкойИспользуйте распознавание изображения или введите данные из кода вручную
Нужно загрузить много кодов маркировкиИспользуйте обмен с ГИС МТ «Честный ЗНАК» или загрузку из файла обмена
Нужен QR-код на печатной формеИспользуйте типовой механизм генерации QR-кодов в макете печатной формы

Подключите сканер штрихкодов к 1С

Для сканирования QR-кодов подойдёт любой двумерный (2D) сканер: линейные сканеры читают только штрихкоды EAN-13 и подобные. Подключите устройство к компьютеру по USB. Большинство сканеров работают в двух режимах: эмуляция клавиатуры и эмуляция COM-порта. Для полноценной работы с 1С предпочтителен режим COM-порта (или USB COM Emulation), так как он позволяет перехватывать данные независимо от активного окна.

Далее откройте в 1С раздел «Администрирование» → «Подключаемое оборудование» (в некоторых конфигурациях — «Настройка подключаемого оборудования»). Установите драйвер сканера: типовые конфигурации предлагают драйвер «1С: Сканеры штрихкода (NativeAPI)» или драйвер производителя (Атол, Штрих-М). После установки добавьте новое устройство, выберите модель и порт, затем нажмите «Тест устройства».

Порядок подключения сканера
  1. 1
    Подключите сканер к USB и переведите его в режим эмуляции COM-порта (обычно сканированием служебного кода из инструкции)
  2. 2
    Откройте «Администрирование → Подключаемое оборудование» и установите драйвер сканера
  3. 3
    Добавьте устройство, укажите порт и модель, выполните «Тест устройства»
  4. 4
    Откройте документ (например, «Приходная накладная») и отсканируйте QR-код с товара
  5. 5
    Проверьте, что код распознан: товар найден или появилась строка с кодом маркировки

Настройте суффикс и префикс сканера

Частая причина проблем — сканер передаёт код, но 1С его «не видит» или обрабатывает неправильно. Проверьте настройки суффикса: в режиме клавиатурного сканера после кода должен передаваться символ Enter (суффикс CR или CR+LF). Без суффикса 1С не понимает, что ввод завершён.

В режиме COM-порта суффикс менее критичен, но драйверу нужно указать правильный порт и скорость обмена. Узнать номер порта можно в «Диспетчере устройств» Windows, раздел «Порты (COM и LPT)». Если сканер определился как «Неизвестное устройство», установите драйвер виртуального COM-порта с сайта производителя.

Загрузите QR-код из файла или изображения

Если сканера нет, а код есть в виде картинки, вариантов несколько. Самый простой — считать код телефоном любым приложением-сканером и ввести полученный текст вручную в нужное поле документа. Это приемлемо при единичных операциях.

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

Загрузите коды маркировки из «Честного ЗНАКа»

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

Порядок такой: настройте обмен с ГИС МТ (потребуется квалифицированная электронная подпись и регистрация в системе), получите входящий УПД от поставщика через ЭДО, и коды маркировки загрузятся в документ автоматически. Затем сверьте их со сканированием фактических товаров — расхождения отразятся в документе приёмки.

При приёмке маркированного товара удобнее всего комбинировать оба способа: загрузить коды из электронного УПД, а затем сканировать физические товары. Проверочный механизм в 1С сам покажет расхождения между документом и фактом.
ПЗ
Практическое замечание

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

После настройки обязательно проверьте работу на реальном коде. Признак корректной настройки — при сканировании в открытом документе товар находится автоматически, а код маркировки отображается полностью, без обрезанных символов. Если вместо товара появляется сообщение «Штрихкод не найден», проверьте, записан ли штрихкод в карточке номенклатуры.

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

Типичные ошибки
01
Использование линейного 1D-сканера для QR и DataMatrix — такие коды он физически не считывает, нужен 2D-сканер
02
Отсутствие суффикса Enter — 1С не понимает, что ввод кода завершён, и код «зависает» в поле ввода
03
Русская раскладка клавиатуры при клавиатурном режиме — символы кода искажаются, штрихкод не находится в базе
04
Обрезка разделителя GS в коде маркировки — код DataMatrix не проходит проверку в «Честном ЗНАКе»
05
Запуск сторонних обработок распознавания без проверки на копии базы — риск повреждения данных
Контрольные точки

Как проверить результат

Тест устройства в настройках оборудования
Норма

Сообщение «Тест успешно выполнен»

Тревожный признак

Ошибка подключения, устройство не найдено

Сканирование в документ
Норма

Товар находится автоматически, код отображается полностью

Тревожный признак

«Штрихкод не найден» или код обрезан

Сканирование в блокнот
Норма

Код выводится одной строкой с переводом каретки

Тревожный признак

Код разрывается или появляются посторонние символы

Код маркировки в документе ИС МП
Норма

Код проходит проверку и имеет корректный статус

Тревожный признак

Ошибка формата кода или статуса

Как вывести QR-код на печатную форму

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

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

Часто задаваемые вопросы

Можно ли сканировать QR-код в 1С без сканера?

Да. Код можно считать камерой смартфона и ввести текст вручную, использовать внешние обработки распознавания изображений или загрузить коды маркировки напрямую из «Честного ЗНАКа» через обмен ЭДО. Для постоянной работы всё же удобнее сканер.

Почему сканер читает код в блокнот, но не в 1С?

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

Какой сканер нужен для маркировки «Честный ЗНАК»?

Нужен двумерный (2D) сканер, поддерживающий DataMatrix. Дополнительно он должен корректно передавать служебный разделитель GS — эта возможность включается в настройках драйвера 1С или самого сканера.

QR-код сканируется, но товар не находится. Что делать?

Проверьте, записан ли штрихкод в карточке номенклатуры. Если код маркировки — убедитесь, что товар относится к маркируемой группе и в базе включён учёт по маркировке. Также проверьте, не обрезается ли код при передаче.

Безопасно ли использовать обработки для распознавания QR из картинок?

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

Можно ли загрузить сразу много QR-кодов списком?

Да, для кодов маркировки это делается через загрузку из электронного документа (УПД) при обмене с ГИС МТ. Для произвольных штрихкодов в типовых конфигурациях есть загрузка данных из файлов через обработки загрузки табличных данных.

Итог

Что важно запомнить

Для загрузки QR-кода в 1С подключите 2D-сканер через подключаемое оборудование, установите драйвер и проверьте тест устройства. Коды маркировки удобнее загружать из «Честного ЗНАКа» через ЭДО, а изображения распознавать только проверенными обработками на копии базы.