# 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