vCBS em gCBS total: somar a contribuição dos itens sem recalcular a alíquota

vCBS em /nfeProc/NFe/infNFe/total/IBSCBSTot/gCBS/vCBS informa o total da CBS do componente gCBS. É valor monetário, não percentual. O campo tem a mesma grafia do valor de CBS do item, mas outro ancestral e outra função.

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

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:

• Origem do somatório e obrigatoriedade
• Exemplo: itens com valores já calculados
• Diagnóstico da rejeição 1091
• Exemplo XML e hipóteses do fragmento
• Versão e cronograma: o que conferir no ambiente
• Leituras relacionadas

Origem do somatório e obrigatoriedade

W56-10, rejeição 1091, determina a comparação com a soma do vCBS informado nos itens, na NT 2025.002 v1.52, p.71. No ramo comum, o caminho de origem é det/imposto/IBSCBS/gIBSCBS/gCBS/vCBS. Não use uma busca global por vCBS: outros ramos podem carregar valores com significado diferente.

No XSD PL 010f v1.04, vCBS é obrigatório se o grupo total gCBS existe. Usa TDec1302RTC: até 13 algarismos inteiros e duas casas quando fracionário, sem sinal ou vírgula. O valor vem do cálculo dos itens, não de digitação para fechar o total.

Exemplo: itens com valores já calculados

Suponha dois itens com CBS documentada e calculada de R$ 9,00 e R$ 4,50. O total correspondente é R$ 13,50, representado pelo fragmento parcial <vCBS>13.50</vCBS> dentro de gCBS total. O exemplo não escolhe alíquotas nem bases reais.

Se os itens também tiverem diferimento ou devolução, esses valores são totalizados separadamente em vDif e vDevTrib. Não os desconte outra vez do vCBS já calculado do item. Créditos presumidos pertencem a vCredPres ou vCredPresCondSus; parcelas monofásicas ficam em gMono. O total de contribuição não vira “saldo líquido de todos os créditos” pela proximidade das tags.

Diagnóstico da rejeição 1091

Liste item, caminho de origem e vCBS exato do XML. Some com aritmética decimal, respeitando os valores efetivamente serializados, e compare com o total. Confira se a integração duplicou itens, somou a monofasia, incluiu um crédito como imposto ou recalculou o total com base e alíquota médias.

Um relatório que mostra menos casas ou usa dados de rascunho pode divergir do arquivo enviado. Identifique qual artefato foi validado. Não acrescente tolerância de outra regra e não modifique o total isolado para contornar o retorno. Corrija a origem comprovada do cálculo/serialização e valide novamente pelo fluxo adequado; preserve o XML assinado e autorizado.

Exemplo XML e hipóteses do fragmento

O valor sintético é a soma de R$9,00 e R$4,50 já apurados nos itens, no contexto gCBS total. O campo isolado é parcial ao grupo e não contém os demais filhos obrigatórios.

<vCBS xmlns="http://www.portalfiscal.inf.br/nfe">13.50</vCBS>

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.

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

O diferimento tem somatório próprio e não pode ser deduzido duas vezes. vDif — /nfeProc/NFe/infNFe/total/IBSCBSTot/gCBS/vDif.