Sistemas Conectados — Destinations y Servicios

Consolida, desde el ángulo del equipo técnico, cómo se conecta la suite con sistemas externos para ejecutar derechos ARSO automáticamente. No duplica Módulo Sistemas Conectados — resume la arquitectura técnica para quien necesita integrar un sistema nuevo.

---

Los 3 niveles de la integración técnica

Sistema Conectado (registro lógico del sistema externo)
    │
    └── Destination (endpoint técnico + autenticación)
            │
            └── Servicio / Operación HTTP (acción concreta por derecho ARSO)

1. Destination

Endpoint técnico configurado dentro de un Sistema Conectado. Define la URL y el tipo de conexión a través del cual la suite se comunica con el sistema externo (definición confirmada en Glosario PDP Suite).

Tipos de conexión soportados:

Tipo	Uso típico
HTTP	APIs REST, servicios web, endpoints cloud
RFC	Sistemas SAP on-premise o cloud
MAIL	Sistemas que reciben solicitudes por email
LDAP	Directorios corporativos, Active Directory
TCP	Conexiones de bajo nivel a sistemas legados

Un sistema puede tener múltiples Destinations. La autenticación se configura por Destination, con gestión de versiones propia para rotar credenciales sin interrumpir integraciones activas — este versionado es de seguridad técnica, no de trazabilidad legal (ver Versionado y trazabilidad (proceso transversal), mecanismo #3).

---

2. Servicio / Operación HTTP

La operación concreta que la Bandeja ARSO ejecuta contra el sistema para cumplir un derecho específico. Se crea mediante el wizard “Crear operación desde cURL”: se pega un comando cURL real del endpoint, el sistema lo analiza y extrae automáticamente método HTTP, ruta y origen.

Configuración mínima de una operación:

1. Destination a usar.
2. Derecho asociado (Acceso, Rectificación, Supresión, Bloqueo, Oposición, Portabilidad).
3. Parámetros de envío, con uno marcado explícitamente como “Llave” — el identificador del titular (normalmente RUT o correo).
4. Mapeo de respuesta — cómo se interpreta lo que devuelve el endpoint.

Regla técnica más importante de todo este módulo: sin el parámetro marcado como “Llave”, el sistema no sabe a qué titular aplicar el derecho. Es el error de configuración más frecuente y de mayor impacto.

---

Historial de peticiones (auditoría técnica)

Cada llamada ejecutada por la Bandeja ARSO contra un servicio queda registrada con: fecha/hora, derecho ejecutado, método HTTP, código de respuesta, duración, y payload/respuesta truncados (no expone datos personales completos, solo para diagnóstico técnico rápido).

---

Checklist para integrar un sistema nuevo

1. Crear el Sistema Conectado (Nombre, Descripción).
2. Crear al menos una Destination (URL, Tipo de conexión, Autenticación).
3. Por cada derecho ARSO que el sistema deba ejecutar: crear una operación HTTP desde cURL, marcar el parámetro Llave, configurar el mapeo de respuesta.
4. Vincular el sistema a un Propósito de Negocio (Módulo Propósitos de Negocio).
5. Vincular cada operación al derecho correspondiente en el Propósito (Pestaña “Vincular servicios ARSO · RUL”).
6. Probar ejecutando una solicitud real y revisando el Historial de peticiones.

---