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

# Urban Sports Club mit anny verbinden

> Übertrage ausgewählte Kurse an Urban Sports Club und halte Buchungen und Kapazitäten in Echtzeit synchron.

[Urban Sports Club](https://www.urbansportsclub.com/) (USC) ist eine Plattform, über die Endkund:innen Zugang zu Sport- und Wellnessangeboten verschiedener Anbieter erhalten. Mit der Integration kann anny ausgewählte Kurse an USC übertragen und Buchungen, Kapazitäten sowie Check-ins kanalübergreifend synchron halten.

Mit Urban Sports Club kannst du in anny:

* Ausgewählte Kurse automatisch an USC übertragen und synchron halten
* USC-Buchungen in Echtzeit empfangen und Kapazitäten kanalübergreifend abgleichen
* Check-ins und No-Shows aus USC sichtbar machen

Die Integration eignet sich vor allem für Kursanbieter wie Pilates Studios, Yoga Studios, Gyms oder Wellness-Anbieter, die ihre Reichweite über USC erhöhen möchten, ohne Überbuchungen zu riskieren.

## Typische Anwendungsfälle

| Anwendungsfall                   | Beschreibung                                                                                                                                                                                       |
| :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Reformer Pilates Studio          | **Kurse nach USC synchronisieren und Kontingente für Direktbuchungen reservieren.** Restplätze werden z. B. 24 Stunden vor Start automatisch für USC freigegeben, um die Auslastung zu maximieren. |
| Yoga Studio mit mehreren Kanälen | **Kapazitäten in Echtzeit über alle Kanäle synchron halten.** Buchungen über anny, die eigene Website und USC werden automatisch gegeneinander geprüft.                                            |
| Massage Studio                   | **Angebote als Kurstermine an USC übertragen.** Sofern die Angebote als Ressourcen mit Terminen abgebildet sind, können sie mit USC synchronisiert werden.                                         |

## Wie die USC-Verbindung funktioniert

Die Integration wird über deine **Provider-ID** authentifiziert, die du vom USC Support Team erhältst. Du trägst sie im Abschnitt **Provider** ein und klickst auf **Provider überprüfen**. Damit autorisierst du anny, Kurstermine an USC zu übertragen und USC-Buchungen zu empfangen.

Die Integration baut auf **Ressourcen mit Terminen (Zeitfenstern)** auf: Kurse sind Ressourcen mit verfügbaren Terminen. Trainer sind eigene Ressourcen, die am Termin als bereitgestellte Ressourcen verknüpft werden und automatisch an USC übermittelt werden.

| Daten                          | Richtung   | Häufigkeit                       |
| ------------------------------ | ---------- | -------------------------------- |
| Kurstermine (nächste 3 Wochen) | anny → USC | Automatisch, laufend synchron    |
| Buchungen                      | USC → anny | Echtzeit                         |
| Kapazitäts-Updates             | anny → USC | Echtzeit bei Buchung/Stornierung |
| Check-ins                      | USC → anny | Echtzeit                         |
| No-Shows                       | USC → anny | 1 Tag nach Ende der Buchung      |

## Urban Sports Club verbinden

### Voraussetzungen

Bevor du Urban Sports Club verbindest, stelle sicher, dass du Folgendes hast:

* Eine **Provider-ID** (erhältst du vom [USC Support Team](https://docs.urbansportsclub.io/documentation/studio-onboarding))
* Kurse in anny als **Ressourcen mit Terminen (Zeitfenstern)**, ohne eigene Öffnungszeiten
* Trainer-Ressourcen mit einer passenden **Kategorie** (z. B. Mitarbeiter/Trainer)
* Einen **Standard-Trainer**, der greift, wenn am Termin kein Trainer verknüpft ist (Pflicht)
* Ressourcen, die sich über den **Standort-Sync** deinen **USC Locations** zuordnen lassen

### Verbindung einrichten

<Steps>
  <Step title="Provider verbinden">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Urban Sports Club**. Trage im Abschnitt **Provider** deine **Provider-ID** ein und klicke auf **Provider überprüfen**.
  </Step>

  <Step title="Grundeinstellungen setzen">
    Lege die globalen Einstellungen für USC-Buchungen fest:

    1. Hinterlege optional einen **Kalkulierten Preis** für USC-Buchungen.
    2. Wähle unter **Ressourcenkategorien der Trainer** die Kategorien, deren Ressourcen als Trainer gelten.
    3. Lege einen **Standard-Trainer** fest (Pflicht).
    4. Ordne im **Standort-Sync** deine Ressourcen den passenden **USC Locations** zu.
  </Step>

  <Step title="Kurse einrichten">
    Lege pro Kurs eine Regel über **Hinzufügen** an:

    1. Wähle die **Kursressource**.
    2. Wähle den **Standort** (USC Location).
    3. Wähle die **Kurskategorie**.
    4. Lege die **Verspätete Stornierungsfrist** fest (bis zu 12 Stunden vor Start).
    5. Optional: Lege **Reservierte Plätze** und die **Frist für die Reservierung von Plätzen** fest.
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, werden Termine der nächsten 3 Wochen automatisch an USC übertragen und Buchungen in Echtzeit synchronisiert.

<Tip>
  Der **Standard-Trainer** erspart dir die manuelle Pflege pro Termin. Ist am Termin keine Trainer-Ressource verknüpft, wird er automatisch als Trainer an USC übermittelt.
</Tip>

### Einstellungen & Optionen

| Einstellung                            | Beschreibung                                                                                                 |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Ressourcenkategorien der Trainer       | Kategorien, deren Ressourcen als Trainer an USC übermittelt werden                                           |
| Standard-Trainer                       | Pflicht. Wird verwendet, wenn am Termin kein Trainer verknüpft ist                                           |
| Standort-Sync                          | Zuordnung von anny-Ressourcen zu USC Locations als Veranstaltungsort                                         |
| Kalkulierter Preis                     | Optionaler Preis zur Umsatzerfassung von USC-Buchungen in anny                                               |
| Kursressource                          | Der anny-Kurs (Ressource mit Terminen), der an USC übertragen wird                                           |
| Kurskategorie                          | USC-Kategorie, unter der der Kurs an USC erscheint                                                           |
| Standort                               | USC Location, an der der Kurs stattfindet                                                                    |
| Verspätete Stornierungsfrist           | Frist vor Kursbeginn, ab der eine Stornierung bei USC als verspätet gilt (bis zu 12h)                        |
| Reservierte Plätze                     | Für anny und andere Kanäle reservierte Plätze pro Kurs (optional)                                            |
| Frist für die Reservierung von Plätzen | Zeitpunkt vor Kursbeginn, zu dem nicht belegte reservierte Plätze für USC freigegeben werden (mindestens 1h) |

## Termine und Sync-Logik

Die Synchronisation folgt festen Regeln:

| Regel               | Beschreibung                                                                      |
| ------------------- | --------------------------------------------------------------------------------- |
| Sync-Fenster        | Alle Termine der nächsten **3 Wochen** werden automatisch übertragen              |
| Buchbarkeit für USC | Nur Termine innerhalb der nächsten **2 Wochen** sind für USC-Nutzer:innen buchbar |
| Verschieben         | Bereits übertragene Termine können **nicht verschoben** werden, nur storniert     |
| Stornierung         | Storno in anny storniert auch den Termin in USC inkl. aller USC-Buchungen         |

## USC-Buchungen in anny

USC-Buchungen sind in anny über die Buchungsoption **Urban Sports Club** gekennzeichnet. Diese Buchungsoption ist nicht editierbar und USC-Buchungen können in anny nicht bearbeitet werden.

USC-Buchungen enthalten nur den Namen der Kund:innen und eine Platzhalter-E-Mail-Adresse.

## Check-ins, No-Shows und Anonymisierung

| Ereignis        | Verhalten in anny                                                                                         |
| --------------- | --------------------------------------------------------------------------------------------------------- |
| USC Check-in    | Wird als Check-in an anny übertragen und ist sichtbar                                                     |
| USC Stornierung | Buchung wird storniert und die Kund:innendaten werden gemäß USC-Vorgaben anonymisiert                     |
| USC No-Show     | Wird 1 Tag nach Ende der Buchung als No-Show markiert (keine Anonymisierung)                              |
| Ausnahme        | Kund:innen werden bei einer Stornierung nicht anonymisiert, wenn noch eine andere Buchung in anny besteht |

## Kapazitätsmanagement

Optional kannst du pro Kurs ein Platzkontingent für Direktbuchungen (über anny und andere Kanäle) reservieren. USC kann dann nur die verbleibenden Plätze belegen.

Zusätzlich kannst du eine **automatische Freigabe** konfigurieren: Reservierte Plätze, die nicht belegt wurden, werden zu einem definierten Zeitpunkt (z. B. 24 Stunden vor Kursstart) für USC freigegeben. So maximierst du die Auslastung, ohne Stammkund:innen Plätze wegzunehmen.

## Einschränkungen

Die Urban Sports Club-Integration unterstützt nicht:

* Verschieben von Terminen nach Übertragung an USC: Termine können nur storniert, nicht verschoben werden
* Bearbeitung von USC-Buchungen in anny: USC-Buchungen sind schreibgeschützt
* Echtzeit-No-Shows: No-Show-Daten werden erst am Folgetag von USC bereitgestellt
* Kurse ohne Termine: Nur Ressourcen mit Terminen (Zeitfenstern) können synchronisiert werden
* Kurs-Ressourcen mit eigenen Öffnungszeiten: Ressourcen mit eigenem Zeitplan lassen sich nicht als USC-Kurs synchronisieren
* Mehrfachnutzung einer Ressource: Jede Kursressource kann nur einer USC-Kursregel zugeordnet werden

## Verbindung trennen

<Warning>
  Wenn du keine neuen Termine mehr synchronisieren möchtest, bestehende Termine und Buchungen in USC aber erhalten bleiben sollen, deaktiviere die Integration. Wenn alle synchronisierten Termine aus USC entfernt werden sollen, lösche die Integration. Bestehende USC-Buchungen in anny bleiben als historische Daten erhalten.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Welche Kurse kann ich an USC übertragen?">
    Du kannst in der Integration frei auswählen, welche anny-Kurse an USC übertragen werden sollen. Voraussetzung ist, dass sie als Ressourcen mit Terminen (Zeitfenstern) angelegt sind und keinen eigenen Zeitplan haben.
  </Accordion>

  <Accordion title="Können USC-Buchungen in anny bearbeitet werden?">
    Nein. USC-Buchungen sind in anny schreibgeschützt und über die Buchungsoption "Urban Sports Club" gekennzeichnet. Änderungen müssen auf USC-Seite erfolgen.
  </Accordion>

  <Accordion title="Wann erscheinen USC No-Shows in anny?">
    USC stellt No-Show-Informationen erst am Folgetag bereit. Sie werden daher 1 Tag nach Ende der Buchung an anny übertragen.
  </Accordion>

  <Accordion title="Was passiert, wenn ich einen Termin in anny storniere?">
    Der Termin wird auch in USC abgesagt und alle bestehenden USC-Buchungen für diesen Termin werden aufgehoben.
  </Accordion>

  <Accordion title="Wie erhalte ich meine Provider-ID?">
    Die **Provider-ID** erhältst du vom USC Support Team. Weitere Informationen findest du in der [USC Provider-Dokumentation](https://docs.urbansportsclub.io/documentation/studio-onboarding).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ein Termin lässt sich nicht mehr verschieben">
    Der Termin wurde bereits an USC übertragen. Einmal übertragene Termine können nicht verschoben, sondern nur noch storniert werden. Lege bei Bedarf einen neuen Termin an.
  </Accordion>

  <Accordion title="Die Kapazität in USC stimmt nicht mit anny überein">
    Prüfe, ob Buchungen über anny oder andere Kanäle eingegangen sind, die noch nicht synchronisiert wurden. Die Kapazität wird in Echtzeit aktualisiert. Bei anhaltendem Problem: Integration deaktivieren und erneut aktivieren.
  </Accordion>

  <Accordion title="Ein:e USC-Kund:in wird anonym angezeigt">
    Das ist erwartetes Verhalten. Bei einer Stornierung werden die Daten der USC-Kund:innen gemäß USC-Vorgaben anonymisiert. Eine Ausnahme gilt nur, wenn die Person noch eine weitere Buchung in anny hat. No-Shows lösen keine Anonymisierung aus.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Urban Sports Club ist ein Partner-/Buchungskanal: externe USC-Mitglieder buchen anny-Kurse über USC. KEIN Smart-Lock, keine Zutrittssteuerung, keine Kalender-Sync. Grundlage sind Ressourcen mit Terminen (Zeitfenstern), NICHT ein „Kursplaner-Modell" (dieser Begriff existiert im Produkt nicht). Abgrenzung zu ClassPass: USC nutzt ein eigenes Integrationsmodell (Provider-ID, Regeln pro Kurs), ClassPass ist eine andere Channel-Integration.
>
> **UI-Pfade:** Menüleiste → **Integrationen** → **Urban Sports Club**. Abschnitte in dieser Reihenfolge: **Provider** (Feld „Provider-ID", Button „Provider überprüfen"), **Preis** (Feld „Kalkulierter Preis"), **Trainer-Sync** (Felder „Ressourcenkategorien der Trainer", „Standard-Trainer"), **Standort-Sync** (Ressource ↔ USC Location), **Kurs-Sync**/„Kurse einrichten" (Regeln über „Hinzufügen"). Regel-Felder: „Kursressource", „Standort", „Kurskategorie", „Verspätete Stornierungsfrist", „Reservierte Plätze", „Frist für die Reservierung von Plätzen".
>
> **Quirks:** (1) Authentifizierung: Nutzer:in trägt nur die Provider-ID ein; anny authentifiziert sich dahinter per Client-Credentials, Access-Token läuft nach 10 Minuten ab. (2) Standard-Trainer ist Pflicht; ohne ihn schlägt Aktivierung/Speichern fehl. (3) Kurs-Ressource darf keine eigenen Zeitpläne (Schedules) haben, sonst Aktivierungsfehler. (4) Jede Ressource nur in einer Kursregel (keine Duplikate). (5) Verspätete Stornierungsfrist max. 12h vor Start; Freigabefrist reservierter Plätze min. 1h vor Start (Voreinstellungen: Stornofrist 12h, reservierte Plätze 2, Freigabe 12h). (6) Sync-Fenster: anny überträgt Termine der nächsten 3 Wochen; die im Artikel genannten „2 Wochen buchbar" sind aus dem anny-Code nicht belegt (vermutlich USC-seitig). (7) Übertragene Termine: Start/Ende/Ressource gesperrt; Titel/Beschreibung/Platzzahl/Buchungszahl werden bei Änderung an USC nachgezogen. (8) Beschreibungen: nur EN, DE, FR, ES, PT, IT, NL; HTML/Markdown wird entfernt. (9) Check-in und Stornierung/verspätete Stornierung kommen per Webhook (Echtzeit); No-Shows via Scheduler ca. 24h nach Terminende. (10) No-Show setzt die anny-Buchung auf abgelaufen/No-Show, anonymisiert NICHT. (11) Anonymisierung nur bei Stornierung, nur wenn die Person über USC angelegt wurde und keine weitere Buchung hat (Zählung offenbar statusunabhängig). (12) Trainer werden aus bereitgestellten Ressourcen der Trainer-Kategorien automatisch in USC angelegt; Trainername aus Ressourcennamen (erstes Wort = Vorname). (13) Kund:innen-Zuordnung: per USC-Kennung, sonst exakter Vor-/Nachname (nur nicht-USC-verknüpfte), sonst Neuanlage; E-Mail ist Platzhalter `usc-…@placeholder.anny.co`. Zuvor anonymisierte Person wird bei Neubuchung wiederhergestellt. (14) Doppelbuchung derselben Person pro Kurs wird abgelehnt; Buchungen für vergangene/ausgebuchte Termine ebenfalls.
>
> **Beziehungen:** Der „Kalkulierte Preis" erzeugt automatisch einen versteckten, geschützten Service „Urban Sports Club", der mit den USC-Kurs-Ressourcen verknüpft wird (Umsatzerfassung). „Reservierte Plätze": bis zur Freigabefrist meldet anny diese Plätze USC als belegt (max(tatsächliche Nicht-USC-Buchungen, reservierte Plätze)). Verbindung trennen: Deaktivieren stoppt neue Übertragungen und Webhook-Verarbeitung, bestehende USC-Events bleiben; Löschen deaktiviert zuerst und entfernt dann alle Syncs/Events aus USC, anny-Buchungen bleiben als Historie. Kein Plan-/Feature-Gating im Code (nur Aktivierungs-Flag), daher kein Info-Plan-Hinweis. Buchungskanal der USC-Buchungen: „Urban Sports Club" (nicht editierbar).
