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 y estado.
• Identificación: Datos de inscripción, actividades económicas y estado tributario.
• Finanzas: Situación de la deuda en el sistema financiero por período (actual, 6 y 12 meses), peor calificación, días de atraso y distribución de calificaciones.
• Legal: Representantes legales y fecha de última actualización.
• Boletín: Deudas del boletín y fechas de última actualización.
• Comex: Actividad de comercio exterior en tres ventanas anuales ancladas al corte de publicación de aduanet, con n° de operaciones, principal país y principal partida.
• Laboral: Variación de deuda laboral, datos de trabajadores, resoluciones laborales y fechas de última actualización.
• Judicial: Deudores morosos, edictos judiciales, boletín concursal y fechas de última actualización.
• Alerta Sheriff: Puntaje de alerta total calculado internamente y por módulos, con su clasificación.
• Alerta Sentinel: Score de tercero (Sentinel) con nota y semáforos.
• Riesgo de Compliance: Nivel de riesgo de compliance.

Endpoint

GET /v2/perfiles/:taxId/resumen

Versiones

v2 está en beta — puedes probarla, pero para producción usa GET /v1/perfiles/:taxId/resumen, la versión estable y sin fecha de deprecación. Las diferencias con v1 están en las secciones finanzas (situación de la deuda por período con la peor calificación, más el bloque codeudores_avales; se eliminan variaciones_financieras y fechas_financieras), comex (tres ventanas anuales ancladas al corte de publicación, con operaciones, principal país y principal partida) y el estado de carga (estado y subhelpers_fallidos a nivel raíz, y cada sección envuelta en { statusCode, data }). Esta página documenta el contrato de v2; te avisaremos cuando quede estable. Ver la guía de migración v1 → v2.

Parámetros de URL:

Parámetro	Tipo	Requerido	Descripción
taxId	string	Sí	Documento de la persona jurídica o natural a consultar (ej: 20XXXXXX056)

Ejemplo de Solicitud

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

Ejemplo de Respuesta

Envoltura por sección en v2

En v2, cada sección viaja envuelta en { "statusCode": "SH10", "data": { ... } } y la raíz agrega estado y subhelpers_fallidos — ver Estados de Carga. El ejemplo y las descripciones de campos de esta página muestran el contenido de data de cada sección, sin la envoltura, para mantener la legibilidad.

Nota sobre valores nulos

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

