EDIE ManualOperacional Cli V11 Full 2020

Manual Operacional - Cliente
@EDI Enterprise
Eletronic Data Interchange
Manual Operacional
1-24
Empresa Brasileira de Correios e Telégrafos
Email edi@correios.com.br - CS/DIEFI/DEARP/GESS
Sumário
@EDI Enterprise .................................................................................................... 1
Sumário ................................................................................................................. 2
1- @EDI Enterprise .......................................................................................... 3
1.1 Objetivos ..................................................................................................................................... 3
1.2 Características Gerais................................................................................................................ 4
1.3 Ganhos com a Automação de transferência de arquivos. ...................................................... 5
2- EDI Web ....................................................................................................... 6

2.1 Requisitos ................................................................................................................................... 6
2.2 Acessando o Sistema ................................................................................................................ 6
................................................................................................................................................................. 6
2.3 Enviando Arquivos (Upload) ...................................................................................................... 7
2.4 Recebendo Arquivos (Download) .............................................................................................. 8
2.5 Relatório de Trafego .................................................................................................................. 9
3- @EDIE Agente ............................................................................................11

3.1 Requisitos ................................................................................................................................. 11
3.2 Acessando o Sistema .............................................................................................................. 11
3.3 Fazendo o Download do @EDIE Agente.................................................................................. 12
3.4 Instalando o @EDIE Agente no Windows ................................................................................ 13
3.5 Instalando o @EDIE Agente em Outros Sistemas Operacionais ........................................... 15
3.6 Enviando arquivos com o @EDIE Agente ................................................................................ 18
3.7 Recebendo arquivos com o @EDIE Agente ............................................................................ 19
3.8 Relatório de Trafego ................................................................................................................ 19
4- FTP .............................................................................................................22
5- FTPS...........................................................................................................24
2-24
1 - @EDI Enterprise
A ferramenta de EDI (Electronic Data Interchange) ou Intercâmbio Eletrônico de Dados adquirida
pelos Correios foi a solução @EDIEnterprise, que consiste em uma ferramenta que possibilita a gestão
de transferência de arquivos através da automação de fluxos, integração com sistemas corporativos,
gerenciamento e monitoração dos processos de transferência provendo autenticação, garantia de
entrega, rastreabilidade, integridade e confidencialidade dos intercâmbios de arquivos. É uma
ferramenta que possibilita trabalhar com diversos tipos de protocolos dentre eles podemos destacar:
FTP, FTPS, SFTP (modo cliente), HTTP, HTTPS, OFTP, OFTP2 ....
A solução @EDIEnterprise, desenvolvida pela empresa E-Sales, que tem como objetivo a troca
eletrônica de dados entre empresas, seus clientes, unidades e fornecedores. Utilizando-se de
recursos de segurança, garantia de integridade, controle de banda, múltiplos protocolos, mecanismos
de caixas postais eletrônicas e diversas outras funcionalidades específicas para troca de dados, como
padrões de layout de arquivo sob a forma de documentos (arquivos) eletrônicos, o @EDIEnterprise
proporciona às empresas uma maior agilidade na execução de seus negócios e interoperabilidade
com seus clientes.
1.1 Objetivos
• Prover um canal de comunicação com clientes e parceiros, mais eficiente, seguro, rastejável,
com garantia de recebimento e entrega das informações, independente do protocolo de
transmissão escolhido por eles.
• Possibilitar a integração do sistema dos clientes com os sistemas dos Correios.
• Automatizar a transferência de arquivos, reduzindo erros e intervenção manual.
• Disponibilizar uma interface única de gestão e consulta das informações, com as mesmas
visões para emissor e destinatário, tornando o processo transparente.
• Instruir o cliente a instalar e configurar o @EDIE Agente, enviar e receber arquivos por este
aplicativo ou pela web.
3-24
1.2 Características Gerais

• Compatível com qualquer Sistema Operacional que possua previamente instalado o Java
1.6.43.17 ou versão superior.
• Homologado para ser utilizado com os browsers Chrome e Firefox.
• Permite enviar e receber arquivos pela Web, de qualquer lugar.
• Usuário pode automatizar o envio e a recepção de arquivos com o @EDIE Agente.
• Usuário final pode emitir relatórios com o registro completo de todas as transmissões
realizadas.
• Todos arquivos são transmitidos criptografados com a possibilidade de configuração do

