# Systax DF-e Manual de Configuração APP -Robô DF-e
Manual de configuração do Robô DF-e - versão 5.0 - 12.03.25
# Introdução
Este documento tem como objetivo guiar na configuração do aplicativo ROBO\_DFE. O APP Systax DF-e automatiza o processo de upload e download de seus arquivos de documentos fiscais, estabelecendo uma conexão entre um diretório interno no servidor do cliente e o Systax DF-e.
# Conceitos
# Conceitos
Para realizar a configuração do APP Robô DF-e é necessário primeiramente entender alguns conceitos sobre os documentos fiscais e como estão dispostos no Systax DF-e.
**Documentos fiscais: **O Systax DFE contempla os documentos fiscais do tipo NF-e (Modelo 55), CT-e (Modelos 57 e 67), NFS-e e Outros Documentos (Boletos, Faturas, Notas de Débito e Crédito, Fretes e Declaração de Importação).** **
**Documentos recebidos: **Sua empresa na condição de Destinatário do Documento Fiscal Eletrônico. E de forma opcional para CT-e sua empresa na condição de Tomador.
**Documentos emitidos: **Sua empresa na condição de Emitente do Documento Fiscal Eletrônico.
**Documentos de terceiros: **Qualquer documento fiscal que não atenda as condições acima, embora o CNPJ da sua empresa esteja mencionado. Ex: CT-e onde sua empresa esteja na condição de Tomador ou Remetente. De modo opcional o cliente pode solicitar que os documentos em que são Tomadores, estejam em Documentos Recebidos.
**Nota Fiscal de Serviços ou Documentos: **Nota Fiscal de Serviço – NFS-e.
**Outros Documentos: **Outros tipos de documentos (Boletos, Faturas, Notas de Débito e Crédito, Fretes e Declaração de Importação).
**Arquivos para upload:**
Para o Systax DF-e - Enviar para o Systax DF-e arquivo XML de documentos fiscais que desejar, contemplando documentos emitidos, recebidos e terceiros.
Para o Systax DOCs – Enviar para o Systax DOCs arquivo XML de documentos fiscais de serviços que desejar, contemplando NFS-e ou Outros Documentos.
**Arquivos para download: **Envio dos arquivos presentes no Systax DF-e e Systax DOCs para um diretório específico no servidor do cliente.
# Requisitos
A solução Systax DF-e é homologada apenas em plataforma Windows Server.
Protocolo HTTP via SOAP.
# Possibilidades
# Possibilidades
Se o ERP do cliente já consome arquivos \*.xml de um determinado diretório, é possível indicar no Systax DF-e essa mesma pasta de Download. É possível selecionar quais arquivos deseja receber no servidor, entre documentos recebidos, emitidos e/ou terceiros ou Documentos (caso utilize para o Systax DOCs) no Item "Arquivos controle".
O aplicativo permite armazenar os \*.pdf´s de DANFE/DACTE juntamente aos \*.xml´s de forma automática. Veja como fazer no item "Gerar PDF de DANFE/DACTE".
# Recomendações
# Recomendações
Alguns passos são recomendados para iniciar a utilização do APP Robô DF-e:
1- Solicite a equipe de Tax Support da Systax através de abertura de chamado no GLPI um usuário exclusivo para configurar no aplicativo;
2- Defina quais tipos de arquivos deseja receber em seu diretório;
3- **Realize essa configuração sempre acompanhado do seu time de TI;**
4- Os arquivos que deverão ser editados são: “Controle” e “DFeRobo.exe”. Nestes arquivos o Robô irá encontrar os dados para acessar o WebService Systax DF-e e os caminhos para armazenar/enviar documentos fiscais em seu servidor. Sempre editar esse arquivo com o aplicativo Bloco de Notas. Caso não seja o modo padrão, salvar no mesmo formato e local já existentes.
# Configurando Aplicativo
Você deve ter recebido uma pasta compactada por e-mail que deverá ser extraída para o local onde será o armazenamento do servidor. Este local normalmente é definido pelo time de TI. Após a extração da pasta, é necessário editar os arquivos da forma que desejam configurar. É possível especificar pastas de upload e download de servidores distintos, uma vez que estejam na mesma rede.
***Observação:** Dê a preferência em editar os arquivos com o aplicativo Bloco de Notas. Após concluir a configuração, salvá-los com o mesmo nome, local e formato.*
**Importante!** Lembramos que neste manual, as informações preenchidas nos próximos passos são em caráter meramente ilustrativos. Os arquivos a serem editados estão na pasta do aplicativo, e deverão ser salvos em seguida conforme recomendações.
# Arquivo "controle.xml"
[](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/imagem1.png)
Neste arquivo você irá configurar quais informações você deseja realizar o Download do Systax DFE para seu servidor (Documentos Recebidos, Emitidos e/ou Terceiros, NFS-e ou Outros Documentos). Marque com “X” os campos ao qual (is) arquivo(s) deseja realizar o Download. Se não for do seu interesse realizar Download de algum tipo, deixe sem preenchimento.
**<DFeRobo>**
** <NSU>**
<!-- Numérico sem decimal --> Passe o NSU 0 para que ocorra o Download total
<recebidos>0</recebidos>
<emitidos>0</emitidos>
<terceiros>0</terceiros>
**</NSU>**
** <nsuEventos>**
<recebidos>0</recebidos>
<emitidos>0</emitidos>
<terceiros>0</terceiros>
**</nsuEventos>**
** <docs>**
<original>0</original>
<email>0</email>
<extraido>0</extraido>
<padrao>0</padrao>
**</docs>**
** <dataInicial>**
<!-- aaaa-mm-dd --> Preecha uma data para que o Download ocorra apenas a partir dela
<recebidos/>
<emitidos>2021-11-01</emitidos>
<terceiros/>
** </dataInicial>**
** <dataInicialDocs>**
<!-- aaaa-mm-dd --> Preecha uma data para que o Download ocorra apenas a partir dela
<original/>
<email/>
<extraido/>
<padrao/>
** </dataInicialDocs>**
** <tipoDocumento>**
<!-- Marcar com X a opção que deseja fazer o download -->
<recebidos>x</recebidos>
<emitidos>x</emitidos>
<terceiros/>
** </tipoDocumento>**
**<apenasTransportador>**
<!-- Caso esteja com X. Trará apenas XMLs onde você é o transportador -->
<recebidos/>
<emitidos/>
<terceiros/>
** </apenasTransportador>**
** <eventosTipoDocumento>**
<!-- Marcar com X a opção que deseja fazer o download -->
<recebidos/>
<emitidos/>
<terceiros/>
**</eventosTipoDocumento>**
** <apenasCancelamento>**
<!-- Marcar com X a opção que deseja fazer o download apenas dos eventos de cancelamento -->
<recebidos/>
<emitidos/>
<terceiros/>
** </apenasCancelamento>**
** <docsTipoDocumento>**
<!-- Marcar com X a opção que deseja fazer o download -->
<original/>
<email/>
<extraido/>
<padrao/>
** </docsTipoDocumento>**
**</DFeRobo>**
# Arquivo DFeRobo
Neste arquivo você irá configurar os dados de usuários, os locais onde serão armazenados os arquivos em seu servidor, o repositório dos \*.xml´s para enviar ao Systax DF-e e se o aplicativo irá realizar download de \*.pdf de DANFE/DACTE.
[](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/imagem2.png)
# Credenciais
Neste bloco, deverão ser informados os dados do usuário que irá acessar o portal Systax DFE. Recomendamos utilizar um usuário específico para o uso do Aplicativo, que deve ser solicitado a equipe de Tax Support.
<!-- CREDENCIAIS-->
<add key="Usuario" value="" />
<add key="Senha" value="" />
# Pastas para Upload
Neste bloco devemos indicar o caminho onde o aplicativo irá buscar os arquivos para enviar ao Systax DFE. Para agilizar sua operação, sugerimos especificar o mesmo caminho para todas opções de Upload, e quando for inserir os documentos para enviar ao Systax DFE, alimente sempre a mesma pasta, independente de qual tipo de documento. O sistema irá os direcionar para o local correto. Somentes as informações que estão em azul é que deverão ser alteradas.
<!--UPLOAD-->
<add key="UploadEmitidas" value="C:\\Users\\Local\_definido\_por\_TI\\UploadEmitidas" />
<add key="UploadRecebidas" value="C:\\Users\\Local\_definido\_por\_TI\\UploadRecebidas" />
<add key="UploadEmitidasProcessadas"value="C:\\Users\\Local\_definido\_por\_TI\\UploadEmitidasProcessadas"/>
<add key="UploadRecebidasProcessadas" value="C:\\Users\\Local\_definido\_por\_TI\\UploadRecebidasProcessadas" />
<add key="UploadDOCs" value=" C:\\Users\\Local\_definido\_por\_TI\\ DocsUpload" />
<add key="UploadProcessadasDOCs" value=" C:\\Users\\Local\_definido\_por\_TI\\ DocsUploadProcessadas" />
As pastas com os nomes 'Processadas', como UploadEmitidasProcessadas, UploadRecebidasProcessadas e UploadProcessadasDOCs, são destinadas à saída de arquivos que foram processados a partir das pastas correspondentes, sem a nomenclatura 'Processadas’.
# Pastas para Download
<!--DOWNLOAD-->
<add key="DownloadEmitidas" value="C:\\Users\\Local\_definido\_por\_TI\\DownloadEmitidas" />
<add key="DownloadRecebidas" value="C:\\Users\\Local\_definido\_por\_TI\\DownloadRecebidas" />
<add key="DownloadTerceiras" value="C:\\Users\\Local\_definido\_por\_TI\\DownloadTerceiras" />
<add key="DownloadDOCs" value="C:\\Users\\Local\_definido\_por\_TI\\Downloads" />
<!--ERROS-->
<add key="ArquivosInvalidos" value="C:\\Users\\Local\_definido\_por\_TI\\ArquivosInvalidos" />
<add key="ArquivosNaoProcessados" value="C:\\Users\\Local\_definido\_por\_TI\\ArquivosNaoProcessados"/>
<add key="ArquivosInvalidosDOCs" value="C:\\Users\\Local\_definido\_por\_TI\\DocsArquivosInvalidos" />
<add key="ArquivosNaoProcessadosDOCs" value="C:\\Users\\Local\_definido\_por\_TI\\DocsArquivosNaoProcessados" />
# Controle
Nesse bloco será especificado o local do arquivo que irá controlar o ROBO. É necessário especificar o caminho onde o aplicativo irá encontrar o arquivo “controle.xml”.
<!--CONTROLE-->
<add key= "Controle" value="C:\\Users\\Local\_onde\_arquivo\_controle\_esta\_salvo\\controle.xml" />
(Caminho para pasta onde o aplicativo está salvo apontando para o arquivo "controle.xml")
# Organização de Pastas
Nesse bloco o aplicativo permite algumas formas de organizar os arquivos no diretório, separando-os por CNPJ de emitente e CNPJ destinatário, conforme no exemplo abaixo:
0 ou NULO - Todos os XMLs na mesma pasta
1 - XMLs separados por CNPJ do Emitente
2 - XMLs separados por CNPJ do Emitente e Ano/Mês
3 - XMLs separados por CNPJ do Destinatário
4 - XMLs separados por CNPJ do Destinatário e Ano/Mês
Insira um dos códigos acima no campo destacado em azul abaixo entre aspas duplas:
<add key="OrganizacaoPastas" value="0" />
(Este campo é definido como 0, mas pode ser alterado conforme necessário)
# Gerar PDF - DANFE/DACTE
Nesse bloco é possível configurar o Robô para realizar o download dos PDF gerados pelo Systax DF-e, optando por gerar ou não esses arquivos juntamente com o download dos XML.
Parâmetros disponíveis:
0 - Para não gerar PDF
1 - Para gerar PDF
<add key="GerarDANFeDACTe" value="0" />
(Este campo é definido como 0, mas pode ser alterado conforme necessário)
# Configurar o Gerenciador de Tarefas do Windows
Após as configurações mencionadas, é necessário incluir o aplicativo nas tarefas agendadas do Windows. É uma etapa definida exclusivamente pelo time de TI já que impacta diretamente na capacidade dos servidores e necessidades de negócio.
# Rodar sem exibir a tela preta
[](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/imagem3.png)
# Rodar exibindo tela preta
[](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/imagem4.png)
[](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/imagem5.png)
[](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/imagem6.png)
[](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/imagem7.png)
[](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/imagem8.png)
# Configuração de Contingência
Trata-se de uma configuração de contingência para o caso de travamento do Robô. Embora essa situação seja rara, caso ocorra, o Robô DF-e será reiniciado automaticamente após 12 horas, garantindo a continuidade dos serviços e evitando interrupções.
[](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/imagem9.png)
# Executável
No link abaixo é possível realizar a baixa do arquivo executável do Systax Robô DF-e.
[https://systaxdfesp3.s3.sa-east-1.amazonaws.com/dfe/RoboDFe/RoboDFe.zip](https://systaxdfesp3.s3.sa-east-1.amazonaws.com/dfe/RoboDFe/RoboDFe.zip)