Importação e Exportação DE DFES

---
title: Importação e Exportação de DFes
slug: importacao-exportacao-dfes
sistema: 
  - "Servidor Nota Fiscal Eletrônica [24]"
chamado: "0000544960"
categoria: user_manual
tipo: how-to
autor: Mauricio Issami Antunes Fujimoto
setor: Qualidade
modulo: ""
publico: ""
keywords:
  - importação
  - exportação
  - DF-e
  - EXPORTAR_DFES
  - server.ini
  - TEO_SERVER
  - Administrador do Servidor de Notas
versao_doc: 01
revisao: Paulo Henrique Quintas Bley
aprovado_em: Janeiro de 2026
release: ""
versao_pipeline: 2.5.2
ultima_revisao: "2026-06-11"
---

## Visão Geral

Este recurso permite exportar e importar Documentos Fiscais Eletrônicos (DF-e — NF-e, CT-e, NFS-e e outros documentos do ecossistema fiscal) entre diferentes servidores de notas do Teorema Sistemas. É útil em cenários de contingência, migração de ambiente, testes operacionais, auditorias e validações técnicas.

Com a funcionalidade ativa, o servidor exporta os DF-es processados em arquivos JSON para a pasta `server/share/export-files`. O Administrador do Servidor de Notas permite selecionar esses arquivos, gerar um pacote `.zip` e importá-lo em outro ambiente para realizar testes de transmissão, impressão, cancelamento ou resolução de duplicidade de forma controlada.

> **Nota:** Os documentos importados ficam armazenados apenas em memória. Se o servidor for finalizado, eles serão descartados e poderão ser importados novamente.

## Configurar a exportação de DF-e no serviço Teorema (EXPORTAR_DFES)

Acesse o arquivo de configuração `server.ini` do servidor de aplicação e localize a seção `[TEO_SERVER]`.

![Arquivo server.ini aberto em editor de texto, seção [TEO_SERVER] com a linha EXPORTAR_DFES = T destacada ao final da lista de parâmetros](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-06.png)

1. Na seção `[TEO_SERVER]`, ative o parâmetro `EXPORTAR_DFES = T`.
2. Reinicie o servidor de notas para que a configuração entre em vigor.

Com essa tag ativa, os documentos processados pelo servidor (enviados, cancelados, impressos, entre outros) serão exportados automaticamente como arquivos JSON na pasta:

```
server/share/export-files
```

![Windows Explorer exibindo o caminho javaapp > teoremaee7server2 > server > share > export-files, com quatro arquivos JSON de exportação listados (42_18-12-01-960.json, 42_18-33-21-706.json, 44_18-12-09-225.json, 44_18-32-55-751.json)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-07.png)

## Exportar DF-es pelo Administrador do Servidor de Notas

### Acessar o Administrador

Na tela inicial do Teorema Sistemas, clique em **Administrador**.

![Tela inicial do Teorema Sistemas com os botões Administrador (destacado), Auditor e XML-Center](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-08.png)

### Abrir a tela de exportação de DF-es

No menu lateral, clique em **Exportação dados** e, em seguida, no botão **EXPORTAR DFES**.

![Administrador do Servidor de Notas com menu lateral mostrando as opções Dashboard, Recados, Configuração do Servidor, Controle de Acesso e Exportação dados (selecionado); no conteúdo central, seção DFes com os botões EXPORTAR DFES (destacado) e IMPORTAR DFES](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-09.png)

### Selecionar os documentos e exportar

O modal **Exportar DFes** exibe a lista de documentos disponíveis para exportação, com as colunas Data, Empresa, Tipo, Transação e Selecionar.

![Modal Exportar DFes com lista de quatro documentos do tipo NF_E (55), empresa 0001, transações 42 e 44, com checkboxes desmarcados e filtros de Data Inicial, Data Final, Tipo e Transação no painel lateral](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-10.png)

Marque os documentos desejados (ou use **Selecionar todos**) e clique em **EXPORTAR**.

![Modal Exportar DFes com todos os checkboxes marcados na coluna Selecionar e botão EXPORTAR destacado no rodapé](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-11.png)

O sistema gera automaticamente um arquivo `.zip` e realiza o download.

![Barra de downloads do navegador exibindo o arquivo DFes_2025-12-22 (1).ZIP recém-baixado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-12.png)

Este arquivo poderá ser utilizado para importar os documentos em outro servidor de notas.

