Resumen de Perfil

Este endpoint entrega un resumen consolidado de la información de riesgo y cumplimiento de una persona jurídica o persona natural. Es ideal para obtener una vista rápida y completa de un perfil sin necesidad de consultar múltiples endpoints.

El resumen de perfil incluye:

• Datos básicos: taxId, razón social y estado.
• Finanzas: Variaciones de deuda, fechas de periodos financieros y fecha de última actualización.
• Legal: Representantes legales y fecha de última actualización.
• Boletín: Deudas del boletín y fechas de última actualización.
• Comex: Resumen de importaciones y exportaciones.
• Laboral: Variación de deuda laboral, datos de trabajadores y fechas de última actualización.
• Judicial: Deudores morosos, edictos judiciales y fechas de última actualización.
• Puntaje de Riesgo: Puntaje de riesgo total y por módulos.
• Riesgo de Compliance: Nivel de riesgo de compliance.

Endpoint

GET /api/v1/perfiles/:taxId/resumen

Parámetros:

• taxId (string, obligatorio): RUC o DNI de la persona jurídica o natural a consultar. (ej: 2010XXX8056)

Ejemplo de Request

curl -X GET https://api.sheriff.pe/v1/perfiles/:taxId/resumen \
  -H "Authorization: Bearer <TU_TOKEN_JWT>"

Estructura de la Respuesta

La respuesta exitosa devuelve un objeto con dos campos principales:

• statusCode: Código HTTP de la respuesta (200 para éxito)
• data: Objeto con toda la información del perfil, organizada por módulos de riesgo

Cada módulo contiene su propia sección con los datos relevantes y la fecha de última actualización.

Nota sobre valores nulos

Si un campo devuelve null, significa que no hay información registrada en esa fuente para el periodo consultado.

Ejemplo de Response