{
  "statusCode": 200,
  "data": {
    "taxId": "20100000001",
    "activo": true,
    "identificacion": {
      "tipo_documento": "RUC",
      "razon_social": "EMPRESA EJEMPLO S.A.C.",
      "ruc": "20100000001",
      "fecha_inscripcion": "2002-10-12T05:00:00.000Z",
      "fecha_inicio_actividades": "2002-10-12T05:00:00.000Z",
      "fecha_emisor_electronico": "2015-11-01T05:00:00.000Z",
      "fecha_afiliado_ple": "2014-02-01T05:00:00.000Z",
      "estado_contribuyente": "ACTIVO",
      "condicion_contribuyente": "HABIDO",
      "sistema_emision_comprobante": "MANUAL",
      "actividad_comercio_exterior": "IMPORTADOR/EXPORTADOR",
      "omisiones_tributarias": [],
      "actividades_economicas": [
        "Principal - 4510 - VENTA DE VEHÍCULOS AUTOMOTORES",
        "Secundaria 1 - 4530 - VENTA DE PARTES, PIEZAS Y ACCESORIOS"
      ],
      "comprobante_pago_electronico": "FACTURA (desde 01/11/2015),BOLETA (desde 01/11/2015)",
      "domicilio_fiscal": "AV. EJEMPLO NRO. 500 URB. SANTA CATALINA LIMA - LIMA - LA VICTORIA"
    },
    "finanzas": {
      "ultima_actualizacion": "2026-01-09T03:00:00.000Z",
      "peor_calificacion": {
        "calificacion": "NOR",
        "porcentaje": 100
      },
      "max_dias_vencidos": 0,
      "situacion": {
        "actual": {
          "periodo": "2025-12-01",
          "vigente": 160487612,
          "ref_rees": 0,
          "vencida": 0,
          "judicial": 0,
          "otros": 0,
          "directa": 160487612,
          "indirecta": 964497446,
          "exposicion_total": 1124985058,
          "linea_credito": 44773271,
          "castigada": 0,
          "garantias": 2111161250,
          "provisiones": null
        },
        "seis_meses": {
          "periodo": "2025-06-01",
          "vigente": 150000000,
          "ref_rees": 0,
          "vencida": 2412900,
          "judicial": 0,
          "otros": 0,
          "directa": 152412900,
          "indirecta": 900000000,
          "exposicion_total": 1052412900,
          "linea_credito": 40000000,
          "castigada": 0,
          "garantias": null,
          "provisiones": null
        },
        "doce_meses": null
      },
      "calificaciones_financieras": [
        {
          "porcentaje": 100,
          "calificacion": "NOR"
        },
        {
          "porcentaje": 0,
          "calificacion": "CPP"
        },
        {
          "porcentaje": 0,
          "calificacion": "DEF"
        },
        {
          "porcentaje": 0,
          "calificacion": "DUD"
        },
        {
          "porcentaje": 0,
          "calificacion": "PER"
        }
      ],
      "codeudores_avales": {
        "corte": "2025-12",
        "a_favor": {
          "total": 44793056,
          "por_aval": 44793056,
          "por_codeudor": 0,
          "avales": 1,
          "codeudores": 0,
          "contrapartes": 1,
          "vinculos": [
            {
              "rol": "aval",
              "contraparte": {
                "doc": "20567788990",
                "tipo_doc": "RUC",
                "nombre": "HOLDING RESPALDO SA"
              },
              "entidad": "BANCO A",
              "monto": 44793056,
              "calificacion": "NOR"
            }
          ]
        },
        "como_garante": {
          "total": 3322500,
          "por_aval": 3180000,
          "por_codeudor": 142500,
          "avales": 1,
          "codeudores": 1,
          "contrapartes": 2,
          "vinculos": [
            {
              "rol": "aval",
              "contraparte": {
                "doc": "20481122334",
                "tipo_doc": "RUC",
                "nombre": "AGROEXPORTADORA DEL NORTE SAC"
              },
              "entidad": "BANCO A",
              "monto": 3180000,
              "calificacion": "CPP"
            },
            {
              "rol": "codeudor",
              "contraparte": {
                "doc": "20334455667",
                "tipo_doc": "RUC",
                "nombre": "TRANSPORTES UNIDOS SRL"
              },
              "entidad": "CAJA C",
              "monto": 142500,
              "calificacion": null
            }
          ]
        }
      }
    },
    "legal": {
      "representantes_legales": [
        {
          "fecha_inicio": "2022-01-01T03:00:00.000Z",
          "cargo": "GERENTE GENERAL",
          "nombre": "PEREZ GONZALES, JUAN",
          "numero_documento": "12345678",
          "tipo_documento": "DNI",
          "participacion": 75
        }
      ],
      "ultima_actualizacion": "2026-01-01T03:00:00.000Z"
    },
    "boletin": {
      "deudas_boletin": [
        {
          "tipo": "Deuda Coactiva - SUNAT",
          "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": null,
          "variacion_doce_meses": null
        }
      ],
      "ultima_actualizacion_deuda_vencida": "2026-01-09T03:00:00.000Z",
      "ultima_actualizacion_protestos": "2026-01-09T03:00:00.000Z",
      "ultima_actualizacion_coactiva": "2026-01-01T03:00:00.000Z"
    },
    "comex": {
      "es_importador": true,
      "es_exportador": false,
      "pendiente_de_calculo": false,
      "corte_publicacion": {
        "importaciones": "2025-12",
        "exportaciones": "2025-12"
      },
      "resumen": [
        {
          "tipo": "Importaciones",
          "valor": "CIF",
          "ventanas": [
            {
              "ventana": 1,
              "desde": "2025-01",
              "hasta": "2025-12",
              "monto_soles": 1897180382.12,
              "numero_operaciones": 1640,
              "variacion_porcentaje": 2.0,
              "principal_pais": "ARGENTINA",
              "participacion_principal_pais": 51.0
            },
            {
              "ventana": 2,
              "desde": "2024-01",
              "hasta": "2024-12",
              "monto_soles": 1861471175.40,
              "numero_operaciones": 1306,
              "variacion_porcentaje": 13.0,
              "principal_pais": "CANADA",
              "participacion_principal_pais": 41.0
            },
            {
              "ventana": 3,
              "desde": "2023-01",
              "hasta": "2023-12",
              "monto_soles": 1651071166.00,
              "numero_operaciones": 1334,
              "variacion_porcentaje": null,
              "principal_pais": "ARGENTINA",
              "participacion_principal_pais": 34.0
            }
          ],
          "principal_partida": {
            "codigo": "1507100000",
            "nombre": "Aceite en bruto, incluso desgomado",
            "participacion": 41.0
          }
        },
        {
          "tipo": "Exportaciones",
          "valor": "FOB",
          "ventanas": [
            {
              "ventana": 1,
              "desde": "2025-01",
              "hasta": "2025-12",
              "monto_soles": 0,
              "numero_operaciones": 0,
              "variacion_porcentaje": null,
              "principal_pais": null,
              "participacion_principal_pais": null
            },
            {
              "ventana": 2,
              "desde": "2024-01",
              "hasta": "2024-12",
              "monto_soles": 0,
              "numero_operaciones": 0,
              "variacion_porcentaje": null,
              "principal_pais": null,
              "participacion_principal_pais": null
            },
            {
              "ventana": 3,
              "desde": "2023-01",
              "hasta": "2023-12",
              "monto_soles": 0,
              "numero_operaciones": 0,
              "variacion_porcentaje": null,
              "principal_pais": null,
              "participacion_principal_pais": null
            }
          ],
          "principal_partida": null
        }
      ],
      "ultima_actualizacion_agentes_importacion": "2026-01-02T03:00:00.000Z",
      "ultima_actualizacion_exportaciones": "2026-01-02T03:00:00.000Z",
      "ultima_actualizacion_importaciones": "2026-01-02T03:00:00.000Z"
    },
    "laboral": {
      "variacion_deuda_laboral": [],
      "datos_resoluciones_laborales": {
        "cantidad_total_actual": 5,
        "cantidad_seis_meses": 3,
        "cantidad_doce_meses": 2,
        "variacion_cantidad_seis": 2,
        "variacion_cantidad_doce": 3,
        "monto_total_actual": 125000.50,
        "monto_seis_meses": 80000.25,
        "monto_doce_meses": 50000.00,
        "variacion_monto_seis": 45000.25,
        "variacion_monto_doce": 75000.50,
        "fecha_ultimo_periodo": "02/2026",
        "fecha_seis_meses_anteriores": "08/2025",
        "fecha_doce_meses_anteriores": "02/2025"
      },
      "datos_trabajadores": [
        {
          "tipo": "Total Trabajadores y/o prestadores de servicios",
          "cantidad_ultimo_periodo": 523,
          "cantidad_seis_meses_anteriores": 515,
          "cantidad_doce_meses_anteriores": 528,
          "variacion_seis_meses": 8,
          "variacion_doce_meses": -5
        }
      ],
      "fechas_periodos_trabajadores": {
        "fecha_ultimo_periodo": "2025-11-01T03:00:00.000Z",
        "fecha_seis_meses_anteriores": "2025-05-01T04:00:00.000Z",
        "fecha_doce_meses_anteriores": "2024-11-01T03:00:00.000Z"
      },
      "ultima_actualizacion_deuda": "2026-01-09T03:00:00.000Z",
      "ultima_actualizacion_resoluciones": "2026-01-01T03:00:00.000Z",
      "ultima_actualizacion_trabajadores": "2026-01-01T03: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": 8,
        "cantidad_seis_meses_anteriores": 8,
        "cantidad_doce_meses_anteriores": 6,
        "fecha_ultimo_periodo": "01/2026",
        "fecha_seis_meses_anteriores": "07/2025",
        "fecha_doce_meses_anteriores": "01/2025",
        "variacion_seis_meses_anteriores": 0,
        "variacion_doce_meses_anteriores": 2
      },
      "boletin_concursal": false,
      "ultima_actualizacion_morosos": "2026-01-18T03:00:00.000Z",
      "ultima_actualizacion_boletin_concursal": "2026-01-18T03:00:00.000Z",
      "ultima_actualizacion_edictos": "2026-01-05T03:00:00.000Z"
    },
    "alerta_sheriff": {
      "periodo": "2026-01-01T03:00:00.000Z",
      "puntaje_total": 299.98,
      "puntaje_maximo": 400,
      "clasificacion": "Alerta media",
      "modulos_incluidos": ["Finanzas", "Judicial", "Laboral", "Boletin"],
      "omisiones_tributarias": null,
      "puntaje_finanzas": 100,
      "puntaje_maximo_finanzas": 100,
      "puntaje_judicial": null,
      "puntaje_maximo_judicial": 100,
      "puntaje_laboral": 100,
      "puntaje_maximo_laboral": 100,
      "puntaje_boletin": 100,
      "puntaje_maximo_boletin": 100,
      "boletin_concursal": false
    },
    "alerta_sentinel": {
      "nota": 0.1767,
      "semaforo_actual": 2,
      "semaforo_previo": 2,
      "semaforo_peor_mejor": 2
    },
    "alerta_compliance": "Alerta Baja"
  }
}

