Erros na NFS-e Nacional: principais códigos, causas e como resolver

Erros de NBS, certificado, CEP, parametrização municipal, série da DPS, emissão retroativa e cancelamento têm causas diferentes. Este guia organiza os principais códigos da NFS-e Nacional e mostra onde procurar a correção.

Contador e desenvolvedor analisam erros da NFS-e Nacional relacionados a NBS, certificado, XML e parametrização
Os códigos de rejeição da NFS-e ajudam a identificar se o problema está no cadastro, no certificado, no XML, na NBS ou na parametrização municipal.

BRASÍLIA/DF — A expansão da NFS-e Nacional e a entrada das informações de IBS e CBS aumentaram também a quantidade de validações que podem interromper uma emissão. Um código de erro pode apontar para problemas completamente diferentes: NBS inválida, certificado digital incompatível, CEP divergente, série errada da DPS, município sem parametrização, data de competência fora da vigência, tentativa de alterar campos que não podem ser substituídos ou uso de uma estrutura antiga do XML.

O primeiro passo para resolver uma rejeição é justamente não tratar todos os erros como se fossem “falha do sistema”. O código retornado informa em qual camada o problema nasceu. Em alguns casos, o contribuinte consegue corrigir diretamente no Portal ou no ERP. Em outros, a solução depende da prefeitura, da Receita Federal, do Cadastro Nacional Complementar, do certificado digital ou de uma atualização da software house.

Este guia foi estruturado principalmente a partir do documento oficial “Perguntas e Respostas da NFS-e”, versão 1.1, de 22 de setembro de 2026, que reúne dúvidas de municípios, contribuintes e empresas de desenvolvimento. Como a documentação técnica continua evoluindo, também é necessário considerar as versões publicadas depois daquele material.

Simples Nacional 2027
Entenda as regras. Teste cenários. Documente a análise.
Por R$ 37,00, você recebe o e-book completo, o simulador HTML offline, o manual e a ferramenta de geração de relatório profissional.
Quero acessar o pacote completo por R$ 37,00

Em 1º de outubro de 2026, o Portal da NFS-e disponibilizou a Nota Técnica SE/CGNFS-e nº 009 versão 1.01, acompanhada do Anexo VI de Leiautes e Regras de Negócio na versão 1.04.01 e do Anexo VII de Indicadores da Operação na versão 1.03.00. Assim, quando a mensagem apresentada pelo sistema divergir de um anexo antigo, a conferência deve ser feita na documentação técnica vigente no momento da emissão.

Antes de corrigir: descubra em qual camada está o erro

Os códigos da NFS-e podem ser separados, de forma prática, em alguns grupos. Há erros cadastrais, como os relacionados ao CNC e ao CEP; erros de certificado e assinatura; erros de XML e schema; erros de parametrização municipal; erros ligados a datas e competências; erros de NBS e classificação; e erros de eventos como cancelamento e substituição.

Essa classificação economiza tempo. Um E0718, por exemplo, não deve ser tratado como problema de NBS. Um E0440 não se resolve trocando certificado. Um E0316 não é corrigido pela prefeitura criando um código próprio. Cada código aponta para um fluxo específico de diagnóstico.

Radar da Reforma Tributária

Receba as principais novidades da Reforma Tributária

Cadastre seu e-mail para acompanhar as mudanças mais importantes.

Antes de qualquer alteração, registre a mensagem completa, o código retornado, a competência da nota, o CNPJ/CPF do emitente, o município de incidência, o código de serviço, o canal utilizado — Portal Web, aplicativo ou API — e, em integrações, guarde o XML enviado e a resposta do autorizador.

Tabela rápida dos principais erros da NFS-e Nacional

