Interoperabilidad entre entidades públicas: lecciones de diseño

Integrar sistemas de distintas entidades del Estado suena, en el papel, a un problema puramente técnico: exponer un servicio, consumir otro, mapear campos. En la práctica, la parte técnica suele ser la más sencilla. Estas son algunas lecciones que se repiten proyecto tras proyecto.

Los contratos cambian más de lo que se documenta

Cada entidad tiene su propio ritmo de despliegue y su propia definición de “esto ya no debería cambiar”. Diseñar los mapeos de datos asumiendo que el contrato de la fuente externa va a cambiar sin aviso —con validaciones defensivas y valores por defecto explícitos— ahorra incidentes que de otra forma se descubren en producción.

La disponibilidad no es uniforme

No todas las fuentes de información tienen el mismo SLA. Un flujo de interoperabilidad diseñado para depender de la disponibilidad simultánea de tres o cuatro sistemas externos es, en la práctica, tan disponible como el más frágil de ellos. Colas de reintento y procesamiento asíncrono no son un lujo aquí: son la diferencia entre un proceso que se recupera solo y uno que exige intervención manual cada semana.

El identificador único casi nunca es tan único

DNI, RUC o códigos internos deberían ser suficientes para cruzar información entre sistemas, pero en la realidad aparecen duplicados, formatos inconsistentes o registros históricos con datos incompletos. Vale la pena invertir tiempo en una capa de normalización y reglas de conciliación antes de asumir que un cruce de datos “simplemente funciona”.

La documentación es parte del entregable, no un anexo

Cuando el consumidor de tu servicio es otro equipo, de otra entidad, con sus propios plazos, un endpoint sin documentación clara de campos, códigos de error y casos límite genera más retrabajo que el que ahorra publicarlo rápido.

Automatizar procesos masivos también significa poder auditarlos

Generar de forma masiva registros o informes a partir de datos de múltiples fuentes exige poder responder, meses después, “¿por qué este registro salió así?”. Guardar trazabilidad del origen de cada dato usado —no solo el resultado final— es lo que hace posible auditar y corregir sin reprocesar todo desde cero.

Ninguna de estas lecciones es exclusiva del sector público, pero ahí se sienten con más fuerza: los sistemas son de alcance nacional, los datos afectan a personas reales, y el margen de error es mucho más pequeño que en un proyecto interno.