Descripción 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	Documento de persona Natural o Jurídica
activo	boolean	Indica si el perfil está activo en Sheriff

Módulo: Identificación

Este módulo contiene los datos de identificación y estado tributario del perfil, obtenidos desde fuentes públicas.

Campo	Tipo	Descripción
identificacion	object	Objeto con la información de identificación.
identificacion.razon_social	string	Razón social o nombre completo.
identificacion.tipo_documento	string	Tipo de documento principal (RUC, DNI o CE).
identificacion.ruc	string	Número de RUC asociado. Si el taxId es un DNI o CE, este campo mostrará el RUC de la persona natural si lo tuviera.
identificacion.fecha_inscripcion	string	Fecha de inscripción en registros públicos (ISO 8601).
identificacion.fecha_inicio_actividades	string	Fecha de inicio de actividades (ISO 8601).
identificacion.fecha_emisor_electronico	string	Fecha desde que es emisor electrónico (ISO 8601).
identificacion.fecha_afiliado_ple	string	Fecha de afiliación al Programa de Libros Electrónicos (PLE) (ISO 8601).
identificacion.estado_contribuyente	string	Estado actual del contribuyente (ej: ACTIVO).
identificacion.condicion_contribuyente	string	Condición del contribuyente (ej: HABIDO).
identificacion.sistema_emision_comprobante	string	Sistema de emisión de comprobantes que utiliza.
identificacion.actividad_comercio_exterior	string	Indica si realiza actividades de comercio exterior (ej: SIN ACTIVIDAD).
identificacion.omisiones_tributarias	array	Lista de omisiones tributarias.
identificacion.actividades_economicas	array	Lista de códigos CIIU de sus actividades económicas.
identificacion.comprobante_pago_electronico	string	Tipo de comprobante electrónico que emite.
identificacion.domicilio_fiscal	string	Dirección del domicilio fiscal registrado.

