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>
266 lines
17 KiB
Markdown
266 lines
17 KiB
Markdown
# 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
|
|
|