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>
18 KiB
18 KiB
US-MAI002-005: Aprobar descuento excepcional
ID: US-MAI002-005 Módulo: MAI-002 (Tarifas y SLA) Prioridad: Media Story Points: 5
Historia de Usuario
Como gerente comercial Quiero aprobar o rechazar solicitudes de descuentos que excedan los límites autorizados Para mantener control sobre los márgenes y evitar erosión de rentabilidad
Criterios de Aceptación
CA-001: Definir políticas de descuento
Dado que necesito establecer límites por rol Cuando configuro las políticas Entonces puedo definir: rol, % máximo permitido, monto máximo, y si requiere aprobación
CA-002: Solicitud automática de aprobación
Dado que un vendedor aplica un descuento que excede su límite Cuando intenta guardar la cotización Entonces el sistema genera automáticamente una solicitud de aprobación
CA-003: Notificación al aprobador
Dado que hay una solicitud pendiente Cuando se crea Entonces el aprobador recibe notificación (email, app, dashboard)
CA-004: Aprobar con justificación
Dado que soy aprobador y reviso una solicitud Cuando decido aprobar Entonces debo registrar una justificación y la solicitud queda aprobada
CA-005: Rechazar con motivo
Dado que soy aprobador y la solicitud no procede Cuando decido rechazar Entonces registro el motivo y el vendedor es notificado
CA-006: Escalamiento automático
Dado que el descuento excede el límite de mi nivel de aprobación Cuando apruebo parcialmente o escalo Entonces la solicitud sube al siguiente nivel (supervisor → gerente → director)
CA-007: Auditoría de aprobaciones
Dado que necesito revisar el histórico Cuando consulto el reporte Entonces veo todas las aprobaciones/rechazos con fecha, usuario, justificación y monto
Mockup / UI
┌─────────────────────────────────────────────────────────────────┐
│ POLÍTICAS DE DESCUENTO [+ Nueva]│
├─────────────────────────────────────────────────────────────────┤
│ │
│ LÍMITES POR ROL │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Vendedor Junior │ │
│ │ Límite: hasta 3% o $500 MXN (lo que sea menor) │ │
│ │ Aprobador: Vendedor Senior [Editar]│ │
│ ├─────────────────────────────────────────────────────────┤ │
│ │ Vendedor Senior │ │
│ │ Límite: hasta 5% o $2,000 MXN │ │
│ │ Aprobador: Gerente Comercial [Editar]│ │
│ ├─────────────────────────────────────────────────────────┤ │
│ │ Gerente Comercial │ │
│ │ Límite: hasta 10% o $10,000 MXN │ │
│ │ Aprobador: Director Comercial [Editar]│ │
│ ├─────────────────────────────────────────────────────────┤ │
│ │ Director Comercial │ │
│ │ Límite: hasta 15% o $50,000 MXN │ │
│ │ Aprobador: CEO (nivel final) [Editar]│ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ REGLAS ADICIONALES │
│ │
│ ☑ Descuento > 10% siempre requiere justificación escrita │
│ ☑ Descuento > $5,000 requiere aprobación de Finanzas │
│ ☑ Cliente nuevo: límite reducido 50% (primeros 3 meses) │
│ │
└─────────────────────────────────────────────────────────────────┘
Solicitud de Aprobación (Vendedor)
┌─────────────────────────────────────────────────────────────────┐
│ SOLICITAR APROBACIÓN DE DESCUENTO ✕ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ⚠ El descuento solicitado excede tu límite autorizado │
│ │
│ Tu límite: 5% ($2,000 MXN) │
│ Descuento solicitado: 8% ($1,039.52) │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ DETALLE DE LA COTIZACIÓN │
│ │
│ Cotización: COT-2026-00457 │
│ Cliente: Distribuidora ABC │
│ Servicio: CDMX → GDL | $12,994.00 │
│ Descuento solicitado: 8% = $1,039.52 │
│ Total con descuento: $11,954.48 │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ JUSTIFICACIÓN (Obligatoria) │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Cliente estratégico con 3 años de relación. Están │ │
│ │ evaluando cotización de competidor con precio similar. │ │
│ │ Potencial de 15 viajes mensuales si ganamos la cuenta. │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Aprobador: María González (Gerente Comercial) │
│ │
│ [Cancelar] [Enviar Solicitud] │
│ │
└─────────────────────────────────────────────────────────────────┘
Bandeja de Aprobaciones (Gerente)
┌─────────────────────────────────────────────────────────────────┐
│ APROBACIONES PENDIENTES (3) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 🔴 URGENTE | Hace 15 min │ │
│ │ │ │
│ │ Solicitante: Pedro Ramírez (Vendedor Senior) │ │
│ │ Cotización: COT-2026-00457 │ │
│ │ Cliente: Distribuidora ABC │ │
│ │ Descuento: 8% ($1,039.52) │ │
│ │ │ │
│ │ Justificación: │ │
│ │ "Cliente estratégico con 3 años de relación. Están │ │
│ │ evaluando cotización de competidor..." │ │
│ │ │ │
│ │ [Ver cotización completa] │ │
│ │ │ │
│ │ [❌ Rechazar] [⬆ Escalar] [✓ Aprobar] │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 🟡 NORMAL | Hace 2 horas │ │
│ │ │ │
│ │ Solicitante: Ana López (Vendedor Junior) │ │
│ │ Cotización: COT-2026-00455 │ │
│ │ Cliente: Comercial XYZ │ │
│ │ Descuento: 5% ($925.00) │ │
│ │ │ │
│ │ [Ver detalle] [❌ Rechazar] [✓ Aprobar] │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Diálogo de Aprobación
┌─────────────────────────────────────────────────────────────────┐
│ APROBAR DESCUENTO ✕ │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Cotización: COT-2026-00457 │
│ Descuento solicitado: 8% ($1,039.52) │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ DECISIÓN │
│ │
│ (●) Aprobar el descuento solicitado (8%) │
│ ( ) Aprobar parcialmente: [____] % │
│ ( ) Rechazar │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ COMENTARIO (Obligatorio) │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Aprobado. Cliente estratégico, el volumen proyectado │ │
│ │ justifica el descuento. Revisar margen al cierre del │ │
│ │ trimestre. │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [Cancelar] [Confirmar] │
│ │
└─────────────────────────────────────────────────────────────────┘
Reporte de Auditoría
┌─────────────────────────────────────────────────────────────────┐
│ AUDITORÍA DE DESCUENTOS │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Periodo: [Enero 2026 ▼] │
│ │
│ RESUMEN │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ │
│ │ 23 │ │ 18 │ │ 3 │ │ 2 │ │
│ │ Solicitudes│ │ Aprobadas │ │ Rechazadas │ │ Pendientes │ │
│ └────────────┘ └────────────┘ └────────────┘ └────────────┘ │
│ │
│ Monto total aprobado: $45,230.00 │
│ Descuento promedio: 6.2% │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ DETALLE │
│ │
│ | Fecha | Cotización | Solicitante | % | Monto | Estado |│
│ |--------|------------|-------------|-----|---------|--------|│
│ | 27-ene | COT-00457 | P. Ramírez | 8% | $1,039 | ✓ Apr. |│
│ | 26-ene | COT-00455 | A. López | 5% | $925 | ✓ Apr. |│
│ | 25-ene | COT-00452 | J. García | 12% | $3,500 | ❌ Rech.|│
│ | 24-ene | COT-00448 | P. Ramírez | 6% | $780 | ✓ Apr. |│
│ │
│ [Exportar a Excel] │
│ │
└─────────────────────────────────────────────────────────────────┘
Notas Técnicas
- Tabla:
politicas_descuentocon límites por rol - Tabla:
solicitudes_aprobacioncon estado (pendiente, aprobada, rechazada) - Tabla:
aprobacionescon detalle de cada decisión - Notificaciones vía módulo de notificaciones (erp-core)
- Auditoría completa con usuario, fecha y justificación
Definición de Done
- CRUD de políticas de descuento
- Generación automática de solicitud si excede límite
- Notificación a aprobadores
- Flujo de aprobación/rechazo con justificación
- Escalamiento a siguiente nivel
- Reporte de auditoría de descuentos
- Tests de flujo de aprobación
- Tests de escalamiento