# 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