Obtener Reporte

POST /cl/consent_manager/get_report

Recupera un reporte RDC30 previamente generado por generate_report, identificado por el período mensual. Devuelve la carátula CMF y el detalle de consentimientos del período.

URL completa (prod): https://api.floid.app/cl/consent_manager/get_report
URL sandbox: https://sandbox.floid.app/cl/consent_manager/get_report

Este endpoint sólo soporta reportes RDC30 persistidos en gestor_reportes_generados. Los demás tipos (PERSONAS, INSTITUCIONES, etc.) no se persisten — para esos hay que volver a llamar a generate_report.

Headers requeridos

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

Parámetros del body

Un reporte se identifica por la tupla (id_cliente, tipo_reporte = "RDC30", year, month). El servidor devuelve la versión más reciente generada para ese período.

Contrato preferido

Campo	Tipo	Requerido	Descripción
`tipo_reporte`	string	Sí	Siempre `"RDC30"` (único soportado)
`year`	integer	Sí	Año del reporte (≥ 2000)
`month`	integer	Sí	Mes del reporte (`1`–`12`)
`codigo_institucion`	string	No	Acota la sección de detalle a una institución

Contrato retrocompatible

Si no enviás year/month, el servidor los deriva de fecha_desde. fecha_hasta se ignora — el período es siempre el mes completo.

Campo	Tipo	Descripción
`fecha_desde`	string	`YYYY-MM-DD` — el día se ignora; sólo cuenta el mes/año

id_cliente y caseId se inyectan por el gateway. Si los enviás, se ignoran/sobreescriben.

Ejemplos

Por `year` + `month` (preferido)

curl --location 'https://api.floid.app/cl/consent_manager/get_report' \
  --header 'Authorization: Bearer {{TOKEN}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tipo_reporte": "RDC30",
    "year": 2026,
    "month": 5
  }'

Por `fecha_desde` (retrocompatible)

curl --location 'https://api.floid.app/cl/consent_manager/get_report' \
  --header 'Authorization: Bearer {{TOKEN}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tipo_reporte": "RDC30",
    "fecha_desde": "2026-05-01",
    "fecha_hasta": "2026-05-31"
  }'

Acotando a una institución

curl --location 'https://api.floid.app/cl/consent_manager/get_report' \
  --header 'Authorization: Bearer {{TOKEN}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "tipo_reporte": "RDC30",
    "year": 2026,
    "month": 5,
    "codigo_institucion": "123456789"
  }'

Respuesta exitosa (200)

{
  "code": "200",
  "msg": "OK",
  "caseid": "",
  "data": {
    "caratula": {
      "institucion": "FLOID",
      "codigo": "123456789",
      "fechaInformacion": "20260601",
      "archivo": "RDC30",
      "totalRegistros": 145,
      "consentimientosObtenidos": 145,
      "consentimientosRevocados": 10,
      "digital": 120,
      "verbal": 15,
      "escrito": 10
    },
    "reporte": [
      {
        "codigoInstitucion": "123456789",
        "identificacionArchivo": "RDC30",
        "fechaArchivo": "20260601",
        "codigoInternoConsentimiento": "BCH-NAT-001",
        "fechaOtorgamiento": "20260512",
        "horaOtorgamiento": "143022",
        "fechaRevocacion": null,
        "horaRevocacion": null,
        "rutDeudorConsultado": "12345678-9",
        "medio": 1,
        "finalidad": 2,
        "rutEjecutivo": "98765432-1",
        "objetivo": 2,
        "codigoEncriptadoConsentimiento": "0F6400343D627EEF5A5346BC3E8006EE17B888D9D37945959602A5EC28980A47"
      }
    ]
  }
}

Estructura

Bloque	Descripción
`data.caratula`	Encabezado del reporte CMF: institución, totales por estado y por medio
`data.reporte[]`	Una entrada por consentimiento del período, con los nombres de campo CMF (camelCase)

Posibles errores

`error_code`	HTTP	`display_message` típico
`INVALID_REQUEST`	400	"Missing or invalid period: provide year+month or fecha_desde (YYYY-MM-DD)"
`INVALID_REQUEST`	400	`month` fuera de [1,12] o `year` < 2000
`NO_DATA_AVAILABLE`	400	"No RDC30 report generated for YYYY-MM." — todavía no llamaste a `generate_report` para ese período
`INTERNAL_ERROR`	500	Error de DB

Última actualización: 12 de mayo de 2026.