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` и проверяйте конечный статус. Повтор после тайм-аута использует прежний ключ; намеренная повторная печать получает новый ключ и записанную причину. ## Следующие шаги