Manual Operacional - Cliente

@EDI Enterprise
Eletronic Data Interchange
Manual Operacional

1-24
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

É 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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

• 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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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

Necessário possuir o Java 64 bits, versão 1.6 ou acima)

Linux + Java, (Instalador com o Java embutido)

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

Necessário possuir o Java 64 bits, versão 1.6 ou acima)

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

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

Necessário possuir o Java 64 bits, versão 1.6 ou acima)

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

Instalação Concluída
Diretórios de Envio e
Recepção Criados.

17-24
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS
Manual Operacional - Cliente

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
Empresa Brasileira de Correios e Telégrafos
Email [email protected] - CS/DIEFI/DEARP/GESS