> ## Documentation Index
> Fetch the complete documentation index at: https://docs.filexpress.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-moneda

> Monedas activas, tasas de cambio y documentos en moneda extranjera

Con multi-moneda puedes emitir **ventas, cotizaciones y compras** en una moneda distinta de la de tu país, usando la tasa de cambio vigente o una propia. Tu contabilidad, tus reportes y tus cuentas por cobrar y pagar siguen en una sola moneda: la **moneda base**.

## Cómo funciona

| Concepto | Detalle |
| - | - |
| **Moneda base** | La moneda legal del país de la empresa: **El Salvador USD**, **Guatemala GTQ**, **Estados Unidos USD**. No se cambia desde la pantalla. |
| **Monedas activas** | Las monedas extranjeras que tu empresa habilita. La base siempre está activa. |
| **Tasa de cambio** | Cuántas unidades de la moneda base equivalen a **1 unidad de la moneda extranjera**. Por ejemplo, con base USD, una tasa de `0.128` para GTQ significa que 1 GTQ = 0.128 USD. |
| **Tasa vigente** | La más reciente que no sea futura. |

> [!NOTE]
>
> Los montos guardados y todos los reportes (ventas, compras, inventario, contabilidad, BI) se expresan en la **moneda base**. La moneda extranjera se conserva como referencia del documento: el total en esa moneda y la tasa usada.

## Activar monedas y registrar tasas

Solo los **administradores** pueden modificar monedas y tasas; el resto de usuarios las consulta.

**1. Ir a la pantalla de inicio (/start)**

Es la pantalla donde eliges empresa y sucursal.

**2. Abrir la Configuración Especial de la empresa**

Haz clic en el ícono de engranaje junto a la empresa.

**3. Ir a la pestaña Configuración avanzada**

Se muestra la **Moneda base** y la tabla **Monedas disponibles** con sus códigos, nombres, símbolos y decimales.

**4. Activar las monedas que usarás**

Enciende el interruptor de cada moneda extranjera.

**5. Registrar la tasa de cambio**

En **Tasas de cambio**, elige la moneda y haz clic en **Registrar tasa**. Indica la **fecha efectiva** (no puede ser futura) y la **tasa** (mayor que 0).

Cada tasa del historial se puede **editar** o **eliminar**. Si activas una moneda que no tiene tasa vigente, un aviso lo indica y no podrás usarla en documentos hasta registrar una. Solo puede haber una tasa por moneda y día.

## Emitir un documento en moneda extranjera

Si tu empresa tiene al menos una moneda extranjera activa, los formularios de **Nueva venta**, **Punto de venta (POS)**, **Nueva cotización** y **Nueva compra** muestran el selector **Moneda del documento**.

**1. Elegir la moneda**

Por defecto está la moneda base. Al elegir otra, el sistema busca la tasa vigente a la fecha del documento.

**2. Revisar o cambiar la tasa**

Puedes escribir una **tasa propia** solo para ese documento. El botón **Usar tasa del sistema** vuelve a la tasa registrada. Si no hay tasa para esa moneda, un aviso te pide ingresarla manualmente o registrarla en Configuración avanzada.

**3. Capturar los montos en esa moneda**

En Nueva venta, Nueva cotización y Nueva compra los precios y montos se escriben en la moneda elegida. En el POS, los precios del catálogo se convierten automáticamente a esa moneda. El selector muestra el **Total en la moneda elegida** y su **Equivalente en la moneda base**.

**4. Guardar**

El sistema convierte los montos a la moneda base antes de calcular impuestos y emitir.

> [!WARNING]
>
> El **documento tributario electrónico (DTE) siempre se emite en la moneda legal del país**. La moneda extranjera queda como referencia interna del documento. Por eso el selector te lo recuerda cuando el documento se transmite.

### Qué debes saber

* En el **POS**, la moneda queda bloqueada en cuanto se agrega el primer pago al cobro.
* En una **cotización** los montos se quedan en la moneda de la cotización; al convertirla en venta se conservan su moneda y su tasa.
* Los **pagos** se convierten con la tasa del documento. No hay una tasa distinta por cobro ni ganancia o pérdida cambiaria.
* Al **editar** una venta emitida no se puede cambiar la moneda ni la tasa; los importes se muestran como están guardados, en moneda base.
* Los [borradores de venta](/docs/ventas/borradores.md) conservan los montos en la moneda del documento y la tasa ya resuelta.

## Cuentas por cobrar y por pagar

[Cuentas por cobrar](/docs/finanzas/cuentas-cobrar.md) y [Cuentas por pagar](/docs/finanzas/cuentas-pagar.md) llevan los saldos en moneda base, y además muestran el **monto del documento en su moneda** cuando este se emitió en moneda extranjera: en las filas, al registrar un pago y en el historial de pagos.

Las tarjetas de totales, los resúmenes y los reportes PDF/Excel siguen en moneda base.

## Disponibilidad

Multi-moneda es una función habilitada por negocio (indicador `multi_currency`). Si está apagada, la pestaña muestra que la gestión de monedas no está habilitada, el selector no aparece y los documentos se emiten en moneda base.

> [!TIP]
>
> Las integraciones también pueden emitir en moneda extranjera con la **API externa v2**. Ver [Integraciones](/docs/gestion/integraciones.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.