Pular para o conteúdo
Beevix

Artigo

NT 2025.002: o que muda no XML da NF-e e da NFC-e

Veja grupo por grupo o que a NT 2025.002 mudou no XML da NF-e e da NFC-e, com exemplo de item preenchido, as novas finalidades e o cronograma da versão 1.51.

Equipe Beevix9 min de leitura
Desenvolvedor e contadora revisam código no monitor e notas fiscais impressas em um pequeno escritório
Desenvolvedor e contadora revisam código no monitor e notas fiscais impressas em um pequeno escritório

A NT 2025.002 é a nota técnica do Portal Nacional da NF-e que adapta o XML da NF-e e da NFC-e à reforma tributária do consumo. Ela cria, em cada item da nota, o grupo do IBS e da CBS (com CST, cClassTrib, base, alíquotas e valores) e o grupo do Imposto Seletivo, acrescenta totais próprios, cria as finalidades "nota de crédito" e "nota de débito" e lança novos eventos. Para empresas do regime normal (CRT 3), o preenchimento já é obrigatório pela legislação desde janeiro de 2026; na versão 1.51, a rejeição automática da nota sem esses campos em produção passou a constar como implementação futura, sem data.

Para quem emite nota, o efeito prático é que o XML ficou maior e o cadastro de produtos precisa de informações novas. Para quem desenvolve ou configura emissores, a nota técnica é o documento de referência, com mais de 90 páginas de campos e regras de validação. Os produtos que entram no grupo IS estão no guia do imposto seletivo, e o recolhimento do IBS e da CBS na liquidação do pagamento, no de split payment.

Este guia resume o que mudou no XML, grupo por grupo, com um exemplo de item preenchido com as alíquotas de teste de 2026 e o cronograma de cada etapa.

O que a nota técnica muda no XML

A tabela reúne as alterações principais por grupo do leiaute, conforme a NT 2025.002-RTC versão 1.51.

Grupo do XMLO que mudouQuem sente primeiro
B (identificação)Novas finalidades na tag finNFe: 5 = nota de crédito e 6 = nota de débito, com os tipos em tpNFCredito e tpNFDebito; campo cMunFGIBS para o município de consumo em venda presencial fora do estabelecimento; campo cIndOp para casos específicosQuem faz ajustes de valores e devoluções
BB (compras governamentais)Grupo gCompraGov para vendas a entes públicosFornecedores do governo
UB (tributos do item)Grupo IS (Imposto Seletivo) e grupo IBSCBS, com CST, cClassTrib, base de cálculo e subgrupos para IBS da UF, IBS do município e CBSTodos os emitentes
VB (total do item)Campo vItem, valor total do item na notaTodos
VC (referência a outro DF-e)Grupo DFeReferenciado, que aponta a chave e o item de outra notaDevoluções e notas de crédito
W03 (totais)Grupos IBSCBSTot e ISTot, e o campo vNFTot, valor total da nota com IBS, CBS e ISTodos
EventosNovos eventos para apuração, crédito presumido, imobilização de item, perecimento e outrosQuem apura pelo regime regular

Na seção 9, a nota informa que as alterações no DANFE para exibir os novos tributos estão em estudo e serão publicadas em versão futura. Até lá, o documento auxiliar impresso não muda por causa da NT 2025.002.

O grupo IBSCBS, campo a campo

O grupo IBSCBS fica dentro do imposto de cada item (det/imposto) e tem esta estrutura básica:

  • CST do IBS e da CBS (3 dígitos) e cClassTrib (6 dígitos), que dizem qual é a tributação aplicável;
  • vBC, a base de cálculo comum ao IBS e à CBS;
  • gIBSUF: alíquota e valor do IBS de competência do estado, com subgrupos opcionais de diferimento (gDif), devolução de tributos ou cashback (gDevTrib) e redução de alíquota (gRed);
  • gIBSMun: a mesma estrutura para o IBS do município;
  • gCBS: a mesma estrutura para a CBS;
  • grupos específicos para tributação regular, compras governamentais, monofasia de combustíveis, transferência de créditos, ajuste de competência, estorno de crédito e crédito presumido, usados só quando o caso exige.

