Autor: Sergi Santamaria

Pagos con Dojo: en mesa (PAT) y en mostrador (PAC) Conexión API REST

Pagos con Dojo en mesa y en mostrador — Glop (Manual para soporte)

Datáfono Dojo Glop TPV Api de Glop   Manual para soporte — Julio 2026

En pocas palabras: el datáfono de Dojo cobra las cuentas de Glop de dos maneras. En mesa (Pay at Table) el camarero elige la mesa en el propio datáfono, que consulta las cuentas de Glop. En mostrador (Pay at Counter) es al revés: el cajero elige el ticket en el TPV y Glop manda el cobro al datáfono, que solo pide la tarjeta. Todo se configura en el TPV con una única clave de Dojo (el Token API), y el pago siempre queda registrado en Glop.
⚠️ Alcance de este manual: cubre la conexión con Dojo por API REST (el modo actual). Existe también una conexión antigua por WebSocket, que se comporta de forma distinta y no se documenta aquí. En la configuración del TPV, asegúrate de que el Tipo de conexión esté en API REST (ver sección 5).

Contenido

1. ¿Qué es y para qué sirve?

Es la forma de cobrar con el datáfono de Dojo usando las cuentas que ya están abiertas en Glop, sin volver a marcarlas. Cubre las dos situaciones habituales en hostelería:

  • Pago en mesa (PAT, Pay at Table): el camarero lleva el datáfono a la mesa, elige esa mesa en la pantalla del datáfono (que consulta las cuentas de Glop) y cobra allí mismo.
  • Pago en mostrador (PAC, Pay at Counter): el cliente paga en la barra o el mostrador; el cajero elige el ticket en el TPV y Glop manda el importe al datáfono, que solo pide la tarjeta.
Idea clave: la gran diferencia es quién empieza el cobro y dónde se elige la cuenta. En mesa, en el datáfono. En mostrador, en el TPV. En ambos casos las cuentas y el registro del pago viven en el TPV de Glop.

2. Las piezas del sistema

PiezaQué hace
Datáfono DojoEl aparato que cobra la tarjeta. En mesa muestra la lista de cuentas para elegir; en mostrador solo pide la tarjeta cuando el TPV le manda el cobro.
Dojo (la nube de Dojo)El servicio de Dojo por el que pasan las peticiones entre el datáfono, el TPV y la Api de Glop.
Api de GlopEl puente que usa Dojo para leer las cuentas de Glop (en el pago en mesa). Devuelve las mesas, los importes y el resultado.
TPV GlopDonde viven las cuentas, las mesas y los cobros. Aquí se configura Dojo y aquí queda registrado el pago. En mostrador, es quien lanza el cobro al datáfono.

4. Diferencias entre mesa (PAT) y mostrador (PAC)

 Pago en mesa (PAT)Pago en mostrador (PAC)
Quién empieza el cobroEl datáfono: pide las cuentas a Glop.El TPV: manda el cobro al datáfono.
Dónde se elige la cuentaEn la pantalla del datáfono.En el TPV (táctil del mostrador).
Qué muestra el datáfonoLa lista de mesas/cuentas para elegir.Solo la pantalla de tarjeta (no hay lista).
Qué hay que registrar en DojoLa integración de lectura de cuentas (sección 5.3) + activar Pay at Table en el aparato.Elegir el datáfono por defecto del TPV (sección 5.4).
Dónde queda el cobroEn el TPV de Glop, igual en ambos.

5. Configuración en el TPV

Todo se configura en el TPV, en Terminales > pestaña Dojo. Esa pestaña tiene a su vez dos apartados: «Pago en Mostrador (PAC)» y «Pago en Mesa (PAT)».

Pestaña Dojo en Terminales, con los apartados «Pago en Mostrador (PAC)» y «Pago en Mesa (PAT)»
Pestaña Dojo en Terminales, con los apartados «Pago en Mostrador (PAC)» y «Pago en Mesa (PAT)».

5.1. Activar Dojo

Se marca la casilla de activación de Dojo (es la misma para mesa y mostrador). Requiere tener contratado el módulo Dojo: si no, el TPV la desmarca y avisa de que hay que contratarlo.

Importante: el pago en mesa (PAT) en modo API REST necesita además licencia Cloud. Si no la hay, el TPV lo pasa automáticamente a la conexión antigua (WebSocket) y avisa.

5.2. La credencial: el Token API

Es la clave que hay que introducir sí o sí, y sirve tanto para mesa como para mostrador.

  • Token API: aquí se pega la clave secreta de Dojo (empieza por sk_). Es la que usa todo el cobro por API REST y es la misma para mesa y para mostrador: al ponerla en un apartado, se refleja en el otro.
  • Entorno automático según la clave: si empieza por sk_sandbox_ el TPV trabaja en pruebas; si empieza por sk_prod_ trabaja en real. No hay que tocar nada más para cambiar de entorno: depende del token.
  • Tipo de conexión: API REST o WebSocket. Se elige por separado para mostrador y para mesa. Para el flujo actual (el de este manual) se usa API REST.
  • Imprimir en Pocket: opción para imprimir el comprobante en datáfonos Dojo Pocket.
  • Los campos «Api Key» y «Cuenta cliente» pertenecen a la conexión antigua (WebSocket); con API REST no se usan.
Cuidado con el entorno: una clave sk_prod_ hace cobros reales. Con sk_sandbox_ los cobros son de prueba y no tienen validez. Asegúrate de poner la clave correcta según si es una instalación de pruebas o de producción.

5.3. Registrar el pago en mesa (PAT) en Dojo

Para que el datáfono pueda leer las cuentas de Glop, hay que dar de alta la integración en Dojo. Son dos cosas:

1 Registrar la integración. El TPV lo hace solo al Guardar la pantalla de Terminales, si el pago en mesa está activo, en modo API REST y con el Token API puesto. También hay un botón «Registrar en Dojo» en el apartado de mesa para hacerlo a mano; al terminar muestra «Capabilities de Pago en Mesa registradas correctamente en Dojo» o el error. Se puede repetir sin riesgo (no duplica nada).
2 Activar Pay at Table en el datáfono. En el propio aparato Dojo: Settings > Integrated payments > (código de supervisor) > Pay at Table > Enable. El datáfono no lleva ni la dirección ni las claves de Glop: eso vive en el registro anterior.

5.4. Elegir el datáfono por defecto del mostrador

Para el pago en mostrador, el TPV necesita saber a qué datáfono mandar el cobro. Eso se elige en la misma pantalla de Terminales:

1 Traer los datáfonos. Con el botón «Refrescar» se importan los datáfonos de la cuenta de Dojo (también se cargan solos al abrir la pestaña). Cada uno aparece con un alias para reconocerlo.
2 Marcar el que será el de este TPV. Se marca la casilla «ACTIVO» en el datáfono elegido. Solo puede haber uno activo por terminal: al marcar uno, los demás se desmarcan solos.
Idea clave: el datáfono con la casilla ACTIVO es el que recibirá los cobros de mostrador de ese TPV. Mientras esté encendido y disponible, el cobro va directo sin preguntar. Si no está disponible, el TPV te dejará elegir otro (ver sección 7).

6. Cobrar en mesa (PAT), paso a paso

Cuando el camarero cobra en la mesa, el sistema hace esto solo:

1 Busca las cuentas vivas. Solo muestra las cuentas abiertas y con importe pendiente. Las ya cobradas del todo y los abonos no aparecen.
2 Pone el nombre a cada mesa. Traduce cada cuenta a algo legible, como «Mesa 3 Salón Glop», leyendo el nombre real del TPV.
3 Bloquea la cuenta mientras se cobra. Al empezar, esa mesa queda reservada para que otro empleado no la cobre a la vez. Al terminar, se libera.
4 Registra el pago en Glop. Cuando la tarjeta se cobra, Glop apunta el importe en la cuenta.
Cobros parciales: no hace falta cobrar toda la cuenta de golpe. Si se cobran 20 € de una cuenta de 50 €, la siguiente vez el datáfono mostrará 30 € pendientes (lo que queda, no el total). Cuando la cuenta llega a cero, deja de aparecer.

7. Cobrar en mostrador (PAC): elección del datáfono

En mostrador, el cajero elige el ticket en el TPV y pulsa cobrar con Dojo. Antes de mandar el cobro, el TPV decide a qué datáfono enviarlo:

1 Mira el datáfono por defecto. El que tiene marcada la casilla ACTIVO en Terminales (sección 5.4).
2 Comprueba si está disponible en Dojo en ese momento.
3 Envía el cobro:
  • Si el datáfono por defecto está disponible → le manda el cobro directamente, sin preguntar.
  • Si no está disponible (apagado, ocupado, sin conexión) → en un TPV táctil aparece una lista con los datáfonos disponibles para elegir uno. En un TPV de autoservicio (kiosko), como no hay nadie para elegir, avisa de que el datáfono no está disponible.
