CloudPrint связывает ERP, WMS, 1С или другую учётную систему с принтерами в офисе, магазине или на складе. Исходная система решает, что печатать, и готовит документ; CloudPrint доставляет его в выбранную локальную очередь и сообщает результат.
## Начинайте с события в бизнес-системе Создавайте операцию печати после понятного события: заказ готов к отгрузке, подбор завершён, товар принят или оператор утвердил документ. Счёт, накладную или этикетку формируйте в ERP, WMS либо 1С до обращения к CloudPrint. Момент печати и правила подготовки документа должны оставаться в исходной системе. ## Назначьте принтеры по месту и назначению При настройке вызовите `GET /api/v1/printers`, дайте администратору выбрать очередь для каждого склада, рабочего места и типа документа и сохраните стабильный `printer_id`. Имя удобно показывать человеку, но оно не подходит для маршрутизации. Не отправляйте документ в другой филиал как незаметный резервный вариант. ## Выберите совместимый формат Для счетов, накладных и постраничных документов используйте PDF. Команды устройства передавайте как RAW: ZPL, TSPL или CPCL для совместимых принтеров этикеток, ESC/POS — для совместимого чекового принтера. Сверяйтесь с возможностями выбранной очереди: CloudPrint не переводит один язык принтера в другой. ## Вызывайте API с сервера Модуль интеграции ERP или WMS либо HTTP-интеграция 1С должны обращаться к CloudPrint Public API из серверной среды. Храните данные доступа там же, задавайте один стабильный `Idempotency-Key` для бизнес-операции и сохраняйте собственный идентификатор вместе с `print_job_id`. ## Контролируйте результат Отслеживайте задание до `printed`, `failed` или `cancelled`. Если агент или принтер не в сети, покажите ожидание или необходимость вмешательства, а не создавайте ещё одну копию. Сетевой повтор сохраняет исходный ключ идемпотентности; подтверждённая оператором повторная печать становится новой записанной операцией. ## Следующие шаги