erp-transportistas-v2/docs/02-definicion-modulos/MAI-007-pod-cierre/historias-usuario/US-MAI007-005.md
Adrian Flores Cortes 7f45eb6383 docs(modulos): MAI-007 POD y Cierre - Especificacion completa
Nuevo modulo P0 critico especificado:
- README.md: Vision general, alcance, actores, flujo
- REQUERIMIENTOS.md: 4 RF (4.7.1-4.7.4), RNF, validaciones
- RESUMEN-EPICA.md: Valor de negocio, criterios exito, 31 SP

User Stories (5):
- US-MAI007-001: Capturar firma digital (8 SP)
- US-MAI007-002: Registrar tiempos reales (5 SP)
- US-MAI007-003: Adjuntar fotos evidencia (5 SP)
- US-MAI007-004: Validar POD antes de cierre (8 SP)
- US-MAI007-005: Cerrar con excepcion (5 SP)

Este modulo es bloqueante para:
- MAI-009 (Facturacion)
- MAI-010 (Liquidaciones)
- MAE-016 (Carta Porte)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 01:33:03 -06:00

4.8 KiB
Raw Blame History

US-MAI007-005: Cerrar viaje con excepcion justificada

ID: US-MAI007-005 Modulo: MAI-007 (POD y Cierre) Prioridad: Media Story Points: 5


Historia de Usuario

Como despachador Quiero poder cerrar un viaje sin POD completo con una justificacion Para no bloquear el proceso cuando hay situaciones excepcionales


Criterios de Aceptacion

CA-001: Opcion de excepcion

Dado que el POD no cumple validaciones Cuando intento cerrar el viaje Entonces el sistema ofrece la opcion "Cerrar con excepcion"

CA-002: Motivo obligatorio

Dado que selecciono cerrar con excepcion Cuando no selecciono un motivo del catalogo Entonces el sistema no permite continuar

CA-003: Justificacion detallada

Dado que selecciono un motivo de excepcion Cuando escribo la justificacion detallada (min 20 caracteres) Entonces puedo proceder con la solicitud de excepcion

CA-004: Aprobacion pendiente

Dado que solicito cierre con excepcion Cuando completo el formulario Entonces el viaje queda en estado "EXCEPCION_PENDIENTE" hasta aprobacion

CA-005: Notificacion a supervisor

Dado que hay una excepcion pendiente Cuando se crea la solicitud Entonces el supervisor recibe notificacion para aprobar/rechazar


Catalogo de Motivos

Codigo Motivo Descripcion
EXC-001 Rechazo en destino Cliente rechazo la mercancia
EXC-002 Entrega parcial Solo se entrego parte de la carga
EXC-003 Falla dispositivo No se pudo capturar firma/fotos
EXC-004 Emergencia Accidente, robo, desastre natural
EXC-005 Cambio destino Cliente solicito entregar en otro lugar
EXC-006 Otro Especificar en justificacion

Mockup / UI

┌─────────────────────────────────────────┐
│ Cierre con Excepcion - Viaje #12345     │
├─────────────────────────────────────────┤
│                                         │
│  ⚠ El POD no cumple validaciones:       │
│  ✗ Sin firma capturada                  │
│                                         │
│  ─────────────────────────────────────  │
│                                         │
│  Motivo de excepcion: *                 │
│  ┌─────────────────────────────────┐   │
│  │ Rechazo en destino           ▼ │   │
│  └─────────────────────────────────┘   │
│                                         │
│  Justificacion detallada: *             │
│  ┌─────────────────────────────────┐   │
│  │ El cliente rechazo la carga    │   │
│  │ por dano visible en 3 cajas.   │   │
│  │ Se levanto acta con fotos.     │   │
│  │ Contacto: Juan Perez, almacen  │   │
│  └─────────────────────────────────┘   │
│                                         │
│  Evidencia adicional:                   │
│  [+ Adjuntar foto/documento]            │
│                                         │
│  ─────────────────────────────────────  │
│   Esta solicitud sera enviada a       │
│    supervisor para aprobacion.          │
│                                         │
│  [Cancelar]    [Enviar Solicitud]       │
│                                         │
└─────────────────────────────────────────┘

Flujo de Aprobacion

SOLICITUD CREADA
      │
      ▼
┌────────────────┐
│ SUPERVISOR     │
│ revisa         │
└───────┬────────┘
        │
   ┌────┴────┐
   │         │
   ▼         ▼
APROBADA  RECHAZADA
   │         │
   ▼         ▼
CERRADO   PENDIENTE
          (regresar a operador)

Notas Tecnicas

  • Excepciones se registran en tabla excepciones_pod
  • Notificacion via push notification y email
  • Timeout de aprobacion: 24 horas (escalamiento automatico)
  • Auditoria completa de quien aprobo/rechazo y cuando

Definicion de Done

  • Formulario de excepcion implementado
  • Catalogo de motivos configurable
  • Flujo de aprobacion funcional
  • Notificaciones a supervisor
  • Auditoria completa
  • Tests de flujo completo