Variables PTU 2026 (Global Payroll México)

Descripción general

👥 [Todos los perfiles]

El módulo de Variables PTU 2026 en Rankmi Global Payroll (México) es una funcionalidad diseñada para simplificar y automatizar el cálculo de la Participación de los Trabajadores en las Utilidades (PTU) y otros procesos de nómina equivalentes en la legislación mexicana. Sirve para calcular de forma masiva métricas e indicadores a nivel de toda la organización (como totales, promedios, conteos de personal y distribución geográfica por impuesto sobre nómina o ISN) y transformarlos en Parámetros especiales(con el prefijo special_).

A través de la generación de una "foto" o snapshot de datos de la empresa, el sistema inyecta estas variables directamente en las fórmulas de nómina. Esto permite que el cálculo individual de cada colaborador lea de forma consistente los grandes agregados de la empresa (por ejemplo, el salario total de la plantilla) para determinar cuotas proporcionales o aplicar reglas de elegibilidad sin necesidad de cálculos manuales externos.

Requisitos previos

⚙️ [Administrador] / 🔧 [Implementador]

Antes de procesar nóminas o utilizar las variables special_*en las fórmulas, es mandatorio asegurar lo siguiente:

• El tipo de proceso correspondiente (por ejemplo, el tipo de proceso PTU/utilidades) debe pertenecer a la legislación de México (MX).
• Se debe activar manualmente el interruptor maestro Activar parámetros especialesdentro de la configuración del tipo de proceso.
• Los conceptos requeridos para el negocio (como SUELDO, BONO_PT, etc.) ya deben estar creados y parametrizados en la plataforma para poder seleccionarse en el Dashboard.
• Para el uso de las variables de Impuesto Sobre Nómina (ISN), se deben tener definidos previamente los grupos de nómina y estados (entidades federativas) en los que opera la organización, junto con períodos de nómina cerrados en los rangos de tiempo que se van a consultar.

Funcionamiento

👥 [Todos los perfiles]

El módulo opera de manera secuencial en tres grandes pasos:

[Paso 1: Configurar] ──> [Paso 2: Generar Snapshot] ──> [Paso 3: Procesar Nómina]
Definir conceptos e ISN    Actualizar datos del período    Fórmulas leen la "foto" global

1. Configurar el Tipo de Proceso (MX): El administrador define qué datos de la empresa se deben consolidar. Selecciona qué conceptos específicos se analizarán en el dashboard corporativo y determina las ventanas de tiempo y estados para el cálculo de empleados pagados (ISN).
2. Generar el Snapshot (Foto de números):Al abrir o actualizar el período de PTU, el sistema genera un registro estático o snapshot con los valores calculados de la empresa. Esta foto se puede actualizar manualmente en el período o configurarse para que se refresque automáticamente antes de un procesamiento masivo.
3. Procesar las Nóminas:Cuando se ejecuta el cálculo de las nóminas de los colaboradores (individual o masivo), las fórmulas parametrizadas leen de forma simultánea e idéntica la misma información guardada en el snapshot corporativo (special_*) y la combinan con las variables individuales del trabajador (como sus días trabajados o salario diario).

Configuración

⚙️ [Administrador]

La personalización de los parámetros especiales se realiza ingresando a la siguiente ruta en la plataforma:

Administración → Tipos de proceso → Seleccionar [Tipo PTU/utilidades] → Sección: Parámetros especiales (solo legislación MX).

Están disponibles las siguientes opciones y parámetros de configuración:

• Activar parámetros especiales:Interruptor maestro. Si se encuentra Apagado, el sistema no realizará los cálculos de empresa, no mostrará el enlace de visualización en el período y no inyectará ninguna variable en el motor de fórmulas.
• Actualizar antes de cada procesamiento:Si se activa (Encendido), el sistema recalculará y actualizará el snapshot de forma automática antes de iniciar un procesamiento masivo. Si se deja Apagado, el snapshot solo se actualizará cuando se presione manualmente el botón en el período.
• Conceptos del dashboard:Selector múltiple (Multiselect) de códigos de concepto. Por cada concepto que elijas, el sistema creará automáticamente tres variables: el total acumulado, el promedio y la cantidad de colaboradores con un monto distinto de cero.
• Empleados pagados por estado (ISN):Bloque donde se define una fecha de referencia, las ventanas temporales (mes, trimestre o semestre), los grupos de nómina y los estados federativos a evaluar. Aplica la lógica del reporte ISN basándose estrictamente en los períodos cerrados dentro del rango.

