Validações de erros retornados pela API

Seguem abaixo as validações de erros retornados pela API, estes erros são validações necessárias que melhoram o desempenho de processamento dos documentos. Veja quais as melhores tomadas de decisão para cada tipo de erro.

Erros retornados na emissão e consulta de status de processamento da API de NFe:

Erro Retornado	Motivo/Causa do erro	Possível Solução	Link da documentação:
{“status”:-2,”motivo”:”Nao foi possivel carregar o status da NF-e”,”erro”:{“cStat”:996,”xMotivo”:”Documento ainda nao processado, por favor realize a consulta novamente”}}	Por alguma lentidão da sefaz o documento ainda não tem o retorno de sucesso ou rejeição.	Aguardar alguns segundos e refazer a consulta de status de processamento.	https://documentacao.nstecnologia.com.br/docs/ns-nfe/emissao-de-nfe/status-de-processamento/
{“status”:-2,”motivo”:”NFe invalido de acordo com a validacao contra schema”,”erros”:[“O campo ‘fone’ foi preenchido incorretamente com o valor ‘ ‘. Este campo deve ser preenchido com numeros e conter no minimo 6 e no maximo 14 caracteres.”]}	Erro retornado devido a algum campo com problema na estrutura do JSON/XML, a tag erros: informa qual é o campo com problema.	Ajustar o erro e reprocessar o documento	É importante baixar o manual de layout da sefaz e verificar os campos do JSON/XML, link: https://dfe-portal.svrs.rs.gov.br/Nfe/Documentos
{“status”:-2,”motivo”:”Nao foi possivel carregar o status da NF-e”,”erro”:{“cStat”:996,”xMotivo”:”Transport error: 504 Error: Gateway Time-out”}}	Erro causado por instabilidade da sefaz	Reenviar o JSON/XML completo para ser processado novamente com os mesmos dados do documento anterior.	https://documentacao.nstecnologia.com.br/docs/ns-nfe/emissao-de-nfe/emissao/
{“status”:-3,”motivo”:”Nao foi possivel realizar a operacao”,”erro”:{“cStat”:899,”xMotivo”:”Dados da Licenca nao Localizada com os parametros informados”}}
{“status”:-3,”motivo”:”Chave de acesso inválida: “}
{“status”:-3,”motivo”:”Nao foi possivel cancelar a NF-e”,”erro”:{“cStat”:997,”xMotivo”:”Evento já Processado Anteriomente e Autorizado”}}
{“status”:-4,”motivo”:”Erro ao carregar os dados enviados: br.eti.ns.nfecommons.xml.nfeproc.TNFe cannot be cast to br.eti.ns.nfecommons.xml.nfeproc.TNfeProc”}
{“status”:-5,”motivo”:”Nao foi possivel carregar o evento”,”erro”:{“cStat”:997,”xMotivo”:”Evento Nao Localizado”}}
{“status”:-5,”motivo”:”Erro ao enviar a NF-e para Sefaz”,”erro”:{“cStat”:897,”xMotivo”:”Certificado Digital do emitente vencido, realize a atualização no painel”}}
{“status”:-6,”motivo”:”Documento já Recebido, porem ainda sem status de processamento, por favor consulte o status de processamento do NSNRec informado”,”nsNRec”:” “}
{“status”:-6,”motivo”:”Nao foi possivel realizar a operacao”,”erro”:{“cStat”:899,”xMotivo”:”Dados da Licenca nao Localizada com os parametros informados”}}
{“status”:-7,”motivo”:”Documento já Processado anteriormente e Autorizado/Denegado”,”nsNRec”:” “}
{“status”:-14,”motivo”:”Data de emissão excede o limite retroativo de 30 dias”}
{“status”:-400,”motivo”:”Requisicao realizada com conteudo invalido. O parse do conteudo gerou a seguinte excecao: Error decoding json body: com.fasterxml.jackson.core.JsonParseException: Unexpected character (‘\\’ (code 92)): expected a valid value (JSON String, Number, Array, Object or token ‘null’, ‘true’ or ‘false’)\n at [Source: (akka.util.ByteIterator$ByteArrayIterator$$anon$1); line: 1, column: 57]”}
{“status”:-401,”motivo”:”Voce nao possui permissoes para gerenciar os documentos do CNPJ “}
{“status”:-403,”motivo”:”Não é possível realizar o download de documentos e eventos com mais de 3 meses de emissão”}
{“status”:-500,”motivo”:”Transport error: 504 Error: Gateway Time-out”}
{“status”:-999,”motivo”:”Erro interno ao processar a requisicao”,”erro”:{“cStat”:999,”xMotivo”:”Documento nao Localizado em nosso banco de dados ou não autorizado”}}
{“status”:-999,”motivo”:”Erro interno ao processar a requisicao”,”erro”:{“cStat”:999,”xMotivo”:”The request failed with HTTP status 503: Service Unavailable.”}}
{“status”:-999,”motivo”:”Erro interno ao processar a requisicao”,”erro”:{“cStat”:999,”xMotivo”:”An error occurred while updating the entries. See the inner exception for details.”}}
{“status”:-999,”motivo”:”Erro interno ao processar a requisicao”,”erro”:{“cStat”:999,”xMotivo”:”Licenca de Uso Bloqueada para Uso, favor verificar com a sua Software House”}}
{“status”:-999,”motivo”:”Erro interno ao processar a requisicao”,”erro”:{“cStat”:999,”xMotivo”:”The request was aborted: Could not create SSL/TLS secure channel.”}}

Erros retornados na emissão de eventos da API de NFe

Erro Retornado no Evento	Motivo/Causa do erro	Possível Solução	Link da documentação:
{“status”:-4,”motivo”:”Evento invalido de acordo com a validacao contra schema”,”erros”:[“O campo ‘xJust’ foi preenchido incorretamente com o valor ‘DIVERGENCIA EM QUANTIDADE ‘. Este campo deve ser preenchido com a justificativa, podendo conter entre 15 e 255 caracteres. Este campo e opcional.”]}
{“status”:-5,”motivo”:”Nao foi possivel carregar o evento”,”erro”:{“cStat”:997,”xMotivo”:”Evento Nao Localizado”}}