> Mejora continua de procesos > Ciclo de vida del empleado, desde la contratación hasta la jubilación > UKG Pro > Template de datos

Su Template de datos para el ciclo de vida laboral, desde la contratación hasta la salida

UKG Pro

← Volver a la guía de mejora

Atributos del ciclo de vida laboral, desde la contratación hasta la salida(21) Actividades del ciclo de vida laboral, desde la contratación hasta la salida(15) Guías de extracción(1)

Su Template de datos para el ciclo de vida laboral, desde la contratación hasta la salida

Este Template ofrece una visión completa de los datos esenciales para analizar eficazmente el proceso desde la contratación hasta la salida. Detalla los atributos que conviene recopilar, las actividades clave que debe seguir y cómo extraer estos datos de UKG Pro. Utilice este recurso para agilizar la preparación de los datos y comenzar sin contratiempos su recorrido de Process Mining.

Atributos recomendados para recopilar
Actividades clave que debe seguir
Guía para extraer datos de UKG Pro

¿Es nuevo en los registros de eventos? Aprenda a crear un Registro de eventos para Process Mining.

Descargar Template

Atributos del ciclo de vida laboral, desde la contratación hasta la salida

Estos son los campos de datos recomendados para incluir en el Registro de eventos y obtener un análisis completo del ciclo de vida laboral, desde la contratación hasta la salida, así como información útil.

5 Obligatorio 7 Recomendado 9 Opcional

	Nombre	Descripción
	ID del empleado EmployeeId	Identificador único asignado a cada empleado, que sirve como ID del caso principal durante todo su ciclo de vida en la organización.
Descripción El ID del empleado conecta todos los eventos relacionados con esa persona, desde su solicitud inicial hasta la desvinculación final. Este identificador es fundamental para construir una vista completa, de principio a fin, de la trayectoria de cada persona. En el análisis de Process Mining, cada actividad, como «Empleado contratado», «Ascenso aprobado» o «Desvinculación iniciada», se vincula a este ID único. Esto permite analizar las rutas individuales de los empleados, comparar grupos según sus atributos y calcular con precisión la duración de cada ciclo de vida. Por qué es importante Es el identificador de caso esencial que vincula todos los eventos relacionados con un empleado y permite analizar de principio a fin el proceso desde la contratación hasta la desvinculación de cada persona. Dónde obtenerlo Es un campo esencial de UKG Pro que suele encontrarse en el perfil del empleado o en los registros de datos maestros. Consulte la documentación de UKG Pro para conocer la tabla y el nombre del campo específicos, que a menudo aparece como número de empleado o ID de persona. Ejemplos 10052198345210047
	Marca de tiempo del evento EventTimestamp	Fecha y hora exactas en que tuvo lugar un evento concreto del ciclo de vida.
Descripción La marca de tiempo del evento aporta el contexto cronológico de cada actividad y constituye la base del flujo del proceso. Registra el momento exacto en que el sistema anotó un evento, como «Oferta aceptada» o «Ascenso aprobado». En el análisis, estas marcas de tiempo se utilizan para calcular la duración entre actividades, identificar demoras y medir los tiempos de ciclo de subprocesos clave, como la contratación y la incorporación. Las marcas de tiempo precisas son fundamentales para todos los KPI basados en el tiempo y para analizar el rendimiento. Por qué es importante Este atributo es esencial para ordenar cronológicamente los eventos y calcular todas las métricas basadas en el tiempo, como los tiempos de ciclo y las duraciones. Dónde obtenerlo Se obtiene de los campos de fecha o marca de tiempo asociados a eventos específicos de UKG Pro, como «HireDate» y «TerminationDate», o de las marcas de tiempo de cambios de estado en los módulos de flujos de trabajo. Ejemplos 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	Nombre de la actividad ActivityName	Nombre del evento o hito concreto que tuvo lugar en el ciclo de vida del empleado, como «Empleado contratado» o «Evaluación del desempeño realizada».
Descripción El nombre de la actividad describe un paso o una tarea del proceso desde la contratación hasta la desvinculación. Los eventos se ordenan cronológicamente y se registran con marcas de tiempo para construir el flujo del proceso que se visualiza y analiza con Process Mining. Analizar la secuencia y la frecuencia de estas actividades permite conocer cómo se ejecuta realmente el proceso. Ayuda a identificar las rutas habituales, las desviaciones respecto al proceso estándar y los cuellos de botella entre actividades clave, como «Incorporación iniciada» y «Configuración de nómina completada». Por qué es importante Este atributo define los pasos del mapa del proceso y permite visualizar y analizar el ciclo de vida del empleado. Dónde obtenerlo Suele obtenerse de los registros de eventos, los cambios de estado de los flujos de trabajo o campos de fecha específicos de distintos módulos de UKG Pro, como los de selección de personal, incorporación y gestión del desempeño. Por lo general, se necesita una lógica de correspondencia para generar nombres de actividad estandarizados. Ejemplos Empleado contratadoEvaluación del desempeño realizadaDesvinculación iniciada
	Sistema de origen SourceSystem	Identifica el sistema del que se extrajeron los datos, que en este caso es UKG Pro.
Descripción Este atributo especifica el origen de los datos del proceso. En este caso, la fuente principal es UKG Pro, aunque un proceso desde la contratación hasta la desvinculación puede incluir datos de otros sistemas, como un sistema de seguimiento de candidaturas (ATS) o un sistema de gestión del aprendizaje (LMS). En el análisis, permite distinguir las fuentes de datos cuando intervienen varios sistemas y es fundamental para la gobernanza de datos y la resolución de problemas. Si se utiliza una sola fuente, aporta contexto esencial sobre el origen de los datos. Por qué es importante Aporta contexto esencial para la gobernanza de datos, el control de calidad y la trazabilidad, ya que identifica el origen de los datos de los eventos. Dónde obtenerlo Suele ser un valor estático («UKG Pro») que se añade durante el proceso de extracción y transformación de datos. Ejemplos UKG ProUKGPro_CoreHRUKG
	Última actualización de los datos LastDataUpdate	Marca de tiempo que indica cuándo se actualizaron o extrajeron por última vez del sistema de origen los datos de este evento.
