Facturación Desktop AY-004

Introducción

Facturación Desktop es el módulo principal de facturación de FactuPOS, diseñado para uso en computadoras de escritorio. Permite crear cotizaciones, facturar de contado o crédito, imprimir en POS y enviar documentos electrónicos a Hacienda.

Flujo general de trabajo

Pantalla principal

La pantalla se divide en las siguientes áreas:

Barra de herramientas superior

Atajos de teclado

Los atajos permiten trabajar sin usar el ratón, ideal para facturación rápida:

Panel Cliente

Ubicado en la parte izquierda, muestra la información completa del cliente seleccionado.

Campos visibles

Fila de configuración

Botones de cliente

• Nuevo — Crear un cliente nuevo sin salir de facturación
• Editar — Modificar datos del cliente actual
• Historial — Ver las últimas compras del cliente con filtros y exportación

Panel Crédito

Muestra la situación crediticia del cliente seleccionado:

Panel Vendedor

Controla quién se registra como agente de ventas en la factura:

• Usuario — Código del usuario que está facturando (no editable)
• Agente — Vendedor asignado. Clic en el nombre (morado) para cambiar
• Referido — Persona que refirió al cliente

Usuario Ventas Última actualización: 2026-04-20

En la barra de búsqueda de artículos aparece el campo Usr. Ventas junto con un botón Cambiar. Este campo indica quién se registrará como el usuario del documento de venta.

¿Cómo funciona?

1. Al iniciar sesión (login), el sistema asigna automáticamente su código y nombre como Usuario Ventas.
2. Si otra persona necesita facturar desde su sesión, presione el botón Cambiar.
3. Se abrirá un modal donde debe ingresar la clave del vendedor.
4. El sistema busca al empleado por su clave y actualiza el Usuario Ventas con su código y nombre.
5. El cambio se mantiene hasta que se vuelva a cambiar o se inicie sesión de nuevo.

¿Cuándo se usa en la factura?

Matriz combinada de parámetros 390 + 392

Ejemplo práctico

María (00003) inicia sesión en la computadora. Juan (00005) necesita hacer una venta desde esa misma computadora. Juan presiona Cambiar, ingresa su clave, y ahora el campo muestra 00005 Juan.

• Con 390=1, 392=0: La factura queda con UsuarioCodigo=00005 (Juan) pero el AgenteCodigo se mantiene como el agente original de la proforma (por ejemplo, SARA).
• Con 390=1, 392=1: La factura queda con UsuarioCodigo=00005 Y AgenteCodigo=00005 (ambos Juan). Recomendado solo para empresas donde el cajero es el mismo vendedor.

Panel Documento

Ubicado en la esquina superior derecha, controla las propiedades del documento:

Toggles y modos

• Código de barras — Activa modo escáner. Si el artículo ya existe en la lista, suma la cantidad en vez de crear nueva línea
• Solo stock — Solo busca artículos con existencias en bodega

Panel Líneas

El área central donde se agregan los artículos del documento.

Barra de búsqueda

Escriba el código o nombre del artículo y presione Enter. Si encuentra coincidencia exacta por código, agrega directamente. Si hay varias coincidencias, abre el modal de búsqueda.

Campo de cantidad

A la derecha de la barra de búsqueda. Escriba la cantidad deseada antes de agregar. Presione Enter en el campo de cantidad para agregar el artículo.

Botón Agregar (verde)

Equivale a presionar Enter sobre la cantidad. Agrega el artículo con la cantidad especificada.

Columnas de la tabla

Panel Totales

Muestra el desglose completo del documento en la parte inferior:

• Total Venta — Suma de todas las líneas sin descuento ni IVA
• Descuento — Total de descuentos aplicados
• Gravado / Exento / Exonerado — Desglose según tipo impositivo
• IVA — Total del impuesto al valor agregado
• TOTAL — Monto final a cobrar

Buscar artículo — Modal MBA-001

Presione F2 o haga clic en el botón Buscar para abrir el modal de búsqueda avanzada.

Barra de búsqueda del modal

• Campo de texto — Busca por código, nombre o código de barras
• Categoría — Filtro por categoría de artículos
• Solo Stock — Muestra solo artículos con existencias
• Buscar — Ejecuta la búsqueda
• Agregar — Agrega todos los artículos que tengan cantidad ingresada

Lista de resultados (panel superior)

Muestra los artículos encontrados con: código, nombre, stock, precio, IVA y precio neto. Cada fila tiene un campo de cantidad para ingresar directamente.

El precio de cada fila es el del nivel que realmente aplica según las reglas (parámetro 57 / cliente / estación), no siempre el P1. Junto al precio aparece un badge con el nivel (ej. P2) para confirmar de un vistazo cuál se está mostrando — coincide con el precio que se factura.

Panel de detalle (4 fichas inferiores)

Al seleccionar un artículo, se cargan 4 fichas con información detallada:

Navegación con teclado en el modal

Flujo Enter → Bodega → Cantidad (Parámetro 383)

Cuando el Parámetro 383 está activo (= 1) y el Parámetro 102 permite seleccionar bodega (= 0), la tecla Enter sigue un flujo guiado de 3 pasos para confirmar artículo + bodega + cantidad antes de agregar la línea:

