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>
290 lines
18 KiB
Markdown
290 lines
18 KiB
Markdown
# 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
|
|
|