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

Preguntas frecuentes

Preguntas frecuentes

Aplica a: NominaHQ Roles: Todos los roles del personal (Acceso total, Captura de datos, Aprobador, Solo lectura) y administradores. Cada respuesta indica el permiso necesario cuando aplica. Referencias regulatorias: CSS (Seguro Social / Seguro Educativo), DGI (ISR / Planilla 03), Código de Trabajo, Ley 44/1995, Ley 27/2017, Decreto Ejecutivo No. 13 de 2025.

Resumen

Esta página reúne las dudas más comunes de los operadores de nómina (proveedores de servicios de nómina de Panamá) que gestionan varias empresas cliente en NominaHQ. Cubre fechas del Décimo, Salario mínimo, exportación a la CSS (SIPE) y a la DGI (Planilla 03), cálculo del ISR, Liquidación y trabajo con varias empresas. Está dirigida a quienes corren planillas y atienden el cumplimiento de sus clientes.

Navegación

Las funciones citadas en estas respuestas se encuentran en:

Conceptos clave

  • Inquilino (tenant): la empresa proveedora de nómina que usa NominaHQ. Sus clientes se registran como Empresas.
  • Planilla: la corrida de pago de un período (Quincenal, Mensual, Semanal o Bisemanal).
  • Décimo (Décimo tercer mes): bonificación legal anual pagada en tres partidas.
  • SIPE: Sistema de la Caja de Seguro Social (CSS) donde se declaran las cuotas; NominaHQ genera el archivo de Carga Masiva.
  • Planilla 03: informe mensual de ISR de la DGI (Informe 03, e-Tax 2.0).
  • CSS: Caja de Seguro Social. ISR: Impuesto Sobre la Renta. ITBMS: impuesto de transferencia de bienes y servicios.

Paso a paso (preguntas y respuestas)

1. ¿Cuándo se paga el Décimo y cómo lo genero?

El Décimo tercer mes se paga en tres partidas: el 15 de abril, el 15 de agosto y el 15 de diciembre. La base de cada partida es lo devengado del cuatrimestre (incluye Horas extras, comisiones y bonificaciones cotizables). Sobre el Décimo se aplica CSS del empleado (7.25 %) y patronal (10.75 %); no lleva Seguro Educativo ni ISR por separado.

Para generarlo:

  1. Vaya a Nómina → Planillas.

  2. Presione Nuevo Décimo.

    Barra de la pantalla Planillas con el botón Nuevo Décimo resaltado

    El botón está junto a Nueva Planilla y Crear en Lote.

  3. En el cuadro Nuevo Décimo, complete Inicio del Período, Fin del Período (el cuatrimestre) y Fecha de Pago, y presione Calcular. NominaHQ calcula la partida del Décimo para los Empleados de la empresa activa.

NominaHQ también muestra un aviso en Alertas ("Pago de décimo próximo") cuando faltan 20 días o menos para la fecha de pago.

2. ¿Cómo genero el archivo SIPE para la CSS?

  1. Vaya a Nómina → Planillas y abra la planilla del período.

  2. Presione Exportar y elija SIPE (Carga Masiva).

    Detalle de una planilla con el menú Exportar abierto: SIPE (Carga Masiva), Planilla 03 (DGI), Excel y Archivo ACH

    El menú Exportar del detalle de la planilla reúne las exportaciones oficiales.

NominaHQ produce el archivo oficial de Carga Masiva de Planilla de la CSS en formato .xlsx de 25 columnas (A–Y), que declara los rubros de ingreso de cada empleado. El SIPE empareja a los Empleados por número de documento / Seguro Social. Necesita el permiso de exportación (roles Acceso total, Captura de datos o Aprobador).

