📚 Documentación v1.0

Documentación PlanillaPro

Guía completa para gestionar la nómina de tu empresa en Honduras. Cálculo automático de IHSS, RAP, AFP e ISR 2024.

🚀 Inicio rápido

De cero a primera planilla en 4 pasos.

Crea tu cuenta

Regístrate con tu email y el nombre de tu empresa. Las deducciones legales se configuran solas.

Agrega empleados

Nombre, DPI, salario y tipo de pago (quincenal o mensual). El número de empleado se genera automático.

Genera la planilla

Selecciona el período. El sistema calcula IHSS, RAP, AFP e ISR de todos los empleados activos.

Aprueba y descarga

Revisa, envía a revisión, aprueba. Descarga la planilla completa o recibos individuales en PDF.

🏗️ Arquitectura multi-tenant

Cada empresa tiene su espacio completamente aislado.

Cada empresa tiene su propio org_id. Todas las queries filtran por él.

👥 Empleados

Expediente digital completo con historial salarial y préstamos.

Requerido

DPI / Identidad — Único por empresa. No puede repetirse.

Opcional

Email — Único por empresa si se proporciona.

Opcional

Número de empleado — Se genera automático si no se especifica (EMP-0001).

Requerido

Salario nominal — En Lempiras. Se almacena en centavos internamente.

Requerido

Tipo de pago — Quincenal (salario ÷ 2) o Mensual.

Requerido

Tipo de contrato — Indefinido, Temporal o Por hora.

Préstamos: Se registran en el perfil del empleado (pestaña "Préstamos"). Al aprobar una planilla, la cuota se descuenta automáticamente del saldo pendiente.

📊 Planillas

Generación automática para todos los empleados activos.

📅 Quincenal

Salario nominal ÷ 2. Fechas: 1–15 y 16–fin de mes.

📅 Mensual

Salario nominal completo. Del 1 al último día del mes.

Cada ítem de planilla puede editarse individualmente antes de aprobar:

Horas extras

Comisiones

Kilometraje

Transporte

Otras entradas

Otras deducciones

✅ Flujo de aprobación

⚠️ Inmutabilidad: Una vez aprobada (pagado), la planilla no puede modificarse. Los préstamos descontados también se actualizan automáticamente.

⚙️ Deducciones Honduras 2024

Configuradas automáticamente al registrarse. Los porcentajes se almacenan en base 10,000.

Código	Nombre	Tasa	Valor interno	Aplica a
IHSS_EMP	IHSS Empleado	2.5%	250	Empleado
IHSS_PAT	IHSS Patronal	5.0%	500	Empleador
RAP_EMP	RAP Empleado	1.5%	150	Empleado
RAP_PAT	RAP Patronal	1.5%	150	Empleador
AFP_EMP	AFP Empleado	1.5%	150	Empleado
AFP_PAT	AFP Patronal	2.0%	200	Empleador
ISR	ISR	Escalonado	0	Empleado
PRESTAMO	Préstamo	Manual	0	Empleado

📐 Cálculo del ISR

El ISR se calcula de forma escalonada proyectando el salario del período a anual.

Fórmula:

salarioAnual = salarioPeriodo × (tipo === "quincenal" ? 24 : 12)
isrAnual = calcularISREscalonado(salarioAnual)
isrPeriodo = Math.round(isrAnual / divisor)

👤 Gestión de equipo

El administrador puede invitar a otros usuarios a su organización.

Ve a Configuración → Equipo para invitar usuarios. El link de invitación expira en 7 días.

🔐 Roles y permisos

Acción	Admin	RRHH	Contador
Gestionar empleados	✅	✅	👁️
Crear planillas	✅	✅	❌
Editar ítems (borrador)	✅	✅	❌
Enviar a revisión	✅	✅	❌
Aprobar / rechazar	✅	❌	❌
Descargar PDFs	✅	✅	✅
Configurar deducciones	✅	❌	❌
Invitar usuarios	✅	❌	❌

👁️ = solo lectura

🗺️ Roadmap

Funciones planificadas para próximas versiones.

Próximamente

— Envío de recibos por correo al aprobar
— Reportes comparativos entre períodos
— Exportación a Excel

Planificado

— Cálculo de décimo cuarto y aguinaldo
— Vacaciones y liquidaciones
— App móvil para consulta

En estudio

— Integración con SAR Honduras
— Firma electrónica de recibos
— API pública para integraciones