P4 Software / NominaHQ

Parámetros legales

Parámetros legales

Aplica a: NominaHQ Roles: Administradores y rol Acceso total (capacidad Configurar). Los demás roles no editan esta pantalla. Referencias regulatorias: CSS (Ley 51/2005; rampa patronal Ley 462/2025), CSS reducida del décimo (régimen obrero-patronal, Ley 114/1973), Seguro Educativo, ISR (Código Fiscal — tramos de personas naturales), Riesgos Profesionales (según CIIU).

Resumen

Los Parámetros legales son las tasas y umbrales nacionales que el motor de planilla aplica al calcular cada corrida: las cuotas de Seguro Social (CSS), el Seguro Educativo, el Riesgos Profesionales por defecto, la CSS reducida del Décimo y los tramos del ISR. Cada parámetro tiene una vigencia por fecha, de modo que un cambio de ley (por ejemplo, la rampa de la cuota patronal de la Ley 462) se registra como un nuevo período de vigencia y no requiere cambios en el sistema. Estos valores son globales del proveedor (tenant): se aplican por igual a todas las empresas/clientes que usted administra. La pantalla la usa el administrador del proveedor de servicios de planilla.

Navegación

Configuración → Parámetros Legales (ruta /settings/pay-parameters).

Conceptos clave

  • Parámetro (Key / clave): identificador del valor legal, por ejemplo CSS_EMPLOYEE, ISR_R2_RATE. No se traduce; es la clave que el motor de cálculo busca.
  • Valor: número con hasta 6 decimales. Para tasas es una fracción (por ejemplo 0.097500 = 9.75 %); para umbrales/montos es una cifra en balboas (por ejemplo 11000).
  • Vigencia por fecha: cada registro tiene Vigente Desde y, opcionalmente, Vigente Hasta. Para una misma clave pueden existir varios registros con períodos distintos.
  • Resolución por período de pago: al calcular una planilla, el motor toma —para cada clave— el registro que esté Activo y cuya ventana [Vigente Desde, Vigente Hasta] contenga la fecha de pago. Si hay varios candidatos para la misma clave, gana el de Vigente Desde más reciente. Si no hay ninguno, el motor usa un valor interno por defecto.
  • CSS: Caja de Seguro Social. Cuota obrera (empleado) 9.75 %; cuota patronal 13.25 % con rampa de la Ley 462 (14.25 % desde 2027, 15.25 % desde 2029).
  • Seguro Educativo: empleado 1.25 %, patronal 1.50 %.
  • Décimo: la CSS sobre el Décimo tercer mes es reducida (empleado 7.25 %, patronal 10.75 %) y no causa Seguro Educativo.
  • ISR: Impuesto Sobre la Renta de personas naturales, anualizado; 0 % hasta 11,000; 15 % entre 11,000 y 50,000; 25 % sobre el excedente.
  • Riesgos Profesionales: cuota patronal según la actividad (CIIU). El valor RIESGOS_DEFAULT es solo el predeterminado; la tasa efectiva de cada empresa se define en la configuración de esa empresa.

Paso a paso

Consultar los parámetros vigentes

  1. Vaya a Configuración → Parámetros Legales. La tabla muestra todas las claves con su Valor, Vigente Desde, Vigente Hasta y Activo.
  2. Use el buscador para filtrar por Key o Descripción, o presione Actualizar para recargar la tabla.

Crear un parámetro

  1. Presione Nuevo.
  2. Key: escriba la clave del parámetro. Obligatorio.
  3. Descripción: texto que identifica el parámetro. Opcional.
  4. Valor: ingrese la tasa (en fracción) o el monto. Opcional (predeterminado 0).
  5. Vigente Desde: fecha en que el valor comienza a aplicar. Predeterminado: hoy.
  6. Vigente Hasta: fecha de fin de vigencia; déjelo en Ninguno si no tiene fin. Opcional.
  7. Activo: déjelo marcado para que el motor pueda usar el registro. Predeterminado: marcado.
  8. Presione Guardar.

Editar o retirar un parámetro

  1. En la tabla, haga clic en la Key del registro (o use el menú contextual de la fila) para abrir la ventana de edición.
  2. Modifique los campos necesarios. El campo Key no se puede cambiar en un registro existente.
  3. Para registrar un cambio de ley, lo recomendable es cerrar el período anterior poniéndole Vigente Hasta al registro vigente y crear un registro nuevo con la nueva tasa y su Vigente Desde. Así se conserva el historial para corridas pasadas.
  4. Para desactivar un parámetro sin borrarlo, desmarque Activo.
  5. Presione Guardar.

Eliminar

  • Desde el menú contextual de una fila, elija eliminar y confirme.
  • Para varios a la vez, seleccione las filas y presione Eliminar en la barra de acciones; confirme.

Referencia de campos

Campo Tipo Obligatorio Descripción Validación
Key Texto Identificador del parámetro (p. ej. CSS_EMPLOYEE). No editable al modificar un registro existente. Guardar se inhabilita si está vacío. Hasta 48 caracteres.
Descripción Texto No Texto descriptivo del parámetro. Hasta 256 caracteres.
Valor Numérico (6 decimales) No (def. 0) Tasa en fracción (0.097500 = 9.75 %) o monto/umbral en balboas (11000). Formato N6.
Vigente Desde Fecha No (def. hoy) Inicio de vigencia del valor.
Vigente Hasta Fecha No Fin de vigencia. Vacío (Ninguno) = sin fecha de fin.
Activo Casilla No (def. activado) Indica si el motor de cálculo puede usar el registro.

Parámetros precargados (valores por defecto del sistema)

