← Tutoriales por extra

💵 Nómina + comisiones

Cálculo automático períodos quincena/mes · comisiones por venta/cita/servicio · deducciones TSS/AFP/SFS · genera ar-pdfs DGT-RD compliant.

1. ¿Qué resuelve?

• Compliance laboral RD · TSS · AFP · SFS · ISR retenciones · DGT cert.
• Comisiones consistentes · cada venta/cita aporta automático · evita discrepancias mes-a-mes.
• Reportes período · tarjeta nómina por empleado · totales empresa · histórico.

2. Cuándo activarlo

• ≥ 3 empleados nominados (TSS registrados).
• Comisiones variables (vendedor retail · estilista salón · médico clínica).
• Auditoría DGT inminente · necesitas trail certificado.

3. Setup

1. Activar extras hr.payroll + hr.commissions_auto desde /extras.
2. Configurar empresa empleadora en /superadmin/tenants/[slug]/fiscal · RNC empleador · nombre legal · representante.
3. Por cada empleado en /employees/[id]:
   • Cédula + TSS NSS + fecha ingreso · cargo · sueldo base.
   • Reglas comisiones: % por servicio prestado · % por venta cobrada · monto fijo por cita · combinaciones.
4. Crear período en /employees/payroll · primera quincena del mes (1-15) o mes completo (1-31) · sistema calcula automático.
5. Revisar borrador · ajustes manuales si aplica (bonos · descuentos extra) · aprobar.

4. Flujo típico (quincena)

1. Día 14 · sistema agrega ventas + citas del período · calcula comisiones.
2. Día 15 mañana · admin abre /employees/payroll · revisa borrador período.
3. Ajustes · bonos productividad · vacaciones · permisos sin sueldo.
4. Aprobar · sistema genera PDF tarjeta empleado + envía via email · marca período cerrado.
5. Pago · admin transfiere via banco · actualiza estado pagado manualmente.
6. Cierre mes · reporte consolidado deducciones · reporta TSS/DGT con CSV export.

5. Troubleshooting

• Comisiones aparecen 0 · verifica reglas en /employees/[id] · confirma ventas/citas en período tienen empleado asociado · revisa cargo emisor.
• Deducción incorrecta · % TSS/AFP/SFS configurables en /superadmin/system/payroll-rates · cambios entran próximo período.
• PDF no genera · verifica plantilla en @vertix/pdf · revisa logs server console superadmin.

6. Integraciones

• @react-pdf/renderer · genera tarjetas DGT compliant.
• Resend · email tarjeta empleado período cerrado.
• Webhooks · payroll.period.closed dispara integración contable (Quickbooks · SAP).
• CSV export · TSS Suir Plus · AFP · DGT formatos.

7. Compliance RD

Vertix calcula deducciones según tablas vigentes 2026: TSS 2.87% empleado · AFP 2.87% · SFS 3.04% · ISR escalonado sueldo bruto. Verifica tablas mensualmente · DGT actualiza enero cada año.

Reference: apps/web/app/employees/payroll/ · módulo hr.payroll + hr.commissions_auto en module_extras.