Documentación de LucraPOS

Qué es LucraPOS

LucraPOS es un punto de venta en la nube para tu negocio: vende rápido, controla inventario, clientes, caja y reportes. Funciona desde cualquier navegador (computadora, tablet o celular) sin instalar nada. Tus datos se guardan y sincronizan en la nube.

Cuenta y acceso

• Crear negocio: en la pantalla de inicio, pestaña "Crear negocio". Pide nombre del negocio, tu nombre, usuario, correo de recuperación y contraseña. Puedes empezar con datos de ejemplo.
• Iniciar sesión: con tu usuario y contraseña.
• Olvidé mi contraseña: envía un enlace de recuperación a tu correo registrado.

Roles y permisos

Cada cuenta tiene un rol que define lo que puede ver y hacer:

• Propietario Acceso total: usuarios, ajustes, costos, borrar datos.
• Encargado Gestiona productos, inventario, ajustes y ve costos. No administra cuentas.
• Vendedor Solo vende. No ve ventas, corte del día, caja, inventario, reportes ni costos, y no puede modificar productos. Puede usar el punto de venta y registrar clientes.

Panel

Muestra solo lo del corte actual: vendido en este corte, número de productos y ticket promedio (con el más vendido). El botón Consultar días anteriores abre el total y los tickets vendidos por día. Incluye accesos rápidos, alertas de stock bajo y la actividad reciente.

Punto de venta

La pantalla para cobrar. Funciones:

• Buscar / escanear: busca por nombre, código o código de barras. Con un lector de código de barras, al escanear se agrega solo al carrito (Enter).
• Carrito: ajusta cantidades con +/− o escribiendo el número. Respeta el stock disponible.
• Descuento: en monto ($) o porcentaje (%).
• Método de pago: Efectivo, Tarjeta, Transferencia o Mixto.
• IVA: se aplica si está activado en los ajustes.
• Efectivo y cambio: botones rápidos (Exacto, $50, $100…) y cálculo del cambio. Avisa si el efectivo no alcanza.
• Cliente: asigna la venta a un cliente o "Cliente general".
• Doble ticket: en Negocio → Ventas y ticket puedes activar "Imprimir doble ticket (2 copias)" para que cada venta salga por duplicado (cliente y negocio). Por USB salen como dos tickets cortados; por navegador, dos copias en la misma tira. Nota: para que salgan separados en 2 tickets se necesita una impresora con cortador automático.
• Cortar papel: en Negocio → Impresión hay un botón "Cortar papel" (en modo USB) para que la impresora haga un corte cuando lo necesites. Solo funciona en impresoras con cortador automático.
• Servicio: el selector ofrece En el local / A domicilio (en giros que no son restaurante dice Local en vez de "En el local"). Al elegir A domicilio aparece un campo de dirección (se prellena con la del cliente elegido) que se imprime en el ticket y en el pedido a cocina, y se suma el costo de envío configurado en Negocio.
• Efectivo: si no capturas el monto recibido, la venta se cobra como pago exacto (sin cambio); si escribes un monto mayor, calcula el cambio.
• Monto libre: botón para cobrar algo que no está en el catálogo (un servicio, una reparación, "varios $35"…). Escribes un concepto y el precio, y se agrega al carrito como una línea más. No afecta el inventario.
• Editar línea (botón ✎ en cada producto del carrito): aplica un descuento a esa línea y, en productos por kilo o de monto libre, cambia su precio. En modo restaurante además puedes agregar una nota / modificador por platillo ("sin cebolla", "+ queso"). El descuento por línea y la nota salen en el ticket.
• Abrir cajón: botón en el carrito para abrir el cajón de dinero sin hacer venta (por ejemplo, para dar cambio). Imprime un comprobante mínimo que dispara el cajón (requiere el cajón configurado en el driver, ver Cajón de dinero).
• Finalizar: registra la venta, descuenta stock e imprime el ticket.
• Modo Caja (pantalla completa): el botón Modo Caja (en el Panel y en el Punto de venta) deja solo la pantalla de venta, en grande y a pantalla completa, ocultando el menú y lo demás. Ideal para un vendedor nuevo o una tablet en el mostrador: muestra una guía de 3 pasos (buscar → tocar → cobrar). Para salir, el botón rojo "✕ Salir del Modo Caja" arriba a la derecha (salida libre). El modo se recuerda al cerrar y volver a abrir.
• Botón Cobrar siempre visible: el total y el botón Cobrar quedan fijos abajo aunque el carrito tenga muchos productos.