Descripción Este atributo indica la marca de tiempo de la última extracción de datos de UKG Pro. No corresponde al momento en que ocurrió el evento de negocio, sino al momento en que el registro se incorporó a la herramienta de Process Mining. Esta información es fundamental para conocer la actualidad de los datos analizados. Permite a analistas y usuarios de negocio saber cuán actualizada está la vista del proceso, gestionar los calendarios de actualización de datos y comprobar la vigencia de las conclusiones. Por qué es importante Indica cuán actualizados están los datos, algo esencial para confiar en el análisis y tomar decisiones de negocio a tiempo. Dónde obtenerlo Esta marca de tiempo se genera y se añade a cada registro durante el proceso de extracción, transformación y carga de datos (ETL). Ejemplos 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	Departamento EmployeeDepartment	Departamento o unidad organizativa a la que está asignado el empleado.
Descripción Este atributo contiene el nombre del departamento asignado al empleado, como «Ventas», «Ingeniería» o «Finanzas». Es una dimensión organizativa clave para segmentar y comparar el rendimiento del proceso. El análisis por departamento permite comparar la ejecución del proceso entre distintas unidades de negocio. Por ejemplo, permite comprobar si el «Tiempo de ciclo de contratación» es mayor en los departamentos técnicos o si el «Cumplimiento de las evaluaciones del desempeño» varía considerablemente entre Ventas y Operaciones, y así obtener información útil para orientar las mejoras. Por qué es importante Permite realizar comparativas detalladas al filtrar y segmentar el proceso según la estructura organizativa, lo que revela diferencias entre departamentos. Dónde obtenerlo Es un campo estándar del registro laboral o del puesto del empleado en el módulo de RR. HH. central de UKG Pro. Ejemplos IngenieríaVentasRecursos Humanos
	Estado laboral EmploymentStatus	Estado laboral actual o histórico del empleado, como «Activo», «Finalizado» o «En licencia».
Descripción Este atributo indica el estado oficial del empleado en la organización en un momento determinado. Es una dimensión clave para comprender la situación general de la plantilla y filtrar el análisis por grupos específicos de empleados. Analizar los cambios en el estado laboral ayuda a modelar correctamente el proceso, por ejemplo, al distinguir entre una licencia temporal y una finalización permanente del empleo. Es fundamental para calcular las tasas de rotación y comprender los resultados de las distintas trayectorias laborales. Por qué es importante Aporta contexto esencial sobre la situación laboral de cada empleado y permite analizar con precisión la rotación y segmentar la plantilla. Dónde obtenerlo Es un campo esencial del registro maestro del empleado en el módulo de RR. HH. central de UKG Pro. Ejemplos ActivoDesvinculadoLicencia
	Fecha de contratación HireDate	La fecha oficial de inicio de la relación laboral de una persona empleada con la organización.
Descripción La fecha de contratación marca el inicio de la relación laboral de la persona empleada. Es un dato fundamental para realizar numerosos cálculos y análisis temporales relacionados con su ciclo de vida. Este atributo se utiliza para calcular la antigüedad, un dato clave para analizar la «Tasa de rotación temprana de personas empleadas». También permite realizar análisis por cohortes y comparar los patrones del ciclo de vida de quienes fueron contratados en distintos periodos. Por qué es importante Sirve de referencia para calcular la antigüedad y es esencial para los análisis por cohortes y los KPI de rotación. Dónde obtenerlo Es un campo estándar y obligatorio del registro principal de la persona empleada en el módulo Core HR de UKG Pro. Ejemplos 2022-08-152023-01-202021-05-10
	ID de la solicitud de empleo JobRequisitionId	Identificador único de la solicitud de empleo que dio inicio al proceso de contratación.
Descripción El ID de la solicitud de empleo es la referencia única de una vacante concreta. Vincula todas las actividades iniciales de selección, desde la creación y aprobación de la solicitud hasta la búsqueda de candidaturas y el envío de ofertas. Este ID es esencial para analizar el KPI «Tiempo de ciclo de contratación», ya que marca el inicio real del proceso. Permite hacer un seguimiento de todo el proceso de selección para una vacante y analizar métricas como la «Tasa de solicitudes de empleo inactivas», identificando las solicitudes que no avanzan. Por qué es importante Proporciona un punto de partida claro para el proceso de selección y permite medir con precisión los tiempos de contratación y la eficacia de las solicitudes de empleo. Dónde obtenerlo Se encuentra en el módulo de selección de personal de UKG Pro o en el sistema de seguimiento de candidaturas (ATS) conectado. Ejemplos REQ-2023-015REQ-2024-112REQ-2023-504
	Nombre del gerente ManagerName	El nombre de la persona que dirige o supervisa directamente a la persona empleada.
Descripción Este atributo identifica a la persona que dirige directamente a la persona empleada. Su función es clave en muchos eventos del ciclo de vida, como las evaluaciones de desempeño, los ascensos y la asignación de formación. El análisis por gerente permite comprender las diferencias en la ejecución de los equipos y evaluar la eficacia de quienes los dirigen. Por ejemplo, el Dashboard «Análisis del impacto de los cambios de gerente» utiliza este atributo para observar cómo afecta un cambio de gerente a las actividades posteriores. También es fundamental para el KPI «Tiempo hasta la reincorporación del gerente». Por qué es importante Permite analizar el desempeño de los procesos a nivel de equipo y evaluar el impacto de los gerentes en los eventos del ciclo de vida de las personas empleadas. Dónde obtenerlo Esta información forma parte de los datos de la estructura jerárquica de la persona empleada en el módulo Core HR de UKG Pro. Ejemplos Juan PérezMaría GarcíaChen Wei
	Puesto JobTitle	El nombre oficial del puesto de la persona empleada, como «Ingeniero de software» o «Gerente de ventas».
Descripción El nombre del puesto describe la función o el cargo de la persona empleada en la organización. Este atributo es una dimensión clave para analizar cómo varían los procesos según las funciones y los niveles de antigüedad. En los análisis, el nombre del puesto permite comparar los tiempos de incorporación de distintos perfiles, evaluar la rapidez de los ascensos o identificar si ciertos puestos registran más salidas tempranas. Esta información ayuda a adaptar los procesos de RR. HH. y los programas de apoyo a las necesidades de cada grupo de personas empleadas. Por qué es importante Permite analizar las diferencias entre los procesos del ciclo de vida según las funciones y los niveles de antigüedad. Dónde obtenerlo Es un campo estándar asociado al puesto o al registro laboral de la persona empleada en el módulo Core HR de UKG Pro. Ejemplos Ingeniero de software IIGerente sénior de productoSocio de negocio de RR. HH.
	Usuario que realizó la acción ActioningUser	Nombre o ID del usuario, normalmente un representante de RR. HH. o un responsable, que realizó la actividad en UKG Pro.