Diálogo del TPV para elegir datáfono cuando el de por defecto no está disponible
Ventana del TPV para elegir datáfono cuando el de por defecto no está disponible.

8. Si el datáfono no está disponible o no responde

No hay conexión con Dojo

Antes de lanzar el cobro, el TPV comprueba que puede hablar con Dojo. Si no hay conexión, muestra: «Sin conexión con la pasarela Dojo. No podemos contactar con el servicio de pago con tarjeta. Reintente o cierre para usar otra forma de pago», con botones Reintentar y Cerrar. Al cerrar, se puede cobrar de otra forma (metálico, otra tarjeta, etc.).

Tiempo de espera agotado

Si el datáfono no responde a tiempo (por defecto, unos 2 minutos), el TPV avisa: «Tiempo de espera agotado. No hemos recibido respuesta del datáfono», y ofrece:

  • Comprobar en el datáfono si el cobro se completó.
  • Si sí se completó → pulsar Aceptar para registrarlo en Glop.
  • Si no → pulsar Cancelar y volver a intentarlo (o cobrar de otra forma).
Muy importante: ante un «tiempo de espera agotado», el cobro puede haberse realizado igualmente. Hay que mirar el datáfono antes de reintentar, para no cobrar dos veces al cliente.

Verificar un pago que quedó pendiente

Si una venta se quedó con un cobro Dojo sin confirmar (típico tras un «tiempo de espera agotado» en autoservicio), al recuperar ese ticket el TPV avisa: «Pago Dojo pendiente de verificar», con las opciones Verificar o Después. Al Verificar, el TPV pregunta a Dojo y según el estado dice qué hacer:

Estado en DojoQué indica el TPV
CobradoEl pago está hecho: cerrar la venta como cobrada con Dojo. Muestra el importe y el código de autorización.
DevueltoEl pago se devolvió: cancelar el documento o reintentar.
CaducadoComprobar en el datáfono: si figura el cobro, cerrar la venta a mano; si no, cancelar y reintentar.
No completadoDojo no tiene constancia del cobro: se puede cobrar el documento normalmente (por ejemplo, en metálico).
Nota: el TPV no cierra la venta solo en este caso; solo informa. La decisión final (cobrar con Dojo, en metálico, o anular) es del empleado.

9. Devoluciones

Una devolución (reembolso al cliente) se gestiona con el datáfono Dojo y se lanza siempre en modo pago en mostrador (PAC): es el TPV el que envía la devolución al datáfono, igual que en un cobro de mostrador.

10. Dos empleados sobre la misma cuenta

Si dos personas intentan cobrar la misma mesa a la vez, el bloqueo (sección 6) lo impide: mientras uno la está cobrando, la cuenta queda reservada y el otro no puede entrar hasta que se libere.

11. Resolución de problemas (soporte)

SíntomaQué comprobar
«Sin conexión con la pasarela Dojo» al cobrar. No hay internet o el servicio de Dojo no responde. Reintentar; si sigue, cobrar de otra forma y revisar la conexión del local.
«Tiempo de espera agotado» en un cobro. Mirar el datáfono para ver si el cobro se hizo antes de reintentar. Si se hizo, Aceptar para registrarlo; si no, Cancelar y repetir. Así se evita el doble cobro.
En mostrador, sale la lista para elegir datáfono cada vez. El datáfono por defecto no está disponible (apagado/ocupado/sin conexión) o no hay ninguno marcado. Encenderlo, o marcar la casilla ACTIVO del datáfono correcto en Terminales (sección 5.4).
«Este terminal no tiene un datáfono Dojo por defecto». Ir a Terminales > Dojo, Refrescar y marcar ACTIVO en el datáfono que debe usar ese TPV.
«No hay datáfonos Dojo disponibles». Ningún datáfono responde ahora mismo. Encender el aparato, esperar unos segundos y usar «Refrescar».
En mesa, no aparece ninguna cuenta en el datáfono. Revisar que el datáfono tiene Pay at Table activado, que la integración está registrada en Dojo (sección 5.3) y que el TPV está encendido y con conexión.
Una mesa concreta no aparece. Debe estar abierta y con importe pendiente. Las cobradas del todo y los abonos no salen.
El pago en mesa da error al registrar en Dojo. Comprobar que está el Token API puesto y que la licencia tiene las credenciales del comercio. Recordar que el PAT en API REST exige licencia Cloud.
Los cobros salen como de prueba (o al revés). Es por el Token API: sk_sandbox_ = pruebas, sk_prod_ = real. Poner la clave del entorno correcto.
El nombre de la mesa sale como un número raro. No se pudo leer el nombre real (TPV apagado, sin conexión o mesa sin número configurado). El datáfono muestra un identificador interno como respaldo; el cobro funciona igual.

12. Preguntas frecuentes

¿Qué clave hay que meter y dónde?

El Token API de Dojo (empieza por sk_), en Terminales > Dojo. Es la misma para mesa y para mostrador.

¿Cómo sé si estoy en pruebas o en real?

Por el principio del Token API: sk_sandbox_ = pruebas, sk_prod_ = real. No hay otro interruptor.

¿Cómo elijo el datáfono del mostrador?

En Terminales > Dojo, con «Refrescar» para traer los datáfonos y marcando la casilla ACTIVO en el que quieras. Solo uno por terminal.

¿Y si ese datáfono está apagado?

En un TPV táctil, el TPV te deja elegir otro de los disponibles. En autoservicio, avisa de que no hay datáfono disponible.

¿El datáfono guarda las cuentas?

No. En el pago en mesa las pide a Glop en tiempo real; por eso el TPV debe estar disponible.

¿Es lo mismo «pago en mesa» que «pago en mostrador»?

No. En mesa el camarero elige la cuenta en el datáfono; en mostrador el cajero la elige en el TPV y el TPV manda el cobro al datáfono. El resultado es el mismo, pero el camino es el contrario.

¿Puedo cobrar solo una parte de la cuenta?

Sí. El resto queda pendiente y se puede cobrar después.

Glop — Pagos con Dojo en mesa (PAT) y en mostrador (PAC) — Manual para soporte — Julio 2026

Glop Pay: cobro con QR (pasarela Dojo) Conexión API REST

Glop Pay: cobro con QR (Dojo) — Glop (Manual para soporte)

Glop TPV Api de Glop Dojo   Manual para soporte — Julio 2026

Glop Pay: cobro con QR (pasarela Dojo)

En pocas palabras: Glop Pay permite cobrar mostrando un QR que se puede presentar de varias formas: en la pantalla del TPV, en el GlopDroid o impreso en el justificante. El cliente lo escanea con su móvil y paga online en una página segura de Dojo (tarjeta y, si están activados, Apple Pay o Google Pay). No hace falta datáfono físico: el móvil del cliente es el «datafono». Cuando el cliente paga, el TPV cierra e imprime el ticket solo.
No confundir: esto es el pago online por QR (enlace de pago de Dojo). Es distinto del datáfono físico Dojo (pago en mesa/mostrador), que tiene su propio manual. Aquí no interviene ningún aparato: solo el TPV y el móvil del cliente.

Contenido

1. ¿Qué es y para qué sirve?

Glop Pay es una forma de cobro del TPV que, en lugar de pasar la tarjeta por un datáfono, genera un QR que el cliente escanea con su móvil para pagar online. El pago lo procesa Dojo en una página segura suya.

Sirve, por ejemplo, para:

  • Cobrar sin datáfono físico o cuando el datáfono está ocupado.
  • Que el cliente pague cómodamente desde su teléfono (tarjeta, Apple Pay, Google Pay si están activados).
  • Mostrar el QR en el display orientado al cliente del TPV o imprimirlo en el justificante para que el cliente lo escanee del ticket.

2. Las piezas del sistema

PiezaQué hace
TPV GlopGenera el QR de cobro, lo muestra y, cuando el cliente paga, cierra e imprime el ticket. Aquí se configura Glop Pay.
Api de GlopEl puente que prepara el enlace de pago con Dojo y avisa al TPV cuando el cobro se ha hecho.
DojoLa pasarela de pago. Muestra al cliente la página de pago y procesa la tarjeta.
Móvil del clienteEscanea el QR y paga en la página de Dojo.

3. Configuración en el TPV

Hay que dejar preparadas dos cosas: la pasarela (Dojo, con su clave) y la forma de cobro «Glop Pay» para que aparezca al cobrar. Todo requiere las licencias Glop Pay y Glop Api Rest (sin ellas, la pestaña no se habilita o el cobro no se arma).

