Modules documented: - MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US - MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA - MAI-008 (Incidencias): 3 US (18 SP) - MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA - MAI-012 (Combustible): 3 US (18 SP) - MAI-013 (Mantenimiento): 3 US (18 SP) - MAI-014 (Carriers): 3 US (18 SP) - MAI-015 (Portal): 3 US (18 SP) - MAE-016 (Carta Porte): 10 US - MAE-017 (HOS): 3 US (16 SP) - MAE-018 (Reportes): 3 US (18 SP) Phase 2+3 complete: 13 modules, 50+ User Stories Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
7.6 KiB
US-MAI008-003: Calcular y aplicar impacto economico
ID: US-MAI008-003 Modulo: MAI-008 (Incidencias) Prioridad: Media Story Points: 5
Historia de Usuario
Como supervisor o facturador Quiero calcular el impacto economico de las incidencias Para reflejarlo en facturacion, liquidaciones o reclamos
Criterios de Aceptacion
CA-001: Registrar conceptos de costo
Dado que la incidencia tiene impacto economico Cuando registro los costos Entonces especifico concepto, monto y responsable
CA-002: Multiples conceptos
Dado que una incidencia puede tener varios impactos Cuando la reviso Entonces puedo agregar multiples conceptos de costo
CA-003: Aprobar impacto
Dado que los costos afectan a terceros Cuando superen un umbral Entonces requieren aprobacion de supervisor
CA-004: Generar movimiento financiero
Dado que el impacto esta aprobado Cuando cierro la incidencia Entonces se genera el movimiento correspondiente (NC, cargo, deduccion)
CA-005: Asociar a rentabilidad
Dado que quiero medir rentabilidad real Cuando el costo se registra Entonces se asocia al viaje para calculos de margen
Mockup / UI
+----------------------------------------------------------+
| IMPACTO ECONOMICO - Incidencia #023 X |
+----------------------------------------------------------+
| |
| Incidencia: Dano a mercancia |
| Viaje: VJE-0125 | Cliente: CEMEX S.A. |
| Responsabilidad determinada: Almacen destino |
| |
| ------------------------------------------------------ |
| |
| CONCEPTOS DE COSTO [+ Agregar]|
| |
| | Concepto | Descripcion | Monto | Cargo a | Estado | |
| |----------|-------------|-------|---------|--------| |
| | Dano mer | 5 cajas prod| $4,500| Cliente | Aprob. | |
| | Reexpedi.| Envio repos.| $1,200| Empresa | Pend. | |
| |----------|-------------|-------|---------|--------| |
| | TOTAL | $5,700| | |
| |
| ------------------------------------------------------ |
| |
| AGREGAR CONCEPTO |
| |
| Tipo: [Dano a mercancia v] |
| o Dano a mercancia |
| o Penalizacion SLA |
| o Reexpedicion |
| o Deducible seguro |
| o Multa transito |
| o Faltante |
| |
| Descripcion: [________________________________] |
| Monto: [$________] |
| |
| Cargo a: |
| ( ) Cliente (genera nota de credito) |
| (o) Empresa (costo operativo) |
| ( ) Operador (deduccion en liquidacion) |
| ( ) Tercero/Carrier (reclamo) |
| ( ) Seguro (expediente de reclamo) |
| |
| [Agregar concepto] |
| |
| ------------------------------------------------------ |
| |
| MOVIMIENTOS FINANCIEROS A GENERAR |
| |
| [x] Nota de credito a CEMEX por $4,500.00 |
| Motivo: Dano a mercancia en viaje VJE-0125 |
| |
| [ ] Deduccion a operador (No aplica) |
| |
| ------------------------------------------------------ |
| |
| ! Monto > $1,000 requiere aprobacion de supervisor |
| |
| [Cancelar] [Solicitar Aprobacion] [Aplicar] |
| |
+----------------------------------------------------------+
Reporte de Incidencias por Costo
+----------------------------------------------------------+
| REPORTE: COSTO DE INCIDENCIAS |
+----------------------------------------------------------+
| |
| Periodo: Enero 2026 |
| |
| ------------------------------------------------------ |
| |
| RESUMEN POR TIPO |
| |
| | Tipo | Cantidad | Costo Total | % del Total | |
| |------------|----------|-------------|-------------| |
| | Dano | 8 | $45,200.00 | 42% | |
| | Faltante | 12 | $28,500.00 | 26% | |
| | Retraso | 25 | $18,000.00 | 17% | |
| | Robo | 2 | $12,000.00 | 11% | |
| | Otros | 5 | $4,300.00 | 4% | |
| |------------|----------|-------------|-------------| |
| | TOTAL | 52 | $108,000.00 | 100% | |
| |
| ------------------------------------------------------ |
| |
| TOP 5 CLIENTES CON MAS INCIDENCIAS |
| |
| 1. CEMEX S.A. - 12 incidencias - $32,000 |
| 2. Liverpool - 8 incidencias - $18,500 |
| 3. Bimbo - 6 incidencias - $12,200 |
| |
| ------------------------------------------------------ |
| |
| KPI: Costo incidencias / Ingresos = 2.1% |
| (Meta: < 3%) |
| |
+----------------------------------------------------------+
Tipos de Movimiento Financiero
| Responsable | Movimiento | Destino |
|---|---|---|
| Cliente | Nota de credito | MAI-009 Facturacion |
| Empresa | Gasto operativo | Contabilidad |
| Operador | Deduccion | MAI-010 Liquidaciones |
| Tercero/Carrier | Reclamo | CxC Terceros |
| Seguro | Expediente | Gestion separada |
Notas Tecnicas
- Tabla:
tracking.costos_incidencia - Tabla:
billing.movimientos_incidencia - Relacion con
settlements.deducciones - Umbral de aprobacion configurable por tenant
- Reportes en modulo MAE-018
Definicion de Done
- Registro de multiples conceptos de costo
- Asignacion de responsable por concepto
- Flujo de aprobacion para montos altos
- Generacion de movimientos financieros
- Asociacion a viaje para rentabilidad
- Reporte de costos por periodo
- Tests de calculo e integracion