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_iddel 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_idexista 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.
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 accesoaccess_date: fecha del acceso en formatoYYYYMMDD, en la zona horaria de tu empresaaccess_time: hora del acceso en formatoHHMMSS(24 horas), en la zona horaria de tu empresamandatary_nin(opcional): RUT del mandatario si aplica. Si el acceso fue directo, envíanullo no lo incluyasexecutive_nin(opcional): RUT de la persona que hizo la consulta, sea de tu institución o del mandatariosource_system(opcional): nombre del sistema desde el que se hizo la consulta, máximo 100 caracteres. No incluyas datos personales
- cURL
- JavaScript
- Python
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"
}'
const response = await fetch('https://app.soyio.id/api/v1/redec/accesses', {
method: 'POST',
headers: {
Authorization: `Bearer ${YOUR_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
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',
}),
});
const data = await response.json();
console.log('Acceso RDC31 registrado:', data.accesses[0].id);
import requests
response = requests.post(
'https://app.soyio.id/api/v1/redec/accesses',
headers={
'Authorization': f'Bearer {YOUR_API_KEY}',
'Content-Type': 'application/json'
},
json={
'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'
}
)
data = response.json()
print('Acceso RDC31 registrado:', data['accesses'][0]['id'])
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:
{
"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):
- Con desfase
- En UTC
{
"redec_id": "REDECIDABC1234567890",
"accessed_at": "2025-06-16T21:30:00-04:00"
}
{
"redec_id": "REDECIDABC1234567890",
"accessed_at": "2025-06-17T01:30:00Z"
}
Con la empresa en hora de Chile, ambos quedan registrados igual que el ejemplo con hora local:
{
"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:
[
{
"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:
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.
{
"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.
- cURL
- JavaScript
- Python
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"
}'
const response = await fetch('https://app.soyio.id/api/v1/reports', {
method: 'POST',
headers: {
Authorization: `Bearer ${YOUR_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
kind: 'redec.rdc31',
starts_at: '2025-06-14T00:00:00-04:00',
ends_at: '2025-06-20T23:59:59-04:00',
}),
});
const data = await response.json();
console.log('Reporte RDC31 generado:', data.report.id);
import requests
response = requests.post(
'https://app.soyio.id/api/v1/reports',
headers={
'Authorization': f'Bearer {YOUR_API_KEY}',
'Content-Type': 'application/json'
},
json={
'kind': 'redec.rdc31',
'starts_at': '2025-06-14T00:00:00-04:00',
'ends_at': '2025-06-20T23:59:59-04:00'
}
)
data = response.json()
print('Reporte RDC31 generado:', data['report']['id'])
Qué retorna el reporte
La respuesta incluye el contenido ASCII del archivo y la metadata que necesitas para completar la cuadratura.
{
"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_recordsmandatary_accesses_countbusiness_day_accesses_countnon_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
0000123456RDC3120250620
REDECIDABC1234567890202506162130000111111111
Configura generación automática
Activa la generación automática semanal desde la configuración 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.
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_idjunto con tu solicitud de crédito o evaluación - Informa el acceso inmediatamente después de una consulta exitosa
- Informa
executive_ninysource_systempara 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
- Configuración de REDEC - Activa reportes automáticos y webhooks
- RDC30 - Genera el reporte semanal de consentimientos
- RDC40 - Genera reportes de solicitudes de derecho REDEC
- Cómo funciona REDEC - Entiende cómo se relacionan consentimientos, accesos y reportes