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

Préstamos y anticipos

Préstamos y anticipos

Aplica a: NominaHQ Roles: Acceso total, Captura de datos (crear/editar); Aprobador y Solo lectura (consulta); el empleado ve solo los suyos en el portal. Referencias regulatorias: Código de Trabajo Art. 161 (tope de descuentos y límite del 15% para deudas con el empleador), Art. 162 (Salario mínimo inembargable).

Resumen

Esta función registra los préstamos y anticipos de salario de cada empleado y descuenta la cuota acordada de forma automática en la Planilla regular, período tras período, hasta saldar el capital. La usa el personal de nómina del proveedor para llevar el saldo pendiente de cada deuda, generar el Pagaré y guardar el documento firmado. Cada empleado puede consultar sus propios préstamos en el portal.

Navegación

Menú lateral: Nómina → Préstamos y Anticipos (ruta /payroll/prestamos). Al hacer clic en el nombre del empleado de un registro se entra a su detalle (/payroll/prestamos/{id}).

Conceptos clave

  • Préstamo: deuda con cuota fija por período. Puede tener Tasa de interés anual y un Acreedor (banco) al que la empresa remite el descuento; si se deja el acreedor en blanco, es un Préstamo del empleador.
  • Anticipo: adelanto de salario, sin interés y financiado por el empleador. Está sujeto al límite del 15% del salario devengado del período (Art. 161).
  • Capital: monto total prestado.
  • Cuota por período: monto que se descuenta en cada Planilla.
  • Saldo: capital menos lo ya pagado.
  • Tabla de amortización: desglose de cada cuota en Interés y Capital sobre saldo decreciente. Para préstamos sin interés (0%) o ya saldados aparece vacía.
  • Pagaré: documento de respaldo del préstamo, imprimible y firmable por el empleado.
  • Estado: Activo, Pagado o Cancelado.

Tarea 1 — Registrar un préstamo o un anticipo

Antes de empezar: tenga los datos del crédito: capital, cuota por período y, si es de un banco, la tasa de interés, el acreedor y la referencia. Necesita el rol Acceso total o Captura de datos.

  1. En el menú lateral, dentro de Nómina, haga clic en Préstamos y Anticipos.

    Pantalla Préstamos y Anticipos con el menú Nómina → Préstamos y Anticipos resaltado

    La lista muestra cada préstamo y anticipo de la empresa activa, con su capital, cuota, saldo y estado.

  2. Haga clic en Nuevo préstamo.

    Botón Nuevo préstamo resaltado en la parte superior de la lista

    Se abre el cuadro Nuevo préstamo.

  3. En Empleado, elija el empleado; puede escribir parte del nombre para filtrar (en el ejemplo, E102 — Gabriela Solís).

    Cuadro Nuevo préstamo con el campo Empleado resaltado

    Solo aparecen Empleados activos de la empresa.

  4. En Tipo, deje Préstamo o elija Anticipo.

    Campo Tipo resaltado con el valor Préstamo

    Un Anticipo es un adelanto de salario sin interés; al elegirlo desaparecen los campos de interés, acreedor y referencia.

  5. En Descripción, escriba para qué es el crédito (en el ejemplo, Préstamo personal).

    Campo Descripción resaltado con el texto Préstamo personal

    La descripción aparece en la planilla y en el recibo, por ejemplo Descuento de préstamo: Préstamo personal.

  6. En Monto del capital, escriba el monto total prestado (en el ejemplo, 1,200.00).

    Campo Monto del capital resaltado con $1,200.00

    Debe ser mayor que cero.

  7. En Cuota por período, escriba lo que se descontará en cada planilla (en el ejemplo, 100.00).

    Campo Cuota por período resaltado con $100.00

    Si la cuota es mayor que el capital, aparece La cuota es mayor que el capital — verifique los montos.

  8. Para un préstamo de banco, complete Tasa de interés anual (%), Acreedor (banco) y Referencia del préstamo (en el ejemplo, 8, Banco General y PP-2026-0415). Deje Acreedor (banco) en blanco si el préstamo lo otorga la empresa.

    Campo Acreedor (banco) resaltado con Banco General, con la tasa 8.00 y la referencia PP-2026-0415

    Puede elegir un banco de la lista o escribir otro acreedor.

  9. Revise la Fecha de inicio (por defecto, hoy) y haga clic en Crear. Aparece el mensaje Préstamo creado.

    Cuadro Nuevo préstamo completo con el botón Crear resaltado

    El botón Crear se habilita cuando hay empleado, capital y cuota.

  10. Verifique el nuevo registro en la lista, en estado Activo y con el Saldo igual al capital.

    Lista de préstamos con la fila de Gabriela Solís, Préstamo personal, resaltada

    Desde la próxima planilla que se calcule, NominaHQ descontará la cuota automáticamente.

