# US-MAI015-002: Crear OT desde portal

**ID:** US-MAI015-002
**Modulo:** MAI-015 (Portal Cliente)
**Prioridad:** Media
**Story Points:** 5

---

## Historia de Usuario

**Como** usuario cliente
**Quiero** crear ordenes de transporte desde el portal
**Para** solicitar servicios sin llamar o enviar emails

---

## Criterios de Aceptacion

### CA-001: Crear OT manual
**Dado** que necesito un envio
**Cuando** lleno el formulario
**Entonces** creo una OT con origen, destino, fechas, carga

### CA-002: Usar plantilla
**Dado** que tengo rutas frecuentes
**Cuando** selecciono una plantilla
**Entonces** los datos se precargan y solo confirmo

### CA-003: Validar datos
**Dado** que ingrese datos
**Cuando** envio la OT
**Entonces** el sistema valida direcciones, fechas y disponibilidad

### CA-004: Ver cotizacion
**Dado** que la OT es valida
**Cuando** reviso antes de confirmar
**Entonces** veo precio estimado segun tarifa vigente

### CA-005: Confirmar y dar seguimiento
**Dado** que confirmo la OT
**Cuando** se procesa
**Entonces** veo el numero asignado y puedo dar seguimiento

---

## Mockup / UI

### Crear OT

```
+----------------------------------------------------------+
| CREAR ORDEN DE TRANSPORTE                                |
+----------------------------------------------------------+
|                                                          |
|  [Crear desde cero]  [Usar plantilla v]  [Carga masiva] |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  ORIGEN                                                 |
|                                                          |
|  Direccion guardada: [CEDIS CDMX                   v]   |
|  o Ingresar nueva direccion:                            |
|  [Av. Tlahuac 500, Iztapalapa, CDMX 09000          ]   |
|                                                          |
|  Fecha de carga: [29-ene-2026]                         |
|  Ventana: [08:00] a [10:00]                            |
|  Contacto: [Pedro Sanchez     ] Tel: [55 1234 5678]    |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DESTINO                                                |
|                                                          |
|  Direccion guardada: [CEDIS Monterrey              v]   |
|                                                          |
|  Fecha de entrega: [30-ene-2026]                       |
|  Ventana: [10:00] a [14:00]                            |
|  Contacto: [Ana Martinez      ] Tel: [81 9876 5432]    |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  CARGA                                                  |
|                                                          |
|  Descripcion: [Electrodomesticos - 25 tarimas         ]|
|  Peso: [18,500    ] kg    Volumen: [45     ] m3        |
|  Tipo equipo: [Caja seca 53'                       v]  |
|                                                          |
|  Instrucciones especiales:                             |
|  [Producto fragil. Estibar max 2 niveles.            ]|
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  REFERENCIAS                                            |
|                                                          |
|  Numero de pedido (PO): [PO-12350            ]         |
|  ASN: [ASN-2026-0089          ]                        |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  COTIZACION ESTIMADA                                    |
|                                                          |
|  Tarifa base:              $15,500.00                  |
|  Fuel surcharge (5%):         $775.00                  |
|  ─────────────────────────────────────                 |
|  Total estimado:           $16,275.00 MXN              |
|                                                          |
|  * Precio final puede variar segun recargos           |
|                                                          |
|  [Guardar como plantilla]                              |
|                                                          |
|  [Cancelar]                        [Confirmar OT]      |
|                                                          |
+----------------------------------------------------------+
```

### Plantillas Guardadas

```
+----------------------------------------------------------+
| MIS PLANTILLAS                                 [+ Nueva] |
+----------------------------------------------------------+
|                                                          |
|  | Nombre           | Ruta              | Uso/mes |     |
|  |------------------|-------------------|---------|     |
|  | Semanal MTY      | CDMX -> Monterrey |   4     | [*] |
|  | Quincenal GDL    | CDMX -> Guadalaj. |   2     | [*] |
|  | Mensual TIJ      | CDMX -> Tijuana   |   1     | [*] |
|                                                          |
|  [*] = Usar plantilla                                   |
|                                                          |
+----------------------------------------------------------+
```

---

## Validaciones

| Campo | Validacion | Mensaje |
|-------|------------|---------|
| Direccion | Geocodificable | Direccion no encontrada |
| Fecha carga | > hoy | Fecha debe ser futura |
| Fecha entrega | > fecha carga | Entrega debe ser despues de carga |
| Peso | <= 25,000 kg | Excede peso maximo |
| Credito | Disponible | Cliente sin credito |

---

## Notas Tecnicas

- Tabla: `transport.ordenes_transporte`
- Tabla: `transport.plantillas_ot_cliente`
- Geocodificacion con Google Maps API
- Cotizacion desde MAI-002 (Tarifas)
- Notificacion a planeacion al crear

---

## Definicion de Done

- [ ] Formulario de creacion de OT
- [ ] Direcciones guardadas
- [ ] Plantillas reutilizables
- [ ] Validacion de datos
- [ ] Cotizacion estimada
- [ ] Confirmacion y numero de OT
- [ ] Notificacion a operaciones
- [ ] Tests de creacion