Интеграция 1С-Битрикс с принтерами этикеток Brother

Интеграция 1С-Битрикс с принтерами этикеток Brother

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

Brother — альтернатива Zebra для офисных и лёгких складских задач. Линейки QL (термопечать на лентах DK) и PT (ленточные принтеры) используются там, где нужны небольшие партии этикеток: маркировка комплектации, адресные наклейки на отправления, этикетки полок. Принципиальное отличие от Zebra: Brother работает преимущественно через печать из системного принтера (GDI/CUPS), а не через RAW TCP/IP с ZPL. Brother на 30–50% быстрее в настройке для малого бизнеса — не нужно изучать ZPL, достаточно базовых знаний PHP.

Почему Brother, а не Zebra для старта?

Brother существенно выгоднее при объёмах до 500 этикеток в день: стоимость принтера в 2–3 раза ниже, а настройка интеграции занимает на 3–5 дней меньше. Для интернет-магазина с 50–200 заказами в день это оптимальное решение. Если объёмы вырастут — мы масштабируем систему до Zebra без потери данных.

Способы взаимодействия с принтером Brother

Вариант 1: Через системный принтер (рекомендуется для офиса)

Brother устанавливается как системный принтер в Windows или macOS. Битрикс генерирует PDF или PNG нужного размера и отправляет на печать через системную команду:

function printLabelViaCups(string $pdfPath, string $printerName): bool {
    $cmd = escapeshellcmd("lp -d " . escapeshellarg($printerName) . " " . escapeshellarg($pdfPath));
    exec($cmd . ' 2>&1', $output, $returnCode);
    return $returnCode === 0;
}

Для Windows — аналогично через SumatraPDF -print-to или mspaint /pt. Вариант 2: Brother SDK / b-PAC (Windows only)

Brother предоставляет COM-объект b-PAC для работы с шаблонами .lbx в P-touch Editor. Интеграция через PHP COM-интерфейс:

$doc = new COM('bpac.Document');
$doc->Open('C:\\Labels\\price_label.lbx');
$doc->GetObject('barcode')->Text = $barcode;
$doc->GetObject('price')->Text = number_format($price, 2, ',', ' ') . ' руб.';
$doc->GetObject('name')->Text = $productName;
$doc->StartPrint('', 0);
$doc->PrintOut(1, 0);
$doc->EndPrint();
$doc->Close();

Этот подход работает только если PHP выполняется на Windows-сервере с установленным Brother P-touch Editor. Для production-серверов под Linux не применим.

Вариант 3: Brother Web API (QL-820NWB и новые модели)

Ряд сетевых моделей Brother имеют веб-API. Документация специфична для каждой модели, но общий принцип: HTTP POST с base64-закодированным изображением или PDF. Этот способ быстрее системной печати, но требует дополнительной разработки на стороне Битрикс.

Как организовать очередь печати для Brother?

В отличие от Zebra (где TCP-отправка быстрая), печать через системный принтер занимает время. Используем ту же архитектуру очереди bl_brother_print_queue:

CREATE TABLE bl_brother_print_queue (
    id SERIAL PRIMARY KEY,
    printer_name VARCHAR(128) NOT NULL, -- имя в CUPS
    template VARCHAR(64) NOT NULL,
    product_id INT,
    data_json JSONB,
    copies SMALLINT DEFAULT 1,
    status VARCHAR(20) DEFAULT 'pending',
    created_at TIMESTAMP DEFAULT NOW(),
    processed_at TIMESTAMP
);

Агент Битрикс берёт задания из очереди, рендерит PNG через BrotherLabelRenderer, отправляет на CUPS. Для больших объёмов можно масштабировать — ставить несколько принтеров и крутить по несколько агентов параллельно.

Генерация этикетки на стороне Битрикс

Для Linux-серверов (вариант 1) генерируем изображение этикетки через GD или Imagick:

class BrotherLabelRenderer {
    public function renderPriceLabel(array $product, int $widthMm = 62, int $heightMm = 29): string {
        $dpi = 300;
        $wPx = (int)($widthMm / 25.4 * $dpi);
        $hPx = (int)($heightMm / 25.4 * $dpi);
        $image = imagecreatetruecolor($wPx, $hPx);
        $white = imagecolorallocate($image, 255, 255, 255);
        $black = imagecolorallocate($image, 0, 0, 0);
        imagefill($image, 0, 0, $white);
        // Название товара (используем TTF-шрифт)
        $fontPath = $_SERVER['DOCUMENT_ROOT'] . '/local/fonts/DejaVuSans.ttf';
        imagettftext($image, 14, 0, 20, 60, $black, $fontPath, mb_substr($product['NAME'], 0, 35));
        // Цена крупно
        $price = number_format($product['PRICE'], 2, ',', ' ') . ' руб.';
        imagettftext($image, 28, 0, 20, 120, $black, $fontPath, $price);
        // Штрихкод через библиотеку (picqer/php-barcode-generator)
        $barcodeGenerator = new \Picqer\Barcode\BarcodeGeneratorPNG();
        $barcodePng = $barcodeGenerator->getBarcode($product['BARCODE'], $barcodeGenerator::TYPE_EAN_13, 2, 60);
        $barcodeImg = imagecreatefromstring($barcodePng);
        imagecopy($image, $barcodeImg, 20, 150, 0, 0, imagesx($barcodeImg), imagesy($barcodeImg));
        $tmpPath = sys_get_temp_dir() . '/label_' . $product['ID'] . '_' . time() . '.png';
        imagepng($image, $tmpPath);
        imagedestroy($image);
        return $tmpPath;
    }
}

Imagick даёт более чёткие шрифты и поддерживает векторные элементы. Мы рекомендуем использовать его на серверах с PHP 8.1+.

Сравнение методов интеграции

Интеграция с административным интерфейсом

В карточке товара Битрикс добавляем кнопку «Распечатать этикетку» — она добавляет задание в очередь с выбором принтера из списка (bl_brother_printers). При массовом выделении товаров в списке — групповое действие «Распечатать этикетки».

Кнопка «Распечатать этикетки на отгружаемый заказ» добавляется в административную карточку заказа: генерирует адресную наклейку (ФИО, адрес, номер заказа) и этикетки комплектации. Все шаблоны легко адаптируются под дизайн вашей компании — мы предоставляем исходники SVG.

Что входит в работу

• Рендерер этикеток с поддержкой штрихкодов, цен, названий (GD/Imagick) — 2 дня
• Очередь печати + агент с обработкой ошибок и повторными попытками — 1 день
• Интеграция с системным принтером (CUPS/Windows) — 1 день
• Кнопки печати в карточке товара и заказа — 2 дня
• Тестирование с реальным принтером Brother — 1 день
• Документация по установке и настройке — включено
• Поддержка 2 недели после запуска — бесплатно

Сроки

Оценим ваш проект — просто опишите задачу. Выполним интеграцию под ключ за 7–9 рабочих дней с гарантией стабильной работы.