# 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