NCM Buscador
Buscar
CAMPO DO XML · CT-E Obrigatório 6 posições

vIBSUF

Valor do IBS de competência das UF

✓ Conferido · 12 de outubro de 2026 CT-e, CT-e OS e GTV-e: leiaute do XML e regras de validação — MOC CT-e — Anexo I: Leiaute e Regras de Validação, versão 4.00 · Portal Nacional do CT-e / SVRS

Onde fica no arquivo

No documento

  • CTe/infCte/imp/IBSCBS/gIBSCBS/gIBSUF/vIBSUF

    Obrigatório, uma vez

  • CTeSimp/infCte/det/IBSCBS/gIBSCBS/gIBSUF/vIBSUF

    Obrigatório, uma vez

  • CTeSimp/infCte/total/IBSCBSTot/gIBS/gIBSUF/vIBSUF

    Obrigatório, uma vez

    Valor total do IBS Estadual

  • cteProc/CTe/infCte/imp/IBSCBS/gIBSCBS/gIBSUF/vIBSUF

    Obrigatório, uma vez

  • cteSimpProc/CTeSimp/infCte/det/IBSCBS/gIBSCBS/gIBSUF/vIBSUF

    Obrigatório, uma vez

  • cteSimpProc/CTeSimp/infCte/total/IBSCBSTot/gIBS/gIBSUF/vIBSUF

    Obrigatório, uma vez

    Valor total do IBS Estadual

O caminho até aqui, nível a nível

  1. CTe — Conhecimento de Transporte Eletrônico
  2. └ infCte — Informações do CT-e
  3. └ imp — Informações relativas aos Impostos
  4. └ IBSCBS — Grupo de informações do IBS e CBS
  5. └ gIBSCBS — Tipo CBS IBS Completo
  6. └ gIBSUF — Grupo de informações do IBS na UF
  7. └ vIBSUF — você está aqui

Dentro do grupo gIBSUF , grupo de informações do IBS na UF

O que o arquivo aceita neste campo

Ocorrência
1-1
Tamanho
—
Tipo no esquema
TDec1302RTC
Formato base
string

Formato exigido: 0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})? Número decimal: até 13 dígitos na parte inteira e 2 casas decimais, com PONTO como separador. Sem separador de milhar, sem sinal e sem espaço. Expressão do próprio esquema. Valor que não casar com ela é recusado na validação do arquivo, antes de qualquer regra de negócio. ⚠ A leitura acima sai da EXPRESSÃO, não do nome do tipo: nome de tipo se expande por palpite e palpite publica regra errada.

O mesmo nome em outros documentos fiscais — 9

vIBSUF aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele documento, que é onde a diferença aparece primeiro.

Documento O que o leiaute dele diz Caminho lá
BP-e Valor do IBS de competência das UF BPeTA/infBPe/imp/IBSCBS/gIBSCBS/gIBSUF/vIBSUF
CT-e OS Valor do IBS de competência das UF CTeOS/infCte/imp/IBSCBS/gIBSCBS/gIBSUF/vIBSUF
DeRE Valor do IBS estadual. Cálculo: {vBCApurIBS} * ({pIBSUF} / 100) DeRE/evtRetornoMensal/infoEvento/infoTotFinanceiro/detBC/gBC…
NF-e Valor do IBS de competência das UF NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSUF/vIBSUF
NF3e Valor do IBS de competência das UF NF3e/infNF3e/NFdet/det/detItem/imposto/IBSCBS/gIBSCBS/gIBSUF…
NFAg Valor do IBS de competência das UF NFAg/infNFAg/det/imposto/IBSCBS/gIBSCBS/gIBSUF/vIBSUF
NFCom Valor do IBS de competência das UF NFCom/infNFCom/det/imposto/IBSCBS/gIBSCBS/gIBSUF/vIBSUF
NFGas Valor do IBS de competência das UF NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS/gIBSUF/vIB…
NFS-e Via — NFSeVia/infNFSeVia/valores/trib/ibscbs/gIBS/uf/vIBSUF

Os campos dos doze documentos fiscais, com filtro →

Campos do mesmo grupo — 4

São os campos que ficam ao lado deste no arquivo, dentro de CTe/infCte/imp/IBSCBS/gIBSCBS/gIBSUF. Quem preenche um costuma precisar dos outros na mesma passada.

gDevTrib Grupo de Informações da devolução de tributos gDif Grupo de campos do Diferimento gRed Grupo de campos da redução de aliquota pIBSUF Aliquota do IBS de competência das UF (em percentual)

Perguntas frequentes

O que é o campo vIBSUF do CT-e?

Valor do IBS de competência das UF No XML ele fica em CTe/infCte/imp/IBSCBS/gIBSCBS/gIBSUF/vIBSUF. Obrigatório, uma vez.

vIBSUF aparece em quantos lugares do CT-e?

Em 6 posições do esquema oficial: CTe/infCte/imp/IBSCBS/gIBSCBS/gIBSUF/vIBSUF, CTeSimp/infCte/det/IBSCBS/gIBSCBS/gIBSUF/vIBSUF, CTeSimp/infCte/total/IBSCBSTot/gIBS/gIBSUF/vIBSUF, cteProc/CTe/infCte/imp/IBSCBS/gIBSCBS/gIBSUF/vIBSUF, cteSimpProc/CTeSimp/infCte/det/IBSCBS/gIBSCBS/gIBSUF/vIBSUF, cteSimpProc/CTeSimp/infCte/total/IBSCBSTot/gIBS/gIBSUF/vIBSUF. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.

Que formato o campo vIBSUF exige no CT-e?

Número decimal: até 13 dígitos na parte inteira e 2 casas decimais, com PONTO como separador. Sem separador de milhar, sem sinal e sem espaço. A regra é a expressão do próprio esquema (0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?), e ela é verificada antes de qualquer regra de negócio: valor fora do formato faz o arquivo ser recusado na validação, com rejeição genérica de schema — que é a mais difícil de diagnosticar justamente por não citar o campo.

vIBSUF no CT-e é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 9 outros documentos (BP-e, CT-e OS, DeRE, NF-e, NF3e, NFAg, NFCom, NFGas, NFS-e Via), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.

De onde vem esta descrição do CT-e?

Do esquema XML oficial (PL_CTe_400_NT2026.004_RTC_1.00). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.

Voltar ao topo