Resultado: el préstamo queda registrado y activo. La cuota se descuenta en cada planilla regular hasta saldar el capital, respetando los topes legales (vea Deducciones legales).

Tarea 2 — Consultar el saldo y la tabla de amortización

  1. En la lista, haga clic en el nombre del empleado del préstamo que quiere consultar.

    Lista de préstamos con el enlace E102 — Gabriela Solís resaltado

    Se abre el detalle del préstamo.

  2. Revise el detalle: Saldo, Capital, Monto pagado, Cuota, Cuotas restantes y, si tiene interés, Tasa de interés anual. Debajo aparecen los Detalles y la Tabla de amortización (Fecha, Interés, Capital, Pago y Saldo restante de cada cuota).

    Detalle del préstamo de Gabriela Solís con sus totales, detalles y tabla de amortización

    La tabla lista solo las cuotas pendientes, una por período de pago del empleado (en el ejemplo, quincenal: el 15 y el último día de cada mes), a partir del primer día de pago posterior a la fecha de inicio; el interés de cada cuota se calcula sobre el saldo. Tiene tantas filas como Cuotas restantes y aparece vacía en los préstamos sin interés y en los ya saldados.

Resultado: conoce el saldo pendiente y cuántas cuotas faltan.

Tarea 3 — Registrar un abono fuera de planilla

Use esta tarea cuando el empleado pague una cuota por su cuenta (por ejemplo, en efectivo). Las cuotas que se descuentan en la planilla se aplican solas al aprobarla; no las registre aquí.

  1. En el detalle del préstamo, haga clic en Registrar pago.

    Botones del préstamo con Registrar pago resaltado

    Se registra una cuota completa, sin pedir confirmación. Si hay interés, la cuota cubre primero el interés del período y el resto reduce el capital.

  2. Revise el mensaje (en el ejemplo, Pago registrado: $100.00 (interés $8.00)) y el nuevo Saldo.

    Totales del préstamo después del abono, con el Saldo de $1,108.00 resaltado

    En el ejemplo, de la cuota de 100.00 se aplicaron 8.00 a interés y 92.00 a capital. Cuando el saldo llega a cero, el estado cambia a Pagado.

Resultado: el abono queda aplicado al saldo. Registrar pago solo aparece mientras el préstamo está Activo.

Tarea 4 — Imprimir el pagaré y guardar la copia firmada

  1. En el detalle del préstamo, haga clic en Pagaré.

    Botones del préstamo con Pagaré resaltado

    El pagaré se abre como PDF en una pestaña nueva.

  2. Imprima el pagaré y hágalo firmar por el empleado.

    Primera página del Pagaré y autorización de descuento de Gabriela Solís

    El documento PAGARÉ Y AUTORIZACIÓN DE DESCUENTO lleva el logo y el nombre de la empresa e incluye la cédula del empleado, el monto, la cuota, la tasa, el acreedor y la autorización para descontar el saldo de la Liquidación final. Está fechado con la fecha de inicio del préstamo. En la segunda página están los datos del préstamo (incluida la Primera cuota) y las firmas del colaborador y de la empresa.

  3. Haga clic en Subir firmado y, en la ventana Subir pagaré firmado, arrastre el archivo escaneado (PDF o imagen) o haga clic en Buscar... para elegirlo.

    Ventana Subir pagaré firmado con la zona para soltar archivos

    Al guardarse aparece Pagaré firmado guardado y el botón cambia a Ver firmado.

Resultado: el pagaré firmado queda guardado con el préstamo como prueba de que el empleado lo solicitó y recibió.

Tarea 5 — Editar un préstamo

  1. En el detalle del préstamo, haga clic en Editar.

    Botones del préstamo con Editar resaltado

    Se abre el cuadro Editar préstamo.

  2. Cambie lo necesario (Descripción, Monto del capital, Cuota por período, Tasa de interés anual (%), Acreedor (banco), Referencia del préstamo o Fecha de inicio) y haga clic en Guardar.

    Cuadro Editar préstamo con los datos del préstamo y el botón Guardar resaltado

    Aparece Préstamo actualizado. El empleado y el tipo no se pueden cambiar.

Resultado: los cambios se aplican desde la próxima planilla que se calcule o recalcule.

