Resumen de un RUT

Envía un RUT y recibe su resumen en el webhook que tengas configurado, en formato JSON o PDF. La solicitud responde de inmediato con un identificador, y Sheriff entrega el resumen en tu webhook cuando la información está lista.

tip

No necesitas usar Carga de RUT antes de esta solicitud. El propio proceso carga el RUT y entrega el resumen automáticamente: basta con llamar a este endpoint.

Qué cambia respecto a la v2

El body que recibes en tu webhook incluye el campo success (true en la entrega del informe, false en la notificación de error).
El informe JSON usa el contrato v3 del resumen: legal como arreglo, ayudanteFallido y ayudantesFallidos con códigos numéricos.
Si alguna fuente falla durante la carga, el informe se entrega de todas formas con ayudanteFallido: true, en lugar de reemplazarse por una notificación de error.
La solicitud acepta isMonitoring e includeMarshal; con includeMarshal, la entrega puede esperar el análisis Marshal.

Ver la Guía de Migración.

Requisitos previos

Debes tener configurado un webhook activo de tipo Resumen en la plataforma (ver Configurar Webhooks). Si no lo tienes, la solicitud responde 400.

Body de la solicitud

Valor	Tipo	Es requerido	Descripción
`rut`	`string`	Sí	RUT del que quieres obtener el resumen. Puede enviarse con o sin puntos (ej: `76123456-0`).
`format`	`string`	No	Formato de la entrega: `json` o `pdf`. Por defecto `json`.
`includeEquifax`	`bool`	No	`true` incluye la consulta a Equifax al cargar el RUT. Solo aplica a clientes con la integración de Equifax. Por defecto `false`.
`isMonitoring`	`bool`	No	Si la solicitud necesita cargar el RUT, `true` lo carga en monitoreo y `false`, como consulta. Si el RUT ya está activo en tu cuenta, no se modifica. Por defecto `false`.
`includeMarshal`	`bool`	No	`true` incorpora el análisis Marshal del RUT a la entrega (ver Análisis Marshal). Requiere que tu plan cuente con Marshal. Por defecto `false`.

Ejemplo de body JSON:

{
  "rut": "76123456-0",
  "format": "json",
  "includeEquifax": false,
  "isMonitoring": false,
  "includeMarshal": true
}

Headers requeridos

Content-Type: application/json
Authorization: Bearer {tu-token}

Ejemplo de solicitud

curl -X POST \
  'https://prod.api.thesheriff.cl/api/clients/v3/webhook/profile/resumen' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
  -d '{ "rut": "76123456-0", "format": "json" }'

Respuesta inicial

La respuesta inicial es la misma para personas naturales y jurídicas.

{
  "success": true,
  "data": {
    "identificador": 1,
    "message": "Su solicitud ha sido recibida y está siendo procesada"
  }
}

Campo	Tipo	Descripción
`success`	`bool`	Indica si la solicitud fue aceptada.
`data.identificador`	`number`	Identificador de la solicitud. Viaja también en la entrega para que puedas asociarla a esta solicitud.
`data.message`	`string`	Mensaje informativo.

Si vuelves a solicitar el mismo RUT mientras una solicitud anterior sigue pendiente (hasta 20 minutos), recibes el mismo identificador.

Si la carga del RUT se rechaza (por ejemplo, porque tu plan no tiene cupo), la solicitud responde con el error correspondiente y no se envía nada a tu webhook (ver Errores de la solicitud).

Entrega del informe

Cuando la información está lista, Sheriff hace un POST a la URL configurada en tu webhook. Sheriff no devuelve un código de estado por esta entrega: el código HTTP lo define tu servidor al responder.

URL: la que configuraste, con los parámetros identificador, rut y razonSocial agregados como query string. razonSocial se omite cuando el RUT no tiene razón social.
Headers: Content-Type: application/json (o application/pdf), Content-Disposition: attachment; filename={rut}.json (o .pdf), los headers que hayas configurado en el webhook y, si el webhook tiene autenticación OAuth, Authorization: Bearer {token}.
Intentos: la entrega se envía una sola vez, con un tiempo de espera de 30 segundos. Si tu servidor no responde a tiempo o falla, no hay reintentos: puedes obtener la información con el Resumen de un perfil o enviar una nueva solicitud a este endpoint.

Formato `json`

El body es el resumen v3 del RUT, precedido por success e identificador. Su estructura depende del tipo de persona, igual que en el Resumen de un perfil.

Campo	Tipo	Descripción
`success`	`boolean`	Siempre `true` en la entrega del informe.
`identificador`	`number`	El mismo identificador entregado al recibir la solicitud.
resto		Todos los campos de `data` del Resumen de un perfil, con la misma estructura y significado.

Entrega para persona jurídica

Los campos se describen en Respuesta para persona jurídica. En este ejemplo falló la fuente de causas civiles (201) y judicial conserva la última información disponible.

Status code (de tu servidor): 200