Descripción Este atributo identifica a la persona responsable de ejecutar un paso concreto del proceso, como la persona encargada de selección que envió una oferta o el responsable que aprobó un ascenso. Vincula las actividades del proceso con las personas que las realizan. En el análisis, este atributo resulta muy útil para comprender la distribución de la carga de trabajo, identificar necesidades de formación y analizar el rendimiento de cada usuario. Por ejemplo, puede ayudar a determinar si los errores de introducción de datos posteriores a «Configuración de nómina completada» se concentran en determinados usuarios y respaldar el KPI «Tasa de correcciones de datos tras la incorporación». Por qué es importante Vincula las actividades del proceso con usuarios concretos y permite analizar la carga de trabajo, comparar el rendimiento e investigar correcciones o errores. Dónde obtenerlo Suele encontrarse en los registros de auditoría o en campos como «Última modificación realizada por» de los módulos de UKG Pro. El nombre exacto del campo varía según el módulo. Ejemplos j.does.smithhr_admin
	Calificación de desempeño PerformanceRating	La calificación asignada a una persona empleada durante un ciclo de evaluación del desempeño.
Descripción La calificación de desempeño es el resultado de la actividad «Realizar evaluación del desempeño». Suele expresarse en una escala, por ejemplo, del 1 al 5, o mediante etiquetas descriptivas, como «Supera las expectativas». Cuantifica la evaluación del desempeño de una persona empleada. Este atributo permite relacionar los eventos del proceso con los resultados de desempeño. Por ejemplo, el análisis puede mostrar si las personas con mejor desempeño reciben ascensos más rápido o si existe una relación entre las calificaciones y la rotación de personal. Es fundamental para el Dashboard «Cumplimiento del ciclo de evaluación del desempeño». Por qué es importante Relaciona los eventos del proceso con los resultados de desempeño y permite analizar la eficacia de la gestión del talento y su impacto en la retención. Dónde obtenerlo Se encuentra en el módulo Performance Management de UKG Pro y está vinculado a ciclos de evaluación específicos. Ejemplos Supera las expectativasCumple las expectativasNecesita mejorar5
	Es rotación temprana IsEarlyChurn	Indicador booleano que señala si la terminación de una persona empleada ocurrió dentro de un periodo inicial predefinido, como 90 o 180 días.
Descripción Este atributo calculado identifica a las personas que dejan la organización poco después de ser contratadas. La empresa suele definir el umbral de «temprano», por ejemplo, como el primer año. El indicador simplifica el análisis del Dashboard «Información sobre la rotación durante los primeros años» y del KPI «Tasa de rotación temprana de personas empleadas». Permite filtrar y segmentar rápidamente este grupo de interés, analizar sus características y patrones del ciclo de vida, e identificar posibles problemas en la contratación o la incorporación. Por qué es importante Facilita directamente el análisis de la rotación temprana al señalar los casos de riesgo y ayudar a identificar las causas de las salidas prematuras. Dónde obtenerlo Este atributo se calcula durante la preparación de los datos. La lógica compara la diferencia entre «TerminationDate» y «HireDate» con un umbral predefinido, por ejemplo, 365 días. Ejemplos truefalse
	Fecha de terminación TerminationDate	La fecha oficial de finalización de la relación laboral de una persona empleada.
Descripción La fecha de terminación marca el final de la relación laboral de la persona empleada y de su ciclo de vida en la organización. Este atributo es necesario para calcular la antigüedad total y es un componente clave del análisis de rotación. El tiempo transcurrido entre la fecha de contratación y la fecha de terminación sirve de base para el Dashboard «Información sobre la rotación durante los primeros años» y los KPI relacionados. Por qué es importante Define el final del ciclo de vida de la persona empleada, permite calcular su antigüedad total y respalda todos los análisis relacionados con la rotación. Dónde obtenerlo Es un campo estándar del registro principal de la persona empleada en UKG Pro y se completa al finalizar el proceso de terminación. Ejemplos 2023-11-302024-02-152022-12-31
	Hora de finalización del evento EventEndTime	La marca de tiempo que indica cuándo termina una actividad con una duración medible.
Descripción En las actividades que no son instantáneas, la hora de finalización del evento registra cuándo concluyó la actividad. Se diferencia de la marca de tiempo del evento (StartTime), que indica cuándo comenzó. Contar con las horas de inicio y finalización permite calcular con precisión el tiempo de procesamiento de actividades individuales, como «Verificación de antecedentes» o «Tarea de incorporación». Así se puede analizar con más detalle en qué partes del proceso se invierte el tiempo. Por qué es importante Permite calcular con precisión el tiempo de procesamiento de cada actividad e identificar los pasos que más tiempo consumen. Dónde obtenerlo Se obtiene de los campos de fecha de finalización de UKG Pro. A menudo, es necesario vincular un evento de inicio con el evento de finalización correspondiente en los datos de origen. Ejemplos 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	Motivo de terminación TerminationReason	El motivo documentado de la salida de una persona empleada, como «Voluntaria: renuncia» o «Involuntaria: desempeño».
Descripción Este atributo registra el motivo por el que terminó la relación laboral de una persona empleada. Los motivos suelen clasificarse como voluntarios o involuntarios, con subcategorías más específicas. Es un atributo fundamental para analizar la retención y la rotación de personal. Al segmentar a las personas que dejaron la organización según el motivo de su salida, es posible conocer mejor las causas de la rotación. Por ejemplo, analizar la «Tasa de rotación temprana de personas empleadas» por motivo de terminación permite distinguir entre decisiones de contratación poco acertadas y ofertas más competitivas. Por qué es importante Aporta información clave sobre las causas de la rotación de personal y permite definir estrategias de retención específicas. Dónde obtenerlo Este campo suele registrarse durante el proceso de terminación o salida en el módulo Core HR de UKG Pro. Ejemplos Voluntaria: otra oportunidadInvoluntaria: desempeñoJubilación
	Motivo del cambio de puesto RoleChangeReason	El motivo de un cambio de puesto de una persona empleada, como «Ascenso», «Traslado lateral» o «Reorganización».
