Todo lo que hace el sistema, explicado por quién lo usa

1. 1Escribe su nombre y toca «Comenzar pedido».
2. 2Recorre el catálogo por categorías (bebidas, desayunos, charcutería, combos…) o usa el buscador de arriba para encontrar un producto por nombre.
3. 3En cada producto, escribe la cantidad exacta en el recuadro (o el peso en gramos, si es un producto que se vende por peso) y toca «Agregar».
4. 4El carrito flotante (abajo a la derecha) muestra cuántos artículos lleva — al tocarlo se abre el resumen completo, con botones para cambiar cantidades sin volver al catálogo.

Si un producto se agota mientras el cliente arma el pedido, el sistema lo retira solo del catálogo y recalcula el total — no hace falta que nadie avise a mano.

Si el dueño cargó extras para la categoría de un producto (pensado sobre todo para pizzerías: queso extra, anchoas, tocineta…), ese producto ya no se agrega directo con el stepper de cantidad — en su lugar aparece un botón «Agregar» que abre una ventana con la lista de extras disponibles (cada uno con su precio) y un campo de cantidad.

Cada combinación distinta de extras queda como su propia línea del carrito — por ejemplo, dos pizzas, una con queso extra y otra con anchoas, se ven como dos renglones separados, no uno solo con cantidad 2. Un producto sin extras cargados en su categoría sigue funcionando exactamente igual que siempre.

En negocios con módulo de cocina, la primera pantalla tiene una pestaña «Cuentas abiertas»: lista las cuentas de mesa que ya están en curso. El cliente (o el mesero) elige una, ve de un vistazo lo que esa cuenta ya tiene pedido, agrega lo nuevo y toca «Agregar a la cuenta» — no se cobra todavía, se suma a la cuenta de esa mesa para cobrar todo junto al final.

Desde el carrito de un pedido nuevo también se puede tocar «Guardar cuenta abierta» para empezar una cuenta (o sumarse a una que ya existe) sin pasar por la pantalla de pago — libera la tablet para atender a otra persona mientras esa mesa sigue consumiendo.

Al tocar «Confirmar selección», el sistema calcula el total en bolívares a la tasa del día y muestra las formas de pago disponibles:

El cliente también puede pedir recibo digital por correo, marcando la casilla antes de confirmar el pago.

Después de pagar, la pantalla se queda siguiendo el estado del pedido sola (sin recargar): «pendiente por validar», «pago confirmado», hasta que se despacha. Si el pago no se puede validar automáticamente, el pedido queda pendiente para que el dueño lo revise a mano — nunca se pierde una venta en silencio.

Los negocios con el módulo de pedido online activo tienen, además del catálogo de siempre, una segunda pantalla más simple pensada solo para el cliente final — sin mesas ni cuentas abiertas, solo nombre, catálogo y pago.

En esa pantalla, antes de confirmar, el cliente puede tocar «Delivery o Pickup»:

• Delivery: escribe su nombre y teléfono, y toca «Compartir mi ubicación» (como WhatsApp) — el sistema calcula solo la distancia hasta el local y aplica la tarifa del tramo que corresponda, sin elegir ninguna zona a mano. Si el negocio todavía no cargó su ubicación, o la distancia queda fuera de todos los tramos configurados, avisa con un mensaje claro en vez de adivinar una tarifa. El teléfono le llega a caja/despacho como un enlace directo a WhatsApp.
• Pickup: un solo botón, «En sede» — confirma que lo va a retirar en el local.

Si elige cualquiera de las dos, la pantalla de pago solo muestra Pago Móvil y Efectivo (no «Tarjeta», porque ese pedido no se cobra en un mostrador en ese momento).

1. 1Escribe el nombre del cliente y toca «Comenzar pedido».
2. 2Arma el carrito como cualquier cliente.
3. 3Si el negocio tiene mesas cargadas, aparece un selector «Mesa: Sin asignar» dentro del carrito — elige la mesa correspondiente en cualquier momento, incluso después de haber empezado el pedido por nombre.

