Налаштування генерації та друку етикеток з 1С-Бітрікс

Ми пропонуємо автоматизацію друку етикеток з 1С-Бітрікс. Наша команда має понад 10 років досвіду в Бітрікс-розробці та реалізувала понад 50 проектів автоматизації. Уявіть склад, що обробляє 300 замовлень на день. Кожну етикетку менеджер друкує вручну з Word-шаблону: копіює адресу, назву товару, вагу. На одну йде 2–3 секунди. В масштабі дня — це більше 2 годин монотонної роботи плюс неминучі помилки (близько 5% замовлень з невірною адресою). При збільшенні обсягів до 500 замовлень ручне етикетування стає критичним вузьким місцем: співробітники відволікаються, зростає відсоток повернень через неправильні адреси. Налаштування генерації та друку етикеток з 1С-Бітрікс дозволяє автоматизувати цей процес: генерація натисканням однієї кнопки з картки замовлення або пакетно зі списку. Автоматизація пришвидшує друк у 24 рази (з 2 годин до 5 хвилин).

Підтримувані формати: PDF та ZPL

Етикетки генеруються у двох основних форматах: PDF — для термодруку та стандартних принтерів — використовуємо бібліотеку mPDF (найкраще справляється з кирилицею та CSS-стилізацією); ZPL (Zebra Programming Language) — для промислових принтерів Zebra, TSC, Honeywell. Відправляємо ZPL-команди безпосередньо на принтер по TCP/IP без генерації PDF — максимальна швидкість друку (до 4 етикеток на секунду). Вибір формату залежить від наявного обладнання: для офісних принтерів підійде PDF, для конвеєрного друку — ZPL.

Установка mPDF та генератора штрихкодів через Composer:

composer require mpdf/mpdf composer require picqer/php-barcode-generator 

Порівняння форматів:

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

Етикетка — це 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); // Generate barcode $this->generateBarcode($orderId); return $this->htmlToPdf($html, $orderId); } private function generateBarcode(int $orderId): void { $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); } 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; } } 

Як додати кнопку друку в адмінку Бітрікс?

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

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

// подія OnAdminSaleOrderListMenu function addPrintLabelsAction(\Bitrix\Main\Event $event) { $items = &$event->getParameter('items'); $items[] = [ 'TEXT' => 'Роздрукувати етикетки', 'ACTION' => 'printLabels()', 'ICON' => 'adm-btn-print', ]; } 

Прямий друк без 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); } 

Як генерується штрихкод?

Штрихкод генерується на основі ідентифікатора замовлення за допомогою бібліотеки picqer/php-barcode-generator. Підтримуються формати Code 128, QR та інші. PNG-файл зберігається в /upload/labels/ і підставляється в HTML-шаблон. У випадку ZPL штрихкод формується командами ^BC, що не вимагає генерації зображень.

Економічний ефект автоматизації друку

Помилки при ручному заповненні етикеток обходяться дорого: неправильна адреса — повернення товару, втрата клієнта, повторне відправлення. Наприклад, при 5% повернень з 300 замовлень на день, щоденні витрати на повернення становили 3000 грн (середня вартість повернення 200 грн). Наш кейс: інтернет-магазин з 300 замовленнями на день до автоматизації витрачав 2 години на етикетування і мав 5% браку. Після впровадження час скоротився до 5 хвилин, помилки — до 0.5% (у 10 разів менше). Економія на логістиці склала 18% за рахунок зниження повернень. Після впровадження ця сума впала в рази. Автоматизація друку окупається в середньому за 2 місяці.

Покрокове налаштування для вашого проекту

1. Збираємо вимоги: обсяг замовлень, типи принтерів, формат етикетки, необхідність штрихкодів.
2. Розробляємо HTML-шаблон етикетки під ваш дизайн (потрібен макет або приклад).
3. Впроваджуємо генератор PDF та/або ZPL, інтегруємо з вашими принтерами.
4. Додаємо кнопку друку в картку замовлення та/або пакетний друк.
5. Тестуємо на 50-100 замовленнях, навчаємо співробітників.

Строки виконання

Що входить в роботу

• Розробка HTML-шаблону етикетки під ваш дизайн
• Генерація PDF та/або ZPL
• Штрихкоди (Code 128, QR)
• Кнопка друку в картці замовлення
• Пакетний друк зі списку замовлень
• Інтеграція з мережевими принтерами (Zebra, TSC та ін.)
• Документація з налаштування та підтримки
• Навчання співробітників (віддалено або на місці)

Гарантуємо стабільну роботу рішення після впровадження. Фіналізуємо проект протягом 3–5 днів залежно від складності. Зв'яжіться з нами для оцінки вашого проекту — підберемо оптимальне рішення під ваш склад. Замовте консультацію, і ми надішлемо комерційну пропозицію протягом 24 годин.