Descripción Este atributo aporta contexto a los eventos de movilidad interna. Explica por qué cambió el puesto o el cargo de una persona empleada dentro de la organización. Es esencial para el Dashboard y el KPI «Tiempo de ciclo de movilidad interna», ya que permite distinguir los ascensos de otros tipos de traslado. Analizar el proceso según el motivo puede revelar si los ascensos tardan más que los traslados laterales y ayudar a agilizar las trayectorias de desarrollo profesional. Por qué es importante Explica el contexto de los movimientos internos y permite analizar con más detalle procesos de movilidad como los ascensos y los traslados laterales. Dónde obtenerlo Esta información suele registrarse como parte de la transacción de cambio de puesto o traslado en el módulo Core HR de UKG Pro. Ejemplos AscensoTraslado lateralReorganización
	Nivel salarial SalaryGrade	El grado o la banda salarial asociados al puesto de la persona empleada.
Descripción El nivel salarial representa la remuneración correspondiente a un puesto. Es un atributo clave para analizar las actividades y tendencias relacionadas con la compensación. Este atributo es importante para analizar eventos como «Cambio de compensación» y permite hacer seguimiento del KPI «Tasa de correcciones de datos posteriores a la incorporación» si se detectan correcciones frecuentes en los niveles salariales. También permite segmentar los datos para comprobar si los tiempos de ciclo de los ascensos o las tasas de rotación varían según el nivel salarial. Por qué es importante Aporta contexto a las actividades relacionadas con la compensación y permite segmentar el proceso según el nivel salarial. Dónde obtenerlo Está disponible en el perfil laboral o de compensación de la persona empleada en el módulo Core HR de UKG Pro. Ejemplos IC3M2D1
	Nombre de la formación TrainingName	El nombre o título del curso de formación asignado a la persona empleada.
Descripción Este atributo identifica una formación o un módulo de aprendizaje específico asignado a una persona empleada. Puede tratarse de formación obligatoria sobre cumplimiento o de desarrollo de habilidades específicas para un puesto. Es un atributo clave para el Dashboard «Asignación y finalización de formación» y el KPI «Tasa de finalización de formación». Permite hacer seguimiento del avance y la eficacia de programas de formación específicos, así como analizar los tiempos de finalización de distintos cursos. Por qué es importante Permite hacer seguimiento de programas de formación específicos y analizarlos para medir el cumplimiento y la eficacia del desarrollo profesional. Dónde obtenerlo Se obtiene del módulo Learning de UKG Pro o de un sistema de gestión del aprendizaje (LMS) conectado. Ejemplos Código de conducta 2024Habilidades avanzadas de gestiónConcienciación sobre ciberseguridad
	Ubicación Location	La ubicación geográfica o la oficina donde trabaja la persona empleada.
Descripción Este atributo indica la ubicación de trabajo principal de la persona empleada, que puede ser una ciudad, un país o una oficina específica. Es una dimensión clave para analizar geográficamente los procesos de RR. HH. El análisis del desempeño de los procesos por ubicación puede revelar diferencias regionales en la eficiencia de contratación, las prácticas de incorporación o las tasas de rotación. Por ejemplo, puede comparar el «Tiempo de ciclo de contratación» de las oficinas de Nueva York y Londres para identificar buenas prácticas o cuellos de botella locales. Por qué es importante Permite segmentar geográficamente el proceso y detectar diferencias regionales en el desempeño y el cumplimiento. Dónde obtenerlo Esta información forma parte de los datos laborales o personales de la persona empleada en el módulo Core HR de UKG Pro. Ejemplos Nueva York, NYLondres, Reino UnidoRemoto

Obligatorio Recomendado Opcional

Actividades del ciclo de vida laboral, desde la contratación hasta la salida

Estos son los pasos e hitos clave que debe registrar en el Registro de eventos para descubrir y optimizar los procesos con precisión.

6 Recomendado 9 Opcional

	Actividad	Descripción
	Ascenso aprobado	Indica la aprobación formal del ascenso de un empleado, que suele incluir un cambio de puesto y, a menudo, de remuneración. Es un evento independiente que precede a la fecha efectiva del cambio.
Por qué es importante Esta actividad es clave para analizar la movilidad interna y la progresión profesional. El tiempo entre la aprobación del ascenso y su fecha efectiva puede revelar cuellos de botella administrativos en el sistema. Dónde obtenerlo Se registra como una acción laboral específica, como «Ascenso», en el historial laboral del empleado dentro del módulo de RR. HH. central. El registro incluye sus propias fechas de aprobación y de entrada en vigor. Capturar Se obtiene de la fecha de registro de una acción de ascenso en el historial laboral del empleado. Tipo de evento explicit
	Desvinculación iniciada	Representa el inicio del proceso de desvinculación y se registra cuando se introduce en el sistema una fecha futura de finalización del empleo. Este evento activa las listas de verificación y los flujos de trabajo de desvinculación.
Por qué es importante Es un hito fundamental que da inicio al proceso de salida del empleado. Analizar el tiempo entre este evento y la finalización del empleo permite evaluar la eficiencia y la integridad de los procedimientos de desvinculación. Dónde obtenerlo Suele corresponder a la creación de un registro de acción de finalización del empleo en los datos laborales del empleado, con una fecha efectiva futura. También puede marcar el inicio de un flujo de trabajo de desvinculación en un módulo específico. Capturar Se registra cuando se envía una transacción de finalización del empleo con fecha futura. Tipo de evento explicit
	Empleado contratado	Marca la creación oficial del registro del empleado en UKG Pro, donde se le asigna formalmente un ID de empleado. Este evento suele registrarse cuando un administrador de RR. HH. finaliza la contratación de una persona candidata y esta pasa a ser un empleado activo en el sistema.
Por qué es importante Este es el evento de inicio definitivo para analizar el proceso desde la contratación hasta la desvinculación. Sirve como referencia para medir el tiempo hasta alcanzar la productividad, la eficiencia de la incorporación y la antigüedad total del empleado. Dónde obtenerlo Es probable que este evento se registre en el módulo de RR. HH. central o de administración de personal. Puede identificarse por la fecha de creación del registro de empleo principal del empleado o por un registro específico de la acción de contratación en su historial laboral. Capturar Se obtiene de la fecha efectiva de la acción de contratación en la tabla del historial laboral del empleado. Tipo de evento explicit
	Evaluación del desempeño realizada	Representa la finalización de un ciclo formal de evaluación del desempeño de un empleado. El evento se registra cuando el responsable o el equipo de RR. HH. finaliza y envía el formulario de evaluación.
