Connecta Loyverse a la teua botiga de Snapbyte
Si el teu local utilitza Loyverse com a TPV, pots connectar-lo a Snapbyte perquè les comandes de la teua carta digital fluïsquen directament a Loyverse com a rebuts — sense tornar a introduir-les manualment, sense perdre cap tiquet.
La connexió es configura a l'Admin Hub i tarda un parell de minuts. Hi ha dos maneres d'autenticar-se: iniciant sessió directament amb Loyverse (recomanat) o apegant un token d'accés personal.
Abans de començar
- Tens accés de Propietari o Gerent a l' Admin Hub de Snapbyte.
- La botiga de Snapbyte que vols connectar està seleccionada al selector de botiga de la part superior de la barra lateral de l'Admin Hub.
- Si gestiones diversos locals, repetix estos passos una vegada per botiga — cada botiga de Snapbyte es connecta a una ubicació de Loyverse.
1. Obri la integració de Loyverse
A l'Admin Hub, ves a Configuració → Integracions, cerca Loyverse i fes clic a Connecta.
2. Tria com autenticar-te
Veuràs dos opcions. Tria la que més et convinga — les dos porten al mateix selector de botiga en el pas següent.
Inicia sessió amb Loyverse (recomanat)
Fes clic a Inicia sessió amb Loyverse. S'obri una finestra d'autorització de Loyverse en una finestra emergent — inicia sessió amb el teu compte de Loyverse i aprova la sol·licitud d'accés.
Una vegada confirmes, Loyverse envia a Snapbyte un token segur automàticament. Mai no apegues credencials a Snapbyte.
Els tokens obtinguts mitjançant Inicia sessió amb Loyverse es renoven automàticament en segon pla. La teua integració continua funcionant sense cap acció per la teua part.
Token d'accés personal
Fes clic a Utilitza un token d'accés si prefereixes connectar-te amb un token que generes tu mateix.
- En una pestanya nova, inicia sessió a back.loyverse.com.
- Ves a Configuració → Tokens d'API.
- Fes clic a Crea un token d'API, posa-li un nom (p. ex. Snapbyte) i copia el token generat.
- Apega el token al camp que es mostra a l'Admin Hub i fes clic a Continua.
Si el token es revoca o caduca, les comandes deixaran d'arribar i hauràs de tornar a connectar-te apegant un token nou. Tracta'l com una contrasenya i guarda'l en un lloc segur.
3. Selecciona la teua botiga de Loyverse
Després d'autenticar-te amb qualsevol dels dos mètodes, Snapbyte carrega les teues ubicacions de Loyverse i, opcionalment, els teus tipus impositius.
- Tria la ubicació de la botiga a Loyverse on han d'aparèixer les comandes de Snapbyte.
- Opcionalment, tria un tipus impositiu per aplicar a eixos rebuts, o deixa-ho en Automàtic perquè Loyverse ho decidisca.
- Fes clic a Confirma.
La targeta de Loyverse a l'Admin Hub mostrarà una insígnia verda de Connectat.
4. Verifica que funciona
Primer, confirma que la targeta de Loyverse mostra la insígnia verda de Connectat. Després, en 2–3 minuts, obri la secció Carta en l'Admin Hub i comprova que les teues categories, articles i modificadors han aparegut. Si pots veure la carta completa, la integració funciona correctament.
Loyverse registra les comandes en línia com a rebuts tancats, no com a tiquets oberts. Açò significa que les comandes de Snapbyte apareixen immediatament en l'historial de vendes i els informes, però no es poden editar en Loyverse una vegada que han arribat.
Què passa una vegada estàs connectat
- Carta — les teues categories, articles i modificadors de Loyverse es sincronitzen en Snapbyte en 2–3 minuts després de la connexió. Les fotos i els detalls addicionals es poden afegir en l'Admin Hub una vegada que la carta s'haja carregat.
- Comandes — cada comanda feta en la teua botiga de Snapbyte s'envia a Loyverse com un rebut, atribuït a la ubicació que has triat.
- Dades de vendes — els rebuts se sumen als teus totals, informes i deduccions d'inventari de Loyverse, igual que qualsevol altra venda.
Desconnectar
Per deixar d'enviar comandes a Loyverse, ves a Configuració → Integracions a l'Admin Hub, obri la targeta de Loyverse i fes clic a Desconnecta. Les comandes ja registrades a Loyverse no es veuen afectades. Pots tornar a connectar-te quan vulgues.
Resolució de problemes
La finestra emergent d'autorització de Loyverse ha sigut bloquejada. Permet les finestres emergents per a l'Admin Hub a la configuració del teu navegador i torna-ho a intentar.
"Token no vàlid" quan intente desar (opció de token). Copia el token de nou des de Loyverse — un únic caràcter que falte farà que la validació falle. Assegura't que no hi ha espais al principi ni al final quan apegues.
Les comandes no apareixen a Loyverse. Comprova que la targeta de Loyverse a l'Admin Hub continua mostrant Connectat. Si mostra Desconnectat, torna a connectar-te. Confirma també que has triat la ubicació correcta de Loyverse — les comandes van únicament a la ubicació que has seleccionat durant la configuració.
Els articles dels rebuts de Loyverse tenen noms inesperats. Els noms dels productes provenen de la teua carta de Snapbyte. Si has canviat el nom d'un article a l'Admin Hub després de connectar-te, el nom nou apareixerà als rebuts futurs.
No veig Loyverse a Configuració → Integracions. És possible que Loyverse no estiga activat per al teu pla o la teua regió encara. Consulta els problemes habituals o contacta amb el suport des de l'Admin Hub.
Preguntes freqüents
Quin mètode de connexió hauria d'utilitzar? Inicia sessió amb Loyverse sempre que siga possible — és més segur (no cal copiar ni guardar cap token) i es manté connectat durant més temps gràcies a la renovació automàtica del token. L'opció de token d'accés personal és útil si la finestra emergent d'autorització està bloquejada en el teu entorn, o prefereixes controlar tu mateix la vida útil dels tokens d'accés.
He d'introduir la meua contrasenya de Loyverse en algun lloc de Snapbyte? No. Amb Inicia sessió amb Loyverse, introdueixes les teues credencials al propi lloc web de Loyverse — Snapbyte només veu el token segur que emet Loyverse. Amb l'opció de token, apegues únicament un token d'API, mai la teua contrasenya.
Què passa si tinc més d'una ubicació de Loyverse? Durant la configuració tries quina ubicació rep les comandes. Si vols que una segona botiga de Snapbyte envie a una ubicació diferent, connecta eixa botiga per separat amb la seua pròpia integració.
Puc canviar la ubicació després de connectar-me? Desconnecta't i torna a connectar-te — se't demanarà que tries una ubicació de nou.
Ets nou a Snapbyte? Comença per crear una botiga des de zero.