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

Salario mínimo

Salario mínimo

Aplica a: NominaHQ Roles: Ver: todos los roles del personal (FullAccess, DataEntry, Approver, ViewOnly). Crear / Editar / Eliminar tarifas: Acceso total (y administradores). La anulación de supervisor durante la aprobación de planilla: Approver y FullAccess. Referencias regulatorias: Decreto Ejecutivo No. 13 de 2025 (Gaceta Oficial No. 30438, vigente 16-ene-2026), MITRADEL; Código de Trabajo (salario mínimo).

Resumen

Esta función mantiene la matriz oficial de salario mínimo de Panamá (Decreto Ejecutivo No. 13 de 2025) por actividad económica, ocupación y región. NominaHQ usa esa matriz para verificar, en cada planilla sin aprobar, si algún colaborador activo gana por debajo del mínimo legal y, en ese caso, exige una anulación de supervisor con justificación antes de aprobar. La pantalla la usan los administradores del proveedor de servicios de planilla; el resultado de la verificación lo ven quienes aprueban planillas.

Navegación

Menú lateral: Configuración → Salario Mínimo (ruta /settings/minimum-wage).

La configuración por empresa (distrito, actividad y categoría) se realiza en Configuración → Clientes → (empresa) → Salario mínimo (MITRADEL).

Conceptos clave

  • Región: clasificación geográfica del Decreto No. 13. Se deriva automáticamente del Distrito de la empresa; nunca se elige a mano. Distritos del listado de Región 1 → Región 1; los demás → Región 2. Si el distrito está vacío o no se reconoce, el sistema asume Región 1 (la más estricta).
  • Actividad económica: sector del Decreto No. 13 al que pertenece la empresa (por ejemplo, Comercio, Hoteles, Transporte).
  • Categoría / Ocupación: la línea específica dentro de la actividad (por ejemplo, «Pequeña Empresa», «Gran Empresa (11 Empleados o más)»).
  • Tarifa por Hora: salario mínimo en B/. por hora para la combinación región + actividad + ocupación.
  • Equivalente Mensual: referencia mensual de la tarifa (tarifa por hora × 208 horas/mes; 8 horas × 26 días).
  • Tarifa horaria efectiva del colaborador: para comparar contra el mínimo, NominaHQ divide el salario mensual del colaborador entre 208 (8 h × 26 días).
  • Anulación de supervisor: aprobación con justificación obligatoria, registrada en la bitácora (Auditoría), que permite aprobar una planilla con colaboradores por debajo del mínimo.
  • MITRADEL: Ministerio de Trabajo y Desarrollo Laboral, autoridad que emite el decreto de salario mínimo.

Tarea 1 — Consultar la tarifa mínima de una actividad

  1. En el menú lateral, dentro de Configuración, haga clic en Salario Mínimo.

    Pantalla Salario Mínimo con la matriz de tarifas y el menú Configuración → Salario Mínimo resaltado

    La tabla muestra las tarifas del decreto (390 filas en el ejemplo), en páginas.

  2. En el cuadro Buscar de la tabla, escriba la actividad u ocupación (en el ejemplo, Comercio Al Por Menor) y presione Enter.

    Tabla filtrada por Comercio Al Por Menor con el cuadro Buscar resaltado; aparecen filas de Región 1 y Región 2, empresas Pequeña y Grande

    El encabezado indica cuántas filas quedaron filtradas; use la X para quitar el filtro.

Resultado: ve la Tarifa por Hora, el Equivalente Mensual y la fecha Vigente Desde de cada región y tamaño de empresa. Por ejemplo, Comercio al por menor, pequeña empresa, Región 1: B/. 2.3700 por hora (B/. 492.96 al mes).

Tarea 2 — Agregar una tarifa

Use esta tarea cuando MITRADEL publique un decreto nuevo o falte una combinación en la matriz.

  1. Haga clic en Nuevo.

    Botón Nuevo resaltado en el encabezado de la pantalla

    Se abre el cuadro Nueva Tarifa de Salario Mínimo.

  2. Elija la Región y el Tamaño de Empresa (obligatorios), y escriba el Código de Actividad y la Ocupación exactamente como aparecen en el decreto.

    Cuadro Nueva Tarifa de Salario Mínimo con la lista Región resaltada

    La actividad y la ocupación deben coincidir con las que se asignan a la empresa.

  3. Escriba la Tarifa por Hora y el Equivalente Mensual en B/.

    Campo Tarifa por Hora resaltado con el valor 0.0000

    La tarifa por hora admite 4 decimales.

  4. Indique Vigente Desde (fecha de entrada en vigor del decreto) y, si aplica, Vigente Hasta. Deje Activo marcado.

    Campo Vigente Desde resaltado con la fecha 09/28/2026; Vigente Hasta muestra Ninguno

    Si hay varias tarifas vigentes para la misma combinación, se usa la de Vigente Desde más reciente.

  5. Haga clic en Guardar.

    Cuadro Nueva Tarifa de Salario Mínimo con el botón Guardar resaltado

    La tarifa aparece en la tabla.

