vCBS em gTransfCred: valor da CBS a transferir
<vCBS>det › imposto › IBSCBS › gTransfCred › vCBSRevisã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
- Tipos comuns RTC — PL_010f_v1.04: TTransfCred/vCBS l1286–1290; TDec1302RTC
- NT 2025.002 — RTC — 1.52, setembro/2026: gTransfCred e valores, p. 27; UB13-44/45 (1131/1132), p. 41; UB106-30/31/40 (1133/1168/1129), p. 65.
- ENCAT — alteração de datas de implantação — 05/10/2026: Aviso de 05/10/2026: alterações antes previstas para 05/out; não é suspensão de todas as regras anteriores
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