Holded POS verbinden

Was das bewirkt

Verbinde dein Holded-Konto, und dein Treueprogramm sammelt direkt an deiner Holded-Kasse. Rechnet dein Team einen bezahlten Verkauf mit zugeordnetem Kunden ab, erfasst Passtastic das automatisch — kein separates Gerät zum Sammeln nötig. Um eine Prämie zu vergeben, bestätigt dein Team sie weiterhin mit einem kurzen Scan in der Passtastic Scanner app, genau wie an jeder anderen Kasse.

Welche Karten aus Holded-Verkäufen sammeln können

• Punkte- und Level-Karten sammeln gemäß deinen Punkte-Regeln — die der Karte zugewiesene Sammelregel entscheidet, wie viel ein Verkauf wert ist. Hat eine Karte noch keine Sammelregel zugewiesen, sammelt sie erst, wenn du eine einrichtest.
• Stempelkarten sammeln 1 Stempel pro bezahltem Verkauf — es braucht keine Regel.
• Coupons, Pakete (Prepaid-Stempel / Prepaid-Punkte) und Mitgliedschaften können nicht aus Holded-Verkäufen sammeln. Diese Kartentypen haben keine Möglichkeit, aus einer Kassentransaktion zu sammeln, deshalb erscheinen sie nicht in der Liste der Karten, die du einschalten kannst.

Bevor du startest

• Zugriff auf dein Holded-Konto mit der Berechtigung, API-Zugangsdaten zu erstellen.
• Mindestens eine veröffentlichte Treuekarte in Passtastic, die sammeln kann (eine Punkte-, Level- oder Stempelkarte). Wenn du noch keine hast, erstelle sie zuerst über Programs → Create New Program (Programme → Neues Programm erstellen).
• Die kostenlose Passtastic Scanner app auf einem Smartphone oder Tablet — du brauchst sie weiterhin, um Prämien einzulösen.

Schritt 1 — Hol dir deinen Holded-API-Schlüssel

1. Öffne in Holded Settings (Einstellungen).

2. Gehe zu Developers (Entwickler).

3. Öffne Credentials (Zugangsdaten).

4. Klicke auf New API Token (Neuer API-Token).

5. Wähle genau diese Berechtigungen:

• Sales: Read (Verkäufe: Lesen)
• Contacts: Read (Kontakte: Lesen)
• Developers: Full (Entwickler: Vollzugriff)

Schritt 2 — Verbinde Holded mit Passtastic

1. Öffne in deinem Passtastic-Dashboard Settings (Einstellungen) und dann Integrations (Integrationen) unter Business (Geschäft).

2. Finde Holded POS.

3. Füge den kopierten API-Schlüssel ein und klicke auf Holded verbinden.

Schritt 3 — Wähle, welche Karten sammeln

Nach dem Verbinden siehst du Deine Treuekarten — jede Punkte-, Level- und Stempelkarte in deinem Konto. Schalte eine Karte ein, um aus Holded-Verkäufen zu sammeln.

• Achte bei Punkte- und Level-Karten darauf, dass eine Sammelregel zugewiesen ist — Karten sammeln erst, sobald eine Punkte-Regel für sie eingerichtet ist. Ist noch keine zugewiesen, nutze Richte deine Punkte-Regeln ein auf derselben Seite.
• Stempelkarten brauchen keine Regel — es reicht, eine einzuschalten; sie sammelt dann 1 Stempel pro bezahltem Verkauf.

Die Verbindungsseite zeigt N von M Karten sammeln an, damit du auf einen Blick siehst, wie viele deiner sammelfähigen Karten eingeschaltet sind.

Die eine Gewohnheit, auf die es ankommt: den Kunden dem Verkauf zuordnen

Punkte und Stempel werden nur gutgeschrieben, wenn dein Team den Kunden in Holded dem Beleg zuordnet — genauso wie beim Hinzufügen eines Kunden zu jedem anderen Verkauf. Wird ein Verkauf ohne zugeordneten Kunden abgerechnet, wird automatisch nichts gutgeschrieben.

Das ist aber nicht zwangsläufig verloren: Ein Verkauf ohne Kunden kann ihm noch später am selben Tag zugeordnet werden, wenn der Beleg vor Tagesabschluss mit dem Kunden aktualisiert wird. Danach lässt sich der Verkauf nicht mehr zuordnen.

Wie dein Team eine Prämie einlöst

Holded zeigt den Prämienstatus eines Kunden nicht an der Kasse an, deshalb erfolgt das Einlösen weiterhin per kurzem Scan, genau wie bei jedem anderen Passtastic-Treueprogramm:

1. Wenn ein Kunde sagt, dass seine Prämie bereit ist, öffnet dein Team die Passtastic Scanner app und scannt die Wallet-Karte des Kunden. Das bestätigt, dass die Prämie echt und bereit ist.

2. Dein Team wendet die Prämie beim Bezahlen wie gewohnt an (Rabatt, kostenloser Artikel usw.).

Das ist die einzige Stelle, an der du noch den Scanner verwendest — das Sammeln läuft aus Holded-Verkäufen automatisch.

Fehlerbehebung

Mein API-Schlüssel wurde nicht akzeptiert. Stelle sicher, dass du einen echten Holded-API-Token erstellt hast (kein Login-Passwort oder eine andere Art von Schlüssel) und dass du die vollständige Zeichenfolge kopiert hast. Erstelle einen neuen Token in Holded → Settings → Developers → Credentials und füge ihn erneut ein.

Fehlermeldung „Add the Sales: Read / Developers: Full scope". Dem Token fehlt eine der drei erforderlichen Berechtigungen. Gehe zurück zu Holded, erstelle einen neuen API-Token und wähle alle drei aus: Sales: Read, Contacts: Read, Developers: Full — füge diesen dann ein.

„Couldn't register the sales webhook in Holded." Holded erlaubt nur einen Verkaufs-Webhook pro Konto. Ist bereits ein anderes Tool registriert, um deine Holded-Verkaufsbenachrichtigungen zu empfangen, lehnt Holded einen zweiten ab. Trenne oder konfiguriere den Webhook des anderen Tools in Holded neu und verbinde Passtastic danach erneut.

Meine Verbindung braucht einen neuen Schlüssel, nachdem ich in Holded einen neuen erstellt habe. Wird ein Schlüssel in Holded neu erstellt oder widerrufen, wird der von Passtastic verwendete Schlüssel ungültig, und die Verbindung funktioniert nicht mehr, bis du dich erneut verbindest. Erstelle einen neuen API-Token in Holded (mit denselben Berechtigungen wie oben) und füge ihn auf der Holded-Integrationsseite ein, um dich wieder zu verbinden — deine Karteneinstellungen bleiben erhalten.

Ein Verkauf wird nicht dem richtigen Kunden zugeordnet. Prüfe, ob die Berechtigung Contacts: Read (Kontakte: Lesen) auf deinem API-Schlüssel noch aktiv ist — ohne sie kann Passtastic Verkäufe nicht mit deinen Kunden abgleichen. Fehlt sie, füge sie deinem bestehenden Token hinzu oder erstelle einen neuen mit allen drei Berechtigungen.

Wie du Treueprogramme ohne Kassensystem betreibst oder andere Tools anbindest, erfährst du unter Kassensysteme & Integrationen.