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>
13 KiB
13 KiB
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