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

vCBS do item: cálculo com redução, diferimento e cashback

<vCBS>det › imposto › IBSCBS › gIBSCBS › gCBS › vCBS

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

vCBS em gIBSCBS/gCBS é o valor efetivo da CBS do item. Ele resulta da base e da alíquota aplicável ao ramo, com as subtrações documentadas de diferimento e devolução de tributo.

Onde localizar esta ocorrência

XPath completo: /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gCBS/vCBS. A informação pertence ao item det, dentro de imposto/IBSCBS/gIBSCBS. Em um XML cuja raiz é NFe, o caminho começa em /NFe, sem o invólucro nfeProc. Para consultas XPath, associe um prefixo ao namespace http://www.portalfiscal.inf.br/nfe. Preserve todos os ancestrais e o item; o nome isolado não distingue tributo, total ou grupo de referência.

Fontes: Tipos RTC — PL_010f_v1.04.

Como conferir a fórmula do valor efetivo

UB67-10 calcula vCBS = gIBSCBS/vBC × (pCBS / 100) − vDif − vDevTrib. Se houver gCBS/gRed, use sua pAliqEfet no lugar de pCBS. As parcelas devem ser as do mesmo item e do ramo CBS; ausência de um grupo que não se aplica significa que ele não participa da conta, não permissão para converter parâmetro desconhecido em zero.

Exemplo com hipóteses explícitas: base de R$ 1.000,00, alíquota nominal de 0,90%, redução hipotética de 40% e diferimento hipotético de 50%, sem devolução. A efetiva é 0,5400%, a CBS anterior ao diferimento é R$ 5,40, vDif é R$ 2,70 e vCBS é R$ 2,70. O exercício não recomenda esses percentuais.

Fontes: NT 2025.002 v1.52 — p. 21 UB67; p. 49 UB61-10/UB63-10; p. 52 UB67-10, tipos RTC — PL_010f_v1.04.

Fragmento que mostra o encadeamento

Trecho parcial de gCBS com os parâmetros sintéticos anteriores, supondo classificação compatível com os grupos:

<gCBS xmlns="http://www.portalfiscal.inf.br/nfe">
  <pCBS>0.9000</pCBS>
  <gDif><pDif>50.0000</pDif><vDif>2.70</vDif></gDif>
  <gRed><pRedAliq>40.0000</pRedAliq><pAliqEfet>0.5400</pAliqEfet></gRed>
  <vCBS>2.70</vCBS>
</gCBS>

vCBS é obrigatório dentro do ramo e vem depois dos grupos opcionais. Seu tipo TDec1302RTC usa ponto e duas casas quando há decimal. A base e os outros tributos da nota foram omitidos; o fragmento não é um documento para transmissão.

Fontes: NT 2025.002 v1.52 — p. 21 UB67; p. 49 UB61-10/UB63-10; p. 52 UB67-10, tipos RTC — PL_010f_v1.04.

Diferenças de valor que não são erro de soma

gALCZFMCBS/vTribRegCBS e gTribRegular/vTribRegCBS são valores de referência em contextos próprios; não devem ser somados à CBS efetiva só porque têm CBS no nome. O total de CBS da nota também fica em outro caminho, sob total/IBSCBSTot/gCBS, e não substitui a conferência por item.

Uma devolução de tributo na NF-e 55 pode reduzir vCBS, enquanto na NFC-e 65 o grupo de devolução é vedado por UB62-10. A fórmula não autoriza inserir um grupo que outra regra proíbe.

Fontes: NT 2025.002 v1.52 — p. 21 UB67; p. 49 UB61-10/UB63-10; p. 52 UB67-10, tipos RTC — PL_010f_v1.04.

O que comparar diante da rejeição 1069

UB67-10/1069 compara o valor da CBS com o calculado e admite tolerância de R$ 0,01 para mais ou menos nos modelos 55/65. Refaça a conta com os números transmitidos, verificando alíquota efetiva, escala, parcelas do próprio ramo e arredondamentos. Não subtraia o diferimento duas vezes nem recalcule a partir de um total já agregado.

Se a base ou os parâmetros fiscais não tiverem origem demonstrada, reúna memória de cálculo, classificação, data e documentos da operação para confirmação. Corrigir a conta ou o serializador é diferente de decidir a incidência, redução ou diferimento do caso.

Fontes: NT 2025.002 v1.52 — p. 21 UB67; p. 49 UB61-10/UB63-10; p. 52 UB67-10, tipos RTC — PL_010f_v1.04.

Leitura relacionada

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gCBS/vCBS
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