Casos Laborales

Este endpoint permite extraer la información de casos laborales asociada a un RUT previamente cargado en tu cuenta de Sheriff.

• No se generará ningún costo adicional al consultar información de un RUT ya cargado en la plataforma.
• Asegúrate de que el RUT esté pre-cargado en la plataforma antes de intentar extraer su información.

Detalle de API

Request

• URL: /helper/judicial/{rut}/laboral
• 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/clients/v2/helper/judicial/12345678-9/laboral?page=1' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
  -H 'x-client-identifier: SheriffSecureClient-v1'

Manejo de paginación

• page: Número de página a consultar. Por defecto es 1.Para incluir se debe ingresar en la ruta como query parameter: ?page=1.

Response

Success

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": {
      "page": 1,
      "totalPages": 1,
      "cantidad": 1,
      "casos": [
        {
          "estado": "Tramitación",
          "estadoCausa": "Sin archivar",
          "etapa": "Audiencia Única",
          "fechaIngreso": "25-07-2024 21:00:00",
          "litigantes": [
            {
              "rut": "12345678-9",
              "nombre": "NOMBRE EJEMPLO",
              "sujeto": "DTE.",
              "persona": "NATURAL",
              "abogadoDefensor": "No"
            }
          ],
          "materia": "Monitorio",
          "rit": "M-81-2024",
          "tribunal": "1er Juzgado de Letras de Melipilla",
          "sujeto": "DDO.",
          "estadoActual": "Vigente"
        }
      ],
      "ultimaActualizacion": "15-06-2024 11:11:11"
    }
  }

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

  Campo	Tipo	Descripción
  success	bool	Indica si la operación fue exitosa.
  data	object	Objeto que contiene la información de Casos Laborales asociados al RUT.

  Campos dentro de data:

  Campo	Tipo	Descripción
  page	number	Página actual de resultados.
  totalPages	number	Cantidad total de páginas disponibles.
  cantidad	number	Número total de casos encontrados (ej: 1).
  casos	array	Lista de objetos, uno por cada caso registrado en Casos Laborales.
  ultimaActualizacion	string	Fecha última actualización de información

  Estructura de cada objeto dentro de casos:

  Campo	Tipo	Descripción
  estado	string	Estado general del caso (ej: "Tramitación").
  estadoCausa	string	Estado procesal de la causa (ej: "Archivada").
  etapa	string	Etapa del proceso (ej: "0 Inicio de la Tramitación").
  fechaIngreso	string	Fecha y hora de ingreso del caso (ej: "27-10-2016 21:00:00").
  litigantes	array	Lista de litigantes relacionados al caso.
  materia	string	Materia del caso (ej: "Monitorio").
  rit	string	Identificador RIT del proceso (ej: "M-81-2024").
  tribunal	string	Nombre del tribunal.
  sujeto	string	Sujeto procesal asociado (ej: "DTE.").
  estadoActual	string	Estado actual del expediente.

  Estructura de cada elemento dentro de litigantes:

  Campo	Tipo	Descripción
  rut	string	RUT del litigante (formato: "12345678-9").
  nombre	string	Nombre completo del litigante.
  sujeto	string	Identificador del sujeto procesal (ej: "AB.DTE").
  persona	string	Tipo de persona (ej: "NATURAL" o "JURIDICA").
  abogadoDefensor	string	Indica si existe abogado defensor asociado al litigante (ej: "No", "Si").

  Nota: Los campos marcados como "No" pueden no estar presentes o ser null según disponibilidad de datos en la fuente.

  Glosario de Términos

  Para una referencia completa de valores como estado, sujeto, estadoCausa y otros campos judiciales, consulta el Glosario de Términos.

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