1. Paso 1 — En la lista de artículos: seleccione la fila con ↑/↓ y presione Enter. El modal mueve automáticamente el foco a la ficha Bodegas y resalta la primera bodega con stock disponible.
2. Paso 2 — En la ficha Bodegas: use ↑/↓ para elegir otra bodega si es necesario y presione Enter. El modal se cierra, el código del artículo se coloca en el campo de búsqueda principal de la factura y el foco salta al campo cantidad principal (no agrega aún). Aparece un toast: "Bodega: X. Ingrese cantidad y Enter."
3. Paso 3 — En el campo cantidad principal: digite la cantidad y presione Enter. Recién acá se agrega la línea, usando la bodega que eligió en el paso 2.

Sugerencia de cambio de bodega (línea sin existencia)

Cuando el Parámetro 102 permite seleccionar bodega (= 0) y usted agrega un artículo que no tiene existencia en la bodega usada, el sistema verifica automáticamente si hay stock en otra bodega. Si lo hay, abre el modal "Sin existencia en esta bodega" con la lista de bodegas que sí tienen el artículo y su existencia.

• Cada bodega muestra su existencia; las que cubren la cantidad solicitada se resaltan en verde.
• Al hacer clic en una bodega, la línea recién agregada se mueve a esa bodega (cambia solo esa línea) y la tabla se actualiza.
• Si prefiere dejarla como está, use "Conservar bodega actual".
• Los servicios (no manejan inventario) nunca disparan esta sugerencia.

Agregar líneas

Existen varias formas de agregar artículos al documento:

1. Búsqueda directa (barra principal)

1. Escriba el código o nombre en la barra de búsqueda
2. Ajuste la cantidad en el campo a la derecha
3. Presione Enter o el botón Agregar

2. Modal de búsqueda (F2)

1. Presione F2 para abrir el modal
2. Busque el artículo por código o nombre
3. Opcionalmente seleccione un precio o bodega específica
4. Ingrese la cantidad y presione Enter

3. Desde historial del cliente

1. Clic en Historial en el panel de cliente
2. Busque la compra anterior por fecha o artículo
3. Doble clic en el artículo para agregarlo al documento actual con el precio sugerido

4. Escáner de códigos de barras

Active el modo "Código de barras" y escanee directamente. El artículo se agrega automáticamente.

Editar líneas

Una vez agregada una línea, puede modificar:

• Cantidad — Clic en la celda de cantidad para editar
• Precio — Clic en la celda de precio (requiere permiso 024)
• Descuento — Clic en la celda de descuento (requiere permiso 004)
• Bodega — Clic en la celda de bodega para cambiar
• Eliminar — Botón rojo en la línea (requiere permiso 059)

Modal de utilidad negativa

Cualquier cambio de precio o descuento que genere pérdida (precio sin IVA, con el descuento, < costo) dispara un modal centralizado, con dos modos según el permiso del usuario:

Si el usuario no tiene permiso 064 (ver utilidad), el modal oculta el costo y los valores de utilidad calculada — sólo informa el descuento máximo permitido.

Artículos con precio 0

Si un artículo tiene precio 0 en el nivel asignado al cliente, la línea se agrega al documento respetando ese precio (entra en 0). El cajero puede editar el precio inline para establecer el valor de venta. El sistema sólo dispara el modal de "bajo costo" cuando el nuevo precio queda por debajo del costo — establecer un precio inicial mayor al costo es válido sin restricciones.

Niveles de precio

El sistema soporta hasta 10 niveles de precio (P1 a P10) por artículo. La selección del precio sigue estas reglas:

Reglas de asignación de precio

Cómo seleccionar un precio diferente

1. Asegúrese de tener un cliente real (no SN) y que el parámetro 57 esté inactivo
2. Abra el modal de búsqueda (F2) y busque el artículo
3. En la ficha Precios (panel inferior), haga clic en el nivel deseado (P1, P2, P3...)
4. La fila se resaltará en azul indicando la selección
5. Agregue el artículo: doble clic en la fila de precio, Enter, o ingrese cantidad y presione Agregar

Cambio de nivel sobre una línea existente

Cuando se cambia el nivel de precio de una línea ya agregada (por ejemplo P1 → P2) usando la barra de precio masiva:

1. Se actualiza el precio al del nuevo nivel.
2. El descuento previo se resetea a 0 (siempre, sin excepción de permisos). Esto evita que un descuento aplicado al nivel anterior arrastre al nuevo bajo reglas distintas.
3. Si el nuevo nivel tiene un Descuento Fijo configurado, se aplica automáticamente — siempre que cumpla con el Descuento Máximo y la Utilidad Mínima de ese nivel. Si no cumple, queda en 0% y la razón se registra en bitácora.

Descuentos

El sistema maneja múltiples tipos de descuento con prioridades definidas:

Tipos de descuento

Prioridad de descuentos

1. Descuento recordado (param 277) — Tiene prioridad máxima si está activo
2. Descuento del cliente — Se aplica automáticamente
3. Descuento fijo del artículo — Se usa si el cliente no tiene descuento

Validación en 3 etapas (descuento → utilidad mínima → costo)

