
Integração EDI com o maior cliente: o que a TI tem de tratar
Costuma começar com uma carta de um grande cliente: a partir de determinada data, encomendas, avisos de expedição e faturas só por EDI. Uma integração EDI soa a escolha de software, e em parte é. Mas o que determina se as mensagens chegam todos os dias está por baixo: certificados, a firewall, os dados-mestre e alguém que dê conta de que falta uma mensagem.
Uma integração EDI troca encomendas, avisos de expedição e faturas num formato fixo entre o sistema da empresa e o do cliente, sem email ou PDF pelo meio.
O software e a tradução das mensagens vêm de um prestador de EDI ou do fornecedor de ERP; a TI trata da ligação, dos certificados, da firewall e da vigilância.
A parte mais difícil raramente é técnica: códigos de artigo e de localização corretos e alguém que repare que uma mensagem não chegou.
O que é uma integração EDI
EDI significa Electronic Data Interchange: duas empresas enviam entre si mensagens comerciais num formato fixo e acordado, diretamente de sistema para sistema. A encomenda do cliente deixa de chegar como PDF numa caixa de correio e passa a ser uma mensagem que o ERP lê sozinho. Seguem depois em sentido contrário uma confirmação de encomenda, um aviso de expedição (muitas vezes chamado ASN) e uma fatura.
Para isso, duas coisas têm de estar certas, e confundem-se com frequência:
- O formato. Como uma mensagem é construída. Na Europa é muitas vezes EDIFACT, no retalho geralmente a variante EANCOM da GS1, e cada vez mais XML. Nos Estados Unidos é habitual o X12.
- O transporte. Como a mensagem viaja: por AS2 (uma ligação protegida com certificados), por SFTP, ou pela rede de um prestador de EDI que passa as mensagens.
Entre o ERP e esse formato há um passo de tradução, o mapping. É software e trabalho especializado, e vem de um prestador de EDI ou do fornecedor de ERP.
Três formas de fazer a ligação
A forma adequada depende sobretudo do número de mensagens e do número de parceiros que pedem EDI.
- Através de um prestador de EDI. Trata da ligação aos clientes, do mapping e da passagem das mensagens, e o ERP fala apenas com ele. É a forma mais escolhida quando há mais do que um parceiro, porque cada novo cliente passa a ser uma ligação no prestador e não um projeto próprio.
- Uma ligação direta. O software EDI próprio ou o módulo EDI do ERP fala diretamente com o cliente por AS2 ou SFTP. Menos intermediários, mas toda a gestão fica do lado da empresa: certificados, ligações, atualizações e vigilância.
- Um portal web do cliente. As encomendas são copiadas à mão e os avisos de expedição preenchidos num site. Funciona com um punhado de encomendas por semana e limita-se a mudar o trabalho manual para outro ecrã.
Para qualquer das formas, a mesma pergunta: quem liga ao cliente quando uma mensagem é rejeitada, e quem resolve?
Começar pelo manual de EDI do cliente
Cada grande cliente tem um guia de implementação: que mensagens espera, em que versão, que campos são obrigatórios, em que prazo tem de chegar uma confirmação ou um aviso de expedição, e como decorrem os testes. Deve ler-se primeiro, em conjunto com quem trata das encomendas e do armazém. A maior parte do atraso não está na técnica, está no que esse guia pede aos dados.
- Dados-mestre. Os códigos de artigo (GTIN), de localização (GLN) e as unidades têm de coincidir no ERP com o que o cliente espera. Estes códigos pedem-se à GS1, não à TI.
- Etiquetas e avisos de expedição. Um aviso de expedição refere muitas vezes uma etiqueta SSCC na palete. A mensagem e a etiqueta têm então de vir da mesma fonte, o que toca nas impressoras e nos scanners do armazém. Há mais sobre o equipamento na nossa página sobre scanners de armazém.
- Testes com uma data. Planeados de trás para a frente a partir da data de início do cliente, com tempo para mensagens de teste rejeitadas.
O que a TI tem de tratar por baixo
Seja como for que o mapping esteja construído, uma integração EDI depende de algumas coisas que são da TI. São pequenas, e cada uma pode parar o fluxo de mensagens numa terça-feira qualquer.
- Certificados com data de validade. Uma ligação AS2 assenta em certificados dos dois lados. Se um caduca, as mensagens param. As datas devem ficar numa agenda com responsável, e deve combinar-se com o cliente como se troca um certificado novo.
- A firewall. O cliente ou o prestador ligam muitas vezes a partir de endereços fixos e esperam o mesmo da outra parte. Regista-se que portas e endereços estão abertos e porquê, para que uma limpeza da firewall não leve a integração atrás.
- Chaves e contas de serviço. Uma chave SFTP ou uma conta para a integração não deve estar em nome de um colaborador. Se ele sai, a integração sai com ele.
- A máquina onde corre. Se o software EDI corre num servidor próprio, esse servidor entra na gestão normal: atualizações, cópias de segurança, vigilância. Um servidor esquecido a um canto é uma causa muitas vezes ouvida.
- Um ambiente de teste e um de produção. Separados, para que uma mensagem de teste nunca entre no ERP como encomenda real.
Uma mensagem que não chega, ninguém dá por ela
Numa encomenda por email, alguém vê o email. Com EDI, quando uma mensagem não vem, não há nada para ver: nenhuma encomenda, nenhum erro, apenas uma lista vazia. Por isso a vigilância é a parte que mais rende.
- Confirmações de receção. O AS2 devolve uma confirmação técnica, e o EDIFACT tem uma mensagem própria para indicar que uma mensagem foi recebida ou rejeitada. Devem ser usadas, e uma confirmação que não chega deve gerar um alerta.
- Recebido não é processado. Uma mensagem pode entrar sem problemas e ficar presa no ERP num código de artigo desconhecido. Por isso, vigiam-se os dois passos.
- Alertas para um sítio partilhado, não para a caixa de correio de uma só pessoa, e combinado quem olha para eles fora de horas quando o cliente também encomenda de noite.
- Um arquivo de mensagens. Numa discussão sobre uma encomenda ou fatura, é preciso poder mostrar o que foi enviado e quando.
EDI e faturação eletrónica são dois percursos
Uma fatura pode seguir para o cliente por EDI, e então parece que a faturação eletrónica está resolvida. Não é automático. A faturação eletrónica segue cada vez mais pelo Peppol na Europa, uma rede própria com regras próprias. Na Bélgica, a fatura eletrónica estruturada entre empresas é obrigatória desde 2026, e em Portugal as entidades públicas recebem faturas eletrónicas estruturadas com especificação própria.
Se uma fatura EDI cumpre essas regras para um determinado cliente, ou se é preciso faturar também pelo Peppol, pergunta-se ao fornecedor do programa de contabilidade, ao prestador de EDI e ao contabilista. Para a TI há uma coisa que importa: são duas integrações com dois conjuntos de regras, e ambas têm de estar vigiadas.
Onde termina o nosso trabalho
O que fazemos. Tratamos da TI por baixo da integração EDI: a ligação e as regras de firewall, a gestão de certificados e chaves com responsável e data de validade, o servidor ou serviço cloud em que o software corre, contas de serviço que não dependem de um colaborador, cópias de segurança, e vigilância que torna visível um fluxo de mensagens parado antes de o cliente telefonar.
O que não fazemos. O software EDI, o mapping e a rede de mensagens são do prestador de EDI ou do fornecedor de ERP; não os vendemos nem os construímos. Não somos transitários nem transportadores: não enviamos ordens de transporte em nome do cliente nem tratamos de assuntos aduaneiros. Os códigos de artigo e de localização pedem-se à GS1, e quem avalia se as faturas cumprem as regras fiscais é o contabilista.
Perguntas que recebemos sobre este tema
As cinco mais frequentes.
O que é uma integração EDI?
Uma integração EDI troca mensagens comerciais como encomendas, avisos de expedição e faturas num formato fixo entre o sistema da empresa e o de um parceiro comercial, sem email ou PDF pelo meio. O formato é muitas vezes EDIFACT, EANCOM ou XML, e as mensagens viajam por AS2, SFTP ou através de um prestador de EDI.
Qual é a diferença entre EDI e uma API?
Ambas ligam sistemas. O EDI usa normas de mensagem fixas acordadas em todo um setor e funciona geralmente com mensagens enviadas. Uma API é uma ligação desenhada pelo próprio fornecedor, que permite a um sistema consultar outro diretamente. Os grandes parceiros comerciais pedem muitas vezes EDI, porque assim trabalham da mesma forma com centenas de fornecedores.
É preciso um prestador de EDI?
Nem sempre, mas com mais do que um parceiro muitas vezes sim. Um prestador trata das ligações, do mapping e da passagem das mensagens, de modo que um novo cliente é uma ligação e não um projeto. Numa ligação direta, toda a gestão fica do lado da empresa, incluindo certificados e vigilância.
Porque é que uma integração EDI para de repente?
Muitas vezes por algo pequeno fora do software: um certificado caducado, uma regra de firewall limpa, uma chave ou conta em nome de um colaborador que saiu, ou um servidor que ficou fora da gestão. Uma mensagem que entra mas fica presa no ERP num código desconhecido também parece uma integração parada.
Podem construir o nosso mapping EDI?
Não. O software EDI, o mapping e a rede de mensagens vêm de um prestador de EDI ou do fornecedor de ERP. Também não somos transitários e não enviamos ordens de transporte em nome do cliente. Tratamos da TI por baixo: ligação, firewall, certificados, contas, servidor e vigilância.
Para ler a seguir
Onde a integração se liga.
Rever a TI por baixo da integração EDI?
Envie-nos o manual de EDI do cliente e um esquema de como as mensagens correm hoje. Dizemos o que tem de estar tratado por baixo da integração; o mapping continua com o prestador de EDI.
Conhecimento prático de TI na sua caixa de correio
Novos guias sobre gestão, segurança e postos de trabalho, escritos por quem faz o trabalho. Sem conversa comercial, e pode cancelar a subscrição com um clique.