O CST e o cClassTrib controlam quais subgrupos são obrigatórios ou proibidos. É por isso que um cadastro com cClassTrib errado gera rejeição mesmo com valores certos. Os dois códigos têm guias próprios no blog: tabela de CST do IBS e da CBS e o que é cClassTrib e como preencher.

Tela de notebook com linhas de código desfocadas ao lado de uma nota fiscal impressa e uma caneca azul

Exemplo de item com as alíquotas de 2026

Exemplo da Redação Beevix (2026), com valores hipotéticos: uma distribuidora do regime normal vende um item de R$ 1.000,00 com tributação integral. Em 2026, a LC 214/2025 fixa alíquota de teste de 0,9% para a CBS (art. 346) e de 0,1% para o IBS estadual (art. 343). Não há IBS municipal em 2026.

CampoGrupoValor no exemplo
vBCgIBSCBS1000.00
pIBSUF / vIBSUFgIBSUF0.1000 / 1.00
pIBSMun / vIBSMungIBSMun0.0000 / 0.00
pCBS / vCBSgCBS0.9000 / 9.00
Total de IBS e CBS do item—10.00

A conta: 0,1% de R$ 1.000,00 é R$ 1,00 de IBS; 0,9% de R$ 1.000,00 é R$ 9,00 de CBS. Pelo art. 348 da LC 214/2025, o valor de 2026 pode ser compensado com PIS e Cofins devidos, e fica dispensado o recolhimento para quem cumprir as obrigações acessórias. Empresas do Simples Nacional não aplicam essas alíquotas em 2026 (art. 348, III, "c"). O CST, o cClassTrib e as reduções do seu produto dependem da operação real e devem ser conferidos com a contabilidade.

"Em 2026 o valor é pequeno, mas o XML precisa sair completo. O teste é de cadastro, não de alíquota." — Equipe Beevix, redação fiscal

Cronograma da NT 2025.002

DataO que aconteceu ou acontecePara quem
Out/2025Campos de IBS e CBS aceitos em produção, de forma facultativa, sem valor jurídico para os novos tributosCRT 3 (regime normal)
Jan/2026Informações dos novos tributos passam a ter valor jurídico; preenchimento obrigatório pela legislação, ainda sem rejeiçãoCRT 3
01/07/2026Regra UB12-10 em homologação: nota sem grupo IBSCBS é rejeitada no ambiente de testes (rejeição 1115)CRT 3
05/10/2026Na devolução, a referência à nota original passa a ser feita só no grupo DFeReferenciado, em produção (a data anterior, 01/09/2026, foi alterada)Todos que fazem devolução
03/11/2026Novo leiaute da tributação monofásica de combustíveis em produçãoSetor de combustíveis
Sem dataRegra UB12-10 em produção: as datas de 03/08/2026 (regime normal) e 04/01/2027 (Simples e MEI) foram riscadas na versão 1.51 e substituídas por "implementação futura"Todos

A própria nota técnica avisa que as orientações específicas para Simples Nacional, MEI e tributação monofásica serão publicadas em nota futura, porque a tributação do IBS, da CBS e do IS para esses contribuintes começa em 2027, conforme o art. 348 da LC 214/2025. Há exceções à rejeição 1115 para devoluções e complementares que referenciam notas antigas e para combustíveis da tabela monofásica; o guia sobre a rejeição 1115 detalha os casos.

Na prática

Emissor atualizado, cadastro no lugar

Emita NF-e e NFC-e com os campos da reforma tributária e mantenha CST, cClassTrib e NCM no cadastro de cada produto.

Ver planos do Beevix →

Notas de crédito e de débito: as finalidades novas

A NT 2025.002 acrescenta duas finalidades de emissão à tag finNFe, que já tinha normal (1), complementar (2), ajuste (3) e devolução (4):