Cuando se aplica un descuento o se edita el precio de una línea, el sistema valida en orden, etapa por etapa. Cada etapa tiene su propio permiso: si el usuario no lo tiene, esa etapa lo detiene (se capa el descuento o se ajusta el precio).

Cálculo de precios y totales

Esta sección explica exactamente cómo el sistema calcula cada línea y los totales del documento, con las fórmulas que se ejecutan tanto en el backend (_funciones_calculo.php) como en el frontend (calcularTotales()).

Paso 1 — De dónde sale el precio unitario

El precio de una línea se resuelve en el momento de agregar el artículo siguiendo esta prioridad (se detiene en la primera que aplique):

Paso 2 — Cadena de cálculo de la línea

Con el precio resuelto, la línea pasa por 10 cálculos en cadena. El nombre entre paréntesis es el campo físico en ProformaHija:

Paso 3 — Redondeo (Parámetros 190 y 195)

Parámetro 195 — Decimales del IVA

Controla con cuántos decimales se redondea el campo ArticuloIvaMonto. Rango permitido: 0 a 6. Default: 2. El resto de campos (SubTotales, Gravado, Exonerado, Total) siempre se redondean a 2 decimales.

Parámetro 190 — Redondear total factura

Controla si el IVA se calcula sobre el subtotal redondeado o sobre el subtotal sin redondear. Es clave cuando el precio unitario sin IVA tiene 4 decimales y el total con IVA debe cuadrar con un precio "redondo" al cliente (ej: ₡1,700.00).

Ver detalles y cuándo activarlo en Parámetros → 190.

Paso 4 — Casos especiales

IVA devuelto (tarjeta con tarifa 4%)

Cuando el documento tiene MedioPagoCodigo = '02' (tarjeta) y una línea tiene IVA del 4%, ese IVA se marca como "devuelto" y se resta del total de la línea. Esto aplica principalmente a canasta básica cuando se paga con tarjeta.

Exoneración parcial o total

Si el cliente tiene exoneración sobre el artículo, el campo ArticuloIvaExonerado guarda el porcentaje exonerado (no el monto). La fórmula distribuye:

• Gravado = parte del SubTotal3 que sigue afecta al IVA
• Exonerado = parte del SubTotal3 liberada del IVA
• IVA neto = SubTotal3 × ((IvaPct − ExoPct) ÷ 100)

Si la exoneración es total (ExoPct = IvaPct), el IVA queda en 0 y todo el SubTotal3 se reporta como Exonerado.

Artículo Exento (IvaPct = 0)

Si el artículo no grava IVA, todo el SubTotal3 se clasifica como Exento (ni gravado ni exonerado). El IVA y el IVA devuelto quedan en 0.

Otros cargos

Campo ArticuloOtrosCargos — se suma al SubTotal2 antes de calcular el IVA, por lo que sí paga IVA (si la línea es gravada).

Paso 5 — Totales del documento

Cuando una línea cambia, el sistema recalcula ProformaMadre sumando todas las líneas y agrupando por naturaleza CABYS (hacienda.dbo.VistaNaturalezaArticulo):

Paso 6 — Cálculo en tiempo real (frontend)

Mientras el usuario edita líneas, el panel "Totales" se actualiza instantáneamente en JavaScript sin esperar al backend. Luego de 300ms sin cambios, se envía al servidor la actualización definitiva (debounce).

Los totales visibles en pantalla suman cada línea así:

• Gravado / Exonerado / Exento mercancía — Σ campos de línea (todos van a mercancía en frontend; el servidor los reclasifica por CABYS)
• IVA — Σ l.ivaTotal (ojo: el campo JS se llama ivaTotal, no impuesto)
• IVA devuelto — Σ l.ivaDevuelto
• Total — Σ l.total

Paso 7 — Margen de utilidad

El porcentaje de margen se calcula solo para productos (excluye servicios, naturaleza = 2). Se muestra en el panel de totales si el usuario tiene permiso 064.

Paso 8 — Moneda extranjera

En facturas con moneda distinta a la nacional (ver parámetro 249), el cálculo de la línea se hace en la moneda del documento. La conversión a moneda nacional ocurre al momento de contabilizar:

• Pagos — siempre en la moneda del documento. Si el cliente paga con otra moneda, se convierte usando el tipo de cambio y se guarda en la moneda del documento.
• Asiento contable — cada línea de DocumentoDetallePago se multiplica por su TipoCambio para llevarla a la moneda nacional.
• Ajuste de redondeo — si DEBE/HABER difieren por menos de 1.00 (por redondeos), se agrega automáticamente una línea de ajuste en la cuenta del parámetro 83 (Caja Efectivo).

Paso 9 — Validación de límites (constraints BD)

Antes del UPDATE, la función calcularTotalesLinea() proyecta los valores y valida que no excedan los check constraints de la base:

Si alguna proyección excede, el sistema auto-corrige la línea: cantidad pasa a 1 y si el precio excede 500,000 se pone a 0, evitando así un error SQL que bloquearía el documento.

Resumen visual del flujo

Ejemplo completo

Artículo con Precio = 1,000, Cantidad = 2, Descuento = 10%, IVA = 13%, sin exoneración, sin otros cargos, MedioPago = efectivo:

Factura de contado

