Tem um ERP, uma loja online, um CRM e um software de faturação. Cada um funciona bem sozinho, mas não falam uns com os outros. O resultado é previsível: dados introduzidos duas ou três vezes, erros de stock, faturas que não batem com as encomendas e horas gastas em tarefas que um computador faria sozinho. A solução chama-se integração de sistemas. Escrevemos este guia como quem faz estas ligações e, onde temos exemplo em vídeo, mostramos os dados a passar entre programas. É para quem gere uma PME em Portugal e quer perceber as opções, quando chega um conector pronto, o que pode correr mal e quanto custa.

O problema: cada software numa ilha

As empresas vão acumulando ferramentas: primeiro uma folha de cálculo, depois um ERP, mais tarde uma loja online, um CRM, um software de contabilidade. Cada uma foi escolhida pelo que faz bem, e ninguém pensou em como iriam comunicar. Quando um cliente compra na loja, alguém lança a venda no ERP. Quando o stock muda no armazém, alguém atualiza a loja. Cada tarefa é pequena, e somadas ao longo de um mês ocupam muitas horas e dão erros.

Como se ligam dois sistemas

  • API (interface de programação): permite a dois programas comunicar diretamente. Muitas plataformas, como Shopify, HubSpot e Salesforce, têm API. Nos ERP nacionais, como o PHC e o Primavera, o que existe e o que está incluído depende do produto, da versão e do contrato, por isso confirme-o antes de prometer uma integração.
  • Webhooks: avisos automáticos enviados por um sistema quando acontece algo, como uma encomenda paga numa loja WooCommerce.
  • Middleware: programa intermédio que recebe dados num formato, os traduz e os entrega ao destino.
  • ETL (extrair, transformar, carregar): copia os dados de uma fonte para outra, em lotes, muito usado para relatórios e análise.
  • Ficheiros de intercâmbio: exportação e importação de CSV ou XML, à mão ou automática, que ainda é a única opção em muitos sistemas antigos.
O caminho de uma encomenda, da loja ao ERP
Loja onlineCamada de integraçãoERP1 · Encomenda paga (webhook)2 · Valida e traduz os campos3 · Criar encomenda×sem resposta4 · Nova tentativa ao fim de 5 minutos5 · Criar encomenda6 · Número da encomenda7 · Atualiza estado e stock
A falha do ERP não perde a encomenda. A camada de integração guarda a mensagem, tenta de novo e só dá o trabalho por feito quando o ERP responde. Quem compra na loja não vê nada, e quem gere a empresa não precisa de lançar a encomenda à mão.
Exemplo hipotético e simplificado. Cada sistema real tem as suas regras, e a tentativa de nova ligação e o seu intervalo são definidos em cada integração.

Arquiteturas de integração

  • Ponto a ponto: cada sistema ligado diretamente a cada outro. Funciona com dois ou três. Com cinco sistemas podem ser dez ligações, cada uma com a sua lógica, e a manutenção torna-se cara.
  • Concentrador (hub and spoke): todos falam com um sistema central, nunca entre si. Simplifica a manutenção e dá uma visão única dos fluxos, mas o concentrador é um ponto único de falha.
  • Gateway de API: uma camada que autentica, controla e encaminha os pedidos, útil quando várias equipas ou serviços consomem os mesmos dados.
  • Plataformas de integração (iPaaS), como o Make ou o Zapier: fluxos montados sem programar, em interfaces visuais, adequadas a ligações simples entre ferramentas que já têm conector.

Integrações mais pedidas por PME

Plataforma de integração ou desenvolvimento à medida

  • Os dois programas já têm conector no Make, no Zapier ou na integração que um deles traz: a lógica é simples, uma ação dispara outra, e o volume é baixo ou moderado. Aqui recomendamos o conector pronto: valida o processo depressa e sem grande investimento.
  • Um dos sistemas não tem conector ou tem uma API própria: a ligação tem de ser feita à medida.
  • A lógica é complexa: transformações, várias condições, casos especiais no mapeamento.
  • O volume é alto e o custo por operação da plataforma pesa.
  • Precisa de controlo total sobre os dados e de garantias de disponibilidade.

Se se reconhece no primeiro ponto, comece pela prateleira: a recomendação é nossa. Muitas empresas começam por uma plataforma para provar o conceito e passam ao desenvolvimento à medida quando o volume ou a complexidade o justificam. Nas ligações à medida, costumamos ligar por API quando o programa dá acesso, ou por exportação quando não dá.

O mapeamento de dados

Cada sistema tem o seu modelo de dados. Um «cliente» do CRM tem campos diferentes do «cliente» do ERP. O mapeamento define como cada campo de um corresponde ao outro, incluindo os casos especiais, os valores em falta e os conflitos, e define também o que não deve atravessar a ligação.

Mapeamento de campos entre um CRM e um ERP
CRMERP
EmpresaExemplo, Lda.
copia
Nome fiscalExemplo, Lda.
NIFPT 999 999 990
remove o prefixo e os espaços
NIF999999990
MoradaRua A, 12, 4000-001 Porto
separa em três campos
Rua · Código postal · LocalidadeRua A, 12 · 4000-001 · Porto
Estado da propostaGanha
dispara a criação da encomenda
EncomendaEm aberto
Notas internas«Cliente difícil…»
não segue
—fica no CRM
O mapeamento decide o que atravessa a ligação, e em que forma. Cada campo tem uma regra, e o que não é preciso (como as notas internas sobre o cliente) não sai do CRM, em linha com a minimização de dados do RGPD. Os dados do exemplo são fictícios.
Exemplo hipotético, com dados fictícios e regras simplificadas. A verde, o que segue com ou sem transformação; a âmbar, o que dispara uma ação; a cinzento, o que não segue.

