Códigos de erro NFS-e, traduzidos

Como resolver: Leia o complemento da mensagem: ele indica o elemento errado. As causas mais comuns são: elementos fora de ordem, campo obrigatório ausente (ex.: cTribNac), uso do campo "Informações Complementares" quando não permitido, ou namespace incorreto. Valide o XML aqui no NotaVálida antes de reenviar.

Como resolver: Salve o arquivo em UTF-8 sem BOM. No VS Code/Notepad++, mude a codificação no canto inferior direito. Se o XML vem de um ERP, confira o parâmetro de encoding na geração — e nunca converta o arquivo depois de assinado.

Como resolver: Remova o prefixo dos elementos e declare o namespace como padrão: xmlns="http://www.sped.fazenda.gov.br/nfse".

Como resolver: Refaça a compactação: gzip → Base64, sem quebras de linha no meio da string. Teste o envio sem compactação para isolar o problema.

Como resolver: Atualize o leiaute para a versão vigente no Portal Nacional. Se usa ERP ou emissor de terceiros, confirme com o fornecedor se o sistema já gera a versão atual.

Como resolver: Confira: número da DPS apenas com dígitos, série no formato permitido (faixa 80000–89999 para transcrição manual), data no formato ISO (AAAA-MM-DDTHH:MM:SS) e código IBGE do município com 7 dígitos.

Como resolver: Padronize o ambiente: no XML, o campo tpAmb deve ser 1 (produção) para o endpoint de produção e 2 (produção restrita) para o endpoint de testes. Confira a URL do endpoint usado pelo seu sistema.

Como resolver: 1) Tente novamente após alguns minutos (instabilidade é comum). 2) Remova acentos e caracteres especiais de razão social e descrição. 3) Omita telefone/e-mail do tomador se suspeitos. 4) Se persistir por mais de 48h com o XML válido, abra chamado em atendimento.nfs-e@rfb.gov.br.

Como resolver: Leia o complemento: normalmente indica campo de tributação da Reforma Tributária preenchido incorretamente (CST, cClassTrib, grupo gTribSN para Simples Nacional). Cruze com o Anexo VII do Portal Nacional (códigos cIndOp).

Como resolver: Confira o código IBGE de 7 dígitos do município de emissão. Consulte o status de adesão do município no Portal Nacional NFS-e. Se o município acabou de aderir, pode haver defasagem no cadastro.

Como resolver: Verifique no Portal Nacional o status do convênio do município. Municípios que aderiram "de última hora" (jan/2026) frequentemente ficaram com parametrização incompleta — contate a prefeitura.

Como resolver: Preencha o código NBS do serviço no item correspondente. A tabela NBS está disponível no Portal Nacional (documentação RTC). Sem NBS, a Reforma Tributária não consegue classificar a operação.

Como resolver: Se o prestador é pessoa física, confira se o seu sistema já está atualizado com a mudança de 13/03/2026. Informe as retenções federais nos campos específicos (nunca em "Outras Retenções").

Como resolver: Remova o campo de total aproximado de tributos (totTrib) da DPS quando o prestador for não optante do Simples. Se o ERP preenche automaticamente, desative a opção nas configurações fiscais.

Como resolver: Verifique a validade do certificado A1/A3. Confirme que o CNPJ do certificado é o mesmo do emitente da nota. Reinstale a cadeia de certificados ICP-Brasil atualizada.

