569eaeb5a4
MAI-009 Facturación Transporte (31 SP): - README, REQUERIMIENTOS (7 RF), RESUMEN-EPICA - 5 User Stories: generación factura, recargos, CFDI/Carta Porte, conciliación/pagos, estados de cuenta MAI-010 Liquidaciones (31 SP): - README, REQUERIMIENTOS (6 RF), RESUMEN-EPICA - 5 User Stories: esquemas pago, cálculo por viaje, viáticos, deducciones, generar/autorizar liquidación Part of Phase 2 - P0 Critical Modules specification Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
18 KiB
18 KiB
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.liquidacionescon periodo y estado - Tabla:
settlements.conceptos_liquidacionpara 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