FinalidadeAlguns tipos previstos
5 = Nota de crédito (tpNFCredito)01 multa e juros; 03 retorno por recusa total na entrega ou por não localização do destinatário; 04 redução de valores; 06 retorno por recusa parcial na entrega
6 = Nota de débito (tpNFDebito)03 débitos de notas não processadas na apuração; 04 multa e juros; 06 pagamento antecipado; 07 perda em estoque (perecimento, perda, furto, roubo); 08 desenquadramento do Simples Nacional

Essas notas servem para ajustar o IBS e a CBS da apuração sem mexer na operação original. A perda de estoque, por exemplo, ganha um tipo próprio de nota de débito. Para a regra atual de baixa de mercadoria perdida, veja o guia da nota fiscal de perda, roubo ou deterioração. Para devoluções, o guia de nota fiscal de devolução continua valendo, agora com a referência no grupo DFeReferenciado. O passo a passo da nota de crédito, com exemplo, está no guia de nota fiscal de estorno.

Assistente de faturamento de uma distribuidora confere dados da nota no computador segurando um documento de entrega

Checklist para a empresa e para o emissor

  1. Atualize o emissor para o schema da versão vigente da NT 2025.002 e confirme que ele preenche os grupos UB, VB, VC e W03.
  2. Revise o cadastro de produtos com NCM, CST do IBS e da CBS e cClassTrib, por grupo de produtos.
  3. Teste em homologação as operações mais comuns da empresa: venda, devolução, remessa e bonificação.
  4. Ajuste as devoluções para referenciar a nota original no grupo DFeReferenciado.
  5. Acompanhe as novas versões no Portal Nacional da NF-e; a nota técnica teve mais de dez versões desde março de 2025.

No Beevix, a emissão de NF-e e a emissão de NFC-e ficam ligadas ao cadastro de produtos e ao estoque. Veja também os segmentos de distribuição e atacado e os demais segmentos atendidos.

Fontes oficiais

Perguntas frequentes

O que é a NT 2025.002?

É a nota técnica do Portal Nacional da NF-e que inclui no XML da NF-e e da NFC-e os campos e as regras de validação do IBS, da CBS e do Imposto Seletivo, criados pela reforma tributária do consumo.

Empresa do Simples Nacional precisa preencher o grupo IBSCBS em 2026?

Não. A LC 214/2025 diz que as alíquotas de teste de 2026 não se aplicam aos optantes pelo Simples (art. 348, III, "c"), e a nota técnica informa que as orientações para Simples Nacional e MEI virão em nota futura, porque a tributação desses contribuintes começa em 2027. Na versão 1.51, a rejeição em produção consta como implementação futura.

O DANFE mudou com a NT 2025.002?

Ainda não. A seção 9 da nota técnica diz que as alterações no DANFE para exibir os novos tributos estão em estudo e serão publicadas em versão futura.

O que é nota de crédito e nota de débito na NF-e?

São as finalidades 5 e 6 da tag finNFe, criadas pela NT 2025.002 para ajustar valores de IBS e CBS. Cada uma tem tipos próprios, como redução de valores, retorno por recusa na entrega, pagamento antecipado e perda em estoque.

Quais alíquotas de IBS e CBS vão no XML em 2026?

Para o regime normal, a LC 214/2025 prevê 0,9% de CBS e 0,1% de IBS estadual em 2026, com possibilidade de compensação com PIS e Cofins e dispensa de recolhimento para quem cumprir as obrigações acessórias. Reduções dependem do cClassTrib do produto.

Próximo passo: emita uma nota de teste completa

Escolha seu produto mais vendido, confira CST e cClassTrib e emita uma nota em homologação com o grupo IBSCBS preenchido. Se o emissor atual não acompanha as versões da nota técnica, veja os planos e preços do Beevix ou faça o teste grátis de 30 dias, sem cartão.

Coloque isso em prática com o Beevix

Estoque, vendas, financeiro e nota fiscal no mesmo lugar, com 30 dias de teste grátis.

Ver planos e preços
Falar no WhatsApp