Настройка генерации и печати этикеток из 1С-Битрикс

Настройка генерации и печати этикеток из 1С-Битрикс

Склад обрабатывает 200 заказов в день, и каждую этикетку менеджер печатает вручную из Word-шаблона. Это 2–3 секунды на этикетку плюс ошибки при копировании адреса. Автоматическая генерация этикеток прямо из карточки заказа в Битрикс сокращает это время до нуля и исключает ошибки.

Форматы этикеток и библиотеки

Этикетки генерируются в двух основных форматах:

PDF — для термопечати и стандартных принтеров. Библиотека TCPDF или mPDF. mPDF предпочтительнее: лучше поддерживает кириллицу и CSS-стилизацию.

ZPL (Zebra Programming Language) — для промышленных принтеров Zebra, TSC, Honeywell. Напрямую отправляется на принтер без генерации PDF. Максимальная скорость печати.

Установка mPDF через Composer:

composer require mpdf/mpdf

Шаблоны этикеток

Этикетка — это HTML-шаблон с подстановкой данных. Хранится в /local/templates/.default/labels/:

<!-- shipping_label.html -->
<div class="label" style="width:100mm; height:150mm; font-family: Arial;">
    <div class="sender">
        <strong>ООО Магазин</strong><br>
        г. Москва, ул. Ленина, 1
    </div>
    <div class="barcode">
        <img src="barcode_{ORDER_ID}.png" width="200">
    </div>
    <div class="recipient">
        <strong>{RECIPIENT_NAME}</strong><br>
        {RECIPIENT_ADDRESS}<br>
        {RECIPIENT_PHONE}
    </div>
    <div class="order-info">
        Заказ #{ORDER_ID} | {ORDER_DATE}<br>
        Вес: {WEIGHT} кг | Мест: {ITEMS_COUNT}
    </div>
</div>

Генератор этикеток

namespace Custom\Warehouse;

class LabelGenerator {

    public function generateShippingLabel(int $orderId): string {
        $order = \Bitrix\Sale\Order::load($orderId);
        if (!$order) throw new \Exception("Order $orderId not found");

        $shipment = $this->getMainShipment($order);
        $propertyCollection = $order->getPropertyCollection();

        $data = [
            '{ORDER_ID}'        => $order->getId(),
            '{ORDER_DATE}'      => $order->getDateInsert()->format('d.m.Y'),
            '{RECIPIENT_NAME}'  => $propertyCollection->getPayerName()->getValue(),
            '{RECIPIENT_PHONE}' => $propertyCollection->getPhone()->getValue(),
            '{RECIPIENT_ADDRESS}' => $this->buildAddress($propertyCollection),
            '{WEIGHT}'          => $this->calculateWeight($order),
            '{ITEMS_COUNT}'     => $order->getBasket()->count(),
        ];

        $template = file_get_contents($_SERVER['DOCUMENT_ROOT'] . '/local/templates/.default/labels/shipping_label.html');
        $html = str_replace(array_keys($data), array_values($data), $template);

        return $this->htmlToPdf($html, $orderId);
    }

    private function htmlToPdf(string $html, int $orderId): string {
        $mpdf = new \Mpdf\Mpdf([
            'mode' => 'utf-8',
            'format' => [100, 150], // 100mm x 150mm
            'margin_top' => 5,
            'margin_bottom' => 5,
            'margin_left' => 5,
            'margin_right' => 5,
        ]);

        $mpdf->WriteHTML($html);

        $outputPath = '/upload/labels/label-' . $orderId . '.pdf';
        $mpdf->Output($_SERVER['DOCUMENT_ROOT'] . $outputPath, 'F');

        return $outputPath;
    }
}

Штрихкоды на этикетках

Для генерации штрихкодов (Code 128, QR) используется библиотека picqer/php-barcode-generator:

composer require picqer/php-barcode-generator

$generator = new \Picqer\Barcode\BarcodeGeneratorPNG();
$barcode = $generator->getBarcode((string)$orderId, $generator::TYPE_CODE_128);
file_put_contents($_SERVER['DOCUMENT_ROOT'] . '/upload/labels/barcode_' . $orderId . '.png', $barcode);

Интеграция в административную часть

Кнопка «Печать этикетки» добавляется в карточку заказа через обработчик OnAdminContextMenuShow или через кастомный action в sale/order_detail.php. При нажатии генерируется PDF и открывается в новой вкладке браузера.

Для пакетной печати (несколько заказов из списка) — action «Распечатать этикетки» через checkbox-selection в sale/order_list.php. Генерируется один многостраничный PDF.

Прямая печать без PDF (ZPL)

Для Zebra-принтеров этикетка формируется в ZPL и отправляется напрямую:

function printZebraLabel(int $orderId, string $printerIp, int $printerPort = 9100): void {
    $zpl = "^XA\n^FO50,50^A0N,30,30^FD Заказ #$orderId ^FS\n^XZ";

    $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
    socket_connect($socket, $printerIp, $printerPort);
    socket_send($socket, $zpl, strlen($zpl), 0);
    socket_close($socket);
}

Сроки выполнения

Автоматизация печати этикеток — один из первых шагов к порядку на складе при росте объёма заказов.