vIBSMun no total: valor do IBS municipal e rejeição 1084

vIBSMun em /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun/vIBSMun é o valor total do IBS municipal no ramo comum. Não é a alíquota municipal nem o total conjunto de IBS estadual e municipal.

Identidade técnica: tag; XPath /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun/vIBSMun.

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:

• Qual campo dos itens alimenta esse total
• Exemplo de soma sem presumir alíquota
• Conferir um retorno de diferença municipal
• Exemplo XML e hipóteses do fragmento
• Versão e cronograma: o que conferir no ambiente
• Leituras relacionadas

Qual campo dos itens alimenta esse total

W46-10/1084, p.71 da NT 2025.002 v1.52, compara o campo com a soma de vIBSMun informado nos itens. O caminho correspondente é det/imposto/IBSCBS/gIBSCBS/gIBSMun/vIBSMun. O XSD PL 010f v1.04 exige vIBSMun quando gIBSMun total existe, depois de vDif e vDevTrib. Usa TDec1302RTC, com duas casas quando fracionário e sem sinal.

Não se aplica uma alíquota média ao valor total dos produtos para obter essa consolidação. As bases, alíquotas, reduções e diferimentos são tratados no cálculo de cada item; o total preserva o resultado correspondente.

Exemplo de soma sem presumir alíquota

Em uma hipótese didática, dois itens têm vIBSMun já apurado de R$ 0,40 e R$ 0,20. O total é R$ 0,60, mostrado parcialmente como <vIBSMun>0.60</vIBSMun> dentro de gIBSMun total. O exemplo usa resultados sintéticos e não indica uma alíquota municipal aplicável ao leitor.

O vIBSUF da mesma nota fica no componente estadual; vIBS total fica no pai gIBS; CBS fica em gCBS. Créditos presumidos e estornos também têm campos próprios. Não os acrescente ou subtraia automaticamente deste total. Se os itens já refletem diferimento no vIBSMun, repetir a dedução no total produziria um valor distinto do somatório exigido.

Conferir um retorno de diferença municipal

Liste nItem, vIBSMun efetivo e total. Use aritmética decimal e os valores do arquivo que gerou o retorno. Confira se houve arredondamento só na interface, duplicação, omissão de item ou filtro indTot aplicado indevidamente a essa regra de imposto.

Se os valores individuais estiverem incorretos, a correção começa em base, alíquota confirmada e demais parcelas do item. Se estiverem corretos e a soma divergente, investigue agregação e serialização. Não altere a alíquota para fazer o somatório fechar. Registre ambiente, versão e mensagem, corrija a causa demonstrada e preserve XML assinado/autorizado.

Exemplo XML e hipóteses do fragmento

O valor sintético soma IBS municipal de R$0,40 e R$0,20 já apurado nos itens. O campo é parcial a gIBSMun total e não recomenda alíquota municipal.

<vIBSMun xmlns="http://www.portalfiscal.inf.br/nfe">0.60</vIBSMun>

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 grupo separa imposto, diferimento e devolução municipal. gIBSMun — /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun.