vCBSEstCred no total: somatório do estorno de crédito de CBS

vCBSEstCred em /nfeProc/NFe/infNFe/total/IBSCBSTot/gEstornoCred/vCBSEstCred totaliza a CBS estornada nos itens. Ele não é o total comum de CBS nem um crédito presumido com sinal trocado.

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

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:

• Nome, ordem e valor de origem
• Conferência e divergência de nomenclatura
• Como investigar uma diferença na CBS estornada
• Exemplo XML e hipóteses do fragmento
• CBS igual a zero: conferir o grupo sem exigir dois estornos positivos
• Referência temporal desta conferência
• Leituras relacionadas

Nome, ordem e valor de origem

No grupo total gEstornoCred, o campo é obrigatório e vem depois de vIBSEstCred. Usa TDec1302RTC: até 13 algarismos inteiros, duas casas quando fracionário e sem sinal. A origem exata é det/imposto/IBSCBS/gEstornoCred/vCBSEstCred. Fonte: XSD PL 010f v1.04, TEstornoCred e TIBSCBSMonoTot; NT 2025.002 v1.52, p. 27 UB118 e p. 30 W59g.

Não use gCBS/vCBS nem gCBSCredPres/vCredPres como origem do estorno. A permissão do grupo no item depende do indicador ind_gEstornoCred da classificação documentada.

Conferência e divergência de nomenclatura

A regra W59g-10/1177, p. 71 da NT 2025.002 v1.52, prevê comparar o total da CBS estornada à soma nos itens, mas escreve gEstornoCred/vCBS. Esse nome diverge de UB118 e do XSD, que definem vCBSEstCred. Não crie vCBS dentro de gEstornoCred para reproduzir a frase da regra, nem interprete automaticamente como o valor comum de CBS.

Em um exemplo didático com estornos confirmados de R$ 4,00 e R$ 6,00, o total é R$ 10,00, representado parcialmente por <vCBSEstCred>10.00</vCBSEstCred>. O exemplo só demonstra soma de valores existentes, sem escolher a condição fiscal que leva ao estorno.

Como investigar uma diferença na CBS estornada

Liste det/@nItem, cClassTrib, indicador de estorno e o valor exato serializado em cada gEstornoCred/vCBSEstCred. Some apenas CBS e compare com esse campo total. Verifique se um mapeamento antigo ainda procura /vCBS, deixando de ler o nome atual, ou se incluiu valores de IBS.

Para erro de schema, confira o nome completo e a presença dos dois filhos do grupo total. Para retorno de negócio, preserve mensagem e versão aplicável, inclusive a divergência documental. Não ajuste o imposto comum para fechar estorno e não utilize valores negativos como atalho. A definição do estorno requer documentos e fundamento; a integração deve refletir o parâmetro confirmado e preservar XML autorizado.

Exemplo XML e hipóteses do fragmento

O valor sintético soma estornos de CBS já documentados de R$ 4,00 e R$ 6,00. É parcial a gEstornoCred total e não define o motivo fiscal do estorno.

<vCBSEstCred xmlns="http://www.portalfiscal.inf.br/nfe">10.00</vCBSEstCred>

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.

CBS igual a zero: conferir o grupo sem exigir dois estornos positivos

vCBSEstCred pode representar uma soma conhecida igual a zero quando os itens não têm CBS estornada. Isso não quer dizer que todo gEstornoCred informado possa ter os dois valores zerados: UB116-30/1174, modelo 55, verifica se IBS ou CBS é maior que zero. Não exige ambos positivos. Em uma hipótese com IBS estornado 5 e CBS efetivamente 0, a coluna desta página continua 0, sem copiar 5 do IBS.

Para tpNFDebito=07, perda em estoque, UB116-30 contém exceção própria. A mesma finalidade é exceção da vedação por ind_gEstornoCred=0 em UB116-10/1172, para 55/65; já UB116-20/1173, modelo 55, exige o grupo por indicador 1 ou por tpNFDebito=07. Diferencie esses alcances ao investigar por que uma CBS zerada foi aceita ou recusada: a condição é do grupo e pode depender do valor de IBS, não só deste campo isolado.

Na trilha de integração, compare UB118 do item com W59g do total. Se o mapper procura o antigo nome curto vCBS em gEstornoCred, pode omitir a CBS estornada mesmo lendo corretamente o imposto comum em outro grupo. Corrija o caminho comprovadamente errado, mantendo documento e finalidade reais. Fonte: NT 2025.002 v1.52, pp. 65–66 UB116-10/20/30 e p. 71 W59g-10; XSD TEstornoCred/vCBSEstCred.

Referência temporal desta conferência

A comparação W59g é documentada na NT 2025.002 v1.52 p. 71, enquanto o nome exato vCBSEstCred vem do XSD PL 010f v1.04 e de UB118/W59g no leiaute. A divergência nominal exige conservar essas versões no diagnóstico. Não houve transmissão de teste para demonstrar como uma autorizadora particular trata a redação antiga; registre ambiente e retorno antes de interpretar a recusa. Fontes: Portal Nacional — PL 010f, NT 2025.002 v1.52, aviso ENCAT 05/10.

Leituras relacionadas

O grupo reúne ambos os estornos em ordem definida. gEstornoCred — /nfeProc/NFe/infNFe/total/IBSCBSTot/gEstornoCred.