Case de sucesso

Mundo do Futebol — quinze anos, quatro gerações de integração

Em 2010, a loja virtual e o ERP não se falavam e cada pedido era redigitado. Outro desenvolvedor já havia tentado e não conseguiu. Mapeamos o banco do ERP registro a registro e construímos a integração que, quatro plataformas e duas versões de ERP depois, continua rodando.

2010
primeiro ano em operação
4
gerações da integração
2
bancos de dados diferentes
0
pedidos redigitados desde então

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.

  1. 2010

    Primeira geração. Loja virtual em plataforma de e-commerce com API, integrada ao ERP do cliente, em SQL Server. Desenvolvimento em C#.

  2. 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.

  3. 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.

  4. 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

Integrações