3.1. Elegir la pasarela Dojo e introducir la API Key

En Terminales > pestaña Glop Pay:

1 Elegir la plataforma «Dojo». En el selector de plataforma de Glop Pay, marcar Dojo (las otras opciones son otras pasarelas).
2 Introducir la API Key de Dojo. Al elegir Dojo, aparece un campo «API Key de Dojo»: ahí se pega la clave de Dojo (empieza por sk_).
IMPORTANTE — los pagos online necesitan aprobación previa de Dojo: a diferencia del pago en mesa y del pago en mostrador (datáfono físico), donde basta con poner la API Key que ya tiene el cliente, en Glop Pay QR (pagos online / Dojo web) no vale con poner sin más la API Key. Hay que ponerse en contacto con Dojo: los pagos online requieren una aprobación previa del departamento de riesgos de Dojo antes de poder cobrar. Sin esa aprobación, aunque la clave esté puesta, los cobros online no funcionarán.
Cuidado con el entorno: la clave marca si los cobros son reales o de prueba. sk_prod_… = cobros reales; sk_sandbox_… = pruebas (sin validez). Poner la clave correcta según sea una instalación de producción o de pruebas.
Buena noticia: no hay que configurar nada más en Dojo. Al guardar, el sistema deja todo preparado automáticamente por comercio (la conexión para recibir el aviso de pago se auto-configura). Solo hay que poner la API Key.
No es el datáfono Dojo: esta pantalla (plataforma de Glop Pay = Dojo) configura el pago online por QR. El datáfono físico Dojo se configura en otra pestaña distinta y tiene su propio manual.
Pestaña Glop Pay en Terminales con plataforma «Dojo» y el campo «API Key de Dojo»
Pestaña Glop Pay en Terminales, con la plataforma «Dojo» y el campo «API Key de Dojo».

3.2. Configurar la forma de cobro «Glop Pay»

Para que Glop Pay aparezca como opción al cobrar, tiene que existir una forma de cobro asociada a Glop Pay. Se configura en el mantenimiento de formas de cobro de Glop:

1 Crear o editar una forma de cobro (por ejemplo, una llamada «Glop Pay» o «QR»).
2 Marcarla como Glop Pay. Activar la casilla que la asocia a Glop Pay (es la que hace que, al usarla, el TPV genere el QR en lugar de registrar un cobro normal).
3 Guardar. A partir de ahí esa forma de cobro aparece en la pantalla de cobro y, al elegirla, lanza el pago con QR de Dojo.
Idea clave: una cosa es la pasarela (Dojo + API Key, apartado 3.1) y otra la forma de cobro (el botón que ve el cajero, apartado 3.2). Hacen falta las dos: la pasarela dice «con quién se cobra» y la forma de cobro es «el botón para cobrar».
Mantenimiento de formas de cobro con la casilla de «Glop Pay» activada
Mantenimiento de formas de cobro con la casilla de «Glop Pay» activada.

4. Cómo se cobra, paso a paso

1 Elegir Glop Pay como forma de pago en la pantalla de cobro, por el importe a cobrar.
2 El TPV presenta el QR. Puede aparecer en una ventana grande en pantalla, en el display orientado al cliente (si el TPV lo tiene) y/o impreso en el justificante, para que el cliente lo escanee del ticket en papel.
3 El cliente escanea el QR (de la pantalla o del justificante impreso) con su móvil y paga en la página de Dojo.
4 Al confirmarse el pago, el TPV cierra el ticket, lo imprime y la ventana del QR se cierra sola (suena un aviso).

5. Qué ve el cliente

Al escanear el QR, el móvil abre la página de pago de Dojo. Ahí el cliente paga con tarjeta y, además, se ofrecen siempre Apple Pay y Google Pay (aparecen automáticamente según el móvil del cliente: Apple Pay en iPhone, Google Pay en Android). Al terminar, ve la confirmación del pago.

6. Confirmación y cierre automático

El TPV no se queda esperando bloqueado: mientras el QR está en pantalla, va comprobando con la Api de Glop si el pago ya se ha hecho. En cuanto Dojo confirma el cobro:

  • El TPV cierra el ticket y lo pasa a histórico.
  • Lo imprime y suena un aviso.
  • La ventana del QR se cierra sola dando el cobro por bueno.

7. Cancelar un cobro

La ventana del QR tiene un botón Cancelar. Al pulsarlo, el TPV pide confirmación y, si se acepta, anula la petición de pago y no se cobra nada. El ticket queda como estaba (abierto), listo para cobrar de otra forma.

8. Devoluciones

Una devolución de un cobro hecho con Glop Pay (Dojo) se lanza desde el TPV. Se admite devolución total o parcial (por ejemplo, devolver solo algunos artículos), y se pueden hacer varias devoluciones parciales sobre el mismo cobro.

9. Resolución de problemas (soporte)

SíntomaQué comprobar
Al elegir Glop Pay no se genera el QR. Revisar que la API Key de Dojo está puesta, que la plataforma es Dojo, que la forma de pago está configurada correctamente, que hay licencia Glop Pay y Glop Api Rest y que el TPV tiene conexión a internet.
El cliente escanea y le da error al pagar. Comprobar el entorno de la clave: sk_sandbox_ hace pagos de prueba; para cobros reales debe ser sk_prod_. Verificar también que el comercio está activo en Dojo.
Los cobros salen como de prueba (o al revés). Es por la API Key: sk_sandbox_ = pruebas, sk_prod_ = real. Poner la del entorno correcto.
El cliente cierra el móvil sin pagar. No pasa nada: el ticket sigue abierto. Cancelar el QR en el TPV (botón Cancelar) y cobrar de otra forma o reintentar.

10. Preguntas frecuentes

¿Hace falta datáfono?

No. El cliente paga con su móvil escaneando el QR. El pago lo procesa Dojo online.

¿Qué clave hay que meter y dónde?

La API Key de Dojo (empieza por sk_), en Terminales > Glop Pay, con la plataforma puesta en Dojo.

¿Cómo sé si estoy en pruebas o en real?

Por el principio de la clave: sk_sandbox_ = pruebas, sk_prod_ = real.

¿El QR caduca?

No caduca solo. Permanece hasta que el cliente paga o hasta que se cancela a mano en el TPV.

¿Con qué puede pagar el cliente?

Con tarjeta, y con Apple Pay o Google Pay, que se ofrecen siempre y aparecen según el móvil del cliente (Apple Pay en iPhone, Google Pay en Android).

¿Esto es el datáfono Dojo de las mesas?

No. Esto es el pago online por QR. El datáfono físico Dojo (pago en mesa/mostrador) es otra cosa y tiene su propio manual.

Glop — Glop Pay: cobro con QR (pasarela Dojo) — Manual para soporte — Julio 2026

Pide y Paga (pago desde el móvil, pasarela Dojo) Conexión API REST

Pide y Paga (pasarela Dojo) — Glop (Manual para soporte)

Pide y Paga Web (WooGlop) Glop TPV Dojo   Manual para soporte — Julio 2026

Pide y Paga (pago desde el móvil, pasarela Dojo)

En pocas palabras: Pide y Paga permite que el propio cliente pida y/o pague desde el móvil, sin llamar al camarero. Llega a la web de la carta con su mesa identificada (normalmente por un QR pegado en la mesa). Si la mesa no tiene nada, puede pedir; si la mesa ya tiene consumo abierto, puede volver a pedir o pagar su cuenta. Al pagar, se le lleva a una página segura de Dojo; el TPV se entera solo y cierra la mesa.
Idea clave: Pide y Paga no calcula la cuenta: paga la que ya está abierta en el TPV. El importe y las líneas los envía el TPV a la web. Por eso el TPV tiene que estar operativo y con la mesa abierta.

Contenido

1. ¿Qué es y para qué sirve?

Pide y Paga es una capa sobre la web de la carta del comercio (WooGlop). El cliente entra en esa web con su mesa (normalmente por el QR de la mesa) y, según lo que tenga:

  • Si la mesa no tiene nada: puede pedir (navegar la carta y hacer su pedido).
  • Si la mesa ya tiene consumo abierto: puede volver a pedir (añadir más) o pagar su cuenta desde el móvil.

Sirve para:

  • Que el cliente pague sin esperar al camarero.
  • Agilizar el cobro en horas punta.
  • Ofrecer pago online (tarjeta, Apple Pay o Google Pay) sobre la cuenta real del TPV.

2. Las piezas del sistema

