Saltar al contenido principal

Cómo funciona REDEC

Cómo funciona REDEC

Funcionamiento general​

El módulo REDEC de Soyio te permite cumplir con la NCG 540 de la CMF registrando todas las acciones de consentimiento asociadas a evaluaciones de riesgo crediticio y generando reportes regulatorios.

Componentes del sistema​

API de registro REDEC​

El endpoint POST /api/v1/redec/consent_actions registra acciones de consentimiento vinculadas a RUT de usuarios chilenos, cumpliendo con los requisitos específicos de la CMF.

Diferencias con consent_actions estándar:

  • Requiere entity_nin (RUT del usuario)
  • Permite executive_nin (RUT del ejecutivo)
  • Diseñado específicamente para cumplimiento regulatorio chileno
  • Se incluye automáticamente en reportes RDC30

API de reportes​

Los endpoints de reportes te permiten:

  • Crear reportes RDC30 y RDC40 con rangos de fechas específicos
  • Los reportes se generan automáticamente en formato CMF
POST /api/v1/reports
{
  "kind": "rdc30",
  "starts_at": "2026-01-01T00:00:00Z",
  "ends_at": "2026-01-31T23:59:59Z"
}

Webhooks​

El sistema envía webhooks para eventos REDEC:

  • consent_action.created - Nueva acción de consentimiento registrada
  • consent_action.redec_receipt_generated - Recibo PDF de consentimiento REDEC generado y listo para descarga
  • report.created - Nuevo reporte generado (verifica kind: "rdc30" o kind: "rdc40" en el payload)
  • redec.rdc40_no_changes - Evento informativo cuando no hubo eventos que generen entradas RDC40 en el período (ver Genera reportes RDC40)

Webhook de recibos PDF​

El webhook consent_action.redec_receipt_generated se envía cuando el recibo PDF de un consentimiento REDEC ha sido generado exitosamente y está listo para descarga:

Payload del webhook
{
  "event": "consent_action.redec_receipt_generated",
  "data": {
    "id": "consact_abc123...",
    "user_reference": "cliente_00042",
    "redec_receipt_pdf": "https://api.soyio.id/api/v1/redec/consent_actions/consact_redec_abc123.../download_receipt",
    "redec_pdf_hash": "a3b2c1d4e5f6789012345678901234567890abcdef1234567890abcdef123456",
    "redec_id": "REDEC_2026_001234",
    "created_at": "2026-01-15T10:30:00Z"
  }
}

Campos importantes:

  • redec_receipt_pdf: URL para descargar el PDF del recibo
  • redec_pdf_hash: Hash SHA256 para verificar integridad del PDF
  • redec_id: Identificador único del proceso REDEC
  • user_reference: Tu referencia interna del usuario (si la proporcionaste)
Sincronización semanal con CMF

Usa el webhook report.created y verifica el campo kind en el payload para identificar reportes RDC30 y sincronizarlos semanalmente con la CMF según lo requiere la normativa.

Recibos PDF automáticos​

Cada consentimiento REDEC registrado genera automáticamente un recibo PDF con evidencia completa del consentimiento. Este recibo incluye:

Información del recibo:

  • Identificador único del proceso REDEC
  • RUT del usuario que otorgó el consentimiento
  • RUT del ejecutivo (si aplica)
  • Fecha y hora exacta del consentimiento
  • Tipo de consentimiento y producto asociado
  • Método de captura (web, IVR, sucursal, etc.)

Además, el sistema calcula un hash SHA256 del PDF generado, que se retorna en la API para verificar la integridad del archivo descargado.

Flujo de generación de recibos​

  1. Registro del consentimiento - Cuando registras un consentimiento REDEC, el sistema inicia la generación del recibo
  2. Generación automática - El recibo PDF se genera en segundo plano
  3. Notificación por webhook - Cuando el PDF está listo, recibes el webhook consent_action.redec_receipt_generated
  4. Descarga del recibo - Usa el endpoint /redec/consent_actions/{consent_action_id}/download_receipt para descargar el PDF

Verificación de integridad​

El sistema calcula un hash SHA256 para cada recibo PDF, el cual se retorna en el header X-SHA256-Hash de la API y en el webhook. Puedes usar este hash para verificar que el archivo descargado no ha sido modificado:

import crypto from 'crypto';
import fs from 'fs';

// Verificar integridad del recibo descargado
function verifyReceiptIntegrity(pdfPath, expectedHash) {
  const fileBuffer = fs.readFileSync(pdfPath);
  const sha256 = crypto.createHash('sha256');
  sha256.update(fileBuffer);
  const calculatedHash = sha256.digest('hex');

  return calculatedHash === expectedHash;
}

// Usar con el hash del webhook
const isValid = verifyReceiptIntegrity(
  '/path/to/receipt.pdf',
  'a3b2c1d4e5f6789012345678901234567890abcdef1234567890abcdef123456'
);

console.log('Recibo válido:', isValid);
Uso de recibos

Los recibos PDF sirven como evidencia auditable del consentimiento para:

  • Auditorías de la CMF
  • Verificación interna de cumplimiento
  • Respaldo legal ante disputas
  • Archivo histórico de consentimientos

Endpoint de descarga​

GET /api/v1/redec/consent_actions/{consent_action_id}/download_receipt

El endpoint retorna:

  • Content-Type: application/pdf
  • Header SHA256: Hash del PDF en el header X-SHA256-Hash
  • Body: Contenido binario del PDF

Para más información sobre cómo descargar y trabajar con recibos, consulta la guía de recibos REDEC.

