Liquidaciones

Descripcion

Modulo de generacion y gestion de recibos de sueldo para los empleados del consorcio. Al crear una liquidacion, el sistema calcula automaticamente los conceptos de haberes y deducciones a partir de la escala salarial vigente para la categoria del empleado. Permite seguir un flujo de estados desde borrador hasta pagada, y generar el recibo en formato PDF con un token de verificacion unico.

Acceso

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

Funcionalidades

Indicadores Resumen

Se muestran 4 tarjetas con metricas de las liquidaciones:

Indicador	Descripcion
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 Liquidacion

Boton "Nueva Liquidacion" que abre un dialogo con 3 campos:

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

Al confirmar con "Generar Liquidacion", el sistema ejecuta el siguiente flujo:

1. Obtiene los datos del empleado seleccionado
2. Busca la escala salarial vigente para la categoria del empleado (primero personalizada, luego SUTERH)
3. Si no encuentra escala vigente, muestra error y no genera la liquidacion
4. Calcula los conceptos automaticamente (haberes y deducciones)
5. Crea el registro de liquidacion 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 boton con icono de ojo se abre un dialogo con el desglose completo de la liquidacion:

• Datos del empleado y periodo
• Seccion HABERES: lista de conceptos con codigo, descripcion y monto, mas subtotal
• Seccion DEDUCCIONES: lista de conceptos con codigo, descripcion y monto, mas subtotal
• Neto a Cobrar: resultado final destacado
• Fecha de liquidacion y fecha de pago (si corresponde)
• Botones de accion segun el estado actual

Emitir Liquidacion

Boton con icono de envio (solo visible en estado borrador). Cambia el estado a emitida y registra la fecha de emision (emitida_at). Disponible tanto en la tabla como en el dialogo de detalle.

Marcar como Pagada

Boton con icono de tarjeta de credito (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 dialogo de detalle.

Eliminar Liquidacion

Boton con icono de papelera (solo visible en estado borrador). Muestra un dialogo de confirmacion. La eliminacion es fisica: se borran primero los conceptos asociados y luego la liquidacion. Solo se pueden eliminar liquidaciones en estado borrador (validado tanto en frontend como en la query de eliminacion).

Descargar PDF

Boton con icono de descarga disponible para cualquier liquidacion. Genera un recibo de sueldo en formato PDF (A4) usando la libreria jsPDF. El PDF incluye:

• Encabezado: titulo "RECIBO DE SUELDO", nombre del consorcio, tipo de liquidacion, periodo y token de verificacion abreviado
• Datos del empleado: nombre, documento, CUIL, categoria, jornada, fecha de ingreso, antiguedad y obra social
• Tabla de haberes: cada concepto con codigo, descripcion y monto, mas subtotal
• Tabla de deducciones: cada concepto con codigo, descripcion y monto, mas subtotal
• Neto a cobrar: monto final destacado
• Fechas: fecha de liquidacion, fecha de pago y estado
• Area de firmas: espacios para firma del empleado y firma del empleador
• Pie de pagina: leyenda "Documento generado por Consorcio Nube"

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

Actualizacion en Tiempo Real

El modulo utiliza suscripciones realtime de Supabase para actualizar automaticamente la lista cuando se registran cambios en la tabla liquidaciones del consorcio activo.

Tipos de Liquidacion

Valor	Label	Descripcion
mensual	Mensual	Liquidacion de sueldo mensual regular
sac	SAC (Aguinaldo)	Sueldo Anual Complementario. Se calcula como la mitad del mejor sueldo del semestre
vacaciones	Vacaciones	Liquidacion de vacaciones
final	Liquidacion Final	Liquidacion por fin de relacion laboral

Estados

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

Flujo de Estados

borrador → emitida → pagada
                   ↘ anulada

Las transiciones permitidas desde la interfaz son:

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

Conceptos de Liquidacion

Haberes (calculados automaticamente)

Codigo	Descripcion	Calculo
SB	Sueldo Basico	Sueldo basico de la escala x factor de jornada (1.0 completa, 0.5 media)
ANT	Antiguedad	Sueldo basico ajustado x porcentaje de antiguedad x anos de antiguedad
PRES	Presentismo	Sueldo basico 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 automaticamente)

Codigo	Descripcion	Calculo
JUB	Jubilacion	Total haberes x porcentaje jubilacion
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:

Codigo	Descripcion	Calculo
SAC	SAC (1° o 2° Semestre)	Total haberes mensual / 2
JUB-SAC	Jubilacion SAC	Monto SAC x porcentaje jubilacion
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 automaticamente segun el mes del periodo: meses 1-6 corresponden al 1° semestre, meses 7-12 al 2° semestre.

Token de Verificacion

Cada liquidacion tiene un campo token unico generado al momento de la creacion. Este token se muestra abreviado (primeros 12 caracteres) en el PDF del recibo y permite verificar la autenticidad del documento.

Filtros y busqueda

• Busqueda 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 mas reciente a mas antiguo