21.1.1 Qué cubre este capítulo

Este capítulo documenta dos módulos que conviven en IAegis y que, aunque son independientes entre sí, comparten un objetivo: dar visibilidad sobre quién trabaja en tu contrato y cómo se está comportando la siniestralidad. El primero, Siniestralidad, consolida los indicadores del DS 67 (el reglamento que regula la cotización adicional según el riesgo efectivo de la empresa). El segundo, Personal Externo, construye el padrón de trabajadores de empresas contratistas y subcontratistas que operan en tu frente de trabajo.

A lo largo del capítulo verás que un mismo dato alimenta decisiones de gestión: la dotación y las horas-hombre del personal externo son la base sobre la que el módulo de Siniestralidad calcula los índices de frecuencia y gravedad. Por eso conviene leer las dos partes de corrido: al terminar sabrás cargar el cierre mensual de un contrato, interpretar el diagnóstico que genera la IA y mantener vigente el padrón de personal externo, incluida su importación masiva desde una planilla de Excel.

21.1.2 Los dos módulos y para quién son

El módulo de Siniestralidad se accede desde la ruta /siniestralidad y es una pantalla única, sin sub-rutas: un dashboard que muestra los indicadores DS 67, el desglose por género, la analítica de la naturaleza de los siniestros y el historial de cierres mensuales. Desde ahí mismo se carga el cierre de cada período y se consulta el análisis generado por inteligencia artificial.

El módulo de Personal Externo tiene dos puntos de entrada que muestran la misma pantalla: la vista de Registros (/records/external-personnel) y la vista de Administración (/admin/external-personnel). La única diferencia funcional entre ambas es el destino del botón de volver: en la primera vuelve a /records y en la segunda a /admin.

Estos módulos están pensados para perfiles distintos según el trabajo:

Antes de empezar a operar, asegúrate de reunir estos requisitos previos:

• Una sesión iniciada en IAegis con un rol que incluya los permisos correspondientes.
• Una empresa activa seleccionada en la barra superior y, para casi todo lo operativo, un contrato activo.
• Para Siniestralidad, el módulo habilitado a nivel de la organización y, si vas a cargar datos, el desglose de horas-hombre y días perdidos del mes a mano.
• Para Personal Externo, los sub-contratos ya creados (se asignan al dar de alta o importar) y, si vas a importar, la planilla completa.

Al terminar el capítulo sabrás: leer los indicadores DS 67 y las tres zonas del gauge, cargar y corregir un cierre mensual, interpretar el diagnóstico IA, y mantener el padrón externo con altas individuales, importación masiva, edición y bajas.

21.1.3 Permisos y accesos

La regla de acceso es sencilla y conviene memorizarla antes de operar, porque explica la mayoría de los mensajes que verás.

En Siniestralidad existen dos permisos:

Además, los perfiles SuperAdmin y Tenant Admin siempre pueden ver y gestionar. El permiso de gestión controla tres cosas visibles: el botón Cierre Mensual, la columna Acciones de la tabla de historial y el botón Cargar Datos que aparece cuando se trabaja sin un contrato activo.

En Personal Externo:

El módulo de Siniestralidad además debe estar habilitado a nivel de la organización. Si no lo está, verás un mensaje de módulo deshabilitado. Si no hay empresa activa, se mostrará un mensaje de contexto requerido; y si no tienes el permiso de lectura, el texto centrado "Sin permisos para acceder a Siniestralidad".

21.2.1 Qué mide el módulo

El módulo de Siniestralidad mide, para un contrato o para la empresa completa, cuántos accidentes hubo, cuántos días se perdieron y cómo eso se traduce en los índices que la legislación chilena exige informar. Concretamente, a partir de los cierres mensuales que tú cargas, el sistema calcula:

• El Índice de Frecuencia (IF): cuántos accidentes con tiempo perdido ocurren por cada millón de horas-hombre trabajadas.
• El Índice de Gravedad (IG): cuántos días se pierden por cada millón de horas-hombre.
• La Tasa de Siniestralidad: el porcentaje que determina si la empresa está en zona de rebaja o de recargo de su cotización adicional.
• La proyección de cotización adicional: cuánto debería cotizar la empresa según su siniestralidad, partiendo de una base de 0,95 % y sumando el recargo según el tramo.
• Indicadores complementarios como el peso de la siniestralidad de origen psicosocial (Ley Karin), el ratio de precursores y los días sin accidentes.

Todo esto se presenta en un dashboard con gráficos y, además, se resume en un diagnóstico ejecutivo generado por IA que proyecta escenarios a 3, 6 y 12 meses.

21.2.2 El DS 67 y los indicadores calculados

El DS 67 de 1999 reglamenta, dentro de la Ley 16.744, la cotización adicional diferenciada: las empresas cotizan un porcentaje base y, según su siniestralidad efectiva, ese porcentaje sube o baja. La idea es simple de entender: quien se accidenta menos, paga menos; quien se accidenta más, paga más.

