ec43d9c6cd
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>
185 lines
7.6 KiB
Markdown
185 lines
7.6 KiB
Markdown
# 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
|