Ventas

Historial de ventas con filtros por texto, fecha y método de pago. Puedes ver el detalle (reimprimir ticket), eliminar una venta y exportar a CSV. Eliminar es permanente: la venta se borra del historial (no queda marcada como "cancelada") y el stock regresa al inventario.

Productos

• Agregar / editar productos: nombre, código, código de barras, categoría, precio, costo, stock, stock mínimo, unidad, proveedor y descripción.
• Venta por kilo: marca la casilla "Venta por kilo" en el producto (el Precio es el precio por kilo). En el punto de venta y en mesas, al agregarlo te pregunta el precio a cobrar (lo que marca la báscula) y calcula los kilos solo. En el ticket sale el peso aproximado y el precio por kilo.
• Ajuste rápido de stock por producto.
• Exportar catálogo a CSV.
• Imprimir lista: botón "Imprimir lista" → imprime en la térmica todos los productos (nombre, precio, código y stock) ordenados por nombre. Útil para revisar precios o hacer conteo.
• Importar CSV: botón "Importar CSV" para cargar productos masivamente. La primera fila son los encabezados (acepta español: nombre, código, código de barras, categoría, precio, costo, stock, stock mínimo, unidad, proveedor, descripción). Los productos cuyo código ya existe se actualizan (solo las columnas incluidas), y los nuevos se agregan. La forma más fácil es exportar el CSV, editarlo en Excel y volver a importarlo.
• Etiquetas: cada producto muestra el botón "Etiqueta" (en cualquier giro) → imprime en la térmica una etiqueta con nombre, precio y código de barras (escaneable). Eliges cuántas imprimir. Usa el código de barras del producto, o su código interno si no tiene. Por USB cada etiqueta sale cortada con espacio suficiente para que no se parta.
• El costo solo lo ven encargado/propietario.
• Precio de mayoreo: activa Mayoreo en Negocio → Funciones. En el producto pones un precio de mayoreo y la cantidad mínima para aplicarlo. Al vender esa cantidad o más, el precio cambia solo al de mayoreo (se ve en el mosaico del POS).
• Combos / paquetes: activa Combos en Negocio → Funciones. Marca un producto como combo y elige qué productos lo forman y en qué cantidad. Al venderlo se cobra el precio del combo y se descuenta el stock de cada componente.

Clientes

Registra clientes con nombre, teléfono, correo, dirección y notas. Se pueden asignar a las ventas. Con el botón Historial ves sus compras, contacto, dirección y cuánto debe (fiado).

Inventario

Valor total del inventario, productos con bajo stock, agotados y el historial de movimientos (cada cambio de stock con motivo y usuario).

Caja y corte del día

• Caja de efectivo: abre con un fondo inicial y ciérrala registrando el efectivo final (calcula diferencia).
• Corte del día: genera un resumen con total vendido, número de ventas, desglose por método de pago, artículos, ganancia y más vendidos. Se puede imprimir y reinicia el conteo del día (sin borrar ventas).
• Si no se vendió nada, no se puede hacer corte: el botón se desactiva cuando el periodo no tiene ventas (no hay nada que cortar).
• Cortes siempre al día: si eliminas una venta, los cortes se recalculan con las ventas reales y dejan de reflejarla. Si un corte se queda sin ninguna venta, se elimina solo.

Reportes

Ventas por día, producto más vendido, mayor ingreso y ganancia estimada. Incluye respaldo: exportar/importar todo en JSON y borrar datos (solo propietario).

Vendedores

El propietario crea y administra las cuentas del negocio, asigna roles, activa/desactiva cuentas y ve el último acceso.

Si asignas el rol Vendedor, esa cuenta queda limitada a solo vender: no verá ventas, corte del día, caja, inventario, reportes ni costos, y no podrá modificar productos. Es lo ideal para cajeros.

Negocio (ajustes)

• Logo y datos: nombre, giro, dirección, teléfono, moneda. El logo aparece en el ticket y en el panel lateral, y se ajusta solo a su forma (horizontal, cuadrado o vertical) sin recortarse.
• Stock mínimo general e IVA (activar y porcentaje).
• Costo de envío a domicilio: monto que se suma al total cuando la venta es "A domicilio". Déjalo en 0 si no cobras envío.
• Ancho del ticket: 44, 57, 58, 76, 80, 112 mm o carta.
• Impresión automática al cobrar y mensaje del ticket.
• Meta de ventas diaria (se ve como barra de progreso en el Panel).
• Funciones activas: enciende/apaga Fiado, Propina, Gastos y Menú público (ver Activar/desactivar).

