Como integrar Magento / Adobe Commerce com ERP e CRM sem travar o checkout (arquitetura com RabbitMQ)

O erro clássico: integração síncrona no checkout

Muita loja chama o ERP, o antifraude ou o CRM no meio do fechamento do pedido. Funciona no dia normal. No dia da promoção, o ERP fica lento, o checkout espera, dá timeout e o cliente desiste, ou pior: paga e o pedido não chega ao ERP.

Qualquer sistema externo vai cair um dia. A arquitetura precisa assumir isso.

Integração assíncrona com filas

O Magento 2 e o Adobe Commerce têm um framework de filas (Message Queue) que trabalha com RabbitMQ. O desenho que uso:

• O evento acontece na loja (pedido criado, cliente cadastrado, lead gerado) e é gravado no banco normalmente.
• Um publisher coloca uma mensagem na fila com os dados necessários.
• Consumidores processam a fila em segundo plano e chamam o ERP ou o CRM.
• Se a chamada falhar, a mensagem volta para nova tentativa; depois de N falhas vai para uma fila de erro, com log e alerta.

Um exemplo real (sem nomes)

Num marketplace de seminovos de uma montadora global, em Adobe Commerce Cloud, a plataforma tinha 14 módulos customizados, leads roteados para o CRM e múltiplos gateways de pagamento. As filas com RabbitMQ garantiram que nenhum lead se perdesse quando um sistema externo oscilava. Entrei como Senior Frontend e, a pedido do cliente, fui nomeado arquiteto do projeto.

Cuidados que fazem a diferença

• Idempotência: reprocessar a mesma mensagem não pode duplicar pedido no ERP.
• Contratos documentados (REST ou GraphQL) e versionados.
• Mapeamento explícito de status entre loja e ERP.
• Observabilidade: saber quantas mensagens estão na fila, quantas falharam e por quê.
• Pagamento continua síncrono quando precisa ser (autorização), mas a conciliação pode ser assíncrona.

Quando a integração síncrona ainda faz sentido

Consultas rápidas e indispensáveis, como cálculo de frete ou autorização do cartão, continuam em tempo real, com timeout curto e resposta de contingência. O que não precisa acontecer na frente do cliente vai para a fila.