P4 Software P4 Software / NominaHQ

Agrega esta documentación a Claude

Hazle preguntas a Claude sobre esta documentación. Claude lee las páginas publicadas y te enlaza a ellas. Copia esta dirección:

https://docs.p4software.cloud/mcp

En claude.ai o Claude Desktop: abre Configuración, luego Conectores, elige Agregar conector personalizado y pega la dirección.

En Claude Code, ejecuta:

claude mcp add --transport http docs https://docs.p4software.cloud/mcp

Horas extras

Horas extras

Aplica a: NominaHQ Roles: Acceso total, Captura de datos, Aprobador y Solo lectura (utilidad de cálculo; los administradores siempre tienen acceso) Referencias regulatorias: Código de Trabajo de Panamá — Art. 30/31 (jornada), Art. 33 (horas extraordinarias), Art. 36 (máximo de tiempo extraordinario), Art. 49 (día de descanso / feriado)

Resumen

La Calculadora de Horas Extras calcula el pago de las horas extraordinarias y de los días especiales (descanso, domingo, feriado y duelo nacional) de un empleado, según los recargos del Código de Trabajo. Usted selecciona el empleado, indica las horas trabajadas en cada categoría y la calculadora muestra el valor hora ordinaria y el desglose del pago. La usa el personal que prepara la planilla de cada empresa cliente. Con un clic, el resultado se envía a la planilla en Borrador del período como una línea de Horas Extras, que entra en las bases de CSS, Seguro Educativo e ISR.

Navegación

Nómina → Horas Extras Ruta: /payroll/horas-extras

Conceptos clave

  • Jornada: clasificación de la jornada de trabajo (Diurna, Nocturna o Mixta). Determina cuántas horas ordinarias tiene el día —y, por tanto, el divisor del valor hora— y también el recargo que corresponde a las horas extraordinarias trabajadas en período nocturno.
  • Valor hora ordinaria: salario mensual ÷ 30 días ÷ horas de la jornada (8 diurna, 7 nocturna, 7.5 mixta). Es la base sobre la que se aplican los recargos.
  • Hora extraordinaria (Art. 33): hora trabajada fuera de la jornada ordinaria. El recargo depende del período en que se trabaja y de la jornada que se prolonga:
    • +25% cuando la hora extraordinaria se trabaja en período diurno.
    • +50% cuando se trabaja en período nocturno y prolonga una jornada diurna.
    • +75% cuando prolonga una jornada nocturna o mixta.
  • Día de descanso / domingo (Art. 49): trabajo en el día de descanso semanal o domingo; recargo de +50%.
  • Día feriado / duelo nacional (Art. 49): trabajo en día feriado o de duelo nacional; recargo de +150%.
  • Máximo de tiempo extraordinario (Art. 36): el tiempo extraordinario no puede exceder 3 horas por día ni 9 horas por semana. El trabajo en día de descanso o feriado se rige por el Art. 49 y no cuenta para ese tope.
  • Recargo: porcentaje adicional sobre el valor hora ordinaria. El monto pagado por hora es el valor hora multiplicado por (1 + recargo).

Tarea 1 — Calcular las horas extras de un empleado