Búsqueda global y modo sin internet

• Búsqueda global: arriba, encuentra ventas, productos y clientes al instante.
• Sin internet: si se cae la red, las ventas se guardan en una cola local y se envían solas al reconectar. El botón "Actualizar" muestra cuántas faltan por sincronizar.

Fiado / cuentas por cobrar

Vende "a crédito" a un cliente y lleva el control de lo que te debe.

• En el punto de venta, elige el método Fiado y selecciona el cliente (obligatorio).
• La venta se registra y el stock se descuenta normal, pero queda marcada como pendiente de pago.
• En la pestaña Por cobrar ves todas las cuentas abiertas, cuánto te deben en total y por cliente.
• Cuando te paguen, presiona Cobrar y elige el método (efectivo, tarjeta, transferencia).

Gastos y ganancia neta

Registra el dinero que sale (renta, compras, servicios, sueldos) para conocer tu ganancia real.

• En la pestaña Gastos, presiona Registrar gasto (concepto, categoría, monto).
• Verás los gastos del día y los totales.
• En Reportes aparece la Ganancia neta = ganancia de ventas − gastos.

Menú público por link (restaurante)

Comparte tu menú con tus clientes mediante un link. Ellos ven tus productos y precios desde el celular, sin instalar nada. Los productos de venta por kilo muestran "Por kilo" y el precio como "/kg".

1. Activa Negocio → Funciones activas → Menú público y guarda.
2. Aparecerá tu link, algo como: tusitio.com/menu/tu-negocio.
3. Presiona Copiar link y compártelo por WhatsApp, redes o un código QR.
4. Tus clientes verán el menú con tus productos agrupados por categoría y precios.

• El menú muestra nombre, descripción, categoría y precio de cada producto. Nunca muestra costos, stock ni datos internos.
• Puedes poner un mensaje del menú (ej. "Pedidos por WhatsApp al…").
• Se actualiza solo cuando cambias tus productos.

Activar / desactivar funciones

Cada negocio enciende solo lo que usa, en Negocio → Funciones activas:

• Fiado — cuentas por cobrar y método Fiado.
• Propina — campo de propina al cobrar (ideal restaurante).
• Gastos — registro de egresos y ganancia neta.
• Inventario — la sección de inventario y movimientos. Al apagarlo se ocultan la columna y los botones de Stock en Productos, y puedes vender aunque el stock esté en 0 (ya no descuenta ni bloquea por existencias; y al eliminar una venta tampoco suma stock).
• Menú público — el link del menú para clientes.
• Modo restaurante — mesas y pedidos a cocina.
• Escáner con cámara — botón "Escanear" en el punto de venta que usa la cámara del celular o tablet para leer el código de barras y agregar el producto al carrito (sin lector físico). Escaneo continuo: lee uno tras otro. Funciona mejor en Chrome/Android; en navegadores sin soporte, usa un lector USB.
• Teclado numérico en pantalla — ideal para tablets sin teclado físico: al tocar un campo de número (efectivo, descuento, precio, etc.) aparece un teclado grande en la pantalla para capturar el monto con el dedo. Toca "Listo" para cerrarlo.

Al apagar una función, desaparece de los menús y del punto de venta, para mantener todo simple.

Modo restaurante (mesas y cocina)

Actívalo en Negocio → Funciones activas → Modo restaurante y define el número de mesas. Aparece la pestaña Mesas.

• Mesas: una cuadrícula con cada mesa en verde (libre) o rojo (ocupada, con su total y tiempo).
• Cuenta: tocas una mesa y abres su cuenta. Agregas platillos y una nota por platillo para la cocina (ej. "sin cebolla"). La cuenta queda guardada y abierta.
• Enviar a cocina: manda el pedido (solo lo nuevo) a la cocina con aviso de confirmación (y vibración en celular). Los platillos enviados se marcan ✓ y el botón queda como "Enviado"; solo se vuelve a habilitar si agregas algo nuevo, para no mandar dos veces lo mismo.
• Cómo llega a la cocina (Negocio → "Pedido a cocina"):
  • 🖨️ Imprimir en papel: sale un ticket "Pedido a cocina" (sin precios).
  • 📺 Pantalla de cocina (sin papel): aparece la pestaña Cocina. El cocinero abre LucraPOS en un celular o tablet en la cocina y los pedidos le llegan a la pantalla; suena una alarma fuerte (y vibra) cuando entra uno nuevo y toca "Listo" al terminar. Ahorras papel: solo imprimes el ticket del cliente.