## Importar DF-es no Administrador do Servidor de Notas

### Acessar o Administrador

Na tela inicial do Teorema Sistemas, clique em **Administrador**.

![Tela inicial do Teorema Sistemas no navegador (URL 10.0.2.15:8080/teoremaee/) com os botões Administrador (destacado), Auditor e XML-Center](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-13.png)

### Abrir a tela de importação de DF-es

No menu lateral, clique em **Exportação dados** e, em seguida, no botão **IMPORTAR DFES**.

![Administrador do Servidor de Notas com menu Exportação dados selecionado e botão IMPORTAR DFES destacado na seção DFes](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-14.png)

### Selecionar a empresa e importar o arquivo

No modal **Importar DFes**, selecione a empresa no campo **Empresa** e clique em **IMPORTAR ARQUIVO**.

![Modal Importar DFes com painel esquerdo exibindo seção Importar Arquivo, campo Empresa preenchido com 0001 e botão IMPORTAR ARQUIVO](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-15.png)

No diálogo de abertura de arquivo, localize e selecione o arquivo `.zip` gerado na exportação e clique em **Open**.

![Diálogo Open do Windows com o arquivo DFes_2025-12-22 (1) selecionado na pasta Downloads e botão Open destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-16.png)

### Visualizar os documentos importados

Após o carregamento, os documentos importados aparecem na lista à direita do modal, com as colunas Selecionar, ID, Data, Empresa, Modelo, Transação e Número.

![Lista de documentos importados com seis registros, colunas Selecionar, ID, Data, Empresa (0001), Modelo (55), Transação e Número](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-17.png)

> **Nota:** Os documentos importados ficam salvos apenas em memória. Se o servidor for finalizado, eles serão descartados e poderão ser importados novamente a qualquer momento.

### Selecionar o documento a testar

Na lista de documentos importados, marque o checkbox do documento que deseja testar.

![Modal Importar DFes com lista de seis documentos importados; checkbox do documento de ID 6 marcado; seção Enviar documento importado visível abaixo do botão IMPORTAR ARQUIVO](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-18.png)

### Definir situação, modo de emissão e enviar

No painel **Enviar documento importado**, selecione a **Situação** e o **Modo de emissão** desejados, ou utilize um dos atalhos disponíveis: **TRANSMITIR**, **IMPRIMIR**, **CANCELAR** ou **RESOLVER DUPLICIDADE**. Em seguida, clique em **ENVIAR DOCUMENTO IMPORTADO**.

![Painel Enviar documento importado com campos Situação e Modo de emissão (menus suspensos), botão ENVIAR DOCUMENTO IMPORTADO e seção Atalhos com botões TRANSMITIR, IMPRIMIR, CANCELAR e RESOLVER DUPLICIDADE](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-19.png)

Acompanhe o resultado na mensagem exibida pelo sistema.

![Modal Importar DFes com Situação definida como AUTORIZADA, Modo de emissão como REIMPRESSÃO, botão ENVIAR DOCUMENTO IMPORTADO destacado e mensagem de sucesso no topo: "Documento enviado com sucesso. Nova situação: A"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/importacao-exportacao-dfes/importacao-exportacao-dfes-20.png)

## Conclusão

A importação e exportação de DF-es oferece uma solução prática, segura e eficiente para o gerenciamento de documentos fiscais entre diferentes ambientes do Teorema Sistemas. O recurso permite reutilizar documentos já processados para testes controlados, validações técnicas e recuperação de informações, mantendo a integridade dos dados e sem impacto na base principal enquanto os documentos estiverem em memória.

## Informações do documento

> Autor: Mauricio Issami Antunes Fujimoto
> Setor: Qualidade
> Módulo:
> Chamado: 0000544960
> Versão do Sistema:
> Versão do documento: 01
> Revisão: Paulo Henrique Quintas Bley
> Aprovado em: Janeiro de 2026

---

> 📎 **Arquivos originais:** [MANUAL IMPORTAÇÃO E EXPORTAÇÃO DE DFES.docx](https://drive.google.com/uc?export=download&id=19qVtxPCPbk8yO5Fxp6XWQ6V45Cq3-EzB) · [MANUAL IMPORTAÇÃO E EXPORTAÇÃO DE DFES.pdf](https://drive.google.com/uc?export=download&id=15H84bo_uRkbiq2gCjxwz9yZHIUxM5sot)