vIBSMonoReten total: IBS monofásico sujeito à retenção
<vIBSMonoReten>total › IBSCBSTot › gMono › vIBSMonoRetenRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vIBSMonoReten, no total IBSCBSTot/gMono, consolida o IBS monofásico sujeito à retenção. A terminação Reten o distingue de vIBSMonoRet, que informa imposto retido anteriormente.
Localização e representação no XML
XPath da ocorrência: /nfeProc/NFe/infNFe/total/IBSCBSTot/gMono/vIBSMonoReten.
| Propriedade no PL 010f v1.04 | Valor |
|---|---|
| Tipo | TDec1302RTC |
| Ocorrência no pai | 1–1 |
| Namespace | http://www.portalfiscal.inf.br/nfe |
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.
Onde buscar a parcela de retenção do IBS
Na estrutura reformulada, use det/imposto/IBSCBS/gIBSCBSMono/gIBSMonoAdRem/gMonoReten/vIBSMonoReten ou a alternativa gIBSMonoAdValorem. W59a-10, modelos 55/65, compara a soma dos valores dos itens com o total e associa a divergência à rejeição 1120. O total recebe moeda; quantidade e alíquota continuam nos campos de cálculo do item. NT 2025.002 v1.52, pp.22–24 e 71.
O fechamento monofásico não substitui esta parcela
vTotIBSMonoItem representa o resultado de fechamento no item. vIBSMono é a parcela padrão e vIBSMonoRet é a retenção anterior. As três informações não podem ser copiadas umas para as outras. O ICMS sujeito à retenção usa vICMSMonoReten em outro grupo; a integração deve manter tributo e categoria em sua chave de agregação.
Exemplo com valores de retenção individualizados
Hipótese sintética: item 1 informa R$ 13,00 e item 2, R$ 17,00 de IBS sujeito à retenção. O total é R$ 30,00. Outros R$ 20,00 de IBS padrão não entram neste campo; permanecem em vIBSMono. A soma demonstra apenas a reconciliação de parcelas já definidas para os itens.
Exigência da retenção e valor de item têm verificações próprias
Na modalidade IBS Ad Rem, UB87-10/1127 exige gMonoReten conforme ind_gMonoReten; UB87-20/1128 verifica sua informação quando vedada. UB87c-10/1222 confere o valor de retenção pelo produto qBCMonoReten × adRemIBSReten. Esses retornos localizam o problema em um item; a mensagem 1120/W59a-10 localiza divergência na consolidação.
Hipótese sintética de modalidade Ad Rem em ano compatível: 10 unidades tributáveis sujeitas à retenção × R$ 1,30 por unidade = R$ 13,00. Este valor explica o primeiro item do exemplo, sem sugerir parâmetro real. Para IBS, Ad Rem é a modalidade prevista a partir de 2029; até 2028, a matriz utiliza Ad Valorem, cuja retenção tem campos próprios em UB92 e verificação UB92c-10. A regra de soma não permite antecipar a transição nem copiar automaticamente a alíquota do IBS padrão para a parcela retida. NT 2025.002 v1.52, pp.53–54 e 57.
Como investigar 1120
Confira o XML da tentativa, liste apenas os valores gMonoReten/vIBSMonoReten e compare com o cabeçalho. Verifique se um mapper usou a parcela Ret, um fechamento de item ou um grupo de ICMS. Se a dúvida for a obrigação de retenção, é necessário confirmar classificação, operação, modalidade e documentos do combustível com o responsável fiscal, antes de alterar os cálculos.
Cronograma da estrutura reformulada
A disponibilidade de gMonoReten no XSD não antecipa a modalidade IBS Ad Rem prevista para 2029. Quanto à implantação técnica da reformulação, o PDF v1.52 traz 03/11/2026; há, porém, aviso posterior ENCAT de 05/10/2026 que inclui a v1.52 entre as NTs com homologação em 05/out adiadas para 26/10/2026 em homologação e 16/11/2026 em produção. Sem discriminar cada regra, esse aviso deve ser lido junto do PDF. Os caminhos aqui são do PL 010f v1.04; documentos antigos e tentativas de ambientes distintos precisam ser confrontados com o pacote efetivamente aplicável. NT 2025.002 v1.52, p.6; comunicado ENCAT de 05/10/2026.
Fragmento XML e limites da conferência
Fragmento sintético da tag vIBSMonoReten, 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.
<vIBSMonoReten xmlns="http://www.portalfiscal.inf.br/nfe">30.00</vIBSMonoReten>
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:
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/total/IBSCBSTot/gMono/vIBSMonoReten- 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