algoritmo de criptografia e chaves de segurança nas regras de comunicação criadas pelos
Correios.
• Além da criptografia dos arquivos, os canais de transmissão de arquivos são totalmente

seguros com a utilização de protocolos com certificado digital – HTTPS, FTPS, SFTP e client
com protocolo próprio.
• Todas as transmissões são validadas no destino visando garantir a integridade dos arquivos
que estão sendo recepcionados. Em caso de verificação de problemas na transmissão, a
aplicação reinicia o envio dos arquivos com falha.
• Reconexão automática e recuperação da transmissão a partir do ponto de parada.
• Geração e manutenção de backup de transmissões no repositório intermediário, por período

especificado.
• Todas as transmissões e acesso ao ambiente web ficam registrados em logs e bancos de

dados para auditoria.
4-24
1.3 Ganhos com a Automação de transferência de arquivos.

• Eliminação de processos repetitivos e de baixo valor agregado, liberando as pessoas para
trabalhos mais nobres.
• Eliminação de retrabalho.
• Diminuição de tempo na identificação e resolução de problemas, como indisponibilidade de

link, arquivos incompletos, corrompidos, não recebidos ou enviados, fora do número
sequencial esperado, etc.
• Pré-validação de arquivos.
• Melhor utilização dos recursos de rede e infraestrutura.
• Processos operacionais mais ágeis, criando vantagem competitiva.
• Redução de Custo Operacional.
5-24
2 - EDI Web
2.1 Requisitos
• Browser homologado para utilização do EDI Web. Atualmente Chrome e Firefox.
• Acesso à internet liberado, pelas portas (80 e 8080) utilizadas pelo protocolo HTTP e porta
3310 para uso do agente @EDIE.
• Usuário e Senha cadastrados com as permissões necessárias.
2.2 Acessando o Sistema
1. Acesso externo da ferramenta EDIE a partir do endereço:

https://ediac.correios.com.br/ediweb ou https://edisp.correios.com.br/ediweb (de acordo
com seu e-mail recebido).
6-24
2. Informe usuário, senha e clique em ‘Login’. Após acessar o sistema, a Barra de Menus
será apresentada, como na imagem abaixo, podendo ter variações de acordo com as
permissões do usuário.
Barra de Menus
2.3 Enviando Arquivos (Upload)
1. Clique em Operações > Enviar > Enviar via Browser.
2 3
7-24
2. Na aba ‘Envio simples’, clique em ‘Escolher arquivos’ e selecione o/s arquivo/s que deseja
transmitir.
3. Caso utilize mais de um Serviço, selecione aquele para o qual o arquivo deve ser
transmitido.
4. Clique em “Enviar Arquivos”. A mensagem “Sucesso: Operação realizada com sucesso!”
deve aparecer na parte superior, esquerda, da tela.
5. Na aba ‘Envio múltiplo’ selecione ou arraste vários arquivos de uma vez. Estes serão
enviados imediatamente sem outra ação a ser tomada.
6. Se o arquivo ainda está sendo carregado no browser, pode clicar em ‘Cancelar envio’
para removê-lo da lista. A mensagem de “Operação realizada com sucesso!” deve
aparecer abaixo de cada arquivo enviado.
2.4 Recebendo Arquivos (Download)
1. Clique em Operações > Receber > Receber via browser. Se não tiver arquivos para ser
recebidos, a mensagem: “Sem Arquivos para Download”, aparecerá. Caso tenha, eles
serão listados como na imagem a seguir.
2 3
4 5
8-24
É possível visualizar informações de quem disponibilizou o arquivo, como Serviço, Empresa,

Remetente, Nome do Arquivo, Data e Hora.
2. Marque os arquivos que deseja fazer o download.

