# 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*