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.
• 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 Settings (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 (Contatti: Lettura)
• Developers: Full (Sviluppatori: Completo)

Passo 2 — Collega Holded a Passtastic

1. Nella tua dashboard Passtastic, apri Settings (Impostazioni), poi Integrations (Integrazioni), sotto Business (Attività).

2. Trova Holded POS.

3. Incolla la chiave API che hai copiato e clicca su Connect Holded (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.

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.

Risoluzione dei problemi

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, 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.

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.