Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · IBS e CBS

vCBS em gTransfCred: valor da CBS a transferir

<vCBS>det › imposto › IBSCBS › gTransfCred › vCBS

Revisã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 IBSCBS/gTransfCred, é o valor da CBS a transferir. Apesar de repetir o nome de outras tags da nota, ele não representa a CBS calculada no grupo regular nem seu totalizador. Um relatório que usa somente o nome vCBS pode misturar valores de natureza diferente.

Caminho desta página: /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gTransfCred/vCBS. O prefixo nfeProc identifica a nota processada; a informação estudada pertence ao conteúdo da NF-e, dentro de NFe/infNFe.

De onde vem o valor a transferir

O valor deve vir da apuração e dos documentos que suportam a transferência específica. Este campo não tem, no grupo, uma base e uma alíquota para calcular a CBS da operação. Dividir o preço do produto por um percentual ou copiar o imposto de outra nota não demonstra o valor transferível.

Conserve no processo de conferência a memória que individualiza CBS e IBS, a operação de transferência e o período correspondente. A definição do direito e do montante transferível depende do enquadramento e dos documentos reais; tecnicamente, depois de confirmados, o XML deve reproduzir o valor da CBS sem migração para o campo do IBS. NT 2025.002 v1.52, UB108, p. 27.

Zero, ausência e o par com IBS

vCBS é obrigatório dentro de gTransfCred, assim como vIBS. O tipo monetário aceita zero, mas a regra UB106-40 exige que pelo menos um dos valores do par seja positivo. CBS zero com IBS positivo pode satisfazer essa condição do par; ambos zerados não satisfazem. A distinção é entre zero confirmado e informação ainda não apurada, que não deve ser convertida automaticamente em zero.

Fragmento sintético do campo, parcial em relação ao grupo e à nota:

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

Neste cenário, a memória confirmada indicaria R$ 75,00 de CBS. Na construção do grupo completo, vIBS vem antes de vCBS; omitir o IBS não é permitido só porque a transferência envolve principalmente CBS. O XSD usa TDec1302RTC, com ponto decimal e duas casas.

Finalidade e homônimos que precisam ser separados

A transferência no modelo 55 é conferida pelas regras UB106-30 e UB106-31: finalidade 6, Nota de Débito, e tipo 01 ou 05, conforme a hipótese descrita pela regra. As mensagens 1133 e 1168 tratam dessas compatibilidades; a 1129 trata do par de valores sem parcela positiva.

gIBSCBS/gCBS/vCBS descreve tributação regular do item; gTransfCred/vCBS descreve valor a transferir. Já um valor encontrado no totalizador resume a nota. A comparação deve manter o XPath, o número do item e a finalidade. Um valor igual em dois locais não prova que eles podem ser copiados entre si. A escolha da hipótese de transferência e dos códigos pertence à avaliação do caso, não à semelhança dos nomes.

Como conferir divergência ou valor perdido

Compare o valor de CBS aprovado na memória da transferência com gTransfCred/vCBS do item correspondente. Se a origem tem R$ 75,00 e o XML mostra 0.00, examine se houve default de campo ausente, chave JSON incorreta ou importação de vIBS para a posição da CBS. Se o valor coincide mas há rejeição, leia o código completo e confira o cabeçalho antes de recalcular tributo que este grupo não calcula.

Corrija o mapeamento ou a origem documental comprovadamente errada e gere novamente antes da assinatura. O fato de o fragmento passar no XSD não prova autorização, saldo disponível ou aceitação da transferência. O cronograma do aviso ENCAT de 05/10/2026 é específico às mudanças então adiadas e não comprova a ativação individual de todas as regras do grupo. Aviso oficial.

Fontes oficiais

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/imposto/IBSCBS/gTransfCred/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