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.
• Karten, die mit einem Willkommensgutschein starten, sammeln ebenfalls, ab dem ersten Verkauf, als die Stempel-, Punkte- oder Level-Karte, zu der sie werden. Holded hat keine Prämien an der Kasse, daher gibt dein Team das Willkommensgeschenk weiterhin mit der Passtastic Scanner app, wie bisher.
• Andere 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 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 + Write (Kontakte: Lesen und Schreiben)
• Developers: Full (Entwickler: Vollzugriff)

Schritt 2 — Verbinde Holded mit Passtastic

1. Öffne in deinem Passtastic-Dashboard Einstellungen und dann Integrationen unter 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.

Schritt 4 — Mitglieder erscheinen automatisch in deinen Holded-Kontakten

Deine Mitglieder erscheinen von selbst in Holded. Tritt jemand bei, fügt Passtastic ihn deinen Holded-Kontakten hinzu (Name, E-Mail, Telefon), sodass dein Team an der Kasse einmal sucht und ihn auf den Beleg setzt. Mitglieder, die schon vor dem Verbinden beigetreten sind, werden über die folgenden Tage nachgetragen, bis zu 200 pro Tag, damit ein großes Programm dein Holded-API-Kontingent nicht auf einen Schlag aufbraucht. Gibt es in Holded bereits jemanden mit derselben E-Mail-Adresse oder Telefonnummer, verknüpfen wir diesen Kontakt, statt einen zweiten anzulegen.

Du kannst das jederzeit mit Mitglieder automatisch zu meinen Holded-Kontakten hinzufügen auf der Holded-Seite in Passtastic ausschalten. Bereits erstellte Kontakte bleiben in Holded erhalten, und das Löschen eines Mitglieds in Passtastic löscht seinen Holded-Kontakt nie.

*Details:* Kontakte werden als Kunden gespeichert, mit passtastic getaggt und tragen den Referenzcode PT-…; der Abgleich nutzt etwa zwei Aufrufe pro Mitglied aus dem monatlichen API-Kontingent deines Holded-Plans.

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.

Rückerstattungen

Wenn du über die Holded-Kasse eine Rückerstattung machst, erstellt Holded einen Korrekturbeleg mit negativem Betrag, der mit dem ursprünglichen Verkauf verknüpft ist. Passtastic wendet deine Punkte-Regel auf den erstatteten Betrag an und zieht so viele Punkte wieder ab – eine Teilrückerstattung nimmt also nur einen Teil der Punkte zurück. Eine Karte geht nie unter null: Hat der Kunde die Punkte schon eingelöst, bleibt sie bei 0 stehen. Wird ein Beleg storniert oder gelöscht, werden seine Punkte ebenfalls abgezogen. Stempelkarten verlieren nur dann einen Stempel, wenn ein Beleg storniert oder gelöscht wird, nicht bei einer Rückerstattung. Du kannst das mit Punkte bei Rückerstattungen abziehen auf der Holded-Seite in Passtastic ausschalten.

Fehlerbehebung

Nichts sammelt, und die Seite zeigt „Verbunden · sammelt nicht". Keine Karte ist eingeschaltet. Schalte unter Deine Treuekarten eine Karte ein. Kam in der Zwischenzeit ein Verkauf herein, zeigt die Seite dessen Datum: Er hat nichts gesammelt, und das wird nicht nachträglich ergänzt.

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

„Dein Holded-Schlüssel kann keine Kontakte erstellen.“ Deinem API-Token fehlt die Berechtigung Contacts: Write (Kontakte: Schreiben), daher kann Passtastic bestehende Kontakte verknüpfen, aber keine neuen erstellen. Erstelle einen neuen API-Token in Holded mit Sales: Read, Contacts: Read + Write (Kontakte: Lesen und Schreiben) und Developers: Full, klicke im Banner auf Neuen Schlüssel einfügen und füge ihn ein. Das Sammeln funktioniert in der Zwischenzeit weiter über den Abgleich von E-Mail und Telefonnummer.

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.