Collega Holded POS

Cosa fa

Collega il tuo account Holded e il tuo programma fedeltà accumula direttamente dalla tua cassa Holded. Quando il tuo staff registra una vendita pagata con un cliente collegato, Passtastic la rileva automaticamente — nessun dispositivo separato per guadagnare. Per dare un premio, il tuo staff lo conferma sempre con una scansione veloce nella Passtastic Scanner app, come con qualsiasi altra cassa.

Quali tessere possono accumulare dalle vendite Holded

• Le tessere punti e livelli accumulano secondo le tue regole punti — la regola di accumulo collegata alla tessera decide quanto vale una vendita. Se una tessera non ha ancora una regola di accumulo collegata, non accumula finché non ne configuri una.
• Le tessere a timbri accumulano 1 timbro per ogni vendita pagata — non serve nessuna regola.
• Le tessere che iniziano con un coupon di benvenuto accumulano anch'esse, dalla prima vendita, come la tessera a timbri, a punti o a livelli in cui si trasformano. Holded non ha premi alla cassa, quindi lo staff dà il regalo di benvenuto con la Passtastic Scanner app, come oggi.
• Gli altri coupon, pacchetti (prepagati a timbri / prepagati a punti) e membership non possono accumulare dalle vendite Holded. Questi tipi non hanno un modo per accumulare da una transazione POS, quindi non compariranno nell'elenco delle tessere che puoi attivare.

Prima di iniziare

• Accesso al tuo account Holded con permesso di creare credenziali API.
• Almeno una tessera fedeltà pubblicata in Passtastic che possa accumulare (una tessera punti, livelli o timbri). Se non ne hai ancora una, creala prima da Programmi → Nuovo programma.
• La Passtastic Scanner app gratuita su un telefono o tablet — ti servirà comunque per riscattare i premi.

Passo 1 — Ottieni la tua chiave API di Holded

1. In Holded, apri Impostazioni.

2. Vai su Developers (Sviluppatori).

3. Apri Credentials (Credenziali).

4. Clicca su New API Token (Nuovo token API).

5. Seleziona esattamente questi permessi:

• Sales: Read (Vendite: Lettura)
• Contacts: Read + Write (Contatti: Lettura e scrittura)
• Developers: Full (Sviluppatori: Completo)

Passo 2 — Collega Holded a Passtastic

1. Nella tua dashboard Passtastic, apri Impostazioni, poi Integrazioni, sotto Attività.

2. Trova Holded POS.

3. Incolla la chiave API che hai copiato e clicca su Collega Holded.

Passo 3 — Scegli quali tessere accumulano

Una volta connesso, vedrai Le tue tessere fedeltà — ogni tessera punti, livelli e a timbri del tuo account. Attiva una tessera per iniziare ad accumulare dalle vendite Holded.

• Per le tessere punti e livelli, assicurati che sia collegata una regola di accumulo — le tessere accumulano solo quando hanno una regola punti configurata. Se non ne è ancora collegata una, usa Configura le tue regole punti nella stessa pagina.
• Le tessere a timbri non hanno bisogno di una regola — attivarle è sufficiente; accumulano 1 timbro per ogni vendita pagata.

La pagina di connessione mostra N di M tessere che accumulano, così vedi a colpo d'occhio quante delle tue tessere idonee sono attive.

Passo 4 — I membri vengono aggiunti automaticamente ai tuoi contatti Holded

I tuoi membri compaiono in Holded da soli. Quando qualcuno si iscrive, Passtastic lo aggiunge ai tuoi contatti Holded (nome, email, telefono), così al banco il tuo team cerca una volta e lo mette sullo scontrino. I membri iscritti prima della connessione vengono inseriti nei giorni successivi, fino a 200 al giorno, così un programma grande non consuma in una volta sola il tuo limite API di Holded. Se in Holded esiste già qualcuno con la stessa email o lo stesso numero di telefono, ci colleghiamo a quel contatto invece di crearne uno nuovo.

Puoi disattivare questa opzione in qualsiasi momento con Aggiungi automaticamente i membri ai miei contatti Holded nella pagina Holded di Passtastic. I contatti già creati restano in Holded, ed eliminare un membro in Passtastic non elimina mai il suo contatto Holded.

*Dettagli:* i contatti sono salvati come clienti, etichettati passtastic e portano il codice di riferimento PT-…; la sincronizzazione usa circa due chiamate per membro dal limite mensile API del tuo piano Holded.

L'unica abitudine che conta: collega il cliente alla vendita

