Impostazioni

L'area Impostazioni raccoglie la configurazione operativa della tua attività — comportamento del Gestore ordini, opzioni di pagamento, misurazione delle zone di consegna, webhook e (per le attività tedesche) l'Impressum previsto dalla legge. Nella Vista Punto Vendita, le impostazioni che modifichi qui valgono per la sede su cui stai lavorando.

Dove si trova Impostazioni#

• Vista: Vista Punto Vendita (alcune schede compaiono anche nella Vista Azienda, con effetto su tutta l'azienda)
• Menu: Negozio & Impostazioni → Impostazioni
• Accesso: Impostazioni richiede un accesso di livello amministratore. La voce di menu compare solo agli account amministratore; gli utenti normali del personale non la vedono.

La pagina Impostazioni è un insieme di schede; facendo clic su una scheda si apre la sottopagina corrispondente. Le schede che vedi dipendono dalla vista in cui ti trovi:

Gli interruttori in queste pagine si salvano subito al clic e lo confermano con "Impostazione salvata con successo".

Gestore ordini#

Impostazioni dell'app Gestore ordini usata per ricevere e gestire gli ordini. Gli interruttori sono raggruppati in tre schede:

Generale#

• Disabilita regolazione orario ordine — "Disabilita la modifica dell'orario dell'ordine nell'app Gestore ordini. Verrà impostato solo l'orario predefinito". Con questa opzione attiva, il personale non può cambiare il tempo di preparazione/consegna quando accetta un ordine.

• Visualizza indirizzo cliente per consegne esternalizzate — mostra l'indirizzo del cliente sugli ordini anche quando la consegna è affidata a un fornitore esterno.

Impostazioni della stampante#

• Nascondi mancia autista sullo scontrino
• Nascondi mancia sullo scontrino

Impostazioni delle prenotazioni dei tavoli#

• Disabilita prenotazioni tavoli — disattiva le prenotazioni dei tavoli per questa sede.

Checkout#

Un solo interruttore:

• Abilita checkout ospite — permette ai clienti di ordinare senza creare un account.

Zone di consegna (solo Vista Azienda)#

Questa scheda compare quando non è selezionata una singola sede, perché si configura per tutta l'azienda:

• Abilita misurazione della distanza su percorso in Google Maps — "Misurazione della distanza lungo il percorso anziché in linea retta". Se attiva, le distanze di consegna (e quindi i costi di consegna basati sulla distanza) vengono calcolate lungo il percorso stradale invece che in linea d'aria.
• Token API Google Cloud — compare quando l'interruttore sopra è attivo. Inserisci il token e fai clic su Salva. Come spiega l'aiuto sullo schermo: "Per misurare la distanza lungo il percorso usiamo la Google Cloud API. Assicurati che il servizio Route API sia abilitato nel tuo account Google Cloud."

Webhook#

I webhook inviano notifiche automatiche a un URL di tua scelta ogni volta che succede qualcosa — ad esempio un nuovo ordine o una prenotazione di un tavolo. Nella Vista Punto Vendita i webhook appartengono alla sede corrente; nella Vista Azienda appartengono a tutta l'azienda.

L'elenco dei webhook#

Colonne: Evento, URL, Stato (Attivo/Inattivo), Firmato (un'icona a lucchetto che significa "Il payload è firmato"), Aggiornata e Azioni (Modifica/Elimina). Quando è vuoto, la pagina mostra "Ancora nessun webhook per questa sede. Aggiungine uno per iniziare a ricevere eventi."

Aggiungere o modificare un webhook#

1. Fai clic su Aggiungi webhook (oppure sul pulsante di modifica su una riga esistente).
2. Evento(obbligatorio) — scegli di che cosa ricevere notifica: Prenotazione tavolo creata, Prenotazione tavolo aggiornata, Cliente creato, Ordine cliente creato, Ordine cliente accettato, Ordine cliente pronto per il ritiro, Ordine cliente in arrivo, Ordine cliente completato, Ordine cliente rifiutato oppure Ordine cliente annullato.
3. URL del payload(obbligatorio) — l'indirizzo a cui inviamo la notifica. Deve essere un URL assoluto valido di al massimo 1024 caratteri; un indirizzo http:// fa comparire l'avviso "L'uso di http:// non è sicuro. Si consiglia vivamente un endpoint https://."
4. Secret di firma(facoltativo, max 255 caratteri) — "Usato per firmare il payload con HMAC-SHA256, così puoi verificare che provenga da noi." Quando modifichi un webhook che ha già un secret, il campo resta bloccato finché non fai clic su Ruota secret; salvando un nuovo valore vuoto il secret esistente viene cancellato, e il modulo ti avvisa prima che succeda.
5. Attivo — attiva o disattiva l'invio di questo webhook.
6. Fai clic su Salva. Compare "Webhook creato" oppure "Webhook aggiornato".

Eliminare un webhook#

Fai clic sull'azione di eliminazione e conferma "Eliminare questo webhook?" — "Gli eventi non verranno più inviati a [l'URL]. L'operazione non può essere annullata."

Come funzionano gli invii#

Un pannello espandibile nella pagina spiega le specifiche tecniche per il tuo sviluppatore: ogni evento viene inviato come HTTP POST con un involucro JSON e intestazioni identificative (tra cui X-Webhook-Event, X-Webhook-Delivery-Id e, se è impostato un secret, X-Webhook-Signature). Il tuo endpoint deve rispondere con HTTP 200; gli invii non riusciti vengono ritentati fino a 6 volte con intervalli crescenti (0s, 15s, 60s, 120s, 240s, 600s). La consegna è di tipo «almeno una volta», quindi i duplicati vanno filtrati usando X-Webhook-Delivery-Id.

Impressum (solo sedi in Germania)#

"La legge tedesca impone a ogni sito web commerciale di mostrare un Impressum (note legali). Le informazioni seguenti vengono pubblicate per questa sede." Questa scheda compare solo nella Vista Punto Vendita per le aziende con sede in Germania, e le note legali si salvano per singola sede. Il modulo è diviso in sezioni; la lunghezza dei testi è limitata e i valori troppo lunghi mostrano "Deve contenere al massimo … caratteri":

Fornitore del servizio#

• Ragione sociale(obbligatorio, max 500) — compresa la forma giuridica, ad es. "Oase Bistro GmbH"
• Nome commerciale(max 200), Forma giuridica(max 100)
• Rappresentanti autorizzati(max 500) — obbligatorio per legge per le persone giuridiche come una GmbH

Sede legale#

• Via e numero civico(obbligatorio, max 250) — non è ammessa una casella postale
• Indirizzo (riga 2)(max 250), CAP(obbligatorio, max 10), Città(obbligatorio, max 200), Paese(max 200)

Contatti#

• Email(obbligatorio, deve essere un indirizzo valido, max 200), Telefono(max 100), Fax(max 100)

Registro e partita IVA#

"Obbligatorio se l'azienda è iscritta a un registro (ad es. una GmbH) o ha una partita IVA." Campi: Tribunale del registro(max 200), Numero di registro(max 100), Partita IVA(max 50), Autorità di vigilanza(max 500, compreso l'indirizzo; obbligatorio per le attività soggette a licenza).

Responsabile dei contenuti#

La persona responsabile dei contenuti redazionali (§ 18 Abs. 2 MStV): Nome(max 200) e Indirizzo(max 500).

Risoluzione delle controversie dei consumatori#

• Partecipa alla risoluzione delle controversie dei consumatori — un interruttore che indica se il fornitore partecipa a procedure davanti a un organismo di conciliazione per i consumatori (§ 36 VSBG)

• Dichiarazione sulla risoluzione delle controversie — indica l'organismo di conciliazione competente se partecipi
• Informazioni aggiuntive — testo libero per eventuali altre dichiarazioni previste dalla legge

Fai clic su Salva per pubblicare ("Impressum creato" / "Impressum aggiornato"). Un Impressum esistente si può rimuovere con il pulsante Elimina Impressum; la conferma avvisa "Le note legali di questa sede verranno rimosse. L'operazione non può essere annullata."

Risoluzione dei problemi#

• Non vedo Impostazioni nel menu. Impostazioni è riservato agli account amministratore; chiedi a un amministratore di fare la modifica per te.
• Manca la scheda Zone di consegna. Compare solo nella Vista Azienda, non quando è selezionata una sede specifica.
• Manca la scheda Impressum. Compare solo nella Vista Punto Vendita e solo per le aziende con sede in Germania.
• Il mio webhook non arriva più. Controlla che sia ancora contrassegnato come Attivo, che il tuo endpoint risponda con HTTP 200, e ricorda che dopo 6 tentativi falliti un invio viene segnato come non riuscito.