Tarea 6 — Cancelar un préstamo

  1. En el detalle del préstamo, haga clic en Cancelar préstamo.

    Botones del préstamo con Cancelar préstamo resaltado

    Solo aparece mientras el préstamo está Activo.

  2. Lea la pregunta ¿Cancelar este préstamo? Dejará de descontarse. y haga clic en Confirmar. Para salir sin cambios, haga clic en Cancelar.

    Ventana de confirmación Cancelar préstamo con el botón Confirmar resaltado

    Aparece Préstamo cancelado y el estado cambia a Cancelado.

Resultado: el préstamo deja de descontarse en las planillas. No se borra: sigue en la lista con su historial.

Referencia de campos

Campo Tipo Obligatorio Descripción Validación
Empleado Lista desplegable (filtrable) Sí Empleado activo de la empresa activa Debe seleccionarse
Tipo Lista desplegable No Préstamo o Anticipo (por defecto Préstamo) —
Descripción Texto No Referencia libre Máx. 256 caracteres
Monto del capital Numérico (moneda) Sí Monto total prestado Mayor que 0
Cuota por período Numérico (moneda) Sí Monto a descontar cada período Mayor que 0
Tasa de interés anual (%) Numérico No Solo Préstamo; 0 = sin interés Entre 0 y 100
Acreedor (banco) Lista desplegable con entrada libre No Solo Préstamo; en blanco = Préstamo del empleador —
Referencia del préstamo Texto No Solo Préstamo Máx. 64 caracteres
Fecha de inicio Campo de fecha No Fecha base del préstamo (por defecto hoy) —
Saldo Calculado — Capital − Pagado No editable
Cuotas restantes Calculado — Cuotas que faltan para saldar el préstamo, según el saldo, la cuota, el interés y la frecuencia de pago del empleado No editable
Estado Calculado — Activo / Pagado / Cancelado No editable

Roles y permisos

Rol Ver Crear Editar Eliminar Aprobar
Acceso total Sí Sí Sí Cancelar (no hay borrado) Sí (al aprobar la Planilla se aplican los pagos)
Captura de datos Sí Sí Sí Cancelar No
Aprobador Sí No No No Sí (al aprobar la Planilla se aplican los pagos)
Solo lectura Sí No No No No
Empleado (portal) Solo los propios No No No No

Los administradores tienen acceso completo. No existe borrado físico de un préstamo: para detener el descuento se usa Cancelar préstamo.

Notas de cumplimiento

  • Tope del 50% (Art. 161): el total de descuentos cappables no puede exceder el 50% del salario en dinero del período.
  • Deudas con el empleador — 15% (Art. 161): los anticipos de salario no pueden exceder el 15% del salario devengado del período. Los préstamos ordinarios se limitan únicamente por el tope del 50% y el piso del Salario mínimo.
  • Salario mínimo inembargable (Art. 162): el descuento nunca reduce el neto por debajo del Salario mínimo del período.
  • Prioridad de descuentos: la pensión alimenticia se aplica primero y está exenta del tope; luego las deducciones recurrentes (embargos/voluntarias); por último las cuotas de préstamos y anticipos.
  • Las cuotas se descuentan de la Planilla regular, no del Décimo.
  • El Saldo de cada préstamo se actualiza cuando se aprueba la Planilla que lo descontó (una sola vez por corrida).

Solución de problemas

Síntoma Causa probable Solución
La cuota no se descontó o se descontó menos en la Planilla Se alcanzó el tope del 50% o el piso de Salario mínimo por otras deducciones, o el anticipo agotó su límite del 15% Revise las demás deducciones del período; el resto se descontará en períodos siguientes
Aviso «La cuota no cubre el interés — auméntela.» al registrar pago La cuota es menor que el interés del período Aumente la cuota por período
La Tabla de amortización aparece vacía Préstamo sin interés (0%) o ya saldado Comportamiento esperado
No aparecen los botones Registrar pago o Cancelar préstamo El préstamo no está Activo (ya está Pagado o Cancelado) —
El préstamo no se descuenta en la Planilla Estado distinto de Activo, sin saldo pendiente, o el empleado no está incluido en la corrida Verifique el estado y el saldo, e incluya al empleado en la Planilla
El empleado no ve su préstamo en el portal El registro no corresponde a su empleado Confirme el empleado asociado al préstamo

Funciones relacionadas

  • Aprobar, pagar y contabilizar — al aprobar la planilla, las cuotas se aplican a los saldos.
  • Deducciones legales — orden de prelación y topes que limitan la cuota.
  • Décimo tercer mes — las cuotas no se descuentan del Décimo.
  • Incapacidades — afectan el salario base del período y, por ende, los topes de descuento.
  • Portal del empleado → Mis préstamos — consulta de saldos y Pagaré por parte del empleado.

¿Te resultó útil esta página?