Как настроить автоматическую генерацию QR-кодов на товары в 1С-Битрикс?
При запуске розничной точки с витриной QR-кодов или при маркировке упаковок для склада встаёт задача: сгенерировать уникальный код для каждой единицы товара. Ручное создание тысяч изображений — не вариант. Мы настраиваем автоматическую генерацию QR-кодов в Битрикс под ключ: от выбора библиотеки до интеграции со складскими процессами. Свяжитесь с нами для оценки вашего проекта.
Основные сложности, которые мы решаем: высокая нагрузка при массовой генерации (1000+ товаров), необходимость поддержки разных форматов (PNG, SVG) и обеспечение читаемости кода на упаковке. Наш опыт показывает, что правильно настроенная генерация экономит до 80% времени менеджера. Без автоматизации менеджеры тратят часы на создание QR через сторонние сервисы, а при обновлении цен или описаний коды приходится перегенерировать вручную. Мы разрабатываем решение, которое интегрируется с вашим каталогом и генерирует коды на лету или по расписанию. В итоге вы получаете готовые к печати PNG с логотипом компании и короткими ссылками для отслеживания конверсий. Автоматизация генерации QR-кодов окупается в среднем за 2–3 месяца работы склада, а в денежном выражении экономия может составлять до $360–520 в месяц на зарплате менеджера.
Какую библиотеку выбрать для генерации QR?
В 1С-Битрикс нет встроенного генератора QR-кодов. Подключается сторонняя библиотека через Composer. Два популярных варианта:
endroid/qr-code предоставляет богатый функционал: поддержка PNG с логотипом, множество уровней коррекции ошибок, работа с разными кодировками. chillerlan/php-qrcode легче и быстрее, не требует расширения GD.
| Характеристика | endroid/qr-code | chillerlan/php-qrcode |
|---|---|---|
| Размер пакета | ~500 KB | ~100 KB |
| PNG с логотипом | Да | Нет |
| Поддержка SVG | Да | Нет |
| Скорость генерации | Средняя | Высокая |
| Зависимости | ext-gd | Нет |
Для большинства проектов мы выбираем endroid/qr-code из-за гибкости и возможности брендирования.
Что кодировать в QR-код?
Возможные варианты содержимого QR:
- URL карточки товара — универсальный вариант для перехода на сайт
- UTM-ссылка — с метками источника для аналитики офлайн/онлайн конверсии
- Артикул — для внутреннего использования на складе, сканируется терминалом
- Ссылка на инструкцию или сертификат — для документной части
Важно: URL должен быть коротким, иначе QR становится плотным и хуже читается дешёвыми сканерами. Для длинных URL используйте собственный редиректор: https://shop.ru/go/A123/ → redirect → актуальный URL.
Как реализована генерация в Битрикс?
Установка библиотек:
composer require endroid/qr-code # или composer require chillerlan/php-qrcode Базовый класс-генератор с кэшированием:
namespace Custom\Catalog; use Endroid\QrCode\Builder\Builder; use Endroid\QrCode\Encoding\Encoding; use Endroid\QrCode\ErrorCorrectionLevel; use Endroid\QrCode\Writer\PngWriter; class ProductQrGenerator { private string $uploadDir; public function __construct() { $this->uploadDir = $_SERVER['DOCUMENT_ROOT'] . '/upload/qr/'; if (!is_dir($this->uploadDir)) mkdir($this->uploadDir, 0755, true); } public function generateForProduct(int $productId, string $url): string { $fileName = 'product-' . $productId . '.png'; $filePath = $this->uploadDir . $fileName; if (file_exists($filePath)) return '/upload/qr/' . $fileName; $result = Builder::create() ->writer(new PngWriter()) ->data($url) ->encoding(new Encoding('UTF-8')) ->errorCorrectionLevel(ErrorCorrectionLevel::High) ->size(400)->margin(10) ->build(); $result->saveToFile($filePath); return '/upload/qr/' . $fileName; } public function generateBatch(array $productIds): void { foreach ($productIds as $id) { $element = \CIBlockElement::GetByID($id)->GetNextElement(); if (!$element) continue; $fields = $element->GetFields(); $url = 'https://' . SITE_SERVER_NAME . $fields['DETAIL_PAGE_URL']; $this->generateForProduct($id, $url); } } } Автоматическая генерация при добавлении товара через обработчик события OnAfterIBlockElementAdd, как указано в документации 1С-Битрикс:
AddEventHandler('iblock', 'OnAfterIBlockElementAdd', function(&$fields) { if ($fields['IBLOCK_ID'] != CATALOG_IBLOCK_ID) return; $generator = new \Custom\Catalog\ProductQrGenerator(); $url = 'https://' . SITE_SERVER_NAME . '/catalog/item/' . $fields['CODE'] . '/'; $generator->generateForProduct($fields['ID'], $url); }); Вывод QR-кода в шаблоне карточки товара:
<?php if (!empty($arResult['PROPERTIES']['QR_CODE_URL']['VALUE'])): ?> <div class="product-qr"> <img src="<?= $arResult['PROPERTIES']['QR_CODE_URL']['VALUE'] ?>" alt="QR-код товара" width="120" height="120"> <a href="<?= $arResult['PROPERTIES']['QR_CODE_URL']['VALUE'] ?>" download="qr-<?= $arResult['ID'] ?>.png">Скачать QR</a> </div> <?php endif; ?> Почему важно кэшировать QR-коды?
Генерация каждого QR-кода — затратная операция. При массовой выгрузке этикеток (1000+ товаров) без кэширования сервер может не справиться. В нашем классе проверяется наличие файла перед повторной генерацией. Это снижает нагрузку на 90% при повторном запуске.
Как мы ускоряем массовую генерацию
Для пакетной обработки 1000+ товаров за один запуск используем выполнение через агенты: разбиваем массив ID на порции по 50 и ставим агент с интервалом 10 секунд. Это позволяет избежать таймаутов и превышения памяти. В итоге весь каталог обрабатывается за несколько минут.Что входит в работу
- Анализ текущего каталога и сценариев использования QR
- Выбор и подключение библиотеки через Composer
- Реализация генератора с кэшированием и пакетной обработкой
- Настройка автоматической генерации при добавлении/обновлении товаров
- Интеграция с выгрузкой этикеток (форматы PNG, SVG)
- Создание коротких редиректов (опционально)
- Документация и обучение персонала На выполненные работы предоставляется гарантия 12 месяцев.
Сроки выполнения
| Объём работ | Срок |
|---|---|
| Базовая генерация QR + сохранение + вывод | от 1 дня |
| Пакетная генерация + автоматика по событию | +1 день |
| QR с логотипом + редиректор | +2 дня |
| Полная интеграция со складом и 1С | от 3 дней |
Типичные ошибки при генерации QR-кодов и их предотвращение
Часто встречаются две проблемы: нечитаемость кода из-за переполнения данных и дублирование файлов при повторной генерации. Чтобы избежать первого, используйте уровни коррекции ошибок не ниже M, а для плотных данных — H. Второе решается кэшированием по ID товара, как показано в коде выше.
Настроенная один раз генерация работает без участия менеджера — это автоматизация, которую замечают только результаты. Закажите настройку QR-генерации и упростите работу склада. Получите консультацию и детальный расчёт сметы под ваш проект. Наша команда имеет опыт более 50 проектов с интеграцией внешних сервисов.







