vIBSUF: valor estadual após redução, diferimento e devolução
<vIBSUF>det › imposto › IBSCBS › gIBSCBS › gIBSUF › vIBSUFRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vIBSUF em gIBSCBS/gIBSUF registra o valor do IBS estadual do item depois das parcelas previstas na regra de cálculo. Ele é monetário e compõe gIBSCBS/vIBS junto do IBS municipal; não inclui a CBS.
Caminho desta ocorrência: /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSUF/vIBSUF.
Como recompor o imposto estadual
A UB35-10 calcula vIBSUF = gIBSCBS/vBC × (pIBSUF/100) − vDif − vDevTrib. Se houver gIBSUF/gRed, use gRed/pAliqEfet na conferência, em lugar da nominal. vDif vem de gIBSUF/gDif; vDevTrib vem de gIBSUF/gDevTrib. São parcelas distintas, com aplicação condicionada às respectivas regras.
Quando uma parcela legitimamente não se aplica, ela não acrescenta abatimento na recomposição; isso não autoriza preencher grupo ausente com zero para disfarçar parâmetro desconhecido. A regra 1041 admite R$ 0,01 para mais ou para menos. NT 2025.002 v1.52, UB35-10, p. 45.
Exemplo sem e com diferimento
Hipóteses sintéticas: base R$ 5.000,00; nominal 0,1%; redução 40%; efetiva 0,0600%; sem devolução de tributos. Sem diferimento, o valor estadual é 5.000 × 0,06/100 = R$ 3,00.
Se, em outro cenário com diferimento confirmado de 50%, vDif = R$ 1,50, o estadual final é R$ 1,50. A redução já entrou na efetiva; aplicá-la novamente ao R$ 3,00 seria duplicá-la. Também não se subtrai pDif=50 diretamente: o abatimento é o valor vDif. Esses parâmetros demonstram a conta, sem indicar tributação da operação do leitor. UB23-10 e UB35-10, p. 44–45.
XML e relação com o IBS do item
Fragmento parcial sintético do segundo cenário:
<vIBSUF xmlns="http://www.portalfiscal.inf.br/nfe">1.50</vIBSUF>
Use duas casas e ponto decimal, conforme TDec1302RTC. No documento, o campo aparece depois dos grupos condicionais estaduais. O XSD PL 010f v1.04 verifica estrutura e literal; o exemplo não é uma nota completa.
O vIBSUF de totalização reúne valores de itens; o deste artigo pertence a det/imposto. vIBS no item soma estadual e municipal e pode ter dedução de crédito presumido quando o indicador específico manda. Assim, vIBSUF e vIBS só coincidem em hipóteses em que as demais parcelas não alteram a soma. Não some a CBS ao campo de IBS. UB54a-10, p. 47.
Como localizar a causa da 1041
Separe os retornos: 1041 aponta o valor estadual;1031 aponta a parcela diferida;1150 aponta a composição do IBS do item. No nItem indicado, confira base, nominal, redução/efetiva, diferimento e devolução na ordem em que entram na conta. Verifique se os dados do cadastro chegaram ao XML e se um parser não buscou vIBSUF nos totais.
Corrija a geração ou o parâmetro cuja divergência foi comprovada; preserve XML assinado/autorizado. Um teste XSD aprovado não substitui a regra de cálculo.
Depois de recompor o estadual, confira a combinação com o municipal em vIBS do item.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSUF/vIBSUF- 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