BeplyTPVTienda

Que permite hacer

Permite seleccionar una terminal, entrar directamente cuando no usa agentes o identificarse con el PIN de agente cuando los tiene, abrir la caja, vender, aparcar carritos, cobrar documentos pendientes y consultar tickets. También permite escanear vales de descuento y emitir saldo de tienda al realizar una devolución. El administrador configura terminales, impresoras, perfiles de apertura, cajas y movimientos con las pantallas normales de FacturaScripts.

La pantalla de venta está en Ventas → TPV. La aplicación local beplySync trabaja en segundo plano para impresión, cajón, etiquetas y báscula; su tecnología interna no forma parte del flujo del usuario.

Primer acceso web

1. Inicia sesion en FacturaScripts.
2. Abre Ventas → TPV.
3. Selecciona la terminal en la tarjeta única la primera vez. El navegador la recuerda como terminal habitual y, en las siguientes entradas, vuelve directamente a su caja. Si esa terminal ya no existe o está desactivada, se muestra de nuevo el selector.
4. Los agentes son opcionales. Si la terminal no tiene ninguno asignado, el TPV entra directamente sin pedir contraseña y la auditoría conserva el usuario de FacturaScripts. Si tiene agentes, toca el bloque del vendedor e introduce su PIN; al completarlo se accede sin pulsar otro botón. Para relevar al vendedor, pulsa su nombre junto a Caja y la caja permanece abierta.
5. El perfil de apertura predeterminado rellena las denominaciones de forma automática. Puedes elegir otro perfil, copiar el último cierre o cambiar cualquier cantidad antes de abrir la caja.
6. Usa el único buscador para texto, referencia o código de barras. Al pulsar Intro se intenta primero una coincidencia exacta de artículo; si no existe, se muestra claramente Referencia o producto no encontrado. El mismo campo admite códigos de vale: si no coincide con un artículo, el TPV comprueba el vale y muestra su aplicación encima del carrito. La portada muestra una carpeta Familias junto a todos los productos, tengan o no familia. Al entrar aparecen las familias como carpetas y una carpeta Sin familia para los artículos no clasificados; al tocar una se muestran sus productos y subfamilias. Volver sube un nivel sin borrar el carrito.
7. Ajusta las cantidades, precio o descuento según los permisos configurados. Los precios con impuestos respetan el régimen fiscal del cliente; el recargo de equivalencia solo aparece cuando corresponde y coincide con el documento. En modo variantes, + Detalle muestra los atributos, stock, observaciones y precio de la referencia concreta antes de añadirla. Si la terminal lo permite, Línea añade un concepto indicando descripción, impuesto y precio final.
8. Escribe en el autocompletado nativo de cliente para filtrar por nombre, razón social, código, NIF/CIF, email o teléfono. El selector y el menú Caja se cierran al pulsar fuera. Si abandonas una búsqueda sin elegir resultado, vuelve a mostrarse el cliente seleccionado. Para usar un cliente nuevo, pulsa el botón de persona con + y completa razón social, tipo de persona, identificación fiscal, dirección, apartado, código postal, ciudad, provincia, país, teléfono y email. Si el número fiscal o el email ya existen, el TPV selecciona el cliente encontrado sin duplicarlo. Al terminar la venta vuelve automáticamente al cliente predeterminado de la terminal.
9. Un vale de descuento reduce el total real del documento y solo puede usarse una vez. Puede estar limitado a un cliente y a una fecha de caducidad. Un vale de devolución conserva saldo: al escanearlo, el TPV asigna hasta el saldo disponible a Vale de tienda y deja el resto en efectivo.
10. En el diálogo compacto de cobro elige Factura o Albarán, la serie y reparte el importe entre las formas de pago disponibles. En efectivo puedes indicar el dinero entregado: el TPV calcula el cambio y solo suma a caja el efectivo neto.
11. Añade, si lo necesitas, el número o referencia del cliente y notas. Si la terminal tiene permiso, Guardar sin cobrar crea el documento pendiente sin mover efectivo ni imprimir ticket.
12. Para cobrar una factura, albarán o presupuesto ya existente, abre Tickets → Pagar documentos, filtra o busca el documento, selecciónalo y reparte el importe entre las formas de pago de la terminal. Los albaranes y presupuestos se transforman en factura; la operación no vuelve a sumar la venta al total documental de caja.
13. Para devolver una factura cobrada, abre Tickets, pulsa la acción Devoluciones, indica la cantidad de cada línea y revisa la forma de reembolso propuesta. El selector Cant. devolución permite marcar ninguna o todas las líneas. Confirma la operación para crear una factura rectificativa; la factura original no se modifica y el efectivo reembolsado sale de la caja abierta. Cuando ya se han devuelto todas sus líneas, el histórico marca la operación original como Rectificada y conserva sus importes para el cierre de caja. En Opciones avanzadas, si marcas Emitir vale de devolución, no sale efectivo: el ticket imprime un código de barras por el importe devuelto.
14. Al terminar, elige ticket Normal o Regalo y el número de copias. Desde el mismo diálogo puedes reimprimir el ticket, abrir el cajón, enviar el ticket a la impresora asignada, abrir el PDF de la factura en el navegador o descargarlo. El PDF no entra en la cola térmica de beplySync. Cada reimpresión queda enlazada al trabajo original y nunca vuelve a crear la venta ni la factura.
15. Consulta el histórico cuando lo necesites. Su diálogo ancho permite filtrar y muestra referencia, notas, desglose del pago y cambio; la acción de impresión abre las mismas opciones.

