Registrar Evidencia

Registrar Evidencia

POST /cl/consent_manager/register_evidence

Agrega una o más piezas de evidencia a un tratamiento existente (EVIDENCE_RECEIVED). Es aditivo: no cambia el estado principal del tratamiento. Puede agregarse a un tratamiento ACTIVE, REVOKED, EXPIRED o TERMINATED; se rechaza sobre uno INVALIDATED.

URL de producción: https://api.floid.app/cl/consent_manager/register_evidence
URL de sandbox: https://sandbox.floid.app/cl/consent_manager/register_evidence

Headers requeridos

Authorization: Bearer {{TOKEN}}
Content-Type: application/json

Parámetros del body

Campo	Tipo	Requerido	Descripción
`processing_id`	string (UUID)	Sí	Tratamiento al que se agrega la evidencia.
`occurred_at`	string (ISO 8601)	Sí	Momento real de recepción de la evidencia. No puede ser anterior al inicio del tratamiento.
`evidence`	array	Sí	Al menos una pieza (ver tabla).
`operational_code`	string	No	Código operacional.
`metadata`	object	No	Metadatos libres.
`duplicate_protection_key`	string	No	Idempotencia por tenant.

`evidence[]`

Campo	Tipo	Requerido	Descripción
`format`	string	Sí	Formato permitido por la Activity (`PDF_A`, `MP3`, `JSON`).
`external_reference`	string	Condicional	URL válida cuando la custodia es `EXTERNAL_URL_ONLY`.
`hash`	string	Condicional	Obligatorio en REDEC.
`custody`	string	No	Se valida contra la política de la Activity.

Ejemplo

curl --location 'https://api.floid.app/cl/consent_manager/register_evidence' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{TOKEN}}' \
  --data '{
    "processing_id": "550e8400-e29b-41d4-a716-446655440000",
    "occurred_at": "2026-09-12T09:00:00.000Z",
    "evidence": [
      { "format": "PDF_A", "external_reference": "https://institution.example/evidence/extra-001.pdf", "hash": "sha256-extra" }
    ],
    "operational_code": "evi-op-12"
  }'

Respuesta exitosa (200)

No cambia el estado principal; expone el eje de evidencia resultante y las piezas agregadas por este evento.

{
  "code": 200,
  "message": "Evidence received",
  "caseid": "b3f1c2a4-9e77-4c31-8a10-2f6d5e7a1b90",
  "data": {
    "data_processing_id": "550e8400-e29b-41d4-a716-446655440000",
    "data_processing_event_id": "c3d4e5f6-7788-4a99-8b00-11cc22dd33ee",
    "event_type": "EVIDENCE_RECEIVED",
    "occurred_at": "2026-09-12T09:00:00.000Z",
    "received_at": "2026-09-12T09:00:02.000Z",
    "data_processing_status": "ACTIVE",
    "evidence_status": "RECEIVED",
    "evidence_due_at": null,
    "evidence_added": [
      {
        "evidence_id": "ev_9a8b7c6d",
        "data_processing_id": "550e8400-e29b-41d4-a716-446655440000",
        "source_event_id": "c3d4e5f6-7788-4a99-8b00-11cc22dd33ee",
        "source_event_type": "EVIDENCE_RECEIVED",
        "received_at": "2026-09-12T09:00:02.000Z",
        "format": "PDF_A",
        "custody": "EXTERNAL_URL_ONLY",
        "external_reference": "https://institution.example/evidence/extra-001.pdf",
        "hash": "sha256-extra"
      }
    ],
    "replayed": false
  }
}

Estructura de `data`

Campo	Tipo	Descripción
`data_processing_id`	string	UUID del tratamiento.
`data_processing_event_id`	string	UUID del evento `EVIDENCE_RECEIVED`.
`event_type`	string	Siempre `EVIDENCE_RECEIVED`.
`occurred_at`	string (ISO 8601)	Momento de la evidencia.
`received_at`	string (ISO 8601)	Momento de recepción por Floid.
`data_processing_status`	string	Estado principal del tratamiento (no cambia por este evento).
`evidence_status`	string	Estado del eje: `NOT_REQUIRED`, `PENDING`, `RECEIVED`, `OVERDUE`.
`evidence_due_at`	string (ISO 8601)	Vencimiento de evidencia diferida (`null` si no aplica).
`evidence_added`	array	Piezas incorporadas por este evento (ver tabla).
`replayed`	boolean	`true` si el request fue una reproducción idempotente.

`evidence_added[]`

Campo	Tipo	Descripción
`evidence_id`	string	Identificador público de la pieza.
`data_processing_id`	string	UUID del tratamiento.
`source_event_id`	string	Evento que aportó la pieza.
`source_event_type`	string	Siempre `EVIDENCE_RECEIVED`.
`received_at`	string (ISO 8601)	Momento de recepción.
`format`	string	Formato de la pieza.
`custody`	string	Custodia aplicada.
`external_reference`	string	URL/referencia de la evidencia.
`hash`	string	Hash declarado.

Errores

HTTP	`error_code`	Cuándo
400	`DATA_PROCESSING_ID_REQUIRED`	Falta `processing_id`.
400	`OCCURRED_AT_REQUIRED` / `OCCURRED_AT_INVALID`	`occurred_at` ausente o inválido.
400	`EVIDENCE_REQUIRED`	No se envió ninguna pieza.
400	`EVIDENCE_FORMAT_NOT_ALLOWED` / `EVIDENCE_CUSTODY_MISMATCH` / `EVIDENCE_HASH_REQUIRED`	Pieza inválida para la política de la Activity.
400	`EVIDENCE_BEFORE_ORIGIN`	`occurred_at` anterior al inicio del tratamiento.
404	`PROCESSING_NOT_FOUND`	El tratamiento no existe o no pertenece a tu cliente.
409	`DATA_PROCESSING_INVALIDATED`	El tratamiento está invalidado.
500	`INTERNAL_ERROR`	Error inesperado del servidor.

Updated about 10 hours ago