# US-MAI010-005: Generar y autorizar liquidación **ID:** US-MAI010-005 **Módulo:** MAI-010 (Liquidaciones) **Prioridad:** Alta **Story Points:** 8 --- ## Historia de Usuario **Como** liquidador **Quiero** generar la liquidación periódica consolidando todos los conceptos **Para** pagar al operador de forma clara y trazable --- ## Criterios de Aceptación ### CA-001: Generar liquidación por periodo **Dado** que llegó la fecha de corte (semanal/quincenal) **Cuando** genero la liquidación **Entonces** se consolidan: pagos por viaje, viáticos, bonos, deducciones ### CA-002: Desglose completo **Dado** que la liquidación fue generada **Cuando** la consulto **Entonces** veo cada concepto con su origen (viaje, tipo, monto) ### CA-003: Estado borrador editable **Dado** que la liquidación está en borrador **Cuando** detecto un error **Entonces** puedo editar o agregar conceptos con justificación ### CA-004: Autorización de supervisor **Dado** que la liquidación está lista **Cuando** la envío a autorización **Entonces** el supervisor debe aprobar antes de proceder al pago ### CA-005: Aceptación del operador **Dado** que la liquidación fue autorizada **Cuando** el operador la revisa **Entonces** puede firmar/aceptar digitalmente conforme ### CA-006: Exportar a nómina **Dado** que la liquidación está autorizada y aceptada **Cuando** exporto **Entonces** se genera archivo compatible con sistema de nómina --- ## Mockup / UI ``` ┌─────────────────────────────────────────────────────────────────┐ │ GENERAR LIQUIDACIÓN ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ CONFIGURACIÓN DEL CORTE │ │ │ │ Tipo de corte: (●) Semanal ( ) Quincenal │ │ Periodo: [20-ene-2026] al [26-ene-2026] │ │ │ │ Operadores a incluir: │ │ (●) Todos los activos con movimientos │ │ ( ) Seleccionar específicos │ │ │ │ [Generar liquidaciones] │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ RESULTADO │ │ │ │ ✓ 18 liquidaciones generadas │ │ Total a pagar: $89,450.00 │ │ │ │ [Ver listado] [Revisar y autorizar] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Liquidación Individual ``` ┌─────────────────────────────────────────────────────────────────┐ │ LIQUIDACIÓN LIQ-2026-W04-025 ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Operador: Juan Pérez García │ │ No. Empleado: OP-0025 │ │ Periodo: Semana 04 (20-ene al 26-ene-2026) │ │ Estado: BORRADOR │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ PERCEPCIONES │ │ │ │ | Concepto | Viaje | Monto | │ │ |-------------------------------------|---------|-----------| │ │ | Pago por flete (25%) | VJE-0120| $1,750.00 | │ │ | Pago por flete (25%) | VJE-0125| $4,550.00 | │ │ | Pago por flete (25%) | VJE-0128| $1,750.00 | │ │ | Bono OTIF | VJE-0120| $800.00 | │ │ | Bono OTIF | VJE-0125| $800.00 | │ │ | Bono OTIF | VJE-0128| $800.00 | │ │ | Bono sin incidencias | VJE-0120| $300.00 | │ │ | Bono sin incidencias | VJE-0125| $300.00 | │ │ | Bono sin incidencias | VJE-0128| $300.00 | │ │ |-------------------------------------|---------|-----------| │ │ | SUBTOTAL PERCEPCIONES | |$11,350.00 | │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ DEDUCCIONES │ │ │ │ | Concepto | Viaje | Monto | │ │ |-------------------------------------|---------|-----------| │ │ | Sobrante viático | VJE-0125| -$940.00 | │ │ | Multa de tránsito | VJE-0120| -$1,200.00| │ │ |-------------------------------------|---------|-----------| │ │ | SUBTOTAL DEDUCCIONES | | -$2,140.00| │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ ═══════════════════════════════════════════════════════════ │ │ NETO A PAGAR: $9,210.00 MXN│ │ ═══════════════════════════════════════════════════════════ │ │ │ │ [Editar] [Agregar concepto] [Enviar a autorización]│ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Autorización de Supervisor ``` ┌─────────────────────────────────────────────────────────────────┐ │ AUTORIZAR LIQUIDACIONES │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Periodo: Semana 04 (20-ene al 26-ene-2026) │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ PENDIENTES DE AUTORIZACIÓN │ │ │ │ [☑ Seleccionar todas] │ │ │ │ | Operador | Percepciones | Deducciones | Neto | │ │ |-----------------|--------------|-------------|-----------| │ │ | ☑ Juan Pérez | $11,350.00 | -$2,140.00 | $9,210.00 | │ │ | ☑ Pedro Ramírez | $8,200.00 | -$450.00 | $7,750.00 | │ │ | ☑ Ana López | $6,500.00 | $0.00 | $6,500.00 | │ │ | ☑ Luis García | $9,800.00 | -$800.00 | $9,000.00 | │ │ | ☐ Carlos Méndez | $7,200.00 | -$3,500.00 | $3,700.00 |⚠│ │ | | | | | │ │ |-----------------|--------------|-------------|-----------| │ │ | TOTAL SELEC. | $35,850.00 | -$3,390.00 | $32,460.00| │ │ │ │ ⚠ Carlos Méndez: Deducciones > 30% del bruto. Revisar. │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ Comentarios del supervisor: │ │ [Liquidaciones revisadas y correctas ]│ │ │ │ [Rechazar seleccionadas] [✓ Autorizar seleccionadas]│ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Aceptación del Operador ``` ┌─────────────────────────────────────────────────────────────────┐ │ ACEPTAR LIQUIDACIÓN ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Operador: Juan Pérez García │ │ Liquidación: LIQ-2026-W04-025 │ │ Neto a pagar: $9,210.00 MXN │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ Por este medio ACEPTO la liquidación correspondiente al │ │ periodo del 20 al 26 de enero de 2026, declarando que: │ │ │ │ ☑ He revisado el desglose de percepciones │ │ ☑ Estoy de acuerdo con las deducciones aplicadas │ │ ☑ El monto neto a recibir es correcto │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ FIRMA DIGITAL │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ [Área de firma - táctil] │ │ │ │ │ │ │ │ ~~~~~~~~~~~~~~~~~~~~~~ │ │ │ │ │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ [Limpiar firma] │ │ │ │ Fecha: 2026-01-27 10:35:22 │ │ IP: 192.168.1.45 │ │ │ │ [Rechazar - Solicitar revisión] [✓ Firmar y Aceptar]│ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Exportar a Nómina ``` ┌─────────────────────────────────────────────────────────────────┐ │ EXPORTAR A NÓMINA ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Periodo: Semana 04 (20-ene al 26-ene-2026) │ │ │ │ Liquidaciones autorizadas y aceptadas: 18 │ │ Total a dispersar: $89,450.00 │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ FORMATO DE EXPORTACIÓN │ │ │ │ ( ) Layout bancario dispersión (TXT) │ │ (●) Excel con desglose │ │ ( ) CSV para sistema de nómina │ │ ( ) XML CFDI recibos de nómina │ │ │ │ Incluir: │ │ ☑ Desglose de conceptos │ │ ☑ Datos bancarios de operadores │ │ ☑ Resumen por centro de costo │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ [Cancelar] [Exportar] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Estados de Liquidación | Estado | Descripción | Acciones permitidas | |--------|-------------|---------------------| | BORRADOR | Generada, editable | Editar, enviar a autorización | | PENDIENTE | Enviada a supervisor | Autorizar, rechazar | | AUTORIZADA | Aprobada por supervisor | Enviar a operador, exportar | | ACEPTADA | Firmada por operador | Exportar, pagar | | PAGADA | Dispersión realizada | Ver, generar recibo | | RECHAZADA | Rechazada (supervisor u operador) | Editar, reenviar | --- ## Notas Técnicas - Tabla: `settlements.liquidaciones` con periodo y estado - Tabla: `settlements.conceptos_liquidacion` para desglose - Firma digital se almacena como imagen base64 - Exportación genera archivos según formato seleccionado - Job automático para generar liquidaciones el día de corte --- ## Definición de Done - [ ] Generación masiva de liquidaciones por periodo - [ ] Desglose completo de conceptos - [ ] Edición de borrador con justificación - [ ] Flujo de autorización de supervisor - [ ] Aceptación con firma del operador - [ ] Exportación a múltiples formatos - [ ] Tests de flujo completo