NFS-e Nacional: erro E999 e outros erros comuns

Quem pesquisa "nfse nacional erro não catalogado" quase sempre recebeu o E999 no Emissor Nacional ou na API e não achou o código em lugar nenhum. Ele realmente não está na lista oficial: o Anexo I do leiaute da NFS-e (versão 1.01, de 09/02/2026, publicado em gov.br/nfse) traz as regras de negócio com códigos como E0015, E0138 ou E1235, e o E999 não aparece ali. Na prática, isso indica uma falha que o sistema não conseguiu enquadrar numa regra conhecida. O caminho é tentar de novo depois de alguns minutos, guardar o XML e o horário, conferir os dados da nota pelas regras catalogadas abaixo e, se persistir, abrir chamado nos canais de atendimento da NFS-e. Os erros catalogados, esses sim, dizem exatamente o que corrigir.

Desde 01/01/2026, a Lei Complementar 214/2025 (art. 62, § 1º) obriga os municípios a autorizar a emissão da NFS-e de padrão nacional no ambiente nacional ou, se tiverem emissor próprio, a compartilhar as notas no ambiente de dados nacional. Muita empresa mudou de emissor no meio do ano e passou a ver mensagens novas. Abaixo estão os erros que mais travam o prestador pequeno, agrupados pela causa.

Como ler uma mensagem de erro da NFS-e Nacional

No Sistema Nacional NFS-e, o prestador envia uma DPS (Declaração de Prestação de Serviço); se ela passa nas regras, vira NFS-e. Cada regra tem código, efeito (rejeição) e mensagem. Os códigos seguem uma lógica aproximada:

Faixa	O que costuma indicar	Exemplo do Anexo I
E0001 a E0999	Regras de negócio da DPS: datas, município, prestador, tomador, regime	E0015: competência posterior à data de emissão
E1200 a E1209	Certificado digital de transmissão	E1203: certificado expirado
E1225 a E1242	Estrutura do arquivo (XML, compactação, esquema)	E1235: falha no esquema XML
E1500 em diante	Grupo de IBS e CBS (reforma tributária)	E1554: alíquota efetiva da CBS incorreta
E999 e mensagens sem código	Fora das regras catalogadas	Tentar de novo e registrar chamado

Mensagens como "erro 403" também não são regra de negócio da NFS-e: 403 é um código do protocolo HTTP para acesso negado pelo servidor. Quando aparece num emissor próprio integrado à API, o fornecedor do sistema precisa olhar a autenticação com o certificado e as permissões da integração.

Erros de certificado digital

Quem emite por sistema próprio ou integrado à API assina e transmite com certificado ICP-Brasil. O Anexo I lista as falhas de certificado logo na recepção:

Código	Mensagem resumida	O que fazer
E1200	Certificado de transmissão inválido	Usar certificado de pessoa jurídica ou física próprio para autenticação de cliente, não de autoridade certificadora
E1203	Certificado de transmissão expirado	Renovar o certificado
E1205	Erro na cadeia de certificação	Reinstalar a cadeia da certificadora
E1207	Certificado revogado	Emitir novo certificado
E1208	Certificado raiz diferente da ICP-Brasil	Usar certificado ICP-Brasil
E1209	Certificado sem CNPJ ou CPF	Conferir o tipo de certificado comprado

Se a dúvida é qual certificado comprar, o post sobre certificado A1 ou A3 resume as diferenças.

Erros de data de competência

A data de competência é o mês em que o serviço foi prestado. Ela causa vários erros porque o sistema cruza essa data com cadastros:

• E0015: a competência não pode ser posterior à data de emissão. Nota de serviço que ainda vai ser prestado não pode ter competência futura.
• E0016: a competência precisa ser igual ou posterior à data de ativação do convênio do município emissor (a regra não se aplica ao MEI).
• E0018 e E0020: a competência precisa ser igual ou posterior à data de inscrição do CNPJ ou do CPF do emitente. Empresa recém-aberta que tenta emitir com competência anterior à abertura cai aqui.
• E0023: com cadastro complementar ativo no município, a competência precisa respeitar a data do indicador municipal.

Erros de município e convênio

Código	Causa	Correção
E0037	Município emissor não existe no cadastro de convênios do sistema nacional	Confirmar se o município aderiu; se tem emissor próprio, emitir por ele
E0038	Convênio do município não está "ATIVO"	Consultar a prefeitura sobre a situação do convênio
E0039	Município não parametrizado para usar os emissores públicos nacionais	Usar o emissor indicado pela prefeitura
E0041	MEI emitindo com município diferente do endereço no CNPJ	Atualizar o endereço do CNPJ ou corrigir o município emissor

As regras E0037, E0038 e E0039 não se aplicam ao MEI, que emite pelo ambiente nacional. O passo a passo para o microempreendedor está no post sobre NFS-e do MEI no Emissor Nacional.

Erros de CEP, prestador e tomador