El cálculo que hace IAegis, documentado en la utilidad calculadoraDS67.ts, es el siguiente:

La proyección de cotización merece una aclaración. El sistema parte de la base legal de 0,95 % y le suma un recargo escalonado según la tasa de siniestralidad. Los tramos son: hasta 8 % no hay recargo; de 8 % a 16 % suma 0,34; de 16 % a 32 % suma 0,85; de 32 % a 64 % suma 1,7; y sobre 64 % suma 3,4. En la práctica, una empresa con tasa 20 % proyecta una cotización de 0,95 + 0,85 = 1,80 %, mientras que una con tasa 5 % se queda en la base de 0,95 %. Esa diferencia de casi un punto porcentual sobre la masa salarial es dinero real, y es exactamente lo que motiva a mantener la siniestralidad baja.

Los términos que conviene dominar desde ahora son:

• CTP: accidente con tiempo perdido (la persona no puede volver a trabajar de inmediato).
• STP: accidente sin tiempo perdido (la persona sigue trabajando, pero el evento queda registrado).
• AT: días perdidos por accidentes del trabajo.
• EP: días perdidos por enfermedad profesional.

21.2.3 Cómo acceder a Siniestralidad

Figura 21.1 — Dashboard de Siniestralidad con gauge DS 67, cotización, género ESG, analítica y tabla de cierres

21.3.1 Lectura del gauge y la cotización proyectada

La columna izquierda del dashboard está dominada por el gauge de Tasa de Siniestralidad, un medidor semicircular que ubica el porcentaje en una de tres zonas:

Debajo del gauge se muestra la "Cotizacion Proyectada" como un porcentaje con dos decimales. Parte de 0,95 % (la base) y le suma el recargo según el tramo de la tasa. Es el dato que conecta directamente con el DS 67: cuanto más alta la tasa, más alta la cotización adicional proyectada.

Figura 21.2 — Gauge de Tasa de Siniestralidad y sus tres zonas de color

21.3.2 Desglose ESG por género

Bajo el gauge hay un bloque de "Exposición al Riesgo por Género (ESG · R-SGI-020)" que responde al requerimiento de desglosar la exposición por género. Muestra barras con los porcentajes de horas-hombre masculinas y femeninas (HH ♂ % / HH ♀ %) y sus totales absolutos. Si cargaste la dotación por género en el cierre, también aparecen los porcentajes de trabajadores (Trab. ♂ % / Trab. ♀ %) con el número de hombres y mujeres del último período.

21.3.3 Analítica de naturaleza y precursores

La columna derecha trae dos bloques de analítica:

• "Naturaleza del Siniestro": un gráfico de torta con los días perdidos clasificados en Accidentes (AT), Enfermedad (EP) y Ley Karin / Salud. Solo se dibujan las categorías con valor mayor que cero, y el pie muestra el total "Dias Perdidos: N".
• "Analisis de Precursores": el ratio STP : 1 CTP. Si el ratio supera 10, la leyenda es "ALTA PROBABILIDAD DE EVENTO GRAVE"; en caso contrario, "RATIO BAJO CONTROL".

Acompañan dos tarjetas con los valores numéricos de "IF (Frecuencia)" e "IG (Gravedad)", cada uno con un decimal.

21.3.4 Historial de cierres mensuales

Si hay datos, al pie del dashboard aparece la tabla "Historial de Cierres Mensuales", ordenada por período descendente (el mes más reciente primero). Cada fila es un cierre:

21.3.5 Exportar informes

En el encabezado del dashboard hay cuatro botones de acción:

Además, el botón Cambiar Nodo (icono de lupa) abre el selector de contexto para elegir otro contrato o empresa.

21.3.6 Estado sin datos

Si el contrato activo todavía no tiene cierres mensuales, el dashboard no desaparece: el gauge y las tarjetas de IF e IG muestran valores en cero, la tabla de historial no se dibuja y el diagnóstico IA muestra su propio estado vacío. Es la forma que tiene el sistema de decirte "todavía no hay información para analizar".

Figura 21.3 — Dashboard de Siniestralidad sin cierres: indicadores en cero y diagnóstico vacío

21.4.1 Abrir el formulario

El cierre mensual se captura en un modal llamado "Cierre Mensual Estadistico" (cuando creas) o "Editar Cierre Mensual" (cuando editas), con el subtítulo "Nodo: <contrato>".

Figura 21.4 — Formulario "Cierre Mensual Estadistico" con sus secciones

21.4.2 Campos generales y desglose ESG

La sección general pide dos campos obligatorios:

Luego viene la sección "Desglose de HH y Trabajadores por Género (ESG)":

