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

Сначала проверьте, читается ли исходный штрихкод на экране. Если на экране читается, а на бумаге нет, ищите проблему в печати, масштабе и материале этикетки.

Коротко: что делать

  • Проверить штрихкод на экране и после печати
  • Проверить формат кода: EAN, Code128, QR и другие
  • Проверить DPI принтера и фактический размер кода
  • Проверить quiet zone вокруг штрихкода
  • Проверить, не масштабирует ли PDF или драйвер печати

Основные причины

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

  • Код слишком маленький для выбранного сканера
  • Принтер печатает с низким DPI или смазывает линии
  • PDF печатается с масштабом Fit to page
  • Нет достаточной свободной зоны вокруг кода
  • Генератор создает код не того формата или с неверной контрольной суммой

Пошаговая диагностика

Диагностику лучше вести от конкретного примера: один пользователь, один запрос, один документ, одно событие или один экран. Так проще увидеть точку, где система начинает вести себя неправильно.

  • Сравнить размер кода в макете и на напечатанной этикетке
  • Распечатать тест без масштабирования 100%
  • Проверить код разными сканерами или приложением телефона
  • Проверить контраст и качество бумаги
  • Проверить значение, которое закодировано внутри

Как исправить проблему

Исправление должно закрывать корневую причину, а не только внешний симптом. Если проблема связана с доступами, платежами, данными или безопасностью, сначала стоит сделать резервную копию и проверить правку на тестовом сценарии.

  • Увеличить размер штрихкода и quiet zone
  • Настроить печать 100% без автоподгонки
  • Использовать подходящий формат кода и корректную контрольную сумму
  • Повысить качество печати или заменить материал этикетки
  • Сгенерировать макет под реальный DPI принтера

Безопасный план решения

Сначала сделайте несколько тестовых этикеток с разным размером и без масштабирования. После проверки сканером закрепляйте параметры в генераторе.

Чего не стоит делать

  • Не растягивать растровый штрихкод в Word или PDF без контроля качества
  • Не размещать текст и рамки слишком близко к коду
  • Не печатать через Fit to page
  • Не менять формат кода без проверки требований склада или маркетплейса

Что подготовить перед исправлением

  • Пример PDF или макета этикетки
  • Модель принтера и DPI
  • Тип сканера
  • Формат штрихкода и ожидаемое значение

FAQ

Почему телефон читает, а складской сканер нет?

У сканеров разные требования к размеру, контрасту и формату. Нужно тестировать тем устройством, которое будет использоваться.

Что такое quiet zone?

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

Лучше SVG или PNG?

Для печати лучше вектор или генерация под нужный DPI, чтобы линии не размывались.

Когда стоит обратиться за помощью

Помощь нужна, если этикетки печатаются массово, идут на склад, доставку, кассу или маркетплейс.

Итог

Начните с проверки размера, DPI и печати 100%. Если нужно исправить генератор этикеток или макет штрихкода, можно написать в Telegram @rabotator_support.