RoboFiscalOperação técnica e resolução de problemas
O sistema do governo caiu e minha nota ficou pendente. O que devo fazer?
Quando a emissão demora ou ocorre timeout, primeiro consulte a situação da operação. A falha de conexão pode acontecer antes ou depois de o governo processar a nota. Preserve referência e identificadores, evite emissões paralelas da mesma prestação e acompanhe a recuperação do serviço. Se a nota já estiver autorizada, use o documento existente e trate separadamente eventuais falhas de PDF ou e-mail.
Fatos e fontes
- A semântica HTTP prevê falhas temporárias de serviço e o cabeçalho Retry-After quando aplicável.Fonte: IETF: RFC 9110, semântica HTTP.
- A API nacional permite consultar NFS-e por chave e verificar documentos a partir da DPS.Fonte: Portal NFS-e: manual da API, v1.2.
- O Portal Nacional identifica endpoints diferentes por ambiente.Fonte: Portal NFS-e: APIs de produção e produção restrita.
- A consulta pública é um canal adicional para conferir uma nota identificada.Fonte: Gov.br: consulta de NFS-e.
- O RoboFiscal oferece consulta de notas, referências externas e acompanhamento de lotes e webhooks.Fonte: RoboFiscal: contrato OpenAPI público.
Nesta página
Como saber em qual etapa ocorreu a falha?
Separe autenticação na API, envio fiscal, consulta do resultado, obtenção do PDF e entrega por e-mail. Uma falha no último passo não desfaz os anteriores. Confira a mensagem e o estado registrado; se houver chave e autorização confirmadas, a prioridade é recuperar o documento ou a entrega, sem criar nova emissão.
Quando tentar novamente?
Consulte o estado antes de repetir operações que podem gerar documento. Respeite os intervalos informados pelo serviço e mantenha tentativas controladas. Se a operação ainda estiver em processamento, aguarde a atualização ou procure suporte com a referência original. Várias chamadas simultâneas dificultam a conciliação e podem ampliar o problema.
Como organizar o atendimento durante a indisponibilidade?
Mantenha uma lista de prestações afetadas, horário, referência e último status. Informe ao cliente o que está confirmado e o que aguarda processamento. Combine com a contabilidade o procedimento permitido para a situação; não presuma um modo de contingência que seu canal não oferece.
Passo a passo
- Registre a referência e a etapa em que ocorreu a falha.
- Consulte a nota na mesma empresa e ambiente.
- Separe pendências fiscais de problemas de arquivo ou entrega.
- Acompanhe o serviço e faça retentativas controladas quando cabíveis.
- Concilie todos os registros ao final da recuperação.
Erros comuns
- Trocar de sistema e emitir de novo sem consultar a primeira tentativa.
- Dizer que o governo caiu apenas porque um download de PDF falhou.
Como o RoboFiscal ajuda
O RoboFiscal registra estados e referências para apoiar a recuperação. Em uma ocorrência de suporte, envie horário, ambiente e identificador da tentativa, preservando as credenciais.
Já tem conta e precisa de ajuda? Fale com o atendimento com os identificadores da operação e a mensagem recebida.
Consulte o estado da operação antes de repetir o envio. Para quem ainda escolhe um emissor, o cadastro permite iniciar a configuração do produto.
Perguntas relacionadas
O cliente recebeu e-mail, mas o painel demorou. Qual informação usar?
Confira a situação atual da nota e sua chave. Evidências de entrega e estado fiscal precisam ser conciliadas.
Posso garantir ao cliente um horário de autorização?
O prazo depende também do ambiente autorizador. Informe a situação observada e acompanhe a operação.
Continue lendo
Revisado em · Equipe RoboFiscal. Versão em texto