Código Significado prático Causa mais comum Onde corrigir
E3351 Registro do CNC não pode ser alterado Cadastro já foi inativado Novo cadastro no CNC
E0240 CEP inválido CEP inexistente, desatualizado ou fora do formato RFB/CNC
E1309 / E0138 CEP não pertence ao município Divergência entre CEP e município Cadastro/RFB/CNC
E3313 CEP incompatível com código IBGE Base territorial/zoneamento postal Base oficial/CNC
E0380 / E0398 Endereço incompatível em obra/evento CEP ou município do local específico Dados da obra/evento
E0931 Dados de imóvel usados incorretamente em construção Uso do grupo <imovel> em vez de <obra> XML/DPS
E1262 CNPJ não autorizado a compartilhar DF-e Certificado do transmissor não é o autorizado Convênio/certificado
E0717 Assinatura obrigatória <Signature> ausente ou não reconhecida XML/assinatura
E0718 Assinatura deve ser do emitente CPF/CNPJ do certificado diverge do emitente Certificado/representação
E1206 / E107 Falha ao acessar LCR Firewall, proxy ou cadeia de certificado Infraestrutura
E1200 Certificado inválido Certificado não aceito Certificado
E1203 Certificado expirado Validade encerrada Renovação
E1205 Erro na cadeia do certificado Cadeia incompleta/incorreta Servidor/certificação
RNG6110 Endereço no exterior inválido Ordem/ausência de elementos em <endExt> XML
E0010 Série não pertence ao tipo de emissor Série de outro canal de emissão ERP/DPS
E0440 Tipo de dedução/redução não permitido Município não admite a modalidade enviada Parametrização/XML
E0454 Dedução percentual não permitida Percentual não habilitado para o serviço Parametrização
E0540 Divergência no item 17 Serviço parametrizado como não incidente e XML tributável Município/XML
E0037 Município emissor fora do cadastro de convênio Convênio não formalizado Município
E0039 Emissor Nacional não habilitado Configuração do convênio incompleta Município
E0015 Competência futura Data posterior à emissão DPS
E0016 / E1270 Competência anterior à vigência do convênio Município ainda não estava ativo Município/competência
E0018 / E0020 Competência anterior ao cadastro do contribuinte CNPJ/CPF ainda não existia Competência
E0025 Contribuinte ainda não autorizado naquela data dAutEmiss posterior à competência CNC
E0312 Serviço sem alíquota vigente na competência Parametrização começou depois Município
E0316 NBS inexistente Código fora da tabela NBS aceita NBS/ERP
E1517 Grupo IBS/CBS incompatível com a DPS Grupo não foi explicitamente informado DPS/XML
E0850 IBS/CBS em competência anterior ao marco admitido Data incompatível Competência/XML
E0827 Cancelamento com tributo já recolhido bloqueado Município não permite cancelamento automático Análise Fiscal
E0840 Já existe solicitação de análise Pedido anterior ainda está em andamento Portal/prefeitura
E0056 Substituição de nota sem tomador bloqueada Parametrização municipal Evento de substituição
E0058 Alteração da identidade do tomador Campo não pode ser trocado por substituição Análise Fiscal/cancelamento
E0060 Alteração vedada na substituição Campo protegido no regime normal Nova estratégia de correção
E0061 Alteração vedada para Simples/MEI Campo protegido no regime simplificado Nova estratégia de correção
E0675 Campos federais bloqueados para emitente CPF Regra própria de pessoa física Fora da NFS-e
E0676 Campos federais bloqueados para MEI Tributação unificada do MEI Regra do regime
E1294 Prazo de entrega da DF-e excedido Emissão extemporânea fora do prazo Decisão administrativa
E1317 Município de incidência incompatível com o serviço Tentativa de direcionar ISS a município indevido Local da incidência

Erro E3351: registro do CNC inativado não pode ser editado

O E3351 aparece quando o registro do contribuinte no Cadastro Nacional Complementar já foi inativado. Segundo o material oficial, a inativação funciona como exclusão lógica daquele registro e não como uma simples suspensão temporária.

Por isso, insistir em editar o mesmo cadastro não resolve. A correção indicada é criar uma nova inclusão com a tríade correta: código do município, CPF/CNPJ e Inscrição Municipal. O novo registro deve ser salvo com situação ativa e status de emissão autorizado.

Se houver outro cadastro duplicado utilizando a mesma inscrição municipal, ele precisa ser identificado antes. Em vários casos, a mensagem relacionada a “Indicador Municipal em uso” decorre justamente da existência de outro registro ativo.

Erro E0240: CEP inválido ou fora do padrão

O E0240 está ligado à validação do CEP. O sistema espera oito dígitos numéricos, sem hífen.

Um CEP visualmente correto pode continuar sendo rejeitado quando a informação armazenada na origem contém máscara, caractere indevido ou ainda não foi sincronizada. O problema pode estar na base da Receita Federal e não no campo que aparece na tela.

