IBSCBSTot: como organizar bases, IBS, CBS, monofasia e estorno no total

IBSCBSTot consolida valores de IBS e CBS na nota, em /nfeProc/NFe/infNFe/total/IBSCBSTot. Não é um único imposto nem uma base acrescida de alíquota. Ele reúne a base comum e componentes separados, originados nos itens.

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

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:

• Estrutura do total IBS/CBS
• Presença do grupo e base comum
• Roteiro para um erro no total
• Exemplo XML e hipóteses do fragmento
• vItem e vProd: duas notas técnicas com escopos temporais diferentes
• Os seis totais monofásicos e os dois estornos
• Versão e cronograma: o que conferir no ambiente
• Leituras relacionadas

Estrutura do total IBS/CBS

O tipo TIBSCBSMonoTot começa por vBCIBSCBS, obrigatório quando IBSCBSTot existe. Seguem, nessa ordem, os grupos opcionais gIBS, gCBS, gMono e gEstornoCred. A ausência estruturalmente permitida de um grupo não dispensa a condição fiscal ou o conteúdo exigido pelos valores dos itens. Fonte: XSD PL 010f v1.04; NT 2025.002 v1.52, p.29–30, W34–W59g.

gIBS separa UF e município, valor de IBS e créditos; gCBS separa diferimento, devolução, valor da contribuição e créditos; gMono reúne parcelas monofásicas; gEstornoCred reúne IBS/CBS estornados. Cada grupo existente precisa conter seus próprios filhos obrigatórios, mesmo quando um valor apurado é zero.

Presença do grupo e base comum

W34-10/1118, p.70 da NT 2025.002 v1.52, compara a presença de IBSCBSTot com a inexistência de itens com IBSCBS; W34-20/1119 trata o inverso. Não crie o grupo apenas para completar um modelo de XML, nem o suprima quando os itens da nota exigirem essa consolidação.

W35-10/1076 compara vBCIBSCBS com as bases gIBSCBS/vBC dos itens. Uma base comum de R$ 100,00 usada para IBS e CBS é contada uma vez, não duas. Em hipótese didática de bases individuais já apuradas de R$ 100,00 e R$ 50,00, a base total é R$ 150,00; os impostos de cada componente continuam em campos próprios.

Roteiro para um erro no total

Confira primeiro se o item usa o ramo comum gIBSCBS, monofasia ou outro ramo específico. Localize a grandeza que a mensagem compara. Não misture créditos, estornos e devoluções no valor de CBS ou IBS, e não calcule o imposto total aplicando uma alíquota média à base da nota.

Para visualizar a hierarquia, uma projeção parcial é IBSCBSTot → vBCIBSCBS, gIBS, gCBS, gMono, gEstornoCred; as setas não são tags XML. Confira a sequência no schema, o namespace da NF-e e os valores em cada det. Corrija a origem demonstrada da divergência, sem editar o XML autorizado. Seleção de ramo ou crédito depende da classificação e dos documentos, não da conveniência do total.

Exemplo XML e hipóteses do fragmento

Considere apenas uma nota sintética com bases comuns de R$100,00 e R$50,00, IBS dos itens de R$1,00 e R$0,50, sendo UF R$0,60/R$0,30 e município R$0,40/R$0,20, e CBS R$9,00/R$4,50. Diferimentos, devoluções, créditos, monofasia e estornos são comprovadamente inexistentes nessa hipótese. O grupo está completo, mas não representa uma nota inteira nem sugere incidência ou alíquotas reais.

<IBSCBSTot xmlns="http://www.portalfiscal.inf.br/nfe">
  <vBCIBSCBS>150.00</vBCIBSCBS>
  <gIBS>
    <gIBSUF>
      <vDif>0.00</vDif>
      <vDevTrib>0.00</vDevTrib>
      <vIBSUF>0.90</vIBSUF>
    </gIBSUF>
    <gIBSMun>
      <vDif>0.00</vDif>
      <vDevTrib>0.00</vDevTrib>
      <vIBSMun>0.60</vIBSMun>
    </gIBSMun>
    <vIBS>1.50</vIBS>
    <vCredPres>0.00</vCredPres>
    <vCredPresCondSus>0.00</vCredPresCondSus>
  </gIBS>
  <gCBS>
    <vDif>0.00</vDif>
    <vDevTrib>0.00</vDevTrib>
    <vCBS>13.50</vCBS>
    <vCredPres>0.00</vCredPres>
    <vCredPresCondSus>0.00</vCredPresCondSus>
  </gCBS>
</IBSCBSTot>

A validação desse fragmento é estrutural e limitada à declaração do seu caminho. Não equivale à validação da nota completa, à assinatura ou à autorização.

vItem e vProd: duas notas técnicas com escopos temporais diferentes

