Rejeição 1031 — Valor do Diferimento da UF difere do calculado
Índice do artigo
- Resumo Rápido
- Solução rápida
- Dados rápidos
- Diagnóstico Rápido
- Mensagem da Rejeição
- O que significa essa rejeição?
- Fórmula de cálculo
- Atenção à redução de alíquota
- Sintomas Comuns
- Por que essa rejeição acontece?
- Valor de diferimento calculado incorretamente
- Percentual de diferimento errado
- Alíquota do IBS da UF incorreta
- Base de cálculo incorreta
- Redução de alíquota ignorada
- Arredondamento inadequado
- Parametrização incorreta do cClassTrib
- Causa Raiz
- Como Resolver
- Passo 1
- Passo 2
- Passo 3
- Passo 4
- Passo 5
- Passo 6
- Passo 7
- Passo 8
- Passo 9
- Passo 10
- Exemplo Prático
- Exemplo XML
- XML com erro
- Por que está errado?
- XML corrigido
- O que mudou?
- Como Identificar o Problema no ERP
- Onde verificar
- O que procurar
- Pontos de Atenção para ERP
- Percentual não é fator decimal
- Arredondamento deve ser consistente
- O item precisa ser recalculado
- Impactos para a Empresa
- Fiscal
- Faturamento
- Financeiro
- Estoque
- Contabilidade
- Suporte ERP
- O que NÃO Fazer
- Caso Real
- Como Evitar Essa Rejeição
- Fluxograma de Diagnóstico
- FAQ
- O que é a Rejeição 1031?
- Qual campo causa essa rejeição?
- Qual é a fórmula do diferimento da UF?
- A rejeição ocorre em NF-e e NFC-e?
- Diferença de centavos pode gerar a rejeição?
- O campo <pIBSUF> deve ser informado como 0.001 para representar 0,1%?
- E se houver redução de alíquota?
- Essa rejeição tem relação com cClassTrib?
- Qual a diferença entre as rejeições 1029, 1030 e 1031?
- Como corrigir no ERP?
- Base Legal
- Artigos Relacionados
- Resumo