A correção estrutural é ajustar o dado na origem ou, quando aplicável, no CNC. O documento oficial orienta que o município pode cadastrar ou editar o CEP correto no Cadastro Nacional Complementar, que passa a prevalecer na validação.

Erros E1309 e E0138: CEP não pertence ao município

Esses erros indicam divergência territorial. O CEP informado precisa corresponder ao município selecionado e ao código IBGE usado pela plataforma.

O E1309 aparece no contexto da emissão e o E0138 no contexto cadastral do CNC. A causa pode ser preenchimento manual incorreto, mudança de zoneamento postal ou dado desatualizado na Receita Federal.

Se o problema reaparece mesmo após correção manual na nota, a solução deve ocorrer na origem: RFB ou CNC. Corrigir apenas o documento pode gerar o mesmo erro na emissão seguinte.

Erro E3313: CEP e código IBGE incompatíveis

O E3313 também pertence à família dos erros territoriais, mas o material o relaciona especialmente a municípios que passaram por mudança de CEP único para CEP por rua ou outra atualização de zoneamento postal.

A prefeitura não consegue simplesmente importar uma nova tabela própria de CEPs para o sistema nacional. A base precisa ser reconhecida pelos cadastros oficiais consumidos pela plataforma.

Se a mudança já foi oficializada e ainda assim a rejeição persiste, deve-se revisar o cadastro do contribuinte e registrar a inconsistência pelos canais responsáveis pela base nacional.

Erros E0380 e E0398: endereço de obra ou evento

Esses códigos aparecem em validações nas quais o local específico da prestação é determinante, como obra ou evento.

O diagnóstico precisa considerar não apenas o endereço do prestador ou tomador, mas o endereço informado no grupo específico da operação. CEP, município e código IBGE precisam estar coerentes entre si.

Em serviços com local de incidência próprio, tentar “resolver” alterando apenas o município do tomador pode criar outra inconsistência. A correção deve ser feita no grupo que representa efetivamente o local da obra ou do evento.

Erro E0931: construção civil usando o grupo de imóvel errado

O E0931 é um dos erros mais importantes para construção civil.

Nos códigos de construção, como 07.02 e 07.05, os dados da obra devem ser informados no grupo <obra>, dentro do grupo de serviço da DPS. O grupo <imovel> dentro da estrutura de IBS/CBS tem outra finalidade e não deve ser utilizado para substituir as informações da obra.

A correção é remover a estrutura inadequada de imóvel e informar CNO, inscrição imobiliária fiscal ou endereço no grupo próprio de obra, conforme o caso.

O próprio material alerta que descrições antigas de regras podem divergir da mensagem retornada pelo sistema. Nessa situação, deve-se consultar o Anexo VI mais recente.

Erro E1262: CNPJ não autorizado a compartilhar DF-e

Esse erro afeta principalmente municípios e integrações de sistemas próprios com o Ambiente de Dados Nacional.

A causa descrita no guia é objetiva: o certificado digital utilizado para transmitir o lote pertence a CNPJ diferente daquele autorizado como transmissor do município.

Isso pode acontecer quando uma software house transmite com o próprio certificado ou quando é usado certificado de autarquia, fundo ou outro órgão que não corresponde ao CNPJ registrado no convênio.

A correção é verificar qual CNPJ está autorizado na configuração do convênio e utilizar certificado compatível com essa identificação.

Erro E0717: assinatura obrigatória mesmo com certificado válido

O E0717 não significa necessariamente que o certificado está vencido ou inválido.

O material oficial explica que, em integrações por API, o problema frequentemente ocorre porque o bloco <Signature> não chegou ao sistema da maneira esperada. A assinatura pode ter sido colocada fora do ponto correto do XML ou corrompida durante codificação, compactação ou encapsulamento da mensagem.

Antes de substituir o certificado, verifique o XML efetivamente enviado. Confirme se a assinatura segue o padrão exigido, se está vinculada ao elemento com o atributo ID correto e se o processo de serialização preservou todos os caracteres.

Erro E0718: assinatura deve ser do emitente da DPS

O E0718 é diferente do E0717.

