Інтеграція 1С-Бітрікс із принтерами етикеток Brother

Інтеграція 1С-Бітрікс із принтерами етикеток Brother

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

Способи взаємодії з принтером Brother

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

Brother встановлюється як системний принтер у Windows або macOS. 1С-Бітрікс генерує 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)

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.

Генерація етикетки на стороні 1С-Бітрікс

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

Агент 1С-Бітрікс бере завдання з черги, рендерить PNG через BrotherLabelRenderer, відправляє на CUPS.

Інтеграція з адміністративним інтерфейсом

У картці товару 1С-Бітрікс додаємо кнопку «Надрукувати етикетку» — вона додає завдання в чергу з вибором принтера зі списку (bl_brother_printers). При масовому виділенні товарів у списку — групова дія «Надрукувати етикетки».

Кнопка «Надрукувати етикетки на відвантажуване замовлення» додається до адміністративної картки замовлення: генерує адресну наклейку (ПІБ, адреса, номер замовлення) і етикетки комплектації.

Терміни