# RESUMEN-EPICA.md - MAI-002: Tarifas, Contratos y SLA **Código:** MAI-002 **Nombre:** Tarifas, Contratos y SLA **Version:** 1.0.0 **Fecha:** 2026-01-27 --- ## Valor de Negocio ### Problema Las empresas transportistas enfrentan pérdidas por: - Cotizaciones inconsistentes entre vendedores - Recargos olvidados (fuel, demoras) no facturados - Tarifas desactualizadas que generan márgenes negativos - Descuentos sin control que erosionan rentabilidad - Incumplimiento de SLA sin consecuencias ### Solución Un módulo de gestión comercial que: - Centraliza tarifario por lane/servicio - Automatiza cálculo de recargos - Documenta SLA con penalizaciones - Genera cotizaciones con desglose - Controla descuentos con flujos de aprobación ### Beneficios Esperados | Beneficio | Métrica | Impacto | |-----------|---------|---------| | Recuperación de recargos | +15% ingresos por recargos | Rentabilidad | | Tiempo de cotización | -70% tiempo de respuesta | Productividad | | Control de descuentos | -50% descuentos excesivos | Margen | | Cumplimiento SLA | +20% OTIF | Satisfacción cliente | --- ## Actores y Stakeholders ### Usuarios Primarios | Actor | Responsabilidad | Frecuencia | |-------|-----------------|------------| | Ejecutivo de Ventas | Crea cotizaciones, gestiona tarifas | Diaria | | Gerente Comercial | Aprueba descuentos, define políticas | Semanal | | Administrador | Configura recargos, actualiza índices | Mensual | ### Usuarios Secundarios | Actor | Interés | |-------|---------| | Planner | Consulta tarifas para costeo de rutas | | Facturación | Usa tarifas para generar facturas | | Finanzas | Reportes de margen por cliente/lane | --- ## Flujo Principal ``` ┌─────────────────────────────────────────────────────────────────┐ │ SOLICITUD DE COTIZACIÓN │ │ (Cliente pide precio de servicio) │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 1. IDENTIFICAR SERVICIO (Ejecutivo de Ventas) │ │ │ │ Cliente: [Distribuidora ABC ▼] │ │ │ │ Origen: [CDMX - Bodega Norte ] │ │ Destino: [Guadalajara - Centro ] │ │ │ │ Tipo de equipo: (●) Caja seca 53' ( ) Refrigerado ( ) Plat │ │ Modalidad: (●) FTL ( ) LTL │ │ Servicio: (●) Estándar ( ) Express │ │ │ │ [Buscar Tarifa] │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 2. TARIFA ENCONTRADA │ │ │ │ Lane: CDMX → GDL (Zona Centro) │ │ Distancia: 540 km │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ Tarifa base: $12,500.00 MXN │ │ │ │ Vigencia: 01-ene-2026 al 31-dic-2026 │ │ │ │ Tipo: Por viaje (FTL) │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ [Continuar con Recargos] │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 3. CALCULAR RECARGOS │ │ │ │ Recargos aplicables: │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ ☑ Fuel Surcharge (8%) $1,000.00 │ │ │ │ ☐ Maniobra de carga $800.00 │ │ │ │ ☐ Maniobra de descarga $800.00 │ │ │ │ ☑ Seguro adicional (0.5%) $250.00 │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ Subtotal recargos: $1,250.00 │ │ │ │ [Continuar] │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 4. APLICAR DESCUENTO (Opcional) │ │ │ │ Subtotal: $13,750.00 MXN │ │ │ │ ¿Aplicar descuento? │ │ Descuento: [5] % = $687.50 │ │ │ │ ✓ Dentro de tu límite (hasta 5%) │ │ │ │ Total cotización: $13,062.50 MXN │ │ │ │ [Generar Cotización] │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ 5. COTIZACIÓN GENERADA │ │ │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ COTIZACIÓN COT-2026-00456 │ │ │ │ │ │ │ │ Cliente: Distribuidora ABC │ │ │ │ Servicio: CDMX → GDL | Caja seca 53' | FTL │ │ │ │ │ │ │ │ DESGLOSE: │ │ │ │ Tarifa base (FTL CDMX→GDL) $12,500.00 │ │ │ │ Fuel Surcharge (8%) $1,000.00 │ │ │ │ Seguro adicional (0.5%) $250.00 │ │ │ │ Subtotal $13,750.00 │ │ │ │ Descuento (5%) -$687.50 │ │ │ │ ───────────────────────────────────────────── │ │ │ │ TOTAL $13,062.50 MXN │ │ │ │ │ │ │ │ Vigencia cotización: 7 días │ │ │ │ Tiempo de entrega: 24-48 hrs │ │ │ └─────────────────────────────────────────────────────────┘ │ │ │ │ [Descargar PDF] [Enviar por email] [Convertir a OT] │ └─────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ COTIZACIÓN ENVIADA │ │ → Si acepta: Convertir a OT (MAI-003) │ │ → Snapshot de tarifa guardado │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Criterios de Éxito ### Funcionales - [ ] CRUD de tarifas por lane - [ ] Matriz de recargos configurable - [ ] SLA por cliente documentado - [ ] Motor de cotización automático - [ ] Flujo de aprobación de descuentos - [ ] Snapshot de tarifa al crear OT ### Técnicos - [ ] Búsqueda de tarifa <500ms - [ ] Histórico de cambios auditado - [ ] Soporte multi-moneda - [ ] Integración con API de mapas (opcional) ### Negocio - [ ] 100% cotizaciones con desglose - [ ] 100% recargos aplicados según reglas - [ ] <10% descuentos fuera de política - [ ] Tiempo de cotización <5 minutos --- ## Riesgos y Mitigaciones | Riesgo | Probabilidad | Impacto | Mitigación | |--------|--------------|---------|------------| | Tarifas no actualizadas | Alta | Alto | Alertas de vencimiento | | Índice fuel desactualizado | Media | Medio | Recordatorio mensual | | Descuentos excesivos | Media | Alto | Umbrales por rol | | Complejidad de lanes | Media | Medio | Zonas tarifarias | --- ## Dependencias ### Prerequisitos - erp-core/partners: Catálogo de clientes - erp-core/catalogs: Zonas, tipos de equipo ### Habilita - MAI-003 (OT): Precio de orden de transporte - MAI-009 (Facturación): Base para facturar --- ## Story Points Estimados | Historia | Complejidad | SP | |----------|-------------|---| | US-MAI002-001 | Alta | 8 | | US-MAI002-002 | Media | 5 | | US-MAI002-003 | Media | 5 | | US-MAI002-004 | Alta | 8 | | US-MAI002-005 | Media | 5 | | **Total** | | **31** | --- *Épica MAI-002 - ERP Transportistas - Sistema SIMCO v4.0.0*