Genera una factura con pago inmediato. Acceso: F4 > Fact. Contado o F7 directo.

Flujo de factura contado

1. Se valida el documento (precio > 0, artículos válidos, agente si es obligatorio)
2. Se abre el modal de pago con el total a cobrar
3. Seleccione el medio de pago: efectivo, tarjeta, transferencia, etc.
4. Para efectivo: ingrese el monto recibido. El sistema calcula el vuelto
5. Para tarjeta/transferencia: ingrese la referencia
6. Confirme el pago. La factura se genera y se envía a Hacienda
7. Se imprime automáticamente (según configuración)

Denominaciones de efectivo

El modal de pago muestra botones con las denominaciones de la moneda activa. Haga clic para sumar al monto recibido. Por ejemplo, para CRC: 1.000, 2.000, 5.000, 10.000, 20.000.

Factura de crédito MV-005

Genera una factura con pago a plazo. Acceso: F4 > Fact. Crédito o F8 directo.

Requisitos

• Cliente con código diferente a SN (debe estar registrado)
• El cliente debe tener crédito disponible suficiente
• Se calcula automáticamente la fecha de vencimiento según los días de crédito del cliente

Flujo

1. Se valida el documento y el crédito disponible
2. Se confirma la fecha de vencimiento
3. La factura se genera con condición "Crédito"
4. Se crea automáticamente la cuenta por cobrar (CxC)
5. Se envía a Hacienda y se imprime
6. Si se ingresó un adelanto, se aplica automáticamente un recibo CxC sobre la factura recién creada (ver sección abajo)

Adelanto al convertir (2026-05-11)

Cuando el cliente entrega un pago parcial al momento de generar la factura a crédito, se puede registrar el adelanto dentro del mismo modal. Tras crear la factura, el sistema aplica automáticamente un recibo CxC contra ese documento.

Impresión automática del recibo (2026-05-15)

Cuando el adelanto se aplica con éxito, el recibo CxC se imprime automáticamente en la misma impresora que la factura, justo después de la factura, para que ambos comprobantes salgan uno seguido del otro y se puedan entregar juntos al cliente.

• La impresión usa la misma impresora configurada en la estación para facturas crédito.
• Si la opción de imprimir está desmarcada en el modal, tampoco se imprime el recibo.
• Si la impresión del recibo falla, queda registrado en el log del modal pero la factura y el recibo ya están guardados en BD — se puede re-imprimir el recibo desde el módulo CxC.

Validaciones previas

Si el monto del adelanto es mayor a 0 y falta cualquiera de los tres campos obligatorios (medio de pago, comprobante o detalle), el sistema muestra un aviso y enfoca el campo faltante antes de iniciar la transacción — no se crea la factura hasta que estén completos.

Archivar cotización

Guarda la cotización en el histórico sin generar factura. Útil para cotizaciones que se concretan sin pasar por Hacienda.

Flujo

1. Presione F4 y seleccione Archivar Cot.
2. Se valida que los artículos tengan stock (si aplica la restricción)
3. Se agrega automáticamente un pago en efectivo
4. El documento se copia a CotizaMadre/CotizaHija
5. Se elimina de ProformaMadre (documento de trabajo)
6. Opcionalmente se imprime en POS

Enviar a Cajas

Transfiere la cotización al módulo de Cajas para que sea facturada desde ahí. Útil cuando un vendedor prepara la cotización y otro usuario la cobra.

• Requiere permiso 123
• El documento queda disponible en el módulo de Cajas
• Se limpia el documento de trabajo actual

Imprimir

Múltiples formatos disponibles desde F4 > Imprimir:

Formatos de impresión

Modal "Imprimir cotización" — Texto vs Con Imágenes NUEVO

El botón Imprimir en la ficha Documento del panel principal abre un modal (código MV-PRT) con dos opciones para visualizar la cotización en pantalla:

Cálculo de totales en reportes FIX 2026-04-28

Los reportes ahora calculan VENTA BRUTA y SUB TOTAL desde las líneas individuales (no desde campos cabecera) para mayor precisión:

Aplicado en: ver_cotizacion_desktop.php, ver_cotizacion_desktop_imagenes.php, ver_factura_desktop.php, correos de cotización (HTML + PDF) y correos de factura (HTML + PDF).

Enviar correo

Envía la cotización por correo electrónico al cliente. Desde F4 > Enviar Correo.

• Se adjunta el PDF de la cotización
• Se envía al email registrado del cliente
• Opcionalmente copia al emisor (parámetro 74)
• Opcionalmente copia al agente de ventas (parámetro 318)

Envío automático de la factura al cliente

Cuando convertís una cotización en factura, el envío del PDF al cliente depende de si la empresa usa factura electrónica o no:

• Empresas con factura electrónica: el correo con la factura (PDF + XML firmado + XML de respuesta) se envía automáticamente después, cuando Hacienda acepta o rechaza el documento. No hay que hacer nada manual.
• Empresas sin factura electrónica (régimen tradicional/simplificado, sin envío a Hacienda): el PDF de la factura se envía al cliente de una vez, en el momento de facturar. Antes esto solo pasaba con envío manual; ahora es automático.

