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>
269 lines
18 KiB
Markdown
269 lines
18 KiB
Markdown
# 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
|
|
|