RoboFiscalDocs

Operação técnica e resolução de problemas

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

Equipe RoboFiscal · Revisado em

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.

Fatos e fontes

Nesta página

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.

Já tem conta e precisa de ajuda? Fale com o atendimento com os identificadores da operação e a mensagem recebida.

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átisConferir a referência da API

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

Revisado em · Equipe RoboFiscal. Versão em texto