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

8.8 KiB

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