{
  "statusCode": 200,
  "data": {
    "taxId": "2010XXX8056",
    "razon_social": "RAZON SOCIAL S.A.C.",
    "activo": true,
    "finanzas": {
      "variaciones_financieras": [
        {
          "tipo": "Total Deuda",
          "monto_ultimo_periodo": 1250000.5,
          "monto_seis_meses_anteriores": 1350000.75,
          "monto_doce_meses_anteriores": 1450000.25,
          "variacion_seis_meses": -100000.25,
          "variacion_doce_meses": -200000.75
        },
        {
          "tipo": "Vigente",
          "monto_ultimo_periodo": 1200000.0,
          "monto_seis_meses_anteriores": 1300000.0,
          "monto_doce_meses_anteriores": 1400000.0,
          "variacion_seis_meses": -100000.0,
          "variacion_doce_meses": -200000.0
        },
        {
          "tipo": "Vencida > 30 días",
          "monto_ultimo_periodo": 50000.5,
          "monto_seis_meses_anteriores": 50000.75,
          "monto_doce_meses_anteriores": 50000.25,
          "variacion_seis_meses": -0.25,
          "variacion_doce_meses": 0.25
        }
      ],
      "fechas_financieras": [
        {
          "fecha_ultimo_periodo": "2025-12-01T00:00:00.000Z",
          "fecha_seis_meses_anteriores": "2025-06-01T00:00:00.000Z",
          "fecha_doce_meses_anteriores": "2024-12-01T00:00:00.000Z"
        }
      ],
      "ultima_actualizacion": "2026-01-02T10:00:00.000Z"
    },
    "legal": {
      "representantes_legales": [
        {
          "fecha_inicio": "2018-05-20T00:00:00.000Z",
          "cargo": "GERENTE GENERAL",
          "nombre": "GARCIA PEREZ, JUAN CARLOS",
          "numero_documento": "12345678",
          "tipo_documento": "DNI"
        },
        {
          "fecha_inicio": "2022-01-10T00:00:00.000Z",
          "cargo": "APODERADO",
          "nombre": "TORRES FLORES, MARIA LUISA",
          "numero_documento": "87654321",
          "tipo_documento": "DNI"
        }
      ],
      "ultima_actualizacion": "2026-01-02T10:00:00.000Z"
    },
    "boletin": {
      "deudas_boletin": [
        {
          "tipo": "Deuda Coactiva - SUNAT",
          "monto_ultimo_periodo": 5230.4,
          "monto_seis_meses_anteriores": null,
          "monto_doce_meses_anteriores": 12000.0,
          "fecha_ultimo_periodo": "2025-11-15T00:00:00.000Z",
          "fecha_seis_meses_anteriores": null,
          "fecha_doce_meses_anteriores": "2024-12-20T00:00:00.000Z",
          "variacion_seis_meses": null,
          "variacion_doce_meses": -6769.6
        }
      ],
      "ultima_actualizacion_deuda_vencida": "2026-01-02T10:00:00.000Z",
      "ultima_actualizacion_protestos": "2026-01-02T10:00:00.000Z",
      "ultima_actualizacion_coactiva": "2026-01-02T10:00:00.000Z"
    },
    "comex": {
      "resumen": [
        {
          "tipo": "Importaciones",
          "monto_ultimo_periodo": 85000.0,
          "monto_seis_meses_anteriores": 150000.25,
          "monto_doce_meses_anteriores": 200000.5,
          "fecha_ultimo_periodo": "2025-12",
          "fecha_seis_meses_anteriores": "2025-06",
          "fecha_doce_meses_anteriores": "2024-12",
          "variacion_seis_meses": -65000.25,
          "variacion_doce_meses": -115000.5
        },
        {
          "tipo": "Exportaciones",
          "monto_ultimo_periodo": 120000.0,
          "monto_seis_meses_anteriores": 110000.0,
          "monto_doce_meses_anteriores": 95000.0,
          "fecha_ultimo_periodo": "2025-12",
          "fecha_seis_meses_anteriores": "2025-06",
          "fecha_doce_meses_anteriores": "2024-12",
          "variacion_seis_meses": 10000.0,
          "variacion_doce_meses": 25000.0
        }
      ],
      "ultima_actualizacion_agentes_importacion": "2026-01-02T10:00:00.000Z",
      "ultima_actualizacion_exportaciones": "2026-01-02T10:00:00.000Z",
      "ultima_actualizacion_importaciones": "2026-01-02T10:00:00.000Z"
    },
    "laboral": {
      "variacion_deuda_laboral": [
        {
          "tipo": "Deudas Laborales Vencidas",
          "monto_ultimo_periodo": 0,
          "monto_seis_meses_anteriores": 0,
          "monto_doce_meses_anteriores": 0,
          "fecha_ultimo_periodo": "2025-12-01T00:00:00.000Z",
          "fecha_seis_meses_anteriores": "2025-06-01T00:00:00.000Z",
          "fecha_doce_meses_anteriores": "2024-12-01T00:00:00.000Z",
          "variacion_seis_meses": 0,
          "variacion_doce_meses": 0
        }
      ],
      "datos_trabajadores": [
        {
          "tipo": "Total Trabajadores y/o prestadores de servicios",
          "cantidad_ultimo_periodo": 125,
          "cantidad_seis_meses_anteriores": 120,
          "cantidad_doce_meses_anteriores": 115,
          "variacion_seis_meses": 5,
          "variacion_doce_meses": 10
        }
      ],
      "fechas_periodos_trabajadores": {
        "fecha_ultimo_periodo": "2025-11-01T00:00:00.000Z",
        "fecha_seis_meses_anteriores": "2025-05-01T00:00:00.000Z",
        "fecha_doce_meses_anteriores": "2024-11-01T00:00:00.000Z"
      },
      "ultima_actualizacion_deuda": "2026-01-02T10:00:00.000Z",
      "ultima_actualizacion_trabajadores": "2026-01-02T10:00:00.000Z"
    },
    "judicial": {
      "deudores_morosos": {
        "monto_ultimo_periodo": null,
        "monto_seis_meses_anteriores": null,
        "monto_doce_meses_anteriores": null,
        "fecha_ultimo_periodo": null,
        "fecha_seis_meses_anteriores": null,
        "fecha_doce_meses_anteriores": null,
        "variacion_seis_meses_anteriores": null,
        "variacion_doce_meses_anteriores": null
      },
      "edictos_judiciales": {
        "cantidad_ultimo_periodo": 1,
        "cantidad_seis_meses_anteriores": 0,
        "cantidad_doce_meses_anteriores": 2,
        "fecha_ultimo_periodo": "11/2025",
        "fecha_seis_meses_anteriores": "05/2025",
        "fecha_doce_meses_anteriores": "11/2024",
        "variacion_seis_meses_anteriores": 1,
        "variacion_doce_meses_anteriores": -1
      },
      "boletin_concursal": false,
      "ultima_actualizacion_morosos": "2026-01-02T10:00:00.000Z",
      "ultima_actualizacion_boletin_concursal": "2026-01-02T10:00:00.000Z",
      "ultima_actualizacion_edictos": "2026-01-02T10:00:00.000Z"
    },
    "puntaje_riesgo": {
      "periodo": "2026-01-02T10:00:00.000Z",
      "puntaje_riesgo_total": 320,
      "puntaje_riesgo_maximo": 400,
      "clasificacion_riesgo": "Riesgo bajo",
      "modulos_incluidos": ["Finanzas", "Judicial", "Laboral", "Boletin"],
      "omisiones_tributarias": false,
      "puntaje_finanzas": 100,
      "puntaje_maximo_finanzas": 100,
      "puntaje_judicial": 20,
      "puntaje_maximo_judicial": 100,
      "puntaje_laboral": 100,
      "puntaje_maximo_laboral": 100,
      "puntaje_boletin": 100,
      "puntaje_maximo_boletin": 100,
      "boletin_concursal": false
    },
    "riesgo_compliance": "Sin Riesgo"
  }
}