Aqui, a assinatura existe e é tecnicamente reconhecida, mas o CPF ou CNPJ identificado no certificado não corresponde ao emitente informado na DPS.

O sistema compara os dados do certificado com o grupo do emitente. Se forem diferentes, rejeita.

Para software houses, isso é especialmente relevante. Usar um único certificado próprio para assinar documentos de vários clientes pode gerar a rejeição quando a regra exige a identidade do prestador emitente.

Erros E1206 e E107: não foi possível acessar a Lista de Certificados Revogados

O problema ocorre quando a infraestrutura não consegue consultar a lista utilizada para verificar se o certificado foi revogado.

O material aponta firewall, proxy e cadeia de certificação como causas frequentes. A solução passa por liberar acesso às URLs indicadas no próprio certificado, conferir os certificados raiz e intermediários instalados e validar a cadeia completa.

O guia registra que a mesma situação pode aparecer com nomenclaturas diferentes em documentações específicas, especialmente na NFS-e Via.

Erros E1200, E1203 e E1205: certificado inválido, expirado ou com cadeia incorreta

Esses códigos ajudam a separar problemas clássicos do certificado digital.

E1200 indica certificado inválido. E1203 está relacionado a certificado expirado. E1205 aponta problema na cadeia de certificação.

A solução depende do diagnóstico: renovar o certificado, corrigir instalação da cadeia, verificar o repositório utilizado pelo servidor e testar novamente a assinatura antes de reenviar documentos acumulados.

Se a correção do certificado ocorrer depois do prazo admitido para determinada emissão, o problema pode se transformar em outro erro, como E1294.

Erro E1294: prazo para entrega da DF-e excedido

O E1294 aparece quando a emissão extemporânea ultrapassa o prazo admitido pela regra aplicável.

O material orienta que, após corrigir o certificado ou outra causa original, o contribuinte tente emitir com a competência correta. Se o sistema bloquear porque o prazo expirou, pode ser necessário abrir procedimento perante a prefeitura para emissão por decisão administrativa.

Esse fluxo de exceção não deve ser utilizado como substituto permanente da correção da causa original.

Erro RNG6110: endereço no exterior

O RNG6110 está associado à estrutura do endereço estrangeiro no XML.

Segundo o Perguntas e Respostas, os elementos do grupo <endExt> possuem ordem rígida. O erro pode surgir quando o código postal no exterior é omitido ou quando cidade, código postal e região aparecem em ordem diferente daquela esperada pelo tipo do schema.

A correção é revisar a sequência dos elementos conforme o XSD vigente, e não apenas conferir se os valores estão corretos.

Erro E0010: série não pertence à faixa do tipo de emissor

Esse é um erro típico de migração entre canais.

A DPS possui faixas de série diferentes conforme a origem. O material indica séries de 00001 a 49999 para aplicativo próprio/API, de 50000 a 69999 para emissor móvel, de 70000 a 79999 para Emissor Web Nacional e de 80000 a 89999 para transcrição manual via web.

O caso mais comum é a empresa sair do Portal Web e começar a emitir via API sem alterar a série configurada no ERP. A correção é ajustar o campo de série para a faixa correspondente ao canal real de transmissão.

Erro E0440: tipo de dedução ou redução não permitido

O E0440 normalmente indica divergência entre a modalidade de dedução enviada pelo sistema e aquilo que o município de incidência parametrizou como permitido para aquele código de serviço.

O Portal Web tende a apresentar apenas opções admitidas. Já um ERP pode continuar enviando automaticamente uma estrutura fixa que o município não autoriza.

A correção pode ocorrer de dois lados. O contribuinte ou a software house ajusta o XML à modalidade realmente permitida; ou o município revisa a parametrização caso a legislação local autorize aquele tipo de dedução.

Com as evoluções da Nota Técnica 009 e do grupo vAjusteBC, sistemas também precisam conferir se ainda estão utilizando estruturas antigas que foram reorganizadas.

Erro E0454: dedução por percentual não permitida

O E0454 é uma variação mais específica do problema de deduções.

Aqui, o código do serviço não admite dedução por percentual, ainda que outra forma de dedução possa estar autorizada.

A correção é verificar a parametrização do subitem no município. Se a legislação local realmente permitir dedução percentual, o gestor deve habilitar essa modalidade. Se não permitir, o ERP precisa deixar de enviá-la.