PiezaQué hace
Móvil del clienteAbre la web de la carta con su mesa, ve la opción de pagar y paga.
Web de la carta (WooGlop)Muestra el popup «Pagar / Pedir» y lleva al cliente a la página de pago. Aquí se configura la pasarela.
TPV GlopEs el dueño de la cuenta: envía a la web el importe y las líneas de cada mesa, y cierra la mesa cuando se paga.
Api de GlopEl puente que prepara el pago con Dojo y comunica el resultado.
DojoLa pasarela: muestra la página de pago y procesa la tarjeta.

3. Cómo lo vive el cliente

El cliente abre la web de la carta con su mesa. Lo que ve depende de si la mesa tiene o no consumo abierto:

  • Mesa sin nada: simplemente pide — navega la carta y hace su pedido, como en cualquier tienda online.
  • Mesa con consumo abierto: aparece un aviso con dos opciones:
    • Volver a pedir: seguir añadiendo a su pedido desde la carta (no cobra online; se paga en el local).
    • Pagar: le lleva a la página de pago para liquidar su cuenta actual. Al terminar, vuelve a la web.

El aviso de pagar solo aparece si se dan estas condiciones: el servicio está activo, la mesa está identificada, la mesa tiene importe pendiente, no está bloqueada por otro pago y el cliente no tiene un pedido a medias en el carrito.

Popup «¿Quieres pagar o pedir?» en la web de la carta, en el móvil
Popup «¿Quieres pagar o pedir?» tal y como lo ve el cliente en la web de la carta desde el móvil.

4. Configuración

La configuración tiene dos lados: el TPV (donde se activa Pide y Paga sobre la carta digital, se crea la forma de cobro y se generan los QR de mesa) y la web (donde se elige la pasarela Dojo). Antes de empezar, la instalación debe tener las licencias Pide y Paga, Glop Pay y Api Rest; sin ellas, las opciones no aparecen.

4.1. En el TPV: activar Pide y Paga en la carta digital

Pide y Paga se activa sobre una carta digital. En el TPV, en Terminal > URLs de cartas digitales:

1 Dar de alta la URL de la carta digital (botón de añadir), o usar la que ya exista.
2 Marcar la casilla ACTIVA de esa carta.
3 Marcar la casilla de la columna «PIDE & PAGA».
Ojo: solo puede haber una carta digital con «Pide & Paga» activo por idioma. Si intentas marcar una segunda con el mismo idioma, el TPV lo impide y avisa.
Pantalla «URLs de cartas digitales» con las columnas ACTIVA y PIDE & PAGA
Pantalla «URLs de cartas digitales» en el TPV, con las columnas ACTIVA y PIDE & PAGA.

4.2. En el TPV: activar la pasarela Glop Pay (plataforma Dojo)

Igual que en el cobro por QR de Glop Pay, la pasarela Glop Pay tiene que estar activa en el TPV con la plataforma Dojo. En Terminales > pestaña Glop Pay:

1 Elegir la plataforma «Dojo» en el selector de plataforma de Glop Pay.
2 Introducir la API Key de Dojo (la clave que empieza por sk_).
Idea clave: es la misma pasarela Glop Pay que usa el cobro por QR. Sin ella activa y con Dojo elegido, Pide y Paga no puede lanzar el cobro online aunque la web esté configurada.

4.3. En el TPV: la forma de cobro «Glop Pay»

Para que el cobro online quede registrado en Glop, tiene que existir una forma de cobro marcada como Glop Pay. En el mantenimiento de formas de pago:

1 Crear o editar una forma de pago.
2 Marcar la casilla «Glop Pay».
3 Guardar.
Idea clave: solo puede haber una forma de pago marcada como Glop Pay, y requiere la licencia Glop Pay. Es la misma forma de cobro que usa el QR de Glop Pay: sirve para todos los cobros online por QR (Pide y Paga incluido).

4.4. En el TPV: generar e imprimir los QR de mesa

Cada mesa necesita su propio QR (el que el cliente escanea). En Mantenimiento de salones > Generar QR:

1 Elegir el salón y la carta digital.
2 Pulsar «Generar QR». Se crea un QR por cada mesa; cada uno lleva la mesa dentro, para que la web sepa a qué mesa pertenece.
3 Imprimir los QR (o exportarlos) y pegarlos en cada mesa.

4.5. En la web: elegir la pasarela Dojo y poner la API Key

En el administrador de WordPress, en la página «Pide & Paga»:

1 Elegir la pasarela «Dojo» en el selector de pasarela (las otras opciones son otras pasarelas de pago).
2 Introducir la API Key de Dojo en el campo que aparece (la clave que empieza por sk_).
IMPORTANTE — los pagos online necesitan aprobación previa de Dojo: a diferencia del pago en mesa y del pago en mostrador (datáfono físico), donde basta con poner la API Key que ya tiene el cliente, en Pide y Paga (pagos online / Dojo web) no vale con poner sin más la API Key. Hay que ponerse en contacto con Dojo: los pagos online requieren una aprobación previa del departamento de riesgos de Dojo antes de poder cobrar. Sin esa aprobación, aunque la clave esté puesta, los cobros online no funcionarán.
Cuidado con el entorno: sk_prod_… = cobros reales; sk_sandbox_… = pruebas (sin validez). Poner la clave correcta.
No hay que tocar Dojo: con solo poner la API Key, el sistema deja preparada la conexión para recibir el aviso de pago automáticamente, por comercio.
Textos que ve el cliente: en Configuraciones web > pestaña «Pide & Paga» se pueden ajustar el nombre y la descripción del método de pago, los textos de los botones «Pedir»/«Pagar» y los minutos de bloqueo de mesa.

5. El bloqueo de la mesa

Cuando un cliente va a pagar una mesa, esa mesa queda bloqueada temporalmente para que dos comensales no la paguen a la vez. El bloqueo se libera solo pasados unos minutos (configurable), o si el cliente vuelve sin pagar.

6. Devoluciones

La devolución de un cobro de Pide y Paga se gestiona desde el TPV (es el mismo pago Dojo que Glop Pay). Admite devolución total o parcial.

Nota: la factura rectificativa automática a partir de una devolución está prevista para una fase posterior; hoy la devolución del dinero funciona, pero la rectificativa puede requerir el paso manual habitual.

7. Resolución de problemas (soporte)

SíntomaQué comprobar
El cliente no ve la opción de pagar en la web. La mesa debe tener cuenta abierta con importe > 0 y estar identificada (entrar con el QR de la mesa). Además: servicio activo, mesa no bloqueada y carrito vacío. Comprobar que el TPV ha enviado los datos de esa mesa.
El importe que ve el cliente no es el correcto. El importe lo pone el TPV. Revisar la cuenta en el TPV; el dato se re-sincroniza cuando el TPV vuelve a enviar las mesas.
El cliente paga pero la mesa no se cierra. Dar unos segundos (la confirmación llega a la Api de Glop y de ahí al TPV). Revisar la conexión del TPV. Si el pago figura hecho, no volver a cobrar.
«La mesa está bloqueada» / no deja pagar. Otro comensal la estaba pagando. El bloqueo se libera solo tras unos minutos; luego se puede reintentar.
Error al pagar en la página de Dojo. Comprobar el entorno de la clave: sk_sandbox_ = prueba, sk_prod_ = real. Verificar que el comercio está activo en Dojo.

8. Preguntas frecuentes

¿Qué diferencia hay entre «Pagar» y «Pedir»?

Pagar liquida online la cuenta ya abierta en el TPV. Pedir (o volver a pedir si la mesa ya tiene consumo) es hacer o añadir un pedido desde la carta, que se paga en el local.

¿De dónde sale el importe?

Del TPV, que envía a la web el importe y las líneas de cada mesa. La web no calcula nada.

¿Qué clave hay que meter y dónde?

La API Key de Dojo (empieza por sk_), en el administrador de la web, página «Pide & Paga», con la pasarela puesta en Dojo.

¿Cómo sé si estoy en pruebas o en real?

Por el principio de la clave: sk_sandbox_ = pruebas, sk_prod_ = real.

¿Y si dos clientes intentan pagar la misma mesa?

La mesa se bloquea mientras uno paga. El otro tendrá que esperar a que se libere (unos minutos).

Glop — Pide y Paga (pasarela Dojo) — Manual para soporte — Julio 2026

Manual de Solicitar Factura mediante Código QR

GLOP TPV Solicitud Facturas — Versión 1.1 — Abril 2026

En pocas palabras: El módulo de Solicitar Factura permite que un cliente final, tras recibir su justificante o factura simplificada, pueda escanear un código QR impreso en el papel y solicitar que se le emita una factura completa con sus datos fiscales (nombre, NIF, dirección, etc.). El Glop TPV procesa automáticamente estas solicitudes y, opcionalmente, envía la factura por correo electrónico al cliente. El proceso principal es automático y no requiere intervención del personal del establecimiento, aunque también se dispone de un botón para reimprimir el QR bajo demanda.

