Glosario de términos y valores (API v3)
Referencia de los valores, términos y campos que devuelve la API v3 de Sheriff: el bloque legal del resumen, la malla societaria, el registro CMF, el compliance y el análisis Marshal, las secciones fallidas y los formatos de datos. Úsala para interpretar los datos de las respuestas de cada endpoint.
Los valores de los bloques judicial, compliance, boletines, tamaño de empresa y credit scoring del resumen se describen en el Glosario de la API v2.
📑 Índice rápido
Legal
Tipo de persona
Campo tipoPersona en la Malla Societaria y en cada socio del bloque legal del resumen.
| Valor | Significado |
|---|---|
juridica | Sociedad o empresa. La ficha describe la sociedad y sus socios. |
natural | Persona natural. La ficha describe a la persona y sus sociedades. |
El bloque
compliancedel resumen, el Detalle de Compliance, los endpoints de Compliance por nombre y la entrega de Cargar perfil en Compliance responden con los mismos valores:juridicaynatural. En el resumen, el tipo también se informa con el booleanoesPersonaJuridica. Cada página de endpoint describe por separado la respuesta para persona jurídica y para persona natural cuando difieren.
Estado de una sociedad
Campo estado de la sociedad consultada o de una participación.
| Valor | Significado |
|---|---|
VIGENTE | La sociedad está activa ante el SII. |
Otros valores se entregan tal como los publica la fuente (por ejemplo, sociedades con término de giro).
Roles y tipos de participación
Los roles de una persona o sociedad dentro de otra sociedad aparecen en dos campos:
| Campo | Dónde aparece | Forma |
|---|---|---|
tipos | Resumen (legal[].socios, legal[].participaciones), Malla Societaria y Capas de la Malla Societaria | Arreglo con los roles, ej: ["SOCIO", "ADMINISTRADOR"] |
roles | Malla Societaria (persona natural, sociedades[]) | Arreglo con los roles de la persona consultada en esa sociedad |
| Rol | Significado |
|---|---|
SOCIO | Participa en el capital de una sociedad de personas (Ltda., EIRL, etc.). |
ACCIONISTA | Participa en el capital de una sociedad de capital (SpA, S.A.). |
ADMINISTRADOR | Administra o representa a la sociedad. |
ALTA_DIRECCION | Integra la alta dirección de la sociedad. |
SOCIO_INDIRECTO | Participa en la sociedad a través de otra sociedad. |
En la Malla Societaria, estos roles determinan la lista en la que aparece cada persona: socios reúne a quienes tienen rol SOCIO o ACCIONISTA (o sin rol informado) y administradores a quienes tienen rol ADMINISTRADOR o son representantes legales. Una misma persona puede estar en ambas listas.
Vigencia de una relación
Campo vigente en socios, participaciones y relaciones de la malla.
| Valor | Significado |
|---|---|
true | La relación societaria sigue vigente. |
false | Relación histórica (ex-socio, participación ya cedida). Se informa, pero la malla no se expande a través de ella. |
null | La fuente no informa vigencia. |
Fuentes de extractos
Los extractos provienen de dos registros públicos, identificados con un código en fuente y fuentes:
| Fuente | Código |
|---|---|
| Diario Oficial | DO |
| Empresa en un Día | EEUD |
- Diario Oficial: publicaciones oficiales de actuaciones societarias.
- Empresa en un Día: registro de las constituciones y modificaciones de sociedades realizadas en el portal oficial (Registro de Empresas y Sociedades).
Actuaciones societarias
Campo actuacion en extractos (resumen y Malla Societaria). Indica el tipo de actuación publicada.
| Valor | Significado | Impacto |
|---|---|---|
CONSTITUCION | Constitución de una nueva sociedad. | Creación de una nueva persona jurídica. |
MODIFICACION | Modificación de estatutos o información societaria. | Cambios en socios, capital, objeto social. |
DISOLUCION | Disolución de una sociedad. | Término de la existencia legal de la entidad. |
MIGRACION | Cambio de tipo societario o migración de registro. | Ej: de EIRL a SpA, cambio de sistema registral. |
Los valores se entregan tal como los publica la fuente, por lo que pueden aparecer con o sin tilde (MODIFICACION / MODIFICACIÓN). Te recomendamos compararlos sin distinguir tildes.
Niveles de la malla societaria
Términos de Capas de la Malla Societaria y Niveles de la Malla Societaria.
| Término | Significado |
|---|---|
nivel | Distancia desde el RUT consultado. El nivel 1 son sus relaciones directas; el nivel 2, las relaciones de esas sociedades, y así sucesivamente. |
modo | Forma de recorrer la malla: beneficiariosFinales (por defecto) o ampliada (ver tabla siguiente). |
siguienteNivel | Indica si existe al menos una relación en el nivel siguiente al consultado. |
truncada | true cuando el recorrido superó su límite de tiempo o de tamaño, o llegó al nivel 50 con relaciones por recorrer, y la malla está incompleta a partir de algún nivel. |
nivelMaximo | Nivel más profundo que tiene relaciones. 0 cuando el RUT no tiene relaciones registradas. Lo entrega Niveles de la Malla Societaria. |
nivelesDisponibles | Lista de niveles con relaciones y cuántas relaciones tiene cada uno. Lo entrega Niveles de la Malla Societaria. |
| Relación | Un vínculo de participación entre un socio (rutSocio) y una sociedad (rutSociedad), con su porcentaje, vigencia y roles. Cada relación aparece una sola vez, en su nivel más cercano. |
| Modo | Cómo se expande la malla |
|---|---|
beneficiariosFinales | Solo por relaciones vigentes cuyo socio es una sociedad. Las personas naturales son el extremo de cada rama. |
ampliada | Además, cada persona natural vigente se expande hacia las otras sociedades en las que participa. |
La profundidad máxima es 50 niveles y cada página trae hasta 100 relaciones.
Otros campos legales
| Campo | Dónde aparece | Significado |
|---|---|---|
cve | extractos | Código de Verificación Electrónica del documento publicado. |
fuente | extractos | Registro del que proviene el extracto: DO o EEUD (ver Fuentes de Extractos). |
fuentes | Malla Societaria | Códigos de las fuentes presentes en los extractos de la sociedad. |
tieneCmf | legal[] (resumen), Malla Societaria, CMF | Indica si la sociedad cuenta con registro en la CMF. |
porcentaje | socios, participaciones, relaciones de la malla | Porcentaje de participación como número (ver Formatos). null si la fuente no lo informa. |
acciones, monto | Malla Societaria | Acciones o derechos y monto del aporte, tal como figuran en la fuente. |
ultimaActualizacion | Todos los endpoints de Legal | Fecha y hora en que el ayudante Legal actualizó la información del RUT. null si nunca se ha actualizado. |
CMF
Términos del endpoint CMF.
| Término | Significado |
|---|---|
origen | Registro de la CMF del que proviene la información: "Emisores de valores de oferta pública" o "Administradoras generales de fondos". |
accionistas | Accionistas informados a la CMF, con acciones suscritas, pagadas y porcentajePropiedad. |
directores | Integrantes del directorio, con su cargo y fecha de nombramiento. |
ejecutivos | Ejecutivos principales; cargoEjecutivoPrincipal indica su cargo ejecutivo (ej: "GERENTE GENERAL"). |
tramoParticipacion | Tramo de participación de un socio, tal como lo publica la CMF (ej: "10-20", "+20"). |
Compliance y Marshal
Marshal es un análisis que complementa el compliance con hallazgos en medios de prensa y detección de Personas Expuestas Políticamente (PEP). Se solicita con includeMarshal en Carga de RUT o en el webhook de resumen, o con Actualizar Marshal para un RUT ya cargado.
| Término | Dónde aparece | Significado |
|---|---|---|
marshal | compliance (resumen), Actualizar Marshal | true cuando tu plan cuenta con Marshal y el RUT está marcado con Marshal en tu cuenta. |
estadoMarshal | compliance (resumen); status en Actualizar Marshal | "PROCESADO" cuando el RUT tiene Marshal (marshal: true) y algún análisis Marshal completado, aunque sea anterior; "NO PROCESADO" en otro caso. |
| Análisis vigente | Webhook de resumen | Análisis que se reutiliza sin pedir uno nuevo. Para un RUT en consulta, el completado hoy (hora de Chile) o desde que el RUT está activo en tu cuenta; en monitoreo de Marshal, cualquier análisis completado. |
1101 | ayudantesFallidos (webhook de resumen) | El análisis Marshal falló, no hubo cupo o venció la espera de 15 minutos. |
| Análisis fallido por tiempo de espera | Actualizar Marshal, webhook de resumen | Marshal no respondió dentro de 10 minutos desde que se creó la investigación. Si la respuesta llega después, el análisis puede completarse con ese resultado. |
marshal.detectado | pepChile y familiaresPep (Detalle de Compliance) | true si Marshal detectó la condición; false si el análisis no la detectó; null si no hay análisis completado. |
| Hallazgos de Marshal | noticias (Detalle de Compliance) | Noticias encontradas por Marshal, al inicio de coincidencias. tema indica su categoría de riesgo. |
estado | Detalle de Compliance, compliance (resumen) | "PROCESADO", o "NO PROCESADO" cuando no hay un nombre con el cual buscar el RUT. |
riesgo | Detalle de Compliance, compliance (resumen) | Riesgo agregado: "free", "medium" o "critical". |
Investigaciones Marshal
Términos de Listar investigaciones, Detalle de una investigación y del bloque marshal de Cargar perfil en Compliance.
| Término | Valores |
|---|---|
estado | EN_CURSO (espera la identificación del RUT, en cola o en proceso), COMPLETADA o FALLIDA. |
motivo | Solo si FALLIDA: SIN_RAZON_SOCIAL, ERROR_ENVIO, ERROR_PROVEEDOR, TIEMPO_AGOTADO o SIN_CUPO. En el webhook de Cargar perfil en Compliance, también NO_LANZADA. |
canal | PLATFORM (plataforma), API o MONITORING (monitoreo de Marshal). |
riesgo | Nivel de riesgo del análisis, o el asignado manualmente (ej: BAJO, MEDIO, ALTO, CRÍTICO). |
indicadorPep | Indicador PEP del análisis (ej: NO, SI, POR ASOCIACIÓN). |
pais | País de la investigación, o Global si no tiene país. |
Compliance por nombre
Términos de Compliance por nombre y de Cargar perfil en Compliance.
| Término | Significado |
|---|---|
estado del perfil | EN_CURSO, COMPLETADO o FALLIDO. En la entrega del webhook, estado: "SUCCESS" indica un resultado entregado. |
toleranciaBusqueda | 0 busca el nombre exacto; 1 y 2 incluyen nombres parecidos. |
tipPersona | Tipo de persona en el resultado de la búsqueda: "natural" o "juridica". |
esPerfilNuevo | true si la carga creó un perfil nuevo; false si reutilizó uno existente, sin el cobro de una búsqueda nueva. |
Secciones fallidas
Términos del Resumen de un perfil y de su webhook.
| Término | Significado |
|---|---|
ayudanteFallido | Booleano. true cuando al menos una fuente falló durante la recolección de datos; la información de la sección afectada puede no estar al día. |
ayudantesFallidos | Códigos numéricos de las fuentes que fallaron, sin repetidos y en orden ascendente (ver tabla siguiente). Vacío cuando no hubo fallas. |
| Sección sin información | La sección alimentada por una fuente fallida conserva la última información disponible. Si nunca se obtuvo información, viaja con su estructura completa, con sus campos en null o con valores vacíos (0) según la sección; identificacion con sus campos en null y legal como []. |
| Sección ausente | La sección no viaja porque tu plan no incluye ese ayudante. No implica una falla. |
Códigos de ayudantesFallidos
| Código | Fuente | Sección afectada |
|---|---|---|
101 | Identificación (SII) | identificacion |
102 | Tamaño de empresa (solo persona jurídica) | identificacion.tamanoEmpresaSii |
201 | Judicial: causas civiles | judicial |
202 | Judicial: causas de cobranza | judicial |
203 | Judicial: causas laborales | judicial |
204 | Judicial: boletín concursal | judicial.boletinConcursal |
301 | Boletín comercial (Bolcom o Cámara de Comercio) | boletinComercial |
302 | Boletín comercial: Dicom | boletinComercial |
303 | Boletín laboral | cobranzaLaboral.boletinLaboral |
401 | Mora previsional | cobranzaLaboral.moraPrevisional |
402 | Multas laborales | cobranzaLaboral.multaLaboral |
501 | Legal | legal |
701 | Información del sistema financiero | deudaBancaria |
801 | Bienes: propiedades | bienes.propiedades |
802 | Bienes: vehículos | bienes.vehiculos |
1101 | Análisis Marshal (solo webhook) | compliance (no se modifica) |
Cada código se forma con el número del ayudante seguido de dos dígitos para la fuente: 1xx Identificación, 2xx Judicial, 3xx Boletín, 4xx Cobranza Laboral, 5xx Legal, 7xx Finanzas (información del sistema financiero), 8xx Bienes y 11xx Compliance.
Para saber cuándo aparece cada código, consulta Valores de ayudantesFallidos.
Formatos
| Tipo de dato | Formato | Ejemplo |
|---|---|---|
| Fecha | DD-MM-YYYY | 02-06-2021 |
| Fecha y hora | DD-MM-YYYY HH:mm:ss | 15-08-2026 13:45:10 |
| Porcentaje | Número con hasta 2 decimales, sin símbolo % | 70, 9.9, 0.7 |
| RUT | Sin puntos, con guion | 76123456-0 |
| Montos legales | Texto tal como figura en la fuente | "7000000" |
Indicadores Sí/No (identificacion) | Booleano; null si la fuente no lo informa | true, false |
Enlaces relacionados
Endpoints v3
- Carga de RUT - Carga de un RUT, con análisis Marshal opcional
- Resumen de un perfil - Vista consolidada de toda la información
- Webhook de resumen - Resumen entregado en tu webhook
- Malla Societaria - Socios, administradores y extractos
- Capas de la Malla Societaria - Relaciones por nivel
- Niveles de la Malla Societaria - Niveles disponibles de la malla
- CMF - Registro de la sociedad en la CMF
- Detalle de Compliance - Coincidencias por fuente y hallazgos de Marshal
- Actualizar Marshal - Nuevo análisis Marshal de un RUT ya cargado
- Cargar perfil en Compliance - Búsqueda de compliance por nombre entregada en tu webhook
- Listar perfiles - Perfiles de compliance buscados por nombre
- Listar investigaciones - Investigaciones Marshal de un RUT
Otros recursos
- Glosario de la API v2 - Términos de los demás bloques del resumen
- Guía de Migración v2 → v3
- Autenticación - Cómo obtener y usar tokens de acceso
- Preguntas Frecuentes - Respuestas a dudas comunes
- Configurar Webhooks - Configuración de los webhooks que reciben las entregas