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

Testar o Simplifique gratuitamente

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.

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.

  1. 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
  2. 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
  3. 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.

  1. Acesse o portal da prefeitura e confirme se o CNAE principal e os secundários estão habilitados para emissão
  2. Verifique se a inscrição municipal está ativa. Empresa sem inscrição municipal não emite NFS-e, mesmo com CNPJ regular
  3. 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.

Atenção: a alíquota de ISS é limitada por lei federal a um mínimo de 2% (art. 8º-A da LC 116/2003, incluído pela LC 157/2016) e a um máximo de 5% (art. 8º, inciso II). Alíquota fora dessa faixa é rejeitada pelo portal, mesmo que conste em sistema interno.
  1. Consulte o Código Tributário do município para o item de serviço utilizado
  2. Se a adesão da prefeitura é recente, a carga das alíquotas pode estar pendente. Registre um protocolo na prefeitura
  3. 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.

  1. A emissão no Portal Nacional exige conta Gov.br nível Prata ou Ouro. Conta Bronze não tem acesso completo
  2. Eleve o nível pelo aplicativo Gov.br, com biometria, validação bancária, CNH ou certificado digital
  3. 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.

Atenção: o prazo de cancelamento da NFS-e é definido por cada município e costuma ser curto, em geral poucos dias após a emissão. Vencido o prazo, a correção deixa de ser cancelamento e passa a exigir substituição da nota conforme a legislação municipal. Confira o prazo da sua cidade antes de emitir em volume.

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

  1. Inscrição municipal ativa e CNAE habilitado no município
  2. Código IBGE de 7 dígitos correto para prestador e tomador
  3. Item da LC 116/2003 mapeado para o serviço, e não o CNAE
  4. Alíquota de ISS conferida na tabela do município, entre 2% e 5%
  5. Data de competência dentro do período permitido pela prefeitura
  6. 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.

Leia também

Conhecer o emissor de NFS-e do Simplifique