Por qué es importante Es un hito recurrente fundamental en el ciclo de vida del empleado. Hacer un seguimiento de su frecuencia y puntualidad permite evaluar el cumplimiento de la gestión del desempeño y su impacto en la progresión profesional. Dónde obtenerlo Se encuentra en el módulo de gestión del desempeño de UKG Pro. Puede identificarse por la fecha de finalización del formulario de evaluación o por el cambio de estado del ciclo de evaluación a «Completado». Capturar Se obtiene de la marca de tiempo de finalización de la instancia del flujo de trabajo de evaluación del desempeño. Tipo de evento explicit
	Finalización del empleo	Es el evento final del ciclo de vida del empleado y representa el fin oficial de la relación laboral. En la fecha efectiva de finalización, el registro del empleado pasa a estar inactivo en el sistema.
Por qué es importante Es el evento de fin definitivo del proceso y resulta fundamental para calcular la antigüedad final del empleado y analizar la rotación. Cierra el ciclo de su trayectoria en la organización. Dónde obtenerlo Corresponde a la fecha efectiva de la acción final de terminación en el historial laboral del empleado, dentro del módulo de RR. HH. central. Por lo general, ese día el sistema cambia el estado del empleado de activo a inactivo. Capturar Se obtiene de la fecha efectiva de la acción de terminación en el historial laboral del empleado. Tipo de evento explicit
	Incorporación del empleado completada	Hito clave que indica que se ha completado correctamente la lista de verificación o el flujo de trabajo inicial de incorporación. Esto suele significar que se han terminado todos los documentos requeridos para la contratación, las solicitudes de acceso a los sistemas y las tareas administrativas iniciales.
Por qué es importante Marca el fin de la configuración administrativa inicial y permite analizar el tiempo total del ciclo de incorporación. Indica que el empleado ya está preparado administrativamente para empezar las tareas propias de su puesto. Dónde obtenerlo Se encuentra en el módulo de incorporación. Suele deducirse de la marca de tiempo de finalización del flujo de trabajo general o del momento en que se marca como completada la última tarea obligatoria de incorporación. Capturar Se deduce de la marca de tiempo de finalización de la lista maestra de verificación de incorporación del empleado. Tipo de evento inferred
	Cambio de puesto procesado	Representa un cambio de puesto o función que no es un ascenso, como un traslado lateral o un cambio de departamento. Se registra cuando se actualizan en el sistema los datos laborales correspondientes.
Por qué es importante Analizar los cambios de puesto permite obtener información sobre la movilidad interna, la asignación del talento y la reestructuración de la organización. También ayuda a identificar cómo se desplazan los empleados dentro de la organización. Dónde obtenerlo Se obtiene del historial laboral del empleado en el módulo de RR. HH. central. Puede identificarse mediante acciones laborales como «Traslado», «Reasignación» o «Cambio de puesto», junto con sus fechas efectivas. Capturar Se identifica mediante un código de acción como «Traslado» en los datos del historial laboral del empleado. Tipo de evento explicit
	Configuración de nómina completada	Indica que se han introducido y verificado todos los datos necesarios para procesar el pago del empleado, como los datos bancarios y los formularios fiscales. Este paso es fundamental para garantizar que reciba su salario correctamente y a tiempo.
Por qué es importante Este hito es clave para medir si la persona recién contratada está lista para empezar. Las demoras en la configuración de la nómina pueden generar insatisfacción y trabajo administrativo adicional, por lo que es un indicador importante del rendimiento de la incorporación. Dónde obtenerlo Este evento puede deducirse del módulo de nómina de UKG Pro. Puede obtenerse de la fecha de finalización de una lista de verificación de preparación de nómina o de la fecha en que el estado del empleado cambia a «Listo para nómina». Capturar Se obtiene de un cambio de estado o de la marca de tiempo de finalización en el perfil de nómina del empleado. Tipo de evento inferred
	Desvinculación completada	Hito que indica que se han completado todas las tareas obligatorias de desvinculación. Incluye actividades como la devolución de activos, los cálculos finales de nómina y la revocación del acceso a los sistemas.
Por qué es importante Este evento confirma que se han tomado todas las medidas necesarias para finalizar la relación laboral de forma segura y conforme a los requisitos. Permite medir el tiempo del ciclo de desvinculación e identificar brechas de cumplimiento. Dónde obtenerlo Se deduce de la marca de tiempo de finalización de la lista de verificación o del flujo de trabajo general de desvinculación, de forma similar al evento «Incorporación del empleado completada», pero para el proceso de salida. Capturar Se deduce de la marca de tiempo de finalización de la lista maestra de verificación de desvinculación del empleado. Tipo de evento inferred
	Entrevista de salida realizada	Este evento marca la finalización de la entrevista de salida con el empleado que deja la organización. Suele registrarse como una tarea completada en una lista de verificación de desvinculación.
Por qué es importante Hacer un seguimiento de la finalización de las entrevistas de salida es importante para garantizar el cumplimiento de los requisitos de RR. HH. y recopilar retroalimentación valiosa. Permite identificar si se omite este paso clave del proceso de desvinculación. Dónde obtenerlo Es probable que este evento se encuentre en el módulo de incorporación o de asistencia de RR. HH. de UKG Pro, como una tarea específica dentro de un flujo de trabajo de desvinculación. Su registro depende de que el equipo de RR. HH. marque manualmente la tarea como completada. Capturar Se registra como una tarea completada en la lista de verificación de desvinculación del empleado. Tipo de evento explicit
	Formación asignada	Registra el momento en que se asigna a un empleado un curso de formación o un plan de aprendizaje concreto. Por lo general, esta información se registra en el módulo de gestión del aprendizaje del sistema.
Por qué es importante Esta actividad permite hacer un seguimiento del cumplimiento de la formación obligatoria y del desarrollo de los empleados. Analizar el tiempo entre la asignación y la finalización puede revelar problemas de participación o de eficacia de la formación. Dónde obtenerlo Se registra en los módulos de gestión del aprendizaje o de gestión del talento de UKG Pro. Cada asignación debe tener un registro con la fecha de asignación y el ID del empleado. Capturar Se registra cuando se asigna un curso o programa al plan de aprendizaje de un empleado. Tipo de evento explicit
	Incorporación iniciada	Indica el inicio del proceso o flujo de trabajo de incorporación de una nueva persona empleada en UKG Pro. Suele ser un evento automático o activado manualmente que asigna una lista de tareas al nuevo empleado, a su responsable y al equipo de RR. HH.
