Saltar al contenido principal

Genera reportes RDC31

Genera reportes RDC31

El reporte RDC31 consolida los accesos a la base de deuda realizados bajo un consentimiento REDEC válido. Soyio almacena cada acceso reportable y genera el archivo en el formato de ancho fijo requerido por la CMF.

Cuándo usar RDC31​

Usa RDC31 cuando tu institución:

  • consulta directamente la base de deuda consolidada
  • ya registró el consentimiento REDEC del deudor en Soyio
  • necesita informar cada acceso exitoso realizado bajo ese consentimiento

RDC31 no reemplaza el registro del consentimiento. Primero registra el consentimiento REDEC y luego informa cada acceso exitoso asociado a ese redec_id.

Qué registra Soyio​

Cada acceso informado incluye:

  • redec_id del consentimiento usado en la consulta
  • fecha y hora del acceso, en la zona horaria de tu empresa
  • RUT del mandatario, si la consulta fue hecha por un tercero autorizado
  • RUT de la persona que hizo la consulta y sistema desde el que la hizo, si los informas

La NCG 576 exige identificar a la persona que consulta la base de deuda y mantener un registro de cada consulta disponible para auditoría. El RUT de la persona y el sistema quedan registrados en Soyio, pero no se informan en el RDC31.

Soyio valida antes de persistir:

  • que el redec_id exista para tu empresa
  • que el consentimiento siga vigente al momento del acceso
  • que no haya sido revocado antes del acceso
  • que la fecha y hora del acceso no sea futura, con una tolerancia de 5 minutos por diferencias de reloj
  • que el acceso no sea un duplicado exacto

Paso 1: guarda el redec_id del consentimiento​

Necesitas conservar el redec_id retornado por el flujo REDEC para reutilizarlo cada vez que consultes la base de deuda bajo ese consentimiento.

Si ya generas y almacenas los recibos o webhooks REDEC, usa ese identificador como llave de referencia para RDC31.

Valida compliance antes de consultar CMF

Antes de registrar un acceso RDC31, verifica que la entidad tiene compliance status complies. Si el status no es complies, no hagas la consulta a la base de deuda. Consulta la guía de validación de compliance.

Paso 2: informa cada acceso exitoso​

Usa el endpoint POST /api/v1/redec/accesses para registrar cada acceso. Puedes enviar una sola entrada o un arreglo cuando procesas múltiples accesos en lote.

Payload base​

{
"redec_id": "REDECIDABC1234567890",
"access_date": "20250616",
"access_time": "213000",
"mandatary_nin": "11.111.111-1",
"executive_nin": "22.222.222-2",
"source_system": "core-bancario"
}

Campos clave:

  • redec_id: identificador del consentimiento REDEC asociado al acceso
  • access_date: fecha del acceso en formato YYYYMMDD, en la zona horaria de tu empresa
  • access_time: hora del acceso en formato HHMMSS (24 horas), en la zona horaria de tu empresa
  • mandatary_nin (opcional): RUT del mandatario si aplica. Si el acceso fue directo, envía null o no lo incluyas
  • executive_nin (opcional): RUT de la persona que hizo la consulta, sea de tu institución o del mandatario
  • source_system (opcional): nombre del sistema desde el que se hizo la consulta, máximo 100 caracteres. No incluyas datos personales
POST /api/v1/redec/accesses
curl -X POST https://app.soyio.id/api/v1/redec/accesses \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"redec_id": "REDECIDABC1234567890",
"access_date": "20250616",
"access_time": "213000",
"mandatary_nin": "11.111.111-1",
"executive_nin": "22.222.222-2",
"source_system": "core-bancario"
}'

Zona horaria del acceso​

Soyio interpreta access_date y access_time en la zona horaria configurada para tu empresa, que por defecto es la hora de Chile. Es la misma fecha y hora que se informa en el RDC31.

Si consultaste la base de deuda el 16 de junio de 2025 a las 21:30 hora de Chile, envía la hora tal como la ves en tu reloj:

Acceso informado con hora local
{
"redec_id": "REDECIDABC1234567890",
"access_date": "20250616",
"access_time": "213000"
}

Estos dos campos no llevan zona horaria. Si los envías en UTC con tu empresa en hora de Chile, el acceso queda 3 o 4 horas adelantado y Soyio lo rechaza por tener fecha futura.

Si tu sistema guarda la hora en UTC o en otra zona horaria, envía accessed_at en lugar de access_date y access_time: una fecha y hora en formato ISO 8601 que indique su desfase horario. Soyio la convierte a la zona horaria de tu empresa para el reporte.

Estos dos ejemplos informan el mismo acceso, uno con el desfase de Chile en invierno (-04:00) y otro en UTC (Z):

accessed_at con desfase
{
"redec_id": "REDECIDABC1234567890",
"accessed_at": "2025-06-16T21:30:00-04:00"
}

Con la empresa en hora de Chile, ambos quedan registrados igual que el ejemplo con hora local:

Acceso registrado
{
"access_date": "20250616",
"access_time": "213000",
"accessed_at": "2025-06-17T01:30:00.000Z"
}

Envía accessed_at o el par access_date y access_time, nunca ambos. Si envías ambos, o si accessed_at no incluye el desfase horario (Z o ±HH:MM), Soyio responde con un error de validación. Las fracciones de segundo se descartan, porque el RDC31 informa la hora en segundos.

Registro masivo​

