> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://esimples.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Principais erros da SEFAZ no é-Xml e como resolver

Ao utilizar o módulo **é-Xml** para capturar notas fiscais direto da SEFAZ, alguns erros podem aparecer. Isso é comum porque a consulta depende das regras da própria SEFAZ e de fatores externos, como internet ou certificado digital.

Por isso, reunimos abaixo os erros mais frequentes e como você pode resolver cada um deles na prática.

## Tabela de Erros Comuns da SEFAZ no é-Xml

| **Mensagem da SEFAZ** | **O que significa** | **Como corrigir** |
| ---- |
| **Consumo Indevido** | Tentativa de consulta feita antes do intervalo de 1 hora. | Aguarde **1 hora completa** entre consultas. Se o certificado A1 for usado em outro sistema, pode estar interferindo. |
| **Nenhum arquivo válido foi encontrado** | O arquivo importado está corrompido ou não é do tipo aceito (NFC-e, NFe ou CFe SAT). | Aguarde a próxima consulta para verificar se a SEFAZ vai disponibilizar o arquivo válido. |
| **Certificado Inválido** | O certificado digital está vencido, revogado ou não pertence ao CNPJ consultado. | Verifique se o certificado A1 é válido, atualizado e corresponde ao mesmo CNPJ cadastrado. |
| **Sem documentos disponíveis** | Não existem novas notas desde a última consulta. | Aguarde novas emissões. Tente novamente após 1 hora. |
| **Erro de comunicação com a SEFAZ** | Instabilidade nos servidores da SEFAZ ou problemas de internet. | Confira sua conexão. Se o problema for na SEFAZ, aguarde a normalização. |
| **Rejeição de protocolo de cancelamento** | O XML de cancelamento da nota não foi importado. | Baixe também os protocolos de cancelamento, assim o sistema consegue desconsiderar as notas canceladas. |
| **Erro 999 – Serviço indisponível** | A SEFAZ suspendeu temporariamente o serviço de distribuição. | Espere alguns minutos ou horas até o serviço ser restabelecido. |

## Dicas extras para evitar erros
* Sempre mantenha o **certificado digital atualizado**.
* Programe as consultas para horários regulares, evitando excesso de requisições.
* Sempre importe também os **protocolos de cancelamento**.
* Se aparecer erro repetido por mais de 24h, entre em contato com o suporte.