vCBS do item: cálculo com redução, diferimento e cashback
<vCBS>det › imposto › IBSCBS › gIBSCBS › gCBS › vCBSRevisã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
- Como conferir a fórmula do valor efetivo
- Fragmento que mostra o encadeamento
- Diferenças de valor que não são erro de soma
- O que comparar diante da rejeição 1069
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