En ambos casos el correo va al EmailFactura del cliente; si está marcado, se agrega copia al agente de ventas (parámetro 318) y al email de respaldo (parámetro 149). A los clientes genéricos (SN) no se les envía. Si el cliente no tiene email registrado, no se envía nada.

Compartir y exportar

Opciones disponibles desde F4:

Guardar cotización

El documento se guarda automáticamente conforme agrega líneas. Sin embargo, puede usar el botón Guardar de la barra de herramientas para:

• Asegurar que todos los cambios estén persistidos
• Generar un número de cotización definitivo
• Permitir que otros usuarios puedan abrir el documento

Abrir cotización

Presione el botón Abrir de la barra de herramientas para recuperar una cotización guardada.

Filtros disponibles

• Fecha desde / hasta — Rango de búsqueda
• Número — Búsqueda por número exacto
• Cliente — Filtrar por código o nombre de cliente
• Origen — Activas, Históricas o Archivadas

Columnas ACTUALIZADO

El listado muestra dos columnas para identificar al cliente:

• N. Comercial (italic gris) — nombre comercial registrado en el catálogo de clientes (Clientes.ClienteNombreComercial)
• Nombre Cot. (bold) — nombre manual escrito en la cotización (ProformaMadre.ClienteNombre) — es el dato editable e identificativo

Para clientes genéricos (SN, 0) que no tienen registro en el catálogo, la columna N. Comercial muestra el mismo nombre manual de la cotización para evitar quedar vacía.

Ordenamiento

Haga clic en las columnas (Número, Fecha, N. Comercial, Nombre Cot., Total, Usuario) para ordenar. La fecha ordena por defecto de más reciente a más antigua.

Exportar e imprimir listado

Al lado del botón Buscar aparecen dos botones adicionales:

• Excel — Descarga un archivo .xlsx con los resultados filtrados. Columnas: Número, Fecha, Cliente ID, Cliente Nombre, Total, Moneda, Usuario, Agente, Estado, Líneas.
• Imprimir — Abre una vista imprimible con los filtros aplicados, totales y tabla de cotizaciones.

Pedidos en línea y comprobante de pago NUEVO

Los pedidos que sus clientes hacen desde la tienda en línea (ecommerce) llegan al sistema como pedidos y se ven en el módulo Facturación → Pedidos en línea (requiere el permiso 115). Desde ahí, con doble clic en un pedido se abre en Facturación Desktop para revisarlo y convertirlo en factura.

Comprobante de pago (SINPE / transferencia)

Si el cliente pagó por SINPE Móvil o transferencia, al hacer el pedido puede adjuntar el número de comprobante y una imagen del pago. Ese comprobante se ve en dos momentos:

• En la lista de “Pedidos en línea” — una columna Comprobante muestra el número de SINPE y un enlace para abrir la imagen del pago.
• Al abrir el pedido en Facturación — aparece un banner verde en la parte superior con el texto “Comprobante de pago (SINPE/transferencia): N° …” y un botón Ver comprobante que abre la imagen en una pestaña nueva.

Historial del cliente

Desde el panel de cliente > botón Historial, puede consultar las últimas compras del cliente seleccionado.

• Muestra las últimas 1,000 líneas de compra
• Filtros por fecha, categoría y monto
• Agrupamiento por categoría (toggle)
• Doble clic para agregar un artículo al documento actual con el precio sugerido
• Exportación a Excel y PDF

Modo código de barras

El checkbox "Código de barras" en el panel de documento controla el comportamiento al agregar artículos repetidos:

Compuestos manuales

Permite agregar artículos compuestos (kits o paquetes) que contienen múltiples componentes. Requiere permiso 119.

Cómo usar

1. Agregue el artículo principal al documento
2. Abra la pestaña "Compuestos" en el panel lateral
3. Busque y agregue los artículos componentes
4. Ajuste las cantidades de cada componente

Exoneración MAG

El MAG (Ministerio de Agricultura) permite a productores agropecuarios comprar con IVA reducido del 1% en lugar del 13%.

Cómo aplicar

1. Seleccione un cliente que tenga registro MAG vigente
2. Vaya a Opciones > pestaña MAG
3. El sistema consulta automáticamente la vigencia del MAG
4. Si está vigente, haga clic en Aplicar MAG
5. Todos los artículos con IVA 13% cambian automáticamente a 1%

Exonerar con validación CABYS

Además de MAG, los clientes con exoneración autorizada (orden de exoneración, ZF, misión diplomática, etc.) pueden tener uno o varios documentos de exoneración, y cada uno con su propia lista de códigos CABYS permitidos. El sistema asigna a cada línea el documento de exoneración cuyo CABYS le corresponde.

Cómo aplicar

1. Agregue las líneas al documento normalmente
2. Abra Opciones > pestaña Exonerar
3. Se abre un modal transaccional con todas las líneas
4. Las líneas con un CABYS autorizado aparecen con ✓ verde y muestran en la columna Cód. Exo el documento de exoneración que les corresponde
5. Las líneas cuyo CABYS no está en ninguna exoneración aparecen con ✗ rojo y quedan gravadas (omitidas)
6. Confirme. El sistema procesa línea por línea, cada una con su documento

Quitar exoneración

Desde Opciones > Quitar Exo.. El modal muestra las líneas que tienen exoneración aplicada y al confirmar las revierte al IVA original.