Resultado: la nueva tarifa queda disponible para las empresas con esa región, actividad y ocupación desde su fecha de vigencia. Para editar una tarifa existente, haga clic en el enlace de la columna Región de su fila; para eliminarla, márquela y use Eliminar.

Tarea 3 — Asignar la actividad de salario mínimo a una empresa

Antes de empezar: tenga a mano el distrito donde opera la empresa y su actividad según el decreto.

  1. Vaya a Configuración → Clientes, abra la empresa (en el ejemplo, Acme Operaciones, S.A.) y, en la sección Salario mínimo (MITRADEL), elija el Distrito, la Actividad económica y la Categoría.

    Sección Salario mínimo (MITRADEL) con los campos Distrito Panamá, Región 1, Actividad económica Comercio y Categoría Comercio Al Por Menor — Pequeña Empresa, resaltados

    La Región se calcula sola a partir del distrito; no se elige a mano.

  2. Revise el Salario mínimo aplicable que muestra la sección.

    Recuadro Salario mínimo aplicable: B/. 2.37 / hora (≈ B/. 492.96 / mes) resaltado

    Si no aparece un monto, no hay tarifa vigente para esa combinación: agréguela (Tarea 2).

  3. Haga clic en Guardar en la parte superior de la ficha de la empresa.

    Encabezado de la ficha de Acme Operaciones, S.A. con el botón Guardar resaltado

    Desde ahora, las planillas sin aprobar de la empresa se verifican contra ese mínimo.

Resultado: la empresa queda asociada a su tarifa mínima y NominaHQ puede verificar sus planillas.

Tarea 4 — Aprobar una planilla con colaboradores por debajo del mínimo

La verificación es automática: mientras la planilla está en Borrador, NominaHQ compara la tarifa horaria efectiva de cada colaborador activo (salario mensual ÷ 208) con el mínimo aplicable.

  1. Abra la planilla en Borrador. Si hay colaboradores por debajo del mínimo, un aviso indica cuántos son (empleado(s) por debajo del salario mínimo legal) y los lista con su código, nombre, tarifa por hora, mínimo y faltante.

Aviso rojo "1 empleado(s) por debajo del salario mínimo legal" con la tabla Código, Empleado, Por hora, Mínimo y Diferencia (E127 Pedro Alonso Batista Ruiz, B/. 1.9231 frente a B/. 2.3700)

El aviso aparece en la planilla en Borrador y muestra cuánto falta por hora para llegar al mínimo.

  1. Corrija el salario de los colaboradores si corresponde. Si el pago por debajo del mínimo está justificado (por ejemplo, jornada parcial), haga clic en Aprobar.

Barra de acciones de la planilla con el botón Aprobar resaltado

Con colaboradores por debajo del mínimo, Aprobar abre primero la anulación de supervisor.

  1. En la ventana Anulación de supervisor — salario mínimo, escriba la Justificación (obligatoria).

Ventana Anulación de supervisor — salario mínimo con la Justificación escrita y resaltada

La justificación queda registrada en la bitácora con su nombre.

  1. Haga clic en Anular y aprobar. El botón se habilita solo cuando hay una justificación.

Ventana Anulación de supervisor con el botón Anular y aprobar habilitado y resaltado

El botón se habilita en cuanto hay una justificación.

Resultado: la planilla queda Aprobada y la anulación se registra en la bitácora (Auditoría) con su nombre, la justificación y los colaboradores afectados. Si en lugar del aviso aparece "La validación de salario mínimo está inactiva", la empresa no tiene actividad o tarifa configurada: complete la Tarea 3.

Referencia de campos

Diálogo Nueva / Editar tarifa de salario mínimo

Campo Tipo Obligatorio Descripción Validación
Región Lista desplegable Sí Región 1 o Región 2. Selección requerida.
Código de Actividad Texto No Sector / actividad económica del Decreto No. 13. —
Ocupación Texto No Categoría o línea específica de la actividad. —
Tamaño de Empresa Lista desplegable Sí Pequeña, Mediana o Grande. Selección requerida.
Tarifa por Hora Numérico (4 decimales) No Salario mínimo en B/. por hora. Valor numérico.
Equivalente Mensual Numérico (2 decimales) No Referencia mensual en B/. Valor numérico.
Vigente Desde Fecha No Inicio de vigencia de la tarifa. Fecha válida.
Vigente Hasta Fecha No Fin de vigencia; Ninguno = sin fecha de cierre. Fecha válida u opcional.
Activo Casilla No Si está marcada, la tarifa se considera en las verificaciones. —

