> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# ClassPass mit anny verbinden

> Biete Kurse und Termine über ClassPass an: ClassPass ruft deine Verfügbarkeiten aus anny ab und bucht direkt bei dir.

[ClassPass](https://classpass.com) ist eine weltweite Plattform, über die Mitglieder mit einem Credit-Guthaben Fitness-, Sport- und Wellnessangebote verschiedener Anbieter buchen. Mit der Integration stellt anny deine Kurse und Termine für ClassPass bereit und empfängt die Buchungen automatisch.

Mit ClassPass kannst du in anny:

* Kurse (Ressourcen mit Terminen) für ClassPass-Mitglieder buchbar machen
* Einzeltermine mit deinen buchbaren Leistungen anbieten, inklusive Live-Verfügbarkeiten aus anny
* Buchungen, Stornierungen und Anwesenheit automatisch mit ClassPass abgleichen

Die Integration eignet sich für Studios und Anbieter wie Yoga- oder Pilates-Studios, Gyms, Massage- und Wellnessanbieter, die über ClassPass neue Kund:innen erreichen möchten, ohne Kapazitäten doppelt zu pflegen.

## Typische Anwendungsfälle

| Anwendungsfall                    | Beschreibung                                                                                                                                                                                   |
| :-------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Yoga-Studio mit Kursplan          | **Kurstermine automatisch für ClassPass bereitstellen.** ClassPass listet deine Zeitfenster als Kurse, Mitglieder buchen freie Plätze, und anny führt alle Kanäle in einer Kapazität zusammen. |
| Massage- und Wellnessanbieter     | **Einzeltermine mit Leistungsauswahl anbieten.** ClassPass fragt die freien Startzeiten deiner Leistungen direkt aus anny ab und bucht den Termin in deinen Kalender.                          |
| Studio mit treuer Stammkundschaft | **Plätze für Direktbuchungen reservieren.** Ein Teil der Kursplätze bleibt für deine eigenen Kanäle zurückgehalten und wird erst kurz vor Kursbeginn für ClassPass freigegeben.                |

## Wie die ClassPass-Verbindung funktioniert

Die Verbindung funktioniert umgekehrt zu vielen anderen Integrationen: Du hinterlegst keine Zugangsdaten in anny. Stattdessen ruft ClassPass deine Daten in regelmäßigen Abständen bei anny ab und sendet Buchungen als Anfragen an anny. ClassPass weist sich dabei mit einem Zugangstoken aus, den anny zentral mit ClassPass vereinbart hat. Du teilst ClassPass nur deine **Partner-ID** und deine **Standort-ID** mit. Beide erzeugt anny automatisch.

ClassPass erhält Zugriff auf deine Standortdaten (Name und Adresse der Organisation), die freigegebenen Ressourcen, Leistungen, Termine und Verfügbarkeiten sowie den Anwesenheitsstatus der ClassPass-Buchungen. Alles andere bleibt außen vor: Nicht freigegebene Ressourcen, deine Kund:innen und deine Preise sieht ClassPass nicht.

| Daten                                     | Richtung         | Häufigkeit                                      |
| :---------------------------------------- | :--------------- | :---------------------------------------------- |
| Standort, Kurse, Termine, Verfügbarkeiten | anny → ClassPass | Bei jedem Abruf durch ClassPass                 |
| Buchungen                                 | ClassPass → anny | Echtzeit                                        |
| Stornierungen                             | ClassPass → anny | Echtzeit                                        |
| Anwesenheit (Check-ins, No-Shows)         | anny → ClassPass | Abruf durch ClassPass, bis 7 Tage nach Kursende |
| Kursabsagen                               | anny → ClassPass | Beim nächsten Abruf                             |

Weil ClassPass die Daten abruft, erscheinen Änderungen in anny (neue Termine, Absagen, Kapazitäten) bei ClassPass erst mit dem nächsten Abruf.

## ClassPass verbinden

### Voraussetzungen

Bevor du ClassPass verbindest, stelle sicher, dass du Folgendes hast:

* Eine Partnerschaft mit ClassPass, damit ClassPass deine **Partner-ID** und deine **Standort-ID** hinterlegen kann
* Kurse als **Ressourcen mit Terminen (Zeitfenstern)** und/oder Leistungen für buchbare Einzeltermine
* Einen **Slug** (URL-Kürzel) an jeder Ressource und Leistung, die du freigeben möchtest
* Trainer-Ressourcen mit einer eigenen **Kategorie** (z. B. Mitarbeiter/Trainer)
* Eine gepflegte Adresse in deiner Organisation, damit ClassPass deinen Standort anzeigen kann

### Verbindung einrichten

<Steps>
  <Step title="Integration öffnen und Partner-Einstellungen prüfen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **ClassPass**. In den **Partner-Einstellungen** findest du deine **Partner-ID**. **Partnername** und **Partnerbeschreibung** sind mit deiner Organisation vorbelegt und können überschrieben werden. Die **Standort-Einstellungen** zeigen deine **Standort-ID** sowie Name und Adresse aus deiner Organisation; sie lassen sich hier nicht bearbeiten.
  </Step>

  <Step title="Trainer-Synchronisierung festlegen">
    Wähle unter **Trainer-Ressourcenkategorien auswählen** die Kategorien, deren Ressourcen als Trainer gelten, und lege einen **Standard-Trainer** fest. Er wird verwendet, wenn an einem Termin kein Trainer verknüpft ist.
  </Step>

  <Step title="Kurs-Regeln anlegen">
    Lege im Abschnitt **Kurs-Regeln** pro Kursressource eine Regel über **Hinzufügen** an: Wähle die Ressource und optional **Plätze für Direktbuchungen reservieren** mit Anzahl (**Reservierte Plätze**) und Freigabefrist (**Reservierte Plätze freigeben vor Beginn**). Hinterlege außerdem einen **Berechneten Preis**: Kursbuchungen aus ClassPass laufen über den automatisch erstellten **Service für ClassPass-Buchungen**, und der Preis bildet deine voraussichtlichen ClassPass-Einnahmen in anny ab.
  </Step>

  <Step title="Service-Buchungsregeln anlegen">
    Lege im Abschnitt **Service-Buchungsregeln** pro Ressource eine Regel über **Hinzufügen** an, wenn du Einzeltermine anbieten möchtest: Wähle die Ressource und unter **Buchbare Leistungen** die freigegebenen Leistungen. Lässt du die Auswahl leer, gelten **Alle Leistungen** der Ressource.
  </Step>

  <Step title="Aktivieren und IDs übermitteln">
    Aktiviere die Integration über den **Toggle** oben rechts. anny prüft dabei, ob alle freigegebenen Ressourcen und Leistungen einen Slug haben. Übermittle anschließend deine **Partner-ID** und deine **Standort-ID** an ClassPass, damit ClassPass deine Daten abrufen kann.
  </Step>
</Steps>

Sobald die Integration aktiv ist und ClassPass deine Partner-ID und Standort-ID hinterlegt hat, kannst du Buchungen von ClassPass-Mitgliedern direkt in anny empfangen.

<Tip>
  Vergib sprechende Slugs, bevor du Ressourcen und Leistungen freigibst. Solange sie für ClassPass freigegeben sind, lassen sich die Slugs nicht mehr ändern.
</Tip>

### Einstellungen & Optionen

| Einstellung                             | Beschreibung                                                                                                                                         |
| :-------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- |
| Partnername / Partnerbeschreibung       | So erscheinst du bei ClassPass. Vorbelegt mit deiner Organisation, hier überschreibbar.                                                              |
| Standort-Einstellungen                  | **Standort-ID**, Name und Adresse deines Standorts. Stammen aus der Organisation, nicht editierbar.                                                  |
| Trainer-Ressourcenkategorien auswählen  | Ressourcen dieser Kategorien gelten als Trainer und werden ClassPass mit Namen gemeldet.                                                             |
| Standard-Trainer                        | Fallback, wenn an einem Kurstermin keine Trainer-Ressource verknüpft ist.                                                                            |
| Service für ClassPass-Buchungen         | Automatisch erstellter, versteckter Service, auf dem alle Kursbuchungen aus ClassPass landen.                                                        |
| Berechneter Preis                       | Preis des ClassPass-Services zur Umsatzerfassung. Die tatsächliche Abrechnung läuft über ClassPass.                                                  |
| Kurs-Regel: Ressource auswählen         | Die Kursressource (mit Terminen), deren Zeitfenster ClassPass als Kurse listet.                                                                      |
| Plätze für Direktbuchungen reservieren  | Hält **Reservierte Plätze** für deine eigenen Kanäle zurück; ClassPass sieht entsprechend weniger freie Plätze.                                      |
| Reservierte Plätze freigeben vor Beginn | Frist vor Kursbeginn, ab der zurückgehaltene Plätze für ClassPass freigegeben werden.                                                                |
| Platz-Bezeichnungen aktivieren          | Kennzeichnet Kurse, deren Plätze als Unterressourcen abgebildet sind. anny meldet ClassPass den Namen des zugewiesenen Platzes.                      |
| Termin-Regel: Ressource auswählen       | Die Ressource, die ClassPass für Einzeltermine anbietet. Je nach Kategorie erscheint sie bei ClassPass als Person (Trainer:in) oder als Raum/Objekt. |
| Buchbare Leistungen                     | Die Leistungen, die ClassPass für diese Ressource buchen darf. Leer = **Alle Leistungen** der Ressource.                                             |

## Einschränkungen

Die ClassPass-Integration unterstützt nicht:

* **Sofortige Übertragung an ClassPass:** ClassPass ruft die Daten ab. Neue Termine, Absagen und Kapazitätsänderungen erscheinen dort erst mit dem nächsten Abruf.
* **Bearbeitung von ClassPass-Buchungen in anny:** ClassPass-Buchungen sind schreibgeschützt und können in anny weder storniert noch gelöscht werden. Stornierungen laufen über ClassPass oder über das Absagen des Kurstermins.
* **Platzwahl durch ClassPass-Mitglieder:** anny weist Plätze automatisch zu und meldet nur die vergebene Platz-Bezeichnung zurück.
* **Slug-Änderungen an freigegebenen Ressourcen und Leistungen:** Der Slug ist gesperrt, solange die Freigabe besteht.
* **Mehrfachzuordnung einer Ressource:** Jede Ressource kann nur in einer Kurs-Regel und nur in einer Termin-Regel stehen.
* **Vererbung auf Unterressourcen:** Regeln gelten genau für die ausgewählte Ressource. Unterressourcen erscheinen nicht als eigene Kurse oder Termine.
* **Beliebige Startintervalle bei Terminen:** ClassPass akzeptiert nur Buchungsintervalle von 5, 10, 15, 30 oder 60 Minuten; bei anderen Intervallen übermittelt anny nur die konkreten Startzeiten.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, weist anny alle Abrufe und Buchungsanfragen von ClassPass ab: Dein Angebot verschwindet dort und es kommen keine neuen Buchungen mehr an. Bestehende ClassPass-Buchungen bleiben in anny erhalten. Beim Löschen werden zusätzlich alle Regeln und Einstellungen entfernt; Buchungen bleiben als historische Daten bestehen. Informiere ClassPass, bevor du dauerhaft trennst, damit dein Profil dort entfernt wird.
</Warning>

Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.

## FAQ

<AccordionGroup>
  <Accordion title="Muss ich Zugangsdaten von ClassPass in anny eintragen?">
    Nein. Die Verbindung läuft umgekehrt: ClassPass ruft deine Daten bei anny ab und weist sich dabei selbst aus. Du teilst ClassPass nur deine **Partner-ID** aus den **Partner-Einstellungen** und deine **Standort-ID** aus den **Standort-Einstellungen** mit.
  </Accordion>

  <Accordion title="Was bringt der Berechnete Preis, wenn ClassPass abrechnet?">
    ClassPass rechnet die Buchungen mit dir außerhalb von anny ab. Damit deine Auswertungen trotzdem stimmen, bekommt jede Kursbuchung aus ClassPass in anny den **Berechneten Preis** als Umsatzwert. Er hat keinen Einfluss darauf, was ClassPass dir auszahlt.
  </Accordion>

  <Accordion title="Kann ich eine ClassPass-Buchung in anny stornieren?">
    Nein. ClassPass-Buchungen sind in anny schreibgeschützt. Storniert ein Mitglied über ClassPass, wird die Buchung in anny automatisch storniert. Wenn du einen ganzen Kurstermin absagst oder löschst, storniert anny alle zugehörigen ClassPass-Buchungen mit und meldet den Termin beim nächsten Abruf als abgesagt.
  </Accordion>

  <Accordion title="Wie erfährt ClassPass, ob jemand teilgenommen hat?">
    Über das normale Check-in in anny (z. B. per QR-Ticket). ClassPass ruft die Anwesenheit bis 7 Tage nach Kursende ab: Eingecheckte Mitglieder gelten als teilgenommen, nicht eingecheckte nach Kursende als verpasst.
  </Accordion>

  <Accordion title="Bekommen ClassPass-Kund:innen E-Mails von anny?">
    Nein. Buchungsbestätigungen und Stornierungen kommuniziert ClassPass selbst. anny legt für ClassPass-Mitglieder eine:n Kund:in mit Namen an; ohne übermittelte E-Mail-Adresse verwendet anny eine Platzhalter-Adresse.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Aktivierung schlägt mit „Fehlender Slug“ fehl">
    Mindestens eine freigegebene Ressource oder Leistung hat keinen Slug (URL-Kürzel). Ergänze den Slug in den Einstellungen der Ressource bzw. Leistung und aktiviere die Integration erneut.
  </Accordion>

  <Accordion title="Ein Kurs erscheint nicht bei ClassPass">
    Entweder fehlt die passende **Kurs-Regel**, die Ressource hat im Abrufzeitraum keine Termine, oder die Integration ist deaktiviert. Prüfe Regel, Zeitfenster und den **Toggle**. Beachte außerdem: ClassPass übernimmt Änderungen erst mit dem nächsten Abruf.
  </Accordion>

  <Accordion title="Der Slug einer Ressource lässt sich nicht ändern">
    Die Ressource oder eine ihrer Leistungen ist für ClassPass freigegeben, deshalb ist der Slug gesperrt. Entferne die Ressource aus den Regeln oder deaktiviere die Integration, ändere den Slug und richte die Freigabe danach neu ein. Bedenke, dass ClassPass gespeicherte Kennungen verliert, wenn sich Slugs ändern.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** ClassPass ist ein Buchungskanal (Integrations-Kategorie „Kanal"), wie Urban Sports Club, aber mit umgekehrtem Modell: USC bekommt Termine aktiv von anny gepusht, ClassPass ruft sie per Polling bei anny ab (anny stellt eine eigene Schnittstelle für ClassPass bereit). KEIN Smart-Lock, keine Kalender-Sync, keine Zutrittssteuerung. Es gibt keinen Verbindungstest und keine Authentifizierungs-Panels, weil anny keine ausgehende Verbindung aufbaut.
>
> **UI-Pfade:** Menüleiste → **Integrationen** → **ClassPass**. Panels in dieser Reihenfolge: **Partner-Einstellungen** (Felder „Partner-ID" (read-only), „Partnername", „Partnerbeschreibung"), **Standort-Einstellungen** (read-only: „Standort-ID", „Standortname", „Adresszeile 1", „Adresszeile 2", „Stadt", „PLZ", „Land"), **Trainer-Synchronisierung** (Felder „Trainer-Ressourcenkategorien auswählen", „Standard-Trainer"), **Kurs-Regeln** (Felder „Service für ClassPass-Buchungen" (read-only), „Berechneter Preis"; Regel-Tabelle mit Spalten „Ressource", „Reservierte Plätze", „Platz-Labels"; Dialog „Kurs-Regel bearbeiten" mit „Ressource auswählen", „Platz-Bezeichnungen aktivieren", „Plätze für Direktbuchungen reservieren", „Reservierte Plätze", „Reservierte Plätze freigeben vor Beginn"), **Service-Buchungsregeln** (Regel-Tabelle mit Spalten „Ressource", „Leistungen"; Dialog „Termin-Regel bearbeiten" mit „Ressource auswählen", „Buchbare Leistungen", Platzhalter „Alle Leistungen"). Regeln jeweils über „Hinzufügen", Speichern im Dialog über „Bestätigen".
>
> **Quirks:** (1) Identifikatoren: Partner-ID = eindeutige Kennung der Integration, Standort-ID = externe Kennung der Organisation; ClassPass adressiert jeden Abruf und jede Buchung über das Paar Partner-ID + Standort-ID, deshalb müssen beim Onboarding BEIDE an ClassPass übermittelt werden. Weiter: Kurs-/Termin-Kennungen = Slugs der Ressourcen und Leistungen, Termin-Kennung eines Kurses = interne Zeitfenster-Kennung. Deshalb Slug-Pflicht und Slug-Sperre; das Wechseln der Trainer-Kategorien setzt den Standard-Trainer zurück. (2) Aktivierungsprüfungen: fehlender Slug → Fehler „Fehlender Slug"; Ressource doppelt in Kurs- bzw. Termin-Regeln → „Resource doppelt ausgewählt"; leere Regel → „Fehlerhaftes ClassPass-Mapping". Die Prüfungen laufen bei Aktivierung UND bei jedem Speichern von Einstellungsänderungen im aktiven Zustand. (3) Kursbuchungen landen auf dem versteckten, geschützten Service „ClassPass" (wird bei Aktivierung automatisch erstellt und mit allen Kurs-Ressourcen verknüpft; bei USC gibt es dasselbe Muster). Terminbuchungen landen direkt auf der gewählten Leistung. (4) Termin-Dauer = Standard-/Mindestdauer der Leistung; das gemeldete Stornofenster („late cancel") stammt aus der Stornofrist der Leistung. (5) Anwesenheits-Mapping: Check-in vorhanden → teilgenommen; Kursende ohne Check-in → verpasst; Zeitfenster abgesagt/gelöscht → Kurs abgesagt; Storno via ClassPass nach Beginn → verspätete Stornierung; Storno durch Betreiber:in (Terminabsage) wird bei Terminen als vom Anbieter abgesagt gemeldet. (6) Abgesagte/gelöschte Zeitfenster bleiben im Feed als abgesagt gelistet; ClassPass ruft die Anwesenheit bis 7 Tage nach Kursende ab — deshalb sind ClassPass-Buchungen in anny auch nicht löschbar (Fehlertexte: „Die Buchung … wurde über ClassPass erstellt", Titel „Buchung nicht stornierbar" / „Buchung kann nicht gelöscht werden"). (7) Wiederholte identische Buchungsanfragen von ClassPass sind idempotent (keine Duplikate). (8) Kund:innen-Zuordnung über die ClassPass-Nutzerkennung; Platzhalter-E-Mail im Format `cp-…@placeholder.anny.co`; keine Kund:innen-Benachrichtigungen durch anny. (9) Buchungskanal der Buchungen: ClassPass; Aktivitätseinträge werden der Integration als Verursacherin zugeschrieben. (10) Reservierte Plätze reduzieren nur die an ClassPass gemeldete Verfügbarkeit; nach Ablauf der Freigabefrist wird der volle Restbestand gemeldet. (11) Trainer-Namen entstehen aus dem Ressourcennamen: erstes Wort = Vorname, Rest = Nachname. (12) Kurs ausgebucht → ClassPass erhält „keine Kapazität"; Kursstart vorbei → „Buchungsfenster geschlossen"; Termin abgesagt → „Kurs abgesagt".
>
> **Beziehungen:** Check-ins laufen über das anny-Check-in-Feature (QR-Ticket), siehe Check-In & Check-Out. Kurs-Bereitstellung setzt Ressourcen mit Terminen (Zeitfenstern) voraus, Termin-Bereitstellung die normale anny-Verfügbarkeit (Leistungen, Zeitpläne). Verwandter Artikel: Urban Sports Club (gleiche Kategorie, anderes Sync-Modell; Begriffe „Reservierte Plätze"/Freigabefrist existieren dort analog). Kein Plan-/Feature-Gating im Code, daher kein Info-Plan-Hinweis im Artikel.