Descripción de Campos

Estructura Principal

Campo	Tipo	Descripción
statusCode	number	Código HTTP de la respuesta (200 para éxito)
data	object	Objeto con toda la información del perfil

Datos Básicos

Información general del perfil consultado.

Campo	Tipo	Descripción
taxId	string	RUC o DNI de persona Natural o Jurídica
razon_social	string	Razón social o nombre de la persona Natural o Jurídica
activo	boolean	Indica si el perfil está activo en Sheriff

Módulo: Finanzas

Información sobre deudas del sistema financiero y microfinanciero.

Campo	Tipo	Descripción
finanzas	object	Contiene toda la información financiera
finanzas.variaciones_financieras	array	Arreglo con variaciones de deuda por categoría
finanzas.variaciones_financieras[].tipo	string	Tipo de deuda (Total, Vigente, Vencida 1-29 días, etc.)
finanzas.variaciones_financieras[].monto_ultimo_periodo	number | null	Monto en el último periodo (en soles)
finanzas.variaciones_financieras[].monto_seis_meses_anteriores	number | null	Monto hace 6 meses
finanzas.variaciones_financieras[].monto_doce_meses_anteriores	number | null	Monto hace 12 meses
finanzas.variaciones_financieras[].variacion_seis_meses	number | null	Diferencia vs 6 meses anteriores
finanzas.variaciones_financieras[].variacion_doce_meses	number | null	Diferencia vs 12 meses anteriores
finanzas.fechas_financieras	array	Arreglo con las fechas de los periodos consultados
finanzas.fechas_financieras[].fecha_ultimo_periodo	string	Fecha del último periodo (ISO 8601)
finanzas.fechas_financieras[].fecha_seis_meses_anteriores	string	Fecha del periodo hace 6 meses
finanzas.fechas_financieras[].fecha_doce_meses_anteriores	string	Fecha del periodo hace 12 meses
finanzas.ultima_actualizacion	string	Fecha de última actualización de datos financieros (ISO 8601)

Módulo: Legal

Información de representantes legales y apoderados.

Campo	Tipo	Descripción
legal	object	Contiene información legal de la empresa
legal.representantes_legales	array	Lista de representantes legales
legal.representantes_legales[].fecha_inicio	string	Fecha de inicio del cargo (ISO 8601)
legal.representantes_legales[].cargo	string	Cargo del representante (GERENTE GENERAL, APODERADO, etc.)
legal.representantes_legales[].nombre	string	Nombre completo del representante
legal.representantes_legales[].numero_documento	string	Número de documento de identidad
legal.representantes_legales[].tipo_documento	string	Tipo de documento (DNI, CE, etc.)
legal.ultima_actualizacion	string	Fecha de última actualización de datos legales (ISO 8601)

Módulo: Boletín

Información de deudas del boletín comercial (protestos, deuda vencida, coactiva).

Campo	Tipo	Descripción
boletin	object	Contiene información del boletín comercial
boletin.deudas_boletin	array	Lista de deudas por tipo
boletin.deudas_boletin[].tipo	string	Tipo de deuda (Deuda Coactiva - SUNAT, Deuda vencida, Documentos protestados)
boletin.deudas_boletin[].monto_ultimo_periodo	number | null	Monto en el último periodo
boletin.deudas_boletin[].monto_seis_meses_anteriores	number | null	Monto hace 6 meses
boletin.deudas_boletin[].monto_doce_meses_anteriores	number | null	Monto hace 12 meses
boletin.deudas_boletin[].fecha_ultimo_periodo	string | null	Fecha del último periodo (ISO 8601)
boletin.deudas_boletin[].fecha_seis_meses_anteriores	string | null	Fecha hace 6 meses
boletin.deudas_boletin[].fecha_doce_meses_anteriores	string | null	Fecha hace 12 meses
boletin.deudas_boletin[].variacion_seis_meses	number | null	Diferencia vs 6 meses anteriores
boletin.deudas_boletin[].variacion_doce_meses	number | null	Diferencia vs 12 meses anteriores
boletin.ultima_actualizacion_deuda_vencida	string | null	Fecha de última actualización deuda vencida (ISO 8601)
boletin.ultima_actualizacion_protestos	string | null	Fecha de última actualización protestos (ISO 8601)
boletin.ultima_actualizacion_coactiva	string | null	Fecha de última actualización coactiva (ISO 8601)