Modelo de datos REDEC​

Acción de consentimiento REDEC​

Cada acción de consentimiento REDEC extiende el modelo estándar de consentimiento con información regulatoria:

Componentes principales:

  • Action Token: Evidencia criptográfica del consentimiento
  • Entity NIN: RUT del usuario (obligatorio)
  • Executive NIN: RUT del ejecutivo (opcional)
  • Consent Template: Plantilla que define el propósito
  • Timestamp: Fecha y hora exacta del consentimiento
  • Consent Method: Método de captura (web, IVR, firma, etc.)
  • Agreement: Se actualiza automáticamente con el consentimiento
¿Qué son las acciones de consentimiento?

Las acciones de consentimiento registran cada vez que un usuario otorga, actualiza o revoca un consentimiento. Para entender el concepto completo, revisa la guía de gestión de consentimientos.

Reporte RDC30​

El reporte RDC30 consolida todas las acciones de consentimiento en un período:

Información incluida:

  • RUT de usuarios que otorgaron consentimiento
  • Fecha y hora de cada consentimiento
  • Tipo de consentimiento
  • Método de captura
  • RUT del ejecutivo (si aplica)
  • Actualizaciones y revocaciones

Relación con otros módulos​

Integración con Consentimiento​

REDEC utiliza la infraestructura del módulo de consentimiento:

  • Las plantillas de consentimiento se crean igual que las plantillas estándar
  • El SDK captura consentimientos de la misma forma
  • Los Agreements se actualizan automáticamente
  • La evidencia se genera igual que en consentimientos regulares

La diferencia: REDEC añade el registro del RUT y genera reportes regulatorios específicos para la CMF.

Revisa la guía de consentimientos para entender los conceptos básicos.

Requisitos de la NCG 540​

¿Qué debe registrarse?​

Según la NCG 540, las instituciones deben registrar:

  1. Consentimientos iniciales - Cuando el usuario autoriza consulta de información crediticia
  2. Actualizaciones de consentimiento - Cuando el usuario modifica sus autorizaciones
  3. Revocaciones - Cuando el usuario retira el consentimiento
  4. Información del solicitante - RUT del usuario
  5. Información del ejecutivo - RUT de quien gestionó (opcional pero recomendado)
  6. Tipo de crédito - Clasificación del producto crediticio según la CMF

Cumplimiento de plantillas REDEC​

Para que un consentimiento sea válido para REDEC y se incluya en reportes RDC30, la plantilla de consentimiento debe cumplir requisitos estrictos:

Data use permitido​

La plantilla debe usar uno de estos dos data uses:

  • finance.credit_risk_assessment - Evaluación de riesgo crediticio
  • finance.commercial_risk_assessment - Evaluación de riesgo comercial

Todos los data_requirements de la plantilla deben usar el mismo data use. No mezcles ambos en una misma plantilla.

Producto con redec_kind (obligatorio)​

La plantilla debe referenciar (vía product_id) un producto que tenga un redec_kind que clasifica el tipo de crédito.

Paso 1: Crear el producto

POST /api/v1/products
{
  "name": "Crédito de Consumo",
  "redec_kind": "consumer_credits"
}

Paso 2: Referenciar en la plantilla

POST /api/v1/redec/consent_templates
{
  "name": "...",
  "data_requirements": [...],
  "product_id": "prod_abc123..."
}
Endpoint dedicado

Usa /api/v1/redec/consent_templates para crear plantillas REDEC. Este endpoint valida el cumplimiento automáticamente al momento de creación.

Valores válidos de redec_kind:

  • commercial_credits - Créditos comerciales
  • consumer_credits - Créditos de consumo
  • housing_credits - Créditos hipotecarios
  • financial_operations - Operaciones financieras
  • acquired_debt_instruments - Instrumentos de deuda adquiridos
  • contingent_credits - Créditos contingentes
  • freely_available_credit_line_limits - Límites de líneas de crédito de libre disposición

Validación automática​

El sistema valida automáticamente:

  • ✅ Data uses permitidos en data_requirements
  • ✅ La plantilla tiene un product_id
  • ✅ El producto referenciado tiene un redec_kind válido

Si la plantilla no cumple, el endpoint /redec/consent_actions retornará error 400.

Solo templates REDEC-compliant en reportes

Únicamente las acciones registradas con plantillas REDEC-compliant se incluirán en los reportes RDC30. Las acciones con plantillas no conformes no serán reportables.

Plazos de reporte​

Los reportes RDC30 deben:

  • Generarse semanalmente (cada sábado entre las 00:00 y 01:00 si está habilitado)
  • Incluir todas las acciones del período
  • Estar disponibles para sincronización con la CMF
  • Conservarse por el tiempo establecido en la normativa

Flujo de trabajo recomendado​

  1. Configura el módulo REDEC en tu cuenta y establece el código REDEC de tu empresa
  2. Crea productos con redec_kind para cada tipo de crédito que ofreces
  3. Crea plantillas de consentimiento REDEC-compliant referenciando los productos
  4. Integra el SDK o API para capturar consentimientos
  5. Registra cada acción con el endpoint REDEC incluyendo el RUT
  6. Activa los reportes periódicos automáticos en la configuración
  7. Suscríbete a webhooks para rastrear generación de reportes
  8. Sincroniza reportes con la CMF semanalmente usando los webhooks
Configuración automática de reportes

En la sección de configuración encontrarás cómo activar los reportes periódicos automáticos que simplifican el cumplimiento.