G5 | Importação de DF-e referenciado em NF-e de devolução

Maria das Graças P. Rariz Godinho
Maria das Graças P. Rariz Godinho
  • ✎ Criado em:
  • ✔ Atualizado em:

Resumo:

1. O sistema G5 permite importar automaticamente ou preencher manualmente os campos "Chave doc. eletrônico referenciado" e "No. item" na tela Itens da NF, essenciais para NF-e de devolução. 

2. A importação via XML captura esses dados do grupo DF-e referenciado, sem alterar outros campos.

3. Validações garantem formato correto e unicidade, bloqueando erros. 

4. A funcionalidade é obrigatória para NF-e modelo 55 a partir de 01/09/2026, conforme NT 2025.002-RTC v1.40.

 

Ícone com dois retângulos roxos, um grande e um pequeno, representando o produto Escrita Fiscal (antigo G5).

🎯 Pré-requisitos


 

 

Onde encontrar os campos


 

Os campos estão localizados na tela Itens da NF, dentro da seção "Chave doc. eletrônico referenciado".

Caminho de acesso:

  • Via importação: Escrituração → Notas ICMS/IPI → Importar NFE → Importar
  • Via digitação: Escrituração → Notas ICMS/IPI → Lançamento de notas fiscais → subtela "Itens"

 

Campos disponíveis


 

Campo

Descrição

Formato

Chave doc. eletrônico referenciado Chave de acesso do documento fiscal de origem (NF-e que originou a devolução) 44 dígitos numéricos exatos
No. item Número do item no documento de origem ao qual este item de devolução se refere Número inteiro de 1 a 999

 

Como funciona a importação automática via XML


 

Primeiramente, se certifique que você atende aos Pré-requisitos citados anteriormente. Caso sim, prossiga com a leitura abaixo:

Ao importar o XML de uma NF-e de devolução que contenha o grupo DF-e referenciado, o sistema captura automaticamente os dados de cada item:

Etapa

O que acontece

1. Processamento do XML O sistema lê cada item (<det>) da NF-e e verifica se existe o grupo <DFeReferenciado>.
2. Extração dos dados Se o grupo estiver presente, o sistema extrai a chave de acesso (44 dígitos) e o número do item e preenche automaticamente os campos correspondentes.
3. Item sem DF-e referenciado Se o item no XML não possuir o grupo, os campos ficam em branco. Nenhum alerta é gerado — isso é esperado.
4. Isolamento por item Cada item recebe exclusivamente os dados do seu próprio registro no XML. Não há cruzamento de dados entre itens.
5. Demais campos preservados Os campos já existentes do item (NCM, CFOP, quantidades, valores, impostos) não são alterados pela importação do DF-e referenciado.

 

Preenchimento manual


 

Caso a NF-e não tenha sido importada via XML ou os dados precisem de correção, o usuário pode preencher ou alterar os campos diretamente na tela de Itens da NF.

Para isso:

  1. Acesse a nota fiscal desejada;
  2. Na subtela Itens, localize a seção "Chave doc. eletrônico referenciado";
  3. Preencha a Chave doc. eletrônico referenciado com os 44 dígitos da chave de acesso do documento de origem;
  4. Preencha o No. item com o número do item correspondente no documento de origem (1 a 999);
  5. Clique em Gravar.

 

Validações e mensagens de erro


 

O sistema realiza validações tanto na importação via XML quanto no preenchimento manual. Abaixo estão as situações que podem gerar bloqueio:

Situação

Mensagem exibida

O que fazer

Chave de acesso com quantidade de dígitos diferente de 44 "A chave de acesso deve conter 44 dígitos." Verifique a chave de acesso do documento de origem e corrija para que contenha exatamente 44 dígitos numéricos.
No. item fora do intervalo (menor que 1 ou maior que 999) "O número do item deve ser um valor inteiro entre 1 e 999." Informe um número inteiro entre 1 e 999, conforme o item correspondente no documento de origem.
No. item preenchido sem a chave de acesso "Informe a chave de acesso do documento referenciado antes de informar o número do item." Preencha primeiro a chave de acesso (44 dígitos) e em seguida o número do item.
Chave de acesso preenchida sem o No. Item "O número do item é obrigatório quando a chave de acesso está preenchida." Informe o número do item correspondente no documento de origem.
Mesma combinação de chave + item já usada em outro item da NF-e "Este documento e item já foram referenciados em outro item desta NF-e." Verifique se outro item da mesma NF-e já referencia a mesma chave de acesso e número do item. Cada combinação deve ser única dentro da nota.

 

Erros na importação de XML

Caso o XML contenha dados inválidos no grupo DF-e Referenciado, a nota inteira não será importada. As mensagens seguem o padrão:

Erro

"Nota (número) com CFOP (cfop) não importada. Motivo: A chave doc. referenciado deve conter 44 dígitos."

"Nota (número) com CFOP (cfop) não importada. Motivo: No Item deve ter até 3 dígitos."

Nesses casos, é necessário verificar o XML de origem e, se necessário, solicitar a correção ao emissor do documento.

 

Perguntas frequentes


 

Essa funcionalidade se aplica a NFC-e (modelo 65)?

Não. A seção "Chave doc. eletrônico referenciado" é exibida apenas para NF-e modelo 55. Para NFC-e a seção não aparece na tela.

Se o XML não tiver o grupo DF-e referenciado, haverá algum erro?

Não. Os campos ficam em branco e nenhum alerta é gerado. Isso é comportamento esperado para documentos que não são de devolução ou que foram emitidos antes da vigência da NT 2025.002.

Posso alterar os dados que vieram da importação do XML?

Sim. Os campos são editáveis e podem ser corrigidos manualmente a qualquer momento. As mesmas validações se aplicam ao salvar.

A importação do DF-e referenciado altera outros campos do item (CFOP, valores, impostos)?

Não. Apenas os campos "Chave doc. eletrônico referenciado" e "No. item" são preenchidos. Todos os demais campos permanecem inalterados.

Quando essa funcionalidade entra em vigor?

A obrigatoriedade do grupo DF-e referenciado em NF-e de devolução pela SEFAZ entra em produção em 01/09/2026, conforme a NT 2025.002-RTC v1.40.



 

 

 

Relativo a

Esse artigo foi útil?