La pagina Come assegnare i timbri

La pagina «Come assegnare i timbri» del pannello elenca otto modi per timbrare: «Manuale», Kiosk Mode, «QR dello scontrino fiscale», «QR stampato sul tuo scontrino», Terminal Mode, Delivery Inserts, «Integrazione API» e Autopilot Mode. Ogni modo mostra i suoi passi, dove si configura e, se ne serve uno, il login del personale con cui accedere.
La pagina mostra uno dei due modi con lo scontrino: «QR dello scontrino fiscale» quando il Paese della tua attività è uno di quelli in cui gli scontrini fiscali si possono scansionare, e «QR stampato sul tuo scontrino» ovunque altrove. Finché la tua attività non ha ciò che serve a un modo, il modo lo indica: «Integrazione API» chiede prima di creare una chiave API, e «QR dello scontrino fiscale» chiede prima di aggiungere una cassa o un codice aziendale.
Ogni timbro viene assegnato tramite un login del personale: quello che ha effettuato l’accesso a 7Stamp Scanner, quello a cui appartiene una chiave API o quello a cui è legata un’origine degli scontrini.
Possiamo gestire il programma quasi senza personale?
Sì. In Kiosk Mode gli acquirenti scansionano da soli la propria carta su un tablet, Autopilot Mode timbra ogni carta letta da un lettore QR hardware, e con «QR dello scontrino fiscale», «QR stampato sul tuo scontrino», Delivery Inserts e «Integrazione API» nessuno al banco deve timbrare. «Come assegnare i timbri» mostra tutti gli otto modi.
Perché «Come assegnare i timbri» mostra «QR dello scontrino fiscale» e non «QR stampato sul tuo scontrino»?
La pagina mostra il modo con lo scontrino adatto al Paese della tua attività: «QR dello scontrino fiscale» dove gli scontrini fiscali si possono scansionare, «QR stampato sul tuo scontrino» ovunque altrove.
«Come assegnare i timbri» mi chiede prima di creare una chiave API. Perché?
«Integrazione API» richiede una chiave API prima che il tuo sistema possa timbrare, e la pagina lo indica finché non ne esiste una. Allo stesso modo, «QR dello scontrino fiscale» chiede prima una cassa o un codice aziendale.
Ogni timbro è collegato a un login del personale?
Sì: a quello che ha effettuato l’accesso a 7Stamp Scanner, a quello a cui appartiene una chiave API o a quello a cui è legata un’origine degli scontrini.
Quale modo fa per la tua attività
La guida «Come assegnare i timbri» si apre con sei immagini: «Manualmente nell’app», «Tablet alla cassa», lo scontrino, «Dispositivo di pagamento», Delivery Inserts e «Automaticamente tramite API». Ognuna indica chi assegna il timbro («Dal personale», «Dall’acquirente», «Al pagamento» o «Automatico»), e «Manualmente nell’app» è segnato come «Consigliato». Autopilot Mode non ha un’immagine propria; lo trovi nella pagina.
Nella pagina, ogni modo indica sotto il suo nome a chi è adatto:
| Modo | Adatto a |
|---|---|
| Manuale | Saloni, spa, ristoranti e attività di servizi |
| Kiosk Mode | Caffè, panetterie, banchi e negozi molto frequentati |
| Terminal Mode | Negozi con dispositivi di pagamento Android alla cassa |
| Delivery Inserts | Consegne, asporto e ordini online |
| Integrazione API | Attività con un POS, un negozio online o un proprio sistema |
«QR dello scontrino fiscale», «QR stampato sul tuo scontrino» e Autopilot Mode indicano come funziona il modo invece che a chi è adatto.
Con quale modo conviene iniziare?
«Come assegnare i timbri» indica «Manuale», cioè «Manualmente nell’app», come «Consigliato». È adatto a saloni, spa, ristoranti e attività di servizi. Kiosk Mode è adatto a caffè, panetterie, banchi e negozi molto frequentati.
Vendiamo tramite app di consegna e da asporto. Quale modo fa per noi?
Delivery Inserts: «Come assegnare i timbri» lo suggerisce per consegne, asporto e ordini online.
Abbiamo un nostro negozio online. Quale modo fa per noi?
«Integrazione API», per le attività con un POS, un negozio online o un proprio sistema.
Perché Autopilot Mode non è tra le immagini?
La guida si apre con sei immagini, e Autopilot Mode non è tra queste. Lo trovi direttamente nella pagina «Come assegnare i timbri».
Manuale
Il personale trova la carta dell’acquirente in 7Stamp Scanner (tramite il suo QR o con «Trova acquirente») e aggiunge i timbri a mano, quanti ne sceglie.
Al personale servono 7Stamp Scanner e il login e la password di un login del personale. Come accedere, trovare una carta e aggiungere o togliere timbri è descritto nell’articolo «7Stamp Scanner», alla voce «Manuale».
Di cosa ha bisogno il personale per «Manuale»?
Di 7Stamp Scanner e del login e della password di un login del personale. La pagina «Come assegnare i timbri» mostra il login del personale con cui accedere.
Posso invece aggiungere timbri alla carta di un acquirente nel pannello di amministrazione?
No. Nel pannello non si possono aggiungere né togliere timbri. Lo fa il personale in 7Stamp Scanner, oppure i timbri arrivano dagli altri modi per timbrare.
L’acquirente non ha con sé il telefono. Il personale può comunque timbrare?
Sì. «Trova acquirente» in 7Stamp Scanner cerca la carta per nome, email, telefono o numero della carta.
Kiosk Mode
Un dispositivo con 7Stamp Scanner è rivolto verso gli acquirenti, che scansionano la propria carta con la sua fotocamera. Il personale avvia Kiosk Mode una volta, per una carta a timbri.
La configurazione, la protezione dalle scansioni doppie e l’uscita da Kiosk Mode sono descritte nell’articolo «7Stamp Scanner», alla voce Kiosk Mode.
In Kiosk Mode il cassiere deve premere qualcosa?
No. Gli acquirenti scansionano da soli la propria carta sul dispositivo rivolto verso di loro.
Un chiosco può timbrare due carte a timbri diverse?
No. Kiosk Mode funziona per l’unica carta a timbri scelta all’avvio; una carta di un’altra carta a timbri viene rifiutata.
Che dispositivo serve per Kiosk Mode?
Un dispositivo che esegue 7Stamp Scanner e ha una fotocamera, con cui gli acquirenti scansionano la propria carta.
QR dello scontrino fiscale
L’acquirente scansiona il QR fiscale già presente sul suo scontrino con il pulsante «Scansiona la ricevuta» nel chatbot della tua attività, e 7Stamp trasforma lo scontrino in timbri. 7Stamp recupera lo scontrino dal servizio fiscale del Paese, quindi non serve alcuna integrazione POS.
Funziona solo in alcuni Paesi e solo tramite il tuo bot Telegram o WhatsApp. I Paesi, le origini degli scontrini e ogni controllo sono descritti nell’articolo «Scansione degli scontrini».
Serve un’integrazione POS per «QR dello scontrino fiscale»?
No. 7Stamp recupera lo scontrino dal servizio fiscale del Paese.
Gli acquirenti possono scansionare lo scontrino senza un chatbot?
No. Il pulsante «Scansiona la ricevuta» esiste solo nel bot Telegram o WhatsApp dell’attività, non nella pagina web della carta né in My 7Stamp.
«QR dello scontrino fiscale» funziona nel mio Paese?
«Come assegnare i timbri» lo mostra solo quando il Paese della tua attività lo supporta; i Paesi sono elencati in «Scansione degli scontrini». Altrove usa «QR stampato sul tuo scontrino».
QR stampato sul tuo scontrino
Questo modo funziona in qualsiasi Paese. Il tuo POS stampa un QR di 7Stamp sullo scontrino, collegato tramite l’API o un’integrazione pronta, e l’acquirente lo scansiona dopo aver pagato. Un POS senza integrazione può invece stampare codici timbri sui suoi scontrini (vedi «Delivery Inserts e codici timbri» più sotto).
Le integrazioni pronte sono in Impostazioni → API e integrazioni: alla cassa Poster, Toast, il tuo POS tramite l’API e una richiesta per un POS non ancora collegato. Sono descritte in «API, webhook e integrazioni».
Non siamo in un Paese con scontrini fiscali. Gli acquirenti possono comunque ottenere timbri da uno scontrino?
Sì. «QR stampato sul tuo scontrino» funziona in qualsiasi Paese: il tuo POS stampa un QR di 7Stamp e l’acquirente lo scansiona dopo aver pagato.
Il mio POS non è nella lista. Cosa posso fare?
Collegalo tramite l’API, oppure invia una richiesta in «API e integrazioni». Nel frattempo, stampa i codici timbri sui tuoi scontrini.
Poster è disponibile fuori dal pannello di amministrazione di 7Stamp?
No. Poster richiede una chiave API ed è offerto solo nel pannello di amministrazione di 7Stamp, non con White Label.
Terminal Mode
7Stamp Scanner funziona sul dispositivo POS Android alla cassa. Dopo il pagamento il personale tocca «Servi l’acquirente», il dispositivo mostra un QR monouso e l’acquirente lo scansiona con il proprio telefono; un acquirente senza la carta a timbri la riceve insieme ai timbri.
L’installazione, l’importo per una carta a timbri «Per importo» e la ricerca preventiva di un acquirente sono descritti nell’articolo «7Stamp Scanner», alla voce Terminal Mode.
L’acquirente deve avere la carta a timbri prima di pagare?
No. Un acquirente che non ha la carta la riceve, insieme ai timbri, quando scansiona il QR.
In Terminal Mode il cassiere deve scansionare il telefono dell’acquirente?
No. Il dispositivo mostra un QR, l’acquirente lo scansiona con il proprio telefono e il risultato compare da solo sul dispositivo.
Un QR di «Servi l’acquirente» si può usare due volte?
No. «Servi l’acquirente» mostra un QR monouso.
Delivery Inserts e codici timbri

