Caso de éxito

Mundo do Futebol — quince años, cuatro generaciones de integración

En 2010, la tienda virtual y el ERP no se hablaban y cada pedido se volvía a tipear. Otro desarrollador ya lo había intentado y no lo logró. Mapeamos la base del ERP registro a registro y construimos la integración que, cuatro plataformas y dos versiones de ERP después, sigue funcionando.

2010
primer año en operación
4
generaciones de la integración
2
bases de datos distintas
0
pedidos vueltos a tipear desde entonces

El punto de partida

En 2010 nos recomendó a Mundo do Futebol un estudio contable. La empresa vendía artículos deportivos por internet y enfrentaba un problema clásico: la tienda virtual, alojada en una plataforma de e-commerce, y el ERP que usaba la empresa no se hablaban. Cada pedido se volvía a tipear a mano. El stock del sitio vivía distinto del stock real.

Otro desarrollador ya había intentado resolverlo y no lo consiguió.

El obstáculo

La API de la plataforma de e-commerce existía y estaba documentada. El ERP era el problema.

El soporte del fabricante del ERP no colaboró. La documentación que recibimos no correspondía al sistema instalado. Después de semanas sin ningún avance por ese camino, quedó claro que la integración no iba a salir de ahí.

Quedaba una alternativa: entender el sistema por dentro.

El giro

Con autorización del cliente, iniciamos el mapeo completo de la base de datos SQL Server del ERP — sobre la base de la propia empresa, en su ambiente.

Eran cientos de tablas. Algunas con más de 150 campos. Ningún diccionario de datos, ninguna referencia confiable.

El método fue artesanal y obstinado: días enteros al lado de un empleado de la empresa, ejecutando ventas y asientos de prueba mientras observábamos, registro a registro, lo que el sistema grababa. Así se identificaron las tablas de productos, grilla, sucursales, ventas, ítems de venta, financiero, movimientos de stock y los controles internos de secuenciales — además de las relaciones y claves foráneas que unían todo eso.

Al final teníamos lo que el fabricante no entregó: el modelo de datos del ERP, documentado.

Lo que se construyó

Integrador de Pedidos. Captura los pedidos del sitio vía API — incluyendo grilla de talle y color, personalizaciones, datos del cliente y formas de pago — y los inserta directamente en la base del ERP. El pedido aparece en la pantalla del sistema listo para facturar y despachar. El registro del cliente llega completo; si ya existe, se actualiza automáticamente.

Detalle del negocio: Mundo do Futebol trabaja con personalización — el cliente paga una tasa adicional y recibe la camiseta de su equipo con su propio nombre. Ese dato necesita atravesar toda la cadena intacto, del carrito hasta la producción.

Monitor de Stock. Lee el stock en el ERP y lo actualiza en el sitio, para miles de productos, en dos modos complementarios: el modo incremental procesa solo los productos con movimiento reciente, manteniendo el sitio cerca del tiempo real a lo largo del día; el modo completo recorre toda la base, registrando en una tabla auxiliar la fila de productos a actualizar — si hay cualquier interrupción, el proceso sabe exactamente dónde quedó y retoma desde ahí.

En ambos modos se respeta la grilla de talle y color. Y cuando el monitor detecta un producto que todavía no existe en el sitio, crea automáticamente el esqueleto del registro — al responsable le queda solo completar fotos y descripción.

El problema que casi lo hizo inviable

La API de la plataforma tenía límite de solicitudes por hora. Superado el tope, el acceso quedaba bloqueado.

Sin tratamiento, eso significaría tareas interrumpidas por la mitad, actualizaciones inconsistentes y una solución en la que nadie confiaría.

La respuesta fue arquitectónica: todo el paquete — Integrador y Monitor — se construyó sobre ciclos de tiempo controlados. Cuando la API bloquea, cuando se cae internet o cuando el servidor sale del aire, el sistema no falla: espera, vuelve a intentar en cada intervalo y se recupera solo apenas el ambiente vuelve, retomando desde el punto exacto.

Esto se diseñó en 2010, mucho antes de que existiera cualquier herramienta de IA.

La prueba real: quince años de cambios

Una integración bien construida se mide por lo que soporta.

  1. 2010

    Primera generación. Tienda virtual en plataforma de e-commerce con API, integrada al ERP del cliente, en SQL Server. Desarrollo en C#.

  2. 2011

    El cliente reemplazó la plataforma por un sitio propio con base MySQL. Integrador y Monitor de Stock reconstruidos para la nueva arquitectura.

  3. 2015

    Actualización de gran porte del ERP a una nueva versión principal, con cambios estructurales profundos en la base de datos. Nueva generación de sistemas desarrollada.

  4. 2024

    Vuelta a la plataforma Fast Commerce. Cuarta generación de la integración, adaptada a la API actual.

Resultado

Desde 2010, Mundo do Futebol nunca volvió a tipear un pedido.

Cuatro plataformas, dos versiones de ERP, dos bases de datos distintas, quince años de operación continua — y el mismo socio técnico desde el primer día hasta hoy.

¿Tiene un escenario parecido? Conversemos.

Hablar con Expert

Integraciones