Rejeição 1010 — NF-e com referenciamento de documento a nível de nota e a nível de item

Resumo Rápido

A Rejeição 1010 ocorre quando uma NF-e informa documento fiscal referenciado em dois níveis ao mesmo tempo:

No nível da nota, pelo grupo <NFref>.
No nível do item, pelo grupo <DFeReferenciado>.

Na prática, a SEFAZ identifica que a nota está referenciando documento fiscal no cabeçalho e também em um ou mais itens. Esse preenchimento simultâneo não é permitido para a regra de validação aplicada.

A rejeição está relacionada às novas validações da Reforma Tributária do Consumo, especialmente ao controle de referenciamento de documentos e itens para operações de devolução, débito, crédito, ajustes e rastreabilidade de IBS/CBS.

Solução rápida

Verifique se existe documento referenciado no cabeçalho da NF-e, no grupo <NFref>.
Verifique se existe documento referenciado nos itens, no grupo <DFeReferenciado>.
Escolha apenas uma forma de referenciamento.
Remova o referenciamento indevido.
Gere novamente o XML.
Transmita a NF-e novamente.

Dados rápidos

Diagnóstico Rápido

Existe `<NFref>` informado no cabeçalho da NF-e?
Existe `<DFeReferenciado>` informado em algum item?
A operação exige referenciamento por item?
A referência deveria ser apenas da nota inteira?
A NF-e é de devolução, débito, crédito ou ajuste?
O ERP gerou automaticamente documentos referenciados?
Alguma integração enviou referência duplicada?
A mesma chave de acesso aparece em mais de um local do XML?
A operação foi parametrizada recentemente para Reforma Tributária?
O XML foi alterado manualmente antes da transmissão?

Mensagem da Rejeição

1010 - NF-e com referenciamento de documento a nível de nota e a nível de item [nItem: 999]

O que significa essa rejeição?

A Rejeição 1010 significa que a NF-e possui referenciamento de documento fiscal em dois pontos diferentes do XML.

O primeiro é o referenciamento tradicional no cabeçalho da nota, por meio do grupo:

<NFref>
   ...
</NFref>

O segundo é o referenciamento no nível do item, por meio do grupo:

<DFeReferenciado>
   ...
</DFeReferenciado>

Com as adequações da Reforma Tributária, o layout da NF-e passou a permitir um referenciamento mais detalhado em determinados cenários. Em vez de apenas dizer que a nota se relaciona com outra NF-e inteira, o XML pode indicar que determinado item da nota atual está relacionado a determinado item de outro documento fiscal.

Esse controle é importante para rastreabilidade, devoluções, créditos, débitos, ajustes e apuração dos novos tributos.

O problema ocorre quando o ERP informa os dois tipos de referência ao mesmo tempo para a mesma operação.

Em termos simples:

Ou a NF-e referencia documento no cabeçalho,
ou referencia documento no item.
 
Não deve fazer os dois ao mesmo tempo quando a regra de validação não permitir.

Sintomas Comuns

A NF-e é rejeitada logo após a transmissão.
A mensagem retorna com indicação de item.
O XML possui <NFref> no grupo <ide>.
O XML também possui <DFeReferenciado> em um ou mais itens.
A rejeição aparece em notas de devolução, crédito, débito ou ajuste.
O erro surge após atualização do ERP para o layout da Reforma Tributária.
A operação funcionava antes da inclusão dos novos campos de IBS/CBS.
O usuário informa a chave da nota original em mais de uma tela do ERP.
A integração externa envia referência no cabeçalho e o ERP complementa no item.
A mesma chave de acesso aparece repetida em pontos diferentes do XML.

Por que essa rejeição acontece?

Referência informada no cabeçalho e no item

A causa mais direta é a existência simultânea dos grupos <NFref> e <DFeReferenciado>.

O grupo <NFref> indica que a NF-e atual referencia outro documento fiscal no nível da nota inteira.

O grupo <DFeReferenciado> indica que determinado item referencia outro documento fiscal ou item específico de outro documento.

Quando os dois aparecem juntos em situação não permitida, ocorre a rejeição.

Parametrização duplicada no ERP

Muitos ERPs possuem parametrizações diferentes para documentos referenciados.