21.4.3 Días perdidos y conteo de accidentes

La sección "Desglose de Dias Perdidos (Naturaleza)" pide cuatro campos, ninguno obligatorio:

La sección de conteo de accidentes y eventos:

21.4.4 Resumen de incidentes R-SGI-020

La última sección es "Resumen Incidentes Detallado (R-SGI-020)", pensada para el informe mensual SSOMA. Todos sus campos son opcionales y tienen el placeholder "0":

Los botones de cierre del modal son Abortar (cierra sin guardar) y Consolidar Estadisticas (crear) o Actualizar Estadisticas (editar).

21.4.5 Validación IA pre-guardado

Al pulsar Consolidar Estadisticas, el sistema ejecuta una validación híbrida y determinística (no consume IA externa): cruza los datos que cargaste contra reglas de coherencia y contra tu histórico para detectar inconsistencias o saltos bruscos.

Si hay observaciones de tipo error o warning, se abre el modal "Validación IA · Pre-guardado" con el título "N observación(es) antes de guardar" y el texto "Detecté inconsistencias o spikes vs tu histórico. Revisa antes de guardar:". Cada observación muestra un badge de severidad (CRÍTICO si es error, REVISAR si es warning, INFO si es informativa), el campo, el message y, cuando corresponde, una → suggestion.

Figura 21.5 — Modal "Validación IA · Pre-guardado" con observaciones antes de guardar

Los botones del modal son "Volver a revisar" (cierra sin guardar) y "Guardar de todos modos" (persiste pese a las observaciones).

Las reglas que disparan observaciones son, en resumen:

Qué hacer si algo falla. Si el guardado o el borrado falla, el dashboard muestra un banner rojo con el texto Error al guardar cierre mensual: <msg> o Error al eliminar cierre mensual: <msg>, según el caso, junto con un botón "Cerrar". Lee el detalle del mensaje: casi siempre se trata de un problema de permisos o de conexión. Corrige el contexto y reintenta; si el error persiste, contacta al administrador.

21.5.1 El Diagnóstico IA · DS 67

Al inicio del dashboard hay una tarjeta grande titulada "Diagnóstico IA · DS 67" / "Inteligencia de Siniestralidad". Se genera automáticamente al abrir la pantalla (con una caché de 30 minutos) y ofrece un resumen ejecutivo de los indicadores, con proyecciones a 3, 6 y 12 meses y escenarios de acción.

Sus estados posibles:

El badge de estado que acompaña el diagnóstico tiene cuatro valores posibles:

Figura 21.6 — Diagnóstico IA · DS 67 con proyección y escenarios

21.5.2 Cómo interpretar el diagnóstico

El cuerpo del diagnóstico se organiza en secciones, de arriba hacia abajo:

1. "Diagnóstico Ejecutivo": un párrafo con la situación actual (situation) y el resumen final (finalSummary).
2. "Highlights": una lista numerada con los puntos más relevantes.
3. Alertas (si las hay): bloque rojo "N alerta(s) · revisar" con el título y detalle de cada una (punto rojo para críticas, ámbar para warnings).
4. "Plan de Acción · N medidas priorizadas": medidas con badge de prioridad CRÍTICO, ATENCIÓN o PREVENTIVO, su detalle, el + impacto esperado y el plazo en días.
5. "Proyección DS 67": tarjetas de 3 meses / 6 meses / 12 meses con la tasa y la cotización proyectadas y una narrativa.
6. Escenarios: "Si NO actúas" (rojo) y "Si ejecutas el plan" (verde).

Al pie se lee Generado · <fecha/hora> · Modelo <modelUsed>.

Conviene leer el diagnóstico en tres tiempos. Primero, mira el badge de estado: si es rojo o ámbar, hay algo que atender hoy. Segundo, lee el "Diagnóstico Ejecutivo" y la lista de Highlights: son el resumen de una página que puedes pegar en tu reporte mensual. Tercero, baja al "Plan de Acción" y ordena las medidas por prioridad: las de badge CRÍTICO son las que debes ejecutar antes de que el escenario "Si NO actúas" se materialice.

21.5.3 Ejemplo numérico interpretado

Para leer el dashboard con criterio, conviene repasar un mes con cifras concretas:

21.6.1 Para qué sirve el padrón

El módulo de Personal Externo construye el padrón de trabajadores de empresas contratistas y subcontratistas que operan dentro de tu contrato. Cada persona queda asociada a uno o más sub-contratos y puede mantenerse activa o inactiva. El padrón se segmenta por contrato activo, un concepto que la interfaz llama "Bóveda Segregada": solo ves y gestionas el personal del contrato que tienes seleccionado.

Sirve para, entre otras cosas, saber exactamente quién está en tu frente de trabajo, mantener vigente el dato de cargo y empresa, y disponer de una fuente confiable de dotación externa para cruzar con la siniestralidad y con los registros del capítulo 2 (capacitaciones, entregas de EPP, etc.).

