Actualización de la configuración de compensación: qué cambia y cómo prepararse

Qué se actualiza y por qué

Estamos actualizando la configuración de compensación en PeopleForce. En lugar de listas separadas de tipos de compensación y calendarios de pago, tendrá un único catálogo: Componentes de compensación. Allí, cada concepto de pago que utiliza su empresa se describe una sola vez, con su tipo de pago y su frecuencia.

La actualización la realiza el equipo de PeopleForce, así que no hace falta activar nada. Los registros de compensación existentes y su historial se conservan, y no se espera ninguna interrupción del servicio.

Qué se obtiene:

Un solo lugar para gestionar la compensación. La compensación base, la compensación adicional y los ajustes se configuran en un mismo catálogo.
Menos campos que completar. Al asignar una compensación, basta con elegir un componente y su configuración se completa automáticamente.
Una pestaña Ajustes aparte para correcciones como un pago insuficiente de un período anterior, la devolución de un pago en exceso o una retención. Se mantienen separadas de los bonos, y las deducciones se muestran como montos negativos.

💡¿No está seguro de si su cuenta ya se actualizó? Abra Configuración → Nómina. Si aparece Componentes de compensación, la actualización ya se realizó. Si aparece Compensación, todavía está pendiente.

Qué hacer antes de la actualización

La mayoría de las cuentas no necesita hacer nada. Conviene revisar estos tres puntos:

Calendario de pago. Si utiliza este campo para sus propios registros, copie sus valores. El campo se eliminará de la ficha de compensación base.
Compensación base en un campo personalizado. Si guarda la compensación base en un campo personalizado y no en el bloque de compensación base, contacte con su Customer Success manager. Esos montos y monedas no se transfieren automáticamente.
Integración por API. Si trabaja con la compensación a través de la API de PeopleForce, comparta la sección Cambios en la API (más abajo) con la persona que gestiona su integración.

Qué cambia en el trabajo diario

Asignación de compensación. Se elige un componente, y el tipo de pago y la frecuencia se toman de él. En la compensación base, el componente también define el método de cálculo (monto fijo o tarifa).
Cambios en un componente. Una vez guardado un componente, se pueden cambiar su nombre, código y descripción. Si necesita otra frecuencia, otro tipo de pago u otro método de cálculo, cree un componente nuevo.
Calendario de pago. El campo se elimina. No influía en ningún cálculo. La frecuencia de pago ahora se define en el módulo de Nómina, en Ciclos de nómina.
Horas extra. La marca se reemplaza por un componente ya creado, Horas extras, con un monto y un período visibles en el historial de compensaciones. Para registrar las horas extra y las horas especiales, use las Políticas de asistencia del módulo Time.
Reporte Historial de compensación base. El archivo exportado tiene dos columnas menos: Calendario de pago y Horas extra. En pantalla el reporte se ve igual.
Códigos de componentes. Cada componente tiene un código que se usa en las exportaciones, la importación del historial y la API. Más detalles en Configurar y gestionar los componentes de compensación.

Qué ocurre con los datos

Los registros de compensación y su historial, tanto activos como finalizados, se transfieren automáticamente. Las solicitudes pendientes de aprobación también se trasladan, así que no hace falta volver a enviarlas. La única excepción es la compensación base guardada en un campo personalizado (ver más arriba).

Es posible que vea más componentes que los tipos de compensación que tenía antes. Por ejemplo, si un "Bono" se pagaba tanto de forma mensual como una sola vez, se obtendrán dos componentes: "Mensual Bono" y "Una sola vez Bono". Puede renombrar los componentes según sus propios términos y eliminar los que no necesite. Los pagos ya asignados se mantienen.

Limitaciones actuales

La compensación adicional variable recurrente y los ajustes todavía no se pueden agregar mediante formularios ni a través de la API. Por ahora, regístrelos en el perfil de la persona empleada. Su incorporación a formularios y API está prevista para finales del cuarto trimestre de 2026.
El componente de un registro de compensación guardado no se puede cambiar. Si eligió el incorrecto, elimine el registro y vuelva a crearlo.
La actualización no se puede revertir. No es posible volver a la configuración de compensación anterior.

Cambios en la API: para quien gestiona la integración

Si usa la API de PeopleForce para trabajar con la compensación, después de la actualización se aplican estos cambios:

Lectura de la lista: use /compensation_components en lugar de /compensation_types.
Creación de compensaciones adicionales: use /employees/{employee_id}/additional_compensations con compensation_component_id en lugar de compensation_type_id. Las solicitudes con el campo anterior serán rechazadas.
Versión de la API: la API v1 no admite componentes. Le pedimos pasar a la API v3.
ID: cada tipo de compensación se convierte en uno o varios componentes con ID nuevos. Los registros de las personas empleadas se trasladan automáticamente, pero es posible que haya que volver a mapear los ID guardados en su integración.
Todavía no disponible a través de la API: la compensación adicional variable recurrente y los ajustes (previsto para finales del cuarto trimestre de 2026).

🤝 Si necesita ayuda con la integración, contacte con su Customer Success manager.

Preguntas frecuentes

No encuentro Componentes de compensación en el menú.

Su cuenta todavía no se ha actualizado. Hasta entonces, el menú muestra Compensación.

La lista de componentes está vacía al asignar una compensación.

Cada sección muestra solo los componentes de su propia categoría y tipo de pago. Cree un componente del tipo necesario en Configuración → Nómina → Componentes de compensación.

Necesitamos más tiempo antes de la actualización.

Contacte con su Customer Success manager.