Ir al contenido principal

WAU

La integración que parecía simple y tomó tres meses

En la primera reunión, la conclusión parecía evidente:

—La integración es sencilla. Solo debemos consumir el servicio, enviar la transacción y recibir una respuesta.

En el diagrama había dos sistemas, una flecha entre ambos y un pequeño cuadro que decía: API.

El cálculo inicial fue de pocas semanas.

Había documentación técnica, ambientes de prueba y equipos con experiencia. No se necesitaba construir un nuevo producto ni reemplazar el sistema central. Se trataba, aparentemente, de conectar una plataforma digital con un sistema bancario existente para ejecutar una operación financiera.

Tres meses después, la integración finalmente entró en producción.

No porque el equipo no tuviera capacidad técnica.

No porque la tecnología fuera inadecuada.

Y tampoco porque existiera un único problema extraordinariamente complejo.

El proyecto tomó tres meses porque aquello que parecía una conexión entre dos sistemas era, en realidad, una conexión entre procesos, reglas de negocio, áreas operativas, controles de seguridad, proveedores, redes y distintas interpretaciones de cómo debía funcionar una transacción bancaria.

En WAU hemos participado en distintos proyectos de integración tecnológica, especialmente dentro del sector financiero. Esta experiencia nos ha enseñado que las integraciones que parecen más sencillas en una presentación suelen ser las que esconden más supuestos.

Este proyecto fue uno de esos casos.

El primer error: pensar que integrar era solamente enviar datos

Durante las primeras sesiones, el análisis se concentró en la estructura del mensaje.

¿Qué campos debía llevar la solicitud?

¿Qué formato tenía la respuesta?

¿Cuál era el mecanismo de autenticación?

¿Cómo se manejaban los códigos de error?

Desde el punto de vista técnico, todo parecía razonable. Sin embargo, pronto descubrimos que el verdadero flujo no comenzaba cuando un sistema enviaba una solicitud ni terminaba cuando recibía una respuesta.

Antes de ejecutar una transacción, el sistema debía validar límites, estado de la cuenta, disponibilidad de fondos, restricciones del producto, horarios operativos y permisos del usuario.

Después de ejecutarla, debía registrar auditoría, generar notificaciones, actualizar saldos, alimentar procesos contables y dejar información disponible para conciliación.

La API representaba solamente una parte del proceso.

El error fue estimar la integración observando el contrato técnico, sin mapear primero el ciclo completo de la transacción.

En WAU aprendimos que una API puede documentar correctamente cómo intercambiar información, pero no necesariamente explica cómo funciona el negocio alrededor de esa información.

La documentación decía una cosa y el sistema hacía otra

El equipo comenzó el desarrollo utilizando la documentación disponible.

Las primeras llamadas funcionaron.

Después aparecieron las excepciones.

Un campo descrito como opcional era obligatorio para determinados productos.

Un código de respuesta podía significar dos situaciones distintas.

Algunas operaciones respondían correctamente, pero quedaban pendientes en procesos internos.

Otras devolvían un error técnico aunque la transacción sí había sido procesada.

También encontramos diferencias entre el ambiente de pruebas y el ambiente productivo. Las versiones no eran exactamente iguales, los catálogos tenían configuraciones diferentes y algunas validaciones solo existían en producción.

La documentación no estaba necesariamente equivocada.

Simplemente no contenía todo el conocimiento operativo que se había acumulado alrededor del sistema durante años.

Parte de ese conocimiento estaba en procedimientos internos.

Otra parte estaba en configuraciones.

Y una parte importante vivía únicamente en la experiencia de ciertas personas.

Este es un riesgo frecuente cuando se trabaja con sistemas bancarios que han evolucionado durante años. El comportamiento real no siempre se encuentra en un único documento. Está distribuido entre código, parametrizaciones, manuales, procesos operativos y conocimiento humano.

La integración funcionaba, pero la transacción no siempre terminaba

Uno de los momentos más difíciles ocurrió cuando comenzamos a ejecutar pruebas de punta a punta.

Desde el sistema de origen, la solicitud se enviaba correctamente.

Desde el sistema receptor, la transacción aparecía procesada.