• E0138: o CEP do prestador não existe ou não pertence ao município informado. Acontece muito quando o CEP do cadastro está desatualizado ou é um CEP geral da cidade.
• E0190 e E0207: CNPJ ou CPF do tomador não encontrado no cadastro na data de competência. Confira dígitos e se o CNPJ do cliente estava aberto naquela data.
• E0202: prestador e tomador com o mesmo CNPJ.
• E0204: retenção de ISS marcada sem identificar o tomador por CNPJ ou CPF. O post sobre retenção de ISS pelo tomador explica quando ela existe.
• E0235: tomador com CNPJ sem endereço nacional preenchido.

Erros de regime tributário e valores

Código	Causa	Correção
E0162	Regime de apuração do Simples preenchido para não optante ou MEI	Deixar o campo em branco
E0166	Optante ME/EPP sem o regime de apuração do Simples preenchido	Preencher o campo
E0175	Optante ME/EPP apurando pelo Simples com regime especial diferente de "Nenhum"	Marcar "Nenhum"
E1300	Alíquota aplicada acima de 5%	Rever a alíquota de ISS
E1302	MEI informando campos de valores além do valor líquido	Retirar os campos extras

Exemplo da Redação Beevix (2026): uma empresa cuja prefeitura tem emissor próprio gera uma NFS-e de R$ 2.000,00 com alíquota de ISS de 3%, e a nota é compartilhada com o ambiente nacional. O ISS informado precisa ser R$ 60,00, porque a regra confere o valor como base de cálculo × alíquota (2.000 × 0,03 = 60). Um valor digitado à mão como R$ 61,00 cai no erro E1289.

Os erros novos do grupo IBS e CBS

Com a reforma tributária, a DPS ganhou o grupo de IBS e CBS, e o Anexo I passou a conferir percentuais com a calculadora oficial, com margem de R$ 0,01. Erros como E1554 (alíquota efetiva da CBS incorreta) e E1549 (alíquota efetiva do IBS municipal incorreta) indicam que o valor informado não bate com o que a calculadora devolve para o cClassTrib escolhido. O ajuste começa pela classificação, que o contador define, e não pela alíquota digitada.

Roteiro quando a nota não sai

1. Anote o código e a mensagem completos, com data e hora.
2. Procure o código no Anexo I da documentação técnica em gov.br/nfse. Se estiver lá, a regra diz o que corrigir.
3. Se for E999 ou mensagem sem código, espere alguns minutos e tente de novo. Não emita a mesma nota duas vezes sem antes consultar se a primeira foi gerada.
4. Confira o cadastro: CEP, município, regime, datas de abertura.
5. Persistindo, abra chamado nos canais de atendimento do portal da NFS-e e avise o cliente que a nota sai assim que o sistema responder.

Erro catalogado é instrução de correção; erro sem catálogo é sinal para registrar e esperar, não para mudar dados da nota no escuro. Equipe Beevix, redação de 07/10/2026.

Fontes oficiais

• NFS-e Nacional, documentação técnica atual: Anexo I (leiaute e regras de negócio da DPS/NFS-e), versão 1.01 de 09/02/2026, consultado em 07/10/2026.
• NFS-e Nacional, documentação da reforma tributária (Nota Técnica SE/CGNFS-e nº 009 v1.01 e Anexo VI), consultado em 07/10/2026.
• Lei Complementar nº 214/2025, art. 62, Planalto, consultado em 07/10/2026.
• NFS-e Nacional, canais de atendimento, consultado em 07/10/2026.

Perguntas frequentes

O que significa o erro E999 na NFS-e Nacional?

É um erro não catalogado: o código não está entre as regras do Anexo I do leiaute. Tente de novo após alguns minutos, confira se a nota não foi gerada e, se persistir, registre chamado nos canais da NFS-e.

Onde encontro a lista oficial de erros da NFS-e Nacional?

No Anexo I da documentação técnica atual, em gov.br/nfse, nas abas de regras de recepção e de regras de negócio da DPS e da NFS-e. Cada regra traz código, mensagem e campo envolvido.

Como resolver o erro de CEP na NFS-e Nacional?

O E0138 indica CEP inexistente ou de outro município. Corrija o CEP do endereço do prestador para um CEP válido do município informado; se o erro vier do cadastro do CNPJ, atualize o cadastro.

Por que a NFS-e diz que a data de competência é inválida?

A competência não pode ser posterior à emissão (E0015) nem anterior à abertura do CNPJ (E0018) ou à ativação do convênio do município (E0016). Ajuste para o mês em que o serviço foi prestado.

O erro 403 é da prefeitura ou do meu sistema?

403 é um código HTTP de acesso negado, não uma regra de negócio da NFS-e. Em integrações por API, o fornecedor do sistema deve revisar o certificado usado na conexão e as permissões de acesso.

Próximo passo

Salve o link do Anexo I e confira hoje o cadastro do seu CNPJ: endereço, CEP e regime. Para entender o emissor e o calendário, leia sobre a NFS-e Nacional no Simples, veja como emitir NFS-e de padrão nacional e a página de NFS-e do Beevix. Depois, conheça os planos do Beevix, fale com um especialista e veja os segmentos atendidos.