Módulo: Finanzas

Información sobre deudas del sistema financiero y microfinanciero.

Campo	Tipo	Descripción
finanzas	object	Información del sistema financiero del perfil
finanzas.ultima_actualizacion	string	Fecha de última actualización de la información del sistema financiero (ISO 8601)
finanzas.peor_calificacion	object | null	Peor calificación del último período
finanzas.peor_calificacion.calificacion	string	Código de la calificación (NOR, CPP, DEF, DUD, PER; SCAL = sin calificación)
finanzas.peor_calificacion.porcentaje	number | null	Porcentaje de la deuda en esa calificación
finanzas.max_dias_vencidos	number | null	Días de atraso máximos reportados en el último período
finanzas.situacion	object | null	Situación de la deuda por período; null si el perfil aún no fue reprocesado con el modelo nuevo
finanzas.situacion.actual	object | null	Último período disponible
finanzas.situacion.seis_meses	object | null	Período de hace 6 meses (mismo shape que actual)
finanzas.situacion.doce_meses	object | null	Período de hace 12 meses (mismo shape que actual); null si no hay histórico
finanzas.situacion.actual.periodo	string	Fecha del período (YYYY-MM-DD)
finanzas.situacion.actual.vigente	number	Deuda directa vigente (en soles)
finanzas.situacion.actual.ref_rees	number	Deuda refinanciada / reestructurada
finanzas.situacion.actual.vencida	number	Deuda vencida
finanzas.situacion.actual.judicial	number	Deuda en cobranza judicial
finanzas.situacion.actual.otros	number	Otras situaciones de deuda directa
finanzas.situacion.actual.directa	number	Deuda directa total (vigente + ref_rees + vencida + judicial + otros)
finanzas.situacion.actual.indirecta	number	Deuda indirecta (cartas fianza, avales)
finanzas.situacion.actual.exposicion_total	number	Exposición total = directa + indirecta
finanzas.situacion.actual.linea_credito	number	Línea de crédito no utilizada (cupo disponible; no suma a la exposición)
finanzas.situacion.actual.castigada	number	Deuda castigada (fuera de balance; no suma a la exposición)
finanzas.situacion.actual.garantias	number | null	Garantías recibidas; null = no reportadas
finanzas.situacion.actual.provisiones	number | null	Provisiones constituidas; null = no reportadas
finanzas.calificaciones_financieras	array	Arreglo con la distribución porcentual de la calificación crediticia.
finanzas.calificaciones_financieras[].porcentaje	number	Porcentaje de la deuda en esa calificación.
finanzas.calificaciones_financieras[].calificacion	string	Calificación crediticia (NOR, CPP, DEF, DUD, PER).
finanzas.codeudores_avales	object	Codeudores y avales del perfil, en dos sentidos; siempre presente, con listas vacías si no hay vínculos
finanzas.codeudores_avales.corte	string | null	Mes del último corte disponible del bloque (YYYY-MM); no es una serie mensual
finanzas.codeudores_avales.a_favor	object	Terceros que respaldan la deuda del perfil (lo avalan o codeudan)
finanzas.codeudores_avales.como_garante	object	Obligaciones de terceros por las que el perfil responde. Es exposición contingente: no suma a exposicion_total
finanzas.codeudores_avales.a_favor.total	number	Suma de los montos de los vínculos del sentido (en soles)
finanzas.codeudores_avales.a_favor.por_aval	number	Parte del total con rol aval
finanzas.codeudores_avales.a_favor.por_codeudor	number	Parte del total con rol codeudor
finanzas.codeudores_avales.a_favor.avales	number	Contrapartes distintas con rol aval
finanzas.codeudores_avales.a_favor.codeudores	number	Contrapartes distintas con rol codeudor
finanzas.codeudores_avales.a_favor.contrapartes	number	Contrapartes distintas del sentido (en como_garante, los terceros garantizados)
finanzas.codeudores_avales.a_favor.vinculos	array	Un vínculo por par contraparte–entidad (mismo shape en como_garante)
finanzas.codeudores_avales.a_favor.vinculos[].rol	string	aval o codeudor
finanzas.codeudores_avales.a_favor.vinculos[].contraparte	object	doc, tipo_doc y nombre de la contraparte; los documentos parciales se conservan tal cual
finanzas.codeudores_avales.a_favor.vinculos[].entidad	string | null	Entidad acreedora que reporta el vínculo
finanzas.codeudores_avales.a_favor.vinculos[].monto	number | null	Monto del vínculo (en soles); null = no reportado
finanzas.codeudores_avales.a_favor.vinculos[].calificacion	string | null	Calificación de la fuente, solo donde la entrega (los vínculos de aval); las codeudas van null

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.representantes_legales[].participacion	number | null	Porcentaje (%) de participación accionaria del relacionado en la empresa. El valor se expresa en porcentaje (p. ej. 75 = 75%). null cuando la fuente no reporta participación (p. ej. representantes de SUNAT).
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.es_importador	boolean | null	Actividad de importación en la ventana actual. null = todavía no se sabe (ver pendiente_de_calculo)
comex.es_exportador	boolean | null	Actividad de exportación en la ventana actual. null = todavía no se sabe
comex.pendiente_de_calculo	boolean	true = el indicador aún no se calcula para este perfil (distinto de "sin actividad"); en ese caso las banderas van en null
comex.corte_publicacion	object	Último mes con datos publicados por aduanet, por flujo (importaciones, exportaciones, formato YYYY-MM, null sin corte)
comex.resumen	array	Siempre dos items: Importaciones y Exportaciones
comex.resumen[].tipo	string	Importaciones o Exportaciones
comex.resumen[].valor	string	Unidad del monto: CIF (importaciones) o FOB (exportaciones). No son la misma unidad y no se suman entre sí
comex.resumen[].ventanas	array	Tres ventanas consecutivas de 12 meses cada una, ancladas al corte de publicación. Vacía si no hay corte
comex.resumen[].ventanas[].ventana	number	Número de ventana: 1 es la más reciente (termina en el corte), 2 los 12 meses anteriores, 3 los 12 previos a esos
comex.resumen[].ventanas[].desde	string	Primer mes de la ventana (YYYY-MM)
comex.resumen[].ventanas[].hasta	string	Último mes de la ventana (YYYY-MM)
comex.resumen[].ventanas[].monto_soles	number | null	Monto total de la ventana en soles, convertido mes a mes con el tipo de cambio de cada periodo. null = sin tipo de cambio disponible
comex.resumen[].ventanas[].numero_operaciones	number	Cantidad de operaciones (declaraciones) de la ventana
comex.resumen[].ventanas[].variacion_porcentaje	number | null	Variación % del monto vs la ventana anterior. null = sin base de comparación (nunca significa "sin cambio")
comex.resumen[].ventanas[].principal_pais	string | null	País principal de la ventana (origen en importaciones, destino en exportaciones)
comex.resumen[].ventanas[].participacion_principal_pais	number | null	Participación % del país principal sobre el flujo de la ventana
comex.resumen[].principal_partida	object | null	Principal partida arancelaria de la ventana actual (codigo, nombre, participacion)
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, deudas laborales y resoluciones laborales (SUNAFIL).

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_resoluciones_laborales	object	Información sobre resoluciones laborales (SUNAFIL)
laboral.datos_resoluciones_laborales.cantidad_total_actual	number	Cantidad total de resoluciones acumuladas
laboral.datos_resoluciones_laborales.cantidad_seis_meses	number	Cantidad acumulada hace 6 meses
laboral.datos_resoluciones_laborales.cantidad_doce_meses	number	Cantidad acumulada hace 12 meses
laboral.datos_resoluciones_laborales.variacion_cantidad_seis	number	Variación de cantidad vs 6 meses
laboral.datos_resoluciones_laborales.variacion_cantidad_doce	number	Variación de cantidad vs 12 meses
laboral.datos_resoluciones_laborales.monto_total_actual	number	Monto total acumulado de importes
laboral.datos_resoluciones_laborales.monto_seis_meses	number	Monto acumulado hace 6 meses
laboral.datos_resoluciones_laborales.monto_doce_meses	number	Monto acumulado hace 12 meses
laboral.datos_resoluciones_laborales.variacion_monto_seis	number	Variación de monto vs 6 meses
laboral.datos_resoluciones_laborales.variacion_monto_doce	number	Variación de monto vs 12 meses
laboral.datos_resoluciones_laborales.fecha_ultimo_periodo	string | null	Periodo actual (formato: MM/YYYY)
laboral.datos_resoluciones_laborales.fecha_seis_meses_anteriores	string | null	Periodo hace 6 meses
laboral.datos_resoluciones_laborales.fecha_doce_meses_anteriores	string | null	Periodo hace 12 meses
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 | null	Cantidad en el último periodo
laboral.datos_trabajadores[].cantidad_seis_meses_anteriores	number | null	Cantidad hace 6 meses
laboral.datos_trabajadores[].cantidad_doce_meses_anteriores	number | null	Cantidad hace 12 meses
laboral.datos_trabajadores[].variacion_seis_meses	number | null	Diferencia vs 6 meses anteriores
laboral.datos_trabajadores[].variacion_doce_meses	number | null	Diferencia vs 12 meses anteriores
laboral.fechas_periodos_trabajadores	object	Fechas de los periodos de trabajadores
laboral.fechas_periodos_trabajadores.fecha_ultimo_periodo	string | null	Fecha del último periodo (ISO 8601)
laboral.fechas_periodos_trabajadores.fecha_seis_meses_anteriores	string | null	Fecha hace 6 meses
laboral.fechas_periodos_trabajadores.fecha_doce_meses_anteriores	string | null	Fecha hace 12 meses
laboral.ultima_actualizacion_deuda	string | null	Fecha última actualización deuda laboral (ISO 8601)
laboral.ultima_actualizacion_resoluciones	string | null	Fecha última actualización resoluciones laborales (ISO 8601)
laboral.ultima_actualizacion_trabajadores	string | null	Fecha última actualización trabajadores (ISO 8601)