Pero en algunos casos el sistema de origen no recibía la confirmación.

¿Debía reenviar la solicitud?

Si la reenviaba, podía duplicar la operación.

Si no la reenviaba, podía dejar al cliente sin respuesta.

Aquí apareció uno de los riesgos más importantes de cualquier integración financiera: la incertidumbre sobre el estado final de la transacción.

En sistemas bancarios no basta con saber que se envió una solicitud. Es necesario poder determinar, con certeza, si la operación:

  • no llegó al sistema receptor;
  • llegó, pero no fue procesada;
  • fue procesada, pero no se recibió la respuesta;
  • quedó pendiente;
  • fue reversada;
  • o fue completada y contabilizada correctamente.

El problema no era únicamente técnico. Tenía implicaciones financieras, operativas y de experiencia del cliente.

Fue necesario incorporar identificadores únicos, controles de idempotencia, consultas de estado, políticas de reintento y procesos de reverso.

Nada de eso estaba claramente incluido en el alcance inicial.

Para el equipo de WAU, este fue uno de los aprendizajes más importantes del proyecto: una integración financiera no debe diseñarse solamente para procesar transacciones exitosas. Debe diseñarse, sobre todo, para administrar la incertidumbre cuando algo falla.

Los ambientes de prueba no representaban la realidad

Otro supuesto fue creer que el ambiente de pruebas sería suficiente para validar el comportamiento completo.

No lo fue.

Los volúmenes eran menores.

Los datos estaban controlados.

Las cuentas utilizadas no tenían todas las restricciones de los productos reales.

No existían ventanas operativas iguales a las de producción.

Tampoco se simulaban adecuadamente las interrupciones, los retrasos de red, los tiempos de espera ni los procesos nocturnos.

La integración funcionaba bien cuando todo estaba disponible.

Pero los sistemas bancarios deben funcionar también cuando una dependencia tarda demasiado, cuando una respuesta no llega o cuando un componente se encuentra temporalmente fuera de servicio.

La prueba más importante no era comprobar si el flujo exitoso funcionaba.

Era comprobar qué ocurría cuando algo fallaba.

Actualmente, en WAU buscamos que las pruebas de integración no se limiten al llamado “camino feliz”. Incluimos desde etapas tempranas escenarios de indisponibilidad, duplicidad, respuestas tardías, reversos y diferencias entre sistemas.

Seguridad también formaba parte del cronograma

Al inicio se asumió que la seguridad consistiría en intercambiar certificados y configurar credenciales.

En la práctica, fue necesario coordinar listas de acceso, reglas de firewall, cifrado, renovación de certificados, bóvedas de secretos, trazabilidad, segregación de funciones y permisos entre distintos ambientes.

Cada cambio requería validaciones de varias áreas.

Una configuración podía estar correcta en un extremo y bloqueada en otro.

Un certificado podía ser válido, pero no tener toda la cadena de confianza.

Una dirección podía estar autorizada para pruebas, pero no para producción.

También fue necesario revisar qué información sensible podía registrarse en los logs. Los registros eran indispensables para investigar problemas, pero no podían exponer números de cuenta, credenciales ni datos personales.

La seguridad no era una tarea que se agregaba al final.

Era una línea de trabajo completa dentro del proyecto.

Este tipo de experiencias también nos ha llevado en WAU a involucrar desde el inicio a los equipos de infraestructura, seguridad y operaciones. Incorporarlos únicamente cuando el desarrollo está terminado suele generar retrasos, rediseños y riesgos que pudieron detectarse mucho antes.

Las reglas de negocio estaban distribuidas

Uno de los mayores aprendizajes fue descubrir que ninguna persona conocía por sí sola el flujo completo.

El equipo técnico conocía la interfaz.

El área de negocio conocía las reglas del producto.

Operaciones conocía las excepciones.

Seguridad conocía las restricciones de acceso.

Contabilidad conocía la forma correcta de registrar la transacción.

El proveedor conocía el comportamiento interno de su plataforma.

Y servicio al cliente sabía qué problemas ocurrían en la operación diaria.