Para definir los rangos de las ventanas ISN, el sistema utiliza una Fecha de referencia ISN como ancla:

Las Ventanas ISN disponiblesgenerarán claves dinámicas en las variables según el ancla. Por ejemplo, si el ancla cae el 18 de octubre de 2025:

🔧 [Implementador]

Para el despliegue inicial y adaptación por cliente, considera los siguientes lineamientos técnicos y de parametrización:

• Verificación en el período: Durante la puesta en marcha, accede al detalle del período PTU (MX) y haz clic en el enlace Ver parámetros especiales. Aquí debes validar:
  • La tabla de conceptos de dashboard con sus columnas de total, promedio y contratos con monto $\neq 0$.
  • Las tablas ISN por ventana y estado, validando el formato estructurado: Nombre (código)(por ejemplo: Chiapas (chp)).
  • La fecha y hora del último refresh para comprobar la vigencia de los datos.
• Inexistencia de catálogo global: Ten presente que no existe un catálogo global de variables con prefijo ptu_preconstruido en el sistema core. Si el cliente requiere conceptos como ptu_15uma o adelanto_ptu, estos deben ser configurados manualmente como conceptos del cliente con sus códigos exactos para que las fórmulas los puedan invocar.
• Lógica de recalculo:Sigue la siguiente matriz de acciones recomendadas durante la fase de pruebas o cambios de estructura:

Casos de uso frecuentes

🧑 [Usuario final]

Este módulo no cuenta con escenarios directos para el colaborador final, ya que su operación es exclusiva de administradores y analistas de nómina.

⚙️ [Administrador]

• Reparto proporcional al sueldo de la empresa: El administrador configura la variable global de sueldos para calcular de manera automatizada la cuota individual de PTU de un empleado, dividiendo la base de su sueldo percibido entre el gran total acumulado por la empresa y multiplicándolo por el monto total de PTU a repartir.
• Validación de plantilla mínima por Estado (ISN): El administrador utiliza los datos acumulados de colaboradores por entidad federativa en un semestre específico para condicionar que se liberen o validen ciertos montos de beneficios o previsiones de acuerdo con la escala del equipo en dicha región.

Restricciones y consideraciones

👥 [Todos los perfiles]

• Condición de activación:Las variables special_*evaluarán estrictamente con un valor de cero (0) o vacío si no están los parámetros especiales activos, si no existe un snapshot guardado en el período, si el bloque (dashboard o ISN) no fue configurado, o si el snapshot es antiguo (anterior a una modificación relevante de la configuración).
• Aislamiento entre procesos: Los tipos de proceso no comparten snapshots entre sí. Cada período de nómina posee un snapshot completamente aislado que responde exclusivamente a la configuración de su propio tipo de proceso.
• Falta de actualización automática ante cambios: Si modificas la configuración de un tipo de proceso, los períodos que ya se encuentren abiertos no se actualizarán automáticamente. Es mandatorio ingresar a cada período afectado y pulsar manualmente Actualizar datos.
• Elegibilidad por días trabajados: El filtro de elegibilidad basado en días trabajados del contrato (por ejemplo, empleados con $\ge 60$ días) se maneja actualmente como una aproximación manual utilizando la variable selected_contract.work_days. La automatización nativa y completa de este flujo se encuentra planificada en el roadmap de desarrollo bajo el código RKM-91203.
• Soporte de edición:Las variables special_*no se muestran de forma mandatoria en el buscador integrado del editor de fórmulas de Rankmi. Se inyectan en tiempo de ejecución.

Preguntas frecuentes (Q&A)

🧑 [Usuario final]

P: ¿Puedo revisar el cálculo de mis utilidades o el snapshot corporativo desde mi perfil de colaborador?

R: No. Esta funcionalidad está diseñada exclusivamente para que la operen los administradores y analistas de nómina de la empresa; no está expuesta a los colaboradores finales.