Desde la pestaña «Cuentas abiertas» de la primera pantalla, el mesero ve todas las mesas con consumo en curso (nombre o mesa, total acumulado, cantidad de artículos). Elegir una muestra de entrada todo lo que esa cuenta ya tiene pedido — el mesero agrega la ronda nueva y toca «Agregar a la cuenta». El cobro final de esa cuenta se hace después, desde /panel/pagos-pendientes (ver la sección de caja).

Si el negocio tiene el módulo de pedido online activo, la primera pantalla gana una tercera pestaña, «Pickup»: lista los pedidos para retirar que ya están pagados y listos. El mesero toca «Marcar entregado» apenas se los entrega al cliente en el mostrador — no hace falta entrar al panel para esto.

Lista los pedidos cuyo Pago Móvil no se pudo confirmar solo (referencia no encontrada, monto no coincide, o el banco no tiene automatización). Por cada uno se ve el banco, la referencia y el motivo del rechazo. Dos acciones:

• «Aprobar y despachar» — si se confirmó el pago por otro medio (viendo el estado de cuenta, por ejemplo), aprueba, descuenta el stock, despacha e imprime la nota, los tres pasos de una vez.
• «Eliminar pedido» — si el pago nunca llegó, lo descarta sin tocar stock.

En la misma pantalla de pagos pendientes, más abajo, están los pedidos que el cliente dejó para pagar en caja y las cuentas abiertas en curso. Por cada uno se puede:

• Editar el carrito (agregar o quitar artículos) antes de cobrar.
• Elegir cómo pagó (Pago Móvil, Efectivo, «Pago manual» — para punto de venta o cualquier cobro que no pasa por la validación automática — o «Venta a crédito», si el cliente no paga en ese momento) y tocar «Cobrar»: esto despacha e imprime la nota en un solo paso (salvo que el pedido todavía esté esperando a cocina). Una venta a crédito no se cobra ahí — queda como una cuenta por cobrar en /panel/creditos.
• Asignar o cambiar la mesa.
• «Eliminar» la cuenta, si el cliente se fue sin consumir.

Pantalla propia para vender directo en el mostrador, sin pasar por el catálogo del cliente — pensada para cafetines sin servicio a la mesa, o como caja rápida de cualquier negocio.

1. 1Si el negocio tiene cajeros cargados, elegir el nombre y escribir el PIN — o tocar «Continuar como dueño» para saltarlo (el PIN nunca es obligatorio, solo identifica quién atiende).
2. 2Abrir el turno de caja con el efectivo inicial (dólares y bolívares por separado). Mientras el turno está abierto se pueden registrar retiros o entradas de efectivo, cada uno con motivo.
3. 3Buscar los productos (por nombre o escaneando el código de barras, si el módulo está activo), armar el carrito con el stepper de cantidad.
4. 4Si el cajero tiene permiso, puede aplicar un descuento por producto o al ticket completo (porcentaje o monto fijo), con motivo obligatorio.
5. 5Cobrar con uno o varios métodos de pago mezclados en el mismo ticket, con recibo digital opcional, y cerrar el turno al final declarando el efectivo contado — el sistema muestra la diferencia contra lo esperado.

Estas tres acciones aparecen junto a cada cuenta de mesa abierta, en /panel/pagos-pendientes:

• Dividir cuenta: en partes iguales (elige cuántas), por producto (cada artículo a su parte) o por monto libre (se escribe cuánto le toca a cada quien). Cada parte se cobra por separado, con su propio método de pago — la mesa se libera recién cuando todas las partes quedaron pagadas.
• Unir con otra mesa: funde dos cuentas abiertas en una sola (suma los artículos de ambas) — útil cuando dos mesas se juntan. No se puede si alguna de las dos ya tiene un pago o una división en curso.
• Propina: se carga como porcentaje sugerido del total o como monto fijo, aparte del total de la cuenta — se cobra por su cuenta (normalmente en efectivo), no se suma al monto que hay que pagar con tarjeta o Pago Móvil.