A NT 2025.002 v1.52, p.68–69, apresenta as composições futuras VB01-10/20 com parcelas de novos tributos separadas. Naquele texto, a exceção dos anos 2025 e 2026 exclui a soma de vIBS, vCBS e vIS; no ramo geral VB01-10 também exclui vTotIBSMonoItem e vTotCBSMonoItem. As duas regras permanecem marcadas como implementação futura.

A NT 2026.008 v1.00, pp. 4, 6 e 9–10, altera essas composições. A observação de I11 na p.6 estabelece que, a partir de 2027, IBS/CBS/IS compõem o valor bruto vProd, exceto nas notas de importação; não descreve uma inclusão automática em 2026. Nas composições VB01, descreve vProd como contendo esses tributos e risca os acréscimos separados e a antiga exceção temporal. A observação de implementação futura continua. Não apresente a fórmula e a exceção da NT anterior como regra universal para qualquer emissão em 2026, nem some novamente tributos que a composição aplicável já contém no valor do produto.

O aviso ENCAT de 5/10/2026 inclui expressamente a NT 2026.008 no adiamento para 26/10 em homologação e 16/11 em produção. Esse cronograma da rodada não ativa por si as regras que continuam futuras. Em 14/10/2026, a documentação publicada e o pacote XSD PL 010f usado nos exemplos são objetos diferentes: o pacote conferido não contém os novos campos vProdLiq/vProdLiqTot daquela NT. Para uma nota concreta, confirme pacote, data, regras implementadas e memória de cálculo; preserve a versão histórica de sua conferência.

Os seis totais monofásicos e os dois estornos

No XSD PL 010f v1.04, gMono vem depois de gCBS e antes de gEstornoCred. Se informado, exige na ordem vIBSMono, vCBSMono, vIBSMonoReten, vCBSMonoReten, vIBSMonoRet e vCBSMonoRet. Os dois primeiros registram monofasia própria; Reten identifica a parcela sujeita à retenção; Ret identifica tributo retido anteriormente. Não troque os sufixos nem some as três situações em um único campo.

A origem é a parcela monofásica correspondente dos itens IBSCBS/gIBSCBSMono. No pacote conferido, os ramos ad rem ou ad valorem podem carregar os valores próprios vIBSMono/vCBSMono; as parcelas sujeitas à retenção e retidas anteriormente usam os campos homônimos nos respectivos ramos. A NT 2025.002 v1.52, p.71, mantém comparações separadas W58-10/1092, W59-10/1093, W59a-10/1120, W59b-10/1121, W59c-10/1122 e W59d-10/1123. O schema PL 010f e a implantação da reformulação monofásica são verificações diferentes; não atribua a estrutura a toda nota histórica nem suponha incidência monofásica por haver um campo.

Em hipótese exclusivamente de conciliação, se os itens já têm IBS próprio monofásico de R$2,00 e R$3,00, IBS sujeito à retenção de R$1,00 e retenção anterior de R$4,00, os totais correspondentes são vIBSMono=5,00, vIBSMonoReten=1,00 e vIBSMonoRet=4,00. Não são três maneiras de escrever R$10,00. Os valores de CBS seguem suas colunas próprias; o exemplo não escolhe a hipótese legal de monofasia.

gEstornoCred, quando informado, exige vIBSEstCred e vCBSEstCred, nessa ordem. Esses valores vêm de IBSCBS/gEstornoCred dos itens, conforme leiaute UB117/118 e W59f/g. Não são vIBS/vCBS comuns nem créditos presumidos negativos. A divergência de nomes nas regras W59f/g não altera os nomes declarados no schema. Permissão e exigência do grupo no item precisam observar a classificação e as exceções das regras UB116, inclusive a nota de débito de perda em estoque.

Versão e cronograma: o que conferir no ambiente

A estrutura descrita foi conferida no PL 010f v1.04. O snapshot da ficha pode oferecer PL 010e v1.02; uma afirmação sobre o pacote mais novo não deve ser atribuída automaticamente a todo arquivo histórico.

A NT 2025.002 v1.52 é a edição de setembro de 2026, publicada no catálogo em 1º/10/2026. O aviso ENCAT de 5/10/2026 adiou as alterações dessa rodada para 26/10/2026 em homologação e 16/11/2026 em produção. Essas datas não suspendem todas as regras anteriores nem tornam ativas as regras que continuam marcadas como implementação futura. Em 14/10/2026, os dois novos marcos ainda eram futuros.

Separe a existência de uma tag no schema, a condição fiscal da operação e a ativação da regra de negócio. A condição legal não se deduz da ausência de rejeição, e o cronograma não comprova implantação em cada autorizadora. Registre data, modelo, ambiente, pacote usado e retorno para interpretar uma divergência concreta.

Leituras relacionadas

A CBS possui cinco totais com significados diferentes. gCBS — /nfeProc/NFe/infNFe/total/IBSCBSTot/gCBS.

O IBS separa componente estadual, municipal e créditos. gIBS — /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS.