569eaeb5a4
MAI-009 Facturación Transporte (31 SP): - README, REQUERIMIENTOS (7 RF), RESUMEN-EPICA - 5 User Stories: generación factura, recargos, CFDI/Carta Porte, conciliación/pagos, estados de cuenta MAI-010 Liquidaciones (31 SP): - README, REQUERIMIENTOS (6 RF), RESUMEN-EPICA - 5 User Stories: esquemas pago, cálculo por viaje, viáticos, deducciones, generar/autorizar liquidación Part of Phase 2 - P0 Critical Modules specification Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
14 KiB
14 KiB
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.deduccionescon estado (pendiente, aprobada, rechazada, aplicada) - Tabla:
settlements.tipos_deduccionpara 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