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>
17 KiB
17 KiB
US-MAI002-004: Generar cotización rápida
ID: US-MAI002-004 Módulo: MAI-002 (Tarifas y SLA) Prioridad: Alta Story Points: 8
Historia de Usuario
Como ejecutivo de ventas Quiero generar cotizaciones rápidamente con cálculo automático de precios Para responder ágilmente a solicitudes de clientes y cerrar más negocios
Criterios de Aceptación
CA-001: Buscar tarifa automáticamente
Dado que ingreso origen, destino, tipo de unidad y cliente Cuando solicito cotizar Entonces el sistema encuentra la tarifa vigente más específica (cliente > general)
CA-002: Calcular recargos automáticos
Dado que hay recargos configurados como automáticos Cuando se genera la cotización Entonces el sistema aplica: fuel surcharge, y otros recargos automáticos
CA-003: Agregar recargos manuales
Dado que el servicio requiere cargos adicionales Cuando configuro la cotización Entonces puedo agregar manualmente: maniobras, escolta, seguro adicional, etc.
CA-004: Mostrar desglose de precio
Dado que el cliente necesita ver el detalle Cuando genero la cotización Entonces muestra: tarifa base, cada recargo con su monto, subtotal, descuento (si aplica), total
CA-005: Aplicar descuento
Dado que puedo ofrecer un descuento Cuando aplico un porcentaje Entonces si está dentro de mi límite se aplica; si excede, se envía a aprobación
CA-006: Generar PDF profesional
Dado que necesito enviar la cotización al cliente Cuando solicito el PDF Entonces genera un documento con logo, desglose, vigencia y condiciones
CA-007: Convertir a OT
Dado que el cliente acepta la cotización Cuando selecciono "Convertir a OT" Entonces se crea la OT con el snapshot de tarifa aplicada
Mockup / UI
┌─────────────────────────────────────────────────────────────────┐
│ NUEVA COTIZACIÓN ✕ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ PASO 1: INFORMACIÓN DEL SERVICIO │
│ │
│ Cliente: [Distribuidora ABC ▼] [+ Nuevo] │
│ Contacto: [Juan Pérez - Logística ▼] │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ Origen: [Ciudad de México - Bodega Norte ] 📍 │
│ Destino: [Guadalajara - Centro Distribución ] 📍 │
│ │
│ Distancia estimada: 540 km (automático) │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ Tipo de unidad: [Tractocamión - Caja seca 53' ▼] │
│ Modalidad: (●) FTL ( ) LTL │
│ Servicio: (●) Estándar ( ) Express ( ) Mismo día │
│ │
│ [Buscar Tarifa] │
│ │
└─────────────────────────────────────────────────────────────────┘
Resultado de Tarifa
┌─────────────────────────────────────────────────────────────────┐
│ COTIZACIÓN - PASO 2: PRECIO ✕ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ TARIFA ENCONTRADA │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ ✓ Tarifa específica para Distribuidora ABC │ │
│ │ Lane: CDMX → GDL (Zona Centro) │ │
│ │ Vigencia: 01-ene-2026 al 31-dic-2026 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ DESGLOSE DE PRECIO │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Tarifa base (FTL Caja seca CDMX→GDL) $11,800.00 │ │
│ │ │ │
│ │ RECARGOS AUTOMÁTICOS: │ │
│ │ + Fuel Surcharge (8%) $944.00 │ │
│ │ │ │
│ │ RECARGOS OPCIONALES: │ │
│ │ ☐ Maniobra de carga $800.00 │ │
│ │ ☐ Maniobra de descarga $800.00 │ │
│ │ ☑ Seguro adicional (0.5% sobre $500K) $250.00 │ │
│ │ ☐ Escolta de seguridad $5,000.00 │ │
│ │ │ │
│ │ ───────────────────────────────────────────────────── │ │
│ │ Subtotal $12,994.00 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ DESCUENTO │
│ │
│ Aplicar descuento: ☑ │
│ Porcentaje: [5] % = $649.70 │
│ ✓ Dentro de tu límite autorizado (hasta 5%) │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ TOTAL COTIZACIÓN: $12,344.30 MXN │
│ │
│ [← Volver] [Generar Cotización] │
│ │
└─────────────────────────────────────────────────────────────────┘
Cotización Generada
┌─────────────────────────────────────────────────────────────────┐
│ COTIZACIÓN COT-2026-00456 ✕ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ [LOGO EMPRESA] │ │
│ │ │ │
│ │ COTIZACIÓN DE SERVICIO DE TRANSPORTE │ │
│ │ No. COT-2026-00456 │ │
│ │ Fecha: 27 de enero de 2026 │ │
│ │ Vigencia: 7 días (hasta 03-feb-2026) │ │
│ │ │ │
│ │ CLIENTE │ │
│ │ Distribuidora ABC S.A. de C.V. │ │
│ │ Atención: Juan Pérez - Logística │ │
│ │ │ │
│ │ SERVICIO │ │
│ │ Origen: CDMX - Bodega Norte │ │
│ │ Destino: Guadalajara - Centro Distribución │ │
│ │ Distancia: 540 km │ │
│ │ Equipo: Tractocamión Caja seca 53' │ │
│ │ Modalidad: FTL (Carga completa) │ │
│ │ Servicio: Estándar (24-48 hrs) │ │
│ │ │ │
│ │ DESGLOSE │ │
│ │ Tarifa base $11,800.00 │ │
│ │ Fuel Surcharge (8%) $944.00 │ │
│ │ Seguro adicional $250.00 │ │
│ │ Subtotal $12,994.00 │ │
│ │ Descuento (5%) -$649.70 │ │
│ │ ───────────────────────────────────────────── │ │
│ │ TOTAL $12,344.30 MXN │ │
│ │ (Doce mil trescientos cuarenta y cuatro pesos 30/100) │ │
│ │ │ │
│ │ CONDICIONES │ │
│ │ • Tiempo de entrega: 24-48 horas hábiles │ │
│ │ • No incluye maniobras de carga/descarga │ │
│ │ • Seguro incluido hasta $500,000 MXN │ │
│ │ • Precio + IVA (16%) │ │
│ │ │ │
│ │ Cotización válida por 7 días. │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [Descargar PDF] [Enviar por Email] [Convertir a OT] │
│ │
└─────────────────────────────────────────────────────────────────┘
Lista de Cotizaciones
┌─────────────────────────────────────────────────────────────────┐
│ COTIZACIONES [+ Nueva]│
├─────────────────────────────────────────────────────────────────┤
│ │
│ Filtros: [Este mes ▼] [Todos los estados ▼] [Mi equipo ▼] │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ COT-2026-00456 | Distribuidora ABC │ │
│ │ CDMX → GDL | $12,344.30 MXN │ │
│ │ Creada: 27-ene-2026 | Vigencia: 03-feb-2026 │ │
│ │ Estado: ⏳ PENDIENTE [Ver] [Convertir a OT] │ │
│ ├─────────────────────────────────────────────────────────┤ │
│ │ COT-2026-00455 | Comercial XYZ │ │
│ │ MTY → CDMX | $18,500.00 MXN │ │
│ │ Creada: 26-ene-2026 | Vigencia: 02-feb-2026 │ │
│ │ Estado: ✅ ACEPTADA → OT-2026-00234 [Ver] │ │
│ ├─────────────────────────────────────────────────────────┤ │
│ │ COT-2026-00454 | Mayorista 123 │ │
│ │ GDL → TIJ | $45,000.00 MXN │ │
│ │ Creada: 25-ene-2026 | Vigencia: 01-feb-2026 │ │
│ │ Estado: ❌ RECHAZADA (precio alto) [Ver] │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Resumen: 15 pendientes | 8 aceptadas | 3 rechazadas | 2 vencidas│
│ │
└─────────────────────────────────────────────────────────────────┘
Estados de Cotización
| Estado | Descripción |
|---|---|
| BORRADOR | En proceso de creación |
| PENDIENTE | Enviada al cliente, esperando respuesta |
| ACEPTADA | Cliente aceptó, convertida a OT |
| RECHAZADA | Cliente rechazó |
| VENCIDA | Pasó la fecha de vigencia sin respuesta |
| CANCELADA | Anulada por el vendedor |
Notas Técnicas
- Tabla:
cotizacionescon snapshot de tarifa aplicada - Tabla:
cotizacion_detallepara el desglose - Tabla:
snapshot_tarifapara guardar la tarifa al momento de cotizar - Generación de PDF con template HTML + puppeteer
- Conversión a OT crea la orden con los mismos datos
Definición de Done
- Búsqueda de tarifa por lane/cliente
- Cálculo automático de recargos
- Agregar recargos manuales
- Desglose completo de precio
- Aplicación de descuento con validación
- Generación de PDF profesional
- Envío por email
- Conversión a OT
- Gestión de estados (pendiente, aceptada, etc.)
- Tests de cálculo de precios