Troubleshooting POS

​

Strumento di diagnosi

Rispondi a poche domande per diagnosticare il tuo problema:

---

Questa guida copre i problemi comuni delle integrazioni POS e come risolverli.

​

Problemi di connessione

​

L’integrazione non si connette

Sintomi:

• Errore “Connection failed” durante la configurazione
• Impossibile salvare le impostazioni dell’integrazione
• Il test di connessione fallisce

Soluzioni:

1. Verifica le credenziali
   • Controlla due volte API key, segreti e site ID
   • Assicurati che non ci siano spazi extra nelle credenziali copiate
   • Conferma che le credenziali non siano scadute
2. Controlla lo stato del POS
   • Verifica che il tuo sistema POS sia online
   • Assicurati che la connettività cloud sia abilitata
   • Controlla eventuali disservizi del sistema POS
3. Problemi di rete
   • Conferma che il tuo locale abbia connettività internet
   • Controlla che le impostazioni del firewall non blocchino le chiamate API
   • Se possibile, prova da una rete differente
4. Contatta il tuo provider POS
   • Verifica che l’accesso API sia abilitato sul tuo account
   • Richiedi nuove credenziali se quelle esistenti non funzionano

​

La connessione cade a intermittenza

Sintomi:

• L’integrazione funziona a volte ma non sempre
• Occasionalmente gli ordini non vengono iniettati
• La sincronizzazione a volte si completa, a volte fallisce

Soluzioni:

1. Controlla la stabilità di internet
   • Le connessioni instabili causano fallimenti intermittenti
   • Considera una connessione internet di backup
2. Verifica l’uptime del POS
   • Alcuni sistemi POS si riavviano di notte
   • Controlla se i fallimenti coincidono con le finestre di manutenzione
3. Monitora i limiti API
   • Alcuni sistemi POS hanno rate limit
   • Riduci la frequenza di sincronizzazione se raggiungi i limiti

​

Problemi di sincronizzazione del menu

​

Il menu non si sincronizza

Sintomi:

• Il pulsante di sync non fa nulla
• I prodotti non compaiono dopo la sincronizzazione
• La sync viene eseguita ma il menu è vuoto

Soluzioni:

1. Controlla che l’integrazione sia connessa
   • Vai su Store Settings > Integrations
   • Verifica che il POS risulti connesso
2. Verifica il menu nel POS
   • Assicurati che i prodotti siano attivi/pubblicati
   • Controlla che i prodotti siano assegnati alle categorie
   • Conferma che il tipo di menu sia corretto
3. Prova la sync manuale
   • Usa il pulsante di sync nella sezione Menu
   • Aspetta che la sync si completi
   • Controlla eventuali messaggi di errore

​

Prodotti mancanti dopo la sync

Sintomi:

• Alcuni prodotti si sincronizzano ma altri no
• I modificatori sono mancanti
• Le categorie sono incomplete

Soluzioni:

1. Controlla lo stato del prodotto nel POS
   • I prodotti devono essere attivi/abilitati
   • I prodotti devono essere assegnati a un menu
   • Controlla le impostazioni di visibilità del prodotto
2. Rivedi la struttura del menu
   • I prodotti al di fuori delle categorie potrebbero non sincronizzarsi
   • Alcune integrazioni sincronizzano solo tipi specifici di menu
   • Verifica che sia selezionato il menu corretto
3. Controlla eventuali errori di sync
   • Rivedi eventuali messaggi di errore dopo la sync
   • Singoli prodotti possono fallire mentre altri hanno successo

​

I prezzi sono sbagliati

Sintomi:

• I prezzi sincronizzati non corrispondono al POS
• I prezzi sono raddoppiati o dimezzati
• Le tasse appaiono in modo errato

Soluzioni:

1. Disallineamento delle impostazioni fiscali
   • Controlla se i prezzi del POS includono le tasse
   • Verifica che le impostazioni fiscali di storekit corrispondano
   • Assicurati che le aliquote fiscali siano configurate correttamente
2. Problemi di valuta
   • Conferma che le impostazioni di valuta corrispondano
   • Controlla eventuali differenze di cifre decimali
