9caeae936a
MAI-002 (Tarifas y SLA): - README, REQUERIMIENTOS, RESUMEN-EPICA - 5 User Stories (31 SP total) - Covers: tarifario por lane, recargos, SLA, cotizaciones, aprobaciones MAI-004 (Planeacion TMS): - README, REQUERIMIENTOS, RESUMEN-EPICA - 5 User Stories (39 SP total) - Covers: tablero planeacion, consolidacion, asignacion, validaciones, ETA MAI-005 (Despacho): - README, REQUERIMIENTOS, RESUMEN-EPICA - 5 User Stories (28 SP total) - Covers: checklist NOM-068, sellos, evidencias, kit documental, gate out Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
13 KiB
13 KiB
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