21.6.2 El registro desde /records/external-personnel

La vista de Registros es la puerta de entrada operativa. El encabezado dice "Padrones Externos" con el subtítulo "Bóveda Segregada" y, cuando hay contrato activo, un badge "Contrato: <nombre>".

Si no hay contrato activo, verás un banner rojo con el texto "Atención: Seleccione un Contrato en la barra superior para gestionar este padrón." y el panel de control queda deshabilitado.

Figura 21.7 — Padrones Externos: panel de ingesta y nómina local

Si el contrato activo todavía no tiene personas cargadas, la nómina muestra el estado vacío "Padrones no hallados" con el texto "Cargue una nómina local para este frente de trabajo."

Figura 21.8 — Estado vacío "Padrones no hallados" de un contrato sin personas

21.6.3 La administración desde /admin/external-personnel

La vista de Administración es idéntica en funciones, pensada para el perfil administrativo que además tiene permisos de eliminación. Aquí el mensaje de empresa requerida menciona el módulo "Padrones Externos", mientras que en la vista de Registros menciona "Personal Externo". Es una distinción solo de texto, no de comportamiento.

Sin el permiso correspondiente, verás "Acceso Denegado" / "No tienes permisos para gestionar padrones externos." con un botón "Volver".

21.8.1 La plantilla plantilla-personal-externo.xlsx

Para cargas grandes, el módulo permite importar desde un archivo de Excel. El enlace "↓ Descargar Plantilla Excel" descarga la plantilla oficial plantilla-personal-externo.xlsx, que está en la raíz del repositorio y se sirve al frontend desde la carpeta de plantillas.

La plantilla trae 4 columnas: Nombre, RUT, Cargo, Empresa. La columna Email es opcional y puedes agregarla manualmente.

Figura 21.10 — Plantilla plantilla-personal-externo.xlsx con sus columnas

21.8.2 Los tres modos de importación

Antes de cargar el archivo, elige el "Modo de importación" en el panel de ingesta:

21.8.3 Cargar el archivo y revisar el resumen

Figura 21.11 — Panel de ingesta con modos de importación, carga masiva y enlace a la plantilla

El resumen de la importación detalla: Creados, Actualizados, Existentes saltados (modo create-only), Filas sin nombre ignoradas, RUTs inválidos ignorados, RUTs duplicados dentro del archivo y Emails con formato inválido omitidos, cada uno con su cantidad y, cuando aplica, el detalle de filas.

La importación valida cada fila antes de escribir: se saltan las filas sin RUT o sin nombre, se verifica el dígito verificador del RUT y el formato del email, y se detectan los RUT duplicados dentro del propio archivo. Por eso el resumen final es tan granular: te dice exactamente qué entró, qué se omitió y por qué. Ese resumen es tu control de calidad de la carga.

Cada fila de la "Nómina Local" (columna derecha, con el contador "Personal vinculado a este contrato: N") muestra los datos de la persona y una serie de acciones según tu permiso:

La nómina tiene una barra de búsqueda con placeholder "Interceptar registro..." que filtra por nombre, RUT o empresa.

Figura 21.12 — Modal "Editar Datos" (el RUT no es editable)

El modal "Editar Datos" muestra el RUT como clave no editable y permite modificar nombre, cargo, empresa y email (con la nota "Dejar vacío para quitar el email existente."). El botón es "Guardar Cambios".

La Desactivación y la Eliminación piden confirmación:

Figura 21.13 — Modal "Confirmar Desactivación"

Figura 21.14 — Modal "Confirmar Eliminación"

21.11 Glosario

• CTP (con tiempo perdido): accidente cuya persona afectada no puede retomar su trabajo de inmediato.
• STP (sin tiempo perdido): accidente registrado cuya persona puede continuar trabajando.
• IF (Índice de Frecuencia): accidentes CTP por cada millón de horas-hombre.
• IG (Índice de Gravedad): días perdidos por cada millón de horas-hombre.
• Tasa de Siniestralidad: porcentaje que determina la zona de rebaja, básica o de recargo de la cotización adicional.
• DS 67: reglamento de la Ley 16.744 sobre cotización adicional diferenciada según siniestralidad efectiva.
• Ley Karin (Ley 21.643): normativa que releva el origen psicosocial de la siniestralidad; sus días perdidos se miden por separado.
• ESG: desglose ambiental, social y de gobernanza; aquí se usa para el desglose de exposición por género (R-SGI-020).
• R-SGI-020: informe mensual SSOMA que incluye desglose ESG y resumen de incidentes.
• Bóveda Segregada: concepto del padrón de personal externo segmentado por contrato activo.
• Sub-contrato: contrato específico dentro del contrato principal al que se asigna el personal externo.