3. Ri-sincronizza dopo le modifiche
   • I prezzi non si aggiornano finché non sincronizzi
   • Attiva una sync manuale dopo le modifiche di prezzo nel POS

​

Problemi di iniezione ordini

​

Gli ordini non compaiono nel POS

Sintomi:

• Il cliente riceve la conferma
• L’ordine compare nella dashboard storekit
• L’ordine non compare mai nel POS

Soluzioni:

1. Controlla lo stato dell’integrazione
   • Verifica che l’integrazione sia abilitata
   • Controlla eventuali avvisi di disconnessione
2. Rivedi l’ordine nella dashboard
   • Guarda i dettagli dell’ordine per eventuali errori
   • Controlla il campo di stato dell’iniezione POS
3. Verifica che il POS sia online
   • Controlla che il terminale sia acceso
   • Conferma la connettività di rete
   • Prova a inserire un ordine direttamente nel POS
4. Controlla i codici PLU (linking manuale)
   • Assicurati che tutti gli articoli abbiano PLU validi
   • Verifica che i PLU esistano nel sistema POS
5. Controlla le notifiche email
   • Se l’iniezione dell’ordine fallisce, riceverai una notifica email
   • L’email include il motivo specifico dell’errore e i dettagli dell’ordine
   • Controlla che l’indirizzo email del locale sia configurato correttamente

​

Ordini in ritardo

Sintomi:

• Gli ordini arrivano nel POS con minuti/ore di ritardo
• I pre-ordini arrivano ai tempi sbagliati
• Gli ordini ASAP sono in ritardo

Soluzioni:

1. Controlla le impostazioni di iniezione
   • Rivedi la tempistica di iniezione dei pre-ordini
   • Verifica che gli ordini ASAP siano impostati come immediati
2. Latenza di rete
   • Le connessioni lente ritardano l’iniezione
   • Controlla le performance complessive della rete
3. Problemi di coda del POS
   • Alcuni sistemi POS mettono in coda gli ordini in arrivo
   • Controlla le impostazioni POS per l’elaborazione degli ordini

​

Articoli mancanti dagli ordini

Sintomi:

• L’ordine compare ma mancano articoli
• I modificatori non compaiono
• Ordine parziale nel POS

Soluzioni:

1. Problemi di mapping PLU
   • PLU mancanti fanno fallire gli articoli
   • Controlla che tutti i prodotti e modificatori abbiano PLU
2. Disallineamento prodotto
   • L’articolo potrebbe essere stato eliminato dal POS
   • Ri-sincronizza il menu per aggiornare i mapping
3. Configurazione dei modificatori
   • Verifica che i modificatori siano collegati correttamente
   • Controlla le impostazioni del gruppo di modificatori

​

Articoli sbagliati negli ordini

Sintomi:

• Il POS mostra articoli diversi da quelli ordinati
• Le quantità sono sbagliate
• I modificatori sono applicati agli articoli sbagliati

Soluzioni:

1. Codici PLU errati
   • Un PLU sbagliato mappa al prodotto sbagliato
   • Fai audit dei mapping PLU rispetto al POS
2. PLU duplicati
   • Lo stesso PLU usato per più prodotti
   • Assicurati che i PLU siano univoci
3. Modifiche recenti al menu
   • I prodotti potrebbero essere stati rimappati
   • Ri-sincronizza e verifica i mapping

​

Problemi di sconti e fedeltà

​

Gli sconti non si applicano

Sintomi:

• Gli sconti fedeltà non compaiono
• I prezzi promozionali non funzionano
• Il saldo cliente non è riflesso

Soluzioni:

1. Verifica che lo sconto sia attivo
   • Controlla che la promozione sia abilitata nel POS
   • Conferma che l’intervallo di date sia corrente
   • Verifica che i termini siano rispettati
2. Qualifica del cliente
   • Controlla che il cliente sia iscritto al programma fedeltà
   • Verifica che il cliente soddisfi i criteri dello sconto
   • Conferma che gli ordini online siano idonei
3. Impostazioni di integrazione
   • Alcuni sconti richiedono un’abilitazione esplicita
   • Controlla le impostazioni di sync degli sconti

​

Importi di sconto sbagliati

Sintomi:

• Lo sconto viene applicato ma l’importo è sbagliato
• La percentuale è calcolata in modo errato
• Lo sconto compare due volte

