# 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_descuento` con límites por rol - Tabla: `solicitudes_aprobacion` con estado (pendiente, aprobada, rechazada) - Tabla: `aprobaciones` con 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