Crear Consentimiento

POST /cl/consent_manager/create_consent

Registra un nuevo consentimiento de consulta de información comercial o crediticia según normativa RDC30.

URL Completa: https://api.floid.app/cl/consent_manager/create_consent

Headers Requeridos

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

Parámetros de Entrada

Campo	Tipo	Requerido	Descripción
`person_rut`	string	Sí	RUT de la persona que otorga el consentimiento (formato: 12345678-9)
`codigo_institucion`	string	Sí	Código de 9 dígitos de la institución solicitante (formato: 001234567)
`finalidad`	integer	Sí	Finalidad del consentimiento: `1` = Riesgo comercial, `2` = Riesgo crediticio
`objetivo`	string	Sí	Código de objetivo de consulta (formato: "01" a "07")
`medio`	integer	Sí	Medio de obtención: `1` = Electrónico, `2` = Verbal, `3` = Escrito
`person_email`	string	Sí	Email de la persona
`person_cellphone`	string	No	Teléfono celular (formato: +56912345678)
`person_name`	string	No	Nombre completo de la persona
`rut_empresa`	string	No	RUT de la empresa relacionada (formato: 12345678-9)
`rut_ejecutivo`	string	Si	RUT del ejecutivo que gestiona el consentimiento (formato: 12345678-9)
`custom_id`	string	No	ID externo único para referencia (alfanumérico, guiones, guiones bajos, max 100)
`metadata_json`	string	No	JSON string con metadata adicional (ej: fingerprint del navegador)
`origen_batch`	boolean	No	Indica si el consentimiento proviene de carga masiva

Ejemplo de Solicitud

curl --location 'https://api.floid.app/cl/consent_manager/create_consent' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{TOKEN}}' \
--data '{
  "caseId": "CASE-2026-001",
  "person_rut": "12345678-9",
  "person_email": "[email protected]",
  "person_name": "Juan Pérez González",
  "codigo_institucion": "001234567",
  "finalidad": 2,
  "objetivo": "02",
  "medio": 1,
  "rut_empresa": "76123456-7",
  "custom_id": "CONSENT-2026-001"
}'

Respuesta Exitosa (200)

{
  "code": "200",
  "msg": "OK",
  "caseid": "CASE-2026-001",
  "data": {
    "consent_id": 123,
    "consent_token": "a9a628a1-b4ac-4ab2-b4d0-954f91239d60",
    "custom_id": "CONSENT-2026-001",
    "codigo_interno": "C2601121752588870878",
    "timestamp_otorgamiento": "20260112 175258",
    "timestamp_expiracion": "20270112 175258",
    "estado": "ACTIVE",
    "origen": "API",
    "ip_captured": "172.19.0.7",
    "file_uploaded": false
  }
}

Posibles Errores

Error Code	HTTP	Descripción
`INVALID_REQUEST`	400	Falta campo obligatorio (person_rut, caseId, etc)
`RUT_NO_VALIDO`	400	RUT no tiene formato válido
`INVALID_REQUEST`	400	Código institución debe ser 9 dígitos
`INVALID_REQUEST`	400	Finalidad debe ser 1 o 2
`INVALID_REQUEST`	400	Medio debe ser 1, 2 o 3
`INVALID_REQUEST`	400	Objetivo debe estar entre 01 y 07
`INVALID_REQUEST`	400	Custom ID duplicado
`INTERNAL_ERROR`	400	Error de conexión a base de datos
`RUT_NO_VALIDO`	400	RUT no válido (persona, empresa o ejecutivo)
`DUPLICATE_ID`	400	Custom ID ya existe
`INVALID_FILE_TYPE`	400	Tipo de archivo no permitido para el medio especificado
`FILE_TOO_LARGE`	400	Archivo supera 8MB