vDif do IBS estadual: conferir o diferimento total da NF-e

vDif, dentro de total/IBSCBSTot/gIBS/gIBSUF, registra o total do diferimento do IBS de competência estadual. É uma quantia monetária do documento, e não o percentual de diferimento nem o IBS estadual devido. A mesma tag aparece nos totais municipais e da CBS; o ancestral gIBSUF é o que identifica esta ocorrência.

Localização e representação no XML

XPath da ocorrência: /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSUF/vDif.

Valor não negativo de até 13 algarismos inteiros; zero é admitido e a parte decimal, quando usada, tem duas casas. O filho é exigido quando o grupo de IBS/CBS correspondente é informado. Para consultas XPath, associe o prefixo nfe: ao namespace; em arquivos sem nfeProc, comece em NFe. XSD oficial.

De quais itens vem o total estadual

A origem é det/imposto/IBSCBS/gIBSCBS/gIBSUF/gDif/vDif. Some somente o diferimento estadual efetivamente informado nos itens. O pDif participa do cálculo no item; não entra no total como percentual nem deve ser somado. A regra W38-10, para modelos 55 e 65, compara esse somatório com o campo W38 e usa a rejeição 1077 quando divergem. NT 2025.002 v1.52, pp.29 e 70.

Diferimento, devolução e valor devido não são intercambiáveis

No total gIBSUF, a sequência é vDif, vDevTrib, vIBSUF. vDevTrib resume devolução de tributos; vIBSUF resume o IBS estadual dos itens. Não se deve somar o diferimento ao imposto devido nem subtraí-lo novamente de um valor de item que já o considerou. Se o cálculo do item estiver incorreto, alterar apenas W38 deixará o erro original preservado.

Exemplo com componentes que precisam permanecer separados

Hipótese sintética: dois itens já calculados têm diferimento estadual de R$ 12,00 e R$ 18,00; os mesmos itens têm, ao todo, R$ 5,00 de diferimento municipal. O vDif estadual é 12,00 + 18,00 = R$ 30,00. Informar R$ 35,00 mistura componentes; R$ 5,00 pertence ao gIBSMun/vDif. Os parâmetros que permitiram o diferimento já são premissas, não uma indicação de benefício para a operação do leitor.

Como localizar a divergência 1077

Exporte o XML gerado e monte uma linha por nItem com o XPath estadual completo. Compare a soma dos valores serializados com W38; depois procure item duplicado, diferimento municipal agregado por engano ou total calculado antes da última alteração do item. Corrija a geração ou a origem comprovada dos valores e valide novamente o XML. O percentual e o fundamento do diferimento precisam ser confirmados com a documentação da operação; a rejeição não determina esses parâmetros.

Versão estrutural e vigência de validações

A estrutura foi conferida no PL 010f v1.04 e as regras citadas, na NT 2025.002 v1.52. A disponibilidade de uma tag não prova adoção de todo o pacote por uma autorizadora nem incidência fiscal. O cronograma da NT separa versões, regras e ambientes; a data de uma alteração de referenciamento ou da reformulação monofásica não deve ser atribuída a este total. Para uma nota histórica, use a versão e a norma pertinentes à data da operação. NT 2025.002 v1.52, pp.4–7.

O aviso ENCAT de 05/10/2026 inclui a NT 2025.002 v1.52 entre as NTs previstas para homologação em 05/out e anuncia 26/10/2026 em homologação e 16/11/2026 em produção. Esse adiamento das alterações abrangidas não deve ser interpretado como data de nascimento deste campo, nova obrigatoriedade geral ou ativação das regras expressamente futuras. Aviso oficial ENCAT.

Fragmento XML e limites da conferência

Fragmento sintético da tag vDif, no ancestral indicado acima, com o resultado do exemplo. É parcial: não contém o grupo pai completo nem uma nota pronta para transmissão.

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

O XSD confere a representação, não a apuração nem a autorização. Preserve o XML autorizado; a correção de divergências exige identificar sua origem e o procedimento fiscal aplicável.

Comparações para aprofundar a conferência

As diferenças essenciais entre as parcelas foram explicadas acima. Para acompanhar os campos relacionados em seu próprio contexto XML:

• vIBSUF total: somar o IBS estadual dos itens da NF-e.
• vIBS total da NF-e: reconciliar o IBS dos itens.