Erro não catalogado pela SEFAZ: leia o xMotivo e tente novamente

A rejeição 999 é o código "pega-tudo" da SEFAZ: ela aparece quando o webservice encontra uma exceção interna não prevista no catálogo de erros. A causa real vem no campo xMotivo da resposta. Na maioria dos casos o problema é transitório ou está do lado da SEFAZ. A ação imediata é ler o xMotivo, aguardar alguns minutos e retransmitir.

O que significa esta rejeição

Ao contrário das demais rejeições, o código 999 não descreve uma regra de validação específica do XML. Ele é devolvido quando o processamento interno do webservice lança uma exceção não mapeada: um erro de infraestrutura, uma falha momentânea de serviço, uma inconsistência no processamento que não corresponde a nenhum dos outros códigos da tabela 4.4.2 do MOC.

A informação real sobre o que ocorreu fica no campo xMotivo da resposta (<retNFe><infRec><xMotivo> ou <retConsNFe><infProt><xMotivo>). Esse texto varia: pode ser uma mensagem de timeout interno, uma falha de banco de dados da SEFAZ, um erro de schema em uma parte do processamento não coberta por outros códigos, ou qualquer outra condição excepcional. Sem ler o xMotivo, não é possível diagnosticar a causa.

Causas mais comuns

• Instabilidade momentânea no webservice da SEFAZ ou na infraestrutura de rede entre o emissor e o autorizador.
• Sobrecarga nos servidores da SEFAZ em horários de pico, causando timeout interno que é retornado como 999.
• Falha transitória na consulta a serviços internos da SEFAZ durante o processamento do lote.
• Problema específico no conteúdo do XML que não é coberto por nenhuma regra de validação catalogada, mas ainda assim impede o processamento.
• Manutenção ou atualização nos sistemas da SEFAZ sem aviso prévio, retornando exceção durante a janela de transição.

Regra de validação oficial

O Anexo I do MOC reserva o código 999 para erros de exceção não catalogados. A SEFAZ o utiliza como fallback quando o processamento falha de forma inesperada. O campo xMotivo da resposta contém a descrição do erro capturado, que é a única fonte de informação disponível para diagnóstico.

Exemplo XML, antes (erro retornado pela SEFAZ)

<!-- Resposta da SEFAZ com rejeição 999 -->
<retNFe versao="4.00">
  <tpAmb>1</tpAmb>
  <verAplic>RS20250601</verAplic>
  <cStat>999</cStat>
  <xMotivo>Erro interno no processamento: NullPointerException ao acessar tabela de parametros</xMotivo>
  <cUF>43</cUF>
  <dhRecbto>2026-05-24T14:32:10-03:00</dhRecbto>
</retNFe>

(o xMotivo descreve o erro real; o XML enviado pode estar correto)

Exemplo XML, depois (correto)

<!-- Mesma NF-e retransmitida minutos depois; SEFAZ retorna autorização -->
<retNFe versao="4.00">
  <tpAmb>1</tpAmb>
  <verAplic>RS20250601</verAplic>
  <cStat>104</cStat>
  <xMotivo>Lote processado</xMotivo>
  <cUF>43</cUF>
  <dhRecbto>2026-05-24T14:38:05-03:00</dhRecbto>
</retNFe>

(retransmissão após alguns minutos resultou em lote processado normalmente)

Passo a passo para corrigir

1. Leia com atenção o conteúdo do campo xMotivo retornado pela SEFAZ. Ele é a única pista disponível sobre o que ocorreu.
2. Se o xMotivo indicar falha de infraestrutura, timeout ou erro interno sem relação com o conteúdo do XML, aguarde de 5 a 15 minutos e retransmita o mesmo lote.
3. Se o xMotivo mencionar algum campo ou estrutura específica do XML, revise esse ponto no documento antes de reenviar.
4. Consulte o portal da SEFAZ da UF ou o painel de status do autorizador para verificar se há manutenção em andamento.
5. Se a rejeição persistir após múltiplas tentativas e o xMotivo não for suficiente para diagnóstico, acione o suporte do sistema emissor com o XML completo e a resposta da SEFAZ.

Como o FazendaNota previne

A rejeição 999 costuma ser transitória e está do lado da SEFAZ, não do XML enviado. Quando a plataforma recebe esse código, exibe o xMotivo retornado para que você identifique o contexto do erro, reapresenta o lote automaticamente após o intervalo recomendado e registra a tentativa no histórico da nota. Se o problema persistir, a plataforma orienta a acionar o suporte com as informações do erro para diagnóstico.

Rejeições relacionadas

• Rejeição 215, Falha no schema XML
• Rejeição 225, Rejeição de Lote em processamento

Referência oficial

Esta rejeição está descrita no Anexo I - Leiaute e Regra de Validação do Manual de Orientação do Contribuinte (MOC) v7.0 da NF-e, publicado pelo CONFAZ. Texto integral em https://www.confaz.fazenda.gov.br/legislacao/arquivo-manuais/moc7-visao-geral.pdf