Exemplos por setor

Quanto custa

Orçamos cada integração caso a caso, porque o custo depende dos sistemas envolvidos, da documentação das interfaces, do volume de dados e da lógica. Como ponto de partida, a tabela do site:

  • Automação pontual entre dois sistemas com interface documentada (por exemplo, enviar as encomendas de uma loja para uma folha ou para um ERP com API): a partir de €300.
  • Dashboard que consolida dados de uma ou duas fontes: a partir de €500.
  • Aplicação web com a sua própria lógica e ligações simples: a partir de €800.
  • App mobile ligada aos seus sistemas: a partir de €2.500.
  • Manutenção mensal, que numa integração tem de existir porque as interfaces mudam: a partir de €50.
  • Integrações entre vários sistemas, com sistemas antigos, grandes volumes ou requisitos de disponibilidade: orçamento personalizado, caso a caso.

Além do desenvolvimento, conte com a subscrição da plataforma de integração, se a usar (que normalmente depende do número de operações), e com o tempo de quem conhece os processos para validar o mapeamento. Quanto ao retorno, depende do tempo que a equipa gasta hoje a copiar dados e dos erros que isso provoca. Exemplo hipotético: se duas pessoas gastassem 10 horas por mês cada em lançamentos repetidos, e cada hora custasse €15 à empresa, seriam 20 horas e €300 por mês, ou €3.600 por ano. Faça a conta com os seus números, em vez dos deste exemplo. O preço final fixa-se na proposta.

Como decorre um projeto

  • Auditoria dos sistemas: quais são, que versões, que interfaces têm e onde os dados são hoje copiados à mão. Identifica também os sistemas sem API, que exigem alternativas, como ler a base de dados ou processar ficheiros.
  • Mapeamento de dados: campo a campo, com as regras para casos especiais.
  • Desenvolvimento e gestão de erros: o que acontece quando uma chamada falha? Há nova tentativa? Alguém é avisado?
  • Testes: não só o caso normal, mas dados inválidos, sistemas em baixo, duplicados e demoras.
  • Monitorização: alertas de falha, registo de cada mensagem e um processo claro para quando algo corre mal.
Monitorização de uma integração: o que passou e o que falhou
310concluídas à primeira
1concluída após nova tentativa
1à espera de correção
09:12Encomenda 10479 → ERPCriada
09:40Stock do ERP → loja48 artigos atualizados
10:05Encomenda 10480 → ERPCriada à 2.ª tentativa
10:31Encomenda 10482 → ERPEm erro: NIF com 8 dígitos
10:45Expedição 10479 → lojaEnviada ao cliente
Encomenda 10482: o NIF tem 8 dígitos em vez de 9. O ERP recusou-a e a mensagem ficou em fila. Um alerta foi enviado por email a quem trata das encomendas, que corrige o NIF no CRM e manda reenviar.
Uma integração sem monitorização falha em silêncio. Os registos de cada mensagem e os alertas de erro são o que permite perceber, no próprio dia, o que não passou, e a ter a prova do que passou, em caso de dúvida.
Exemplo hipotético, com números e registos fictícios, do painel de uma integração entre uma loja online e um ERP nas últimas 24 horas.

Segurança e dados pessoais

Quando os sistemas comunicam, os dados passam pela rede, e isso traz obrigações técnicas e legais, sobretudo quando há dados pessoais.

  • Dados em trânsito: toda a comunicação deve ser cifrada (HTTPS/TLS).
  • Autenticação: use o mecanismo que a interface suportar (por exemplo OAuth 2.0 ou chaves de API com âmbito limitado), e nunca a conta de uma pessoa para uma integração automática.
  • Minimização: a integração deve transferir só o necessário. Se a sincronização de stock não precisa do nome do cliente, esse campo não entra.
  • Registos: guarde registo das operações, para diagnosticar problemas e para demonstrar conformidade, com um prazo de conservação definido.
  • Subcontratantes: se uma plataforma de terceiros processa dados pessoais, é preciso um acordo de subcontratação (DPA) e confirmar onde os dados são tratados.

O que perguntar a um fornecedor

  • Que interfaces tem cada um dos meus sistemas, e o que depende de licenças adicionais do fabricante?
  • O que acontece quando um sistema fica em baixo ou uma mensagem falha?
  • Como vejo o que passou e o que falhou, e quem é avisado?
  • Quem mantém a integração quando um dos sistemas mudar a sua interface, e quanto custa?
  • Os meus dados passam por algum serviço de terceiros, e onde fica alojado?
  • Quais são os custos ao fim de três anos, incluindo plataformas e manutenção?

Por onde começar

  • Que sistemas usa hoje?
  • Onde é que a informação é introduzida mais do que uma vez?
  • Que erros acontecem por dados desatualizados ou inconsistentes?
  • Quanto tempo gasta a equipa, por semana, a copiar e a verificar dados entre sistemas?

As respostas dizem onde começar, e ajudam a estimar o retorno. Nós começamos pelo processo mais repetitivo: a ligação com mais repetição e mais erros, e as outras depois. Veja também os guias de desenvolvimento de APIs REST, de automação de tarefas repetitivas e de business intelligence.

Se o seu caso pede uma ligação à medida, contacte-nos para uma conversa sem compromisso, e veja os exemplos por setor.