erp-transportistas-v2/docs/02-definicion-modulos/MAI-014-carriers/historias-usuario/US-MAI014-002.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3)
Modules documented:
- MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US
- MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-008 (Incidencias): 3 US (18 SP)
- MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-012 (Combustible): 3 US (18 SP)
- MAI-013 (Mantenimiento): 3 US (18 SP)
- MAI-014 (Carriers): 3 US (18 SP)
- MAI-015 (Portal): 3 US (18 SP)
- MAE-016 (Carta Porte): 10 US
- MAE-017 (HOS): 3 US (16 SP)
- MAE-018 (Reportes): 3 US (18 SP)

Phase 2+3 complete: 13 modules, 50+ User Stories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 02:24:35 -06:00

205 lines
8.8 KiB
Markdown

# US-MAI014-002: Asignar viaje a carrier
**ID:** US-MAI014-002
**Modulo:** MAI-014 (Carriers)
**Prioridad:** Alta
**Story Points:** 8
---
## Historia de Usuario
**Como** planeador de trafico
**Quiero** asignar viajes a carriers mediante cotizacion
**Para** cubrir demanda cuando no hay capacidad propia
---
## Criterios de Aceptacion
### CA-001: Solicitar cotizaciones (RFQ)
**Dado** que un viaje no tiene recurso propio
**Cuando** envio solicitud de cotizacion
**Entonces** se notifica a carriers seleccionados
### CA-002: Recibir propuestas
**Dado** que carriers reciben el RFQ
**Cuando** responden
**Entonces** veo comparativo de propuestas
### CA-003: Validar margen
**Dado** que hay un margen minimo requerido
**Cuando** comparo propuestas
**Entonces** el sistema indica si cumple el margen
### CA-004: Adjudicar a carrier
**Dado** que selecciono una propuesta
**Cuando** adjudico
**Entonces** se genera OV al carrier
### CA-005: Recibir POD del carrier
**Dado** que el carrier completo el viaje
**Cuando** sube el POD
**Entonces** se integra al expediente del viaje
---
## Mockup / UI
### Solicitar Cotizacion (RFQ)
```
+----------------------------------------------------------+
| SOLICITAR COTIZACION A CARRIERS X |
+----------------------------------------------------------+
| |
| VIAJE |
| |
| Viaje: VJE-0135 |
| Ruta: CDMX -> Guadalajara |
| Fecha carga: 28-ene-2026 08:00 |
| Fecha entrega: 29-ene-2026 14:00 |
| Tipo equipo: Caja seca 53' |
| Peso: 18,500 kg |
| |
| ------------------------------------------------------ |
| |
| CARRIERS A COTIZAR |
| |
| [x] Transportes del Norte Score: 92 [A] |
| [x] Logistica Express Score: 85 [B] |
| [x] Fletes Rapidos Score: 78 [C] |
| [ ] Carga Segura (Bloqueado - doc vencido) |
| |
| ------------------------------------------------------ |
| |
| CONFIGURACION |
| |
| Tiempo limite respuesta: [4 ] horas |
| Tarifa maxima aceptable: [$15,000.00] |
| Margen minimo requerido: [15 ] % |
| |
| Tarifa al cliente: $18,000.00 |
| Costo maximo carrier: $15,300.00 (para 15% margen) |
| |
| [Cancelar] [Enviar Solicitud] |
| |
+----------------------------------------------------------+
```
### Comparativo de Propuestas
```
+----------------------------------------------------------+
| PROPUESTAS - VJE-0135 |
+----------------------------------------------------------+
| |
| Tarifa cliente: $18,000.00 |
| Margen minimo: 15% ($2,700) |
| Vence en: 2h 15m |
| |
| ------------------------------------------------------ |
| |
| | Carrier | Tarifa | Margen | Score | |
| |-------------------|-----------|--------|-------| |
| | Trans. del Norte | $14,500 | 19.4% | 92 [A]| * |
| | Logistica Express | $15,200 | 15.5% | 85 [B]| |
| | Fletes Rapidos | $16,000 | 11.1% | 78 [C]| ! |
| |
| * Recomendado (mejor margen + score) |
| ! Por debajo del margen minimo |
| |
| ------------------------------------------------------ |
| |
| DETALLE PROPUESTA SELECCIONADA |
| |
| Carrier: Transportes del Norte |
| Tarifa propuesta: $14,500.00 |
| Tiempo transito: 10 horas |
| Unidad ofrecida: Kenworth T680 + Caja 53' |
| Operador: Juan Martinez Perez |
| |
| ------------------------------------------------------ |
| |
| MARGEN CALCULADO |
| |
| Ingreso (cliente): $18,000.00 |
| (-) Costo (carrier): $14,500.00 |
| ───────────────────────────────── |
| Margen bruto: $3,500.00 (19.4%) |
| |
| [Rechazar todas] [Adjudicar a Carrier] |
| |
+----------------------------------------------------------+
```
### Orden de Viaje a Carrier
```
+----------------------------------------------------------+
| ORDEN DE VIAJE - OVC-2026-0089 |
+----------------------------------------------------------+
| |
| Para: Transportes del Norte SA de CV |
| Contacto: Mario Lopez | 81 8765 4321 |
| |
| ------------------------------------------------------ |
| |
| DATOS DEL SERVICIO |
| |
| Referencia interna: VJE-0135 |
| Cliente final: Liverpool SA de CV |
| |
| ORIGEN |
| CEDIS CDMX |
| Av. Tlahuac 500, Iztapalapa, CDMX |
| Cita carga: 28-ene-2026 08:00 - 10:00 |
| Contacto: Pedro Sanchez | 55 1234 5678 |
| |
| DESTINO |
| CEDIS Guadalajara |
| Av. Lazaro Cardenas 2000, Zapopan, JAL |
| Cita entrega: 29-ene-2026 12:00 - 14:00 |
| Contacto: Ana Martinez | 33 9876 5432 |
| |
| ------------------------------------------------------ |
| |
| INSTRUCCIONES |
| |
| - Presentar OV impresa en origen |
| - Verificar sellos antes de salir |
| - Reportar eventos por WhatsApp |
| - Subir POD al portal dentro de 24h |
| |
| ------------------------------------------------------ |
| |
| TARIFA ACORDADA: $14,500.00 MXN |
| Pago: 15 dias despues de POD |
| |
| [Descargar PDF] [Enviar por Email] [WhatsApp] |
| |
+----------------------------------------------------------+
```
---
## Notas Tecnicas
- Tabla: `carriers.solicitudes_cotizacion`
- Tabla: `carriers.cotizaciones_carrier`
- Tabla: `carriers.ordenes_viaje_carrier`
- Notificaciones por email/WhatsApp
- Portal para carriers (upload POD)
---
## Definicion de Done
- [ ] Envio de RFQ a multiples carriers
- [ ] Recepcion y comparativo de propuestas
- [ ] Validacion de margen minimo
- [ ] Adjudicacion y generacion de OV
- [ ] Notificaciones a carrier
- [ ] Recepcion de POD del carrier
- [ ] Tests de flujo completo