Holded POS verbinden

Wat dit doet

Verbind je Holded-account en je loyaliteitsprogramma draait direct op je Holded-kassa. Wanneer je personeel een betaalde verkoop afrekent met een gekoppelde klant, pikt Passtastic dit automatisch op — geen apart apparaat om te sparen. Om een beloning te geven, bevestigt je personeel deze nog steeds met een snelle scan in de Passtastic Scanner app, net als bij elke andere kassa.

Welke kaarten sparen via Holded-verkopen

• Punten- en niveaukaarten sparen volgens je puntenregels — de spaarregel die aan de kaart is gekoppeld, bepaalt hoeveel een verkoop waard is. Heeft een kaart nog geen spaarregel gekoppeld, dan spaart hij pas nadat je er een instelt.
• Stempelkaarten verdienen 1 stempel per betaalde verkoop — geen regel nodig.
• Coupons, pakketten (prepaid stempel / prepaid punten) en lidmaatschappen kunnen niet sparen via Holded-verkopen. Deze kaarttypes hebben geen manier om te sparen via een kassatransactie, dus ze verschijnen niet in de lijst met kaarten die je kunt aanzetten.

Voordat je begint

• Toegang tot je Holded-account met rechten om API-credentials aan te maken.
• Minstens één gepubliceerde loyaliteitskaart in Passtastic die kan sparen (een punten-, niveau- of stempelkaart). Heb je er nog geen, maak deze dan eerst aan via Programs → Create New Program (Programma's → Nieuw programma maken).
• De gratis Passtastic Scanner app op een telefoon of tablet — die heb je nog steeds nodig om beloningen in te wisselen.

Stap 1 — Haal je Holded API-sleutel op

1. Open in Holded Settings (Instellingen).

2. Ga naar Developers (Ontwikkelaars).

3. Open Credentials.

4. Klik op New API Token (Nieuw API-token).

5. Selecteer precies deze rechten:

• Sales: Read (Verkoop: Lezen)
• Contacts: Read (Contacten: Lezen)
• Developers: Full (Ontwikkelaars: Volledig)

Stap 2 — Verbind Holded met Passtastic

1. Open in je Passtastic-dashboard Settings (Instellingen), dan Integrations (Integraties) onder Business (Bedrijf).

2. Zoek Holded POS.

3. Plak de API-sleutel die je hebt gekopieerd en klik op Connect Holded (Holded koppelen).

Stap 3 — Kies welke kaarten sparen

Eenmaal verbonden zie je Your loyalty cards (Je loyaliteitskaarten) — elke punten-, niveau- en stempelkaart in je account. Zet een kaart aan om te beginnen met sparen via Holded-verkopen.

• Zorg er bij punten- en niveaukaarten voor dat er een spaarregel is gekoppeld — kaarten sparen pas zodra er een puntenregel voor is ingesteld. Is er nog geen gekoppeld, gebruik dan Set up your points rules (Stel je puntenregels in) op dezelfde pagina.
• Stempelkaarten hebben geen regel nodig — aanzetten is genoeg; ze verdienen 1 stempel per betaalde verkoop.

De verbindingspagina toont N van M kaarten actief, zodat je in één oogopslag ziet hoeveel van je spaargeschikte kaarten zijn aangezet.

De ene gewoonte die telt: koppel de klant aan de verkoop

Punten en stempels worden alleen toegevoegd wanneer je personeel de klant aan het ticket in Holded koppelt — op dezelfde manier als bij elke andere verkoop een klant toevoegen. Wordt een verkoop afgerekend zonder gekoppelde klant, dan wordt er niets automatisch bijgeschreven.

Dat hoeft niet per se verloren te zijn: een verkoop zonder klant kan nog steeds later diezelfde dag aan hem worden toegeschreven, als het ticket vóór het sluiten van de dag met de klant wordt bijgewerkt. Na dat venster kan de verkoop niet meer worden gekoppeld.

Hoe je personeel een beloning inwisselt

Holded toont de beloningsstatus van een klant niet bij de kassa, dus inwisselen gaat nog steeds via een snelle scan, net als bij elk ander Passtastic-loyaliteitsprogramma:

1. Wanneer een klant zegt dat zijn beloning klaar is, opent je personeel de Passtastic Scanner app en scant de wallet-pas van de klant. Dit bevestigt dat de beloning echt en klaar is.

2. Je personeel past de beloning bij het afrekenen toe zoals gebruikelijk (korting, gratis item, enz.).

Dat is de enige plek waar je nog de scanner gebruikt — sparen gaat automatisch via Holded-verkopen.

Problemen oplossen

Mijn API-sleutel is niet geaccepteerd. Zorg dat je een echt Holded API Token hebt aangemaakt (geen inlogwachtwoord of ander type sleutel), en dat je de hele string hebt gekopieerd. Maak een nieuw token aan in Holded → Settings → Developers → Credentials en plak het opnieuw.

Foutmelding "Add the Sales: Read / Developers: Full scope". Het token mist een van de drie vereiste rechten. Ga terug naar Holded, maak een nieuw API Token aan en selecteer alle drie: Sales: Read, Contacts: Read, Developers: Full — en plak dat token dan opnieuw in.

"Couldn't register the sales webhook in Holded." Holded staat maar één verkoop-webhook per account toe. Is er al een andere tool geregistreerd om je Holded-verkoopmeldingen te ontvangen, dan weigert Holded een tweede. Koppel de webhook van de andere tool los of configureer deze opnieuw in Holded, en probeer dan opnieuw Passtastic te verbinden.

Mijn verbinding heeft een nieuwe sleutel nodig nadat ik er een heb vernieuwd in Holded. Het vernieuwen of intrekken van een sleutel in Holded maakt de sleutel die Passtastic gebruikt ongeldig, waardoor de verbinding stopt te werken totdat je opnieuw koppelt. Maak een nieuw API Token aan in Holded (dezelfde rechten als hierboven) en plak dit op de Holded-integratiepagina om opnieuw te koppelen — je kaartinstellingen blijven behouden.

Een verkoop wordt niet aan de juiste klant gekoppeld. Controleer of het recht Contacts: Read nog steeds is ingeschakeld op je API-sleutel — zonder dit kan Passtastic verkopen niet aan je klanten koppelen. Ontbreekt het, voeg het dan toe aan je bestaande token of maak een nieuwe aan met alle drie de rechten.

Voor het draaien van loyaliteit zonder een POS, of het verbinden van andere tools, zie POS-systemen & integraties.