• Cobrar mesa: cierra la cuenta con propina/descuento/método, imprime el ticket del cliente y libera la mesa. Se registra como venta normal (entra en ventas, cortes y reportes).
• Cerrar sin cobrar: libera la mesa si fue un error.
• Mover de mesa: pasa la cuenta a otra mesa libre.
• Juntar mesas: une los platillos de otra mesa a esta.
• Dividir cuenta: al cobrar, indica entre cuántas personas y muestra cuánto paga cada una.
• En el punto de venta normal: el selector es En el local / A domicilio (con modo restaurante además aparece el botón Enviar a cocina). El ticket muestra "A DOMICILIO" con la dirección cuando aplica.

Propina, favoritos y más

• Propina: campo en el cobro; se suma al total y sale en el ticket.
• Favoritos ★: marca productos como favoritos (botón ★ en Productos); aparecen primero en el punto de venta. También hay un chip ★ Favoritos y chips por categoría para vender más rápido.
• Atajos de teclado: en el punto de venta, F2 enfoca el buscador y F4 cobra.
• Meta de ventas diaria: defínela en Negocio y el Panel muestra una barra de progreso del día.
• Historial por cliente: botón "Historial" en Clientes muestra sus compras, total y cuánto debe.
• Compartir por WhatsApp: en el ticket, botón para enviar el recibo por WhatsApp.
• Duplicar producto: crea una copia de un producto para registrar variantes rápido.

Imprimir tickets

Al finalizar una venta se muestra el ticket con botón Imprimir / Abrir cajón. LucraPOS imprime desde el navegador, así que funciona en cualquier dispositivo sin instalar nada.

Para que salga perfecto en impresora térmica

• En Negocio → Ancho del ticket, elige el ancho que coincida con tu papel (44, 57, 58, 76, 80, 112 mm).
• En el diálogo de impresión: Márgenes: Ninguno y desactiva Encabezados y pies de página.
• Usa Google Chrome (imprime mejor en térmicas que Safari).
• Activa "Imprimir ticket al cobrar" en Negocio para que salga solo.

Impresión directa por USB (tickets siempre perfectos)

Algunas impresoras térmicas genéricas, al imprimir desde el navegador, sacan caracteres raros al inicio o no cortan bien. Con la impresión directa por USB, LucraPOS le manda el ticket a la impresora en ESC/POS directo (sin pasar por el navegador): sale siempre limpio, con tu logo, se corta solo y abre el cajón. No se instala ningún programa.

El ticket incluye el logo del negocio (el que subes en Negocio) y el ancho del texto y del logo se ajustan al ancho de la impresora que elijas en Negocio → Ancho del ticket. Muy importante: ese ajuste debe coincidir con tu impresora real — si tu impresora es de 80 mm, pon 80 mm (si lo dejas en 58 mm, el texto sale angosto y descentrado).

Con el modo USB activado, todas las impresiones usan ESC/POS: el ticket de venta y su reimpresión, el pedido a cocina, el corte de caja, la lista de productos y las etiquetas con código de barras. El botón "Abrir cajón" también manda el pulso por USB (sin imprimir nada). Si en algún momento el USB falla, esa impresión sale por el navegador como respaldo.

Cómo activarla

1. Usa Google Chrome o Microsoft Edge en la computadora (no funciona en Safari).
2. Quita la impresora de las impresoras del sistema (Ajustes → Impresoras y escáneres → eliminarla). Esto es necesario para que el navegador pueda usarla por USB. El corte y el cajón los maneja LucraPOS directamente, así que no los pierdes.
3. Ve a Negocio → Impresión, elige "Impresión directa por USB" y toca "Conectar impresora USB".
4. En la lista que aparece, selecciona tu impresora y da "Permitir". Haz una impresión de prueba. ¡Listo!

📱 En iPad / iPhone

La impresión directa por USB no existe en iPad/iPhone — es un límite de Apple (ningún navegador en iOS lo permite). El POS funciona perfecto para vender; para imprimir usa el modo "Por el navegador" con una impresora AirPrint (WiFi): al cobrar sale el diálogo de impresión y eliges tu impresora. También puedes mandar el ticket por WhatsApp o descargarlo. LucraPOS detecta el iPad y deja activado el modo navegador automáticamente.

