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

6.2 KiB

Raw Blame History

US-MAI012-003: Liquidar anticipo de viaticos

ID: US-MAI012-003 Modulo: MAI-012 (Combustible y Gastos) Prioridad: Media Story Points: 5

Historia de Usuario

Como administrador Quiero liquidar los anticipos de viaticos al cierre de viaje Para controlar el efectivo entregado y el saldo a favor/cargo

Criterios de Aceptacion

CA-001: Ver resumen de gastos

Dado que el operador regreso del viaje Cuando inicio la liquidacion Entonces veo todos los gastos reportados vs anticipo

CA-002: Validar comprobantes

Dado que el operador presenta comprobantes Cuando los reviso Entonces puedo aprobar o rechazar cada gasto

CA-003: Calcular saldo

Dado que hay diferencia entre anticipo y gastos Cuando se calculan Entonces veo si hay reintegro (a favor empresa) o adicional (a favor operador)

CA-004: Registrar reintegro

Dado que el operador debe devolver dinero Cuando liquido Entonces registro el reintegro o genero deduccion en liquidacion

CA-005: Cerrar liquidacion

Dado que todo esta conciliado Cuando cierro la liquidacion Entonces el estado cambia a LIQUIDADO

Mockup / UI

+----------------------------------------------------------+
| LIQUIDAR ANTICIPO - VJE-0125                          X  |
+----------------------------------------------------------+
|                                                          |
|  Viaje: VJE-0125 | CDMX -> Monterrey                    |
|  Operador: Juan Perez Garcia                            |
|  Fecha viaje: 20-ene a 25-ene-2026                      |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  ANTICIPO ENTREGADO                                     |
|                                                          |
|  Monto aprobado:           $7,500.00                    |
|  Fecha entrega:            20-ene-2026                  |
|  Entregado por:            Maria Gonzalez               |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  GASTOS REPORTADOS                                      |
|                                                          |
|  | Fecha | Tipo        | Descripcion    | Monto   | St ||
|  |-------|-------------|----------------|---------|----||
|  | 21-ene| Combustible | PEMEX Qro      |$4,350.00| OK ||
|  | 22-ene| Combustible | PEMEX SLP      |$1,890.00| OK ||
|  | 21-ene| Peaje       | TAG IAVE       |  $980.00| OK ||
|  | 21-ene| Alimentos   | Restaurante    |  $180.00| OK ||
|  | 22-ene| Alimentos   | Restaurante    |  $150.00| OK ||
|  | 23-ene| Hospedaje   | Hotel Express  |  $450.00| [?]||
|  |-------|-------------|----------------|---------|----||
|  | TOTAL REPORTADO                      |$8,000.00|    ||
|                                                          |
|  [?] Hospedaje: Verificar comprobante (foto borrosa)   |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  REVISAR GASTO                                          |
|                                                          |
|  Hospedaje - Hotel Express MTY                         |
|  Monto: $450.00  Fecha: 23-ene-2026                    |
|                                                          |
|  Comprobante: [Ver foto]                               |
|                                                          |
|  Decision:                                              |
|  (o) Aprobar                                            |
|  ( ) Rechazar                                           |
|                                                          |
|  Motivo rechazo: [________________________]            |
|                                                          |
|  [Guardar decision]                                    |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  CALCULO DE SALDO                                       |
|                                                          |
|  Anticipo entregado:       $7,500.00                   |
|  (-) Gastos aprobados:     $8,000.00                   |
|  ──────────────────────────────────────                |
|  Saldo a favor operador:     $500.00                   |
|                                                          |
|  Destino del saldo:                                    |
|  (o) Pagar en efectivo                                 |
|  ( ) Incluir en proxima liquidacion                    |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  [Cancelar]                    [Cerrar Liquidacion]    |
|                                                          |
+----------------------------------------------------------+

Escenarios de Saldo

Escenario	Calculo	Accion
Gasto < Anticipo	Operador devuelve	Reintegro efectivo o deduccion
Gasto = Anticipo	Sin saldo	Cerrar
Gasto > Anticipo	Empresa debe	Pago adicional o en liquidacion

Estados del Anticipo

SOLICITADO → APROBADO → ENTREGADO → COMPROBANDO → LIQUIDADO
                                         ↓
                                    RECHAZADO

Notas Tecnicas

Tabla: fuel.anticipos_viaticos
Relacion con fuel.gastos_viaje
Relacion con settlements.deducciones (si reintegro)
Fotos de comprobantes en S3

Definicion de Done

Vista de anticipo vs gastos reportados
Revision y aprobacion de cada gasto
Calculo automatico de saldo
Opciones de destino del saldo
Generacion de deduccion si aplica
Cierre de liquidacion
Tests de calculo de saldos

6.2 KiB Raw Blame History