Moneda extranjera

FactuPOS permite facturar en moneda distinta a la nacional (USD, EUR, etc.) con conversión automática a moneda local para el asiento contable.

Cambiar la moneda del documento

1. En el Panel Documento, haga clic en el campo Moneda
2. Seleccione la moneda deseada (USD, EUR, etc.)
3. El sistema usa el tipo de cambio del día (configurado en Contabilidad > Tipos de cambio)
4. Agregue los artículos normalmente — los precios se convierten a la moneda elegida

Pagos en moneda mixta

En el modal de pago de contado puede recibir efectivo en cualquier moneda configurada. El sistema siempre guarda el pago en la moneda del documento, convirtiendo el monto recibido si es necesario:

Asiento contable

El asiento contable se registra siempre en moneda nacional. El sistema convierte usando el tipo de cambio del documento. Si aparece una diferencia de centavos por redondeo, agrega automáticamente una línea de ajuste con la cuenta del parámetro 83 (Caja efectivo).

Saldo a favor del cliente

Los adelantos y saldos a favor del cliente se muestran en el Panel Crédito, línea Tiene:. Cuando es mayor a 0, el monto titila suavemente para llamar la atención del cajero.

Menú del saldo a favor

Haga clic sobre el monto de Tiene: para abrir el menú con estas opciones:

Generar adelanto

Desde el botón Utils:

• Adelanto Cliente — Registra un adelanto a favor. Requiere cliente con código.
• Retirar Adelanto — Devuelve al cliente parte o todo su saldo a favor.
• Retiro Adelantos SN — Caso especial para clientes sin código, abre el modal Saldos Notas de Crédito MV-040.

Modal Saldos Notas de Crédito MV-040

Ruta: Utils → Retiro Adelantos SN. Lista las facturas que generaron NC con saldo a favor disponible para clientes sin código (cuenta 2104SN, tabla SaldosAFavor).

• Columnas: Factura · Cliente · Movimientos · Caja · Saldo
• Buscador por número de factura o nombre de cliente
• Tipo de devolución: Efectivo (param 83) o Tarjeta (param 84 — requiere número de comprobante de anulación del datáfono)
• Saldo Requerido: monto a retirar. Se calcula automáticamente el Saldo a Retirar (mín. entre requerido y disponible)

Botones de acción

Cuenta contable del saldo a favor

La cuenta contable donde se registra el saldo a favor se construye concatenando la cuenta base (parámetro 89, por defecto 2104) con el código del cliente:

Envío Express y Boletillas BO-001

Desde F4 > Envío Express, puede abrir el módulo de boletillas para gestionar envíos a domicilio / guías de transporte del día.

• Pasa automáticamente el código y nombre del cliente actual (auto-abre el modal "Nueva Boletilla")
• Funciona con cualquier cliente, incluyendo SN
• Abre el módulo de boletillas en una nueva pestaña

Filtros del listado

Todos los filtros aplican auto-submit: al cambiar un valor la lista se recarga sola (los inputs de texto usan un debounce de 500ms, Enter también envía).

Estados

Acciones masivas

Al marcar boletillas con los checkboxes aparece una barra azul con acciones:

• Asignar Agente (MB-002) — asigna un agente a todas las seleccionadas y las pasa a estado Calle.
• Marcar Entrada — registra hora de entrada y pasa a Entregado. Solo aplica a boletillas en estado "Calle".
• Reset — limpia Agente a 59999, Estado a Pendiente y vacía Salida/Entrada. Útil para corregir errores.

Códigos del módulo

Validación de monto alto

Cuando una línea supera los 5 millones de colones (cantidad x precio), el sistema muestra un modal de confirmación de seguridad.

Comportamiento

1. Al agregar o editar una línea que supera el umbral, aparece un modal rojo
2. Debe escribir la palabra "SI" (en mayúsculas) para confirmar
3. Si cancela, la línea se elimina automáticamente
4. Se envía una alerta por correo al email del parámetro 194

Configuración de estación

La estación define los valores predeterminados para facturar. Acceda con el botón (piñón) en el panel Documento.

Modal Buscar Artículo MBA-001

Modal principal de búsqueda y selección de artículos durante la facturación. Se abre con F2 o el botón de búsqueda. Permite filtrar por categoría, por stock y muestra precios y existencias en tiempo real.

Barra de búsqueda

• Texto — busca por código, código de barras, nombre, descripción o serie.
• Todas las categorías — combo para limitar a una categoría específica.
• Solo stock — checkbox que filtra a artículos con existencia positiva.
• Buscar / Agregar — ejecuta búsqueda o agrega el primer resultado al documento.

Lista de resultados (con imagen lateral)

A la izquierda de la lista aparece la ficha de imagen del artículo seleccionado (130px de ancho, ocupa todo el alto del panel superior). Si el artículo tiene varias imágenes en su carrusel, se muestran apiladas verticalmente con scroll. Click sobre cualquier imagen la abre en grande (lightbox) sobre toda la pantalla; cierra con Esc, click fuera o el botón ✕.

Tabla con las columnas: Código, Nombre, Stock, Precio (sin IVA), IVA %, Neto (con IVA) y Cant (cantidad a agregar). Al pasar el mouse, se muestra además la categoría y subcategoría del artículo.

