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>
234 lines
13 KiB
Markdown
234 lines
13 KiB
Markdown
# 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*
|