# 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: `cotizaciones` con snapshot de tarifa aplicada - Tabla: `cotizacion_detalle` para el desglose - Tabla: `snapshot_tarifa` para 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