# Timeout na emissão fiscal > Timeout na emissão fiscal é a situação em que uma requisição para emitir um documento fiscal, como NF-e, NFC-e ou NFS-e, ultrapassa o tempo máximo de espera definido sem receber resposta. Nesse caso, o sistema não sabe se o documento foi autorizado, rejeitado ou nem chegou ao órgão autorizador, exigindo consulta antes de qualquer reenvio. **Também conhecido como:** Tempo limite esgotado, Tempo de espera excedido, Estouro de tempo na emissão, Timeout de requisição fiscal, Request timeout **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** T ## O que acontece quando ocorre um timeout na emissão fiscal? Toda comunicação entre sistemas tem um tempo limite de espera. Quando um ERP ou uma plataforma de vendas envia uma nota para emissão e a resposta não chega dentro desse prazo, a conexão é encerrada e o sistema registra um timeout. O ponto mais importante é que timeout não significa erro na nota. Significa apenas que a resposta não chegou a tempo. A nota pode ter sido autorizada normalmente, pode ter sido rejeitada ou pode nem ter sido processada. O status real só é conhecido depois de uma consulta. ## Por que acontece timeout na emissão de notas fiscais? As causas mais comuns são lentidão ou instabilidade no órgão autorizador (SEFAZ ou prefeitura), falhas momentâneas de rede, janelas de manutenção e picos de volume, como datas promocionais ou fechamento de mês. Também há causas do lado de quem integra: tempo limite configurado curto demais, envio de lotes muito grandes em uma única requisição ou um servidor sobrecarregado que demora a processar a resposta. Na NFS-e, como cada município pode ter um sistema diferente, o tempo de resposta varia bastante entre prefeituras. ## Qual o risco de reenviar uma nota após um timeout? O maior risco é a duplicidade. Se a primeira tentativa foi autorizada e o sistema reenvia sem verificar, pode gerar uma segunda nota para a mesma venda ou receber uma rejeição por duplicidade de número. Duplicidades geram retrabalho: é preciso cancelar a nota extra, conferir a numeração e, às vezes, explicar a diferença na contabilidade. Por isso, a regra básica é consultar primeiro e só reenviar se ficar confirmado que o documento não foi autorizado. ## Como tratar um timeout de forma segura? O primeiro passo é consultar o status do documento usando um identificador já conhecido, como a chave de acesso, a referência interna da venda ou o identificador devolvido pela API. Se a nota estiver autorizada, basta seguir o fluxo normal e baixar o XML e o PDF. Integrações bem construídas usam idempotência: cada pedido de emissão leva uma chave única, e se a mesma requisição chegar duas vezes, a API reconhece e não cria um segundo documento. Combinada a tentativas automáticas com intervalos crescentes (backoff exponencial), essa técnica permite reenviar sem medo. Outra prática é adotar o fluxo assíncrono: o sistema envia a nota, recebe um aviso de que ela entrou na fila e depois acompanha o resultado por webhook ou consulta periódica. Assim, a espera pela SEFAZ ou prefeitura não prende a conexão e o risco de timeout cai bastante. Registrar tudo em log ajuda a investigar casos que fogem do padrão. ## Qual a diferença entre timeout e rejeição fiscal? A rejeição é uma resposta clara do órgão autorizador dizendo que a nota não foi aceita e indicando o motivo, como um CFOP inválido ou dados do destinatário incorretos. A correção é ajustar os dados e emitir de novo. O timeout é a ausência de resposta. Não há motivo informado nem certeza sobre o resultado. Por isso, enquanto a rejeição pede correção, o timeout pede verificação antes de qualquer ação. ## O que fazer quando a SEFAZ ou a prefeitura está fora do ar? Se os timeouts se repetem por causa de indisponibilidade do órgão autorizador, a legislação prevê modos de contingência para alguns documentos. Na NF-e, por exemplo, existem alternativas como a SVC e o EPEC, e a NFC-e também possui regras próprias de contingência. Cada modalidade tem condições e prazos específicos, que mudam conforme o documento e a unidade da federação. Por isso, vale conferir as regras vigentes antes de ativá-las e manter os documentos emitidos em contingência sob acompanhamento até a regularização. ## Exemplos de Timeout na emissão fiscal - Uma loja virtual envia uma NF-e e a conexão expira sem resposta. O sistema consulta o status pela referência do pedido, descobre que a nota já estava autorizada e apenas baixa o XML, evitando emitir em duplicidade. - Um ERP envia uma NFS-e para uma prefeitura lenta e recebe timeout. Como a integração usa chave de idempotência, o reenvio automático é reconhecido pela API e nenhuma nota extra é criada. - Durante um pico de vendas, um sistema de PDV passa a registrar vários timeouts. A equipe migra para o fluxo assíncrono, recebendo o resultado das NFC-e por webhook, e os erros de espera deixam de ocorrer. - Uma transportadora recebe timeout ao emitir um CT-e. O log mostra que a SEFAZ estava instável, e a emissão é refeita após consulta confirmar que o documento não havia sido autorizado. ## Perguntas frequentes ### Timeout significa que a nota não foi emitida? Não. Significa apenas que a resposta não chegou dentro do tempo limite. A nota pode ter sido autorizada, rejeitada ou não processada. É preciso consultar o status antes de concluir qualquer coisa. ### Devo aumentar o tempo limite para evitar timeouts? Ajustar pode ajudar quando o valor está curto demais, mas não resolve a causa. O mais eficaz é usar fluxo assíncrono, consulta de status e idempotência, que tornam a integração segura mesmo quando o órgão autorizador demora. ### Posso reenviar a nota automaticamente após um timeout? Sim, desde que a integração use idempotência ou consulte o status antes. Sem essas proteções, o reenvio automático pode gerar notas duplicadas ou rejeições por duplicidade de número. ### O timeout pode acontecer em qualquer tipo de documento fiscal? Sim. NF-e, NFC-e, NFS-e, CT-e e MDF-e dependem de comunicação com sistemas externos e estão sujeitos a atrasos. A frequência varia conforme o órgão autorizador, o município e o volume de emissões. ## Termos relacionados - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) - [Retry na integração fiscal](https://conota.dev/glossario/retry-na-integracao-fiscal.md) - [Backoff exponencial](https://conota.dev/glossario/backoff-exponencial.md) - [Fluxo assíncrono de emissão](https://conota.dev/glossario/fluxo-assincrono-de-emissao.md) - [Polling de status fiscal](https://conota.dev/glossario/polling-de-status-fiscal.md) - [Latência da API fiscal](https://conota.dev/glossario/latencia-da-api-fiscal.md) --- Fonte: [Timeout na emissão fiscal](https://conota.dev/glossario/timeout-na-emissao-fiscal/) · Atualizado em 2026-10-22