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>
234 lines
13 KiB
Markdown
234 lines
13 KiB
Markdown
# RESUMEN-EPICA.md - MAI-010: Liquidaciones a Operadores
|
|
|
|
**Código:** MAI-010
|
|
**Nombre:** Liquidaciones a Operadores
|
|
**Version:** 1.0.0
|
|
**Fecha:** 2026-01-27
|
|
|
|
---
|
|
|
|
## Valor de Negocio
|
|
|
|
### Problema
|
|
|
|
Las empresas transportistas enfrentan problemas con:
|
|
- Pagos incorrectos a operadores (errores de cálculo)
|
|
- Viáticos sin control que generan pérdidas
|
|
- Deducciones no aplicadas o aplicadas sin documentar
|
|
- Liquidaciones tardías que afectan retención de operadores
|
|
- Falta de visibilidad del operador sobre sus ingresos
|
|
|
|
### Solución
|
|
|
|
Un módulo de liquidaciones que:
|
|
- Calcula automáticamente el pago según esquema configurado
|
|
- Controla viáticos con anticipos y comprobación
|
|
- Aplica deducciones con aprobación y documentación
|
|
- Genera liquidaciones periódicas con desglose claro
|
|
- Da visibilidad al operador de sus pagos pendientes
|
|
|
|
### Beneficios Esperados
|
|
|
|
| Beneficio | Métrica | Impacto |
|
|
|-----------|---------|---------|
|
|
| Precisión en pagos | -95% errores de cálculo | Confianza operador |
|
|
| Control de viáticos | +30% viáticos comprobados | Reducción pérdidas |
|
|
| Rapidez liquidación | -60% tiempo de proceso | Satisfacción operador |
|
|
| Retención operadores | -20% rotación | Estabilidad operativa |
|
|
|
|
---
|
|
|
|
## Actores y Stakeholders
|
|
|
|
### Usuarios Primarios
|
|
|
|
| Actor | Responsabilidad | Frecuencia |
|
|
|-------|-----------------|------------|
|
|
| Liquidador | Procesa y genera liquidaciones | Semanal |
|
|
| Supervisor | Aprueba deducciones y liquidaciones | Semanal |
|
|
| Operador | Consulta sus pagos | Diaria |
|
|
|
|
### Usuarios Secundarios
|
|
|
|
| Actor | Interés |
|
|
|-------|---------|
|
|
| Contador | Exporta a nómina, genera pólizas |
|
|
| Gerente Operaciones | Reportes de costos por operador |
|
|
| RRHH | Datos para expediente laboral |
|
|
|
|
---
|
|
|
|
## Flujo Principal
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ VIAJE CERRADO (con POD) │
|
|
│ (Listo para liquidar desde MAI-007) │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 1. CÁLCULO DE PAGO POR VIAJE (Automático) │
|
|
│ │
|
|
│ Viaje: VJE-0125 | Operador: Juan Pérez │
|
|
│ Esquema: Por km ($2.50/km) + Bono OTIF ($500) │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ Km recorridos (tracking): 540 km │ │
|
|
│ │ Pago por km: $1,350.00 │ │
|
|
│ │ Bono OTIF (entregó a tiempo): $500.00 │ │
|
|
│ │ ───────────────────────────────────────── │ │
|
|
│ │ Total viaje: $1,850.00 │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 2. VIÁTICOS DEL VIAJE │
|
|
│ │
|
|
│ Anticipo entregado: $2,000.00 │
|
|
│ │
|
|
│ Comprobación: │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ Combustible (ticket): $1,200.00 ✓ │ │
|
|
│ │ Casetas (TAG): $450.00 ✓ │ │
|
|
│ │ Comida (tickets): $180.00 ✓ │ │
|
|
│ │ ───────────────────────────────────────── │ │
|
|
│ │ Total comprobado: $1,830.00 │ │
|
|
│ │ Sobrante a descontar: $170.00 │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 3. DEDUCCIONES (Si aplican) │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ Multa de tránsito (VJE-0120): $500.00 │ │
|
|
│ │ Motivo: Exceso de velocidad en Qro │ │
|
|
│ │ Evidencia: Foto de infracción │ │
|
|
│ │ Estado: ✓ Aprobado por supervisor │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 4. LIQUIDACIÓN SEMANAL │
|
|
│ │
|
|
│ Operador: Juan Pérez García │
|
|
│ Periodo: 20-ene-2026 al 26-ene-2026 │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ PERCEPCIONES │ │
|
|
│ │ Viaje VJE-0120 (CDMX→GDL): $1,750.00 │ │
|
|
│ │ Viaje VJE-0125 (CDMX→MTY): $1,850.00 │ │
|
|
│ │ Viaje VJE-0128 (CDMX→GDL): $1,750.00 │ │
|
|
│ │ Bono asistencia perfecta: $300.00 │ │
|
|
│ │ ───────────────────────────────────────────── │ │
|
|
│ │ Subtotal percepciones: $5,650.00 │ │
|
|
│ │ │ │
|
|
│ │ DEDUCCIONES │ │
|
|
│ │ Sobrante viático VJE-0125: -$170.00 │ │
|
|
│ │ Multa tránsito VJE-0120: -$500.00 │ │
|
|
│ │ ───────────────────────────────────────────── │ │
|
|
│ │ Subtotal deducciones: -$670.00 │ │
|
|
│ │ │ │
|
|
│ │ ═══════════════════════════════════════════════ │ │
|
|
│ │ NETO A PAGAR: $4,980.00 MXN │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ Estado: PENDIENTE DE AUTORIZACIÓN │
|
|
│ │
|
|
│ [Autorizar] │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ 5. AUTORIZACIÓN Y EXPORTACIÓN │
|
|
│ │
|
|
│ ✓ Autorizado por: María González (Supervisor) │
|
|
│ ✓ Aceptado por operador: Juan Pérez (firma digital) │
|
|
│ │
|
|
│ [Exportar a nómina] [Generar póliza contable] │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ LIQUIDACIÓN PAGADA │
|
|
│ → Exportada a nómina │
|
|
│ → Póliza contable generada │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Criterios de Éxito
|
|
|
|
### Funcionales
|
|
|
|
- [ ] Configuración de esquemas de pago
|
|
- [ ] Cálculo automático por viaje
|
|
- [ ] Gestión de viáticos con comprobación
|
|
- [ ] Deducciones con aprobación
|
|
- [ ] Generación de liquidación periódica
|
|
- [ ] Exportación a nómina
|
|
|
|
### Técnicos
|
|
|
|
- [ ] Cálculos precisos (2 decimales)
|
|
- [ ] Auditoría de ajustes
|
|
- [ ] Portal operador con sus pagos
|
|
- [ ] Exportación <30 seg para 100 operadores
|
|
|
|
### Negocio
|
|
|
|
- [ ] <5 días entre cierre y pago
|
|
- [ ] >98% liquidaciones sin ajuste
|
|
- [ ] >90% viáticos comprobados
|
|
- [ ] 100% deducciones aprobadas
|
|
|
|
---
|
|
|
|
## Riesgos y Mitigaciones
|
|
|
|
| Riesgo | Probabilidad | Impacto | Mitigación |
|
|
|--------|--------------|---------|------------|
|
|
| Cálculo incorrecto | Media | Alto | Validación doble, auditoría |
|
|
| Viáticos sin comprobar | Alta | Medio | Alertas, bloqueo de anticipo |
|
|
| Deducciones impugnadas | Media | Medio | Evidencia obligatoria |
|
|
| Retraso en liquidación | Media | Alto | Automatización, alertas |
|
|
|
|
---
|
|
|
|
## Dependencias
|
|
|
|
### Prerequisitos
|
|
- MAI-007 (POD): Viajes cerrados
|
|
- MAI-006 (Tracking): Kilometraje real
|
|
- MAI-011 (Flota): Datos de operadores
|
|
|
|
### Habilita
|
|
- erp-core/financial: Pólizas contables
|
|
- erp-core/nomina: Integración nómina
|
|
|
|
---
|
|
|
|
## Story Points Estimados
|
|
|
|
| Historia | Complejidad | SP |
|
|
|----------|-------------|---|
|
|
| US-MAI010-001 | Media | 5 |
|
|
| US-MAI010-002 | Alta | 8 |
|
|
| US-MAI010-003 | Media | 5 |
|
|
| US-MAI010-004 | Media | 5 |
|
|
| US-MAI010-005 | Alta | 8 |
|
|
| **Total** | | **31** |
|
|
|
|
---
|
|
|
|
*Épica MAI-010 - ERP Transportistas - Sistema SIMCO v4.0.0*
|