Debe tener marcado el módulo de Restoo en el apartado API Rest.
Previamente se debe configurar el Restoo (Cliente).
No se pueden tener habilitada más de una integración de Reservas Online de manera simultánea.
CONFIGURACIÓN DE RESTOO
Como configuración en la plataforma de Restoo tendremos que dirigirnos a la pestaña de mapeo de mesas y unir las mesas de la plataforma con las mesas de Glop mediante los ID’s de las mesas. Link
CREACIÓN DE LA RESERVA
Para crear una reserva desde la plataforma de Restoo simplemente tendremos que clickar en el botón de nueva. Enlace a la plataforma: Link
Seleccionar la fecha de la reserva.
El número de adultos y niños que se sentarán.
Seleccionar el turno y la hora de la reserva.
Y finalmente asignar la mesa en la cual se van a sentar.
GESTIÓN DE LA RESERVA DESDE GLOP
Para acceder a la gestión de reservas desde Glop primero tendremos que acceder al TPV, después en utilidades y para finalizar en Reserva Online.
Una vez estemos ya en la pestaña de Reservas Online, podremos observar un listado con todas las reservas confirmadas o pendientes de confirmar para así poder gestionarlas individualmente.
Estas reservas, podrán ser canceladas desde el botón cancelar, seleccionando una de ellas.
Nota: Cuando una reserva no cuenta con Zona ni Turno la reserva es de Cover Manager, si la reserva cuenta con dichos campos, es una reserva de Glop
Para gestionar la reserva, seleccionaremos una de ellas del listado, pulsaremos sobre el botón gestionar. Tras esto se abrirá la pantalla de ventas con la mesa seleccionada, donde podremos añadir artículos o aparcarla vacía. Si la aparcamos vacía aparecerá de color rojo como mesa reservada y si la aparcamos con articulo estará de color azul como mesa ocupada.
Tras gestionar la reserva, si por algún motivo lo deseamos podemos desvincular la reserva de esa mesa, a través del botón desvincular, de forma que la mesa volverá a aparecer en estado libre para ser ocupada.
Vídeo flujo completo de gestión de reservas
Nota de funcionamiento
En el caso de haber modificado el APIREST original de la instalación en la nube y/o licencia, es necesario borrar los registros de APIREST_BEARER de la tabla TB_TERMINALES para que conecte correctamente con los nuevos datos generados. Al intentar traspasar una mesa de una reserva, la cual en la plataforma de Restoo está asignada a 2 mesas, en glop se realizará correctamente pero este cambio no se reflejará ni en la plataforma de Restoo ni en la Api Rest de Glop.
El PAC o punto de aviso al cliente es un exe que utilizaremos para avisar al cliente del estado de su pedido. Su utilidad va relacionada directamente con los gestores de comandas y Su Turno.
En el PAC podremos observar si nuestro pedido esta en preparación o para servir, esto se hará a través del ticket impreso en el que se mostrara el numero de Turno, este numero se mostrara en pantalla PAC según en el estado que este. Para identificar el pedido en los gestores de cocina se mostrara la coletilla ST: seguido del numero de Su Turno (el numero equivale a los últimos 2 dígitos del IdTIcket).
Configuración Inicial
¿Requiere licencia de módulo?
Si, requiere el módulo PAC
¿Qué tipo de licencia usa la integración?
GL y GB
CONFIGURACIÓN DESDE GLOP
Primeramente para poder utilizar y configurar PAC deberemos de disponer de licencia de PAC Windows.
Accederemos a configuraciones, terminales, módulos, PAC.
Configuraremos, colores y tamaño de letra, colores de fondo y los textos a mostrar. También monitor donde se mostrara y si queremos o no mostrar los tickets aparcados en barra.
CONFIGURACION SU TURNO GESTOR DE COMANDAS
Se ha añadido un parámetro en las configuraciones para mostrar el número de Su Turno en los gestores de comandas.
EJEMPLO DE FUNCIONAMIENTO
Hay que tener en cuenta que hasta que todas las líneas de un mismo pedido no estén en el mismo estado no realizara el cambio de preparación a servir en el PAC. Los pedidos que se muestran en el PAC pueden venir desde Glop, Glopdroid, kiosko…
El estado recibido y en preparación se muestran en la columna de de en preparación, el estado para servir se muestra en la columna recoger, destacando siempre el ultimo pedido que ha cambiado a ese estado y el estado servido lo que hace es eliminar el numero de la pantalla.
Resumen:
El PAC es un exe utilizado para informar al cliente sobre el estado de su pedido, mostrando el número de Su Turno y la preparación del pedido.
El PAC muestra el estado del pedido y el número de Su Turno, relacionado con gestores de comandas.
Se requiere licencia de módulo PAC para la integración, con configuraciones desde GLOP.
Es importante que todas las líneas de un pedido estén en el mismo estado para cambiar de preparación a servir en el PAC.
Se puede configurar colores, tamaño de letra y otros aspectos visuales en el PAC y en el gestor de comandas.
Los pedidos en el PAC pueden provenir de diferentes fuentes como Glop, Glopdroid o kioskos.
La licencia de Glop debe tener el módulo Cloud o Business.
Debe tener marcado el módulo de la propia integración en el apartado API Rest en la configuración del sitio del cliente.
Previamente, se debe configurar la integración (si fuera necesario).
No se pueden tener habilitadas las reservas de Glop (Agenda en comercios) y cualquier otro sistema de reservas de manera simultánea.
La plataforma de reservas nos debe asignar un API-Key único para Glop que usaremos para todas las llamadas en el header. La plataforma identificará la reserva a través de este valor y el identificador de la reserva.
Obtención de localizacionesPara poder obtener las reservas y redirigirlas a nuestros terminales, necesitamos que la plataforma integradora de Reservas nos envíe localizaciones/restaurantes a las que van dirigidos las reservas. Nosotros hacemos un mapeo entre localizaciones y terminal de Glop de envío de las reservas.
La plataforma integradora deberá desarrollar un endpoint al cual llamaremos para que nos devuelva las localizaciones. La respuesta debe tener estas características:[ { "id":"96f8adc9-c1dd-42a8-94a1-6b6d669bcce6", "nombre":"Nombre Localización 1" }, { "id":"96f0d827-8b28-4f65-a874-89f67e76a9b4", "nombre":"Nombre Localización 2" } ]El campo id debe ser único para todos las localizaciones existentes. El id de localización lo obtenemos de la llamada explicada aquí.El campo nombre es el nombre de cada localización (restaurante o establecimiento) Este endpoint debe ser remitido por la plataforma integradora a joaquin@glop.es.
Nuestro sistema siempre utiliza el id de localización de un JSON de reserva para «llevarlo» hasta el terminal (una vez mapeado).
La plataforma integradora necesita obtener de Glop los identificadores de las mesas para hacer un match entre el salón de Glop y el de la plataforma Obtener mesas por id grupo | Glop API Rest“La solicitud requiere que el Servicio Glop esté activo para responder a esta petición. Esto es necesario para la correcta recuperación de tablas a través de los grupos de terminales.” El ID de grupo se refiere a un establecimiento (Localización) que agrupa al menos un terminal. Un grupo puede contener uno o más terminales. Por ejemplo, si un propietario tiene dos establecimientos, esto implicaría tener dos ID de grupos diferentes: uno con uno o más terminales y el otro con sus propios terminales. Aquí un enlace al endpoint de obtener la lista de grupos de terminales: Obtener lista grupos terminales | Glop API Rest
Obtención de mesas Para poder asignar las reservas a las mesas equivalentes en los salones de glop, las plataformas integradoras deberán usar este endpoint para recibir los identificadores únicos de cada mesa. Nosotros hacemos un mapeo entre el número de mesa en los salones Glop y los identificadores que devolvemos en el endpoint. Para poder realizar esta llamada, el software Glop deberá estar en marcha.
Obtención del token Para poder realizar llamadas a la API de Glop se necesitará obtener el Bearer Token de autorización mediante este endpoint. Para poder obtenerlo necesitaremos tener un sitio configurado con API Rest en App.glop.es.
client_id: Id de las credenciales de API Rest del sitio.
client_secret: Secret de las credenciales de API Rest del sitio. Estos valores deberán ser suministrados por el soporte de Glop.
Nuestro endpoint devolverá una respuesta con estos parámetros:
{ "token_type": "string", "expires_in": 0, "access_token": "string" }El token a usar será el devuelto en el parámetro access_token.
Casos de uso:
Un cliente realiza una reserva desde la plataforma externa (día, fecha, mesa, nombre, email, etc).
La plataforma externa le asigna número de reserva
Nuestro software consulta reservas de hoy + dos días (reservas a dos días vista con las de hoy) (Obtener reservas)
El cliente llega al establecimiento y es llevado a su mesa.
Si el cliente tiene una reserva previa:
Si la reserva tiene una mesa asignada desde la plataforma, la mesa estará disponible para el cliente siempre que se asigne manualmente. Update-TableSit-Client
Si el establecimiento cambia una mesa (por cualquier motivo), Glop enviará el traspaso de la mesa de la reserva a la plataforma. Update-Table
Al cerrar la cuenta, se enviará la información del ticket a la plataforma Set-Ticket
Se abrirá una mesa libre en Glop y se enviará petición walk-in (nueva mesa sin reserva) al sistema de reservas indicándole que esa mesa está ocupada
El sistema de reservas nos debe responder con un identificador de reserva
Al cerrar la cuenta, se enviará la información del ticket a la plataforma Set-Ticket
Ciclo completo de una Reserva
Agregado de productos a una Reserva
Endpoints necesarios para la integración con GLOP
Algunos endpoints requieren el parámetro apikey en la cabecera o URL. Este parámetro será único en todas las llamadas realizadas por nuestros terminales a la API de terceros, independientemente del establecimiento que realice la llamada. Los establecimientos se «registrarán» y se «gestionarán» a través del listado de localizaciones y terminales en nuestra configuración de la API.
Obtener Reservas
Descripción
Obtenemos la lista de reservas confirmadas o pendientes de confirmar desde Glop para poder gestionarlas de manera individual, asegurando así una correcta integración entre Glop y la plataforma de reservas. Al enviar una reserva sin mesa, es estrictamente necesario que esta venga con la cadena «SIN».
date_start: fecha filtro inicio formato (dd-mm-YYYY)
date_end: fecha filtro fin formato (dd-mm-YYYY)
Ejemplo respuesta del sistema externo de reservas
{ "resp": 1, "reservs":[
{
"id_reserv": "eytoRR",//Imprescindible, Identificador único de la reserva
"product": "1", // Nullable
"date_add": "2019-11-26", // Nullable
"time_add": "12:19:36", // Nullable
"user_name": "ANONYMOUS", // Nullable
"date": "2019-11-27", // Fecha de la Reserva - Nullable
"for": "2", // Número de comensales de la Reserva - Nullable
"commentary_restaurant": "", // Comentario asignado a la Reserva - Máximos 255 Carácteres - Nullable
"commentary_client": "", // Nullable
"user_phone": null, // Número de teléfono asignado a la Reserva - Nullable
"tables": "67", // Imprescindible, ID de la mesa o mesas a la cual se les asignará la reserva, si no viene el ID, enviar "SIN"
"status": "-2", //Contemplamos el Status 1 y -2,</em> -2 = CANCELADA, 1 = CONFIRMADA
"source": null, // Nullable
"duration": "180", // Nullable
"camarero": null, // Nullable
"is_group": "0", // Nullable
"id_client": "oGS2wA", // Identificador único del Cliente de la plataforma de reservas
"origin": "", // Nullable
"email": "", // Correo eléctronico asignado a la Reserva - Nullable
"first_name": "Pepito", // Nombre del cliente que realizó la Reserva - Nullable
"last_name": "Perez" // Apellido del cliente que realizó la Reserva - Nullable
}
], "page": "0" }
*Nullable: Que puede ser nulo. (null)
Walk-In
Descripción
Asignación de una mesa ad hoc para clientes que llegan sin reserva
Asignamos una mesa de Glop sin previo aviso («walk-in») cuando ubicamos a clientes sin reservas, utilizando Glop. De esta manera, notificamos a la plataforma de reservas que la mesa está ocupada.
id_table: mesas separadas por coma a reservar para esos comensales
Ejemplo respuesta del sistema externo de reservas
{ "resp": 1, "id_reserv": "kfMxTN" }
Inmediatamente después se hace un Update Table y un Sit Client
Update Table
Descripción
Asignar o traspasar una reserva de una mesa a otra. Asignamos el identificador de la mesa a otra mesa al realizar un traspaso de mesa. Si una reserva está asignada a 2 mesas, esta no podrá ser traspasada.
tables: El nuevo identificador de la mesa para la reserva
apikey
Ejemplo respuesta del sistema externo de reservas
{ "resp": 1, "message": "Ok" }
Sit Client
Descripción
Asignar a una reserva asiganda a un cliente una mesa especifica en Glop para que la plataforma confirme o indentifique la mesa en la que el cliente esta sentado.
Se envía a la plataforma de reserva en el momento de cerrar la venta de una mesa con identificador de reserva indicando que la mesa queda libre e informando de los productos vendidos.
Este documento proporciona información detallada sobre la integración con GLOP para la gestión de reservas y pedidos.
Se requiere una licencia Cloud o Business y la configuración del módulo de integración en el apartado API Rest.
Es necesario obtener localizaciones para el envío de pedidos y asignar mesas a través de un endpoint creado por la plataforma integradora.
Se describen casos de uso desde la realización de reservas hasta el cierre de la mesa con el cobro de un ticket.
Se presentan varios endpoints necesarios para la integración con GLOP, como obtener reservas, crear reservas adhoc, asignar mesas, abrir reservas, y enviar tickets.
Se detalla la estructura de los endpoints, ejemplos de respuestas y la importancia de ciertos parámetros como el apikey.
Debe tener marcado el módulo de Cover Manager en el apartado API Rest.
Previamente se debe configurar el Cover Manager(Cliente).
No se pueden tener habilitadas las reservas de Glop y las reservas de Cover Manager de manera simultánea.
CONFIGURACIÓN DE COVER MANAGER
Es necesario que en cada mesa de los salones de Cover Manager se acceda a la opción Modificar y rellenar los datos de ID Mesa y Número Mesa que nos facilita el salón de GLOP.
Ejemplo de un Salón en Cover Manager
Configuración de una mesa desde Cover Manager
Página de configuración de Cover Manager
CREACIÓN DE LA RESERVA
Para realizar una reserva de prueba desde Cover Manager primero deberemos dirigirnos a la página test proporcionada por la propia Cover Manager, en el caso de Glop la nuestra es esta link.
Dentro de la página tendremos que seleccionar tanto la cantidad personas, como la fecha y la hora a la cual se quiere reservar la mesa.
Nota: En Glop sólo aparecerán las reservas asignadas para el día de hoy y el día siguiente
Seguidamente clickaremos el botón de reservar y nos moveremos a la pestaña de destalles para ultimar la reserva.
Para poder finalizar la reserva tendremos que escribir el nombre y apellidos de la persona que desea realizar la reserva, además de su correo electrónico y su número de teléfono.
Nota: Cover Manager identifica las reservas por el número de teléfono por tanto si realizamos dos reservas con el mismo teléfono, los datos introducidos en la 2da sobrescribirán los de la primera
Una vez confirmada la reserva nos aparecerá este mensaje.
GESTIÓN DE LA RESERVA DESDE GLOP
Para acceder a la gestión de reservas desde Glop primero tendremos que acceder al TPV, después en utilidades y para finalizar en Reserva Online.
Una vez estemos ya en la pestaña de Reservas Online, podremos observar un listado con todas las reservas confirmadas o pendientes de confirmar para así poder gestionarlas individualmente.
Estas reservas, podrán ser canceladas desde el botón cancelar, seleccionando una de ellas.
Para gestionar la reserva, seleccionaremos una de ellas del listado, pulsaremos sobre el botón gestionar. Tras esto se abrirá la pantalla de ventas con la mesa seleccionada, donde podremos añadir artículos o aparcarla vacía. Si la aparcamos vacía aparecerá de color rojo como mesa reservada y si la aparcamos con articulo estará de color azul como mesa ocupada.
Tras gestionar la reserva, si por algún motivo lo deseamos podemos desvincular la reserva de esa mesa, a través del botón desvincular, de forma que la mesa volverá a aparecer en estado libre para ser ocupada.
Nota de funcionamiento
En el caso de haber modificado el APIREST original de la instalación en la nube y/o licencia, es necesario borrar los registros de APIREST_BEARER de la tabla TB_TERMINALES para que conecte correctamente con los nuevos datos generados.