🪟 En Windows (si no conecta por USB)

En Windows, para usar la impresora por USB esta no debe estar instalada como impresora del sistema (Configuración → Bluetooth y dispositivos → Impresoras). La mayoría de las POS-80 genéricas conectan así sin más. Si aún no conecta, instálale el driver WinUSB con Zadig (gratis, una sola vez):

1. Descarga Zadig desde zadig.akeo.ie (también tienes el botón directo en Negocio → Impresión cuando entras desde Windows) y ábrelo con la impresora conectada y encendida.
2. Menú Options → List All Devices y elige tu impresora en la lista.
3. A la derecha deja WinUSB y toca "Replace Driver". Espera a que termine.
4. Vuelve a Negocio → Impresión y toca "Conectar impresora USB".

🆘 Si no imprime al conectar

Si la impresora conecta pero no sale el ticket, toca el botón "Reiniciar impresora" en Negocio → Impresión (hace un reinicio por software que la destraba). Si aun así no conecta, apaga y prende la impresora (con su botón de encendido, o desconecta y reconecta el cable USB), espera unos segundos y toca otra vez "Conectar impresora USB". LucraPOS te muestra ese mismo aviso cuando no logra conectar. Y si salen símbolos raros, apaga el logo (ver nota arriba).

Cajón de dinero (que se abra solo al cobrar)

El cajón de dinero se conecta a la impresora de tickets por el puerto "DK" / RJ11 (parecido al de teléfono), no a la computadora. El cajón no tiene electrónica propia: se abre cuando la impresora le manda un pulso al imprimir. Como LucraPOS imprime por el navegador, ese pulso lo manda el driver de la impresora, así que solo hay que activarlo una vez por computadora.

En Windows

• Ve a Panel de control → Dispositivos e impresoras, clic derecho en tu impresora térmica → Preferencias de impresión (o la Utilidad del driver).
• Busca una opción como "Cash Drawer" / "Cajón" y ponla en "Abrir después de imprimir" (After Printing). Guarda.
• Listo: cada ticket que imprimas abrirá el cajón.

En Mac

• Ve a Ajustes del sistema → Impresoras y escáneres, elige tu impresora térmica → Opciones, busca "Cash Drawer 1" y ponla en "After Printing". Guarda.
• Si tu driver es genérico y no muestra esa opción, puede que el cajón no se abra solo; en ese caso conviene usar Windows (su driver casi siempre la trae).

Abrir el cajón sin vender

En el punto de venta hay un botón "Abrir cajón" que imprime un comprobante mínimo (con la hora y el cajero) para abrir el cajón sin hacer una venta —ideal para dar cambio—. Funciona una vez que activaste la opción del cajón en el driver (arriba).

Logo en el ticket

LucraPOS incluye el logo de tu negocio en el ticket (lo configuras en Negocio → Logo). Al imprimir, el logo se manda a la impresora en blanco y negro optimizado.

Instalar como app

LucraPOS se puede instalar como aplicación en la computadora, tablet o celular (es una PWA), para abrirlo con un ícono propio, a pantalla completa y sin la barra del navegador.

• Computadora (Chrome / Edge): aparece un botón "Instalar app" flotante; o usa el ícono de instalar en la barra de direcciones. También puedes usar el Modo Caja dentro de la app para pantalla completa.
• Android (Chrome): menú ⋮ → "Instalar app" / "Agregar a pantalla de inicio".
• iPad / iPhone (Safari): botón Compartir → "Agregar a inicio".

Impresora de cocina (¿cómo llega el pedido a la cocina?)

LucraPOS imprime desde el navegador a la impresora que elijas. Tienes dos formas de manejar la cocina:

Mi recomendación: empieza con una sola impresora (Opción 1). Si tu cocina está lejos o quieres separar pedidos, una impresora de red en la cocina es lo ideal.

Desde celular y tablet

LucraPOS funciona en celular, tablet y computadora. En pantallas chicas:

• Abre el menú con el botón ☰ (arriba a la izquierda); tócalo de nuevo o toca afuera para cerrarlo.
• Las tablas se deslizan a los lados si no caben.
• Para imprimir tickets desde celular necesitas una impresora compatible (por red o Bluetooth) o una computadora conectada a la impresora.

Para una caja fija, lo más cómodo sigue siendo una laptop o tablet con la impresora; el celular es ideal para consultar ventas o vender en la calle.