Un codice timbri è un codice monouso di una carta a timbri che assegna timbri. Viene consegnato come QR stampabile, come link o come codice vero e proprio. Un acquirente senza la carta la riceve con il codice, e i timbri finiscono su quella carta.
Delivery Inserts è un modo di usare i codici timbri, non una cosa a parte: stampi una serie di codici timbri, ne metti uno in ogni ordine a domicilio o da asporto, e l’acquirente lo scansiona a casa. I codici timbri si trovano in «Strumenti di marketing».

Ogni codice di una serie dà un numero di timbri, da uno fino al totale della carta a timbri, oppure un importo d’acquisto. Una serie contiene da uno a cento codici.

Un codice con importo calcola i suoi timbri in base al prezzo del timbro della carta a timbri quando l’acquirente lo apre. Un importo inferiore al prezzo di un timbro dà la carta senza timbri, e all’acquirente viene spiegato perché.

Ogni codice timbri funziona una sola volta. Un acquirente che ne apre uno già usato non riceve timbri e vede che è già stato usato; un acquirente che non aveva la carta riceve comunque la carta. Se due acquirenti aprono lo stesso codice nello stesso istante, solo uno riceve i timbri. Quando la tua attività ha un bot Telegram o WhatsApp, il link di un codice timbri apre il bot, e la carta vive poi nella chat; altrimenti apre la pagina web della carta.
Quanti timbri può dare un codice timbri?
Da uno fino al totale della carta a timbri, oppure un importo d’acquisto che viene convertito in timbri in base al prezzo del timbro quando l’acquirente apre il codice.
Quanti codici timbri posso generare in una volta?
Da uno a cento codici per serie. Genera un’altra serie quando te ne servono altri.
Un acquirente ha scansionato due volte un codice timbri. Ha ricevuto i timbri due volte?
No. Ogni codice timbri funziona una sola volta; la seconda volta l’acquirente vede che è già stato usato.
Serve un’impostazione separata per Delivery Inserts?
No. Delivery Inserts è un modo di usare i codici timbri: stampa una serie e metti un codice in ogni ordine a domicilio o da asporto.
Integrazione API

