Modernização de legado: o padrão strangler na prática
Modernização de legado sem parar a operação: o padrão strangler substitui o sistema antigo por partes, com risco controlado em cada entrega.
Ler artigoArquitetura de Software
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.

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.
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.
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.
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
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.
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.
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.
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
Modernização de legado sem parar a operação: o padrão strangler substitui o sistema antigo por partes, com risco controlado em cada entrega.
Ler artigoAutenticar é só o começo. Veja como modelar papéis, escopos e permissões no Keycloak para que a autorização não vire um emaranhado de ifs.
Ler artigoMonólito modular entrega a simplicidade operacional do monólito com fronteiras claras de domínio. Entenda quando ele vence os microserviços.
Ler artigoVamos construir juntos
Conte o desafio. A ITCODE avalia o contexto e propõe o caminho mais adequado — seja desenvolvimento, sustentação, assessoria ou outsourcing.
ou pelo WhatsApp
(54) 98134-6930 ↗