Al cerrar la caja se mantiene la terminal habitual y se vuelve directamente a Dinero inicial para la siguiente apertura. Para usar otra, elige Cambiar terminal en el menú Caja o en la pantalla de apertura; la siguiente terminal elegida pasa a ser la habitual de ese navegador. No es necesario cerrar la caja anterior: cada terminal conserva su propia caja abierta y, al volver a ella, el TPV recupera esa sesión sin mezclar ventas ni movimientos. Una terminal continúa admitiendo una sola caja abierta; otro dispositivo solo puede tomarla cuando la terminal permite compartir caja.

Configurar perfiles de apertura

1. Abre Administrador → TPV → Perfiles de apertura.
2. Crea el perfil, elige la terminal e indica la cantidad habitual de cada moneda y billete.
3. Marca Predeterminado para que el TPV lo cargue al elegir esa terminal. Solo puede quedar un perfil predeterminado por terminal.
4. Los importes son una ayuda editable: el agente puede corregir cualquier denominación antes de abrir. El último cierre permanece como alternativa. El perfil predeterminado se aplica sin mostrar un aviso; el aviso solo aparece cuando eliges otro perfil manualmente.

Consultar la actividad desde administración

Todas estas pantallas son subpáginas nativas de Administrador → TPV:

• Cajas muestra Apertura, Cierre, Terminal, Usuario, Agente, Inicial, Final, Ventas y Estado. La ficha es de solo lectura y agrupa sus tickets y movimientos.
• Movimientos de caja muestra Tipo, Motivo, Importe, Agente, Forma de pago y Fecha. Los tipos aparecen como Entrada, Salida, Venta o Devolución. Al pulsar una fila se abre la caja asociada en su subpágina de movimientos.
• Historial de tickets muestra Código, Operación, Cliente, Agente, Fecha, Entregado, Cambio y Total. Cada fila abre una ficha de consulta con accesos al documento de FacturaScripts, la caja, los movimientos y el ticket enviado.
• Cola de impresión muestra el código del documento, los nombres de la impresora y la terminal, título, formato, copia, impreso, estado, intentos y fecha. Cada fila abre el contenido exacto enviado a beplySync y sus datos de diagnóstico, sin permitir modificarlo.
• Impresoras muestra Nombre, Caracteres por línea, Última conexión, Número de tickets y Activa. El contador incluye únicamente trabajos de tipo ticket.

En Ventas → Vales, los estados y tipos aparecen traducidos. En Usos y devoluciones la fila completa no navega: solo el código de la columna Documento abre la factura o el albarán donde se aplicó el descuento o el saldo devuelto.

Configurar vales

1. En Administrador → TPV, edita la terminal y selecciona una Forma de pago para vales que también esté activa en la subpágina de formas de pago de esa terminal.
2. En Ventas → Vales puedes crear un vale porcentual manual, asignarlo opcionalmente a un cliente y fijar su caducidad.
3. Los vales originados por una devolución se crean automáticamente. Su ficha conserva documento de origen, usuario, agente, terminal y caja; la subpágina Usos y devoluciones muestra cada descuento o consumo de saldo.

No uses la forma de pago de vales manualmente: el TPV exige escanear el código para validar estado y saldo. Solo se admite un vale por venta.

La venta usa el cliente generico MOSTRADOR y los valores locales por defecto de almacen, serie y forma de pago.

Conectar beplySync

1. En Administrador → TPV → Impresoras, crea una impresora por cada ordenador que tenga su propio hardware.
2. Edita la terminal y selecciona la impresora que corresponde a ese equipo. Dos terminales pueden compartir impresora deliberadamente, pero entonces sus trabajos saldrán por el mismo ordenador.
3. En la subpágina Aplicación o Imprimir, descarga el instalador de Windows y copia la URL de FacturaScripts y la clave de conexión.
4. En beplySync, abre Tickets, elige la impresora térmica de Windows, pega la URL y la clave y pulsa Probar conexión API. El ID de impresora se obtiene automáticamente.
5. Activa la impresión automática. El mismo módulo ejecuta la secuencia local configurada para abrir el cajón.