Contenido de esta guía

1. Introducción

1.1 ¿Qué es Solicitar Factura?

El módulo de Solicitar Factura de GLOP ofrece a los clientes finales de un establecimiento la posibilidad de solicitar una factura completa con sus datos fiscales simplemente escaneando un código QR con su teléfono móvil.

Hasta ahora, si un cliente quería factura, debía solicitarla en el momento de pagar o volver al establecimiento. Con esta funcionalidad, el cliente puede hacerlo cómodamente desde su móvil en cualquier momento posterior a la compra.

El sistema se compone de tres partes que trabajan juntas:

  • Glop TPV: Imprime el código QR en los justificantes y facturas simplificadas del establecimiento, y procesa automáticamente las solicitudes recibidas.
  • Formulario web: La página donde el cliente rellena sus datos fiscales tras escanear el QR.
  • Procesamiento automático: El TPV consulta periódicamente si hay nuevas solicitudes y las gestiona sin intervención del personal.

1.2 Tres escenarios de uso

La funcionalidad cubre tres situaciones habituales:

Escenarios de solicitud de factura
EscenarioSituaciónQué ocurre
Justificante abierto El cliente recibe un justificante (cuenta sin cobrar) con QR. Escanea el QR y envía sus datos antes de pagar. El TPV asigna los datos del cliente a la cuenta. Cuando se cobre, se emitirá factura completa automáticamente en lugar de factura simplificada.
Factura simplificada cerrada El cliente ya ha pagado y tiene una factura simplificada con QR. Escanea el QR y envía sus datos después de pagar. El TPV abona la factura simplificada original y genera una nueva factura completa con los datos fiscales del cliente.
Factura completa cerrada El cliente ya ha pagado y tiene una factura completa, pero necesita modificar los datos fiscales (cambio de razón social, corrección de NIF, actualización de dirección, etc.). Escanea el QR y envía los datos corregidos. El TPV abona la factura original y genera una nueva factura completa con los datos fiscales actualizados.
Nota: El primer escenario (justificante abierto) está disponible para todas las licencias, tengan o no Cloud. El segundo escenario (factura simplificada cerrada) y el tercer escenario (modificación de factura completa) requieren licencia Cloud.

2. Requisitos previos

Antes de empezar: Verifique que su instalación de GLOP cumple con los siguientes requisitos para poder utilizar el módulo de Solicitar Factura.
RequisitoDescripciónObligatorio
Parámetro de terminal activado Cada terminal donde se desee ofrecer la solicitud de factura por QR debe tener activados los parámetros correspondientes en su configuración (ver sección 3). Obligatorio
Conexión a internet El TPV necesita conexión a internet para consultar las solicitudes pendientes en la nube y confirmar su procesamiento. Obligatorio
Licencia Cloud Para el escenario de facturas simplificadas cerradas (donde el cliente ya ha pagado), se requiere licencia Cloud. Sin ella, solo funciona el escenario de justificantes abiertos. Según escenario
Sin licencia Cloud: El escenario de justificantes abiertos funciona con cualquier licencia. Sin embargo, para el escenario de facturas simplificadas cerradas (solicitar factura después de pagar) es necesaria la licencia Cloud.

3. Configuración de parámetros en Glop

Para activar el módulo de Solicitar Factura es necesario configurar los parámetros del terminal desde el mantenimiento de terminales en Glop TPV.

3.1 Parámetros de terminal

Acceda al mantenimiento de terminales en Glop TPV. En la sección de parámetros encontrará las siguientes opciones relacionadas con Solicitar Factura:

Bloque 1: Solicitud de factura por QR en Justificantes

ParámetroFunciónRequisito
Activar solicitud de factura por QR a través de Justificantes Activa la funcionalidad en justificantes (cuentas sin cobrar). Cuando está marcado, se imprime el código QR en los justificantes y el TPV comienza a consultar periódicamente si hay solicitudes pendientes. Cualquier licencia
Obligar Factura al Solicitar Cuando un cliente ha enviado sus datos fiscales a través del QR y la cuenta aún está abierta, el sistema fuerza automáticamente que el documento de cobro sea una factura completa en lugar de una factura simplificada. El cajero no podrá cambiar el tipo de documento. Cualquier licencia
Enviar Email al Solicitar Envía automáticamente un duplicado de la factura generada por correo electrónico a la dirección que el cliente proporcionó en el formulario web. Cualquier licencia
Imprimir siempre QR en Justificante Cuando está activado, el código QR de solicitud de factura se incluye siempre integrado dentro del propio justificante, asegurando que el cliente siempre reciba el QR en el documento. Se activa automáticamente al activar el parámetro principal del bloque. Cualquier licencia

Bloque 2: Solicitud de factura por QR en Facturas Simplificadas

ParámetroFunciónRequisito
Activar solicitud de factura por QR a través de Factura Simplificada Activa la funcionalidad en facturas simplificadas ya cobradas. Permite que el cliente solicite factura completa incluso después de haber pagado. El sistema abona el documento original y genera una nueva factura. Cloud
Permitir Modificar Factura al Solicitar Permite que también se imprima el papel con QR de solicitud tras la emisión de facturas completas, para que el cliente pueda solicitar una modificación de los datos fiscales de una factura ya emitida. Cloud

3.2 Dependencia entre parámetros

Los parámetros se organizan en dos bloques independientes, cada uno con su parámetro principal:

Jerarquía de parámetros
  • Activar solicitud de factura por QR a través de Justificantes (parámetro principal bloque 1)
    • Obligar Factura al Solicitar
    • Enviar Email al Solicitar
    • Imprimir siempre QR en Justificante
  • Activar solicitud de factura por QR a través de Factura Simplificada (parámetro principal bloque 2 — solo Cloud)
    • Permitir Modificar Factura al Solicitar
Importante: Cada bloque funciona de forma independiente. Si desactiva un parámetro principal, sus parámetros dependientes se desactivarán automáticamente. El bloque 2 (Factura Simplificada) y su subparámetro solo estarán disponibles si la licencia incluye el módulo Cloud.

3.3 Configuración recomendada

Según el tipo de establecimiento y licencia, estas son las configuraciones recomendadas:

Caso de usoConfiguración
Básico: Solo quiero que los clientes puedan pedir factura antes de pagar Activar QR en Justificantes + Obligar Factura al Solicitar + Enviar Email al Solicitar (Imprimir siempre QR en Justificante se activa automáticamente)
Completo: Quiero que los clientes puedan pedir factura antes y después de pagar, y modificar datos Todos los parámetros de ambos bloques activados (Imprimir siempre QR en Justificante se activa automáticamente con el bloque 1)
Solo post-pago: Quiero que los clientes puedan pedir factura después de pagar Activar QR en Factura Simplificada + Permitir Modificar Factura
Sin email: No quiero enviar facturas por correo Activar QR en Justificantes + Obligar Factura al Solicitar (sin Enviar Email)

4. El código QR en justificantes y facturas simplificadas

4.1 Dónde aparece el QR

Una vez activada la funcionalidad, el código QR se imprime automáticamente en los documentos del establecimiento. Según el tipo de documento, aparece de dos formas distintas:

1 QR integrado en el documento: El código QR aparece directamente dentro del justificante (cuenta sin cobrar, justificante de factura, justificante servicio a domicilio), junto con un texto explicativo para el cliente.
2 Papel separado con QR: Se imprime un pequeño papel adicional justo después del documento principal, con el código QR y un mensaje invitando al cliente a solicitar su factura. Se usa en facturas simplificadas (ya cobradas) y en facturas completas.

4.2 En qué documentos se imprime

El QR se imprime en los siguientes tipos de documentos, según los parámetros activados:

Tipo de documentoParámetro necesarioTipo de QR
Justificante (cuenta sin cobrar) Activar QR a través de Justificantes QR integrado en el documento
Justificante de factura Activar QR a través de Justificantes QR integrado en el documento
Justificante servicio a domicilio Activar QR a través de Justificantes QR integrado en el documento
Factura simplificada (cobrada) Activar QR a través de Factura Simplificada Papel separado
Factura completa (cobrada) Permitir Modificar Factura al Solicitar Papel separado
Nota: Los documentos de abono nunca incluyen código QR de solicitud de factura, ya que un abono no es un documento sobre el que tenga sentido solicitar factura.

4.3 Texto del QR

El texto que acompaña al código QR es personalizable. Por defecto incluye un mensaje invitando al cliente a escanear el código para solicitar su factura. Los textos se pueden personalizar desde el archivo de configuración (ver sección 9).

4.4 Validez del QR

El código QR tiene una validez de 90 días desde la fecha de emisión del documento. Pasado este tiempo, el cliente verá un mensaje indicando que el QR ha expirado y no podrá solicitar factura.