Módulo: Comercio Exterior (Comex)

Información de importaciones y exportaciones.

Campo	Tipo	Descripción
comex	object	Contiene información de comercio exterior
comex.resumen	array	Lista con resumen de importaciones y exportaciones
comex.resumen[].tipo	string	Tipo de operación (Importaciones, Exportaciones)
comex.resumen[].monto_ultimo_periodo	number	Monto en el último periodo (en soles)
comex.resumen[].monto_seis_meses_anteriores	number	Monto hace 6 meses
comex.resumen[].monto_doce_meses_anteriores	number	Monto hace 12 meses
comex.resumen[].fecha_ultimo_periodo	string	Periodo del último mes (formato: YYYY-MM)
comex.resumen[].fecha_seis_meses_anteriores	string	Periodo hace 6 meses
comex.resumen[].fecha_doce_meses_anteriores	string	Periodo hace 12 meses
comex.resumen[].variacion_seis_meses	number	Diferencia vs 6 meses anteriores
comex.resumen[].variacion_doce_meses	number	Diferencia vs 12 meses anteriores
comex.ultima_actualizacion_agentes_importacion	string | null	Fecha última actualización agentes (ISO 8601)
comex.ultima_actualizacion_exportaciones	string | null	Fecha última actualización exportaciones (ISO 8601)
comex.ultima_actualizacion_importaciones	string | null	Fecha última actualización importaciones (ISO 8601)

Módulo: Laboral

Información sobre trabajadores y deudas laborales.

Campo	Tipo	Descripción
laboral	object	Contiene información laboral
laboral.variacion_deuda_laboral	array	Lista de deudas laborales vencidas
laboral.variacion_deuda_laboral[].tipo	string	Tipo de deuda (Deudas Laborales Vencidas)
laboral.variacion_deuda_laboral[].monto_ultimo_periodo	number	Monto en el último periodo
laboral.variacion_deuda_laboral[].monto_seis_meses_anteriores	number	Monto hace 6 meses
laboral.variacion_deuda_laboral[].monto_doce_meses_anteriores	number	Monto hace 12 meses
laboral.variacion_deuda_laboral[].fecha_ultimo_periodo	string	Fecha del último periodo (ISO 8601)
laboral.variacion_deuda_laboral[].fecha_seis_meses_anteriores	string	Fecha hace 6 meses
laboral.variacion_deuda_laboral[].fecha_doce_meses_anteriores	string	Fecha hace 12 meses
laboral.variacion_deuda_laboral[].variacion_seis_meses	number	Diferencia vs 6 meses anteriores
laboral.variacion_deuda_laboral[].variacion_doce_meses	number	Diferencia vs 12 meses anteriores
laboral.datos_trabajadores	array	Lista con estadísticas de trabajadores
laboral.datos_trabajadores[].tipo	string	Tipo de trabajador (Total, Trabajadores, Pensionistas, Prestadores)
laboral.datos_trabajadores[].cantidad_ultimo_periodo	number	Cantidad en el último periodo
laboral.datos_trabajadores[].cantidad_seis_meses_anteriores	number	Cantidad hace 6 meses
laboral.datos_trabajadores[].cantidad_doce_meses_anteriores	number	Cantidad hace 12 meses
laboral.datos_trabajadores[].variacion_seis_meses	number	Diferencia vs 6 meses anteriores
laboral.datos_trabajadores[].variacion_doce_meses	number	Diferencia vs 12 meses anteriores
laboral.fechas_periodos_trabajadores	object	Fechas de los periodos de trabajadores
laboral.fechas_periodos_trabajadores.fecha_ultimo_periodo	string	Fecha del último periodo (ISO 8601)
laboral.fechas_periodos_trabajadores.fecha_seis_meses_anteriores	string	Fecha hace 6 meses
laboral.fechas_periodos_trabajadores.fecha_doce_meses_anteriores	string	Fecha hace 12 meses
laboral.ultima_actualizacion_deuda	string	Fecha última actualización deuda laboral (ISO 8601)
laboral.ultima_actualizacion_trabajadores	string	Fecha última actualización trabajadores (ISO 8601)