3. ¿Cómo genero la Planilla 03 para la DGI?

  1. Vaya a Nómina → Planillas y abra la planilla del período.

  2. (Opcional) Escriba el ID Planilla (recibo SIPE) en el campo de texto. Este identificador es el recibo asignado por la CSS al presentar la planilla SIPE y se usa en la columna 1 de la Planilla 03; si lo deja en blanco, se usa el número de registro patronal.

    Campo ID Planilla (recibo SIPE) resaltado junto al botón Exportar en el detalle de la planilla

    El campo está en la barra superior del detalle de la planilla, junto a Exportar.

  3. Presione Exportar y elija Planilla 03 (DGI).

El resultado es el informe oficial Planilla 03 / Informe 03 V5 de la DGI (e-Tax 2.0), en .xlsx de 33 columnas, con la retención de ISR del mes. Las columnas de deducciones personales (gastos del declarante) se emiten en cero, ya que corresponden al cierre de diciembre del empleado.

4. ¿Cómo se calcula el ISR de cada empleado?

La base es la renta neta gravable: el salario menos la cuota de CSS del empleado (9.75 %) y el Seguro Educativo (1.25 %). Esa base se anualiza (× 13, lo que incluye el Décimo) y se aplican los tramos vigentes:

  • 0 % hasta B/.11,000.
  • 15 % sobre el tramo de B/.11,000 a B/.50,000.
  • 25 % sobre el excedente de B/.50,000.

Puede revisar la proyección por empleado en Nómina → Reportes → Proyección de ISR, que muestra el ingreso anualizado, el tramo y la retención mensual.

Pantalla Reportes con la tarjeta Proyección de ISR resaltada

Haga clic en la tarjeta para generar el reporte en PDF.

5. ¿Qué pasa si un empleado gana menos del Salario mínimo?

NominaHQ compara cada salario contra el mínimo legal de MITRADEL. Si una planilla paga a uno o más Empleados por debajo del mínimo, la aprobación queda bloqueada hasta registrar una anulación de supervisor con una justificación obligatoria. Esa anulación queda registrada en la bitácora de Auditoría con su nombre; no elimina el permiso de aprobar, solo agrega un control registrado.

El Salario mínimo se resuelve por distrito, actividad económica y categoría; la región se deriva del distrito y nunca se elige a mano. Consulte la tabla oficial en Configuración → Salario mínimo; el distrito, la actividad y la categoría de cada empresa se eligen en su ficha (Maestra → Empresas).

Pantalla Salario Mínimo con la tabla por región, actividad, ocupación y tamaño de empresa

Cada línea muestra la tarifa por hora, su equivalente mensual y la fecha de vigencia.

6. ¿Cómo cambio entre mis empresas cliente?

NominaHQ es multi-empresa: su cuenta (el proveedor de nómina) administra varias empresas cliente. Use el selector de empresa de la barra superior para elegir la empresa con la que va a trabajar.

Selector de empresa de la barra superior abierto con la lista de empresas cliente

Puede escribir en el cuadro del selector para filtrar por código o nombre. Casi todas las pantallas (Empleados, Planillas, Reportes, Alertas) muestran solo los datos de la empresa activa, y cambian de inmediato al seleccionar otra. Para ver un resumen de todas sus empresas a la vez, use el Panel de inicio.

Las empresas cliente se crean y editan en Maestra → Empresas (también accesibles desde Configuración → Clientes).

7. ¿Cómo proceso una Liquidación al terminar un empleado?

Vaya a Nómina → Liquidación, elija el Empleado, la Fecha de Terminación y el Tipo de Terminación, marque Preaviso otorgado si corresponde y presione Calcular.

Pantalla Liquidación con los campos Empleado, Fecha de Terminación, Tipo de Terminación y Preaviso otorgado

Los meses de Vacaciones y de Décimo pendientes se calculan solos; puede ajustarlos manualmente.

NominaHQ liquida desde la fecha de ingreso hasta la fecha de terminación e incluye, según corresponda:

  • Preaviso de 1 mes (Art. 211/212), si no se otorgó.
  • Prima de antigüedad: 1 semana por año (Ley 44/1995).
  • Indemnización por despido injustificado (Art. 225); no se paga si el despido es justificado.
  • Vacaciones y Décimo proporcionales.

