Pular para o conteúdo
itcode tech systems

Arquitetura de Software

Integração de sistemas: como conectar ERP, CRM e e-commerce sem criar um novo legado

Integrar ERP, CRM e e-commerce exige mais que ligar APIs. Veja como escolher entre API, fila e eventos e evitar que a integração vire o próximo legado.

16 de nov. de 2026·8 min de leitura
Integração de sistemas conectando ERP, CRM e e-commerce por um barramento central de dados

Quase toda empresa média tem o mesmo desenho: um ERP no centro, um CRM para o comercial, uma loja virtual, um sistema de logística e algumas planilhas fazendo a ponte entre eles. Enquanto o volume é pequeno, alguém copia o pedido de um lado para o outro e tudo funciona.

O problema aparece quando a operação cresce. Pedido duplicado, estoque divergente entre a loja e o ERP, cliente cadastrado três vezes com dados diferentes. Nesse ponto, a integração de sistemas deixa de ser um detalhe técnico e passa a ser uma questão de faturamento.

Integrar não é só ligar uma API na outra. É decidir quem é o dono de cada dado, como as informações viajam e o que acontece quando algo falha no meio do caminho.

Comece pelo dono do dado, não pela ferramenta

O erro mais comum em projetos de integração é começar escolhendo a tecnologia. A primeira pergunta deveria ser outra: qual sistema é a fonte da verdade para cada informação?

Um mapa simples já resolve metade das discussões:

•        Cliente: nasce no CRM ou no e-commerce, é consolidado no ERP?

•        Produto e preço: o ERP manda e os outros só leem?

•        Estoque: quem reserva, quem baixa e quem apenas consulta?

•        Pedido: a loja cria, o ERP fatura, a logística atualiza o status?

Quando dois sistemas podem alterar o mesmo dado sem regra clara, a divergência é questão de tempo. Defina um único dono por informação e trate os demais como consumidores.

Os três modelos de integração e quando usar cada um

Não existe um modelo certo para tudo. Existem três abordagens principais, e a maioria dos cenários reais combina mais de uma.

1. Integração síncrona por API

Um sistema chama o outro e espera a resposta. É o modelo mais intuitivo e funciona bem quando a resposta precisa ser imediata.

Use quando:

•        O usuário está esperando o resultado na tela, como cálculo de frete ou consulta de saldo

•        A operação é rápida e de baixo volume

•        O sistema de destino tem disponibilidade alta e previsível

O ponto de atenção é o acoplamento. Se o ERP fica fora do ar, a loja que depende dele para fechar o pedido também para. Cadeias longas de chamadas síncronas multiplicam o risco de falha.

2. Integração assíncrona com filas

O sistema de origem publica uma mensagem em uma fila, como RabbitMQ, Amazon SQS ou Azure Service Bus, e segue o trabalho. O destino processa no seu ritmo.

Use quando:

•        O volume tem picos, como Black Friday ou fechamento de mês

•        O processamento pode levar alguns segundos ou minutos sem prejuízo

•        Você precisa garantir que nada se perca se o destino estiver indisponível

A fila absorve picos e desacopla a disponibilidade dos sistemas. Em troca, exige tratamento de reprocessamento, mensagens com erro e ordem de chegada.

3. Arquitetura orientada a eventos

Em vez de um sistema mandar uma ordem para outro, ele anuncia que algo aconteceu: "pedido criado", "pagamento aprovado", "estoque abaixo do mínimo". Quem tiver interesse no fato se inscreve e reage.

Use quando:

•        Vários sistemas precisam reagir ao mesmo fato

•        Novos consumidores devem poder entrar sem alterar a origem

•        Você quer histórico do que aconteceu, não apenas o estado atual

Eventos dão flexibilidade para crescer, mas exigem disciplina: contratos versionados, nomes que reflitam o negócio e monitoramento de quem consome o quê.

Ponto a ponto, middleware ou iPaaS?

Além do modelo de comunicação, é preciso decidir onde a lógica de integração vai morar.

•        Ponto a ponto: cada sistema conversa direto com o outro. É rápido para começar, mas com cinco sistemas você pode chegar a vinte conexões diferentes para manter.

•        Middleware ou camada de integração própria: um serviço central recebe, transforma e distribui os dados. Concentra regras e facilita monitoramento, mas precisa de dono e sustentação.

•        iPaaS (plataformas de integração como serviço): ferramentas prontas com conectores para sistemas conhecidos. Aceleram cenários padrão, mas podem ficar caras com volume e limitadas em regras específicas.

A regra prática: integrações simples e padronizadas cabem bem em ferramentas prontas. Regras de negócio que diferenciam a sua operação merecem uma camada própria, versionada e testada como qualquer outro software.

Contratos claros evitam a maior parte dos problemas

Uma integração é um acordo entre dois sistemas. Quando o acordo é implícito, qualquer mudança de um lado quebra o outro sem aviso.

Boas práticas que fazem diferença:

•        Documente os contratos em OpenAPI para APIs e em AsyncAPI ou JSON Schema para mensagens e eventos

•        Versione as mudanças e mantenha a versão anterior por um período definido

•        Valide na entrada: rejeite dados fora do contrato em vez de tentar adivinhar

