Punto de Venta (POS)

El Punto de Venta es una pantalla a pantalla completa (sin menú lateral) pensada para cobrar en segundos con teclado o táctil. Cada venta genera una factura electrónica real (FCF o CCF) y descuenta el inventario. Antes de vender necesitas una caja abierta.

1. Requisito: caja abierta

Sin una sesión de caja abierta no se puede vender. Si no la hay, la zona de productos muestra el mensaje “Abra la caja registradora para comenzar a realizar ventas”, los datos de la Última caja (número, fecha de cierre, total de ventas) y el botón “Abrir Caja”. El carrito queda deshabilitado.

Nota: al pulsar cobrar, el sistema vuelve a comprobar que la caja siga abierta (por si se cerró en otra pestaña). Si no, avisa “La caja ya no está abierta. Refresque la página.”

2. Abrir la caja

Pasos:

1. Pulsa “Abrir Caja” (atajo F5).
2. Si tienes varias cajas configuradas, selecciona en la barra superior cuál vas a abrir. Verás “Vas a abrir: {nombre} (código de punto de venta)”.
3. Escribe el Monto de apertura ($) — el efectivo con el que inicia la caja.
4. Pulsa “Abrir Caja”. Aparece el aviso “Caja abierta”.

Reglas:

• Solo puede haber una sesión abierta por punto de venta. Si ya hay una: “Ya hay una caja abierta en este punto de venta. Ciérrala antes de abrir una nueva.”
• La caja recibe un número tipo CAJA-2026-0001.
• Si lleva 8 horas o más abierta, la barra superior muestra un aviso “Pendiente cierre”.

3. Buscar y agregar productos

Tienes dos formas de agregar artículos:

Buscador (rápido):

1. Pulsa F3 o haz clic en la barra de búsqueda (placeholder “Buscar producto o 3producto… (F3)”*).
2. Escribe el nombre o el SKU.
3. Para varias unidades de golpe, usa la sintaxis 3*producto o 3x producto (aparece un badge ×3).
4. Cada resultado muestra imagen/ícono, nombre, si es Servicio, cuántas unidades ya hay en el carrito, SKU, categoría, stock y el precio con IVA incluido. Haz clic para agregarlo.

Cuadrícula visual:

• Filtra por tipo con Todos / Productos / Servicios, elige el número de columnas (2 a 6) y navega por pestañas de categoría (cada una con su conteo).
• Cada tarjeta muestra imagen, nombre, precio (con IVA) y stock, con badges Sin stock (no se puede agregar), stock bajo, Servicio o duración en minutos.

Nota: el buscador solo lista productos con stock en la sucursal activa; los servicios se listan siempre. Los servicios no descuentan inventario.

4. El carrito y los descuentos

En el panel derecho (Carrito) revisas y ajustas la venta:

• Cantidad por línea: botones – / + (el + se bloquea al alcanzar el stock disponible, con el aviso “Stock máximo alcanzado para …”).
• Eliminar línea: botón de papelera.
• Descuento por línea: enlace ”+ Agregar descuento”, con conmutador $ / %.
• Descuento global: botones rápidos 5 % / 10 % / 15 % o un monto libre en $ / %, con opción “Quitar”.
• Vaciar todo el carrito.

Totales (desglose): Subtotal · IVA (13 %) · Descuentos por producto · Descuento global · Total (lo que se cobra).

Validación: si el total llega a $0 por un descuento, aparece “El total es $0 — ajuste el descuento para poder cobrar.” y los botones de pago se deshabilitan.

5. Cliente y tipo de documento

En Opciones de venta defines cómo se emite el documento:

Pasos:

1. Tipo de documento: “Consumidor Final” (FCF) o “Crédito Fiscal” (CCF).
2. Atendido por: el empleado que realiza la venta (se autoselecciona el ligado a tu usuario).
3. Cliente: búscalo, créalo con +, ve sus detalles con el ojo, o quítalo con X. También puedes escribir solo un nombre libre.
4. Auto-CCF: si eliges un cliente marcado como contribuyente, el sistema cambia solo a CCF y precarga sus datos fiscales.
5. Datos fiscales (solo CCF), todos obligatorios: Razón social, NIT, NRC, Giro / actividad económica y Dirección.