Erro E0540: divergência de incidência no item 17

O guia associa o E0540 a situações em que o município configurou determinado subitem do item 17 como não incidente, enquanto o prestador envia a DPS indicando tributação de ISSQN.

O sistema identifica a incompatibilidade entre o XML e a parametrização municipal e rejeita a operação.

A solução é revisar a lista de serviços do município e o valor de tributação enviado na DPS. Não basta mudar um campo no ERP sem verificar se a parametrização municipal está correta juridicamente.

Erro E0037: código do município emissor inexistente no cadastro de convênio

Esse erro aponta para a situação do município no Sistema Nacional.

Segundo o material, ele ocorre quando o município do emitente não está com convênio formalizado, ressalvadas exceções específicas como o MEI nas validações indicadas.

Para contribuintes comuns, o problema não é resolvido trocando o código do serviço ou o certificado. É necessário conferir a situação do convênio do município.

Erro E0039: município ainda não habilitou os Emissores Públicos Nacionais

Ter a Lista de Serviços parametrizada não significa que todo o processo de adesão foi concluído.

O E0039 pode decorrer de configuração incompleta do convênio. O material orienta verificar se o município marcou que utilizará os Emissores Públicos Nacionais, concluiu as etapas de parametrização e atingiu a data de vigência.

Quando existe autorização individual pelo CNC, também é necessário conferir a data específica do contribuinte.

Código de Tributação Municipal rejeitado: por que o cTribMun não funciona?

Nem toda rejeição relevante aparece para o usuário com um código simples.

O campo cTribMun só deve ser informado quando a especialização municipal estiver cadastrada formalmente no ambiente nacional. Um código histórico utilizado pelo sistema antigo da prefeitura não é automaticamente reconhecido pela NFS-e Nacional.

O caminho rápido pode ser remover o cTribMun e transmitir apenas o código nacional, quando isso corresponder à operação. A solução definitiva, quando o município realmente precisa da especialização, é cadastrá-la no Painel Nacional.

Erros E0015, E0016, E1270, E0018 e E0020: problemas de competência

Esses códigos formam uma família importante para emissões retroativas.

E0015 está ligado à competência futura. A data da prestação não pode ser posterior à emissão.

E0016 e E1270 aparecem quando a competência informada é anterior à ativação ou à vigência necessária do convênio municipal.

E0018 e E0020 estão associados à existência do próprio emitente: não se pode emitir documento com competência anterior ao cadastro do CNPJ ou CPF nos termos validados pelo sistema.

Antes de tentar contornar essas rejeições, monte uma linha do tempo: data do CNPJ/CPF, data de início do convênio, data de autorização no CNC e data da competência da nota.

Erro E0025: contribuinte ainda não autorizado naquela competência

Mesmo que o convênio municipal já estivesse ativo, um contribuinte específico pode ter sido habilitado em data posterior.

O E0025 está ligado à Data de Autorização de Uso, dAutEmiss, registrada no CNC. O sistema considera essa informação ao verificar se o emitente podia utilizar o emissor naquela competência.

A solução é revisar a autorização individual e confirmar situação ativa e status de emissão autorizado.

Erro E0312: serviço sem alíquota vigente na competência

O E0312 não significa necessariamente que o convênio está inativo.

Ele pode ocorrer quando o código de serviço utilizado não possuía parametrização ou alíquota vigente na data da competência informada.

A correção é verificar a vigência do subitem. Em situações excepcionais devidamente justificadas, o material menciona fluxo por decisão administrativa para emissão que precise superar a trava temporal.

Erro E0316: código NBS inexistente na tabela do sistema

O E0316 tende a se tornar um dos erros mais pesquisados com a Reforma Tributária.

Segundo o Perguntas e Respostas, ele ocorre quando o código informado não pertence à versão da NBS aceita pelo ambiente nacional ou está fora do formato exigido.

Em integração por API, confira o valor enviado em <cNBS> e a tabela utilizada pelo ERP. Não resolva o problema simplesmente escolhendo qualquer código que o sistema aceite: a NBS precisa descrever corretamente o serviço.

O município não pode criar uma NBS própria. A tabela é nacional.

NBS e cClassTrib incompatíveis: atenção à versão da documentação

