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.
- 2010
Primera generación. Tienda virtual en plataforma de e-commerce con API, integrada al ERP del cliente, en SQL Server. Desarrollo en C#.
- 2011
El cliente reemplazó la plataforma por un sitio propio con base MySQL. Integrador y Monitor de Stock reconstruidos para la nueva arquitectura.
- 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.
- 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