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>
160 lines
6.2 KiB
Markdown
160 lines
6.2 KiB
Markdown
# 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
|