O PDF de setembro relaciona rejeições da Calculadora Oficial à correlação entre NBS, indicador da operação e cClassTrib e aponta o Anexo VIII como referência.

Há, porém, uma atualização importante posterior ao documento: o Portal da NFS-e, atualizado em outubro de 2026, informa que o Anexo VIII versão 1.01.00 é um trabalho inicial em desenvolvimento e que não há regras de negócio baseadas nele no ambiente do Piloto RTC nem na produção indicada pelo portal.

Isso significa que uma incompatibilidade vista na calculadora ou em outro componente não deve ser automaticamente atribuída a uma regra de produção do Anexo VIII sem conferir a documentação atual. Este é um exemplo claro de por que códigos e tabelas precisam ser validados pela versão vigente.

Erro E1517: grupo IBS/CBS não foi informado como esperado na DPS

Informar NBS não faz o grupo de IBS/CBS nascer automaticamente.

O material descreve a E1517 no contexto em que a estrutura <IBSCBS> precisa estar coerente com aquilo que foi explicitamente declarado na DPS.

No Portal Web, o preenchimento depende da opção correspondente. Em API, o integrador precisa enviar a estrutura adequada no XML. A simples presença de um código NBS não substitui o grupo dos novos tributos.

Erro E0850: IBS/CBS em competência anterior ao período admitido

Esse código está relacionado ao marco temporal das informações da Reforma Tributária.

O sistema impede a inclusão dos grupos de IBS e CBS em competências anteriores ao período em que essa estrutura passou a ser admitida.

Se a nota é retroativa, o ERP deve respeitar o leiaute e as regras válidos para a competência original, em vez de aplicar automaticamente todos os campos atuais.

Erro E0827: cancelamento bloqueado porque há tributo recolhido

O cancelamento automático pode depender da parametrização do município.

O material aponta o E0827 quando a prefeitura não permite cancelar automaticamente notas que já possuem tributo recolhido.

Nesse cenário, a solução deixa de ser o simples botão de cancelamento e pode migrar para Solicitação de Análise Fiscal, conforme o fluxo disponibilizado.

Erro E0840: já existe solicitação de análise fiscal em andamento

O E0840 aparece quando o contribuinte tenta abrir nova solicitação para uma nota que já possui pedido pendente.

Antes de gerar outro requerimento, consulte a situação da solicitação anterior.

A duplicação de pedidos não acelera o processo e pode gerar mais confusão na fila administrativa. O caminho é acompanhar o procedimento existente ou contatar o município responsável pela análise.

Erro E0056: substituição de NFS-e sem tomador identificado

A possibilidade de substituir uma nota originalmente emitida sem identificação do tomador pode depender da parametrização municipal.

Quando a prefeitura não admite esse tipo de substituição, a regra E0056 pode bloquear o processo.

Isso significa que “adicionar o tomador depois” não é sempre uma simples edição. Dependendo do caso, será necessário utilizar outro fluxo de correção.

Erro E0058: substituição não pode trocar a identidade do tomador

O E0058 é ainda mais restritivo.

O material informa que a substituição não pode ser utilizada para alterar a identificação do tomador como se fosse um campo comum. Mudar o sujeito da operação possui efeito fiscal maior do que corrigir uma descrição.

Quando o erro está no CPF ou CNPJ do tomador, verifique a via adequada de cancelamento ou análise fiscal antes de emitir outra nota.

Erros E0060 e E0061: campos protegidos na substituição

A substituição possui limites que variam conforme o regime.

A regra E0060, aplicável ao regime normal no contexto descrito pelo guia, impede alterar determinados campos como competência, subitem, código complementar municipal e local da prestação.

A E0061 contém restrições específicas para Simples Nacional e MEI, alcançando campos como identificação do tomador, competência e valor do serviço em situações descritas pela regra.

Por isso, antes de iniciar uma substituição, identifique exatamente qual campo precisa ser corrigido. Nem todo erro é substituível.

Erros E0675 e E0676: retenções federais bloqueadas

O E0675 está relacionado ao emitente identificado por CPF. O sistema bloqueia campos de tributos federais em determinadas situações e o material orienta que a retenção seja tratada fora do fluxo da NFS-e quando cabível.

A E0676 é apresentada como regra semelhante para MEI, mas por fundamento diferente: o regime simplificado e o recolhimento unificado.

