Collega Loyverse al tuo store Snapbyte
Se nel tuo locale usi Loyverse come punto vendita (POS), puoi collegarlo a Snapbyte in modo che gli ordini dal tuo menu digitale confluiscano direttamente in Loyverse come ricevute — senza reinserimento manuale, senza scontrini persi.
La connessione si configura nell'Admin Hub e richiede un paio di minuti. Ci sono due modi per autenticarti: accedere direttamente con Loyverse (consigliato) oppure incollare un token di accesso personale.
Prima di iniziare
- Hai accesso come Proprietario o Manager all' Admin Hub di Snapbyte.
- Lo store Snapbyte che vuoi collegare è selezionato nel selettore store in cima alla barra laterale dell'Admin Hub.
- Se gestisci più locali, ripeti questi passaggi una volta per ogni store — ogni store Snapbyte si collega a una sede Loyverse.
1. Apri l'integrazione Loyverse
Nell'Admin Hub, vai su Impostazioni → Integrazioni, trova Loyverse e clicca su Connetti.
2. Scegli come autenticarti
Vedrai due opzioni. Scegli quella che preferisci — entrambe portano allo stesso selettore di store nel passaggio successivo.
Accedi con Loyverse (consigliato)
Clicca su Accedi con Loyverse. Si apre una finestra di autorizzazione Loyverse in un popup — accedi con il tuo account Loyverse e approva la richiesta di accesso.
Una volta confermato, Loyverse invia automaticamente a Snapbyte un token sicuro. Non devi mai incollare credenziali in Snapbyte.
I token ottenuti tramite Accedi con Loyverse si aggiornano automaticamente in background. La tua integrazione continua a funzionare senza che tu debba fare nulla.
Token di accesso personale
Clicca su Usa invece un token di accesso se preferisci connetterti con un token che generi tu stesso.
- In una nuova scheda, accedi a back.loyverse.com.
- Vai su Impostazioni → Token API.
- Clicca su Crea token API, dagli un nome (es. Snapbyte) e copia il token generato.
- Incolla il token nel campo mostrato nell'Admin Hub e clicca su Continua.
Se il token viene revocato o scade, gli ordini smetteranno di arrivare e dovrai riconnetterti incollando un nuovo token. Trattalo come una password e tienilo al sicuro.
3. Seleziona il tuo store Loyverse
Dopo l'autenticazione con uno dei due metodi, Snapbyte carica le tue sedi Loyverse e, facoltativamente, le tue aliquote fiscali.
- Scegli la sede in Loyverse dove devono comparire gli ordini Snapbyte.
- Facoltativamente scegli un'aliquota fiscale da applicare a quelle ricevute, oppure lascia su Auto per lasciare decidere a Loyverse.
- Clicca su Conferma.
Il riquadro Loyverse nell'Admin Hub mostrerà un badge verde Connesso.
4. Verifica che funzioni
Prima, conferma che il riquadro Loyverse mostri il badge verde Connesso. Poi, entro 2–3 minuti, apri la sezione Menu nell'Admin Hub e verifica che le tue categorie, articoli e modificatori siano comparsi. Se puoi vedere il menu completo, l'integrazione funziona correttamente.
Loyverse registra gli ordini online come ricevute chiuse, non come ticket aperti. Ciò significa che gli ordini di Snapbyte appaiono immediatamente nella cronologia delle vendite e nei report, ma non possono essere modificati in Loyverse una volta arrivati.
Cosa succede una volta connesso
- Menu — le tue categorie, articoli e modificatori di Loyverse si sincronizzano in Snapbyte entro 2–3 minuti dalla connessione. Foto e dettagli aggiuntivi possono essere aggiunti nell'Admin Hub una volta che il menu è stato caricato.
- Ordini — ogni ordine effettuato sul tuo storefront Snapbyte viene inviato a Loyverse come ricevuta, attribuita alla sede che hai scelto.
- Dati di vendita — le ricevute si sommano ai tuoi totali, report e deduzioni di inventario di Loyverse, esattamente come qualsiasi altra vendita.
Disconnettersi
Per smettere di inviare ordini a Loyverse, vai su Impostazioni → Integrazioni nell'Admin Hub, apri il riquadro Loyverse e clicca su Disconnetti. Gli ordini già registrati in Loyverse non vengono modificati. Puoi riconnetterti in qualsiasi momento.
Risoluzione dei problemi
Il popup di autorizzazione Loyverse è stato bloccato. Consenti i popup per l'Admin Hub nelle impostazioni del browser, poi riprova.
"Token non valido" quando provo a salvare (opzione token). Copia di nuovo il token da Loyverse — anche un singolo carattere mancante non supera la validazione. Assicurati che non ci siano spazi iniziali o finali quando lo incolli.
Gli ordini non compaiono in Loyverse. Controlla che il riquadro Loyverse nell'Admin Hub mostri ancora Connesso. Se mostra Disconnesso, riconnettiti. Verifica inoltre di aver scelto la sede Loyverse corretta — gli ordini vanno solo alla sede selezionata in fase di configurazione.
Gli articoli nelle ricevute Loyverse hanno nomi inattesi. I nomi dei prodotti provengono dal tuo menu Snapbyte. Se hai rinominato un articolo nell'Admin Hub dopo la connessione, il nuovo nome apparirà sulle ricevute future.
Non vedo Loyverse in Impostazioni → Integrazioni. Loyverse potrebbe non essere ancora abilitato per il tuo piano o la tua regione. Consulta i problemi comuni o contatta l'assistenza dall'Admin Hub.
FAQ
Quale metodo di connessione dovrei usare? Accedi con Loyverse quando possibile — è più sicuro (nessun token da copiare o conservare) e rimane connesso più a lungo grazie all'aggiornamento automatico del token. L'opzione con token di accesso personale è utile se il popup di autorizzazione è bloccato nel tuo ambiente, o se preferisci gestire tu stesso la durata dei token di accesso.
Devo inserire la mia password Loyverse da qualche parte in Snapbyte? No. Con Accedi con Loyverse, inserisci le tue credenziali sul sito di Loyverse — Snapbyte vede solo il token sicuro emesso da Loyverse. Con l'opzione token, incolli solo un token API, mai la tua password.
E se ho più di una sede Loyverse? Durante la configurazione scegli quale sede riceve gli ordini. Se vuoi che un secondo store Snapbyte invii ordini a una sede diversa, collega quello store separatamente con la propria integrazione.
Posso cambiare la sede dopo la connessione? Disconnettiti e riconnettiti — ti verrà chiesto di scegliere nuovamente una sede.
Sei nuovo su Snapbyte? Inizia con la guida creare uno store da zero.