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>
236 lines
14 KiB
Markdown
236 lines
14 KiB
Markdown
# 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
|
|
|