Skip to main content
Problemi comuni dell’integrazione Syrve e come risolverli. Se sei ancora bloccato, contatta il supporto storekit.

Connessione

«Syrve» non compare nel mio elenco Integrations

L’integrazione non è abilitata per il tuo account. Contatta il supporto per farla attivare.

«We could not reach Syrve’s API with the configured API key»

L’API Login salvato non funziona — è digitato male, revocato o non ancora rilasciato per l’accesso API. Reinseriscilo in Syrve API Settings (usa l’icona a matita per sostituirlo). storekit valida la credenziale con Syrve prima di salvarla, quindi un valore che si salva con successo è un valore che funziona.

Non riesco a salvare le impostazioni

Prima di poter salvare le impostazioni occorre selezionare un’Organization — la pagina ti chiede di selezionarne una.

Sincronizzazione del menu

Il pulsante Sync menu è disabilitato

  • Occorre selezionare un External Menu.
  • Il negozio deve avere un menu storekit attivo.

Il menu a tendina External Menu è vuoto

Gli external menu vengono creati in Syrve Office. Creane uno lì (e assicurati che la tua Organization sia quella giusta), poi riapri la pagina.

Gli articoli mostrano £0

Syrve non ha restituito un prezzo per quegli articoli — una lacuna nota in alcuni external menu di Syrve. Correggi i prezzi in Syrve Office ed esegui di nuovo Sync menu. Impostare il prezzo in storekit non è una soluzione duratura: la prossima sync lo sostituisce con quanto restituito da Syrve.

Mancano articoli o modificatori

Vengono importati solo i contenuti visibili nell’external menu di Syrve — articoli, dimensioni e gruppi di modificatori nascosti in Syrve vengono saltati, così come i gruppi di modificatori senza opzioni visibili. Controlla l’external menu in Syrve Office e risincronizza.

Un articolo disponibile risulta esaurito (o viceversa)

La disponibilità segue la stop list di Syrve per il tuo Terminal Group — vedi Scorte e disponibilità per le regole esatte (incluso il motivo per cui un articolo in stop list con scorta rimanente resta in vendita). I webhook consegnano le modifiche della stop list in tempo reale; senza di essi, l’elenco viene riletto solo alla sync del menu — esegui Sync menu per forzare una riconciliazione, e configura i webhook affinché resti aggiornato.

Ordini

Gli ordini non arrivano in cassa

Un ordine fallito viene contrassegnato come failed in storekit con l’errore Syrve sull’ordine; l’ordine del cliente si conclude comunque. Cause comuni:
  • Il terminal group è dormiente — l’errore menziona un timeout. Questo è il fallimento più comune e ha una guida dedicata: sveglia la cassa e nota che Syrve rifiuta un rinvio di un ordine andato in timeout come duplicato — battilo manualmente.
  • Nessun tipo d’ordine per il metodo di evasione — imposta Delivery Order Type, Pickup Order Type o Table Order Type in Syrve Order Complications, poi apri l’ordine e usa Resend order to POS.
  • L’integrazione è configurata solo in parte — sia Organization che Terminal Group devono essere impostati; correggi e rinvia.
  • Un articolo non può essere abbinato sul POS — il menu in cassa è cambiato dall’ultima importazione. Esegui Sync menu, poi rinvia.

Il pagamento non è sull’ordine Syrve

Imposta Cash Payment Type e Card Payment Type in Syrve Order Complications. Gli ordini effettuati mentre uno dei due manca vengono inviati senza pagamento — lo staff deve chiuderli in cassa.

Il coperto sullo scontrino non corrisponde all’ordine

La Service Charge selezionata è una maggiorazione percentuale in Syrve, che ricalcola la propria percentuale sul POS e ignora l’importo inviato da storekit. Usa invece una maggiorazione a somma flessibile da Syrve Office. Ricorda che il costo di consegna viene incorporato nella stessa maggiorazione, quindi sugli ordini di consegna la cifra combinata è quella attesa.

Gli stati degli ordini non si aggiornano in storekit

Gli aggiornamenti di stato arrivano via webhook. Controlla Syrve Webhooks nella pagina Syrve Settings — se il pannello dice Webhooks not configured, clicca Setup webhooks. Se hai cambiato Organization, salva e riconfigura i webhook.

Syrve dice che l’ordine è stato annullato, ma è ancora attivo in storekit

È voluto: uno scontrino stornato in cassa non annulla un ordine storekit pagato alle tue spalle. storekit segnala l’ordine; annullalo (e rimborsalo) in storekit se è ciò che deve accadere.

Un ordine storekit annullato è ancora in cassa

  • L’annullamento raggiunge Syrve solo per gli ordini di ritiro e consegna — i conti al tavolo devono essere stornati in cassa.
  • Occorre selezionare una Cancel Cause in Syrve Order Complications; Syrve rifiuta gli annullamenti che ne sono privi.

Correlati