- ESTADO: ACTIVO
- VERSIÓN COMPATIBLE: 3.2
1. QUÈ ÉS COVERMANAGER? 2. COM FUNCIONA LA INTEGRACIÓ ENTRE COVERMANAGER <-> REVO? 3. INTEGRACIÓ VIA WEBHOOKS 4. INTEGRACIÓ VIA API 5. CONFIGURACIÓ A REVO 6. COM DESACTIVAR LA INTEGRACIÓ
1. QUÈ ÉS COVERMANAGER?
CoverManager és una eina tecnològica per a restaurants que ajuda a eliminar "no shows", augmentar la demanda i fidelitzar clients sense dependre d’un canal de vendes.
Permet gestionar reserves des d’un ordinador o una tauleta, sense necessitat de descarregar aplicacions ni instal·lar programari. És accessible per a qualsevol restaurant i client d’arreu del món.
Consulta més informació aquí.


2. COM FUNCIONA LA INTEGRACIÓ ENTRE COVERMANAGER I REVO?
La integració es pot fer de dues maneres: via Webhooks o API.
-
Webhooks: Revo XEF envia l’estat de la reserva automàticament a CoverManager segons els esdeveniments configurats, com ara una ordre finalitzada perquè CoverManager alliberi la taula.
-
API: Mètode avançat. Permet la connexió directa entre Revo XEF i CoverManager per a l’intercanvi d’informació.
Escull el mètode que millor s’adapti a les teves necessitats.
3. INTEGRACIÓ AMB WEBHOOKS
Per configurar-la, envia un correu a hospitality@covermanager.com amb aquesta informació:
-
Tenant: Nom del teu compte a REVO.
-
Webhook secret: El trobaràs a Compte / WEBHOOKS a la cantonada superior dreta. Més informació aquí.

Després, activa la integració amb CoverManager, explicat aquí.
Finalment, configura els esdeveniments segons les teves necessitats:
1. Accedeix a Compte / WEBHOOKS.
2. Fes clic a + Nou i configura els esdeveniments:
-
order.updated: Per notificar sobre actualitzacions a l’ordre. Exemple: contingut consumit fins al moment. També permet crear un "Walkin At Table" a CoverManager en obrir la taula i afegir productes.
- URL: https://www.covermanager.com/api2/Revo/orderUpdated/{slug de CoverManager} (slug: nom del restaurant a CoverManager).
-
order.closed: Per avisar CoverManager que la taula està tancada, alliberant-la així a CoverManager.
- URL: https://www.covermanager.com/i/revo/orderClosed
Per alinear el teu plànol de taules de Revo XEF amb el de CoverManager, cal exportar el plànol de taules i enviar-lo a CoverManager. Ells s’encarregaran de mapejar les taules al seu sistema, creant una correspondència entre tots dos plànols.
1. Ves a INTEGRACIONS.
2. Fes clic als i selecciona Exportar taules.

4. INTEGRACIÓ AMB API
Per utilitzar l’API, envia un correu a hospitality@covermanager.com amb aquesta informació:
-
Tenant: Nom del teu compte a REVO.
-
Autorització XEF: Genera aquest token a Compte / TOKENS i fes clic a + Nou:

5. CONFIGURACIÓ A REVO
Quan hagis rebut la clau API de CoverManager i el slug (nom del restaurant a CoverManager), configura la integració:
1. Accedeix al back-office de Revo XEF.
2. Ves a INTEGRACIONS.
3. Des del botó + Nou, busca CoverManager i fes clic a + Afegir.

4. Completa la informació:

-
Actiu:
-
Nom: Nom identificatiu de la integració.
-
Test: Desactivat.
-
Clau API: Proporcionada per CoverManager.
-
Restaurant: Slug proporcionat per CoverManager.
-
Separar les taules en tancar: Escull si vols que se separin les taules en tancar l’ordre.
5. Importa les taules des de CoverManager per mantenir la configuració i distribució que ja tens. Ves a Disseny / SALES i fes clic al botó Importar a la cantonada superior dreta.
Després, tanca completament l’app i torna-la a obrir per sincronitzar correctament les sales.
IMPORTANT: Assegura’t de tancar els torns i completar correctament les dades a la pantalla d’integració. Els missatges d’error t’indicaran el motiu si alguna cosa falla:

NOTES IMPORTANTS:
- Creació de noves sales: Un cop activada la integració amb CoverManager, no podràs crear noves sales des del back-office de XEF. La importació de sales elimina el plànol de taules a Revo XEF i el substitueix pel de CoverManager.
- Actualització de claus: Si tens una integració prèvia, sol·licita la nova Clau API i el Restaurant a CoverManager per actualitzar-la, ja que les claus antigues poden no funcionar.
Ja tens la integració configurada completament!
5. FUNCIONAMENT DE LA INTEGRACIÓ
-
Sincronització: REVO sincronitza les reserves amb CoverManager automàticament cada 30-60 segons. Accedeix al menú r i fes clic a Sincronitzar ordres obertes per actualitzar al moment.
-
Taula reservada a CoverManager: Les reserves marcades com "seient" o "arribant" a CoverManager apareixen ocupades (color gris clar) a Revo XEF.
-
Crear una ordre des de REVO: Quan obris una taula o ocupis una taula a Revo XEF, s’enviarà un “walkin” a CoverManager per ocupar aquesta taula.
-
Moure taules des de REVO: En moure taules a Revo XEF, els canvis es reflecteixen a CoverManager.
-
Ajuntar taules: Si ajuntes una taula a Revo XEF, a CoverManager es desbloquejarà, es deixarà amb 0 comensals i s’enviaran els seus productes a la taula de destí.

-
Tancar ordres: Quan tanques una ordre, es desbloqueja la taula en tots dos sistemes enviant a CoverManager el tiquet consumit i els comensals.
Recorda que un cop es fa la integració via API, tota la gestió de reserves, alliberar taules, moure-les o ajuntar-les, s’ha de fer des de Revo XEF.
COMPORTAMENT EN LA CREACIÓ I ACTUALITZACIÓ DE CLIENTS
Quan Cover envia una reserva a través de la nostra API, si la reserva inclou dades de client, XEF comprova si ja existeix un client creat seguint aquest ordre:
- Client amb aquest telèfon i correu
- Client amb aquest telèfon
- Client amb aquest correu
Si es localitza un client existent en qualsevol d'aquestes comprovacions, el sistema actualitza la resta de dades del client amb la informació rebuda des de CoverManager. Si no existeix cap client que coincideixi, llavors es crea un client nou.
Per tant, si una reserva de CoverManager coincideix per telèfon o email amb un client fiscal ja existent a XEF, el sistema pot actualitzar les seves dades amb les dades del reservant, i això pot modificar el nom fiscal d'un client existent.
6. COM DESACTIVAR LA INTEGRACIÓ
Per desactivar la integració amb CoverManager, has de desactivar-la des de INTEGRACIONS i també desactivar el TOKEN creat.

