vTotCBSMonoItem: como conferir a CBS monofásica do item

vTotCBSMonoItem representa o total da Contribuição sobre Bens e Serviços (CBS) monofásica de um item, dentro de IBSCBS/gIBSCBSMono. Ele não é a CBS regular do grupo gCBS, nem o total de todos os itens da nota. Para conferir uma divergência, a primeira tarefa é identificar quais parcelas monofásicas pertencem àquele item e qual versão do leiaute está sendo usada.

Caminho desta página: /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBSMono/vTotCBSMonoItem. O prefixo nfeProc identifica a nota processada; a informação estudada pertence ao conteúdo da NF-e, dentro de NFe/infNFe.

Quais parcelas entram no total

Na NT 2025.002 v1.52, a regra UB105b-10 apresenta vTotCBSMonoItem = vCBSMono + vCBSMonoReten. A primeira parcela é a tributação própria; a segunda é a parcela sujeita à retenção. vCBSMonoRet, que identifica imposto retido anteriormente, é uma informação distinta e não aparece nessa soma. Portanto, copiar todas as tags cujo nome começa com vCBSMono para um somatório produz um resultado incorreto.

A reformulação monofásica separa CBS ad rem e ad valorem. Ad rem usa quantidade e valor por unidade; ad valorem usa base monetária e percentual. O total mantém o mesmo nome, mas a origem de suas parcelas depende do ramo aplicável. A conta precisa seguir o ramo efetivamente gerado, sem combinar estruturas de versões distintas. NT 2025.002 v1.52, p. 25–27 e 65.

Exemplo de reconciliação do item

Considere somente um cenário sintético, com parâmetros já definidos fora desta página: CBS própria de R$ 12,50 e CBS sujeita à retenção de R$ 3,00. A composição é 12,50 + 3,00 = 15,50. Se o item também informa R$ 8,00 retidos anteriormente, esse registro não transforma o total em R$ 23,50.

O fragmento abaixo mostra apenas o campo estudado, válido em sua declaração contextual; não é uma NF-e completa e não contém os grupos que justificam as parcelas:

<vTotCBSMonoItem xmlns="http://www.portalfiscal.inf.br/nfe">15.50</vTotCBSMonoItem>

O valor monetário usa ponto decimal e duas casas. Na montagem do grupo, preserve a posição definida no XSD: total do IBS antes do total da CBS. O tipo TDec1302RTC aceita valor não negativo; isso não autoriza preencher zero quando a operação tem valor desconhecido.

Como investigar uma diferença

Localize o det pelo seu nItem e leia somente o gIBSCBSMono correspondente. Compare a memória de cálculo do item com os valores próprios e de retenção gravados no XML. Se o total esperado era R$ 15,50 e foram gerados R$ 23,50, procure primeiro a inclusão indevida da retenção anterior; se foi gerado R$ 15,00, examine as duas parcelas e a precisão usada antes da serialização.

Depois confira se o emissor está reaproveitando a CBS de outro item, somando o total da nota em cada item ou misturando CBS regular com monofásica. Essas são hipóteses de diagnóstico, não causas presumidas. Corrija o mapeamento ou cálculo na origem quando a comparação comprovar a falha e gere novamente o documento antes de assinar. Alterar diretamente um XML assinado não corrige a emissão.

Regra documentada e implantação são coisas diferentes

UB105b-10 é a regra vinculada à mensagem 1071 e descreve tolerância de R$ 0,01 para mais ou para menos. A própria linha da NT v1.52 está marcada como implementação futura. A tolerância não é uma autorização para escolher um total arbitrário nem deve ser aplicada a toda soma da nota.

O pacote PL 010f v1.04 contém a declaração estrutural do campo, mas sua existência não comprova que a regra 1071 esteja ativa em cada autorizadora. O aviso ENCAT de 05/10/2026 posterga as alterações previstas para 05/out para 26/10/2026 em homologação e 16/11/2026 em produção; ele não transforma uma regra assinalada como futura em regra ativa e não suspende genericamente validações anteriores. Para uma rejeição real, registre ambiente, UF, data, versão e retorno completo antes de relacioná-la a essa regra. Aviso oficial.

O que o valor não decide

Este total não determina a alíquota, o enquadramento monofásico ou o direito a crédito de quem recebe a nota. A classificação, a natureza do combustível, a etapa da cadeia e os parâmetros aplicáveis precisam estar confirmados com o responsável fiscal. Com esses dados definidos, o integrador consegue conferir parcelas, unidade, ramo do leiaute e valor final sem inferir o tratamento tributário a partir do total.

O total da outra contribuição tem conferência própria: vTotIBSMonoItem.

Fontes oficiais

• Tipos comuns RTC — PL_010f_v1.04: TMonofasia l1451–1839; vTotCBSMonoItem l1833; 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