•        Use identificadores estáveis: o código do cliente no ERP não deveria depender do e-mail cadastrado na loja

Contrato documentado também reduz dependência de pessoas. Quando só um desenvolvedor sabe como a integração funciona, você tem um risco, não uma integração.

Projete para a falha, porque ela vai acontecer

Redes caem, APIs de terceiros mudam sem avisar, tokens expiram. Uma integração madura não é a que nunca falha, é a que falha de forma controlada e se recupera sozinha.

Os mecanismos essenciais:

•        Idempotência: processar a mesma mensagem duas vezes não pode gerar dois pedidos ou duas baixas de estoque. Use uma chave única por operação.

•        Retentativas com intervalo crescente: tentar de novo imediatamente só piora a sobrecarga do sistema de destino.

•        Fila de mensagens com erro (dead letter queue): o que falhou depois de várias tentativas vai para um lugar visível, onde alguém analisa e reprocessa.

•        Timeouts definidos: nenhuma chamada deve esperar indefinidamente.

•        Padrão outbox: grave o evento na mesma transação do banco de dados que gerou a mudança e publique depois. Assim, nunca existe pedido salvo sem evento, nem evento sem pedido.

Sem observabilidade, a integração vira caixa-preta

O cliente reclama que o pedido não chegou ao ERP. Onde ele parou? Se a resposta exige abrir cinco logs em três servidores, a integração não está pronta.

O mínimo que vale implementar:

•        ID de correlação que acompanha a operação do início ao fim, em todos os sistemas

•        Painel com volume, tempo de processamento e taxa de erro por fluxo de integração

•        Alertas para fila acumulando, erro acima do normal ou fluxo parado

•        Tela de reprocessamento para que o suporte resolva casos simples sem acionar desenvolvimento

Observabilidade transforma reclamação em diagnóstico de minutos, não de dias.

Segurança também faz parte do contrato

Integrações trafegam dados de clientes, pedidos e preços. Elas precisam do mesmo cuidado que qualquer sistema exposto.

•        Autenticação entre sistemas com OAuth 2.0 ou certificados, nunca com usuário e senha fixos no código

•        Segredos guardados em cofre, como Azure Key Vault, AWS Secrets Manager ou HashiCorp Vault

•        Tráfego sempre criptografado com TLS

•        Permissões mínimas: o e-commerce não precisa de acesso total ao ERP para consultar estoque

•        Registro de quem acessou o quê, o que também ajuda na conformidade com a LGPD

Um roteiro prático para começar

Se a sua operação já sofre com dados divergentes, um caminho seguro é:

1.      Mapear os sistemas, os fluxos de dados e quem é o dono de cada informação

2.      Listar os pontos de dor com impacto mensurável: retrabalho, pedidos travados, divergência de estoque

3.      Priorizar o fluxo de maior impacto e menor complexidade para o primeiro ciclo

4.      Definir contrato, modelo de comunicação e tratamento de falhas desse fluxo

5.      Implementar com observabilidade desde o primeiro dia

6.      Medir o resultado e só então avançar para o próximo fluxo

Integrar tudo de uma vez costuma gerar um projeto longo, caro e difícil de validar. Fluxo a fluxo, o ganho aparece cedo e financia o restante.

Quando a integração esbarra no legado

Muitas vezes o sistema central não tem API, ou tem uma API frágil que ninguém quer tocar. Nesses casos, a integração pode ser o primeiro passo de uma modernização gradual: uma camada nova expõe os dados de forma organizada enquanto o legado continua operando por trás.

Esse é exatamente o princípio do padrão strangler, explicado no artigo Modernização de legado: o padrão strangler na prática. E se a dúvida é como organizar os módulos da nova camada sem cair na complexidade dos microserviços, vale ler Monólito modular: a arquitetura que devolve velocidade ao time.

Como a ITCODE pode ajudar

A ITCODE desenvolve camadas de integração sob medida, conectando ERPs, CRMs, plataformas de e-commerce e sistemas legados com contratos documentados, tratamento de falhas e monitoramento. Para quem já tem integrações em produção, a assessoria técnica avalia a arquitetura atual e propõe um plano de evolução, e a sustentação mantém os fluxos funcionando no dia a dia.

Conclusão

Integração de sistemas bem feita é quase invisível: o pedido entra na loja, chega ao ERP, gera a nota e atualiza o estoque sem ninguém precisar olhar. Para chegar lá, a tecnologia é a parte mais fácil.

O que separa uma integração sólida de um novo legado é a clareza sobre quem é dono de cada dado, contratos explícitos, tratamento de falhas pensado desde o início e visibilidade sobre o que está acontecendo. Com isso no lugar, conectar o próximo sistema deixa de ser um projeto e vira rotina.

Veja também Keycloak além do login

Continue lendo

Mais sobre Arquitetura de Software

Vamos construir juntos

Seu próximo passo digital começa com uma conversa.

Conte o desafio. A ITCODE avalia o contexto e propõe o caminho mais adequado — seja desenvolvimento, sustentação, assessoria ou outsourcing.

Entre em contato

Vamos conversar sobre a sua demanda.

ou pelo WhatsApp

(54) 98134-6930 ↗