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

vIBS em gTransfCred: valor do IBS a transferir

<vIBS>det › imposto › IBSCBS › gTransfCred › vIBS

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

vIBS, em IBSCBS/gTransfCred, informa o valor de IBS a transferir. É uma quantia monetária da transferência, sem divisão em alíquotas estadual e municipal dentro desse grupo. A mesma tag curta aparece em outros contextos da NF-e, por isso localizar o ancestral gTransfCred é indispensável.

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

O campo não calcula o crédito disponível

O tipo TTransfCred contém vIBS seguido de vCBS, ambos obrigatórios quando o grupo existe. Não contém base de cálculo, percentuais nem campos separados por UF e município. O valor do IBS precisa estar individualizado na apuração e documentação da transferência; não se obtém automaticamente multiplicando o valor comercial do item pela alíquota de uma venda.

O IBS transferível, a hipótese da transferência, o período e os participantes devem estar confirmados antes da serialização. A página explica como representar e conferir esse montante, mas não determina saldo disponível ou direito material. XSD PL 010f v1.04, TTransfCred.

Representação e exemplo do valor de IBS

Suponha R$ 120,00 de IBS a transferir, confirmados para um cenário sintético. O campo isolado fica assim:

<vIBS xmlns="http://www.portalfiscal.inf.br/nfe">120.00</vIBS>

É um fragmento parcial, sem grupo completo nem nota apta a transmissão. O tipo TDec1302RTC usa valor não negativo com ponto decimal e duas casas. No grupo completo, deve existir também vCBS. Se a CBS confirmada é zero, a condição UB106-40 continua atendida pelo IBS positivo. Se o IBS confirmado é zero e a CBS positiva, essa mesma regra do par não exige tornar o IBS positivo. Os dois valores zerados estão relacionados à mensagem 1129.

Informação desconhecida não equivale a zero: o integrador deve distinguir ausência na origem e valor monetário zero efetivamente apurado.

O que verificar antes de mudar finalidade ou valor

UB106-30 relaciona a presença da transferência no modelo 55 à finalidade finNFe=6; sua incompatibilidade é 1133. UB106-31 relaciona o tipo de débito aos códigos 01, transferência para cooperativas, ou 05, transferência de sucessão; sua incompatibilidade é 1168. Não conclua, a partir do nome da tag, que qualquer transferência de mercadoria entre estabelecimentos se enquadra em uma dessas hipóteses.

Compare gTransfCred/vIBS com a memória de IBS da transferência e não com gIBSCBS/vIBS, que pertence à tributação regular. O totalizador da nota tampouco é fonte intercambiável com o valor deste item. Antes de corrigir um retorno, identifique se o problema comprovado é estrutural, de valor do par ou de finalidade/tipo. NT v1.52, p. 65.

Rastreabilidade da correção

Se a apuração registra R$ 120,00 de IBS e o XML carrega esse valor em vCBS, o erro é uma troca de campos, demonstrada comparando a memória e o XML. Se o IBS está correto e a finalidade incompatível, alterar o valor não resolve. Preserve documento de origem, item, versão do emissor e retorno da autorizadora para testar a correção exata.

Corrija a causa antes de assinar e confirme novamente o grupo e o cabeçalho. Autorizar a NF-e não prova aceitação de eventuais manifestações próprias da transferência nem transforma o campo em comprovação de crédito. O aviso ENCAT de 05/10/2026 tem alcance específico para alterações adiadas; não substitui a conferência do cronograma de cada regra. Aviso oficial.

Fontes oficiais

Referência técnica para integração

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