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>
159 lines
8.6 KiB
Markdown
159 lines
8.6 KiB
Markdown
# US-MAI005-004: Compilar kit documental
|
|
|
|
**ID:** US-MAI005-004
|
|
**Módulo:** MAI-005 (Despacho)
|
|
**Prioridad:** Media
|
|
**Story Points:** 5
|
|
|
|
---
|
|
|
|
## Historia de Usuario
|
|
|
|
**Como** despachador
|
|
**Quiero** que el sistema compile automáticamente todos los documentos necesarios para el viaje
|
|
**Para** asegurar que el operador lleva toda la documentación requerida y evitar retenciones en ruta
|
|
|
|
---
|
|
|
|
## Criterios de Aceptación
|
|
|
|
### CA-001: Compilar documentos automáticamente
|
|
**Dado** que un viaje está listo para despachar
|
|
**Cuando** accedo al kit documental
|
|
**Entonces** el sistema lista todos los documentos requeridos con su estado (disponible/pendiente)
|
|
|
|
### CA-002: Incluir orden de viaje
|
|
**Dado** que el viaje está planificado
|
|
**Cuando** compilo el kit
|
|
**Entonces** incluye la Orden de Viaje con código QR para identificación rápida
|
|
|
|
### CA-003: Incluir Carta Porte (si existe)
|
|
**Dado** que la Carta Porte fue generada en MAE-016
|
|
**Cuando** compilo el kit
|
|
**Entonces** incluye el CFDI Carta Porte con su UUID
|
|
|
|
### CA-004: Alertar documentos faltantes
|
|
**Dado** que faltan documentos obligatorios
|
|
**Cuando** reviso el kit
|
|
**Entonces** el sistema muestra alertas con los documentos pendientes
|
|
|
|
### CA-005: Disponible offline en app
|
|
**Dado** que el kit está completo
|
|
**Cuando** el operador lo descarga en su app
|
|
**Entonces** todos los documentos están disponibles sin conexión
|
|
|
|
### CA-006: Descargar paquete completo
|
|
**Dado** que necesito imprimir los documentos
|
|
**Cuando** solicito descarga
|
|
**Entonces** se genera un ZIP con todos los PDFs del kit
|
|
|
|
---
|
|
|
|
## Mockup / UI
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ KIT DOCUMENTAL ✕ │
|
|
├─────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ Viaje: VJE-0123 | Ruta: CDMX → GDL → AGS │
|
|
│ │
|
|
│ ───────────────────────────────────────────────────────────── │
|
|
│ │
|
|
│ DOCUMENTOS DEL VIAJE │
|
|
│ │
|
|
│ 📄 OBLIGATORIOS │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ ✅ Orden de Viaje │ │
|
|
│ │ OV-VJE-0123.pdf | 2 páginas | [Ver] [Descargar] │ │
|
|
│ ├─────────────────────────────────────────────────────────┤ │
|
|
│ │ ✅ Carta Porte CFDI │ │
|
|
│ │ UUID: 6ba7b810-9dad-11d1-80b4-00c04fd430c8 │ │
|
|
│ │ CP-VJE-0123.pdf | 4 páginas | [Ver] [Descargar] │ │
|
|
│ ├─────────────────────────────────────────────────────────┤ │
|
|
│ │ ✅ Remisión del cliente │ │
|
|
│ │ REM-CLI-2026-0891.pdf | [Ver] [Descargar] │ │
|
|
│ ├─────────────────────────────────────────────────────────┤ │
|
|
│ │ ⚠️ Factura del cliente │ │
|
|
│ │ PENDIENTE - El cliente no ha subido la factura │ │
|
|
│ │ [Subir manualmente] [Omitir con nota] │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ 📄 CONDICIONALES (según carga) │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ ✅ Permiso de materiales peligrosos │ │
|
|
│ │ PERM-HAZMAT-2026.pdf | [Ver] [Descargar] │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ 📄 INSTRUCCIONES POR PARADA │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ Parada 1: Almacén GDL Centro │ │
|
|
│ │ • Entregar en andén 5 │ │
|
|
│ │ • Contacto: Juan Pérez (33) 1234-5678 │ │
|
|
│ │ • Horario: 08:00 - 18:00 │ │
|
|
│ ├─────────────────────────────────────────────────────────┤ │
|
|
│ │ Parada 2: Bodega AGS │ │
|
|
│ │ • Requiere cita previa (ya agendada) │ │
|
|
│ │ • Contacto: María López (449) 876-5432 │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ ───────────────────────────────────────────────────────────── │
|
|
│ │
|
|
│ ⚠ 1 documento pendiente │
|
|
│ │
|
|
│ [Descargar ZIP] [Enviar a app] [Imprimir todo] │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Tipos de Documentos
|
|
|
|
| Tipo | Obligatorio | Fuente | Generación |
|
|
|------|-------------|--------|------------|
|
|
| Orden de Viaje | Siempre | Sistema | Automática |
|
|
| Carta Porte | Siempre | MAE-016 | Automática |
|
|
| Remisión | Por cliente | Cliente/Sistema | Manual/Auto |
|
|
| Factura | Por cliente | Cliente | Manual |
|
|
| Permiso Hazmat | Si aplica | Sistema | Referencia |
|
|
| Permiso Sobredimensión | Si aplica | SCT | Manual |
|
|
| Instrucciones | Siempre | Embarque | Automática |
|
|
|
|
---
|
|
|
|
## Validaciones de Documentos
|
|
|
|
| Código | Validación | Acción si falla |
|
|
|--------|------------|-----------------|
|
|
| DOC_001 | Orden de Viaje presente | Bloquear despacho |
|
|
| DOC_002 | Carta Porte si viaje federal | Bloquear despacho |
|
|
| DOC_003 | Permisos especiales si carga lo requiere | Bloquear despacho |
|
|
| DOC_004 | Factura del cliente | Advertencia |
|
|
| DOC_005 | Instrucciones de entrega | Advertencia |
|
|
|
|
---
|
|
|
|
## Notas Técnicas
|
|
|
|
- Tabla: `documentos_viaje`
|
|
- Generación de OV desde vista `v_orden_viaje`
|
|
- Integración con MAE-016 para obtener Carta Porte
|
|
- ZIP generado con JSZip o similar
|
|
- Sincronización a app móvil via API dedicada
|
|
- Cache de documentos para acceso offline
|
|
|
|
---
|
|
|
|
## Definición de Done
|
|
|
|
- [ ] Compilación automática de documentos
|
|
- [ ] Generación de Orden de Viaje con QR
|
|
- [ ] Integración con Carta Porte (MAE-016)
|
|
- [ ] Alertas de documentos faltantes
|
|
- [ ] Descarga de ZIP con todos los PDFs
|
|
- [ ] Sincronización a app móvil
|
|
- [ ] Validaciones bloqueantes vs advertencias
|
|
- [ ] Tests de compilación y generación
|
|
|