erp-transportistas-v2/docs/02-definicion-modulos/MAI-008-incidencias/historias-usuario/US-MAI008-003.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3)
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>
2026-01-27 02:24:35 -06:00

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