En este manual vamos a detallar los diferentes módulos, su configuración y funcionamiento de app.glop.es
Módulo Informes:
Configuración:
En los informes podremos configurar el tipo de gráfico, activar/desactivar cada uno de los informes, configurar el refresco automatico, la comparativa, el envío de informes…
Informes Venta:
En el vídeo podemos observar su funcionamiento con los diferentes filtros y comparativas
Informes compra:
Módulo artículos:
El módulo de articulos nos permite ver todos los artículos de los que disponemos, y en caso de tener permisos, modificar el precio de las diferentes tarifas de cada uno de los artículos.
Módulo stock
Podremos consultar el stock de los diferentes artículos en cada uno de los almacenes.
Módulo clientes
En el módulo de clientes, podremos ver, editar, eliminar y crear clientes. Dentro de los datos de cada uno de los clientes, podremos ver sus datos como nobre apellidos email… sus datos fiscales y sus datos adicionales (indicar que tiene una alergia o cualquier cosa que se necesite). En la pestaña de facturación podremos ver su registro de pagos online, los diferentes planes activados (suscripciones), y sus facturas de los últimos años. En la pestaña mensajes podremos enviarle un mensaje a través de un email o SMS. Y en la de documentos podremos subir diferentes documentos asociados al cliente, como un compromiso de confidencialidad, un presupuesto etc…
*A TENER EN CUENTA
Los mensajes a un cliente a través de SMS están condicionados a pago, y este pago va en función de la cantidad de SMS contratados. Si no es activado o se ha terminado el saldo de SMS no se realizará el envío.
Pestaña facturación:
En este vídeo podremos observar las diferentes acciones de la pestaña de facturación, generacion de pagos y como se muestran una vez han sido pagados por el cliente.
El objetivo es proporcionar a los usuarios de Glop una opción configurable donde el cierre de caja (no el turno) se realice automáticamente después de una hora establecida. Cabe destacar que el cierre automático de caja no se llevará a cabo si hay notas pendientes sin pagar y aparcadas. Si el sistema detecta esto y ha sido configurado, Glop realizará tantos intentos como se hayan asignado en la configuración dentro del marco de tiempo especificado.
Comprobaciones Previas
¿Requiere licencia de módulo?
NO
¿Qué tipo de licencia usa la integración?
Todas
Otros requisitos
NO
Configuración Inicial
La configuración se encuentra en Mi Glop – Cierre de caja automático
Operativa de trabajo
La operación es sencilla. Al activar el proceso en un momento específico, cuando llegue ese momento, la caja registradora se cerrará automáticamente siempre que no haya documentos de ventas en espera. Si los hay y está configurado para hacerlo, Glop intentará X veces hasta que no encuentre facturas sin facturar.
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.
