vIBSUF total: somar o IBS estadual dos itens da NF-e

vIBSUF em total/IBSCBSTot/gIBS/gIBSUF é o valor total do IBS estadual da nota. Ele consolida o imposto estadual calculado nos itens; não representa a base de cálculo, a parcela municipal ou o IBS monofásico.

Localização e representação no XML

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

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.

A soma usa o imposto dos itens, sem recalcular pela média

A regra W41-10 compara o total com det/imposto/IBSCBS/gIBSCBS/gIBSUF/vIBSUF, para NF-e e NFC-e, modelos 55 e 65. A divergência está associada à rejeição 1080. Usar uma alíquota média sobre a soma das bases pode produzir resultado diferente quando os itens têm reduções, diferimento, devolução ou arredondamentos próprios. A conferência deve partir dos valores finais de item. NT 2025.002 v1.52, pp.29 e 70.

Como ler as três parcelas de gIBSUF

vDif identifica o diferimento; vDevTrib, a devolução; vIBSUF, o imposto estadual. São três somas diferentes. O gIBS/vIBS reúne o IBS dos itens, enquanto gIBSMun/vIBSMun identifica a componente municipal. Não acrescente a CBS, que tem seu próprio gCBS, nem o monofásico registrado em gMono.

Exemplo: o diferimento já está refletido no item

Hipótese sintética: os valores finais estaduais de dois itens são R$ 25,00 e R$ 15,00. O total vIBSUF é R$ 40,00. Se os itens também informam R$ 10,00 de diferimento, esse valor é totalizado separadamente em vDif; ele não transforma os R$ 40,00 em R$ 30,00 por uma segunda dedução. A demonstração pressupõe que os cálculos de item estão corretos.

Verificações úteis quando o total parece correto

Confira os caminhos completos no XML efetivamente enviado, não apenas no relatório do ERP. Um vIBSUF calculado, mas não serializado, não integra a soma transmitida. Se o total divergir por centavos, compare os valores monetários já arredondados nos itens antes de buscar ajustes no total. Se o erro vier da incidência ou da alíquota, reúna CST, cClassTrib, data, produto e fundamento para confirmar o parâmetro adequado.

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 vIBSUF, 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.

<vIBSUF xmlns="http://www.portalfiscal.inf.br/nfe">40.00</vIBSUF>

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:

• vDif do IBS estadual: conferir o diferimento total da NF-e.
• vIBS total da NF-e: reconciliar o IBS dos itens.