EDI - Electronic Data Interchange (Intercâmbio eletrônico de dados) da pessoa
O EDI (Electronic Data Interchange) é o processo responsável pelo intercâmbio eletrônico de arquivos entre o sistema da Zetti Tech e os fornecedores, viabilizando o processo de compra automatizado por meio do Robô de Compras. É uma tecnologia que faz a integração de dados entre empresas, e seu objetivo é facilitar e agilizar a troca de informações. Por meio dessa integração, é possível realizar a troca de arquivos de remessa de pedidos de compra e retorno das confirmações, garantindo agilidade, padronização e redução de falhas manuais no processo de compras. Este artigo tem como objetivo orientar sobre a configuração correta do cadastro EDI da pessoa, requisito indispensável para o funcionamento adequado dessa operação.
Na tela de cadastro, o usuário pode criar uma EDI do zero, configurando todos os parâmetros manualmente. Também é possível aplicar parâmetros de outro fornecedor como base, desconsiderando informações mais específicas, como senha, por exemplo. Além disso, caso já exista uma EDI cadastrada para a pessoa, será possível clonar os dados do cadastro existente para utilizar os dados completos no novo registro, e se necessário, também é possível excluir um cadastro existente. Por fim, a tela também permite cadastrar os motivos de retorno da integração, que serão utilizados para identificar e tratar as respostas recebidas durante o processo de comunicação EDI. Continue a leitura e confira todas as funcionalidades disponíveis na tela.
Antes de prosseguir com as orientações técnicas, é importante esclarecer que o sistema suporta comunicação EDI por meio dos protocolos FTP e SFTP, sendo que a disponibilização e a configuração do servidor são de responsabilidade do fornecedor. Alguns fornecedores utilizam FTP convencional, enquanto outros operam por SFTP, conforme sua política interna de segurança e infraestrutura de rede. A partir dessa definição, devem ser observadas as orientações abaixo para garantir a correta comunicação entre os sistemas:
Caso o fornecedor possua algum tipo de bloqueio de acesso ao diretório FTP, ele deverá ser orientado a realizar a liberação do IP do servidor onde o Robô de Compras é executado, correspondente ao endereço 177.70.2.90. Essa liberação é indispensável para permitir a comunicação entre os sistemas.
Ressalta-se também que, sem a configuração correta do cadastro EDI da pessoa, não será possível realizar a troca de arquivos de remessa e retorno dos pedidos de compra entre o fornecedor e a filial, inviabilizando o processo de compra automatizado.
Além disso, é importante considerar que essa operação requer conhecimento técnico para ser executada com êxito, especialmente no que diz respeito às configurações de rede, FTP e validações de comunicação. Caso surjam dúvidas ou dificuldades durante o processo, recomenda-se fortemente entrar em contato com a equipe de Suporte da Zetti Tech.
Por fim, para garantir o funcionamento correto do Robô de Compras, é obrigatório que o fornecedor realize também a liberação dos IPs 177.105.248.164 e 177.107.38.134, assegurando a estabilidade e a continuidade da troca de arquivos EDI.
SFTP (Secure File Transfer Protocol) e o FTP (File Transfer Protocol) são protocolos de transferência de arquivos que utilizam criptografia para proteger os dados durante a comunicação, garantindo que as informações sejam transmitidas de forma segura e descriptografadas apenas no destino. O SFTP utiliza uma camada de segurança baseada no protocolo SSH, padronizada pela Internet Engineering Task Force (IETF). Já o FTPS adiciona segurança ao FTP tradicional por meio dos protocolos SSL/TLS, protegendo a conexão contra interceptações e acessos não autorizados.
Pré-requisitos
- Cadastro do fornecedor: Para efetuar a integração do fornecedor com o processo automatizado de compras, é imprescindível que o fornecedor esteja corretamente cadastrado na solução Vetor Farma e se encontre com status ativo, garantindo que possa participar do fluxo de compras.
- Lista de motivos de retorno: Para cadastrar os motivos de retorno, é necessário possuir previamente a lista de códigos e descrições disponibilizada pelo fornecedor/distribuidor.
- Configuração do parâmetro HAB_RESSUPRIMENTO: Para assegurar o funcionamento adequado da funcionalidade, é essencial realizar previamente a configuração do parâmetro por empresa: "HAB_RESSUPRIMENTO". Esse parâmetro habilita o uso do processo automatizado de compras e deve ser ativo antes de qualquer tentativa de integração do fornecedor. Caso haja dúvidas sobre como habilitar um parâmetro por empresa, clique aqui para acessar a documentação com o passo a passo detalhado.
- Configuração de compras e roteiro: Para que este recurso funcione corretamente, é necessário configurar o parâmetro de compras e criar um roteiro de compras. Clique sobre o passo que deseja aprender para ser redirecionado:
Como acessar
- Abra o módulo Vetor Farma.
- Acesse o menu: Cadastros >> Compras >> Configuração do robô de compras (EDI) >> EDI da pessoa.
1º Passo – Cadastrar EDI da pessoa
Configurações iniciais
A tela de cadastro apresenta, no cabeçalho, campos para seleção e/ou digitação das informações necessárias para o registro. Além disso, possui duas abas: a primeira permite informar os parâmetros de integração, enquanto a segunda permite cadastrar os motivos de retorno dos pedidos eletrônicos. Veja a seguir todos os detalhes.
Para iniciar o cadastro, identifique a pessoa, isto é, o fornecedor que será integrado ao processo automatizado de compras. Para isso, informe o seu "Código" de cadastro, ou clique no botão de pesquisa "
" para localizar o cadastro adequado. Ao informar o fornecedor, os campos "Razão social da pessoa" e "Nome fantasia" serão carregados com as informações adequadas conforme o cadastro.
Clique aqui para acessar a documentação correspondente à tela de pesquisa, caso precise de orientações para utilizá-la.
No campo "Cód. EDI", será exibido inicialmente o número 00, pois este campo é destinado ao registro do código da EDI cadastrada. O sistema gerará automaticamente um código único para o novo cadastro assim que ele for salvo. Portanto, no campo "Descrição EDI", informe um nome que identifique claramente a integração que está sendo cadastrada. Em seguida, utilize o campo "Situação" para definir o status da integração, escolhendo entre as opções "Ativo" ou "Inativo".
A seguir, na aba “Comunicação”, à esquerda da tela, há uma seção com a lista de "Parâmetros" de integração, e ao lado, os campos para informar o "Valor" correspondente.
Para preencher corretamente os campos, leia as instruções a seguir. E caso deseje aplicar automaticamente os parâmetros de outro fornecedor como base no seu cadastro, continue a leitura. Porém, para realizar o preenchimento manual completo, clique aqui após ler as informações abaixo.
Instruções importantes para configuração de envio via FTP:
- Antes de iniciar, é essencial verificar as informações específicas junto a cada fornecedor. No caso da opção FTP, os seguintes campos são obrigatórios:
Endereço FTP (com porta);
Usuário do FTP;
Senha do FTP;
Diretório de Envio;
Diretório de Retorno (localizado no servidor FTP);
Nome do Arquivo de Envio;
Nome do Arquivo de Retorno.
- Configuração de diretórios: Certifique-se de que os campos "Diretório de Envio", "Retorno" e "Falta" estejam preenchidos corretamente, de acordo com o local de armazenamento no computador ou servidor.
- Máscaras para arquivos: É necessário aplicar uma máscara aos arquivos de "Envio", "Retorno" e "Falta". Essa máscara funciona como um parâmetro para organizar os registros. O usuário pode escolher entre os seguintes formatos:
[YYYYMMDDHHMMSS]-data e hora completas[RANDOM_TIME_SECUND]-valor aleatório em segundos- Exemplos de nomes de arquivo com máscara:
- Arquivo de Envio:
ENVIO[YYYYMMDDHHMMSS].PED - Arquivo de Retorno:
RETORNO[YYYYMMDDHHMMSS].PED - Arquivo de Falta:
FALTA[YYYYMMDDHHMMSS].PED
- Arquivo de Envio:
- Exemplos de nomes de arquivo com máscara:
- Layout: No campo "Layout", selecione o tipo de layout aceito por cada fornecedor. Essa escolha determina o formato dos arquivos e como será realizada a troca entre as partes.
Aplicar parâmetros de outro fornecedor
Após preencher as configurações iniciais e ler as orientações acima, o usuário pode, conforme interesse, clicar no botão >> Sugestão de cadastro, que abrirá a tela de “Consulta de listas de EDI”. Nessa tela, é possível localizar e selecionar um fornecedor; os parâmetros aplicados a ele servirão como base para o novo cadastro. Dessa forma, ao selecionar o registro, os dados básicos são preenchidos automaticamente, oferecendo orientação para a configuração do novo cadastro. Apenas informações mais específicas como usuário e senha, por exemplo, não são transferidos.
Clique aqui para acessar a documentação completa sobre a tela de pesquisa.
Como nem todos os parâmetros são transferidos, o usuário precisará completar manualmente os campos restantes. Veja a seguir como fazer isso.
Aplicar parâmetros manualmente
Dependendo do tipo de integração, clique na linha correspondente da coluna "Valor", acione o botão exibido "
" para selecionar a opção ou preencha os campos manualmente. Esses parâmetros são essenciais para o correto envio e recebimento dos pedidos eletrônicos.
A seção à direita da tela é dividida em duas partes. Na parte superior, há um espaço destinado à apresentação das EDIs cadastradas para a pessoa/fornecedor. Caso já exista uma EDI cadastrada, ela será exibida nessa lista. Também está disponível o botão >> Novo EDI, os detalhes sobre essas informações serão apresentados no próximo passo. Por fim, na parte inferior da seção à direita, há um campo disponível para que o usuário registre anotações relevantes sobre a configuração, se desejar.
Após concluir a configuração dos parâmetros, é possível dar continuidade ao cadastro incluindo os motivos de retorno da integração, utilizados para identificar e tratar as respostas recebidas durante o processo de comunicação EDI. Para prosseguir com a configuração, clique na aba “Motivos de retorno” e continue a leitura do documento. Por outro lado, caso prefira salvar o cadastro, tecle o atalho >> F2 e confirme a mensagem exibida. Depois, quando desejar, basta localizar o cadastro como demonstrado no segundo passo, acessar essa aba, e preencher os campos como demonstrado a seguir.
Cadastrar motivos de retorno
Os motivos de retorno, quando cadastrados nesta aba, indicam as situações que podem ser retornadas na linha dos produtos durante o processamento do pedido eletrônico e têm como finalidade informar os usuários, especialmente o departamento de compras, sobre o status do pedido. Eles permitem identificar, por exemplo, pedidos não atendidos por não atingimento do pedido mínimo, indisponibilidade de produto, ausência de identificação do item no fornecedor, entre outras situações que indicam o atendimento ou não do pedido.
Como mencionado nos pré-requisitos, os motivos de retorno são definidos pelos fornecedores/distribuidores. Por esse motivo, o usuário deve solicitar a cada fornecedor a lista de códigos e descrições correspondentes antes de realizar o cadastro. Além disso, os motivos de retorno cadastrado para os fornecedores, podem ser visualizados nos relatórios de auditoria de envio/retorno do pedido eletrônico, de acordo com o código retornado no arquivo. Clique aqui para acessar a documentação desse relatório.
Esta aba apresenta uma seção, na qual o usuário pode informar o "Código" e a "Descrição do motivo" de retorno a ser cadastrado. Para incluir os registros, digite as informações e tecle >> Enter para avançar entre os campos e adicionar novas linhas, até concluir o cadastro dos motivos desejados.
Para remover um registro inserido incorretamente, clique na linha correspondente na primeira coluna. Assim, ela ficará destacada de azul, indicando que está selecionada. Em seguida, pressione a tecla >> Delete para remover o item da lista.
Após adicionar todas as configurações desejadas, tecle o atalho >>F2 e confirme a mensagem seguinte.
Assim, a tela será limpa para um novo cadastro. Confira no segundo passo como consultar, validar, clonar, inserir e excluir EDI da pessoa.
Realizadas as configurações e criado o roteiro, o próximo passo será realizar a ativação da compra automática, onde o Robô (Processo de envio automático) enviará ao fornecedor o pedido de compra da demanda de abastecimento. Clique aqui para acessar a documentação "Ativação de compra (Robô)".
2º Passo – Gerenciar cadastro
O usuário pode, sempre que necessário, consultar os cadastros realizados para visualizar, alterar parâmetros configurados, realizar a validação dos dados, inserir novos EDIs, clonar os dados de um cadastro existente ao criar um novo e até mesmo excluir um registro. Veja a seguir.
Consultar EDI da pessoa
O primeiro passo da consulta é localizar o fornecedor, como demonstrado no primeiro passo. Portanto, informe o "Código" de cadastro ou clique no botão de pesquisa "" para encontrar o registro desejado. Ao selecionar o fornecedor, os campos "Razão social da pessoa" e "Nome fantasia" localizados no cabeçalho serão preenchidos automaticamente com as informações do cadastro e na seção à direita será revelada a lista de integrações, isto é, "EDI cadastrados da pessoa", se houver.
Clique aqui para acessar a documentação correspondente à tela de pesquisa, caso precise de orientações para utilizá-la.
Para detalhar um EDI cadastrado, clique duas vezes sobre o registro desejado. Ao fazer isso, as informações de cadastro serão detalhadas na tela, e os botões >> Valida EDI e >> Clonar EDI serão revelados.
O botão >> Novo EDI, está sempre disponível na tela e pode ser usado quando o usuário detalha um EDI cadastrado e, após análise, decide não editar nem clonar, mas iniciar um cadastro manual. Ao clicar nesse botão, todas as informações das abas “Comunicação” e “Motivos de retorno” serão limpas, permitindo inserir os dados de um novo cadastro do zero. Confira mais detalhes no tópico "Clonar e/ou Inserir novo EDI da pessoa".
Validar EDI
O botão >> Validar EDI, pode ser acionado sempre que uma EDI for detalhada, ele aciona um serviço externo hospedado no servidor da Zetti Tech. Para que o teste funcione corretamente, é essencial que todas as informações estejam corretas e gravadas no banco de dados, pois o serviço acessa essas configurações para realizar a verificação. Ao clicar no botão, o serviço externo é acionado e realiza um teste de comunicação, garantindo que as configurações estejam corretas e funcionando conforme esperado. Se as informações estiverem corretas, uma mensagem de sucesso será revelada, veja um exemplo:
Por outro lado, caso haja alguma divergência, um alerta será exibido detalhando a inconsistência. O usuário poderá então realizar as correções necessárias na configuração dos parâmetros, conforme orientado no primeiro passo. Veja um exemplo:
Veja a seguir, como clonar e/ou inserir novo EDI
Clonar e/ou Inserir novo EDI da pessoa
Após consultar o fornecedor, caso o usuário já tenha detalhado um EDI e deseje criar um novo cadastro do zero, é necessário clicar no botão >> Novo EDI. Ao acionar esse botão, os dados já configurados nas abas “Comunicação” e “Motivos de retorno” serão removidos, permitindo a inserção de novos dados manualmente. Neste cenário, basta o usuário seguir as orientações do primeiro passo. Ao salvar o cadastro e realizar uma nova pesquisa, o novo EDI será listado na tela.
Por outro lado, com os detalhes do EDI na tela, ao clicar no botão >> Clonar EDI, ele será substituído por uma mensagem em vermelho: "Clonando EDI". Essa ação permite copiar todos os dados de cadastro para a criação de um novo registro. Além disso, será exibida uma mensagem orientando o usuário a informar um novo fornecedor e a descrição do EDI. Ao confirmar a mensagem, o sistema copiará os dados da configuração escolhida e aplicará a um novo registro, bastando apenas informar o novo fornecedor e a nova descrição do EDI.
Em seguida, conforme instruído, preencha as informações solicitadas e, se necessário, ajuste os outros parâmetros de configuração, conforme demonstrado no primeiro passo. Para salvar, utilize o atalho >> F2 e confirme a mensagem exibida.
Ao consultar o fornecedor, o cadastro criado a partir do clone aparecerá na lista de "EDI cadastrado da pessoa". Caso o clone tenha sido feito para um fornecedor que já possua cadastro de EDI, ele será listado junto com os demais registros.
Excluir EDI da pessoa
Ao detalhar um EDI cadastrado, o usuário também pode excluir o registro. Para isso, basta pressionar o atalho>> F5 e confirmar a mensagem exibida.
Após, o EDI será removido do cadastro da pessoa.
Assista à vídeoaula.
Experiências 
✍️ Clique aqui, descreva o cenário com a experiência e a tratativa aplicada. Seu relato será avaliado e, se aprovado, contribuirá para a troca de conhecimento.
Nota final 
Este tópico tem como objetivo esclarecer pontos específicos e complementares relacionados à documentação, oferecendo informações adicionais que contribuem para uma melhor compreensão do conteúdo apresentado.
- Destaques visuais apresentados no documento;
- Termos técnicos utilizados:
- EDI: Electronic Data Interchange, é o processo responsável pelo intercâmbio eletrônico de arquivos entre o sistema da Zetti Tech e os fornecedores, viabilizando o processo de compra automatizado por meio do Robô de Compras.
Histórico de atualizações do documento
A seguir, apresentamos o registro das atualizações realizadas neste documento. Esse controle tem como objetivo garantir a qualidade, rastreabilidade e alinhamento das informações com as evoluções do sistema. As criações e revisões são realizadas conforme o versionamento de cada aplicação. Para mais detalhes sobre as melhorias e implementações relacionadas, consulte a página de Notas de Versão.
Explore outros conteúdos e descubra o passo a passo da operação.