Antes de empezar: tenga a mano las horas extraordinarias del período de cada empleado, separadas en diurnas, nocturnas, en día de descanso/domingo y en día feriado/duelo nacional.

  1. En el menú lateral, dentro de Nómina, haga clic en Horas Extras.

    Pantalla Calculadora de Horas Extras con el menú Nómina → Horas Extras resaltado

    Se abre la Calculadora de Horas Extras de la empresa activa.

  2. En Empleado, elija el empleado. Puede escribir parte del código o del nombre para filtrar la lista (en el ejemplo, E102 — Gabriela Solís).

    Campo Empleado resaltado con E102 — Gabriela Solís seleccionada

    La lista muestra solo los Empleados activos de la empresa.

  3. Revise la Jornada. NominaHQ la toma del contrato activo del empleado; cámbiela a Diurna, Nocturna o Mixta solo si no corresponde.

    Campo Jornada resaltado con el valor Diurna

    La jornada define el divisor del valor hora (8, 7 o 7.5 horas) y el recargo de las horas extras nocturnas.

  4. En Horas extras diurnas (+25%), escriba las horas extraordinarias trabajadas en período diurno (en el ejemplo, 4).

    Campo Horas extras diurnas (+25%) resaltado con 4.00

    Deje 0 en las categorías que no apliquen.

  5. En Horas extras nocturnas, escriba las horas extraordinarias trabajadas en período nocturno (en el ejemplo, 2).

    Campo Horas extras nocturnas (+50%) resaltado con 2.00

    El rótulo indica el recargo que se aplicará: (+50%) si la jornada es Diurna, (+75%) si es Nocturna o Mixta.

  6. Si el empleado trabajó en su día de descanso o domingo, complete Horas en día de descanso / domingo (+50%). Si trabajó en un día feriado o de duelo nacional, complete Horas en día feriado / duelo nacional (+150%) (en el ejemplo, 8 horas de feriado).

    Campo Horas en día feriado / duelo nacional (+150%) resaltado con 8.00

    Estas horas se rigen por el Art. 49 y no cuentan para el máximo de tiempo extraordinario del Art. 36.

  7. Haga clic en Calcular.

    Formulario completo con el botón Calcular resaltado

    El botón permanece deshabilitado hasta que se elige un empleado.

  8. Revise el resultado: Valor hora ordinaria, el pago de cada categoría y el Total horas extras.

    Resultado Horas Extras — Gabriela Solís con el valor hora, el desglose y el total de 326.66

    En el ejemplo: valor hora $11.67; 14 horas en total, por $326.66. Si las horas diurnas más nocturnas superan el máximo legal, aparece Advertencia: el tiempo extraordinario excede el máximo legal de 3 h/día y 9 h/semana (Art. 36).

Resultado: conoce el monto de horas extras del empleado. La calculadora no guarda nada hasta que usted lo envía a una planilla (Tarea 2).

Tarea 2 — Enviar las horas extras a la planilla

Antes de empezar: la empresa debe tener una planilla regular en Borrador para el período (vea Crear y calcular una planilla). Si no la hay, bajo el resultado aparece No hay una planilla en borrador abierta para esta empresa — cree una primero y luego envíe estas horas extras a ella.

  1. En Enviar a la planilla, elija la planilla en Borrador por su período (en el ejemplo, 01 oct. – 15 oct. 2026). Por defecto aparece la más reciente.

    Lista Enviar a la planilla resaltada con el período 01 oct. – 15 oct. 2026

    Solo aparecen planillas regulares en Borrador; las corridas de Décimo y las planillas ya aprobadas no se listan.

  2. Haga clic en Enviar a la planilla. Aparece el mensaje Horas extras enviadas a la planilla.

    Botón Enviar a la planilla resaltado

    NominaHQ agrega el monto como concepto único de horas extras y recalcula la planilla de inmediato.

  3. Abra la planilla en Nómina → Planillas y verifique la línea Horas Extras del empleado, marcada Manual, con las horas en Base, el monto y el detalle en Notas.

    Línea Horas Extras con la etiqueta Manual resaltada en el grupo de Gabriela Solís

    Las horas extras suben la base de Seguro Social, Seguro Educativo e ISR del empleado. Con el lápiz de la línea puede editarla o eliminarla mientras la planilla está en Borrador.

Resultado: las horas extras forman parte de la planilla del empleado. Si vuelve a enviar horas extras del mismo empleado a la misma planilla, NominaHQ actualiza la línea existente en lugar de duplicarla.

Referencia de campos

Campo Tipo Obligatorio Descripción Validación
Empleado Lista desplegable con filtro Sí Empleado activo de la empresa activa, mostrado como código y nombre. El botón Calcular permanece inhabilitado mientras no se seleccione un empleado.
Jornada Lista desplegable No Diurna, Nocturna o Mixta. Define las horas ordinarias del día (8 / 7 / 7.5) usadas como divisor del valor hora, y el recargo de las horas extraordinarias nocturnas (+50% o +75%). Se completa automáticamente desde el contrato del empleado. Valor por defecto: Diurna.
Horas extras diurnas (+25%) Campo numérico No Horas extraordinarias trabajadas en período diurno. Mínimo 0; dos decimales.
Horas extras nocturnas (+50%) / (+75%) Campo numérico No Horas extraordinarias trabajadas en período nocturno. El recargo del rótulo cambia con la Jornada: +50% si es Diurna, +75% si es Nocturna o Mixta. Mínimo 0; dos decimales.
Horas en día de descanso / domingo (+50%) Campo numérico No Horas trabajadas en el día de descanso semanal o domingo. Mínimo 0; dos decimales.
Horas en día feriado / duelo nacional (+150%) Campo numérico No Horas trabajadas en día feriado o de duelo nacional. Mínimo 0; dos decimales.
Enviar a la planilla Lista desplegable Para enviar Planilla regular en Borrador de la empresa que recibirá las horas extras, identificada por su período. Aparece después de calcular, si el total es mayor que cero. Solo planillas en Borrador. Por defecto, la más reciente.

