vIBS total da NF-e: reconciliar o IBS dos itens

vIBS em total/IBSCBSTot/gIBS é o total do IBS informado nos itens no grupo de tributação correspondente. Ele fica ao lado dos totais de crédito presumido e dos grupos estadual e municipal; não deve absorver automaticamente CBS, créditos ou os valores monofásicos.

Localização e representação no XML

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

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 regra compara vIBS de item com vIBS de total

W47-10, modelos 55 e 65, determina somar det/imposto/IBSCBS/gIBSCBS/vIBS. A rejeição associada é 1085. O total não é uma nova apuração sobre a base global: representa a consolidação dos valores dos itens. A relação entre o IBS estadual e o municipal deve ser conferida primeiro em cada item e depois nos respectivos totais. NT 2025.002 v1.52, pp.29 e 71.

O que não entra como parcela adicional

Os totais vCredPres e vCredPresCondSus representam créditos, e não somas adicionais ao imposto. vDif e vDevTrib têm totalizadores próprios; não reaplique no total uma redução já incorporada ao valor do item. IBS monofásico permanece em IBSCBSTot/gMono, com categorias próprias. Somar tudo o que contenha as letras IBS contaria grandezas diferentes.

Exemplo de reconciliação em duas direções

Hipótese sintética: item 1 tem IBS estadual de R$ 12,00 e municipal de R$ 3,00, com vIBS de R$ 15,00; item 2 tem R$ 8,00 e R$ 2,00, com vIBS de R$ 10,00. A soma de item resulta R$ 25,00; os totais estadual R$ 20,00 e municipal R$ 5,00 também permitem conferir R$ 25,00. Isso demonstra uma nota com essas premissas, sem prescrever alíquotas.

Como explicar uma diferença ao integrar o emissor

Compare os dois vIBS dos itens com o total e confira os grupos estadual e municipal separadamente. Uma divergência apenas entre a soma das componentes e o imposto de item exige revisar o cálculo do item; uma divergência apenas no cabeçalho sugere agregação ou serialização. A análise depende do XML do mesmo documento e ambiente; não edite uma nota autorizada para fazê-la fechar.

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

<vIBS xmlns="http://www.portalfiscal.inf.br/nfe">25.00</vIBS>

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.
• gMono nos totais: as seis parcelas monofásicas de IBS e CBS.