Pular para o conteúdo principal
Exportação de Serviços
5 min de leitura

O XML e o emissor mostram códigos diferentes: como conferir a NFS-e

Compare a classificação exibida no emissor e no XML da NFS-e. Identifique código nacional, complemento municipal e eventual erro fiscal.

04 de novembro de 2026Atualizado em 04 de novembro de 2026
Compartilhar:

Se o código de serviço que aparece no emissor parece diferente do XML, confira se os dois campos representam a mesma informação. Um sistema pode mostrar código de tributação nacional, complemento municipal ou descrição abreviada. Consulte a documentação vigente e compare os documentos da mesma nota. Se houver divergência real, preserve os arquivos e verifique o procedimento de correção antes de emitir outro documento.

Confirme que está comparando a mesma NFS-e

Abra o XML e o documento auxiliar ou a consulta do emissor. Compare chave, número, emitente, tomador, competência e estado. Um arquivo baixado antes de uma substituição pode se referir à nota anterior. Um rascunho de DPS pode ter campos que não correspondem ao documento final. Use o registro emitido para verificar o que foi gravado e guarde a versão consultada.

O Portal da NFS-e mantém guias e documentação técnica com leiautes e tabelas. Use o documento correspondente ao ambiente e à competência. Confira quais campos representam código nacional, complemento municipal e descrição. Compare com a legislação municipal e com o item da lista da LC nº 116 que sustenta a classificação. Se o código tiver pontuação, verifique a convenção do sistema antes de tratar como outro valor.

Monte uma tabela para a conferência

CampoO que comparar
Identificação da notaChave, número e competência
Classificação nacionalCódigo e descrição na tabela vigente
Código municipalComplemento e relação com a atividade
DescriçãoEscopo efetivo e texto exibido
SituaçãoVigente, cancelada, substituída ou em análise

Se o portal mostrar uma descrição e o XML trouxer somente código, consulte a tabela que liga os dois. Se a integração converte códigos internos para o padrão do emissor, peça a regra de mapeamento e a versão usada. Registre o resultado. Uma diferença de campo visual pode ser explicada pelo leiaute. Quando o valor gravado não corresponde à classificação aprovada, preserve a evidência e consulte a orientação fiscal.

Exemplo com complemento municipal

Uma prestadora seleciona uma atividade e o portal mostra o complemento municipal. No XML, a equipe encontra o código nacional e procura o campo complementar. Com o guia do emissor e a tabela do município, confirma que as informações correspondem ao mesmo serviço. Guarda a consulta e o XML no índice da invoice. Se o complemento não aparecesse onde a regra exige, a equipe abriria a pendência e pediria a confirmação da integração.

Em outro caso, o XML traz um código de atividade diferente daquele aprovado para a prestação. A empresa registra chave, competência e documento. Consulta o emissor e a contabilidade para verificar se cabe substituição, cancelamento ou outro procedimento. Não edita o XML baixado. Guarda o protocolo e confere o estado após a decisão.

Revise o efeito na escrituração

Se a nota já entrou no fechamento, informe a contabilidade sobre a divergência e o estado. Preserve a nota original, o arquivo importado e a data. Se houver documento substituto, registre a ligação entre chaves. Confirme se existe impacto em escrituração ou obrigações do período. Uma diferença pode afetar apenas apresentação ou exigir correção fiscal. A conclusão depende do campo, do emissor e da regra.

No cadastro do cliente, verifique se a configuração será usada na próxima nota. Teste a classificação em ambiente apropriado quando disponível. Se a causa foi mapeamento do sistema, confirme a correção antes da emissão seguinte. Guarde o resultado da consulta oficial e registre o responsável pela revisão.

Faça uma verificação após qualquer correção

Consulte o documento final no emissor e confira o XML disponível. Compare os campos com o escopo e a classificação validados. Guarde o estado, os documentos e o protocolo. Se o cliente recebeu versão anterior, confirme como informar a atualização. No fechamento, confira se a nota vigente foi ligada à invoice correta.

Revise o mapeamento da integração

Se a empresa usa um software emissor, peça a tabela que associa o código interno aos campos da NFS-e. Registre a versão e a data em que foi atualizada. Compare uma nota correta com a nota em análise usando a mesma competência e o mesmo tipo de prestação. Se o código interno estava correto e o XML gravou outro, preserve o arquivo enviado e o retornado. Encaminhe as referências ao fornecedor e à contabilidade. Se o mapeamento afetou outras notas, faça uma lista com chaves e estados.

Confira após o ajuste

No ambiente apropriado, valide o novo mapeamento com a descrição e o código aprovados. Depois confira a primeira nota real. Registre quais documentos anteriores exigem revisão e quais apresentavam apenas diferença de exibição. Guarde também a data da validação do mapeamento.

Perguntas frequentes

Código diferente no PDF e no XML é sempre erro?

Confira se os campos representam a mesma classificação e se pertencem à mesma nota. Use a tabela e a documentação vigentes.

Posso corrigir o XML manualmente?

Preserve o arquivo emitido. Consulte o procedimento do emissor e da autoridade competente para corrigir a nota.

O que informar à contabilidade?

Envie chave, competência, XML, consulta, classificação validada e protocolo ou documento de correção quando houver.

Fontes oficiais

Leituras relacionadas

Como a Zen pode ajudar

A contabilidade para exportação de serviços da Zen ajuda a organizar documentos, conciliar recebimentos e analisar as regras da sua operação. Peça uma proposta personalizada para conversar sobre o seu caso.

Tags:

legislação municipal de nfs-e divergência entre xml e classificação do emissor
legislação municipal de nfs-e
exportação de serviços

Perguntas Frequentes

"Exporto serviços de consultoria para os EUA e a equipe cuida de toda a parte fiscal e cambial. Economizo muito com a isenção de ISS."

MS

Marina Silva

Consultora Internacional · São Paulo, SP

Thomas Broek

Responsável técnico
CRC-SP 337693/O-7

Contador Especialista em Profissionais de Saúde · Fundador da Contabilidade Zen

Contador especializado em tributação para médicos, dentistas e psicólogos PJ. Registro ativo no CRC-SP (337693/O-7). Fundador da Contabilidade Zen, escritório 100% digital focado em planejamento tributário e abertura de empresa para profissionais de saúde.

Última atualização: 04 de novembro de 2026

Publicado por: Equipe Contabilidade Zen

Compartilhar:

Artigos relacionados

Como Calcular o IOF na Remessa 2026
Exportação de Serviços
9 min

Como Calcular o IOF na Remessa 2026

Entenda como o IOF incide sobre o câmbio na remessa internacional: base de cálculo, quando incide e como afeta o valor líquido recebido pelo exportador.

Ler mais
Psicólogo pode atender no exterior?
Exportação de Serviços
9 min

Psicólogo pode atender no exterior?

Psicólogo pode atender brasileiros no exterior? Veja as regras do atendimento on-line, como receber em moeda estrangeira e a tributação da exportação.

Ler mais
MEI para ME: Faturamento em Dólar
Exportação de Serviços
9 min

MEI para ME: Faturamento em Dólar

Faturando em dólar, o teto do MEI pode ser ultrapassado mais rápido. Veja quando migrar de MEI para ME e como contar o faturamento em reais.

Ler mais

Quer saber mais sobre contabilidade para profissionais da saúde?

Entre em contato conosco e descubra como podemos ajudar você a pagar menos impostos de forma legal.

Fale com um especialista

Sua privacidade

Cookies de análise só com sua permissão. Política de Privacidade.