Exclusivo del dueño: anula un pedido que ya se cobró y despachó (por ejemplo, un error de carga o un reclamo del cliente). Devuelve el stock vendido y pide un motivo, que queda en la auditoría — no reversa el dinero ya cobrado, solo el inventario y el registro de la venta.

Apenas un pago se valida (solo o a mano), la nota aparece acá sola, con sonido de alerta. Un pedido con cocina activa que todavía no está listo se muestra bloqueado, con el aviso «esperando que cocina termine» — se habilita apenas cocina lo marca listo.

1. 1Tocar «Despachar» entrega el pedido e imprime la nota (si hay impresora conectada vía la app de escritorio).
2. 2Si nadie despacha en 10 minutos, el sistema lo despacha solo — como respaldo, no como reemplazo del despacho manual. Un contador arriba muestra cuántos auto-despachos hubo en el día.

La pantalla más usada del panel, organizada en pestañas tipo carpeta:

• Productos: alta de productos nuevos (nombre, categoría, precio, stock, foto, umbral de stock mínimo, y código de barras si el módulo está activo). La edición es masiva: se cambian los campos que hagan falta directo en la lista y un botón flotante («Guardar cambios») manda todo el lote de una vez — no hace falta guardar fila por fila. Hay buscador y filtro por categoría.
• Insumos: igual que productos, pero un insumo nunca se vende directo ni aparece en el catálogo del cliente — existe solo para que una receta lo descuente (harina, café molido, vasos, tapas).
• Productos por peso: al crear un producto se elige «Por unidad» o «Por peso (kg)» — para charcutería, carnes, quesos. El precio y el costo se cargan por kilo; el stock se maneja en gramos.

Dentro de la pestaña «Recetas / Combo»: a cada producto vendible se le arma una receta (qué insumos y cuánto de cada uno consume una unidad). Vender ese producto descuenta solo esos insumos. Un componente de receta puede ser otro producto que también se vende suelto — así se arman combos («Combo 1» = una bebida + un pasapalo, cada uno vendible por separado también). El costo y el margen del producto se calculan solos, sumando el costo de cada componente.

Dentro de /panel/productos, pestaña «Extras»: se eligen una categoría (ej. «Pizzas») y se cargan los extras que ofrece — nombre y precio en dólares (ej. «Queso extra», $1.00). Se configuran una sola vez por categoría, no producto por producto: todas las pizzas de esa categoría ofrecen automáticamente la misma lista de extras al cliente. Admite desactivar un extra sin borrarlo, para no perder la referencia de pedidos que ya lo usaron.

Mesas (solo con módulo de cocina activo): cargar los nombres de las mesas del salón — aparecen en el selector de mesa del mesero.

Delivery (solo con módulo de pedido online activo), dentro de la misma pestaña de Productos:

• Ubicación del local: un botón «Usar mi ubicación actual» guarda las coordenadas GPS del negocio — es el punto desde el que se mide la distancia de cada pedido.
• Tramos de distancia: en vez de zonas con nombre, se cargan tramos («hasta 1 km», «hasta 2 km»…) con su tarifa en dólares — por ejemplo, hasta 1 km sin costo, de 1 a 2 km $1. El sistema elige solo el tramo que corresponde a la distancia real de cada cliente.

Ambas secciones admiten desactivar (en vez de borrar) para no perder la referencia de pedidos ya hechos.

Dentro de /panel/productos, pestaña «Mesas», debajo del listado de mesas: crear salones (ej. «Terraza», «Interior») y arrastrar cada mesa a su posición en un plano visual, con capacidad opcional. Cada mesa se ve de un color distinto según su estado — libre, ocupada, pidió la cuenta, o por limpiar — y se puede marcar «pidió la cuenta» o «mesa limpia» con un toque, sin tener que ir a buscarla en ningún listado.

