# Gastos en otras monedas (oct-2026)

Pedido: cargar gastos en otra moneda (USD, etc.) y que el pago afecte la cuenta del
banco en su moneda, con el asiento contable correcto.

## Cómo estaba

- La pantalla de gastos no tenía moneda ni cotización: todo quedaba en guaraníes.
  El backend ya guardaba `gasto_cab.moneda_id` / `cotizacion`, pero nadie los mandaba,
  y si faltaba la cotización quedaba en 1 (USD 100 se contabilizaba como Gs. 100).
- Tesorería descontaba `gasto.total` tal cual, sin mirar la moneda de la cuenta.
  El cheque se grababa siempre en `'PYG'`. Lo mismo en la orden de pago.
- La orden de pago automática de una compra contado se creaba con `cotizacion: 1`.

## Reglas

`src/common/utils/moneda-cuenta.util.ts` (`montoEnMonedaDeCuenta`). Las usan el gasto
(al guardar y al generar el egreso) y la orden de pago (al crearla y al sincronizar
tesorería). El frontend replica la misma tabla en `GastosTemplate.jsx` (`pagoEnCuenta`).

| Moneda del documento | Moneda de la cuenta | Qué se descuenta |
|---|---|---|
| X | X | el total, sin convertir |
| extranjera | PYG | total × cotización (se guarda en `tes_movimientos.tipo_cambio`) |
| PYG | extranjera | no se permite |
| extranjera A | extranjera B | no se permite |

Cotización del gasto: en PYG siempre 1. En otra moneda tiene que ser real (> 0 y ≠ 1);
si no viene se toma `MonedasService.getCotizacionVigente` a la fecha del gasto; si
tampoco hay, el gasto no se graba. Cubre también requisición → gasto, que no la manda.

## Asiento

Sin cambios de forma: igual que facturas, compras, OP y recibos, las líneas van en
guaraníes (`moneda_origen 'PYG'`) con la moneda y la cotización en la glosa. Ningún
reporte contable lee `debe_moneda` en moneda extranjera, así que cambiar sólo gastos
los dejaba distintos al resto. Un gasto contado usa una sola cotización y cuadra; uno
a crédito pagado por OP ya calcula la diferencia de cambio en `integrarOrdenPago`.

## Qué toca del ERP existente

- **Migración** `20261016100000_tes_movimientos_tipo_cambio`: columna nueva y opcional
  `tes_movimientos.tipo_cambio DECIMAL(18,6)`. No modifica datos.
- `GastosTesoreriaService`: `resolverCuentaPago` (cuenta elegida → regla PAGO_GASTO),
  egreso y cheque en la moneda de la cuenta.
- `GastosService`: inyecta `MonedasService` (GastosModule importa MonedasModule);
  moneda/cotización cuentan como edición financiera sólo si cambian de verdad
  (por código: un gasto viejo sin moneda que llega con PYG no cambió). KPIs del
  listado sumados en guaraníes.
- `PagosProveedorService.create`: valida la moneda de cada cuenta del banco contra la
  de la OP. `syncTesoreriaOrdenPago`: monto en la moneda de la cuenta, cheque con la
  moneda real.
- `ComprasService.createOrdenPagoAutomatica`: usa la cotización de la compra.
  Antes, una compra contado en USD dejaba la OP con cotización 1 y el asiento del
  pago acreditaba el banco por el monto en dólares como si fueran guaraníes.

## Fuera de alcance / pendiente

- **Libro IVA (export Marangatu)**: ventas, compras y gastos exportan los montos sin
  convertir y sólo marcan "moneda extranjera = S". No se cambió: hay que confirmar con
  el contador si el registro de comprobantes los pide en guaraníes y, si es así,
  corregir los tres juntos.
- Importador de gastos (Excel / Marangatu): sigue sólo en guaraníes.
- Pantalla de recibos multi: el backend acepta moneda, el wizard no la manda.
- `tes_reglas` no distingue por moneda: si la regla PAGO_GASTO apunta a una cuenta en
  guaraníes, un gasto en USD sin cuenta elegida se paga desde ahí convirtiendo.

## Pruebas

- Unitarias: `src/common/utils/moneda-cuenta.util.spec.ts`, `src/gastos/gastos-multimoneda.spec.ts`.
- E2E: `frontend/e2e/gastos-multimoneda.real.spec.js` (`pnpm run e2e:gastos` con `E2E_BASE_URL`,
  `E2E_API_URL`, `E2E_USER`, `E2E_PASS`). 2026-10-16 en test: 6/6 con Kety (sin CONTABILIDAD:
  pantalla y tesorería) y 7/7 con DOBA, asientos incluidos. Asientos verificados: gasto USD 100
  → Debe gasto 730.000 / Haber banco USD 730.000; USD 50 desde guaraníes → 365.000 / 365.000;
  OP USD 20 a 7.400 de un gasto a 7.300 → Debe acreedor 146.000 + diferencia de cambio 2.000 /
  Haber banco 148.000.
- Para correrla con DOBA en test hizo falta: `pnpm reparent:submodulo -- --submodulo=TES_GASTOS
  --modulo=COMPRAS` (los perfiles tenían `perfiles_privilegios.modulo_id` = TESORERIA y daban 403),
  y dejar el mapeo de la copia como el de prod (GASTOS_GENERALES 11.19, DIFERENCIA_CAMBIO 13.04 /
  8.05) más IVA_NO_DEDUCIBLE en SUMAR_A_PRINCIPAL, que DOBA no tiene ni en prod.

## Arreglos del integrador que salieron de las pruebas

- `integrarGasto` pedía GASTOS_GENERALES siempre, aunque cada ítem tuviera tipo de gasto con
  cuenta: sin ese concepto mapeado, ningún gasto se contabilizaba. Ahora sólo si algún ítem la necesita.
- Igual con IVA_NO_DEDUCIBLE: se pedía en todo gasto sin factura aunque no tuviera IVA.
