--- audiencia: usuario screen_key: configuracion/facturacion/monedas-metodos-pago titulo: Monedas, Cotizaciones y Métodos de Pago aliases: - monedas - moneda principal - cotizaciones - tipo de cambio - dolar cotizacion - diferencia de cambio - metodos de pago - formas de pago - efectivo - tarjeta credito - transferencia - cheque - bancard --- # Monedas, Cotizaciones y Métodos de Pago Cubre la configuración de **Monedas** (catálogo, moneda principal), **Cotizaciones / Tipo de Cambio** (compra, venta y cotización contable por fecha) y **Métodos de Pago** (Efectivo, Tarjeta, Cheque, Transferencia, etc.) — todo bajo Configuración → Facturación. ## Dónde está esto en el menú `Configuración → Facturación → Monedas` `Configuración → Facturación → Métodos de Pago` Dentro del tab Monedas hay dos sub-pestañas: **Monedas** (catálogo) y **Cotizaciones** (tipos de cambio). ## Conceptos generales - **Moneda principal**: la moneda en la que se llevan los libros de la empresa (en Paraguay típicamente **PYG / Guaraní**). Hay **una y sólo una** por empresa. - **Monedas habilitadas**: además de la principal, se pueden habilitar **monedas adicionales** para facturar (USD, BRL, ARS, EUR…). Sólo las habilitadas aparecen en los selectores de POS, Compras, Tesorería. - **Cotización**: el tipo de cambio entre una moneda extranjera y la principal. El sistema maneja **dos vistas distintas**: - **Cotización operativa** (`cotizacion_moneda`): tiene precio de **compra** y precio de **venta**. La usa el POS, Compras y Tesorería. - **Tipo de cambio contable** (`cont_tipo_cambio`): una sola **tasa** por fecha. La usa Contabilidad para los asientos y para calcular **diferencia de cambio** ganada/perdida. - **Vigencia**: las cotizaciones son **por fecha** (foto diaria). Si una fecha no tiene cotización, el sistema **toma la última anterior**. - **PYG es base**: la tasa siempre es 1.0 y no admite cotización. - **Métodos de pago** (`medio_pago`): catálogo SIFEN (códigos 1 a 19+). La empresa habilita y ordena los que va a usar. --- ## 1. Monedas (sub-pestaña Monedas) ### 1.1 Catálogo global El sistema viene con el catálogo ISO 4217 (PYG, USD, BRL, ARS, EUR, etc.). Por moneda se guarda: | Campo | Detalle | |---|---| | Código | ISO 3 letras (PYG, USD, BRL) | | Código numérico | ISO 3 dígitos | | Descripción | "Guaraní", "Dólar Americano" | | Símbolo | "Gs.", "$", "R$" | | Decimales estándar | Cantidad de decimales por defecto (PYG=0, USD=2) | | Posición del símbolo | **L** (izquierda, default) o **R** (derecha) | | Activa | Toggle | Las **monedas nuevas** del catálogo global sólo las crea/edita un superadmin. Para cada empresa lo que se gestiona es **cuáles habilita**. ### 1.2 Monedas de la empresa Lista de las monedas habilitadas para la empresa actual. Cada fila muestra: Código, Descripción, Símbolo, **Decimales a visualizar**, **¿Principal?**, Estado y acciones. #### Agregar una moneda 1. Click en **+ Agregar moneda**. 2. Elegir la moneda del catálogo global (filtra por código o descripción). 3. **Decimales a visualizar** (default 0): cuántos decimales se muestran en facturas/recibos para esta empresa. Puede ser distinto del estándar (por ejemplo, USD con 2 vs USD con 4 para precios mayoristas). 4. Guardar. La **primera moneda agregada** se marca automáticamente como principal. #### Marcar la moneda principal - El switch **Principal** es **exclusivo**: al marcar una nueva, la anterior se desmarca sola. - La moneda principal **no se puede eliminar** mientras lo sea — primero marcar otra y después borrar. #### Activar / desactivar - Toggle **Activa**: oculta la moneda de los selectores sin borrarla. Sirve cuando una moneda dejó de usarse pero hay documentos históricos. - La moneda principal nunca se puede desactivar. ### 1.3 Validaciones - "Esta moneda ya está asignada a la empresa" (no se permite duplicar). - "No se puede eliminar la moneda principal — marcá otra como principal primero". - "Debe haber al menos una moneda principal" (no se puede dejar a la empresa sin principal). --- ## 2. Cotizaciones (sub-pestaña Cotizaciones) ### 2.1 Carga diaria Para cada moneda extranjera habilitada se cargan **una o varias cotizaciones por fecha**: | Campo | Detalle | |---|---| | Moneda | USD, BRL, ARS, … | | Fecha | Una entrada por (moneda, fecha) | | Cotización compra | A cuánto se **compra** la moneda extranjera (lo que paga la empresa al comprar dólares) | | Cotización venta | A cuánto se **vende** la moneda extranjera (lo que cobra al cliente) | **Carga**: - Manual desde la pantalla: elegir moneda + fecha + tipear los dos valores y guardar. - Si la fecha ya existe, el sistema **actualiza** la entrada (upsert). - También se puede cargar por API/integración externa (preparado, sin UI). ### 2.2 ¿Cuándo se usa "compra" y cuándo "venta"? | Operación | Tipo usado | |---|---| | Facturar al cliente en USD y cobrar en PYG | Venta | | Pagar a un proveedor en USD desde una caja en PYG | Compra | | Cobrar un crédito en USD a un cliente | Venta | | Convertir una transferencia bancaria entre cuentas en distinta moneda | Lo determina la operación (ver Tesorería) | | Valuar la deuda en USD a fin de mes | Cierre contable usa la tasa contable, no esta | > Si en una fecha no hay cotización cargada, el sistema **busca la última anterior**. Por eso conviene cargar la cotización del día apenas se conoce, especialmente para días con mucho movimiento. ### 2.3 Tipo de Cambio Contable Pantalla aparte (dentro de Contabilidad → Tipo de Cambio) que guarda **una sola tasa por (moneda, fecha)** — sin compra/venta. Sirve para: - **Asientos automáticos** de facturas, recibos, compras y pagos. - **Cálculo de diferencia de cambio**: cuando se cancela una cuenta a cobrar en USD con una cotización distinta a la del documento original, la diferencia se imputa a: - **4.2.1.02 Diferencia de Cambio Ganada** (ganancia). - **6.3.1.03 Diferencia de Cambio Perdida** (pérdida). - **Reportes contables** (Balance General, Estado de Resultados) consolidados a moneda principal. Si no hay tasa para una fecha, el sistema usa la última anterior. Si tampoco hay anterior y la moneda no es PYG → error _"No hay tipo de cambio registrado para…"_. ### 2.4 Quién mantiene cada cotización - **Compra/venta** (operativa): la carga el cajero, el administrativo o el contador todos los días. - **Tasa contable**: la carga el contador. Puede coincidir con la cotización de venta o ser una tasa pactada/promedio según la política de la empresa. --- ## 3. Métodos de Pago ### 3.1 Catálogo SIFEN El catálogo global viene con los códigos definidos por el SET. Los más usados: | Código | Método | |---|---| | 1 | Efectivo | | 2 | Tarjeta de Débito | | 3 | Tarjeta de Crédito | | 4 | Cheque | | 5 | Transferencia bancaria | | 6 | Depósito bancario | | 7+ | Billetera electrónica / QR, Vale, Bonificación, Crédito (cuenta corriente), etc. | Los códigos del catálogo no se crean ni se editan — son los oficiales que la SET acepta en el XML del documento electrónico. ### 3.2 Métodos habilitados para la empresa Pantalla **Métodos de Pago**: muestra el catálogo completo con un toggle **Activo** y un campo **Orden** por cada uno. | Campo | Para qué | |---|---| | Activo | Si está OFF el método **no aparece** en los selectores del POS / Cobros / Pagos | | Orden | Posición en el dropdown (los menores aparecen primero). Sirve para poner adelante los más usados | Al crear la empresa, **Efectivo (código 1)** queda activo por default. El resto se va activando según haga falta. #### Cómo dar de alta (activar) un método de pago nuevo **Ruta**: **Menú principal › Configuración › Facturación › Métodos de Pago**. (Es una pantalla propia, separada de "Monedas" — no es una pestaña dentro de ella.) Pasos: 1. En la lista, ubicá el método del catálogo SIFEN que querés activar (por ejemplo Tarjeta de Crédito, Cheque, Transferencia, QR, etc.). 2. Activá el toggle **Activo** de esa fila. 3. Asigná el **Orden** (número entero). Los más usados van con números bajos para que aparezcan primero en el dropdown del POS. 4. (Opcional) Pulsá **Editar** para configurar: - **Cuenta de tesorería destino** (caja o banco al que cae el dinero). - **Cuenta contable** para que el asiento automático sepa dónde imputar. - **Comisión %** si es un método con costo (típico tarjeta de crédito). - **Requiere autorización** y otros campos específicos del tipo. 5. **Guardar**. > **Importante**: no se pueden crear métodos de pago propios fuera del catálogo SIFEN — solo activar/desactivar los códigos oficiales (1 al 99 según SET). Si necesitás un método que no existe en el catálogo, contactá por teléfono o WhatsApp a tu referente de Novasis. **Dónde verificar**: el método aparece en el dropdown del POS (Facturación), del módulo de Cobros y del módulo de Pagos a Proveedor de inmediato. **Errores típicos al alta**: - "Debe activar al menos un método de pago" → en el alta de empresa nueva, Efectivo viene activo por default. Si se desactivó todo, hay que volver a activar al menos uno. - "Falta cuenta de tesorería destino" → el método se activó pero no se le asignó caja/banco. El POS no va a dejar usarlo. - "Falta cuenta contable mapeada" → el método se usa pero el asiento contable no se genera. Ir a **Contabilidad › Mapeo de Cuentas** y mapearlo. ### 3.3 Configuración por método Según el tipo de método, el sistema le pide al usuario datos adicionales al usarlo en una venta o un cobro: | Método | Datos que pide | |---|---| | Efectivo | Importe, vuelto | | Tarjeta de Débito / Crédito | Banco emisor, últimos 4 dígitos, n° de autorización, n° de cuotas (en Crédito), comisión | | Cheque | Banco, n° de cheque, fecha emisión, fecha de pago (si es **diferido**), librador | | Transferencia | Banco origen, banco destino, n° de transferencia, fecha | | Depósito | Cuenta destino, comprobante | | QR / Billetera | Comprobante / ID de transacción | | Crédito (cuenta corriente) | Condición de pago (30/60/90), n° de cuotas | > Si el cliente paga **con más de un método** (por ejemplo: parte en efectivo y parte con tarjeta), se carga cada uno como una **línea de pago** en el recibo o factura. El sistema valida que la suma cuadre con el total. ### 3.4 Integración con caja, banco y contabilidad Cada método "cae" en una cuenta distinta de tesorería / contabilidad: | Método | Cuenta destino típica | |---|---| | Efectivo | Caja activa (sucursal/caja del cajero) | | Tarjeta Débito | Banco (depósito en tránsito) según pasarela | | Tarjeta Crédito | Banco (depósito en tránsito) según pasarela. Con comisión separada | | Cheque recibido | 1.1.1.06 Cheques en Cartera (queda pendiente hasta acreditar) | | Cheque emitido | 2.1.1.04 Cheques a Pagar | | Transferencia | Cuenta bancaria seleccionada | | Depósito | Cuenta bancaria seleccionada | | QR / Billetera | Cuenta bancaria de la billetera (Tigo Money, Personal Pay…) | | Crédito (cta. cte.) | Crea documento en Cuentas por Cobrar | Cada movimiento de caja / banco generado por un cobro o pago dispara su **asiento contable automático** (ver `guia-contabilidad.md`). ### 3.5 Bancard / pasarelas Para Tarjeta de Crédito y Débito vía Bancard VPOS: - La empresa configura el **merchant_id**, API key y secrets en **Configuración → Tesorería y Bancos → Bancard VPOS**. - El POS dispara el cobro contra Bancard; si la pasarela responde aprobado, se cierra la venta con el medio de pago Tarjeta + número de autorización. - En la versión actual la integración corre en **modo mock** (respuestas simuladas) — la habilitación real depende del módulo `BANCARD` contratado. ### 3.6 Cuotas Las cuotas son una **condición de pago**, no un método aparte: - Para una venta a crédito (cuenta corriente) se eligen **N cuotas** con vencimiento. - Para una venta con Tarjeta de Crédito en N cuotas, el método sigue siendo "Tarjeta de Crédito" pero se indica la cantidad de cuotas + el plan (1, 3, 6, 12 cuotas). - Las cuotas se gestionan desde `guia-cobros-finanzas.md` y `guia-compras.md` (cuotas a proveedores). --- ## Validaciones (texto que ve el usuario) - "Ya existe una moneda con ese código" (alta de moneda en el catálogo). - "Esta moneda ya está asignada a la empresa". - "No se puede eliminar la moneda principal — marcá otra como principal primero". - "Esta moneda no está configurada para la empresa" (cotización sobre moneda no habilitada). - "La cotización compra debe ser mayor a cero". - "La cotización venta no puede ser menor a la cotización compra" (advertencia, no bloqueo). - "Ya existe una cotización para esa fecha — se actualizará la existente". - "No hay tipo de cambio registrado para {moneda} en la fecha {fecha}". - "Debe activar al menos un método de pago". - "El método Efectivo no se puede desactivar si no hay otro método activo". - "Los montos por método no coinciden con el total" (al cobrar con multi-método). ## Lo que NO se puede hacer - **No se puede tener más de una moneda principal** por empresa. - **No se puede borrar la moneda principal** sin antes pasar el flag a otra. - **No se puede facturar en una moneda no habilitada** para la empresa. - **No se puede facturar en una moneda extranjera sin cotización vigente** para esa fecha (o anterior). - **No se puede cambiar la moneda principal** sin impactar todos los reportes históricos: el sistema bloquea el cambio si ya hay movimientos en la principal anterior. - **No se puede crear métodos de pago propios** fuera del catálogo SIFEN — el código es lo que SE acepta. - **No se puede desactivar Efectivo** si quedaría la empresa sin ningún método activo. - **No se puede registrar un cheque diferido sin fecha de vencimiento**. - **No se puede dejar líneas de pago en blanco**: al cobrar con multi-método, la suma debe coincidir con el total exacto. ## Problemas frecuentes - **"El POS me dice que no hay cotización"**: cargar la cotización del día (o de un día anterior) en Configuración → Facturación → Monedas → Cotizaciones. - **"El asiento contable de la factura en USD muestra 0 en PYG"**: falta la **tasa contable** del día. Cargarla en Contabilidad → Tipo de Cambio y regenerar el asiento. - **"Aparece una diferencia de cambio inesperada"**: la cotización del cobro fue distinta a la del documento original. Es normal — se registra en 4.2.1.02 (ganancia) o 6.3.1.03 (pérdida). - **"El cliente paga 100 USD pero el sistema convierte mal"**: revisar qué cotización corresponde (compra vs venta) y si la fecha es la correcta. - **"Me falta un método de pago en el POS"**: revisar que esté **Activo** y, si está oculto al final del dropdown, subir el orden. - **"No me deja desactivar Tarjeta"**: probablemente sea el único método activo además del que estás tratando de desactivar — habilitar otro primero. - **"El cheque que recibí no aparece en banco"**: los cheques recibidos quedan en **1.1.1.06 Cheques en Cartera** hasta que se depositan / acreditan. Ver `guia-tesoreria-bancos.md`. - **"Cambié los decimales a visualizar y los precios viejos quedaron raros"**: la configuración aplica a la **renderización** — los importes en BD están en formato completo; los reportes mostrarán los nuevos decimales. ## Limitaciones actuales - **No hay descarga automática** de cotizaciones desde el BCP u otra fuente — la carga es manual o por integración a medida. - **No hay configuración fina por método** (comisión %, plazo de acreditación, redondeo, monedas permitidas) en la UI — la arquitectura está pero la UI todavía no expone esos campos. - **Bancard funciona en modo mock** salvo que se contrate el módulo real. - **No hay alerta de "falta cotización del día"** al iniciar sesión: hay que revisar manualmente. - **No se versiona la moneda principal**: cambiarla deja todos los reportes consolidados con la nueva — el sistema lo bloquea cuando ya hay movimientos. - **No se pueden combinar dos monedas distintas en el mismo recibo / pago** (todos los métodos de un mismo cobro deben estar expresados en la moneda del documento). - **Cuotas en tarjeta**: el sistema registra la cantidad de cuotas pero la planilla de acreditación bancaria (cuándo se cobra cada cuota) es manual. ## Documentos relacionados - `guia-empresa.md` — moneda principal y datos generales. - `guia-facturacion.md` — uso de monedas y métodos al emitir comprobantes. - `guia-cobros-finanzas.md` — recibos multi-método, cuotas, cobranzas. - `guia-tesoreria-bancos.md` — cuentas, transferencias multi-moneda, cheques. - `guia-contabilidad.md` — tipo de cambio contable, diferencia de cambio, asientos automáticos.