Cuidados na emissão de documentos assíncronos

A maioria dos documentos fiscais é processada de forma assíncrona. A API transmite os dados para o órgão emissor (SEFAZ ou prefeitura) e aguarda o retorno da autorização.

Ao desenhar o fluxo de emissão na sua aplicação, considere:

• Tempo de Processamento: Na maioria dos documentos, a autorização ocorre em poucos segundos. Para NFS-e, esse tempo pode levar alguns minutos devido à variação de desempenho nos sistemas municipais.
• Evite Polling Excessivo: Consultas em intervalos muito curtos geram overhead no seu servidor e consomem desnecessariamente a sua quota de requisições (rate limit).
• Uso de Webhooks (Recomendado): Em vez de fazer requisições periódicas de checagem, cadastre uma URL de callback em nosso painel. A Focus NF-e notificará sua aplicação via HTTP POST imediatamente após a conclusão do processamento.