Resultado del cálculo

Línea Descripción
Valor hora ordinaria Salario mensual ÷ 30 ÷ horas de la jornada.
Diurnas (+25%) Horas diurnas × valor hora × 1.25.
Nocturnas (+50%) / (+75%) Horas nocturnas × valor hora × 1.50 si la jornada es Diurna, o × 1.75 si es Nocturna o Mixta. El rótulo indica el recargo aplicado.
Día de descanso / domingo (+50%) Horas de descanso/domingo × valor hora × 1.50.
Día feriado / duelo nacional (+150%) Horas de feriado/duelo × valor hora × 2.50.
Total horas extras Suma de las horas y suma de los pagos de todas las categorías.

Roles y permisos

Calcular no guarda datos. Enviar a la planilla agrega una línea a una planilla en Borrador, por lo que requiere permiso para modificar planillas.

Rol Usar la calculadora Enviar a la planilla
Acceso total Sí Sí
Captura de datos Sí Sí
Aprobador Sí No
Solo lectura Sí No

Los administradores siempre tienen acceso.

Notas de cumplimiento

  • El valor hora ordinaria se calcula como salario mensual ÷ 30 días ÷ horas de la jornada (8 diurna, 7 nocturna, 7.5 mixta), conforme a los Art. 30/31. De este modo, a quien trabaja en jornada nocturna o mixta se le remunera la hora como si fuese de ocho horas diurnas.
  • Recargos aplicados conforme al Art. 33: +25% por la hora extraordinaria trabajada en período diurno; +50% por la trabajada en período nocturno cuando prolonga una jornada diurna; y +75% cuando prolonga una jornada nocturna o mixta. Conforme al Art. 49: día de descanso o domingo +50%, y día feriado o de duelo nacional +150%.
  • La jornada seleccionada afecta el cálculo de dos maneras: cambia el divisor del valor hora ordinaria (8 / 7 / 7.5) y determina si las horas extraordinarias nocturnas se pagan con +50% o con +75%. Los recargos de las demás categorías (diurnas, día de descanso y feriado) son fijos e independientes de la jornada.
  • Los recargos del Art. 33 y del Art. 49 están fijados en el sistema y no se editan desde Parámetros legales, a diferencia de las tasas de CSS, Seguro Educativo e ISR.
  • La advertencia del Art. 36 se muestra cuando la suma de horas extraordinarias diurnas más nocturnas supera 9 horas. El trabajo en día de descanso o feriado no se incluye en ese tope porque se rige por el Art. 49.
  • Al enviar el resultado a la planilla, NominaHQ lo registra como ingreso por horas extras y recalcula la planilla, de modo que se incluye en el devengado y en las bases de cotización correspondientes.

Solución de problemas

Síntoma Causa probable Solución
El botón Calcular está inhabilitado. No se ha seleccionado un empleado. Seleccione un empleado en el campo Empleado.
El empleado no aparece en la lista. El empleado está inactivo o pertenece a otra empresa. Verifique que el empleado esté activo en la empresa activa.
La jornada no es la esperada. El contrato del empleado tiene otra jornada o no tiene contrato activo. Revise el contrato del empleado o cambie la jornada manualmente antes de calcular.
Aparece la advertencia de máximo legal. Las horas extraordinarias diurnas más nocturnas superan 9 h/semana (Art. 36). Confirme las horas registradas y la autorización correspondiente antes de incluirlas en la planilla.
El valor hora ordinaria parece bajo o alto. La jornada seleccionada cambia el divisor (8 / 7 / 7.5 h). Seleccione la jornada correcta del empleado y vuelva a calcular.
El rótulo del campo de horas nocturnas cambió de (+50%) a (+75%). Se seleccionó una jornada Nocturna o Mixta: el Art. 33 exige +75% cuando la hora extraordinaria prolonga esas jornadas. Es el comportamiento esperado. Confirme que la jornada corresponde a la del contrato del empleado.
El resultado muestra un recargo nocturno distinto al del rótulo del campo. Se cambió la Jornada después de calcular, sin volver a presionar Calcular. Presione Calcular de nuevo para que el resultado corresponda a la jornada seleccionada.

Funciones relacionadas

¿Te resultó útil esta página?