Solo visible si el superadmin activó el módulo de meseros. Dentro de /panel/productos, pestaña «Meseros»: cargar el nombre de cada mesero y su porcentaje de comisión — se aplica solo sobre el total de cada pedido que atendió (ver /panel/reportes para el reporte de comisión y propina por mesero). Cada mesero puede, opcionalmente, tener un PIN propio para identificarse en /panel/pagos-pendientes (una franja arriba de la pantalla, que nunca bloquea al dueño) — así las cuentas que atiende quedan asociadas a él sin tener que elegirlo a mano en cada pedido.

Para negocios con varias impresoras (ej. una para la arepera, otra para bebidas): dentro de /panel/productos, pestaña «Mesas», se crean las estaciones y se asigna cada categoría de producto a la suya desde «Categorías». Un mismo pedido con artículos de varias categorías imprime una comanda por estación, en cadena — la siguiente se imprime sola apenas se marca lista la anterior, para que ningún plato se quede esperando frío o caliente. Sin ninguna estación creada, todo sigue imprimiéndose junto en una sola comanda, como siempre.

Solo visible si el superadmin activó el módulo de pedido online. Reúne todo el ciclo de un pedido de delivery en una sola ficha por pedido: comprador, artículos (con sus extras si los lleva), contacto (teléfono como enlace de WhatsApp), ubicación y distancia, monto, forma de pago y si ya se validó o no — sin tener que ir a buscarlo entre Pagos pendientes y Despacho. Un pedido nuevo suena y aparece solo, sin recargar la pantalla.

Si el negocio tiene módulo de cocina, cada ficha tiene su propio botón «Enviar a cocina» — es la única forma de que un pedido de delivery entre a la cola de cocina, porque la pantalla de pago simplificada no tiene ese paso.

Colores del catálogo que ve el cliente: dos paletas de fábrica («Negro, rojo y dorado» y «Cálido clásico», la de este manual) o colores propios, campo por campo (fondo, letras, bordes, botón de acción, color del precio). Desde «Productos» también se elige el diseño (lista o cuadrícula) y cuántas columnas usa la cuadrícula en pantallas grandes.

Inventario (/panel/inventario): stock disponible por producto e insumo, valor total en existencia, alertas de stock bajo/agotado, y sugerencias de reposición calculadas sobre el consumo real de los últimos 30 días. Exportable a CSV. Mermas (/panel/mermas): registrar producto vencido, dañado, de cortesía o para consumo interno — descuenta stock real con motivo y nota, con su propio historial.

Tasa (/panel/tasa): se carga a mano, o se activa sincronización automática con el BCV (la tasa se actualiza sola apenas cambia la oficial — apagado por defecto, porque muchos negocios usan una tasa paralela más alta). Métodos de pago (/panel/metodos-pago): los datos de cuenta que el cliente ve en el acordeón «Cómo pagar» (Pago Móvil, Zelle, transferencia…) — etiqueta, detalle y un código QR opcional por cada uno.

Cuentas por cobrar de ventas marcadas como «Venta a crédito» desde Pagar en caja — el pedido se despacha igual, pero el cliente no paga en ese momento. La deuda se guarda en dólares, no en bolívares, para que no pierda valor con la inflación mientras el cliente no viene a pagar.

Cada cuenta muestra cuánto debe en dólares y cuánto sería hoy en bolívares a la tasa vigente — ese número en bolívares cambia solo si la tasa cambia, aunque el cliente no haya abonado nada. Para registrar un pago, se anota el monto que trajo (en bolívares o en dólares) y el sistema calcula solo cuánta deuda cubre, usando la tasa del día del abono — no la tasa del día de la venta. La cuenta se marca saldada sola cuando ya no debe nada.

Solo visible si el superadmin activó el módulo de cocina para el negocio. Lista los pedidos que el cliente ya confirmó, listos para preparar — no espera a que el pago se valide. Cada plato se marca «Listo» apenas sale de cocina, lo que lo habilita para despacho (si el pago ya está resuelto) o lo deja esperando el pago en una fila aparte.

