Actividades de tratamiento

El registro de actividades de tratamiento (RAT) es el inventario legal de todo lo que el colegio hace con datos personales. Cada actividad (processing_activity) describe una finalidad; su contenido vive en versiones selladas (processing_activity_versions), y sobre las actividades de alto riesgo se levantan evaluaciones de impacto (dpia_assessments, EIPD, Art. 15 ter). Por API puedes leer todo el registro y escribir el RAT; la autoría de EIPD es de consola.

La misma superficie para integradores partner está en Actividades de tratamiento (Partner API); el registro de riesgos asociado, en Riesgos.

El modelo de versionado

Una actividad publica su contenido en versiones inmutables y monotónicas:

• versionNumber crece de a uno; la actividad apunta a la vigente con currentVersionNumber.
• Cada versión queda sellada con noticeChecksum — SHA-256 sobre el contenido normativo (finalidad, aviso en lenguaje claro, base legal, modelo de consentimiento y sus opciones, resúmenes de retención/transferencia/automatización). Si el texto cambia, cambia el checksum: es la prueba de qué vio el apoderado.
• Publicar una versión nueva puede invalidar los consentimientos anteriores (invalidatesPreviousConsents): las solicitudes pending/granted de versiones previas pasan a invalidated y se dispara la recaptura. La respuesta te entrega los ids afectados.
• Lo que no envíes en la versión nueva (dataCategories, recipients, consentOptions) se arrastra desde la versión anterior; lo que envíes la reemplaza.
• Publicar cuenta como revisión: fija lastReviewedAt, calcula el próximo reviewDueAt y reabre las EIPD aprobadas de la actividad.

Listar actividades

curl -G "https://app.edugoverna.com/api/processing-activities" \
  -H "x-api-key: {tu_api_key}" \
  -d limit=25

{
  "processingActivities": [
    {
      "id": "a2f1…",
      "code": "ACT-004",
      "name": "Comunicaciones académicas",
      "status": "active",
      "lawfulBasis": "consent",
      "consentRequired": true,
      "involvesSensitiveData": false,
      "involvesMinorData": true,
      "riskLevel": "medium",
      "isHighRisk": false,
      "currentVersionNumber": 2,
      "currentVersion": {
        "versionNumber": 2,
        "versionStatus": "published",
        "title": "v2 · salidas pedagógicas",
        "purposeSummary": "Informar y coordinar actividades académicas…",
        "consentModel": "bundled",
        "noticeChecksum": "9b1e…",
        "publishedAt": "2026-07-30T14:00:00.000Z"
      },
      "retentionPolicy": null,
      "dpiaAssessmentCount": 0,
      "reviewDueAt": "2027-07-30T14:00:00.000Z"
    }
  ],
  "meta": {
    "totalMatchedCount": 9,
    "limit": 25,
    "returnedCount": 9,
    "nextCursor": null,
    "hasMore": false
  }
}

El detalle (GET /processing-activities/:processingActivityId) agrega el historial versions[] (con consentRequestCount por versión), los consentRequestCounts de la actividad —el radio de impacto de la próxima publicación invalidante— y expande currentVersion con sus dataCategories[] y recipients[].

Publicar una versión nueva

curl -X POST "https://app.edugoverna.com/api/processing-activities/a2f1…/versions" \
  -H "x-api-key: {tu_api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "v3 · incluye fotografías",
    "purposeSummary": "Comunicaciones académicas y registro fotográfico de actividades.",
    "invalidatesPreviousConsents": true
  }'

{
  "activity": {
    "id": "a2f1…",
    "currentVersionNumber": 3,
    "currentVersion": {
      "versionNumber": 3,
      "versionStatus": "published",
      "noticeChecksum": "c7a2…"
    }
  },
  "invalidatedConsentRequestIds": ["b9d2…", "b9d3…"]
}

Las demás rutas del RAT

Evaluaciones de impacto (EIPD)

curl -G "https://app.edugoverna.com/api/dpia/screening" \
  -H "x-api-key: {tu_api_key}" \
  -d processingActivityId=a2f1…

{
  "activity": { "id": "a2f1…", "name": "Videovigilancia patios", "code": "ACT-011" },
  "screening": {
    "level": "required",
    "letters": ["c"],
    "factors": ["declared_high_risk"],
    "reasons": ["La actividad declara observación sistemática…"]
  },
  "letters": [
    {
      "letter": "c",
      "legalText": "…",
      "schoolMeaning": "Cámaras u observación sistemática de espacios…",
      "reason": "…"
    }
  ],
  "existingAssessmentId": null,
  "suggestedTemplates": [
    { "key": "cctv", "name": "Videovigilancia escolar", "whenToUse": "…" }
  ]
}

Rutas de EIPD

Los escenarios de una EIPD comparten catálogo de medidas y matriz con el registro de riesgos.