Cada clave pertenece a una sola impresora lógica. Un ordenador configurado con la clave de la terminal 1 no puede listar ni confirmar los trabajos de la terminal 2. El servicio WebSocket solo avisa de que hay actividad; después cada equipo consulta su propia cola autenticada. Si el socket no está disponible, beplySync continúa mediante polling.

No pegues la clave en tickets o documentación. Para sustituir un ordenador o revocar una clave expuesta, abre la ficha de la impresora y, en Aplicación, pulsa Regenerar clave. FacturaScripts pide confirmación y la clave anterior deja de autenticar inmediatamente; copia la nueva únicamente en el equipo que debe consumir esa cola. La rotación no modifica otras impresoras, terminales ni trabajos pendientes.

Dependencia de conexión

Después de abrir el TPV una vez con conexión, el equipo conserva de forma local el programa, terminal, catálogo, clientes ya descargados, caja, carrito y operaciones pendientes. Si Internet falla y se recarga la página, vuelve a la misma terminal y caja sin perder el carrito. El menú superior de FacturaScripts permanece visible para no cambiar el diseño, pero queda desactivado hasta que vuelve la conexión; el TPV sigue operativo.

Una venta realizada sin conexión se guarda antes de imprimir y muestra un comprobante provisional que indica que todavía no es una factura definitiva. Al recuperar Internet se envía automáticamente con el mismo identificador; FacturaScripts crea el documento una sola vez aunque el navegador o beplySync repitan el envío. El efectivo queda confirmado en la caja local. Los pagos de tarjeta se conservan como declarados y los proveedores de pago online quedan pendientes de conciliación.

FacturaScripts prepara de forma invisible una autorización offline temporal para este usuario, equipo, terminal y agente. beplySync presenta esa autorización al sincronizar: conocer la clave de una impresora no basta para crear operaciones en nombre de otro usuario. Cambiar la contraseña, desactivar el usuario o retirar el agente/terminal invalida el acceso correspondiente.

La impresión intenta primero beplySync en el propio equipo y usa la cola remota como respaldo. El usuario solo ve un punto de estado en el pie del catálogo: verde significa preparado, amarillo que hay operaciones pendientes o se está usando el respaldo y rojo que no se puede imprimir. Al pulsarlo aparece una guía breve. La primera autorización solo se solicita al pulsar Preparar impresión; el navegador muestra su permiso nativo para acceder a la red local. BeplyTPVTienda busca el servicio local automáticamente entre 127.0.0.1:8089 y 127.0.0.1:8098, recuerda el puerto correcto y descarta cualquier otro programa que responda en ese rango sin identificarse como una versión compatible de beplySync. BeplySync autoriza exactamente el origen configurado en su URL de FacturaScripts, por lo que no hay que recompilarlo al crear un cliente nuevo. Cada ticket, reimpresión y apertura de cajón identifica también la impresora lógica seleccionada en la terminal actual. Al cambiar de terminal, beplySync resuelve de nuevo esa impresora hacia su dispositivo físico; no reutiliza una impresora global. Si la aplicación local aún no admite este enrutado, el TPV no le entrega una orden ambigua y usa la cola remota.

Que beplySync esté conectado no basta para imprimir si la terminal no tiene una impresora lógica seleccionada. En ese caso el estado queda en amarillo y muestra Este terminal no tiene impresora asignada. Asigna una desde la ficha de la terminal; un canal local o remoto activo no sustituye esta configuración.

Si no hay Internet y tampoco acceso a beplySync, el TPV conserva el carrito pero no finaliza el cobro: vuelve a mostrar la preparación de impresión cada vez que se intenta cobrar o abrir el cajón. Abre beplySync y concede el permiso para continuar. Con Internet, este permiso no bloquea la venta porque la cola remota actúa como respaldo. Una orden física nunca se repite automáticamente si su resultado quedó desconocido tras un cierre inesperado.

Limitaciones deliberadas:

• el equipo debe haber abierto el TPV al menos una vez con conexión;
• los vales requieren conexión para impedir doble consumo entre terminales;
• el alta de cliente, cobro de documentos pendientes y devoluciones requieren autoridad central;
• aparcar, recuperar o eliminar carritos requiere conexión; si falla, la venta actual no se modifica;
• un comprobante offline no sustituye la factura definitiva hasta que se sincroniza.

Alcance actual

Esta versión incluye alta rápida de clientes con deduplicación, selección de variantes con atributos, composiciones web para escritorio, tableta y móvil y operación local-first de caja/venta, además de integración multiequipo con beplySync externo. La accesibilidad exhaustiva y la aceptación con impresora y cajón físicos continúan fuera del alcance actual.