Liquidaciones

Próximamente

Este módulo forma parte de Personal y Sueldos, que todavía está en desarrollo. Lo vas a ver en el menú, pero por ahora no se puede usar. Esta página describe cómo va a funcionar.

Descripción

Módulo de generación y gestión de recibos de sueldo para los empleados del consorcio. Al crear una liquidación, el sistema calcula automáticamente los conceptos de haberes y deducciones a partir de la escala salarial vigente para la categoría del empleado. Permite seguir un flujo de estados desde borrador hasta pagada, y generar el recibo en formato PDF con un token de verificación único.

Acceso

• Roles permitidos: admin, superadmin
• Ruta: /admin/liquidaciones

Funcionalidades

Indicadores Resumen

Se muestran 4 tarjetas con métricas de las liquidaciones:

Indicador	Descripción
Total	Cantidad total de liquidaciones registradas
Borradores	Liquidaciones en estado borrador (amarillo)
Emitidas	Liquidaciones emitidas pendientes de pago (azul)
Pagadas	Liquidaciones marcadas como pagadas (verde)

Crear Liquidación

Botón "Nueva Liquidación" que abre un diálogo con 3 campos:

• Empleado: select con los empleados activos del consorcio (muestra apellido, nombre y categoría)
• Periodo: selector de mes (input type month, default: mes actual)
• Tipo: select con los tipos disponibles (default: Mensual)

Al confirmar con "Generar Liquidación", el sistema ejecuta el siguiente flujo:

1. Obtiene los datos del empleado seleccionado
2. Busca la escala salarial vigente para la categoría del empleado (primero personalizada, luego SUTERH)
3. Si no encuentra escala vigente, muestra error y no genera la liquidación
4. Calcula los conceptos automáticamente (haberes y deducciones)
5. Crea el registro de liquidación en estado borrador
6. Inserta los conceptos calculados en la tabla liquidacion_conceptos

Ver Detalle

Al hacer click en una fila de la tabla o en el botón con icono de ojo se abre un diálogo con el desglose completo de la liquidación:

• Datos del empleado y periodo
• Sección HABERES: lista de conceptos con código, descripción y monto, más subtotal
• Sección DEDUCCIONES: lista de conceptos con código, descripción y monto, más subtotal
• Neto a Cobrar: resultado final destacado
• Fecha de liquidación y fecha de pago (si corresponde)
• Botones de acción según el estado actual

Emitir Liquidación

Botón con icono de envío (solo visible en estado borrador). Cambia el estado a emitida y registra la fecha de emisión (emitida_at). Disponible tanto en la tabla como en el diálogo de detalle.

Marcar como Pagada

Botón con icono de tarjeta de crédito (solo visible en estado emitida). Cambia el estado a pagada, registra la fecha de pago (pagada_at) y completa el campo fecha_pago con la fecha actual. Disponible tanto en la tabla como en el diálogo de detalle.

Eliminar Liquidación

Botón con icono de papelera (solo visible en estado borrador). Muestra un diálogo de confirmación. La eliminación es física: se borran primero los conceptos asociados y luego la liquidación. Solo se pueden eliminar liquidaciones en estado borrador (validado tanto en frontend como en la query de eliminación).

Descargar PDF

Botón con icono de descarga disponible para cualquier liquidación. Genera un recibo de sueldo en formato PDF (A4) usando la librería jsPDF. El PDF incluye:

• Encabezado: título "RECIBO DE SUELDO", nombre del consorcio, tipo de liquidación, periodo y token de verificación abreviado
• Datos del empleado: nombre, documento, CUIL, categoría, jornada, fecha de ingreso, antigüedad y obra social
• Tabla de haberes: cada concepto con código, descripción y monto, más subtotal
• Tabla de deducciones: cada concepto con código, descripción y monto, más subtotal
• Neto a cobrar: monto final destacado
• Fechas: fecha de liquidación, fecha de pago y estado
• Área de firmas: espacios para firma del empleado y firma del empleador
• Pie de página: leyenda "Documento generado por Consorcio Nube"

El archivo se descarga con el nombre recibo_[apellido]_[nombre]_[periodo]_[tipo].pdf.

Actualización en Tiempo Real

El módulo utiliza suscripciones realtime de Supabase para actualizar automáticamente la lista cuando se registran cambios en la tabla liquidaciones del consorcio activo.

Tipos de Liquidación

Valor	Label	Descripción
mensual	Mensual	Liquidación de sueldo mensual regular
sac	SAC (Aguinaldo)	Sueldo Anual Complementario. Se calcula como la mitad del mejor sueldo del semestre
vacaciones	Vacaciones	Liquidación de vacaciones
final	Liquidación Final	Liquidación por fin de relación laboral

Estados

Estado	Badge	Color	Descripción
borrador	Borrador	Amarillo	Liquidación generada, pendiente de revisión. Se puede editar y eliminar
emitida	Emitida	Azul	Liquidación emitida, pendiente de pago. Solo se puede marcar como pagada
pagada	Pagada	Verde	Liquidación abonada al empleado. Registra fecha de pago
anulada	Anulada	Rojo	Liquidación anulada

Flujo de Estados

borrador → emitida → pagada
                   ↘ anulada

Las transiciones permitidas desde la interfaz son:

• borrador → emitida: botón "Emitir"
• emitida → pagada: botón "Marcar Pagada"
• Solo las liquidaciones en borrador pueden eliminarse

Conceptos de Liquidación

Haberes (calculados automáticamente)

Código	Descripción	Cálculo
SB	Sueldo Básico	Sueldo básico de la escala x factor de jornada (1.0 completa, 0.5 media)
ANT	Antigüedad	Sueldo básico ajustado x porcentaje de antigüedad x años de antigüedad
PRES	Presentismo	Sueldo básico ajustado x porcentaje de presentismo
VIV	Adicional Vivienda	Monto fijo de la escala. Solo se aplica si el empleado vive en el edificio

Deducciones (calculadas automáticamente)

Código	Descripción	Cálculo
JUB	Jubilación	Total haberes x porcentaje jubilación
OS	Obra Social	Total haberes x porcentaje obra social
SIND	Cuota Sindical	Total haberes x porcentaje sindicato

Conceptos SAC

Para liquidaciones de tipo SAC, los conceptos son:

Código	Descripción	Cálculo
SAC	SAC (1° o 2° Semestre)	Total haberes mensual / 2
JUB-SAC	Jubilación SAC	Monto SAC x porcentaje jubilación
OS-SAC	Obra Social SAC	Monto SAC x porcentaje obra social
SIND-SAC	Cuota Sindical SAC	Monto SAC x porcentaje sindicato

El semestre se determina automáticamente según el mes del periodo: meses 1-6 corresponden al 1° semestre, meses 7-12 al 2° semestre.

Token de Verificación

Cada liquidación tiene un campo token único generado al momento de la creación. Este token se muestra abreviado (primeros 12 caracteres) en el PDF del recibo y permite verificar la autenticidad del documento.

Filtros y búsqueda

• Búsqueda por texto: nombre, apellido o documento del empleado
• Filtro por estado (select): Todos, Borrador, Emitida, Pagada, Anulada
• Filtro por periodo (select): lista de periodos existentes, ordenados de más reciente a más antiguo