Resumen de un perfil
Este endpoint entrega la información consolidada de un RUT cargado previamente en tu cuenta de Sheriff.
- Consultar un RUT ya cargado en la plataforma no tiene costo adicional.
- El RUT debe estar cargado en la plataforma antes de que consultes su información. Para cargarlo, usa Carga de RUT.
- La estructura de la respuesta depende de si el RUT corresponde a una persona jurídica o a una persona natural.
legalpasa de objeto a arreglo de sociedades.ayudantesFallidosentrega códigos numéricos en lugar de nombres y se agrega el booleanoayudanteFallido.- Las secciones cuya fuente falló y no tienen información previa viajan con su estructura completa en lugar de omitirse.
- En
identificacion, los indicadores"SI"/"NO"pasan a booleanos ycantidadTrabajadoreses numérico onull;bienes.propiedades.tasacionTotales numérico. complianceagregamarshalyestadoMarshal, y sutipoPersonausa"juridica"en lugar de"juridical".
Ver la Guía de Migración.
Detalle de API
Request
- URL:
/helper/resumen?rut={rut} - Método:
GET
Parámetros de consulta (query)
| Valor | Tipo | Es requerido | Descripción |
|---|---|---|---|
rut | string | Sí | RUT que quieres consultar, en formato "12345678-9". |
Ejemplo request con curl
curl -X 'GET' \
'https://prod.api.thesheriff.cl/api/clients/v3/helper/resumen?rut=76123456-0' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123'
Response
| Campo | Tipo | Descripción |
|---|---|---|
success | boolean | Indica si la operación fue exitosa. |
data | object | Resumen completo del RUT consultado. |
Diferencias por tipo de persona
El campo esPersonaJuridica de data indica si el resumen corresponde a una persona jurídica o a una persona natural. La mayoría de los bloques tienen la misma estructura en ambos casos (ver Estructuras comunes). Estos son los que cambian:
| Campo | Persona jurídica | Persona natural |
|---|---|---|
esPersonaJuridica | true | false |
identificacion.tamanoEmpresaSii | Tamaño, ventas y trabajadores según el SII | Siempre con sus campos en null |
legal | Un único elemento: la sociedad consultada | Un elemento por cada sociedad en la que participa |
compliance.tipoPersona | "juridica" | "natural" |
compliance.nombre y siguientes | Razón social en nombre; el resto en "" | Nombres y apellidos por separado |
compliance.resumen (pepChile, pepChileFamiliares, funcionariosPublicos) | Siempre 0 resultados: estas fuentes no se buscan para personas jurídicas. El riesgo es "free", salvo que Marshal detecte un PEP | Resultado de la búsqueda |
Código 102 en ayudantesFallidos | Puede aparecer | Nunca aparece |
Respuesta para persona jurídica
Success
-
Status code: 200
-
Example response body:
{
"success": true,
"data": {
"rut": "76123456-0",
"esPersonaJuridica": true,
"fechaCarga": "13-06-2024",
"identificacion": {
"razonSocial": "EMPRESA FICTICIA SPA",
"presentaActividades": true,
"inicioActividades": "15-06-2021",
"autorizadoMonedaExtranjera": false,
"empresaMenor": true,
"observaciones": "Observación",
"notas": "Notas",
"situacionActual": "Situación actual",
"actividadEconomicaVigente": [
{
"actividades": "ACTIVIDADES DE CONSULTORIA DE GESTION",
"codigo": "702000",
"categoria": "Primera",
"afectaIva": true,
"fecha": "15-06-2021"
}
],
"documentosTimbrados": [
{
"documento": "Factura electrónica",
"ultimoAnioTimbrado": "2025"
}
],
"cantidadActividades": 1,
"cantidadDocumentos": 1,
"ultimaActualizacion": "23-07-2025 11:00:00",
"tamanoEmpresaSii": {
"tamanoEmpresa": "Pequeña empresa",
"ventasAnuales": "5.000,01 a 10.000,00",
"cantidadTrabajadores": 12
}
},
"boletinComercial": {
"casosInfocom": 0,
"casosBolcom": 0,
"casosDicom": 0,
"MontoInfocom": 0,
"MontoBolcom": 0,
"MontoDicom": 0,
"variacion": {
"ultimoPeriodo": "05/2025",
"periodoActual": "11/2025",
"cambioPorcentual": null,
"cambioAbsoluto": 0
},
"ultimaActualizacion": "21-11-2025 11:00:00"
},
"judicial": {
"casosCivilesActivos": 1,
"casosCivilesPresentados": 1,
"casosCivilesConcluidos": 0,
"cobranzaActivos": 0,
"cobranzaPresentados": 0,
"cobranzaConcluidos": 0,
"laboralActivos": 0,
"laboralPresentados": 0,
"laboralConcluidos": 0,
"casosActuales": 1,
"casosArchivados": 0,
"casosConcluidos": 0,
"todosLosCasos": 1,
"casosQuiebra": 0,
"casosQuiebraResumen": {},
"posturasActivasPresentadas": {
"demandado": 1
},
"ultimaActualizacionCiviles": "23-07-2025 11:00:01",
"ultimaActualizacionCobranza": "23-07-2025 11:00:02",
"ultimaActualizacionLaboral": "23-07-2025 11:00:03",
"boletinConcursal": false
},
"cobranzaLaboral": {
"moraPrevisional": {
"casosTotales": 0,
"empleados": 0,
"variacion": {
"ultimoPeriodo": "05/2025",
"periodoActual": "11/2025",
"cambioPorcentual": null,
"cambioAbsoluto": 0
},
"ultimaActualizacion": "21-11-2025 11:00:00"
},
"multaLaboral": {
"totalMultas": 0,
"montoTotalMultas": 0,
"multasPagadas": 0,
"montoMultasPagadas": 0,
"multasPendientes": 0,
"montoMultasPendientes": 0,
"variacion": {
"ultimoPeriodo": "05/2025",
"periodoActual": "11/2025",
"cambioPorcentual": 0,
"cambioAbsoluto": 0
},
"ultimaActualizacion": "21-11-2025 11:00:00"
},
"boletinLaboral": {
"montoTotal": 0,
"variacion": {
"montoTotal": 0,
"ultimoPeriodo": "05/2025",
"periodoActual": "11/2025",
"cambioPorcentual": null,
"cambioAbsoluto": 0
},
"ultimaActualizacion": "21-11-2025 11:00:00"
}
},
"legal": [
{
"nombre": "EMPRESA FICTICIA SPA",
"rut": "76123456-0",
"fechaConstitucion": "02-06-2021",
"estado": "VIGENTE",
"trabajadores": 24,
"socios": [
{
"nombre": "SOCIO FICTICIO UNO",
"rut": "11111111-1",
"domicilio": "CALLE EJEMPLO 123, LAS CONDES",
"tipoPersona": "natural",
"tipos": ["ADMINISTRADOR", "SOCIO"],
"porcentaje": 70,
"vigente": true
},
{
"nombre": "HOLDING FICTICIO LTDA",
"rut": "22222222-2",
"domicilio": null,
"tipoPersona": "juridica",
"tipos": ["SOCIO"],
"porcentaje": 30,
"vigente": true
}
],
"administradores": [
{
"nombre": "SOCIO FICTICIO UNO",
"rut": "11111111-1",
"domicilio": "CALLE EJEMPLO 123, LAS CONDES"
}
],
"participaciones": [
{
"nombre": "FILIAL FICTICIA SPA",
"rut": "33333333-3",
"tipos": ["ACCIONISTA"],
"porcentaje": 50,
"estado": "VIGENTE",
"fechaConstitucion": "01-01-2020"
}
],
"extractos": [
{
"fecha": "11-05-2024",
"actuacion": "MODIFICACION",
"linkPdf": "https://www.registrodeempresasysociedades.cl/Certificados/",
"cve": "2491726",
"fuente": "EEUD"
},
{
"fecha": "02-06-2021",
"actuacion": "CONSTITUCION",
"linkPdf": "https://www.registrodeempresasysociedades.cl/Certificados/",
"cve": "1234567",
"fuente": "EEUD"
}
],
"tieneCmf": false
}
],
"deudaBancaria": {
"periodo": "06/2025",
"deudaDirectaComercial": 0,
"deudaDirectaCastigada": 0,
"deudaDirectaHipotecaria": 0,
"deudaDirectaMorosa": 0,
"deudaDirectaVencida": 0,
"deudaDirectaVigente": 0,
"deudaIndirectaCastigada": 0,
"deudaIndirectaVencida": 0,
"deudaIndirectaVigente": 0,
"leasingMoroso": 0,
"leasingVigente": 0,
"lineaCredito": 0,
"variacion": {
"periodo": "12/2024",
"deudaDirectaComercial": 0,
"deudaDirectaCastigada": 0,
"deudaDirectaHipotecaria": 0,
"deudaDirectaMorosa": 0,
"deudaDirectaVencida": 0,
"deudaDirectaVigente": 0,
"deudaIndirectaCastigada": 0,
"deudaIndirectaVencida": 0,
"deudaIndirectaVigente": 0,
"leasingMoroso": 0,
"leasingVigente": 0,
"lineaCredito": 0
}
},
"bienes": {
"vehiculos": {
"cantidadVehiculos": 2,
"tasacionTotal": 18500000,
"ultimaActualizacion": "23-07-2025 11:00:00"
},
"propiedades": {
"cantidadPropiedades": 3,
"tasacionTotal": 185000000,
"ultimaActualizacion": "23-07-2025 11:00:00"
}
},
"creditScoring": {
"ponderacionFinanciero": 0,
"maxPonderacionFinanciero": null,
"ponderacionJudicial": 100,
"judicialBankruptcy": false,
"maxPonderacionJudicial": 100,
"ponderacionCobranzaLaboral": 100,
"maxPonderacionCobranzaLaboral": 100,
"ponderacionBoletin": 100,
"maxPonderacionBoletin": 100,
"cantidadAyudantes": 3,
"nombresAyudantes": ["judicial", "commertialBulletin", "laborCollection"],
"porcentajeClasificacion": 300,
"etiquetaClasificacion": "Risk free"
},
"ratings": {
"etiquetasActivas": ["fraude", "bloqueado"],
"cantidadComentarios": 2,
"calificacionGlobal": { "valor": 4.2, "total": 5 },
"calificacionCumplimientoGlobal": { "valor": 3.7, "total": 3 },
"calificacionRelacionGlobal": { "valor": 2.5, "total": 2 },
"calificacionTransparenciaGlobal": { "valor": 2, "total": 2 },
"calificacionFiabilidadGlobal": { "valor": 2.5, "total": 2 }
},
"compliance": {
"estado": "PROCESADO",
"nombre": "EMPRESA FICTICIA SPA",
"segundoNombre": "",
"apellido": "",
"segundoApellido": "",
"tipoPersona": "juridica",
"riesgo": "free",
"resumen": {
"pepChile": { "totalResultados": 0, "riesgo": "free" },
"pepChileFamiliares": { "totalResultados": 0, "riesgo": "free" },
"funcionariosPublicos": { "totalResultados": 0, "riesgo": "free" },
"listasInternacionales": { "totalResultados": 0, "riesgo": "free" },
"penal": { "totalResultados": 0, "riesgo": "free" },
"mallaSocietaria": { "totalResultados": 3, "riesgo": "free" },
"noticias": { "totalResultados": 0, "riesgo": "free" }
},
"marshal": true,
"estadoMarshal": "PROCESADO"
},
"incluyeEquifax": true,
"ayudanteFallido": false,
"ayudantesFallidos": []
}
}
Campos dentro de data (persona jurídica):
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
rut | string | No | RUT consultado (formato "12345678-9"). |
esPersonaJuridica | boolean | No | Siempre true. |
fechaCarga | string | No | Fecha en que el RUT se cargó en tu cuenta (formato DD-MM-YYYY). |
identificacion | object | No | Identificación y actividades de la sociedad (ver Estructura de identificacion). No viaja si aún no hay información del SII; si la consulta al SII falló, viaja con sus campos en null (ver Secciones fallidas). |
boletinComercial | object | No | Resumen de boletines comerciales (ver Estructuras comunes). |
judicial | object | No | Resumen de causas judiciales. |
cobranzaLaboral | object | No | Mora previsional, multas laborales y boletín laboral. |
legal | array | No | Un único elemento con la sociedad consultada; [] si no hay información legal (ver tabla siguiente). |
deudaBancaria | object | No | Resumen de la información del sistema financiero. |
bienes | object | No | Vehículos y propiedades con tasaciones. |
creditScoring | object | No | Ponderaciones y clasificación del scoring crediticio. |
ratings | object | No | Etiquetas, comentarios y calificaciones del perfil. |
compliance | object | No | Compliance de la sociedad (ver tabla de compliance para persona jurídica). |
incluyeEquifax | boolean | No | Indica si el resumen incluye datos provenientes de Equifax. |
ayudanteFallido | boolean | No | true cuando al menos una fuente falló (ver Secciones fallidas). |
ayudantesFallidos | array | No | Códigos numéricos de las fuentes que fallaron; [] si no hubo fallas (ver Valores de ayudantesFallidos). |
Los bloques que dependen de un ayudante (boletinComercial, judicial, cobranzaLaboral, legal, deudaBancaria, bienes, compliance) solo se incluyen si tu plan cuenta con ese ayudante. creditScoring solo se incluye si tu plan cuenta con alguno de los ayudantes Finanzas, Boletín, Judicial o Cobranza Laboral.
identificacion.tamanoEmpresaSii (persona jurídica):
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
tamanoEmpresa | string | Sí | Tamaño de empresa según el SII (ej: "Pequeña empresa"); null si el SII no informa el tamaño. |
ventasAnuales | string | Sí | Tramo de ventas anuales en UF (ej: "5.000,01 a 10.000,00"); null si el SII no informa el tamaño. |
cantidadTrabajadores | number | Sí | Trabajadores dependientes informados; null si no se informa. |
legal (persona jurídica), campos del único elemento:
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
nombre | string | Sí | Razón social de la sociedad consultada. |
rut | string | Sí | RUT de la sociedad consultada. |
fechaConstitucion | string | Sí | Fecha de constitución (formato DD-MM-YYYY). |
estado | string | Sí | Estado de la sociedad (ej: "VIGENTE"). |
trabajadores | number | Sí | Número de trabajadores declarados. |
socios | array | No | Socios, accionistas y administradores de la sociedad (ver campos de legal[]). |
administradores | array | No | Socios con rol de administrador o representante legal. |
participaciones | array | No | Sociedades en las que la sociedad consultada participa. |
extractos | array | No | Extractos societarios publicados. |
tieneCmf | boolean | No | Indica si la sociedad tiene registro en la CMF. |
compliance (persona jurídica):
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
estado | string | No | "PROCESADO" o "NO PROCESADO". |
nombre | string | No | Razón social usada en la búsqueda; "" si no hay. |
segundoNombre | string | No | Siempre "". |
apellido | string | No | Siempre "". |
segundoApellido | string | No | Siempre "". |
tipoPersona | string | No | Siempre "juridica". |
riesgo | string | No | Riesgo agregado: "free", "medium" o "critical". |
resumen | object | No | Resumen por fuente (ver compliance.resumen). pepChile, pepChileFamiliares y funcionariosPublicos siempre vienen con totalResultados: 0, porque esas fuentes no se buscan para personas jurídicas. Su riesgo es "free", salvo que Marshal haya detectado un PEP: en ese caso pepChile (PEP directo) o pepChileFamiliares (relación con un PEP) vienen con riesgo: "critical". |
marshal | boolean | No | true cuando tu plan cuenta con Marshal y el RUT está marcado con Marshal en tu cuenta (ver Carga de RUT). |
estadoMarshal | string | No | "PROCESADO" cuando el RUT tiene Marshal en tu cuenta (marshal: true) y algún análisis Marshal completado; "NO PROCESADO" en otro caso. |
Respuesta para persona natural
Success
-
Status code: 200
-
Example response body:
{
"success": true,
"data": {
"rut": "11111111-1",
"esPersonaJuridica": false,
"fechaCarga": "13-06-2024",
"identificacion": {
"razonSocial": "JUAN PEREZ SOTO",
"presentaActividades": true,
"inicioActividades": "21-09-2010",
"autorizadoMonedaExtranjera": false,
"empresaMenor": null,
"observaciones": null,
"notas": null,
"situacionActual": null,
"actividadEconomicaVigente": [
{
"actividades": "SERVICIOS DE ASESORAMIENTO Y CONSULTORIA",
"codigo": "702000",
"categoria": "Segunda",
"afectaIva": false,
"fecha": "21-09-2010"
}
],
"documentosTimbrados": [
{
"documento": "Boleta de honorarios electrónica",
"ultimoAnioTimbrado": "2025"
}
],
"cantidadActividades": 1,
"cantidadDocumentos": 1,
"ultimaActualizacion": "23-07-2025 11:00:00",
"tamanoEmpresaSii": {
"tamanoEmpresa": null,
"ventasAnuales": null,
"cantidadTrabajadores": null
}
},
"boletinComercial": {
"casosInfocom": 1,
"casosBolcom": 0,
"MontoInfocom": 350000,
"MontoBolcom": 0,
"variacion": {
"ultimoPeriodo": "05/2025",
"periodoActual": "11/2025",
"cambioPorcentual": null,
"cambioAbsoluto": 350000
},
"ultimaActualizacion": "21-11-2025 11:00:00"
},
"judicial": {
"casosCivilesActivos": 0,
"casosCivilesPresentados": 0,
"casosCivilesConcluidos": 0,
"cobranzaActivos": 0,
"cobranzaPresentados": 0,
"cobranzaConcluidos": 0,
"laboralActivos": 0,
"laboralPresentados": 0,
"laboralConcluidos": 0,
"casosActuales": 0,
"casosArchivados": 0,
"casosConcluidos": 0,
"todosLosCasos": 0,
"casosQuiebra": 0,
"casosQuiebraResumen": {},
"posturasActivasPresentadas": {},
"ultimaActualizacionCiviles": "23-07-2025 11:00:01",
"ultimaActualizacionCobranza": "23-07-2025 11:00:02",
"ultimaActualizacionLaboral": "23-07-2025 11:00:03",
"boletinConcursal": false
},
"cobranzaLaboral": {
"moraPrevisional": {
"casosTotales": 0,
"empleados": 0,
"variacion": {
"ultimoPeriodo": "05/2025",
"periodoActual": "11/2025",
"cambioPorcentual": null,
"cambioAbsoluto": 0
},
"ultimaActualizacion": "21-11-2025 11:00:00"
},
"multaLaboral": {
"totalMultas": 0,
"montoTotalMultas": 0,
"multasPagadas": 0,
"montoMultasPagadas": 0,
"multasPendientes": 0,
"montoMultasPendientes": 0,
"variacion": {
"ultimoPeriodo": "05/2025",
"periodoActual": "11/2025",
"cambioPorcentual": null,
"cambioAbsoluto": 0
},
"ultimaActualizacion": "21-11-2025 11:00:00"
},
"boletinLaboral": {
"montoTotal": 0,
"variacion": {
"montoTotal": 0,
"ultimoPeriodo": "05/2025",
"periodoActual": "11/2025",
"cambioPorcentual": null,
"cambioAbsoluto": 0
},
"ultimaActualizacion": "21-11-2025 11:00:00"
}
},
"legal": [
{
"nombre": "EMPRESA FICTICIA SPA",
"rut": "76123456-0",
"fechaConstitucion": "02-06-2021",
"estado": "VIGENTE",
"trabajadores": 24,
"socios": [
{
"nombre": "JUAN PEREZ SOTO",
"rut": "11111111-1",
"domicilio": "CALLE EJEMPLO 123, LAS CONDES",
"tipoPersona": "natural",
"tipos": ["ADMINISTRADOR", "SOCIO"],
"porcentaje": 70,
"vigente": true
}
],
"administradores": [
{
"nombre": "JUAN PEREZ SOTO",
"rut": "11111111-1",
"domicilio": "CALLE EJEMPLO 123, LAS CONDES"
}
],
"participaciones": [],
"extractos": [
{
"fecha": "02-06-2021",
"actuacion": "CONSTITUCION",
"linkPdf": "https://www.registrodeempresasysociedades.cl/Certificados/",
"cve": "1234567",
"fuente": "EEUD"
}
],
"tieneCmf": false
},
{
"nombre": "INVERSIONES FICTICIAS LIMITADA",
"rut": "77777777-7",
"fechaConstitucion": "10-03-2015",
"estado": "VIGENTE",
"trabajadores": 0,
"socios": [
{
"nombre": "JUAN PEREZ SOTO",
"rut": "11111111-1",
"domicilio": "CALLE EJEMPLO 123, LAS CONDES",
"tipoPersona": "natural",
"tipos": ["SOCIO"],
"porcentaje": 40,
"vigente": true
}
],
"administradores": [],
"participaciones": [],
"extractos": [],
"tieneCmf": false
}
],
"deudaBancaria": {
"periodo": "06/2025",
"deudaDirectaComercial": 0,
"deudaDirectaCastigada": 0,
"deudaDirectaHipotecaria": 52000,
"deudaDirectaMorosa": 0,
"deudaDirectaVencida": 0,
"deudaDirectaVigente": 52000,
"deudaIndirectaCastigada": 0,
"deudaIndirectaVencida": 0,
"deudaIndirectaVigente": 0,
"leasingMoroso": 0,
"leasingVigente": 0,
"lineaCredito": 1500,
"variacion": {
"periodo": "12/2024",
"deudaDirectaComercial": 0,
"deudaDirectaCastigada": 0,
"deudaDirectaHipotecaria": 53000,
"deudaDirectaMorosa": 0,
"deudaDirectaVencida": 0,
"deudaDirectaVigente": 53000,
"deudaIndirectaCastigada": 0,
"deudaIndirectaVencida": 0,
"deudaIndirectaVigente": 0,
"leasingMoroso": 0,
"leasingVigente": 0,
"lineaCredito": 1500
}
},
"bienes": {
"vehiculos": {
"cantidadVehiculos": 1,
"tasacionTotal": 9800000,
"ultimaActualizacion": "23-07-2025 11:00:00"
},
"propiedades": {
"cantidadPropiedades": 1,
"tasacionTotal": 120000000,
"ultimaActualizacion": "23-07-2025 11:00:00"
}
},
"creditScoring": {
"ponderacionFinanciero": 80,
"maxPonderacionFinanciero": 100,
"ponderacionJudicial": 100,
"judicialBankruptcy": false,
"maxPonderacionJudicial": 100,
"ponderacionCobranzaLaboral": 100,
"maxPonderacionCobranzaLaboral": 100,
"ponderacionBoletin": 60,
"maxPonderacionBoletin": 100,
"cantidadAyudantes": 4,
"nombresAyudantes": ["judicial", "commertialBulletin", "finances", "laborCollection"],
"porcentajeClasificacion": 340,
"etiquetaClasificacion": "Risk free"
},
"ratings": {
"etiquetasActivas": [],
"cantidadComentarios": 0,
"calificacionGlobal": { "valor": 0, "total": 0 },
"calificacionCumplimientoGlobal": { "valor": 0, "total": 0 },
"calificacionRelacionGlobal": { "valor": 0, "total": 0 },
"calificacionTransparenciaGlobal": { "valor": 0, "total": 0 },
"calificacionFiabilidadGlobal": { "valor": 0, "total": 0 }
},
"compliance": {
"estado": "PROCESADO",
"nombre": "JUAN",
"segundoNombre": "",
"apellido": "PEREZ",
"segundoApellido": "SOTO",
"tipoPersona": "natural",
"riesgo": "medium",
"resumen": {
"pepChile": { "totalResultados": 0, "riesgo": "free" },
"pepChileFamiliares": { "totalResultados": 1, "riesgo": "medium" },
"funcionariosPublicos": { "totalResultados": 0, "riesgo": "free" },
"listasInternacionales": { "totalResultados": 0, "riesgo": "free" },
"penal": { "totalResultados": 0, "riesgo": "free" },
"mallaSocietaria": { "totalResultados": 2, "riesgo": "free" },
"noticias": { "totalResultados": 0, "riesgo": "free" }
},
"marshal": false,
"estadoMarshal": "NO PROCESADO"
},
"incluyeEquifax": false,
"ayudanteFallido": false,
"ayudantesFallidos": []
}
}
Campos dentro de data (persona natural):
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
rut | string | No | RUT consultado (formato "12345678-9"). |
esPersonaJuridica | boolean | No | Siempre false. |
fechaCarga | string | No | Fecha en que el RUT se cargó en tu cuenta (formato DD-MM-YYYY). |
identificacion | object | No | Identificación y actividades de la persona (ver Estructura de identificacion). No viaja si aún no hay información del SII; si la consulta al SII falló, viaja con sus campos en null (ver Secciones fallidas). |
boletinComercial | object | No | Resumen de boletines comerciales (ver Estructuras comunes). |
judicial | object | No | Resumen de causas judiciales. |
cobranzaLaboral | object | No | Mora previsional, multas laborales y boletín laboral. |
legal | array | No | Un elemento por cada sociedad en la que participa la persona; [] si no participa en ninguna o no hay información legal (ver tabla siguiente). |
deudaBancaria | object | No | Resumen de la información del sistema financiero. |
bienes | object | No | Vehículos y propiedades con tasaciones. |
creditScoring | object | No | Ponderaciones y clasificación del scoring crediticio. |
ratings | object | No | Etiquetas, comentarios y calificaciones del perfil. |
compliance | object | No | Compliance de la persona (ver tabla de compliance para persona natural). |
incluyeEquifax | boolean | No | Indica si el resumen incluye datos provenientes de Equifax. |
ayudanteFallido | boolean | No | true cuando al menos una fuente falló (ver Secciones fallidas). |
ayudantesFallidos | array | No | Códigos numéricos de las fuentes que fallaron; [] si no hubo fallas. Nunca incluye el código 102. |
Los bloques que dependen de un ayudante (boletinComercial, judicial, cobranzaLaboral, legal, deudaBancaria, bienes, compliance) solo se incluyen si tu plan cuenta con ese ayudante. creditScoring solo se incluye si tu plan cuenta con alguno de los ayudantes Finanzas, Boletín, Judicial o Cobranza Laboral.
identificacion.tamanoEmpresaSii (persona natural):
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
tamanoEmpresa | string | Siempre | No aplica a personas naturales. |
ventasAnuales | string | Siempre | No aplica a personas naturales. |
cantidadTrabajadores | number | Siempre | No aplica a personas naturales. |
legal (persona natural), campos de cada elemento:
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
nombre | string | Sí | Razón social de la sociedad en la que participa la persona. |
rut | string | Sí | RUT de esa sociedad. |
fechaConstitucion | string | Sí | Fecha de constitución de la sociedad (formato DD-MM-YYYY). |
estado | string | Sí | Estado de la sociedad (ej: "VIGENTE"). |
trabajadores | number | Sí | Número de trabajadores declarados por la sociedad. |
socios | array | No | Socios de la sociedad. La persona consultada aparece aquí con su RUT, sus roles (tipos) y su porcentaje. |
administradores | array | No | Socios de la sociedad con rol de administrador o representante legal. |
participaciones | array | No | Sociedades en las que esa sociedad participa. |
extractos | array | No | Extractos societarios de la sociedad. |
tieneCmf | boolean | No | Indica si la sociedad tiene registro en la CMF. La persona natural no tiene un tieneCmf propio. |
compliance (persona natural):
| Campo | Tipo | Puede ser null | Descripción |
|---|---|---|---|
estado | string | No | "PROCESADO", o "NO PROCESADO" cuando no se pudo identificar el nombre de la persona para la búsqueda. |
nombre | string | No | Primer nombre; "" si no hay. |
segundoNombre | string | No | Segundo nombre; "" si no tiene. |
apellido | string | No | Primer apellido; "" si no hay. |
segundoApellido | string | No | Segundo apellido; "" si no tiene. |
tipoPersona | string | No | Siempre "natural". |
riesgo | string | No | Riesgo agregado: "free", "medium" o "critical". |
resumen | object | No | Resumen por fuente (ver compliance.resumen), con todas las fuentes consultadas. |
marshal | boolean | No | true cuando tu plan cuenta con Marshal y el RUT está marcado con Marshal en tu cuenta. |
estadoMarshal | string | No | "PROCESADO" cuando el RUT tiene Marshal en tu cuenta (marshal: true) y algún análisis Marshal completado; "NO PROCESADO" en otro caso. |
Estructuras comunes
Estos bloques tienen la misma estructura para personas naturales y jurídicas.
Estructura de identificacion
| Campo | Tipo | Descripción |
|---|---|---|
razonSocial | string | Razón social (persona jurídica) o nombre (persona natural) registrado en el SII. |
presentaActividades | boolean | Indica si el contribuyente presenta actividades económicas; null si no se informa. |
inicioActividades | string | Fecha de inicio de actividades. |
autorizadoMonedaExtranjera | boolean | Indica si está autorizado para operar en moneda extranjera; null si no se informa. |
empresaMenor | boolean | Indica si es considerada empresa menor; null si no se informa. |
observaciones | string | Observaciones libres. |
notas | string | Notas adicionales relacionadas con la identificación. |
situacionActual | string | Descripción de la situación actual del contribuyente. |
actividadEconomicaVigente | array | Actividades económicas vigentes: actividades, codigo, categoria, afectaIva (boolean o null) y fecha. No viaja si el SII no informa actividades. |
documentosTimbrados | array | Documentos timbrados: documento y ultimoAnioTimbrado. No viaja si el SII no los informa. |
cantidadActividades | number | Cantidad de actividades registradas; 0 si no hay. |
cantidadDocumentos | number | Cantidad de documentos timbrados; 0 si no hay. |
ultimaActualizacion | string | Fecha de la última actualización. |
tamanoEmpresaSii | object | Tamaño de empresa según el SII. Su contenido depende del tipo de persona (ver persona jurídica y persona natural). |
Los campos de texto llegan en null cuando el SII no los informa.
Campos de legal[]
Campos dentro de cada socio:
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | Nombre o razón social del socio. |
rut | string | RUT del socio. |
domicilio | string | Domicilio del socio; puede ser null. |
tipoPersona | string | "natural" o "juridica". |
tipos | array | Roles del socio en la sociedad (ej: ["SOCIO"], ["ADMINISTRADOR", "SOCIO"]). |
porcentaje | number | Porcentaje de participación, con hasta 2 decimales (ej: 70); null si no se informa. |
vigente | boolean | true si la relación sigue vigente; false para ex-socios; null si no se informa. |
Campos dentro de cada administrador:
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | Nombre o razón social. |
rut | string | RUT. |
domicilio | string | Domicilio declarado; puede ser null. |
Campos dentro de cada participacion:
| Campo | Tipo | Descripción |
|---|---|---|
nombre | string | Razón social de la sociedad participada. |
rut | string | RUT de la sociedad participada. |
tipos | array | Roles en la sociedad participada (ej: ["ACCIONISTA"]). |
porcentaje | number | Porcentaje de participación (ej: 50); null si no se informa. |
estado | string | Estado de la sociedad participada (ej: "VIGENTE"). |
fechaConstitucion | string | Fecha de constitución de la sociedad participada (DD-MM-YYYY); puede ser null. |
Campos dentro de cada extracto:
| Campo | Tipo | Descripción |
|---|---|---|
fecha | string | Fecha del extracto (formato DD-MM-YYYY). |
actuacion | string | Tipo de actuación (ej: "CONSTITUCION", "MODIFICACION"). |
linkPdf | string | URL al documento del extracto; null si no está disponible. |
cve | string | Código de Verificación Electrónica del documento. |
fuente | string | "DO" (Diario Oficial) o "EEUD" (Empresa en un Día); puede ser null. |
Estructura de boletinComercial
| Campo | Tipo | Descripción |
|---|---|---|
casosInfocom | number | Cantidad de casos en Infocom. |
casosBolcom | number | Cantidad de casos en Bolcom. |
casosDicom | number | Cantidad de casos en Dicom (solo con Equifax). |
MontoInfocom | number | Monto asociado en Infocom. |
MontoBolcom | number | Monto asociado en Bolcom. |
MontoDicom | number | Monto asociado en Dicom (solo con Equifax). |
variacion | object | Variación temporal: ultimoPeriodo, periodoActual, cambioPorcentual y cambioAbsoluto. |
ultimaActualizacion | string | Fecha de la última actualización. |
Nota sobre el boletín comercial: el contenido de
boletinComercialvaría según el tipo de integración contratada y si hay datos de Equifax (incluyeEquifax):
- Cuando
incluyeEquifaxesfalse, los campos de DICOM (casosDicom,MontoDicom) no se incluyen en la respuesta.- En integraciones de tipo "FULL", si el perfil se cargó sin Equifax, el bloque
boletinComercialno se incluye.- En integraciones de tipo "MIX" se devuelven los datos de Bolcom e Infocom; solo DICOM se omite cuando
incluyeEquifaxesfalse.- La ausencia de campos DICOM no implica que falten datos de Bolcom o Infocom.
Estructura de judicial
| Campo | Tipo | Descripción |
|---|---|---|
casosCivilesActivos | number | Cantidad de casos civiles activos. |
casosCivilesPresentados | number | Cantidad de casos civiles presentados. |
casosCivilesConcluidos | number | Cantidad de casos civiles concluidos. |
cobranzaActivos | number | Cantidad de casos de cobranza activos. |
cobranzaPresentados | number | Cantidad de casos de cobranza presentados. |
cobranzaConcluidos | number | Cantidad de casos de cobranza concluidos. |
laboralActivos | number | Cantidad de casos laborales activos. |
laboralPresentados | number | Cantidad de casos laborales presentados. |
laboralConcluidos | number | Cantidad de casos laborales concluidos. |
casosActuales | number | Total de casos actuales. |
casosArchivados | number | Total de casos archivados. |
casosConcluidos | number | Total de casos concluidos. |
todosLosCasos | number | Suma total de casos por fuente. |
casosQuiebra | number | Casos de quiebra detectados. |
casosQuiebraResumen | object | Resumen de quiebras por tipo de procedimiento; {} si no hay. |
posturasActivasPresentadas | object | Cantidad de causas vigentes o archivadas por postura (ej: demandado). Solo incluye las posturas con al menos una causa; {} si no hay. |
ultimaActualizacionCiviles | string | Fecha de la última actualización de las causas civiles. |
ultimaActualizacionCobranza | string | Fecha de la última actualización de las causas de cobranza. |
ultimaActualizacionLaboral | string | Fecha de la última actualización de las causas laborales. |
boletinConcursal | boolean | Indica si existe boletín concursal. |
Estructura de cobranzaLaboral
| Campo | Tipo | Descripción |
|---|---|---|
moraPrevisional | object | Objeto con casosTotales, empleados, variacion y ultimaActualizacion. |
multaLaboral | object | Objeto con totalMultas, montoTotalMultas, multasPagadas, montoMultasPagadas, multasPendientes, montoMultasPendientes, variacion y ultimaActualizacion. |
boletinLaboral | object | Objeto con montoTotal, variacion (variación temporal: montoTotal, ultimoPeriodo, periodoActual, cambioPorcentual y cambioAbsoluto) y ultimaActualizacion. Solo viaja si tu plan incluye también el ayudante Boletín. |
Estructura de deudaBancaria (información del sistema financiero)
Los valores de esta sección están expresados en miles.
| Campo | Tipo | Descripción |
|---|---|---|
periodo | string | Periodo del resumen (ej: "06/2025"). |
deudaDirectaComercial | number | Obligaciones directas comerciales (valores en miles). |
deudaDirectaCastigada | number | Obligaciones directas castigadas (valores en miles). |
deudaDirectaHipotecaria | number | Obligaciones hipotecarias (valores en miles). |
deudaDirectaMorosa | number | Obligaciones directas morosas (valores en miles). |
deudaDirectaVencida | number | Obligaciones directas vencidas (valores en miles). |
deudaDirectaVigente | number | Obligaciones directas vigentes (valores en miles). |
deudaIndirectaCastigada | number | Obligaciones indirectas castigadas (valores en miles). |
deudaIndirectaVencida | number | Obligaciones indirectas vencidas (valores en miles). |
deudaIndirectaVigente | number | Obligaciones indirectas vigentes (valores en miles). |
leasingMoroso | number | Leasing moroso (valores en miles). |
leasingVigente | number | Leasing vigente (valores en miles). |
lineaCredito | number | Línea de crédito disponible o registrada (valores en miles). |
variacion | object | Objeto con los mismos campos, referidos al periodo anterior. |
Estructura de bienes
| Campo | Tipo | Descripción |
|---|---|---|
vehiculos | object | Resumen de vehículos: cantidadVehiculos (number), tasacionTotal (number) y ultimaActualizacion. |
propiedades | object | Resumen de propiedades: cantidadPropiedades (number), tasacionTotal (number) y ultimaActualizacion. |
Estructura de creditScoring
| Campo | Tipo | Descripción |
|---|---|---|
ponderacionFinanciero | number | Ponderación del componente financiero. |
maxPonderacionFinanciero | number | Máxima ponderación financiera posible. |
ponderacionJudicial | number | Ponderación del componente judicial. |
judicialBankruptcy | boolean | Indica si hay quiebra judicial. |
maxPonderacionJudicial | number | Máxima ponderación judicial. |
ponderacionCobranzaLaboral | number | Ponderación de cobranza laboral. |
maxPonderacionCobranzaLaboral | number | Máxima ponderación de cobranza laboral. |
ponderacionBoletin | number | Ponderación por boletín. |
maxPonderacionBoletin | number | Máxima ponderación por boletín. |
cantidadAyudantes | number | Cantidad de ayudantes que aportaron al scoring. |
nombresAyudantes | array | Nombres identificadores de los ayudantes. |
porcentajeClasificacion | number | Porcentaje de clasificación total. |
etiquetaClasificacion | string | Etiqueta resumen (ej: "Risk free"). |
Estructura de ratings
| Campo | Tipo | Descripción |
|---|---|---|
etiquetasActivas | array | Lista de etiquetas activas. |
cantidadComentarios | number | Cantidad de comentarios registrados para el perfil. |
calificacionGlobal | object | Puntuación global (valor, total). |
calificacionCumplimientoGlobal | object | Puntuación de cumplimiento. |
calificacionRelacionGlobal | object | Puntuación de relación. |
calificacionTransparenciaGlobal | object | Puntuación de transparencia. |
calificacionFiabilidadGlobal | object | Puntuación de fiabilidad. |
Subestructura compliance.resumen
Cada fuente es un objeto con totalResultados (number) y riesgo ("free", "medium" o "critical").
| Campo | Tipo | Descripción |
|---|---|---|
pepChile | object | Resultados de PEP Chile. |
pepChileFamiliares | object | Resultados de PEP Chile Familiares. |
funcionariosPublicos | object | Resultados de Funcionarios Públicos. |
listasInternacionales | object | Resultados de Listas Internacionales. |
penal | object | Resultados de Penal. |
mallaSocietaria | object | Resultados de Malla Societaria. |
noticias | object | Resultados de Noticias. |
El detalle de cada fuente está en el Detalle de Compliance.
Secciones fallidas
Si una fuente no responde durante la recolección de datos, el resumen se entrega igual, de forma parcial, y la falla se informa de tres maneras a la vez:
ayudanteFallidopasa atrue.ayudantesFallidosincluye el código de la fuente que falló (ver tabla de códigos).- La sección alimentada por esa fuente conserva la última información disponible. Si nunca se ha obtenido información para ella, la sección viaja igual, con su estructura completa (ver Qué contiene una sección fallida).
Valores de ayudantesFallidos
ayudantesFallidos es un arreglo de números enteros, sin repetidos y en orden ascendente. Solo incluye fuentes de los ayudantes de tu plan.
| Código | Fuente que falló | Sección afectada | Cuándo aparece |
|---|---|---|---|
101 | Identificación (SII) | identificacion | La consulta de identificación falló o no tiene información disponible. |
102 | Tamaño de empresa (SII) | identificacion.tamanoEmpresaSii | Solo personas jurídicas. |
201 | Judicial: causas civiles | judicial | Plan con ayudante Judicial. |
202 | Judicial: causas de cobranza | judicial | Plan con ayudante Judicial. |
203 | Judicial: causas laborales | judicial | Plan con ayudante Judicial. |
204 | Judicial: boletín concursal | judicial.boletinConcursal | Plan con ayudante Judicial. |
301 | Boletín comercial (Bolcom o Cámara de Comercio) | boletinComercial | Plan con ayudante Boletín, cuando boletinComercial viaja en el resumen. |
302 | Boletín comercial: Dicom | boletinComercial | Plan con ayudante Boletín, cuando boletinComercial viaja en el resumen. |
303 | Boletín laboral | cobranzaLaboral.boletinLaboral | Plan con ayudantes Cobranza Laboral y Boletín. |
401 | Mora previsional | cobranzaLaboral.moraPrevisional | Plan con ayudante Cobranza Laboral. |
402 | Multas laborales | cobranzaLaboral.multaLaboral | Plan con ayudante Cobranza Laboral. |
501 | Legal | legal | Plan con ayudante Legal. |
701 | Información del sistema financiero | deudaBancaria | Plan con ayudante Finanzas. |
801 | Bienes: propiedades | bienes.propiedades | Plan con ayudante Bienes. |
802 | Bienes: vehículos | bienes.vehiculos | Plan con ayudante Bienes. |
1101 | Análisis Marshal | compliance (no se modifica) | Solo en el webhook de resumen con includeMarshal: true: el análisis falló, no hubo cupo o venció la espera de 15 minutos. Nunca aparece en este endpoint. |
Cómo leer los códigos
Cada código se forma con el número del ayudante del plan seguido de dos dígitos que identifican la fuente dentro de ese ayudante. Así puedes agrupar las fallas por ayudante sin conocer cada fuente:
| Prefijo | Ayudante | Códigos |
|---|---|---|
1xx | Identificación | 101, 102 |
2xx | Judicial | 201 a 204 |
3xx | Boletín | 301, 302, 303 |
4xx | Cobranza Laboral | 401, 402 |
5xx | Legal | 501 |
7xx | Finanzas (información del sistema financiero) | 701 |
8xx | Bienes | 801, 802 |
11xx | Compliance (análisis Marshal) | 1101 |
Cómo se informan las fuentes:
- Cada fuente tiene su propio código. Por ejemplo, si fallan las causas civiles y las laborales,
ayudantesFallidoses[201, 203]; no existe un código para el ayudante Judicial completo. - Las fuentes que no alimentan ninguna sección del resumen no generan código ni ponen
ayudanteFallidoentrue.
Qué contiene una sección fallida
- Si la sección ya tenía información de una carga anterior, conserva esa información. Usa los campos
ultimaActualizacionde cada bloque para saber de cuándo es. - Si nunca se obtuvo información, la sección viaja igual, con su estructura completa: según la sección, sus campos llegan en
nullo con valores vacíos (0).identificacionllega con todos sus campos ennull, incluidotamanoEmpresaSii, ylegal, como arreglo vacío ([]).
Una sección sin información previa puede llegar con contadores en 0. Evalúa siempre ayudanteFallido y ayudantesFallidos antes de interpretar que un RUT no tiene registros.
Ejemplo de respuesta parcial
Resumen de una persona jurídica en el que fallaron la identificación, Legal, la información del sistema financiero y vehículos, sin información previa. identificacion viaja con sus campos en null (y puede aparecer al final de data); las demás secciones afectadas viajan con su estructura vacía:
{
"success": true,
"data": {
"rut": "76123456-0",
"esPersonaJuridica": true,
"fechaCarga": "20-10-2026",
"boletinComercial": {
"casosInfocom": 0,
"casosBolcom": 0,
"MontoInfocom": 0,
"MontoBolcom": 0,
"variacion": {
"ultimoPeriodo": "04/2026",
"periodoActual": "10/2026",
"cambioPorcentual": null,
"cambioAbsoluto": 0
},
"ultimaActualizacion": "20-10-2026 10:15:00"
},
"legal": [],
"deudaBancaria": {
"periodo": null,
"deudaDirectaComercial": 0,
"deudaDirectaCastigada": 0,
"deudaDirectaHipotecaria": 0,
"deudaDirectaMorosa": 0,
"deudaDirectaVencida": 0,
"deudaDirectaVigente": 0,
"deudaIndirectaCastigada": 0,
"deudaIndirectaVencida": 0,
"deudaIndirectaVigente": 0,
"leasingMoroso": 0,
"leasingVigente": 0,
"lineaCredito": 0,
"variacion": {
"periodo": null,
"deudaDirectaComercial": 0,
"deudaDirectaCastigada": 0,
"deudaDirectaHipotecaria": 0,
"deudaDirectaMorosa": 0,
"deudaDirectaVencida": 0,
"deudaDirectaVigente": 0,
"deudaIndirectaCastigada": 0,
"deudaIndirectaVencida": 0,
"deudaIndirectaVigente": 0,
"leasingMoroso": 0,
"leasingVigente": 0,
"lineaCredito": 0
}
},
"bienes": {
"vehiculos": {
"cantidadVehiculos": 0,
"tasacionTotal": 0,
"ultimaActualizacion": null
},
"propiedades": {
"cantidadPropiedades": 2,
"tasacionTotal": 240000000,
"ultimaActualizacion": "20-10-2026 10:16:00"
}
},
"incluyeEquifax": false,
"ayudanteFallido": true,
"ayudantesFallidos": [101, 501, 701, 802],
"identificacion": {
"razonSocial": null,
"presentaActividades": null,
"inicioActividades": null,
"autorizadoMonedaExtranjera": null,
"empresaMenor": null,
"observaciones": null,
"notas": null,
"situacionActual": null,
"actividadEconomicaVigente": null,
"documentosTimbrados": null,
"cantidadActividades": null,
"cantidadDocumentos": null,
"ultimaActualizacion": null,
"tamanoEmpresaSii": {
"tamanoEmpresa": null,
"ventasAnuales": null,
"cantidadTrabajadores": null
}
}
}
}
El ejemplo muestra solo las secciones relevantes; el resto de los bloques del resumen viaja con su estructura habitual.
Reglas adicionales
- La sección solo se incluye si tu plan cuenta con el ayudante correspondiente; si tu plan no lo incluye, la sección no viaja y no genera código.
- Las fallas se aplican también por subsección: si falla el boletín concursal y
judicialtiene información, solojudicial.boletinConcursalse ve afectado. - Para obtener la información completa, vuelve a consultar el resumen más tarde.
Errores
Además de los errores comunes, este endpoint puede responder:
400 - RUT restringido
Tu usuario tiene rol de observador u operador y el RUT está en la lista restringida de tu cuenta.
{
"success": false,
"code": 400,
"error": "No tienes permiso para revisar este perfil."
}
401 - No autorizado
El token no se envió, expiró o no es válido (ver Errores de autenticación). Si expiró, solicita uno nuevo en Obtener Token.
{
"success": false,
"code": 401,
"error": "El token de autenticación no es válido."
}
404 - RUT no encontrado
El RUT no está cargado en la plataforma o tu cuenta no tiene acceso a él. Si aún no lo cargas, usa Carga de RUT.
{
"success": false,
"code": 404,
"error": "Rut no encontrado o no posee permisos para consultar. Asegurese de que está incluido en su cartera de clientes o que posee autorización e intente más tarde"
}
429 - Demasiadas solicitudes
Superaste el límite de solicitudes (ver Rate Limits). Espera los segundos que indica el header Retry-After antes de reintentar.
{
"success": false,
"code": 429,
"error": "Demasiadas solicitudes desde esta API externa, intente más tarde."
}
500 - Error interno del servidor
Ocurrió un error inesperado. Intenta nuevamente más tarde.
{
"success": false,
"code": 500,
"error": "Ocurrió un error interno. Intenta nuevamente más tarde."
}