Somatório dos itens diverge do total da nota

O que significa

A soma do IBS de todos os itens (`vIBSUF` + `vIBSMun`) deve fechar com o total declarado em `<total><IBSCBSTot><vIBS>`. Quando não fecha, algum item ficou de fora do somatório ou o total foi calculado com uma base diferente da dos itens.

Exemplo — errado × certo

<!-- 3 itens somando R$ 280,00 de IBS -->
<total><IBSCBSTot><vIBS>250.00</vIBS></IBSCBSTot></total>

<!-- 3 itens somando R$ 280,00 de IBS -->
<total><IBSCBSTot><vIBS>280.00</vIBS></IBSCBSTot></total>

Como corrigir no seu ERP

1. Verifique se o totalizador soma todos os itens da nota, incluindo os que têm CST de diferimento/suspensão (que ainda entram na base, mesmo sem destaque de valor).
2. Rode o fechamento do total como um teste automatizado sempre que mexer no motor de cálculo por item.

Referência normativa

Somatório dos itens deve fechar com os totais da nota (NT 2025.002).

Impacto se não corrigir

É um sinal de alerta (aviso, não bloqueante) — mas indica que a apuração agregada da nota não é confiável, o que compromete a reconciliação mensal.