Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Totais

vCBSMonoReten total: CBS monofásica sujeita à retenção

<vCBSMonoReten>total › IBSCBSTot › gMono › vCBSMonoReten

Revisã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