Cada área tenía una parte de la verdad.

El proyecto avanzó realmente cuando dejamos de preguntar solamente:

“¿Cómo funciona la API?”

Y comenzamos a preguntar:

“¿Qué debe ocurrir desde que el cliente inicia la operación hasta que todas las áreas pueden confirmar que terminó correctamente?”

A partir de este y otros proyectos, en WAU hemos reforzado la importancia de trabajar las integraciones como procesos de punta a punta y no como tareas aisladas de desarrollo.

Una integración puede estar técnicamente terminada y, aun así, no estar preparada para operar.

La conciliación llegó tarde a la conversación

Durante las primeras semanas, el objetivo principal era lograr que la transacción se ejecutara.

Más adelante surgió una pregunta sencilla:

¿Cómo comprobaremos al final del día que ambos sistemas tienen la misma información?

Ese punto cambió el proyecto.

Una integración financiera no termina cuando una operación responde exitosamente. Debe existir la capacidad de comparar registros, identificar diferencias y resolverlas.

Tuvimos que definir:

  • cuál sistema era la fuente oficial para cada dato;
  • qué campos se utilizarían para relacionar operaciones;
  • cómo se identificarían duplicados;
  • qué ocurriría con las transacciones pendientes;
  • quién investigaría las diferencias;
  • y cómo se corregirían sin afectar la trazabilidad.

Sin conciliación, una integración puede parecer exitosa durante el día y generar diferencias financieras al cierre.

Hoy, cuando en WAU analizamos una integración transaccional, la conciliación ya no se trata como una actividad posterior. Se considera parte del diseño inicial.

La pregunta no es solamente cómo mover una transacción entre dos plataformas.

También debemos responder cómo demostrar que esa transacción quedó correctamente registrada en todas las partes involucradas.

El problema más difícil no fue tecnológico

A medida que el proyecto avanzaba, también aparecieron los problemas de coordinación.

Los equipos trabajaban con prioridades distintas.

Algunas dependencias pertenecían a terceros.

Las ventanas de cambio eran limitadas.

Las pruebas requerían la participación simultánea de varias áreas.

Cuando ocurría un error, no siempre era claro quién debía investigarlo primero.

Cada grupo analizaba únicamente su componente y confirmaba que estaba funcionando.

El problema, sin embargo, existía en el espacio entre los componentes.

En una integración compleja, es posible que cada sistema funcione correctamente de manera individual y que el proceso completo falle.

Por eso, la responsabilidad no puede dividirse únicamente por aplicaciones. Debe existir un responsable del flujo de punta a punta.

Este fue también un aprendizaje de liderazgo.

En varios momentos, la función más importante del equipo de WAU no fue escribir código, sino reunir a las personas correctas, traducir perspectivas técnicas y operativas, ordenar las evidencias y mantener la atención sobre el flujo completo.

La tecnología resolvía una parte.

La comunicación y la colaboración resolvían el resto.

¿Qué subestimamos?

Al revisar el proyecto, encontramos que habíamos subestimado principalmente siete cosas.

1. La cantidad de reglas de negocio ocultas

Muchas reglas no estaban en la documentación técnica. Aparecieron al probar productos, clientes y situaciones diferentes.

2. El manejo de errores y estados inciertos

Diseñamos primero el camino exitoso y dejamos para después las excepciones.

3. Las diferencias entre ambientes

Asumimos que pruebas y producción tendrían configuraciones equivalentes.

4. Las dependencias organizacionales

Calculamos tiempo de desarrollo, pero no el tiempo de coordinación, aprobaciones y ventanas operativas.

5. La seguridad y el cumplimiento

Tratamos los controles de seguridad como requisitos adicionales, cuando en realidad eran parte central de la arquitectura.

6. La conciliación y la operación posterior

Nos concentramos en poner en funcionamiento la integración, sin diseñar desde el inicio cómo sería monitoreada y operada.

7. El conocimiento no documentado

Dependimos demasiado de documentos y muy poco de las personas que conocían las excepciones reales del proceso.

¿Cómo lo detectaríamos antes hoy?

Si hoy comenzáramos una integración similar en WAU, no iniciaríamos estimando a partir del documento de la API.