Por exemplo:

Uma configuração no cabeçalho da nota.
Uma configuração no item.
Uma configuração no tipo de operação.
Uma configuração herdada do pedido de venda.
Uma configuração trazida da nota original.

Quando essas regras se sobrepõem, o XML pode sair com referência duplicada.

Atualização incompleta para a Reforma Tributária

Com a inclusão dos novos grupos de referenciamento por item, algumas rotinas antigas de emissão podem continuar preenchendo <NFref> enquanto novas rotinas passam a preencher <DFeReferenciado>.

Esse cenário é comum em sistemas que receberam atualização parcial do layout, mas não tiveram as regras de negócio totalmente revisadas.

Operações de devolução

Em devoluções, o referenciamento da nota original é comum.

Antes das mudanças recentes, muitas empresas referenciavam a NF-e original apenas no cabeçalho.

Com a Reforma Tributária, determinados cenários passam a exigir ou permitir referência mais detalhada no nível do item.

Se o ERP mantém o referenciamento antigo e adiciona o novo, a rejeição pode ocorrer.

Integrações externas

A rejeição também pode ocorrer quando um sistema externo envia dados para o ERP, como:

Plataforma de pedidos.
Sistema fiscal.
Middleware de integração.
API de emissão.
Sistema de loja virtual.
Sistema de devolução.
Sistema de logística reversa.

Se a integração envia a chave referenciada no cabeçalho e o ERP gera a referência por item, o XML pode ficar inconsistente.

Cópia de nota ou reaproveitamento de XML

Algumas empresas geram notas de devolução, complemento, crédito ou débito copiando dados de documentos anteriores.

Se a rotina de cópia carrega a referência no cabeçalho e, depois, o usuário informa a referência no item, a duplicidade pode ser gerada sem que fique evidente na tela.

Causa Raiz

A causa raiz da Rejeição 1010 é a falta de definição clara sobre o nível correto de referenciamento do documento fiscal.

A operação precisa ser tratada por uma única lógica:

Referenciamento no nível da nota; ou
Referenciamento no nível do item.

O erro aparece quando o ERP, a parametrização fiscal ou a integração tenta usar as duas lógicas ao mesmo tempo.

As causas mais frequentes são:

Documento referenciado informado no cabeçalho e no item.
Tipo de operação configurado com referência automática.
Usuário informando manualmente referência adicional.
Regra fiscal antiga convivendo com regra nova da Reforma Tributária.
Integração externa preenchendo campos que o ERP também preenche.
Customização fiscal sem validação do XML final.
Falta de consistência entre operação, finalidade da NF-e e grupos de referenciamento.

Como Resolver

Passo 1

Abra o XML rejeitado.

Localize o grupo de documentos referenciados no cabeçalho da NF-e:

<ide>
   ...
   <NFref>
      ...
   </NFref>
   ...
</ide>

Se esse grupo existir, a nota possui referência no nível da nota.

Passo 2

Verifique os itens da NF-e.

Procure o grupo de documento fiscal referenciado no item:

<det nItem="1">
   ...
   <DFeReferenciado>
      ...
   </DFeReferenciado>
   ...
</det>

Se esse grupo existir em um ou mais itens, a nota possui referência no nível do item.

Passo 3

Confirme qual nível de referenciamento a operação realmente exige.

Use a regra de negócio da operação:

A referência vale para a nota inteira?
A referência vale para itens específicos?
A operação é devolução?
A operação é nota de débito?
A operação é nota de crédito?
O documento original precisa ser rastreado por item?
O ERP está gerando os grupos conforme a finalidade da NF-e?

Essa decisão não deve ser feita apenas olhando a rejeição. Ela precisa considerar a operação fiscal.

Passo 4

Se a referência correta for no nível da nota, mantenha o grupo <NFref> e remova os grupos <DFeReferenciado> dos itens.

Esse cenário faz sentido quando o documento referenciado se aplica à nota como um todo.

Passo 5

Se a referência correta for no nível do item, remova o grupo <NFref> do cabeçalho e mantenha apenas os grupos <DFeReferenciado> nos itens correspondentes.