Módulo: Judicial

Información de edictos judiciales, boletín concursal y deudas morosas, incluyendo el Registro de Deudores Alimentarios Morosos (REDAM) y el Registro de Deudores Judiciales Morosos (REDJUM).

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: Alerta Sheriff

Calificación de riesgo calculada internamente por Sheriff basada en los diferentes módulos.

Campo	Tipo	Descripción
alerta_sheriff	object	Contiene la alerta calculada por Sheriff
alerta_sheriff.periodo	string	Periodo del cálculo (ISO 8601)
alerta_sheriff.puntaje_total	number	Puntaje total obtenido
alerta_sheriff.puntaje_maximo	number	Puntaje máximo posible
alerta_sheriff.clasificacion	string	Etiqueta visible (Sin alerta, Alerta baja, Alerta media, Alerta alta, Alerta crítica, No procesado)
alerta_sheriff.modulos_incluidos	array	Lista de módulos incluidos en el cálculo
alerta_sheriff.omisiones_tributarias	boolean	Indica si tiene omisiones tributarias
alerta_sheriff.puntaje_finanzas	number	Puntaje obtenido en finanzas
alerta_sheriff.puntaje_maximo_finanzas	number	Puntaje máximo de finanzas
alerta_sheriff.puntaje_judicial	number	Puntaje obtenido en judicial
alerta_sheriff.puntaje_maximo_judicial	number	Puntaje máximo de judicial
alerta_sheriff.puntaje_laboral	number	Puntaje obtenido en laboral
alerta_sheriff.puntaje_maximo_laboral	number	Puntaje máximo de laboral
alerta_sheriff.puntaje_boletin	number	Puntaje obtenido en boletín
alerta_sheriff.puntaje_maximo_boletin	number	Puntaje máximo de boletín
alerta_sheriff.boletin_concursal	boolean	Indica si está en boletín concursal

