Печать этикеток: агент печати и принтеры

Что это и зачем

Глайдер работает в интернете и сам не достаёт до принтера, который стоит у вас на складе по USB или в локальной сети. Эту задачу решает агент печати — небольшая программа на компьютере рядом с принтером. Она сама обращается к серверу, получает готовые этикетки и отправляет их на принтер через обычную очередь печати вашей системы. Ничего наружу она не открывает.

Благодаря агенту этикетки Ozon, Wildberries и Яндекс Маркета печатаются одной кнопкой или сканом прямо из окна сборки и заказов FBS, а также с приложения для ТСД.

Как это работает

Как задание доходит до принтера

1. Вы нажимаете «Печать» (или сканируете код в окне сборки). Сервер получает этикетку и ставит задание в очередь.
2. Агент на компьютере склада держит соединение с сервером и забирает задание сразу, как оно появилось.
3. Агент отправляет PDF на выбранный принтер и сообщает серверу, что напечатано. Только после этого у заказа появляется отметка «этикетка напечатана».

Задание берёт ровно один компьютер, поэтому если агентов запущено несколько, одна этикетка не выйдет дважды. Если сервер временно недоступен, агент подождёт и попробует снова — задания лежат в очереди, пока их не напечатают.

Кэш этикеток: печать не ждёт площадку

Раньше каждая печать ждала ответа маркетплейса — у Ozon это секунды на этикетку. Теперь Глайдер заранее, примерно раз в минуту, скачивает этикетки заказов, которые уже можно печатать, и хранит их три дня. Окно сборки дополнительно заранее готовит этикетки предыдущего, текущего и двух следующих заказов. Поэтому «Печать» обычно срабатывает сразу. Если этикетки в кэше нет, система запросит её у площадки, как раньше, и сохранит для повторной печати.

Установка агента

Откройте «Настройки → Печать» (или раздел «Печать этикеток») на том компьютере, к которому подключён принтер. Выберите операционную систему и получите установку:

• macOS и Linux — кнопка «Получить команду установки». Скопируйте команду, вставьте в Терминал и нажмите Enter. Агент скачается, настроится и добавится в автозапуск. Повторный запуск команды обновляет агент.
• macOS без Терминала — «Скачать для macOS»: откройте архив, нажмите на файл «Установить агент WMS» правой кнопкой → «Открыть» → «Открыть» (в первый раз macOS предупредит, что файл не подписан).
• Windows — кнопка «Получить установщик», затем «Скачать для Windows»: в архиве уже есть ключ вашей организации. Распакуйте его в постоянную папку и запустите install.bat.

Ссылка на установку действует сутки. Ключ для агента создаётся в момент скачивания и виден в вашем профиле среди ключей. Агент работает в фоне без окна и сам запускается после перезагрузки.

Через несколько секунд компьютер появится в списке — выберите на нём принтер и нажмите «Пробная».

Несколько компьютеров

На один аккаунт можно подключить несколько компьютеров, например по одному на каждый стол упаковки. Каждый запущенный агент — отдельная карточка в списке «Компьютеры и принтеры». Компьютер можно переименовать (например, «Упаковка 1») и убрать из списка, когда он не на связи. Если агент ещё работает, компьютер появится снова.

В карточке видно: имя, систему, версию агента, статус «На связи» или «Нет связи» и принтеры с состоянием «Готов», «Нет связи» или «Выключен». На macOS принтер может сам выключиться после ошибки печати — такой принтер виден красным.

Куда печатать: себе и всем

Каждое задание печатается на одном компьютере и одном принтере. Порядок выбора:

1. принтер, указанный при пробной печати;
2. ваш личный выбор («для меня»);
3. выбор организации по умолчанию («для всех по умолчанию»);
4. если ничего не выбрано — любой компьютер организации на связи.

Выбрать принтер себе может любой сотрудник склада, нажав на принтер в карточке компьютера. Принтер по умолчанию для всех выбирают администратор и менеджер: переключите «Выбор ниже —» на «для всех по умолчанию». Кнопка «Сбросить мой выбор» возвращает вас к принтеру организации.

Если выбранный компьютер не на связи, задания ждут его и на другой компьютер сами не уходят. Если выбранного принтера на компьютере нет, задание завершится понятной ошибкой.

Статус печати

Текущий принтер и состояние показывает блок вверху «Настройки → Печать»: «Вы печатаете на» или «Печать по умолчанию», название принтера и компьютера. Надписи «Принтер не подключён», «Принтер не выбран» и «Агент не на связи» подсказывают, что делать. Когда компьютер не на связи, а задания копятся, рядом пишется «ждут N».

Запасной порядок принтеров

Это старый способ для агентов без выбора принтера. В разделе «Печать этикеток» блок «Запасной порядок принтеров» задаёт список: агент печатает на первом включённом принтере из него. Он используется, когда принтер не выбран в карточке компьютера. Имя принтера вписывайте латинскими буквами и без числа в конце (Xprinter_XP_365B, а не Xprinter_XP_365B_2): macOS добавляет число при каждом переподключении.

