WINDOWS AGENT

Troubleshooting do Agent Windows

Diagnóstico dos problemas mais comuns sem depender do suporte.

Online, mas 0 impressoras

Sincronize pelo tray/painel; confira impressoras instaladas e política printer_sync.

Job fica queued

Agent/fila/impressora precisam estar online; não crie outro job “para testar” com chave nova.

manual_review

Leia failure_code/failure_class e histórico antes de retry.

PRINT_STA_PDF_HANDLER_UNAVAILABLE

Atualize Agent para 2.0.25+; PDFium interno remove dependência de leitor externo.

401 após revogação

Reconecte para nova credencial; não apague installation_id.

Janela abre no boot

2.0.25+ usa --background e deve ficar apenas no tray.

Atalho sem ícone

2.0.25+ fixa ICO no atalho; reinicie Explorer/Windows se houver cache antigo.

spooler_completed

Não é prova física de papel; é conclusão do spooler.

Contrato de máquina

Consulte também o OpenAPI 3.1.0 v1, com schemas tipados e exemplos.