Credit Scoring

Este endpoint permite ver y procesar Credit Scoring de un RUT.

Detalle de API

Request

• URL: /notification/creditScoring/{rut}/getByRut
• Método: GET

Parámetros

• rut (requerido): El RUT del cual se desea extraer la información. Formato del rut "12345678-9".

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/external/v1/notification/creditScoring/12345678-9/getByRut' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
  -H 'x-client-identifier: SheriffSecureClient-v1'

Response

Success

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": {
      "periodo": "2025-08",
      "inicioActividades": true,
      "porcentajeFinanzas": 0,
      "numeradorFinanzas": 0,
      "denominadorFinanzas": 0,
      "ponderacionFinanzas": 0,
      "porcentajeJudicial": 0,
      "numeradorJudicial": 0,
      "denominadorJudicial": 0,
      "quiebraJudicial": false,
      "ponderacionJudicial": 64.28571428571429,
      "porcentajeMoraPrevisional": 0,
      "casosMoraPrevisional": 0,
      "porcentajeMultasLaborales": 0,
      "montoMultasLaborales": 0,
      "porcentajeBoletinLaboral": 0,
      "montoBoletinLaboral": 0,
      "ponderacionCobranzaLaboral": 34.821428571428584,
      "porcentajeBoletinComercial": 0,
      "montoBoletinComercial": 0,
      "ponderacionBoletinComercial": 0,
      "cantidadHelpers": "3",
      "porcentajeClasificacion": 99.10714285714288,
      "etiquetaClasificacion": "High",
      "nombresHelpers": ["judicial", "commertialBulletin", "laborCollection"],
      "maxPonderacionJudicial": 150,
      "maxPonderacionBoletinComercial": 150,
      "maxPonderacionCobranzaLaboral": 150
    }
  }

  A continuación se describen los campos devueltos en la respuesta JSON.

  Campo	Tipo	Descripción
  success	boolean	Indica si la petición fue exitosa.
  data	object	Lista de objetos que representan métricas y puntajes del Credit Scoring para el RUT.

  Campos dentro de data:

  Campo	Tipo	Descripción
  periodo	string	Período del scoring (ej: "2025-08").
  inicioActividades	boolean	Indica si el contribuyente tiene inicio de actividades.
  porcentajeFinanzas	number	Porcentaje asociado al componente financiero.
  numeradorFinanzas	number	Numerador usado para cálculo financiero.
  denominadorFinanzas	number	Denominador usado para cálculo financiero.
  ponderacionFinanzas	number	Ponderación resultante del componente financiero.
  porcentajeJudicial	number	Porcentaje del componente judicial.
  numeradorJudicial	number	Numerador para cálculo judicial.
  denominadorJudicial	number	Denominador para cálculo judicial.
  quiebraJudicial	boolean	Indica si existe registro de quiebra judicial.
  ponderacionJudicial	number	Ponderación calculada del componente judicial.
  porcentajeMoraPrevisional	number	Porcentaje por mora previsional.
  casosMoraPrevisional	number	Cantidad de casos de mora previsional.
  porcentajeMultasLaborales	number	Porcentaje asociado a multas laborales.
  montoMultasLaborales	number	Monto total de multas laborales.
  porcentajeBoletinLaboral	number	Porcentaje del boletín laboral.
  montoBoletinLaboral	number	Monto asociado al boletín laboral.
  ponderacionCobranzaLaboral	number	Ponderación de cobranza laboral.
  porcentajeBoletinComercial	number	Porcentaje del boletín comercial.
  montoBoletinComercial	number	Monto asociado al boletín comercial.
  ponderacionBoletinComercial	number	Ponderación del boletín comercial.
  cantidadHelpers	string	Cantidad de helpers detectados (a veces como string).
  porcentajeClasificacion	number	Porcentaje total de clasificación.
  etiquetaClasificacion	string	Etiqueta summary de clasificación (ej: "High").
  nombresHelpers	Array<string>	Lista de helpers detectados (ej: ["judicial","commertialBulletin","laborCollection"]).
  maxPonderacionJudicial	number	Máxima ponderación permitida para judicial.
  maxPonderacionBoletinComercial	number	Máxima ponderación permitida para boletín comercial.
  maxPonderacionCobranzaLaboral	number	Máxima ponderación permitida para cobranza laboral.

  Nota: Algunos campos numéricos pueden ser 0 cuando no hay hallazgos. Los campos que indican montos o contadores pueden ser 0 o null dependiendo de la fuente.

  Errores

  400 - Solicitud inválida

  {
    "success": false,
    "code": 400,
    "error": "Solicitud inválida"
  }

  401 - No autorizado

  {
    "success": false,
    "code": 401,
    "error": "No autorizado"
  }

  403 - No tienes permiso para acceder a este recurso

  {
    "success": false,
    "code": 403,
    "error": "No tienes permiso para acceder a este recurso"
  }

  404 - Recurso no encontrado

  {
    "success": false,
    "code": 404,
    "error": "Recurso no encontrado"
  }

  408 - Tiempo de espera agotado

  {
    "success": false,
    "code": 408,
    "error": "Tiempo de espera agotado"
  }

  429 - Demasiadas solicitudes

  {
    "success": false,
    "code": 429,
    "error": "Demasiadas solicitudes"
  }

  500 - Error interno del servidor

  {
    "success": false,
    "code": 500,
    "error": "Error interno del servidor"
  }