4.5 Actualización de diseños existentes

En instalaciones nuevas, los diseños de los documentos (justificantes, facturas, etc.) ya incluyen de serie los campos necesarios para mostrar el código QR y el texto de solicitud de factura. No es necesario hacer nada adicional.

Sin embargo, en instalaciones que se actualizan desde una versión anterior, los diseños personalizados existentes no incluirán automáticamente los campos del QR. En este caso, hay dos opciones:

Opción A: Restablecer el diseño al predeterminado (recomendado)

Esta es la opción más rápida. Desde Glop, acceda al Diseñador de documentos y pulse el botón “Reestablecer informe”. Esto sustituirá el diseño actual por el diseño predeterminado, que ya incluye los campos del QR.

1 Acceda al Diseñador de documentos en Glop.
2 Seleccione el diseño del documento que desea restablecer (por ejemplo, “Justificante”).
3 Pulse el botón “Reestablecer informe”.
4 Confirme la acción en el diálogo de confirmación.
Atención: Al restablecer un informe se pierden todas las personalizaciones realizadas sobre ese diseño (cambios de fuente, logotipo, disposición de elementos, campos añadidos, etc.). Si el establecimiento tiene un diseño personalizado que desea conservar, utilice la Opción B.

Opción B: Añadir los campos manualmente en el editor

Si el establecimiento tiene un diseño personalizado y no desea perderlo, puede añadir los campos del QR manualmente desde el editor de informes (FastReport). Es imprescindible que los objetos tengan los nombres exactos indicados a continuación, ya que el sistema los busca por nombre.

1 Acceda al Diseñador de documentos en Glop y seleccione el diseño a modificar.
2 Pulse “Editar informe” para abrir el editor de FastReport.
3 Añada un objeto de tipo Imagen (Picture) en la zona del diseño donde desee que aparezca el código QR. En sus propiedades, establezca el nombre (Name) como: imgQR_SF
4 Añada un objeto de tipo Texto (Memo) encima o debajo de la imagen. En sus propiedades, establezca el nombre (Name) como: lbLeyendaSF
5 Guarde el diseño.
Los nombres deben ser exactos. El sistema busca los objetos por su nombre para asignarles el código QR y el texto. Si los nombres no coinciden exactamente (por ejemplo, si escribe imgQRSF en lugar de imgQR_SF), el QR no se mostrará en el documento impreso. No se producirá ningún error, simplemente el QR no aparecerá.
ObjetoNombre exactoTipo en FastReportFunción
Código QR imgQR_SF Imagen (Picture) Muestra el código QR que el cliente escaneará con su móvil.
Texto leyenda lbLeyendaSF Texto (Memo) Muestra el mensaje que acompaña al QR (por ejemplo, “Escanee este código QR para solicitar su factura”). El texto se rellena automáticamente desde la configuración.

Diseños que necesitan estos campos

Los campos imgQR_SF y lbLeyendaSF deben añadirse (o verificar que existen) en los siguientes diseños de documentos:

  • Justificante (cuenta sin cobrar)
  • Justificante de factura
  • Justificante servicio a domicilio
  • Justificante factura servicio a domicilio
Nota: Los diseños de facturas simplificadas y facturas completas no necesitan estos campos, ya que en esos documentos el QR se imprime en un papel separado que se genera automáticamente.

5. Botón Cliente/QR en la pantalla del TPV

Además de la impresión automática del QR en los documentos, el TPV incluye un botón “Cliente/QR” que permite al personal del establecimiento imprimir manualmente el papel con el código QR de solicitud de factura para cualquier documento seleccionado.

5.1 Dónde aparece el botón

El botón “Cliente/QR” está disponible en dos ubicaciones del TPV:

UbicaciónDescripción
Pantalla táctil principal Aparece en el panel lateral de botones de las pantallas táctiles (hostelería y comercio). Permite imprimir el QR del documento (ticket o factura) seleccionado en la lista.
Vista de salón (mesas) Aparece en la vista de gestión de mesas y salones. Permite imprimir el QR asociado a la mesa seleccionada.

5.2 Cuándo está disponible

El botón “Cliente/QR” solo está habilitado cuando el parámetro Activar solicitud de factura por QR a través de Justificantes está activo en el terminal. Si la funcionalidad no está activada, el botón aparece deshabilitado.

5.3 Cómo funciona

1 El cajero selecciona un documento (ticket o mesa) en la pantalla del TPV.
2 Pulsa el botón “Cliente/QR”.
3 El sistema imprime un papel con el código QR de solicitud de factura correspondiente a ese documento. El tipo de documento impreso (justificante de ticket o justificante de factura) se determina automáticamente según la configuración del terminal o del salón.
Caso de uso típico: Un cliente pide la cuenta, pero el justificante original se ha extraviado o el QR no se escanea bien. El cajero puede usar el botón “Cliente/QR” para imprimir un nuevo papel con el QR de solicitud de factura sin necesidad de reimprimir todo el justificante.
Importante: Es necesario tener un documento seleccionado antes de pulsar el botón. Si no hay ningún documento seleccionado, el sistema mostrará un mensaje indicando que debe seleccionar un documento o una mesa.

6. Experiencia del cliente (formulario web)

Esta sección describe lo que ve y hace el cliente final cuando escanea el código QR de su justificante o factura simplificada.

6.1 Escaneo del QR

El cliente escanea el código QR impreso en su justificante o factura simplificada utilizando la cámara de su teléfono móvil. No necesita instalar ninguna aplicación especial: la cámara nativa del móvil reconoce el QR y abre automáticamente el navegador web.

6.2 Vista previa de la factura simplificada

Si el QR corresponde a una factura simplificada ya cobrada y la licencia tiene Cloud activo, antes de mostrar el formulario se presenta una vista previa de la factura simplificada con:

  • Datos fiscales del establecimiento (nombre, CIF, dirección).
  • Líneas de la factura simplificada (artículos, cantidades, precios).
  • Total de la compra.

El cliente puede revisar que se trata de su compra correcta y pulsar “Continuar” para acceder al formulario de solicitud.

6.3 Formulario de solicitud

El formulario web solicita al cliente los siguientes datos fiscales:

CampoDescripciónObligatorio
NIF / CIF / NIE Documento de identificación fiscal del cliente. Se valida automáticamente (formato y dígito de control). Sí
Nombre / Razón social Nombre completo o razón social (en caso de empresa). Sí
Apellidos Apellidos del cliente (no aplica para empresas). No
Correo electrónico Dirección de email donde recibir la factura. Sí
Dirección Dirección fiscal. Sí
Código postal Se rellena automáticamente al seleccionar la dirección. Sí
Localidad Se rellena automáticamente al seleccionar la dirección. Sí
Provincia Se rellena automáticamente al seleccionar la dirección. Sí

6.4 Autocompletado inteligente

El formulario ofrece autocompletado para facilitar la experiencia del cliente:

1 Autocompletado por NIF: Si el cliente ya existe en la base de datos del establecimiento, al introducir su NIF/CIF/NIE el sistema reconoce automáticamente sus datos y rellena el nombre, apellidos, dirección y email. El cliente solo tiene que verificar que los datos son correctos.

6.5 Validación del NIF

El sistema valida automáticamente el formato del documento de identificación fiscal:

  • NIF: 8 dígitos + letra de control (ejemplo: 12345678Z).
  • NIE: Letra (X, Y o Z) + 7 dígitos + letra de control (ejemplo: X1234567L).
  • CIF: Letra de tipo de entidad + 7 dígitos + dígito o letra de control (ejemplo: B12345678).

Si el formato no es válido, se muestra un mensaje de error y no se permite enviar el formulario.

6.6 Envío y confirmación

Tras rellenar y enviar el formulario, el cliente ve una página de confirmación indicando que su solicitud ha sido recibida correctamente y que la factura será procesada en breve.

6.7 Situaciones especiales

El cliente puede encontrar los siguientes mensajes al escanear un QR:

SituaciónMensajeCausa
QR expirado Se muestra una página indicando que el código ha expirado. Han pasado más de 90 días desde la emisión del documento.
Solicitud duplicada Se muestra una página indicando que ya se ha solicitado factura para esta compra. El cliente (u otra persona) ya envió una solicitud de factura para la misma compra.

7. Procesamiento automático en el TPV

Una vez que el cliente envía su solicitud de factura a través del formulario web, el Glop TPV se encarga de procesarla automáticamente. No se requiere ninguna acción por parte del personal del establecimiento.

7.1 Consulta periódica de solicitudes

Cuando alguno de los parámetros principales está activo, el TPV consulta automáticamente cada 15 segundos si hay solicitudes pendientes para ese terminal. Este intervalo es configurable (ver sección 9).