Esse cenário faz sentido quando cada item precisa se relacionar com item específico de outro documento fiscal.

Passo 6

Revise a parametrização do ERP.

Verifique principalmente:

Tipo de operação.
Finalidade da NF-e.
Configuração de devolução.
Configuração de nota de débito.
Configuração de nota de crédito.
Rotina de cópia de nota.
Regras de importação de XML.
Regras de integração.
Rotinas customizadas de geração do XML.

Passo 7

Gere novamente o XML e valide se apenas um nível de referenciamento foi mantido.

Passo 8

Transmita novamente a NF-e.

Exemplo Prático

Uma empresa precisa emitir uma NF-e relacionada a documento fiscal anterior.

No ERP, o usuário informa a chave da NF-e original no campo de documento referenciado do cabeçalho.

Depois, ao preencher os dados da Reforma Tributária, o sistema também informa a mesma chave no item da nota, dentro do grupo de DFe referenciado.

O XML fica com:

Referência no cabeçalho da NF-e
+
Referência no item da NF-e

Resultado:

Rejeição 1010

A correção consiste em escolher apenas uma forma de referenciamento, conforme a regra aplicável à operação.

Exemplo XML

XML com erro

<NFe>
   <infNFe>
      <ide>
         <cUF>35</cUF>
         <natOp>Devolução de mercadoria</natOp>
         <mod>55</mod>
         <serie>1</serie>
         <nNF>12345</nNF>
 
         <NFref>
            <refNFe>35260199999999999999550010000000011234567890</refNFe>
         </NFref>
      </ide>
 
      <det nItem="1">
         <prod>
            <cProd>PROD001</cProd>
            <xProd>Produto de exemplo</xProd>
         </prod>
 
         <DFeReferenciado>
            <chaveAcesso>35260199999999999999550010000000011234567890</chaveAcesso>
            <nItem>1</nItem>
         </DFeReferenciado>
      </det>
   </infNFe>
</NFe>

Nesse exemplo, a NF-e possui documento referenciado no cabeçalho pelo grupo <NFref> e também no item pelo grupo <DFeReferenciado>.

XML corrigido com referência no nível do item

<NFe>
   <infNFe>
      <ide>
         <cUF>35</cUF>
         <natOp>Devolução de mercadoria</natOp>
         <mod>55</mod>
         <serie>1</serie>
         <nNF>12345</nNF>
      </ide>
 
      <det nItem="1">
         <prod>
            <cProd>PROD001</cProd>
            <xProd>Produto de exemplo</xProd>
         </prod>
 
         <DFeReferenciado>
            <chaveAcesso>35260199999999999999550010000000011234567890</chaveAcesso>
            <nItem>1</nItem>
         </DFeReferenciado>
      </det>
   </infNFe>
</NFe>

Nesse caso, o grupo <NFref> foi removido e a referência ficou apenas no item.

XML corrigido com referência no nível da nota

<NFe>
   <infNFe>
      <ide>
         <cUF>35</cUF>
         <natOp>Operação relacionada a documento anterior</natOp>
         <mod>55</mod>
         <serie>1</serie>
         <nNF>12345</nNF>
 
         <NFref>
            <refNFe>35260199999999999999550010000000011234567890</refNFe>
         </NFref>
      </ide>
 
      <det nItem="1">
         <prod>
            <cProd>PROD001</cProd>
            <xProd>Produto de exemplo</xProd>
         </prod>
      </det>
   </infNFe>
</NFe>

Nesse caso, o grupo <DFeReferenciado> foi removido e a referência ficou apenas no cabeçalho.

O que mudou?

O XML deixou de informar o documento referenciado simultaneamente no nível da nota e no nível do item.

A NF-e passou a usar apenas uma forma de referenciamento.

Como Identificar o Problema no ERP

Onde verificar

Tela de emissão da NF-e.
Aba de documentos referenciados.
Aba de itens/produtos.
Configuração do tipo de operação.
Configuração de devolução.
Configuração de nota de débito.
Configuração de nota de crédito.
Parametrização da Reforma Tributária.
Integrações fiscais.
Rotinas de importação de XML.
XML gerado antes da transmissão.

O que procurar

