vTotIBSMonoItem: total do IBS monofásico por item
<vTotIBSMonoItem>det › imposto › IBSCBS › gIBSCBSMono › vTotIBSMonoItemRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vTotIBSMonoItem informa o total do Imposto sobre Bens e Serviços (IBS) monofásico de um item. A tag fica em det/imposto/IBSCBS/gIBSCBSMono, fora do grupo de tributação regular gIBSCBS. O sufixo Item é decisivo: o campo não resume todos os produtos da NF-e.
Caminho desta página: /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBSMono/vTotIBSMonoItem. O prefixo nfeProc identifica a nota processada; a informação estudada pertence ao conteúdo da NF-e, dentro de NFe/infNFe.
Composição e diferenças entre parcelas
A NT 2025.002 v1.52 define, na UB105a-10, vTotIBSMonoItem = vIBSMono + vIBSMonoReten. O primeiro valor corresponde ao IBS próprio; o segundo, ao sujeito à retenção. O IBS já retido anteriormente é informado em vIBSMonoRet e não é acrescentado novamente nessa fórmula.
No leiaute reformulado, o IBS pode ser representado em ramo ad rem ou ad valorem, conforme as condições documentadas. No ramo ad valorem, vIBSMono resulta dos valores estadual e municipal. Somar simultaneamente vIBSMono, vIBSMonoUF e vIBSMonoMun duplicaria a tributação própria. A totalização precisa reconhecer a hierarquia do XML, não somente procurar nomes parecidos. NT v1.52, p. 24 e 65.
Uma conta que evita duplicidade
Assuma valores sintéticos já apurados: R$ 7,00 de IBS próprio e R$ 2,00 sujeitos à retenção. O total do item é R$ 9,00. Um registro de R$ 4,00 cobrados anteriormente não eleva esse total a R$ 13,00. Se os R$ 7,00 próprios tiverem sido formados por parcelas de R$ 5,00 estadual e R$ 2,00 municipal, essas parcelas já estão dentro dos R$ 7,00.
Fragmento parcial da declaração do campo, sem nota completa, assinatura ou autorização:
<vTotIBSMonoItem xmlns="http://www.portalfiscal.inf.br/nfe">9.00</vTotIBSMonoItem>
O tipo monetário TDec1302RTC exige a representação admitida pelo XSD, com ponto decimal. A quantidade tributada e as alíquotas não devem ser inferidas dividindo esse total pelo valor comercial do item: existem parcelas de natureza diferente.
Conferência no XML e na memória de cálculo
Escolha o item correto pelo atributo nItem, identifique o ramo monofásico e relacione cada valor ao cálculo que o originou. Em seguida compare o total do item com as parcelas monetárias serializadas. Para diferenças pequenas, verifique o estágio de arredondamento no emissor; para diferenças maiores, procure duplicidade de componentes, retenção anterior indevida ou total de outro item.
O fechamento da nota é outra etapa: múltiplos itens precisam ser reconciliados com seus totais próprios, respeitando as categorias do totalizador. Não substitua o valor deste item pelo total monofásico de todos os itens. Se um importador usa o mesmo nome simplificado para campos diferentes, conserve o XPath completo no diagnóstico e corrija o mapeamento de origem comprovadamente incorreto.
Rejeição 1070 e vigência da validação
A regra UB105a-10 relaciona esse cálculo à mensagem 1070 e aceita diferença de R$ 0,01 para mais ou para menos. Entretanto, a linha da NT v1.52 declara implementação futura. Isso deve acompanhar qualquer referência ao código: o manual documenta a validação, mas a página não afirma que ela já esteja sendo executada em produção.
O aviso ENCAT de 05/10/2026 muda as datas das alterações então previstas para 05/out para 26/10 em homologação e 16/11 em produção. A revisão de cronograma tem alcance específico; não demonstra a implantação de UB105a-10 nem revoga regras anteriores. Um XML aprovado no XSD também não demonstra que o cálculo foi validado pelo autorizador. Preserve a mensagem real, ambiente, UF e versão do emissor ao investigar. Aviso oficial.
Parâmetros que precisam estar definidos
A montagem técnica pode conferir campos e somas, mas não selecionar a tributação do produto. Leve ao responsável fiscal a identificação do combustível, classificação tributária, etapa da cadeia, unidade aplicável e os documentos que fundamentam retenção própria ou anterior. A partir dos parâmetros confirmados, a comparação entre cálculo, parcelas e XML passa a ter significado; apenas um total isolado não resolve a aplicabilidade.
O total da outra contribuição tem conferência própria: vTotCBSMonoItem.
Fontes oficiais
- Tipos comuns RTC — PL_010f_v1.04: TMonofasia l1451–1839; vTotIBSMonoItem l1828; TDec1302RTC
- NT 2025.002 — RTC — 1.52, setembro/2026: UB14a, p. 18; UB105a/b e UB106, p. 27 e 65; UB13-20/30, p. 40; cronograma p. 4–7
- ENCAT — alteração de datas de implantação — 05/10/2026: Aviso de 05/10/2026: alterações antes previstas para 05/out; não é suspensão de todas as regras anteriores
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBSMono/vTotIBSMonoItem- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 1–1 no contexto do elemento pai
- Tipo
- TDec1302RTC · string
- Preenchimento no catálogo
- Condicional
A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.
- pattern
0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?- whiteSpace
preserve