Funcionamiento transparente: La consulta se ejecuta en segundo plano y no interfiere con el uso normal del TPV. El personal del establecimiento no percibe ningún cambio en su flujo de trabajo habitual.

7.2 Escenario 1: Justificante abierto (cuenta sin cobrar)

Cuando la solicitud corresponde a una cuenta que aún no ha sido cobrada:

1 El TPV recibe la solicitud con los datos fiscales del cliente.
2 Crea o actualiza el cliente en la base de datos del establecimiento con los datos recibidos (nombre, NIF, dirección, email). Si ya existe un cliente con ese NIF, actualiza sus datos.
3 Asigna el cliente a la cuenta abierta y la marca internamente como “cliente actualizado por QR”.
4 Cuando el cajero vaya a cobrar esa cuenta, el sistema fuerza automáticamente el tipo de documento a Factura (si el parámetro está activado). El cajero verá que el tipo de documento ya está seleccionado como “Factura” y no podrá cambiarlo.
Para el cajero: Al abrir la pantalla de cobro de esa cuenta, verá que el tipo de documento está fijado en “Factura” y el botón de email aparece resaltado en verde. No necesita hacer nada especial: simplemente cobra como de costumbre y el sistema se encarga del resto.

7.3 Escenario 2: Factura simplificada cerrada (ya cobrada)

Cuando la solicitud corresponde a una factura simplificada que ya ha sido cobrada:

1 El TPV recibe la solicitud con los datos fiscales del cliente.
2 Crea o actualiza el cliente en la base de datos con los datos recibidos.
3 Genera un abono del documento original (anulación contable de la factura simplificada).
4 Genera una nueva factura completa con los datos fiscales del cliente, que reemplaza al documento original.
5 Si el parámetro de envío de email está activo, envía la factura por correo electrónico al cliente.
Importante: Este escenario solo funciona si el parámetro Activar solicitud de factura por QR a través de Factura Simplificada está activo, lo cual requiere licencia Cloud.

7.4 Escenario 3: Factura completa cerrada (modificación de datos fiscales)

Cuando la solicitud corresponde a una factura completa que ya ha sido emitida y el cliente necesita modificar sus datos fiscales (por ejemplo, cambio de razón social, corrección de NIF, actualización de dirección, etc.):

1 El TPV recibe la solicitud con los datos fiscales actualizados del cliente.
2 Actualiza el cliente en la base de datos con los nuevos datos recibidos.
3 Genera un abono de la factura original (anulación contable de la factura completa).
4 Genera una nueva factura completa con los datos fiscales corregidos, que reemplaza a la factura original.
5 Si el parámetro de envío de email está activo, envía la nueva factura por correo electrónico al cliente.
Importante: Este escenario solo funciona si el parámetro Permitir Modificar Factura al Solicitar está activo, lo cual requiere licencia Cloud.
Diferencia con el escenario 2: En el escenario de factura simplificada cerrada, el cliente no tenía factura completa y la solicita por primera vez. En este escenario, el cliente ya tiene una factura completa pero necesita corregir o actualizar los datos fiscales que figuran en ella.

7.5 Resumen del procesamiento

Comparativa de los tres escenarios
AspectoJustificante abiertoFactura simplificada cerradaFactura completa cerrada
Estado del documento Sin cobrar Ya cobrado (FS) Ya cobrado (Factura)
Motivo de la solicitud El cliente quiere factura completa El cliente quiere factura completa El cliente necesita corregir datos fiscales
Acción del TPV Asigna cliente a la cuenta; al cobrar se emite factura Abona la FS original y genera nueva factura Abona la factura original y genera nueva factura con datos corregidos
Intervención del cajero Ninguna (solo cobra como siempre) Ninguna (proceso totalmente automático) Ninguna (proceso totalmente automático)
Parámetro necesario Activar QR a través de Justificantes Activar QR a través de Factura Simplificada Permitir Modificar Factura al Solicitar
Licencia necesaria Cualquier licencia Cloud Cloud

8. Envío de factura por correo electrónico

8.1 Cuándo se envía el email

Si el parámetro Enviar Email al Solicitar está activo, el sistema envía automáticamente la factura por correo electrónico al cliente en los siguientes momentos:

  • Justificante abierto: El email se envía tras cobrar la cuenta (una vez generada la factura).
  • Factura simplificada cerrada: El email se envía automáticamente tras generar la nueva factura (proceso completamente automático).
  • Factura completa cerrada: El email se envía automáticamente tras generar la nueva factura con los datos fiscales corregidos (proceso completamente automático).

8.2 Dirección de envío

La factura se envía a la dirección de correo electrónico que el cliente proporcionó en el formulario web al solicitar la factura.

8.3 Indicador visual en el cobro

Cuando una cuenta tiene un cliente asignado por QR y el parámetro de email está activo, en la pantalla de cobro el botón de email aparece resaltado en verde, indicando al cajero que la factura se enviará por correo al cliente.

9. Configuración avanzada

Estas opciones de configuración permiten ajustar el comportamiento del módulo. Se configuran en el archivo INI del TPV.

9.1 Intervalo de consulta

El tiempo entre cada consulta de solicitudes pendientes se puede ajustar:

Configuración en el archivo INI del TPV

[solicitarfactura]

interval=15

El valor se expresa en segundos. Por defecto es 15 segundos. Puede aumentarse si se desea reducir la carga de red, o reducirse si se necesita que las solicitudes se procesen más rápidamente.

9.2 Textos del QR impreso

Los textos que acompañan al código QR en el papel separado se pueden personalizar:

Configuración en el archivo INI

[solicitarfactura]

txtsolicitarjusti=Escanee este código QR para solicitar su factura

txtsolicitarfra=Escanee este código QR para solicitar su factura

txtmodiffra=Escanee este código QR para modificar los datos de su factura

Clave INISe usa enSituación
txtsolicitarjusti QR integrado en justificantes (cuentas sin cobrar) El cliente aún no ha pagado. El texto le invita a proporcionar sus datos fiscales para que, cuando se cobre la cuenta, se emita directamente una factura completa.
txtsolicitarfra Papel separado tras facturas simplificadas (ya cobradas) El cliente ya ha pagado pero solo tiene una factura simplificada. El texto le invita a solicitar una factura completa con sus datos fiscales.
txtmodiffra Papel separado tras facturas completas (ya emitidas) El cliente ya tiene factura completa pero necesita corregir o actualizar los datos fiscales (cambio de NIF, razón social, dirección, etc.).
Consejo: Adapte el texto al idioma y estilo de su establecimiento. Por ejemplo, un restaurante podría usar: “Si necesita factura, escanee este QR con su móvil”.

10. Preguntas frecuentes

¿El cliente necesita instalar alguna aplicación?

No. El código QR se escanea con la cámara nativa del teléfono móvil (disponible en todos los smartphones actuales, tanto iPhone como Android). Al escanearlo se abre automáticamente el navegador web con el formulario de solicitud.

¿Cuánto tarda en procesarse la solicitud?

El TPV consulta cada 15 segundos (por defecto) si hay nuevas solicitudes. En el caso de un justificante abierto, los datos del cliente se asignan a la cuenta en menos de un minuto. En el caso de una factura simplificada cerrada o una factura completa cerrada, el abono y la nueva factura se generan automáticamente también en menos de un minuto.

¿Qué pasa si el TPV está apagado cuando el cliente envía la solicitud?

La solicitud queda almacenada en la nube con estado “pendiente”. Cuando el TPV se encienda y comience a consultar solicitudes, la procesará automáticamente. No se pierde ninguna solicitud.

¿Un cliente puede solicitar factura más de una vez para la misma compra?

No. Si un cliente intenta solicitar factura para una compra que ya tiene una solicitud registrada, verá un mensaje indicando que ya se ha solicitado factura para esa compra. Esto evita solicitudes duplicadas.

¿Qué ocurre si el cliente introduce un NIF incorrecto?

El formulario web valida el formato del NIF/CIF/NIE en tiempo real. Si el formato no es válido (dígito de control incorrecto, longitud incorrecta, etc.), el formulario no permite el envío y muestra un mensaje de error.

¿Puedo desactivar la funcionalidad para un terminal concreto?

Sí. Cada terminal tiene sus propios parámetros de solicitud de factura por QR. Puede activarlos en los terminales de caja principal y desactivarlos en terminales secundarios, por ejemplo.

¿El QR funciona si no hay internet en el momento de escanear?

El cliente necesita conexión a internet en su móvil para acceder al formulario web. Si no tiene conexión, puede guardar el documento y escanearlo más tarde (dentro del plazo de 90 días).

¿Qué pasa si el cliente ya está en la base de datos?