Por qué es importante El seguimiento de esta actividad permite medir el tiempo entre la fecha oficial de contratación y el inicio de la integración administrativa y cultural. Es el punto de partida para analizar la eficiencia del proceso de incorporación e identificar demoras. Dónde obtenerlo Se encuentra en el módulo de incorporación de UKG Pro. El evento puede deducirse de la fecha de creación de la lista de verificación o de la instancia del flujo de trabajo asociada al empleado. Capturar Se deduce de la marca de tiempo de creación del flujo de trabajo de incorporación o de la lista de tareas del empleado. Tipo de evento inferred
	Inicio de licencia	Marca el inicio de una licencia aprobada del empleado, por motivos médicos o personales, por ejemplo. Se registra cuando su estado cambia a inactivo o en licencia.
Por qué es importante Permite identificar los periodos de inactividad en el ciclo de vida del empleado. Es fundamental para calcular correctamente la antigüedad activa y comprender el impacto de las licencias en la progresión profesional. Dónde obtenerlo Se encuentra en el historial laboral del empleado dentro del módulo de RR. HH. central. Corresponde a una acción laboral como «Licencia», con una fecha de inicio efectiva específica. Capturar Se obtiene de la fecha efectiva de una acción de inicio de licencia en el historial laboral. Tipo de evento explicit
	Remuneración modificada	Este evento registra cualquier cambio en el salario base, la estructura de bonificaciones u otros componentes de la remuneración del empleado. Puede deberse a un ascenso, un aumento por mérito o un ajuste de mercado.
Por qué es importante Hacer un seguimiento de los cambios en la remuneración es fundamental para comprender la progresión profesional y salarial. Los ajustes frecuentes después de la contratación podrían indicar errores de introducción de datos o problemas al fijar el salario inicial. Dónde obtenerlo Se encuentra en la tabla del historial de remuneración del empleado, dentro del módulo de RR. HH. central o de nómina. Cada cambio suele registrarse con una fecha efectiva y un código de motivo. Capturar Se registra a partir de la fecha efectiva de una nueva entrada en el historial de remuneración del empleado. Tipo de evento explicit
	Responsable modificado	Este evento se genera cuando se actualiza el campo «Reporta a» o «ID del responsable» de un empleado. Representa un cambio en su línea jerárquica directa.
Por qué es importante Los cambios de responsable pueden afectar considerablemente la participación y el desempeño de los empleados. Hacer un seguimiento de este evento permite analizar su efecto en actividades posteriores, como las evaluaciones del desempeño o la retención. Dónde obtenerlo Este evento debe deducirse mediante el seguimiento de los cambios en el campo del responsable o supervisor en los datos laborales del empleado a lo largo del tiempo. Para ello, hay que comparar el ID del responsable entre registros consecutivos del mismo empleado. Capturar Se deduce al detectar un cambio en el campo «Reporta a» del historial laboral del empleado. Tipo de evento inferred

Recomendado Opcional

Guías de extracción

Cómo obtener sus datos de UKG Pro

Pasos

Requisitos previos: Asegúrese de tener Python 3.6 o una versión posterior y de haber instalado las bibliotecas requests y pandas. Puede instalarlas con pip: pip install requests pandas.
Acceso y autenticación de la API: Pida al administrador de UKG Pro que cree una cuenta de servicio. Necesitará la API Key, el User Name y la Password. La cuenta de servicio debe tener permisos para acceder a todos los endpoints de API necesarios, incluidos los de personal, nómina, incorporación, desempeño y formación.
Configure el script: Abra el script de Python proporcionado en un editor de texto o IDE. Busque la sección de configuración al principio del script y sustituya los valores de ejemplo de UKG_BASE_URL, API_KEY, USERNAME, PASSWORD y COMPANY_ID por sus credenciales y datos de entorno.
Defina el intervalo de fechas de extracción: En la sección de configuración, indique los valores de START_DATE y END_DATE. Estos determinan el período del que se extraerán los cambios y eventos de los empleados. Se recomienda empezar con un intervalo menor, como de 3 a 6 meses, para probar el script.
Ejecute el script: Ejecútelo desde la línea de comandos con python your_script_name.py. El script se autenticará, obtendrá datos de distintos endpoints de la API de UKG Pro para cada actividad y mostrará el avance en la consola.
Gestione los límites de la API: El script incluye una llamada básica a time.sleep() para respetar los límites de solicitudes de la API. Si se producen errores por exceso de solicitudes (HTTP 429), quizá deba aumentar la pausa entre llamadas.
Transforme y estandarice los datos: Cada función del script obtiene datos sin procesar para una actividad específica, selecciona los campos pertinentes y les asigna los nombres del formato estándar del Registro de eventos (EmployeeId, ActivityName, EventTimestamp, etc.).
Combine los datos de eventos: La parte principal del script llama a la función correspondiente a cada actividad y añade los datos obtenidos a una única lista maestra de eventos.
Genere el Registro de eventos: Después de procesar todas las actividades, el script reúne los datos en un DataFrame de pandas, los ordena por ID de empleado y marca de tiempo, y los guarda en un archivo CSV llamado ukg_hire_to_retire_event_log.csv.
Revise y cargue el archivo: Abra el archivo CSV generado para comprobar que los datos estén completos y tengan el formato correcto. Ya puede cargarlo en la herramienta de Process Mining.

Configuración

