Rejeição 999: investigue o erro não catalogado pelo serviço correto

O código 999 informa um erro não catalogado. Ele não aponta, sozinho, um campo fiscal a corrigir nem comprova indisponibilidade geral da SEFAZ. O diagnóstico depende da mensagem completa, do serviço chamado e do resultado efetivamente recebido. Antes de repetir uma operação, preserve o retorno e verifique sua situação atual, especialmente quando a tentativa pode emitir uma nota ou alterar um CSC.

O MOC recomenda que xMotivo contenha a mensagem do aplicativo ou sistema que gerou a exceção não prevista. Assim, o texto que acompanha o número pode ser a principal pista disponível. Não descarte esse complemento ao abrir um chamado: “erro 999” é informação insuficiente para distinguir falha de processamento, inconsistência de dados ou problema específico de uma integração.

Descubra onde o retorno foi produzido

Registre o serviço, a operação, o ambiente, o horário, a UF ou órgão envolvido, a versão da aplicação e o conteúdo integral da resposta. Identifique se o 999 está no retorno principal ou dentro do resultado de uma nota específica. Um lote processado não significa que cada documento tenha sido autorizado. Da mesma forma, um código exibido pela interface precisa ser relacionado ao retorno original, quando disponível.

Separe uma rejeição fiscal de uma falha HTTP, de comunicação ou de montagem local. Elas podem aparecer próximas na experiência do usuário, mas exigem evidências diferentes. Se houve resposta estruturada com cStat=999, preserve-a. Se o sistema não recebeu resposta, registre essa ausência sem convertê-la em um retorno fiscal que não foi observado.

Não transporte automaticamente instruções de NFS-e, CT-e ou outro documento para NF-e. Nomes parecidos, inclusive “erro não catalogado”, não tornam seus serviços, protocolos ou canais de suporte equivalentes. Neste artigo, os contextos documentados incluem autorização de NF-e/NFC-e, distribuição de DF-e de interesse e administração do CSC da NFC-e.

Quando ocorreu durante uma emissão

Consulte a situação da chave antes de decidir sobre retransmissão ou nova emissão. Uma interrupção posterior ao envio pode deixar o resultado local incompleto. Se houver autorização confirmada, a providência é recuperar e conciliar o resultado correspondente, em vez de gerar outra nota para a mesma operação. Se houver rejeição confirmada, analise seu motivo e o documento enviado.

Verifique o status oficial do autorizador e comunicados referentes ao período e ao ambiente utilizados. Um indicador de disponibilidade é contexto, não comprovação da causa daquela nota. Compare também se o erro atinge várias operações ou somente um documento específico. A repetição em apenas um arquivo pode orientar a investigação de dados ou de geração, sem demonstrar antecipadamente qual campo está errado.

Caso o complemento identifique uma inconsistência, confira o campo e a regra aplicável com o suporte e o responsável fiscal. Não remova grupos opcionais indiscriminadamente, não altere impostos por tentativa e não escolha outro destinatário para testar autorização. Um XML validado estruturalmente também pode falhar em regras de negócio; a validação de schema não certifica aceitação fiscal.

Quando ocorreu na distribuição de DF-e

A NT 2014.002 v1.40 também lista 999 no serviço NFeDistribuicaoDFe. Nesse contexto, o resultado trata da consulta ou distribuição de documentos de interesse. Ele não indica, por si só, que uma nota deixou de ser autorizada, que foi cancelada ou que não existe no ambiente emissor. Não emita outro documento para resolver uma falha de download.

Guarde o tipo de consulta, o interessado, o ambiente e os NSUs envolvidos, com dados sensíveis protegidos. Preserve o último estado consistente do controle de distribuição. Não zere o cursor nem incremente o NSU arbitrariamente para escapar do erro: isso pode prejudicar a continuidade da busca e a identificação do que foi efetivamente recebido.

A própria NT diferencia retorno sem documentos, documentos localizados e consumo indevido. Os intervalos de uma hora estabelecidos para determinadas situações de 137 ou 656 não devem ser apresentados como uma regra universal do 999. Respeite o retorno concreto e o procedimento aplicável. Consultas em sequência, sem controle, podem produzir uma nova ocorrência de consumo indevido em vez de esclarecer a falha original.

Quando ocorreu na administração do CSC

A NT NFC-e 2014.001 relaciona 999 aos resultados do serviço de manutenção do CSC. Identifique se o pedido era consulta, criação ou revogação. Uma resposta genérica não deve ser tratada como confirmação de CSC criado ou revogado. Confira os códigos ativos pelo canal oficial disponível antes de repetir uma operação administrativa cujo resultado permaneceu incerto.

Essa precaução é diferente de consultar uma chave de NFC-e. O estado de um CSC não demonstra o estado fiscal de uma venda. Também não se deve gerar ou revogar códigos apenas para testar se o serviço voltou. A disponibilidade do Web Service e o procedimento de acesso precisam ser confirmados na UF; a especificação histórica não comprova implantação individual.

Reúna evidências para uma correção verificável

Encaminhe ao suporte o pedido e a resposta pertinentes, o horário, o ambiente, a versão e a sequência das tentativas. Proteja certificado, senha, segredo CSC e dados pessoais. Se o problema estiver na geração, corrija a origem e compare o arquivo regenerado. Se houver indisponibilidade confirmada, acompanhe a normalização e realize a próxima tentativa de maneira controlada, conforme o serviço utilizado.

Retentativas automáticas anunciadas por outro fornecedor não comprovam comportamento equivalente no ALRA. Contingência também exige análise do modelo, da operação e das condições próprias; o número 999 não é autorização automática para ativá-la. Termine a investigação com o retorno individual, o protocolo quando cabível e a conciliação do estado local. Não houve emissão, consulta privada ou alteração administrativa executada nesta revisão documental.

Fontes

• MOC 7.0, Anexo I, página 153: código 999 e recomendação para xMotivo.

• Portal Nacional: NT 2014.002 v1.40, páginas 3–4 e 14–16; NT NFC-e 2014.001, páginas 3–9.

• Oobj: artigo específico da 999, corpo técnico HTTP consultado; frequência alegada e retentativa própria não generalizadas.

• TOTVS: artigo Linha RM sobre a 999, corpo WEB consultado; referências de NFS-e separadas da NF-e.

• NFeLink: artigo específico, confrontado com a necessidade de investigar o complemento e o estado real da operação.

Documentos oficiais citados: NT 2014.002 v1.40, NT NFC-e 2014.001, MOC 7.0, Anexo I.