Anatomia do XML da NF-e: onde os créditos que você não vê estão escondidos

Toda nota fiscal eletrônica é, por baixo, um arquivo XML. O DANFE em PDF que você imprime é só uma representação. O documento que vale, com cada campo de imposto, é o XML, e quase ninguém o abre.

Isso é um problema, porque é exatamente ali que estão os números que decidem quanto crédito você aproveita. A base do ICMS-ST que você pagou, os créditos de PIS e Cofins, o FCP retido: tudo já está escrito no arquivo, item por item. Quem lê só o total da nota perde o detalhe.

Este post abre o XML e mostra onde o dinheiro se esconde. É um passeio técnico, mas vale para qualquer um que decide sobre crédito tributário.

O XML é o documento; o PDF é a foto

Quando você recebe uma nota, recebe dois arquivos: o DANFE (PDF, para humanos) e o XML (para máquinas e para o fisco). Só o XML tem valor fiscal pleno e só ele traz todos os campos. Guardar apenas o PDF é guardar a foto e jogar fora o documento.

A estrutura é hierárquica. Dentro de <infNFe> há um <det> por item da nota. Cada <det> tem um <imposto>, e dentro dele os grupos de cada tributo: <ICMS>, <IPI>, <PIS>, <COFINS>. É descendo nessa árvore que se chega aos números que importam.

ICMS-ST: a base que você pagou e raramente confere

O grupo <ICMS> não é único. Ele tem um subgrupo conforme a situação tributária (CST) do item: <ICMS00>, <ICMS10>, <ICMS60>, <ICMS90> e assim por diante. É dentro do subgrupo certo que mora a substituição tributária.

Os campos a procurar:

• vBCST: a base de cálculo do ICMS por substituição tributária.
• pICMSST e vICMSST: a alíquota e o valor do ICMS-ST daquele item.
• vBCSTRet e vICMSSTRet: quando a ST já foi retida em etapa anterior (típico de CST 60), é aqui que aparece o valor retido.

<det nItem="1">
  <imposto>
    <ICMS>
      <ICMS10>
        <orig>0</orig>
        <CST>10</CST>
        <vBC>1000.00</vBC>
        <vICMS>180.00</vICMS>
        <vBCST>1300.00</vBCST>
        <vICMSST>234.00</vICMSST>
      </ICMS10>
    </ICMS>
  </imposto>
</det>

Para quem revende mercadoria com ST, esse é o ponto onde se descobre quanto de ICMS-ST foi embutido na compra. Sem ler o XML item a item, o número fica enterrado no total e a recuperação de ST vira chute.

PIS e Cofins: o crédito que sai de cena em 2027

Nos grupos <PIS> e <COFINS> estão a base (vBC), a alíquota (pPIS, pCOFINS) e o valor (vPIS, vCOFINS) de cada item. No regime não-cumulativo atual, é desse valor que nasce o crédito que abate o que a empresa deve.

Esse crédito tem prazo. PIS e Cofins são extintos em 2027, e o que você não aproveitar ou compensar até lá vira perda. Ler o XML para levantar crédito acumulado deixou de ser tarefa de rotina e virou tarefa de calendário.

FCP, o adicional que se esconde junto da ST

Ainda dentro do ICMS estão os campos do Fundo de Combate à Pobreza: vBCFCP, pFCP, vFCP, e as variantes de ST (vBCFCPST, vFCPST, vFCPSTRet). É um adicional de poucos pontos que passa despercebido no total da nota, mas que compõe a carga real do item.

O que a Reforma adicionou ao arquivo

O layout do XML mudou. A Nota Técnica 2025.002-RTC introduziu grupos para destacar IBS e CBS na nota fiscal, e desde janeiro de 2026 a maioria das empresas já preenche esses campos, por ora em caráter informativo, sem recolhimento.

A consequência prática é direta: o XML passou a carregar, em paralelo, o mundo antigo (ICMS, ISS, PIS, Cofins) e o novo (IBS, CBS). Durante a transição de 2029 a 2032, os dois convivem no mesmo arquivo. Ler o XML com precisão fica mais importante, não menos, porque é nele que a apuração dos dois sistemas vai bater.

Os campos que valem ouro, em uma tabela

Ninguém precisa ler 18 mil XMLs com o olho

Você não precisa abrir cada arquivo à mão. Mas alguém, ou algum sistema, precisa ler, porque o crédito está no XML, e não no relatório que o ERP mostra na tela.

O Nítido lê esse XML no seu próprio navegador, a partir do certificado A1, sem que o arquivo passe pelos nossos servidores. É o mesmo passeio deste post, feito em escala sobre as suas notas.