CloudPrint — бесплатная альтернатива PrintNode, если вы интегрируете печать через API для собственного аккаунта и его принтеров. Это не замена endpoint один в один, а для SaaS-интеграций с аккаунтами клиентов нужен коммерческий B2B-договор. До переноса сравните развёртывание, назначение принтеров, форматы и статусы.
## Начните бесплатно со своего аккаунта Создайте аккаунт CloudPrint, подключите его агенты и принтеры и используйте API Credentials этого аккаунта без пользовательской подписки и платного тарифа на печать. Если ваш продукт подключает аккаунты клиентов или управляет ими, ознакомьтесь с условиями Developer Platform для production-доступа. ## Сначала сравните эксплуатационную модель CloudPrint использует локальный агент в каждой среде печати и серверный Public API. Ваш backend отвечает за авторизацию, маршрутизацию, идемпотентность и обработку статусов. Перед оценкой миграции сопоставьте действующий тариф PrintNode с условиями CloudPrint, доступными агентами, операционными системами и требованиями к поддержке. ## Проведите инвентаризацию Соберите все филиалы, компьютеры, принтеры, типы документов, параметры и ошибки текущей интеграции. Зафиксируйте, где хранятся идентификаторы, как обрабатываются недоступные устройства и может ли повтор запроса создать дубль. Это критерии приёмки CloudPrint. ## Сопоставьте понятия PrintNode и CloudPrint Компьютеру PrintNode операционно соответствует установка агента CloudPrint, но идентификаторы не переносятся. Принтер становится заново найденным `printer_id`, а задание — подготовленным документом и заданием CloudPrint. Подключите каждый агент, проверьте возможности очереди и запросите у администратора подтверждение назначения. ## Перестройте границу API Получите OAuth2-токен Client Credentials, вызовите `GET /api/v1/printers`, загрузите PDF или RAW, создайте задание и сохраните `print_job_id`. Держите секрет только на backend. Статусы `printed`, `failed` и `cancelled` обрабатывайте как конечные, а не пытайтесь переводить названия статусов другого провайдера один в один. ## Замените авторизацию и повторы Используйте OAuth2 Client Credentials с минимально необходимыми разрешениями. На каждую бизнес-операцию назначайте стабильный `Idempotency-Key`. После тайм-аута восстанавливайте или повторяйте исходный запрос, а не создавайте независимое второе задание. ## Проверьте форматы и возможности принтеров Протестируйте каждое рабочее сочетание PDF или языка RAW, носителя, DPI, числа копий и очереди. Для ZPL принтер должен объявить профиль ZPL и сквозную RAW-печать; для PDF нужна системная печать или поддерживаемая обработка. Название модели само по себе не подтверждает совместимость. ## Проведите пилот на типовом сценарии Выберите один филиал, одну модель принтера и часто используемый документ. Проверьте размер, количество копий, выравнивание, время до итогового статуса и поведение при потере связи. В пилот должны войти не только тестовая печать, но и интерфейс оператора и данные для поддержки. Такой же осторожный подход использован при поэтапном запуске CARRO.Бизнес. ## Переключайтесь без двойной отправки Сохраните окно отката, но каждую бизнес-операцию направляйте только одному провайдеру. Отслеживайте ошибки, время и ручные перепечатки. После стабилизации отзовите старые секреты и удалите ветки, способные отправить документ дважды. ## Частые вопросы ### CloudPrint — бесплатная альтернатива PrintNode? Да, если вы печатаете через API собственного аккаунта CloudPrint на его принтерах. Для интеграции, которая подключает аккаунты клиентов или управляет ими, нужен B2B-договор. ### CloudPrint заменяет PrintNode без доработки интеграции? Нет. Результат для бизнеса похож, но авторизацию, идентификаторы, endpoints, возможности и статусы нужно сопоставить явно. ### Можно переносить филиалы постепенно? Да. Начните с одного филиала или типа документа, сохраните проверенный путь отката и направляйте каждую бизнес-операцию только одному провайдеру. ### Можно печатать PDF и ZPL? CloudPrint принимает готовые PDF и явно указанные RAW-форматы, включая ZPL, если выбранный принтер объявил совместимый маршрут. ### Как сравнивать стоимость? Сопоставьте текущий тариф провайдера с опубликованными моделями аккаунта и B2B CloudPrint, затем учтите миграцию, поддержку и эксплуатационные требования. ### Как избежать дублей при переключении? Сохраняйте один `Idempotency-Key` для повторов и принимайте единственное решение о маршруте для каждой бизнес-операции. Осознанная перепечатка получает новый ключ и причину. ## Следующие шаги