Print STA
DevelopersWINDOWS AGENT
← Documentação
WINDOWS AGENT

Troubleshooting do Agent Windows

Diagnóstico objetivo dos problemas mais comuns do Agent Windows.

Online, mas 0 impressoras

Sincronize as impressoras pelo aplicativo da bandeja ou pelo painel e confirme que as impressoras do Windows estão instaladas e disponíveis.

Job fica queued

Confirme que Agent, fila e impressora estão online. Reutilize a mesma Idempotency-Key ao repetir a mesma solicitação.

manual_review

Leia failure_code, failure_class e o histórico do trabalho antes de executar retry. O retry manual deve ser usado somente nos estados permitidos pelo contrato.

Processamento de PDF

O Agent utiliza PDFium interno para processar documentos PDF.

401 após revogação de credencial

Após revogação de credencial, reconecte a instalação para emitir uma nova credencial. Preserve o installation_id.

Inicialização do Windows

O Agent inicia em segundo plano e permanece disponível na bandeja do Windows.

Atalho sem o ícone oficial

O atalho do Print STA utiliza o ícone oficial. Se o Windows exibir um ícone antigo, reinicie o Explorer para atualizar o cache.

spooler_completed

spooler_completed indica que o Windows spooler concluiu o processamento do trabalho. O status não confirma fisicamente a saída do papel.

Contrato de máquina

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

Referência completa