Módulo: Judicial

Información de deudores morosos, edictos judiciales y boletín concursal.

Campo	Tipo	Descripción
judicial	object	Contiene información judicial
judicial.deudores_morosos	object	Información de registro de deudores morosos
judicial.deudores_morosos.monto_ultimo_periodo	number | null	Monto en el último periodo
judicial.deudores_morosos.monto_seis_meses_anteriores	number | null	Monto hace 6 meses
judicial.deudores_morosos.monto_doce_meses_anteriores	number | null	Monto hace 12 meses
judicial.deudores_morosos.fecha_ultimo_periodo	string | null	Fecha del último periodo (ISO 8601)
judicial.deudores_morosos.fecha_seis_meses_anteriores	string | null	Fecha hace 6 meses
judicial.deudores_morosos.fecha_doce_meses_anteriores	string | null	Fecha hace 12 meses
judicial.deudores_morosos.variacion_seis_meses_anteriores	number | null	Diferencia vs 6 meses
judicial.deudores_morosos.variacion_doce_meses_anteriores	number | null	Diferencia vs 12 meses
judicial.edictos_judiciales	object	Información de edictos judiciales
judicial.edictos_judiciales.cantidad_ultimo_periodo	number	Cantidad en el último periodo
judicial.edictos_judiciales.cantidad_seis_meses_anteriores	number	Cantidad hace 6 meses
judicial.edictos_judiciales.cantidad_doce_meses_anteriores	number	Cantidad hace 12 meses
judicial.edictos_judiciales.fecha_ultimo_periodo	string	Periodo del último mes (formato: MM/YYYY)
judicial.edictos_judiciales.fecha_seis_meses_anteriores	string	Periodo hace 6 meses
judicial.edictos_judiciales.fecha_doce_meses_anteriores	string	Periodo hace 12 meses
judicial.edictos_judiciales.variacion_seis_meses_anteriores	number	Diferencia vs 6 meses
judicial.edictos_judiciales.variacion_doce_meses_anteriores	number	Diferencia vs 12 meses
judicial.boletin_concursal	boolean	Indica si está en el boletín concursal de INDECOPI
judicial.ultima_actualizacion_morosos	string | null	Fecha última actualización morosos (ISO 8601)
judicial.ultima_actualizacion_boletin_concursal	string | null	Fecha última actualización boletín concursal (ISO 8601)
judicial.ultima_actualizacion_edictos	string | null	Fecha última actualización edictos (ISO 8601)

Módulo: Puntaje de Riesgo

Calificación de riesgo basada en los diferentes módulos.

Campo	Tipo	Descripción
puntaje_riesgo	object	Contiene el puntaje de riesgo calculado
puntaje_riesgo.periodo	string	Periodo del cálculo (ISO 8601)
puntaje_riesgo.puntaje_riesgo_total	number	Puntaje total obtenido
puntaje_riesgo.puntaje_riesgo_maximo	number	Puntaje máximo posible
puntaje_riesgo.clasificacion_riesgo	string	Clasificación (Riesgo bajo, Riesgo medio, Riesgo alto)
puntaje_riesgo.modulos_incluidos	array	Lista de módulos incluidos en el cálculo
puntaje_riesgo.omisiones_tributarias	boolean	Indica si tiene omisiones tributarias
puntaje_riesgo.puntaje_finanzas	number	Puntaje obtenido en finanzas
puntaje_riesgo.puntaje_maximo_finanzas	number	Puntaje máximo de finanzas
puntaje_riesgo.puntaje_judicial	number	Puntaje obtenido en judicial
puntaje_riesgo.puntaje_maximo_judicial	number	Puntaje máximo de judicial
puntaje_riesgo.puntaje_laboral	number	Puntaje obtenido en laboral
puntaje_riesgo.puntaje_maximo_laboral	number	Puntaje máximo de laboral
puntaje_riesgo.puntaje_boletin	number	Puntaje obtenido en boletín
puntaje_riesgo.puntaje_maximo_boletin	number	Puntaje máximo de boletín
puntaje_riesgo.boletin_concursal	boolean	Indica si está en boletín concursal

Módulo: Riesgo Compliance

Evaluación de riesgo de cumplimiento normativo (lavado de activos, listas internacionales).

Campo	Tipo	Descripción
riesgo_compliance	string	Nivel de riesgo de compliance (Sin Riesgo, Riesgo Bajo, Riesgo Medio, Riesgo Alto)