vCBSMonoRet no grupo legado: valor da CBS retida anteriormente

vCBSMonoRet era o valor da CBS monofásica retida anteriormente no antigo grupo conjunto gMonoRet. A declaração histórica /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBSMono/gMonoRet/vCBSMonoRet está no PL_010e_v1.02. O PL_010f_v1.04 mantém o nome em ramos próprios de CBS, mas o caminho direto antigo é legado.

Valor anterior e valor sujeito à retenção não são a mesma parcela

A NT 2025.002 v1.40, página 23 descrevia vCBSMonoRet como o valor da CBS retida anteriormente, relacionado à quantidade qBCMonoRet e à alíquota por unidade adRemCBSRet. O grupo tinha contexto de tributação monofásica própria cobrada anteriormente, com aplicação condicionada ao indicador ind_gMonoRet.

Já vCBSMonoReten, com final Reten, era a parcela sujeita à retenção no grupo gMonoReten. Confundir os dois nomes pode transformar informação anterior em parcela nova de uma composição. O nome do relatório “CBS retida” é insuficiente: identifique a tag, o ancestral e o documento de origem.

O PL_010e_v1.02 define vCBSMonoRet como último dos cinco filhos obrigatórios do grupo opcional, com tipo TDec1302RTC. O padrão comporta até treze dígitos inteiros e duas casas quando há parte decimal, com ponto e sem negativo. 24.00 é formato aceito; 24,00 e 24.0000 não são. Um zero explícito difere da ausência do grupo.

Exemplo: a conta confirma a relação, não a retenção real

Assuma somente como cenário histórico 60 unidades fiscais e alíquota anterior de CBS de R$ 0,40 por unidade. A conta 60 × R$ 0,40 = R$ 24,00 relaciona quantidade, alíquota e vCBSMonoRet=24.00. Para concluir que esses R$ 24,00 correspondem ao item real, ainda é necessário vincular documentos, produto, período e unidade.

Suponha separadamente R$ 30,00 de CBS padrão, R$ 5,00 de CBS sujeita à retenção e R$ 2,00 de CBS diferida. A expressão histórica UB105-10, página 51 da v1.40, daria R$ 30,00 + R$ 5,00 − R$ 2,00 = R$ 33,00 para o total do item. Os R$ 24,00 anteriormente retidos não aparecem como parcela a somar nessa expressão. A versão indicava implementação futura da validação.

Somar R$ 24,00 por causa do rótulo genérico “retida” produziria R$ 57,00 e confundiria informação anterior com vCBSMonoReten. O cenário é sintético, não indica parâmetros tributários e não deve ser transplantado como fórmula do leiaute atual.

Como reconhecer o mesmo nome no XML atual

A NT 2025.002 v1.52, páginas 25–26 e o PL_010f_v1.04 colocam vCBSMonoRet em gCBSMonoAdRem/gMonoRet ou gCBSMonoAdValorem/gMonoRet, sob gIBSCBSMono. Nesses grupos, não existem a quantidade e a alíquota anterior do modelo conjunto.

A reformulação consta do histórico da versão 1.50. O nome persistir não autoriza mover todo o grupo antigo ou decidir ad rem/ad valorem pela presença do valor. Um importador deve manter item, tributo, ancestral, pacote e origem documental; buscar somente pelo nome pode misturar estruturas.

O que conferir antes de corrigir um sistema

Separe leitura histórica de tentativa atual. Se a divergência for de valor anterior, confronte o documento de origem e os dados que o vinculam ao item, sem recalcular a história por uma alíquota atual. Se for de schema, compare o contrato do gerador com o pacote atual. A definição da retenção anterior exige documentos e confirmação contábil.

Limite do exemplo XML: as contas são textuais, sem fragmento para transmissão. Inserir vCBSMonoRet no caminho conjunto antigo de um XML atual seria incorreto. Preserve o original assinado e a autorização existente, não estime dados ausentes e esclareça um envio incerto antes de nova tentativa. O XSD não comprova a retenção real ou a situação fiscal do documento.