Обновление агента

Агент на macOS и Linux сам проверяет новую версию и обновляется между заданиями. Сборку для Windows пока нужно обновлять вручную: скачайте новый архив, распакуйте поверх старых файлов (файл config.json не трогайте) и снова запустите install.bat. Если версия устарела, в карточке компьютера появится предупреждение.

Что нужно

• Компьютер рядом с принтером: macOS 11 и новее, Windows 7–11 или Linux (Ubuntu, Debian, Mint, Fedora, Astra, РЕД ОС) с системой печати CUPS и Python 3.8+.
• Принтер, который печатает PDF из вашей системы и печатает пробную страницу из настроек ОС. Подходят термопринтеры этикеток (Xprinter, TSC, Godex, Zebra, АТОЛ и другие) и обычные офисные принтеры.
• Роль: выбрать принтер себе может любой сотрудник склада; общий выбор, переименование и удаление компьютеров — администратор и менеджер.
• Интернет на компьютере с агентом. Пока никто не вошёл в Windows, агент не работает, поэтому для печати сразу после включения настройте автоматический вход пользователя.

Размеры этикеток

В драйвере принтера выставьте размер бумаги, как у ваших этикеток. В мастере настройки Глайдера предложены два размера: 58×40 мм для штрихкодов товаров и 75×120 мм для этикеток Ozon, Wildberries и Маркета. Пробная этикетка печатается в этих же размерах. Ярлык Яндекс Маркета (40×58 мм) сервер сам разворачивает, чтобы он занимал одну этикетку.

Что и как печатается

• Этикетки заказов Ozon, Wildberries и Яндекс Маркета — из окна сборки, реестра заказов и с ТСД.
• Штрихкоды товаров — этикетка 58×40 мм со штрихкодом и названием; можно напечатать несколько копий (до 200 за раз).
• Этикетки конструктора (Честный знак, ШК единицы и свои шаблоны) — раздел «Товары → Этикетки», подробнее в статьях про товары и маркировку.
• QR-коды ячеек — страница «Ячейки» (кнопка «Печать QR», доступна администратору и менеджеру). Они открываются как обычная печать браузера, а не через агента, поэтому печатаются на принтере, который выбран в браузере.

Сколько это стоит

Печать этикетки заказа маркетплейса стоит 1 скан за каждый заказ. На тарифе «Безлимит» операции склада, включая печать, не списываются до 150 000 операций за период, сверх лимита — 1 скан за каждые 3 операции. Пробная печать и этикетки товаров в справочнике тарифа отдельной строкой не указаны. Если сканов не хватает, печать приостанавливается до пополнения баланса. Подробнее — в статье Тариф и баланс и на странице тарифов.

Частые вопросы и ошибки

Компьютер не появился в списке. Подождите до 30 секунд после установки. Если не появился, откройте файл agent.log в папке агента: там причина. Частые случаи: «Не удалось связаться с сервером» (проверьте интернет), 401 (ключ отозван, получите установщик заново).

Этикетки не печатаются, а в шапке «нет связи · ждут N». Выбранный компьютер выключен, спит или агент остановлен. Включите компьютер: задания напечатаются сами. Нужна срочная печать — выберите другой компьютер в «Настройки → Печать».

Принтер в списке красный («Выключен»). macOS отключила очередь после ошибки печати. Включите принтер в «Системные настройки → Принтеры и сканеры».

Печатается боком, мелко или на две этикетки. В драйвере выбран не тот размер бумаги. Выставьте 58×40 или 75×120 мм и нажмите «Пробная».

Пустые этикетки у термопринтера. Проверьте, что этикетки вставлены нужной стороной, и откалибруйте принтер (у многих моделей — удерживать кнопку FEED).

Этикетки выходят пачкой, а не по одной. Режим отделения этикетки включается в драйвере принтера на компьютере, не в Глайдере.

macOS: ошибка «CERTIFICATE_VERIFY_FAILED». Выполните в Терминале pip3 install certifi.

Выбранный принтер «не найден». Выберите принтер заново из списка, который прислал агент. Названия с русскими буквами лучше не использовать.

Две этикетки на один заказ. Этого быть не должно: задание берёт один агент, а окно сборки закрепляет заказ за сотрудником, печатавшим его последние 10 минут. Если другой сотрудник уже напечатал заказ, окно покажет, кто, и перейдёт к следующему.

Что дальше

• Окно сборки — печать и упаковка заказов.
• Сканеры и камера — как подключить сканер штрихкодов.
• Приложение для ТСД — печать с терминала на принтер станции.
• Тариф и баланс — сколько стоят действия.

Что нового

• 2026-10-19: у каждого заказа ведётся журнал печати — все попытки, ошибки с номером задания, отмены; отмена печати снимает упаковку. Описано в окне сборки.
• 2026-10-15: статья создана. Установка агента одной командой на macOS и Linux описана по документации; на чистом Mac, на Linux и на настоящем Windows-компьютере пока не проверена.