O que você vai ver neste post:
- Por que a nota trava no Portal Nacional mesmo com o preenchimento aparentemente certo
- As 12 mensagens de erro mais comuns, a causa real de cada uma e o passo a passo para resolver
- Como validar município, CNAE, código de serviço e alíquota de ISS antes de transmitir
A nota não sai, o portal devolve um código que ninguém entende e o cliente cobra o documento no mesmo dia. Os erros no Emissor Nacional NFS-e travam o faturamento de prestadores de serviço todos os meses, e quase sempre a culpa não está na nota: está em um detalhe de cadastro, de habilitação municipal ou de compatibilidade do sistema com a API federal.
O Brasil tem 5.570 municípios, segundo o IBGE, e cada um define a própria alíquota de ISS, a própria lista de atividades habilitadas e o próprio momento de migrar para o Padrão Nacional. É essa colcha de retalhos que transforma uma emissão simples em mensagem de rejeição.
Abaixo você encontra as 12 rejeições mais frequentes do Portal Nacional (nfse.gov.br), agrupadas por origem, com a causa real e a correção de cada uma. Comece pelo grupo que corresponde ao seu código de erro.
Tópicos neste artigo:
- Por que o Emissor Nacional NFS-e apresenta erros
- Erros de município e CNAE no Emissor Nacional NFS-e
- Erros de ISS e código de serviço na NFS-e nacional
- Erros de acesso e transmissão no Portal Nacional
- Como evitar erros no Emissor Nacional NFS-e
- Emita NFS-e no Padrão Nacional sem erro de compatibilidade
- Perguntas Frequentes
Por que o Emissor Nacional NFS-e apresenta erros
Antes de corrigir a mensagem, entenda de onde ela vem. O Padrão Nacional da NFS-e não é um portal isolado: é um Ambiente de Dados Nacional (ADN), a base federal que recebe, valida e devolve os documentos fiscais de serviço, e que consulta o cadastro de cada prefeitura antes de autorizar a nota.
Na prática, isso significa que a rejeição pode nascer em três lugares diferentes. Saber qual deles falhou economiza horas de tentativa e erro.
O que muda no fluxo de emissão do Padrão Nacional
No modelo nacional você não envia a nota pronta. Você envia uma DPS (Declaração de Prestação de Serviços), um arquivo XML com os dados do serviço, e o ADN é que gera a NFS-e, assina e devolve a chave de acesso.
Essa inversão é a origem de boa parte das rejeições. O portal valida o cadastro no momento da transmissão, então um dado desatualizado na prefeitura derruba a nota mesmo que o preenchimento na sua tela esteja perfeito.
As três origens de erro: cadastro, habilitação e integração
- Cadastro: dado errado no documento (código IBGE, CEP, CNPJ do tomador, data de competência)
- Habilitação: o município, o CNAE ou a alíquota não estão liberados para aquela operação
- Integração: o sistema emissor fala com a API antiga da prefeitura, não com a API federal
Erros de cadastro você resolve sozinho em minutos. Erros de habilitação dependem da prefeitura. Erros de integração dependem do fornecedor do seu sistema.
Como ler o código de erro antes de mexer em qualquer campo
O Portal Nacional devolve um código numérico junto com a descrição. Copie os dois e localize o grupo correspondente na tabela abaixo, porque a mesma frase ("dado inválido") aparece em contextos completamente diferentes.
| Mensagem do portal | Origem | Quem resolve |
|---|---|---|
| Município não habilitado | Habilitação | Prefeitura |
| CNAE não autorizado | Habilitação | Prefeitura |
| Alíquota de ISS inválida | Habilitação | Prefeitura |
| Código de serviço inválido | Cadastro | Você |
| CEP ou endereço não encontrado | Cadastro | Você |
| Data de competência inválida | Cadastro | Você |
| Autenticação Gov.br inválida | Acesso | Você |
| Timeout ou serviço indisponível | Integração | Portal ou fornecedor |
Com o grupo identificado, vá direto à seção correspondente.
Cansado de descobrir a rejeição só depois de transmitir a nota? Emitir NFS-e com validação prévia
Erros de município e CNAE no Emissor Nacional NFS-e
Este é o grupo que mais aparece. As mensagens envolvem o código do município, a adesão da prefeitura ao convênio e a atividade econômica cadastrada no CNPJ.
Confira as três variações e o que fazer em cada uma.
Erro 1 e 2: "Município não habilitado" e "Município não encontrado"
Causa: a prefeitura do prestador ainda não aderiu ao Padrão Nacional, ou o código IBGE informado está incorreto.
- Consulte a situação da cidade no painel de adesão em nfse.gov.br. Se a prefeitura não constar como aderente, a emissão continua no portal próprio dela
- Confirme o código IBGE do município, que tem 7 dígitos. Não confunda com o código de endereçamento postal (CEP), de 8 dígitos
- Se a adesão é recente e o erro persiste, aguarde até 24 horas: a carga do cadastro municipal no ADN pode ter atraso
Erro 3: "CNAE não autorizado" ou "Atividade não permitida"
Causa: a atividade econômica da empresa não está liberada para emitir NFS-e naquele município, ou o cadastro municipal está incompleto.
- Acesse o portal da prefeitura e confirme se o CNAE principal e os secundários estão habilitados para emissão
- Verifique se a inscrição municipal está ativa. Empresa sem inscrição municipal não emite NFS-e, mesmo com CNPJ regular
- Se a atividade não estiver na lista, solicite a inclusão na prefeitura antes de tentar emitir novamente
Erro 4: "CNPJ não habilitado para emissão de NFS-e"
Causa: situação cadastral irregular na Receita Federal ou ausência de habilitação no Portal Nacional.
Faça login em nfse.gov.br e confira se o CNPJ aparece como habilitado. CNPJ inapto, suspenso ou baixado não emite. Regularize a situação cadastral primeiro e depois solicite a habilitação na prefeitura da sede.
Resolvido o cadastro da empresa, o próximo bloqueio costuma ser o imposto.
Quer parar de conferir CNAE e código IBGE em três telas diferentes a cada nota? Testar o emissor de NFS-e do Simplifique
Erros de ISS e código de serviço na NFS-e nacional
Aqui está a confusão mais silenciosa do Padrão Nacional: muita gente informa o CNAE onde o portal espera o código da lista de serviços. São duas classificações diferentes, com finalidades diferentes.
Entenda cada rejeição a seguir.
Erro 5: "Código de serviço inválido"
Causa: foi informado o CNAE, e não o item da Lista de Serviços da Lei Complementar 116/2003, que é a referência nacional do ISS.
Na prática, o CNAE descreve a atividade da empresa na Receita Federal; o código da LC 116 descreve o serviço prestado naquela nota específica. Faça o mapeamento uma única vez para cada serviço que você vende e reaproveite.
Erro 6: "Alíquota de ISS inválida" ou "Alíquota não cadastrada"
Causa: a alíquota informada não corresponde à tabela do município para aquele item de serviço, ou a prefeitura ainda não carregou as alíquotas no ADN.
- Consulte o Código Tributário do município para o item de serviço utilizado
- Se a adesão da prefeitura é recente, a carga das alíquotas pode estar pendente. Registre um protocolo na prefeitura
- Confira se o serviço é tributado no município do prestador ou no do tomador. A LC 116/2003 lista exceções em que o ISS é devido no destino
Erro 7: "Retenção de ISS divergente" ou regime tributário incompatível
Causa: a nota marca ISS retido pelo tomador quando a legislação municipal não prevê a retenção para aquele item, ou o regime informado (Simples Nacional, MEI, lucro presumido) não bate com o cadastro.
- Empresa no Simples Nacional recolhe o ISS dentro do DAS. Marcar retenção indevida gera divergência
- O MEI tem ISS fixo no DAS-MEI e, em regra, não sofre retenção
- Profissional liberal em município com ISS por estimativa precisa do regime especial cadastrado antes de emitir
Com imposto e serviço corretos, sobram os erros de acesso e de rede.
Erros de acesso e transmissão no Portal Nacional
Estas rejeições não têm relação com o conteúdo da nota. Elas acontecem antes ou durante o envio, e o sintoma clássico é o documento que "desaparece" sem virar NFS-e.
Veja as quatro situações mais comuns.
Erro 8: "Autenticação Gov.br inválida" ou "Sessão expirada"
Causa: nível de conta insuficiente ou token de sessão vencido durante o preenchimento.
- A emissão no Portal Nacional exige conta Gov.br nível Prata ou Ouro. Conta Bronze não tem acesso completo
- Eleve o nível pelo aplicativo Gov.br, com biometria, validação bancária, CNH ou certificado digital
- Em notas longas, salve o rascunho antes de autenticar novamente
Erro 9: "Certificado digital inválido" na integração por API
Causa: certificado e-CNPJ vencido, cadeia de certificação desatualizada ou credencial de integração revogada.
Confira a validade do certificado (o modelo A1 vale 1 ano) e renove as credenciais no seu sistema emissor. Certificado válido no navegador pode estar ausente no servidor que transmite a DPS.
Erro 10 e 11: "CEP inválido" e "Endereço não encontrado"
Causa: a consulta automática de CEP não retorna dados, ou o tomador pessoa física tem endereço incompleto.
- Valide o CEP no site dos Correios antes de preencher
- Para tomador pessoa física sem endereço completo, informe apenas município e UF
- Se o CEP é válido e o portal recusa, desative o preenchimento automático e digite o endereço campo por campo
Erro 12: "Timeout" ou "Serviço indisponível"
Causa: instabilidade do ADN ou fila de processamento no horário de pico.
Aguarde alguns minutos e repita a transmissão. Os picos se concentram nos últimos dias do mês e nas datas de fechamento de contrato. Antes de reenviar, consulte a nota pela chave de acesso: em muitos casos a NFS-e foi autorizada e só o retorno se perdeu, e um reenvio cria documento duplicado.
Identificado o padrão dos seus erros, o passo seguinte é impedir que eles voltem.
Como evitar erros no Emissor Nacional NFS-e
Corrigir rejeição é retrabalho. Evitar rejeição é processo. As três rotinas abaixo eliminam a maioria dos bloqueios antes da transmissão.
Adote uma por vez, começando pelo checklist.
Checklist de 6 itens antes de transmitir
- Inscrição municipal ativa e CNAE habilitado no município
- Código IBGE de 7 dígitos correto para prestador e tomador
- Item da LC 116/2003 mapeado para o serviço, e não o CNAE
- Alíquota de ISS conferida na tabela do município, entre 2% e 5%
- Data de competência dentro do período permitido pela prefeitura
- Certificado digital e conta Gov.br válidos, com nível Prata ou Ouro
Validação prévia: por que checar antes vale mais que corrigir depois
Um sistema que valida os dados antes de montar a DPS transforma a rejeição do portal em aviso na sua tela. Você corrige o campo na hora, sem consumir tentativa de transmissão e sem risco de nota duplicada.
Na prática, é a diferença entre descobrir o erro em dois segundos e descobrir depois que o cliente ligou cobrando o documento.
Cancelamento e substituição sem gerar novo erro
Quando a nota sai errada, resista ao impulso de emitir outra por cima. Cancele dentro do prazo municipal ou emita a substituição vinculada à chave de acesso original. Duas notas ativas para o mesmo serviço geram divergência na apuração do ISS e cobrança em duplicidade.
Com o processo redondo, falta só o sistema acompanhar.
Emita NFS-e no Padrão Nacional sem erro de compatibilidade
A maior parte das rejeições que você acabou de ver tem a mesma raiz: o sistema descobre o problema tarde, quando o portal já respondeu. O Simplifique inverte essa ordem.
O que o emissor de NFS-e do Simplifique valida antes de transmitir
- Integração direta com o Portal Nacional, sem depender da API antiga de cada prefeitura
- Validação de município, CNAE, item da LC 116 e alíquota de ISS antes de montar a DPS
- Mensagem de erro em português claro, apontando o campo a corrigir em vez do código técnico da API
- Cobertura em centenas de municípios, com atualização acompanhando as novas adesões ao convênio
- Emissão de NF-e, NFS-e, CT-e e MDF-e na mesma plataforma, com integração contábil
Para quem faz volume de notas todos os meses
Se você emite dezenas ou centenas de NFS-e por mês, cada rejeição custa tempo de alguém. Mais de 8 mil empresas já usam o Simplifique para centralizar a emissão fiscal e reduzir esse retrabalho, com suporte especializado quando a dúvida é de legislação municipal.
O teste é gratuito e você emite suas primeiras notas no Padrão Nacional sem instalar nada.
Começar o teste grátis do emissor de NFS-e
Perguntas Frequentes
Quais são os erros mais comuns no Emissor Nacional NFS-e?
Os mais frequentes são município não habilitado, código IBGE incorreto, CNAE não autorizado, código de serviço da LC 116/2003 trocado pelo CNAE, alíquota de ISS fora da tabela municipal, autenticação Gov.br inválida, CEP não encontrado e timeout na transmissão. Todos aparecem com código numérico e descrição no retorno do portal.
Por que meu sistema parou de emitir NFS-e depois que o município migrou?
Porque a API antiga da prefeitura foi desativada quando ela aderiu ao Padrão Nacional. O sistema emissor precisa estar integrado ao Portal Nacional (nfse.gov.br) para continuar transmitindo. Fale com o fornecedor e confirme se existe versão compatível com o ADN.
Como resolver o erro de município não habilitado na NFS-e?
Confirme no painel de adesão em nfse.gov.br se a prefeitura já aderiu ao convênio. Se não aderiu, a emissão continua no portal municipal. Se aderiu, revise o código IBGE de 7 dígitos e aguarde até 24 horas pela carga do cadastro no ambiente nacional.
Qual nível de conta Gov.br é necessário para emitir NFS-e?
É preciso conta nível Prata ou Ouro. A conta Bronze não libera o acesso completo ao Portal Nacional. Você eleva o nível pelo aplicativo Gov.br usando biometria, validação bancária, CNH ou certificado digital.
MEI consegue emitir NFS-e pelo Portal Nacional sem sistema emissor?
Sim. O MEI emite direto em nfse.gov.br ou pelo aplicativo NFS-e Mobile, com conta Gov.br nível Prata ou Ouro, sem custo pelo uso do portal. Para volume alto, integração com o financeiro ou emissão de outros documentos fiscais, um sistema como o Simplifique evita o preenchimento manual repetido.
O Simplifique valida os dados antes de enviar a NFS-e ao portal?
Sim. O Simplifique confere município, CNAE, item da LC 116/2003 e alíquota de ISS antes de montar a DPS, e exibe o campo a corrigir em linguagem clara. Isso reduz as rejeições que só apareceriam depois da transmissão ao Ambiente de Dados Nacional.