vDif de CBS no total: diferimento consolidado sem duplicar a dedução

vDif em /nfeProc/NFe/infNFe/total/IBSCBSTot/gCBS/vDif informa o diferimento total de CBS. Ele registra uma parcela específica do tributo nos itens; não representa desconto, devolução ou crédito.

Identidade técnica: tag; XPath /nfeProc/NFe/infNFe/total/IBSCBSTot/gCBS/vDif.

Para consultas XPath com prefixos, associe n a http://www.portalfiscal.inf.br/nfe em cada elemento. Em XML cuja raiz é NFe, retire o ancestral nfeProc da consulta; não remova namespaces do documento original.

Nesta página:

• Origem e formato do diferimento total
• Exemplo: somar o valor diferido, não o imposto inteiro
• Diagnóstico quando o total diverge
• Exemplo XML e hipóteses do fragmento
• Versão e cronograma: o que conferir no ambiente
• Leituras relacionadas

Origem e formato do diferimento total

O valor correspondente nos itens fica em det/imposto/IBSCBS/gIBSCBS/gCBS/gDif/vDif. W53-10/1088, na NT 2025.002 v1.52, p.71, compara o total com esse somatório. A alíquota e o percentual de diferimento são parâmetros do item; não existe percentual médio a preencher no total.

No XSD PL 010f v1.04, vDif é o primeiro filho obrigatório do grupo total gCBS. Usa TDec1302RTC, com até 13 algarismos inteiros, duas casas quando fracionário e sem sinal. Se gCBS foi informado e a inexistência de diferimento foi apurada, o campo pode representar zero; desconhecer o parâmetro não permite assumir zero.

Exemplo: somar o valor diferido, não o imposto inteiro

Suponha dois itens cujos valores de diferimento de CBS já estejam documentados e calculados em R$ 1,20 e R$ 0,80. O total vDif é R$ 2,00. Um fragmento parcial seria <vDif>2.00</vDif> dentro de gCBS total.

Essa soma não altera o vCBS informado em cada item. Se a CBS de um item já foi calculada considerando seu diferimento, subtrair de novo os R$ 2,00 do vCBS total duplicaria a dedução. vDevTrib continua representando devolução de tributo; vCredPres e vCredPresCondSus continuam sendo créditos próprios. Proximidade no XML não os torna parcelas equivalentes.

Diagnóstico quando o total diverge

Associe a mensagem 1088 à CBS e ao ancestral total correto. Compare o valor diferido em cada gCBS/gDif com o consolidado. Confira se a integração somou pDif como dinheiro, incluiu vDif de IBS, ignorou um item ou usou valores exibidos com arredondamento diferente dos serializados.

Se o problema estiver no cálculo do diferimento do item, confirme base, alíquota aplicável, eventual redução e percentual de diferimento com a documentação correspondente antes de recalcular. O total não resolve a decisão de incidência. Registre o ambiente e a versão da regra, corrija a origem comprovada e preserve XML autorizado.

Exemplo XML e hipóteses do fragmento

O valor sintético soma R$1,20 e R$0,80 de diferimento de CBS já apurados nos itens. O campo é parcial ao grupo gCBS total e não define o percentual de diferimento.

<vDif xmlns="http://www.portalfiscal.inf.br/nfe">2.00</vDif>

A validação desse fragmento é estrutural e limitada à declaração do seu caminho. Não equivale à validação da nota completa, à assinatura ou à autorização.

Versão e cronograma: o que conferir no ambiente

A estrutura descrita foi conferida no PL 010f v1.04. O snapshot da ficha pode oferecer PL 010e v1.02; uma afirmação sobre o pacote mais novo não deve ser atribuída automaticamente a todo arquivo histórico.

A NT 2025.002 v1.52 é a edição de setembro de 2026, publicada no catálogo em 1º/10/2026. O aviso ENCAT de 5/10/2026 adiou as alterações dessa rodada para 26/10/2026 em homologação e 16/11/2026 em produção. Essas datas não suspendem todas as regras anteriores nem tornam ativas as regras que continuam marcadas como implementação futura. Em 14/10/2026, os dois novos marcos ainda eram futuros.

Separe a existência de uma tag no schema, a condição fiscal da operação e a ativação da regra de negócio. A condição legal não se deduz da ausência de rejeição, e o cronograma não comprova implantação em cada autorizadora. Registre data, modelo, ambiente, pacote usado e retorno para interpretar uma divergência concreta.

Leituras relacionadas

O valor da contribuição totaliza o que já foi calculado nos itens. vCBS — /nfeProc/NFe/infNFe/total/IBSCBSTot/gCBS/vCBS.