Si el NIF que introduce el cliente ya existe en la base de datos del establecimiento, el formulario autocompleta automáticamente los datos (nombre, apellidos, dirección, email). El cliente puede verificarlos, corregirlos si es necesario y enviar la solicitud. En el TPV, los datos del cliente se actualizan con la información enviada.

¿El cajero necesita hacer algo especial?

En la mayoría de los casos, no. Para justificantes abiertos, el cajero simplemente cobra como siempre y el sistema fuerza el tipo de documento a Factura automáticamente. Para facturas simplificadas cerradas y para modificaciones de facturas completas, el proceso es completamente automático y no requiere ninguna acción del personal.

¿Se puede reimprimir el QR de solicitud de factura?

Sí. El botón “Cliente/QR” en la pantalla táctil y en la vista de salón permite reimprimir el papel con el código QR de solicitud de factura para cualquier documento seleccionado. Esto es útil si el cliente ha extraviado el justificante original o si el QR no se escanea correctamente. El botón solo está disponible cuando la funcionalidad de solicitud de factura por QR está activa en el terminal (ver sección 5).

¿Un cliente puede modificar los datos fiscales de una factura ya emitida?

Sí, siempre que el parámetro Permitir Modificar Factura al Solicitar esté activo (requiere licencia Cloud). Tras la emisión de una factura completa, se imprime un papel separado con un QR que permite al cliente solicitar la modificación de sus datos fiscales. El TPV abona la factura original y genera una nueva con los datos corregidos.

Documento generado para GLOP — Última actualización: Abril 2026 — Versión 1.1

Manual SMARTtill

SMARTtill es un sistema de cajón inteligente que se integra con GLOP para contar automáticamente el dinero en efectivo cada vez que el cajón se abre y se cierra. El dispositivo pesa las monedas y billetes depositados en el cajón y genera informes de discrepancia en tiempo real.

Requisitos previos

¿Requiere licencia de módulo?Si, requiere licencia de cajones
¿Qué tipo de licencia usa la integración?GL y GB
Software necesarioDriver SMARTtill

Configuracion inicial

Primeramente tendremos que tener instalado los drivers de SMARTtill

Tras esto en Configuración > Terminales > Periféricos > Cajones de seguridad > SMARTtill, podremos realizar la configuración en Glop

SMARTtill se comunica con GLOP mediante archivos XML depositados en carpetas del sistema de archivos. Es necesario configurar todas las carpetas, que debería de haberse creado tras la instalación de los drivers de SMARTtill.

Casilla mostrar descuadres: Muestra la ventana de descuadres después de cada operación con el cajón si existe algún descuadre.

Casilla mostrar descuadres en cada operación: Muestra la ventana de descuadres solo cuando el importe del descuadre cambia respecto a la operación anterior.

Número de SMARTtill: n.º de identificación del cajón dentro de nuestra instalación

Configuración de formas de pago

Toda forma de pago que quiera ser utilizado junto al cajón, deberá de tener marcado el check de SMARTtill

Operativa diaria

Al abrir turno/día el cajón pedirá realizar una inicialización, tras haberla realizado ya podremos usar la pantalla de ventas sin ningún problema.

Una vez estemos utilizando la pantalla de ventas, podrán surgir descuadres cuando realicemos diferentes operaciones de caja, la gestión de estos descuadres está detallada en el siguiente enlace.

Menú de utilidades SMARTtill

Botón utilidades de la pantalla de ventas > opciones SMARTtill

  • Inicializar cajón: Reinicia completamente el dispositivo SMARTtill, realizando un recuento desde cero.
  • Ver totales: Muestra el desglose actual del contenido del cajón por denominación.
  • Ver descuadres: Muestra la ventana de descuadres del turno actual.

Denominaciones soportadas

SMARTtill reconoce las siguientes 14 denominaciones del euro:

Monedas

Denominación
0,01 EUR
0,02 EUR
0,05 EUR
0,10 EUR
0,20 EUR
0,50 EUR
1,00 EUR
2,00 EUR

Billetes

Denominación
5,00 EUR
10,00 EUR
20,00 EUR
50,00 EUR
100,00 EUR
200,00 EUR

Como consultar descuadres con cajón SMARTtill

Que es SMARTtill

SMARTtill es un sistema de cajón inteligente que cuenta automáticamente el dinero en efectivo cada vez que se abre y cierra el cajón. Al conocer cuanto dinero hay físicamente en el cajón y cuanto debería haber según las ventas, GLOP puede detectar descuadres (diferencias entre lo esperado y lo real) en tiempo real.

Como funciona el sistema de descuadres

Concepto basico

Cada vez que el cajón se abre y se cierra, SMARTtill genera un informe de discrepancia (DIS) que compara:

  • Dinero teórico: Lo que debería haber en el cajón según las ventas, entradas y salidas de efectivo registradas
  • Dinero real: Lo que SMARTtill ha contado físicamente en el cajón

Descuadre = Dinero real en el cajon – Dinero teorico esperado

  • Si el resultado es negativo: falta dinero en el cajón
  • Si el resultado es positivo: sobra dinero en el cajón
  • Si el resultado es cero: el cajón cuadra perfectamente

Solo se tienen en cuenta las formas de pago marcadas como activas para SMARTtill en la configuración.

Cuando se genera un descuadre

Se registra un descuadre en el sistema cada vez que el cajón se abre y cierra durante una de estas operaciones:

OperacionDescripcion
CobroTras cobrar un ticket en efectivo
Apertura de cajónAl abrir el cajón manualmente (sin cobro)
Entrada de efectivoAl hacer un ingreso en caja
Salida de efectivoAl hacer una extracción de caja
Abono de documentoAl devolver dinero por una devolución
Corrección de descuadreTras corregir un descuadre desde la ventana de discrepancias
InicializaciónAl resetear/inicializar el dispositivo SMARTtill

Importante: Solo se registran descuadres cuando la diferencia es distinta de cero. Si el cajon cuadra perfectamente, no se crea registro.

Ventana de descuadres en tiempo real

Cuando aparece

La ventana de descuadres puede aparecer automáticamente después de cada operación con el cajón, dependiendo de la configuración:

  • Seguimiento continuo: La ventana aparece tras cada operación si hay descuadre
  • Seguimiento por operación: La ventana aparece solo cuando el importe del descuadre cambia respecto a la ultima vez

Que muestra

La ventana «Descuadres SMARTtill» muestra una tabla con todas las discrepancias del turno actual:

ColumnaDescripcion
CajaNumero de caja
TurnoNumero de turno
EmpleadoNombre del empleado que realizo la operación
OperaciónTipo de operación (Cobro, Apertura Cajón, etc.)
EfectivoImporte en efectivo de la operación
DocumentoNumero de ticket o factura asociada
DescuadreImporte de la discrepancia detectada

Botones disponibles

BotonAccion
AceptarCierra la ventana y continua trabajando
CorregirAbre el cajón para que el empleado corrija el efectivo. Si tras cerrar el cajón ya no hay descuadre, se marcan las discrepancias como corregidas
InicializarResetea completamente el dispositivo SMARTtill (usar solo si es necesario)

Descuadres en el cierre de turno/caja

Donde se ven los descuadres al cerrar turno

Al realizar un cierre de turno o cierre de caja (día), la ventana de cierre muestra:

  1. Tabla de formas de pago: Con columnas de cantidad esperada, cantidad real contada y descuadre
  2. Tabla de efectivo: Con el desglose de efectivo y su descuadre
  3. Total descuadres: Suma de todos los descuadres de cobros y efectivo

Si el cajón se encuentra vacío los descuadres generados no se mostrarán en la ventana del cierre de día/turno.

Ventana de discrepancias al cerrar

Si al cerrar el turno existe un descuadre (la cantidad real del cajón no coincide con la esperada), se muestra automáticamente la ventana de discrepancias SMARTtill antes de completar el cierre. Esto permite al usuario:

  • Ver el detalle de las discrepancias del turno
  • Decidir si corregir el cajón antes de cerrar
  • Aceptar y continuar con el cierre

Botón Inicializar

En la ventana de cierre, el botón «Inicializar» solo aparece visible cuando el total de descuadres es distinto de cero. Al pulsarlo se abre la ventana de descuadres SMARTtill para poder revisar y gestionar las discrepancias.

Informe de descuadres

Como acceder al informe exclusivo de SMARTtill

El informe de descuadres SMARTtill se encuentra en:

Ventas > Informes > Incidencias > Descuadres SMARTtill

Como acceder al informe de descuadres genéricos

Los informes de descuadres se encuentran en:

Ventas > Informes > Resumen de caja > Descuadres de efectivo

Volver arriba

Acceder a WikiGlop

Cambiar la contraseña