Cosa ottieni
- Iniezione degli ordini — gli ordini online vengono inviati direttamente a Centegra
- Mapping tavoli — instrada gli ordini dine-in a una Location Centegra e a un tavolo per POS ID
- Linking manuale dei prodotti — controllo completo sulla presentazione del tuo menu online
Iniziare
Cosa serve
Contatta il tuo account manager Centegra per ottenere:- Secure Key — la tua API key a livello aziendale
- Site ID — identifica la tua specifica sede
Connessione a Centegra
- Vai su Settings > Integrations nella tua dashboard storekit
- Seleziona Centegra
- Inserisci la tua Secure Key
- Clicca su Connect
Selezione del tuo site
Dopo la connessione a livello di account:- Vai su Stores → il tuo store → Settings → Integrations → Centegra
- Seleziona il tuo Site Centegra tra le opzioni disponibili
- Il Site ID viene salvato per l’instradamento degli ordini
Configurazione delle impostazioni del locale
Ogni locale richiede specifiche impostazioni Centegra:Collegare i prodotti
Centegra utilizza il linking manuale dei prodotti — i prodotti non vengono sincronizzati automaticamente dal tuo POS.Come funziona
- Crea il tuo menu in storekit con categorie, prodotti e modificatori
- Per ogni prodotto, inserisci il suo Centegra Product ID nel campo POS ID
- Per ogni modificatore, inserisci il suo Centegra Product ID
- Quando vengono effettuati ordini, storekit invia i Product ID a Centegra
Trovare i Product ID
Puoi trovare i tuoi Centegra Product ID in:- Il back office Centegra alla voce Products
- Report di export prodotti
- Contattando il tuo team di supporto Centegra
Collegare i modificatori
Anche i modificatori necessitano dei Product ID da Centegra:- Vai ai tuoi gruppi di modificatori in storekit
- Per ogni opzione di modificatore, inserisci il suo Centegra Product ID
- I modificatori vengono inviati come articoli figli collegati al loro prodotto genitore
Come funzionano gli ordini
Flusso ordine
- Il cliente effettua l’ordine sul tuo store storekit
- L’ordine viene validato con Centegra (
TransactionValidate) - Se valido, l’ordine viene inviato (
Transaction) - L’ordine compare in Centegra sulla cassa configurata
- Il cliente riceve la conferma con l’ID della transazione
Se un ordine non riesce a sincronizzarsi con Centegra, riceverai una notifica email con i dettagli dell’errore e un link diretto all’ordine nella tua dashboard.
Tipi di ordine
Cosa riceve Centegra
Ogni ordine include:- ID transazione esterno (basato su timestamp)
- ID di location, cassa e clerk
- Tutti gli articoli con Product ID, quantità e prezzi
- Modificatori come articoli figli collegati ai genitori
- Sconti calcolati distribuiti tra gli articoli
- Dettagli pagamento con media ID
- Nome, email e telefono del cliente
- Numero di riferimento dell’ordine
- Ora di inizio preparazione (per la pianificazione)
- Note dell’ordine
Sconti
Quando viene applicato uno sconto:- L’importo dello sconto viene distribuito proporzionalmente su tutti gli articoli
- Ogni articolo mostra il prezzo unitario, il totale lordo e l’importo dello sconto
- Centegra riceve la scomposizione completa dello sconto
Mance
Le mance vengono gestite come una voce di pagamento negativa, mantenendo il totale dell’ordine accurato pur tracciando separatamente la gratifica.Tavoli e instradamento dine-in
La pagina impostazioni Centegra non ha una planimetria né un pulsante di sync dei tavoli. Crea le tue aree e i tavoli in storekit (vedi tavoli dine-in) e assegna a ciascun tavolo il POS ID Centegra corrispondente, così che gli ordini dine-in vengano instradati al tavolo corretto all’interno della Location configurata.Troubleshooting
Problemi di connessione
“Secure Key not found”- Verifica che la tua Secure Key sia inserita correttamente a livello di account
- Contatta il supporto Centegra per confermare l’accesso API
- Controlla che il Site ID corrisponda alla tua sede in Centegra
- Assicurati che la tua Secure Key abbia accesso a questo site
Problemi con gli ordini
Ordini falliscono la validazione- Controlla che tutte le impostazioni del locale siano configurate (location, cassa, clerk, ecc.)
- Verifica che la Till Secure Key sia corretta
- Assicurati che tutti i prodotti abbiano Centegra Product ID validi
- L’articolo in questione manca del suo Centegra Product ID
- Modifica il prodotto in storekit e aggiungi il POS ID
- Un’opzione di modificatore manca del Product ID
- Modifica il modificatore e aggiungi il Centegra Product ID
Articoli o prezzi sbagliati
- Verifica che i Product ID corrispondano tra storekit e Centegra
- Controlla che l’impostazione Price Level sia corretta per il tuo menu online
- Assicurati che le aliquote fiscali siano configurate sui prodotti
Gli ordini dine-in non arrivano al tavolo corretto
- Conferma che il tuo locale abbia un Site ID valido (posId)
- Controlla che la Location selezionata nelle impostazioni Centegra di storekit esista in Centegra
- Verifica che ogni tavolo storekit abbia il POS ID del tavolo Centegra corrispondente
Checklist di go-live
Prima del lancio:- Secure Key inserita a livello di account
- Impostazioni del locale configurate (location, cassa, clerk, media, source, price level)
- Tutti i prodotti hanno Centegra Product ID
- Tutti i modificatori hanno Centegra Product ID
- Effettua un ordine di test pickup
- Verifica che l’ordine compaia sulla cassa corretta in Centegra
- Controlla che articoli, modificatori e prezzi siano corretti
- Testa un ordine di delivery con indirizzo completo
- Crea i tavoli in storekit con i loro POS ID Centegra (se usi il dine-in)
Funzionalità supportate
Ordini
Ordini
Pay at Table
Pay at Table
Configurazione locale
Configurazione locale