Chave de acesso informada no cabeçalho.
Chave de acesso informada no item.
Mesma chave repetida em mais de um local.
Referência automática herdada da nota original.
Campo de documento referenciado preenchido manualmente.
Tipo de operação configurado para gerar <NFref> automaticamente.
Integração enviando dados de referência por item.
Customização criando grupo <DFeReferenciado> sem remover <NFref>.

Pergunta prática para o suporte

A pergunta que resolve metade do diagnóstico é:

Essa referência pertence à nota inteira ou a um item específico?

Se a resposta for “nota inteira”, o caminho tende a ser <NFref>.

Se a resposta for “item específico”, o caminho tende a ser <DFeReferenciado>.

Impactos para a Empresa

Fiscal

A NF-e não é autorizada, impedindo a formalização da operação.

Faturamento

A venda, devolução, débito, crédito ou ajuste pode ficar bloqueado.

Logística

A mercadoria pode não ser expedida ou recebida corretamente.

Estoque

Operações de devolução ou ajuste podem ficar pendentes.

Financeiro

Cobranças, abatimentos ou créditos podem atrasar.

Contabilidade

A escrituração pode ser impactada se o documento não for emitido dentro do período correto.

Suporte ERP

A equipe pode precisar analisar XML, parametrização fiscal, tipo de operação e integração.

O que NÃO Fazer

Não remover o documento referenciado sem entender a operação.
Não manter <NFref> e <DFeReferenciado> ao mesmo tempo.
Não alterar o XML manualmente em produção.
Não assumir que a rejeição é erro da SEFAZ.
Não resolver apenas apagando campos sem revisar o tipo de operação.
Não deixar a integração e o ERP preencherem a mesma referência.
Não tratar devolução, nota de débito e nota de crédito como se fossem operações iguais.
Não ignorar o campo [nItem: 999], pois ele ajuda a localizar o item envolvido.
Não corrigir apenas uma nota se a origem for parametrização do ERP.
Não copiar a nota rejeitada sem limpar os documentos referenciados.

Caso Real

Uma empresa atualizou o ERP para contemplar os campos da Reforma Tributária.

Antes da atualização, as notas de devolução referenciavam a NF-e original apenas no cabeçalho, usando o grupo <NFref>.

Depois da atualização, o sistema passou a preencher também o grupo <DFeReferenciado> nos itens, para permitir o vínculo com o item da NF-e original.

Durante os primeiros testes, algumas notas passaram a ser rejeitadas com o código 1010.

A análise do XML mostrou que a mesma chave de acesso estava sendo informada no cabeçalho e também nos itens.

A correção foi feita em duas etapas:

O tipo de operação foi ajustado para não gerar <NFref> quando o referenciamento por item fosse utilizado.
A rotina de geração do XML passou a validar a existência dos dois grupos antes da transmissão.

Após a correção, as notas foram autorizadas corretamente.

Como Evitar Essa Rejeição

Definir claramente quando usar referência no cabeçalho.
Definir claramente quando usar referência por item.
Revisar tipos de operação após atualizações da Reforma Tributária.
Criar validação preventiva no ERP antes da transmissão.
Bloquear preenchimento simultâneo de <NFref> e <DFeReferenciado>.
Auditar integrações que enviam dados fiscais.
Testar devoluções, notas de débito, notas de crédito e ajustes em homologação.
Documentar o comportamento esperado por operação.
Treinar usuários para não informar a mesma chave em dois locais.
Validar XMLs com múltiplos itens antes de liberar em produção.
Revisar customizações fiscais antigas.
Monitorar rejeições após atualização de layout.

Fluxograma de Diagnóstico

Recebeu Rejeição 1010?
 
├─ Existe <NFref> no cabeçalho?
│
├─ Não
│   └─ Revisar se existe outro erro de referenciamento
│
└─ Sim
    │
    ├─ Existe <DFeReferenciado> em algum item?
    │
    ├─ Não
    │   └─ Revisar XML e regra aplicada
    │
    └─ Sim
        │
        ├─ A referência deve ser por item?
        │
        ├─ Sim
        │   └─ Remover <NFref> do cabeçalho
        │
        └─ Não
            └─ Remover <DFeReferenciado> dos itens