O erro não deve ser “corrigido” forçando valores no XML. É necessário entender se o campo realmente pode ser informado para aquele tipo de emitente.

Erro E1317: município de incidência incompatível com o código de serviço

A NFS-e possui regras de incidência que seguem a legislação do ISS.

O E1317 aparece no material ao explicar que determinados serviços, como o código 07.01, não podem ter o município de incidência livremente escolhido pelo contribuinte.

Se o serviço não está entre as exceções legais que deslocam a incidência, tentar informar outro município gera rejeição. A correção é enquadrar corretamente o serviço e o local tributável, e não simplesmente trocar o município até a nota ser autorizada.

Quando o erro está no Portal, no ERP ou na prefeitura?

Uma forma prática de diagnosticar é observar se o mesmo documento funciona em canais diferentes.

Se a emissão funciona no Portal Web, mas falha no ERP, há forte indicação de que o XML do sistema próprio está enviando campo, série, dedução ou estrutura diferente daquela montada dinamicamente pelo Portal.

Se falha em ambos os canais para o mesmo contribuinte e serviço, investigue cadastro, competência, parametrização municipal e situação do convênio.

Se outros contribuintes emitem normalmente e apenas um CNPJ falha, o foco deve migrar para CNC, situação cadastral, data de autorização ou dados recuperados da Receita Federal.

Não tente “resolver” uma rejeição apagando campos aleatoriamente

Uma prática perigosa é retirar tags do XML até o documento passar.

Isso pode eliminar a rejeição técnica e criar um documento fiscal incorreto. O mesmo vale para trocar NBS, cClassTrib, município de incidência ou natureza da tributação apenas para conseguir autorização.

A solução correta precisa preservar a realidade da operação. O código de erro é um diagnóstico, não um obstáculo que deve ser contornado a qualquer custo.

A versão do leiaute pode ser a causa do erro

A documentação da NFS-e está evoluindo rapidamente.

Em 1º de outubro de 2026, o Portal publicou a NT 009 versão 1.01, o Anexo VI v1.04.01 e o Anexo VII v1.03.00. Sistemas que continuam validados apenas contra versões anteriores podem produzir rejeições, ignorar novos campos ou montar estruturas que deixaram de corresponder à documentação vigente.

Por isso, software houses devem registrar em seus logs qual versão do schema e das tabelas foi utilizada para gerar cada DPS.

Como montar um diagnóstico antes de abrir chamado

Guarde o código e a mensagem integral da rejeição. Depois registre CNPJ/CPF, município, competência, código do serviço, regime tributário, canal de emissão e horário da tentativa.

Em integração, salve o XML exatamente como foi transmitido e a resposta completa da API. Não envie para o suporte apenas um print da tela se o problema está no XML.

Teste o mesmo caso em Produção Restrita quando a funcionalidade estiver disponível. Compare a versão dos XSDs, regras de negócio e tabelas do ERP com a versão publicada no Portal da NFS-e.

Quando procurar a prefeitura

Procure a administração tributária municipal quando o problema estiver em parametrização de serviço, alíquota, dedução/redução admitida, autorização no CNC, data de habilitação, cancelamento fora do fluxo automático ou decisão administrativa.

Erros como E0440, E0454, E0540, E0039, E0025, E0312, E0827 e E0840 podem envolver ação municipal, dependendo da causa concreta.

Levar o código exato, a chave da nota quando houver e o XML reduz bastante o tempo de diagnóstico.

Quando procurar a software house

Procure o fornecedor do sistema quando o erro indicar montagem incorreta do XML, série incompatível, assinatura perdida no encapsulamento, uso de schema antigo, tag descontinuada ou divergência entre o XML e aquilo que o usuário configurou no ERP.

E0010, E0717, RNG6110, E0931, E1517 e problemas envolvendo estruturas antigas de dedução são exemplos em que a integração deve ser investigada.

A software house precisa reproduzir o erro com o XML real. Mensagens genéricas como “problema da Receita” não substituem o diagnóstico técnico.

Quando o problema está no certificado

E0718, E1200, E1203, E1205 e E1206/E107 apontam diretamente para identidade, validade, cadeia ou consulta de revogação do certificado.