8. ¿Dónde actualizo las tasas legales (CSS, ISR) y el Salario mínimo?

Solo los administradores y el rol Acceso total pueden cambiar esta configuración. Las tasas y los tramos son sensibles a la fecha: se aplican según el período de cada planilla.

Referencia de campos

Campo Tipo Obligatorio Descripción Validación
ID Planilla (recibo SIPE) Campo de texto Opcional Recibo asignado por la CSS al presentar el SIPE; se usa en la columna 1 de la Planilla 03 Si se omite, se usa el número de registro patronal
Justificación (anulación de Salario mínimo) Campo de texto Obligatorio al anular Motivo del pago por debajo del mínimo (p. ej. tiempo parcial, por comisión, exención legal) Requerida para aprobar; se registra en la bitácora
Selector de empresa Lista desplegable Sí Selecciona la empresa cliente activa —

Roles y permisos

Rol Ver Crear Editar Eliminar Aprobar
Acceso total Sí Sí Sí Sí Sí
Captura de datos Sí Sí Sí Sí No
Aprobador Sí No No No Sí
Solo lectura Sí No No No No
Administrador Sí Sí Sí Sí Sí

Notas: la exportación (SIPE, Planilla 03, ACH, recibos) está disponible para Acceso total, Captura de datos y Aprobador, no para Solo lectura. La contabilización (registrar en GL, marcar pagada) corresponde a Acceso total y Aprobador. La configuración (Parámetros legales, Salario mínimo) y la gestión de usuarios son exclusivas de Acceso total y los administradores. El diseño aplica segregación de funciones: quien captura (Captura de datos) no aprueba ni contabiliza.

Notas de cumplimiento

  • CSS: empleado 9.75 %, empleador 13.25 % (rampa Ley 462: 14.25 % en 2027, 15.25 % en 2029). Seguro Educativo 1.25 % empleado / 1.50 % empleador. En el Décimo, CSS es 7.25 % empleado / 10.75 % empleador y no lleva Seguro Educativo.
  • ISR (DGI): 0 % hasta B/.11,000; 15 % de B/.11,000 a B/.50,000; 25 % sobre el excedente.
  • Décimo: tres partidas (15 de abril, 15 de agosto, 15 de diciembre), Código de Trabajo.
  • Liquidación: Art. 211/212 (preaviso), Ley 44/1995 (prima de antigüedad y Fondo de Cesantía), Art. 225 (indemnización).
  • Salario mínimo: Decreto Ejecutivo No. 13 de 2025 (Gaceta 30438, vigente 16-ene-2026), por actividad, región y tamaño; Salario mínimo inembargable (Art. 162).

Solución de problemas

Síntoma Causa probable Solución
No aparece el botón Exportar ni las opciones SIPE / Planilla 03 Su rol no tiene permiso de exportación (Solo lectura) Solicite a un administrador un rol con permiso de exportación
No puede aprobar la planilla Hay Empleados por debajo del Salario mínimo, o su rol no aprueba Registre la anulación de supervisor con justificación, o pida a un Aprobador o a alguien con Acceso total que apruebe
La validación de Salario mínimo aparece inactiva La empresa no tiene distrito, actividad o categoría configurados Complételos en la ficha de la empresa (Maestra → Empresas), sección Salario mínimo (MITRADEL)
Los datos no son los de la empresa que esperaba Hay otra empresa seleccionada como activa Cambie de empresa en el selector de la barra superior
El SIPE no empareja a un empleado Falta el número de Cédula o de Seguro Social Complete Cédula y No. CSS en la ficha del empleado
No puede cambiar las tasas o el Salario mínimo La configuración es exclusiva del rol Acceso total y los administradores Solicite el cambio a un administrador

Funciones relacionadas

¿Te resultó útil esta página?