Il tuo POS, il tuo negozio online o il tuo software timbra tramite l’API con una chiave API creata in «API e integrazioni» per un login del personale; ogni chiamata agisce come quel login del personale. Tramite l’API un sistema emette carte e aggiunge timbri in base al proprio identificativo dell’acquirente.
Una scansione tramite l’API invia un numero di timbri, un importo d’acquisto o le righe dello scontrino. Un numero di timbri prevale sull’importo e sulla regola di accumulo; zero timbri significa «calcolali dall’importo o dallo scontrino». L’API aggiunge solo timbri: per toglierli si usa 7Stamp Scanner. Prima di una scansione, il sistema può chiedere cosa darebbe; la risposta non salva nulla e non conteggia alcuna Card Operation, e funziona anche per un acquirente che non ha ancora una carta.
Le chiavi API, i webhook e le integrazioni pronte sono descritti in «API, webhook e integrazioni».
Possiamo aggiungere timbri dal nostro CRM o POS?
Sì, tramite l’API. Crea una chiave API per un login del personale in «API e integrazioni»; il tuo sistema poi emette carte a timbri e aggiunge timbri in base al proprio identificativo dell’acquirente.
Il nostro sistema può togliere timbri tramite l’API?
No. La scansione dell’API aggiunge solo timbri. I timbri si tolgono in 7Stamp Scanner.
Il nostro sistema invia sia un numero di timbri sia un importo. Quale conta?
Il numero di timbri. Prevale sull’importo e sulla regola di accumulo; invia zero timbri per farli calcolare dall’importo o dallo scontrino.
Possiamo mostrare all’acquirente cosa darà un acquisto prima di timbrare?
Sì. L’API può chiedere cosa darebbe una scansione; la risposta non salva nulla e non conteggia alcuna Card Operation.
Autopilot Mode
Un lettore QR hardware al banco timbra ogni carta che legge, un timbro ciascuna, senza che nessuno prema nulla. L’acquirente mostra la carta e il timbro viene aggiunto.
Autopilot Mode è un interruttore nella schermata «Manuale» di 7Stamp Scanner e richiede un lettore QR hardware: una carta letta dalla fotocamera del telefono apre solo la carta dell’acquirente. I dettagli sono nell’articolo «7Stamp Scanner», alla voce Autopilot Mode.
Autopilot Mode può usare la fotocamera del telefono?
No. Con Autopilot Mode attivo, una carta letta dalla fotocamera apre solo la carta dell’acquirente. I timbri automatici richiedono un lettore QR hardware.
Quanti timbri aggiunge Autopilot Mode?
Un timbro per ogni carta letta dal lettore QR hardware.
Dove si attiva Autopilot Mode?
In 7Stamp Scanner, nella schermata «Manuale».
Quanti timbri dà un acquisto
Ogni carta a timbri ha una sola regola di accumulo, impostata nell’editor in «Come gli acquirenti ottengono i timbri»:
- Per ordine: un timbro per ogni acquisto, qualunque sia il suo importo.
- Per importo: un timbro per ogni prezzo del timbro intero contenuto nell’importo dell’acquisto, arrotondando per difetto, quindi un acquisto può dare più timbri: un acquisto pari a due prezzi del timbro e mezzo ne dà due.
- Per prodotto: un timbro per ogni unità di un prodotto il cui codice è nella lista della carta a timbri, quindi due unità di un prodotto in lista danno due timbri. I codici corrispondono senza distinguere maiuscole e minuscole.
Un acquisto inferiore al prezzo di un timbro, o uno scontrino senza nessuno dei prodotti in lista, è una scansione valida che non aggiunge timbri. All’acquirente viene spiegato perché (per un importo, quanto mancava) e non gli viene inviato nulla.
«Per importo» e «Per prodotto» funzionano ovunque un importo d’acquisto o le righe dello scontrino arrivino a 7Stamp: Terminal Mode («Per importo»), scontrini fiscali, codici timbri con importo, l’API, le integrazioni POS e Toast. «Manuale», Kiosk Mode e Autopilot Mode aggiungono un numero di timbri, mai un importo: Kiosk Mode e Autopilot Mode aggiungono un timbro per scansione, «Manuale» il numero scelto dal personale.
Si possono assegnare timbri in base all’importo dell’acquisto?
Sì. Scegli «Per importo» per la carta a timbri. L’importo arriva a 7Stamp tramite Terminal Mode, gli scontrini fiscali, i codici timbri con importo, l’API e le integrazioni POS. «Manuale» non ha un importo: il personale sceglie il numero di timbri.
Con «Per importo», un acquisto grande dà più timbri?
Sì. Ogni prezzo del timbro intero contenuto nell’importo dà un timbro, arrotondando per difetto: due prezzi del timbro e mezzo danno due timbri.
L’acquisto di un acquirente era inferiore al prezzo del timbro. Cosa succede?
La scansione è valida ma non aggiunge timbri. All’acquirente viene detto quanto mancava; la sua carta non cambia.
Kiosk Mode timbra per importo?
No. Kiosk Mode e Autopilot Mode aggiungono un timbro per scansione, qualunque sia la regola di accumulo.
Quale carta a timbri riceve i timbri
Quando il personale scansiona la carta di un acquirente, i timbri vanno alla carta a timbri di quella carta. Scontrini e chiamate API non portano una carta, quindi la carta a timbri che timbrano viene scelta per ciascun login del personale, nella sua pagina in «Timbri automatici».
Un login del personale senza una propria scelta usa la carta a timbri predefinita dell’attività. Questa predefinita non ha un’impostazione propria: quando si crea un login del personale mentre l’attività ha esattamente una carta a timbri e nessuna predefinita, quella carta diventa la predefinita. Con una sola carta a timbri nell’attività, la scelta è bloccata su di essa.
Con due o più carte a timbri e nessuna scelta (né per il login del personale né come predefinita), i suoi scontrini fiscali non danno timbri, e le sue chiamate API che non indicano una carta a timbri vengono rifiutate.
Abbiamo due carte a timbri. Quale timbrano gli scontrini?
Quella scelta per il login del personale dell’origine degli scontrini in «Timbri automatici». Se non ne è scelta nessuna e non c’è una predefinita, gli scontrini non danno timbri.
Dove scelgo la carta a timbri per le chiamate API?
Nella pagina del login del personale, in «Timbri automatici». Ogni chiamata fatta con la chiave API di quel login del personale la usa, a meno che la chiamata non indichi una carta a timbri.
«Timbri automatici» cambia cosa timbra la scansione di una carta in 7Stamp Scanner?
No. Una carta scansionata viene timbrata sulla propria carta a timbri.
Quando una scansione non dà timbri
Una scansione non dà timbri alla carta di un’altra attività, a una carta eliminata nel pannello, a una carta il cui titolare ha eliminato il proprio profilo o a una carta di una carta a timbri disattivata o eliminata. Un acquirente la cui carta è stata eliminata aggiunge di nuovo la carta e ne riceve una nuova.
Le scansioni non hanno limiti di frequenza: la stessa carta può essere timbrata di nuovo subito, sia da 7Stamp Scanner sia tramite l’API. Solo Kiosk Mode protegge dalle scansioni doppie, per conto proprio.
I timbri sulla carta di un acquirente non scadono.
I timbri scadono?
No. I timbri sulla carta di un acquirente non scadono; solo i buoni possono avere una data di fine.
Il personale può timbrare la stessa carta due volte di seguito?
Sì. Le scansioni non hanno limiti di frequenza. Solo Kiosk Mode blocca una seconda scansione consecutiva della stessa carta.
Perché la carta di un acquirente non ha ricevuto il timbro?
La carta potrebbe appartenere a un’altra attività, essere stata eliminata, appartenere a un acquirente che ha eliminato il proprio profilo o appartenere a una carta a timbri disattivata o eliminata.
NFC, Apple VAS e Google Smart Tap
L’NFC non aggiunge timbri: 7Stamp Scanner legge il QR o il numero di una carta, e né lo scanner né il lato dell’acquirente leggono l’NFC.
L’NFC può portare acquirenti. Puoi scrivere il link di adesione di una carta a timbri su un tuo tag NFC, così avvicinando il telefono la carta si apre come scansionando il QR di adesione. 7Stamp in sé non ha impostazioni NFC.
Apple VAS e Google Smart Tap, con cui il dispositivo di pagamento riconosce la carta fedeltà prima del pagamento, si possono configurare con i partner di 7Stamp. Il partner fornisce il certificato del protocollo, e il dispositivo deve accettare le chiavi di crittografia di Apple e di Google.
L’NFC aggiunge timbri?
No. I timbri arrivano dai modi della pagina «Come assegnare i timbri»; 7Stamp Scanner legge il QR o il numero di una carta, non l’NFC.
Gli acquirenti possono ottenere la carta a timbri avvicinando il telefono a un tag NFC?
Sì. Scrivi il link di adesione della carta a timbri su un tuo tag NFC; un tocco apre la carta come il QR di adesione.
Un dispositivo di pagamento può riconoscere la carta fedeltà prima del pagamento con Apple VAS o Google Smart Tap?
Sì, con i partner di 7Stamp. Ti serve il certificato del protocollo dal partner, e il dispositivo deve accettare le chiavi di crittografia di Apple e di Google.