Módulo: Alerta Sentinel

Score de riesgo proporcionado por el proveedor externo Sentinel. Contiene información consolidada de todas las deudas del consultado según la fuente reportada, correspondiente a la última fecha de actualización.

Campo	Tipo	Descripción
alerta_sentinel	object	Contiene el puntaje de riesgo calculado por Sentinel
alerta_sentinel.nota	number | null	Nota de riesgo calculada por Sentinel
alerta_sentinel.semaforo_actual	number | null	Semáforo de riesgo actual. (Ver tabla de valores de semáforos)
alerta_sentinel.semaforo_previo	number | null	Semáforo de riesgo del periodo anterior. (Ver tabla de valores de semáforos)
alerta_sentinel.semaforo_peor_mejor	number | null	Semáforo histórico en el peor o mejor momento según tendencia. (Ver tabla de valores de semáforos)

Valores de Semáforos:

Valor	Color/Estado
0	Nulo
1	Rojo 🔴
2	Amarillo 🟡
3	Gris ⚪
4	Verde 🟢
6	Rojo Amarillo 🔴🟡
7	Rojo Verde 🔴🟢
8	Amarillo Rojo 🟡🔴
9	Amarillo Verde 🟡🟢
10	Verde Rojo 🟢🔴
11	Verde Amarillo 🟢🟡
12	Gris Rojo ⚪🔴
13	Gris Amarillo ⚪🟡
14	Gris Verde ⚪🟢
15	Blanco ⚪
16	Rojo Gris 🔴⚪
17	Amarillo Gris 🟡⚪

Módulo: Riesgo Compliance

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

Campo	Tipo	Descripción
alerta_compliance	string	Nivel de alerta de compliance (Alerta Alta, Alerta Media, Alerta Baja)