Печать этикеток, ценников и штрихкодов по API
CloudPrint передаёт готовые этикетки, ценники, штрихкоды и коды маркировки на локальные принтеры. Ваша система формирует содержимое, а CloudPrint принимает подготовленный PDF либо RAW-данные в ZPL, TSPL или CPCL, проверяет маршрут и отслеживает задание.
Подготовьте макет и данные
Сформируйте цену, текст, штрихкод или Data Matrix и итоговый макет в интернет-магазине, 1С, товароучётной системе, ERP или WMS. CloudPrint не выпускает и не проверяет коды маркировки, не является редактором этикеток и не изменяет бизнес-данные. До загрузки убедитесь, что товар, партия, заказ и значение кода относятся к одной операции.
Выберите PDF или язык принтера
PDF подходит для этикетки, подготовленной как страница, если очередь поддерживает системную печать или поддерживаемое преобразование. Для прямой термопечати задайте document_format=raw и document_raw_language: zpl, tspl либо cpcl. CloudPrint не преобразует команды одного языка принтера в другой.
Проверьте обнаруженные возможности
Вызовите GET /api/v1/printers и проверьте capabilities.language_profiles вместе с endpoint.raw_passthrough_available. Агент получает эти сведения от принтера и очереди. Выбирайте только маршрут с нужным языком; не делайте вывод по бренду или названию и не просите оператора назначить язык вручную.
Согласуйте макет с носителем
Размер страницы или команд должен совпадать с физической этикеткой. При необходимости укажите media_width_mm, media_height_mm и dpi, затем настройте датчик зазора или метки, плотность и скорость на принтере. До запуска напечатайте и отсканируйте реальные образцы: статус printed не подтверждает читаемость обрезанного штрихкода.
Маршрутизируйте и повторяйте осознанно
Сохраните printer_id для каждого рабочего места или назначения этикетки. Создавайте задание со стабильным Idempotency-Key, сохраняйте print_job_id и проверяйте конечный статус. Повтор после тайм-аута использует прежний ключ; намеренная повторная печать получает новый ключ и записанную причину.