Nesses casos, o contador ou usuário do Portal nem sempre consegue resolver sozinho. Pode ser necessário envolver o responsável pelo certificado e a equipe de infraestrutura que mantém o servidor de integração.

Antes de qualquer reinstalação, confira se o certificado utilizado é realmente o do emitente exigido pela regra.

Quando o problema está na NBS

O E0316 é o código mais direto: a NBS enviada não é reconhecida pela tabela aceita.

Mas existem outros problemas de classificação que podem não aparecer exatamente com esse código. NBS inadequada pode gerar incompatibilidade com tratamentos tributários ou com outras tabelas.

A correção começa na identificação real do serviço prestado. Não escolha a classificação pela mensagem que “passa”; escolha pela operação e valide nas tabelas oficiais vigentes.

Checklist rápido para resolver um erro da NFS-e

1. Anote o código exato e a mensagem completa.
2. Confirme a competência e o regime tributário do emitente.
3. Verifique CNPJ/CPF, CNC, endereço e CEP.
4. Confira código nacional do serviço, NBS e demais classificações.
5. Identifique se a emissão ocorreu pelo Web, App ou API.
6. Se for API, preserve o XML e a resposta integral.
7. Confira série da DPS e versão do schema.
8. Valide certificado e identidade do emitente.
9. Consulte a parametrização municipal quando o erro envolver ISS, alíquota, dedução ou vigência.
10. Use sempre a versão mais recente do Anexo VI e das tabelas publicadas pelo Portal da NFS-e.

Resumo: os erros da NFS-e precisam ser corrigidos na origem

Os principais erros da NFS-e Nacional não têm uma única causa. Alguns nascem no cadastro, outros no município, no certificado, no ERP ou nas tabelas nacionais.

E0316 normalmente leva à NBS. E0717 e E0718 apontam para assinatura. E0010 indica série incompatível com o canal. E0440 e E0454 tratam de deduções. E0037 e E0039 envolvem o convênio municipal. E0931 aparece na estrutura de construção civil. E0240, E1309 e E0138 direcionam a investigação para CEP e território.

Emissão retroativa exige atenção a E0015, E0016, E1270, E0018, E0020, E0025 e E0312. Cancelamentos e substituições trazem outra família de regras, como E0827, E0840, E0056, E0058, E0060 e E0061.

O melhor caminho não é tentar eliminar a mensagem de qualquer forma. É identificar a camada responsável e corrigir o dado na origem. Quando a causa é cadastral, ajuste o cadastro. Quando é municipal, revise a parametrização. Quando é técnica, corrija o XML. Quando é certificado, resolva identidade e cadeia. Quando é classificação, consulte as tabelas nacionais vigentes.

A NFS-e Nacional está em rápida evolução. Por isso, este guia deve ser utilizado junto com a documentação técnica atualizada do Portal da NFS-e, especialmente o Anexo VI de Leiautes e Regras de Negócio e as Notas Técnicas vigentes.

Acompanhe o Radar da Reforma Tributária para acompanhar novos códigos de rejeição, atualizações dos leiautes da NFS-e, NBS, cClassTrib, IBS, CBS e as mudanças operacionais da Reforma Tributária.

Fontes públicas: Sistema Nacional da NFS-e — “Perguntas e Respostas”, versão 1.1, de 22 de setembro de 2026; Portal da Nota Fiscal de Serviço eletrônica — Documentação Técnica RTC, atualizada em outubro de 2026; Nota Técnica SE/CGNFS-e nº 009, versão 1.01; Anexo VI — Leiautes e Regras de Negócio RTC/IBSCBS v1.04.01; Anexo VII — Indicadores da Operação v1.03.00; Resolução CGNFS-e nº 3/2023; Lei Complementar nº 214/2025; Decreto nº 12.955/2026; Ato Conjunto RFB/CGIBS nº 4/2026; Ato Técnico Conjunto RFB/CGIBS nº 1/2026.

Este conteúdo é informativo. Os códigos, mensagens, regras de validação, schemas e tabelas da NFS-e podem ser alterados por novas Notas Técnicas ou versões dos anexos. Quando houver divergência entre material anterior e a documentação técnica mais recente publicada no Portal da NFS-e, confirme a regra vigente antes de alterar sistemas ou procedimentos fiscais.

Sair da versão mobile