Comenzaríamos construyendo un mapa completo de la operación.

1. Dibujaríamos el flujo de punta a punta

Desde la acción del cliente hasta la contabilización, conciliación y resolución de excepciones.

Cada paso tendría un sistema responsable, un área responsable y un resultado esperado.

2. Crearíamos un catálogo de escenarios

No solamente el caso exitoso.

También incluiríamos:

  • tiempos de espera;
  • mensajes duplicados;
  • respuestas tardías;
  • saldos insuficientes;
  • cuentas bloqueadas;
  • límites excedidos;
  • reversos;
  • interrupciones de red;
  • cierres operativos;
  • mantenimientos;
  • y transacciones procesadas sin respuesta.

3. Validaríamos la integración con datos representativos

Los datos sintéticos son útiles, pero rara vez representan toda la diversidad de productos, configuraciones y excepciones de una operación bancaria.

Cuando fuera posible y cumpliendo los controles de privacidad, utilizaríamos datos anonimizados que reflejaran situaciones reales.

4. Probaríamos primero el manejo de fallos

Antes de celebrar que una transacción exitosa funciona, comprobaríamos que el sistema puede responder correctamente cuando una dependencia falla.

5. Definiríamos la idempotencia desde el diseño

Toda operación financiera debería poder identificar reintentos y evitar duplicidades.

6. Incluiríamos seguridad, infraestructura y operaciones desde el inicio

No como revisores al final, sino como participantes activos del diseño.

7. Diseñaríamos la conciliación antes de desarrollar

La pregunta no sería únicamente cómo enviar la transacción, sino cómo demostrar después que fue registrada correctamente en todos los sistemas.

8. Crearíamos observabilidad de punta a punta

Cada operación tendría un identificador trazable en todos los componentes.

Los tableros permitirían conocer cuántas operaciones fueron exitosas, rechazadas, pendientes o reversadas.

9. Realizaríamos una prueba temprana controlada

Una prueba técnica pequeña, bajo condiciones adecuadas, puede revelar en pocos días diferencias que un ambiente de pruebas no muestra durante semanas.

10. Agregaríamos incertidumbre al estimado

En sistemas heredados o poco documentados, no todo puede conocerse al principio.

El cronograma debe incluir tiempo para descubrir reglas, resolver dependencias y ajustar el diseño.

La verdadera lección

La integración finalmente fue exitosa.

Pero el mayor valor del proyecto no estuvo únicamente en conectar los sistemas.

Estuvo en comprender que, dentro de una entidad financiera, una integración nunca es solamente una flecha entre dos aplicaciones.

Es una cadena de decisiones, validaciones, controles y responsabilidades.

Cada sistema tiene su propia historia.

Cada proceso tiene excepciones.

Cada área observa un riesgo diferente.

Y cada transacción debe conservar consistencia, seguridad y trazabilidad, incluso cuando algo sale mal.

En WAU, esta y otras experiencias nos han ayudado a evolucionar la forma en que abordamos los proyectos de integración.

Hoy sabemos que el trabajo no empieza con el desarrollo.

Empieza con las preguntas.

¿Qué ocurre si la respuesta no llega?

¿Cómo evitamos duplicados?

¿Cómo conciliamos?

¿Qué sistema tiene la verdad?

¿Qué diferencias existen entre ambientes?

¿Quién opera las excepciones?

¿Cómo sabremos que la transacción realmente terminó?

Muchas veces, la complejidad no está oculta dentro de la tecnología.

Está oculta dentro de las preguntas que todavía no hemos hecho.

Y en proyectos de integración bancaria, detectar esas preguntas temprano puede ser la diferencia entre una integración de pocas semanas y una que toma tres meses.

En WAU seguimos aprendiendo de cada implementación, porque integrar sistemas no consiste solamente en conectar tecnología.

Consiste en conectar procesos, equipos y responsabilidades para que la experiencia completa funcione.

¿Cuál ha sido el riesgo más inesperado que has encontrado al integrar sistemas?

x
¡Hola! ¿Cómo podemos ayudarte? Haz click para escribirnos.