P: ¿Qué pasa si quiero consultar cuántos días trabajados registra mi contrato para el reparto de utilidades?

R: ⚠️ Caso no contemplado en la versión actual del producto.

⚙️ [Administrador]

P: ¿Puedo utilizar la variable special_dashboard_total_SUELDOen mis fórmulas si no seleccioné el concepto SUELDO en la configuración del tipo de proceso?

R: No. La variable no tendrá ningún valor calculado. El sistema solo genera las variables special_*correspondientes a los conceptos de nómina que hayan sido expresamente seleccionados en el multiselect de la configuración.

P: Si realizo modificaciones en la configuración del Tipo de Proceso PTU, ¿los períodos que tengo abiertos reflejarán el cambio de inmediato?

R: No. Cambiar la configuración del tipo de proceso no actualiza los períodos abiertos de forma automática. Debes ingresar a cada período afectado y ejecutar la acción Actualizar datosmanualmente.

P: ¿Qué ocurre si lanzo un procesamiento masivo de nóminas y olvidé generar o activar el snapshot previo del período?

R: Todas las fórmulas que contengan variables con el prefijo special_*se evaluarán con un valor de 0 o vacío, lo que generará cálculos erróneos en los conceptos asociados.

P: ¿Estas variables de parámetros especiales se pueden usar únicamente en los procesos de fin de año o PTU?

R: No son exclusivas de PTU. La funcionalidad de parámetros especiales puede habilitarse en cualquier tipo de proceso de la legislación de México (MX) que tenga la opción activa; el escenario de PTU 2026 simplemente fue el caso de uso que originó su liberación.

🔧 [Implementador]

P: ¿Las variables special_* se autocompletan o aparecen listadas en el buscador del editor de fórmulas de Rankmi?

R: No necesariamente. Estas variables se inyectan dinámicamente en el procesamiento a partir del snapshot generado en el período. Se recomienda escribir los nombres tal como están documentados o copiarlos directamente desde la pantalla de configuración del Tipo de Proceso, validando su correcta lectura mediante un procesamiento de prueba.

P: Si configuro los conceptos SUELDO y BONO_PT en el apartado de Conceptos del Dashboard, ¿cuántas variables se inyectarán exactamente en el motor de fórmulas?

R: Se generarán exactamente 6 variables en total (3 por cada concepto): special_dashboard_total_SUELDO, special_dashboard_average_SUELDO, special_dashboard_count_SUELDO, y sus tres equivalentes para el código BONO_PT.

P: ¿Existe alguna variable predefinida para extraer la fecha de término del contrato de un empleado sin depender del proceso de finiquito?

R: No en esta versión. La necesidad de contar con la variable contract_ended_at_datese encuentra actualmente con estatus de Pendiente en el sistema.

P: ¿Es posible formular la suma acumulada de un concepto parametrizado entre dos fechas completamente libres elegidas por el cliente dentro del ejercicio?

R: No en esta versión. Esta funcionalidad de sumas en rango de fechas personalizado se encuentra actualmente con estatus de Pendiente.

Glosario de términos clave

👥 [Todos los perfiles]

• Conceptos del dashboard:Códigos de conceptos de nómina específicos seleccionados por el administrador para que el sistema consolide sus totales, promedios y conteos a nivel empresa dentro del snapshot.
• Fecha de referencia ISN: Indicador temporal utilizado como ancla (period_start, period_end o payment_date) para calcular y segmentar la cantidad de empleados pagados en una ventana de tiempo específica.
• Parámetros especiales:Variables globales con prefijo special_*calculadas a nivel de toda la organización que representan métricas consolidadas del negocio para su uso en fórmulas de nómina.
• PTU:Participación de los Trabajadores en las Utilidades. Prestación con carácter obligatorio en México que consiste en el reparto de una parte de las ganancias de la empresa entre sus colaboradores.
• Snapshot (o Foto):Registro estático de datos de la empresa calculado y congelado en un momento determinado dentro de un período de nómina abierto, garantizando que el motor de fórmulas lea información consistente.
• Ventanas ISN:Bloques de tiempo estructurados (meses, trimestres o semestres) vinculados al Impuesto Sobre Nómina, usados para cuantificar el personal pagado en una o varias entidades federativas.