Cómo plantear correctamente una integración entre dos sistemas (antes de hablar con nadie)

Por qué las integraciones se tuercen en el planteamiento

Cuando una integración fracasa, casi nunca es porque “el código estaba mal”. Suele ser porque nadie definió qué sistema tenía razón sobre un dato, porque a mitad de proyecto apareció que el ERP no exponía las tarifas o porque “tiempo real” significaba cosas distintas para cada uno. Todo eso se resuelve gratis en el planteamiento y sale carísimo en producción.

Las cuatro preguntas de negocio

1. ¿Qué datos, exactamente?

Decir «conectar el ERP con la web» no basta; hay que decir qué datos. Productos, precios, tarifas especiales, stock, clientes, pedidos, facturas, estados… Haz la lista concreta. Cada dato que añades tiene coste, y cada dato que olvidas cuesta más.

2. ¿En qué sentido viaja cada uno?

Para cada dato de la lista, decide si va del sistema A al B, del B al A o en ambos sentidos. Sospecha de los “ambos”. Los flujos bidireccionales auténticos son raros, y casi siempre resultan ser dos flujos de ida bien definidos (aquí el detalle para el caso ERP⇄ecommerce).

3. ¿Cómo de frescos?

¿El dato puede tener una hora de retraso? ¿Un día? ¿Ni un segundo? Cada nivel de frescura tiene un coste distinto y no todo necesita tiempo real. Decidirlo dato a dato es una de las mayores palancas de ahorro del proyecto.

4. ¿Quién manda cuando discrepen?

Discreparán. Para cada dato, un único sistema es la fuente de verdad y el otro obedece. Dejarlo por escrito evita el bucle en el que cada sistema machaca al otro, que es de los errores más caros de detectar tarde.

La pregunta técnica: qué expone cada sistema

Inventaría los mecanismos que tiene cada sistema. Si hay API, qué cubre campo a campo; si hay acceso a base de datos; si hay ficheros de importación y exportación validados. No te fíes de “tiene API” en la ficha comercial, porque muchas APIs cubren la mitad de lo que necesitas y descubrirlo a mitad de proyecto cambia el presupuesto. Si no sabes responder a esto, pídeselo por escrito a los proveedores de tus sistemas. Es una pregunta que están obligados a saber contestar.

Lo que una propuesta de integración seria debe incluir

Con tu planteamiento hecho, evalúa lo que te propongan con esta lista:

1. Los flujos, uno a uno, con su sentido, su frescura y su fuente de verdad. Si la propuesta habla de “conectar los sistemas” en genérico, está estimando a ciegas.
2. Qué pasa cuando algo falle. Validación antes de aplicar, registros problemáticos apartados sin tumbar el resto, log de cada ejecución y avisos concretos. Una integración sin plan de fallo es un script con suerte.
3. Fases. El flujo que más duele va primero y llega pronto a producción; el resto se monta sobre esa base. Desconfía del “todo conectado en una entrega”.
4. Comportamiento ante repeticiones. Si una sincronización se relanza, no puede duplicar pedidos ni clientes. Pregúntalo con esas palabras; la respuesta te dirá mucho.
5. Respeto a la operación diaria. Las cargas pesadas, fuera de horario, porque tu ERP tiene usuarios trabajando en él.
6. Propiedad y salida. ¿De quién es la integración? ¿Está documentada? ¿Podría mantenerla otro? (Nuestra respuesta: tuya, documentada y sin peajes.)

Errores de planteamiento que vemos repetirse

• Empezar por la herramienta («¿integramos con Zapier o a medida?») antes que por los flujos. La herramienta es la última decisión, no la primera.
• Plantearlo como proyecto técnico sin sentar a la persona que sufre el proceso, que es quien sabe qué discrepancias existen.
• No presupuestar los datos sucios. Los datos reales son imperfectos. La integración debe apartarlos y avisar, y ese trabajo hay que contarlo desde el día uno.
• El silencio como estado normal. Si nadie mira la integración, que avise ella sola. Lo que falla en silencio envejece los datos de toda la empresa.

Tu checklist antes de pedir presupuesto

1. Lista de datos concretos que deben viajar.
2. Sentido de cada flujo (desconfía de los bidireccionales).
3. Frescura necesaria, dato a dato.
4. Fuente de verdad de cada dato, por escrito.
5. Inventario de lo que expone cada sistema (pedido a sus proveedores si hace falta).
6. El flujo que más duele, señalado, porque por ahí se empieza.

Con esto respondido, la conversación con cualquier proveedor se vuelve corta y comparable. Y si prefieres hacer el planteamiento con nosotros, para eso está nuestro análisis con alcance y entregable cerrados.