Validación: si es CCF y faltan los datos fiscales, el cobro se bloquea con “Para emitir CCF complete los datos fiscales del cliente”. Si eliges CCF con un cliente no contribuyente, verás una advertencia con el botón “Actualizar cliente”.

6. Cobrar: métodos de pago

Pulsa uno de los botones de cobro: Efectivo, Tarjeta, Transf. o Pago mixto.

Nota: para cobrar con tarjeta debe existir al menos una terminal POS configurada (Ajustes → Integraciones). El cambio solo se calcula sobre la parte en efectivo.

7. Cómo se calcula el IVA

En el POS el precio que ves ya incluye el IVA (precio de góndola). El sistema extrae el 13 % para mostrarlo desglosado; nunca lo suma encima. Por eso:

• El Total que cobras es exactamente el precio de la etiqueta.
• El Subtotal y el IVA (13 %) de abajo son solo el desglose informativo de ese mismo total.
• Cambiar de Consumidor Final a Crédito Fiscal no cambia lo que paga el cliente; solo cambia cómo se presenta el IVA en el documento fiscal.

Regla fiscal: esta lógica es la misma en el POS y en la facturación manual (tutorial 12). El precio de catálogo siempre se interpreta con IVA incluido (excepto la Factura de Exportación, que es 0 %).

8. Transmitir a Hacienda y venta exitosa

Si tu cuenta opera en modo Hacienda, al confirmar el pago aparece el diálogo “Emitir factura — ¿Cómo desea procesar esta factura?” con dos opciones:

• “Transmitir a Hacienda (DTE)” — firma y transmite al Ministerio de Hacienda; recibe código y sello.
• “Solo registro interno” — registra la venta sin transmitir (podrás emitirla después desde el detalle de la factura).

Antes de emitir, el sistema hace un pre-chequeo de stock; si falta, avisa “Stock insuficiente para X (disp: N)” y no cobra.

Luego se muestra el modal “Venta Exitosa” con el número de documento, el detalle, los totales, el método de pago y el cambio. Acciones:

• “Imprimir Ticket” (ticket térmico de 80 mm).
• “Imprimir DTE PDF” — solo si el DTE fue transmitido y aceptado por Hacienda.
• “Nueva Venta”.

Nota: el carrito se conserva si refrescas la página por accidente, y la venta es a prueba de doble clic (un reintento no genera dos ventas).

9. Atajos de teclado

Con F8 abres “Ventas del Día”: conteo, total y cada venta con opción de reimprimir ticket.

10. Cerrar la caja (arqueo)

Pasos:

1. Pulsa “Cerrar Caja” (F5). Verás el resumen: Ventas totales, Ventas efectivo, Ventas tarjeta, Productos (subtotal), Servicios (subtotal), Monto apertura y Efectivo esperado.
2. Escribe el Efectivo contado ($). El sistema muestra la diferencia:
   • “Cuadra” (verde) si es $0.
   • ”+$X (sobrante)” o “$X (faltante)”, con la tolerancia configurada (por defecto ±$5).
3. Si la diferencia supera la tolerancia, el campo Notas se vuelve obligatorio; sin nota no deja cerrar.
4. Pulsa “Cerrar Caja” (aviso “Caja cerrada”).
5. Opcional: “Imprimir Reporte” del cierre (apertura, ventas, esperado, contado, diferencia, notas y firma).

Efecto contable: la diferencia genera automáticamente un asiento (faltante o sobrante). El efectivo esperado = monto de apertura + ventas en efectivo.

11. Diferencias e historial de caja

Punto de Venta → Diferencias de Caja (pos:reports): reporte de faltantes y sobrantes por cajero en un rango de fechas, con KPIs (Total Faltantes, Total Sobrantes, Diferencia Neta) y desglose por cajero.

Punto de Venta → Historial de Caja (pos:reports): lista de todos los cierres (n.º de caja, cajero, apertura, cierre, ventas, diferencia). Al abrir un cierre ves su detalle completo y puedes “Imprimir reporte” en PDF.

12. Liquidaciones POS

Los cobros con tarjeta no ingresan como efectivo: se liquidan cuando el banco deposita los fondos, ya descontada la comisión. Esa conciliación se hace en Facturación → Liquidaciones POS (normalmente la realiza administración/contabilidad, no el cajero). Consulta el detalle en el tutorial 12 · Facturación.