Rejeição 1031 — Valor do Diferimento da UF difere do calculado
Resumo Rápido
A Rejeição 1031 ocorre quando o valor do diferimento do IBS da UF informado na NF-e ou NFC-e é diferente do valor calculado pela regra de validação da SEFAZ.
Na prática, o XML informa o grupo de diferimento da UF, dentro do grupo do IBS/CBS, mas o campo <vDif> não corresponde ao cálculo esperado a partir da base de cálculo, da alíquota do IBS da UF e do percentual de diferimento.
A mensagem normalmente vem acompanhada da indicação do item com problema:
1031 - Valor do Diferimento da UF difere do calculado [nItem: 999]Solução rápida
- Localize o item indicado em
[nItem]. - Verifique a base de cálculo do IBS/CBS em
<vBC>. - Confira a alíquota do IBS da UF em
<pIBSUF>. - Confira o percentual de diferimento em
<pDif>. - Recalcule o valor de
<vDif>. - Revise se existe redução de alíquota e se deve ser usada a alíquota efetiva.
- Gere novamente o XML e retransmita a NF-e.
Dados rápidos
Diagnóstico Rápido
- O item indicado em `[nItem]` possui grupo `<gIBSUF><gDif>`?
- O campo `<vBC>` está correto?
- O campo `<pIBSUF>` está correto?
- O campo `<pDif>` está correto?
- O valor de `<vDif>` foi calculado com a fórmula correta?
- Existe redução de alíquota no grupo `<gRed>`?
- O ERP usou `<pIBSUF>` quando deveria usar `<pAliqEfet>`?
- Houve erro de casas decimais no percentual?
- O valor foi arredondado incorretamente?
- O item foi recalculado após alteração da regra fiscal?
Mensagem da Rejeição
1031 - Valor do Diferimento da UF difere do calculado [nItem: 999]
O que significa essa rejeição?
A Rejeição 1031 significa que a SEFAZ recalculou o valor do diferimento do IBS de competência da UF e encontrou diferença em relação ao valor informado no XML.
O campo afetado é o valor do diferimento da UF, representado pela tag:
<vDif>...</vDif>Esse campo fica dentro do grupo de diferimento da UF:
<gIBSUF>
<gDif>
<pDif>...</pDif>
<vDif>...</vDif>
</gDif>
</gIBSUF>Quando o grupo de diferimento é informado, o valor de <vDif> precisa bater com o cálculo esperado para aquele item.
Fórmula de cálculo
Em regra geral, o valor do diferimento da UF deve ser calculado assim:
vDif = vBC × (pIBSUF / 100) × (pDif / 100)Onde:
Exemplo:
vBC = 1.000,00
pIBSUF = 0,1000%
pDif = 50,0000%Cálculo:
vDif = 1.000,00 × (0,1000 / 100) × (50,0000 / 100)
vDif = 1.000,00 × 0,001 × 0,50
vDif = 0,50Portanto, o valor correto de <vDif> seria:
<vDif>0.50</vDif>Atenção à redução de alíquota
Quando o item também possui grupo de redução de alíquota da UF, o cálculo pode exigir o uso da alíquota efetiva.
Nesse cenário, o ERP deve avaliar se o cálculo do diferimento deve considerar:
<pAliqEfet>...</pAliqEfet>em vez da alíquota cheia:
<pIBSUF>...</pIBSUF>Esse ponto é crítico porque uma nota pode estar aparentemente correta na alíquota do IBS da UF, mas ainda assim gerar a Rejeição 1031 se o cálculo de <vDif> não considerar a alíquota aplicável após a redução.
Sintomas Comuns
- Rejeição apenas em itens com diferimento.
- Rejeição em operações com CST/cClassTrib específicos da Reforma Tributária.
- Diferença de poucos centavos.
- Erro após atualização da tabela de cClassTrib.
- Erro após alteração de alíquota ou percentual de diferimento.
- XML com
<pDif>informado, mas<vDif>calculado incorretamente. - ERP calculando o diferimento sobre percentual errado.
- Integração enviando valores já arredondados.
- Problema em notas com redução de alíquota e diferimento ao mesmo tempo.
Por que essa rejeição acontece?
Valor de diferimento calculado incorretamente
O ERP informa um valor em <vDif> que não corresponde ao resultado esperado pela SEFAZ.
Percentual de diferimento errado
O campo <pDif> pode estar incorreto, desatualizado ou parametrizado para a classificação tributária errada.
Alíquota do IBS da UF incorreta
O campo <pIBSUF> pode estar errado ou incompatível com o período de transição aplicável.
Base de cálculo incorreta
Se a base de cálculo <vBC> estiver incorreta, o valor do diferimento também será calculado incorretamente.
Redução de alíquota ignorada
Quando há redução de alíquota, o sistema pode precisar usar a alíquota efetiva no cálculo do diferimento.
Arredondamento inadequado
Diferenças de centavos podem ocorrer quando o ERP arredonda valores intermediários em vez de arredondar apenas o resultado final.
Parametrização incorreta do cClassTrib
Algumas classificações tributárias exigem ou permitem diferimento. Se a regra estiver mal parametrizada, o ERP pode gerar o grupo de forma incorreta.
Causa Raiz
A causa raiz da Rejeição 1031 é uma inconsistência matemática no cálculo do valor do diferimento do IBS da UF.
A SEFAZ não está apenas verificando se o grupo foi informado. Ela compara o valor declarado em <vDif> com o valor que deveria resultar da combinação entre:
- Base de cálculo do IBS/CBS.
- Alíquota do IBS da UF.
- Percentual de diferimento.
- Eventual alíquota efetiva, quando houver redução.
- Regras de arredondamento aceitas.
Se o valor informado não corresponder ao valor calculado, a NF-e ou NFC-e será rejeitada.
Como Resolver
Passo 1
Identifique o item indicado na mensagem da rejeição.
Exemplo:
[nItem: 3]Isso indica que a divergência está no item 3 da NF-e.
Passo 2
No XML, localize o grupo de IBS/CBS do item:
<IBSCBS>
...
</IBSCBS>Passo 3
Verifique a base de cálculo:
<vBC>...</vBC>Passo 4
Verifique a alíquota do IBS da UF:
<pIBSUF>...</pIBSUF>Passo 5
Verifique o percentual de diferimento:
<pDif>...</pDif>Passo 6
Recalcule o valor do diferimento:
vDif = vBC × (pIBSUF / 100) × (pDif / 100)Passo 7
Compare o resultado calculado com o valor informado no XML:
<vDif>...</vDif>Passo 8
Se houver grupo de redução de alíquota, revise se o ERP deve usar a alíquota efetiva:
<pAliqEfet>...</pAliqEfet>Passo 9
Corrija a parametrização fiscal no ERP.
Passo 10
Redigite ou recalcule o item, gere um novo XML e transmita novamente a NF-e.
Exemplo Prático
Uma NF-e possui um item com as seguintes informações:
Base de cálculo do IBS/CBS: 1.000,00
Alíquota do IBS da UF: 0,1000%
Percentual de diferimento: 50,0000%Cálculo correto:
1.000,00 × 0,001 × 0,50 = 0,50Porém, o XML foi gerado assim:
<vDif>0.60</vDif>Como o valor correto seria 0.50, a SEFAZ rejeita a nota com a Rejeição 1031.
Exemplo XML
XML com erro
<IBSCBS>
<CST>200</CST>
<cClassTrib>200002</cClassTrib>
<gIBSCBS>
<vBC>1000.00</vBC>
<gIBSUF>
<pIBSUF>0.1000</pIBSUF>
<gDif>
<pDif>50.0000</pDif>
<vDif>0.60</vDif>
</gDif>
<vIBSUF>0.40</vIBSUF>
</gIBSUF>
</gIBSCBS>
</IBSCBS>Por que está errado?
O valor correto do diferimento deveria ser:
1000.00 × (0.1000 / 100) × (50.0000 / 100) = 0.50O XML informou:
<vDif>0.60</vDif>XML corrigido
<IBSCBS>
<CST>200</CST>
<cClassTrib>200002</cClassTrib>
<gIBSCBS>
<vBC>1000.00</vBC>
<gIBSUF>
<pIBSUF>0.1000</pIBSUF>
<gDif>
<pDif>50.0000</pDif>
<vDif>0.50</vDif>
</gDif>
<vIBSUF>0.50</vIBSUF>
</gIBSUF>
</gIBSCBS>
</IBSCBS>O que mudou?
O campo <vDif> passou a refletir corretamente o cálculo do valor diferido da UF.
Também foi ajustado o valor de <vIBSUF> para manter coerência com o valor remanescente do IBS da UF após o diferimento.
Como Identificar o Problema no ERP
Onde verificar
- Cadastro tributário da Reforma Tributária.
- Configuração de IBS/CBS.
- Cadastro de CST do IBS/CBS.
- Cadastro de cClassTrib.
- Regra fiscal do produto.
- Regra fiscal da operação.
- Parametrização de diferimento.
- Parametrização de redução de alíquota.
- XML gerado.
- Rotinas de arredondamento.
O que procurar
- Percentual de diferimento incorreto.
- Alíquota do IBS da UF incorreta.
- Base de cálculo divergente.
- Uso indevido de alíquota cheia em vez de alíquota efetiva.
- Campos preenchidos com casas decimais erradas.
- Valor de
<vDif>calculado manualmente ou sobrescrito. - Integração externa enviando valor pronto ao ERP.
- Item alterado sem recálculo dos impostos.
Pontos de Atenção para ERP
Percentual não é fator decimal
No XML, percentuais devem ser informados como percentual, não como fator matemático.
Exemplo:
0,1000% deve ser informado como 0.1000Não como:
0.001Esse erro é comum quando integrações enviam percentuais já convertidos para fator decimal.
Arredondamento deve ser consistente
O ERP deve evitar arredondar valores intermediários de forma diferente da regra esperada pela SEFAZ.
Em geral, o mais seguro é:
- Calcular com precisão interna maior.
- Arredondar o valor final conforme o tamanho do campo.
- Manter consistência entre
<vDif>e<vIBSUF>.
O item precisa ser recalculado
Após mudar CST, cClassTrib, alíquota, redução ou diferimento, não basta alterar o cadastro.
É necessário recalcular ou redigitar o item da nota para que os valores do XML sejam atualizados.
Impactos para a Empresa
Fiscal
A NF-e ou NFC-e não será autorizada enquanto o cálculo do diferimento estiver incorreto.
Faturamento
A operação fica bloqueada até a correção do XML.
Financeiro
Pode haver atraso no faturamento, cobrança ou recebimento.
Estoque
A expedição pode ser impactada se depender da autorização da NF-e.
Contabilidade
A escrituração pode ser afetada se houver inconsistência entre imposto calculado, imposto diferido e imposto efetivamente destacado.
Suporte ERP
A rejeição tende a gerar chamados fiscais, especialmente em fases de implantação da Reforma Tributária.
O que NÃO Fazer
- Não alterar apenas o XML manualmente.
- Não trocar o CST ou cClassTrib sem validar a regra fiscal.
- Não informar
<vDif>com valor aproximado. - Não usar fator decimal no campo percentual.
- Não ignorar o grupo de redução de alíquota quando ele existir.
- Não corrigir apenas
<vDif>e esquecer<vIBSUF>. - Não tratar a rejeição como erro da SEFAZ sem antes revisar o cálculo.
- Não deixar a integração externa sobrescrever o cálculo do ERP sem validação.
Caso Real
Uma empresa atualizou seu ERP para emitir documentos com os campos da Reforma Tributária.
Durante os testes em homologação, algumas NF-es com CST e cClassTrib que utilizavam diferimento do IBS da UF começaram a retornar a Rejeição 1031.
A análise do XML mostrou que a base de cálculo e a alíquota estavam corretas, mas o valor de <vDif> havia sido calculado sobre o percentual cheio da operação, sem considerar corretamente o percentual de diferimento configurado.
Após revisar a regra fiscal, ajustar o percentual de diferimento e recalcular os itens da nota, o XML passou a ser autorizado.
Como Evitar Essa Rejeição
- Manter atualizada a tabela de CST e cClassTrib do IBS/CBS.
- Validar quais classificações exigem ou permitem diferimento.
- Parametrizar corretamente os percentuais de diferimento.
- Testar cenários com diferimento total e parcial.
- Testar cenários com redução de alíquota e diferimento juntos.
- Automatizar validações antes da transmissão.
- Evitar edição manual de valores fiscais.
- Conferir fórmulas usadas por integrações.
- Usar ambiente de homologação para validar operações fiscais novas.
- Monitorar rejeições durante a implantação da Reforma Tributária.
Fluxograma de Diagnóstico
Recebeu Rejeição 1031?
├─ Identificou o item em [nItem]?
│ ├─ Não → Localizar item no XML
│ └─ Sim
│
├─ Existe grupo gIBSUF/gDif?
│ ├─ Não → Verificar outra inconsistência no XML/regra
│ └─ Sim
│
├─ vBC, pIBSUF e pDif estão corretos?
│ ├─ Não → Corrigir parametrização fiscal
│ └─ Sim
│
├─ Existe redução de alíquota?
│ ├─ Sim → Verificar uso de pAliqEfet no cálculo
│ └─ Não → Usar pIBSUF no cálculo
│
├─ vDif bate com o cálculo?
│ ├─ Não → Corrigir vDif e recalcular item
│ └─ Sim → Revisar arredondamento e demais campos do IBS da UFFAQ
O que é a Rejeição 1031?
É a rejeição que ocorre quando o valor do diferimento do IBS da UF informado no XML difere do valor calculado pela SEFAZ.
Qual campo causa essa rejeição?
O campo principal é <vDif>, dentro do grupo <gIBSUF><gDif>.
Qual é a fórmula do diferimento da UF?
A fórmula geral é:
vDif = vBC × (pIBSUF / 100) × (pDif / 100)A rejeição ocorre em NF-e e NFC-e?
Sim. A validação está associada aos modelos 55 e 65, conforme as regras da Reforma Tributária.
Diferença de centavos pode gerar a rejeição?
Sim. Diferenças fora da tolerância aceita pela validação podem causar a rejeição.
O campo <pIBSUF> deve ser informado como 0.001 para representar 0,1%?
Não. Percentual deve ser informado como percentual. Para 0,1%, o valor normalmente deve ser 0.1000, não 0.001.
E se houver redução de alíquota?
O ERP deve avaliar se a alíquota efetiva <pAliqEfet> deve ser usada no cálculo do diferimento.
Essa rejeição tem relação com cClassTrib?
Sim. O cClassTrib define se a operação permite ou exige determinados grupos tributários, incluindo diferimento em alguns cenários.
Qual a diferença entre as rejeições 1029, 1030 e 1031?
A 1029 ocorre quando o CST/cClassTrib não permite diferimento estadual. A 1030 ocorre quando a classificação exige diferimento da UF e ele não foi informado. A 1031 ocorre quando o diferimento foi informado, mas o valor calculado está incorreto.
Como corrigir no ERP?
Revise a regra fiscal, CST, cClassTrib, alíquota do IBS da UF, percentual de diferimento, redução de alíquota e arredondamentos. Depois, recalcule o item e gere novo XML.
Base Legal
- Projeto NF-e.
- Nota Técnica 2025.002 — Reforma Tributária do Consumo.
- Regras de Validação da NF-e e NFC-e.
- Lei Complementar nº 214/2025.
- Tabela de CST do IBS/CBS.
- Tabela de cClassTrib do IBS/CBS.
Artigos Relacionados
- IBS
- CBS
- Reforma Tributária
- cClassTrib
- CST IBS/CBS
- Diferimento
- Rejeição 1029
- Rejeição 1030
- Rejeição 1032
- Rejeição 1041
Resumo
A Rejeição 1031 ocorre quando o valor do diferimento do IBS da UF informado no campo <vDif> difere do valor calculado pela SEFAZ. A correção exige revisar base de cálculo, alíquota do IBS da UF, percentual de diferimento, eventual redução de alíquota, arredondamentos e parametrização fiscal do ERP. Depois da correção, o item deve ser recalculado, o XML deve ser gerado novamente e a NF-e ou NFC-e deve ser retransmitida.