Como resolver: Use certificado digital ICP-Brasil (A1 em formato PKCS#12/.pfx ou A3). Certificados autoassinados ou de outras cadeias são rejeitados.

Como resolver: Informe um RPS com número novo para cada emissão. Se precisa corrigir uma nota já emitida, use substituição ou cancelamento — nunca reenvie o mesmo RPS.

Como resolver: O complemento da mensagem indica qual campo falta. Preencha e reenvie. Compare seu XML com o exemplo oficial do Manual de Utilização do Webservice (Modelo Nacional v2.03).

Como resolver: Ajuste a estrutura do XML conforme o leiaute do ADN. Valide o arquivo aqui no NotaVálida para localizar o elemento problemático.

Como resolver: Assine o XML da DPS com certificado digital válido (padrão ICP-Brasil) antes de enviar. A assinatura segue o padrão XML-DSig.

Como resolver: Reassine o XML sem modificar nenhum caractere depois da assinatura (nem espaços). Confira validade e cadeia do certificado.

Como resolver: Preencha o CST de PIS/COFINS de acordo com a tributação do serviço. Valores e CST sempre andam juntos.

Como resolver: Verifique a última numeração utilizada e continue a sequência. Se o salto foi causado por testes, regularize a numeração junto à prefeitura.

Como resolver: Use 1 para produção e 2 para produção restrita (testes). Qualquer outro valor é rejeitado.

Como resolver: Cada RPS gera no máximo uma NFS-e. Gere um novo número de RPS ou use o fluxo de substituição de nota.

Como resolver: Informe a data de emissão no formato exigido pelo manual ABRASF (AAAA-MM-DD). Datas futuras também são rejeitadas.

Como resolver: Assine o lote com o certificado do próprio prestador ou configure a procuração eletrônica no portal GINFES do município.

Como resolver: Confirme número, série e tipo do RPS. Se o lote foi enviado recentemente, aguarde o processamento assíncrono e consulte novamente.

Como resolver: Use um número de RPS único. Mantenha controle sequencial da numeração no seu sistema emissor.

Como resolver: Informe o número do RPS (apenas dígitos, sem formatação).

Como resolver: Informe a data de emissão do RPS no formato AAAA-MM-DD.

Como resolver: Corrija a data de emissão. Atenção ao fuso horário: use o horário de Brasília.

Como resolver: Acesse o portal NFS-e do município, faça login, leia e aceite a política. Procedimento feito uma única vez por usuário.

Como resolver: Verifique se a Inscrição Municipal está migrada no Cadastro Nacional de Contribuintes NFS-e. Se o município aderiu de última hora, a parametrização pode estar incompleta — abra chamado na prefeitura e no suporte do Portal Nacional.

Como resolver: Consulte o CEP no site dos Correios e corrija o cadastro do tomador. Se o CEP está certo mas continua rejeitando, o problema é defasagem na base nacional — registre chamado.

Como resolver: Reexporte o certificado A1 (.pfx) com a cadeia completa e reenvie ao ERP. Verifique validade. Se o erro surgiu do nada após a migração, confirme com o fornecedor do ERP se o endpoint e o envelope SOAP/REST foram atualizados.

Como resolver: Confira cAtvSN e vReceitaBrutaSN conforme a NT 009. Optantes do Simples devem demonstrar IBS/CBS apurados pelo regime — a parametrização errada do ERP é a causa mais comum.

Como resolver: Consulte a tabela de extensões do seu município no portal da prefeitura e ajuste o código de tributação do serviço. Mantenha o código nacional como base e adicione a extensão exigida.

Como resolver: Verifique no Portal Nacional NFS-e se o seu município já aderiu ao padrão nacional. Se sim, faça o credenciamento do CNPJ no Portal do Contribuinte. Se o município ainda não aderiu, você deve continuar usando o sistema municipal até a migração.

Como resolver: Confirme com a prefeitura se a Inscrição Municipal está ativa e se foi feita a vinculação com o Cadastro Nacional. Empresas recém-abertas podem demorar até 30 dias para aparecer no sistema nacional.

Como resolver: Verifique no Portal do Simples Nacional (gov.br) se a empresa está ativa no regime para o período. Se a empresa saiu do Simples, desmarque a opção e use a tributação correspondente (Lucro Presumido, etc.).

Como resolver: Consulte a lista de municípios conveniados no Portal NFS-e. Se o município ainda não aderiu, você não pode usar o Emissor Nacional para operações com incidência nesse município — use o sistema municipal.

Como resolver: Remova o campo de alíquota de ISSQN da DPS. O sistema nacional determina a alíquota com base no município de incidência e no tipo de serviço. Esse erro foi reportado pela FENACON à Receita Federal em janeiro de 2026.

Como resolver: Consulte a tabela de códigos de tributação do município de incidência. Use o código cTribNac correspondente ao serviço prestado e aceito por aquela prefeitura. Se nenhum código corresponder, o serviço pode não ser tributado por ISS naquele município.

Como resolver: Consulte o Anexo VIII do padrão nacional, que correlaciona LC 116 → NBS → cIndOp → cClassTrib. Use a combinação correta para o seu serviço.

Como resolver: Consulte a tabela NBS atualizada no Portal NFS-e e encontre o código equivalente ao serviço prestado. Use o novo código NBS + cTribNac correspondente.

Como resolver: Consulte a tabela de serviços da prefeitura do município de incidência. Cada cidade pode ter códigos próprios que diferem da tabela nacional.

Como resolver: Consulte a legislação municipal do município de incidência para confirmar o valor mínimo. Ajuste o valor na DPS ou comprove a isenção/faixa reduzida se aplicável.

Como resolver: Revise os campos de valor do serviço (vServico) e retenção (vRetISS). A retenção deve ser um percentual do valor do serviço, normalmente entre 2% e 5%.

Como resolver: Confira o campo de dedução (vDeducao). Ele deve ser menor ou igual ao valor do serviço. Se não houver dedução, remova o grupo.

Como resolver: Verifique os valores de serviço, deduções e descontos incondicionados. A base de cálculo deve ser positiva. Se o serviço é isento, use o código de tributação correspondente a isenção/imunidade.

Como resolver: Confira o CNPJ (14 dígitos) ou CPF (11 dígitos) do tomador. Use o validador de CNPJ/CPF do NotaVálida para confirmar antes de enviar.

Como resolver: Informe o CEP do tomador com 8 dígitos. Se o tomador é estrangeiro, use o grupo específico de endereço exterior (cPais, NCM não aplicável).

Como resolver: Confira o código IBGE do município e a UF. Use a tabela IBGE completa para garantir compatibilidade.

Como resolver: Verifique a validade do certificado A1/A3 no site da autoridade certificadora. Se expirado, renove. Se inválido, reexporte o .pfx com a cadeia completa ICP-Brasil.

Como resolver: Reassine o XML após qualquer alteração. Use o algoritmo SHA-256 com RSA. Confira a URI da referência — deve apontar para o ID correto da DPS. Nunca edite o XML depois de assinar.

Como resolver: Use um certificado digital emitido para o CNPJ do prestador. Se usa certificado de contador/procurador, confira se a procuração está cadastrada no Portal do Contribuinte.

Como resolver: Use o próximo número de RPS disponível na sequência do seu sistema. Se o RPS foi cancelado, não reutilize o número — avance para o próximo.

Como resolver: Cadastre a série de RPS no Portal do Contribuinte do Emissor Nacional, ou use a série padrão (geralmente série 1 ou 'A').

Como resolver: Use a data atual ou uma data passada. Para serviços prestados em data anterior, use a data real de prestação como data de competência.

Como resolver: Aguarde a migração do município para Produção. Consulte o cronograma no Portal NFS-e. Para testes, use Produção Restrita; para notas válidas, só Produção.

Como resolver: Distribua as emissões ao longo do tempo. Use o mecanismo de retry do open-nfse/nfse-sdk que respeita o header Retry-After. Para lotes grandes, divida em lotes menores (máx. 50 DPS por lote).

Como resolver: Aguarde 15-30 minutos e tente novamente. Se persistir, consulte o status do Portal NFS-e. Não reenvie imediatamente — pode causar duplicação. Use o mecanismo de consulta para verificar se a DPS foi processada.

Como resolver: Inclua o grupo IBSCBS na DPS com os campos finNFSe, indFinal, cIndOp, indDest, cClassTrib e valores de tributo. Consulte o Anexo VII (tabela cIndOp) e Anexo VIII (correlação LC 116 → NBS → cIndOp → cClassTrib).

Como resolver: Consulte o Anexo VII – IndOp_IBSCBS no Portal NFS-e. O código tem 6 dígitos e deve corresponder exatamente ao tipo de operação. Use o Anexo VIII para encontrar o cIndOp correto a partir do item LC 116 ou NBS.

Como resolver: Use o Classificador Tributário do Portal NFS-e para encontrar o cClassTrib correto. O código tem 6 dígitos e identifica a incidência dos tributos, o local de prestação e as características do fornecimento.

Como resolver: Consulte o manual de integração do município. O padrão ABRASF tem versões diferentes (1.0, 2.0, 2.03) e cada prefeitura pode adotar uma versão específica com campos adicionais.

Como resolver: Consulte o XSD específico do município. Campos como CEP, código do município e valor do serviço são geralmente obrigatórios.

Como resolver: Aguarde 5-10 minutos e reenvie. Antes de reenviar, faça uma consulta pela chave de acesso para verificar se a DPS foi processada. Reenvios cegos causam duplicação.

Como resolver: Aguarde 15 minutos e tente novamente. Se o erro persistir, abra chamado no Portal do Contribuinte. Documente o XML enviado, a hora exata e a mensagem de retorno para anexar ao chamado.

Como resolver: Faça uma consulta pela chave para recuperar a NFS-e já autorizada. Se precisa corrigir, use o evento de substituição (105102) em vez de reenviar.

Como resolver: Consulte a legislação municipal para o prazo de cancelamento. Em muitos municípios é 30 dias, em outros pode ser menor. Após o prazo, a única opção é nota de ajuste ou comunicação de irregularidade.