Reportes (/panel/reportes): ventas por día/semana/mes o un rango elegido, costo y margen por producto, top de más vendidos, gráficos y exportación. Si el negocio tiene el módulo de lealtad, se suma una tarjeta con los clientes más frecuentes del período, puntos emitidos vs. canjeados, y una lista de clientes inactivos (marcados en rojo los que ya superan el umbral de días configurado en /panel/lealtad).

Cierre de caja (/panel/cierre-caja) tiene dos botones, con la misma terminología que cualquier punto de venta:

• Reporte X: una vista previa en vivo de los totales del día (vendido, despachados, cancelados, operaciones) — se puede pedir todas las veces que haga falta durante el turno, no guarda ni cierra nada.
• Reporte Z: el cierre definitivo de siempre — congela esos mismos números para esa fecha. Generarlo dos veces el mismo día pide confirmación antes de sobrescribir.

Historial (/panel/historial): todos los pedidos pasados, con su detalle completo y reimpresión de nota. Auditoría (/panel/auditoria): bitácora de cambios de precio, stock, umbral y costo de cada producto, más las importaciones de inventario por CSV — quién cambió qué y cuándo.

Conectar el Telegram del dueño para recibir un aviso apenas un producto quede con stock bajo o se agote — sin tener que entrar al panel a revisarlo.

Si el negocio forma parte de una cadena (varias sucursales bajo un mismo dueño), esta sección deja ver — y entrar a administrar — el panel de cada sucursal desde la misma cuenta, sin tener que iniciar sesión por separado en cada una.

Solo visible si el superadmin activó el módulo. Tres secciones en una sola pantalla:

• Configuración: activar/desactivar el programa, cuántos puntos gana el cliente por cada dólar gastado, vencimiento opcional de los puntos, cada cuántos días sin comprar avisar que un cliente quedó inactivo, y la URL/secreto de un webhook para automatizar avisos (ej. con n8n hacia WhatsApp) — dispara cuatro eventos: cliente_registrado, puntos_acreditados, recompensa_disponible (apenas el saldo de un cliente alcanza el costo de alguna recompensa activa) y cliente_inactivo (revisado una vez al día).
• Recompensas: catálogo de lo que un cliente puede canjear — un producto gratis o un porcentaje de descuento, cada uno con su costo en puntos.
• Canjear recompensa: buscar al cliente por teléfono (o registrarlo si es la primera vez), ver su saldo, y canjear cualquier recompensa que le alcance.

El cliente se identifica por teléfono también desde Caja (venta de mostrador) y desde una cuenta de mesa en Pagos pendientes — los puntos se acreditan solos apenas esa venta queda pagada, y se revierten si el dueño anula la venta después.

/panel/cambiar-password para cambiar la contraseña (obligatorio la primera vez, si el superadmin asignó una temporal) y /panel/recuperar si se olvida.

Crear negocios nuevos, activar/desactivar el acceso, y cargar licencias (cada renovación queda como su propio registro — la vigencia real es la fecha de fin más lejana entre todas). También configura la regla de notificación bancaria (el webhook que recibe los Pago Móvil de la app del teléfono del negocio) y puede ver el detalle completo de cualquier negocio (productos, pagos, historial, cierre de caja, auditoría) en modo solo lectura.

Interruptores por negocio — apagados por defecto porque no todos los negocios los necesitan:

Cadenas (/superadmin/cadenas): agrupar varias sucursales bajo un mismo dueño, para que las vea todas desde /panel/sucursales. Cuentas (/superadmin/cuentas): crear otras cuentas de superadmin, cada una con permisos propios tipo lista de verificación (gestionar negocios, dueños, licencias, reglas bancarias, otras cuentas de superadmin, cadenas, o solo ver el detalle de un negocio) — no todas tienen que poder hacer todo.