• Enter sobre una fila → agrega el artículo al documento.
• Clic sobre una fila → marca la fila como seleccionada y carga los paneles laterales de detalle.

Paneles de detalle (parte inferior)

Reglas de selección de precio (versión 2026-05-11)

El cajero puede elegir un nivel de precio diferente clickeando sobre la fila correspondiente en el panel Precios — esto se respeta al agregar la línea. Hay UNA regla que bloquea esa selección manual:

Flujo Enter — selección de precio + bodega + cantidad (bidireccional)

El Enter funciona en cualquier orden. Pasos:

1. Buscás el artículo y se selecciona (fila marcada azul).
2. Tipeás la cantidad en el input de la fila (default 1).
3. Click en un nivel de precio (ej: P3) y click en una bodega (ej: Bodega A) — en cualquier orden.
4. Enter con el foco en cualquier lado del modal → agrega con cantidad + P3 + Bodega A automáticamente.

Lo mismo aplica con doble clic en cualquier fila de precio o bodega (atajo equivalente al Enter). Tras agregar, el modal se cierra y las selecciones globales se limpian.

Cantidad por monto (Precio→Cant en barra de búsqueda)

Junto al input "Cantidad" hay un campo "Precio→Cant" que solo se activa para artículos fraccionados (azúcar, harina, líquidos a granel...). Tipeás el monto que el cliente quiere gastar (con IVA) y al hacer Enter / Tab el sistema calcula la cantidad fraccionada y la pone en Cantidad.

Fórmula: cantidad = (monto ÷ (1 + IVA/100)) ÷ precio redondeada a 3 decimales. Misma función disponible también dentro del modal Editar Artículo (MV-ART) usando el precio virtual (con descuento aplicado).

Modal Editar Artículo MV-ART

Al hacer doble clic (o usar la opción Editar) sobre una línea del documento se abre este modal para ajustar cantidad, precio, descuento, IVA, compuestos, lotes y vencimientos.

Campos principales

Totales del modal

En la parte inferior del modal se muestran Subtotal, IVA y Total calculados en tiempo real al cambiar cualquier campo.

Pestañas especiales

Utilidades VE-UTL

Menú de funciones adicionales accesible durante la facturación. Cada utilidad abre un modal o ejecuta una acción sobre el documento actual o sobre la caja.

Inventario y artículos

Cliente y saldos

Documentos

Caja y efectivo

Import / Export de cotizaciones

Configuración

Configuración Romana / Balanza MCF-ROM

Permite que el lector de barras interprete los códigos que imprimen las balanzas (romanas) cuando un código no se encuentra ni como Cod_Articulo ni como CodigoBarra. Se accede desde Utilidades VE-UTL → Configuración → Romana / Balanza.

Cómo funciona

Cuando escaneás un código en el campo de búsqueda de artículos, el sistema lo busca en este orden:

1. Busca por Cod_Articulo exacto.
2. Si no existe, busca en CodigoBarra.
3. Si no existe y la romana está activa, intenta interpretarlo como código de balanza extrayendo el código del artículo y el valor (peso o precio).

El código de la balanza siempre arranca en la posición 1 y el valor sigue inmediatamente después. Solo hay que indicar 2 longitudes.

Campos del modal

Ejemplo: EAN-13 estándar de balanza

Para un código como 2600101056111 (13 dígitos):

El artículo en la base de datos debe llamarse exactamente 2600101. Al escanear, el sistema agrega 1 unidad (en modo precio se usa la cantidad precio_balanza ÷ precio_artículo).

Configuraciones típicas

Importante: el último dígito de un EAN-13 es el check digit y NO debe entrar al cálculo. Por eso para 13 dígitos totales se configura código + valor = 12.

Almacenamiento

La configuración vive en la tabla dbo.RomanaConfig (singleton, 1 fila por empresa). La migración 20260511104634 la crea con valores default desactivados.

Opciones de línea MV-OPC

Modal que aplica acciones masivas sobre las líneas seleccionadas del documento. Se accede desde el menú Opciones o con el botón correspondiente de la barra de acciones.

Acciones disponibles

Aplicar descuento (modal detallado)

Al elegir "Descuento" se abre el panel con:

• Tipo de Descuento — combo con las 10 clases Hacienda (01 Descuento general, 02 Bonificación, 07 Descuento comercial, etc.).
• Porcentaje (%) — campo numérico con botones rápidos: 0, 5, 10, 15, 20, 25, 40, 50.
• Descuento Máximo — checkbox que aplica el descuento máximo permitido por artículo.
• Aplicar Descuento — botón primario que efectúa la acción sobre todas las líneas seleccionadas.

Novedades 2026-04-23 NUEVO

Actualización mayor del módulo con migración visual completa y nuevas funcionalidades.

Migración visual Banking Bold

Todo el módulo fue migrado al estándar visual Banking Bold: fichas, modales, tabla de artículos, barra de búsqueda y totales. Características:

• Headers azul corporativo sólido (#0047AB) con texto blanco uppercase
• Códigos de módulo/modal (MV-001, MV-042, etc.) en amarillo puro destacado
• Tabla de artículos con fuente 16px negro para mejor legibilidad
• Inputs con borde visible #64748b y focus azul
• Labels en negras 700 uppercase
• Radius 0 en todos los elementos (esquinas rectas profesionales)
• Soporte completo de modo oscuro con paleta adaptada

Nueva funcionalidad: Otros Datos (MV-042)

Se agregó el módulo Otros Datos (equivalente al Frm_FacturaOtrosDatos del sistema legacy VB6). Permite agregar campos adicionales arbitrarios a cualquier factura o proforma.

Flujo de uso

1. Abra el modal "Otros Datos" desde cualquiera de los dos lugares
2. Panel izquierdo: CRUD de favoritos (agregar / renombrar / quitar nombres de campos reutilizables)
3. Panel derecho: formulario Nombre + Valor → click en un favorito lo pre-llena
4. "Aceptar" guarda en FacturaVentaOtrosDatos y auto-registra el nombre en favoritos
5. Lista inferior muestra los datos actuales — clic en fila para editar, 🗑️ para eliminar

Integración con Hacienda

Los campos guardados se emiten automáticamente en el nodo <Otros> del XML enviado a Hacienda como <OtroTexto codigo="NombreCampo">valor</OtroTexto>. Paridad completa con el sistema VB6 anterior.

Transfer proforma → factura

Al convertir una proforma a factura, los datos extras se migran automáticamente del número de proforma al nuevo consecutivo de factura (sin intervención del usuario).

Auto-refresh de costos al abrir cotización

Cada vez que se abre o recupera una cotización/proforma, el sistema ahora sincroniza automáticamente los costos de las líneas con el costo actual del catálogo de artículos.

Detalles técnicos:

• Función central: actualizarCostoCotizacion(PDO, numero)
• Respeta la moneda del documento: si está en USD, el costo se divide entre el tipo de cambio
• Solo actualiza líneas cuyo costo difiera (tolerancia 0.0001)
• Tras actualizar, recalcula totales de línea y totales del documento
• Endpoint standalone disponible: POST /api/proformas/cotizacion_actualizar_costos.php

Preview del último artículo encontrado

En la barra de búsqueda, después del input de código ahora aparece un preview visual del artículo buscado:

Margen de utilidad — validaciones

La columna %Marg de la tabla tiene 4 estados según la calidad del dato:

Filas sin stock — formato visible

Cuando una línea de artículo tiene cantidad mayor al stock disponible (faltante en bodega), toda la fila se marca en rojo:

• Fondo: rojo claro (#fef2f2)
• Texto: rojo oscuro (#dc2626) en peso 600 y tamaño completo (no se ve más pequeño)
• Todos los campos de la fila (código, nombre, cantidad, precio, totales) mantienen el mismo tamaño que filas normales

Esto permite detectar visualmente artículos que provocarían sobregiro antes de procesar la factura.

Doble clic inteligente en tabla artículos

Se intercambió la acción del doble clic para mejor UX:

• Doble clic en el CÓDIGO del artículo → abre el Kardex (consulta histórica de movimientos)
• Doble clic en el NOMBRE del artículo → abre Editar Línea (MV-ART)

Indicador de conexión en el Total

El header de la ficha Total ahora muestra:

• Moneda activa del documento (CRC, USD, EUR) como chip amarillo
• Botón 💱 Cambiar que abre un popup para cambiar la moneda del documento
• Puntito • de conexión al extremo derecho:
  • ● Verde pulsando → servidor en línea
  • ● Rojo pulsando → sin conexión

El sistema hace un ping automático al servidor cada 30 segundos, y también escucha los eventos online/offline del navegador.

Número de documento — últimos 10 dígitos

El número del documento mostrado en la ficha Documento se recorta a los últimos 10 dígitos cuando es un consecutivo electrónico (20 caracteres). Para proformas cortas se mantiene completo. El número completo sigue enviándose correctamente a todas las APIs.

Botón "Nueva" reubicado

El botón Nueva (abrir nueva venta en pestaña aparte) se movió del panel de Herramientas a la ficha Documento, junto al botón Imprimir. Solo es visible cuando la proforma tiene consecutivo real (no en documento de trabajo).

Parámetro 380 — control completo del teléfono

El parámetro 380 (Imprimir teléfono del cliente) ahora aplica en todos los formatos de salida:

• ✅ POS térmica (FIPVIVI002)
• ✅ Hoja carta centrado (FIPVIVI003)
• ✅ Hoja carta 2 columnas (FIPVIVI004)
• ✅ PDF DataReport (FIPVIVI005)
• ✅ Matricial GDI (FIPVIVI006)
• ✅ Vista HTML web
• ✅ PDF del correo electrónico
• ✅ Cuerpo HTML del correo
• ✅ Bluetooth

Si 380 = 0, el teléfono del cliente no se imprime y la etiqueta cambia de "Tel/Email:" a "Email:" automáticamente.

Parámetros clave

El comportamiento del módulo se controla mediante parámetros de empresa:

💱 T.C. USD       500.00

Permisos

Los permisos controlan qué acciones puede realizar cada usuario en el módulo de facturación. Se configuran desde Configuración > Usuarios asignando los códigos correspondientes.

Acceso al módulo

Edición de líneas

Visualización

Acciones del documento