3. Depois de selecionados, clique em “Baixar todos”. O seu browser vai salvar um arquivo
compactado no formato zip. Seu nome é download.zip, descompacte-o no diretório de
sua preferência para acessar os arquivos.
4. Se o download for realizado por meio do botão “Baixar”, será baixado um por vez.
5. Para remover arquivos já recebidos, clique em “Remover”, mas cuidado, não é possível
desfazer a remoção.
2.5 Relatório de Trafego
1. Para acessar o relatório que mostra os arquivos que foram Enviados e Recebidos, clique
em Relatórios > Tráfego > Tráfego Analítico.
O relatório apresenta:
• IP > Endereço IP do emissor do arquivo;
• Nome do arquivo > no momento do Envio;
• Nome destino > do arquivo no momento da Recepção;
• Status > da transmissão;
• Tamanho > do arquivo, em bytes;
• Data da transmissão > e hora do E/R;
• Porta > de comunicação utilizada na transferência.
• Protocolo > utilizado na transmissão;
• Usuário > que fez o E/R;
9-24
• CRC > que o sistema gera, para verificar a integridade e rastreabilidade do arquivo;
• Ações > detalhes do arquivo E/R.
2. Utilize os filtros disponíveis para refinar a pesquisa, buscando pelo Status, Sentido e
Protocolo ou clique em “Adicionar Filtro” para filtrar pelo Nome do arquivo, a Data de
transmissão, o Usuário, o IP, o CRC, etc. Depois de adicionados, clique em “Consultar”.
3. Os relatórios podem ser exportados para posterior análise. Basta selecionar o formato
desejado. Os formatos suportados são: CSV, Excel, XML e PDF.
10-24
3 - @EDIE Agente
Para automatizar o Envio e a Recepção de arquivos, tornando o processo mais ágil e
confiável, é possível utilizar o @EDIE Agente, que deve ser pré-configurado pelo
Administrador do Sistema.
3.1 Requisitos
• Browser homologado para utilização do @EDIEnterprise Web, atualmente “Chrome” e
“Firefox”.
• Acesso à internet liberado, pelas portas utilizadas pelo protocolo HTTP, que geralmente são
as portas 80 e 8080, HTTPS porta 443 e a Porta 3310 utilizada pelo Servidor que receberá
os arquivos
• Java instalado e configurado, Versão 1.6.0, ou superior.
• Usuário e Senha cadastrados pelo Administrador com as permissões necessárias.
3.2 Acessando o Sistema