Cuando tu proceso genera múltiples accesos exitosos en la misma corrida, envía un arreglo:

POST /api/v1/redec/accesses
[
{
"redec_id": "REDECIDABC1234567890",
"access_date": "20250616",
"access_time": "083000",
"mandatary_nin": null
},
{
"redec_id": "REDECIDABC1234567890",
"access_date": "20250616",
"access_time": "213000",
"mandatary_nin": "11.111.111-1"
}
]

Registra cada consulta exitosa por separado. Si consultas dos veces el mismo redec_id a distinta hora, informa dos accesos.

Paso 3 (opcional): revisa los accesos registrados​

Usa el endpoint GET /api/v1/redec/accesses para listar los accesos de tu empresa, del más reciente al más antiguo. Filtra por consentimiento con consent_action_id o redec_id en el parámetro where:

GET /api/v1/redec/accesses
curl -G https://app.soyio.id/api/v1/redec/accesses \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode 'where={"redec_id":{"=":"REDECIDABC1234567890"}}'

Cada acceso incluye access_date y access_time en la zona horaria de tu empresa, tal como se informan en el RDC31, y accessed_at en UTC.

Paso 4: genera el reporte RDC31​

Usa el endpoint POST /api/v1/reports con kind: "redec.rdc31" y el rango semanal que deseas reportar. Los valores sin prefijo, como rdc31, siguen funcionando, pero están deprecados: usa redec.rdc31.

Payload base
{
"kind": "redec.rdc31",
"starts_at": "2025-06-14T00:00:00-04:00",
"ends_at": "2025-06-20T23:59:59-04:00"
}

El período es una semana completa de sábado a viernes en la zona horaria de tu empresa. Envía las fechas con el desfase de esa zona, como en el ejemplo (-04:00 es Chile en horario de invierno). Si las envías en UTC (Z), Soyio genera la misma semana de sábado a viernes en la zona horaria de tu empresa.

POST /api/v1/reports
curl -X POST https://app.soyio.id/api/v1/reports \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"kind": "redec.rdc31",
"starts_at": "2025-06-14T00:00:00-04:00",
"ends_at": "2025-06-20T23:59:59-04:00"
}'

Qué retorna el reporte​

La respuesta incluye el contenido ASCII del archivo y la metadata que necesitas para completar la cuadratura.

Respuesta de ejemplo
{
"report": {
"id": "rpt_abc123...",
"kind": "redec.rdc31",
"starts_at": "2025-06-14T04:00:00Z",
"ends_at": "2025-06-21T03:59:59Z",
"created_at": "2025-06-23T04:30:00Z",
"generated_by": null,
"content": "0000123456RDC3120250620 \nREDECIDABC1234567890202506162130000111111111\n",
"metadata": {
"institution_name": "Acme Bank",
"institution_code": 123456,
"information_date": "20062025",
"total_records": 1,
"mandatary_accesses_count": 1,
"business_day_accesses_count": 1,
"non_business_hours_accesses_count": 1
}
}
}

Cómo usar metadata​

Usa report.metadata para completar la carátula de cuadratura del RDC31. Hoy Soyio entrega estas métricas junto al reporte:

  • total_records
  • mandatary_accesses_count
  • business_day_accesses_count
  • non_business_hours_accesses_count

Si la metadata trae warnings, revisa el reporte antes de enviarlo. Por ejemplo, missing_institution_code indica que se generó sin Código CMF. Revisa el aviso de Código CMF faltante.

El contenido del archivo y la metadata de cuadratura se generan juntos. Eso te permite automatizar la descarga del TXT y también poblar tu flujo interno de revisión antes de subirlo a la CMF.

Formato del archivo​

El contenido del RDC31 se entrega en texto ASCII con líneas de ancho fijo.

  • Encabezado: código de institución CMF, identificador RDC31, fecha de referencia y relleno
  • Detalle: redec_id, fecha y hora de acceso en la zona horaria de tu empresa y RUT del mandatario cuando aplica
Ejemplo simplificado
0000123456RDC3120250620
REDECIDABC1234567890202506162130000111111111

Configura generación automática​

Activa la generación automática semanal desde la configuración REDEC:

PATCH /api/v1/config/redec
{
"redec_automatic_rdc31": true
}

Cuando esta opción está activa, Soyio genera el RDC31 automáticamente el primer día hábil bancario después del cierre semanal (viernes) y lo publica con el webhook report.created. Por defecto se genera a las 00:30 en la zona horaria de tu empresa. Para cambiar la hora, revisa Reportes automáticos.

Usa webhooks para sincronizar el proceso​

El webhook report.created se envía también para RDC31. Verifica el campo kind antes de procesarlo.

Handler del webhook
app.post('/webhooks/soyio', async (req, res) => {
const { name, payload } = req.body;

if (name === 'report.created' && payload.kind === 'redec.rdc31') {
await storeCoverSheetData(payload.metadata);
await sendToCMF(payload.content);
}

res.status(200).send('OK');
});

Buenas prácticas​

  • Guarda el redec_id junto con tu solicitud de crédito o evaluación
  • Informa el acceso inmediatamente después de una consulta exitosa
  • Informa executive_nin y source_system para que cada consulta quede identificada ante una auditoría
  • Usa el modo masivo solo cuando controles deduplicación en tu propio proceso
  • Automatiza la descarga del reporte con report.created
  • Revisa Configuración para activar la generación semanal

Próximos pasos​