Печать чеков ESC/POS из приложения
CloudPrint передаёт подготовленные ESC/POS-данные из кассовой системы, интернет-магазина, 1С или другой учётной системы на совместимый локальный чековый принтер. Сервис доставляет команды и сообщает статус задания, но не регистрирует продажу, не управляет ККТ или фискальным накопителем и не формирует юридически значимый фискальный чек.
Отделите печать от фискализации
Формируйте данные чека только после завершения бизнес-операции в кассовой или торговой системе. Если закон требует ККТ, регистрации, подписи или передачи данных оператору, выполняйте это в сертифицированной фискальной системе. CloudPrint может напечатать подготовленный клиентский или служебный чек, но не заменяет фискализацию.
Подготовьте ESC/POS в своей системе
Сформируйте текст, штрихкоды, QR-коды, подачу и отрезание бумаги с учётом команд конкретной модели. Проверьте кодировку, кодовую страницу и реальную ширину ленты 58 или 80 мм. CloudPrint передаёт байты без изменений и не исправляет неподдерживаемые команды или символы.
Явно укажите и проверьте язык
Загрузите данные с document_format=raw и document_raw_language=escpos. Перед созданием задания вызовите GET /api/v1/printers и убедитесь, что выбранная очередь сообщает escpos в capabilities.language_profiles и доступную сквозную RAW-печать.
Назначьте нужный чековый принтер
Сохраните стабильный printer_id для каждой кассы, стойки выдачи или кухонной станции. Если один заказ создаёт несколько документов, задайте каждый маршрут явно. Не выбирайте очередь только по имени и не отправляйте чек в другую точку без решения оператора.
Не допускайте случайных дублей
Используйте отдельный Idempotency-Key для каждого намеренно создаваемого отпечатка и сохраняйте полученный print_job_id. Отслеживайте статус до printed, failed или cancelled. Повтор после тайм-аута использует тот же ключ и данные; намеренная вторая копия оформляется как новая, отслеживаемая операция.