vIBS em gTransfCred: valor do IBS a transferir
<vIBS>det › imposto › IBSCBS › gTransfCred › vIBSRevisã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
- Tipos comuns RTC — PL_010f_v1.04: TTransfCred/vIBS l1281–1285; 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/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