Columnas de la tabla de datos

Columna Descripción
Región Región 1 o Región 2.
Código de Actividad Actividad / sector económico.
Ocupación Categoría dentro de la actividad.
Tamaño de Empresa Pequeña, Mediana o Grande.
Tarifa por Hora Mínimo en B/. por hora (4 decimales).
Equivalente Mensual Referencia mensual en B/. (2 decimales).
Vigente Desde Fecha de inicio de vigencia.
Activo Indica si la tarifa está activa.

Configuración por empresa (Salario mínimo MITRADEL)

Campo Tipo Obligatorio Descripción Validación
Distrito Lista con búsqueda No Distrito de la empresa; determina la región. Acepta selección o texto.
Región Calculado (solo lectura) — Se deriva del distrito; no editable. —
Actividad económica Lista con búsqueda No Actividad del Decreto No. 13. —
Categoría Lista con búsqueda No Categoría dentro de la actividad. Se reinicia si no aplica a la actividad elegida.

Roles y permisos

Pantalla Salario Mínimo (matriz de tarifas)

Rol Ver Crear Editar Eliminar Aprobar
Administrador Sí Sí Sí Sí n/a
FullAccess Sí Sí Sí Sí n/a
DataEntry Sí No No No n/a
Approver Sí No No No n/a
ViewOnly Sí No No No n/a

El mantenimiento de tarifas de salario mínimo es una acción de configuración: solo el rol Acceso total (y los administradores) ve Nuevo y Eliminar y puede guardar. La columna «Aprobar» no aplica a esta pantalla.

Anulación de supervisor en la planilla

Rol Aprobar con anulación
FullAccess Sí
Approver Sí
DataEntry No
ViewOnly No

Notas de cumplimiento

  • La matriz corresponde al Decreto Ejecutivo No. 13 de 2025 (Gaceta Oficial No. 30438), vigente desde el 16 de enero de 2026, que deroga el Decreto No. 1 de 2024. Las tarifas son por hora, según actividad económica y región (R1/R2). Fuente: MITRADEL.
  • La región se deriva del distrito de la empresa; no se selecciona manualmente. Distrito desconocido o vacío se trata como Región 1 (criterio más estricto).
  • La verificación compara la tarifa horaria efectiva (salario mensual ÷ 208 h/mes) contra el mínimo aplicable. Esta conversión es exclusiva de la verificación de salario mínimo y no sustituye la fórmula de valor hora para Horas extras.
  • Aprobar una planilla con colaboradores por debajo del mínimo requiere una anulación de supervisor con justificación, que se registra en la bitácora (Auditoría) junto con el nombre del usuario y el detalle de los colaboradores afectados. Conserve estas justificaciones como respaldo ante MITRADEL.

Solución de problemas

Síntoma Causa probable Solución
La planilla no muestra ningún aviso de salario mínimo La empresa no tiene actividad u ocupación de salario mínimo configurada, o no hay tarifa vigente para esa combinación. Configure Distrito, Actividad económica y Categoría en la empresa (Clientes → empresa → Salario mínimo (MITRADEL)) y confirme que exista una tarifa activa y vigente.
No se calcula la región de la empresa (queda como Región 1) El distrito no coincide con el listado de Región 1, o está vacío. Verifique la ortografía del distrito; si no pertenece a Región 1, la región correcta es Región 2. Sin distrito, el sistema asume Región 1.
El aviso indica «No hay tarifa vigente» para la actividad de la empresa La combinación actividad + ocupación + región no tiene una fila activa dentro de su rango de vigencia. Cree o active la tarifa correspondiente en Configuración → Salario Mínimo con Vigente Desde apropiado y Activo marcado.
No puedo aprobar la planilla pese a tener permiso Hay colaboradores por debajo del mínimo y falta la justificación. Complete la Justificación (obligatoria) en la ventana de anulación y presione Anular y aprobar.
No aparece el botón de anulación / no puedo aprobar El rol no tiene permiso de aprobación. Solicite que un usuario con rol Approver o FullAccess apruebe la planilla.
No veo Nuevo ni Eliminar, o Guardar está deshabilitado El mantenimiento de la matriz requiere el rol Acceso total. Solicite el cambio a un usuario con Acceso total.

Funciones relacionadas

  • Parámetros legales (/settings/pay-parameters): tasas de CSS, Seguro Educativo e ISR.
  • Clientes / Empresas (/master/companies): asignación de distrito, actividad y categoría por empresa.
  • Planilla (detalle de corrida): verificación automática y anulación de supervisor por salario mínimo.
  • Auditoría (/auditoria): registro de las anulaciones de supervisor.

¿Te resultó útil esta página?