Casos Boletín Dicom

Este endpoint permite extraer la información de boletines comerciales de Dicom 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/boletin/{rut}/boletinDicom
• 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/boletin/12345678-9/boletinDicom'\
  -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": {
      "cantidad": 1,
      "casos": [
        {
          "fechaEquifax": "24-11-2025",
          "montoImpago": 10000,
          "deudaActiva": true,
          "nombreLibrador": "Nombre Librador",
          "tipoDeuda": "FA",
          "tipoDocumento": "FA",
          "fechaJustificacion": "24-11-2025",
          "descripcionJustificacion": "MOROSIDAD",
          "fechaVisibilidad": "24-11-2025",
          "fechaDesactivacion": null,
          "numeroCheque": "000000",
          "fechaExpiracion": "27-11-2025",
          "localidad": "Rancagua",
          "codigoMercado": "",
          "descripcionMercado": "",
          "codigoMoneda": "$",
          "tipoMotivo": ""
        }
      ],
      "cantidadConsultas": 2,
      "consultas": [
        {
          "consultadoPor": "Empresa 1",
          "consultadoA": "IC",
          "fecha": "02-09-2025"
        },
        {
          "consultadoPor": "Empresa 2",
          "consultadoA": "IC",
          "fecha": "02-07-2025"
        }
      ]
    }
  }

  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 con el número total de casos, consultas y las listas correspondientes (casos, consultas).

  Campos dentro de data:

  Campo	Tipo	Descripción
  cantidad	number	Número total de casos encontrados (ej: 1).
  casos	array	Lista de objetos, uno por cada caso registrado en el boletín.
  cantidadConsultas	number	Número total de consultas registradas en data (ej: 2).
  consultas	array	Lista de objetos con el histórico de consultas realizadas sobre el RUT.

  Estructura de cada objeto dentro de casos (Boletín Dicom):

  Campo	Tipo	Descripción
  fechaEquifax	string	Fecha registrada por Equifax.
  montoImpago	number	Monto impago informado (ej: 10000).
  deudaActiva	bool	Indica si la deuda está activa (true/false).
  nombreLibrador	string	Nombre del librador o acreedor.
  tipoDeuda	string	Código del tipo de deuda (ej: "FA").
  tipoDocumento	string	Código del tipo de documento (ej: "FA").
  fechaJustificacion	string	Fecha de justificación si aplica.
  descripcionJustificacion	string	Descripción breve de la justificación (ej: "MOROSIDAD").
  fechaVisibilidad	string	Fecha desde la cual el registro es visible.
  fechaDesactivacion	string	Fecha de desactivación o null si aún está activo.
  numeroCheque	string	Número de cheque asociado (cadena con ceros a la izquierda).
  fechaExpiracion	string	Fecha de expiración si aplica.
  localidad	string	Localidad asociada al registro (ej: "Rancagua").
  codigoMercado	string	Código del mercado o cadena vacía si no aplica.
  descripcionMercado	string	Descripción del mercado o cadena vacía.
  codigoMoneda	string	Símbolo o código de moneda (ej: "$").
  tipoMotivo	string	Texto con el motivo o tipo (puede ser cadena vacía).

  Estructura de cada objeto dentro de consultas:

  Campo	Tipo	Descripción
  consultadoPor	string	Empresa o entidad que realizó la consulta.
  consultadoA	string	Entidad o proveedor consultado (fuente).
  fecha	string	Fecha de la consulta.

  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 consulta el Glosario de Términos. En particular, revisa las definiciones de tipoDeuda, tipoDocumento, descripcionJustificacion, y otros campos del boletín Dicom.

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