Представьте склад, обрабатывающий 300 заказов в день. Каждую этикетку менеджер печатает вручную из Word-шаблона: копирует адрес, название товара, вес. На одну уходит 2–3 секунды. В масштабе дня — это более 2 часов монотонной работы плюс неизбежные ошибки (около 5% заказов с неверным адресом). При увеличении объёмов до 500 заказов ручное этикетирование становится критическим узким местом: сотрудники отвлекаются, растёт процент возвратов из-за неправильных адресов. Настройка генерации и печати этикеток из 1С-Битрикс позволяет автоматизировать этот процесс: генерация нажатием одной кнопки из карточки заказа или пакетно из списка. Опыт наших инженеров — более 10 лет в Битрикс-разработке, поэтому решаем задачу «под ключ» с учётом вашего оборудования.
Поддерживаемые форматы: 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
Сравнение форматов:
| Параметр | ZPL | |
|---|---|---|
| Совместимость | Любые принтеры | Zebra, TSC, Honeywell |
| Скорость | Средняя (преобразование HTML→PDF) | Максимальная (прямая отправка) |
| Кастомизация | Через HTML/CSS | Через ZPL-команды |
| Штрихкоды | Встраиваются как PNG | Генерируются командами ^BC |
Шаблоны этикеток
Этикетка — это 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, что не требует генерации изображений.
Почему автоматизация печати экономит деньги?
Ошибки при ручном заполнении этикеток обходятся дорого: неправильный адрес — возврат товара, потерянного клиента, повторная отправка. Наш кейс: интернет-магазин с 300 заказами в день до автоматизации тратил 2 часа на этикетирование и имел 5% брака. После внедрения время сократилось до 5 минут, ошибки — до 0.5%. Экономия на логистике составила 18% за счёт снижения возвратов. Средняя стоимость возврата (логистика + упущенная выручка) составляла значительные суммы — после внедрения эта сумма упала в разы. Автоматизация печати окупается в среднем за 2 месяца.
Пошаговая настройка для вашего проекта
- Собираем требования: объём заказов, типы принтеров, формат этикетки, необходимость штрихкодов.
- Разрабатываем HTML-шаблон этикетки под ваш дизайн (требуется макет или пример).
- Внедряем генератор PDF и/или ZPL, интегрируем с вашими принтерами.
- Добавляем кнопку печати в карточку заказа и/или пакетную печать.
- Тестируем на 50-100 заказах, обучаем сотрудников.
Сроки выполнения
| Объём работ | Срок |
|---|---|
| HTML-шаблон + PDF-генерация + кнопка в заказе | 1–2 дня |
| Штрихкоды + пакетная печать | +1 день |
| ZPL для Zebra + сетевая печать | +1 день |
| Интеграция с транспортными ярлыками СДЭК/Почты | отдельная задача |
Что входит в работу
- Разработка HTML-шаблона этикетки под ваш дизайн
- Генерация PDF и/или ZPL
- Штрихкоды (Code 128, QR)
- Кнопка печати в карточке заказа
- Пакетная печать из списка заказов
- Интеграция с сетевыми принтерами (Zebra, TSC и др.)
- Документация по настройке и поддержке
- Обучение сотрудников (удалённо или на месте)
Гарантируем стабильную работу решения после внедрения. Финализируем проект в течение 3–5 дней в зависимости от сложности. Свяжитесь с нами для оценки вашего проекта — подберём оптимальное решение под ваш склад. Закажите консультацию, и мы пришлём коммерческое предложение в течение 24 часов.