Integração e-commerce + ERP + logística: fim da digitação dupla
Integração e-commerce + ERP + logística
O contexto
E-commerce de médio porte (GMV ~R$ 400k/mês) vendendo em loja própria (WooCommerce) + Mercado Livre + Shopee. ERP Bling para gestão. 3 transportadoras diferentes conforme região.
Equipe de 4 pessoas gastando a maior parte do dia relançando pedidos manualmente entre plataformas.
O problema
- 14h/semana de trabalho manual só movendo dados entre sistemas
- Erros de digitação gerando notas fiscais erradas (~5% de reemissão)
- Estoque desatualizado entre canais — cancelamentos por falta de produto
- Sem rastreamento unificado — cliente perguntava status e ninguém sabia responder rápido
- Escala impossível — para crescer, precisaria contratar mais gente só para operar sistemas
A solução técnica
Camada de integração event-driven
Construímos um hub central que escuta eventos de cada sistema e orquestra os fluxos:
Pedido novo (marketplace) → Hub → Valida estoque → Cria no ERP → Gera NF → Envia para transportadora → Atualiza tracking → Notifica clienteFilas com retry automático
Cada etapa do fluxo é uma mensagem em fila (Redis + BullMQ). Se uma ponta cai (ERP fora, transportadora com timeout), a mensagem volta para a fila e é reprocessada automaticamente em intervalos crescentes.
Painel de conciliação
Dashboard mostrando em tempo real:
- Pedidos processados com sucesso
- Pedidos em fila (aguardando retry)
- Pedidos com erro (exigem ação humana)
- Alertas de estoque divergente entre canais
Sincronização de estoque multi-canal
Estoque unificado no ERP como source of truth. A cada venda em qualquer canal, o hub atualiza reserva nos demais em menos de 30 segundos.
Stack
Node.js | Redis (BullMQ) | PostgreSQL | WooCommerce API | Bling API | Mercado Livre API | Shopee API | APIs de transportadoras
O resultado
| Métrica | Antes | Depois |
|---|---|---|
| Horas manuais/semana | 14h | < 1h (só exceções) |
| Taxa de erro em NF | ~5% | < 0.3% |
| Cancelamentos por estoque | ~8/mês | 0-1/mês |
| Tempo para status do pedido | 5-15 min (manual) | Instantâneo (painel) |
| Capacidade de volume | ~800 pedidos/mês | 3.000+ pedidos/mês (mesma equipe) |
ROI: investimento se pagou em 2.5 meses considerando apenas economia de horas.
Aprendizados
- APIs de marketplaces são instáveis — o retry com backoff exponencial não é luxo, é necessidade. Mercado Livre em particular tem rate limits agressivos.
- Conciliação > automação cega — automatizar sem ter painel de exceções é receita para bagunça silenciosa. O humano precisa ver o que falhou.
- Comece pelo fluxo mais doloroso — começamos pelo fluxo pedido→NF (o mais manual) e expandimos depois. Valor imediato gera confiança para o restante.