Soluzioni:

1. Controlla le regole di sconto
   • Verifica il metodo di calcolo dello sconto
   • Controlla le regole di stacking
2. Interazione con le tasse
   • Conferma se lo sconto si applica prima/dopo le tasse
   • Controlla che entrambi i sistemi usino lo stesso metodo

​

Notifiche email per sincronizzazioni fallite

storekit invia automaticamente notifiche email quando gli ordini o i pagamenti non riescono a sincronizzarsi con il tuo POS, garantendoti di non perdere mai informazioni critiche.

​

Notifiche di ordini falliti

Quando un ordine non riesce a sincronizzarsi con il tuo POS, riceverai un’email che include:

• Dettagli ordine — nome cliente, ID ordine e metodo di pagamento
• Motivo dell’errore — dettagli tecnici specifici sul perché la sync è fallita
• Articoli dell’ordine — un riepilogo di cosa è stato ordinato (con immagini quando disponibili)
• Azioni rapide — link diretto per visualizzare l’ordine nella tua dashboard

​

Cosa fare quando ricevi un’email di ordine fallito

1. Controlla il motivo dell’errore — l’email include dettagli specifici sul perché la sync è fallita
2. Visualizza l’ordine nella dashboard — clicca sul link nell’email per vedere i dettagli completi dell’ordine
3. Correggi la causa sottostante — ad esempio, riaccendi il terminale POS o l’app iPad, oppure disattiva lo snooze di un modificatore richiesto che manca dall’ordine
4. Rinvia manualmente l’ordine al tuo POS — apri l’ordine, clicca su More actions, poi Resend order to POS. La dashboard conferma con Queued POS order injection retry e l’ordine viene inviato di nuovo al tuo POS
5. Inserisci l’ordine manualmente — se il retry fallisce ancora, inserisci l’ordine direttamente nel tuo POS come ripiego
6. Contatta il supporto — se il problema persiste, il nostro team di supporto è già stato avvisato e può aiutarti a risolverlo

​

Notifiche di fallimento pagamento conto

Quando un pagamento Pay at Table va a buon fine ma non riesce a sincronizzarsi con il tuo POS, riceverai una notifica email. Questo è critico perché il cliente ha già pagato, ma il tuo POS potrebbe non rifletterlo. La notifica include:

• Dettagli conto — ID conto e nome del locale
• Informazioni pagamento — ID pagamento e dettagli della transazione
• Motivo dell’errore — dettagli tecnici specifici sul perché la sync è fallita
• Reference ID — sia gli ID del conto storekit che quelli del POS per la riconciliazione
• Azioni rapide — link diretto per visualizzare il conto nella tua dashboard

​

Cosa fare quando ricevi un’email di fallimento pagamento conto

1. Controlla i dettagli dell’errore — l’email include informazioni specifiche sul perché la sync è fallita
2. Visualizza il conto nella dashboard — clicca sul link per vedere i dettagli completi del pagamento
3. Riconcilia manualmente nel POS — se necessario, marca il conto come pagato nel tuo POS
4. Contatta il supporto — il nostro team viene automaticamente notificato e può aiutare con problemi ricorrenti

​

Assicurarti di ricevere le notifiche

Assicurati che l’indirizzo email del tuo locale sia configurato correttamente:

1. Vai su Store Settings nella tua dashboard
2. Naviga su Store Details
3. Verifica che il tuo indirizzo email sia corretto
4. Aggiungi più indirizzi email se necessario (il primo riceverà le notifiche)

​

Ottenere aiuto

Se hai provato queste soluzioni e hai ancora problemi:

1. Raccogli informazioni
   • Annota i messaggi di errore specifici
   • Registra gli ID degli ordini interessati
   • Fai screenshot se possibile
   • Controlla le notifiche email di ordini falliti
2. Controlla lo stato del provider POS
   • Cerca eventuali problemi a livello di sistema
   • Contatta il supporto POS per la loro parte
3. Contatta il supporto storekit
   • Fornisci ID ordine e dettagli errore
   • Condividi le impostazioni di integrazione (non le credenziali)
   • Inoltra eventuali notifiche email di ordini falliti

Contatta il supporto per ulteriore assistenza.