gCBS no total: valor da CBS, diferimento, devolução e créditos separados

gCBS em /nfeProc/NFe/infNFe/total/IBSCBSTot/gCBS é o grupo de totalização da CBS. Ele é diferente de gCBS dentro do imposto de cada item e do total da CBS monofásica em gMono.

Identidade técnica: tag; XPath /nfeProc/NFe/infNFe/total/IBSCBSTot/gCBS.

Para consultas XPath com prefixos, associe n a http://www.portalfiscal.inf.br/nfe em cada elemento. Em XML cuja raiz é NFe, retire o ancestral nfeProc da consulta; não remova namespaces do documento original.

Nesta página:

• Cinco campos obrigatórios quando gCBS existe
• Exemplo completo do grupo, parcial em relação à nota
• Como localizar uma diferença de CBS
• Como decidir qual coluna de crédito conferir
• Referência temporal desta conferência
• Leituras relacionadas

Cinco campos obrigatórios quando gCBS existe

O grupo é opcional dentro de IBSCBSTot. Uma vez informado, exige, na ordem, vDif, vDevTrib, vCBS, vCredPres e vCredPresCondSus. Todos usam TDec1302RTC: valores sem sinal, até 13 algarismos inteiros e duas casas quando há fração. Fonte: XSD PL 010f v1.04, TIBSCBSMonoTot/gCBS; NT 2025.002 v1.52, p. 30.

vDif consolida diferimento; vDevTrib, devolução de tributo; vCBS, valor da contribuição; vCredPres, crédito presumido; vCredPresCondSus, crédito em condição suspensiva. Esses valores têm sentidos diferentes. Não elimine um filho obrigatório porque sua parcela não existe no cenário: use zero somente quando a ausência da parcela foi efetivamente apurada.

Exemplo completo do grupo, parcial em relação à nota

Considere uma nota sintética cujos itens já resultaram em CBS de R$ 13,50, diferimento de R$ 1,00, devolução de R$ 0,50, crédito presumido de R$ 2,00 e nenhum crédito em condição suspensiva. O grupo seria:

<gCBS xmlns="http://www.portalfiscal.inf.br/nfe">
  <vDif>1.00</vDif>
  <vDevTrib>0.50</vDevTrib>
  <vCBS>13.50</vCBS>
  <vCredPres>2.00</vCredPres>
  <vCredPresCondSus>0.00</vCredPresCondSus>
</gCBS>

O exemplo apenas agrega valores previamente apurados e não define incidência ou direito a crédito. Não se subtraem novamente 1,00, 0,50 e 2,00 de 13,50 para preencher vCBS: esse campo totaliza o valor de CBS que os itens já carregam.

Como localizar uma diferença de CBS

W53-10/1088 compara diferimento; W54-10/1089, devolução; W56-10/1091, CBS; W56a-10/1087, crédito presumido. As regras estão na NT 2025.002 v1.52, p. 71. O identificador do campo vCBS é W56; isso não é o código da rejeição 1091.

Monte os somatórios separados, usando os ancestrais corretos dos itens. Se o problema for no crédito, confira gCredPresOper/gCBSCredPres, sem usar o crédito de IBS. Se for valor da contribuição, confira gIBSCBS/gCBS/vCBS. Os componentes monofásicos e de estorno possuem totais próprios; somá-los automaticamente em gCBS/vCBS mistura ramos diferentes.

Como decidir qual coluna de crédito conferir

A leitura de gCBS começa separando imposto e ajuste: vCBS é contribuição calculada, vDif é diferimento e vDevTrib é devolução. Só depois se examinam as duas colunas de crédito. O total não oferece uma escolha livre entre elas: a origem documentada de cada item determina se há vCredPres, vCredPresCondSus ou nenhuma dessas parcelas.

No modelo 65, UB120-10/1049 veda o grupo de crédito de operação gCredPresOper. Os valores positivos de crédito do exemplo desta página pressupõem modelo 55. Na NF-e, o indicador ind_gCredPresOper=1 permite, mas não exige, o uso; UB120-20/1175 trata de vedação por indicador 0, com exceção específica para indBemMovelUsado=1. Em seguida, os indicadores de CBS da tabela de cCredPres são conferidos por UB127-10/1050 e UB127-20/1058.

Para a coluna vCredPres, se o crédito confirmado é código 4, UB129-10/1124 limita o valor do item a vProd. Para a coluna suspensiva, UB130-10/1060 exige ano de emissão a partir de 2027 e código 4, além das condições materiais; a ausência de rejeição não prova o direito. O código 4 é a aquisição de bem móvel de pessoa física não contribuinte para revenda e usa a representação 04 no tipo de dois dígitos. Em 2026, não se cria essa parcela suspensiva apenas porque o total a admite estruturalmente.

Com esses dados confirmados, o mapa de conferência fica claro: compare contribuição com contribuição; diferimento com diferimento; devolução com devolução; crédito com a alternativa correspondente no item. Não compense as colunas entre si para fechar gCBS. Fontes: NT 2025.002 v1.52, p. 66 UB120 e p. 67 UB127/129/130; XSD PL 010f v1.04, gCBS total.

Referência temporal desta conferência

A referência estrutural deste mapa é TIBSCBSMonoTot/gCBS no PL 010f v1.04. As condições de crédito citadas pertencem à NT 2025.002 v1.52, sobretudo pp. 66–67; o marco 2027 da parcela suspensiva é um ano de emissão, não uma data de instalação de schema. Registre a versão da tabela usada nos itens. O aviso ENCAT 05/10/2026, que adia mudanças listadas para 26/10 homologação e 16/11 produção, não substitui condições específicas ou comprova implantação de cada autorizadora. Fontes: Portal Nacional — PL 010f, NT 2025.002 v1.52, aviso ENCAT 05/10.

Leituras relacionadas

O valor de CBS é somado sem deduzir outras parcelas novamente. vCBS — /nfeProc/NFe/infNFe/total/IBSCBSTot/gCBS/vCBS.