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

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

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

Способы взаимодействия с принтером 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.

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

Для 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;
    }
}

Очередь печати для 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.

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

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

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

Сроки