Credenciales de autenticación: Para la autenticación de la API, se necesitan la API Key, el User Name y la Password de una cuenta de servicio.
URL base: La UKG_BASE_URL de su instancia de UKG Pro (por ejemplo, https://service[##].ultipro.com/api).
ID de empresa: Para muchas llamadas a la API se necesita el COMPANY_ID exclusivo de su organización en UKG Pro.
Intervalo de fechas: Los parámetros START_DATE y END_DATE (en formato «YYYY-MM-DD») determinan el período de extracción. Para la primera ejecución, se recomienda un período de 3 a 6 meses para gestionar el volumen de datos y verificar los resultados.
Versiones de los endpoints de la API: El script utiliza versiones específicas de las API REST (por ejemplo, /personnel/v1/). Compruebe que su instancia de UKG Pro sea compatible con estas versiones.
Dependencias de los módulos: Para extraer ciertas actividades, su organización debe tener licencia y utilizar los módulos correspondientes de UKG Pro, como Onboarding, Learning y Performance Management. Si no se utiliza un módulo, no se extraerán las actividades asociadas.

Consulta de ejemplo python

import requests
import pandas as pd
import datetime
import time
import json

class=class="hl-string">"hl-comment"># --- CONFIGURATION --- #
UKG_BASE_URL = class="hl-string">"https://service[YourServiceNumber].ultipro.com/api"
API_KEY = class="hl-string">"[Your_API_Key]"
USERNAME = class="hl-string">"[Your_Service_Account_Username]"
PASSWORD = class="hl-string">"[Your_Service_Account_Password]"
COMPANY_ID = class="hl-string">"[Your_Company_ID]"
START_DATE = (datetime.date.today() - datetime.timedelta(days=180)).strftime(class="hl-string">'%Y-%m-%d')
END_DATE = datetime.date.today().strftime(class="hl-string">'%Y-%m-%d')

class=class="hl-string">"hl-comment"># --- API HELPER FUNCTION --- #

def get_ukg_data(endpoint, params=None):
    class="hl-string">"""Helper function to handle authentication and pagination for UKG API calls."""
    auth_data = json.dumps({
        class="hl-string">"username": USERNAME,
        class="hl-string">"password": PASSWORD,
        class="hl-string">"apiKey": API_KEY
    })
    headers = {class="hl-string">'Content-Type': class="hl-string">'application/json'}
    
    class=class="hl-string">"hl-comment"># Authenticate and get token
    try:
        auth_response = requests.post(fclass="hl-string">"{UKG_BASE_URL}/v1/login", data=auth_data, headers=headers)
        auth_response.raise_for_status()
        token = auth_response.json().get(class="hl-string">'token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Authentication failed: {e}")
        return []

    all_records = []
    page = 1
    per_page = 100
    
    api_headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}'}
    
    while True:
        if params is None:
            params = {}
        params.update({class="hl-string">'page': page, class="hl-string">'per_page': per_page})
        
        try:
            response = requests.get(fclass="hl-string">"{UKG_BASE_URL}{endpoint}", headers=api_headers, params=params)
            response.raise_for_status()
            data = response.json()
            
            if isinstance(data, list) and data:
                all_records.extend(data)
                if len(data) < per_page:
                    break class=class="hl-string">"hl-comment"># Last page
                page += 1
            elif isinstance(data, dict) and class="hl-string">'results' in data:
                all_records.extend(data[class="hl-string">'results'])
                if len(data[class="hl-string">'results']) < per_page:
                    break class=class="hl-string">"hl-comment"># Last page
                page += 1
            else:
                 break class=class="hl-string">"hl-comment"># No more data

            time.sleep(1) class=class="hl-string">"hl-comment"># Respect rate limits

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from {endpoint}: {e}")
            break
            
    return all_records

class=class="hl-string">"hl-comment"># --- ACTIVITY EXTRACTION FUNCTIONS --- #

def get_employee_hired_events():
    print(class="hl-string">"Fetching 'Employee Hired' events...")
    events = []
    class=class="hl-string">"hl-comment"># Use employee changes API to find hire events
    params = {class="hl-string">'action': class="hl-string">'HIRE', class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') and record.get(class="hl-string">'effectiveDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Employee Hired',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                class="hl-string">'JobRequisitionId': record.get(class="hl-string">'jobRequisitionId'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'supervisorName'),
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
    return events

def get_onboarding_events():
    print(class="hl-string">"Fetching 'Onboarding' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Onboarding module. This is a conceptual endpoint.
    class=class="hl-string">"hl-comment"># You may need to adjust the endpoint based on your UKG configuration.
    data = get_ukg_data(fclass="hl-string">'/onboarding/v1/employee-onboarding-activities?start-date={START_DATE}&end-date={END_DATE}')
    for record in data:
        if record.get(class="hl-string">'workflow') == class="hl-string">'New Hire Onboarding':
            if record.get(class="hl-string">'dateAssigned'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Onboarding Initiated',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateAssigned'),
                    class="hl-string">'ActioningUser': record.get(class="hl-string">'assignedBy'),
                    class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                    class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                    class="hl-string">'ManagerName': record.get(class="hl-string">'managerName'),
                    class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
                })
            if record.get(class="hl-string">'dateCompleted'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Employee Onboarded',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCompleted'),
                    class="hl-string">'ActioningUser': None,
                    class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                    class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                    class="hl-string">'ManagerName': record.get(class="hl-string">'managerName'),
                    class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
                })
    return events

def get_payroll_setup_events():
    print(class="hl-string">"Fetching 'Payroll Setup Completed' events...")
    events = []
    class=class="hl-string">"hl-comment"># Inferring this from direct deposit creation date
    params = {class="hl-string">'dateTimeCreated': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employees/direct-deposit', params=params)
    processed_employees = set()
    for record in data:
        if record.get(class="hl-string">'employeeId') not in processed_employees and record.get(class="hl-string">'dateTimeCreated') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Payroll Setup Completed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateTimeCreated'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'userWhoModified'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employeeStatus')
            })
            processed_employees.add(record.get(class="hl-string">'employeeId'))
    return events

def get_training_assigned_events():
    print(class="hl-string">"Fetching 'Training Assigned' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Learning module.
    params = {class="hl-string">'assignmentDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/learning/v1/enrollments', params=params)
    for record in data:
        if record.get(class="hl-string">'assignmentDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employee').get(class="hl-string">'id'),
                class="hl-string">'ActivityName': class="hl-string">'Training Assigned',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'assignmentDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'assignedBy').get(class="hl-string">'name'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'employee').get(class="hl-string">'jobTitle')
            })
    return events

def get_performance_review_events():
    print(class="hl-string">"Fetching 'Performance Review' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Performance Management module.
    params = {class="hl-string">'completionDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/performance/v1/reviews', params=params)
    for record in data:
        if record.get(class="hl-string">'completionDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employee').get(class="hl-string">'id'),
                class="hl-string">'ActivityName': class="hl-string">'Performance Review Conducted',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'completionDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'manager').get(class="hl-string">'name'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'manager').get(class="hl-string">'name')
            })
    return events

