# Minha requisição de emissão deu timeout. Como tento de novo sem duplicar a nota?

Depois de um timeout, consulte a nota antes de tentar emitir de novo. Envie referenciaExterna estável desde a primeira solicitação e preserve essa referência nas tentativas da mesma operação. O RoboFiscal consulta registros existentes por empresa e ambiente, com tratamento conforme o status. Um timeout deixa o resultado incerto; criar uma nova referência pode transformar o reenvio em outra emissão.

Revisado em 10 de outubro de 2026 · Equipe RoboFiscal.

## Fatos e fontes

- A RFC 9110 orienta cautela ao repetir automaticamente requisições não idempotentes. [IETF: RFC 9110, semântica HTTP](https://www.rfc-editor.org/rfc/rfc9110.html).
- A API nacional oferece consulta de NFS-e pela chave de acesso. [Portal NFS-e: manual da API, v1.2](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual/manual-contribuintes-emissor-publico-api-sistema-nacional-nfs-e-v1-2-out2025.pdf).
- O serviço nacional também permite recuperar a chave a partir do identificador da DPS, conforme as regras de acesso. [Portal NFS-e: manual da API, v1.2](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/documentacao-atual/manual-contribuintes-emissor-publico-api-sistema-nacional-nfs-e-v1-2-out2025.pdf).
- O Portal Nacional distingue produção de produção restrita. [Portal NFS-e: APIs de produção e produção restrita](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica/apis-prod-restrita-e-producao).
- A API do RoboFiscal aceita referenciaExterna na emissão e na consulta de notas. [RoboFiscal: contrato OpenAPI público](https://robofiscal.com.br/app/api/v1/openapi.yaml).

## Como escolher uma referência externa?

Use um identificador estável da prestação, como contrato mais competência, ou o identificador único de um pedido. Exemplo ilustrativo: manutencao-contrato42-2026-10. A referência precisa distinguir prestações diferentes e permanecer igual quando a mesma operação é reenviada. Um horário aleatório gerado a cada tentativa não atende a esse objetivo.

## Como decidir o que fazer depois do timeout?

Consulte por referenciaExterna com a chave da empresa e o ambiente usados no envio. Se houver autorização, utilize o documento existente. Se estiver processando, aguarde e consulte novamente. Se houver rejeição ou erro, examine o motivo antes de corrigir ou reprocessar. A ausência momentânea de resposta não prova que nenhuma etapa foi executada.

## Existe garantia para qualquer situação de concorrência?

O controle por referência precisa trabalhar junto da organização da sua integração. Evite dois processos locais disparando a mesma operação simultaneamente. Registre a tentativa antes do envio e reconcilie o resultado depois. A busca de referências no RoboFiscal tem condições de status; rejeitadas e erros exigem análise própria, e não devem ser tratados como autorizações reaproveitáveis.

Consulta de conferência, relativa à base da API e com a mesma chave de empresa.

```
GET /notas?referenciaExterna=manutencao-contrato42-2026-10
```

## Passo a passo

1. Grave uma referência estável antes da primeira chamada.
2. Em caso de timeout, suspenda o reenvio automático cego.
3. Consulte a referência na empresa e no ambiente corretos.
4. Use a nota existente ou acompanhe o processamento.
5. Trate erros e rejeições com a evidência da tentativa original.

## Erros comuns

- Gerar uma referência nova porque a conexão caiu.
- Repetir a emissão apenas porque o PDF ainda não foi obtido.

## Como o RoboFiscal ajuda

O RoboFiscal permite correlacionar emissão e consulta pela referência externa. Combine esse recurso com controle de concorrência e conciliação no seu sistema.

Leia o comportamento de referenciaExterna e os exemplos validados; use o cadastro para iniciar uma integração que preserve a identificação da operação. [Criar conta grátis](https://robofiscal.com.br/app/registrar).

[Conferir a referência da API](https://robofiscal.com.br/app/api/docs).

## Perguntas relacionadas

### Posso usar a mesma referência para o contrato em todos os meses?

Use uma identificação por prestação. Para mensalidades distintas, inclua a competência ou outro identificador que diferencie os ciclos.

### Idempotency-Key substitui referenciaExterna?

Siga o contrato de cada rota. Na emissão individual, referenciaExterna identifica a operação fiscal; outras operações também usam Idempotency-Key.

## Continue lendo

- [Como integrar a emissão de NFS-e ao seu sistema por API?](https://robofiscal.com.br/api-nfs-e.html)
- [Como emitir NFS-e em lote e acompanhar o resultado de cada nota?](https://robofiscal.com.br/docs/emissao-nfse-lote/)
- [O que fazer quando a emissão de NFS-e fica indisponível?](https://robofiscal.com.br/docs/nfse-indisponivel-timeout/)

Página: https://robofiscal.com.br/docs/evitar-nfse-duplicada/