Timbri e punti vengono accreditati solo quando il tuo staff assegna il cliente allo scontrino in Holded — allo stesso modo in cui si aggiunge un cliente a qualsiasi vendita. Se una vendita viene registrata senza cliente collegato, nulla viene accreditato automaticamente.

Non è comunque necessariamente perso: una vendita fatta senza cliente può ancora essergli attribuita più tardi lo stesso giorno, se lo scontrino viene aggiornato con il cliente prima della chiusura della giornata. Oltre quella finestra, la vendita non può più essere abbinata.

Come il tuo staff riscatta un premio

Holded non mostra lo stato del premio di un cliente alla cassa, quindi il riscatto usa sempre una scansione veloce, come in qualsiasi programma fedeltà Passtastic:

1. Quando un cliente dice che il suo premio è pronto, il tuo staff apre la Passtastic Scanner app e scansiona il pass wallet del cliente. Questo conferma che il premio è reale e pronto.

2. Il tuo staff applica il premio alla cassa come farebbe normalmente (sconto, articolo gratuito, ecc.).

È l'unico punto in cui usi ancora lo scanner — l'accumulo è automatico dalle vendite Holded.

Rimborsi

Quando fai un rimborso dal POS Holded, Holded crea uno scontrino di rettifica con importo negativo, collegato alla vendita originale. Passtastic applica la tua regola punti all'importo rimborsato e toglie quei punti, quindi un rimborso parziale toglie solo una parte dei punti. Una carta non va mai sotto zero: se il cliente ha già usato i punti, si ferma a 0. Anche annullare o eliminare uno scontrino toglie i suoi punti. Le carte a timbri perdono un timbro solo quando uno scontrino viene annullato o eliminato, non con un rimborso. Puoi disattivarlo con Togli i punti sui rimborsi nella pagina Holded di Passtastic.

Risoluzione dei problemi

Non guadagna nulla, e la pagina dice Connesso · non accumula. Nessuna tessera è attiva. Attiva l'interruttore di una tessera sotto Le tue tessere fedeltà. Se nel frattempo è arrivata una vendita, la pagina mostra la data di quella vendita: non ha fatto guadagnare nulla, e non viene aggiunta in seguito.

La mia chiave API non è stata accettata. Assicurati di aver creato un vero API Token di Holded (non una password di accesso o un altro tipo di chiave) e di aver copiato l'intera stringa. Crea un nuovo token in Holded → Settings → Developers → Credentials e incollalo di nuovo.

Errore "Aggiungi il permesso Vendite: Lettura / Sviluppatori: Completo". Al token manca uno dei tre permessi richiesti. Torna in Holded, crea un nuovo API Token e seleziona tutti e tre: Sales: Read, Contacts: Read + Write, Developers: Full — poi incolla quello.

"Impossibile registrare il webhook delle vendite in Holded." Holded consente un solo webhook di vendite per account. Se un altro strumento è già registrato per ricevere le notifiche di vendita di Holded, Holded rifiuterà una seconda registrazione. Disconnetti o riconfigura il webhook dell'altro strumento in Holded, poi riprova a connettere Passtastic.

La mia connessione ha bisogno di una nuova chiave dopo averne rigenerata una in Holded. Rigenerare o revocare una chiave in Holded invalida quella che Passtastic sta usando, quindi la connessione smette di funzionare finché non ti riconnetti. Crea un nuovo API Token in Holded (stessi permessi indicati sopra) e incollalo nella pagina dell'integrazione Holded per riconnetterti — le impostazioni delle tue tessere vengono mantenute.

"La tua chiave Holded non può creare contatti." Il tuo token API non ha il permesso Contacts: Write (Contatti: Scrittura), quindi Passtastic può collegare i contatti esistenti ma non può crearne di nuovi. Crea un nuovo API Token in Holded con Sales: Read, Contacts: Read + Write e Developers: Full, clicca su Incolla una nuova chiave nel banner e incollalo. Nel frattempo l'accumulo continua a funzionare tramite l'abbinamento per email e telefono.

Una vendita non si abbina al cliente giusto. Verifica che il permesso Contatti: Lettura sia ancora attivo sulla tua chiave API — senza di esso, Passtastic non può abbinare le vendite ai tuoi clienti. Se manca, aggiungilo al tuo token esistente o creane uno nuovo con tutti e tre i permessi.

Per gestire la fedeltà senza un POS, o collegare altri strumenti, vedi Sistemi POS e integrazioni.