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>
8.6 KiB
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