Al habilitar un proveedor, NominaHQ precarga estas claves. Las tasas se expresan como fracción.

Key Valor Vigencia Significado
CSS_EMPLOYEE 0.0975 (9.75 %) Permanente CSS — cuota obrera (empleado)
CSS_EMPLOYER 0.1225 (12.25 %) hasta 31-mar-2025 CSS — cuota patronal (antes de la reforma)
CSS_EMPLOYER 0.1325 (13.25 %) 01-abr-2025 a 28-feb-2027 CSS — cuota patronal (Ley 462)
CSS_EMPLOYER 0.1425 (14.25 %) 01-mar-2027 a 28-feb-2029 CSS — cuota patronal (Ley 462, etapa 2)
CSS_EMPLOYER 0.1525 (15.25 %) desde 01-mar-2029 CSS — cuota patronal (Ley 462, etapa 3)
SEGURO_EDU_EMPLOYEE 0.0125 (1.25 %) Permanente Seguro Educativo (empleado)
SEGURO_EDU_EMPLOYER 0.0150 (1.50 %) Permanente Seguro Educativo (patronal)
DECIMO_CSS 0.0725 (7.25 %) Permanente CSS reducida del empleado sobre el Décimo tercer mes
DECIMO_CSS_EMPLOYER 0.1075 (10.75 %) Permanente CSS reducida patronal sobre el Décimo tercer mes
RIESGOS_DEFAULT 0.0210 (2.10 %) Permanente Riesgos Profesionales por defecto (por empresa según CIIU)
ISR_EXEMPT 11000 Permanente ISR — umbral exento (anual)
ISR_R2_FLOOR 11000 Permanente ISR — piso del tramo 2
ISR_R2_RATE 0.15 (15 %) Permanente ISR — tasa del tramo 2
ISR_R3_FLOOR 50000 Permanente ISR — piso del tramo 3
ISR_R3_BASE 5850 Permanente ISR — impuesto base del tramo 3
ISR_R3_RATE 0.25 (25 %) Permanente ISR — tasa del tramo 3

"Permanente" significa Vigente Hasta vacío: el valor aplica desde su Vigente Desde mientras no se cierre con una fecha de fin o se cree un registro posterior para la misma clave.

Roles y permisos

Cambiar parámetros legales corresponde a la capacidad Configurar, reservada al rol Acceso total. Los administradores del proveedor tienen acceso sin restricción.

Rol Ver Crear Editar Eliminar Aprobar
Administrador n/a
Acceso total n/a
Captura de datos No No No No n/a
Aprobador No No No No n/a
Solo lectura No No No No n/a

Esta pantalla no tiene una acción de "Aprobar"; la columna se incluye por formato y no aplica.

Notas de cumplimiento

  • CSS / cuota patronal: la rampa de la Ley 462/2025 está modelada por fecha (13.25 % → 14.25 % en 2027 → 15.25 % en 2029). No edite el registro vigente para "adelantar" una etapa: cada etapa ya tiene su propio período. Si una norma cambia, cree un registro nuevo con su Vigente Desde.
  • Base del ISR: el motor calcula la renta neta gravable restando del salario gravable la cuota obrera de CSS (9.75 %) y de Seguro Educativo (1.25 %), y la anualiza (incluye el Décimo). Cambiar ISR_EXEMPT, los pisos o las tasas altera la retención mensual de todas las empresas.
  • Décimo: sobre el Décimo se aplica CSS reducida (7.25 % / 10.75 %) y no Seguro Educativo; el ISR del Décimo se cubre vía la proyección anual, no como retención aparte.
  • Riesgos Profesionales: RIESGOS_DEFAULT es solo el valor por defecto. La tasa real de cada empresa depende de su clasificación CIIU y se define en la configuración de esa empresa, no aquí.
  • Alcance global: un cambio en esta pantalla afecta a todas las empresas/clientes del proveedor. Verifique fechas y valores antes de guardar.

Solución de problemas

Síntoma Causa probable Solución
El cálculo usa una tasa que no corresponde al período Existe otro registro de la misma clave con Vigente Desde más reciente, o la ventana de fechas no cubre la fecha de pago Revise todos los registros de esa clave; ajuste Vigente Desde / Vigente Hasta para que el período de pago caiga dentro de la ventana correcta.
El parámetro que edité no se usa La casilla Activo está desmarcada, o Vigente Hasta quedó antes del período de pago Marque Activo y corrija las fechas de vigencia.
No puedo cambiar el campo Key al editar La clave identifica el parámetro y no es editable en un registro existente Cree un registro nuevo si necesita otra clave.
El botón Guardar está inhabilitado El campo Key está vacío Escriba la clave del parámetro.
Cambié una tasa y afectó a todas las empresas Los parámetros legales son globales del proveedor (tenant) Es el comportamiento esperado. Para la tasa de Riesgos por empresa, use la configuración de esa empresa.
Dos registros de la misma clave se solapan en fechas Hay ventanas de vigencia que se traslapan El motor toma el de Vigente Desde más reciente; para retirar un valor, póngale Vigente Hasta o desmarque Activo.

Funciones relacionadas

  • Salario mínimo (/settings/minimum-wage) — matriz de Salario mínimo por actividad/región/tamaño.
  • Conceptos (/master/concepts) — define qué ingresos/deducciones existen y si están sujetos a CSS, Seguro Educativo e ISR.
  • Empresas / configuración de la empresa — tasa de Riesgos Profesionales y CSS del Décimo por empresa.
  • Corridas de planilla — donde estas tasas se aplican al calcular cada período.

¿Te resultó útil esta página?