vCBSMonoReten total: CBS monofásica sujeita à retenção
<vCBSMonoReten>total › IBSCBSTot › gMono › vCBSMonoRetenRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vCBSMonoReten, em total/IBSCBSTot/gMono, totaliza a CBS monofásica sujeita à retenção. Não é o valor padrão da CBS, nem a CBS cuja retenção já ocorreu anteriormente.
Localização e representação no XML
XPath da ocorrência: /nfeProc/NFe/infNFe/total/IBSCBSTot/gMono/vCBSMonoReten.
| 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.
A origem específica da parcela Reten
Os caminhos da estrutura reformulada são det/imposto/IBSCBS/gIBSCBSMono/gCBSMonoAdRem/gMonoReten/vCBSMonoReten e a alternativa com gCBSMonoAdValorem. A regra W59b-10 compara os valores dos itens com o total e identifica a divergência por 1121 nos modelos 55/65. Quantidade, alíquota e modalidade participam do cálculo de cada item; não devem ser transportadas para o total como se fossem montantes. NT 2025.002 v1.52, pp.24–26 e 71.
O total tem uma função diferente do Ret
vCBSMonoRet informa a tributação retida anteriormente; Reten identifica a parcela sujeita à retenção. São categorias próprias, e não abreviações alternativas do mesmo campo. vCBSMono informa o padrão. O total de fechamento vTotCBSMonoItem tem sua regra no item; copiar esse fechamento para Reten incorporaria parcelas de outra natureza.
Exemplo de retenção consolidada
Hipótese sintética: dois itens contêm R$ 9,00 e R$ 21,00 de vCBSMonoReten. O total é R$ 30,00, mesmo que a nota também tenha R$ 50,00 de CBS padrão ou R$ 12,00 retidos anteriormente. Esses outros valores continuam em suas tags. Não há escolha de produto, CST ou alíquota no exemplo.
Conferência de retenção no item vem antes da W59b-10
O indicador ind_gMonoReten da classificação tributária controla a exigência ou vedação de gMonoReten. Na CBS Ad Rem, UB97-10/1250 trata de grupo não informado quando exigido; UB97-20/1251, de grupo indevido. UB97c-10/1252 compara vCBSMonoReten com qBCMonoReten × adRemCBSReten. Esses códigos são de item e não devem ser chamados de rejeição 1121 do total.
Hipótese aritmética da modalidade Ad Rem em ano/ambiente compatíveis: 10 unidades sujeitas à retenção × R$ 0,90 por unidade = R$ 9,00; esse é o primeiro valor de item do exemplo. A quantidade própria pode ser diferente da sujeita à retenção. A matriz prevê CBS Ad Rem a partir de 2027, enquanto o uso em 2026 tem a exceção de homologação expressa em UB95a-10. Ad Valorem usa os campos e a regra UB102c-10 próprios; escolher a modalidade não cabe ao total. NT 2025.002 v1.52, pp.59–60 e 63.
Diagnóstico técnico da rejeição 1121
Compare os dois valores dos itens, o momento de cálculo do cabeçalho e o XML enviado. Busque troca entre Ret e Reten, soma de CBS padrão ou seleção de caminho anterior à reformulação. Corrija a origem comprovada. A obrigação material de reter depende da operação, classificação e documentação aplicáveis; o sufixo da tag não decide essa obrigação.
Cronograma da estrutura reformulada
A validação de soma W59b-10 e a disponibilidade das alternativas de item não são o mesmo marco. O cronograma da reformulação v1.50 aparece na v1.52 com produção em 03/11/2026, mas há comunicado posterior de 05/10/2026: ENCAT postergou as NTs previstas para homologação em 05/out, com v1.52 na lista, para 26/10 em homologação e 16/11 em produção de 2026. O aviso não descreve novamente o alcance de cada linha do PDF. Para uma tentativa específica, confira a autorizadora, o ambiente e o pacote aceito; não conclua que toda retenção passou a usar a estrutura nova em 03/11. 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 vCBSMonoReten, 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.
<vCBSMonoReten xmlns="http://www.portalfiscal.inf.br/nfe">30.00</vCBSMonoReten>
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/vCBSMonoReten- 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