O ponto de partida
Em 2010 fomos indicados ao Mundo do Futebol por um escritório de contabilidade. A empresa vendia artigos esportivos pela internet e enfrentava um problema clássico: a loja virtual, hospedada em uma plataforma de e-commerce, e o ERP utilizado pela empresa não se falavam. Cada pedido era redigitado manualmente. O estoque do site vivia diferente do estoque real.
Outro desenvolvedor já havia tentado resolver e não conseguiu.
O obstáculo
A API da plataforma de e-commerce existia e estava documentada. O ERP era o problema.
O suporte do fabricante do ERP não colaborou. A documentação que recebemos não correspondia ao sistema instalado. Depois de semanas sem qualquer avanço por esse caminho, ficou claro que a integração não sairia dali.
Restava uma alternativa: entender o sistema por dentro.
A virada
Com autorização do cliente, iniciamos o mapeamento completo do banco de dados SQL Server do ERP — sobre a base da própria empresa, no ambiente dela.
Eram centenas de tabelas. Algumas com mais de 150 campos. Nenhum dicionário de dados, nenhuma referência confiável.
O método foi artesanal e obstinado: dias inteiros ao lado de um funcionário da empresa, executando vendas e lançamentos de teste enquanto observávamos, registro a registro, o que o sistema gravava. Assim foram identificadas as tabelas de produtos, grade, filiais, vendas, itens de venda, financeiro, movimentações de estoque e os controles internos de sequenciais — além dos relacionamentos e chaves estrangeiras que ligavam tudo isso.
Ao final, tínhamos o que o fabricante não forneceu: o modelo de dados do ERP, documentado.
O que foi construído
Integrador de Pedidos. Captura os pedidos do site via API — incluindo grade de tamanho e cor, personalizações, dados do cliente e formas de pagamento — e os insere diretamente no banco do ERP. O pedido aparece na tela do sistema pronto para faturar e despachar. O cadastro do cliente vem completo; se já existir, é atualizado automaticamente.
Detalhe do negócio: o Mundo do Futebol trabalha com personalização — o cliente paga uma taxa adicional e recebe a camisa do seu time com o próprio nome. Esse dado precisa atravessar toda a cadeia intacto, do carrinho até a produção.
Monitor de Estoque. Lê o estoque no ERP e o atualiza no site, para milhares de produtos, em dois modos complementares: o modo incremental processa apenas os produtos com movimentação recente, mantendo o site próximo do tempo real ao longo do dia; o modo completo varre a base inteira, registrando em uma tabela auxiliar a fila de produtos a atualizar — se houver qualquer interrupção, o processo sabe exatamente onde parou e retoma dali.
Em ambos os modos, a grade de tamanho e cor é respeitada. E quando o monitor detecta um produto que ainda não existe no site, ele cria automaticamente o esqueleto do cadastro — cabendo ao responsável apenas completar fotos e descrição.
O problema que quase inviabilizou tudo
A API da plataforma tinha limite de requisições por hora. Ultrapassado o teto, o acesso era bloqueado.
Sem tratamento, isso significaria tarefas interrompidas pela metade, atualizações inconsistentes e uma solução em que ninguém confiaria.
A resposta foi arquitetural: todo o pacote — Integrador e Monitor — foi construído sobre ciclos de tempo controlados. Quando a API bloqueia, quando a internet cai ou quando o servidor sai do ar, o sistema não falha: ele aguarda, tenta novamente a cada intervalo e se recupera sozinho assim que o ambiente volta, retomando do ponto exato.
Isso foi projetado em 2010, muito antes de qualquer ferramenta de IA existir.
A prova real: quinze anos de mudanças
Uma integração bem construída se mede pelo que ela suporta.
- 2010
Primeira geração. Loja virtual em plataforma de e-commerce com API, integrada ao ERP do cliente, em SQL Server. Desenvolvimento em C#.
- 2011
O cliente substituiu a plataforma por um site próprio com banco MySQL. Integrador e Monitor de Estoque reconstruídos para a nova arquitetura.
- 2015
Atualização de grande porte do ERP para uma nova versão principal, com mudanças estruturais profundas no banco de dados. Nova geração de sistemas desenvolvida.
- 2024
Retorno à plataforma Fast Commerce. Quarta geração da integração, adaptada à API atual.
Resultado
Desde 2010, o Mundo do Futebol nunca voltou a redigitar um pedido.
Quatro plataformas, duas versões de ERP, dois bancos de dados diferentes, quinze anos de operação contínua — e o mesmo parceiro técnico do primeiro dia até hoje.
Tem um cenário parecido? Vamos conversar.
Falar com a Expert