def get_job_change_events():
    print(class="hl-string">"Fetching job and compensation change events...")
    events = []
    params = {class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') > END_DATE: continue

        action = record.get(class="hl-string">'action', class="hl-string">'').upper()
        reason = record.get(class="hl-string">'reason', class="hl-string">'').upper()
        
        if action == class="hl-string">'PROMOTION' or reason == class="hl-string">'PROMOTION':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Promotion Approved',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'supervisorName')
            })

        if action == class="hl-string">'TRANSFER' or reason == class="hl-string">'TRANSFER' or reason == class="hl-string">'REASSIGNMENT':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Role Change Processed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle')
            })

        if record.get(class="hl-string">'isPayRateChanged') == class="hl-string">'true':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Compensation Changed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus')
            })

        if record.get(class="hl-string">'isSupervisorChanged') == class="hl-string">'true':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Manager Changed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'supervisorName')
            })
    return events

def get_leave_events():
    print(class="hl-string">"Fetching 'Leave of Absence' events...")
    events = []
    params = {class="hl-string">'action': class="hl-string">'LEAVE', class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') and record.get(class="hl-string">'effectiveDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Leave of Absence Started',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus'),
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
    return events

def get_termination_events():
    print(class="hl-string">"Fetching 'Termination' events...")
    events = []
    params = {class="hl-string">'action': class="hl-string">'TERM', class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') and record.get(class="hl-string">'effectiveDate') <= END_DATE:
            class=class="hl-string">"hl-comment"># Termination Initiated is when the record is created, Terminated is the effective date
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Termination Initiated',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCreated'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus'),
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Employee Terminated',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': class="hl-string">'Terminated',
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
    return events

def get_offboarding_events():
    print(class="hl-string">"Fetching 'Offboarding' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Onboarding module for offboarding checklists.
    class=class="hl-string">"hl-comment"># Conceptual endpoint, may need adjustment.
    data = get_ukg_data(fclass="hl-string">'/onboarding/v1/employee-onboarding-activities?start-date={START_DATE}&end-date={END_DATE}')
    for record in data:
        if record.get(class="hl-string">'workflow') == class="hl-string">'Employee Offboarding':
            if record.get(class="hl-string">'stepName') == class="hl-string">'Exit Interview' and record.get(class="hl-string">'dateCompleted'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Exit Interview Conducted',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCompleted'),
                    class="hl-string">'ActioningUser': record.get(class="hl-string">'completedBy')
                })
            if record.get(class="hl-string">'dateCompleted') and record.get(class="hl-string">'isWorkflowComplete'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Offboarding Completed',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCompleted'),
                    class="hl-string">'ActioningUser': None
                })
    return events

class=class="hl-string">"hl-comment"># --- MAIN EXECUTION --- #
if __name__ == class="hl-string">"__main__":
    all_events = []
    last_data_update = datetime.datetime.utcnow().isoformat() + class="hl-string">'Z'

    class=class="hl-string">"hl-comment"># Collect events from all functions
    all_events.extend(get_employee_hired_events())
    all_events.extend(get_onboarding_events())
    all_events.extend(get_payroll_setup_events())
    all_events.extend(get_training_assigned_events())
    all_events.extend(get_performance_review_events())
    all_events.extend(get_job_change_events())
    all_events.extend(get_leave_events())
    all_events.extend(get_termination_events())
    all_events.extend(get_offboarding_events())

    if not all_events:
        print(class="hl-string">"No events found for the specified period. Exiting.")
    else:
        class=class="hl-string">"hl-comment"># Create DataFrame
        df = pd.DataFrame(all_events)
        
        class=class="hl-string">"hl-comment"># Add required static columns
        df[class="hl-string">'SourceSystem'] = class="hl-string">'UKG Pro'
        df[class="hl-string">'LastDataUpdate'] = last_data_update
        
        class=class="hl-string">"hl-comment"># Standardize and clean up
        df = df.rename(columns={class="hl-string">'employeeId': class="hl-string">'EmployeeId', class="hl-string">'activityName': class="hl-string">'ActivityName', class="hl-string">'eventTimestamp': class="hl-string">'EventTimestamp'})
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'EventTimestamp']).dt.strftime(class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')[:-3] + class="hl-string">'Z'
        df = df.sort_values(by=[class="hl-string">'EmployeeId', class="hl-string">'EventTimestamp'])
        
        class=class="hl-string">"hl-comment"># Reorder columns for clarity
        column_order = [
            class="hl-string">'EmployeeId', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
            class="hl-string">'ActioningUser', class="hl-string">'EmployeeDepartment', class="hl-string">'JobRequisitionId', class="hl-string">'EmploymentStatus',
            class="hl-string">'JobTitle', class="hl-string">'ManagerName', class="hl-string">'HireDate'
        ]
        df = df.reindex(columns=column_axist)

        class=class="hl-string">"hl-comment"># Save to CSV
        output_filename = class="hl-string">'ukg_hire_to_retire_event_log.csv'
        df.to_csv(output_filename, index=False)
        print(fclass="hl-string">"\nExtraction complete. Event log saved to {output_filename}")

¿Listo para empezar?

Utilice este Template para preparar sus datos con confianza y obtener información clave sobre sus procesos de RR. HH. Empiece hoy a optimizar el ciclo de vida laboral, desde la contratación hasta la salida.

Volver a la guía de mejora

Descargar Template

¡Empiece hoy a optimizar el ciclo de vida laboral, desde la contratación hasta la salida!

Reduzca un 30 % el tiempo de ciclo desde la contratación hasta la salida y mejore la eficiencia de RR. HH.

Comience su prueba gratuita

No se requiere tarjeta de crédito. Configuración rápida.

Su Template de datos para el ciclo de vida laboral, desde la contratación hasta la salida

Su Template de datos para el ciclo de vida laboral, desde la contratación hasta la salida

Atributos del ciclo de vida laboral, desde la contratación hasta la salida

Actividades del ciclo de vida laboral, desde la contratación hasta la salida

Guías de extracción

Extracción mediante un script de Python a través de las API REST de UKG Pro

Pasos

Configuración

Consulta de ejemplo python

¿Listo para empezar?

¡Empiece hoy a optimizar el ciclo de vida laboral, desde la contratación hasta la salida!