• Pelo IP ou DNS fornecido pelo Administrador mais porta HTTP (geralmente 8080) mais
..\Ediweb. Exemplo: HTTP://ediac.correios.com.br:8080\Ediweb. Digite o nome de usuário
fornecido pelo Administrador e a senha.
11-24
3.3 Fazendo o Download do @EDIE Agente
1 Barra de Menus
1. Clique em Operações > Softwares > Download @EDIE Agente
Uma janela surgirá na tela, como a da imagem a seguir, onde é possível cadastrar
informações de IP do Proxy e Porta, ademais de verificar a versão do Java instalado. *Alguns
navegadores não oferecem suporte á verificação do Java instalado.
2. Verifique se a versão do Java* é adequada.
3. Se tiver mais de um Serviço com a empresa parceira, selecione aquele para o qual deseja
utilizar a Caixa Postal.
12-24
4. Caso utilize Proxy, informe seu Endereço e a Porta.
5. Selecione o Sistema Operacional entre:
Windows 64 bits + Java, (Instalador com o Java embutido)
Windows 64 bits, (Selecione esta opção se você já possui o Java instalado

Necessário possuir o Java 64 bits, versão 1.6 ou acima)
Windows 32 bits + Java, (Instalador com o Java embutido)
Windows 32 bits, (Selecione esta opção se você já possui o Java instalado

Linux + Java, (Instalador com o Java embutido)
Linux, (Selecione esta opção se você já possui o Java instalado

Mac OS X + Java, (Instalador com o Java embutido)
Mac OS X, (Selecione esta opção se você já possui o Java instalado

Pacote com os arquivos compactados no formato zip
6. Clique em Download e um arquivo “agente.zip” será baixado. Após o download, o

instalador estará disponível no diretório configurado no browser.
7. Clique em Fechar.
3.4 Instalando o @EDIE Agente no Windows

Navegue pelo Windows Explorer até o diretório onde o arquivo “agente.zip” foi baixado.
Descompacte-o. Dois arquivos serão disponibilizados, o instalador “agente_x64.exe” e o “host”.
1. Dê um duplo clique no *.exe para dar início à instalação.
13-24
Instalador
2. Após o duplo clique, a tela inicial surgirá, clique em “Next”.

3. Na tela seguinte, você poderá alterar o diretório de instalação, clicando em “Choose”.
Sugerimos manter o diretório padrão para facilitar um eventual suporte. Clique em “Next”.
4. Verifique os dados da Instalação e clique em “Next”.
5. A continuação ocorrerá o processo de instalação.
3 4
14-24
5 6
6. Ao finalizar, a tela de instalação do Serviço irá aparecer. Faça o renomeio do sua

preferência ou clique em “Ok” para finalizar o processo.
7. A próxima tela informa que a instalação ocorreu com sucesso. Clique em “Done”.
8. O @EDIE Agente fica com o status “Iniciado” e o tipo de inicialização “Automático” para
ficar sempre operacional em caso de reinicialização da máquina hospedeira.
3.5 Instalando o @EDIE Agente em Outros Sistemas Operacionais

Navegue até o diretório onde o instalador foi baixado. Copie-o ao local desejado para a
instalação. Neste exemplo usaremos o diretório C:\@EDIE Agente\ e o Client cxa_1000003.zip,
que irá variar de acordo com o usuário.
15-24
1. Descompacte o instalador. Todos os outros arquivos da imagem acima estão contidos no

pacote.
2. Como há diferença entre os Clients, a forma de automatizar a inicialização do @EDIE
Agente varia. Neste caso pelo Prompt de Comando se posicione no diretório do Client, e
execute o arquivo “Service.bat”. O sistema perguntará pela ação a ser executada, neste
caso digitaremos o 1 > Instalar o Serviço, após digitaremos o Nome do Serviço.
3. Aqui, é o ediclientews.jar. É importante lembrar que o usuário que vai executar o client
tenha permissão de gravar e deletar arquivos, criar subdiretórios, compactar arquivos,
etc. Recomenda-se a execução com o perfil de administrador. Em uma instalação Linux
a execução deve ser efetuada como root utilizando-se o comando sudo java -jar
ediclientws.jar.
4. Quando o arquivo ediclientews.jar for executado pela primeira vez, ele concluirá
automaticamente a instalação e criará diretórios para Envio e Recepção de arquivos, que
podem sofrer alteração em seus nomes e na quantidade de diretórios, pois são
configurações baseadas nas regras criadas pelo Administrador do Sistema. Veja na
imagem abaixo como ficou o diretório da imagem anterior. A instalação está concluída.
Lembre-se apenas de deixar automatizada a inicialização do ediclientes.jar.
16-24
Instalação Concluída
Diretórios de Envio e
Recepção Criados.
17-24
3.6 Enviando arquivos com o @EDIE Agente
1. Coloque os arquivos que deseja enviar na pasta de Envio, que será um subdiretório do
diretório de instalação do @EDIE Agente. Em nosso exemplo, o nome da pasta é Envia,
C:\@EDIE Agente\Envia\. O nome do diretório de envio pode ser diferente, pois depende
da Regra criada pelo Administrador do Sistema. Mas geralmente, são nomes intuitivos.
2. Caso não tenha instalado o sistema como serviço, é necessário executar o arquivo
ediclienws.jar para fazer a transmissão, mas caso já o tenha feito, a transmissão é
automática.
3. Após o Envio, o diretório deverá ficar vazio. Os arquivos transmitidos, ou foram excluídos
após a transmissão, ou foram movidos para um diretório de backup, dependendo da
configuração realizada pelo Administrador do Sistema. É possível verificar pela Web
quais arquivos foram transmitidos, falaremos a respeito no último tópico deste capitulo.
18-24
3.7 Recebendo arquivos com o @EDIE Agente
1. Caso não tenha instalado o sistema como serviço, é necessário executar o arquivo
ediclienws.jar para fazer a recepção de arquivos, mas caso já o tenha feito, a transmissão
é automática e eles já devem estar disponíveis.
2. Os arquivos recebidos vão para o diretório de Recepção, que neste exemplo tem o nome
Recebe, C:\@EDIE Agente\Recebe\, mas pode sofrer alterações, conforme configuração
realizada pelo Administrador do Sistema. Geralmente, são nomes intuitivos.
3.8 Relatório de Trafego

Com o mesmo usuário e senha que utilizou para realizar o download do @EDIE Agente, é
possível visualizar os arquivos que foram enviados e recebidos. Faça login no sistema e siga os
passos:
19-24
1. Para acessar o relatório clique em Relatório > @EDIE Agente > Tráfego Agentes
Analítico.
O relatório apresenta:
• Endereço IP que enviou o arquivo;
• Nome do arquivo no momento do Envio;
• Nome do arquivo no momento da Recepção;
• Status da transmissão;
• Tamanho do arquivo, em bytes;
• Data e hora em que a transmissão foi iniciada;
• Data e hora em que a transmissão foi concluída;
• Protocolo utilizado na transmissão;
• Usuário que fez o envio;
• Usuário que recebeu o arquivo;
• CRC que o sistema gera, para verificar a integridade e poder rastrear o arquivo.
20-24
2. Utilize os filtros disponíveis para refinar a pesquisa, buscando pelo nome do arquivo, data
de transmissão e status. Depois de selecionados, clique em Filtrar.
3. Em Ações, é possível ver detalhes, como os diretórios de Envio e Recepção.
4. Os relatórios podem ser exportados para posterior análise, basta selecionar o formato
desejado. Os formatos suportados são: CSV, Excel, XML e PDF.
21-24
4 - FTP
É possível efetuar a comunicação de arquivos com o sistema dos Correios diretamente
via FTP. Para isso utilize uma ferramenta cliente de FTP direcionando o servidor para o
seguinte endereço:
ediac.correios.com.br ou edisp.correios.com.br (de acordo com seu e-mail recebido)
Portas padrão 21 e Range (55000 a 65535) modo implícito.
Efetue login com o seu usuário e senha repassado pelos Correios.
Após a autenticação no servidor de FTP, seu usuário terá acesso aos diretórios de seus
sistemas contratados, para envio e recepção de arquivos.
Clientes de FTP homologados pelos Correios para utilização: Filezilla, FireFTP e MS-
DOS.
Importante: o servidor FTP dos Correios não é um repositório de arquivos. Sendo assim,
após o envio (PUT) de um arquivo em seu diretório de sistema contratado, não será possível
visualizá-lo na referida pasta (DIR). Todos os arquivos enviados aos Correios são
imediatamente redirecionados à área de sistema respectiva e removidos por questões de
segurança do servidor de FTP. Para consultar o resultado de um tráfego de arquivos, emita
um relatório web conforme descrito no item 3.5 deste documento.
Se houver envio de arquivos por parte dos Correios, estes poderão ser acessados nos
diretórios de retorno. E ficarão à disposição pelo prazo contratual, ou até que você os delete.
Observação: Para o envio e a recepção de arquivos é necessário que o usuário ou o

sistema que estão utilizando o protocolo FTP façam o posicionamento nas pastas disponíveis.
22-24
Exemplo de conexão com o servidor FTP dos Correios via programação em linguagem
Java:
Arquivo Java completo com um exemplo de conexão e transferências de arquivos.
Obs: a url de acesso pode ser alterada para edisp.correios.com.br de acordo com seu e-
mail de instruções recebidas.
Obs2: A exigência de comunicação pode ser feita pela porta 990 para conexões seguras.
TesteECT.java
23-24
5 - FTPS
Também e possível efetuar a comunicação de arquivos com os Correios diretamente via
FTPS. Para isso utilize uma ferramenta cliente de FTPS direcionando o servidor para o
seguinte endereço:
ediac.correios.com.br ou edisp.correios.com.br (de acordo com seu e-mail recebido)
Portas padrão 990 e Range (55000 a 65535) modo implícito.
Efetue login com o seu usuário e senha repassado pelos Correios.
Após a autenticação no servidor de FTPS, seu usuário terá acesso aos diretórios de seus
sistemas contratados, para envio e recepção de arquivos.
As ferramentas clientes de FTPS homologados pelos Correios são: Filezilla, FireFTP.
Se houver envio de arquivos por parte dos Correios, estes poderão ser acessados nos
diretórios de retorno. E ficarão à disposição pelo prazo contratual, ou até que você os delete.
Observação: Para o envio e a recepção de arquivos é necessário que o usuário ou o

sistema que estão utilizando o protocolo FTPS façam o posicionamento nas pastas
disponíveis após estabelecida a conexão.
24-24

EDIE ManualOperacional Cli V11 Full 2020

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

EDIE ManualOperacional Cli V11 Full 2020

Enviado por

Direitos autorais:

Formatos disponíveis

Manual Operacional - Cliente

2- EDI Web ....................................................................................................... 6

3- @EDIE Agente ............................................................................................11

• Possibilitar a integração do sistema dos clientes com os sistemas dos Correios.

• Automatizar a transferência de arquivos, reduzindo erros e intervenção manual.

1.2 Características Gerais

• Homologado para ser utilizado com os browsers Chrome e Firefox.

• Permite enviar e receber arquivos pela Web, de qualquer lugar.

• Usuário pode automatizar o envio e a recepção de arquivos com o @EDIE Agente.

• Todos arquivos são transmitidos criptografados com a possibilidade de configuração do

• Além da criptografia dos arquivos, os canais de transmissão de arquivos são totalmente

• Reconexão automática e recuperação da transmissão a partir do ponto de parada.

• Geração e manutenção de backup de transmissões no repositório intermediário, por período

• Todas as transmissões e acesso ao ambiente web ficam registrados em logs e bancos de

1.3 Ganhos com a Automação de transferência de arquivos.

• Diminuição de tempo na identificação e resolução de problemas, como indisponibilidade de

• Melhor utilização dos recursos de rede e infraestrutura.

• Processos operacionais mais ágeis, criando vantagem competitiva.

• Redução de Custo Operacional.

• Usuário e Senha cadastrados com as permissões necessárias.

2.2 Acessando o Sistema

1. Acesso externo da ferramenta EDIE a partir do endereço:

2.3 Enviando Arquivos (Upload)

1. Clique em Operações > Enviar > Enviar via Browser.

2.4 Recebendo Arquivos (Download)

É possível visualizar informações de quem disponibilizou o arquivo, como Serviço, Empresa,

2. Marque os arquivos que deseja fazer o download.

2.5 Relatório de Trafego

• IP > Endereço IP do emissor do arquivo;

• Nome do arquivo > no momento do Envio;

• Nome destino > do arquivo no momento da Recepção;

• Status > da transmissão;

• Tamanho > do arquivo, em bytes;

• Data da transmissão > e hora do E/R;

• Porta > de comunicação utilizada na transferência.

• Protocolo > utilizado na transmissão;

• Usuário > que fez o E/R;

• Ações > detalhes do arquivo E/R.

• Java instalado e configurado, Versão 1.6.0, ou superior.

• Usuário e Senha cadastrados pelo Administrador com as permissões necessárias.

3.2 Acessando o Sistema

3.3 Fazendo o Download do @EDIE Agente

1. Clique em Operações > Softwares > Download @EDIE Agente

2. Verifique se a versão do Java* é adequada.

4. Caso utilize Proxy, informe seu Endereço e a Porta.

5. Selecione o Sistema Operacional entre:

Windows 64 bits + Java, (Instalador com o Java embutido)

Windows 64 bits, (Selecione esta opção se você já possui o Java instalado

Windows 32 bits + Java, (Instalador com o Java embutido)

Windows 32 bits, (Selecione esta opção se você já possui o Java instalado

Linux + Java, (Instalador com o Java embutido)

Linux, (Selecione esta opção se você já possui o Java instalado

Mac OS X + Java, (Instalador com o Java embutido)

Mac OS X, (Selecione esta opção se você já possui o Java instalado

Pacote com os arquivos compactados no formato zip

6. Clique em Download e um arquivo “agente.zip” será baixado. Após o download, o

3.4 Instalando o @EDIE Agente no Windows

1. Dê um duplo clique no *.exe para dar início à instalação.

2. Após o duplo clique, a tela inicial surgirá, clique em “Next”.

6. Ao finalizar, a tela de instalação do Serviço irá aparecer. Faça o renomeio do sua

3.5 Instalando o @EDIE Agente em Outros Sistemas Operacionais

1. Descompacte o instalador. Todos os outros arquivos da imagem acima estão contidos no

3.6 Enviando arquivos com o @EDIE Agente

3.7 Recebendo arquivos com o @EDIE Agente