# US-MAI010-004: Aplicar deducciones **ID:** US-MAI010-004 **Módulo:** MAI-010 (Liquidaciones) **Prioridad:** Media **Story Points:** 5 --- ## Historia de Usuario **Como** supervisor de operaciones **Quiero** aplicar deducciones a operadores por multas, daños o faltantes **Para** recuperar pérdidas y mantener la disciplina operativa --- ## Criterios de Aceptación ### CA-001: Catálogo de tipos de deducción **Dado** que hay diferentes causas de deducción **Cuando** administro el catálogo **Entonces** tengo tipos como: multa, daño unidad, daño carga, faltante, préstamo ### CA-002: Registrar deducción **Dado** que ocurrió un evento que amerita deducción **Cuando** la registro **Entonces** especifico: tipo, monto, viaje relacionado, evidencia ### CA-003: Requiere aprobación **Dado** que las deducciones afectan al operador **Cuando** registro una deducción **Entonces** queda pendiente hasta que un supervisor apruebe ### CA-004: Plan de pagos **Dado** que el monto es alto para descontar de una vez **Cuando** configuro la deducción **Entonces** puedo establecer un plan (descontar $X por liquidación) ### CA-005: Límite de deducción **Dado** que hay políticas de límite **Cuando** las deducciones exceden el % permitido del pago **Entonces** el sistema alerta y requiere autorización especial ### CA-006: Historial por operador **Dado** que quiero ver el comportamiento de un operador **Cuando** consulto su historial **Entonces** veo todas las deducciones aplicadas --- ## Mockup / UI ``` ┌─────────────────────────────────────────────────────────────────┐ │ REGISTRAR DEDUCCIÓN ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Operador: Juan Pérez García │ │ No. Empleado: OP-0025 │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ TIPO DE DEDUCCIÓN │ │ │ │ Tipo: [Multa de tránsito ▼] │ │ ○ Multa de tránsito │ │ ○ Daño a unidad │ │ ○ Daño a carga │ │ ○ Faltante de mercancía │ │ ○ Préstamo/Adelanto │ │ ○ Sobrante de viático │ │ ○ Otro │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ DETALLE │ │ │ │ Viaje relacionado: [VJE-0120 ▼] │ │ Fecha del evento: [2026-01-21] │ │ │ │ Descripción: │ │ [Infracción por exceso de velocidad en carretera 57D ]│ │ [Querétaro. Límite 90 km/h, velocidad 112 km/h. ]│ │ │ │ Monto total: [$1,200.00] │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ EVIDENCIA │ │ │ │ [📷 Agregar foto] [📄 Agregar documento] │ │ │ │ ✓ multa_transito_001.jpg (Foto de infracción) │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ FORMA DE DESCUENTO │ │ │ │ (●) Descontar completo en próxima liquidación │ │ ( ) Plan de pagos: [____] pagos de $[_____] │ │ │ │ [Cancelar] [Enviar a aprobación] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Aprobar Deducción ``` ┌─────────────────────────────────────────────────────────────────┐ │ APROBAR DEDUCCIÓN ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ SOLICITUD DE DEDUCCIÓN │ │ │ │ Operador: Juan Pérez García │ │ Tipo: Multa de tránsito │ │ Monto: $1,200.00 │ │ Viaje: VJE-0120 │ │ │ │ Descripción: │ │ Infracción por exceso de velocidad en carretera 57D │ │ Querétaro. Límite 90 km/h, velocidad 112 km/h. │ │ │ │ Evidencia: [📷 Ver foto] │ │ │ │ Registrado por: María González │ │ Fecha solicitud: 2026-01-22 │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ POLÍTICA DE EMPRESA │ │ │ │ Según política, las multas de tránsito se descuentan al │ │ operador en un 100% cuando son por exceso de velocidad. │ │ │ │ Límite de deducción por liquidación: 30% del pago bruto │ │ Pago estimado próxima liquidación: $5,650.00 │ │ Máximo descuento permitido: $1,695.00 │ │ ✓ Esta deducción está dentro del límite │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ DECISIÓN │ │ │ │ (●) Aprobar deducción │ │ ( ) Aprobar con monto ajustado: $[______] │ │ ( ) Rechazar │ │ │ │ Comentario: │ │ [Aprobado según política ]│ │ │ │ [Cancelar] [Confirmar] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Historial de Deducciones ``` ┌─────────────────────────────────────────────────────────────────┐ │ HISTORIAL DE DEDUCCIONES - Juan Pérez García │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Periodo: [Últimos 12 meses ▼] │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ RESUMEN │ │ │ │ Total deducciones: 3 │ │ Monto total: $2,450.00 │ │ Promedio mensual: $204.17 │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ DETALLE │ │ │ │ | Fecha | Tipo | Viaje | Monto | Estado | │ │ |----------|-------------|---------|----------|------------| │ │ | 22-ene-26| Multa | VJE-0120| $1,200.00| Descontada | │ │ | 15-dic-25| Daño unidad | VJE-0089| $750.00| Descontada | │ │ | 10-oct-25| Faltante | VJE-0056| $500.00| Descontada | │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ COMPARATIVO CON OTROS OPERADORES │ │ │ │ Juan Pérez: $204/mes (promedio) │ │ Promedio empresa: $180/mes │ │ Posición: 15 de 25 operadores │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Tipos de Deducción | Tipo | Descripción | % responsabilidad | |------|-------------|-------------------| | MULTA_TRANSITO | Infracciones de tránsito | 100% operador | | DANO_UNIDAD | Daño al vehículo por negligencia | 50-100% | | DANO_CARGA | Daño a la mercancía | Según caso | | FALTANTE | Faltante de mercancía | Según caso | | PRESTAMO | Adelanto de efectivo | 100% | | SOBRANTE_VIATICO | Viático no comprobado | 100% | --- ## Notas Técnicas - Tabla: `settlements.deducciones` con estado (pendiente, aprobada, rechazada, aplicada) - Tabla: `settlements.tipos_deduccion` para catálogo - Plan de pagos: se crean N registros con monto parcial - Límite de deducción configurable por tenant (ej: 30% del bruto) - Auditoría completa de aprobaciones/rechazos --- ## Definición de Done - [ ] Catálogo de tipos de deducción - [ ] Registro de deducción con evidencia - [ ] Flujo de aprobación por supervisor - [ ] Plan de pagos para montos grandes - [ ] Validación de límite de deducción - [ ] Historial de deducciones por operador - [ ] Tests de flujo de aprobación