Example Body:

{
  "success": true,
  "identificador": 1,
  "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,
    "MontoInfocom": 0,
    "MontoBolcom": 0,
    "variacion": {
      "ultimoPeriodo": "05/2025",
      "periodoActual": "11/2025",
      "cambioPorcentual": null,
      "cambioAbsoluto": 0
    },
    "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": 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
        }
      ],
      "administradores": [
        {
          "nombre": "SOCIO FICTICIO UNO",
          "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
    }
  ],
  "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": [],
    "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": "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": 1, "riesgo": "free" },
      "noticias": { "totalResultados": 0, "riesgo": "free" }
    },
    "marshal": true,
    "estadoMarshal": "PROCESADO"
  },
  "incluyeEquifax": false,
  "ayudanteFallido": true,
  "ayudantesFallidos": [201]
}

Entrega para persona natural

Los campos se describen en Respuesta para persona natural: identificacion.tamanoEmpresaSii viaja con sus campos en null, legal trae un elemento por cada sociedad en la que participa la persona y compliance separa nombres y apellidos.

Status code (de tu servidor): 200

Example Body:

{
  "success": true,
  "identificador": 2,
  "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": [],
      "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": []
}

Formato `pdf`

El body del POST es el archivo PDF del informe (binario), con Content-Type: application/pdf y Content-Disposition: attachment; filename={rut}.pdf. Los parámetros identificador, rut y razonSocial viajan en la query string de la URL. Las secciones cuya fuente falló conservan la última información disponible; si no la hay, se muestran sin información. El PDF no incluye la lista de ayudantesFallidos.

El contenido de algunas secciones del PDF depende del tipo de persona:

Sección del PDF	Persona jurídica	Persona natural
Identificación	Tamaño de empresa, ventas anuales y trabajadores según el SII.	Tamaño de empresa, ventas y trabajadores se muestran como "No aplica".
Legal	Actuaciones societarias (extractos con fecha), socios históricos y administradores históricos.	Tabla con el nombre y el RUT de las sociedades en las que participa.

Análisis Marshal

Con includeMarshal: true, la entrega incorpora el análisis Marshal del RUT. Requiere que tu plan cuente con Marshal; de lo contrario, la solicitud responde 403. Lo que ocurre depende de la situación del RUT en tu cuenta:

Situación del RUT en tu cuenta	Qué ocurre
Tiene un análisis Marshal en curso	La entrega espera ese análisis.
Tiene Marshal y un análisis vigente ya incorporado al compliance	La entrega sale sin esperar, con ese análisis.
No tiene un análisis vigente y el RUT no estaba activo en tu cuenta	Se solicita un análisis nuevo y la entrega lo espera.
No tiene un análisis vigente y el RUT ya estaba activo en tu cuenta	No se solicita un análisis nuevo y la entrega sale sin esperar. Si el RUT ya está en tu cartera sin Marshal, tampoco se activa Marshal en él. Para activarlo o actualizarlo, usa Actualizar Marshal y luego envía esta solicitud: la entrega esperará ese análisis.

Un análisis es vigente cuando:

El RUT está cargado como consulta: se completó hoy (hora de Chile) o después de que el RUT quedó activo en tu cuenta.
El RUT está en monitoreo de Marshal: cualquier análisis completado; el monitoreo lo mantiene actualizado.

Reglas de la espera:

Solo se espera si tu plan incluye el ayudante Compliance. Sin Compliance, el análisis se solicita igual cuando corresponde, pero la entrega no lo espera.
El resumen se entrega cuando terminan la carga del RUT y el análisis Marshal (lo que ocurra al final). Un análisis que espera la consulta de identificación (SII) del RUT cuenta como en curso.
Si el análisis falla (por ejemplo, porque el RUT no tiene razón social), el resumen se entrega sin esperar el resto del plazo.
La espera máxima es de 15 minutos desde la solicitud. Si el análisis falla, no hay cupo disponible para Marshal en tu plan o se cumple el plazo, el resumen se entrega igual con el código 1101 en ayudantesFallidos y ayudanteFallido: true. El bloque compliance conserva la última información disponible.
El detalle de la investigación, incluido el motivo si falló, se consulta en Listar investigaciones.

Ejemplo (fragmento) de una entrega en la que el análisis Marshal no se completó a tiempo:

{
  "success": true,
  "identificador": 3,
  "rut": "76123456-0",
  "compliance": {
    "estado": "PROCESADO",
    "riesgo": "free",
    "marshal": true,
    "estadoMarshal": "NO PROCESADO"
  },
  "ayudanteFallido": true,
  "ayudantesFallidos": [1101]
}

En el informe, compliance.marshal y compliance.estadoMarshal indican si el RUT tiene Marshal y si tiene algún análisis completado. El detalle de los hallazgos está en el Detalle de Compliance.

Fuentes que fallan

Si una o más fuentes no responden durante la carga, el informe se entrega igual, de forma parcial, y no recibes una notificación de error por la fuente fallida:

ayudanteFallido viene en true.
ayudantesFallidos lista los códigos de las fuentes que fallaron (ver Valores de ayudantesFallidos). Si solicitaste includeMarshal y el análisis no se completó, incluye 1101.
La sección afectada conserva la última información disponible de una carga anterior.
Si nunca se obtuvo información para esa sección, la sección viaja igual, con su estructura completa: según la sección, sus campos llegan en null o con valores vacíos (0). identificacion llega con todos sus campos en null, incluido tamanoEmpresaSii, y legal, como arreglo vacío ([]).
Si el análisis Marshal no se completó (1101), compliance no cambia: conserva la última información disponible y estadoMarshal indica si hay algún análisis completado.

precaución

Una sección sin información puede llegar con contadores en 0, lo que no significa que el RUT no tenga registros. Evalúa siempre ayudanteFallido y ayudantesFallidos antes de procesar el informe.

Ejemplo (fragmento) de una entrega en la que fallaron la identificación, Legal y la información del sistema financiero, sin información previa:

{
  "success": true,
  "identificador": 4,
  "rut": "76123456-0",
  "esPersonaJuridica": true,
  "fechaCarga": "20-10-2026",
  "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
    }
  },
  "incluyeEquifax": false,
  "ayudanteFallido": true,
  "ayudantesFallidos": [101, 501, 701],
  "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 fragmento muestra solo las secciones afectadas; el resto del informe viaja con su estructura habitual. identificacion puede llegar al final del body. En el formato pdf, esas secciones se muestran sin información.

Notificación de error

Solo si el informe no se pudo construir (por ejemplo, por un error interno al armar el resumen), recibes una notificación de error en tu webhook, con el mismo método y los mismos headers configurados. Sheriff hace un POST a la URL configurada con este body:

{
  "success": false,
  "identificador": 1,
  "rut": "76123456-0",
  "error": "Detalle del error"
}

Campo	Tipo	Descripción
`success`	`boolean`	Siempre `false` en una notificación de error.
`identificador`	`number`	El mismo identificador entregado al recibir la solicitud.
`rut`	`string`	RUT consultado, en formato `12345678-9`.
`error`	`string`	Detalle del error.

Cómo distinguir una entrega de una notificación de error

Ambas llegan a tu webhook y comparten identificador y rut. Basta con evaluar success: true indica una entrega del informe y false, una notificación de error, que además trae el campo error y no incluye datos del informe. Evalúa success antes de procesar el resto del body.

Errores de la solicitud

Además de los errores comunes, la solicitud puede responder:

400 - Parámetros inválidos

Algún campo del body falta o tiene un valor inválido. isMonitoring e includeMarshal deben ser booleanos. El mensaje indica el campo rechazado: corrígelo y vuelve a enviar la solicitud.

Cuándo ocurre	Mensaje en `error`
Falta `rut` en el body	`El campo 'rut' debe enviarse en el body de la petición.`
`rut` con formato inválido o incorrecto	`El rut posee un formato inválido o es incorrecto.`
`isMonitoring` o `includeMarshal` no booleano	Indica el campo rechazado, por ejemplo: `El campo 'includeMarshal' debe ser verdadero o falso.`

{
  "success": false,
  "code": 400,
  "error": "El campo 'includeMarshal' debe ser verdadero o falso."
}

400 - Sin webhook configurado

Tu cuenta no tiene un webhook activo de tipo Resumen. Configúralo en la plataforma (ver Configurar Webhooks).

{
  "success": false,
  "code": 400,
  "error": "No tienes un webhook asociado aún. Para más información, comunícate con el soporte de Sheriff."
}

400 / 403 / 404 / 503 - Carga del perfil

El RUT necesita cargarse y tu plan o tu cuenta no lo permiten. La solicitud responde los mismos errores de Carga de RUT (cupo, plan, demo, suscripción o sandbox) y no se envía nada a tu webhook.

{
  "success": false,
  "code": 400,
  "error": "Has consumido el total de consultas disponibles en tu plan. Escribe al área comercial para solicitar más consultas"
}

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."
}

403 - Plan sin Marshal

Enviaste includeMarshal: true y tu plan no cuenta con Marshal.

{
  "success": false,
  "code": 403,
  "error": "El plan no cuenta con Marshal."
}

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."
}

Requisitos previos​

Body de la solicitud​

Headers requeridos​

Ejemplo de solicitud​

Respuesta inicial​

Entrega del informe​

Formato json​

Entrega para persona jurídica​

Entrega para persona natural​

Formato pdf​

Análisis Marshal​

Fuentes que fallan​

Notificación de error​

Errores de la solicitud​

400 - Parámetros inválidos​

400 - Sin webhook configurado​

400 / 403 / 404 / 503 - Carga del perfil​

401 - No autorizado​

403 - Plan sin Marshal​

429 - Demasiadas solicitudes​

500 - Error interno del servidor​