Checklist de Correção no ERP

Localizar a NF-e rejeitada.
Abrir o XML gerado.
Procurar o grupo `<NFref>`.
Procurar o grupo `<DFeReferenciado>`.
Identificar o item indicado na rejeição.
Confirmar a finalidade da NF-e.
Confirmar a operação fiscal.
Definir o nível correto de referenciamento.
Corrigir a parametrização.
Gerar novo XML.
Validar se apenas um tipo de referência ficou no XML.
Transmitir novamente.

Diferença entre Rejeição 1010, 1027, 1038, 1042 e 1072

Rejeição 1010

Ocorre quando há documento referenciado no nível da nota e também no nível do item.

Rejeição 1027

Ocorre quando a NF referenciada é informada indevidamente em determinado cenário.

Rejeição 1038

Ocorre quando o DFe referenciado deveria ser informado, mas não foi.

Rejeição 1042

Ocorre quando o referenciamento a nível de item é informado indevidamente.

Rejeição 1072

Ocorre quando há duplicidade de DFe ou item referenciado.

Essas rejeições pertencem ao mesmo universo de controle de documentos referenciados, mas cada uma aponta uma inconsistência diferente.

FAQ

A Rejeição 1010 é sobre ICMS, IBS ou CBS?

Ela não é uma rejeição de cálculo de imposto. É uma rejeição de estrutura e consistência do referenciamento de documentos fiscais.

A rejeição 1010 impede a emissão?

Sim. A NF-e não será autorizada enquanto o XML estiver com referenciamento simultâneo em nível de nota e item.

O que é referenciamento no nível da nota?

É quando a NF-e referencia outro documento fiscal no cabeçalho, normalmente pelo grupo <NFref>.

O que é referenciamento no nível do item?

É quando um item da NF-e referencia outro documento fiscal ou item específico, normalmente pelo grupo <DFeReferenciado>.

Posso informar `<NFref>` e `<DFeReferenciado>` juntos?

Para a situação validada pela Rejeição 1010, não. A regra exige que não exista referenciamento simultâneo nos dois níveis.

A mesma chave pode aparecer no cabeçalho e no item?

Não nessa situação. Se isso ocorrer, a NF-e pode ser rejeitada.

O `[nItem: 999]` indica o quê?

Indica o item da NF-e onde a regra encontrou a inconsistência relacionada ao referenciamento.

Essa rejeição se aplica à NFC-e?

A regra é tratada para NF-e modelo 55. A NFC-e possui restrições próprias e deve ser analisada conforme o modelo e a operação.

O ERP pode causar essa rejeição?

Sim. Normalmente a causa está em parametrização, integração, cópia de documento ou rotina de geração do XML.

Como saber qual referência manter?

A decisão depende da operação fiscal. Se a referência for da nota inteira, mantenha o cabeçalho. Se for de item específico, mantenha a referência no item.

Posso apenas apagar todos os documentos referenciados?

Não é recomendado. Algumas operações exigem documento referenciado. A correção correta é manter o nível adequado, não simplesmente apagar a referência.

Essa rejeição está relacionada à Reforma Tributária?

Sim. Ela está dentro do conjunto de novas validações e campos introduzidos para adequação da NF-e aos novos controles da Reforma Tributária do Consumo.

Base Legal

Projeto NF-e.
Manual de Orientação do Contribuinte.
Nota Técnica 2025.002 da Reforma Tributária do Consumo.
Regras de Validação da NF-e.
Leiaute da NF-e modelo 55.
Lei Complementar nº 214/2025.
Legislação aplicável ao IBS, CBS e documentos fiscais eletrônicos.

Resumo

A Rejeição 1010 ocorre quando a NF-e possui documento fiscal referenciado no nível da nota e também no nível do item. O erro normalmente aparece quando o XML contém o grupo <NFref> no cabeçalho e o grupo <DFeReferenciado> em um ou mais itens. Para resolver, é necessário definir se a operação exige referência da nota inteira ou de item específico, remover o referenciamento indevido, corrigir a parametrização do ERP e retransmitir a NF-e.

Rejeição 1010 — NF-e com referenciamento de documento a nível de nota e a nível de item

Conteúdo relacionado