# Account-Einstellungen
Source: https://docs.anny.co/account-settings

Die Reiter der Account-Einstellungen: Profil, Abo, Anfragen, anny AI, Rechnungen, Zahlungen, Sicherheit und mehr.

In den Account-Einstellungen legst du fest, was für die ganze Organisation gilt: Profil, Buchungsseite, Rechnungen, Zahlungen und Sicherheit. Einstellungen an einer einzelnen Ressource oder einem Service ergänzen das oder gelten nur dort.

## So öffnest du die Account-Einstellungen

Zwei Wege führen auf dieselbe Seite:

* In der Seitenleiste unter **Account** auf **Einstellungen**.
* Oben rechts auf deinen **Avatar** und dann **Account Einstellungen**.

Oben steht der Name des Accounts, daneben **Buchungsseite aktiv** oder **Buchungsseite inaktiv**. Änderungen speicherst du mit **Speichern** in der Kopfzeile.

<Frame>
  <img alt="Account-Einstellungen von Basecamp: Seitenleiste mit Einstellungen, Reiter von General bis Share and embed, darunter Shop settings, Custom data fields und Documents" />
</Frame>

## Alle Reiter

| Reiter | Was du dort findest | Wann du ihn siehst |
| - | - | - |
| **Allgemein** | Profil, Shop, eigene Datenfelder, Dokumente | Immer |
| **Abo** | Plan und Rechnungsdaten von anny | Wenn der Account ein Abo oder eine Testphase hat |
| **Anfragen** | E-Mails empfangen und neue Anfragen als Bestellungen erfassen | Wenn du die Organisation bearbeiten darfst |
| **anny AI** | Dein anny KI-Agent für Kund:innen: testen, konfigurieren, Wissen | Wenn anny AI für den Account verfügbar ist |
| **Rechnungsstellung** | Automatisierte Rechnungsstellung | Immer |
| **Online-Zahlungen** | Zahlungskonditionen | Wenn Online-Zahlungen für den Account verfügbar sind |
| **SSO & Sicherheit** | Domains, Attribute Mapping, Zwei-Faktor-Authentifizierung | Immer |
| **Datenschutz** | Lösch- und Anonymisierungsfristen | Wenn **Löschfristen** aktiv sind |
| **Buchungsregeln** | Regeln für alle Buchungen und für einzelne Ressourcen | Immer |
| **Gruppen** | Produkt-, Paket-, Ressourcen- und Servicegruppen, Tags | Immer |
| **API & Webhooks** | Personal Access Tokens und Webhooks | Wenn du Webhooks verwalten darfst |
| **Teilen & Einbetten** | Link zur Buchungsseite und Einbinden | Immer |

## Was in den Reitern liegt

### Allgemein

**Allgemein** ist das Profil des Accounts. Du hinterlegst Logo, Namen, Zeitzone, Währung, Use Case, Branche, Beschreibung und Titelbild. Kontaktdaten und Rechtliche Angaben erscheinen auf der Buchungsseite und auf dem Rechnungs-PDF. Das Logo kommt automatisch auf das Rechnungs-PDF. Unter Rechnungsstellung gibt es dafür keine eigene Logo-Option.

**Shop-Einstellungen** gliedern sich in Allgemein, Buchungsseite, Etiketten & Barcodes, Verfügbarkeitskalender und Mitteilungen. Das Layout der Buchungsseite stellst du unter Buchungsseite ein. Mehr dazu im Artikel [Layout der Buchungsseite](/booking-page-layout). Etiketten & Barcodes erscheint, wenn Etiketten für den Account verfügbar sind.

**Eigene Datenfelder** enthält Zusätzliche Felder im Checkout. Eigene Bestelldaten, Eigene Kundendaten und Eigene Unternehmensdaten kommen dazu, wenn eigene Datenfelder für den Account freigeschaltet sind.

Unter Dokumente pflegst du **AGB** und **Datenschutzerklärung**. Der Status ist gesetzt oder nicht gesetzt, daneben Bearbeiten.

### Abo

Abo zeigt, welcher anny Plan gilt, und die Rechnungsdaten. In der Seitenleiste erreichst du denselben Reiter über Einstellungen und dann Abrechnung.

### Anfragen

Anfragen empfängt E-Mails und legt neue Anfragen als Bestellungen an. Der Ablauf steht im Artikel [Anfragen & Anfrageformulare](/inquiries).

### anny AI

anny AI ist die Seite für den Telefon- und Chat-Assistent, den deine Kund:innen nutzen. Hier gelangst du zu der Konfiguration sowie Verwaltung deines anny AI Plans.

Das ist nicht der **anny** **KI-Agent**. Den beschreibt [anny Agent](/anny-agent).

### Rechnungsstellung

Rechnungsstellung enthält Automatisierte Rechnungsstellung. Details stehen im Artikel [Rechnungsstellung](/invoicing).

### Online-Zahlungen

Online-Zahlungen zeigt Deine Zahlungskonditionen. Der Reiter setzt voraus, dass Zahlungsabwicklung & Rechnungsstellung für den Account verfügbar ist.

### SSO & Sicherheit

SSO & Sicherheit enthält Domains, Attribute Mapping und Zwei-Faktor-Authentifizierung erzwingen.

### Datenschutz

Datenschutz konfiguriert Lösch- und Anonymisierungsfristen. Er erscheint nur, wenn Löschfristen aktiv sind.

### Buchungsregeln

Buchungsregeln hält Accountweite Regeln für Buchungen und Ressourcenspezifische Regeln für Buchungen.

### Gruppen

Gruppen sind die Stammdaten, nach denen Buchungen, Ressourcen und Services gegliedert sind. Du ziehst Einträge, um die Reihenfolge zu ändern. Die Gruppen heißen Produktgruppen, Buchungspaket-Gruppen, Ressourcengruppen und Servicegruppen. Tags kennzeichnen Buchungen, Bestellungen, Kunden, Ressourcen und Services. Wer einen Datensatz bearbeiten darf, kann ihn taggen.

### API & Webhooks

API & Webhooks enthält Personal Access Tokens und Webhooks.

### Teilen & Einbetten

Teilen & Einbetten gibt dir den Link zur Buchungsseite und das Einbinden auf einer Website.

## Was nicht mehr in den Account-Einstellungen liegt

<Note>
  Update: Admin 3.0 (Oktober 2026)
</Note>

* Aktivierbare Funktionen liegen in der Seitenleiste unter **Apps & Integrationen**, nicht mehr als eigener Reiter.
* **Mitteilungen** liegen unter **Allgemein**, in den **Shop-Einstellungen**.
* Blocker liegen unter **Buchungen** und dann **Blocker**, nicht mehr als Reiter. Mehr dazu im Artikel [Globale Blocker](/global-blockers).

## FAQ

<AccordionGroup>
  <Accordion title="Welche Reiter sehe ich nur unter bestimmten Bedingungen?">
    **Abo** erscheint, wenn der Account ein Abo oder eine Testphase hat. **Anfragen** siehst du, wenn du die Organisation bearbeiten darfst. **anny AI** und **Online-Zahlungen** erscheinen, wenn sie für den Account verfügbar sind. **Datenschutz** nur mit **Löschfristen**. **Auszahlungen** nur ohne Zahlungskonto, wenn der Account Auszahlungen nutzt und du sie sehen darfst. **API & Webhooks** nur, wenn du Webhooks verwalten darfst.
  </Accordion>

  <Accordion title="Was ist der Unterschied zu Ressourcen-Einstellungen?">
    Account-Einstellungen gelten für die ganze Organisation. Ressourcen und Services haben eigene Einstellungen, die das ergänzen oder nur für diesen Eintrag gelten.
  </Accordion>

  <Accordion title="Wer kann die Account-Einstellungen bearbeiten?">
    **Einstellungen** siehst du, wenn du die Organisation bearbeiten darfst. In den Standardrollen sind das **Super-Admin** und **Admin**. Mehr dazu im Artikel [Admin-Nutzer und Rollen verwalten](/roles-and-permissions).
  </Accordion>

  <Accordion title="Wo finde ich meinen anny Plan?">
    Unter **Account** auf **Einstellungen** und dann den Reiter **Abo**, oder in der Seitenleiste **Einstellungen** und **Abrechnung**. Das Avatar-Menü hat dafür keinen eigenen Punkt mehr.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> Pfade: Seitenleiste **Account** → **Einstellungen** (`organization-settings-general`). Avatar → **Account Einstellungen** (`sidebar.items.accountSettings`, ohne Bindestrich) routet auf `organization-settings-account` und leitet auf Allgemein um.
>
> Reiter in Reihenfolge, Quelle `pages/organization/settings.vue`: **Allgemein** immer. **Abo** nur bei `requiresSubscription` oder `testingPeriodEndDate`. **Aktivität** ist `hidden: true`, nicht als Reiter nennen. **Anfragen** bei `can('update', organization)`. **anny AI** nur wenn `annyAiEnabled` nicht false. **Rechnungsstellung** immer. **Online-Zahlungen** bei Feature `payments` und `paymentsEnabled`. **SSO & Sicherheit** immer. **Datenschutz** bei Feature `clearance-periods`. **Buchungsregeln** immer. **Gruppen** immer. **Auszahlungen** bei `can('*', 'accounting-payouts')`, `usesPayments` und ohne `paymentAccount`. **API & Webhooks** bei `can('index', 'webhook-subscriptions')`. **Teilen & Einbetten** immer.
>
> Nicht mehr hier: Features sind **Apps & Integrationen**. Mitteilungen stecken in Shop-Einstellungen. Globale Blocker sind die Route `/blockers`. `account`, `features`, `notifications` und `blockers` unter settings sind Redirects.
>
> Reiter **anny AI** ist der Kund:innen-Agent (Testanruf, Chat testen, Planwahl). Der In-Admin-Agent ist `/anny-agent`, Button **KI-Agent**.
>
> Logo unter Allgemein erscheint auf dem Rechnungs-PDF. Keine eigene Logo-Option unter Rechnungsstellung.


# Buchhaltung mit anny
Source: https://docs.anny.co/accounting

Exportiere Kontoauszüge, Belege und Umsatzübersichten aus anny und integriere sie in DATEV oder andere Buchhaltungssysteme.

anny stellt alle Zahlungsbewegungen als strukturierte Kontoauszüge bereit. Diese können automatisiert exportiert und in Buchhaltungssysteme wie DATEV, lexoffice oder sevDesk importiert werden: wahlweise als CSV oder im Bankstandard CAMT.053 (XML). Jeder Export enthält neben den Transaktionsdaten auch die zugehörigen Belege als PDF.

<Info>
  Die Buchhaltungsfunktionen setzen eine aktive **Online-Zahlung (Stripe Connect)** voraus. Ohne Stripe-Verbindung gibt es kein anny-Zahlungskonto und keine Kontoauszüge.
</Info>

## Wie funktioniert das anny-Zahlungskonto?

Das anny-Zahlungskonto (Stripe Connect) verhält sich wie ein eigenes Bankkonto mit Saldo. Es empfängt Zahlungen, verrechnet Gebühren und führt Auszahlungen an das hinterlegte Geschäftskonto durch.

**Empfohlene Einrichtung in DATEV / Buchhaltungssoftware:**

<Steps>
  <Step title="Neues Bankkonto anlegen">
    Erstelle ein neues Bankkonto (z. B. Konto 1370 "anny / Stripe").
  </Step>

  <Step title="Mock-IBAN hinterlegen">
    Verwende die von anny generierte Mock-IBAN als Kontonummer (Format: `DE00` + Konto-ID).
  </Step>

  <Step title="BIC setzen">
    Trage als BIC `STRIPE` ein. CAMT-Dateien können dann direkt als Kontoauszug importiert werden.
  </Step>
</Steps>

Damit behandelt das Buchhaltungssystem anny wie eine reguläre Bankverbindung mit Eröffnungs- und Schlusssaldo.

## Transaktionsarten

| Bewegung | Buchungsrichtung | CAMT-Typ |
| - | - | - |
| Zahlung (Kunde bezahlt) | Haben (Eingang) | `PMNT/RCDT/ESCT` |
| Rückerstattung | Soll (Ausgang) | `PMNT/RDDT/ESDD` |
| Auszahlung auf Bankkonto | Soll (Ausgang) | `PMNT/ICDT/ESCT` |
| Plattformgebühr (anny-Gebühr) | Soll (Gebühr) | `PMNT/OTHR/OTHR` |
| Streitfall / Chargeback | Soll (Ausgang) | `PMNT/RDDT/ESDD` |

<Tip>
  Auszahlungen von anny auf das Geschäftskonto sind keine eigenen Geschäftsvorfälle, sondern lediglich eine Umbuchung zwischen zwei Konten (Soll auf anny-Konto, Haben auf Geschäftskonto). Pro Auszahlung muss nichts extra gebucht werden.
</Tip>

## Gebührenmodelle

anny unterstützt zwei Gebührenmodelle, die sich auf die Darstellung im Kontoauszug auswirken.

### Altes Modell (bis 13.04.2026)

Gebühren werden direkt bei Zahlungseingang vom Bruttobetrag abgezogen. Auf dem Kontoauszug erscheint nur der Nettobetrag.

| Transaktion | Betrag | Beleg |
| - | - | - |
| Zahlung (abzgl. Gebühr) | +9,46 € | Kundenrechnung über 10,00 € |

<Warning>
  Bei diesem Modell stimmt der Betrag auf dem Kontoauszug nicht 1:1 mit der Kundenrechnung überein. Die Differenz ergibt sich aus Stripe- und anny-Gebühren.
</Warning>

### Neues Modell (ab 13.04.2026)

Gebühren werden nicht bei Zahlungseingang abgezogen, sondern erst bei Auszahlung als separater Einzug verrechnet. Jede Transaktion hat dadurch genau einen passenden Beleg.

| Transaktion | Betrag | Beleg |
| - | - | - |
| Zahlung | +10,00 € | Kundenrechnung über 10,00 € |
| Auszahlung auf Bankkonto | -150,00 € | (Umbuchung, kein Beleg nötig) |
| Gebühreneinzug (anny) | -8,30 € | Gebührenrechnung mit MwSt. |

## Wann nutze ich das?

* **Du nutzt Online-Zahlung und möchtest deine Buchhaltung automatisieren**: Richte einen monatlichen Export ein und übergib das ZIP-Archiv an deinen Steuerberater.
* **Du arbeitest mit DATEV**: Nutze den CAMT.053-Export als Kontoauszug mit Saldofortschreibung.
* **Du brauchst eine tägliche Umsatzübersicht**: Richte einen täglichen Export mit Revenue Summary ein.
* **Du möchtest Trinkgelder pro Mitarbeiter:in auswerten**: Der tägliche Export schlüsselt POS-Trinkgelder pro Person auf.
* **Nicht geeignet für**: Accounts ohne Online-Zahlung. Ohne Stripe gibt es keine Kontoauszüge.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Stripe Connect | Grundvoraussetzung für das Zahlungskonto und alle Exporte |
| (Automatische) Exporte | Exportpläne und Zustelloptionen für die Buchhaltung |
| DATEV Import | Automatische Rechnungsweiterleitung per E-Mail an DATEV |

## Einstellungen & Optionen

### Exportformate

| Format | Geeignet für |
| - | - |
| CSV / Excel | Manuelle Prüfung, einfache Buchhaltungssysteme |
| CAMT.053 (XML) | DATEV, ADDISON, Agenda und alle CAMT-fähigen Systeme |

### ZIP-Archiv (Statement Bundle)

Jeder Export wird als ZIP bereitgestellt und enthält:

* `statement.xml` (oder `.csv` / `.xlsx`): Kontoauszug
* `revenue-summary.pdf`: Umsatzübersicht nach Steuersätzen
* `receipt-index.csv`: Zuordnung Transaktion → Beleg
* `receipts/`: Alle Rechnungs-PDFs

Die Umsatzübersicht schlüsselt auf: Umsatz nach Steuersatz (19%, 7%, steuerfrei), steuerfreie Gutscheinverkäufe und Trinkgelder (POS).

### Automatische Exports

| Exporttyp | Empfehlung |
| - | - |
| Monatlich (1. jeden Monats) | Standard für Buchhaltung. Ein Export pro Monat reicht. |
| Täglich (optional) | Für tägliche Umsatzübersicht oder Trinkgeld-Aufschlüsselung |

**Zustelloptionen:** E-Mail (auch direkt an Steuerberater), SFTP, FTP, S3.

<Tip>
  Richte den Steuerberater als E-Mail-Empfänger unter Export-Zielen ein. Er erhält dann automatisch am Monatsanfang das vollständige ZIP-Archiv mit Kontoauszug und allen Belegen.
</Tip>

## Buchungsworkflow

### Variante A: CAMT-Import (empfohlen für DATEV)

<Steps>
  <Step title="Monatlichen Export importieren">
    Importiere die CAMT.053-Datei als Kontoauszug in DATEV (Konto 1370 "anny / Stripe"). Buchungsvorschläge werden automatisch generiert.
  </Step>

  <Step title="Belege zuordnen">
    Ordne die Rechnungs-PDFs aus dem ZIP den Buchungen zu. Die `receipt-index.csv` hilft bei der Zuordnung über Rechnungsnummer.
  </Step>

  <Step title="Auszahlungen verknüpfen">
    Verknüpfe Auszahlungen auf dem anny-Konto mit Zahlungseingängen auf dem Geschäftskonto (Umbuchung).
  </Step>

  <Step title="Umsatzübersicht kontrollieren">
    Ziehe die `revenue-summary.pdf` zur Kontrolle der Erlös- und Steuerkonten heran.
  </Step>
</Steps>

### Variante B: CSV-Import (einfache Buchhaltung)

<Steps>
  <Step title="CSV importieren">
    Importiere die CSV-Datei in die Buchhaltungssoftware.
  </Step>

  <Step title="Spalten mappen">
    Ordne die Spalten zu: Datum, Betrag, Beschreibung, Referenz.
  </Step>

  <Step title="Belege manuell zuordnen">
    Ordne Belege manuell oder über die Rechnungsnummer den Buchungen zu.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Warum erscheint ein SEPA-Einzug auf meinem Bankkonto?">
    Wenn eine Rückerstattung oder ein Chargeback das anny-Guthaben übersteigt, entsteht ein negativer Saldo. Stripe zieht den fehlenden Betrag per SEPA-Lastschrift vom hinterlegten Bankkonto ein, um das Konto auszugleichen.
  </Accordion>

  <Accordion title="Warum steht mein Guthaben nicht zur Auszahlung bereit?">
    Zahlungen durchlaufen eine Bearbeitungszeit: 5 Werktage ab Zahlungseingang plus 1 Tag nach Beginn der Buchung. Bei Paketen und Abos gelten nur die 5 Werktage (kein Buchungsbezug).
  </Accordion>

  <Accordion title="Reicht ein monatlicher Export für die Buchhaltung?">
    Ja. Der monatliche Export enthält den vollständigen Kontoauszug mit allen Transaktionen, Auszahlungen und Belegen. Ein täglicher Export ist nur für interne Abstimmung oder Trinkgeld-Auswertung nötig.
  </Accordion>

  <Accordion title="Muss ich Auszahlungen separat buchen?">
    Nein. Auszahlungen sind im Kontoauszug bereits als Abgang enthalten. Der Steuerberater verknüpft sie mit dem Zahlungseingang auf dem Geschäftskonto (einfache Umbuchung).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Betrag auf dem Kontoauszug stimmt nicht mit der Kundenrechnung überein">
    Du verwendest wahrscheinlich noch das alte Gebührenmodell (bis 13.04.2026), bei dem Gebühren direkt bei Zahlungseingang abgezogen werden. Beim neuen Modell (ab 13.04.2026) stimmen Beträge 1:1 überein.
  </Accordion>

  <Accordion title="Der Export enthält keine Belege">
    Stelle sicher, dass du das ZIP-Format ausgewählt hast. Nur ZIP-Exporte enthalten die Rechnungs-PDFs und die receipt-index.csv.
  </Accordion>

  <Accordion title="DATEV erkennt die CAMT-Datei nicht als Kontoauszug">
    Prüfe, ob du in DATEV ein Bankkonto mit der anny Mock-IBAN und BIC "STRIPE" angelegt hast. Ohne dieses Konto kann DATEV die Datei nicht zuordnen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Buchhaltung setzt aktive Online-Zahlung (Stripe Connect) voraus. Ohne Stripe gibt es kein anny-Zahlungskonto und keine Kontoauszüge.
> * anny-Zahlungskonto verhält sich wie ein eigenes Bankkonto. Empfehlung: In DATEV als Konto 1370 "anny / Stripe" mit Mock-IBAN (DE00 + Konto-ID) und BIC "STRIPE" anlegen.
> * Zwei Gebührenmodelle: Alt (bis 13.04.2026, Gebühren pro Zahlung abgezogen) vs. Neu (ab 13.04.2026, Gebühren gesammelt bei Auszahlung). Neues Modell: 1:1 Zuordnung Transaktion → Beleg.
> * Auszahlungen = Umbuchung zwischen anny-Konto und Geschäftskonto, kein eigener Geschäftsvorfall.
> * Verfügbarkeit des Guthabens: 5 Werktage Bearbeitungszeit + 1 Tag nach Buchungsbeginn (Buchungen). Pakete & Abos: nur 5 Werktage.
> * Exportformate: CSV/Excel, CAMT.053 (XML), ZIP-Archiv mit allen Belegen + receipt-index.csv + revenue-summary.pdf.
> * Monatlicher Export = empfohlener Standard für Steuerberater. Täglicher Export optional für interne Abstimmung.
> * Zustelloptionen: E-Mail, SFTP, FTP, S3.
> * Revenue Summary enthält: Umsatz nach Steuersatz, steuerfreie Gutscheinverkäufe, Trinkgelder (POS).
> * Negativer Saldo (z. B. durch Rückerstattung): Stripe zieht fehlenden Betrag per SEPA-Lastschrift vom Bankkonto ein.
> * Verwandte Artikel: Stripe Connect einrichten, Online-Zahlung & Gebühren, DATEV Import, (Automatische) Exporte.


# Aktivitäts-Log
Source: https://docs.anny.co/activity-log

Alle Änderungen, E-Mails, internen Notizen und Aufgaben zu Buchungen, Bestellungen und Kunden in einer Zeitleiste.

Das Aktivitäts-Log zeigt dir die gesamte Historie eines Datensatzes in einer Zeitleiste: Änderungen, versendete und empfangene E-Mails, interne Notizen, Aufgaben deines Teams und Ereignisse wie Kalendersynchronisationen. Du kannst direkt im Log Notizen schreiben, Aufgaben an Kolleg:innen verteilen und deinen Kund:innen per E-Mail antworten.

<Warning>
  Beta-Phase Admin 3.0 (Stand: 5. Oktober). Anpassungen sind möglich.
</Warning>

## Wo finde ich das Aktivitäts-Log?

Im Admin-Bereich heißt das Log **Aktivität**. Du findest es an diesen Stellen:

| Ort | Was du im Log tun kannst |
| :- | :- |
| Buchungsdetails, Bestelldetails und Kundendetails | Notizen schreiben und E-Mails an Kund:innen senden |
| Buchungsdetails im Kalender und in den Tabellen **Buchungen** und **Bestellungen** | Notizen schreiben und E-Mails an Kund:innen senden |
| Blocker | Notizen schreiben |
| Ressourcen, Services, Pläne und Buchungspakete | Über die Aktion **Aktivität** öffnest du das Log seitlich und kannst Notizen schreiben |
| Weitere Einstellungen wie Produkte, verfügbare Termine oder Formulare | Über die Aktion **Aktivität** siehst du die Änderungen, ohne Notizen schreiben zu können |

Ganz oben steht der älteste geladene Eintrag, ganz unten der neueste. Wenn du nach oben scrollst, lädt anny ältere Einträge nach. Kommen neue Ereignisse hinzu, während du weiter oben liest, zeigt dir das Glocken-Icon oben rechts einen Hinweis wie **2 neue Ereignisse anzeigen**.

## Einträge filtern und durchsuchen

Klicke oben rechts auf das Filter-Icon (**Filtern**). Darunter erscheinen fünf Filter:

| Filter | Was du dort siehst |
| :- | :- |
| **Alles** | Alle Einträge in einer Zeitleiste |
| **Notizen** | Interne Notizen deines Teams, inklusive Aufgaben, Antworten und Reaktionen |
| **Kommunikation** | E-Mails an und von Kund:innen, automatische E-Mails von anny, SMS und WhatsApp-Nachrichten sowie Anrufe und Chats des KI-Assistenten |
| **Änderungen** | Wer wann was am Datensatz geändert hat, zum Beispiel Buchung erstellt, akzeptiert, verschoben oder storniert. Hier erscheinen auch Änderungen durch den KI-Agenten. |
| **System** | Ereignisse ohne handelnde Person: Kalendersynchronisationen, Importe aus externen Kalendern und Zugangscodes |

<Frame>
  <img alt="Aktivitäts-Log mit geöffneten Filtern Alles, Notizen, Kommunikation, Änderungen und System" />
</Frame>

Mit dem Lupen-Icon (**Aktivität durchsuchen**) suchst du nach Text in den Einträgen, zum Beispiel nach einem Betreff oder einem Namen. Suche und Filter lassen sich kombinieren.

<Tip>
  Hat ein Tag mehr als drei Änderungen oder Systemereignisse, fasst anny sie unter **Alles** zusammen. Klicke auf **Mehr anzeigen**, um alle Einträge des Tages zu sehen. Wählst du einen Filter oder suchst du, siehst du alle Einträge sofort.
</Tip>

Einträge mit Details, zum Beispiel eine Änderung oder eine E-Mail, klappst du über den Pfeil links auf.

## Interne Kommunikation: Notizen und Aufgaben

Notizen sind nur für dein Team sichtbar. Kund:innen sehen sie weder auf der Buchungsseite noch per E-Mail. Im Log erkennst du sie an **Notiz · intern**.

### Notiz schreiben

<Steps>
  <Step title="Notiz auswählen">
    Wähle im Eingabefeld unten im Log **Notiz**.

    Das Feld zeigt **Notiz schreiben…** und den Hinweis **Intern**.
  </Step>

  <Step title="Text eingeben">
    Schreibe deine Notiz. Mit `@` erwähnst du eine Kollegin oder einen Kollegen.

    Die erwähnte Person wird benachrichtigt.
  </Step>

  <Step title="Notiz speichern">
    Klicke auf **Notiz schreiben** oder drücke `⌘` + `↩` (Windows: `Strg` + `Enter`).

    Die Notiz erscheint ganz unten im Log.
  </Step>
</Steps>

Unter jeder Notiz kannst du mit **Antworten** einen Verlauf starten und mit **Reaktion hinzufügen** ein Emoji vergeben. Eigene Notizen kannst du über die drei Punkte wieder löschen.

### Aufgaben zuweisen

Eine Notiz wird zur Aufgabe, sobald du eine Person zuweist oder ein Fälligkeitsdatum setzt. So verteilst du To-dos direkt an der Buchung, Bestellung oder am Kunden.

<Steps>
  <Step title="Notiz schreiben">
    Schreibe im Modus **Notiz**, was zu tun ist.

    Unter dem Text siehst du **Zuweisen** und **Fällig**.
  </Step>

  <Step title="Person zuweisen">
    Klicke auf **Zuweisen** und wähle eine Person aus deinem Team.

    Der Name erscheint statt **Zuweisen** im Eingabefeld.
  </Step>

  <Step title="Fälligkeit setzen">
    Klicke auf **Fällig** und wähle ein Datum. Dieser Schritt ist optional.

    Das Datum erscheint statt **Fällig** im Eingabefeld.
  </Step>

  <Step title="Aufgabe speichern">
    Klicke auf **Notiz schreiben**.

    Die Aufgabe erscheint im Log mit **Als erledigt markieren**, dem Fälligkeitsdatum und **Zugewiesen an**.
  </Step>
</Steps>

<Frame>
  <img alt="Aktivitäts-Log mit Filter Notizen, einer offenen Aufgabe und einer neuen Notiz, die Anna Berger zugewiesen wird" />
</Frame>

Aufgaben durchlaufen diese Zustände:

| Anzeige | Bedeutung |
| :- | :- |
| **Als erledigt markieren** mit **Fällig** und Datum | Die Aufgabe ist offen |
| **Überfällig seit** und Datum | Das Fälligkeitsdatum ist überschritten |
| **Erledigt** und Datum | Jemand hat die Aufgabe abgehakt. Mit **Wieder öffnen** machst du sie wieder offen. |

Zuweisung und Fälligkeit änderst du auch nachträglich über die Icons oben rechts an der Notiz. Über **Zuweisung entfernen** und **Fälligkeit entfernen** nimmst du beides wieder heraus.

### Benachrichtigungen

anny informiert dich im Admin-Bereich und per E-Mail, wenn:

* dir jemand eine Aufgabe zuweist. Die E-Mail enthält das Fälligkeitsdatum und den Button **Aufgabe öffnen**.
* dich jemand in einer Notiz erwähnt.
* jemand auf deine Notiz oder auf eine dir zugewiesene Aufgabe antwortet.
* eine Kundin oder ein Kunde per E-Mail antwortet.

Welche dieser Benachrichtigungen du erhältst, legst du in der Gruppe **Aktivität** deiner [Benachrichtigungseinstellungen](/admin-notifications) fest: **Mir zugewiesene Aufgaben**, **Notizen** und **Kundennachrichten**. Erwähnungen erhältst du immer.

## Externe Kommunikation: E-Mails an Kund:innen

Aus dem Log einer Buchung, Bestellung oder eines Kunden schreibst du der Kundin oder dem Kunden direkt eine E-Mail. Die E-Mail und alle Antworten bleiben im Log, sodass dein ganzes Team den Verlauf sieht.

<Steps>
  <Step title="E-Mail auswählen">
    Wähle im Eingabefeld unten im Log **E-Mail**.

    Unter **An** siehst du Name und E-Mail-Adresse der Kundin oder des Kunden.
  </Step>

  <Step title="Betreff und Text eingeben">
    Trage unter **Betreff** ein, worum es geht, und schreibe deine Nachricht.

    Der Button **E-Mail absenden** wird aktiv, sobald Betreff und Text ausgefüllt sind.
  </Step>

  <Step title="E-Mail senden">
    Klicke auf **E-Mail absenden**.

    Die E-Mail erscheint im Log als **E-Mail · ausgehend** und erhält einen Zustellstatus.
  </Step>
</Steps>

<Frame>
  <img alt="Aktivität mit Filter Kommunikation, einer eingehenden Kunden-E-Mail und dem Eingabefeld im Modus E-Mail mit An, Betreff und Nachricht" />
</Frame>

Antwortet die Kundin oder der Kunde, landet die Antwort automatisch im Log als **E-Mail · eingehend**. Mit **Antworten** schreibst du direkt zurück; der Betreff wird übernommen.

<Note>
  Die Option **E-Mail** ist nur aktiv, wenn beim Datensatz eine Kund:in mit E-Mail-Adresse hinterlegt ist. Hast du die Kundin oder ihre E-Mail-Adresse gerade geändert, speichere zuerst. Bei Blockern gibt es nur Notizen.
</Note>

### Automatische E-Mails und Zustellstatus

Unter **Kommunikation** siehst du auch alle E-Mails, die anny automatisch verschickt, zum Beispiel Buchungsbestätigungen, Erinnerungen oder Rechnungen. Klappe eine E-Mail auf, um Betreff, Empfänger:in und den Verlauf des Status zu sehen. Mit **Öffnen** siehst du die E-Mail so, wie sie versendet wurde.

| Status | Bedeutung |
| :- | :- |
| **Gesendet** | anny hat die E-Mail verschickt |
| **Zugestellt** | Der Mailserver der Empfänger:in hat die E-Mail angenommen |
| **Geöffnet** | Die Empfänger:in hat die E-Mail geöffnet |
| **Geklickt** | Die Empfänger:in hat einen Link in der E-Mail angeklickt |
| **Unzustellbar** | Die E-Mail-Adresse existiert nicht |
| **Blockiert** | Der Mailserver der Empfänger:in hat die E-Mail abgelehnt |
| **Postfach voll** | Das Postfach der Empfänger:in ist voll |

<Tip>
  Zeigt der Status **Zugestellt**, aber die Kundin findet die E-Mail nicht: Die Nachricht liegt möglicherweise im Spam-Ordner oder in einem Ordner wie „Sonstige“.
</Tip>

### Weitere Nachrichten

Außerdem erscheinen unter **Kommunikation**:

* SMS und WhatsApp-Nachrichten, zum Beispiel mit einem Zugangscode, mit ihrem Zustellstatus
* Anrufe und Chats des anny KI-Assistenten mit Kund:innen. Aufgeklappt siehst du die **KI-Zusammenfassung** und kannst bei Anrufen die **Aufnahme abspielen**.

## Änderungen und Änderungen durch den KI-Agenten

Unter **Änderungen** siehst du, wer den Datensatz wann geändert hat. Aufgeklappt zeigt jede Änderung den alten und den neuen Wert.

Nimmt der anny KI-Agent eine Änderung vor, trägt der Eintrag das Label **via KI-Agent**. So erkennst du auf einen Blick, welche Änderungen nicht von einer Person aus deinem Team stammen. Aufgeklappt siehst du, was der Agent geändert hat, und gegebenenfalls seine Begründung.

<Frame>
  <img alt="Aktivitäts-Log mit Filter Änderungen und aufgeklappter Buchungsänderung via KI-Agent mit Begründung sowie alter und neuer Uhrzeit" />
</Frame>

<Note>
  Das Label **via KI-Agent** gibt es nicht nur bei Änderungen. Schreibt der KI-Agent eine Notiz oder eine E-Mail, erscheint sie mit demselben Label unter **Notizen** beziehungsweise **Kommunikation**.
</Note>

## System

Unter **System** stehen Ereignisse, die anny automatisch protokolliert. Als Absender siehst du dort **System**.

| Eintrag | Beispiel |
| :- | :- |
| Kalendersynchronisation | **Mit Google Calendar synchronisiert**, **Synchronisierung mit Outlook Calendar fehlgeschlagen** |
| Import aus einem externen Kalender | **Aus Outlook Calendar importiert** |
| Zugangscodes und Schlösser | **Türcode ausgestellt**, **Zugangslink geplant**, **Türcode fehlgeschlagen** |

<Frame>
  <img alt="Aktivitäts-Log mit Filter System, Einträgen zu Türcodes, Zugangslinks und Kalendersynchronisationen" />
</Frame>

Fehlgeschlagene Einträge sind rot markiert. Aufgeklappt siehst du Details wie den Kalender, das Schloss oder die Fehlermeldung.

## Wann nutze ich das?

* **Du möchtest wissen, ob eine Buchungsbestätigung angekommen ist**: Unter **Kommunikation** siehst du den Zustellstatus jeder E-Mail.
* **Eine Kollegin soll sich um eine Buchung kümmern**: Schreibe eine Notiz, weise sie ihr zu und setze eine Fälligkeit.
* **Eine Kundin hat eine Rückfrage**: Antworte ihr per E-Mail direkt aus dem Log, damit dein Team den Verlauf sieht.
* **Du willst nachvollziehen, wer eine Buchung verschoben hat**: Unter **Änderungen** siehst du, ob es eine Person aus deinem Team oder der KI-Agent war.
* **Eine Buchung fehlt in deinem externen Kalender**: Unter **System** siehst du, ob die Synchronisation fehlgeschlagen ist.

## FAQ

<AccordionGroup>
  <Accordion title="Können Kund:innen die internen Notizen sehen?">
    Nein. Notizen und Aufgaben sind ausschließlich im Admin-Bereich sichtbar und werden weder per E-Mail noch auf der Buchungsseite angezeigt. Nur Nachrichten, die du im Modus **E-Mail** schreibst, erreichen die Kundin oder den Kunden.
  </Accordion>

  <Accordion title="Wo landen die Antworten meiner Kund:innen?">
    Antwortet eine Kundin auf eine E-Mail, die du aus dem Log gesendet hast, erscheint die Antwort im Log desselben Datensatzes als **E-Mail · eingehend**. Wenn du die Benachrichtigung **Kundennachrichten** aktiviert hast, informiert dich anny zusätzlich.
  </Accordion>

  <Accordion title="Warum kann ich keine E-Mail schreiben?">
    Die Option **E-Mail** ist deaktiviert, wenn beim Datensatz keine Kund:in mit E-Mail-Adresse hinterlegt ist. Hast du die Kundin gerade geändert, speichere zuerst. Bei Blockern und in den Einstellungen gibt es nur Notizen.
  </Accordion>

  <Accordion title="Warum wird keine E-Mail im Aktivitäts-Log angezeigt, obwohl ein Kunde zugeordnet ist?">
    Prüfe, ob beim Abschließen der Bestellung **Bestätigung per E-Mail senden** deaktiviert war. Außerdem können Kund:innen E-Mail-Benachrichtigungen in ihrem Profil deaktivieren. Die Bestätigung kannst du in den Bestelldetails über **Buchungsbestätigung erneut senden** nachträglich verschicken.
  </Accordion>

  <Accordion title="Wie erkenne ich Änderungen durch den KI-Agenten?">
    Einträge, die der anny KI-Agent ausgelöst hat, tragen das Label **via KI-Agent**. Änderungen findest du unter **Änderungen**, Notizen des Agenten unter **Notizen** und E-Mails unter **Kommunikation**.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="E-Mail-Status bleibt auf „Zugestellt“, obwohl die Empfänger:in die Mail gelesen hat">
    Das Öffnen wird über ein unsichtbares Bild in der E-Mail erkannt. Manche E-Mail-Programme laden externe Inhalte nicht automatisch. Dann bleibt der Status auf **Zugestellt**, auch wenn die E-Mail gelesen wurde.
  </Accordion>

  <Accordion title="E-Mail mit Status „Blockiert“ oder „Unzustellbar“">
    Bei **Unzustellbar** existiert die E-Mail-Adresse nicht. Prüfe die Adresse beim Kunden und korrigiere sie. Bei **Blockiert** hat der Mailserver der Empfänger:in die E-Mail abgelehnt, zum Beispiel weil die Kundin E-Mails von anny als Spam markiert oder den Empfang abgelehnt hat. Bitte die Kundin, die Absenderadresse freizugeben, und wende dich an den anny Support, damit die Adresse wieder freigeschaltet wird.
  </Accordion>

  <Accordion title="Kein Eintrag nach einer Änderung über eine Integration">
    Änderungen und Synchronisationen über eine Integration können mit leichter Verzögerung erscheinen. Wenn am Glocken-Icon ein Hinweis wie **2 neue Ereignisse anzeigen** erscheint, klicke darauf. Andernfalls lade die Seite neu.
  </Accordion>

  <Accordion title="Ich erhalte keine Benachrichtigung zu zugewiesenen Aufgaben">
    Prüfe in deinen [Benachrichtigungseinstellungen](/admin-notifications) in der Gruppe **Aktivität**, ob **Mir zugewiesene Aufgaben** aktiviert ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Name im Admin: **Aktivität** (Titel des Logs und der Aktion mit Uhr-Icon). Das Log ersetzt den früheren „E-Mail Tracker“ und das „Aktivitätsprotokoll“.
> * Mit Notiz + E-Mail: Buchungs-, Bestell- und Kundendetails, Buchungsdetails im Kalender, Tabellen Buchungen und Bestellungen. Blocker: nur Notiz. Ressourcen, Services, Pläne, Buchungspakete: Aktion **Aktivität** öffnet das Log seitlich mit Notizen. Produkte, verfügbare Termine, Terminplan-Gruppen, Karten, Formulare/Felder: Aktion **Aktivität** nur lesend.
> * Reihenfolge: neueste Einträge unten, ältere laden beim Hochscrollen. Glocke „n neue Ereignisse anzeigen“ für neue Einträge.
> * Filter (Icon **Filtern**): **Alles**, **Notizen** (Kommentare/Aufgaben), **Kommunikation** (gesendete/empfangene E-Mails, SMS/WhatsApp, KI-Anrufe/Chats), **Änderungen** (Aktivitäten am Datensatz), **System** (Kalender-Sync, Import aus externem Kalender, Zugangscodes; alles andere ohne Kategorie). Suche: **Aktivität durchsuchen**.
> * KI-Änderungen: Label **via KI-Agent**, erscheinen unter **Änderungen** (bzw. Notizen/Kommunikation bei Notizen/E-Mails des Agenten), NICHT unter System. Es gibt keinen eigenen KI-Filter.
> * Faltung: > 3 Änderungen/Systemereignisse pro Tag werden unter **Alles** ohne Suche hinter **Mehr anzeigen** zusammengefasst.
> * Notiz: Modus **Notiz**, Platzhalter „Notiz schreiben…“, Tag **Intern**, `@` erwähnt Kolleg:innen, Button **Notiz schreiben**, ⌘↩. Antworten, Reaktionen, eigene Notizen löschen.
> * Aufgabe = Notiz mit **Zuweisen** und/oder **Fällig**. Zustände: **Als erledigt markieren**, „Überfällig seit \[Datum]“, „Erledigt \[Datum]“, **Wieder öffnen**. Zuweisung/Fälligkeit nachträglich änderbar, **Zuweisung entfernen**, **Fälligkeit entfernen**.
> * Benachrichtigungen (In-App + E-Mail): Aufgabe zugewiesen (Button **Aufgabe öffnen**), erwähnt, Antwort auf eigene Notiz oder zugewiesene Aufgabe, Kundenantwort. Einstellungen Gruppe **Aktivität**: **Mir zugewiesene Aufgaben**, **Notizen** (Erwähnungen immer), **Kundennachrichten**.
> * E-Mail an Kund:in: Modus **E-Mail**, **An** (Kund:in), **Betreff** (Pflicht), Text, **E-Mail absenden**. Deaktiviert ohne Kunden-E-Mail („Keine E-Mail-Adresse des Kunden hinterlegt“) oder bei ungespeicherter Kundenänderung. Antworten der Kund:innen kommen über die Antwortadresse des Datensatzes als „E-Mail · eingehend“ ins Log; **Antworten** übernimmt den Betreff mit „Re:“.
> * E-Mail-Status: Gesendet → Zugestellt → Geöffnet → Geklickt. Negativ (rot): **Unzustellbar** (Adresse existiert nicht), **Blockiert** (Empfängerserver lehnt ab, z. B. Spam/Suppression List), **Postfach voll**. **Öffnen** zeigt die versendete E-Mail.
> * Bestätigung nachträglich senden: Bestelldetails → **Buchungsbestätigung erneut senden**. Beim Abschließen einer Bestellung steuert **Bestätigung per E-Mail senden** den Versand; die frühere Glocke gibt es nicht mehr.


# Produkte & Zusatzoptionen
Source: https://docs.anny.co/add-ons

Biete Produkte wie Getränke oder Equipment sowie zusätzliche und empfohlene Ressourcen direkt im Buchungsprozess an.

Mit Zusatzoptionen erweiterst du die Buchung eines Services um drei Dinge: **Produkte** (Extras wie Getränke, Handtücher oder Equipment), **Zusätzliche Ressourcen** (werden als Sub-Buchung im selben Zeitraum mitgebucht) und **Empfohlene Ressourcen** (werden beim Checkout als eigene Buchung vorgeschlagen). Produkte legst du zentral unter **Produkte** an. Welche Zusatzoptionen ein Service anbietet, legst du im Tab **Zusatzoptionen** des Services fest.

<Info>
  Den Tab **Zusatzoptionen** siehst du erst, wenn das Feature aktiv ist. Öffne dafür in der Seitenleiste **Apps & Integrationen**, wähle die Kategorie **anny Apps** und öffne **Service Zusatzoptionen**. Schalte dort **Für deine Organisation aktivieren** ein.
</Info>

## Wie funktionieren Zusatzoptionen?

### Produkte

Produkte sind Extras, die Kund:innen während der Buchung zu einem Service hinzufügen. Die Verfügbarkeit ist unbeschränkt, abgerechnet wird nach gewählter Anzahl und hinterlegtem Preis.

Alle Produkte deiner Organisation findest du in der Seitenleiste unter **Produkte**. Die Tabelle zeigt pro Produkt die Gruppe, den Preis, die Preisart und ob es hervorgehoben ist oder von Dritten angeboten wird. Über die Filter **Gruppe**, **Hervorgehoben** und **Drittanbieter** grenzt du die Liste ein.

<Frame>
  <img alt="Seite Produkte: Tabelle mit sieben Produkten wie Handtuchverleih, Yogamatte und Protein-Shake, jeweils mit Gruppe, Preis, Preisart und den Spalten Hervorgehoben und Drittanbieter" />
</Frame>

Der Ablauf:

1. Du legst ein Produkt mit Name, Preis und Regeln an.
2. Du ordnest es einem oder mehreren Services zu.
3. Kund:innen sehen das Produkt bei der Buchung dieser Services und können es hinzufügen.
4. Die Abrechnung erfolgt automatisch anhand von Anzahl und Preis.

#### Preisarten

| Preisart | Beschreibung |
| - | - |
| Preis pro Einheit | Festpreis pro Stück, z. B. 3 € pro Yogamatte. |
| Preis pro Intervall | Preis pro Zeiteinheit der Buchung. Unter **Abrechnung pro** legst du das Intervall fest, z. B. 1 Stunde. Abgerechnet wird jedes angefangene Intervall. |
| Relativer Preis | Prozentsatz der Zwischensumme der Buchung. Alle Produkte ohne relativen Preis zählen zur Zwischensumme, Sub-Buchungen nicht. Beispiel: 20 % bei 20 € Zwischensumme ergeben 4 €. |

Mit **Staffelpreis hinzufügen** legst du einen günstigeren Preis ab einer bestimmten Anzahl fest. Ab dieser Anzahl gilt der Staffelpreis für die gesamte Menge. Beispiel: Eine Yogamatte kostet 3 €, ab 5 Stück 2,50 € pro Stück. Wer 6 Matten bucht, zahlt 15 €.

Mit **Preis ausblenden** zeigst du Kund:innen keinen Preis an, z. B. wenn der finale Preis erst nach der Buchung feststeht.

#### Produktgruppen

Produkte lassen sich in Gruppen ordnen, z. B. "Getränke" oder "Equipment". Gruppen sind optional. Eine neue Gruppe legst du direkt im Feld **Gruppe** eines Produkts an, indem du einen neuen Namen eintippst. Alle Gruppen verwaltest du in den **Einstellungen** im Reiter **Gruppen** unter **Produktgruppen**.

### Zusätzliche Ressourcen

Zusätzliche Ressourcen werden zusammen mit dem Service gebucht. Kund:innen wählen sie nach dem Datum aus. Die Ressource wird als Sub-Buchung an die Hauptbuchung gehängt und übernimmt immer deren Zeitraum (**Gleicher Zeitraum**). Ändert sich die Hauptbuchung, passt sich die Sub-Buchung an.

### Empfohlene Ressourcen

Empfohlene Ressourcen werden beim Checkout als separate Buchungen angeboten. Pro Empfehlung wählst du den **Vorausgewählten Service** und den **Zeitraum** relativ zur Buchung des Services. Kund:innen legen die Empfehlung als eigene Buchung in den Warenkorb.

| Zeitraum | Beschreibung |
| - | - |
| Innerhalb des Zeitraums | Die empfohlene Buchung liegt im Zeitfenster der Hauptbuchung. |
| Nach Buchungsende | Die empfohlene Buchung beginnt nach dem Ende der Hauptbuchung. |
| Vor Buchungsbeginn | Die empfohlene Buchung endet vor dem Beginn der Hauptbuchung. |
| Übernachtungen | Die empfohlene Buchung wird als Übernachtung gebucht. |

## Wann nutze ich das?

* **Du bietest Extras zu einer Buchung an** (z. B. Getränke, Leihmaterial, eine Bewirtungspauschale): Nutze **Produkte**.
* **Du willst eine weitere Ressource fest an die Buchung koppeln** (z. B. einen zweiten Raum im selben Zeitraum): Nutze **Zusätzliche Ressourcen**.
* **Du willst ergänzende Angebote vorschlagen, die als eigene Buchung funktionieren** (z. B. einen Parkplatz oder einen Raum nach dem Kurs): Nutze **Empfohlene Ressourcen**.
* **Nicht geeignet für**: Abhängige Ressourcen, die unsichtbar im Hintergrund blockiert werden sollen (z. B. ein Raum, der automatisch mitgebucht wird). Dafür nutzt du [Smart Availability](/smart-availability).

## Zusammenhang mit anderen Features

* [**Smart Availability**](/smart-availability): Smart Availability blockiert Ressourcen im Hintergrund. Zusatzoptionen sind für Kund:innen sichtbar und wählbar.
* [**Änderung von Buchungen**](/modify-bookings): Ist im Tab **Änderung & Stornierung** des Services **Nachträgliche Bearbeitung von Serviceoptionen erlauben** aktiv, können Kund:innen ihre Produkte nach der Buchung selbst anpassen.
* [**Dynamisches Pricing**](/dynamic-pricing): Produktpreise sind unabhängig von den dynamischen Preismodifikatoren des Services.
* [**Wiederkehrende Buchungen**](/recurring-bookings): Produkte werden bei Serien pro Termin übernommen und können pro Termin angepasst werden.

## Produkt anlegen

<Steps>
  <Step title="Produkte öffnen">
    Öffne in der Seitenleiste **Produkte** und klicke auf **Neu**. Es öffnet sich ein Fenster zum Anlegen.
  </Step>

  <Step title="Name und Gruppe festlegen">
    Gib einen **Name** ein, wähle optional eine **Gruppe** und klicke auf **Speichern**. Die Detailseite des neuen Produkts öffnet sich.
  </Step>

  <Step title="Allgemeine Informationen ergänzen">
    Lade bei Bedarf ein **Titelbild** hoch und ergänze **Untertitel** und **Beschreibung**. Diese Texte sehen Kund:innen bei der Auswahl.
  </Step>

  <Step title="Preis festlegen">
    Wähle unter **Preisgestaltung** die Preisart, gib den Preis ein und prüfe die **UST. Rate**. Füge bei Bedarf Staffelpreise hinzu. Der Preis erscheint nun oben unter dem Produktnamen.
  </Step>

  <Step title="Mengen und Regeln festlegen">
    Öffne **Mengen & Vorauswahl** sowie **Buchung & Abrechnung** und passe die Einstellungen an. Änderungen speicherst du mit **Speichern** oben rechts.
  </Step>

  <Step title="Services zuordnen">
    Wechsle zum Abschnitt **Services** und wähle rechts unter **Alle Services** die Services aus, bei denen das Produkt angeboten wird. Die Services erscheinen links in der Liste.
  </Step>
</Steps>

<Frame>
  <img alt="Detailseite eines Produkts, Abschnitt Preisgestaltung: Preis pro Einheit 3 Euro, UST. Rate 19 %, zwei Staffelpreise ab 5 und ab 10 Stück, darunter die Bereiche Mengen & Vorauswahl und Buchung & Abrechnung" />
</Frame>

## Zusatzoptionen eines Services einrichten

<Steps>
  <Step title="Service öffnen">
    Öffne in der Seitenleiste **Services**, wähle den Service aus und wechsle zum Tab **Zusatzoptionen**. Du siehst die Abschnitte **Produkte**, **Zusätzliche Ressourcen** und **Empfohlene Ressourcen**.
  </Step>

  <Step title="Produkte zuordnen">
    Klicke im Abschnitt **Produkte** rechts unter **Alle Produkte** auf das Plus-Icon neben einem Produkt oder ziehe es nach links. Mit **Neu** legst du direkt hier ein neues Produkt an. Das Produkt steht nun links in der Liste des Services.
  </Step>

  <Step title="Reihenfolge festlegen">
    Ziehe die Produkte links am Griff in die gewünschte Reihenfolge. In dieser Reihenfolge sehen Kund:innen sie bei der Buchung.
  </Step>

  <Step title="Ressourcen hinzufügen">
    Füge in den Abschnitten **Zusätzliche Ressourcen** und **Empfohlene Ressourcen** auf dieselbe Weise Ressourcen aus **Alle Ressourcen** hinzu. Bei empfohlenen Ressourcen wählst du anschließend **Vorausgewählter Service** und **Zeitraum**.
  </Step>

  <Step title="Speichern">
    Klicke oben rechts auf **Speichern**. Die Zusatzoptionen erscheinen ab sofort bei der Buchung dieses Services.
  </Step>
</Steps>

<Frame>
  <img alt="Service Barre class, Tab Zusatzoptionen: links vier zugeordnete Produkte mit Preis, rechts Alle Produkte mit weiteren Produkten und der Schaltfläche Neu" />
</Frame>

<Tip>
  Die Zuordnung funktioniert in beide Richtungen: Am Produkt wählst du die Services, am Service die Produkte. Die Reihenfolge der Produkte legst du immer am jeweiligen Service fest.
</Tip>

## Einstellungen & Optionen

### Produkt: Allgemeine Informationen

| Einstellung | Beschreibung |
| - | - |
| Titelbild | Optionales Bild im Format 16:9 (PNG, JPG). |
| Name | Bezeichnung des Produkts. Pflichtfeld, übersetzbar. |
| Untertitel | Kurzer Hinweis unter dem Namen, z. B. "Nach jedem Kurs gereinigt". |
| Gruppe | Optionale Produktgruppe. Tippe einen neuen Namen ein, um eine Gruppe anzulegen. |
| Beschreibung | Ausführliche Beschreibung mit Formatierung. |

### Produkt: Preisgestaltung

| Einstellung | Beschreibung |
| - | - |
| Preisart | **Preis pro Einheit**, **Preis pro Intervall** oder **Relativer Preis**. |
| Preis | Betrag mit Währung und Brutto oder Netto. Beim relativen Preis ein Prozentsatz. |
| UST. Rate | Umsatzsteuersatz, Standard 19 %. |
| Abrechnung pro | Nur bei **Preis pro Intervall**: das Intervall, pro angefangenem Intervall wird abgerechnet. |
| Preis ausblenden | Kund:innen sehen keinen Preis. |
| Staffelpreis | **Ab Anzahl** plus Preis. Ab dieser Anzahl gilt der Staffelpreis für die gesamte Menge. |

### Produkt: Mengen & Vorauswahl

| Einstellung | Beschreibung |
| - | - |
| Min. Anzahl | Mindestmenge, sobald das Produkt gewählt ist. Standard: 0. |
| Max. Anzahl | Höchstmenge pro Buchung. Leer bedeutet uneingeschränkt. |
| Immer anwenden | Erscheint, sobald **Min. Anzahl** größer als 0 ist. Standard: an. Wenn aktiv, wird das Produkt mit der Mindestanzahl vorausgewählt und kann nicht abgewählt werden. Wenn inaktiv, bleibt das Produkt optional und die Mindestanzahl gilt erst nach der Auswahl. Bei aktivem **Immer anwenden** entfällt die Vorlaufzeit. |

### Produkt: Buchung & Abrechnung

| Einstellung | Beschreibung |
| - | - |
| Für die Bereitstellung dieses Produkts erforderliche Vorlaufzeit | Mindestabstand zwischen Buchung und Beginn. Bei kurzfristigeren Buchungen wird das Produkt nicht angeboten. |
| Hervorgehoben | Das Produkt erscheint prominent unter der Auswahl von Datum und Uhrzeit. |
| Vollständige Rückerstattung bei Stornierung | Bei einer Stornierung wird der Produktbetrag immer voll erstattet, unabhängig von den Stornierungsbedingungen des Services. |
| Dieses Produkt wird von Dritten angeboten und in Rechnung gestellt | Das Produkt wird von Dritten abgerechnet und zählt nicht gegen das Prepaid-Guthaben der Buchung. |

### Zusätzliche Ressourcen

| Einstellung | Beschreibung |
| - | - |
| Ressource | Die Ressource, die im **Gleichen Zeitraum** mitgebucht wird. |

### Empfohlene Ressourcen

| Einstellung | Beschreibung |
| - | - |
| Ressource | Die empfohlene Ressource. |
| Vorausgewählter Service | Der Service, mit dem die Empfehlung gebucht wird. |
| Zeitraum | **Innerhalb des Zeitraums**, **Nach Buchungsende**, **Vor Buchungsbeginn** oder **Übernachtungen**. |

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Fitnessstudio mit Leihmatten und Getränken (Produkte)">
    Ein Studio möchte bei Kursbuchungen Yogamatten und Getränke anbieten.

    <Steps>
      <Step title="Produkte anlegen">
        Öffne **Produkte**, klicke auf **Neu** und lege "Yogamatte" mit der Gruppe "Equipment" an. Setze unter **Preisgestaltung** einen **Preis pro Einheit** von 3 € und füge einen Staffelpreis ab 5 Stück hinzu. Lege auf dieselbe Weise "Protein-Shake" mit der Gruppe "Getränke" an.
      </Step>

      <Step title="Dem Kurs zuordnen">
        Öffne unter **Services** den Kurs, wechsle zum Tab **Zusatzoptionen** und füge beide Produkte aus **Alle Produkte** hinzu. Die Produkte stehen nun links in der Liste.
      </Step>

      <Step title="Testen">
        Öffne die Buchungsseite und buche den Kurs. Die Produkte werden im Buchungsprozess angezeigt.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Tagungszentrum mit Zusatzraum (Zusätzliche Ressource)">
    Ein Tagungszentrum bietet einen Besprechungsraum an, der im selben Zeitraum wie der Hauptraum gebucht wird.

    <Steps>
      <Step title="Service öffnen">
        Öffne unter **Services** den Service des Hauptraums und wechsle zum Tab **Zusatzoptionen**.
      </Step>

      <Step title="Zusätzliche Ressource hinzufügen">
        Füge im Abschnitt **Zusätzliche Ressourcen** den Besprechungsraum aus **Alle Ressourcen** hinzu und speichere. Der Raum trägt das Label **Gleicher Zeitraum**.
      </Step>

      <Step title="Testen">
        Erstelle eine Testbuchung. Nach der Datumsauswahl erscheint der Besprechungsraum als Option. Wählst du ihn, entsteht eine Sub-Buchung im Zeitraum der Hauptbuchung.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Coworking Space mit Parkplatz-Empfehlung (Empfohlene Ressource)">
    Ein Coworking Space empfiehlt Parkplätze als separate Buchung für denselben Zeitraum.

    <Steps>
      <Step title="Service öffnen">
        Öffne unter **Services** den Service des Arbeitsplatzes und wechsle zum Tab **Zusatzoptionen**.
      </Step>

      <Step title="Empfohlene Ressource hinzufügen">
        Füge im Abschnitt **Empfohlene Ressourcen** die Parkplatz-Ressource hinzu. Wähle den **Vorausgewählten Service** und setze den **Zeitraum** auf **Innerhalb des Zeitraums**. Speichere die Änderungen.
      </Step>

      <Step title="Testen">
        Erstelle eine Testbuchung. Beim Checkout erscheint der Parkplatz als Empfehlung und lässt sich als separate Buchung in den Warenkorb legen.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Produkten, zusätzlichen und empfohlenen Ressourcen?">
    Produkte sind Extras ohne eigene Buchung (z. B. Getränke). Zusätzliche Ressourcen erzeugen eine Sub-Buchung, die immer den Zeitraum der Hauptbuchung übernimmt. Empfohlene Ressourcen werden beim Checkout vorgeschlagen und als eigene, separate Buchung in den Warenkorb gelegt.
  </Accordion>

  <Accordion title="Sind Produkte dasselbe wie Add-Ons?">
    Ja. Im Admin heißen die früheren Add-Ons jetzt **Produkte**. Du findest sie in der Seitenleiste unter **Produkte** und im Tab **Zusatzoptionen** eines Services im Abschnitt **Produkte**.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Zusatzoptionen und Smart Availability?">
    Zusatzoptionen sind für Kund:innen sichtbar und wählbar. Smart Availability blockiert Ressourcen unsichtbar im Hintergrund (z. B. einen abhängigen Raum).
  </Accordion>

  <Accordion title="Können Kund:innen Produkte nach der Buchung ändern?">
    Ja, wenn im Tab **Änderung & Stornierung** des Services **Nachträgliche Bearbeitung von Serviceoptionen erlauben** aktiv ist.
  </Accordion>

  <Accordion title="Kann ich den Preis eines Produkts ausblenden?">
    Ja. Aktiviere **Preis ausblenden**, wenn der finale Preis erst später feststeht, z. B. bei verbrauchsabhängiger Abrechnung. Kund:innen sehen dann keinen Preis.
  </Accordion>

  <Accordion title="Was bewirkt Immer anwenden?">
    **Immer anwenden** erscheint, sobald **Min. Anzahl** größer als 0 ist, und ist standardmäßig aktiv. Dann wird das Produkt mit der Mindestanzahl vorausgewählt und kann nicht abgewählt werden. Schaltest du es aus, bleibt das Produkt optional: Kund:innen wählen es selbst, und erst danach gilt die Mindestanzahl. Bei Serien gilt dieselbe Regel pro Termin.
  </Accordion>

  <Accordion title="Wie wirkt ein Staffelpreis?">
    Ab der unter **Ab Anzahl** eingetragenen Menge gilt der Staffelpreis für alle Einheiten, nicht nur für die zusätzlichen. Bei mehreren Staffeln greift die höchste erreichte Stufe.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Tab Zusatzoptionen fehlt am Service">
    Das Feature ist nicht aktiv. Aktiviere unter **Apps & Integrationen** in der Kategorie **anny Apps** die App **Service Zusatzoptionen**.
  </Accordion>

  <Accordion title="Das Produkt erscheint nicht im Buchungsprozess">
    Prüfe, ob das Produkt dem richtigen Service zugeordnet ist. Es muss im Tab **Zusatzoptionen** des Services links stehen oder am Produkt im Abschnitt **Services** aufgeführt sein. Produkte, die nur unter **Alle Produkte** stehen, sind noch keinem Service zugeordnet.
  </Accordion>

  <Accordion title="Kund:innen können das Produkt nicht auswählen">
    Die Vorlaufzeit des Produkts ist wahrscheinlich nicht eingehalten. Prüfe unter **Buchung & Abrechnung** die erforderliche Vorlaufzeit: Ist die Buchung zu kurzfristig, wird das Produkt nicht angeboten.
  </Accordion>

  <Accordion title="Die empfohlene Ressource wird beim Checkout nicht angezeigt">
    Prüfe Ressource, **Vorausgewählter Service** und **Zeitraum** der Empfehlung. Stelle sicher, dass die Ressource im gewählten Zeitraum verfügbar ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Admin-UI-Name: **Produkte** (früher Add-Ons; API-Typ `add-ons`, Berechtigung `add-ons`). Seitenleiste **Produkte** im Katalog, sichtbar mit Berechtigung zum Anzeigen von Produkten.
> * Feature aktivieren: **Apps & Integrationen** → Kategorie **anny Apps** → **Service Zusatzoptionen** → **Für deine Organisation aktivieren** (Feature-Key `additional-service-options`). Ohne Feature fehlt der Service-Tab **Zusatzoptionen**.
> * Service-Tab **Zusatzoptionen** hat drei Abschnitte: **Produkte**, **Zusätzliche Ressourcen**, **Empfohlene Ressourcen**.
> * Produkt anlegen: **Produkte** → **Neu** (Name, Gruppe) → Detailseite mit **Allgemeine Informationen** und **Services**. Detailbereiche: **Preisgestaltung**, **Mengen & Vorauswahl**, **Buchung & Abrechnung**.
> * Zuordnung in beide Richtungen: am Produkt (Abschnitt **Services**, rechts **Alle Services**) oder am Service (rechts **Alle Produkte**). Reihenfolge (`order_index` auf `service-add-ons`) nur am Service per Drag & Drop.
> * Preisarten: `unit` (Preis pro Einheit), `interval` (Preis pro Intervall, **Abrechnung pro** = `calculation_interval` + `calculation_unit`, pro angefangenem Intervall), `relative` (Prozent der Zwischensumme ohne relative Produkte und ohne Sub-Buchungen).
> * Staffelpreise (`staggered_pricing`, **Ab Anzahl** = `min_quantity`): höchste erreichte Stufe ersetzt den Stückpreis für die gesamte Menge.
> * **Immer anwenden** (`always_apply`, Default `true`): nur sichtbar bei Min. Anzahl > 0. An = vorausgewählt und nicht abwählbar; Aus = optional, Min. gilt erst nach Auswahl. Vorlaufzeit wird bei aktivem Immer anwenden auf 0 gesetzt.
> * Weitere Felder: **Preis ausblenden** (`is_price_hidden`), **Hervorgehoben** (`featured`), **Vollständige Rückerstattung bei Stornierung** (`full_refund`), Drittanbieter (`is_third_party`, zählt nicht gegen Prepaid-Guthaben), Vorlaufzeit (`lead_time`, Minuten).
> * Produktgruppen: im Feld **Gruppe** per Eintippen anlegen oder unter **Einstellungen** → Reiter **Gruppen** → **Produktgruppen** verwalten.
> * Zusätzliche Ressourcen: `booking_type` `sub_booking`, Label **Gleicher Zeitraum**, Sub-Buchung übernimmt immer den Zeitraum der Hauptbuchung, Auswahl nach dem Datum.
> * Empfohlene Ressourcen: separate Buchung beim Checkout; **Vorausgewählter Service** und **Zeitraum** (innerhalb, nach Buchungsende, vor Buchungsbeginn, Übernachtungen).
> * Nachträgliche Änderung durch Kund:innen: Service-Tab **Änderung & Stornierung** → **Nachträgliche Bearbeitung von Serviceoptionen erlauben**.
> * Zusatzoptionen ≠ Smart Availability: Zusatzoptionen sichtbar und wählbar, Smart Availability blockiert unsichtbar im Hintergrund.
> * Verwandte Artikel: /smart-availability, /configure-booking-option, /modify-bookings, /dynamic-pricing, /recurring-bookings


# Admin 3.0: Was sich ändert
Source: https://docs.anny.co/admin-3-0

Finde Navigation, Kalender und Buchungen im neuen Admin wieder. Die wichtigsten Änderungen im Überblick.

Der neue Admin-Bereich (**Admin 3.0**) ändert Erscheinungsbild und Bedienung. Deine Daten, Rechte, Buchungen und öffentlichen Buchungsseiten bleiben.

| | Öffentliche Beta | Roll-out |
| :- | :- | :- |
| **anny.co** | 5. Oktober | 1. November |
| **anny.eu** | 19. Oktober | 1. Dezember |

Dieser Artikel dient der Orientierung. Du siehst, was sich wo geändert hat. Ausführliche Schritte folgen in eigenen Artikeln, zum Beispiel zum Kalender und zur Buchungsverwaltung.

Drei Stellen merkst du zuerst: die **Navigation**, den **Kalender** und die **Buchungsverwaltung**.

<Warning>
  Die öffentliche Beta-Phase läuft ab dem 5. Oktober. Du kannst zwischen der alten und neuen Version wechseln, bis der neue Admin für alle standardmäßig ausgerollt wird (1. November). Wenn du **Admin 3.0 Beta** im Profilmenü ausschaltest, fragt anny **Zurück zu v2.0?** und nach einem Grund. Bei **Etwas anderes** ist eine Notiz Pflicht. Einschalten geht jederzeit wieder über denselben Schalter.
</Warning>

<iframe title="YouTube video player" />

## Startseite, Suche und anny Assistent

Nach dem Login öffnet sich die **Startseite**. Dort siehst du drei frei wählbare **Dashboard-Widgets** für heute und morgen, **Erste Schritte**, **Neue Funktionen**, Benachrichtigungen und **Meine Aufgaben**.

<Frame>
  <img alt="Startseite im neuen Admin: Begrüßung, Tagesüberblick mit Buchungen, Auslastung und Umsatz, darunter das Eingabefeld für den KI-Agenten und neue Benachrichtigungen" />
</Frame>

Oben in der Leiste liegt die **Suche** (⌘K). Ergebnisse sind nach Bereichen gruppiert und haben eine Vorschau. Die Suche findet auch Notizen, Einstellungsseiten und Hilfe-Artikel in deiner Sprache.

<Frame>
  <video aria-label="Suche mit ⌘K: Ergebnisse nach Bereichen gruppiert, rechts die Vorschau einer Buchung" />
</Frame>

Der Button **Support** öffnet den anny **KI-Agenten** (⌘L). Der Agent kennt die aktuelle Seite, liest Screenshots, Bilder und PDFs und fragt vor jeder Änderung nach **Freigabe**.

<Frame>
  <video aria-label="Der KI-Agent verschiebt auf Zuruf alle Buchungen eines ausgefallenen Raums und zeigt die Änderungen" />
</Frame>

<Tip>
  Der **KI-Agent** im Admin ist nicht derselbe Assistent wie die Telefon- und Chat-KI für deine Kund:innen. Die richtest du unter [anny AI einrichten](/anny-ai-setup) ein. Hier erfährst du alles zur **Suche** und zum **KI-Agenten**.
</Tip>

## Navigation

Links bleibt die Seitenleiste. Die Ziele kennst du, Gruppierung und Reihenfolge sind neu. Selten genutzte Punkte legst du über **Aus Seitenleiste ausblenden** nach **Ausgeblendet**. Zurück holst du sie mit **In Seitenleiste anzeigen**.

| Gruppe | Typische Einträge |
| :- | :- |
| **Übersicht** | **Home**, **Dashboard** |
| **Buchungen** | **Kalender**, **Buchungen**, **Blocker**, **Verfügbarkeit** |
| **Management** | **Anfragen**, **Bestellungen**, **Abos**, **Rechnungen**, **Codes** |
| **CRM** | **Kunden**, **Unternehmen**, **Communities** |
| **Katalog** | **Ressourcen**, **Services**, **Abo-Pläne**, **Buchungspakete**, **Produkte** |
| **Check-In** | **Check-In**, **Schnellaufruf**, **Warteschlangen** |
| **Account** | **Einstellungen**, **Admin-Nutzer**, **Apps & Integrationen** |
| **Hardware** | **Displays** |

Neu im Menü sind unter anderem **Anfragen**, **Anfrageformulare**, **Unternehmen**, **Produkte**, **Blocker**, **Zeitfenster**, **Wochenpläne** und **Warteschlangen**.

**Karten** und **Export-Zeitpläne** liegen unter **Account › Einstellungen**. Exporte startest du aus der jeweiligen Tabelle.

<Tip>
  Taste **N** legt in Listen einen neuen Eintrag an, **B** eine neue Buchung, **Strg+B** einen neuen Blocker.
</Tip>

## Kalender

Der Kalender hat mehr Fläche. Die Ressourcenauswahl sitzt im **Filter** als Seitenpanel neben dem Kalender, nicht mehr in einer Leiste links. Der Filter bleibt offen. Gespeicherte Ansichten gelten für Kalender und Ressourcenliste und lassen sich umbenennen, teilen, duplizieren und sortieren.

<Frame>
  <img alt="Tagesansicht im Kalender mit geöffnetem Filter-Panel rechts: Tabs für Ansichten, Filter nach Kategorien, Gruppe und Services, Liste der Ressourcen" />
</Frame>

Alle Ansichten liegen in einer Leiste: Tag, Woche, Monat, Timeline, Board, Bestellungen und Karte. Du ziehst einen Zeitraum auf und legst direkt eine **Buchung**, einen **Blocker** oder einen verfügbaren Termin an. Einzelne Buchungen und Blocker verschiebst du per Drag-and-Drop. Verschieben per Ziehen fragt nach, inkl. der Option, den Kunden zu benachrichtigen. Ganze Bestellungen lassen sich im Kalender nicht verschieben.

<Frame>
  <video aria-label="Im Kalender wird ein Zeitraum markiert, im Dialog Neue Bestellung werden Buchung und Produkte ergänzt und ein Kunde gewählt" />
</Frame>

Auf der Buchungsdetailseite stehen Übersicht, Buchungsdaten, Teilnehmende, Anwesenheit und Herkunft. Statt des Mini-Kalenders liegen rechts **Aktivität** und Kommentare. Zum zeitlichen Einordnen oder Verschieben gehst du in den Hauptkalender. **Tags** kennzeichnen Buchungen, Bestellungen, Kund:innen, Ressourcen und Services. Im Feed schreibst du interne Notizen, weist Aufgaben zu und sendest E-Mails. Blocker haben eine eigene Seite unter **Buchungen › Blocker**. Auch globale Blocker und Feiertage liegen dort.

| Vorher | Jetzt |
| :- | :- |
| Ressourcenleiste links am Kalender | Ressourcen und Kategorien wählst du über **Filter** über dem Kalender |
| Bestellungen nur in der Bestellliste | Bestellungen siehst du im Kalender, zum Beispiel in **Woche (Bestellungen)** und **Tag (Bestellungen)** |
| Termine per Drag-and-Drop verschieben | Einzelne Buchungen und Blocker verschiebst du weiterhin per Drag-and-Drop, mit Rückfrage und optionaler Benachrichtigung. Ganze Bestellungen lassen sich im Kalender nicht verschieben. Du fügst der Bestellung weitere Buchungen hinzu. |
| Mini-Kalender auf der Buchungsseite | Verschieben und Anlegen passieren im Hauptkalender. Die Buchung selbst zeigt Aktivität und Kommentare. |

Den detaillierten Buchungsflow (Ressource oder **Beliebig**, **Verfügbar** oder **Freie Eingabe**) beschreibt der Artikel [Kalender](/calendar).

## Bestellungen, Anfragen und Angebote

Die Bestellung kann der zentrale Vorgang sein. Buchungen, Produkte, Buchungspakete und Rabatte hängst du daran, statt Termin für Termin zu arbeiten. Im Kalender fasst du mehrere Buchungen zu einem Vorgang zusammen.

<Frame>
  <img alt="Kalender in der Bestellungsansicht mit geöffneter Bestellung im Seitenpanel: Zusammenfassung, zwei Buchungen, Produkte, Buchungscodes und Rechnungen" />
</Frame>

**Anfragen** landen in einer eigenen Liste mit Status und lassen sich im Seitenpanel bearbeiten. **Anfrageformulare** haben eine öffentliche Seite, QR-Code oder Einbettung. Aus eingehenden E-Mails werden Anfragen, inkl. AI-Zusammenfassung. [Erfahre hier mehr](/inquiries).

<Frame>
  <img alt="Übersicht von der Anfrage zur Buchung: Posteingang für Anfragen, Formularantworten, Anfragen per E-Mail, KI-Zusammenfassung, Kollegen erwähnen, Antworten per E-Mail, Angebot mit Reservierung und Online-Unterschrift" />
</Frame>

**Angebote** versendest du aus dem Rechnungsentwurf, mit Gültigkeitsdatum und optional reservierten Terminen. Der Kunde nimmt online an und unterschreibt. Preisänderungen gelten nur noch für neue Buchungen.

<Frame>
  <video aria-label="Dialog Als Angebot senden mit Empfänger, Betreff, Nachricht, PDF-Anhang, Gültig bis und der Option Buchungen reservieren" />
</Frame>

Bestehende Buchungen behalten den Preis, zu dem sie gebucht wurden. Rechnungen liegen direkt unter **Management**, nicht mehr als Unterpunkt von Bestellungen.

## Buchungsverwaltung

Buchungen bearbeitest du weiter im Kalender, in der Liste **Buchungen** und auf der Buchungsdetailseite. Der Ablauf ist derselbe Gedanke wie bei Bestellungen: du arbeitest am Vorgang, nicht an einzelnen verstreuten Formularen.

| Vorher | Jetzt |
| :- | :- |
| Status oft nur über die Liste oder die alte Detailseite | **Bestätigen**, **Ablehnen** und **Stornieren** sitzen an der Buchung, im Kalender und in der Liste |
| Mini-Kalender und eigene Detail-Logik | **Buchungsdetails** mit Ressource, **Buchungsoption**, Zeitraum und Status. Daneben Feed statt Mini-Kalender. |
| Termin für Termin, Bestellung getrennt | Bestellung und Buchungen hängen zusammen. Du siehst den Vorgang im Kalender und auf der Buchung. |
| Eine Aktion nach der anderen | Mehrere Buchungen markieren und über **Massenaktionen** gemeinsam **bestätigen**, **ablehnen** oder **stornieren** |

<Frame>
  <video aria-label="Buchungsliste mit 30 markierten Buchungen und geöffneten Sammelaktionen wie Nachricht senden, Umbuchen, Duplizieren und Export" />
</Frame>

Die ausführlichen Schritte (Anfrage annehmen, stornieren, Buchungsoption von Anfrage auf eine bezahlbare Option wechseln) folgen in einem eigenen Artikel zur Buchungsverwaltung.

### Kommunikation

Die interne sowie externe Kommunikation wird nun über die **Aktivität** verwaltet in chronologischer Reihenfolge. Du findest rechts auf der Detailseite einer **Buchung**, **Bestellung** oder eines **Kunden**, außerdem in der Kalender-Vorschau. [Erfahre hier mehr](/activity-log).

Im Feed stehen automatisch festgehaltene Ereignisse (Status, Änderungen, Zugänge, Sync) und das, was dein Team schreibt oder verschickt. Oben filterst du nach **Alles**, **Notizen**, **Kommunikation**, **Änderungen** und **System**. Daneben kannst du die Aktivität durchsuchen.

<Frame>
  <video aria-label="Buchungsdetail mit Aktivität rechts: eingehende Kunden-E-Mail und Antwort im Modus E-Mail" />
</Frame>

<AccordionGroup>
  <Accordion title="Kommunikation">
    Unten wechselst du die **Art der Nachricht** auf **E-Mail**. Die Mail geht an die hinterlegte Kund:innenadresse (**An**, **Betreff**, **E-Mail senden**). Eingehende und ausgehende Mails (und SMS, falls vorhanden) erscheinen im Filter **Kommunikation**, inkl. Zustellstatus wie **Gesendet**, **Zugestellt**, **Geöffnet**.
  </Accordion>

  <Accordion title="Notizen und Tasks">
    Standard ist **Notiz**. Die Notiz ist intern, Kund:innen sehen sie nicht. Du kannst Kolleg:innen erwähnen, antworten und reagieren. Wird daraus eine Aufgabe, sobald du **Zuweisen** und/oder **Fälligkeit setzen** nutzt. Im Feed steht dann **Aufgabe**, mit Fälligkeit und Checkbox **Als erledigt markieren** bzw. **Wieder öffnen**.
  </Accordion>
</AccordionGroup>

### Tags

**Tags** sind organisationsweite Labels (Name, optional Farbe). Du kennzeichnest damit Buchungen, Bestellungen, Kund:innen, Ressourcen und Services. Derselbe Tag (z. B. **VIP**) gilt überall. Wer den Datensatz bearbeiten darf, kann ihn taggen; anlegen und umbenennen geht über **Tags suchen oder erstellen** bzw. **Tags verwalten**. Änderungen speichern sofort. [Erfahre hier mehr.](/tags)

<Frame>
  <img alt="Wochenkalender mit farbigen Tags wie VIP, Catering, Rechnung offen und Stammkunde auf den Buchungskarten" />
</Frame>

<AccordionGroup>
  <Accordion title="Buchungsverwaltung">
    * Am Datensatz: in den Buchungsdetails unter **Tags** Chips setzen oder entfernen; in der Tabelle ebenfalls inline.
    * Filtern: in der Buchungsliste nach **Tags** (mindestens einer der gewählten Tags).
    * Massenbearbeitung: Auswahl → **Tags bearbeiten** → **Hinzufügen** oder **Entfernen**.
    * Im Kalender zeigt die Karte die Tags der Buchung, der Bestellung und der Kund:in zusammen.

    Typische Nutzung: Status wie *Nachfassen*, *VIP*, *Interne Buchung* oder *Warteliste* — ohne extra Custom Fields.
  </Accordion>

  <Accordion title="Ressourcen">
    * Auf der Ressource unter **Tags** (Hinweis: **Tags werden sofort gespeichert.**).
    * In der Ressourcenliste filtern und per **Tags bearbeiten** mehrere Räume/Objekte auf einmal kennzeichnen.

    Typische Nutzung: *Renovierung*, *Barrierefrei*, *Outdoor*, *Nur intern* — zum Filtern und für den Überblick, nicht als Buchungsregel.
  </Accordion>

  <Accordion title="Kund:innen">
    * In den Kundendetails unter **Tags**.
    * In der Kundenliste nach **Tags** filtern.
    * Keine Massenaktion **Tags bearbeiten** in der Kundenliste (Stand Admin 3.0). Kundentags erscheinen mit auf der Kalenderkarte der Buchung.

    Typische Nutzung: *Stammkunde*, *VIP*, *Firma XY*, *Mahnung* — einmal am Kunden, sichtbar bei jeder Buchung.
  </Accordion>
</AccordionGroup>

## Listen und Tabellen

Fast alle großen Listen nutzen dasselbe Tabellensystem. Du sicherst eine **Ansicht** bewusst, privat oder fürs Team. Filter speichern sich nicht mehr automatisch.

Viele Werte änderst du direkt in der Zeile. Neue Einträge legst du oft in der letzten Zeile an. Markierte Zeilen öffnen Sammelaktionen, zum Beispiel taggen, stornieren, anschreiben, verschieben oder exportieren. Spalten stellst du über das Einstellungs-Symbol im Tabellenkopf ein.

<Frame>
  <img alt="Übersicht der Funktionen für schnelles Arbeiten: Tastenkürzel, Sammelaktionen für viele Buchungen, Live-Aktualisierung, Ansichten, farbige Tags und Neu anlegen mit N" />
</Frame>

### Ansichten

Eine **Ansicht** ist eine benannte Zusammenstellung. In Tabellen merkt sie sich Filter, sichtbare Spalten, deren Reihenfolge und die Sortierung. Im Kalender steuert dieselbe Ressourcen-Ansicht, welche Ressourcen du siehst. Kalender und Ressourcenliste teilen sich diese Ansichten, merken sich aber getrennt, welche gerade aktiv ist. Die Tabs stehen über der Liste. Geteilte Ansichten liegen links, private rechts (Schloss-Symbol).

<Frame>
  <img alt="Ressourcenliste mit Ansichts-Tabs Alle, Live, Intern und Archiviert, Filterleiste und Spalten wie Status, Kategorie, Gruppe, Fläche und Kapazität" />
</Frame>

| Art | Wer sieht sie |
| :- | :- |
| **Privat** | Nur du. Du kannst sie immer selbst anlegen, umbenennen und löschen. |
| **Geteilte Ansicht** | Alle Teammitglieder. Sichtbar für alle, die die Liste sehen. |

<Accordion title="So legst du eine Ansicht an">
  1. Stelle Filter, Spalten und Sortierung so ein, wie du sie brauchst.
  2. Klicke auf **Ansicht hinzufügen**.
  3. Vergib einen **Namen der Ansicht**.
  4. Schalte optional **Geteilte Ansicht** ein (**Sichtbar für alle Teammitglieder**).
  5. Klicke auf **Ansicht speichern**. Änderst du Filter oder Spalten an einer bestehenden Ansicht, speichert anny das nicht von allein. Du wählst **Speichern** (diese Ansicht überschreiben), **Als neue Ansicht speichern** oder **Änderungen verwerfen**. Am Tab-Menü (⋯ beim Überfahren, Rechtsklick oder Umschalt+F10): **Ansicht bearbeiten**, **Duplizieren**, **Entfernen**. Die letzte Ansicht einer Liste lässt sich nicht löschen. Die Reihenfolge ziehst du per Drag & Drop, innerhalb der privaten bzw. geteilten Gruppe. Typische Nutzung: *Heutige Anfragen*, *Unbezahlte Rechnungen*, *Meetingräume* im Kalender und in der Ressourcenliste.
</Accordion>

## Katalog und Detailseiten

Detailseiten folgen demselben Aufbau: Seitenkopf, Aktionsmenü, **Speichern** oben mit sichtbarem Status, Aktivität am Eintrag. Einstellungen liegen in aufklappbaren Gruppen.

<Frame>
  <img alt="Detailseite der Ressource Salon: Seitenkopf mit Status und Gespeichert, Reiter von Allgemeine Informationen bis Teilen & Einbetten, Bild, Beschreibung und Eigenschaften" />
</Frame>

Zusatzoptionen heißen **Produkte** und haben einen eigenen Bereich im **Katalog**. Der frühere Tab **Buchungsseite** heißt **Teilen**. Unterressourcen pflegst du in der Ressourcenliste, nicht auf einer eigenen Seite. Ressourcen und Services sortierst du per Drag & Drop. Diese Reihenfolge gilt im Admin und auf der Buchungsseite.

## Einstellungen und Integrationen

Einstellungen liegen in aufklappbaren Gruppen, zum Beispiel Allgemein, Anfragen, anny AI, Rechnungsstellung, Buchungsregeln und Teilen & Einbetten. **Apps & Integrationen** und Features sind aus den Organisationseinstellungen nach **Account › Apps & Integrationen** gezogen. Sprache und Erscheinungsbild stellst du im Benutzermenü ein, nicht mehr im Profil. Team, Einladungen und Rollen liegen als Abschnitte auf einer Seite.

## Buchungsseite

Admin 3.0 ist vor allem ein Update des Admins. Der Buchungsablauf bleibt. Neu sind die öffentliche Anfrageseite und die Angebotsseite. Ressourcen und Services erscheinen in der Reihenfolge, die du im Admin festlegst, nicht mehr alphabetisch.

## Außerdem neu

Auch abseits von Kalender und Bestellungen hat sich einiges getan: ein neuer [Check-in](/check-in-overview), ein Dunkelmodus, [Karten mit KI](/maps-and-floor-plans) aus deinem Grundriss, [Produkte](/add-ons) ohne Termin und [Benachrichtigungen](/admin-notifications) im Admin oder im Browser.

<Frame>
  <img alt="Weitere Neuerungen im Überblick: Check-in, Dunkelmodus, Mobil, Karten mit KI, Produkte, Pakete mit Versand, Benachrichtigungen und Formulare später" />
</Frame>

## Was gleich bleibt

* Bestehende Buchungen, Bestellungen, Rechnungen und Kund:innen
* Rechte und Rollen
* Öffentliche Buchungsseiten, Buchungsoptionen und Verfügbarkeit (Ablauf unverändert)
* Integrationen und Smart Locks, erreichbar unter **Apps & Integrationen**

## FAQ

<AccordionGroup>
  <Accordion title="Muss ich selbst etwas umstellen?">
    Nein. Daten und Konfigurationen bleiben erhalten. Wer Ressourcen und Services in einer bestimmten Reihenfolge zeigen will, legt sie jetzt per Drag & Drop fest.
  </Accordion>

  <Accordion title="Ändert sich etwas für meine Kund:innen?">
    Kaum. Der Buchungsablauf bleibt gleich. Neu sind die Anfrageseite und die Angebotsseite. Die Buchungsseite zeigt Ressourcen und Services in der im Admin festgelegten Reihenfolge.
  </Accordion>

  <Accordion title="Ändern sich bestehende Buchungen, wenn ich einen Preis anpasse?">
    Nein. Neue Preise gelten nur für neue Buchungen. Bestehende Buchungen behalten den Preis, zu dem sie gebucht wurden.
  </Accordion>

  <Accordion title="Wo ist der Support-Chat hin?">
    Der Button **Support** öffnet den **KI-Agenten**. Er hilft direkt weiter und legt bei Bedarf eine **Support-Anfrage** an, die an das Support-Team geht.
  </Accordion>

  <Accordion title="Wo ist die Ressourcenauswahl im Kalender hin?">
    In den **Filter** neben dem Kalender. Die linke Leiste entfällt. Der Kalender bekommt die Fläche.
  </Accordion>

  <Accordion title="Warum sehe ich auf der Buchungsdetailseite keinen kleinen Kalender mehr?">
    An seiner Stelle stehen **Aktivität** und Kommentare. Zum zeitlichen Einordnen oder Verschieben gehst du in den Hauptkalender. Dort liegt die Buchung neben den anderen Terminen.
  </Accordion>

  <Accordion title="Wo stelle ich die Spalten einer Tabelle ein?">
    Über das Einstellungs-Symbol im Tabellenkopf.
  </Accordion>

  <Accordion title="Warum ist mein Filter beim nächsten Aufruf weg?">
    Filter speichern sich nicht mehr automatisch. Eine Zusammenstellung, die du öfter brauchst, sicherst du als **Ansicht**, privat oder fürs Team.
  </Accordion>

  <Accordion title="Wo finde ich Integrationen und Features?">
    Unter **Account › Apps & Integrationen**.
  </Accordion>

  <Accordion title="Wo sind Exporte und Karten hin?">
    Exporte startest du aus der jeweiligen Tabelle. **Karten** und **Export-Zeitpläne** liegen unter **Account › Einstellungen**. Karten erreichst du zusätzlich als Ansicht im Kalender. Alles ist auch über die **Suche** (⌘K) erreichbar.
  </Accordion>

  <Accordion title="Wo sind meine Zusatzoptionen?">
    Sie heißen **Produkte** und haben einen eigenen Bereich im **Katalog**.
  </Accordion>

  <Accordion title="Wo ist der Speichern-Button hin?">
    Nach oben in den Seitenkopf. Er zeigt, ob gerade gespeichert wird und ob es geklappt hat.
  </Accordion>

  <Accordion title="Wo gebe ich Rückmeldung?">
    Über **Support** bzw. den **KI-Agenten**. Rückmeldungen zu Admin 3.0 werden gesammelt.
  </Accordion>
</AccordionGroup>

Hidden announcement in docs.json group Ankündigungen (`hidden: true`, `public: true`). Slug `admin-3-0`. Orientation article for existing admins after Admin 3.0. Not a how-to. Keep go-live wording only as in the Warning (public beta in October, old/new toggle until default rollout). Turning off **Admin 3.0 Beta** opens **Zurück zu v2.0?** and requires a reason; **Etwas anderes** requires a note. Turning it back on uses the same switch and does not ask again. In-admin assistant: topbar **Support** opens the **KI-Agent** (launcher label **KI-Agent**, ask placeholder **anny KI-Agent fragen**, shortcut ⌘L). Search is **Suche** (⌘K). This is not the customer-facing phone/chat product documented at `/anny-ai-setup`. The agent asks for **Freigabe** before writes and can create a **Support-Anfrage**. Intercom messenger is no longer in admin. Sidebar sections (de-DE): Buchungen, Management (not Verkauf), CRM, Katalog, Check-In, Account, Hardware (not Apps), plus **Ausgeblendet**. Hide/show: **Aus Seitenleiste ausblenden** / **In Seitenleiste anzeigen**. Page after login: **Startseite** (sidebar item may still read **Home**). Relocations: resource picker in calendar **Filter** side panel; blockers under **Buchungen › Blocker**; invoices under **Management**; integrations under **Account › Apps & Integrationen**; exports from the table; maps under **Account › Einstellungen** and as calendar view; **Speichern** in the page header; add-ons renamed **Produkte**. Do not treat this page as a second calendar, check-in, or activity-log article. Deep how-tos: `/calendar`, `/activity-log`, `/global-blockers`, `/maps-and-floor-plans`, `/invoice-corrections`, `/invoicing`, `/invoice-drafts`, `/customer-balances-and-collective-invoices`, `/ressourcen-konfigurieren`, `/configure-booking-option`, `/add-ons`, `/custom-forms`, `/booking-codes`, `/subscriptions-and-memberships`, `/check-in-overview`, `/check-in-booking-details`, `/queuing-system`, `/account-settings`, `/admin-notifications`, `/roles-and-permissions`, `/booking-page-layout`, `/admin-area-intro` (stale menu table), `/anny-ai-setup`. Planned, not registered: Suche, KI-Agent im Admin, Buchungsverwaltung, Tags, Anfragen, Anfrageformulare, Angebote, Bestellung als Vorgang, Tabellen/Ansichten, Produkte. Do not invent hrefs for planned pages. Price changes apply only to new bookings. Do not confuse `/modify-bookings` (customer self-service) with admin booking management.


# Einführung in den Admin-Bereich
Source: https://docs.anny.co/admin-area-intro

Home, Suche, Neu und das Avatar-Menü. Dazu Ansichten, Massenaktionen und Aktivität im Admin-Bereich.

Der Admin-Bereich ist dein Werkzeug für den anny Account. Hier verwaltest du Ressourcen, Buchungen, Kund:innen und die Einstellungen der Organisation. Die Buchungsseite ist das, was deine Kund:innen sehen und wo sie buchen.

Nur Personen mit Admin-Rechten haben Zugang. Nach dem Login landest du auf **Home**.

## Home

**Dein Tag im Überblick** zeigt bis zu drei Widgets, umschaltbar zwischen Heute und Morgen. Über das Zahlenrad kannst du selbst entscheiden, welche Widgets sichtbar sein sollen.

Darunter kannst du den anny AI Agent fragen: Wobei kann ich dir helfen? Die Vorschläge sind Was steht heute an?, Offene Anfragen prüfen und Freie Ressourcen finden.

Weiter unten liegen Erste Schritte, Neue Benachrichtigungen und Meine Aufgaben. Daneben Neue Funktionen. Sind die ersten Schritte erledigt, kommt Hol mehr aus anny heraus dazu.

## Obere Leiste

In der Mitte der Leiste liegt **Globale Suche**. Ein Klick öffnet die Suche. Das Tastenkürzel steht am Button: auf dem Mac ⌘K, sonst Strg+K. In der Suche gibt es die Zeile **anny KI-Agent fragen**.

Daneben steht **Neu**. Ein Klick öffnet das Fenster für eine neue Bestellung. Der Hinweis am Button lautet **Bestellung erstellen**, das Kürzel ist B.

Rechts liegen die Benachrichtigungen und dein **Avatar**. Das Menü hat diese Punkte:

* **Profil & Benachrichtigungen**
* **Account Einstellungen**, wenn du die Organisation bearbeiten darfst. Mehr dazu im Artikel [Account-Einstellungen](/account-settings).
* **Sprache**, mit der aktuellen Sprache
* **Erscheinungsbild**, mit **Hell**, **Dunkel** und **System**
* **Abmelden**

Admin-Nutzer und das Abo erreichst du nicht mehr über den Avatar. **Admin-Nutzer** liegen in der Seitenleiste unter **Account**. Den Plan findest du unter **Einstellungen** im Reiter **Abo**, in der Seitenleiste auch unter **Abrechnung**.

## Seitenleiste

Die linke Leiste zeigt, was deine Rolle und die aktivierten Funktionen freigeben. Einträge blendest du mit **Aus Seitenleiste ausblenden** aus. Ausgeblendetes holst du unter **Ausgeblendet** mit **In Seitenleiste anzeigen** zurück.

| Bereich | Einträge |
| - | - |
| ohne Überschrift | **Home**, **Dashboard** |
| **Buchungen** | **Kalender**, **Buchungen** (darin **Buchungen** und **Blocker**), **Verfügbarkeit** (darin **Verfügbare Termine** und **Wöchentliche Zeitpläne**) |
| **Management** | **Anfragen**, **Bestellungen**, **Abos**, **Rechnungen**, **Codes** (darin **Buchungscodes** und **Rabattcodes**) |
| **CRM** | **Kunden**, **Unternehmen**, **Communities** |
| **Katalog** | **Ressourcen**, **Services**, **Abo-Pläne**, **Buchungspakete**, **Produkte**, **Anfrageformulare** |
| **Check-In** | **Schnellaufruf** (darin **Warteschlangen**), **Check-In** |
| **Account** | **Einstellungen** (darin **Allgemein**, **Abrechnung**, **Karten**, **Export-Zeitpläne**), **Admin-Nutzer**, **Apps & Integrationen** |
| **Hardware** | **Displays** |

Unten in der Leiste liegen **Support** und **Buchungsseite**.

## Ansichten

Auf Listen wie Buchungen oder Ressourcen speicherst du Filter und Spalten als Ansicht. **Ansicht hinzufügen** legt eine an. Im Dialog **Ansicht erstellen** gibst du den Namen ein. **Geteilte Ansicht** macht sie für das Team sichtbar. Der Hinweis dazu lautet **Sichtbar für alle Teammitglieder**. Danach nimmst du **Ansicht speichern**, **Als neue Ansicht speichern** oder **Änderungen verwerfen**.

## Massenaktionen

Markierst du Zeilen in einer Liste, erscheint eine Leiste für Massenaktionen. Sie zeigt, wie viele Einträge ausgewählt sind, dazu **Auswahl aufheben** und **Weitere Aktionen**.

## Aktivität

An einem Datensatz heißt die Zeitleiste **Aktivität**. Dort siehst du Änderungen, E-Mails und Notizen. Den Zusammenhang beschreibt der Artikel [Aktivitäts-Log](/activity-log). Änderungen des **anny AI Agent** stehen dort mit **via KI-Agent**.

## Einladung annehmen

Du wurdest per E-Mail (Absender: [bookings@anny.co](mailto:bookings@anny.co)) zum Admin-Bereich eingeladen. So nimmst du die Einladung an:

<Steps>
  <Step title="E-Mail öffnen">
    Suche in deinem Posteingang nach der Einladungs-E-Mail. Prüfe auch den Spam-Ordner.

    <img alt="Einladungs-E-Mail zum Admin-Bereich" />

    Die Einladung liegt im Posteingang oder im Spam-Ordner.
  </Step>

  <Step title="Team beitreten">
    Klicke auf **Team beitreten**. Melde dich mit deinem bestehenden anny Konto an oder erstelle ein neues.

    <img alt="Team beitreten in der Einladung" />

    Du bist angemeldet und siehst die Einladung.
  </Step>

  <Step title="Einladung bestätigen">
    Klicke auf **Einladung annehmen**. Du wirst in den Admin-Bereich weitergeleitet und landest auf **Home**.
  </Step>
</Steps>

## Profil und Benachrichtigungen einstellen

<Steps>
  <Step title="Profil öffnen">
    Klicke oben rechts auf deinen **Avatar** und wähle **Profil & Benachrichtigungen**.

    Dein Profil ist offen.
  </Step>

  <Step title="Grundeinstellungen prüfen">
    Stelle Sprache, Zeitzone und E-Mail-Adresse ein.

    Die Angaben sind gespeichert.
  </Step>

  <Step title="Benachrichtigungen konfigurieren">
    Wähle unter den Kategorien, welche Benachrichtigungen du erhalten möchtest. Unter **Relevante Ressourcen** schränkst du sie auf bestimmte Ressourcen ein. Zusätzlich kannst du einen Buchungszeitraum für Benachrichtigungen einstellen.

    Du bekommst nur die Benachrichtigungen, die du ausgewählt hast.
  </Step>
</Steps>

Als Super-Admin stellst du die Benachrichtigungen anderer Admins über die drei Punkte in der Nutzerverwaltung ein. Der Ablauf steht im Artikel [Admin-Benachrichtigungen](/admin-notifications).

## Neue Teammitglieder einladen

<Steps>
  <Step title="Nutzerverwaltung öffnen">
    Öffne in der Seitenleiste **Account** und dann [**Admin-Nutzer**](/roles-and-permissions).

    Die Nutzerverwaltung ist offen.
  </Step>

  <Step title="Einladung versenden">
    Klicke auf **Einladen**, gib Name und E-Mail-Adresse ein und weise eine Rolle zu.

    Die Einladung ist raus.
  </Step>

  <Step title="Berechtigungen anpassen">
    Klicke auf **Berechtigungen verwalten**, wenn die Rechte vor dem Versand enger sein sollen, zum Beispiel nur für bestimmte Ressourcen.

    Die Einladung gilt mit den Rechten, die du gesetzt hast.
  </Step>
</Steps>

<Columns>
  <Column>
    <Card title="Der Kalender in anny" icon="calendar-alt">
      Ein Überblick über alle Buchungen und Verfügbarkeiten deiner Ressourcen in einer Zeitansicht, sodass du Termine direkt einsehen und verwalten kannst.<br /><br />[Erfahre hier mehr](/calendar)
    </Card>
  </Column>

  <Column>
    <Card title="Buchungsverwaltung" icon="calendar-check">
      Erstelle, bearbeite und storniere Buchungen zentral und behalte den Überblick über Status und Details wie Formulare, rechtliche Dokumente und Zugänge.<br /><br />[Erfahre hier mehr](/modify-bookings)
    </Card>
  </Column>

  <Column>
    <Card title="Kunden verwalten" icon="people-group">
      Verwalte Kundendaten und die Buchungshistorie an einem Ort. Sieh Pläne, Kontingente, Rechnungen und Unternehmen.<br /><br />[Erfahre hier mehr](/manage-customers)
    </Card>
  </Column>
</Columns>

<AccordionGroup>
  <Accordion title="Ich finde die Einladungs-E-Mail nicht.">
    Prüfe den Spam-Ordner. Die E-Mail kommt von [bookings@anny.co](mailto:bookings@anny.co). Taucht sie nicht auf, bitte die einladende Person, die Einladung erneut zu senden.
  </Accordion>

  <Accordion title="Welche Rolle brauche ich, um alles sehen zu können?">
    Mit **Super-Admin** oder **Admin** hast du Zugriff auf alle Bereiche. Für eingeschränkten Zugriff gibt es eigene Rollen. Mehr dazu im Artikel [Admin-Nutzer und Rollen verwalten](/roles-and-permissions).
  </Accordion>

  <Accordion title="Kann ich Benachrichtigungen nur für bestimmte Ressourcen erhalten?">
    Ja. Unter **Profil & Benachrichtigungen** wählst du bei den Buchungsbenachrichtigungen unter **Relevante Ressourcen** aus, wofür du benachrichtigt wirst.
  </Accordion>

  <Accordion title="Wie unterscheidet sich der Admin-Bereich von der Buchungsseite?">
    Im Admin-Bereich verwaltest du Ressourcen, Buchungen, Kund:innen und Einstellungen. Die Buchungsseite ist das, was deine Kund:innen sehen und wo sie buchen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> Start nach Login: Route `home` (Index leitet dorthin). Begrüßung `pages.onboarding.flows.steps.welcome.welcomeUser`. Block **Dein Tag im Überblick** nur, wenn Widgets oder ein Widget-Katalog da sind.
>
> Topbar: **Globale Suche** (Meta+K), **Neu** (`common.actions.new`) öffnet direkt `openCreateBookingModal`, Tooltip **Bestellung erstellen**, Kürzel B. Kein Aufklappmenü.
>
> Avatar (`AdminUserMenu`): **Profil & Benachrichtigungen**, **Account Einstellungen** bei `can('update', organizations)`, **Sprache**, **Erscheinungsbild** (Hell/Dunkel/System), **Abmelden**. Kein Punkt für Admin-Nutzer oder Abo.
>
> Admin-Nutzer: Seitenleiste **Account** → **Admin-Nutzer**. Abo: Reiter **Abo** und Unterpunkt **Abrechnung**.
>
> Ansichten: `components.tables.views`. Massenaktionen: Leiste `common.tables.bulkActions` (**Auswahl aufheben**, **Weitere Aktionen**). Aktivität am Datensatz: Label **Aktivität**, Artikel `/activity-log`.


# Admin-Benachrichtigungen einstellen
Source: https://docs.anny.co/admin-notifications

Lege fest, welche Benachrichtigungen du als Admin erhältst, und stelle sie als Super Admin auch für Kolleg:innen ein.

Als Admin erhältst du Benachrichtigungen, sobald in deiner Organisation etwas Relevantes passiert: neue Bestellungen, Anfragen, Abo-Ereignisse oder Fehler an Integrationen. Jede Admin-Person hat eigene Einstellungen.

Mit Admin-Benachrichtigungen kannst du in anny:

* festlegen, zu welchen Ereignissen du selbst benachrichtigt wirst
* die Benachrichtigungen auf bestimmte Ressourcen oder Abo-Pläne eingrenzen
* als Super Admin dieselben Einstellungen für andere Admins setzen

Der Artikel richtet sich an Admins, die ihr eigenes Postfach steuern, und an Super Admins, die das für das Team übernehmen.

## Typische Anwendungsfälle

| Szenario | Beschreibung |
| :- | :- |
| **Nur eigene Räume** Du betreust ausgewählte Ressourcen und willst nicht zu jeder Buchung eine Mail. | Aktiviere die Buchungsbenachrichtigungen und wähle unter **Relevante Ressourcen** nur deine Räume. |
| **Empfang übernimmt Anfragen** Eine Kolleg:in soll jede Buchung mit manueller Bestätigung mitbekommen. | Öffne als Super Admin **Benachrichtigungen verwalten** in der Zeile dieser Person und schalte **Angefragt Buchungen** ein. |
| **Keine Mails während einer Pause** Jemand soll vorübergehend keine Admin-Mails bekommen. | Deaktiviere im Dialog **Alle Benachrichtigungen** und speichere. |

## Wie Admin-Benachrichtigungen funktionieren

Die Einstellungen hängen an der einzelnen Person in der Organisation, nicht am Account insgesamt. Zwei Wege führen auf dieselben Toggles:

* **Dein Profil:** Unter **Profil & Benachrichtigungen** änderst du nur deine eigenen Einstellungen. anny speichert jede Änderung direkt.
* **Nutzerverwaltung:** Als Super Admin öffnest du über die drei Punkte **Benachrichtigungen verwalten** und stellst die Werte für eine andere Person ein. Hier gibt es zusätzlich **Alle Benachrichtigungen**. Änderungen gelten erst nach **Speichern**.

Unter **Relevante Ressourcen** (Platzhalter **Alle Ressourcen**) filterst du die Buchungsbenachrichtigungen. Sind Abos aktiv, filterst du Abo-Mails zusätzlich über **Abo-Pläne**.

Für **Neue Bestellungen**, **Stornierte Bestellungen**, **Angefragt Buchungen** und **Geänderte Buchungen** kannst du zusätzlich **Benachrichtigen für** setzen: **Alle** oder nur Buchungen **In den nächsten** X Tagen. **Neue Paketverkäufe** hat diese Einschränkung nicht.

## Eigene Benachrichtigungen einstellen

<Steps>
  <Step title="Profil öffnen">
    Klicke oben rechts auf deinen **Avatar** und wähle **Profil & Benachrichtigungen**.
  </Step>

  <Step title="Kategorien wählen">
    Gehe die Abschnitte durch und schalte die Toggles ein oder aus. Unter **Relevante Ressourcen** wählst du bei Bedarf einzelne Ressourcen. Ist das Feature **Abos und Mitgliedschaften** aktiv, erscheint zusätzlich **Abo Benachrichtigungen** mit der Auswahl **Abo-Pläne**.
  </Step>
</Steps>

Sobald eine Einstellung gesetzt ist, speichert anny sie für dich. Ab dann erhältst du nur noch die aktivierten Benachrichtigungen.

## Benachrichtigungen anderer Admins einstellen

Das Menü **Benachrichtigungen verwalten** siehst du, wenn du die Organisation bearbeiten darfst. Bei den Standardrollen hat das die Rolle Super Admin. Andere Admins stellen nur ihr eigenes Profil ein.

<Steps>
  <Step title="Nutzerverwaltung öffnen">
    Klicke oben rechts auf deinen **Avatar** und wähle **Admin-Nutzer verwalten**. Du landest auf der **Admin Nutzerverwaltung** bei **Aktive Nutzer**.
  </Step>

  <Step title="Menü der Person öffnen">
    Klicke in der Zeile des gewünschten Admins auf die drei Punkte und wähle **Benachrichtigungen verwalten**.
  </Step>

  <Step title="Einstellungen setzen">
    Im Dialog **Benachrichtigungseinstellungen** steht, welche Benachrichtigungen diese Person erhält. Mit **Alle Benachrichtigungen** schaltest du alle sichtbaren Kategorien auf einmal um. Danach kannst du einzelne Toggles und **Relevante Ressourcen** anpassen.
  </Step>

  <Step title="Speichern">
    Klicke auf **Speichern**. Mit **Abbrechen** verwirfst du ungespeicherte Änderungen.
  </Step>
</Steps>

Sobald du gespeichert hast, gelten die neuen Werte für diese Person. Sie sieht dieselben Einstellungen unter **Profil & Benachrichtigungen**.

<Frame>
  <img alt="Drei-Punkte-Menü Benachrichtigungen verwalten in der Admin Nutzerverwaltung und Dialog Benachrichtigungseinstellungen" />
</Frame>

## Einstellungen und Optionen

| Einstellung | Wirkung |
| :- | :- |
| **Alle Benachrichtigungen** | Nur im Dialog für andere Nutzer. Schaltet alle aktuell sichtbaren Toggles gemeinsam ein oder aus. Filter wie Ressourcen, Pläne und Fristen bleiben unberührt. |
| **Neue Bestellungen** | Mail bei jeder neuen Bestellung. Optional **Benachrichtigen für**. |
| **Stornierte Bestellungen** | Mail bei Stornierung. Optional **Benachrichtigen für**. |
| **Angefragt Buchungen** | Mail, wenn eine Buchung deine manuelle Bestätigung braucht. Optional **Benachrichtigen für**. |
| **Geänderte Buchungen** | Mail bei Änderungen an Buchungen. Optional **Benachrichtigen für**. |
| **Neue Paketverkäufe** | Mail, wenn ein Kunde ein Buchungspaket kauft. Keine Frist. |
| **Relevante Ressourcen** | Schränkt Buchungsbenachrichtigungen ein. Leer bzw. Platzhalter **Alle Ressourcen** bedeutet alle Ressourcen. |
| **Neue Abos**, **Angefragte Abos**, **Gekündigte Abos**, **Abgerechnete Abos**, **Geänderte Abos** | Abo-Ereignisse. Der Abschnitt erscheint nur, wenn das Feature **Abos und Mitgliedschaften** aktiv ist. |
| **Abo-Pläne** | Schränkt Abo-Benachrichtigungen auf ausgewählte Pläne ein. |
| **Termin wird storniert** | Mail, wenn ein verfügbarer Termin storniert wird. |
| **Mindestanzahl für den Termin erreicht** | Mail, wenn die Mindestanzahl eines Termins erreicht ist. |
| **Zahlungserinnerung versendet** | Mail, sobald eine Zahlungserinnerung rausgegangen ist. |
| **Fehler bei Integrationen** | Mail, wenn eine Integration einen Fehler hat. |
| **Webhook-Deaktivierungsbenachrichtigung** | Mail, wenn anny einen Webhook wegen Fehlern automatisch deaktiviert. |
| **KI-Anruf abgeschlossen** | Mail und Hinweis im Admin-Bereich, wenn ein KI-Gespräch endet. Der Abschnitt erscheint nur, wenn anny AI Agents aktiv sind. |

Die Toggles im Dialog entsprechen denen unter **Profil & Benachrichtigungen**. Zusätzlich gibt es im Dialog **Alle Benachrichtigungen**.

<Frame>
  <img alt="Dialog Benachrichtigungseinstellungen mit Toggle Alle Benachrichtigungen und den Buchungsbenachrichtigungen" />
</Frame>

## Einschränkungen

* **Benachrichtigungen verwalten** erscheint nur mit dem Recht, die Organisation zu bearbeiten. Die Standardrolle Admin hat das nicht.
* Du kannst keine Admins einer anderen Organisation bearbeiten.
* **Alle Benachrichtigungen** gibt es nur im Dialog für andere Nutzer, nicht unter **Profil & Benachrichtigungen**.
* Der Abschnitt **Abo Benachrichtigungen** fehlt, wenn das Feature **Abos und Mitgliedschaften** nicht aktiv ist. **KI-Benachrichtigungen** fehlen ohne anny AI Agents.
* Die Frist **Benachrichtigen für** gilt nur für die vier Buchungs-Toggles oben, nicht für Paketverkäufe, Abos, Termine, Zahlungen, Integrationen oder KI.
* Diese Einstellungen steuern Mails an Admins. Zusätzliche Texte in Kund:innen-Mails liegen unter [Mitteilungen konfigurieren](/configure-notifications). SMS, WhatsApp und Telegram liegen unter [Mobile Benachrichtigungen](/mobile-notifications).

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich die Benachrichtigungen anderer Admins ändern?">
    Ja, wenn du die Organisation bearbeiten darfst (Standardrolle Super Admin). Öffne **Admin-Nutzer verwalten**, klicke auf die drei Punkte in der Zeile der Person und wähle **Benachrichtigungen verwalten**.
  </Accordion>

  <Accordion title="Warum sehe ich Alle Benachrichtigungen nicht in meinem Profil?">
    Der Master-Toggle existiert nur im Dialog **Benachrichtigungseinstellungen**, wenn du die Einstellungen einer anderen Person bearbeitest. Für dich selbst schaltest du die Kategorien einzeln unter **Profil & Benachrichtigungen**.
  </Accordion>

  <Accordion title="Was passiert, wenn Relevante Ressourcen auf Alle Ressourcen steht?">
    Dann gilt keine Einschränkung. Du erhältst die aktivierten Buchungsbenachrichtigungen für alle Ressourcen der Organisation.
  </Accordion>

  <Accordion title="Ist das dasselbe wie Mitteilungen in den Account-Einstellungen?">
    Nein. Hier entscheidest du, welche Mails Admins bekommen. Unter **Account-Einstellungen** → **Mitteilungen** hinterlegst du zusätzliche Texte in den E-Mails an Kund:innen. Siehe [Mitteilungen konfigurieren](/configure-notifications).
  </Accordion>

  <Accordion title="Bekommt die andere Person eine Info, dass ich ihre Einstellungen geändert habe?">
    Nein. Die Person sieht die neuen Werte in ihrem Profil, erhält dazu aber keine gesonderte Nachricht.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich sehe Benachrichtigungen verwalten in den drei Punkten nicht">
    Dir fehlt das Recht, die Organisation zu bearbeiten. Die Standardrolle Admin hat es nicht, Super Admin schon. Stelle in diesem Fall nur dein eigenes Profil unter **Profil & Benachrichtigungen** ein oder bitte eine Person mit Super Admin.
  </Accordion>

  <Accordion title="Der Abschnitt Abo Benachrichtigungen fehlt">
    Der Block erscheint nur, wenn das Feature **Abos und Mitgliedschaften** in deinem Account aktiv ist. Ohne dieses Feature gibt es keine Abo-Toggles und keine Auswahl **Abo-Pläne**.
  </Accordion>

  <Accordion title="Meine Änderungen im Dialog sind nach dem Schließen weg">
    Im Dialog für andere Admins gelten Werte erst nach **Speichern**. **Abbrechen** oder Schließen ohne Speichern verwirft die Änderungen. Unter **Profil & Benachrichtigungen** speichert anny dagegen direkt.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> UI-Pfade:
>
> * Eigene Einstellungen: **Avatar** (oben rechts) → **Profil & Benachrichtigungen** (Route `/user`, Seitentitel „Profil“). Component `UserSettings` → `UserNotificationSettings` ohne `showToggleAll`.
> * Andere Admins: **Avatar** → **Admin-Nutzer verwalten** (Route `/user-management`, Titel **Admin Nutzerverwaltung**) → Tabelle **Aktive Nutzer** → Aktionsmenü (drei Punkte) → **Benachrichtigungen verwalten**. Dialogtitel **Benachrichtigungseinstellungen**, Beschreibung „Lege fest, welche Benachrichtigungen  erhält.“
>
> Berechtigung: UI `user.can('update', 'organizations')`. Backend `permissionManager()->can('update', $organization)`, sonst 403. OrganizationUser einer anderen Organisation: 404. Standardrolle Super Admin hat `*` auf Organization; Standardrolle Admin nicht. Eigene Settings gehen weiter über `api/settings/organization-user`, nicht über den Admin-Endpunkt.
>
> API (nur fremde Nutzer): GET/PUT `api/settings/organization-users/{organizationUser}/notifications`. Response enthält ausschließlich den Key `notifications` (keine sonstigen OrganizationUser-Settings). PUT sendet nur dirty Keys.
>
> Quirks:
>
> * `showToggleAll` nur im Modal. Toggle **Alle Benachrichtigungen** setzt die aktuell gerenderten Boolean-Keys, nicht `resources`, `plans` oder `*LeadTime`.
> * Lead Time nur für orderConfirmed, orderCanceled, bookingRequested, bookingUpdated, und nur bei aktivem Toggle. Scope „upcoming“ schreibt beim Umschalten 7 Tage. 0/null/leer = keine Frist.
> * Abo-Abschnitt: Feature `plan-subscriptions`. KI-Abschnitt: `organization.hasAgents`.
> * Label **Angefragt Buchungen** ist der UI-Wortlaut (nicht „Angefragte“).
> * Super Admin kann den Dialog auch für die eigene Zeile öffnen. Dann erscheint **Alle Benachrichtigungen**, obwohl das eigene Profil den Master-Toggle nicht hat.
>
> Abgrenzung: Nicht `configure-notifications` (Zusatztexte in Kund:innen-Mails), nicht `mobile-notifications` (SMS/WhatsApp/Telegram), nicht `user-profile-settings` (Endnutzer:innen auf der Buchungsseite).
>
> Beziehungen: Intro-Pfad in `/admin-area-intro`. Drei-Punkte-Menü auch für Berechtigungen in `/roles-and-permissions`. Abo-Pfad zusätzlich in `/subscriptions-and-memberships`. Alter Verweis `/mitteilung` zeigt auf diesen Artikel.


# anny Plan verwalten
Source: https://docs.anny.co/anny-plan

Passe deinen anny Plan an, um die passenden Features für dein Team freizuschalten.

Mit dem anny Plan steuerst du, welche Features und Kapazitäten dir zur Verfügung stehen. In diesem Artikel erfährst du, wie du deinen aktuellen Plan einsehen, wechseln oder kündigen kannst.

## Planübersicht

anny bietet fünf Pläne. **Starter** ist dauerhaft kostenlos mit begrenzten Kontingenten. Alle Preise der kostenpflichtigen Pläne verstehen sich monatlich und zzgl. MwSt. Bei jährlicher Zahlung sparst du 20 %.

| | Starter | Essential | Professional | Business | Enterprise |
| - | - | - | - | - | - |
| **Preis/Ressource** | 0 € | 5,00 € | 10,00 € | 15,00 € | Custom |
| **Preis/Child-Ressource** | – | 5,00 € | 5,00 € | 5,00 € | Custom |
| **Ressourcen** | 5 | nach Verbrauch | nach Verbrauch | nach Verbrauch | Custom |
| **Buchungsoptionen** | 5 | unbegrenzt | unbegrenzt | unbegrenzt | Custom |
| **Buchungen/Monat** | 100 | unbegrenzt | unbegrenzt | unbegrenzt | Custom |
| **Communities** | – | 2 | 5 | 20 | Unlimited |
| **Automatische Exporte** | – | 1 | 3 | 5 | 12 |
| **Highlights** | Kostenlos, Check-in | Individuelle Stornierungsbedingungen, Smart Availability, Rechte- & Rollensysteme, Check-in & Check-out, Personalisierte Buchungen, E-Mail Templates, Mehrfachverfügbarkeiten, Terminerinnerungen, Custom Fields, Video-Meetings, Kalender-Sync, Abos & Mitgliedschaften | Alles aus Essential sowie: Conversion Tracking, 3D Raumplaner, Mehrfachkarten & Wertgutscheine, Buchungskontingente, Warteliste, Broadcast Nachrichten, Erweiterte Buchungsregeln, Individuelles Widget, Smart-Lock Integrationen, Dynamisches Pricing | Alles aus Professional sowie: Kundensalden, Webhooks, API Zugang, Anonyme Buchungen, Verträge & Dokumente | Alles aus Business sowie: Priority Support, Onboarding, Eigene Löschfristen, Single-Sign-On |

<Tip>
  Nach der Account-Erstellung kannst du **5 Tage** lang alle Features kostenlos testen. Beim Upgrade auf Essential oder Professional gilt zusätzlich eine **14-tägige** Testphase des gewählten Plans.
</Tip>

## Plan einsehen und ändern

<Steps>
  <Step title="Abo & Abrechnung öffnen">
    Klicke oben rechts auf dein **Account-Symbol** und wähle **Abo & Abrechnung**.
  </Step>

  <Step title="Aktuellen Plan prüfen">
    Unter deinem aktiven Plan steht der Hinweis **aktiv**. Du siehst alle verfügbaren Pläne nebeneinander.
  </Step>

  <Step title="Plan wechseln">
    Wähle den gewünschten Plan aus. Klicke auf **Upgrade**, um in einen höheren Plan zu wechseln, oder auf **Downgrade**, um zu einem kleineren Plan zu wechseln.
  </Step>

  <Step title="Wechsel bestätigen">
    Es erscheint ein Pop-up zur Bestätigung. Prüfe die Angaben und bestätige den Wechsel.
  </Step>
</Steps>

<Tip>
  Bei einem **Upgrade** wird der bereits gezahlte Betrag anteilig verrechnet und der neue Plan ist sofort aktiv. Bei einem **Downgrade** greift der neue Plan erst zum Ende der aktuellen Abrechnungsperiode.
</Tip>

## Ergebnis prüfen

Nach dem Wechsel siehst du unter **Abo & Abrechnung** den neuen Plan mit dem Status **aktiv**. Bei einem Downgrade zeigt der bisherige Plan den Status **Geplant** bzw. **Gekündigt** an, bis die aktuelle Periode endet.

## Plan kündigen

<Steps>
  <Step title="Abo & Abrechnung öffnen">
    Klicke oben rechts auf dein **Account-Symbol** und wähle **Abo & Abrechnung**.
  </Step>

  <Step title="Starter-Plan auswählen">
    Wähle den **Starter-Plan** (kostenlos) aus, um deinen bezahlten Plan zu kündigen.
  </Step>

  <Step title="Buchungsseite deaktivieren">
    Stelle deine Buchungsseite auf **inaktiv**, damit keine neuen Buchungen eingehen.
  </Step>
</Steps>

## Account löschen

Wenn du anny nicht mehr nutzen möchtest, kannst du deinen Account vollständig löschen.

<Steps>
  <Step title="Plan kündigen">
    Wechsle zunächst auf den Starter-Plan (siehe oben).
  </Step>

  <Step title="Buchungsseite deaktivieren">
    Stelle deine Buchungsseite auf **inaktiv**.
  </Step>

  <Step title="Admins entfernen">
    Lösche alle Admins aus der **Nutzerverwaltung** (erreichbar über die drei Striche oben rechts).
  </Step>

  <Step title="Support kontaktieren">
    Schicke eine Nachricht mit deinem Feedback in den Support-Chat, damit dein Account final gelöscht wird.
  </Step>
</Steps>

<Warning>
  Nach der Löschung ist dein Account nicht mehr zugänglich. Alle erstellten Daten werden automatisch und unwiderruflich gelöscht.
</Warning>

## FAQ

<AccordionGroup>
  <Accordion title="Verlängert sich mein Plan automatisch?">
    Ja. Bei monatlicher Zahlung verlängert sich der Plan monatlich und du kannst jederzeit wechseln oder kündigen. Bei jährlicher Zahlung erhältst du 20 % Rabatt, kannst den Plan aber erst nach Ablauf der Laufzeit anpassen.
  </Accordion>

  <Accordion title="Was passiert bei einem Downgrade mit meinen Daten?">
    Deine Daten bleiben erhalten. Features, die im kleineren Plan nicht enthalten sind, stehen dir nach dem Wechsel nicht mehr zur Verfügung, bis du wieder upgradest.
  </Accordion>

  <Accordion title="Ab wann gilt ein Downgrade?">
    Ein Downgrade greift erst zum Ende der aktuellen Abrechnungsperiode. Bis dahin bleibt dein bisheriger Plan aktiv.
  </Accordion>

  <Accordion title="Kann ich den Enterprise-Plan direkt buchen?">
    Nein. Für den Enterprise-Plan musst du ein individuelles Angebot anfragen. Kontaktiere dazu unser Sales-Team.
  </Accordion>

  <Accordion title="Gibt es eine Kündigungsfrist?">
    Die Kündigungsfrist beträgt 30 Tage.
  </Accordion>

  <Accordion title="Was ist im Starter-Plan enthalten?">
    Starter ist dauerhaft kostenlos: 5 Ressourcen, 5 Buchungsoptionen und 100 Buchungen pro Monat. Höhere Features (z. B. Abos, dynamisches Pricing, Kundensalden) sind nicht enthalten, außer während der Testphase nach der Account-Erstellung.
  </Accordion>

  <Accordion title="Wie lange kann ich anny kostenlos testen?">
    Nach der Account-Erstellung gilt eine **5-tägige** Testphase mit allen Features ohne Kosten. Wechselt du danach auf Essential oder Professional, gilt für den Plan eine **14-tägige** Testphase. Starter, Business und Enterprise haben keine Plan-Testphase.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich kann kein Upgrade durchführen">
    Prüfe, ob deine Zahlungsmethode hinterlegt und gültig ist. Ohne aktive Zahlungsmethode kann kein kostenpflichtiger Plan aktiviert werden.
  </Accordion>

  <Accordion title="Mein Downgrade wurde nicht übernommen">
    Ein Downgrade wird erst zum Ende der aktuellen Abrechnungsperiode wirksam. Unter Abo & Abrechnung siehst du den Status "Geplant", bis der Wechsel greift.
  </Accordion>

  <Accordion title="Nach dem Planwechsel fehlen Features">
    Wenn du in einen kleineren Plan gewechselt hast, sind Features aus dem höheren Plan nicht mehr verfügbar. Prüfe die Planübersicht oben und führe bei Bedarf ein Upgrade durch.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Starter (`starter-v2`): dauerhaft kostenlos, Default-Plan, `trial_period` 0. Quotas: 5 Ressourcen, 5 Services/Buchungsoptionen, 100 Buchungen/Monat. Zahlungsgebühren 0,40 € + 5 %.
> * Zwei Testmechanismen: (1) Organisations-Testphase nach Account-Erstellung: alle Features ohne Kosten, produktseitig **5 Tage**. Code-Default `PLATFORM_DEFAULT_TESTING_DAYS` ist 4, nicht an Kund:innen als 4 kommunizieren.
> * (2) Plan-Trial: Essential und Professional **14 Tage** (`trial_period`). Starter, Business, Enterprise: 0.
> * UI: Avatar → **Abo & Abrechnung**. Banner **Testphase: n Tage**.
> * Alte Texte mit 7 Tagen Testphase sind falsch.


# Attribute Mapping
Source: https://docs.anny.co/attribute-mapping



Das Attribute Mapping ist nur in Kombination mit einem aktiven Single-Sign-On (SSO) möglich. Nach der Aktivierung des SSO können gewünschte Attribute/ Gruppe über die SSO Anwendung (z.B. Entra ID, Shibboleth, SAML2) freigegeben werden. Bei der Anmeldung des User erhalten wir dann zusätzlich zum Namen und Mailadresse noch die Angabe zum Attribute.

Beispiele: Attribute: Department 01, Gruppe: IT-DEV, Status: Student / Staff

Teste, welche Attribute und Gruppen über deine SSO Anmeldung mitgegeben werden, dies kannst du unter [*SSO & Sicherheit*](https://app.anny.co/organization/settings/sso?o=) *- Meine Attributdaten laden* einsehen.

# Was ist Attribute Mapping?

Durch das Attribute Mapping kannst du Benutzer-Eigenschaften aus deinem IDP (Usermanagement) zu anny Communities zuweisen. So können Mitglieder automatisch (Auto-Join) in die jeweiligen internen Buchungsbereiche (Communities) zugeordnet werden. Außerdem kannst du Profildaten wie Firma oder Abteilung und deine [eigenen Kundendaten](#eigene-kundendaten-befüllen) automatisch aus dem IDP befüllen.

**Wo nehme ich die Einstellung vor?**

1. Klicke hierzu auf deine **Account-Einstellungen**
2. Wähle den Punkt ***SSO & Sicherheit*** aus
3. Scroll runter zu ***Attribute Mapping***
4. Klicke auf ***Attribut zuordnen***

Du kannst diese Attribute zuordnen, am meisten wird die Zuordnung zur Community verwendet:

* Communities
* Rollen
* Profilbild
* Sprache
* Anmeldung erlaubt
* Identifikator
* Email
* Nachname
* Vorname
* Anzeigename
* Firma
* Titel
* Berufsbezeichnung
* Abteilung
* deine Felder unter **Eigene Kundendaten**, z.B. **Eigene Kundendaten: Personalnummer**

![Attribute Mapping Übersicht](https://downloads.intercomcdn.eu/i/o/niegcmk9/65658098/5da1ec4e09d062591f7cb8487671/SCR-20250919-kgsx.png?expires=1784813400\&signature=bda10c40857823648185294eef4fff9d7c3d6770d5c41df7aa158cbe9dc5bd93\&req=1tBpwFD6pT9k2hL085ZhoafkGK8xoK5aheyceWhdHfmXcFwmEqmYml5LFQ0t%0A9Ls3q8AIZTAfySfH%0A)

## Regel erstellen

1. Klicke auf Attribute Mapping und wähle Community aus
2. Klicke auf Regel, um eine neue Regel zu erstellen
3. Trage in die Bedingung den Wert der Gruppe oder des Attributes ein und lege die Community fest, zu welche die User hinzugefügt werden sollen Beispiel M365 Entra ID-Gruppen: Wenn [http://schemas.microsoft.com/......../identity/claims/\*\*groups](http://schemas.microsoft.com/......../identity/claims/**groups)\*\* enthält (Array): **gruppe\_dev** Dann anny Community **Dev Team Office** Beispiel Shibboleth: Wenn: **urn:oid:xxxx** enthält (Array): **Student** Dann anny Community **Studierende Wave University**
4. Speichere deine Eingaben

<Warning>
  Die Eingabe der Werte für Gruppen Bezeichnungen und Wert ist case sensitiv und muss exakt der Schreibweise entsprechen, die von dem IDP übergeben wird. Die genaue Schreibweise kann unter 'Meine Attributedaten laden' eingesehen werden.
</Warning>

Gibt es **mehrere Werte,** die zu einer bestimmten Personengruppe gehören? Das **System durchläuft alle Regeln**. Immer wenn eine Regel zutrifft, wird dieser Wert übernommen.

<AccordionGroup>
  <Accordion title="Beispiel Unternehmen">
    Eine Person gehört einer Abteilung (z.B. Sales) innerhalb eines Unternehmens an. Sie soll daher als Nutzer:in bei anny automatisch in die Community "Sales and Marketing", "Retail" und auch "Company" hinzugefügt werden.
  </Accordion>

  <Accordion title="Beispiel Universität">
    Eine Person gehört einem bestimmten Studiengang (z.B. Lehramt Philosophie) innerhalb einer Hochschule an. Sie soll daher als Nutzer:in bei anny automatisch in die Community "Lehramt Philosophie", aber auch in die Community "Philosophische Fakultät" und "Hochschule Teststadt" hinzugefügt werden.
  </Accordion>
</AccordionGroup>

![Regel Beispiel](https://downloads.intercomcdn.eu/i/o/3054005/1505363c191d0ba34aa62888/liad.png?expires=1784813400\&signature=67b7d817bb64f8eebf3f79cb5d3e226c9f6716b70d10f63f2d6e6c585dccebfb\&req=09VqwVj6qXsp0xr0v9tnrjNBr9YDj3Tb67qpq5K8j70YxWtDzrNqnOLT4MUQ%0ANPiFP5VwiedljlI%3D%0A)

## Alle User deines Unternehmens (SSO) hinzufügen

Erstelle eine neue Regel zum Community Mapping und lösche als nächstes die Bedingung. Wähle die gewünschte Community aus, zu der alle User deines Unternehmens zugeordnet werden sollen.

![Alle User hinzufügen](https://downloads.intercomcdn.eu/i/o/11354975/5af9cdb4276c591a47318f1c/chrome-capture-2024-2-11.gif?expires=1784813400\&signature=df2e8335119fd072dbe1604fe3b2d1713b2886a6037b3bad5be7b35e952652e2\&req=0dRswFzzqzJk2hL085ZhoavwFlgBjEn3V0Q2IPnm90a7GWUkeWQm%2FN2j55OH%0AlQi%2FOTVepD9CHI%2BL%0A)

Nun werden alle User deines SSO ohne Filter zu der gewünschten Community hinzugefügt.

## Eigene Kundendaten befüllen

Mit dem Attribute Mapping kannst du auch die Felder deiner **Eigenen Kundendaten** aus dem IDP befüllen, z.B. eine Personalnummer, eine Kostenstelle oder einen Standort.

Voraussetzung: Das Feld ist in den [Account-Einstellungen](/account-settings) unter **Allgemein** → **Eigene Datenfelder** → **Eigene Kundendaten** angelegt.

<Steps>
  <Step title="Feld auswählen">
    Klicke unter ***Attribute Mapping*** auf ***Attribut zuordnen*** und wähle **Eigene Kundendaten: *Feldname***.
  </Step>

  <Step title="Regel festlegen">
    Die Regel liest standardmäßig ein **Attribut** aus. Trage den Namen ein, unter dem dein IDP den Wert überträgt, z.B. `employeeNumber`. Wie bei den Communities kannst du Bedingungen ergänzen oder mit **Explizit** einen festen Wert setzen.
  </Step>

  <Step title="Übernehmen">
    Klicke auf ***Anwenden*** und danach auf ***Speichern***.
  </Step>
</Steps>

Bei jeder Anmeldung über SSO überträgt anny den Wert in die Kundendaten des Users in deiner Organisation. Du siehst ihn im Kundenprofil. Ist der User noch kein Kunde deiner Organisation, wird der Wert beim ersten Checkout vorausgefüllt. Wenn du ein Mapping speicherst, wendet anny es auch auf bereits bekannte SSO-User an, mit den Attributen ihrer letzten Anmeldung.

* **Leere Werte** überschreiben keine vorhandenen Daten. Liefert der IDP nichts, bleibt der bisherige Wert stehen.
* **Auswahlfelder:** Der Wert muss genau einer Option des Feldes entsprechen. Weicht die Schreibweise im IDP ab, setze den passenden Wert mit einer Bedingung und **Explizit**.
* **Mehrfachauswahl:** Liefert der IDP mehrere Werte (z.B. Gruppen), werden alle übernommen.
* Felder vom Typ **Datei hochladen** stehen nicht zur Auswahl, weil ein IDP keine Dateien überträgt.
* Benennst du ein Feld um, bleibt das Mapping bestehen. Löschst du ein Feld, erscheint das Mapping als **Gelöschtes Kundendatenfeld**. Entferne es dann.

## Technische Daten der Zuordnung

| Begriff | Erklärung | Beispiel |
| - | - | - |
| Ist gleich | Eine exakte Übereinstimmung von Werten zwischen zwei Elementen oder Attributen. | Wenn der Name "John" genau mit "John" übereinstimmt. |
| Ist nicht gleich | Die Werte zweier Elemente oder Attribute sind nicht identisch. | |
| Ist leer | Ein bestimmtes Attribut oder eine Gruppe hat keinen zugewiesenen oder vorhandenen Wert. | Wenn das Attribut "Team" keinen Wert hat. |
| Ist nicht leer | Ein bestimmtes Attribut oder eine Gruppe hat einen zugewiesenen oder vorhandenen Wert. | |
| Enthält (String) | Eine bestimmte Zeichenfolge (String) ist in einem größeren Textfeld oder einer größeren Zeichenkette vorhanden. | Wenn das Wort "Sales" in "Marketing Operations and Sales Team Analytics" enthalten ist. |
| Enthält nicht (String) | Eine bestimmte Zeichenfolge (String) ist nicht in einem größeren Textfeld oder einer größeren Zeichenkette vorhanden. | |
| Enthält (Array) | Ein spezifisches Element oder ein spezifischer Wert ist in einem Array (einer geordneten Gruppe oder Liste von Werten) vorhanden. | Wenn die Nummer "3" in dem Array \[1,2,3,4,5] enthalten ist. |
| Enthält nicht (Array) | Ein spezifisches Element oder ein spezifischer Wert ist nicht in einem Array (einer geordneten Gruppe oder Liste von Werten) vorhanden. | |

<Tip>
  **Pro Tipp:** Wenn es Nutzer gibt, die mehreren Gruppen in M365 angehören, handelt es sich bei dem ***Attribut*** ***Gruppe*** um ein ***Array,*** das bedeutet, dass der Operator "***enthält (Array)***" anstelle von "***ist gleich"*** verwendet werden soll.
</Tip>


# Verfügbare Termine
Source: https://docs.anny.co/available-slots

Erstelle einzelne buchbare Zeitfenster für Events, Kurse oder Workshops mit optionaler Wiederholung.

Verfügbare Termine sind konkrete, einzelne Zeitfenster, die du für eine Ressource anlegst. Sie eignen sich für Angebote mit festem Datum und Uhrzeit: Kurse, Workshops, Events oder Sprechstunden. Im Unterschied zu Zeitplänen definieren sie keine wiederkehrenden Öffnungszeiten, sondern gezielte Buchungsgelegenheiten.

<Info>
  Jede Ressource benötigt mindestens einen verbundenen Zeitplan oder einen verfügbaren Termin, damit sie auf der Buchungsseite angezeigt wird.
</Info>

## Wie funktionieren Verfügbare Termine?

Ein verfügbarer Termin besteht aus einem konkreten Datum mit Start- und Endzeit. Optional kannst du einen Termin als **wiederkehrend** konfigurieren, damit anny ihn automatisch in einem definierten Rhythmus (z. B. wöchentlich) anlegt.

Über den Reiter **Einstellungen** eines Termins konfigurierst du erweiterte Optionen wie Mindestteilnehmeranzahl, Stornierungsdeadline und bereitgestellte Ressourcen.

Verfügbare Termine erscheinen auf der Buchungsseite als auswählbare Slots. Kund:innen buchen den gesamten Termin (nicht Teilabschnitte daraus).

## Wann nutze ich das?

* **Du bietest Kurse, Workshops oder Events mit festen Terminen an**: Jeder Termin ist ein eigener buchbarer Slot mit konkretem Datum.
* **Du möchtest Sprechstunden oder Beratungstermine an bestimmten Tagen anbieten**: Lege gezielt Termine an den gewünschten Tagen an.
* **Du brauchst eine Mindestteilnehmeranzahl pro Termin**: Konfiguriere die Mindestanzahl in den Termin-Einstellungen.
* **Nicht geeignet für**: Regelmäßige, wiederkehrende Öffnungszeiten ohne festes Enddatum. Nutze dafür [Zeitpläne](/schedules).

## Zusammenhang mit anderen Features

* **[Buchungsserien](/booking-series):** Verknüpfe mehrere verfügbare Termine zu einer Serie, die Kund:innen als Paket buchen.
* **[Dynamische Kapazitätsplanung](/dynamic-capacity-planning):** Nutze On-Demand Ressourcen, um die Kapazität von Terminen automatisch an die Nachfrage anzupassen.
* **[Smart Availability](/smart-availability):** Verbinde Ressourcen, damit bei einer Terminbuchung automatisch abhängige Ressourcen blockiert werden.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Datum | Konkretes Datum des Termins |
| Start-/Endzeit | Zeitfenster des Termins |
| Wiederkehrend | Automatische Wiederholung (z. B. wöchentlich) |
| Mindestteilnehmeranzahl | Mindestbuchungen für Durchführung |
| Stornierungsdeadline | Frist für kostenlose Stornierung |
| Bereitgestellte Ressourcen | Zusätzliche Ressourcen (z. B. Raum, Trainer:in) |

<Tip>
  Nutze die Option **Wiederkehrend**, um Serientermine (z. B. wöchentlicher Yogakurs) automatisch anlegen zu lassen, statt jeden Termin einzeln zu erstellen.
</Tip>

## Verfügbaren Termin erstellen

<Steps>
  <Step title="Ressource öffnen">
    Öffne die gewünschte Ressource unter **Ressourcen** und navigiere zum Reiter **Verfügbarkeit**.
  </Step>

  <Step title="Termin hinzufügen">
    Klicke auf **+ Verfügbaren Termin hinzufügen**.
  </Step>

  <Step title="Datum und Uhrzeit festlegen">
    Wähle das gewünschte Datum sowie Start- und Endzeit für den Termin.
  </Step>

  <Step title="Wiederkehrend aktivieren (optional)">
    Aktiviere **Wiederkehrend**, um den Termin automatisch mehrfach anzulegen (z. B. wöchentlich).
  </Step>

  <Step title="Einstellungen konfigurieren (optional)">
    Wechsle zum Reiter **Einstellungen**. Hier kannst du eine Mindestteilnehmeranzahl, eine **Stornierungsdeadline** und **Bereitgestellte Ressourcen** (z. B. Studio oder Trainer:in) festlegen.
  </Step>

  <Step title="Speichern">
    Bestätige deine Angaben mit **Speichern**.
  </Step>
</Steps>

Sobald der Termin gespeichert ist, erscheint er in der Liste **Verfügbare Termine** der Ressource und kann als ganzer Slot gebucht werden.

<Frame>
  <img alt="Liste Verfügbare Termine mit dem Button Verfügbaren Termin hinzufügen, der das Formular Verfügbaren Termin erstellen für den Morning Barre Kurs auf der Ressource Barre Course öffnet" />
</Frame>

Unter **Einstellungen** verbindest du über **Bereitgestellte Ressourcen** Räume oder Personen, die für diesen Termin blockiert werden sollen. Klicke auf **+** neben einer Ressource oder ziehe sie in die Ablagefläche. anny erstellt automatisch einen Blocker. Die Ressource kann zusätzlich im Buchungskalender angezeigt werden, zum Beispiel Studio und Trainer:in eines Kurses.

<Frame>
  <img alt="Reiter Einstellungen im Dialog Verfügbaren Termin erstellen mit Bereitgestellte Ressourcen, wo du Raum oder Trainer:in per Plus-Button hinzufügst" />
</Frame>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Yoga-Studio legt wöchentlich wiederkehrende Kurstermine an">
    Ein Yoga-Studio bietet jeden Dienstag von 18:00 bis 19:30 Uhr einen Vinyasa-Kurs an. Der Kurs hat maximal 15 Plätze.

    <Steps>
      <Step title="Ressource öffnen">
        Öffne die Ressource (z. B. "Yogaraum") unter **Ressourcen** → **Verfügbarkeit**.
      </Step>

      <Step title="Termin anlegen">
        Klicke auf **+ Verfügbaren Termin hinzufügen**. Wähle den nächsten Dienstag, 18:00 bis 19:30 Uhr.
      </Step>

      <Step title="Wiederholung aktivieren">
        Aktiviere **Wiederkehrend** und wähle "Wöchentlich". anny legt den Termin automatisch für kommende Dienstage an.
      </Step>

      <Step title="Kapazität prüfen">
        Stelle sicher, dass die Buchungsoption die gewünschte Teilnehmeranzahl (15) als maximale Kapazität erlaubt.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Ein Workshop-Anbieter erstellt einmalige Eventtermine mit Mindestteilnehmerzahl">
    Ein Anbieter plant einen Fotografie-Workshop am 15. September von 10:00 bis 16:00 Uhr. Der Workshop findet nur bei mindestens 5 Anmeldungen statt.

    <Steps>
      <Step title="Ressource öffnen">
        Öffne die Ressource (z. B. "Studio A") unter **Ressourcen** → **Verfügbarkeit**.
      </Step>

      <Step title="Termin anlegen">
        Klicke auf **+ Verfügbaren Termin hinzufügen**. Wähle den 15. September, 10:00 bis 16:00 Uhr. Lasse **Wiederkehrend** deaktiviert.
      </Step>

      <Step title="Mindestteilnehmeranzahl konfigurieren">
        Wechsle zum Reiter **Einstellungen** und trage bei **Mindestteilnehmeranzahl** den Wert 5 ein. Speichere den Termin.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Zeitplänen und verfügbaren Terminen?">
    Zeitpläne definieren regelmäßige, wiederkehrende Öffnungszeiten (z. B. werktags 9 bis 18 Uhr). Verfügbare Termine sind einzelne, konkrete Zeitfenster für einmalige oder serielle Angebote wie Kurse oder Workshops.
  </Accordion>

  <Accordion title="Kann ich einen verfügbaren Termin nachträglich bearbeiten?">
    Ja. Öffne den Termin im Reiter **Verfügbarkeit** der Ressource und passe Datum, Uhrzeit oder Einstellungen an. Bereits bestehende Buchungen bleiben erhalten.
  </Accordion>

  <Accordion title="Was passiert, wenn die Mindestteilnehmeranzahl nicht erreicht wird?">
    Der Termin bleibt buchbar, aber du erhältst eine Information, dass die Mindestanzahl nicht erreicht ist. Die Durchführungsentscheidung liegt bei dir.
  </Accordion>

  <Accordion title="Kann ich Zeitpläne und verfügbare Termine für dieselbe Ressource kombinieren?">
    Ja. Eine Ressource kann gleichzeitig verbundene Zeitpläne und verfügbare Termine haben. Beide erzeugen buchbare Slots unabhängig voneinander.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Verfügbare Termine erscheinen nicht auf der Buchungsseite">
    Stelle sicher, dass das Datum des Termins in der Zukunft liegt und die zugehörige Buchungsoption aktiv ist. Prüfe außerdem, ob die verfügbare Anzahl größer als 0 ist.
  </Accordion>

  <Accordion title="Die Wiederholung erzeugt keine neuen Termine">
    Prüfe, ob ein Enddatum für die Wiederholung gesetzt ist und ob dieses bereits erreicht wurde. Ohne Enddatum erzeugt anny Termine fortlaufend.
  </Accordion>

  <Accordion title="Die Mindestteilnehmeranzahl wird nicht angezeigt">
    Die Mindestteilnehmeranzahl wird im Reiter **Einstellungen** des verfügbaren Termins konfiguriert, nicht in der Buchungsoption.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> Terminologie: "Terminverfügbarkeiten" = Verfügbare Termine (einmalig oder wiederkehrend mit konkretem Datum). Nicht verwechseln mit "Zeitplänen" (regelmäßige wochentägliche Öffnungszeiten) oder "Service-Zeitplänen" (buchungsoptionsspezifische Einschränkung).
>
> UI-Pfad: Ressource → Reiter "Verfügbarkeit" → Bereich "Verfügbare Termine" (unten) → "+ Verfügbaren Termin hinzufügen" → Dialog "Verfügbaren Termin erstellen".
>
> Wiederholungslogik: "Wiederkehrend" bei verfügbaren Terminen erzeugt automatisch neue Termin-Instanzen im gewählten Rhythmus. Jede Instanz ist ein eigenständiger buchbarer Slot.
>
> Bereitgestellte Ressourcen: Im Dialog Verfügbaren Termin erstellen/bearbeiten unter dem Reiter Einstellungen (kein eigener Reiter). Label "Bereitgestellte Ressourcen"; hinzufügen per + oder Drag. Erzeugt einen Blocker. Nicht verwechseln mit Smart Availability (dynamische Verknüpfung auf Service-Ebene). Screenshot-Beispiel: Barre Course, Titel "Morning Barre", 24.08.2026 08:00–09:00, Kapazität 10.
>
> Verwandte Artikel: Zeitpläne → /schedules | Buchungsserien → /booking-series | Dynamische Kapazitätsplanung → /dynamic-capacity-planning | Smart Availability → /smart-availability


# Buchungspakete & Codes
Source: https://docs.anny.co/booking-codes

Erstelle käufliche Pakete und Gutscheine, die Kund:innen als 8-stelligen Buchungscode bei zukünftigen Buchungen einlösen können.

Mit Buchungspaketen bietest du deinen Kund:innen käufliche Leistungspakete an, die sie später per Buchungscode bei einer Buchung einlösen. Ein Buchungspaket ist zweckgebunden: Es enthält ein konkretes Kontingent (z. B. 10 Buchungen für einen bestimmten Kurs) und die Umsatzsteuer wird beim Kauf ausgewiesen — steuerlich ist das typischerweise ein [Einzweckgutschein](/voucher-taxation). So generierst du Vorabeinnahmen und bindest Kund:innen langfristig.

<Info>
  * Verfügbar ab dem Professional-Plan.
  * Aktiviere vorab das Feature **Buchungspakete** unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktioniert das Konzept?

Ein Buchungspaket ist ein konkretes Leistungskontingent mit festem Preis. Die Umsatzsteuer wird direkt beim Kauf des Pakets ausgewiesen. Das spätere Einlösen des Codes funktioniert technisch als Preisreduzierung (Rabatt) auf die gebuchte Leistung.

Der Ablauf:

1. Du erstellst ein Buchungspaket mit Preis, Beschreibung und verknüpftem Kontingent.
2. Kund:innen kaufen das Paket auf deiner Buchungsseite (Reiter **Pakete & Gutscheine**).
3. Kund:innen erhalten einen **8-stelligen Buchungscode**.
4. Bei zukünftigen Buchungen geben sie den Code im Checkout ein und der Preis wird reduziert.

<Tip>
  Mit `default-list="packages"` kannst du auf eigenen Webseiten die Buchungspakete als Standardreiter einbetten, unabhängig von den Account-Einstellungen.
</Tip>

## Wann nutze ich das?

* **Du verkaufst Mehrfachkarten** (z. B. 10er-Karte für Kurse): Erstelle ein Buchungspaket mit Mengen-Kontingent.
* **Du möchtest Vorabeinnahmen erzielen und Kund:innen binden**: Pakete mit vergünstigtem Gesamtpreis motivieren zum Kauf.
* **Du willst physische Gutscheinkarten verkaufen**: Nutze den Versandmodus, um Pakete per Post zuzustellen.
* **Nicht geeignet für**: Wiederkehrende Zahlungen (nutze Abos), flexible Geldwert-Gutscheine ohne Zweckbindung (nutze Wertgutscheine) oder reine Preisnachlässe (nutze Rabattcodes).

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Buchungskontingente | Jedes Buchungspaket ist mit einem Kontingent verknüpft, das beim Einlösen verbraucht wird. |
| Rechtliche Dokumente | Dokumente können dem Paket hinzugefügt werden, die im Checkout akzeptiert/unterschrieben werden müssen. |
| Wiederkehrende Buchungen | Jeder Serientermin verbraucht das Paket-Kontingent einzeln. Stornierte Termine werden seit Juli 2026 korrekt zurückerstattet. |

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Name & Beschreibung | Titel und Erklärungstext für die Buchungsseite |
| Preis | Festpreis inkl. Steuersatz |
| Steuersatz | Regulärer Satz (wird beim Kauf ausgewiesen) |
| Verfallsdatum | Gültigkeit des Codes in **Tagen** oder **Jahren** (Standard: 730 Tage). Optional **Gültig bis Jahresende**: der Code gilt dann bis zum 31. Dezember des Jahres, in dem der Zeitraum endet (Beispiel: 1. März 2025 und 3 Jahre → 31. Dezember 2028). |
| Buchungskontingent | Verknüpftes Kontingent, das beim Einlösen verbraucht wird |
| Gruppe | Optional. Gliedert Pakete in der Admin-Liste und auf der Buchungsseite |
| Dokumentvorlage | Dokument, das beim Kauf an Kund:innen gesendet wird |
| Vor-Ort-Dokumentvorlage | Zweites Template nur für Admin-Zwecke (z. B. Ausdruck) |
| Lieferadresse anbieten | Abweichende Lieferadresse im Checkout abfragen |
| Geschäftsadresse anbieten | Geschäftsadresse im Checkout abfragen |
| Versand | Deaktiviert, Optional oder Immer |
| Live/Entwurf | Sichtbarkeit auf der Buchungsseite |

Auf der Buchungsseite sehen Kund:innen den Reiter **Pakete & Gutscheine**, auf dem sie Pakete erwerben können. Mehrere Pakete gliederst du über das Feld **Gruppe** im Paketformular. Das sind eigene **Buchungspaket-Gruppen**, unabhängig von den Gruppen bei Services. Auf der Buchungsseite erscheinen nur Gruppen mit mindestens einem Live-Paket. Pakete ohne Gruppe stehen dort im Abschnitt **Andere**. Löschst du eine Gruppe, bleiben die Pakete erhalten; auf der Buchungsseite rutschen sie nach **Andere**. Die Listen dafür pflegst du unter [Gruppen](/groups-and-categories).

## Buchungspaket erstellen

<Steps>
  <Step title="Buchungspakete öffnen">
    Öffne **Buchungspakete** in der Menüleiste links. Über das Suchfeld **Suchen** filterst du die Paketübersicht. Während einer Suche mit mindestens drei Zeichen ist das Umsortieren per Drag-and-Drop deaktiviert.
  </Step>

  <Step title="Neues Paket anlegen">
    Klicke oben rechts auf **Neu+** und vergib einen Namen.
  </Step>

  <Step title="Modus Buchungspaket wählen">
    Wähle den Tab **Buchungspaket** (zweckgebunden).
  </Step>

  <Step title="Details konfigurieren">
    Füge Preis, Verfallsdatum (Tage oder Jahre, optional **Gültig bis Jahresende**), Steuersatz und Beschreibung hinzu.
  </Step>

  <Step title="Kontingent verknüpfen">
    Verknüpfe ein bestehendes Buchungskontingent oder erstelle direkt ein neues unter **Buchungskontingente** → **Neu+**.
  </Step>

  <Step title="Optional einer Gruppe zuweisen">
    Im Feld **Gruppe** wählst du eine bestehende Buchungspaket-Gruppe oder tippst einen neuen Namen, um eine Gruppe anzulegen.
  </Step>

  <Step title="Dokumente und Versand (optional)">
    Füge eine Dokumentvorlage hinzu und konfiguriere bei Bedarf den Versandmodus und die Lieferadresse.
  </Step>

  <Step title="Live schalten">
    Setze das Paket über den **Live-Toggle** oben rechts auf aktiv. Es erscheint jetzt auf deiner Buchungsseite.
  </Step>
</Steps>

## Buchungscode manuell erstellen

Du kannst Buchungscodes auch direkt im Admin-Bereich ausstellen, z. B. für Bestandskund:innen oder Vor-Ort-Verkäufe.

<Steps>
  <Step title="Buchungscodes öffnen">
    Öffne **Buchungscodes** in der Menüleiste links.
  </Step>

  <Step title="Neuen Code erstellen">
    Klicke auf **Neu+** und wähle das gewünschte Buchungspaket aus.
  </Step>

  <Step title="Kunden zuweisen (optional)">
    Hinterlege eine:n Kund:in für den Code. Anonyme Codes ohne Kundenzuweisung sind ebenfalls möglich.
  </Step>

  <Step title="Rechnungsoptionen wählen">
    Entscheide: **Rechnung fertigstellen** (Kunde zahlt online), **Bereits bezahlt** (Vor-Ort-Zahlung), oder **ohne Rechnung** (Entwurf).
  </Step>

  <Step title="Gültigkeit anpassen">
    Passe bei Bedarf das Ablaufdatum an (Standard: 730 Tage oder Paket-Gültigkeit).
  </Step>

  <Step title="Speichern">
    Der 8-stellige Code wird erstellt und in der Übersicht gelistet. Er kann exportiert oder gefiltert werden.
  </Step>
</Steps>

<Tip>
  Deaktiviere vor dem Speichern die Benachrichtigungs-Glocke, wenn der Kunde nicht per E-Mail über den neuen Code informiert werden soll.
</Tip>

## Versandmodus konfigurieren

Wenn du Buchungspakete als physische Karte oder Brief versenden möchtest, kannst du pro Paket einen Versandmodus einstellen:

| Modus | Verhalten |
| - | - |
| Deaktiviert | Kein Versand, rein digitale Zustellung |
| Optional | Kund:innen wählen im Checkout, ob Versand gewünscht ist |
| Immer | Versand ist verpflichtend, Versandkosten werden automatisch addiert |

Zusätzlich kannst du einen Versandkostenbetrag hinterlegen, der zum Paketpreis addiert wird. Im Admin-Bereich siehst du, welche Pakete noch versendet werden müssen, und kannst sie nach dem Versand als **versendet** markieren.

## Lieferadresse und Geschäftsadresse

Mit den Toggles **Lieferadresse anbieten** und **Geschäftsadresse anbieten** kannst du im Checkout zusätzliche Adressfelder abfragen. Das ist besonders nützlich, wenn die Standardadresse nicht der tatsächlichen Zustelladresse entspricht (z. B. bei Equipment-Versand ins Homeoffice).

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Massagestudio verkauft eine 10er-Karte">
    Ein Studio möchte 10 Massagen als vergünstigtes Paket anbieten. Kund:innen kaufen die Karte online und lösen sie bei jeder Buchung ein.

    <Steps>
      <Step title="Kontingent erstellen">
        Öffne **Buchungspakete** → **Buchungskontingente** → **Neu+**. Wähle Typ **Menge**, Wert **10**, Modus **Einmalig**. Begrenze auf deine Massage-Services.
      </Step>

      <Step title="Buchungspaket erstellen">
        Erstelle unter **Buchungspakete** → **Neu+** ein Paket im Tab **Buchungspaket**. Setze den Preis (z. B. 450 Euro statt 500 Euro Einzelpreis).
      </Step>

      <Step title="Kontingent verknüpfen">
        Verknüpfe das soeben erstellte 10er-Kontingent mit dem Paket.
      </Step>

      <Step title="Steuersatz setzen">
        Wähle den regulären Steuersatz (z. B. 19 %). Die USt. wird direkt auf der Kaufrechnung ausgewiesen.
      </Step>

      <Step title="Live schalten">
        Aktiviere den Live-Toggle. Kund:innen können das Paket auf deiner Buchungsseite kaufen, erhalten einen Code und lösen ihn bei jeder Massagebuchung ein.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Coworking-Space verkauft 10er-Karten mit physischem Versand">
    Ein Coworking-Betreiber möchte Day-Pass-Pakete als Geschenkkarten per Post anbieten.

    <Steps>
      <Step title="Kontingent erstellen">
        Erstelle ein Mengen-Kontingent (Wert: 10), begrenzt auf die Day-Pass-Ressource.
      </Step>

      <Step title="Buchungspaket erstellen">
        Erstelle ein Paket mit Preis, verknüpfe das Kontingent und füge eine Dokumentvorlage für die Geschenkkarte hinzu.
      </Step>

      <Step title="Versand konfigurieren">
        Setze den Versandmodus auf **Optional** und hinterlege die Versandkosten (z. B. 2,90 Euro).
      </Step>

      <Step title="Lieferadresse aktivieren">
        Aktiviere **Lieferadresse anbieten**, damit Kund:innen eine abweichende Zustelladresse angeben können.
      </Step>

      <Step title="Live schalten und abwickeln">
        Aktiviere den Live-Toggle. Wenn eine Kund:in den Versand wählt, werden die Versandkosten addiert. Im Admin siehst du offene Sendungen und markierst sie nach Versand als erledigt.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Wie lange ist ein Buchungscode gültig?">
    Standard sind 730 Tage oder die im Paket konfigurierte Gültigkeit. Du wählst die Einheit **Tage** oder **Jahre**. Mit **Gültig bis Jahresende** läuft der Code am 31. Dezember des Endjahres ab, nicht am Kalendertag nach dem Zeitraum. Beim manuellen Erstellen eines Codes kannst du das Ablaufdatum zusätzlich anpassen.
  </Accordion>

  <Accordion title="Kann ich Codes ohne Kundenzuweisung erstellen?">
    Ja. Seit Juli 2026 können anonyme Codes ohne hinterlegten Kunden erstellt werden, z. B. für Sammelverkäufe oder Promotions.
  </Accordion>

  <Accordion title="Wo sehe ich alle verkauften Codes?">
    Unter **Buchungscodes** in der Menüleiste. Dort kannst du filtern, exportieren und den Einlösungsstatus einsehen.
  </Accordion>

  <Accordion title="Werden Versandkosten auf der Rechnung separat ausgewiesen?">
    Ja. Die Versandkosten erscheinen als eigene Position auf der Rechnung, zusätzlich zum Paketwert.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Buchungspaket und Wertgutschein?">
    Ein Buchungspaket ist zweckgebunden (konkretes Kontingent, USt. beim Kauf, Einlösung als Rabatt). Ein Wertgutschein ist ein Mehrzweckgutschein (reiner Geldwert, 0 % USt. beim Kauf). Mehr dazu im Artikel [Wertgutscheine](/value-vouchers), zur steuerlichen Einordnung unter [Gutscheine & Umsatzsteuer](/voucher-taxation).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kund:innen sehen den Reiter Pakete & Gutscheine nicht">
    Prüfe, ob mindestens ein Paket auf **Live** steht. Pakete im Entwurfsmodus werden auf der Buchungsseite nicht angezeigt.
  </Accordion>

  <Accordion title="Der Buchungscode wird im Checkout nicht akzeptiert">
    Prüfe: Ist das Verfallsdatum überschritten? Ist das verknüpfte Kontingent aufgebraucht? Gilt das Kontingent für die gewählte Ressource?
  </Accordion>

  <Accordion title="Importierte Buchungscodes lösen einen Fehler aus">
    Bei importierten Codes kann es vorkommen, dass die Verrechnung beim Einlösen fehlschlägt. Wende dich in diesem Fall an den Support mit Angabe des Paketnamens und des betroffenen Codes.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Buchungspakete. Plan: Professional. Aktivierung: Account-Einstellungen → Features → Buchungspakete.
> * UI-Pfad Pakete verwalten: **Buchungspakete** (Menüleiste links). Suchfeld **Suchen** (`common.actions.search`) filtert Name/Beschreibung; ab 3 Zeichen kein Drag-and-Drop.
> * UI-Pfad Codes verwalten: **Buchungscodes** (Menüleiste links).
> * Buchungspaket = zweckgebunden: USt. beim Kauf, Einlösung = Rabatt auf Buchungspreis.
> * Anonyme Codes (seit Juli 2026): Erstellung ohne Kundenpflicht möglich.
> * Zweites Dokument-Template (seit Juli 2026): Admin-only Dokument, z. B. für Vor-Ort-Ausdruck ("Vor-Ort-Dokumentvorlage").
> * Versandmodus (seit Juni 2026): Deaktiviert/Optional/Immer. Versandkosten werden addiert. Admin kann als "versendet" markieren.
> * Lieferadresse (seit Mai 2026): Toggle pro Paket, fragt abweichende Lieferadresse im Checkout ab.
> * Geschäftsadresse (seit Juli 2026): Toggle pro Paket, fragt Geschäftsadresse im Checkout ab.
> * Verfallsdatum: Feld **Verfallsdatum** (`expiry_period` + `expiry_period_unit` `day`/`year`, Default 730 Tage). Toggle **Gültig bis Jahresende** (`expiry_until_end_of_year`, Default aus): `endOfYear` nach dem addierten Zeitraum. Manuelle Codes erben dieselbe Berechnung.
> * Abgrenzung Wertgutscheine: Mehrzweckgutschein, 0 % USt. beim Kauf, Einlösung = Zahlungsmittel. Eigener Artikel.
> * Abgrenzung Rabattcodes: Prozentuale/absolute Preisnachlässe im Checkout OHNE Guthabenlogik.
> * Abgrenzung Abos: Abos = wiederkehrende Zahlungen. Buchungspakete = Einmalkauf.
> * Buchungsseite-Reiter: **Pakete & Gutscheine** (nicht „Buchungspakete“). Admin-Menü bleibt **Buchungspakete**.
> * Gruppen: Feld **Gruppe** im Paketformular. Eigene Buchungspaket-Gruppen, nicht dieselben wie Service-Gruppen. Ungrouped auf der Buchungsseite: Abschnitt **Andere**.


# Das Layout deiner Buchungsseite
Source: https://docs.anny.co/booking-page-layout



Deine Buchungsseite ist der erste Kontaktpunkt für deine Kund:innen. Mit den richtigen Einstellungen entscheidest du, welche Inhalte zuerst sichtbar sind, wie der Kalender dargestellt wird und welche Ressourcen angezeigt werden. Am Ende dieses Guides hast du die wichtigsten Layout-Einstellungen für deine Buchungsseite konfiguriert.

<Note>
  Es handelt sich hierbei um die anny Buchungsseite deiner Organisation, nicht um das Widget, welches auf deiner Website eingebettet werden kann.
</Note>

## Das Layout im anny-Kontext verstehen

Bevor du die Einstellungen anpasst, hilft es, zwei Bereiche in anny klar zu unterscheiden:

* **Admin-Bereich**: Hier konfigurierst du dein Konto, deine Ressourcen und deine Buchungsseite. Nur Personen mit Admin-Rechten haben Zugang.
* **Buchungsseite**: Das ist die öffentliche Seite, auf der deine Kund:innen Buchungen vornehmen. Sie spiegelt wider, was du im Admin-Bereich eingestellt hast.
* **Buchungsseite als Widget**: Das ist die Variante deiner Buchungsseite, die du direkt in deine eigene Website einbetten kannst. Inhaltlich zeigt sie dieselben Ressourcen und Buchungsoptionen. Der Unterschied liegt in der Darstellung und Integration.

| | <br />**Buchungsseite (anny)** | **Buchungsseite als Widget** |
| - | :- | :- |
| **Aufruf** | Über anny bzw. einen direkten Link | Eingebettet auf deiner eigenen Website |
| **Design** | Standard-Layout von anny | Eigenes Branding (Farben, Logo, Schriftarten) |
| **Anpassung** | Inhaltlich über den Admin-Bereich | Zusätzlich Design- und Darstellungseinstellungen |
| **Einsatzzweck** | Schnell startklar, ohne eigene Website | Nahtlose Integration in deinen Webauftritt |

## Was du am Ende eingerichtet hast

* Den Standard-Reiter deiner Buchungsseite festgelegt
* Die Standard-Kalenderansicht ausgewählt
* Die im Kalender angezeigten Ressourcen definiert

## Schritt-für-Schritt Anleitung

<Steps>
  <Step title="Account-Einstellungen öffnen">
    Klicke im Admin-Bereich oben rechts auf deinen **Avatar**. Wähle **Account-Einstellungen** aus dem Dropdown-Menü. Navigiere zum Reiter **Einstellungen**.

    <img alt="Image" />
  </Step>

  <Step title="Standard-Reiter der Buchungsseite festlegen">
    Für die Option **Standard Reiter auf Buchungsseite**. Hier wählst du aus, was Besucher:innen als erstes sehen, wenn sie deine Buchungsseite öffnen. Du hast vier Optionen:

    * **Ressourcen**: Zeigt buchbare Einheiten wie Räume, Plätze oder Equipment.
    * **Services**: Zeigt Leistungen, bei denen zuerst der Service gewählt wird (z. B. Beratung, Haarschnitt).
    * **Abonnements**: Zeigt verfügbare Abo-Pläne.
    * **Pakete & Gutscheine**: Zeigt Buchungspakete.

    Öffne das Dropdown-Menü bei **Standard Reiter auf Buchungsseite**. Wähle den Reiter, der für deine Kund:innen am relevantesten ist und speichere die Einstellung.

    <Note>
      Die Auswahl hier beeinflusst nur die Startansicht. Besucher:innen können jederzeit selbst zwischen den Reitern wechseln.
    </Note>
  </Step>

  <Step title="Standard-Kalenderansicht festlegen">
    Im selben Bereich findest du die Option **Standard-Kalenderansicht**. Sie legt fest, in welcher Ansicht der Kalender auf deiner Buchungsseite standardmäßig geöffnet wird. Du hast vier Ansichten zur Auswahl:

    * **Tag**: Stündliche Detailansicht eines einzelnen Tages. Geeignet, wenn viele Buchungen pro Tag stattfinden.
    * **Woche**: Übersicht über sieben Tage. Gut für Angebote mit regelmäßigem Wochenrhythmus.
    * **Monat**: Überblick über den gesamten Monat. Ideal für schnelle Orientierung und Vorausplanung.
    * **Board**: Chronologische Liste aller Termine untereinander, ohne Zeitachse. Jede Buchung wird vollständig angezeigt, unabhängig von ihrer Dauer. Besonders geeignet als Kursübersicht.

    Öffne das Dropdown-Menü bei **Standard-Kalenderansicht** und wähle die Ansicht, die zu deinem Angebot passt.

    <Tip>
      **Tipp**: Die Boardansicht eignet sich besonders gut, wenn du viele Kurse oder Events anbietest. Sie lässt sich außerdem als eingebetteter Kalender auf deiner eigenen Website nutzen. Mehr dazu: [Buchungsseite als Widget auf der Website einbetten](/embed-booking-page)
    </Tip>
  </Step>

  <Step title="Ressourcen im Kalender festlegen">
    Im Bereich **Ressourcen im Kalender anzeigen** legst du fest, welche Ressourcen auf deiner Buchungsseite im Kalender sichtbar sind.

    Du hast zwei Optionen:

    * **Alle Ressourcen anzeigen**: Alle vorhandenen Ressourcen werden uneingeschränkt im Kalender dargestellt.
    * **Ausgewählte Ressourcen anzeigen**: Du wählst manuell aus einer Liste, welche Ressourcen sichtbar sein sollen.

    Wenn du **Ausgewählte Ressourcen** wählst, öffnet sich eine Liste deiner Ressourcen. Setze einen Haken bei den Ressourcen, die im Kalender erscheinen sollen.<br /><br />So verhalten sich die Ansichten im Detail: 

    <AccordionGroup>
      <Accordion title="Wochenansicht">
        * Buchungen mit einer Dauer von 7 Stunden oder mehr werden oben im Kalender als **ganztägige Ereignisse** angezeigt. So bleibt das Stundenraster übersichtlich.
        * Bei vielen gleichzeitigen Buchungen werden maximal **2 parallele Buchungen** nebeneinander angezeigt. Weitere sind über **+X** erreichbar.
        * Es können bis zu **30 Ressourcen** gleichzeitig im Kalender dargestellt werden.

        ![Wochenansicht im Kalender](https://downloads.intercomcdn.eu/i/o/niegcmk9/137076982/de2e272b003e8747fe83b61dae5a/SCR-20260430-mhdg.png)
      </Accordion>

      <Accordion title="Boardansicht">
        * Termine erscheinen als chronologische Liste, ohne Zeitraster.
        * Jede Buchung wird vollständig angezeigt, unabhängig davon, wie lang sie dauert.
        * Besonders übersichtlich bei vielen Kursen oder Events mit unterschiedlichen Laufzeiten.

        ![Boardansicht im Kalender](https://downloads.intercomcdn.eu/i/o/niegcmk9/137077171/feb6ba99a5f0e34016865b74aa4f/image.png)
      </Accordion>
    </AccordionGroup>

    <Info>
      **Hinweis**: Diese Einstellung gilt für die Standardansicht der Buchungsseite. Besucher:innen können den Kalender auf der Buchungsseite zusätzlich per Filter individuell anpassen. Diese Filter werden pro Person gespeichert und beim nächsten Besuch wiederhergestellt.
    </Info>
  </Step>

  <Step title="Buchungsseite überprüfen">
    Sobald du alle Einstellungen getroffen hast, kannst du dir deine öffentliche Buchungsseite anzeigen lassen. Klicke im Admin-Bereich unten links auf **Buchungsseite**. Ein neuer Tab öffnet sich, mit der Buchungsseite, die so auch deine Kund:innen sehen.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich den Standard-Reiter jederzeit ändern?">
    Ja, du kannst die Einstellung jederzeit im Admin-Bereich unter **Avatar > Account-Einstellungen > Einstellungen** anpassen. Die Änderung ist sofort auf der Buchungsseite sichtbar.
  </Accordion>

  <Accordion title="Was passiert, wenn ich „Alle Ressourcen anzeigen“ wähle und später neue Ressourcen anlege?">
    Neue Ressourcen erscheinen automatisch im Kalender, sobald sie angelegt sind. Du musst die Einstellung nicht erneut anpassen.
  </Accordion>

  <Accordion title="Können meine Kund:innen die Kalenderansicht selbst wechseln?">
    Ja. Die Standard-Kalenderansicht ist nur die Voreinstellung. Besucher:innen können auf der Buchungsseite jederzeit zwischen Tag, Woche, Board und Monat wechseln.
  </Accordion>

  <Accordion title="Warum sehen verschiedene Besucher:innen unterschiedliche Ressourcen im Kalender?">
    Besucher:innen können den Kalender per Filter individuell anpassen. Diese Filter werden pro Person gespeichert. Deshalb kann die Ansicht von Person zu Person abweichen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich sehe nicht alle parallelen Buchungen im Kalender.">
    Das ist das erwartete Verhalten. In der Wochenansicht werden maximal 2 parallele Buchungen gleichzeitig angezeigt. Weitere Buchungen sind über **+X** erreichbar. So bleibt der Kalender auch bei hoher Auslastung lesbar.
  </Accordion>

  <Accordion title="Eine Buchung wird als ganztägig angezeigt, obwohl sie eine genaue Uhrzeit hat.">
    Buchungen mit einer Dauer von 7 Stunden oder mehr werden in der Wochenansicht automatisch oben als ganztägige Ereignisse gruppiert. Das ist kein Fehler, sondern eine bewusste Darstellungsentscheidung für mehr Übersichtlichkeit.
  </Accordion>

  <Accordion title="Meine Kolleg:in sieht andere Ressourcen im Kalender als ich.">
    Filter und Ansichten werden individuell pro Nutzer:in gespeichert. Jede Person kann den Kalender auf der Buchungsseite selbst anpassen. Die Admin-seitige Einstellung in den Account-Einstellungen legt nur die Standardansicht fest.
  </Accordion>

  <Accordion title="Eine Ressource, die ich in den Einstellungen ausgewählt habe, erscheint nicht im Kalender.">
    Prüfe, ob die Ressource aktiv und für den gewählten Zeitraum verfügbar ist.
  </Accordion>
</AccordionGroup>


# Buchungskontingente
Source: https://docs.anny.co/booking-quotas

Vergib Mengen, Zeitbudgets oder Geldbeträge als wiederverwendbare Kontingente an Kund:innen und steuere so den Zugang zu deinen Ressourcen.

Mit Buchungskontingenten steuerst du, wie viel eine Person buchen darf: als Menge (z. B. 10 Buchungen), als Dauer (z. B. 8 Stunden pro Monat) oder als monetäres Budget (z. B. 200 Euro). Kontingente werden Kund:innen zugewiesen und bei jeder Buchung automatisch verrechnet.

<Info>
  * Verfügbar ab dem Professional-Plan.
  * Aktiviere vorab das Feature **Buchungspakete** unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktioniert das Konzept?

Ein Buchungskontingent ist ein Guthaben, das einer Person zugeordnet wird. Bei jeder passenden Buchung wird das Guthaben automatisch reduziert. Kontingente können auf verschiedene Weisen an Kund:innen gelangen:

* **Manuell**: Du weist ein Kontingent direkt in der Kundendetailansicht zu.
* **Über ein Abo**: Das Kontingent wird automatisch erteilt, sobald eine Person einen Abo-Plan abonniert. Endet oder wird das Abo gekündigt, stellt anny keine weiteren Kontingente aus und zieht übrige zum Ablauf ein. Endet oder wird das Abo gekündigt, stellt anny keine weiteren Kontingente aus und zieht übrige zum Ablauf ein.
* **Über eine Community**: Alle Mitglieder einer Community erhalten das verknüpfte Kontingent.
* **Über ein Buchungspaket**: Kund:innen kaufen ein Paket (z. B. 10er-Karte) und erhalten einen Buchungscode mit verknüpftem Kontingent.

Beim Buchen sehen Kund:innen ihre verfügbaren Kontingente nach Auswahl von Datum und Zeitraum. Ein visueller Kreis zeigt verbrauchtes und verbleibendes Guthaben. Sind mehrere Kontingente vorhanden, können Kund:innen wählen, welches genutzt wird.

<Tip>
  Bei einer Bestellung wird immer das Kontingent verwendet, dessen Gültigkeitszeitraum das Datum der Buchung beinhaltet, nicht das Datum der Bestellung.
</Tip>

## Wann nutze ich das?

* **Du möchtest deinen Mitgliedern ein begrenztes Nutzungsrecht geben** (z. B. 5 Meetingraum-Stunden pro Monat im Coworking-Abo): Erstelle ein wiederkehrendes Dauer-Kontingent und verknüpfe es mit dem Abo-Plan.
* **Du verkaufst Mehrfachkarten** (z. B. 10er-Karte für Yoga): Erstelle ein einmaliges Mengen-Kontingent und verknüpfe es mit einem Buchungspaket.
* **Du willst ein Catering-Budget für Abteilungen begrenzen**: Erstelle ein wiederkehrendes Budget-Kontingent und verknüpfe es mit einer Community.
* **Nicht geeignet für**: Reine Rabatte ohne Guthabenlogik. Nutze dafür Rabattcodes.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Abos & Mitgliedschaften | Kontingente können direkt an einen Abo-Plan geknüpft und bei Verlängerung automatisch erneuert werden. Nach Ablauf oder Kündigung enden die Kontingente; Checkout wendet sie danach nicht mehr an. Nach Ablauf oder Kündigung enden die Kontingente; Checkout wendet sie danach nicht mehr an. |
| Communities | Kontingente werden allen Community-Mitgliedern automatisch zugewiesen. |
| Buchungspakete & Codes | Ein Buchungspaket verknüpft ein Kontingent mit einem käuflichen Code (z. B. 10er-Karte). |
| Wiederkehrende Buchungen | Jeder Termin einer Serie verbraucht das Kontingent separat. Stornierte Serientermine werden nicht mehr gegen das Kontingent gezählt. |
| Zusatzoptionen | Kontingente können auch für Add-ons genutzt werden. Add-ons von Drittanbietern zählen nicht gegen das Prepaid-Guthaben der Buchung. |

<Warning>
  Wenn Ressourcen als zusätzliche Ressource einer Buchungsoption hinzugefügt sind und ein Kontingent angewendet wird, greift dieses nur für die ursprüngliche Ressource. Die zusätzlichen Ressourcen werden nicht gegen das Kontingent verrechnet, es sei denn, es handelt sich um ein geldwertes Kontingent (Typ Budget).
</Warning>

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Typ: Menge | Anzahl Buchungen, unabhängig von Dauer/Preis |
| Typ: Dauer | Gesamtdauer in Minuten oder Tagen |
| Typ: Budget | Monetärer Gesamtwert |
| Einmalig | Wird einmal zugeteilt und nicht erneuert |
| Wiederkehrend | Wird automatisch pro Zeitraum erneuert |
| Erneuerungsintervall | Tage, Wochen, Monate oder Jahre |
| Begrenzung | Nutzung einschränkbar auf Kategorie, Gruppe, Ressource oder Service |

Auf der Buchungsseite sehen Kund:innen nach der Datumsauswahl ihre verfügbaren Kontingente und können bei mehreren Kontingenten das gewünschte auswählen.

<Warning>
  Ein Kontingent kann nach dem Speichern nicht von einmalig auf wiederkehrend (oder umgekehrt) geändert werden. Erstelle in diesem Fall ein neues Kontingent.
</Warning>

<Tip>
  Wenn du den Wert eines wiederkehrenden Kontingents anpasst, kannst du bestimmen, ob alle bisher ausgestellten Kontingente von der Änderung betroffen sein sollen. Wiederkehrende Kontingente werden für die nächsten 12 Monate ausgestellt.
</Tip>

## Kontingente in der Kundenübersicht

Alle Kontingente eines Kunden findest du in der Detailansicht unter **Kunden** → Kunde auswählen → **Buchungskontingente**. Dort siehst du Gültigkeitsdaten, Ausschöpfung und Erteilung (für wiederkehrende Kontingente gibt es für jeden Zeitraum bis in 12 Monaten einen Eintrag).

Mit **Neu+** kannst du individuelle Kontingente direkt für einen Kunden erstellen. Bestehende Kontingente lassen sich über die **drei Punkte** widerrufen oder im Wert bearbeiten.

## Kontingente als Zugangsbeschränkung

Unter **Ressource** → **Einstellungen** → **Verifizierung & Zugang** oder **Buchungsoption** → **Bearbeiten** → **Zugang** kannst du Ressourcen und Services so konfigurieren, dass sie ausschließlich mit Kontingent buchbar sind.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Yoga-Studio verkauft eine 10er-Karte">
    Ein Studio bietet einen Yoga-Kurs an. Kund:innen sollen flexibel 10 Teilnahmen nutzen können.

    <Steps>
      <Step title="Kontingent erstellen">
        Öffne **Buchungspakete** in der Menüleiste → **Buchungskontingente** → **Neu+**. Wähle Typ **Menge**, Wert **10**, Modus **Einmalig**.
      </Step>

      <Step title="Begrenzung setzen">
        Begrenze die Nutzung auf die Ressource oder den Service deines Yoga-Kurses.
      </Step>

      <Step title="Buchungspaket erstellen">
        Erstelle unter **Buchungspakete** ein neues Paket mit Preis und Beschreibung. Verknüpfe das soeben erstellte Kontingent.
      </Step>

      <Step title="Live schalten">
        Setze das Buchungspaket über die drei Punkte auf **Live**. Kund:innen können die 10er-Karte jetzt auf deiner Buchungsseite kaufen und den Code bei Buchungen einlösen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Coworking-Space mit monatlichem Meetingraum-Budget">
    Premium-Mitglieder erhalten 8 Stunden Meetingraum-Nutzung pro Monat, automatisch über ihr Abo.

    <Steps>
      <Step title="Kontingent erstellen">
        Öffne **Buchungspakete** → **Buchungskontingente** → **Neu+**. Wähle Typ **Dauer**, Wert **480 Minuten**, Modus **Wiederkehrend**, Intervall **1 Monat**.
      </Step>

      <Step title="Begrenzung setzen">
        Begrenze die Nutzung auf die Gruppe oder Ressource deiner Meetingräume.
      </Step>

      <Step title="Mit Abo-Plan verknüpfen">
        Öffne deinen Abo-Plan (z. B. Premium Membership) unter **Abo-Pläne** und füge das Kontingent im Bereich **Buchungskontingente** hinzu.
      </Step>

      <Step title="Ergebnis prüfen">
        Sobald ein Mitglied das Abo abschliesst, wird das Kontingent automatisch zugeteilt und monatlich erneuert. In der Kundendetailansicht siehst du die Auslastung.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Wo sehe ich als Admin die Restguthaben?">
    Auf der Rechnung, in der Kundendetailansicht, im Abo und im Buchungscode (jeweils auf der Detailseite).
  </Accordion>

  <Accordion title="Was passiert mit nicht genutztem Kontingent am Ende des Zeitraums?">
    Bei wiederkehrenden Kontingenten verfällt der Restbetrag am Ende des Zeitraums. Er wird nicht in den nächsten Zeitraum übertragen.
  </Accordion>

  <Accordion title="Kann ich ein Kontingent auf mehrere Ressourcen begrenzen?">
    Ja. Begrenzungen auf Kategorie, Gruppe, Ressource und Service lassen sich frei kombinieren.
  </Accordion>

  <Accordion title="Werden stornierte Buchungen wieder gutgeschrieben?">
    Ja, bei regulärer Stornierung wird das Kontingent zurückgegeben. Ausnahme: Wenn Stornierungsbedingungen greifen, die keine Rückgabe vorsehen, wird das Kontingent nicht zurückerstattet.
  </Accordion>

  <Accordion title="Kann ein Kontingent nachträglich von einmalig auf wiederkehrend geändert werden?">
    Nein. Du musst ein neues Kontingent erstellen und das alte widerrufen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein Kunde hat kein Kontingent, obwohl er in der Community ist">
    Bei Multi-Organisations-Setups kann es vorkommen, dass Kontingente nicht automatisch aktualisiert werden. Öffne die Community und klicke auf **Kontingente aktualisieren**.
  </Accordion>

  <Accordion title="Wiederkehrendes Kontingent zeigt im ersten Zeitraum den Wert 0">
    Dieser Bug wurde behoben. Prüfe, ob die Änderung bereits in deiner Umgebung aktiv ist. Falls das Problem weiterhin auftritt, wende dich an den Support.
  </Accordion>

  <Accordion title="Dauer-Kontingent lässt sich nicht auf einen Service anwenden">
    Kontingente können nur auf Services mit der gleichen Zeiteinheit angewendet werden. Ein Dauer-Kontingent in Stunden funktioniert nicht bei einer Buchungsoption, die in Tagen rechnet. Passe die Einheit des Kontingents an.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Buchungskontingente. Plan: Professional. Aktivierung via Account-Einstellungen → Features → Buchungspakete.
> * UI-Pfad Kontingente verwalten: Buchungspakete (Menüleiste) → Buchungskontingente.
> * UI-Pfad Kundenkontingente: Kunden → Kunde → Tab Buchungskontingente.
> * UI-Pfad Zugang beschränken: Ressource → Einstellungen → Verifizierung & Zugang ODER Buchungsoption → Bearbeiten → Zugang.
> * Einmalig vs. Wiederkehrend kann NICHT nachträglich geändert werden.
> * Einheitenkompatibilität: Kontingent-Einheit muss zur Buchungsoption passen (Stunden ≠ Tage).
> * Wiederkehrende Kontingente werden für 12 Monate im Voraus ausgestellt.
> * Bei Stornierung nach Frist (Stornierungsbedingungen aktiv): Kontingent wird NICHT zurückgegeben.
> * Wiederkehrende Buchungen: Jeder Serientermin verbraucht Kontingent. Stornierte Termine innerhalb einer Serie werden seit 29.07.2026 korrekt zurückerstattet.
> * Quota-based Add-ons (seit 06.07.2026): Kontingente können auch Add-on-Kosten abdecken. Third-party add-ons (`is_third_party`) zählen nicht gegen das Prepaid-Booking-Cap.
> * Abgrenzung Zeitplan-Kontingente (eigenes Feature): Steuert max. gleichzeitige Buchungen pro Slot, NICHT Kundenguthaben.
> * Abgrenzung Kontingente für Buchungsoptionen (eigenes Feature): Begrenzt parallele Buchungen pro Service, NICHT Kundenguthaben.
> * Zusätzliche Ressourcen: Kontingent wird NUR auf die Hauptressource angewendet, nicht auf zusätzliche Ressourcen der Buchungsoption. Ausnahme: Budget-Kontingent (geldwert) greift auch auf zusätzliche Ressourcen.
> * Abo-Grants (seit Sep 2026, #282): `BookingQuotaGrantsService` clamped an `ends_at` / `cancels_at`. `SubscriptionEnded` widerruft Rest-Grants. Checkout wendet Grants nach Abo-Ende nicht mehr an.
> * Abo-Grants (seit Sep 2026, #282): `BookingQuotaGrantsService` clamped an `ends_at` / `cancels_at`. `SubscriptionEnded` widerruft Rest-Grants. Checkout wendet Grants nach Abo-Ende nicht mehr an.


# Buchungsregeln
Source: https://docs.anny.co/booking-rules

Begrenze accountweit die Anzahl erlaubter Buchungen pro Zeitraum und steuere Ausnahmen.

Mit Buchungsregeln steuerst du zentral und accountweit, wie oft deine Kund:innen in einem bestimmten Zeitraum buchen dürfen. Die Regeln gelten global für deinen gesamten Account und können auf bestimmte Ressourcen, Services oder Nutzer:innen eingegrenzt werden.

<Info>
  Verfügbar ab **Professional**.
</Info>

## Wie funktionieren Buchungsregeln?

Buchungsregeln definieren ein maximales Buchungslimit pro Zeitraum. Sobald eine Kund:in das Limit erreicht, wird die nächste Buchung im definierten Geltungsbereich blockiert. Optional wird dabei eine individuelle Fehlermeldung angezeigt.

Das Grundprinzip:

1. Du legst eine Regel mit einem Namen, einem Limit und einem Zeitraum an.
2. Du bestimmst den Geltungsbereich: alle Buchungen oder nur bestimmte Ressourcen/Services.
3. Du entscheidest, ob die Regel für alle Nutzer:innen gilt oder nur für bestimmte (Sperrliste) bzw. bestimmte ausgenommen werden (White-List).

Alle Regeln werden zentral in den **Account-Einstellungen** unter **Buchungsregeln** verwaltet. Damit hast du einen vollständigen Überblick über sämtliche Buchungslimits deines Accounts.

<Tip>
  Bei Buchungsoptionen mit mehrfacher Gewichtung zählt jede Gewichtungseinheit als separate Buchung gegen das Limit. Beispiel: Eine Buchungsoption mit Gewichtung 4 verbraucht bei einem Limit von 3 bereits mehr als erlaubt. Schließe solche Buchungsoptionen gegebenenfalls vom Geltungsbereich der Regel aus.
</Tip>

<Tip>
  Jeder einzelne Termin einer [wiederkehrenden Buchung](/recurring-bookings) zählt gegen das Limit. Eine zweite Serie am selben Tag wird blockiert, wenn das Tageslimit durch die erste Serie bereits ausgeschöpft ist.
</Tip>

## Wann nutze ich das?

* **Du möchtest faire Nutzung sicherstellen**: Begrenze Buchungen pro Zeitraum, damit alle Kund:innen gleichmäßig Zugang erhalten (z. B. max. 1 Lernplatz pro Tag an einer Uni).
* **Du brauchst eine Sperrliste**: Setze das Limit auf 0 und weise die Regel bestimmten Nutzer:innen zu, um diese komplett von Buchungen auszuschließen.
* **Du willst VIP-Ausnahmen schaffen**: Erstelle eine Regel mit engem Limit und nimm bestimmte Nutzer:innen (z. B. Premium-Mitglieder) über die White-List aus.
* **Nicht geeignet für**: Das Sperren ganzer Zeiträume. Dafür nutze stattdessen Globale Blocker (**Account-Einstellungen** → **Globale Blocker**).

## Zusammenhang mit anderen Features

* **Communities**: Über Buchungsregeln kannst du Nutzer:innen sperren, die trotz SSO/Auto-Join in einer Community landen, aber bestimmte Ressourcen nicht buchen sollen.
* **Globale Blocker**: Während Buchungsregeln die Anzahl limitieren, sperren Globale Blocker komplette Zeiträume für Ressourcen oder Services.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Regelname | Frei wählbarer Name zur Identifikation |
| Regel-Typ | Art der Regel (Anzahl der Buchungen) |
| Maximale Buchungen | Erlaubte Buchungsanzahl im Zeitraum |
| Zeitraum | Täglich, Pro Woche, Pro 2 Wochen, Pro Monat, Pro Jahr, Pro verfügbarem Termin, In der Zukunft |
| Hinweis bei Überschreitung | Individuelle Fehlermeldung (max. 255 Zeichen, mehrsprachig) |
| Geltungsbereich | Alle Buchungen oder Mit Einschränkung |
| Einschränkung auf | Ressource, Gruppe, Kategorie, Service, Service Gruppe |
| Nutzer | Alle Nutzer, Nutzer einbeziehen (Sperrliste), Nutzer ausschließen (White-List) |

<Tip>
  Der Hinweis bei Überschreitung lässt sich mehrsprachig hinterlegen. Nutze das Sprachmenü im Textfeld, um Fehlermeldungen in weiteren Sprachen zu pflegen.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Eine Universität begrenzt Lernplatz-Buchungen auf 1 pro Tag">
    Eine Uni möchte sicherstellen, dass alle Studierenden fair Zugang zu den Lernplätzen erhalten. Pro Person soll nur eine Buchung am Tag möglich sein.

    <Steps>
      <Step title="Regel hinzufügen">
        Öffne **Account-Einstellungen** → **Buchungsregeln** → **+ Regel hinzufügen**.
      </Step>

      <Step title="Limit und Zeitraum konfigurieren">
        Setze **Maximale Buchungen** auf **1** und wähle als **Zeitraum** den Wert **Täglich**.
      </Step>

      <Step title="Geltungsbereich einschränken">
        Wähle **Mit Einschränkung** → **Kategorie** und wähle die Kategorie deiner Lernplätze aus.
      </Step>

      <Step title="Fehlermeldung hinterlegen">
        Trage unter **Hinweis bei Überschreitung** ein: "Du hast für heute bereits einen Lernplatz gebucht."
      </Step>

      <Step title="Speichern">
        Klicke auf **Speichern**. Die Regel gilt sofort für alle Nutzer:innen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Ein Coworking-Space erstellt eine Sperrliste für zahlungssäumige Mitglieder">
    Ein Coworking-Betreiber möchte bestimmte Nutzer:innen komplett von allen Buchungen ausschließen, ohne sie aus der Community zu entfernen.

    <Steps>
      <Step title="Regel hinzufügen">
        Öffne **Account-Einstellungen** → **Buchungsregeln** → **+ Regel hinzufügen**.
      </Step>

      <Step title="Limit auf 0 setzen">
        Setze **Maximale Buchungen** auf **0** und wähle als **Zeitraum** den Wert **In der Zukunft**.
      </Step>

      <Step title="Geltungsbereich festlegen">
        Wähle **Alle Buchungen**, damit die Sperre für den gesamten Account gilt.
      </Step>

      <Step title="Nutzer:innen zuweisen">
        Wähle **Nutzer einbeziehen** und füge die E-Mail-Adressen der betroffenen Personen hinzu.
      </Step>

      <Step title="Fehlermeldung hinterlegen und speichern">
        Trage unter **Hinweis bei Überschreitung** ein: "Bitte wende dich an das Team." Klicke auf **Speichern**.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich mehrere Regeln gleichzeitig anlegen?">
    Ja. Du kannst beliebig viele Regeln erstellen. Alle aktiven Regeln werden parallel geprüft. Sobald eine Regel greift, wird die Buchung blockiert.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen 'Nutzer einbeziehen' und 'Nutzer ausschließen'?">
    **Nutzer einbeziehen** bedeutet: Die Regel gilt NUR für die angegebenen Personen (Sperrliste). **Nutzer ausschließen** bedeutet: Die Regel gilt für alle AUSSER die angegebenen Personen (White-List).
  </Accordion>

  <Accordion title="Was passiert, wenn ich den Zeitraum 'In der Zukunft' wähle?">
    Das Limit gilt ab dem Zeitpunkt der Regelerstellung kumulativ. Alle zukünftigen Buchungen werden gegen das Limit gezählt, ohne dass es sich zu einem bestimmten Zeitpunkt zurücksetzt.
  </Accordion>

  <Accordion title="Kann ich die Fehlermeldung in mehreren Sprachen hinterlegen?">
    Ja. Nutze das Sprachmenü im Feld **Hinweis bei Überschreitung**, um Meldungen in beliebig vielen Sprachen zu pflegen. Kund:innen sehen die Meldung in ihrer eingestellten Sprache.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Meine Regel greift nicht bei einer bestimmten Buchungsoption">
    Prüfe, ob die Buchungsoption eine mehrfache Gewichtung hat. Bei einer Gewichtung von z. B. 4 werden 4 Buchungen gegen das Limit gezählt. Schließe die betroffene Buchungsoption gegebenenfalls aus dem Geltungsbereich der Regel aus.
  </Accordion>

  <Accordion title="Eine gesperrte Person kann trotzdem buchen">
    Stelle sicher, dass du **Nutzer einbeziehen** (nicht "ausschließen") gewählt hast und die korrekte E-Mail-Adresse eingetragen ist. Prüfe außerdem, ob der Geltungsbereich die betroffene Ressource oder den Service abdeckt.
  </Accordion>

  <Accordion title="Der Hinweis wird Kund:innen nicht angezeigt">
    Der Hinweis erscheint nur beim Checkout, wenn das Limit tatsächlich überschritten wird. Prüfe, ob das Textfeld ausgefüllt und gespeichert wurde. Ohne hinterlegten Hinweis erscheint eine generische Fehlermeldung.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Avatar** → **Account-Einstellungen** → **Buchungsregeln**
> * Gewichtungsregel: Bei mehrfacher Gewichtung einer Buchungsoption zählt jede Gewichtungseinheit als separate Buchung gegen das Limit. Beispiel: Gewichtung 4 bei Limit 3 = Buchung nicht möglich.
> * Wiederkehrende Buchungen: Jedes Child-Vorkommen zählt (auch wenn `customer_id` auf dem Child leer ist). Eine zweite Serie am selben Tag trifft dasselbe Tageslimit.
> * Geltungsbereich-Filter: Ressource (einzeln), Gruppe, Kategorie, Service (einzeln), Service Gruppe
> * White-List = Nutzer:innen von einer Regel ausnehmen ("Nutzer ausschließen"). Sperrliste = Regel gilt NUR für diese Nutzer:innen ("Nutzer einbeziehen").
> * Abgrenzung: Buchungsregeln ≠ Globale Blocker. Buchungsregeln limitieren die Anzahl der Buchungen pro Zeitraum. Globale Blocker sperren Zeiträume komplett.
> * Buchungsregeln sind accountweit/global. Sie gelten für den gesamten Account, nicht pro Ressource.
> * Verfügbar ab Professional. Basis-Buchungsregeln (z. B. 1x pro Tag pro Ressource) waren früher in den Ressourceneinstellungen konfigurierbar, sind jetzt zentral zusammengeführt.


# Mehrere Services kombinieren
Source: https://docs.anny.co/booking-sequences

Lass Kund:innen mehrere Services in einer Buchung wählen oder hintereinander buchen.

Auf einer Ressource kannst du zwei Einstellungen kombinieren: **Mehrfachauswahl von Services erlauben** und **Mehrere Services aneinanderreihen**. So wählen Kund:innen auf der Buchungsseite mehrere Services oder Buchungsoptionen auf einmal.

<Info>
  Für **Mehrere Services aneinanderreihen** aktivierst du zuerst **Buchungssequenzen** unter **Avatar** → **Account-Einstellungen** → **Features**.
</Info>

## Wie funktioniert das?

Ohne Aneinanderreihen laufen mehrere Auswahlen **parallel**. Typisch für Kurse oder Events: mehrere Personen buchen denselben Zeitraum.

Mit **Mehrere Services aneinanderreihen** legt anny die Services **hintereinander**. Die Gesamtdauer verlängert sich, zum Beispiel Haarschnitt plus Färben bei derselben Person.

Du findest beide Schalter unter **Ressourcen** → deine Ressource → Reiter **Services** oder **Buchungsoptionen**.

## Einrichten

<Steps>
  <Step title="Buchungen einschalten">
    Öffne die Ressource und verknüpfe mindestens einen Service oder eine Buchungsoption. Aktiviere **Buchungen aktivieren**.
  </Step>

  <Step title="Mehrfachauswahl erlauben">
    Ist die Ressource mehrfach verfügbar, erscheint **Mehrfachauswahl von Services erlauben**. Schalte den Toggle ein.
  </Step>

  <Step title="Optional aneinanderreihen">
    Ist **Buchungssequenzen** aktiv, erscheint **Mehrere Services aneinanderreihen**. Schalte den Toggle ein, wenn die Services nacheinander statt parallel gebucht werden sollen.
  </Step>

  <Step title="Obergrenze setzen">
    Unter **Maximale Anzahl ausgewählter Services** begrenzst du, wie viele Services in einer Buchung zusammenkommen dürfen.
  </Step>
</Steps>

Sobald die Schalter aktiv sind, können Kund:innen auf der Buchungsseite mehrere Services auswählen, sofern die folgenden Bedingungen erfüllt sind.

## Welche Bedingungen müssen erfüllt sein?

Die Services oder Buchungsoptionen, die zusammen gebucht werden sollen, müssen **gleich eingestellt** sein. Weicht eine Einstellung ab, erscheint die Kombination auf der Buchungsseite als nicht verfügbar.

| Muss gleich sein | Wo stellst du das ein |
| - | - |
| **Zeitpunkt der Zahlung** | Buchungsoption → **Zahlungen** |
| **Währung** | Buchungsoption → **Einstellungen** |
| **MwSt. Satz** | Buchungsoption → **Einstellungen** |
| **Netto** oder **Brutto** | Buchungsoption → **Einstellungen** |
| **Rechnung automatisch generieren** | Buchungsoption → **Zahlungen** |
| **Zeitpunkt der Rechnungserstellung** | Buchungsoption → **Zahlungen** |
| **Zahlungsstatus verfolgen** | Buchungsoption → **Zahlungen** |
| Zeiteinheit (Stunden oder Tage) | Buchungsoption → **Einstellungen** |

Bei **Tagesbuchungen** müssen zusätzlich **Startzeit** und **Endzeit** übereinstimmen.

Außerdem gilt:

* Alle Services hängen an **derselben Ressource**.
* Keiner der Services ist eine **Serie**. Serien lassen sich nicht aneinanderreihen.
* Die Ressource hat **keine Child-Ressourcen**. Sonst erscheint die Mehrfachauswahl auf der Buchungsseite nicht.

<Tip>
  Prüfe Zahlung, MwSt. und Zeitraum zuerst. Das sind die häufigsten Gründe, warum zwei Services nicht kombinierbar sind.
</Tip>

## Wann nutze ich das?

* **Du bietest kombinierbare Leistungen an**: z. B. Beratung plus Workshop, oder mehrere Behandlungen hintereinander.
* **Du verkaufst Kurse oder Events**: Mehrfachauswahl ohne Aneinanderreihen, damit mehrere Personen denselben Slot buchen.
* **Nicht geeignet für**: Serien, Child-Ressourcen oder Services mit unterschiedlicher Zahlung oder MwSt.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| [Buchungsoption](/configure-booking-option) | Zahlung, Preis und Zeitraum müssen bei kombinierbaren Optionen gleich sein |
| [Service-First Flow](/service-first-flow) | Kund:innen können mehrere Services direkt in der Service-Liste kombinieren |
| [Serienbuchungen](/booking-series) | Serien und Buchungssequenzen schließen sich aus |

## Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Mehrfachauswahl von Services erlauben | Kund:innen können in der Service-Liste mehrere Services auswählen. Erscheint nur bei mehrfach verfügbaren Ressourcen. |
| Mehrere Services aneinanderreihen | Die ausgewählten Services werden hintereinander gelegt statt parallel. Braucht das Feature **Buchungssequenzen**. |
| Maximale Anzahl ausgewählter Services | Obergrenze für die Anzahl der Services in einer Buchung |

Bei einer einfach verfügbaren Ressource erscheint nur **Mehrere Services aneinanderreihen**. Die Mehrfachauswahl wird dann automatisch mit eingeschaltet.

## FAQ

<AccordionGroup>
  <Accordion title="Warum sehe ich die Schalter nicht?">
    **Mehrfachauswahl von Services erlauben** erscheint nur, wenn **Buchungen aktivieren** an ist und die Ressource mehrfach verfügbar ist. **Mehrere Services aneinanderreihen** braucht zusätzlich das Feature **Buchungssequenzen**.
  </Accordion>

  <Accordion title="Warum kann ich zwei Services nicht kombinieren?">
    Fast immer unterscheiden sich Zahlung, MwSt., Währung oder die Zeiteinheit. Gleiche die Einstellungen in beiden Buchungsoptionen ab. Serien sind grundsätzlich nicht kombinierbar.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen parallel und aneinanderreihen?">
    Parallel teilen sich mehrere Buchungen denselben Zeitraum, z. B. Teilnehmer:innen eines Kurses. Aneinanderreihen verlängert die Gesamtdauer: Service 2 beginnt, sobald Service 1 endet.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Mehrfachauswahl erscheint auf der Buchungsseite nicht">
    Die Ressource hat Child-Ressourcen, oder **Mehrfachauswahl von Services erlauben** ist aus. Entferne die Child-Ressourcen oder aktiviere den Schalter.
  </Accordion>

  <Accordion title="Ein Service ist grau und nicht auswählbar">
    Der Service passt nicht zur aktuellen Auswahl. Gleiche Zahlung, MwSt., Währung und Zeitraum an. Achte darauf, dass beide Services an derselben Ressource hängen.
  </Accordion>

  <Accordion title="Ich kann Aneinanderreihen nicht aktivieren">
    Das Feature **Buchungssequenzen** ist aus, oder an der Ressource hängt eine Serie. Entferne die Serie oder aktiviere das Feature unter **Account-Einstellungen** → **Features**.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: Ressource → Reiter Services (oder Buchungsoptionen bei is\_rental\_option). Toggles: allowMultiService (`Mehrfachauswahl von Services erlauben`) und createBookingSequence (`Mehrere Services aneinanderreihen`). Feld maxSequenceQuantity (`Maximale Anzahl ausgewählter Services`).
> * allowMultiService-Toggle nur sichtbar bei bookingsEnabled && quantity > 1. createBookingSequence-Toggle nur bei bookingsEnabled && (allowMultiService || quantity === 1) && Feature `booking-sequences`.
> * quantity === 1 + allowMultiService erzwingt createBookingSequence (Observer + UI). allowMultiService aus setzt createBookingSequence aus.
> * Shop blendet Mehrfachauswahl aus, wenn resource.hasChildren. Serien (is\_series) sind nicht multi-selectbar und blockieren create\_booking\_sequence (Fehler series.sequence\_not\_allowed).
> * Kombinierbarkeit: aggregateSameValue in ServiceConfiguration::fromServices und getSequentialServices. Muss identisch sein: payment\_flow, create\_invoice, issue\_days\_offset, issue\_reference, track\_payment, currency, tax\_rate, is\_net\_price, unit; bei unit nicht MINUTE/HOUR zusätzlich default\_start\_time und default\_end\_time.
> * Alle Services einer Sequenz müssen an derselben ONE\_OF-Ressource hängen. Die Ressource braucht allow\_multi\_service + create\_booking\_sequence, max\_sequence\_quantity >= Summe der Mengen.
> * Feature-Titel **Buchungssequenzen**. Verwandte Artikel: /configure-booking-option, /service-first-flow, /booking-series, /min-max-selection, /ressourcen-konfigurieren.


# Buchungsserien
Source: https://docs.anny.co/booking-series

Biete mehrere zusammengehörige Termine als buchbares Paket an, z. B. für Kurse oder Workshop-Reihen.

Mit Buchungsserien bietest du mehrere zusammengehörige Termine als Paket an, die ausschließlich gemeinsam gebucht werden können. Du pflegst die einzelnen Termine in den Verfügbarkeiten deiner Ressource, ordnest sie einer Serie zu und lässt Kund:innen die passende Serie direkt im Buchungsprozess auswählen.

## Wie funktioniert Buchungsserien?

Buchungsserien arbeiten mit der Kombination aus **Buchungsoption** (Modus "Serie") und den **Verfügbarkeiten** der Ressource:

1. Du stellst den Modus der Buchungsoption auf **Serie**
2. Du legst in den Verfügbarkeiten der Ressource die einzelnen Termine an
3. Du ordnest diese Termine einer **Serie** zu (z. B. "Yoga Juni 2026")
4. Kund:innen wählen im Buchungsprozess die gewünschte Serie über ein Dropdown aus und buchen alle Termine auf einmal

Mehrere Serien können parallel auf derselben Ressource existieren. Zusätzlich können einzelne Termine bewusst ohne Serienzuordnung bleiben, um sie als Drop-In buchbar zu machen.

### Bereitgestellte Ressourcen pro Termin

An einzelnen Terminen können zusätzliche Ressourcen verbunden werden (z. B. Trainer:innen oder Räume), die direkt auf Slot-Ebene mitverwaltet werden.

### Stornierung von Buchungsserien

**Admin-Stornierung** bietet drei Optionen:

| Option | Beschreibung |
| - | - |
| Einzeltermin stornieren | Nur ein bestimmter Termin wird storniert |
| Diesen und alle folgenden Termine | Ab dem gewählten Termin werden alle folgenden storniert |
| Gesamte Serie stornieren | Alle Termine werden storniert, Stornierungskonditionen greifen |

**Kund:innen** können keine Serienstornierung durchführen. Sie können einzelne Termine oder alle folgenden Termine absagen. Der Anbieter erhält eine Mitteilung über die Art der Absage.

<Warning>
  Stornierungskonditionen (Gebühren) werden nur bei der Option "Gesamte Serie stornieren" angewendet. Bei Einzeltermin- oder Folge-Stornierung fallen keine Stornierungskosten an.
</Warning>

Stornierst du eine bezahlte Serie unter **Bestellungen**, öffnet anny denselben Korrektur-Dialog wie bei anderen bezahlten Buchungen. Dort schließt du die Gutschrift oder Erstattung ab. Details: [Rechnung korrigieren](/invoice-corrections).

## Wann nutze ich das?

* **Du bietest Kurse mit festen Terminen an** (z. B. Sprachkurs 12 Wochen, Yogakurs 8 Wochen): Erstelle eine Serie mit allen Kursterminen.
* **Du willst mehrere Kurszyklen parallel anbieten**: Lege mehrere Serien auf derselben Ressource an (z. B. "Anfänger Mai" und "Anfänger Juli").
* **Du möchtest zusätzlich Drop-Ins ermöglichen**: Lasse einzelne Termine ohne Serienzuordnung, damit sie separat buchbar bleiben.
* **Du brauchst Trainer:innen-Zuordnung pro Termin**: Verbinde bereitgestellte Ressourcen auf Slot-Ebene.
* **Nicht geeignet für**: Automatisch wiederkehrende Einzeltermine (z. B. wöchentliches Jour Fixe, das sich endlos wiederholt). Dafür nutze [Wiederkehrende Buchungen](/recurring-bookings).

## Zusammenhang mit anderen Features

* [**Wiederkehrende Buchungen**](/recurring-bookings): Wiederkehrende Buchungen wiederholen einen Termin automatisch (z. B. jeden Montag). Buchungsserien sind feste, manuell gepflegte Terminpakete. Beides sind unterschiedliche Konzepte.
* [**Eigene Formulare**](/custom-forms): Formulardaten bei Serien werden ausschließlich auf dem Mastertermin gespeichert und sind nur dort sichtbar.
* [**Stornierungsbedingungen**](/cancellation-policy): Stornierungskonditionen greifen nur bei der Stornierung der gesamten Serie, nicht bei Einzeltermin-Absagen.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Modus der Buchungsoption | Auf "Serie" stellen |
| Verfügbarkeiten der Ressource | Einzelne Termine anlegen |
| Serienzuordnung | Termine einer benannten Serie zuweisen |
| Bereitgestellte Ressourcen | Zusätzliche Ressourcen pro Termin (z. B. Trainer:in) |
| Drop-In | Termine ohne Serienzuordnung bleiben einzeln buchbar |

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Yoga-Kurs (8 Wochen) mit Drop-In für Restplätze">
    Ein Yoga-Studio bietet einen 8-Wochen-Kurs als Paket an. Einzelne Restplätze sollen zusätzlich als Drop-In buchbar sein.

    <Steps>
      <Step title="Ressource und Buchungsoption">
        Lege die Ressource "Yoga Kurs" an und verknpfe eine Buchungsoption im Modus **Serie**.
      </Step>

      <Step title="Termine anlegen">
        Wechsle in die **Verfügbarkeiten** der Ressource und lege 8 Termine an (z. B. jeden Mittwoch 18:00 bis 19:00).
      </Step>

      <Step title="Serie zuordnen">
        Ordne alle 8 Termine der Serie **"Yoga Juni 2026"** zu.
      </Step>

      <Step title="Drop-In konfigurieren">
        Lasse einzelne Termine bewusst ohne Serienzuordnung oder konfiguriere, dass Restplätze für Drop-In-Buchungen verfügbar bleiben.
      </Step>

      <Step title="Testen">
        Prüfe im Buchungsprozess, ob die Serie "Yoga Juni 2026" im Dropdown erscheint und alle 8 Termine als Paket gebucht werden.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Sprachkurs mit Trainer-Zuordnung pro Termin">
    Ein Sprachkursanbieter möchte einen 12-Wochen-Kurs anbieten und pro Termin eine:n Trainer:in zuordnen.

    <Steps>
      <Step title="Ressource und Buchungsoption">
        Lege die Ressource "Sprachkurs A1" an und stelle die Buchungsoption auf Modus **Serie**.
      </Step>

      <Step title="Termine anlegen">
        Hinterlege in den **Verfügbarkeiten** 12 Termine (z. B. jeden Dienstag 10:00 bis 11:30).
      </Step>

      <Step title="Serie zuordnen">
        Ordne alle 12 Termine der Serie **"A1 Herbst 2026"** zu.
      </Step>

      <Step title="Trainer:in pro Termin verbinden">
        Verbinde bei einzelnen Terminen die bereitgestellte Ressource (z. B. "Trainerin Lea Sommer" oder "Trainer Max Müller"), wenn verschiedene Personen unterschiedliche Termine übernehmen.
      </Step>

      <Step title="Testen">
        Prüfe den Buchungsprozess und kontrolliere im Admin-Kalender, ob die Trainer-Zuordnung pro Termin korrekt sichtbar ist.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Buchungsserien und Wiederkehrenden Buchungen?">
    Buchungsserien sind feste, manuell gepflegte Terminpakete, die als Ganzes gebucht werden (z. B. ein 8-Wochen-Kurs). Wiederkehrende Buchungen wiederholen einen Termin automatisch nach einer Regel (z. B. jeden Montag). Beides sind separate Features.
  </Accordion>

  <Accordion title="Muss ich für jede neue Serie eine neue Buchungsoption anlegen?">
    Nein. Neue Serien legst du über neue Termine und Serienzuordnungen in derselben Ressource an. Die Buchungsoption bleibt bestehen.
  </Accordion>

  <Accordion title="Können Kund:innen zwischen mehreren Serien wählen?">
    Ja. Wenn du in einer Ressource mehrere Serien angelegt hast, können Kund:innen die gewünschte Serie im Dropdown auswählen.
  </Accordion>

  <Accordion title="Können Kund:innen eine Serie selbst stornieren?">
    Nein. Kund:innen können nur einzelne Termine oder alle folgenden Termine absagen. Eine vollständige Serienstornierung ist nur durch Admins möglich.
  </Accordion>

  <Accordion title="Wann greifen Stornierungskonditionen?">
    Nur bei der Admin-Option "Gesamte Serie stornieren". Einzeltermin-Absagen und "Diesen und alle folgenden" lösen keine Stornierungsgebühren aus.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kund:innen sehen die Serie nicht im Dropdown">
    Prüfe, ob die Termine in den Verfügbarkeiten korrekt angelegt und einer Serie zugeordnet sind. Ohne Serienzuordnung erscheint keine Auswahl im Buchungsprozess.
  </Accordion>

  <Accordion title="Für einen neuen Kurszyklus taucht keine neue Auswahl auf">
    Prüfe, ob die neuen Termine in der Ressource angelegt und einer neuen Serie zugeordnet wurden. Ohne vorhandene Slots in den Verfügbarkeiten kann keine neue Serie angezeigt werden.
  </Accordion>

  <Accordion title="Drop-Ins und Serien verhalten sich nicht wie erwartet">
    Prüfe, welche Termine der Serie zugeordnet sind und welche bewusst als einzelne freie Termine verfügbar bleiben. Die saubere Trennung in der Verfügbarkeitslogik ist entscheidend.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Buchungsoption** → Modus **Serie** + **Ressource** → **Verfügbarkeit** → Termine anlegen und Serie zuordnen
> * Buchungsserien ≠ Wiederkehrende Buchungen: Serien = festes Terminpaket, alle Termine auf einmal gebucht. Wiederkehrende = automatisch wiederholende Einzeltermine.
> * Ohne gepflegte Termine in den Verfügbarkeiten mit Serienzuordnung erscheint keine Serie im Buchungsprozess
> * Bereitgestellte Ressourcen werden auf Slot-Ebene verbunden (z. B. Trainer:in pro Termin)
> * Stornierung Admin: 3 Optionen (Einzeltermin / Diesen + folgende / Gesamte Serie). Nur bei "Gesamte Serie" greifen Stornierungskonditionen.
> * Bezahlte Serie aus Bestellungen stornieren: erzeugt eine BookingChange / tmp-Rechnung und öffnet den Korrektur-Dialog (wie andere bezahlte Buchungen). Wiederkehrende Master zählen hier nicht doppelt.
> * Stornierung Kund:innen: keine Serienstornierung möglich, nur Absagen einzelner oder folgender Termine (Admin erhält Mitteilung)
> * Eigene Formulare bei Serien: Formulardaten nur auf dem Mastertermin gespeichert
> * Mehrere Serien können parallel auf derselben Ressource existieren
> * Drop-In: Termine ohne Serienzuordnung bleiben einzeln buchbar
> * Verwandte Artikel: /recurring-bookings, /buchungsoption-konfigurieren, /custom-forms, /cancellation-policy


# Broadcasting
Source: https://docs.anny.co/broadcasting

Sende gezielte Nachrichten an Kund:innen, basierend auf Buchungen, Kundenprofilen oder Abonnements.

Mit dem Broadcast-Feature versendest du gezielte Nachrichten an definierte Empfängergruppen. Statt einzeln zu kommunizieren, erreichst du alle relevanten Kund:innen auf einmal, ob einmalig bei kurzfristigen Änderungen oder automatisiert als wiederkehrende Kampagne.

<Info>
  Verfügbar ab **Professional**. Broadcasting ist ein Plan-Feature, kein Schalter unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktioniert Broadcast?

Broadcast arbeitet in drei Schritten:

1. **Empfänger definieren**: Du wählst eine von drei Basen (Buchungen, Kunden oder Abonnements) und filterst die Zielgruppe über Kriterien wie Zeitraum, Ressource, Community oder Abo-Plan.
2. **Nachricht konfigurieren**: Du erstellst eine Nachricht mit Betreff, Inhalt und optionalem Button. Tippe **#**, um Platzhalter einzufügen (gespeichert z. B. als `{customer.given_name}`).
3. **Versenden**: Du entscheidest, ob die Nachricht **Jetzt senden**, **Später senden** oder **Wiederkehrend** (täglich, wöchentlich, monatlich) versendet wird.

Die Nachricht wird über einen oder mehrere Kanäle gleichzeitig zugestellt: **Email**, **SMS** und **Push-Notification** (anny App). Einen eigenen Browser-Notification-Kanal gibt es nicht.

<Tip>
  Alternativ startest du einen Broadcast direkt aus der **Buchungen**-, **Kunden**- oder **Abos**-Ansicht: Filtere dort deine gewünschte Empfängerliste und klicke oben rechts auf **Broadcast**. Die Empfängerliste wird übernommen und kann im Broadcast nachträglich angepasst werden.

  Den Kampagnen-Bereich selbst findest du unter **Kunden** → **Broadcasting**.
</Tip>

## Wann nutze ich das?

* **Du musst Kund:innen kurzfristig über Änderungen informieren (z. B. Raumschließung, Ausfall)**: Einmaliger Broadcast an alle betroffenen Buchungen.
* **Du möchtest regelmäßige Erinnerungen automatisieren (z. B. Wochenplanung, Equipment-Rückgabe)**: Wiederkehrender Broadcast mit passenden Filtern.
* **Du willst Abo-Kund:innen gezielt ansprechen (z. B. Event-Newsletter, Verlängerungshinweis)**: Broadcast basierend auf Abonnements mit Abo-Plan-Filter.
* **Nicht geeignet für**: Transaktionale Einzelbenachrichtigungen wie Buchungsbestätigungen oder Erinnerungen. Dafür nutze E-Mail Templates.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Communities | Community-Zugehörigkeit als Empfänger-Filter nutzbar |
| Abos und Mitgliedschaften | Abo-Plan als Empfänger-Basis und Filter verfügbar |
| Check-In & Check-Out | Check-out-Status als Filter bei buchungsbasierten Broadcasts |

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Empfänger-Basis | Buchungen, Kunden oder Abonnements |
| Channel | Email, SMS, Push-Notification |
| Platzhalter | Mit **#** einfügen, intern z. B. `{customer.given_name}` |
| Button | Optionaler CTA mit Titel und Ziel-URL |
| Vorlage speichern | Nachricht für spätere Verwendung sichern |
| Versandmodus | Jetzt senden, Später senden oder Wiederkehrend |
| Intervall | Täglich, wöchentlich oder monatlich |

### Filteroptionen nach Empfänger-Basis

**Basierend auf Buchungen:**

| Filter | Beschreibung |
| - | - |
| Zeitraum / Tag | Buchungen in einem bestimmten Zeitfenster |
| Ressource | Bestimmte Räume, Equipment oder Bereiche |
| Buchungsoptionen | Spezifische Buchungsoptionen |
| Status | Buchungsstatus (z. B. bestätigt, storniert) |
| Community | Nur Mitglieder einer bestimmten Community |
| Check-In / Check-Out | Eingecheckt oder ausgecheckt |
| Add-Ons, UTM, Custom Fields | Weitere Filter der Buchungsliste |

**Basierend auf Kundenprofilen:**

| Filter | Beschreibung |
| - | - |
| Community | Mitgliedschaft in einer Community |
| Registrierungsdatum | Zeitpunkt der Registrierung |
| Anzahl Buchungen | Buchungsanzahl insgesamt oder in einem Zeitraum |
| Geburtsdatum | Für Geburtstagsnachrichten |
| Unternehmen, E-Mail, Custom Fields | Weitere Kundenfilter |

**Basierend auf Abonnements:**

| Filter | Beschreibung |
| - | - |
| Abo-Plan | Kund:innen mit einem bestimmten Abo-Plan |
| Status, Abrechnung, offene Rechnung | Weitere Abo-Filter |

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Coworking-Space informiert über geänderte Feiertags-Öffnungszeiten">
    Alle Community-Mitglieder sollen vor den Feiertagen über abweichende Öffnungszeiten informiert werden. Der Broadcast wird einmalig per E-Mail und Push-Notification versendet.
  </Accordion>

  <Accordion title="Ein Fitnessstudio versendet einen monatlichen Event-Newsletter an Abo-Kund:innen">
    Alle Kund:innen mit einem aktiven Abo-Plan sollen monatlich über anstehende Events und Kursangebote informiert werden. Der Broadcast wird wiederkehrend per E-Mail versendet.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Können Empfänger auf eine Broadcast-Nachricht antworten?">
    Nein. Broadcast-Nachrichten sind rein informativ und unterstützen keine Antwortfunktion. Für individuelle Kommunikation nutze die Kontaktdaten im Kundenprofil.
  </Accordion>

  <Accordion title="Was passiert, wenn ich einen Broadcast an Buchungen sende und eine Buchung storniert wird?">
    Broadcast hat rein informativen Charakter und löst keine automatische Stornierung oder Statusänderung von Buchungen aus. Wenn du z. B. über eine Raumschließung informierst, musst du die betroffenen Buchungen separat stornieren.
  </Accordion>

  <Accordion title="Kann ich eine wiederkehrende Kampagne nachträglich anpassen?">
    Ja. Öffne die Kampagne unter **Broadcasting**, passe Nachricht oder Filter an und speichere. Die Änderungen gelten ab dem nächsten geplanten Versand.
  </Accordion>

  <Accordion title="Welche Platzhalter kann ich verwenden?">
    Setze ein **#-Zeichen**, um die Variablenauswahl zu öffnen. Gespeichert wird z. B. `{customer.given_name}`, `{booking.resource}` oder `{plan.name}`. Der Platzhalter wird beim Versand durch die Daten des Empfängers ersetzt.
  </Accordion>

  <Accordion title="Wer erhält Broadcast-Nachrichten?">
    Ausschließlich Personen, die in deiner anny-Organisation als Kund:in registriert sind und den gewählten Filterkriterien entsprechen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Empfängerliste zeigt keine Einträge an">
    Die Filterkombination ergibt keine Treffer. Prüfe, ob der gewählte Abo-Plan aktive Abonnent:innen hat oder ob der Zeitraum-Filter Buchungen enthält. Bei Abo-basierten Broadcasts: Stelle sicher, dass du einen konkreten Abo-Plan ausgewählt hast (das Feld darf nicht leer bleiben).
  </Accordion>

  <Accordion title="Kund:innen erhalten die Broadcast-Nachricht nicht">
    Prüfe den gewählten Channel. Bei E-Mail: Hat die Person eine gültige E-Mail-Adresse hinterlegt? Bei Push: Ist die anny App installiert und sind Benachrichtigungen aktiviert? Bei SMS: Ist eine Mobilnummer vorhanden?
  </Accordion>

  <Accordion title="Mein Broadcast wird automatisch blockiert">
    anny blockiert Broadcasts, wenn die Nachricht als schädlich erkannt wird und deine Organisation nicht auf der Trusted-Account-Whitelist steht. Wende dich an den Support, um deine Organisation freischalten zu lassen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: `broadcast-campaigns`, verfügbar ab Professional. Kein Toggle unter Account-Einstellungen → Features.
> * UI-Pfad: **Kunden** → **Broadcasting** (`/campaigns`). Start auch aus Buchungen, Kunden und Abos.
> * Drei Empfänger-Basen in der UI: Buchungen, Kunden, Abonnements. Backend kennt zusätzlich `static` (UI auskommentiert) und `community`.
> * Kanäle: Email, Push-Notification, SMS. Kein Browser-Notification-Kanal. SMS braucht aktivierte Mobile Notifications.
> * Platzhalter: `#` öffnet die Variablenauswahl. Gespeichert als `{customer.given_name}` etc., nicht als `#Vorname`.
> * Versand: **Jetzt senden**, **Später senden**, **Wiederkehrend**.
> * Grenzwert: Empfänger müssen in der anny-Organisation als Kund:in registriert sein
> * Trusted-Account-Whitelist (`broadcast_whitelisted`): umgeht Malicious-Content-Erkennung und `broadcast_blocked`. Auto-Block kommt aus Template-Analyse, nicht aus Versandvolumen.
> * Broadcast-Nachrichten sind im Kundenprofil einsehbar (Reiter **Broadcast-Nachrichten**)
> * Abgrenzung: Broadcast ist nicht gleich E-Mail Templates. E-Mail Templates sind transaktionale Benachrichtigungen (Buchungsbestätigung, Erinnerung). Broadcasting ist proaktive Masseninformation an definierte Empfängergruppen.
> * Broadcast hat rein informativen Charakter und löst keine automatische Stornierung oder Statusänderung von Buchungen aus
> * Bug-Fix 22.07.2026: Abo-Plan-Filter mit leerer Auswahl zeigte keine Empfänger. Leere Plan-Auswahl wird jetzt ignoriert (zeigt alle Abonnent:innen).


# Buchungen im Kalender planen und verwalten
Source: https://docs.anny.co/calendar

Behalte alle Buchungen im Blick, wechsle Ansichten, filtere Ressourcen und lege Buchungen direkt im Kalender an.

Der Kalender ist die zentrale Übersicht für alle Buchungen in deinem anny Account. Du siehst auf einen Blick, welche Ressourcen wann belegt sind, wechselst zwischen verschiedenen Ansichten und legst Buchungen, Blocker oder verfügbare Termine direkt im Kalender an.

<Warning>
  Beta-Phase Admin 3.0 (Stand: 5. Oktober). Anpassungen sind möglich.
</Warning>

## Wie funktioniert der Kalender?

Der Kalender zeigt alle Buchungen deiner Organisation in einer visuellen Übersicht. Du erreichst ihn über **Kalender** in der Seitenleiste links, in der Gruppe **Buchungen**.

Die Bedienelemente sind auf drei Stellen verteilt:

| Bereich | Was du dort findest |
| :- | :- |
| Oben links in der Leiste | Pfeile für den vorherigen und nächsten Zeitraum, **Heute** und das aktuelle Datum. Ein Klick auf das Datum öffnet eine Datumsauswahl. |
| Oben rechts in der Leiste | **Filter** für Ressourcen, Kategorien und gespeicherte Ansichten |
| Unten rechts im Kalender | Umschalter für die Ansicht, die Zeitfenster-Dauer und den Zoom |

<Frame>
  <img alt="Kalender in der Ansicht Tag mit geöffnetem Filter-Panel und ausgewählten Ressourcen" />
</Frame>

### Ansichten

Unten rechts im Kalender öffnest du den Umschalter über **Ansicht ändern**. Dort wählst du eine der folgenden Ansichten:

| Ansicht | Beschreibung |
| :- | :- |
| Tag | Tagesübersicht mit einer Spalte pro Ressource |
| Woche | Wochenübersicht mit Tagesaufteilung |
| Monat | Monatsübersicht im klassischen Kalenderformat |
| Timeline Tag | Timeline für einen einzelnen Tag, eine Zeile pro Ressource |
| Timeline Woche | Timeline für eine gesamte Woche |
| Timeline Monat | Timeline für einen gesamten Monat |
| Board | Kartenansicht der Buchungen einer Woche |
| Woche (Bestellungen) | Wochenansicht, in der Buchungen nach Bestellung zusammengefasst sind |
| Tag (Bestellungen) | Tagesansicht, in der Buchungen nach Bestellung zusammengefasst sind |
| Karte | Deine Lagepläne mit freien und gebuchten Plätzen. Nur sichtbar, wenn Karten in deiner Organisation aktiviert sind. |

Im selben Umschalter stellst du über **Zeitfenster-Dauer ändern** ein, in welchen Schritten das Raster unterteilt ist. Mit **Zeitfenster verkleinern** und **Zeitfenster vergrößern** zoomst du in das Raster hinein oder heraus. anny merkt sich die zuletzt gewählte Ansicht und den Zoom für dich persönlich.

Über **Verfügbarkeiten planen** wechselst du in den Planer-Modus. Dort legst du verfügbare Termine an und verschiebst sie per Drag-and-Drop. Mit **Planer-Modus verlassen** kehrst du zur normalen Ansicht zurück. Der Planer-Modus steht in den Ansichten Board und Karte nicht zur Verfügung.

<Frame>
  <img alt="Geöffneter Ansichten-Umschalter im Kalender mit dem Eintrag Verfügbarkeiten planen" />
</Frame>

### Filter

Über **Filter** oben rechts öffnest du ein Seitenpanel neben dem Kalender. Das Panel bleibt geöffnet, während du im Kalender arbeitest. So siehst du jede Änderung sofort.

Im Panel hast du folgende Möglichkeiten:

* **Schnellfilter**: Grenze die Ressourcen nach **Kategorien**, **Gruppe**, **Services**, **Live**, **Heute aktiv**, **Archiviert** oder **Tags** ein.
* **Mehr Filter**: Filtere zusätzlich nach Verfügbarkeit, Eigenschaften, Sichtbarkeit und, falls aktiviert, nach Check-In.
* **Suche**: Finde eine Ressource über ihren Namen.
* **Ressourcenauswahl**: Wähle einzelne Ressourcen aus der Liste aus. Ausgewählte Ressourcen stehen oben unter **Ausgewählt**. Mit **Alle abwählen** setzt du die Auswahl zurück.

Ausgewählte Ressourcen sortierst du unter **Ausgewählt** per Drag-and-Drop. Diese Reihenfolge bestimmt die Reihenfolge der Ressourcen im Kalender. Speichere sie in einer Ansicht, damit sie erhalten bleibt. Ohne eigene Auswahl zeigt der Kalender die Ressourcen in der Reihenfolge, die du in der Ressourcenliste festgelegt hast.

Der Kalender zeigt höchstens 30 Ressourcen gleichzeitig. Passen mehr Ressourcen zu deinem Filter, zeigt das Panel einen Hinweis. Entferne dann eine Ressource aus der Auswahl, bevor du eine andere hinzufügst.

Hat eine Ressource Unterressourcen, zeigt ihr Chip im Kalender ein Symbol. Mit **Unterressourcen von … anzeigen** blendet der Kalender die Unterressourcen dieser Ressource ein. Über **Zurück zur Ressourcenauswahl** kehrst du zu deiner vorherigen Auswahl zurück.

### Gespeicherte Ansichten

Eine gespeicherte Ansicht merkt sich deine Filter und deine Ressourcenauswahl. Du findest alle gespeicherten Ansichten als Tabs oben im Filter-Panel. Die Standardansicht heißt **Alle**.

<Note>
  Der Kalender und die Ressourcenliste teilen sich dieselben gespeicherten Ansichten. Eine Ansicht, die du im Kalender speicherst, steht dir auch in der Ressourcenliste zur Verfügung und umgekehrt. Welche Ansicht gerade aktiv ist, merken sich beide getrennt.
</Note>

So speicherst du eine neue Ansicht:

<Steps>
  <Step title="Filter einstellen">
    Öffne **Filter** und stelle die gewünschten Filter und die Ressourcenauswahl ein. Sobald du etwas änderst, erscheint im Panel der Button **Speichern**.
  </Step>

  <Step title="Als neue Ansicht speichern">
    Öffne das Menü am Button **Speichern** und wähle **Als neue Ansicht speichern**. Mit **Speichern** überschreibst du stattdessen die aktive Ansicht. Mit **Änderungen verwerfen** stellst du den gespeicherten Stand wieder her.
  </Step>

  <Step title="Namen vergeben und teilen">
    Gib im Fenster **Ansicht erstellen** einen Namen ein. Aktiviere **Geteilte Ansicht**, wenn alle Teammitglieder die Ansicht sehen sollen. Klicke auf **Ansicht speichern**.
  </Step>
</Steps>

Sobald die Ansicht gespeichert ist, wechselst du über den Tab im Filter-Panel mit einem Klick zu ihr. Private Ansichten erkennst du am Hinweis **Privat**.

Über das Menü am Tab einer Ansicht wählst du **Ansicht bearbeiten**, **Duplizieren** oder **Entfernen**. Die Reihenfolge der Tabs änderst du per Drag-and-Drop.

<Frame>
  <img alt="Filter-Panel mit geöffnetem Menü am Button Speichern und dem Eintrag Als neue Ansicht speichern" />
</Frame>

### Direktaktionen im Kalender

Ziehe mit der Maus einen Zeitraum in einer Ressourcenspalte auf. Es öffnet sich ein Menü mit drei Optionen:

* **Buchung anlegen**: Öffnet die Buchungserstellung mit dem gewählten Zeitraum und der Ressource (siehe unten).
* **Blocker erstellen**: Sperrt den gewählten Zeitraum für die Ressource. Mehr dazu unter [Globale Blocker erstellen und verwalten](/global-blockers).
* **Termin erstellen**: Legt einen verfügbaren Termin für die Ressource an. Mehr dazu unter [Verfügbare Termine](/available-slots).

Ein Klick auf eine Buchung öffnet ihre Details in einem Seitenpanel neben dem Kalender. Dort siehst du Ressource, Zeitraum, Kund:in und **Tags** der Buchung. Rechts daneben liegt die **Aktivität** mit Notizen und E-Mails. Offene Buchungen bestätigst oder lehnst du direkt im Panel ab. Ein Klick auf eine Bestellung in den Bestellungsansichten öffnet entsprechend die Bestellung.

#### Buchungen und Blocker verschieben

Einzelne Buchungen und Blocker verschiebst du per Drag-and-Drop auf eine andere Zeit oder eine andere Ressource. Über den Rand einer Buchung änderst du ihre Dauer. Vorbereitungs- und Nachbereitungszeiten passt du ebenfalls über ihren Rand an.

Bevor anny eine Buchung verschiebt, fragt ein Dialog nach deiner Bestätigung. Dort legst du fest:

* **Kunde benachrichtigen**: Die Kundin oder der Kunde erhält eine E-Mail zur Änderung.
* **Nachricht an den Kunden**: Optionaler Text, der in dieser E-Mail erscheint.

Beim Verschieben eines Blockers entfällt die Benachrichtigung.

<Note>
  Buchungen mit mehreren Plätzen, die im Kalender zusammengefasst sind, und ganze Bestellungen lassen sich nicht per Drag-and-Drop verschieben. Öffne dafür die Buchung oder die Bestellung und bearbeite sie dort.
</Note>

<Frame>
  <img alt="Dialog zum Verschieben einer Buchung mit der Option Kunde benachrichtigen" />
</Frame>

### Neue Buchung anlegen

Du startest eine neue Buchung auf drei Wegen:

* über **Neu** oben in der Leiste,
* mit der Taste **B** auf der Tastatur,
* über **Buchung anlegen** nach dem Aufziehen eines Zeitraums im Kalender.

Es öffnet sich das Fenster **Neue Bestellung**. Bietet deine Organisation Produkte oder Buchungspakete an, wählst du oben, was du hinzufügen möchtest: **Buchungen**, **Produkte** oder **Buchungspakete**. Es erscheinen nur die Tabs, für die es Angebote gibt. Ohne Produkte und Buchungspakete startet das Fenster direkt mit den Buchungen. Alles, was du auswählst, landet in einer gemeinsamen Bestellung.

<Tip>
  Mit **Strg+B** (Mac: **⌘+B**) öffnest du direkt das Fenster zum Erstellen eines Blockers.
</Tip>

#### Buchungsflow

Im Fenster **Neue Bestellung** gibt es zwei Wege zur Buchung. Im Ressourcen-Flow gehst du von einer konkreten Ressource aus. Im Service-Flow wählst du **Beliebig** und startest mit dem Service. Beide Wege bestehen aus drei Schritten.

Zu Beginn siehst du alle Ressourcen deiner Organisation, gruppiert nach Kategorien. Ganz oben steht **Beliebig**.

<Frame>
  <img alt="Fenster Neue Bestellung mit der Übersicht aller Ressourcen und der Karte Beliebig" />
</Frame>

**Ressourcen-Flow: konkrete Ressource auswählen**

<Steps>
  <Step title="Ressource wählen">
    Wähle die gewünschte Ressource aus der Übersicht. anny zeigt dir die Services dieser Ressource und wählt den ersten Service direkt aus.
  </Step>

  <Step title="Service und Zeitraum wählen">
    Wähle bei Bedarf einen anderen Service aus der Liste. Entscheide dann, ob du über **Verfügbar** einen freien Zeitraum auswählst oder über **Freie Eingabe** Datum und Uhrzeit selbst eingibst. Bei **Freie Eingabe** zeigt anny an, ob der Zeitraum verfügbar ist. Ist er belegt, kannst du die Buchung über **Trotzdem hinzufügen** dennoch anlegen.
  </Step>

  <Step title="Optionen ergänzen und Buchung hinzufügen">
    Füge optional einen **Titel**, **Notizen**, **Zusätzliche Optionen** und **Zusätzliche Ressourcen** hinzu. Klicke auf **Buchung hinzufügen**.
  </Step>
</Steps>

Sobald du die Buchung hinzugefügt hast, erscheint sie rechts unter **Bestelldetails**. Für weitere Buchungen in derselben Bestellung wiederholst du die Schritte.

<Frame>
  <img alt="Fenster Neue Bestellung mit gewählter Ressource, gewähltem Service, Zeitraum, Optionen und der Buchung unter Bestelldetails" />
</Frame>

**Service-Flow: Beliebig**

<Steps>
  <Step title="Beliebig wählen">
    Wähle **Beliebig** („Wählt automatisch“) aus der Ressourcen-Übersicht. anny zeigt dir alle Services, die mit mindestens einer Ressource verknüpft sind.
  </Step>

  <Step title="Service wählen">
    Wähle den gewünschten Service aus der Liste.
  </Step>

  <Step title="Zeitraum und Optionen wählen">
    Wähle Datum und Uhrzeit über **Verfügbar** oder **Freie Eingabe**. Füge optional **Titel**, **Notizen**, **Zusätzliche Optionen** und **Zusätzliche Ressourcen** hinzu. Klicke auf **Buchung hinzufügen**.
  </Step>
</Steps>

Unter **Bestelldetails** steht die Buchung zunächst mit **Beliebig**. Sobald die Bestellung abgeschlossen ist, siehst du die Buchung bei der Ressource, die anny ausgewählt hat.

<Frame>
  <img alt="Fenster Neue Bestellung mit Beliebig, gewähltem Service, Zeitraum, Optionen und der Buchung unter Bestelldetails" />
</Frame>

#### Kunde, Rabatt und Abschluss

In der Seitenleiste **Bestelldetails** siehst du alle Buchungen der Bestellung und den Gesamtbetrag. Dort schließt du die Bestellung ab:

* **Kunde hinzufügen**: Öffnet das Fenster **Personalisieren**. Suche die Kundin oder den Kunden über **Nach Name oder E-Mail suchen** oder lege über **Kunde erstellen** einen neuen Kunden an. Fülle bei Bedarf die weiteren Felder aus und klicke auf **Bestätigen**.
* **Rabatt hinzufügen**: Wähle im Feld rechts die Art des Rabatts. Mit **%** gibst du einen prozentualen Rabatt ein oder wählst eine der Schnellauswahlen 5 %, 10 %, 15 % oder 20 %. Mit **€** ziehst du einen festen Betrag ab. Mit **Code** löst du einen Rabatt- oder Gutscheincode ein, den du eintippst oder über **Code scannen** erfasst. Klicke auf **Rabatt anwenden**.
* **Individueller Preis**: Über den Stift an einer Buchung passt du ihren Preis an.

Klicke anschließend auf **Bestellung abschließen**. Es öffnet sich der Dialog **Bestellung abschließen?**. Dort legst du fest, was beim Speichern passiert:

| Option | Was sie bewirkt |
| :- | :- |
| **Bestätigung per E-Mail senden** | Die Kundin oder der Kunde erhält eine Buchungsbestätigung per E-Mail. Die Option ist nur aktiv, wenn du der Bestellung einen Kunden zugewiesen hast. |
| **Rechnung festschreiben** | anny vergibt eine Rechnungsnummer und sperrt die Rechnung gegen Änderungen. Ohne diese Option bleibt die Rechnung ein Entwurf, den du noch bearbeiten kannst. Die Option erscheint nur bei Bestellungen mit einem Betrag und ist nur mit zugewiesenem Kunden aktiv. |
| **Transparente Buchungen** | Die Buchungen belegen keine Kapazität. Die Ressource bleibt im gleichen Zeitraum für andere buchbar. Bei transparenten Buchungen bleibt die Rechnung ein Entwurf. |

Nutzt deine Organisation Kundensalden, erscheint zusätzlich **Zum Kundensaldo hinzufügen**. Mehr dazu unter [Kundensalden und Sammelrechnungen](/customer-balances-and-collective-invoices). Klicke auf **Speichern**. anny merkt sich deine Auswahl für die nächste Bestellung.

<Frame>
  <img alt="Dialog Bestellung abschließen mit den Optionen Bestätigung per E-Mail senden, Rechnung festschreiben und Transparente Buchungen" />
</Frame>

## Wann nutze ich das?

* **Du willst einen schnellen Überblick über alle Buchungen deiner Organisation**: Der Kalender zeigt dir auf einen Blick Auslastung und Verfügbarkeit.
* **Du verwaltest Buchungen für Kund:innen, die telefonisch oder vor Ort anfragen**: Über **Neu** oder die Taste **B** legst du Buchungen direkt an, ohne die Buchungsseite nutzen zu müssen.
* **Du arbeitest mit verschiedenen Ressourcentypen und brauchst unterschiedliche Perspektiven**: Über Filter und gespeicherte Ansichten erstellst du spezialisierte Arbeitsansichten für dein Team.
* **Du willst Termine kurzfristig umplanen**: Per Drag-and-Drop verschiebst du Buchungen und informierst die Kund:innen im selben Schritt.
* **Nicht geeignet für**: Wenn du Buchungen nach Status, Kund:in oder Tags durchsuchen und gesammelt bearbeiten willst, nutze die Liste **Buchungen**. Für Umsätze nutze die Bestellungsübersicht oder Exporte.

## Zusammenhang mit anderen Features

* **Buchungspakete und Produkte**: Beides fügst du im Fenster **Neue Bestellung** über die Tabs **Buchungspakete** und **Produkte** zur Bestellung hinzu. Die Tabs erscheinen nur, wenn deine Organisation Buchungspakete bzw. Produkte anbietet.
* **Blocker**: Blocker legst du direkt im Kalender an. Alle Blocker verwaltest du zusätzlich unter **Buchungen › Blocker**. Mehr dazu unter [Globale Blocker erstellen und verwalten](/global-blockers).
* **Verfügbare Termine**: Im Planer-Modus (**Verfügbarkeiten planen**) legst du verfügbare Termine an und verschiebst sie. Mehr dazu unter [Verfügbare Termine](/available-slots).
* **Karten**: Mit aktivierten Karten erscheint die Ansicht **Karte**. Mehr dazu unter [Interaktive 3D-Lagepläne](/maps-and-floor-plans).
* **Rabattcodes**: In der Buchungserstellung wendest du über **Rabatt hinzufügen** einen Rabattcode an. Mehr dazu unter [Rabattcodes](/discount-codes).
* **Aktivität**: Im Seitenpanel einer Buchung siehst du ihre Aktivität mit Notizen und E-Mails. Mehr dazu unter [Aktivitäts-Log](/activity-log).

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| :- | :- |
| Ansicht | Darstellungsformat des Kalenders. Wird pro Person gespeichert. |
| Zeitfenster-Dauer | Unterteilung des Zeitrasters |
| Zoom | Höhe bzw. Breite der Zeitfenster im Raster. Wird pro Person gespeichert. |
| Filter (Schnellfilter) | Ressourcen nach Kategorien, Gruppe, Services, Live, Heute aktiv, Archiviert oder Tags eingrenzen |
| Ressourcenauswahl | Einzelne Ressourcen auswählen und ihre Reihenfolge festlegen, maximal 30 gleichzeitig |
| Gespeicherte Ansichten | Filter und Ressourcenauswahl dauerhaft speichern, gemeinsam mit der Ressourcenliste |
| Geteilte Ansicht | Gespeicherte Ansicht für alle Teammitglieder sichtbar machen |
| Kunde benachrichtigen | Beim Verschieben einer Buchung eine E-Mail an die Kundin oder den Kunden senden |
| Bestätigung per E-Mail senden | Beim Abschließen einer neuen Bestellung eine Bestätigung an die Kundin oder den Kunden senden |
| Rechnung festschreiben | Beim Abschließen die Rechnung mit Rechnungsnummer festschreiben statt als Entwurf anzulegen |
| Transparente Buchungen | Buchungen anlegen, die keine Kapazität der Ressource belegen |

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Coworking-Betreiber filtert den Kalender auf eine Kategorie und speichert die Ansicht für sein Team">
    Ein Coworking-Space hat Meetingräume, Flex Desks und Phone Booths. Das Team an der Rezeption soll nur die Meetingräume sehen.

    <Steps>
      <Step title="Kalender öffnen und Filter setzen">
        Öffne den **Kalender** und klicke oben rechts auf **Filter**. Wähle unter **Kategorien** die Kategorie **Meetingraum** aus.
      </Step>

      <Step title="Als neue Ansicht speichern">
        Öffne im Filter-Panel das Menü am Button **Speichern** und wähle **Als neue Ansicht speichern**.
      </Step>

      <Step title="Ansicht für das Team teilen">
        Vergib einen Namen (z. B. „Meetingräume“), aktiviere **Geteilte Ansicht** und klicke auf **Ansicht speichern**.
      </Step>
    </Steps>

    Sobald die Ansicht gespeichert ist, wählt das Rezeptionsteam sie im Filter-Panel mit einem Klick aus.
  </Accordion>

  <Accordion title="Yoga-Studio legt über den Kalender eine neue Buchung für eine Kundin an">
    Eine Kundin ruft an und möchte einen Termin für eine Einzelstunde buchen. Die Rezeptionistin legt die Buchung direkt im Kalender an.

    <Steps>
      <Step title="Zeitraum im Kalender aufziehen">
        Ziehe in der Spalte der gewünschten Ressource (z. B. „Studio A“) den Zeitraum auf und wähle **Buchung anlegen**.
      </Step>

      <Step title="Service wählen">
        Wähle den Service (z. B. „Einzelstunde 60 Min“). Datum und Uhrzeit sind aus dem Kalender bereits übernommen. Klicke auf **Buchung hinzufügen**.
      </Step>

      <Step title="Kundin zuweisen">
        Klicke auf **Kunde hinzufügen** und wähle die Kundin aus.
      </Step>

      <Step title="Bestellung abschließen">
        Klicke auf **Bestellung abschließen**. Lass **Bestätigung per E-Mail senden** aktiviert und klicke auf **Speichern**.
      </Step>
    </Steps>

    Sobald die Bestellung gespeichert ist, erhält die Kundin eine Bestätigung per E-Mail.
  </Accordion>

  <Accordion title="Rezeption verschiebt einen Termin und informiert den Kunden">
    Ein Kunde bittet darum, seinen Termin um eine Stunde nach hinten zu verschieben.

    <Steps>
      <Step title="Buchung verschieben">
        Ziehe die Buchung im Kalender per Drag-and-Drop auf die neue Uhrzeit.
      </Step>

      <Step title="Kunden benachrichtigen">
        Aktiviere im Dialog **Kunde benachrichtigen** und ergänze optional eine **Nachricht an den Kunden**. Bestätige den Dialog.
      </Step>
    </Steps>

    Sobald du bestätigt hast, steht die Buchung zur neuen Zeit im Kalender und der Kunde erhält eine E-Mail.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Verfügbar und Freie Eingabe?">
    Bei **Verfügbar** wählst du aus den freien Zeiträumen der Ressource. Bei **Freie Eingabe** gibst du Datum und Uhrzeit selbst ein. anny prüft dann trotzdem, ob der Zeitraum frei ist, und fragt bei einer Überschneidung nach, ob du die Buchung dennoch anlegen willst. Wenn du einen Zeitraum im Kalender aufziehst, nutzt anny automatisch **Freie Eingabe**, damit dein Zeitraum genau übernommen wird.
  </Accordion>

  <Accordion title="Kann ich eine gespeicherte Ansicht nachträglich ändern?">
    Ja. Wähle die Ansicht im Filter-Panel aus, passe die Filter an und klicke auf **Speichern**. Namen und Freigabe änderst du über **Ansicht bearbeiten** im Menü am Tab.
  </Accordion>

  <Accordion title="Wer sieht meine gespeicherte Ansicht?">
    Eine private Ansicht siehst nur du. Eine **Geteilte Ansicht** sehen alle Teammitglieder. Da Kalender und Ressourcenliste dieselben Ansichten nutzen, erscheint sie an beiden Stellen.
  </Accordion>

  <Accordion title="Wo ist das Menü Neu+ mit Abos und Buchungspaketen geblieben?">
    Im neuen Admin öffnet **Neu** direkt das Fenster **Neue Bestellung**. Buchungspakete und Produkte fügst du dort über die Tabs **Buchungspakete** und **Produkte** hinzu. Die Tabs erscheinen nur, wenn deine Organisation Buchungspakete bzw. Produkte anbietet.
  </Accordion>

  <Accordion title="Warum sehe ich einzelne Unterressourcen nicht im Kalender?">
    Der Kalender fasst Ressourcen mit Unterressourcen oder einer Kapazität größer 1 zusammen. Du siehst Belegungszahlen, nicht jede Unterressource als eigene Spalte. Klicke auf das Symbol am Chip der Ressource und wähle **Unterressourcen von … anzeigen**. Räume und Sportplätze legst du deshalb am besten als eigene Ressourcen an. Mehr dazu unter [Ressourcen konfigurieren](/ressourcen-konfigurieren).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich sehe keine Buchungen im Kalender">
    Wahrscheinlich blendet ein Filter Ressourcen aus. Öffne **Filter** und prüfe Schnellfilter und Ressourcenauswahl. Setze die Filter zurück oder wechsle zur Ansicht **Alle**.
  </Accordion>

  <Accordion title="Unter Beliebig fehlt ein Service">
    Unter **Beliebig** erscheinen nur Services, die mit mindestens einer Ressource verknüpft sind. Buchungsoptionen, die nur zu einer einzelnen Ressource gehören, erscheinen dort nicht. Wähle in diesem Fall die konkrete Ressource aus.
  </Accordion>

  <Accordion title="Ich kann keine weitere Ressource auswählen">
    Der Kalender zeigt maximal 30 Ressourcen gleichzeitig. Entferne eine Ressource unter **Ausgewählt**, bevor du eine neue hinzufügst, oder teile deine Ressourcen auf mehrere gespeicherte Ansichten auf.
  </Accordion>

  <Accordion title="Die Ansicht Karte fehlt im Umschalter">
    Die Ansicht **Karte** erscheint nur, wenn Karten in deiner Organisation aktiviert sind und du berechtigt bist, Karten zu sehen. Mehr dazu unter [Interaktive 3D-Lagepläne](/maps-and-floor-plans).
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Gilt für Admin 3.0 (anny-ui Branch admin-next). Der Kalender ist ein Standard-UI-Element der Seitenleiste (Gruppe Buchungen), kein aktivierbares Feature, in allen Plänen verfügbar. Sichtbar mit Berechtigung, Buchungen zu sehen.
> * Layout: Datumsnavigation (Pfeile, **Heute**, Datumsauswahl) oben links in der Top-Bar; **Filter** oben rechts in der Top-Bar; Ansichten-Umschalter als schwebende Pill unten rechts (Tooltip **Ansicht ändern**), darin **Zeitfenster-Dauer ändern**, **Zeitfenster verkleinern**/**vergrößern**, **Verfügbarkeiten planen**.
> * Ansichten (DE-Labels): Tag, Woche, Monat, Timeline Tag, Timeline Woche, Timeline Monat, Board, Woche (Bestellungen), Tag (Bestellungen), Karte. Karte nur mit Feature Karten (resource-maps) und Berechtigung für Karten. Auf Mobilgeräten stattdessen Tag/Liste.
> * Ansicht, Zoom und aktive gespeicherte Ansicht werden als persönliche Nutzereinstellung gespeichert. Keine Einstellungen für Wochenenden ausblenden, stornierte Buchungen anzeigen oder Kalender-Zeitbereich (Raster immer 00:00 bis 24:00).
> * Planer-Modus (**Verfügbarkeiten planen**): nur mit Berechtigung, Termine zu erstellen; nicht in Board und Karte. Verfügbare Termine sind dort verschieb- und in der Dauer änderbar.
> * Filter-Panel = angedocktes Seitenpanel, bleibt offen; ein Klick auf eine Buchung ersetzt es durch das Buchungs-Panel. Schnellfilter: Kategorien, Gruppe, Services, Live, Heute aktiv, Archiviert, Tags. **Mehr Filter**: Verfügbarkeit von/bis, Eigenschaft, Sichtbarkeit, Check-In (nur mit Check-In-Feature). Maximal 30 Ressourcen-Spalten (Hinweis „Maximal 30 Ressourcen gleichzeitig …“ bzw. „Zeigt X von Y Ressourcen“).
> * Unterressourcen: kein Aufklappen in der Zeile mehr, sondern Drilldown über den Chip (**Unterressourcen von  anzeigen** / **Zurück zur Ressourcenauswahl**). Änderungen an der Auswahl während des Drilldowns gelten erst nach der Rückkehr.
> * Gespeicherte Ansichten sind dieselben wie die der Ressourcenliste (Bereich Ressourcen). Standard-Ansicht heißt **Alle** (früher „Default“), weitere Standard-Ansichten der Ressourcenliste: Live, Intern, Archiviert. Im Kalender gibt es keinen „+“-Tab; neue Ansichten nur über **Speichern** › **Als neue Ansicht speichern** bei geänderten Filtern. Privat = nur Ersteller:in, **Geteilte Ansicht** = Organisation.
> * Ressourcen-Reihenfolge: Die alten Chip-Drag-and-Drop oben im Kalender gibt es nicht mehr. Reihenfolge = Reihenfolge unter **Ausgewählt** im Filter-Panel (pro Ansicht gespeichert); ohne Auswahl die globale Reihenfolge aus der Ressourcenliste.
> * Zeitraum aufziehen → Menü: **Buchung anlegen** (öffnet Buchungserstellung mit Ressource und Zeitraum im Modus Freie Eingabe), **Blocker erstellen**, **Termin erstellen** (EN: Create available date).
> * Drag-and-Drop: nur Einzelbuchungen und Blocker (Zeit und Ressource), Dauer per Rand. Vorbereitungs-/Nachbereitungszeit per Rand ohne Bestätigungsdialog. Zusammengefasste Mehrfachbuchungen (Kapazität > 1) und Bestellungen sind NICHT verschiebbar; eine Bestellung als Ganzes verschieben ist im Kalender nicht möglich. Dialogtitel z. B. „Buchung auf neue Zeit verschieben?“; Optionen **Kunde benachrichtigen**, **Nachricht an den Kunden**. Blocker: kein Benachrichtigungs-Feld. Erfolgsmeldung **Buchung verschoben**.
> * Buchungs-Panel: volle Buchungsdetails inkl. Tags, rechts **Aktivität** (Notiz/E-Mail). Statusaktionen **Bestätigen**, **Ablehnen**, **Stornieren**.
> * Neu erstellen: ein Button **Neu** in der Top-Bar (Tooltip **Bestellung erstellen**) statt „Neu+“-Menü. Tastenkürzel: **B** = Buchungserstellung öffnen/schließen, **Strg/⌘+B** = Blocker erstellen. **N** ist kein globales Kürzel (gehört zu „Neu“ in Tabellen). Abos werden nicht mehr über dieses Menü angelegt.
> * Fenster **Neue Bestellung**: Tabs **Buchungen**, **Produkte**, **Buchungspakete** (Tab Produkte nur bei vorhandenen Zusatzoptionen, Tab Buchungspakete nur bei vorhandenen Buchungspaketen; ohne beides keine Tabs, direkt Buchungen); Schritte **Ressourcen** → **Services** → **Optionen**. **Beliebig** („Wählt automatisch“) zeigt Services mit mindestens einer verknüpften Ressource, ohne ressourcengebundene Buchungsoptionen; kein Zusammenhang mehr mit der Aktivierung des Service-First Flows im Buchungsflow des Admins. Zeitraum: **Verfügbar** / **Freie Eingabe**; bei belegtem Zeitraum Dialog **Zeitraum belegt** › **Trotzdem hinzufügen**. Bei konkreter Ressource wird der erste Service automatisch vorausgewählt. Optionen: **Titel** (Platzhalter „Buchungstitel“), **Notizen** (intern), **Zusätzliche Optionen** (Produkte), **Zusätzliche Ressourcen**, Child-Ressourcen. Button auf dem Desktop immer **Buchung hinzufügen** (mit Preis, z. B. „Buchung hinzufügen (€45.00)“); **Jetzt Buchen** gibt es nur in der mobilen Ansicht. Seitenleiste **Bestelldetails**: **Kunde hinzufügen** → Modal **Personalisieren** (**Nach Name oder E-Mail suchen**, **Kunde erstellen**, dynamisches Formular, **Bestätigen**); **Rabatt hinzufügen** mit Modi %, Währung (€) und Code, Schnellauswahl 5/10/15/20 %, im Code-Modus Eingabe „Gutscheincode eingeben“ oder **Code scannen**, Button **Rabatt anwenden**; individueller Preis per Stift; **Bestellung abschließen**.
> * Dialog **Bestellung abschließen?**: Checkboxen **Bestätigung per E-Mail senden** (Standard an, deaktiviert ohne Kund:in), **Rechnung festschreiben** (nur bei Betrag > 0; deaktiviert ohne Kund:in oder bei transparenten Buchungen; ohne sie bleibt die Rechnung ein Entwurf; bei Vorauszahlung standardmäßig an), **Transparente Buchungen** (Buchungen belegen keine Kapazität, Ressource bleibt buchbar, Rechnung bleibt Entwurf), **Zum Kundensaldo hinzufügen** (nur mit aktivierten Kundensalden, Betrag > 0 und Kund:in); dann **Abbrechen** oder **Speichern**. Die frühere „Glocke“ gibt es nicht mehr. Standardwerte der Checkboxen merkt sich anny pro Person.
> * Abgrenzung: Der Kalender ist nicht die Liste **Buchungen** (Tabellenansicht mit Filtern, Tags, Massenaktionen) und nicht /modify-bookings (Selbstservice der Kund:innen).


# Stornierungsbedingungen
Source: https://docs.anny.co/cancellation-policy

Lege fest, bis wann und zu welchen Kosten Kund:innen ihre Buchungen stornieren können.

Mit Stornierungsbedingungen steuerst du, ob und zu welchen Konditionen Kund:innen ihre Buchungen selbst stornieren können. Du definierst einen Stornierungszeitraum (bis wann ist eine Stornierung möglich) und legst gestaffelte Gebühren fest (zu welchen Kosten). Bei kostenpflichtigen Buchungen wird die Rückerstattung automatisch berechnet und verarbeitet.

## Wie funktioniert Stornierungsbedingungen?

Stornierungsbedingungen bestehen aus zwei Komponenten:

**Stornierungszeitraum**: Definiert, bis wann eine Stornierung überhaupt möglich ist. Außerhalb dieses Zeitraums wird der Button "Stornieren" für Kund:innen ausgeblendet. Du wählst eine Einheit (Minuten, Stunden oder Tage) und einen Bezugspunkt (vor Buchungsstart, nach Buchungsstart, vor Buchungsende, nach Buchungsende).

**Stornierungskonditionen**: Legen fest, ob die Stornierung kostenlos oder kostenpflichtig ist. Bei kostenpflichtigen Stornierungen definierst du Standardkosten (anteilig in Prozent vom Buchungspreis) und optional zusätzliche zeitabhängige Konditionen für gestaffelte Gebühren.

Die Logik der Stornierungskosten:

* 0% Stornierungskosten = vollständige Erstattung
* 50% Stornierungskosten = Teilerstattung (50% zurück)
* 100% Stornierungskosten = keine Erstattung

Mit zusätzlichen Konditionen staffelst du die Kosten zeitabhängig: Je kurzfristiger die Stornierung, desto höher können die Kosten sein.

### Rückerstattung als Wertgutschein

Bei online bezahlten Buchungen kannst du festlegen, dass die Rückerstattung nicht als Geldrückzahlung, sondern als Wertgutschein erfolgt. Das hält den Umsatz in deinem Unternehmen und ermöglicht Kund:innen eine schnellere Neubuchung.

Du konfigurierst pro Service, welcher Gutschein bei einer Stornierung verwendet wird. Es können verschiedene Gutscheintypen mit unterschiedlichen Einschränkungen verwaltet und zugeordnet werden. Kund:innen sehen in den Storno-Details auf der Buchungsseite, dass sie einen Gutschein statt einer Geldrückzahlung erhalten.

Nach einem Storno im Admin-Bereich wählst du Geld oder Wertgutschein im Korrektur-Dialog. Details: [Rechnung korrigieren](/invoice-corrections).

<Tip>
  Die Option "Stornieren als Gutschein" ist nur verfügbar, wenn die Original-Rechnung online bezahlt wurde.
</Tip>

## Wann nutze ich das?

* **Du möchtest kurzfristige Stornierungen verhindern oder verteuern**: Definiere gestaffelte Konditionen, die bei später Stornierung höhere Kosten berechnen.
* **Du bietest Kurse oder Events an und willst Umsatz bei Stornierungen sichern**: Aktiviere "Stornieren als Gutschein", damit Kund:innen statt Geld einen Wertgutschein für die nächste Buchung erhalten.
* **Du willst flexible Stornierungen ermöglichen, aber einen Zeitrahmen setzen**: Konfiguriere den Stornierungszeitraum so, dass nach einem bestimmten Zeitpunkt keine Stornierung mehr möglich ist.
* **Du hast kostenpflichtige Buchungen mit unterschiedlichen Konditionen je nach Vorlauf**: Kombiniere Standardkosten mit zeitabhängigen Konditionen für eine gestufte Gebührenstruktur.
* **Nicht geeignet für**: Kostenlose Buchungen ohne Zahlungsabwicklung. Dort reicht der Stornierungszeitraum ohne Konditionen.

## Zusammenhang mit anderen Features

* [**Änderung von Buchungen**](/modify-bookings): Stornierungsbedingungen und Buchungsbearbeitung werden im gleichen Tab konfiguriert. Die Buchungsbearbeitung kann als Alternative zur Stornierung positioniert werden (umbuchen statt stornieren).
* [**Dynamisches Pricing**](/dynamic-pricing): Stornierungskosten beziehen sich immer auf den tatsächlich berechneten Endpreis inklusive aller Preismodifikatoren.
* [**Buchungscodes & Pakete**](/booking-codes): Wertgutscheine, die bei "Stornieren als Gutschein" verwendet werden, lassen sich über die Gutscheinverwaltung konfigurieren.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Stornierungszeitraum | Bis wann Stornierung möglich ist (Einheit + Bezugspunkt) |
| Einheit | Minuten, Stunden oder Tage |
| Bezugspunkt | Vor/nach Buchungsstart oder vor/nach Buchungsende |
| Art der Stornierung | Kostenlos oder kostenpflichtig |
| Standardkosten (anteilig) | Prozentuale Stornierungsgebühr vom Buchungspreis |
| Konditionen | Zeitabhängige Staffelung der Kosten |
| Stornieren als Gutschein | Erstattung als Wertgutschein statt Geld (pro Service) |

<Tip>
  Wir empfehlen, **Stornierung möglich bis** auf **0 Stunden vor Buchungsstart** zu belassen. So bleibt der Stornieren-Button für Kund:innen immer sichtbar und du steuerst ausschließlich über die Konditionen darunter, zu welchen Kosten storniert werden darf. Das ist transparenter als den Button komplett auszublenden.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Yoga-Studio mit kostenloser Stornierung bis 12 Stunden vor Start und Gutschein-Erstattung">
    Ein Yoga-Studio möchte, dass Kund:innen bis 12 Stunden vor Kursbeginn kostenlos stornieren können. Danach soll keine Erstattung mehr erfolgen. Bei einer berechtigten Stornierung soll statt Geld ein Wertgutschein für den nächsten Kurs ausgegeben werden.

    <Steps>
      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen**, wähle die Yoga-Ressource und öffne die gewünschte **Buchungsoption**.
      </Step>

      <Step title="Tab Änderung und Stornierung öffnen">
        Navigiere zum Reiter **Änderung & Stornierung** und scrolle zum Bereich **Stornierung**.
      </Step>

      <Step title="Stornierungszeitraum belassen">
        Belasse **Stornierung möglich bis** auf **0 Stunden vor Buchungsstart** (Empfehlung), damit der Stornieren-Button bis zum Terminbeginn sichtbar bleibt.
      </Step>

      <Step title="Stornierung als Wertgutschein konfigurieren">
        Wähle im Dropdown **Stornierung als Wertgutschein** den gewünschten Gutscheintyp aus (z. B. "Wertgutschein").
      </Step>

      <Step title="Stornierungsbedingungen festlegen">
        Wähle unter Stornierungsbedingungen **Kostenpflichtige Stornierung**. Setze die **Standardmäßige Stornierungskosten (anteilig)** auf **0%** (kostenlose Stornierung als Standard).
      </Step>

      <Step title="Kondition hinzufügen">
        Klicke auf **+ Kondition hinzufügen**. Setze **Zeitraum vor Buchungsstart** auf **12 Stunden** und **Stornierungskosten (anteilig)** auf **100%** (keine Erstattung ab 12 Stunden vor Start).
      </Step>

      <Step title="Speichern und testen">
        Klicke auf **Speichern**. Erstelle eine Testbuchung und prüfe, ob bei Stornierung innerhalb der Frist ein Gutschein ausgestellt wird und ob ab 12 Stunden vor Start keine Erstattung erfolgt.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Raumbuchung mit gestaffelter Stornierungsgebühr">
    Ein Konferenzraum-Anbieter möchte gestaffelte Stornierungsgebühren: Bis 48 Stunden vor Start kostenlos, ab 48 Stunden 50% Gebühr, ab 24 Stunden keine Erstattung.

    <Steps>
      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen**, wähle den Konferenzraum und öffne die gewünschte **Buchungsoption**.
      </Step>

      <Step title="Tab Änderung und Stornierung öffnen">
        Navigiere zum Reiter **Änderung & Stornierung** und scrolle zum Bereich **Stornierung**.
      </Step>

      <Step title="Stornierungszeitraum belassen">
        Belasse **Stornierung möglich bis** auf **0 Stunden vor Buchungsstart** (Empfehlung).
      </Step>

      <Step title="Stornierungsbedingungen festlegen">
        Wähle **Kostenpflichtige Stornierung**. Setze die **Standardmäßige Stornierungskosten (anteilig)** auf **0%** (kostenlose Stornierung als Standard).
      </Step>

      <Step title="Erste Kondition hinzufügen">
        Klicke auf **+ Kondition hinzufügen**. Setze **Zeitraum vor Buchungsstart** auf **48 Stunden** und **Stornierungskosten (anteilig)** auf **50%**.
      </Step>

      <Step title="Zweite Kondition hinzufügen">
        Klicke erneut auf **+ Kondition hinzufügen**. Setze **Zeitraum vor Buchungsstart** auf **24 Stunden** und **Stornierungskosten (anteilig)** auf **100%** (keine Erstattung).
      </Step>

      <Step title="Speichern und testen">
        Klicke auf **Speichern**. Erstelle Testbuchungen und prüfe die Staffelung: mehr als 48h vorher (kostenlos), zwischen 48h und 24h (50% Gebühr), unter 24h (keine Erstattung).
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Stornierungszeitraum und Stornierungsbedingungen?">
    Der Stornierungszeitraum bestimmt, OB eine Stornierung möglich ist (Button sichtbar oder nicht). Die Stornierungsbedingungen bestimmen, ZU WELCHEN KOSTEN storniert werden kann, solange der Zeitraum noch offen ist.
  </Accordion>

  <Accordion title="Wann werden die Stornierungskosten für eine Buchung festgelegt?">
    Die Konditionen werden zum Zeitpunkt der Buchung gespeichert. Wenn du die Einstellungen später änderst, gelten die neuen Konditionen nur für zukünftige Buchungen, nicht für bestehende.
  </Accordion>

  <Accordion title="Kann ich auch nach Buchungsstart noch eine Stornierung ermöglichen?">
    Ja. Wähle als Bezugspunkt "nach Buchungsstart" oder "vor Buchungsende", um den Stornierungszeitraum über den Start hinaus offen zu halten.
  </Accordion>

  <Accordion title="Wann ist die Option Stornieren als Gutschein verfügbar?">
    Nur wenn die Original-Rechnung online bezahlt wurde. Bei Offline-Zahlungen oder kostenlosen Buchungen ist die Option nicht verfügbar.
  </Accordion>

  <Accordion title="Können verschiedene Services unterschiedliche Gutscheine verwenden?">
    Ja. Du konfigurierst pro Service, welcher Gutscheintyp bei einer Stornierung als Erstattung verwendet wird. So kannst du z. B. für Kurse einen Kursgutschein und für Räume einen Raumgutschein hinterlegen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kund:innen sehen den Button Stornieren nicht">
    Der Stornierungszeitraum ist überschritten. Prüfe die Einstellung unter Stornierungszeitraum. In den meisten Fällen ist "0 Stunden vor Buchungsstart" die passende Einstellung, damit der Button bis zum Termin sichtbar bleibt.
  </Accordion>

  <Accordion title="Die Stornierungskosten wurden nicht korrekt berechnet">
    Die Konditionen werden zum Buchungszeitpunkt festgelegt. Wenn die Einstellungen zwischenzeitlich geändert wurden, verwenden bestehende Buchungen noch die alten Konditionen. Nur neue Buchungen übernehmen die aktualisierten Einstellungen.
  </Accordion>

  <Accordion title="Die Option Stornieren als Gutschein wird nicht angezeigt">
    Prüfe, ob die Original-Rechnung online bezahlt wurde (Voraussetzung). Stelle außerdem sicher, dass im betreffenden Service ein Gutschein für "Stornieren als Gutschein" konfiguriert ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Ressourcen** → Buchungsoption → Tab **Änderung & Stornierung**
> * Stornierungszeitraum ≠ Stornierungsbedingungen: Zeitraum = OB storniert werden kann (Button-Sichtbarkeit), Bedingungen = ZU WELCHEN KOSTEN
> * Stornierungskosten (anteilig) = % vom Buchungspreis. Erstattung = 100% minus Kosten.
> * Konditionen werden zum Buchungszeitpunkt festgelegt, nicht bei nachträglicher Einstellungsänderung
> * Bezugspunkte: vor Buchungsstart, nach Buchungsstart, vor Buchungsende, nach Buchungsende
> * Einheiten: Minuten, Stunden, Tage
> * "Stornieren als Gutschein": nur wenn Original-Rechnung online bezahlt wurde. Konfiguration pro Service unter Stornierung. Kund:innen sehen in Storno-Details auf der Buchungsseite, dass Gutschein statt Geld erstattet wird.
> * Bei mehreren Konditionen: die spezifischere (kurzfristigere) Kondition greift, wenn ihr Zeitfenster erreicht ist
> * Verwandte Artikel: /modify-bookings, /buchungsoption-konfigurieren, /booking-codes (Wertgutscheine)


# Zertifikate
Source: https://docs.anny.co/certificates

Stelle Teilnehmer:innen automatisch personalisierte Zertifikate und Nachweise für Seminare oder Workshops aus.

Mit Zertifikaten generierst du personalisierte Urkunden, Bescheide oder Testnachweise für deine Kund:innen direkt aus einer Buchung heraus. Der Versand erfolgt entweder automatisch nach dem Termin oder manuell über die Buchungsdetails.

<Info>
  Aktiviere vorab **Tests & Zertifikate** unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktionieren Zertifikate?

Du definierst im Vorfeld mögliche Ergebnisse (z. B. "Erfolgreich teilgenommen" oder "Bestanden"), gestaltest das Zertifikat mit eigenem Text und Hintergrundbild und legst fest, ob der Versand automatisch oder manuell erfolgt.

Der Ablauf im Überblick:

1. Du legst ein Zertifikat an einem Service an (Reiter **Zertifikate**).
2. Du definierst Ergebnisoptionen und gestaltest das Dokument.
3. Nach dem Termin wird das Ergebnis entweder automatisch nach einer konfigurierbaren Verzögerung veröffentlicht oder du trägst es manuell in den Buchungsdetails ein.
4. Kund:innen erhalten das Zertifikat per E-Mail und können es im Kundenprofil abrufen.

<Warning>
  Das Zertifikat muss vollständig angelegt und konfiguriert sein, bevor der Service live geschaltet wird und die ersten Buchungen eingehen. Nachträgliches Anwenden auf bestehende Buchungen ist nicht möglich.
</Warning>

## Wann nutze ich das?

* **Du bietest Fortbildungen oder Fachseminare an**: Stelle gesetzliche oder branchenspezifische Nachweise mit individuellen Leistungspunkten aus.
* **Du leitest Workshops oder Kurse**: Biete Teilnahmebescheinigungen als professionellen Abschluss.
* **Du betreibst ein Prüfungszentrum**: Dokumentiere Testergebnisse rechtssicher und versende sie automatisch.
* **Nicht geeignet für**: Einfache Buchungsbestätigungen ohne Ergebnis oder Nachweis. Dafür reichen die Standard-E-Mail-Templates.

## Zusammenhang mit anderen Features

* **Check-In & Check-Out**: Die Check-in-Funktion muss an der Ressource aktiviert sein, damit der Zertifikate-Reiter im Service erscheint.
* **Eigene Formulare**: Über zusätzliche Datenfelder im Zertifikat kannst du Werte erfassen, die später auf dem Dokument erscheinen (z. B. "Erreichte Punkte").

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Name | Bezeichnung des Zertifikats |
| Ergebnisoptionen | Mögliche Ergebnisse (z. B. Bestanden, Teilgenommen) |
| Weitere Daten erfassen | Zusätzliche Felder pro Teilnehmer:in |
| Zertifikatstyp | Zertifikat oder Nachweis |
| Ressourcennamen anzeigen | Name der Ressource auf dem Dokument |
| QR-Code zur Validierung | Prüfbarer QR-Code auf dem Zertifikat |
| Informationen zum Zertifikat | Freitextfeld für Beschreibung |
| Hintergrundbild | DIN-A4-Format (210 x 297 mm) |
| Automatisch veröffentlichtes Ergebnis | Standard-Ergebnis + Verzögerung |
| Kunde benachrichtigen | E-Mail-Versand bei Veröffentlichung |
| Download validieren | Authentifizierung per Geburtsdatum |

Die Einstellungen findest du unter **Services** → Service auswählen → Reiter **Zertifikate** → **+ Test hinzufügen**.

<Tip>
  Das Hintergrundbild muss exakt im DIN-A4-Format (210 x 297 mm) vorliegen. Nutze dein Firmenbriefpapier für ein professionelles Erscheinungsbild.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Fortbildungsinstitut stellt Teilnahmebescheinigungen mit individuellen Punkten aus">
    Ein Institut bietet Brandschutz-Seminare an und muss pro Teilnehmer:in individuelle Leistungspunkte auf dem Zertifikat vermerken.

    <Steps>
      <Step title="Zertifikat anlegen">
        Öffne **Services** → Service "Brandschutz-Seminar" → Reiter **Zertifikate** → **+ Test hinzufügen**.
      </Step>

      <Step title="Ergebnis und Datenfelder konfigurieren">
        Trage als Name "Teilnahmebescheinigung Brandschutz" ein. Lege unter **Ergebnisoptionen** den Wert "Erfolgreich teilgenommen" an. Klicke auf **+ Weitere Daten erfassen** und füge ein Feld "Erreichte Punkte" hinzu.
      </Step>

      <Step title="Zertifikat gestalten">
        Wähle als **Zertifikatstyp** den Wert "Zertifikat". Aktiviere **Ressourcennamen anzeigen** und **QR-Code zur Validierung**. Lade dein Firmenbriefpapier als Hintergrundbild hoch.
      </Step>

      <Step title="Versand konfigurieren und speichern">
        Setze den Haken bei **Kunde benachrichtigen** und klicke auf **Speichern**. Nach dem Seminar trägst du die Punkte pro Teilnehmer:in in den Buchungsdetails ein und veröffentlichst das Ergebnis manuell.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Ein Yoga-Studio versendet Teilnahmeurkunden automatisch">
    Ein Studio möchte allen Retreat-Teilnehmer:innen ohne manuellen Aufwand eine Urkunde zusenden.

    <Steps>
      <Step title="Zertifikat anlegen">
        Öffne **Services** → Service "Yoga-Retreat" → Reiter **Zertifikate** → **+ Test hinzufügen**.
      </Step>

      <Step title="Automatisches Ergebnis aktivieren">
        Trage als Name "Urkunde Yoga-Retreat" ein. Lege als Ergebnisoption "Teilgenommen" an. Aktiviere **Automatisch veröffentlichtes Ergebnis**, wähle "Teilgenommen" als Standard und setze die Verzögerung auf "1 Tag".
      </Step>

      <Step title="Typ und Versand konfigurieren">
        Setze den **Zertifikatstyp** auf "Nachweis". Aktiviere **Kunde benachrichtigen** und klicke auf **Speichern**.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Können Zertifikate nachträglich für alte Buchungen aktiviert werden?">
    Nein. Das Zertifikat muss fertig eingerichtet sein, bevor die erste Buchung für diesen Service eingeht.
  </Accordion>

  <Accordion title="Wo finden Kund:innen ihr Zertifikat?">
    Kund:innen erhalten eine E-Mail mit einem Button zum Abruf. Alternativ finden sie es im Kundenprofil unter **Buchungen** → vergangene Buchungen filtern → Buchung auswählen → **Zertifikat anzeigen**.
  </Accordion>

  <Accordion title="Welches Format muss das Hintergrundbild haben?">
    Exakt DIN-A4 (210 x 297 mm). Andere Formate werden nicht korrekt dargestellt.
  </Accordion>

  <Accordion title="Kann ich das Zertifikat auch manuell ausstellen?">
    Ja. Deaktiviere die Option für das automatische Ergebnis. Dann legst du das Ergebnis pro Teilnehmer:in in den Buchungsdetails manuell fest und löst den Versand dort aus.
  </Accordion>

  <Accordion title="Kann ich ein Zertifikat erneut an Kund:innen senden?">
    Ja. In der Buchungsdetailansicht kannst du das Zertifikat jederzeit erneut verschicken.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Reiter 'Zertifikate' wird in meinem Service nicht angezeigt">
    Prüfe zwei Voraussetzungen: 1) Das Feature **Tests & Zertifikate** muss unter **Account-Einstellungen** → **Features** aktiviert sein. 2) Die **Check-in-Funktion** muss an der verknüpften Ressource (Reiter: Check-in) eingeschaltet sein.
  </Accordion>

  <Accordion title="Kund:innen haben keine E-Mail mit dem Zertifikat erhalten">
    Stelle sicher, dass in den Zertifikatseinstellungen der Haken bei **Kunde benachrichtigen** gesetzt ist. Bei manuellen Zertifikaten: Prüfe in den Buchungsdetails, ob das Ergebnis tatsächlich veröffentlicht wurde.
  </Accordion>

  <Accordion title="Der Download des Zertifikats funktioniert nicht">
    Wenn **Download validieren** aktiviert ist, müssen Kund:innen ihr Geburtsdatum exakt so eingeben, wie sie es im Checkout hinterlegt haben. Prüfe, ob das Geburtsdatum im Kundenprofil korrekt vorliegt.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Services** → Service → Reiter **Zertifikate** → **+ Test hinzufügen**
> * Voraussetzungen: Feature "Tests & Zertifikate" unter Account-Einstellungen → Features aktiviert UND Check-in an der Ressource eingeschaltet.
> * Buchungsoption muss als Service angelegt sein (nicht als reine Buchungsoption).
> * Zertifikat MUSS vor der ersten Buchung fertig konfiguriert sein. Kein nachträgliches Anwenden möglich.
> * Automatischer Versand: Verzögerung zählt ab Check-in oder Terminende.
> * Download validieren: Kund:innen authentifizieren sich per Geburtsdatum aus dem Checkout.
> * Hintergrundbild: exakt DIN-A4 (210 x 297 mm).
> * Admin kann Zertifikate in der Buchungsdetailansicht einsehen und erneut versenden.
> * Verfügbar in allen Plänen (Feature muss nur aktiviert werden).


# Anwesenheit in den Buchungsdetails
Source: https://docs.anny.co/check-in-booking-details

Checke Buchungen im Adminbereich manuell ein und aus und sieh die Anwesenheitshistorie.

Im Abschnitt **Anwesenheit** einer Buchung siehst du, wer eingecheckt oder ausgecheckt hat, und du kannst das selbst auslösen. Jede Aktion hinterlässt einen Eintrag mit Zeitpunkt, Status und der Person, die den Vorgang ausgeführt hat.

Das ist der Weg, wenn kein QR-Ticket vorliegt oder du die Anwesenheit nach einer manuellen Änderung nachziehen willst.

<Info>
  Das Feature muss vorab aktiviert werden: **Avatar** (oben rechts) → **Account-Einstellungen** → **Features** → **Check-In & Check-Out**. Zusätzlich aktivierst du pro Ressource **Buchungen ein- und auschecken**.
</Info>

## Typische Anwendungsfälle

| Szenario | Beschreibung |
| :- | :- |
| **Ohne Ticket einchecken** | Die Buchung wurde manuell angelegt oder das Ticket fehlt. Du markierst die Person in den Buchungsdetails als anwesend. |
| **Historie prüfen** | Du siehst, wann eingecheckt oder ausgecheckt wurde, welchen Status der Eintrag hat und von wem er stammt. |
| **Platz wieder freigeben** | Nach dem Checkout kannst du den Slot für andere Buchungen öffnen, wenn die Ressource **Kapazität nach Checkout wieder freigeben** aktiviert hat. |

## Wie Anwesenheit funktioniert

Jeder Check-In und jeder Check-Out erzeugt einen Eintrag in **Anwesenheit**. Die Buchung speichert daraus den aktuellen Check-In-Zeitpunkt und, falls vorhanden, den Check-Out-Zeitpunkt.

Für den aktuellen Stand zählen Einträge mit Status **Gültig** oder **Unbezahlt**. Der neueste solche Check-In setzt den Check-In-Zeitpunkt. Ein Check-Out zählt nur, wenn er nach diesem Check-In liegt.

Löschst du einen Eintrag über das Kreuz, berechnet anny die Zeitpunkte neu.

### Wann der Abschnitt sichtbar ist

Der Abschnitt **Anwesenheit** erscheint in den Buchungsdetails, wenn alle Punkte zutreffen:

* Die Buchung ist bearbeitbar und kein Blocker.
* Die Buchung hat eine Ressource.
* Für die Ressource ist **Buchungen ein- und auschecken** aktiv.

Er fehlt zum Beispiel bei Blockern, Buchungsfolgen und Buchungen, die du nicht bearbeiten darfst.

### Wann die Buttons sichtbar sind

**Einchecken** und **Auschecken** erscheinen, wenn du die Berechtigung **Check-In und Check-Out** hast. In den Buchungsdetails stehen beide Buttons gleichzeitig. Sie werden nicht ausgegraut, weil der Termin noch in der Zukunft liegt oder schon vorbei ist.

Der **Admin Check-In Zeitraum** der Ressource gilt beim Scannen eines QR-Tickets. Er sperrt die Buttons in den Buchungsdetails nicht.

**Auschecken** schlägt fehl, wenn gerade niemand eingecheckt ist. Es entsteht dann kein neuer Eintrag.

Klickst du **Einchecken**, obwohl schon ein aktiver Check-In existiert, erscheint ein Eintrag mit Status **Bereits gescannt**. Der Check-In-Zeitpunkt der Buchung bleibt unverändert. Mit **Mehrfach Check-In erlauben** ist ein weiterer gültiger Check-In erst nach einem Checkout möglich.

## In den Buchungsdetails ein- und auschecken

<Steps>
  <Step title="Feature und Ressource prüfen">
    Aktiviere **Check-In & Check-Out** in den Account-Einstellungen. Öffne danach die Ressource und schalte unter **Check-In** die Option **Buchungen ein- und auschecken** ein.
  </Step>

  <Step title="Buchung öffnen">
    Gehe zu **Buchungen**, öffne die gewünschte Buchung und scrolle zum Abschnitt **Anwesenheit**.
  </Step>

  <Step title="Einchecken oder auschecken">
    Klicke **Einchecken**, um die Person als anwesend zu markieren. Klicke **Auschecken**, wenn sie den Ort verlassen hat und bereits eingecheckt ist.
  </Step>
</Steps>

Sobald der Vorgang geklappt hat, erscheint ein neuer Eintrag in der Historie und die Buchung übernimmt den aktuellen Check-In- oder Check-Out-Zeitpunkt.

## Einstellungen & Optionen

Diese Ressourcen-Einstellungen unter **Ressource** → **Check-In** beeinflussen, wie Anwesenheit erfasst wird:

| Einstellung | Wirkung in den Buchungsdetails |
| - | - |
| **Buchungen ein- und auschecken** | Ohne diese Option gibt es den Abschnitt **Anwesenheit** nicht. |
| **Admin Check-In Zeitraum** | Steuert, wann ein QR-Scan zu früh oder zu spät ist. Die Buttons in den Buchungsdetails bleiben trotzdem klickbar. |
| **Mehrfach Check-In erlauben** | Erlaubt nach einem Checkout einen weiteren gültigen Check-In. Sonst bleibt ein zweiter Check-In **Bereits gescannt**. |
| **Kapazität nach Checkout wieder freigeben** | Setzt das Buchungsende auf den Checkout-Zeitpunkt, wenn dieser nach dem geplanten Start liegt und vor dem ursprünglichen Ende. |
| **Self Check-In** | Gilt für Gäste in App und Buchungsseite, nicht für die Admin-Buttons. |

## Einschränkungen

* In den Buchungsdetails gibt es keinen eigenen Status „nicht erschienen“.
* Die Buttons fragen keine Formulare oder rechtlichen Dokumente ab, die erst beim Check-in fällig sind. Fehlen solche Angaben, schlägt **Einchecken** hier fehl. Nutze dann das Check-In-Terminal oder den Self-Check-In.
* **Auschecken** funktioniert nur bei einem aktiven Check-In.
* Der Abschnitt erscheint nicht bei Blockern und nicht bei Buchungen, die du nicht bearbeiten darfst.

## FAQ

<AccordionGroup>
  <Accordion title="Wann sehe ich den Abschnitt Anwesenheit?">
    Wenn Check-In & Check-Out im Account aktiv ist, die Ressource **Buchungen ein- und auschecken** eingeschaltet hat und die Buchung bearbeitbar ist. Blocker und nicht bearbeitbare Buchungen zeigen den Abschnitt nicht.
  </Accordion>

  <Accordion title="Warum sind Einchecken und Auschecken beide sichtbar?">
    In den Buchungsdetails stehen beide Aktionen immer bereit, sobald du die Berechtigung **Check-In und Check-Out** hast. anny graut sie nicht aus, wenn der Termin noch nicht begonnen hat. **Auschecken** erzeugt nur dann einen Eintrag, wenn gerade ein Check-In aktiv ist.
  </Accordion>

  <Accordion title="Gilt der Admin Check-In Zeitraum auch hier?">
    Nein. Dieser Zeitraum gilt, wenn du ein QR-Ticket scannst. In den Buchungsdetails kannst du unabhängig davon einchecken. Ein zu früher oder zu später Scan erscheint in der Historie mit **Zu frühes einchecken** oder **Zu spätes einchecken** und ändert den Anwesenheitszeitpunkt der Buchung nicht.
  </Accordion>

  <Accordion title="Kann ich einen Check-In rückgängig machen?">
    Ja. Lösche den Eintrag über das Kreuz in der Zeile. anny berechnet Check-In- und Check-Out-Zeitpunkt danach neu.
  </Accordion>

  <Accordion title="Was bedeutet Bereits gescannt?">
    Es gab schon einen aktiven Check-In. Der neue Versuch wird protokolliert, ändert den Check-In-Zeitpunkt der Buchung aber nicht. Checke zuerst aus, wenn **Mehrfach Check-In erlauben** aktiv ist und ein erneuter Eintritt gelten soll.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Abschnitt Anwesenheit fehlt">
    Ursache: Feature, Ressource oder Buchungstyp passen nicht. Aktiviere **Check-In & Check-Out** und **Buchungen ein- und auschecken**. Prüfe, dass es keine Blocker-Buchung ist und dass du die Buchung bearbeiten darfst.
  </Accordion>

  <Accordion title="Die Buttons Einchecken und Auschecken fehlen">
    Ursache: Es fehlt die Berechtigung **Check-In und Check-Out**. Passe die Rolle unter **Avatar** → **Admin-Nutzer verwalten** → **Rollen** an.
  </Accordion>

  <Accordion title="Auschecken schlägt fehl">
    Ursache: Es gibt keinen aktiven Check-In. Checke zuerst ein oder prüfe, ob der letzte gültige Check-In schon ausgecheckt oder gelöscht wurde.
  </Accordion>

  <Accordion title="Einchecken schlägt fehl, obwohl der Button da ist">
    Ursache: Oft fehlen Angaben, die erst beim Check-in fällig sind, oder die Buchung ist nicht angenommen. Schließe Formulare oder Dokumente am Check-In-Terminal oder per Self-Check-In ab. Nimm die Buchung an, falls sie noch als Anfrage offen ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: Menüleiste → **Buchungen** → Buchung → Panel **Anwesenheit**. Overflow-Menü hat dieselben Aktionen, ist aber zusätzlich an Status „angenommen“ gekoppelt.
> * Presence logs = `scans` (scan\_type `check_in` / `check_out`). `Booking.check_in_date` = max created\_at der Check-Ins mit Status `valid` oder `unpaid`. `check_out_date` = max Check-Out nach diesem Zeitpunkt, sonst null. Delete und Save rufen `updatePresenceDates`.
> * Abschnitt sichtbar: `booking.isEditable && !isBlocker && resource && resource.settings.checkIn.isEnabled`. isEditable false bei external\_calendar\_id, status reserved, is\_sequence, protected channel, IS\_READ\_ONLY.
> * Buttons sichtbar: `user.can('create', 'scans')`. Kein `:disabled`. Beide Buttons immer parallel.
> * Abschnitt-Felder: `is_editable`, `is_blocker`, relationship `resource`, included `resource.settings.checkIn.isEnabled`. Buttons: `user.can('create', 'scans')`. Historie: Scan `scan_type`, `status`, `created_at`, `device_identifier`, included `scanner`. Buchung `check_in_date` / `check_out_date`.
> * Endpoints Presence-Card: GET /api/v1/bookings/ (include resource); GET /api/v1/bookings//scans?include=scanner\&sort=-createdAt; POST /api/v1/bookings//check-in|check-out body `{ data: {} }`; DELETE /api/v1/scans/. QR: POST /api/v1/scans. Delayed form: GET /api/ui/booking-check-in-form?booking=.
> * Admin `POST /api/v1/bookings/{id}/check-in|check-out` → createScan mit `validate(true)` (ignoreTiming). QR `POST /scans` nutzt Admin-Fenster allowedAdvancePeriod/allowedDelayPeriod → Status too\_early/too\_late, Scan wird trotzdem gespeichert, Presence-Daten nicht. Self-Check-In nutzt selfCheckIn.disabledUntil/allowedUntil und wirft Exceptions.
> * Checkout ohne aktiven Check-In: HTTP 400 `scans.not_checked_in`. Zweites Check-In: Status `scanned`, Presence unverändert. Unpaid zählt für Presence. Status nicht accepted → `invalid`.
> * `X-Supports-Dynamic-Form: true` am Booking-Action: fehlende form\_data → 200 + meta.status `requires_details` + meta.form\_url. Ohne Header → 400 `scans.check_in_requires_details_unsupported`. POST /scans mit Header erzeugt Scan-Status `requires_details` (Booking noch nicht eingecheckt). Admin-Details senden den Header heute nicht. Spec: /developers/guides/admin/booking-lifecycle#x-supports-dynamic-form.
> * Kein No-Show-Status in dieser UI. Figma-Zustände (Too early disabled, Remind guest, No show) sind nicht gebaut (CU-86cazprgg).
> * releaseOnCheckout: end\_date/blocker\_end\_date auf Checkout, nur wenn Checkout nach start\_date und vor bisherigem end\_date.
> * Verwandte Artikel: /check-in-overview, /check-in-setup, /roles-and-permissions, /custom-forms, /legal-documents. API: /developers/guides/admin/booking-lifecycle, /developers/models/scans.


# Check-In & Check-Out
Source: https://docs.anny.co/check-in-overview

Steuere den Einlass per QR-Code, verwalte Kapazitäten in Echtzeit und frage Formulare erst beim Check-in ab.

Mit Check-In & Check-Out steuerst du den Einlass zu deinen Ressourcen per QR-Code-Ticket. Du entscheidest pro Ressource, ob bei einer Buchung ein Ticket ausgestellt wird und wie der Check-in-Prozess abläuft. So behältst du die Übersicht über Anwesenheiten, steuerst Kapazitäten in Echtzeit und kannst Formulare oder rechtliche Dokumente gezielt erst beim Check-in abfragen.

<Info>
  Das Feature muss vorab aktiviert werden: **Avatar** (oben rechts) → **Account-Einstellungen** → **Features** → **Check-In & Check-Out**.
</Info>

## Wie funktioniert Check-In & Check-Out?

Nach der Aktivierung konfigurierst du den Check-in pro Ressource unter dem Reiter **Check-In**. Kund:innen erhalten bei der Buchung ein QR-Code-Ticket, das beim Eintritt gescannt wird.

### Check-In-Methoden

| Methode | Beschreibung |
| - | - |
| Handscanner oder Kamera | QR-Code-Ticket per Handscanner oder Gerätekamera einscannen |
| Suche ohne Ticket | Im Check-In-Bereich über die Suche die Buchung finden und manuell einchecken |
| Manuell in Buchungsdetails | Check-In direkt in den [Buchungsdetails](/check-in-booking-details) auslösen (z. B. nach manueller Änderung) |
| Automatisch bei Kartenzahlung vor Ort | Nimmst du die Zahlung über ein Kartenlesegerät entgegen, checkt anny akzeptierte Buchungen der Bestellung zum Startzeitpunkt ein, sofern Check-In auf der Ressource aktiv ist |

## Wann nutze ich das?

* **Du willst den Besucherstrom an Eingängen steuern**: Begrenze die Buchungen pro Startzeit und nutze QR-Tickets für einen kontrollierten Einlass.
* **Du brauchst Echtzeit-Übersicht über Anwesenheiten**: Check-In und Check-Out zeigen dir, wer gerade vor Ort ist.
* **Du willst Formulare oder Unterschriften erst vor Ort abfragen**: Nutze die verzögerte Abfrage beim Check-in.
* **Du verwaltest Besucher:innen und willst Hosts sofort benachrichtigen**: Aktiviere SMS- und Anruf-Benachrichtigungen beim Check-in.
* **Nicht geeignet für**: Rein digitale Buchungen ohne physischen Zugang (z. B. Online-Termine, Video-Calls).

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| QR-Code-Ticket | Pro Ressource aktivierbar |
| Check-In-Zeitraum | Zeitfenster, in dem der Check-in möglich ist |
| Mehrfach-Check-In | Wiedereintritt während der Buchungszeit erlauben |
| Kapazität freigeben | Nach Check-Out wird der Slot für andere Buchungen frei |
| Buchungen pro Startzeit | Begrenzt die gleichzeitigen Ankünfte |
| Verzögerte Formularabfrage | Formulare/Dokumente erst beim Check-in (BETA) |
| Host-Benachrichtigung (SMS/Anruf) | Beim Besucher-Check-in den Host informieren |

<Tip>
  Mit "Kapazität freigeben" gibst du nach einem Check-Out ungenutzte Slots automatisch für andere Buchungen frei. Das ist besonders bei flexiblen Daueroptionen (z. B. Schwimmbäder, Bibliotheken) nützlich.
</Tip>

## Use Cases

<CardGroup>
  <Card title="Besucherverwaltung" icon="users" href="/visitor-management">
    Besucher:innen am Empfang per QR-Code einchecken und Hosts sofort benachrichtigen.
  </Card>

  <Card title="Universitätsbibliothek" icon="book-open" href="/check-in-university">
    Lernplätze per Check-in verwalten und Kapazitäten in Echtzeit steuern.
  </Card>

  <Card title="Ticketing & Events" icon="ticket" href="/check-in-ticketing-events">
    Teilnehmer:innen am Einlass scannen und Formulare erst vor Ort abfragen.
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Muss ich für jede Ressource ein QR-Code-Ticket aktivieren?">
    Nein. Du entscheidest pro Ressource, ob ein QR-Code-Ticket bei der Buchung ausgestellt wird. Ressourcen ohne Ticket-Aktivierung haben keinen Check-in-Prozess.
  </Accordion>

  <Accordion title="Kann ich den Check-in auch ohne QR-Code durchführen?">
    Ja. Über die Suche im Check-In-Bereich oder direkt in den [Buchungsdetails](/check-in-booking-details) kannst du Buchungen auch ohne Ticket manuell einchecken.
  </Accordion>

  <Accordion title="Was passiert, wenn Kund:innen den Check-In-Zeitraum verpassen?">
    Nach Ablauf des Check-In-Zeitraums ist kein Check-in mehr möglich. Die Buchung bleibt bestehen, aber der Einlass wird nicht mehr gewährt.
  </Accordion>

  <Accordion title="Kann ich Formulare beim Check-in abfragen lassen?">
    Ja. Setze den Abfragezeitpunkt bei Eigenen Formularen oder Rechtlichen Dokumenten auf "Später (beim Check-in)" (BETA). Im Checkout bleibt die Abfrage optional. Beim Check-in wird sie Pflicht, wenn Angaben noch fehlen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Check-In-Bereich ist nicht sichtbar">
    Prüfe, ob das Feature unter **Account-Einstellungen** → **Features** → **Check-In & Check-Out** aktiviert ist.
  </Accordion>

  <Accordion title="Kund:innen erhalten kein QR-Code-Ticket">
    Prüfe, ob für die betreffende Ressource das QR-Code-Ticket aktiviert ist (Ressource → Check-In).
  </Accordion>

  <Accordion title="Der Host wird beim Besucher-Check-in nicht benachrichtigt">
    Prüfe, ob SMS-Benachrichtigungen in den Organisationseinstellungen aktiviert sind und ob beim Host eine gültige Mobilnummer hinterlegt ist. Für den anny AI Anruf muss anny AI entsprechend konfiguriert sein.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature aktivieren: **Avatar** → **Account-Einstellungen** → **Features** → **Check-In & Check-Out**
> * Konfiguration pro Ressource unter **Ressource** → **Check-In**
> * Check-In-Methoden: QR-Code (Handscanner/Kamera), Suche ohne Ticket, manuell in Buchungsdetails, automatisch bei Terminal-/Kartenzahlung vor Ort (`is_terminal_payment`) zum `start_date` wenn `CHECKIN_IS_ENABLED` und Status accepted
> * Verzögerte Formular-/Dokumentenabfrage beim Check-in (BETA): Eigene Formulare und Rechtliche Dokumente können auf "Später (beim Check-in)" gesetzt werden
> * Mehrfach-Check-In: erlaubt Wiedereintritt während der Buchungszeit
> * Kapazität freigeben: nach Check-Out wird Slot für andere Buchungen freigegeben
> * Host-Benachrichtigungen bei Besucher-Check-in: SMS und/oder anny AI Anruf (Voraussetzung: Mobilnummer beim Host, anny AI konfiguriert)
> * Buchungen pro Startzeit: begrenzt gleichzeitige Ankünfte, Konfiguration unter Ressource → Verfügbarkeit → Mehrfach verfügbar
> * Check-In-Zeitraum: Konfiguration unter Ressource → Check-In → Check-In Zeitraum
> * Verwandte Artikel: /check-in-booking-details, /check-in-setup, /visitor-management, /check-in-university, /eigene-formulare, /rechtliche-dokumente


# Check-In Terminal einrichten
Source: https://docs.anny.co/check-in-setup

Richte die anny Check-In App auf einem Tablet ein und verbinde sie mit deinen Ressourcen.

Mit dieser Anleitung richtest du ein Check-In Terminal ein, das Buchungen per QR-Code scannt, Besucher:innen registriert und optional Badges druckt. Am Ende ist dein Terminal einsatzbereit und mit deinen Ressourcen verbunden.

## Check-In Terminal einrichten

<Steps>
  <Step title="App herunterladen">
    Lade die **anny Check-In App** aus dem [App Store (iOS)](https://apps.apple.com/vn/app/anny-check-in/id6633442909) oder [Google Play (Android)](https://play.google.com/store/apps/details?id=co.anny.checkin) auf dein Tablet herunter.

    Bei Windows PCs bitte die folgende Datei herunterladen:<br />[http://cdn.anny.co/apps/checkin-app/latest-windows-setup.exe](http://cdn.anny.co/apps/checkin-app/latest-windows-setup.exe)
  </Step>

  <Step title="Display pairen">
    Öffne die App auf dem Tablet. Beim ersten Start wird ein 6-stelliger Code angezeigt. Öffne parallel im Browser deinen anny Adminbereich, navigiere zu **Displays** in der linken Navigationsleiste und klicke oben rechts auf **Pair Display App**. Gib den 6-stelligen Code ein.
  </Step>

  <Step title="Modus wählen">
    Öffne das gepaarte Display unter **Displays** im Adminbereich und wähle den passenden **Modus** (siehe Tabelle unten).
  </Step>

  <Step title="Ressource(n) zuweisen">
    Wähle eine oder mehrere Ressourcen für das Display aus. Stelle sicher, dass bei den gewählten Ressourcen Check-In unter **Ressource** → **Check-In** aktiviert ist und die Verfügbarkeit auf **Mehrfach verfügbar** steht.
  </Step>

  <Step title="Sprache und Zeitzone konfigurieren">
    Stelle unter den allgemeinen Display-Einstellungen die korrekte **Zeitzone** ein und wähle eine oder mehrere **unterstützte Sprachen** aus.
  </Step>

  <Step title="Design anpassen (optional)">
    Passe unter **Startbildschirm** und **Design** Begrüßungstext, Logo, Hintergrundbild/-farbe und Akzentfarben an dein Corporate Design an.
  </Step>

  <Step title="Drucker einrichten (optional)">
    Verbinde einen Drucker via Bluetooth über die Tablet-Einstellungen. Wähle in der App unter **Einstellungen** → **Drucker** das verbundene Gerät und den Etikettentyp aus. Erstelle unter der Ressourcenzuweisung eine Badge-Vorlage (siehe Abschnitt unten).
  </Step>

  <Step title="Testen">
    Führe einen Test-Check-in durch: Erstelle eine Buchung für eine zugewiesene Ressource und scanne das QR-Code-Ticket am Terminal. Prüfe, ob der Check-in erfolgreich angezeigt wird.
  </Step>
</Steps>

<Tip>
  Es können mehrere Terminals mit der gleichen Ressource verbunden werden. So betreibst du bei hohem Aufkommen z. B. 3 Check-In Terminals parallel.
</Tip>

## Use Case: Sicherheitseinweisung direkt beim Check-in

Typischer Ablauf: Gäste absolvieren die **Sicherheitseinweisung** am Terminal, nicht schon bei der Buchung. Die Einweisung ist ein [rechtliches Dokument](/legal-documents) mit eingebettetem Video. **Das Video muss gestartet werden, bevor der Check-in abgeschlossen werden kann.**

<Steps>
  <Step title="Sicherheitsdokument anlegen">
    Lege in der Buchungsoption unter **Formulare** → **Rechtliche Dokumente** ein Dokument an (z. B. "Sicherheitseinweisung"). Bette dein Einweisungsvideo ein (YouTube, Vimeo oder Loom) und optional Fotos zu Wegen oder Notausgängen. Wähle Checkbox oder digitale Unterschrift.
  </Step>

  <Step title="Abfrage auf den Check-in legen">
    Setze den Abfragezeitpunkt auf **Später (beim Check-in)**. Das Dokument erscheint nicht im Checkout.
  </Step>

  <Step title="Gast scannt am Terminal">
    Der erste Scan meldet, dass weitere Angaben benötigt werden. Das Dokument öffnet sich am Bildschirm mit dem Video-Poster (16:9-Thumbnail und Play-Button).
  </Step>

  <Step title="Video starten">
    Der Gast tippt auf Play und startet das Video. Der Check-in bleibt gesperrt, bis das Video gestartet wurde.
  </Step>

  <Step title="Bestätigen und abschließen">
    Nach dem Start des Videos bestätigt der Gast das Dokument (Checkbox oder Unterschrift). Das Terminal übermittelt die Angaben und schließt den Check-in ab. Das signierte PDF behält die Fotos sowie ein Play-Button-Poster plus klickbare Watch-URL.
  </Step>
</Steps>

Dieselbe verzögerte Abfrage funktioniert auch für [eigene Formulare](/custom-forms) ohne Video. Geräte, die das dynamische Formular nicht anzeigen können, können solche Buchungen nicht einchecken, bis die Angaben an einem geeigneten Client erfasst wurden (z. B. Check-In App oder Admin-Check-in).

Mehr zur Einstellung findest du unter [Check-In & Check-Out](/check-in-overview). Native Apps, die dasselbe HTML rendern, folgen [Rich Content Media](/developers/guides/rich-content-media): Bestätigen und Check-in erst freigeben, wenn jedes eingebettete Video gestartet wurde.

## Verfügbare Modi

| Modus | Einsatzzweck |
| - | - |
| Check-In | Event-Einlass oder Bibliothek nur mit Voranmeldung |
| Check-Out | Reiner Check-Out Screen (z. B. zweiter Screen an Bibliotheken) |
| Check-In & Check-Out | Voranmeldung mit Check-in und Check-out auf einem Screen |
| Personalisierte Registrierung & Check-In | Besucherverwaltung: mit Termin einchecken oder ohne Termin vor Ort registrieren |
| Personalisierte Registrierung, Check-In & Check-Out | Besucherverwaltung mit Zeiterfassung oder Bibliothek mit Vor-Ort-Reservierung |
| Anonyme Registrierung & Check-In | Warteschlangen-System (Queueing) |
| Anonyme Registrierung & Check-Out | Anonyme Registrierung mit Check-out |
| Außer Betrieb | Terminal deaktiviert, keine Aktion möglich |

## Badge-Vorlage erstellen (optional)

Wenn du beim Check-in ein Badge, Label oder Ticket drucken möchtest, erstelle eine Vorlage:

1. Gehe in der Ressourcenzuweisung des Displays auf **Auswählen** und erstelle eine neue Vorlage.
2. Wähle das Format (Empfehlung: "visitor badge upright 60x86" oder "visitor badge horizontal 86x60").
3. Füge Textfelder mit Variablen ein (z. B. #Vorname, #Familienname, #Unternehmen, #Startzeit).
4. Optional: Füge ein Logo, einen QR-Code (für Check-out) oder Formen hinzu.
5. Speichere die Vorlage.

Verfügbare Variablen: Buchungsnummer, Ticket-Code, Startdatum, Startzeit, Enddatum, Endzeit, Check-In Zeitpunkt, Erstellungsdatum, Beschreibung, Dauer, Preis, Ressource, Service, Host-Name, Vollständiger Name, Vorname, Familienname, E-Mail, Unternehmen, Handynummer, Straße und Hausnummer, Postleitzahl, Stadt.

Die Variablenauswahl enthält außerdem die Feldtitel deiner [eigenen Formulare](/custom-forms) auf Buchungs-, Kunden- und Bestellebene. Badge-Vorlagen am Display sind buchungsbezogen; Angaben aus der Bestellung kannst du dort trotzdem einfügen.

<Warning>
  Stelle sicher, dass Felder, die als Variable auf dem Badge genutzt werden, im Checkout als Pflichtfeld konfiguriert sind. Sonst bleibt das Feld auf dem Badge leer.
</Warning>

## Empfohlene Hardware

| Kategorie | Empfehlung |
| - | - |
| Drucker | Brother QL810w, Brother QL820w, Zebra ZD 220/230 |
| Ständer | Bouncepad Original Floorstanding mit Brother-Druckerhalterung |
| Etiketten | Brother DK-11234 (60 x 86 mm, selbstklebend, 260 Stk./Rolle) |

## Ergebnis prüfen

Dein Terminal ist erfolgreich eingerichtet, wenn der Startbildschirm angezeigt wird, ein Test-Scan den Check-in bestätigt und (falls konfiguriert) ein Badge gedruckt wird.

## FAQ

<AccordionGroup>
  <Accordion title="Wo finde ich die PIN für die Tablet-Einstellungen?">
    Die PIN steht im Adminbereich unter **Displays** oben rechts in den Display-Einstellungen. Sie wird beim ersten Öffnen der Einstellungen auf dem Tablet abgefragt.
  </Accordion>

  <Accordion title="Kann ich das Design später ändern?">
    Ja. Alle Design-Einstellungen (Farben, Logo, Hintergrund) kannst du jederzeit im Adminbereich unter dem jeweiligen Display anpassen. Die Änderungen werden sofort auf das Terminal übertragen.
  </Accordion>

  <Accordion title="Welche Scanner-Typen werden unterstützt?">
    Integrierte Tablet-Kamera oder ein externer Scanner im HID-Modus (USB). Du kannst die Position des Scanners in den Einstellungen festlegen.
  </Accordion>

  <Accordion title="Kann ich mehrere Sprachen auf einem Terminal anbieten?">
    Ja. Hinterlege mehrere Sprachen in den Display-Einstellungen und wähle eine Standardsprache. Kund:innen können dann am Terminal selbst die Sprache wechseln.
  </Accordion>

  <Accordion title="Warum kann der Gast den Check-in nicht abschließen?">
    Wenn die Buchungsoption ein rechtliches Dokument **Später (beim Check-in)** mit eingebettetem Video abfragt, muss der Gast das Video starten, bevor Bestätigen und Check-in möglich sind. Prüfe außerdem, ob Check-In für die Ressource aktiviert ist und die Buchung im gültigen Check-In-Zeitraum liegt.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Das Pairing schlägt fehl">
    Stelle sicher, dass das Tablet eine Internetverbindung hat und der Code noch gültig ist. Bei anny.eu oder On-Prem: prüfe, ob die korrekte Data Host Region in der App ausgewählt ist.
  </Accordion>

  <Accordion title="Der Drucker druckt nicht">
    Prüfe die Bluetooth-Verbindung in den Tablet-Einstellungen. Stelle sicher, dass in der App unter Einstellungen der richtige Drucker und Etikettentyp ausgewählt ist. Bei Endlos-Etiketten muss der Typ auf die Breite eingestellt werden (z. B. B29).
  </Accordion>

  <Accordion title="Der Check-In wird nicht akzeptiert">
    Prüfe, ob für die zugewiesene Ressource Check-In aktiviert ist (Ressource → Check-In) und ob die Buchung im gültigen Check-In-Zeitraum liegt.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * App: iOS (App Store) + Android (Google Play), Name "anny Check-In"
> * Pairing: **Displays** in Navigationsleiste → **Pair Display App** → 6-stelliger Code
> * PIN: wird beim ersten Öffnen der Einstellungen auf dem Tablet abgefragt, steht im Adminbereich unter Displays
> * Modi: Check-In / Check-Out / Check-In & Check-Out / Personalisierte Registrierung & Check-In / Personalisierte Registrierung, Check-In & Check-Out / Anonyme Registrierung & Check-In / Anonyme Registrierung & Check-Out / Außer Betrieb
> * Mehrere Terminals mit gleicher Ressource möglich (Parallel-Betrieb bei hohem Aufkommen)
> * Drucker: Brother QL810w/QL820w empfohlen, Verbindung via Bluetooth
> * Badge-Variablen mit # einfügen (z. B. #Vorname), zugehörige Felder müssen Pflichtfelder im Checkout sein
> * Variablenauswahl enthält auch Eigene Formulare (Buchung, Kunde, Bestellung). Bestellfelder stehen auf buchungsbezogenen Badge-Vorlagen, weil die PDF-Bindung die Bestelldaten mit auflöst.
> * Für anny.eu und On-Prem: Data Host Region in der App vor dem Pairing auswählen
> * Verwandte Artikel: /check-in-overview, /visitor-management, /check-in-university, /rechtliche-dokumente, /eigene-formulare
> * Verzögerte Formulare beim Check-in (BETA): Terminals mit dynamischem Formular erfassen rechtliche Dokumente / eigene Formulare beim Check-in, wenn die Abfragezeit "Später (beim Check-in)" ist
> * Typischer Use Case: Sicherheitseinweisung beim Check-in. Der Gast muss das eingebettete Video starten, bevor der Check-in abgeschlossen werden kann. Signierte PDFs behalten Bilder und ein statisches Video-Poster mit klickbarer URL. Native-Vertrag: /developers/guides/rich-content-media

Mit dieser Anleitung richtest du ein Check-In Terminal ein, das Buchungen per QR-Code scannt, Besucher:innen registriert und optional Badges druckt. Am Ende ist dein Terminal einsatzbereit und mit deinen Ressourcen verbunden.

## Check-In Terminal einrichten

<Steps>
  <Step title="App herunterladen">
    Lade die **anny Check-In App** aus dem [App Store (iOS)](https://apps.apple.com/vn/app/anny-check-in/id6633442909) oder [Google Play (Android)](https://play.google.com/store/apps/details?id=co.anny.checkin) auf dein Tablet herunter.

    Bei Windows PCs bitte die folgende Datei herunterladen:<br />[http://cdn.anny.co/apps/checkin-app/latest-windows-setup.exe](http://cdn.anny.co/apps/checkin-app/latest-windows-setup.exe)
  </Step>

  <Step title="Display pairen">
    Öffne die App auf dem Tablet. Beim ersten Start wird ein 6-stelliger Code angezeigt. Öffne parallel im Browser deinen anny Adminbereich, navigiere zu **Displays** in der linken Navigationsleiste und klicke oben rechts auf **Pair Display App**. Gib den 6-stelligen Code ein.
  </Step>

  <Step title="Modus wählen">
    Öffne das gepaarte Display unter **Displays** im Adminbereich und wähle den passenden **Modus** (siehe Tabelle unten).
  </Step>

  <Step title="Ressource(n) zuweisen">
    Wähle eine oder mehrere Ressourcen für das Display aus. Stelle sicher, dass bei den gewählten Ressourcen Check-In unter **Ressource** → **Check-In** aktiviert ist und die Verfügbarkeit auf **Mehrfach verfügbar** steht.
  </Step>

  <Step title="Sprache und Zeitzone konfigurieren">
    Stelle unter den allgemeinen Display-Einstellungen die korrekte **Zeitzone** ein und wähle eine oder mehrere **unterstützte Sprachen** aus.
  </Step>

  <Step title="Design anpassen (optional)">
    Passe unter **Startbildschirm** und **Design** Begrüßungstext, Logo, Hintergrundbild/-farbe und Akzentfarben an dein Corporate Design an.
  </Step>

  <Step title="Drucker einrichten (optional)">
    Verbinde einen Drucker via Bluetooth über die Tablet-Einstellungen. Wähle in der App unter **Einstellungen** → **Drucker** das verbundene Gerät und den Etikettentyp aus. Erstelle unter der Ressourcenzuweisung eine Badge-Vorlage (siehe Abschnitt unten).
  </Step>

  <Step title="Testen">
    Führe einen Test-Check-in durch: Erstelle eine Buchung für eine zugewiesene Ressource und scanne das QR-Code-Ticket am Terminal. Prüfe, ob der Check-in erfolgreich angezeigt wird.
  </Step>
</Steps>

<Tip>
  Es können mehrere Terminals mit der gleichen Ressource verbunden werden. So betreibst du bei hohem Aufkommen z. B. 3 Check-In Terminals parallel.
</Tip>

## Use Case: Sicherheitseinweisung direkt beim Check-in

Typischer Ablauf: Gäste absolvieren die **Sicherheitseinweisung** am Terminal, nicht schon bei der Buchung. Die Einweisung ist ein [rechtliches Dokument](/legal-documents) mit eingebettetem Video. **Das Video muss gestartet werden, bevor der Check-in abgeschlossen werden kann.**

<Steps>
  <Step title="Sicherheitsdokument anlegen">
    Lege in der Buchungsoption unter **Formulare** → **Rechtliche Dokumente** ein Dokument an (z. B. "Sicherheitseinweisung"). Bette dein Einweisungsvideo ein (YouTube, Vimeo oder Loom) und optional Fotos zu Wegen oder Notausgängen. Wähle Checkbox oder digitale Unterschrift.
  </Step>

  <Step title="Abfrage auf den Check-in legen">
    Setze den Abfragezeitpunkt auf **Später (beim Check-in)**. Das Dokument erscheint nicht im Checkout.
  </Step>

  <Step title="Gast scannt am Terminal">
    Der erste Scan meldet, dass weitere Angaben benötigt werden. Das Dokument öffnet sich am Bildschirm mit dem Video-Poster (16:9-Thumbnail und Play-Button).
  </Step>

  <Step title="Video starten">
    Der Gast tippt auf Play und startet das Video. Der Check-in bleibt gesperrt, bis das Video gestartet wurde.
  </Step>

  <Step title="Bestätigen und abschließen">
    Nach dem Start des Videos bestätigt der Gast das Dokument (Checkbox oder Unterschrift). Das Terminal übermittelt die Angaben und schließt den Check-in ab. Das signierte PDF behält die Fotos sowie ein Play-Button-Poster plus klickbare Watch-URL.
  </Step>
</Steps>

Dieselbe verzögerte Abfrage funktioniert auch für [eigene Formulare](/custom-forms) ohne Video. Geräte, die das dynamische Formular nicht anzeigen können, können solche Buchungen nicht einchecken, bis die Angaben an einem geeigneten Client erfasst wurden (z. B. Check-In App oder Admin-Check-in).

Mehr zur Einstellung findest du unter [Check-In & Check-Out](/check-in-overview). Native Apps, die dasselbe HTML rendern, folgen [Rich Content Media](/developers/guides/rich-content-media): Bestätigen und Check-in erst freigeben, wenn jedes eingebettete Video gestartet wurde.

## Verfügbare Modi

| Modus | Einsatzzweck |
| - | - |
| Check-In | Event-Einlass oder Bibliothek nur mit Voranmeldung |
| Check-Out | Reiner Check-Out Screen (z. B. zweiter Screen an Bibliotheken) |
| Check-In & Check-Out | Voranmeldung mit Check-in und Check-out auf einem Screen |
| Personalisierte Registrierung & Check-In | Besucherverwaltung: mit Termin einchecken oder ohne Termin vor Ort registrieren |
| Personalisierte Registrierung, Check-In & Check-Out | Besucherverwaltung mit Zeiterfassung oder Bibliothek mit Vor-Ort-Reservierung |
| Anonyme Registrierung & Check-In | Warteschlangen-System (Queueing) |
| Anonyme Registrierung & Check-Out | Anonyme Registrierung mit Check-out |
| Außer Betrieb | Terminal deaktiviert, keine Aktion möglich |

## Badge-Vorlage erstellen (optional)

Wenn du beim Check-in ein Badge, Label oder Ticket drucken möchtest, erstelle eine Vorlage:

1. Gehe in der Ressourcenzuweisung des Displays auf **Auswählen** und erstelle eine neue Vorlage.
2. Wähle das Format (Empfehlung: "visitor badge upright 60x86" oder "visitor badge horizontal 86x60").
3. Füge Textfelder mit Variablen ein (z. B. #Vorname, #Familienname, #Unternehmen, #Startzeit).
4. Optional: Füge ein Logo, einen QR-Code (für Check-out) oder Formen hinzu.
5. Speichere die Vorlage.

Verfügbare Variablen: Buchungsnummer, Ticket-Code, Startdatum, Startzeit, Enddatum, Endzeit, Check-In Zeitpunkt, Erstellungsdatum, Beschreibung, Dauer, Preis, Ressource, Service, Host-Name, Vollständiger Name, Vorname, Familienname, E-Mail, Unternehmen, Handynummer, Straße und Hausnummer, Postleitzahl, Stadt.

Die Variablenauswahl enthält außerdem die Feldtitel deiner [eigenen Formulare](/custom-forms) auf Buchungs-, Kunden- und Bestellebene. Badge-Vorlagen am Display sind buchungsbezogen; Angaben aus der Bestellung kannst du dort trotzdem einfügen.

<Warning>
  Stelle sicher, dass Felder, die als Variable auf dem Badge genutzt werden, im Checkout als Pflichtfeld konfiguriert sind. Sonst bleibt das Feld auf dem Badge leer.
</Warning>

## Empfohlene Hardware

| Kategorie | Empfehlung |
| - | - |
| Drucker | Brother QL810w, Brother QL820w, Zebra ZD 220/230 |
| Ständer | Bouncepad Original Floorstanding mit Brother-Druckerhalterung |
| Etiketten | Brother DK-11234 (60 x 86 mm, selbstklebend, 260 Stk./Rolle) |

## Ergebnis prüfen

Dein Terminal ist erfolgreich eingerichtet, wenn der Startbildschirm angezeigt wird, ein Test-Scan den Check-in bestätigt und (falls konfiguriert) ein Badge gedruckt wird.

## FAQ

<AccordionGroup>
  <Accordion title="Wo finde ich die PIN für die Tablet-Einstellungen?">
    Die PIN steht im Adminbereich unter **Displays** oben rechts in den Display-Einstellungen. Sie wird beim ersten Öffnen der Einstellungen auf dem Tablet abgefragt.
  </Accordion>

  <Accordion title="Kann ich das Design später ändern?">
    Ja. Alle Design-Einstellungen (Farben, Logo, Hintergrund) kannst du jederzeit im Adminbereich unter dem jeweiligen Display anpassen. Die Änderungen werden sofort auf das Terminal übertragen.
  </Accordion>

  <Accordion title="Welche Scanner-Typen werden unterstützt?">
    Integrierte Tablet-Kamera oder ein externer Scanner im HID-Modus (USB). Du kannst die Position des Scanners in den Einstellungen festlegen.
  </Accordion>

  <Accordion title="Kann ich mehrere Sprachen auf einem Terminal anbieten?">
    Ja. Hinterlege mehrere Sprachen in den Display-Einstellungen und wähle eine Standardsprache. Kund:innen können dann am Terminal selbst die Sprache wechseln.
  </Accordion>

  <Accordion title="Warum kann der Gast den Check-in nicht abschließen?">
    Wenn die Buchungsoption ein rechtliches Dokument **Später (beim Check-in)** mit eingebettetem Video abfragt, muss der Gast das Video starten, bevor Bestätigen und Check-in möglich sind. Prüfe außerdem, ob Check-In für die Ressource aktiviert ist und die Buchung im gültigen Check-In-Zeitraum liegt.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Das Pairing schlägt fehl">
    Stelle sicher, dass das Tablet eine Internetverbindung hat und der Code noch gültig ist. Bei anny.eu oder On-Prem: prüfe, ob die korrekte Data Host Region in der App ausgewählt ist.
  </Accordion>

  <Accordion title="Der Drucker druckt nicht">
    Prüfe die Bluetooth-Verbindung in den Tablet-Einstellungen. Stelle sicher, dass in der App unter Einstellungen der richtige Drucker und Etikettentyp ausgewählt ist. Bei Endlos-Etiketten muss der Typ auf die Breite eingestellt werden (z. B. B29).
  </Accordion>

  <Accordion title="Der Check-In wird nicht akzeptiert">
    Prüfe, ob für die zugewiesene Ressource Check-In aktiviert ist (Ressource → Check-In) und ob die Buchung im gültigen Check-In-Zeitraum liegt.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * App: iOS (App Store) + Android (Google Play), Name "anny Check-In"
> * Pairing: **Displays** in Navigationsleiste → **Pair Display App** → 6-stelliger Code
> * PIN: wird beim ersten Öffnen der Einstellungen auf dem Tablet abgefragt, steht im Adminbereich unter Displays
> * Modi: Check-In / Check-Out / Check-In & Check-Out / Personalisierte Registrierung & Check-In / Personalisierte Registrierung, Check-In & Check-Out / Anonyme Registrierung & Check-In / Anonyme Registrierung & Check-Out / Außer Betrieb
> * Mehrere Terminals mit gleicher Ressource möglich (Parallel-Betrieb bei hohem Aufkommen)
> * Drucker: Brother QL810w/QL820w empfohlen, Verbindung via Bluetooth
> * Badge-Variablen mit # einfügen (z. B. #Vorname), zugehörige Felder müssen Pflichtfelder im Checkout sein
> * Variablenauswahl enthält auch Eigene Formulare (Buchung, Kunde, Bestellung). Bestellfelder stehen auf buchungsbezogenen Badge-Vorlagen, weil die PDF-Bindung die Bestelldaten mit auflöst.
> * Für anny.eu und On-Prem: Data Host Region in der App vor dem Pairing auswählen
> * Verwandte Artikel: /check-in-overview, /visitor-management, /check-in-university, /rechtliche-dokumente, /eigene-formulare
> * Verzögerte Formulare beim Check-in (BETA): Terminals mit dynamischem Formular erfassen rechtliche Dokumente / eigene Formulare beim Check-in, wenn die Abfragezeit "Später (beim Check-in)" ist
> * Typischer Use Case: Sicherheitseinweisung beim Check-in. Der Gast muss das eingebettete Video starten, bevor der Check-in abgeschlossen werden kann. Signierte PDFs behalten Bilder und ein statisches Video-Poster mit klickbarer URL. Native-Vertrag: /developers/guides/rich-content-media


# Mitgliedermanagement (Communities)
Source: https://docs.anny.co/communities

Steuere mit Communities, wer deine Ressourcen sehen und buchen kann.

Mit Communities erstellst du interne Buchungsseiten, auf denen ausgewählte Ressourcen nur für bestimmte Personengruppen zugänglich sind. So trennst du interne von externen Buchungen und steuerst gezielt, wer welche Inhalte sieht und buchen kann.

<Info>
  * Verfügbar ab **Essential** (2 Communities). Höhere Pläne bieten mehr: Professional 5, Business 20, Enterprise unbegrenzt.
  * Aktiviere vorab **Communities** unter **Account-Einstellungen** > **Features**, um den Menüpunkt in der Navigation freizuschalten.
</Info>

## Wie funktioniert eine Community?

Eine Community ist ein geschlossener Bereich innerhalb deines anny Accounts. Du verknüpfst Ressourcen und Buchungsoptionen mit einer Community und legst fest, welche Personen als Mitglieder Zugang erhalten. Nur Mitglieder sehen und buchen die zugewiesenen Ressourcen auf der Community-Startseite.

Das Grundprinzip:

1. Du erstellst eine Community und gibst ihr einen Namen.
2. Du verknüpfst Ressourcen (einzeln, als Gruppe oder die gesamte Organisation).
3. Du fügst Mitglieder hinzu (manuell, per Auto-Join oder über ein Abo).
4. Mitglieder sehen auf ihrer Community-Startseite nur die verknüpften Ressourcen und können dort buchen.

Jedes Mitglied benötigt einen anny Account, um einer Community beizutreten.

## Wann nutze ich das?

* **Unternehmen mit internem Desk Sharing oder Raumbuchung:** Mitarbeitende sollen Arbeitsplätze und Räume buchen, ohne dass Externe diese sehen.
* **Coworking-Spaces mit Mitglieder-Konditionen:** Mitglieder erhalten über ihre Community Zugang zu exklusiven Ressourcen und Preisen.
* **Universitäten und Hochschulen:** Studierende und Mitarbeitende buchen Lernplätze oder Labore, die nur für die eigene Fakultät sichtbar sind.
* **Vereine und Verbände:** Vereinsmitglieder buchen Plätze und Kurse, die Nicht-Mitgliedern verborgen bleiben.

**Nicht geeignet für:** Rein öffentliche Buchungsseiten ohne Zugangsbeschränkung. Dort reicht die Standard-Buchungsseite ohne Community.

## Zusammenhang mit anderen Features

* **Buchungskontingente:** Verknüpfe Kontingente mit einer Community, um Mitgliedern ein begrenztes Buchungsbudget (Menge, Dauer oder Betrag) zuzuweisen.
* **Abos & Mitgliedschaften:** Weise in den Abo-Einstellungen eine Community zu. Mitglieder werden bei Abo-Abschluss automatisch der Community hinzugefügt.
* **Attribute Mapping (SSO):** Synchronisiere Benutzergruppen aus deinem Identity Provider automatisch mit Communities.

## Einstellungen & Optionen

### Ressourcen zuweisen

| Methode | Beschreibung |
| - | - |
| Organisation hinzufügen | Alle Ressourcen des Accounts zuweisen |
| Ressourcengruppe hinzufügen | Vordefinierte Gruppen zuweisen |
| Ressource hinzufügen | Einzelne Ressourcen auswählen |
| Services hinzufügen | Einzelne Buchungsoptionen zuweisen |

<Tip>
  Standardmässig ist alle Services auswählen aktiv. Deaktiviere diese Option, um nur bestimmte Buchungsoptionen zuzuweisen.
</Tip>

### Sichtbarkeit der Ressourcen

| Einstellung | Sichtbar für | Buchbar für |
| - | - | - |
| Öffentlich sichtbar und buchbar für alle | Alle | Alle |
| Sichtbar und buchbar nur für Mitglieder | Nur Mitglieder | Nur Mitglieder |
| Öffentlich sichtbar, buchbar nur für Mitglieder | Alle | Nur Mitglieder |

<Note>
  Sowohl Betrachter:in als auch buchende Person müssen Teil derselben Community sein, damit Buchungen anderer Mitglieder sichtbar sind.
</Note>

### Mitglieder hinzufügen

| Methode | Funktionsweise |
| - | - |
| Manuell einladen | E-Mail-Adresse eingeben, Einladung versenden |
| Auto-Join via Domain | Neue Registrierungen mit passender E-Mail-Domain werden automatisch hinzugefügt |
| Auto-Join via SSO | Benutzergruppen aus dem Identity Provider werden per Attribute Mapping synchronisiert |
| Auto-Join via Buchungsregel | Eine Regel prüft getätigte Buchungen und fügt passende Kund:innen hinzu |
| Automatisch über Abo | In den Abo-Einstellungen wird die Ziel-Community hinterlegt. Mitglieder werden bei Abo-Abschluss zugeordnet |

Unter **Mitglieder** sortierst du die Liste über **Mitglieder sortieren**: **Beitritt (neueste zuerst)** (Standard), **Beitritt (älteste zuerst)** oder **E-Mail**. Bei jedem Mitglied siehst du den Beitrittsweg, zum Beispiel **Beigetreten über SSO**, **Beigetreten über Einladung** oder **Beigetreten über Einladungslink**.

Lädst du eine E-Mail ein, die bereits ein anny-Konto hat, wird die Person sofort Mitglied. Auto-Join über eine Buchung legt keine zweite Zeile neben einer bestehenden Mitgliedschaft oder offenen Einladung an: Dieselbe E-Mail erscheint nicht gleichzeitig als Einladung und als Mitglied.

### Mitglieder-Rollen

| Rolle | Rechte |
| - | - |
| Mitglied | Buchen und andere Mitglieder sehen |
| Beobachter | Nur lesender Zugriff (wer hat wann gebucht?) |
| Gast | Nur buchen, keine Leserechte auf andere Mitglieder |

### Inkognito-Modus

| Option | Verhalten |
| - | - |
| Opt-In | Standardmässig sichtbar, Mitglieder können Inkognito aktivieren |
| Opt-Out | Standardmässig Inkognito, Mitglieder können Sichtbarkeit aktivieren |
| Aktiviert | Alle Mitglieder sind Inkognito, keine individuelle Änderung |
| Deaktiviert | Alle Mitglieder sind sichtbar, keine individuelle Änderung |

### Externe Links auf der Community-Startseite

Community-Admins können pro Community bis zu drei externe Links hinterlegen. Jeder Link besteht aus einem Namen, einer URL und einem Icon. Die Links werden auf der Community-Startseite im Web für Mitglieder angezeigt.

<Note>
  Externe Links sind aktuell nur im Web verfügbar, nicht in der App.
</Note>

### Mitglieder entfernen

| Methode | Funktionsweise |
| - | - |
| Automatisch (SSO) | Attribute-Mapping-Regel anpassen, Zuordnung wird entfernt |
| Manuell | Unter **Mitglieder** die Person suchen und **Entfernen** klicken |

<Tip>
  Entfernte Mitglieder erhalten keine Benachrichtigung und können später wieder eingeladen werden.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Hybrid-Work: Interne Arbeitsplatzbuchung per Domain">
    <Steps>
      <Step title="Community erstellen">
        Öffne in der Menüleiste **Communities** und klicke oben rechts auf **Neu+**. Vergib einen Namen, z. B. Büro Frankfurt.
      </Step>

      <Step title="Ressourcen verknüpfen">
        Füge über **Ressourcengruppe hinzufügen** die Gruppe Büro Frankfurt hinzu, die alle Arbeitsplätze und Räume enthält.
      </Step>

      <Step title="Sichtbarkeit einstellen">
        Setze die Sichtbarkeit der verknüpften Ressourcen auf **sichtbar und buchbar nur für Mitglieder**.
      </Step>

      <Step title="Auto-Join per Domain aktivieren">
        Wechsle zum Reiter **Auto-Join**, klicke auf **+ Eigene Domain** und gib deine Unternehmens-Domain ein (z. B. firma.de). Neue Registrierungen mit dieser Domain werden automatisch Mitglied.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Coworking-Community mit Abo-Zuordnung und externen Links">
    <Steps>
      <Step title="Community erstellen">
        Öffne in der Menüleiste **Communities** und klicke auf **Neu+**. Vergib den Namen Coworking Members.
      </Step>

      <Step title="Ressourcen verknüpfen">
        Füge über **Ressource hinzufügen** die gewünschten Coworking-Arbeitsplätze und Meetingräume hinzu.
      </Step>

      <Step title="Abo mit Community verknüpfen">
        Öffne die Einstellungen deines Mitgliedschafts-Abos. Wähle unter der Community-Zuordnung Coworking Members aus. Neue Abonnent:innen werden bei Abo-Abschluss automatisch der Community zugeordnet.
      </Step>

      <Step title="Externe Links hinterlegen">
        Öffne die Community-Einstellungen und hinterlege bis zu drei externe Links (z. B. Kundenportal, Profilseite, FAQ) mit Name, URL und Icon. Mitglieder sehen diese Links direkt auf der Community-Startseite im Web.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Können Mitglieder in mehreren Communities gleichzeitig sein?">
    Ja. Ein:e Nutzer:in kann Mitglied beliebig vieler Communities sein und hat in jeder Community Zugang zu den dort verknüpften Ressourcen.
  </Accordion>

  <Accordion title="Was passiert, wenn ich eine Ressource aus der Community entferne?">
    Mitglieder sehen die Ressource nicht mehr auf ihrer Community-Startseite und können sie dort nicht mehr buchen. Bestehende Buchungen bleiben bestehen.
  </Accordion>

  <Accordion title="Können Mitglieder die Buchungen anderer Mitglieder sehen?">
    Nur wenn beide Personen Teil derselben Community sind und die gebuchte Ressource in dieser Community liegt. Der Inkognito-Modus steuert zusätzlich, ob Mitglieder füreinander sichtbar sind.
  </Accordion>

  <Accordion title="Wie viele externe Links kann ich pro Community hinterlegen?">
    Maximal drei. Jeder Link besteht aus Name, URL und Icon und wird auf der Community-Startseite im Web angezeigt.
  </Accordion>

  <Accordion title="Können Gäste die Buchungen anderer Mitglieder sehen?">
    Nein. Die Rolle Gast erlaubt ausschliesslich das Buchen. Personenbezogene Daten anderer Mitglieder bleiben geschützt.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mitglieder sehen eine Ressource nicht in der Community">
    Die Ressource ist nicht mit der Community verknüpft oder die Sichtbarkeitseinstellung schliesst das Mitglied aus. Prüfe unter der Community, ob die Ressource zugewiesen ist, und kontrolliere die Sichtbarkeitseinstellung der Ressource innerhalb der Community.
  </Accordion>

  <Accordion title="Auto-Join funktioniert nicht für neue Registrierungen">
    Die E-Mail-Domain des Mitglieds stimmt nicht mit der hinterlegten Domain überein. Prüfe unter **Auto-Join**, ob die Domain korrekt eingetragen ist (z. B. firma.de statt [www.firma.de](http://www.firma.de)). Bei SSO: Prüfe, ob das Attribute Mapping korrekt konfiguriert ist.
  </Accordion>

  <Accordion title="Externe Links werden nicht auf der Community-Startseite angezeigt">
    Externe Links sind aktuell nur im Web sichtbar, nicht in der App. Prüfe ausserdem, ob die URL korrekt hinterlegt ist (inkl. https\://) und ob das Link-Limit von drei nicht überschritten wurde.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad Community erstellen: Menüleiste > Communities > Neu+
> * Feature muss aktiviert werden: Account-Einstellungen > Features > Communities
> * Plan-Limits: Essential 2, Professional 5, Business 20, Enterprise unbegrenzt
> * Externe Links: max. 3 pro Community, Felder: Name, URL, Icon. Nur Web, nicht in der App.
> * Rollen: Mitglied (buchen + sehen), Beobachter (nur sehen), Gast (nur buchen, keine Leserechte auf andere)
> * Inkognito-Modus-Optionen: Opt-In, Opt-Out, Aktiviert, Deaktiviert
> * Auto-Join-Methoden: SSO Attribute Mapping, E-Mail-Domain, Buchungsregel, Abo-Zuordnung
> * Sichtbarkeitsstufen pro Ressource in Community: (1) öffentlich sichtbar und buchbar für alle, (2) sichtbar und buchbar nur für Mitglieder, (3) öffentlich sichtbar, buchbar nur für Mitglieder
> * Sichtbarkeitslogik für Buchungen: Betrachter:in + buchende Person müssen in derselben Community sein UND Ressource muss in der Community liegen
> * Sichtbarkeit von Blockern: Ressource muss in Community liegen UND Funktion Blocker Titel anzeigen muss aktiviert sein
> * Entfernte Mitglieder erhalten keine Benachrichtigung und können später wieder eingeladen werden
> * Mitgliederliste: Sort **Beitritt (neueste zuerst)** / **Beitritt (älteste zuerst)** / **E-Mail**. Join-Labels: SSO, Einladung, Einladungslink, Buchung, E-Mail-Domain, Abonnement. API-Feld `joinedVia`, Fallback `joinedThrough`. `sort=email` joint `customer_accounts.email`.
> * Einladung an bestehende CustomerAccount-E-Mail: sofort Mitglied, keine pending Invite. Auto-Join via Buchung reused overlapping membership und consumes leftover invites (keine doppelte Zeile Invite + Member). Nicht-überlappende Zeitfenster bleiben getrennte Mitgliedschaften.
> * Verwandte Artikel: Buchungskontingente, Attribute Mapping, Abos und Mitgliedschaften, Community Sichtbarkeit


# Buchungsoption
Source: https://docs.anny.co/configure-booking-option

Definiere, wie deine Ressourcen gebucht werden: Dauer, Preis, Intervall und erweiterte Regeln.

Eine Buchungsoption legt fest, wie eine Ressource gebucht wird: Dauer, Preis, Buchungsintervall und alle weiteren Regeln rund um den Buchungsprozess. Im Admin-Bereich werden „Buchungsoption" und „Service" synonym verwendet. Der angezeigte Begriff hängt von der Kategorie deiner Ressource ab.

## Wie funktioniert eine Buchungsoption?

Buchungsoptionen liegen zentral in deinem Account. Du erstellst sie einmalig und verknüpfst sie mit einer oder mehreren Ressourcen. Eine Ressource kann mehrere Buchungsoptionen haben (z. B. stundenweise und tageweise), und eine Buchungsoption kann mit mehreren Ressourcen verknüpft sein.

<Warning>
  Das Bearbeiten einer Buchungsoption wirkt sich auf alle verknüpften Ressourcen aus.
</Warning>

Der Buchungsprozess folgt dem **Resource-first Flow**: Kund:innen wählen zuerst die Ressource und dann die gewünschte Buchungsoption. Alternativ kannst du den **Service-first Flow** aktivieren, bei dem Kund:innen zuerst die Leistung wählen und danach (optional) eine Ressource.

### Zeitraum-Modi

Jede Buchungsoption verwendet einen von vier Zeitraum-Modi:

| Modus | Beschreibung |
| - | - |
| Feste Dauer | Das Buchungsintervall ist vorgegeben (z. B. immer 1 Tag) |
| Flexible Dauer | Kund:innen bestimmen die Dauer innerhalb eines Min/Max-Rahmens |
| Dauer nach Zeitplan | Die Buchung füllt den gesamten verfügbaren Zeitslot |
| Serie | Mehrere Termine werden als Paket gebucht |

<Tip>
  Bei ganztägigen oder mehrtägigen Buchungsoptionen kannst du eine Start- und Endzeit definieren. Setzt du die Endzeit kleiner als die Startzeit, erkennt anny automatisch eine Übernacht-Buchung (z. B. Check-in 16:00, Check-out 11:00).
</Tip>

### Serien

Im Modus „Serie" werden die Termine zentral in der Ressourcen-Verfügbarkeit gepflegt. Jeder Termin kann einer Serie zugeordnet werden. Kund:innen wählen bei der Buchung die gewünschte Serie über ein Dropdown und buchen alle zugehörigen Termine als Paket. Einzelne Termine können zentral verschoben oder abgesagt werden und bleiben mit den Buchungen synchron.

## Wann nutze ich das?

* **Du vermietest Räume, Arbeitsplätze oder Equipment**: Definiere Buchungsoptionen mit fester oder flexibler Dauer. Räume und Sportplätze legst du als eigene Ressourcen an, Arbeitsplätze oft als Child-Ressourcen. Details: [Ressourcen konfigurieren](/ressourcen-konfigurieren).
* **Du bietest Kurse mit mehreren Terminen an**: Nutze den Modus „Serie", um Terminketten als Paket buchbar zu machen
* **Du möchtest verschiedene Preismodelle auf derselben Ressource**: Erstelle mehrere Buchungsoptionen (z. B. Stundentarif und Tagestarif) und verknüpfe sie mit der gleichen Ressource
* **Nicht geeignet für**: Wenn die Leistung im Vordergrund steht (z. B. Coaching, Beratung) und Kund:innen zuerst die Leistung wählen sollen, ist der Service-first Flow die bessere Wahl

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Smart Availability | Verbinde zusätzliche Ressourcen mit einer Buchungsoption, um kombinierte Verfügbarkeit sicherzustellen |
| Dynamisches Pricing | Ergänze zeitbasierte Preisregeln auf der Buchungsoption (z. B. Wochenendpreise) |
| Zusatzoptionen | Füge Add-Ons, zusätzliche Ressourcen und Empfehlungen im Buchungsprozess hinzu |
| Service-Zeitpläne | Schränke die Verfügbarkeit einer Buchungsoption über eigene Zeitpläne ein |
| [Buchungssequenzen](/booking-sequences) | Kombiniere mehrere Services in einer Buchung. Zahlung, MwSt. und Zeitraum müssen gleich sein. |

## Einstellungen & Optionen

### Grundeinstellungen

| Einstellung | Beschreibung |
| - | - |
| Name | Anzeigename auf der Buchungsseite |
| Gruppe | Interne Organisationseinheit |
| Zeitraum | Modus: Fest, Flexibel, Nach Zeitplan, Serie |
| Preis | Betrag inkl. MwSt-Satz. Zusammen mit Startgebühr, Basisdauer und Abrechnung pro ergibt sich der Dauerpreis. |
| Startgebühr | Einmalbetrag pro Buchung, unabhängig von der Dauer |
| Basisdauer | Zeitraum, der durch die Startgebühr abgedeckt ist. Darüber hinaus gilt der Preis pro Abrechnungsintervall. |
| Abrechnung pro | Intervall für angebrochene Zeit nach der Basisdauer (z. B. pro angefangene Stunde) |

### Erweiterte Einstellungen

| Einstellung | Beschreibung |
| - | - |
| Buchungsintervall | Zeitabstand zwischen möglichen Startterminen, gerechnet ab dem Beginn jedes Verfügbarkeitsfensters — nicht automatisch zur vollen Stunde |
| Vorlaufzeit | Frühestmöglicher Buchungszeitpunkt. Kann auch negativ sein, damit nach dem Start noch gebucht werden kann. |
| Vorausbuchungszeitraum | Wie weit in die Zukunft gebucht werden kann |
| Vorbereitungs-/Nachbereitungszeit | Automatisch geblockte Pufferzeit, nicht abgerechnet |
| Vor- und Nachbereitungszeit außerhalb der Öffnungszeiten erlauben | Standard an. Wenn du den Toggle deaktivierst, müssen Vorbereitung und Nachbereitung vollständig innerhalb der Öffnungszeiten liegen. Erscheint nur, wenn eine Vor- oder Nachbereitungszeit gesetzt ist. |
| Blocker übergreifend erlauben | Buchungen vor/nach einem Blocker ermöglichen |
| Zeitplan übergreifend erlauben | Über nicht verfügbare Zeiten hinweg buchen |
| Ende außerhalb des Zeitplans | Buchungsende darf nach Zeitplanende liegen |
| Wiederkehrende Buchungen | Regelmäßige Intervallbuchungen |
| Alle Buchungen automatisch annehmen | Ohne manuelle Bestätigung |
| Kontingent | Zusätzliche Begrenzung paralleler Buchungen |
| Buchungsart | Standard, Transparent, Mehrfach oder Vollständig |
| Min. Auswahl pro Bestellung | Mindestanzahl bei Mehrfachbuchungen |
| Max. Auswahl pro Bestellung | Höchstanzahl bei Mehrfachbuchungen |
| Interner Service | Nur für Admins bei manueller Buchung sichtbar |
| Zugangscode | Nur per Direkt-Link mit Code erreichbar |
| Darstellung der Zeitauswahl | Kalender oder Liste |
| Standort ausblenden | Für Online-Services |
| Weitere Buchung erlauben | Button für Folgebuchung im Checkout |

<Tip>
  Eine **Tagesbuchung** (feste Dauer 1 Tag) startet um 00:00 Uhr bzw. zur hinterlegten Startzeit. Mit Vorlaufzeit 0 ist der heutige Tag danach nicht mehr buchbar. Setze eine **negative Vorlaufzeit**, z. B. **-8 Stunden**: Dann bleibt der heutige Tag nach dem Start noch für diese Dauer buchbar.
</Tip>

### Buchungsarten im Detail

| Buchungsart | Verhalten |
| - | - |
| Standard | Blockiert die Ressource für den Buchungszeitraum |
| Transparent | Blockiert nicht, unbegrenzte parallele Buchungen möglich |
| Mehrfach | Blockiert mehrere Kapazitätseinheiten pro Buchung (Gewichtung) |
| Vollständig | Blockiert die volle Kapazität (nur bei Child-Ressourcen) |

### Verfügbare Reiter

Je nach aktivierten Features werden innerhalb der Buchungsoption weitere Reiter angezeigt:

| Reiter | Funktion |
| - | - |
| Ressourcen | Weitere Ressourcen für kombinierte Verfügbarkeit (Smart Availability) |
| Zugang | Zugangslevel und Community-Zuordnung |
| Zahlungen | Online, Offline oder auf Rechnung |
| Zusatzoptionen | Add-Ons, zusätzliche Ressourcen und Empfehlungen |
| Zeitpläne | Zusätzliche Verfügbarkeitsregeln |
| Formular | Checkout-Abfragen und rechtliche Dokumente |
| Mitteilungen | Zusatzinfos in Bestätigungsmails und Erinnerungen |
| Stornierung | Stornierungsbedingungen und -fristen |

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Coworking-Space vermietet Meetingräume stundenweise">
    Ein Coworking-Space möchte seinen Mitgliedern Meetingräume flexibel zwischen 1 und 6 Stunden buchbar machen, mit automatischer Bestätigung.
  </Accordion>

  <Accordion title="Ein Sportstudio bietet Kurse mit begrenzter Teilnehmerzahl an">
    Ein Sportstudio bietet Yoga-Kurse an. Pro Kurs können maximal 20 Teilnehmer:innen teilnehmen. Die Teilnehmeranzahl wird über die Ressourcen-Verfügbarkeit gesteuert.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Buchungsoption und Service?">
    Technisch sind beide identisch (`services`-Tabelle, Feld `is_rental_option`). Der angezeigte Begriff hängt von der Ressourcen-Kategorie ab: Bei Räumen, Equipment oder Arbeitsplätzen wird **Buchungsoption** angezeigt, bei Dienstleistungen wie Coaching oder Beratung **Service**. Über die Aktionen **In Service umwandeln** bzw. **In Buchungsoption umwandeln** (drei Punkte in der Liste oder in der Detailansicht) wechselst du die Darstellung, ohne die Verknüpfungen zu verlieren.
  </Accordion>

  <Accordion title="Kann ich eine Buchungsoption mit mehreren Ressourcen verknüpfen?">
    Ja. Buchungsoptionen liegen zentral im Account. Du kannst eine Buchungsoption mit beliebig vielen Ressourcen verknüpfen. Beachte: Änderungen an der Buchungsoption wirken auf alle verknüpften Ressourcen.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Kontingent und der Ressourcen-Verfügbarkeit?">
    Die Ressourcen-Verfügbarkeit (Anzahl) bestimmt, wie oft die Ressource physisch vorhanden ist. Das Kontingent ist eine zusätzliche, buchungstechnische Begrenzung, die unabhängig davon greift. Beispiel: Ein Raum ist einfach verfügbar, aber das Kontingent begrenzt die Buchungsoption auf maximal 3 parallele Buchungen.
  </Accordion>

  <Accordion title="Wann nutze ich die Buchungsart Vollständig?">
    Die Buchungsart **Vollständig** ist nur bei Child-Ressourcen verfügbar. Sie blockiert mit einer Buchung die gesamte Kapazität der übergeordneten Ressource. Typischer Anwendungsfall: ein Meetingraum mit mehreren Arbeitsplätzen, der als Ganzes gebucht werden soll. Für exklusive Tische oder Boote mit Plätzen pro Child-Ressource nutzt du **Standard** und [Exklusive Zeitfenster](/exclusive-time-slots), nicht **Vollständig**.
  </Accordion>

  <Accordion title="Wie stelle ich 'erste Stunde 35 €, jede weitere 15 €' ein?">
    Setze **Startgebühr** auf 35 €, **Basisdauer** auf 60 Minuten, **Preis** auf 15 € und **Abrechnung pro** auf 60 Minuten. Die erste Stunde kostet nur die Startgebühr, jede weitere angefangene Stunde 15 €. Feine Unterschiede nach Wochentag, Uhrzeit oder Dauer hinterlegst du zusätzlich über [dynamisches Pricing](/dynamic-pricing) mit der Bedingung **Dauer**.
  </Accordion>

  <Accordion title="Warum erscheinen Startzeiten zur halben Stunde, obwohl das Buchungsintervall 60 Minuten ist?">
    Das Buchungsintervall ist der Abstand zwischen Starts, keine Ausrichtung auf volle Uhrzeiten. Beginnt das Verfügbarkeitsfenster um 10:30, folgen 10:30, 11:30, 12:30. Mit [Smart Availability](/smart-availability) ist der Fensterstart der erste gemeinsame Zeitpunkt aller nötigen Ressourcen. Mehrere verbundene Ressourcen können mehrere Fenster erzeugen — dann stehen volle und halbe Stunden auf derselben Buchungsseite.
  </Accordion>

  <Accordion title="Warum kann ich eine Tagesbuchung nicht mehr am selben Tag buchen?">
    Eine Tagesbuchung beginnt zum Tagesstart bzw. zur hinterlegten Startzeit. Sobald dieser Zeitpunkt vorbei ist, gilt der heutige Tag bei Vorlaufzeit 0 als vergangen. Hinterlege in den erweiterten Einstellungen eine **negative Vorlaufzeit** (z. B. **-8 Stunden**). So können sich Kund:innen im Laufe des Tages noch einbuchen. -8 Stunden ist auch der Standard für die Tagesbuchung, die anny beim Onboarding interner Arbeitsplätze anlegt.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Meine Buchungsoption wird auf der Buchungsseite nicht angezeigt">
    Die Buchungsoption muss mit einer Ressource verknüpft sein, die auf „live" steht. Prüfe außerdem, ob ein Zugangscode gesetzt ist (dann ist die Option nur per Direkt-Link erreichbar) oder ob sie als „Interner Service" markiert ist.
  </Accordion>

  <Accordion title="Kund:innen können keine Termine finden, obwohl die Ressource verfügbar ist">
    Prüfe, ob die Zeitangaben auf der Ressource mit denen der Buchungsoption kompatibel sind. Die Zeitpläne der Ressource müssen identisch oder größer als die der Buchungsoption sein. Prüfe auch Vorlaufzeit und Vorausbuchungszeitraum.
  </Accordion>

  <Accordion title="Kund:innen können den heutigen Tag bei einer Tagesbuchung nicht mehr buchen">
    Prüfe die **Vorlaufzeit**. Für Tagesbuchungen brauchst du in der Regel einen negativen Wert (z. B. -8 Stunden). Eine Vorlaufzeit von 0 oder mehr schließt den heutigen Tag, sobald die Startzeit erreicht ist.
  </Accordion>

  <Accordion title="Das Kontingent-Feld wird nicht in den erweiterten Einstellungen angezeigt">
    Das Feature „Kontingente für Buchungsoptionen und Dienstleistungen" muss unter **Account-Einstellungen** → **Features** aktiviert sein, bevor das Feld in den erweiterten Einstellungen erscheint.
  </Accordion>

  <Accordion title="No resource linked to the booking option / Mit der Buchungsoption ist keine Ressource verbunden">
    Die Buchungsoption hat keine verknüpfte Ressource vom Typ „eine davon" (ONE\_OF). Verknüpfe unter **Buchungsoption** → Reiter **Ressourcen** mindestens eine Ressource und stelle sicher, dass diese Ressource **live** ist. Der englische Fehlertext lautet **No resource linked to the booking option**, der deutsche **Mit der Buchungsoption ist keine Ressource verbunden**.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Buchungsoption und Service sind technisch identisch (`is_rental_option`). Bezeichnung im Admin hängt von der Ressourcen-Kategorie ab. Umwandlung: **In Service umwandeln** / **In Buchungsoption umwandeln**
> * Fehler `no_resource_attached_to_service`: EN-Titel **No resource linked to the booking option**, DE-Titel **Mit der Buchungsoption ist keine Ressource verbunden**. Ursache: keine ONE\_OF-Ressource verknüpft. Fix: Ressource an die Buchungsoption hängen und live schalten.
> * Buchungsoptionen liegen zentral im Account: Bearbeitung wirkt auf ALLE verknüpften Ressourcen
> * Zeitangaben auf der Ressource überschreiben die der Buchungsoption; Ressourcen-Zeitplan muss ≥ Buchungsoptions-Zeitplan sein
> * Pfad: **Ressource** → Reiter **Buchungsoption** → **+Hinzufügen** → **+Neu**
> * Kontingent ist eine ZUSÄTZLICHE Begrenzung neben der Ressourcen-Verfügbarkeit (Anzahl). Feature „Kontingente für Buchungsoptionen und Dienstleistungen" muss vorab aktiviert werden
> * Buchungsart „Vollständig" nur bei Child-Ressourcen verfügbar
> * Serie-Modus: Termine werden zentral in der Ressourcen-Verfügbarkeit gepflegt, nicht in der Buchungsoption selbst (seit Serienbuchungen v2, Release März 2026)
> * Min/Max Auswahl pro Bestellung gilt pro Buchungsoption, nicht global für den Service
> * Dauerpreis: subtotal = chargedIntervals × price + startingFee, chargedIntervals = ceil((duration − unchargedDuration) / calculationInterval). UI: **Startgebühr**, **Basisdauer**, **Abrechnung pro**. Beispiel erste Stunde 35 € / weitere 15 €: Startgebühr 35, Basisdauer 60 min, Preis 15, Abrechnung pro 60 min.
> * `allow_padding_off_schedule` default `true`. Toggle **Vor- und Nachbereitungszeit außerhalb der Öffnungszeiten erlauben** nur sichtbar bei padding ≠ 0 und nicht auto-duration. `false` erzeugt Unavailability `padding_off_schedule`.
> * Vorlaufzeit in Minuten, negativ erlaubt (UI: integer, Vielfaches von 5). Onboarding `RESOURCE_INTERNAL` Tagesbuchung: `lead_time` = -480, `default_start_time` bleibt 00:00:00.
> * Same-Day-Tagesbuchung: `DateAvailabilityEngine` addiert einen Tag, wenn `(now + leadTime).time > defaultStartTime`. Deshalb blockiert Vorlaufzeit 0 den heutigen Tag nach Mitternacht bzw. nach der Startzeit.


# Mitteilungen und Terminerinnerungen
Source: https://docs.anny.co/configure-notifications

Hinterlege E-Mail-Hinweise und die Terminerinnerung am Service oder an der Buchungsoption.

Mitteilungen sind zusätzliche Texte in den E-Mails an deine Kund:innen. Am Service und an der Buchungsoption stellst du auf demselben Reiter auch die Terminerinnerung ein. Du legst den Zeitpunkt fest und schreibst den Hinweis direkt darunter.

Das ist kein Editor für das E-Mail-Layout.

<Info>
  Terminerinnerungen und die zusätzlichen E-Mail-Informationen sind ab dem Plan **Essential** verfügbar.
</Info>

## Wann nutze ich das?

| Situation | Was du einstellst |
| - | - |
| **Kund:innen sollen pünktlich kommen.** | Eine Erinnerung 24 Stunden und eine Stunde vor Buchungsbeginn, plus einen kurzen Hinweis im Text. |
| **Die Buchung hat ein klares Ende.** | Eine Erinnerung vor Buchungsende, zum Beispiel bei einer Tagesmiete oder einem Check-out. |
| **Alle E-Mails brauchen dieselbe Info.** | Den Text auf Account-Ebene, zum Beispiel die Anfahrt. Am Service ergänzt du, was man mitbringen soll. |

## Wo liegen Text und Erinnerung?

| Ebene | Pfad | Was du einstellst |
| - | - | - |
| Account | Oben den Account-Namen anklicken, oder im Benutzermenü **Account Einstellungen**. Dann Reiter **Mitteilungen** | Text in jeder E-Mail deiner Organisation |
| Ressource | Seitenleiste **Ressourcen** → Ressource öffnen → Reiter **Mitteilungen** | Text nur für diese Ressource |
| Service oder Buchungsoption | Seitenleiste **Services** → Service oder Buchungsoption öffnen → Reiter **Mitteilungen** | Zeitpunkt der Erinnerung und Text nur für diesen Service oder diese Buchungsoption |

<Tip>
  Die Textebenen ergänzen sich. Liegt auf Account, Ressource und Service jeweils ein Text, stehen alle drei in einer E-Mail. Gibt es mehr als einen Hinweis, bekommt jeder Block eine Überschrift mit dem Namen der Ebene.
</Tip>

## Terminerinnerung am Service

Die Terminerinnerung gibt es nur am Service und an der Buchungsoption. Im Reiter **Mitteilungen** steht zuerst **Erinnerungen**. Direkt darunter steht **Zusätzliche E-Mail Informationen**. Dieser Text erscheint in der Bestätigung, in der Änderung und in der Erinnerungsmail.

Ohne hinterlegten Zeitpunkt sendet anny keine Terminerinnerung. Es gibt keinen Ein- und Ausschalter. Eine leere Liste bedeutet, dass keine Erinnerung rausgeht.

## Mitteilungen und Erinnerung einrichten

<Steps>
  <Step title="Service oder Buchungsoption öffnen">
    Öffne in der Seitenleiste **Services** und wähle den Service oder die Buchungsoption.

    Die Detailseite ist offen.
  </Step>

  <Step title="Mitteilungen öffnen">
    Wechsle zum Reiter **Mitteilungen**.

    **Erinnerungen** steht über **Zusätzliche E-Mail Informationen**.
  </Step>

  <Step title="Zeitpunkt festlegen">
    Füge unter **Standarderinnerungen vor Buchungsbeginn** oder **Standarderinnerungen vor Buchungsende** mit **Hinzufügen** einen Eintrag hinzu. Trage die Zeit ein und wähle Minuten, Stunden oder Tage. Ein neuer Eintrag startet mit 60 Minuten. Mindestens 5 Minuten, höchstens ein Jahr.

    Einen Eintrag entfernst du mit **Löschen**. Eine leere Liste schaltet diese Erinnerung aus.

    Die Listen zeigen die Zeitpunkte, die anny verwenden soll.
  </Step>

  <Step title="Text zur Erinnerung schreiben">
    Schreibe den Hinweis unter **Zusätzliche E-Mail Informationen**. Du kannst Überschriften, Listen, Fett, Kursiv, Unterstrichen und Durchgestrichen verwenden. Über das Sprachmenü hinterlegst du den Text pro Sprache.

    Der Hinweis steht im Editor, direkt unter den Erinnerungen.
  </Step>

  <Step title="Speichern">
    Klicke auf **Speichern**. Danach steht dort **Gespeichert**.

    Auf Account- und Ressourcen-Ebene speicherst du denselben Text über **Speichern**. Dort gibt es keine Terminerinnerung.
  </Step>
</Steps>

Sobald die Erinnerung und der Text gespeichert sind, erscheint der Hinweis in den passenden E-Mails. Die Terminerinnerung gilt für nachfolgende Buchungen dieses Services oder dieser Buchungsoption.

## Einstellungen

| Einstellung | Beschreibung |
| - | - |
| Standarderinnerungen vor Buchungsbeginn | Zeitpunkte vor dem Start, in Minuten, Stunden oder Tagen. Leere Liste bedeutet keine Erinnerung vor Beginn. Mindestens 5 Minuten, höchstens ein Jahr. |
| Standarderinnerungen vor Buchungsende | Zeitpunkte vor dem Ende. Leere Liste bedeutet keine Erinnerung vor Ende. |
| Hinzufügen | Legt einen weiteren Zeitpunkt an. Der erste Wert ist 60 Minuten. |
| Löschen | Entfernt einen Zeitpunkt. |
| Zusätzliche E-Mail Informationen | Text auf Account-, Ressourcen- oder Service-Ebene. Er steht auch in der Erinnerungsmail. |

## Einschränkungen

* Das Layout der E-Mail bleibt fest. Du ergänzt nur den Text.
* Es gibt keinen Schalter für Terminerinnerungen. Ohne Zeitpunkt sendet anny keine Erinnerung.
* Account und Ressource haben nur den Text, keine Terminerinnerung.
* Kund:innen können Erinnerungen im Profil unter **Benachrichtigungen** mit **Erinnerungen** abbestellen. Den Zeitpunkt können sie selbst anpassen.
* Offene Rechnungen erinnerst du nicht hier. Dafür nutzt du **Zahlungserinnerungen senden** unter **Account Einstellungen** → Reiter **Rechnungsstellung** → **Automatisierte Rechnungsstellung**. Siehe [Zahlungserinnerungen](/pay-later).

## FAQ

<AccordionGroup>
  <Accordion title="Sehen Kund:innen die Texte aller Ebenen gleichzeitig?">
    Ja. Liegt auf Account-, Ressourcen- und Service-Ebene jeweils ein Text, stehen alle drei in der E-Mail. Gibt es mehr als einen Hinweis, bekommt jeder Block eine eigene Überschrift mit dem Namen der Ebene.
  </Accordion>

  <Accordion title="Wie schalte ich die Terminerinnerung aus?">
    Entferne alle Einträge unter **Standarderinnerungen vor Buchungsbeginn** und **Standarderinnerungen vor Buchungsende**. Es gibt keinen separaten Schalter.
  </Accordion>

  <Accordion title="Kann ich das E-Mail-Layout anpassen?">
    Nein. Das Format der E-Mails ist fest. Den zusätzlichen Text hinterlegst du unter **Zusätzliche E-Mail Informationen**.
  </Accordion>

  <Accordion title="Gelten die Erinnerungen für alle Ressourcen des Services?">
    Ja. Der Service liegt zentral im Account. Die Erinnerungen gelten für Buchungen dieses Services, unabhängig von der verknüpften Ressource.
  </Accordion>

  <Accordion title="Was ist der Unterschied zu Zahlungserinnerungen?">
    Terminerinnerungen gehen vor Buchungsbeginn oder Buchungsende raus. **Zahlungserinnerungen senden** mahnt offene Rechnungen: am Fälligkeitsdatum, 7 Tage danach und 14 Tage danach.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kund:innen erhalten keine Terminerinnerung">
    Im Service ist kein Zeitpunkt hinterlegt, der Plan enthält keine Terminerinnerungen, oder die Person hat **Erinnerungen** im Profil abbestellt. Prüfe den Reiter **Mitteilungen**, den Plan **Essential** und das Profil der Kund:in.
  </Accordion>

  <Accordion title="Es gehen Zahlungserinnerungen raus, aber keine Terminerinnerungen">
    Zahlungserinnerungen kommen aus **Account Einstellungen** → Reiter **Rechnungsstellung** → **Automatisierte Rechnungsstellung** → **Zahlungserinnerungen senden**. Den Zeitpunkt der Terminerinnerung stellst du nur am Service oder an der Buchungsoption im Reiter **Mitteilungen** ein.
  </Accordion>

  <Accordion title="Der Hinweis fehlt in der Erinnerungsmail">
    Der Text steht auf keiner der drei Ebenen, oder er wurde nicht mit **Speichern** übernommen. Lege ihn unter **Zusätzliche E-Mail Informationen** ab und speichere. Er erscheint in Bestätigung, Änderung und Erinnerung.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Zusätzliche E-Mail Informationen = Feature `custom-emails`, Planname **E-Mail Templates**, ab Essential. Drei Ebenen in der Mail: Account, Ressource, Service. Mehr als ein Block bekommt eine Überschrift mit dem Namen der Ebene.
> * Terminerinnerungen = `service.settings.reminders.beforeStart` und `beforeEnd`, Feature `default-reminders`, Planname **Terminerinnerungen**, ab Essential. Leere Arrays = aus, kein Toggle. Offset in Minuten, Minimum 5, Maximum 525600, UI-Default 60. Einheit Minuten, Stunden oder Tage. Button **Hinzufügen**, Entfernen mit **Löschen**.
> * UI am Service und an der Buchungsoption: Seitenleiste Services → Reiter Mitteilungen. **Erinnerungen** steht über **Zusätzliche E-Mail Informationen**. Speichern über **Speichern**, danach **Gespeichert**.
> * Account: Account-Name oben oder Benutzermenü **Account Einstellungen** → Reiter **Mitteilungen**. Ressource: Seitenleiste Ressourcen → Reiter **Mitteilungen**. Dort nur der Text, keine Terminerinnerung.
> * Kund:innen: Profil → Benachrichtigungen → Schalter **Erinnerungen**. Zeitpunkt kann kundenseitig angepasst werden.
> * Zahlungserinnerungen: Account Einstellungen → Reiter Rechnungsstellung → Automatisierte Rechnungsstellung, Toggle **Zahlungserinnerungen senden**. Artikel: /pay-later
> * Alte Hilfe-Route `/configure-booking-reminders` leitet auf diesen Artikel um.
> * Verwandte Artikel: /mobile-notifications, /pay-later, /anny-plan, /email-design-september-2026


# Eigene Formulare
Source: https://docs.anny.co/custom-forms

Erfasse individuelle Informationen im Buchungsprozess mit eigenen Formularfeldern pro Buchungsoption.

Eigene Formulare ermöglichen dir, individuell abgestimmte Informationen direkt im Buchungsprozess von deinen Kund:innen abzufragen. Du erstellst ein oder mehrere Formulare mit verschiedenen Feldtypen und weist sie flexibel einzelnen Buchungsoptionen zu, um kundenbezogene Daten effizient und zielgerichtet zu erfassen.

## Wie funktioniert Eigene Formulare?

Du erstellst ein Formular mit beliebig vielen Feldern und legst dabei fest, auf welcher Ebene die Daten erfasst werden:

* **Buchung**: Kund:innen füllen das Formular für jede einzelne Buchung aus.
* **Bestellung**: Kund:innen füllen das Formular einmal pro Gesamtbestellung aus (z. B. bei mehreren Buchungen in einem Warenkorb).
* **Kunde**: Kund:innen füllen das Formular einmalig für ihr Kundenprofil aus (z. B. für selten wechselnde Stammdaten).

Jedes Formular wird einer Buchungsoption zugewiesen. Pro Buchungsoption können mehrere Formulare gleichzeitig aktiv sein. Formulare, die aktuell nicht benötigt werden, verschiebst du per Drag & Drop in den inaktiven Bereich und kannst sie jederzeit wieder aktivieren oder einer anderen Buchungsoption zuweisen.

Sobald ein Formular einer Buchungsoption hinzugefügt ist, legst du pro Formular den **Abfragezeitpunkt** fest:

* **Bei Buchungsabschluss**: Kund:innen füllen das Formular direkt im Checkout aus (Standardverhalten).
* **Später (beim Check-in)** (BETA): Kund:innen können das Formular schon im Checkout optional ausfüllen. Pflicht wird es erst beim Check-in, falls Angaben noch fehlen. Das ist besonders nützlich, wenn Angaben erst kurz vor dem Termin relevant oder bekannt sind.

Weitere Details zur Einrichtung und zum Ablauf der verzögerten Formularabfrage beim Check-in findest du im Artikel [Check-in: Erste Schritte](/check-in-setup).

Nach der Buchung können Kund:innen ihre übermittelten Formulardaten in der Buchungsübersicht einsehen und bearbeiten, sofern du die nachträgliche Bearbeitung im jeweiligen Service freigibst. Diese Funktion ist aktuell nur in der Web-Version verfügbar.

<Tip>
  Nutze die Ebene "Kunde" für Angaben, die sich selten ändern (z. B. Firmendaten, Zertifikate). So müssen Kund:innen diese Informationen nur einmal hinterlegen.
</Tip>

## Wann nutze ich das?

* **Du fragst pro Buchung spezifische Details ab (z. B. Teilnehmerzahl, Sonderwünsche, Ankunftszeit)**: Erstelle ein Formular auf Buchungsebene mit den passenden Feldtypen.
* **Du brauchst einmalige Angaben pro Bestellung, die für alle enthaltenen Buchungen gelten (z. B. Projektname, Versicherungsbestätigung)**: Nutze die Bestellebene, damit Kund:innen die Information nur einmal eingeben.
* **Du sammelst selten wechselnde Stammdaten (z. B. Gewerbenachweis, Zertifikat)**: Nutze die Kundenebene, damit die Angabe dauerhaft im Profil gespeichert wird.
* **Du möchtest Unterlagen vorab erhalten (z. B. Nachweise, Fotos, ausgefüllte PDFs)**: Verwende den Feldtyp Datei-Upload.
* **Nicht geeignet für**: Reine Kontaktdaten (Name, E-Mail, Telefon), denn diese erfasst anny bereits automatisch im Kundenprofil.

## Zusammenhang mit anderen Features

* [**Rechtliche Dokumente**](/legal-documents): Rechtliche Dokumente werden ebenfalls im Tab Formulare konfiguriert. Sie dienen der rechtlichen Absicherung (z. B. AGB-Bestätigung), während eigene Formulare inhaltliche Informationen abfragen.
* [**Wiederkehrende Buchungen**](/recurring-bookings): Bei Buchungsserien werden Formulardaten ausschließlich auf dem Mastertermin gespeichert und sind nur dort sichtbar und bearbeitbar.
* [**Check-In Terminal**](/check-in-setup): Auf Badge-Vorlagen kannst du Formularfelder der Buchung, des Kunden und der Bestellung als Variablen einfügen.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Interner Name | Bezeichnung zur Verwaltung |
| Beschreibung | Optionaler Hinweistext für Kund:innen |
| Anwenden auf | Buchung, Bestellung oder Kunde |
| Feldtitel | Bezeichnung des Eingabefelds |
| Feldtyp | Siehe Tabelle unten |
| Pflichtfeld | Feld muss ausgefüllt werden |
| Im Checkout anzeigen | Feld direkt im Checkout sichtbar |
| Abfragezeitpunkt | Bei Buchungsabschluss oder Später (beim Check-in, BETA) |
| Nachträgliche Bearbeitung | Kund:innen dürfen Daten nach Buchung ändern (pro Service) |

Für den Feldtyp Datei-Upload legst du zusätzlich die maximale Dateigröße (Standard: 5 MB) sowie die Mindest- und Maximalanzahl der erlaubten Dateien fest.

## Verfügbare Feldtypen

| Feldtyp | Anwendungsfall |
| - | - |
| Text | Kurze Angaben, z. B. Name einer Begleitperson |
| Zahl | Numerische Werte, z. B. Teilnehmerzahl |
| Text (lang) | Ausführliche Details, Wünsche oder Hinweise |
| Auswahl | Genau eine Antwort, z. B. Kenntnisstand |
| Mehrfachauswahl | Mehrere Antworten, z. B. thematische Interessen |
| Checkbox | Optionale Bestätigung, z. B. "Ich bringe Material mit" |
| Datum | Konkretes Datum, z. B. Geburtsdatum |
| Datum und Uhrzeit | Datum mit Uhrzeit, z. B. Ankunftstermin |
| Datei-Upload | Dokumente, Nachweise oder Medien vorab bereitstellen |

<Tip>
  Unterstützte Dateitypen beim Upload: JPEG, PNG, GIF, WebP, PDF, Word (.doc/.docx), Excel (.xls/.xlsx), OpenDocument (.odt/.ods/.odp), Text (.txt), CSV, ZIP, MP3, MP4.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Workshop-Anbieter fragt Vorkenntnisse und Ernährungswünsche ab">
    Ein Workshop-Anbieter möchte pro Buchung den Kenntnisstand und Ernährungswünsche der Teilnehmer:innen abfragen, um Gruppen einteilen und das Catering planen zu können.
  </Accordion>

  <Accordion title="Equipment-Verleih sammelt Projektdaten pro Bestellung">
    Ein Verleih-Anbieter möchte bei jeder Bestellung einmalig den Projektnamen und eine Schadensversicherungs-Bestätigung abfragen, unabhängig davon, wie viele Geräte in einer Bestellung enthalten sind.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich ein Formular mehreren Buchungsoptionen zuweisen?">
    Ja. Bestehende Formulare findest du zentral im Bereich Eigene Formulare. Von dort kannst du sie per Drag & Drop verschiedenen Buchungsoptionen zuweisen.
  </Accordion>

  <Accordion title="Was passiert mit Formulardaten bei wiederkehrenden Buchungen?">
    Bei Buchungsserien werden Formulardaten ausschließlich auf dem Mastertermin gespeichert. In den einzelnen Serienterminen sind die Felder nicht editierbar, um die Konsistenz der Serie sicherzustellen.
  </Accordion>

  <Accordion title="Können Kund:innen ihre Formulardaten nach der Buchung ändern?">
    Ja, wenn du die nachträgliche Bearbeitung im jeweiligen Service aktivierst. Kund:innen sehen ihre Angaben dann in der Buchungsübersicht und können sie dort bearbeiten. Diese Funktion ist aktuell nur in der Web-Version verfügbar.
  </Accordion>

  <Accordion title="Wie viele Felder kann ein Formular enthalten?">
    Es gibt keine feste Obergrenze. Du fügst über **+ Feld hinzufügen** beliebig viele Felder innerhalb eines Formulars hinzu.
  </Accordion>

  <Accordion title="Welche Dateitypen sind beim Datei-Upload erlaubt?">
    JPEG, PNG, GIF, WebP, PDF, Word, Excel, OpenDocument, Text, CSV, ZIP, MP3 und MP4. Die Standard-Dateigröße liegt bei 5 MB.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein Formular erscheint nicht im Buchungsprozess">
    Das Formular ist möglicherweise im inaktiven Bereich. Öffne die Buchungsoption, wechsle zum Tab **Formulare** und prüfe, ob das Formular links (aktiv) oder rechts (inaktiv) steht. Ziehe es per Drag & Drop nach links, um es zu aktivieren.
  </Accordion>

  <Accordion title="Kund:innen können ihre Formulardaten nicht nachträglich bearbeiten">
    Prüfe, ob die nachträgliche Bearbeitung im betreffenden Service aktiviert ist. Stelle außerdem sicher, dass die Person die Web-Version nutzt, da die Funktion in der mobilen App noch nicht verfügbar ist.
  </Accordion>

  <Accordion title="Formularfelder bei Serienterminen sind nicht ausfüllbar">
    Das ist erwartetes Verhalten. Formulardaten werden bei Serien nur auf dem Mastertermin erfasst und gespeichert. Die einzelnen Serientermine zeigen die Felder nicht separat an.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Ressourcen** → Ressource wählen → **Buchungsoption** → Tab **Formulare** → **Eigene Formulare**
> * "Anwenden auf" steuert Speicherort: Buchung = pro Einzelbuchung, Bestellung = einmal pro Warenkorb, Kunde = einmalig im Profil
> * Formulare per Drag & Drop zwischen aktiv (links) und inaktiv (rechts) verschieben
> * Serien: Formulardaten nur auf Mastertermin gespeichert, Einzeltermine nicht editierbar
> * Nachträgliche Bearbeitung durch Kund:innen: Admin-Freigabe pro Service in den Service-Einstellungen, nur Web-Version (mobile App nicht enthalten)
> * Max. Dateigröße Upload: Standard 5 MB (konfigurierbar), unterstützte Formate: JPEG, PNG, GIF, WebP, PDF, DOC/DOCX, XLS/XLSX, ODT/ODS/ODP, TXT, CSV, ZIP, MP3, MP4
> * Abfragezeitpunkt pro Formular: "Bei Buchungsabschluss" (Standard, Pflicht im Checkout) oder "Später (beim Check-in)" (BETA: im Checkout optional mit Hint, beim Check-in Pflicht falls leer).
> * Eigene Formulare ≠ Rechtliche Dokumente: Formulare erfassen inhaltliche Daten, Rechtliche Dokumente sichern rechtlich ab (AGB, Widerruf etc.)
> * Badge-Vorlagen (Displays): Variablenauswahl enthält Feldtitel aus Buchungs-, Kunden- und Bestellformularen. Bestellfelder sind auf buchungsbezogenen Vorlagen wählbar.
> * Verwandte Artikel: /legal-documents, /buchungsoption-konfigurieren, /recurring-bookings, /check-in-setup


# Kundensalden & Sammelrechnungen
Source: https://docs.anny.co/customer-balances-and-collective-invoices

Sammle Rechnungsentwürfe pro Kund:in oder Unternehmen auf einem Saldo und konsolidiere sie später in einer Sammelrechnung.

Mit Kundensalden sammelst du Rechnungsentwürfe aus Buchungen, manuellen Rechnungen und optional auch aus Abos zunächst auf einem offenen Saldo, statt jede Position sofort final abzurechnen. Am Ende des Abrechnungszeitraums erstellt anny daraus eine Sammelrechnung. Das reduziert den Abrechnungsaufwand bei Firmenkund:innen mit vielen Buchungen und liefert eine zentrale, nachvollziehbare Rechnung pro Periode.

<Info>
  * Verfügbar ab dem **Business Plan**.
  * Aktiviere das Feature unter **Avatar** → **Account-Einstellungen** → **Rechnungsstellung** → **Kundensalden**.
</Info>

## Wie funktioniert das Feature?

Die Grundlogik der Rechnungsstellung bleibt erhalten: Für jede Buchung oder manuelle Rechnung entsteht ein Rechnungsentwurf. Kundensalden fügen eine zusätzliche Steuerungsebene hinzu:

1. Der Rechnungsentwurf wird einem offenen Kundensaldo zugeordnet. Entscheidend ist der Buchungszeitpunkt (nicht der Checkout-Zeitpunkt). Ist ein Service so konfiguriert, dass erst zum Buchungsbeginn abgerechnet wird, landet die Position im späteren Abrechnungszeitraum.
2. Kundensalden können pro Person oder pro Unternehmen geführt werden. Bei Gruppierung nach Unternehmen ordnet anny Buchungen automatisch anhand des Firmennamens und, wenn vorhanden, einer nicht-generischen E-Mail-Domain zu.
3. Am Stichtag (Periodenende + konfigurierte Verzögerung) werden alle verknüpften Rechnungsentwürfe in einer Sammelrechnung konsolidiert. Die Einzelentwürfe bleiben zur Nachvollziehbarkeit verlinkt.

Zusätzlich kannst du den Flow an mehreren Stellen steuern:

* **Maximaler Bestellbetrag für Saldo**: Verhindert, dass große Einzelbestellungen erst später abgerechnet werden. Beispiel 2000 €: Bestellungen bis 2000 € auf den Saldo, darüber sofortige Rechnung.
* **Schwellenwert für automatische Abrechnung**: Löst eine Sammelrechnung aus, sobald ein Saldo einen bestimmten Betrag erreicht.
* **Mindestbetrag**: Schiebt kleine Restbeträge in die nächste Periode.
* **Nur von Admins erstellte Buchungen** oder **Community-Beschränkung**: Definiert, wer auf Kundensaldo buchen darf.
* **Abo-Rechnungen einbeziehen**: Verschiebt deren Zahlungszeitpunkt an das Ende des Abrechnungszeitraums.

Du kannst Rechnungsentwürfe jederzeit manuell vorzeitig festschreiben oder in einen anderen Saldo verschieben.

## Wann nutze ich das?

* **Mehrere Buchungen innerhalb eines Zeitraums sollen gesammelt statt einzeln abgerechnet werden**: Typisch für Coworking Spaces oder Raumvermietung mit wiederkehrenden Buchungen.
* **Mehrere Mitarbeitende eines Unternehmens sollen auf einer Rechnung landen**: Gruppiere Salden nach Unternehmen, damit alle Buchungen konsolidiert werden.
* **Du möchtest vertrauenswürdigen Kund:innen spätere Abrechnung ermöglichen**: Beschränke die Funktion auf bestimmte Communities.
* **Zusatzkosten, manuelle Rechnungen oder Abo-Rechnungen sollen in einen gemeinsamen Abrechnungsflow**: Aktiviere die jeweiligen Optionen in den Kundensaldo-Einstellungen.
* **Nicht geeignet für**: Szenarien, in denen jede Buchung sofort final abgerechnet werden muss. Hier ist ein klassischer Einzelrechnungsprozess die bessere Wahl.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Communities | Berechtigungssteuerung, wer auf Kundensaldo buchen darf |
| Unternehmensprofile | Gruppierung der Salden pro Unternehmen, zentrale Rechnungs-E-Mail |
| Abos & Mitgliedschaften | Abo-Rechnungen können in den Kundensaldo einbezogen werden |
| Zahlen auf Rechnung (Pay-Later) | Kombinierbar: Pay-Later erzeugt Entwürfe, die auf dem Saldo gesammelt werden |

## Einstellungen & Optionen

Pfad: **Avatar** (oben rechts) → **Account-Einstellungen** → **Rechnungsstellung** → **Kundensalden**

| Einstellung | Beschreibung |
| - | - |
| Abrechnungszeitraum | Periode für die Konsolidierung (z. B. monatlich) |
| Verzögerung nach Periodenende | Tage bis zur automatischen Abrechnung |
| Salden nach Unternehmen gruppieren | Buchungen pro Firma statt pro Person bündeln |
| Abo-Rechnungen einbeziehen | Abo-Abrechnungen in den Saldo aufnehmen |
| Maximaler Bestellbetrag | Obergrenze für Einzelbestellungen auf Saldo. Bestellungen **über** diesem Betrag werden sofort abgerechnet, nicht auf den Saldo geschrieben. Beispiel: 2000 € – Bestellungen bis 2000 € landen auf dem Saldo, darüber entsteht sofort eine Rechnung. |
| Schwellenwert für automatische Abrechnung | Konsolidierung bei Erreichen eines Gesamtbetrags |
| Mindestbetrag | Kleine Beträge in nächste Periode schieben. Die Sammelrechnung wird erst erstellt, wenn der Mindestbetrag erreicht ist. |
| Nur Admin-Buchungen | Nur von Admins erstellte Buchungen landen auf Saldo |
| Community-Beschränkung | Nur Mitglieder bestimmter Communities dürfen auf Saldo buchen |

Weitere relevante Bereiche:

* **Rechnungen**: Alle Rechnungsentwürfe, Salden und Konsolidierungen nachvollziehen
* **Kunden** → **Unternehmen**: Offene Salden auf Unternehmensebene einsehen
* **Checkout**: Kund:innen sehen die Option "Auf Kundensaldo buchen", wenn die Berechtigung und Service-Einstellungen es erlauben

## Was ändert sich für Kund:innen?

* Kund:innen erhalten nicht zwingend sofort eine finale Einzelrechnung. Ihre Positionen werden auf dem Saldo gesammelt.
* Je nach Konfiguration sehen Kund:innen im Checkout eine Option, die Buchung auf den Kundensaldo zu schreiben.
* Bestätigungs-E-Mails zeigen transparent, zu welchem Abrechnungszeitraum die Position gehört und wann die Sammelrechnung erstellt wird.
* Owner und Admins eines Firmenkontos sehen offene Salden unter **Home**.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Coworking Space mit Firmensaldo, Community-Freigabe und Abo-Rechnungen">
    Ein Coworking Space möchte alle Buchungen und Abos eines Unternehmens monatlich gesammelt abrechnen. Nur Mitglieder der Community "Members" dürfen auf Kundensaldo buchen.

    <Steps>
      <Step title="Kundensalden aktivieren und konfigurieren">
        Öffne **Avatar** → **Account-Einstellungen** → **Rechnungsstellung** → **Kundensalden**. Aktiviere das Feature, setze den Abrechnungszeitraum auf **monatlich** und die Verzögerung auf **3 Tage** nach Periodenende.
      </Step>

      <Step title="Gruppierung und Abo-Einbeziehung">
        Aktiviere **Salden nach Unternehmen gruppieren** und **Abo-Rechnungen einbeziehen**.
      </Step>

      <Step title="Berechtigungen einschränken">
        Beschränke die Funktion auf die Community **Members** und setze einen maximalen Bestellbetrag von 250 €.
      </Step>

      <Step title="Ergebnis prüfen">
        Prüfe unter **Kunden** → **Unternehmen** → z. B. "Figma", dass Buchungen der Mitarbeitenden im offenen Kundensaldo zusammenlaufen. Anfang des Folgemonats wird die Sammelrechnung automatisch erstellt.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Stadtverwaltung mit Sammelrechnung ohne Online-Zahlung">
    Eine Stadtverwaltung möchte mehrere Raumbuchungen monatlich gesammelt abrechnen, nutzt aber keine Online-Zahlung.

    <Steps>
      <Step title="Kundensalden aktivieren">
        Öffne **Avatar** → **Account-Einstellungen** → **Rechnungsstellung** → **Kundensalden**. Wähle **monatlich** als Abrechnungszeitraum und setze die automatische Abrechnung auf **5 Tage** nach Periodenende.
      </Step>

      <Step title="Nach Unternehmen gruppieren">
        Aktiviere **Salden nach Unternehmen gruppieren**, damit Buchungen verschiedener Mitarbeitender auf einer gemeinsamen Sammelrechnung landen.
      </Step>

      <Step title="Rechnungs-E-Mail hinterlegen">
        Gehe zu **Kunden** → **Unternehmen** → "Stadt Musterstadt" und hinterlege eine zentrale **Rechnungs-E-Mail**, damit die Sammelrechnung an die richtige Stelle gesendet wird.
      </Step>

      <Step title="Ergebnis prüfen">
        Prüfe in der Unternehmensansicht, dass Rechnungsentwürfe dem offenen Kundensaldo zugeordnet sind. Anfang des Folgemonats wird die konsolidierte Rechnung automatisch erstellt und an die hinterlegte E-Mail versendet.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Brauche ich für Kundensalden aktivierte Online-Zahlung?">
    Nein. Kundensalden funktionieren auch ohne Online-Zahlung. Online-Zahlung ist aber sinnvoll, wenn die spätere Sammelrechnung automatisch über eine hinterlegte Zahlungsmethode eingezogen werden soll.
  </Accordion>

  <Accordion title="Wann wird aus einem Kundensaldo eine Sammelrechnung?">
    Am Ende des gewählten Abrechnungszeitraums plus der konfigurierten Verzögerung. Zusätzlich kann eine Sammelrechnung früher entstehen, wenn du einen Schwellenwert für automatische Abrechnung gesetzt hast.
  </Accordion>

  <Accordion title="Bekommt jede Buchung im Kundensaldo eine eigene Rechnungsnummer?">
    Nein. Die finale Sammelrechnung erhält die offizielle Rechnungsnummer. Die einzelnen Rechnungsentwürfe bleiben zur Nachvollziehbarkeit verknüpft, sind aber keine separaten finalen Rechnungen.
  </Accordion>

  <Accordion title="Kann ich einzelne Ressourcen von Kundensalden ausschließen?">
    Nicht direkt über eine Ressourceneinstellung. Die Steuerung erfolgt über die globalen Kundensaldo-Einstellungen, Service-Zahlungseinstellungen, Grenzwerte und Berechtigungen.
  </Accordion>

  <Accordion title="Wer erhält die Sammelrechnung bei einem Unternehmenssaldo?">
    Wenn für das Unternehmen eine Rechnungs-E-Mail gepflegt ist, geht die Sammelrechnung dorthin. Fehlt diese Angabe, wird sie an die zuerst mit dem Unternehmen verknüpfte Person gesendet.
  </Accordion>

  <Accordion title="Kann ich die Summe einer Bestellung begrenzen, die auf den Saldo geht?">
    Ja. Unter **Kundensalden** setzt du **Maximaler Bestellbetrag für Saldo**. Ein üblicher Wert ist **2000 €**: Bestellungen bis zu diesem Betrag werden auf den Saldo geschrieben, Bestellungen darüber sofort abgerechnet. Das ist kein harter Warenkorb-Deckel, sondern steuert nur, ob die Bestellung in den Saldo darf. **Mindestbetrag** steuert etwas anderes: die Sammelrechnung wartet, bis der offene Saldo diesen Betrag erreicht hat.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Eine Buchung landet nicht im Unternehmenssaldo">
    Prüfe, ob "Salden nach Unternehmen gruppieren" aktiv ist und ob bei der Buchung dasselbe Unternehmen verwendet wurde. Unterschiedliche Firmennamen oder abweichende E-Mail-Domains können dazu führen, dass anny separate Unternehmen erkennt.
  </Accordion>

  <Accordion title="Eine große Buchung wird sofort abgerechnet statt auf den Saldo geschrieben">
    Das ist erwartetes Verhalten durch den eingestellten **Maximalen Bestellbetrag für Saldo** (Beispiel 2000 €: alles darüber wird sofort berechnet) oder einen bereits erreichten Schwellenwert für automatische Abrechnung.
  </Accordion>

  <Accordion title="Kleine Restbeträge werden nicht abgerechnet">
    Wenn ein Mindestbetrag konfiguriert ist, werden sehr kleine offene Beträge in die nächste Periode übernommen, bis der Mindestwert erreicht ist.
  </Accordion>

  <Accordion title="Eine Abo-Rechnung wird später bezahlt als bisher">
    Wenn Abo-Rechnungen in Kundensalden einbezogen werden, verschiebt sich die Zahlung an das Ende des Abrechnungszeitraums. Das ist kein Fehler, sondern Teil der Sammelrechnungslogik.
  </Accordion>

  <Accordion title="Die Sammelrechnung geht an die falsche Person">
    Wenn auf Unternehmensebene keine Rechnungs-E-Mail gepflegt ist, wird die Sammelrechnung an die zuerst zugeordnete Person gesendet. Pflege bei Unternehmenssalden immer eine zentrale Rechnungs-E-Mail.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Kundensalden. Verfügbar ab Business Plan. Muss unter Account-Einstellungen → Rechnungsstellung → Kundensalden aktiviert werden.
> * UI-Pfad: Avatar → Account-Einstellungen → Rechnungsstellung → Kundensalden
> * Salden pro Person ODER pro Unternehmen (nicht beides gleichzeitig). Gruppierung nach Unternehmen nutzt Firmenname + nicht-generische E-Mail-Domain zur Zuordnung.
> * Rechnungsentwurf wird dem Saldo des Monats zugeordnet, in dem die BUCHUNG stattfindet (nicht der Checkout-Zeitpunkt).
> * Konsolidierung: Am Stichtag (Periodenende + Verzögerung) werden alle verknüpften Entwürfe zu einer Sammelrechnung zusammengefasst. Einzelentwürfe bleiben verlinkt.
> * Steuerungsmechanismen: Maximaler Bestellbetrag (Bestellungen DARÜBER nicht auf Saldo, Beispiel 2000 €), Schwellenwert für automatische Abrechnung, Mindestbetrag (Sammelrechnung erst ab diesem Saldo), Community-Beschränkung, "Nur Admin-Buchungen". Kein harter Warenkorb-Maximalbetrag im Checkout.
> * Abo-Rechnungen optional einbeziehbar: verschiebt deren Zahlung an das Periodenende.
> * Automatische Zahlung der Sammelrechnung möglich, wenn Kunde hinterlegte Zahlungsmethode aus Abo hat.
> * Verwechslungsgefahr: Kundensalden ≠ Pay-Later. Kundensalden sind ein Abrechnungsmodell (Entwürfe sammeln + konsolidieren). Pay-Later ist eine Zahlungsmethode pro Buchungsoption.
> * Empfänger Sammelrechnung: Rechnungs-E-Mail des Unternehmens > erste verknüpfte Person.
> * Verwandte Artikel: Rechnungsstellung (Übersicht), Unternehmen verwalten, Pay-Later, Rechnungsentwurf.


# Datenschutz & Löschfristen
Source: https://docs.anny.co/data-privacy

Definiere eigene Lösch- oder Anonymisierungsfristen für personenbezogene Daten und halte Datenschutzrichtlinien ein.

Mit dem Feature Löschfristen setzt du interne Richtlinien zur Datenaufbewahrung um und definierst flexibel, wann personenbezogene Daten anonymisiert oder gelöscht werden. anny ist grundsätzlich DSGVO-konform, entwickelt in Deutschland und betrieben auf Servern mit Hostingstandort Deutschland.

<Info>
  Das Feature **Löschfristen** muss unter **Account-Einstellungen → Features** aktiviert werden.
</Info>

## Wie funktioniert das Feature?

Als Auftragsverarbeiter löscht anny keine Daten eigenständig. Du entscheidest, wann und wie lange personenbezogene Daten gespeichert, anonymisiert oder gelöscht werden.

Standardmäßig speichert anny Daten mindestens 10 Jahre. Sobald du das Feature aktivierst und eigene Fristen konfigurierst, werden nach Ablauf der definierten Zeiträume folgende personenbezogene Informationen verarbeitet:

* Vorname und Nachname
* E-Mail-Adresse
* Aktivitäten innerhalb der Plattform (z. B. Buchungen)
* Unternehmen
* Handynummer

Du wählst zwischen zwei Modi:

| Modus | Wirkung | Empfohlen für |
| - | - | - |
| Anonymisierung | Buchungsdaten bleiben in anonymisierter Form erhalten (z. B. für Auslastungsberichte). Personenbezug wird vollständig entfernt. | Desksharing, Hochschulen |
| Vollständige Löschung | Alle Buchungen und Nutzerinformationen werden vollständig entfernt. Keine Daten zur Auswertung verbleiben. | Sensible Bereiche (z. B. betriebliche Gesundheitsprogramme) |

<Warning>
  Sowohl Anonymisierung als auch vollständige Löschung sind irreversibel. Gelöschte oder anonymisierte Daten können nicht wiederhergestellt werden.
</Warning>

So konfigurierst du die Fristen:

<Steps>
  <Step title="Feature aktivieren">
    Navigiere in den **Account-Einstellungen** zum Reiter **Features** und aktiviere **Löschfristen**.
  </Step>

  <Step title="Datenschutz-Tab öffnen">
    Nach Aktivierung wird der Reiter **Datenschutz** sichtbar. Klicke darauf.
  </Step>

  <Step title="Eigene Löschfristen konfigurieren">
    Wähle **Eigene Löschfristen** und entscheide dich für **Anonymisieren** oder **Löschen**. Stelle die Fristen für kostenlose und kostenpflichtige Buchungen separat ein. Die Frist wird in Wochen festgelegt (Minimum: 1 Woche).
  </Step>

  <Step title="Speichern">
    Klicke auf **Speichern**, um die Einstellungen zu übernehmen.
  </Step>
</Steps>

## Wann nutze ich das?

* **Du möchtest interne Datenschutzrichtlinien umsetzen**: Definiere individuelle Aufbewahrungsfristen für kostenlose und kostenpflichtige Buchungen getrennt.
* **Du betreibst eine Hochschule oder Desksharing-Lösung und brauchst Auslastungsdaten ohne Personenbezug**: Nutze die Anonymisierung, um statistische Auswertungen zu ermöglichen.
* **Du verarbeitest besonders sensible Daten (z. B. Gesundheitsprogramme)**: Nutze die vollständige Löschung, damit keinerlei Rückverfolgbarkeit möglich ist.
* **Nicht geeignet für**: Reine Sichtbarkeitssteuerung innerhalb von Communities. Dafür nutze den Inkognito-Modus in den Community-Einstellungen.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Löschfristen aktivieren | Feature unter Account-Einstellungen → Features einschalten |
| Modus | Anonymisieren oder vollständig löschen |
| Frist kostenlose Buchungen | In Wochen, Minimum 1 Woche |
| Frist kostenpflichtige Buchungen | In Wochen, Minimum 1 Woche |

<Tip>
  Setze die Frist für kostenpflichtige Buchungen länger als für kostenlose, um Aufbewahrungspflichten aus der Rechnungsstellung zu berücksichtigen.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Universität anonymisiert Buchungsdaten nach Semesterende">
    Eine Universitätsbibliothek möchte Auslastungsberichte erstellen, ohne personenbezogene Daten dauerhaft zu speichern.
  </Accordion>

  <Accordion title="Gesundheitsanbieter löscht alle Daten nach Aufbewahrungsfrist">
    Ein betriebliches Gesundheitsprogramm erfordert die vollständige Entfernung aller Nutzerdaten nach Ablauf der gesetzlichen Aufbewahrungspflicht.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich die Löschfrist nachträglich ändern?">
    Ja, du kannst die Fristen jederzeit anpassen. Bereits anonymisierte oder gelöschte Daten können jedoch nicht wiederhergestellt werden.
  </Accordion>

  <Accordion title="Werden die Daten sofort nach Ablauf der Frist gelöscht?">
    Die Verarbeitung erfolgt automatisch nach Ablauf der eingestellten Frist. Der genaue Zeitpunkt hängt vom internen Verarbeitungszyklus ab.
  </Accordion>

  <Accordion title="Was passiert, wenn ich das Feature wieder deaktiviere?">
    Bereits verarbeitete Daten bleiben anonymisiert oder gelöscht. Neue Daten werden wieder nach der Standardfrist von mindestens 10 Jahren gespeichert.
  </Accordion>

  <Accordion title="Gilt die Frist pro Buchung oder pro Kunde?">
    Die Frist bezieht sich auf die letzte Aktivität des Kunden. Solange aktive Buchungen bestehen, werden keine Daten verarbeitet.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Reiter Datenschutz ist nicht sichtbar">
    Das Feature Löschfristen ist nicht aktiviert. Navigiere zu **Account-Einstellungen → Features** und aktiviere **Löschfristen**. Der Reiter erscheint erst danach.
  </Accordion>

  <Accordion title="Kundendaten sind trotz abgelaufener Frist noch sichtbar">
    Prüfe, ob der Kunde noch aktive Buchungen hat. Solange offene Buchungen bestehen, wird die Löschung oder Anonymisierung nicht ausgeführt.
  </Accordion>

  <Accordion title="Community-Mitglieder werden nicht anonymisiert">
    Die Löschfristen betreffen Buchungs- und Kundendaten. Die Sichtbarkeit in Communities steuerst du über den Inkognito-Modus in den Community-Einstellungen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature-Name: Löschfristen
> * UI-Pfad: Account-Einstellungen → Features → Löschfristen aktivieren → Reiter Datenschutz wird sichtbar
> * Standardspeicherfrist ohne Feature: mindestens 10 Jahre
> * Beide Modi (Anonymisierung, vollständige Löschung) sind irreversibel
> * anny agiert als Auftragsverarbeiter (Art. 28 DSGVO), löscht nie eigenständig
> * Getrennte Fristen für kostenlose und kostenpflichtige Buchungen konfigurierbar
> * Fristformat: Wochen, Minimum 1 Woche, kein Maximum
> * Abgrenzung: Inkognito-Modus (Community-Einstellungen) steuert Sichtbarkeit innerhalb Communities, nicht Datenlöschung
> * Löschfristen betreffen: Vorname, Nachname, E-Mail, Buchungsaktivitäten, Unternehmen, Handynummer
> * Bei Anonymisierung bleiben Buchungsdaten für Auswertungen erhalten, nur der Personenbezug wird entfernt
> * Performance-Verbesserung "Custom Deletion Periods Speedup" deployed Nov 2025


# Invoice forwarding
Source: https://docs.anny.co/datev-import

Richte die automatische Rechnungsweiterleitung an DATEV ein und nutze anny-Exporte für DATEV Unternehmen Online.

anny lässt sich auf mehreren Wegen mit DATEV verbinden: über automatische E-Mail-Weiterleitung von Rechnungs-PDFs, über monatliche Exportpläne für DATEV Unternehmen Online oder über den CAMT.053-Import als Kontoauszug. In diesem Artikel erfährst du, wie du die einzelnen Wege einrichtest.

## Automatische Rechnungsweiterleitung an DATEV

Mit dieser Methode werden alle Rechnungs-PDFs automatisch und einzeln in Echtzeit an DATEV übertragen.

<Steps>
  <Step title="Funktions-E-Mail erstellen">
    Erstelle in deinem Mailing-System eine spezielle Funktions-E-Mail für Rechnungen, z. B. `accounting@deinunternehmen.de`. Diese dient als Zwischenstation für die Weiterleitung an DATEV.
  </Step>

  <Step title="Automatische Weiterleitung zu DATEV einrichten">
    Richte eine automatische Weiterleitung von der Funktions-E-Mail zu deiner DATEV Upload Mail ein. Die DATEV Upload Mail kannst du im DATEV Help Center unter "Einrichtung DATEV Upload Mail" konfigurieren.
  </Step>

  <Step title="Weiterleitung in anny aktivieren">
    Öffne **Avatar** → **Account-Einstellungen** → **Rechnungsstellung**. Trage die Funktions-E-Mail (z. B. `accounting@deinunternehmen.de`) als Rechnungs-E-Mail ein und wähle als Anhangformat **PDF**.
  </Step>
</Steps>

<Tip>
  Die DATEV Upload Mail funktioniert ausschließlich mit bestätigten E-Mail-Adressen. Da anny von einer no-reply-Adresse sendet, ist der Umweg über eine eigene Funktions-E-Mail erforderlich.
</Tip>

<Warning>
  In Google Mail (Gmail) ist es nicht möglich, E-Mails automatisch an eine andere Adresse weiterzuleiten, ohne die Weiterleitungsadresse vorher zu bestätigen. Nutze in diesem Fall einen anderen E-Mail-Anbieter für die Funktions-E-Mail.
</Warning>

## DATEV Unternehmen Online nutzen

Für DATEV Unternehmen Online empfiehlt sich der folgende monatliche Workflow:

<Steps>
  <Step title="Automatischen Rechnungsexport einrichten">
    Öffne die **Export-Zeitpläne** (Menüleiste → Exporte oder direkt über Account-Einstellungen). Erstelle einen monatlichen Exportplan für alle Rechnungen (Status: bezahlt, erstattet, versendet) als PDF an die gewünschte E-Mail-Adresse oder an die DATEV Unternehmen Online Mailadresse.
  </Step>

  <Step title="Internes Konto in DATEV anlegen">
    Erstelle in DATEV Unternehmen Online ein internes Konto für anny und importiere alle Rechnungs-PDFs dorthin.
  </Step>

  <Step title="Gebührenrechnungen ergänzen">
    Lade einmal pro Monat die Rechnungs-PDFs der Online-Transaktionsgebühren (Stripe/anny-Gebühren) manuell in DATEV hoch.
  </Step>
</Steps>

## CAMT.053-Import als Kontoauszug

Für eine vollständige Integration empfehlen wir den CAMT.053-Import, der im Artikel [Buchhaltung mit anny](/accounting) ausführlich beschrieben ist. Dabei behandelt DATEV das anny-Zahlungskonto wie eine reguläre Bankverbindung mit Saldofortschreibung.

## Ergebnis prüfen

Nach der Einrichtung erkennst du den Erfolg daran, dass:

* Bei der E-Mail-Weiterleitung: Rechnungs-PDFs automatisch in deinem DATEV-Posteingang erscheinen
* Bei DATEV Unternehmen Online: Der monatliche Export als ZIP mit allen Rechnungen am definierten Datum zugestellt wird
* Beim CAMT-Import: Der Kontoauszug in DATEV mit Eröffnungs- und Schlusssaldo angezeigt wird

## FAQ

<AccordionGroup>
  <Accordion title="Warum kann ich nicht direkt die DATEV Upload Mail in anny eintragen?">
    Die DATEV Upload Mail akzeptiert nur E-Mails von bestätigten Absenderadressen. Da anny von einer no-reply-Adresse sendet, ist eine Bestätigung nicht möglich. Der Umweg über eine eigene Funktions-E-Mail mit Weiterleitung löst dieses Problem.
  </Accordion>

  <Accordion title="Welche Methode ist für mich die richtige?">
    Für Echtzeit-Einzelbelege nutze die E-Mail-Weiterleitung. Für eine strukturierte monatliche Übergabe nutze den CAMT.053-Import (empfohlen) oder den PDF-Sammelexport für DATEV Unternehmen Online.
  </Accordion>

  <Accordion title="Werden Stornorechnungen auch automatisch weitergeleitet?">
    Ja. Alle Rechnungen und Gutschriften (inklusive Stornorechnungen) werden automatisch als PDF weitergeleitet, sofern die E-Mail-Weiterleitung aktiv ist.
  </Accordion>

  <Accordion title="Kann ich den Export auch an meinen Steuerberater senden?">
    Ja. Unter Export-Zielen kannst du beliebige E-Mail-Adressen als Empfänger hinterlegen. Der Steuerberater erhält dann automatisch das monatliche ZIP-Archiv.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="DATEV erhält keine Rechnungen">
    Prüfe die Weiterleitungskette: 1) Ist die Funktions-E-Mail korrekt in anny unter Rechnungsstellung eingetragen? 2) Ist die automatische Weiterleitung von der Funktions-E-Mail zur DATEV Upload Mail aktiv? 3) Ist das Anhangformat auf PDF gesetzt?
  </Accordion>

  <Accordion title="Die Weiterleitung funktioniert nicht mit Gmail">
    Gmail erfordert eine Bestätigung der Weiterleitungsadresse, die bei der DATEV Upload Mail nicht möglich ist. Nutze einen anderen E-Mail-Anbieter (z. B. Microsoft 365) für die Funktions-E-Mail.
  </Accordion>

  <Accordion title="Im DATEV-Import fehlen die Gebührenrechnungen">
    Die anny/Stripe-Gebührenrechnungen werden separat erstellt und sind nicht im automatischen Rechnungsexport enthalten. Lade sie manuell einmal pro Monat in DATEV hoch, oder nutze den CAMT.053-Import, der Gebühren als separate Buchungen enthält.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * DATEV ist keine native Integration im Integrations-Menü, sondern ein E-Mail-basierter Workflow über Rechnungsweiterleitung.
> * UI-Pfad für E-Mail-Weiterleitung: Avatar → Account-Einstellungen → Rechnungsstellung → Rechnungs-E-Mail + Anhangformat PDF
> * Funktions-E-Mail nötig (z. B. [accounting@firma.de](mailto:accounting@firma.de)), da DATEV Upload Mail nur bestätigte Absender akzeptiert (anny sendet von no-reply).
> * Einschränkung Gmail: Weiterleitung erfordert Bestätigung der Zieladresse, was mit DATEV Upload Mail nicht direkt möglich ist.
> * DATEV Unternehmen Online Workflow: Monatlicher PDF-Export aller Rechnungen + separates Hochladen der Stripe-Gebührenrechnungen.
> * Neues Feature (Hidden Beta, Juli 2026): DATEV-Buchhaltungsexporte direkt aus dem Admin-Bereich (geplant oder manuell), liefert DATEV-Buchungsstapel.
> * Export-Pläne konfigurierbar unter: Export-Zeitpläne
> * Verwandte Artikel: Buchhaltung mit anny, (Automatische) Exporte, Stripe Connect einrichten.


# Rabattcodes
Source: https://docs.anny.co/discount-codes

Erstelle absolute oder prozentuale Rabattcodes, die Kund:innen im Checkout eingeben, um einen Preisnachlass auf ihre Buchung zu erhalten.

Mit Rabattcodes bietest du deinen Kund:innen einen direkten Preisnachlass im Checkout. Du erstellst einen Code, legst den Rabatt fest (absolut oder prozentual) und bestimmst optional, für welche Ressourcen er gilt und wie oft er eingelöst werden darf. Kund:innen geben den Code im Buchungsprozess ein und der Preis wird sofort reduziert.

<Info>
  * Verfügbar ab dem Professional-Plan.
  * Aktiviere vorab das Feature **Rabattcodes** unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktioniert das Konzept?

Ein Rabattcode ist ein frei wählbarer Zeichencode (z. B. "SOMMER20"), den Kund:innen im Checkout eingeben. Der hinterlegte Rabatt wird direkt vom Buchungspreis abgezogen. Im Gegensatz zu Buchungscodes gibt es kein Guthaben, das über mehrere Buchungen hinweg verbraucht wird: Der Rabattcode reduziert den Preis der aktuellen Buchung einmalig.

Die Logik ist einfach:

* Kund:in gibt den Code im Checkout ein.
* anny prüft: Ist der Code gültig (Ablaufdatum, verfügbare Anzahl, passende Ressource)?
* Bei Erfolg wird der Rabatt angewendet und der reduzierte Preis angezeigt.
* Auf der Rechnung erscheint der Originalpreis abzüglich des Rabatts.

<Tip>
  Rabattcodes können auch für kostenlose Buchungen genutzt werden: Setze einen 100-%-Rabatt, um eine Ressource für ausgewählte Personen kostenfrei zugänglich zu machen.
</Tip>

## Wann nutze ich das?

* **Du führst eine Promotion oder Marketingaktion durch**: Erstelle einen Code mit begrenzter Anzahl und Ablaufdatum.
* **Du willst Bestandskund:innen oder Partner:innen einen Sondertarif geben**: Erstelle einen Code mit unbegrenzter Anzahl, beschränkt auf bestimmte Ressourcen.
* **Du möchtest eine Buchung komplett kostenfrei anbieten**: Setze einen 100-%-Rabatt für eine bestimmte Ressource.
* **Nicht geeignet für**: Guthabenlogik über mehrere Buchungen (nutze dafür Buchungspakete/Wertgutscheine) oder wiederkehrende Rabatte auf Abos (Abo-Rabatte werden direkt im Admin bei der Abo-Erstellung hinterlegt).

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Buchungspakete & Codes | Abgrenzung: Buchungscodes sind einlösbares Guthaben mit Kontingent. Rabattcodes sind reine Preisnachlässe ohne Guthaben. |
| Dynamisches Pricing | Rabattcodes und dynamische Preisregeln können kombiniert werden. Der Rabatt wird auf den dynamisch berechneten Preis angewendet. |
| Zusatzoptionen | Mit dem Toggle "Zusatzoptionen inkludieren" wird der Rabatt auch auf gebuchte Add-ons angewendet. |

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Gutscheincode | Der Code, den Kund:innen im Checkout eingeben |
| Interne Beschreibung | Nur für Admins sichtbare Notiz zum Verwendungszweck |
| Absoluter Rabatt | Fester Betrag in Euro, der abgezogen wird |
| Relativer Rabatt | Prozentualer Abzug vom Buchungspreis |
| Ablaufdatum | Datum und Uhrzeit, bis wann der Code gültig ist |
| Verfügbare Anzahl | Wie oft der Code insgesamt eingelöst werden kann |
| Einmal pro Kunde | Toggle: begrenzt die Einlösung auf einmal pro Kund:in (per E-Mail) |
| Gültige für Ressourcen | Optionale Einschränkung auf Ressourcen; leer = accountweit gültig |
| Zusatzoptionen inkludieren | Rabatt gilt auch für gebuchte Add-ons |

Im Checkout sehen Kund:innen **Gutscheincode hinzufügen**. Nach erfolgreicher Eingabe wird der reduzierte Preis direkt angezeigt. Auf der Buchungsseite können sie denselben Code auch im Feld **Buchungscode** eingeben. Der Rabatt gilt dann schon beim Hinzufügen zum Warenkorb und in der Preisvorschau.

<Tip>
  "Gültige für Ressourcen" ist optional. Lässt du das Feld leer, gilt der Rabattcode accountweit für alle Ressourcen. Trage einzelne Ressourcen ein, um den Code gezielt einzuschränken.
</Tip>

## Rabattcode erstellen

<Steps>
  <Step title="Rabattcodes öffnen">
    Öffne **Rabattcodes** in der Menüleiste links (sichtbar nach Feature-Aktivierung).
  </Step>

  <Step title="Neuen Code anlegen">
    Klicke auf **Neu+**. anny generiert automatisch einen Code, den du überschreiben kannst.
  </Step>

  <Step title="Rabatt festlegen">
    Trage entweder einen **absoluten Rabatt** (z. B. 10 Euro) oder einen **relativen Rabatt** (z. B. 20 %) ein. Setze nicht beide gleichzeitig.
  </Step>

  <Step title="Einschränkungen setzen">
    Wähle unter **Gültige für Ressourcen** optional die Ressource(n) aus, für die der Code gelten soll. Lässt du das Feld leer, gilt der Code accountweit. Setze optional ein Ablaufdatum und eine verfügbare Anzahl.
  </Step>

  <Step title="Zusatzoptionen (optional)">
    Aktiviere **Zusatzoptionen inkludieren**, wenn der Rabatt auch auf Add-ons angewendet werden soll.
  </Step>

  <Step title="Einlösung pro Kund:in begrenzen (optional)">
    Aktiviere den Toggle **Einmal pro Kunde**, wenn jede Person den Code nur einmal einlösen darf. anny prüft die Einlösung anhand der E-Mail-Adresse.
  </Step>

  <Step title="Speichern">
    Der Code ist sofort aktiv und kann von Kund:innen im Checkout verwendet werden.
  </Step>
</Steps>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Seminarhaus gibt 20 % Rabatt für eine Frühlingsaktion">
    Ein Seminarhaus möchte im Frühling eine Promotion laufen lassen: 20 % auf alle Räume, begrenzt auf 50 Einlösungen.

    <Steps>
      <Step title="Code erstellen">
        Öffne **Rabattcodes** → **Neu+**. Setze den Code auf "FRUEHLING20".
      </Step>

      <Step title="Rabatt konfigurieren">
        Trage 20 % als relativen Rabatt ein.
      </Step>

      <Step title="Ressourcen zuweisen">
        Wähle unter **Gültige für Ressourcen** alle Seminarräume aus.
      </Step>

      <Step title="Einschränkungen setzen">
        Setze die verfügbare Anzahl auf 50 und das Ablaufdatum auf Ende Mai.
      </Step>

      <Step title="Ergebnis">
        Kund:innen geben "FRUEHLING20" im Checkout ein und erhalten 20 % Rabatt. Nach 50 Einlösungen oder nach dem Ablaufdatum ist der Code nicht mehr gültig.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Coworking-Betreiber bietet Partner:innen kostenfreie Day Passes">
    Ein Coworking-Space möchte Kooperationspartner:innen kostenfreie Tagesbuchungen ermöglichen, ohne ein Abo oder Kontingent einzurichten.

    <Steps>
      <Step title="Code erstellen">
        Öffne **Rabattcodes** → **Neu+**. Setze den Code auf "PARTNER100".
      </Step>

      <Step title="100 % Rabatt setzen">
        Trage 100 % als relativen Rabatt ein.
      </Step>

      <Step title="Ressource zuweisen">
        Wähle die Day-Pass-Ressource aus.
      </Step>

      <Step title="Anzahl begrenzen">
        Setze die verfügbare Anzahl auf die gewünschte Menge (z. B. 10).
      </Step>

      <Step title="Ergebnis">
        Partner:innen geben "PARTNER100" ein und buchen kostenfrei. Nach 10 Einlösungen ist der Code aufgebraucht.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Kursanbieter gibt einen Rabattcode für den ersten Kursbesuch">
    Ein Aktivitätsanbieter möchte neuen Teilnehmer:innen einen Rabatt für ihren ersten Kursbesuch geben. Jede Person soll den Code genau einmal nutzen können, auch wenn sie später weitere Kurse bucht.

    <Steps>
      <Step title="Code erstellen">
        Öffne **Rabattcodes** → **Neu+**. Setze den Code auf "ERSTERKURS".
      </Step>

      <Step title="Rabatt konfigurieren">
        Trage den gewünschten Rabatt ein, z. B. 50 % als relativen Rabatt.
      </Step>

      <Step title="Ressource zuweisen">
        Wähle unter **Gültige für Ressourcen** die Kurs-Ressource(n) aus.
      </Step>

      <Step title="Einmal pro Kunde aktivieren">
        Aktiviere den Toggle **Einmal pro Kunde**, damit jede Person den Code nur beim ersten Checkout einlösen kann.
      </Step>

      <Step title="Ergebnis">
        Teilnehmer:innen geben "ERSTERKURS" beim ersten Kursbuchen ein und erhalten den Rabatt. Bei späteren Buchungen wird derselbe Code für dieselbe E-Mail-Adresse nicht erneut angerechnet.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich einen Rabattcode für alle Ressourcen gleichzeitig anlegen?">
    Ja. Lass das Feld **Gültige für Ressourcen** einfach leer, dann gilt der Code accountweit für alle Ressourcen. Alternativ wählst du gezielt einzelne Ressourcen aus, um den Code einzuschränken.
  </Accordion>

  <Accordion title="Was passiert, wenn absoluter und relativer Rabatt gleichzeitig gesetzt sind?">
    Setze nur einen der beiden Werte. Wenn versehentlich beide gesetzt sind, wird der relative Rabatt priorisiert.
  </Accordion>

  <Accordion title="Können Kund:innen mehrere Rabattcodes in einer Buchung kombinieren?">
    Nein. Pro Buchung kann nur ein Rabattcode eingegeben werden.
  </Accordion>

  <Accordion title="Gilt der Rabattcode auch für Buchungen auf Anfrage?">
    Ja, sofern im Checkout **Gutscheincode hinzufügen** angezeigt wird. Bei einigen Konfigurationen (z. B. Sofort-Bestätigung ohne Checkout-Schritt) kann das Feld fehlen.
  </Accordion>

  <Accordion title="Wie stelle ich sicher, dass jede:r Kund:in einen Code nur einmal nutzen kann?">
    Aktiviere beim Erstellen oder Bearbeiten des Codes den Toggle **Einmal pro Kunde**. anny prüft die Einlösung dann anhand der E-Mail-Adresse und rechnet den Code pro Person nur einmal an.
  </Accordion>

  <Accordion title="Können Kund:innen den Rabattcode schon vor dem Checkout eingeben?">
    Ja. Auf der Buchungsseite funktioniert der Code im Feld **Buchungscode** (dasselbe Feld wie für Pakete und Wertgutscheine). Der Preis wird dann schon vor dem Checkout reduziert. Im Checkout bleibt zusätzlich **Gutscheincode hinzufügen**.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Im Checkout wird kein Gutscheincode-Feld angezeigt">
    Prüfe, ob das Feature **Rabattcodes** unter **Account-Einstellungen** → **Features** aktiviert ist. Stelle zudem sicher, dass für die gebuchte Ressource ein gültiger Code existiert.
  </Accordion>

  <Accordion title="Der Code wird abgelehnt, obwohl er existiert">
    Mögliche Ursachen: Das Ablaufdatum ist überschritten, die verfügbare Anzahl ist aufgebraucht, oder der Code gilt nicht für die ausgewählte Ressource. Prüfe alle drei Einschränkungen. Ist der Toggle **Einmal pro Kunde** aktiv, prüfe zusätzlich, ob die E-Mail-Adresse den Code bereits eingelöst hat.
  </Accordion>

  <Accordion title="Der Rabatt wird im Checkout nicht korrekt angezeigt">
    In eingebetteten Widgets konnte es vorkommen, dass der Originalpreis kurzzeitig angezeigt wird. Lade die Seite neu. Wenn das Problem bestehen bleibt, wende dich an den Support.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Rabattcodes. Plan: Professional. Aktivierung: Account-Einstellungen → Features → Rabattcodes.
> * UI-Pfad: **Rabattcodes** (Menüleiste links, nach Aktivierung sichtbar).
> * "Gültige für Ressourcen" ist optional. Leer = Code gilt accountweit für alle Ressourcen. Mit Einträgen = Code gilt nur für die gewählten Ressourcen.
> * Pro Buchung nur EIN Rabattcode möglich.
> * Toggle "Einmal pro Kunde": Wenn aktiv, ist der Code pro Kund:in nur einmal einlösbar. Identifikation der Kund:in erfolgt über die E-Mail-Adresse.
> * "Verfügbare Anzahl" (Gesamtzahl aller Einlösungen) und "Einmal pro Kunde" (max. 1 pro Person) sind unabhängig und kombinierbar.
> * Wenn "Einmal pro Kunde" aktiv und dieselbe E-Mail-Adresse den Code bereits eingelöst hat: Code wird im Checkout nicht erneut angerechnet, auch bei späteren Buchungen nicht.
> * Kombination mit Buchungscodes: Möglich. Rabattcode reduziert den Preis, Buchungscode verrechnet Guthaben auf den Restbetrag.
> * Kombination mit dynamischem Pricing: Rabatt wird auf den dynamisch berechneten Endpreis angewendet.
> * Toggle "Zusatzoptionen inkludieren": Wenn aktiv, gilt der Rabatt auf Hauptbuchung + Add-ons. Wenn inaktiv, nur auf Hauptbuchung.
> * Abgrenzung Buchungscodes: Guthaben mit Kontingent, einlösbar über mehrere Buchungen. Rabattcodes: Einmalige Preisreduktion pro Buchung.
> * Abgrenzung Abo-Rabatte: Prozentualer Rabatt bei manueller Abo-Erstellung im Admin. Kein Code, kein Self-Service.
> * Bekanntes Problem: Bei "Buchung auf Anfrage" konnte das Rabattcode-Feld in älteren Versionen fehlen (Bug gefixt).
> * Verwechslungsgefahr für Endkund:innen: **Buchungscode** vs. Checkout **Gutscheincode**. Buchungscode = Paket-Guthaben, Gutscheincode = Preisnachlass (Admin-Feature heißt weiter **Rabattcodes**).
> * Seit Aug 2026 akzeptiert die öffentliche Buchungsseite Rabattcodes auch im Feld **Buchungscode** (add + precalculate). Checkout-Trigger ist **Gutscheincode hinzufügen** (nicht mehr Rabattcode). Der Hinweistext `bookingCodeInfo` behauptet noch, Rabattcodes kämen erst im Checkout: UI-Copy ist veraltet, Verhalten im Artikel oben ist korrekt.


# Dynamische Kapazitätsplanung mit On-Demand Ressourcen
Source: https://docs.anny.co/dynamic-capacity-planning

Passe die Kapazität deiner Termine automatisch an die Nachfrage an, indem du On-Demand Ressourcen nutzt.

Mit der **dynamischen Kapazitätsplanung mit On-Demand Ressourcen** passt anny die Kapazität eines Termins automatisch an die tatsächliche Buchungsnachfrage an. Ressourcen wie Guides, Trainer:innen oder Equipment werden **nicht vorab fest eingeplant**. Sie werden erst dann automatisch zugewiesen, wenn eine Buchung eingeht und Kapazität benötigt wird.

So bleiben Ressourcen flexibel verfügbar, werden vor Doppelbelegung geschützt und Termine skalieren in **Echtzeit** mit der Nachfrage.

## Wie du Termin-Kapazitäten automatisch an die Nachfrage anpasst

In den Termineinstellungen kannst du neben festen Ressourcen auch **On-Demand Ressourcen** hinterlegen. Diese stehen zunächst auf Abruf bereit und werden erst bei Bedarf automatisch eingesetzt.

**So funktioniert die dynamische Kapazitätsplanung im Hintergrund:**

<Steps>
  <Step title="Keine feste Zuteilung">
    On-Demand Ressourcen sind einem Termin zugeordnet, aber noch nicht blockiert.
  </Step>

  <Step title="Buchung löst Bereitstellung aus">
    Sobald eine Buchung Kapazität beansprucht, weist anny automatisch eine passende On-Demand Ressource zu.
  </Step>

  <Step title="Automatischer Kalender-Blocker">
    Mit der Zuweisung wird ein Blocker im Kalender der Ressource erstellt.
  </Step>

  <Step title="Schutz vor Doppelbelegung">
    Die Ressource ist im gleichen Zeitraum für andere Angebote nicht mehr als On-Demand verfügbar.
  </Step>

  <Step title="Echtzeit-Kapazitätsanpassung">
    Die Kapazität des Termins aktualisiert sich dynamisch, abhängig von: Buchungsstand, verfügbaren On-Demand Ressourcen und deren individueller Kapazität.
  </Step>
</Steps>

### Voraussetzungen und Hinweise

Damit die Logik sauber greift, solltest du Folgendes beachten:

* **Verfügbarkeiten pflegen:** On-Demand Ressourcen müssen korrekte Verfügbarkeiten haben, damit sie nur für passende Termine berücksichtigt werden.
* **Saubere Zuordnung:** Wenn Ressourcen nur bestimmte Angebote bedienen können, muss diese Einschränkung über die Verknüpfung korrekt abgebildet sein.

### Praxisbeispiel: Tourismusagentur

Eine Agentur bietet **5 parallele Touren** an. Guides sind On-Demand Ressourcen mit einer Kapazität von **max. 10 Gästen** pro Guide.

| Buchungen | Was passiert |
| - | - |
| 1–10 | Guide 1 wird bereitgestellt und geblockt |
| 11–20 | Guide 2 wird bereitgestellt und ebenfalls geblockt |

Beide Guides sind nun für andere Touren im selben Zeitraum nicht mehr verfügbar. Die Kapazität passt sich automatisch an, ohne manuelle Eingriffe.

## Verwandte Artikel

* **[Los Geht's: Kurse](/getting-started-courses):** Richte Kurse mit Sessions, Kapazitäten und wiederkehrenden Terminen ein.
* **[Smart Availability](/smart-availability):** Erfahre, wie du komplexe Verfügbarkeitsregeln für deine Ressourcen definierst.
* **[Ressourcen und Child-Ressourcen](/ressourcen-konfigurieren):** Verstehe den Unterschied zwischen Haupt- und Child-Ressourcen.
* **[Zeitpläne](/schedules):** Definiere regelmäßige Öffnungszeiten für deine Ressourcen.
* **[Verfügbare Termine](/available-slots):** Erstelle einzelne buchbare Zeitfenster für Events, Kurse oder Workshops.


# Dynamisches Pricing
Source: https://docs.anny.co/dynamic-pricing

Passe Preise automatisch an: nach Wochentag, Uhrzeit, Auslastung, Kundengruppe oder Buchungsanzahl.

Mit dynamischem Pricing passt du die Preise deiner Buchungsoptionen automatisch an verschiedene Faktoren an. Statt für jedes Szenario eine eigene Buchungsoption zu erstellen, definierst du Preismodifikatoren mit Bedingungen, die den Basispreis erhöhen oder senken.

<Info>
  Verfügbar ab dem **Professional Plan**.
</Info>

## Wie funktioniert dynamisches Pricing?

Dynamisches Pricing arbeitet mit **Preismodifikatoren**. Ein Preismodifikator verändert den Basispreis einer Buchungsoption, wenn eine oder mehrere Bedingungen erfüllt sind.

Der Ablauf:

1. Du öffnest das dynamische Pricing über den Link oberhalb des Preisfeldes in der Buchungsoption
2. Du erstellst einen oder mehrere Preismodifikatoren
3. Pro Modifikator legst du die Art der Preisänderung und die Bedingungen fest
4. Bei einer Buchung prüft anny automatisch, ob die Bedingungen zutreffen, und passt den Preis an

### Arten von Preismodifikatoren

| Typ | Beschreibung |
| - | - |
| Einmaliger Rabatt/Aufschlag | Fester Betrag, einmalig auf die Buchung angewendet |
| Pro Intervall | Betrag pro Zeiteinheit (z. B. pro Stunde) |
| Prozentual | Prozentualer Aufschlag oder Rabatt auf den Gesamtpreis |

<Warning>
  Ein einmaliger Rabatt kann nicht größer sein als der Preis eines einzelnen Intervalls. Sollen mehrere Intervalle kostenlos sein, nutze stattdessen eine kostenlose Basisdauer in der Buchungsoption.
</Warning>

### Bedingungen

Jeder Preismodifikator kann an eine oder mehrere Bedingungen geknüpft werden:

| Bedingung | Beschreibung |
| - | - |
| Wochentag | Gilt an bestimmten Wochentagen (z. B. Samstag, Sonntag) |
| Uhrzeit | Gilt zu bestimmten Uhrzeiten |
| Datum | Gilt an konkreten Daten (z. B. Feiertage) |
| Vorlaufzeit | Abhängig davon, wie weit im Voraus gebucht wird |
| Dauer | Gilt ab einer bestimmten Buchungsdauer (z. B. Aufschlag oder Rabatt nach der ersten Stunde) |
| Community | Gilt für Mitglieder einer bestimmten Community |
| Auslastung | Greift ab einem definierten Auslastungsgrad der Ressource |
| Anzahl Termine in Serie | Bei Serienbuchungen ab einer bestimmten Terminanzahl |
| Buchungsanzahl (gleicher Tag) | Anzahl Buchungen desselben Services im Warenkorb am gleichen Datum |
| Buchungsanzahl (gleicher Monat) | Anzahl Buchungen desselben Services im Warenkorb im gleichen Monat |
| Ressource | Gilt für eine oder mehrere ausgewählte Ressourcen oder Child-Ressourcen |

### Bedingungslogik

Du kannst festlegen, ob **alle** Bedingungen zutreffen müssen (UND-Logik) oder ob **eine** genügt (ODER-Logik). Außerdem wählst du, ob der Modifikator pro einzelne Buchung oder auf die gesamte Bestellung angewendet wird.

<Tip>
  Mehrere Preismodifikatoren können kombiniert werden. Die Reihenfolge ist relevant: sie werden nacheinander in der definierten Reihenfolge angewendet. Achte darauf, ob du zuerst prozentuale oder absolute Werte anwenden möchtest.
</Tip>

### Preisvorschau und Anzeige

Im Bereich Dynamisches Pricing kannst du zusätzlich:

* Eine **manuelle Preisvorschau** festlegen (z. B. "ab 15 €"), die auf der Buchungsseite angezeigt wird
* Die **Preisaufschlüsselung** für Kund:innen ein- oder ausblenden (besonders hilfreich bei Rabatten)
* Die Preisvorschau pro Sprache individuell anpassen

## Wann nutze ich das?

* **Du möchtest Wochenend- oder Feiertagszuschläge berechnen**: Erstelle einen prozentualen Aufschlag mit Wochentag- oder Datumsbedingung
* **Du hast Kundengruppen mit Sonderkonditionen** (z. B. Mitglieder, Stammkund:innen): Nutze die Community-Bedingung für automatische Rabatte
* **Du willst die Auslastung über den Preis steuern**: Erhöhe den Preis ab einer bestimmten Auslastung automatisch
* **Du bietest Gruppenrabatte oder Mengenstaffeln an**: Kombiniere Buchungsanzahl-Bedingungen mit gestaffelten Rabatten
* **Du hast innerhalb einer Buchungsoption unterschiedliche Preise pro Platz, Zone oder Mitarbeitenden**: Hinterlege Preis-Modifikatoren direkt auf der Ressource oder Child-Ressource, statt mehrere Buchungsoptionen anzulegen.
* **Nicht geeignet für**: Komplett unterschiedliche Produkte oder Leistungen. Dafür solltest du separate Buchungsoptionen mit eigenen Preisen erstellen.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Communities | Preismodifikatoren können an Community-Mitgliedschaft geknüpft werden |
| Rabattcodes | Ergänzend nutzbar: Rabattcodes gelten zusätzlich zu dynamischen Preismodifikatoren |
| Stornierungsbedingungen | Stornierungskosten beziehen sich auf den modifizierten Endpreis |

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Preismodifikator erstellen | Aufschlag oder Rabatt mit Betrag/Prozent definieren |
| Typ | Einmalig, Pro Intervall oder Prozentual |
| Anwendungsebene | Pro Buchung oder auf gesamte Bestellung |
| Bedingungen | Wochentag, Uhrzeit, Datum, Vorlaufzeit, Dauer, Community, Auslastung, Buchungsanzahl, Ressource |
| Bedingungslogik | Alle müssen zutreffen / Eine muss zutreffen |
| Preisvorschau | Manueller Anzeigetext auf der Buchungsseite |
| Preisaufschlüsselung anzeigen | Detaillierte Preisdarstellung für Kund:innen |
| MwSt-Satz | Individuell pro Preismodifikator einstellbar |

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Fahrradverleih berechnet Wochenendzuschläge">
    Ein Fahrradverleih möchte an Samstagen und Sonntagen 20 % mehr pro Stunde berechnen. Unter der Woche gilt der normale Tarif.
  </Accordion>

  <Accordion title="Eine City-Tour bietet Gruppenrabatte ab 5 Personen">
    Ein Tour-Anbieter möchte ab 5 Personen 5 % Rabatt und ab 10 Personen 10 % Rabatt gewähren.
  </Accordion>

  <Accordion title="Ein Coworking-Space bepreist einzelne Desks unterschiedlich">
    Ein Coworking-Space bietet eine offene Flex-Desk-Area mit mehreren Child-Ressourcen (Desk 1–4) an. Bestimmte Desks am Fenster sollen teurer sein als die im Innenbereich, ohne dafür separate Buchungsoptionen anzulegen.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Können mehrere Preismodifikatoren gleichzeitig greifen?">
    Ja. Alle Modifikatoren, deren Bedingungen erfüllt sind, werden nacheinander angewendet. Die Reihenfolge kannst du per Drag & Drop anpassen.
  </Accordion>

  <Accordion title="Was passiert bei einer Stornierung mit dynamischem Preis?">
    Die Stornierungsbedingungen beziehen sich auf den tatsächlich berechneten Endpreis (also inklusive aller angewendeten Modifikatoren).
  </Accordion>

  <Accordion title="Kann ich Preismodifikatoren mit Rabattcodes kombinieren?">
    Ja. Rabattcodes werden zusätzlich zu den dynamischen Preismodifikatoren angewendet.
  </Accordion>

  <Accordion title="Sehen Kund:innen die Preisaufschlüsselung?">
    Nur wenn du die Preisaufschlüsselung in den Einstellungen des dynamischen Pricings aktivierst. Andernfalls sehen Kund:innen nur den Endpreis.
  </Accordion>

  <Accordion title="Kann ich einen Frühbucher-Rabatt erstellen?">
    Ja. Nutze die Bedingung "Vorlaufzeit" (z. B. Vorlaufzeit größer als 14 Tage) in Kombination mit einem prozentualen Rabatt.
  </Accordion>

  <Accordion title="Kann ich den Preis nach Buchungsdauer staffeln?">
    Ja. Nutze die Bedingung **Dauer**. Für das Grundmodell "erste Stunde 35 €, jede weitere 15 €" setzt du zuerst Startgebühr, Basisdauer und Abrechnung pro in der [Buchungsoption](/configure-booking-option). Dynamisches Pricing ergänzt das um Zuschläge oder Rabatte ab einer bestimmten Dauer.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Preismodifikator wird nicht angewendet">
    Prüfe, ob die Bedingungen exakt zutreffen. Bei der Logik "Alle müssen zutreffen" genügt eine nicht erfüllte Bedingung, damit der Modifikator nicht greift. Teste mit der Preisvorschau in der Buchungserstellung.
  </Accordion>

  <Accordion title="Der angezeigte Preis auf der Buchungsseite stimmt nicht">
    Die Preisvorschau auf der Ressourcen-Kachel zeigt den Preis der ersten Buchungsoption. Wenn du eine manuelle Preisvorschau eingestellt hast, überschreibt diese die automatische Berechnung. Prüfe unter **Dynamisches Pricing** → **Preisvorschau**.
  </Accordion>

  <Accordion title="Kund:innen sehen keinen Rabatt, obwohl sie Community-Mitglied sind">
    Stelle sicher, dass die Kund:innen beim Buchen eingeloggt sind und der richtigen Community zugeordnet sind. Community-basierte Preismodifikatoren greifen nur bei authentifizierten Nutzer:innen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Dynamisches Pricing ist ab dem **Professional Plan** verfügbar
> * Pfad: **Buchungsoption/Service** → oberhalb des Preisfeldes → Link **Dynamisches Pricing**
> * Preismodifikator-Typen: Einmaliger Rabatt/Aufschlag, Pro Intervall, Prozentual
> * Bedingungen: Wochentag, Uhrzeit, Datum, Vorlaufzeit, Dauer (`duration`), Community, Auslastung, Anzahl Termine in Serie, Buchungsanzahl (gleicher Tag/gleicher Monat), Ressource (für individuelle Preise pro Ressource/Child-Ressource)
> * Anwendungsebene: pro Buchung ODER auf gesamte Bestellung
> * Logik: "Alle müssen zutreffen" (UND) oder "Eine muss zutreffen" (ODER)
> * Ein einmaliger Rabatt kann nicht größer sein als der Preis eines einzelnen Intervalls
> * Reihenfolge der Modifikatoren beachten: prozentuale und absolute Werte werden in der definierten Reihenfolge angewendet
> * MwSt-Sätze können individuell pro Preismodifikator gesetzt werden
> * Preisvorschau kann manuell überschrieben und pro Sprache angepasst werden
> * Bedingung "Ressource": Ermöglicht individuelle Preise pro Ressource oder Child-Ressource innerhalb derselben Buchungsoption (z. B. Fensterplatz teurer als Innenplatz). Operator "One of" + Ressourcen/Child-Ressourcen auswählen.


# Neues E-Mail-Design ab 15. September 2026
Source: https://docs.anny.co/email-design-september-2026



Ab dem **15. September 2026** versendet anny Bestätigungen, Änderungen, Erinnerungen, Rechnungen und Abo-Mails im neuen Layout. Bereits zugestellte E-Mails bleiben unverändert. Das Layout selbst kannst du nicht umschalten.

Die Beispielbilder zeigen die fiktive Organisation **Acme Inc**. So siehst du, wo deine Marke steht und wo anny nur noch im Footer als **Powered by** erscheint.

<Frame>
  <img alt="Neue Bestätigungs-E-Mail von Acme Inc: Logo links im Kopf, eine Buchungskarte, Bestellreferenz BO darunter, Powered by anny nur im Footer" />
</Frame>

## Was sich für Kund:innen ändert

| Vorher | Ab 15. September 2026 |
| :- | :- |
| Organisationsname und Bestellnummer (**BO…**) stehen unter der Begrüßung. | Der Kopf zeigt dein **Logo** links, wenn du eines hinterlegt hast. Die Bestellnummer steht dezent als **Bestellreferenz** direkt unter den Buchungskarten. |
| Buchungsnummern (**BB…**) stehen mit Raute auf jeder Karte. | Die Buchungsnummer bleibt auf der Karte, ohne Raute. |
| Mehrere Buchungen stehen nebeneinander in zwei Spalten. | Jede Gruppe ist eine volle Karte untereinander. |
| Gleiche Zeit, gleiche Ressource und gleiche Buchungsoption erscheinen als getrennte Karten. | Diese Buchungen liegen in einer Karte, zum Beispiel **3 Buchungen**. |
| Zusätzliche E-Mail-Informationen stehen unter den Karten. | Dieselben Texte stehen direkt unter der Begrüßung, vor den Karten. |
| Tickets sind volle Download-Buttons unter jeder Karte, zum Beispiel **PDF Ticket herunterladen**. | Tickets sitzen auf der Karte als kompakte **Wallet**- und **PDF**-Buttons. |
| Jede Karte hat eigene Kalender- und Storno-Aktionen. | Kalender sitzt auf der Karte. Verwalten und Stornieren stehen einmal darunter. |
| Der Footer steht zweispaltig: **Platform** (anny) neben **Provider** (deine Organisation). | Mit eigenem **Logo** bleibt anny auf **Powered by** im Footer beschränkt. |

<Columns>
  <Column>
    <Frame>
      <img alt="Altes E-Mail-Layout von main: Bestellnummer BO unter der Begrüßung, drei Hot-desk-Karten in zwei Spalten, Footer Platform mit anny-Logo und Provider" />
    </Frame>
  </Column>

  <Column>
    <Frame>
      <img alt="Neues E-Mail-Layout: eine gestapelte Karte mit 3 bookings, kompakten Wallet- und PDF-Buttons, Bestellreferenz BO unter den Karten" />
    </Frame>
  </Column>
</Columns>

<Columns>
  <Column>
    <Frame>
      <img alt="Altes Ticket-Layout: volle Buttons Mobile Ticket und PDF Ticket herunterladen unter der Karte" />
    </Frame>
  </Column>

  <Column>
    <Frame>
      <img alt="Neues Ticket-Layout: kompakte Apple-Wallet-, Google-Wallet- und PDF-Buttons auf der Buchungskarte" />
    </Frame>
  </Column>
</Columns>

## Hinweise und Adresse

Texte aus **Mitteilungen** bleiben erhalten. Du hinterlegst sie weiter unter [Mitteilungen konfigurieren](/configure-notifications) auf Account-, Ressourcen- oder Buchungsoptionsebene. Das Feature dafür heißt **E-Mail Templates**. Es ist kein Editor für das Layout.

Steht mehr als ein Hinweis in der Mail, bekommt jeder Block einen fetten Titel nach dem Muster **Hinweise zur Bibliothek** oder **Hinweise zum Campus**. Ein einzelner Hinweis erscheint nur als Text, ohne Überschrift.

Adresse, Serientermine und häufige Fragen bleiben unter den Karten.

<Columns>
  <Column>
    <Frame>
      <img alt="Neue Mail mit einem Hinweistext ohne Überschrift direkt unter der Begrüßung, danach die Buchungskarte" />
    </Frame>
  </Column>

  <Column>
    <Frame>
      <img alt="Neue Mail mit Notes about Acme HQ und Notes about Guided tour oberhalb der Buchungskarte, Adresse darunter" />
    </Frame>
  </Column>
</Columns>

## Was gleich bleibt

* Inhalt der Buchung: Zeiten, Preise, Teilnehmer:innen, Formularfelder, Tickets, Zugänge und Online-Meetings.
* Ob eine Mail überhaupt rausgeht. Das steuerst du weiter über die Benachrichtigungseinstellungen.
* Zusätzliche Texte aus **Mitteilungen**.
* Rechnungen und Abo-Mails nutzen dasselbe neue Erscheinungsbild, der Inhalt bleibt fachlich gleich.

<Frame>
  <img alt="Neue Bestätigung mit Rechnungstabelle und Button Download invoice, Acme Inc als Anbieter" />
</Frame>

## Was du vor dem Stichtag prüfen solltest

<Steps>
  <Step title="Logo hinterlegen">
    Öffne **Avatar** → **Account-Einstellungen** → **Account**. Hinterlege dein **Logo**, wenn der Mail-Kopf deine Marke zeigen soll. Ohne Logo bleibt im Kopf die anny-Wortmarke.
  </Step>

  <Step title="Mitteilungen lesen">
    Prüfe die Texte unter **Mitteilungen** auf Account-, Ressourcen- und Buchungsoptionsebene. Sie erscheinen künftig weiter oben und werden eher gelesen.
  </Step>

  <Step title="Nach dem Stichtag eine Mail prüfen">
    Löse nach dem 8. September eine Testbuchung aus oder sende eine Bestätigung erneut. Alte Mails im Posteingang ändern sich nicht.
  </Step>
</Steps>

Sobald das Logo gespeichert ist, nutzen neu versendete Mails es im Kopf. anny bleibt im Footer als **Powered by**.

## Einschränkungen

* Du kannst nicht beim alten Layout bleiben.
* Du kannst das HTML der Mail nicht frei gestalten.
* Bereits versendete Mails werden nicht nachträglich umgebaut.
* In manchen Outlook-Versionen können abgerundete Ecken eckiger wirken.

## FAQ

<AccordionGroup>
  <Accordion title="Gilt das neue Design für alle E-Mails?">
    Es gilt für neu versendete transaktionale Mails: Buchungsbestätigung, Änderung, Erinnerung, Rechnung und Abo. Broadcasts und rein administrative Systemmails sind nicht das Thema dieser Umstellung.
  </Accordion>

  <Accordion title="Sehen Kund:innen anny noch im Kopf?">
    Nur wenn unter **Account** kein **Logo** hinterlegt ist. Mit Logo erscheint anny unten als **Powered by**, zusammen mit dem Link auf eine eigene Buchungsseite.
  </Accordion>

  <Accordion title="Kann ich die Bestellnummer weiter oben behalten?">
    Nein. Die Bestellnummer (**BO…**) steht nicht mehr unter der Begrüßung, sondern dezent als **Bestellreferenz** direkt unter den Buchungskarten. Die Buchungsnummer (**BB…**) bleibt auf der Karte.
  </Accordion>

  <Accordion title="Ändern sich meine Mitteilungstexte?">
    Nein. Es ändert sich nur die Position: oberhalb der Karten statt darunter.
  </Accordion>

  <Accordion title="Müssen Kund:innen etwas tun?">
    Nein. Sie erhalten ab dem Stichtag einfach das neue Layout. Bereits erhaltene Mails bleiben wie gesendet.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Im Kopf steht weiter das anny-Logo">
    Unter **Account-Einstellungen** → **Account** fehlt ein **Logo**, oder die Mail wurde vor dem Speichern versendet. Hinterlege das Logo und prüfe eine neu versendete Mail.
  </Accordion>

  <Accordion title="Die Hinweise fehlen in der Mail">
    Auf keiner Ebene ist ein Text unter **Zusätzliche E-Mail Informationen** hinterlegt. Lege ihn unter [Mitteilungen konfigurieren](/configure-notifications) an.
  </Accordion>

  <Accordion title="Eine alte Mail zeigt noch überlappende Karten">
    Diese Mail wurde vor der Umstellung erzeugt. Der Posteingang ändert sich nicht. Sende die Bestätigung nach dem Stichtag erneut, wenn die Kund:in eine lesbare Kopie braucht.
  </Accordion>
</AccordionGroup>

Hidden link-only announcement (`hidden: true` group in docs.json, `public: true`). Slug `email-design-september-2026`. Switchover date 8 September 2026 comes from product, not from code.

Shared wrapper is the customer notification mail that includes order, booking, invoice and subscription blocks. Same-slot stacking: identical start, end, service and resource become one card (`stack_count`). Old layout used 50% columns in one section (Outlook overlap). Notices are org/resource/service email info above cards; titles only when more than one notice (`Notes about :name` / grammar\_choice Hinweise zur/zum). Address and series stay in meta-info below cards. Header logo is organization logo when present, else platform wordmark. Footer imprint is the organization; anny is powered-by plus create-page link.

Screenshots are English playground renders with Acme Inc as tenant and customer Anna. Greeting line may still show German copy from the playground greeting helper. Order number (BO…) is a muted order reference directly under the booking cards; booking numbers (BB…) sit on cards. Old tickets are full-width download buttons; new tickets are compact Wallet/PDF on the card. Header and footer logos are fitted from the image aspect ratio, left-aligned, and vertically centered in the header row. Do not treat Acme Inc as a real customer. Do not present playground URLs as a product feature.

Related: /configure-notifications (extra email copy and appointment reminders on the service, features Email Templates and Appointment reminders), /account-settings (logo on Account tab), /admin-notifications (who receives admin mail). Do not document implementation identifiers in user-facing answers.


# Die anny Buchungsseite als Widget auf der eigenen Website einbetten
Source: https://docs.anny.co/embed-booking-page

Bette deine Buchungsseite oder einzelne Ressourcen direkt auf deiner Website ein und biete deinen Kund:innen ein nahtloses Buchungserlebnis in deinem eigenen Design.

Eine eigene Website ist heute für fast jedes Angebot selbstverständlich. Das anny Widget ermöglicht es dir, deine Buchungsseite oder einzelne Ressourcen direkt dort einzubetten, wo deine Kund:innen bereits sind – sie müssen deine Website nicht verlassen, um zu buchen.

<Note>
  **WordPress:** Installiere das Plugin [anny bookings](https://wordpress.org/plugins/anny-bookings/) und füge Blöcke ein, statt HTML zu kopieren. Schritt für Schritt: [Die anny Buchungsseite in WordPress einbetten](/embed-wordpress). Die HTML-Einbettung unten bleibt für alle anderen Websites.
</Note>

Technisch funktioniert das über einen iFrame, der in zwei Schritten eingebunden wird: zuerst ein globales Script, dann die eigentliche Komponente an der gewünschten Stelle. Du konfigurierst das Widget einmalig in anny und passt es an dein Design an. Deine Website zeigt dann immer den aktuellen Stand.

## Was du am Ende eingerichtet hast

* Das globale Widget-Script ist auf deiner Website eingebunden
* Du hast das Widget auf Organisations- oder Ressourcenebene konfiguriert
* Das Design ist an deine Corporate Identity angepasst
* Das Widget ist an der gewünschten Stelle platziert und getestet

## Schritt 1: Widget-Ebene und -Typ wählen

Du kannst das Widget auf zwei Ebenen einbetten. Entscheide zuerst, was du zeigen möchtest.

**Gesamte Buchungsseite** (Organisation → Einstellungen → Buchungsseite) Sinnvoll, wenn du mehrere Ressourcen hast, die durchsuchbar sein sollen. Hier konfigurierst du auch globale Komponenten wie den Login-Button und den Warenkorb-Button.

<img alt="Image" />

**Einzelne Ressource** (Ressourcen → Ressource auswählen → Buchungsseite) Sinnvoll, wenn du gezielt eine Ressource einbetten möchtest, z. B. ein Erstgespräch auf einer Landingpage.

<img alt="Image" />

Innerhalb jeder Ebene gibt es verschiedene Widget-Typen:

| Typ | Wann verwenden |
| - | - |
| **Seiten-Widget** | Buchung ist der Hauptinhalt der Seite |
| **Panel-Widget** | Du hast eigenen Inhalt und willst nur den Buchungsfluss einbetten |
| **Button-Widget** | Buchung soll sich per Klick in einem Modal öffnen |
| **Globale Hilfs-Widgets** | Login und Warenkorb im Site-Header |

### **Welche Widgets gibt es?**

#### **Seiten-Widgets**

| Widget | Am besten für |
| - | - |
| `a-organization-page` | Vollständige Buchungsseite mit Tabs, Filtern, optionaler Karte/Kalender |
| `a-organization-map` | Karten-orientiertes Organization-Erlebnis |
| `a-organization-calendar` | Kalender-orientiertes Organization-Erlebnis |
| `a-resource-page` | Vollständige Ressource-Detail- und Buchungsseite |
| `a-resource-map` | Ressource-Karte oder Sitzplan-/Grundrissansicht |
| `a-resource-calendar` | Ressource-Kalenderansicht |
| `a-service-page` | Vollständige Service-Detail- und Buchungsseite |
| `a-subscription-page` | Subscription-Detail und Checkout |
| `a-package-page` | Package-Detail und Checkout |
| `a-my-bookings` | Buchungsübersicht des eingeloggten Nutzers |

#### **Panel-Widgets**

| Widget | Am besten für |
| - | - |
| `a-resource-booking-panel` | Nur den Buchungsfluss für eine Ressource einbetten |
| `a-service-booking-panel` | Nur den Buchungsfluss für einen Service einbetten |

#### **Button-Widgets**

| Widget | Am besten für |
| - | - |
| `a-organization-button` | Organization-Explore in einem Modal öffnen |
| `a-resource-button` | Ressource-Buchung in einem Modal öffnen |
| `a-service-button` | Service-Buchung in einem Modal öffnen |
| `a-subscription-button` | Subscription-Checkout in einem Modal öffnen |
| `a-package-button` | Package-Checkout in einem Modal öffnen |

#### Globale Hilfs-Widgets

| Widget | Am besten für |
| - | - |
| `a-cart-modal-button` | Warenkorb-Trigger mit Live-Badge |
| `a-login-button` | Login/Logout mit gemeinsamem Auth-Zustand |

## Schritt 2: Script global laden

Füge das Widget-Bundle **einmalig** in den `<head>` deiner Website ein.

```html theme={null}
<script src="https://cdn.anny.co/widget/annyComponents.umd.latest.min.js"></script>
```

Wenn du das Widget nur auf einer einzigen Seite verwendest, kannst du das Script auch direkt oberhalb der Komponente auf dieser Seite einfügen.

## Schritt 3: Einstellungen prüfen und Snippet einfügen

Öffne die Buchungsseite der entsprechenden Ebene im Admin, wähle die gewünschte Komponente und konfiguriere die Optionen.

**Auf Organisationsebene** (Seiten-Widget) stehen u. a. folgende Einstellungen zur Verfügung:

* Header auf Organisations-/Ressourcenseite ausblenden
* Filter und Kartenumschalter ausblenden
* Standard-Reiter und Standard-Ansicht (z. B. Raster)
* Kategorie zur Vorfilterung
* Widget-Höhe und Navbar-Höhe

**Auf Ressourcenebene** (Seiten-Widget) stehen u. a. folgende Einstellungen zur Verfügung:

* Header auf Ressourcen-/Organisationsseite ausblenden
* Vorausgewählter Service
* Widget-Höhe und Navbar-Höhe

Kopiere dann den generierten Einbettungscode und füge die Komponente an der Stelle ein, an der sie auf deiner Website erscheinen soll.

Beispiel für ein ganzseitiges Widget auf Organisationsebene:

```html theme={null}
<a-organization-page
  base-url="https://anny.co"
  organization="my-org"
  fullscreen="true"
  nav-height="64px"
></a-organization-page>
```

Beispiel für ein eingebettetes Booking-Panel:

```html theme={null}
<a-resource-booking-panel
  base-url="https://anny.co"
  resource="my-resource"
></a-resource-booking-panel>
```

Beispiel für einen Button-Widget:

```html theme={null}
<a-resource-button
  base-url="https://anny.co"
  resource="my-resource"
  modal-layout="drawer"
></a-resource-button>
```

## Schritt 4: Design anpassen

Navigiere zu Organisation → Einstellungen → Buchungsseite und öffne das Design-Panel über „Design anpassen". Dort kannst du einstellen:

* Primary Color und Secondary Color
* Text- und Hintergrundfarbe
* Input-Hintergrund und Rahmenfarbe
* Eckenradius (abgerundet oder eckig)
* Logo für die Lade-Animation

anny speichert das Design für den gesamten Account – du musst es nicht pro Ressource neu einstellen. In der Live-Vorschau siehst du deine Änderungen sofort.

## Schritt 5: Testen

Öffne die Seite im Browser und prüfe:

* Widget lädt und zeigt Inhalte an
* Buchungsflow lässt sich vollständig durchführen
* Design passt zur restlichen Seite
* Auf mobilen Viewports ist das Layout korrekt
* Login- und Warenkorb-Button (falls verwendet) sind sichtbar und funktionieren
* Login und Zahlung dürfen ein Popup öffnen. Wenn das Fenster leer bleibt oder der Browser den Inhalt blockiert, siehe [Popups vom Widget](/widget-embed-advanced#popups-vom-widget).

## Checkliste

<Check>
  * Script global im Header eingebunden
  * Widget auf Account- oder Ressourcenebene konfiguriert
  * Komponente an der richtigen Stelle auf der Website platziert
  * Design angepasst und gespeichert
  * Widget getestet und Buchungsflow geprüft
</Check>


# Die anny Buchungsseite in Google einbetten
Source: https://docs.anny.co/embed-google-sites



## Kopiere den Code deiner Buchungsseite

* Den Code für die allgemeine Buchungsseite deiner Organisation findest du in deinen Accounteinstellungen unter [Buchungsseite](http://app.anny.co/organization/settings/booking-page), die Einstellung findet man im am Profilbild rechts oben im anny Adminbereich.
* Den Code für die Buchungsseite einer bestimmten Ressource oder eines bestimmten Services findet man in den jeweiligen Einstellungen der Ressource/des Services [Ressourcen](https://app.anny.co/resources) > Ressource > Buchungsseite

Dort kopiert man das Script (einmalig auf der Webseite) und den jeweiligen Code des Buchungswidgets.

![Screenshot: Code der Buchungsseite kopieren](https://downloads.intercomcdn.eu/i/o/4492191/d81167e300e9fcf37f00f54f/2023-08-15_17-38.png)

<Tip>
  **Pro Tipp:** Das Design der Buchungsseite kann in anny bearbeitet werden, mehr dazu findest du in unserem Artikel [Die anny Buchungsseite auf deiner Website einbetten](/embed-booking-page).
</Tip>

## HTML-Einfüge Punkt finden

In der Bearbeitungsleiste oben rechts, auf "Einbetten" klicken.

![Screenshot: Einbetten in Google Sites auswählen](https://downloads.intercomcdn.eu/i/o/4410484/49cd9127d9a2384d1151b282/2023-08-10_17-58.png)

## Einfügen des HTML-Blocks

Durch Auswahl dieser Option wird ein spezieller Block für den HTML-Code hinzugefügt, wichtig ist, dass *Code einbetten* ausgewählt wird.

![Screenshot: HTML-Block einfügen in Google Sites](https://downloads.intercomcdn.eu/i/o/4535095/d891670c9eef7274008d3b07/2023-08-17_12-34.png)

## HTML-Code einfügen

Innerhalb dieses HTML-Blocks befindet sich ein Feld, in das der HTML-Code aus anny hinzugefügt werden kann. Wenn der Code eingefügt wurde, auf weiter klicken.

## Widget anpassen

Durch Ziehen des Fensters kann das Widget auf die passende Größe zugeschnitten werden.

<Tip>
  **Pro Tipp:** Mit dem Button rechts oben gibt es eine Vorschau, die zeigt, wie deine Webseite angezeigt wird.
</Tip>

![Screenshot: Vorschau in Google Sites](https://downloads.intercomcdn.eu/i/o/4540601/89be91a7811bac760f983062/2023-08-17_15-35.png)

### Das Endergebnis

![Screenshot: Eingebettete anny Buchungsseite in Google Sites](https://downloads.intercomcdn.eu/i/o/5178105/34dd1f79e002601549f14263/Frame+8+%284%29.png)


# Die anny Buchungsseite in Wix einbetten
Source: https://docs.anny.co/embed-wix



## Kopiere den Code deiner Buchungsseite

* Den Code für die allgemeine Buchungsseite deiner Organisation findest du in deinen Accounteinstellungen unter [Buchungsseite](http://app.anny.co/organization/settings/booking-page), die Einstellung findet man im am Profilbild rechts oben im anny Adminbereich.
* Den Code für die Buchungsseite einer bestimmten Ressource oder eines bestimmten Services findet man in den jeweiligen Einstellungen der Ressource/des Services [Ressourcen](https://app.anny.co/resources) > Ressource > Buchungsseite

Dort kopiert man das Script (einmalig auf der Webseite) und den jeweiligen Code des Buchungswidgets.

![Screenshot: Code der Buchungsseite kopieren](https://downloads.intercomcdn.eu/i/o/4492191/d81167e300e9fcf37f00f54f/2023-08-15_17-38.png)

<Tip>
  **Pro Tipp:** Das Design der Buchungsseite kann in anny bearbeitet werden, mehr dazu findest du in unserem Artikel [Die anny Buchungsseite auf deiner Website einbetten](/embed-booking-page).
</Tip>

## Element hinzufügen

Im Wix Editor kann man mit dem "+"-Symbol befindlich am linken, oberen Bildschirmrand kann man Elemente hinzufügen. Unter Code einbetten > beliebte Einbettungen > "HTML-Code" Kann man ein HTML-Element hinzufügen.

![Screenshot: HTML-Element in Wix hinzufügen](https://downloads.intercomcdn.eu/i/o/4491041/40e9e9a7ab93c25f8ef7efc6/WBEW%2B2.gif)

## HTML-Code einfügen

Ein neues Element wird der Seite hinzugefügt. Es öffnet sich ein Textfeld, wo der HTML-Code aus anny hinzugefügt werden kann, wenn der Code eingefügt wurde, auf Aktualisieren klicken.

![Screenshot: HTML-Code in Wix einfügen](https://downloads.intercomcdn.eu/i/o/4490373/6d80d87ddbf0df4ec47ec160/2023-08-15_16-12.png)

<Tip>
  **Pro Tipp:** Hier darauf achten, dass man einmal auf der gesamten Seite das Script lädt, wenn sich die [Einstellungen](https://app.anny.co/organization/settings/booking-page) in anny zur Bearbeitung des Designs ändern, ändert sich auch der Code.
</Tip>

## Das Fenster anpassen

Passe die Größe und Position des Fensters so an, dass deine Buchungsseite, oder der Kalender deiner Ressource nach deinen Wünschen angezeigt wird.

<Tip>
  **Pro Tipp:** Mit dem Button links oben gibt es eine Vorschau, die zeigt, wie deine Webseite auf Mobilgeräten angezeigt wird.
</Tip>

![Screenshot: Fenster in Wix anpassen](https://downloads.intercomcdn.eu/i/o/4490410/b771a977693dd10cbb6a3b32/2023-08-15_16-14.png)


# Die anny Buchungsseite in WordPress einbetten
Source: https://docs.anny.co/embed-wordpress

Mit dem Plugin anny bookings fügst du Buchungsseiten, Kalender, Karten und Buttons als Blöcke in WordPress ein – ohne HTML.

Mit dem Plugin [anny bookings](https://wordpress.org/plugins/anny-bookings/) bettest du deine Buchungsseite als ganz normalen Block in WordPress ein. Du kopierst keinen HTML-Code mehr: Du verbindest deine Website einmal mit anny und wählst danach in jedem Block aus, was er zeigen soll.

<Note>
  Du brauchst WordPress 6.5 oder neuer, PHP 8.1 oder neuer, Administrationsrechte in WordPress und eine anny Organisation. Für anny genügt der kostenlose Tarif.
</Note>

## Plugin installieren

<Steps>
  <Step title="Plugin suchen">
    Gehe in WordPress auf **Plugins** > **Installieren** und suche nach `anny bookings`.
  </Step>

  <Step title="Installieren und aktivieren">
    Klicke auf **Jetzt installieren** und danach auf **Aktivieren**. In der linken Seitenleiste erscheint der neue Menüpunkt **anny**.
  </Step>
</Steps>

## Website mit anny verbinden

Die Verbindung läuft über deinen anny Login. Du hinterlegst keine Schlüssel oder Passwörter in WordPress.

<Steps>
  <Step title="Datenregion wählen">
    Öffne **anny** > **Verbindung** und wähle unter **Datenregion** die Region, in der deine Organisation liegt: `anny.co` oder `anny.eu`. Im Zweifel ist es die Adresse, über die du dich bei anny anmeldest.
  </Step>

  <Step title="Verbinden">
    Klicke auf **Mit anny verbinden**. Du landest auf der Anmeldeseite von anny und bestätigst dort den Zugriff.
  </Step>

  <Step title="Organisation auswählen">
    Zurück in WordPress wählst du unter **Organisation** die Organisation aus, deren Ressourcen und Services du einbetten möchtest, und speicherst.
  </Step>
</Steps>

<img alt="Screenshot: Reiter Verbindung im anny Plugin mit verbundenem Konto, Datenregion und ausgewählter Organisation" />

<Tip>
  Über **Verbindung trennen** entziehst du WordPress den Zugriff jederzeit wieder. Die Blöcke auf deinen Seiten bleiben erhalten.
</Tip>

## Block einfügen

<Steps>
  <Step title="Block hinzufügen">
    Öffne eine Seite im Editor, klicke auf das **Plus** und suche nach `anny`. Alle Blöcke liegen in der Kategorie **anny**.
  </Step>

  <Step title="Ressource oder Service auswählen">
    Wähle im Block aus der Liste aus, was gebucht werden soll. Die Liste kommt direkt aus deiner Organisation – du musst keine Namen oder Kürzel abtippen.
  </Step>
</Steps>

<img alt="Screenshot: Die anny Blöcke in der Blockauswahl von WordPress" />

Im Block suchst du danach nach dem Namen deiner Ressource – Kürzel oder IDs musst du nirgends nachschlagen.

<img alt="Screenshot: Ressource über die Suchliste in den Widget-Einstellungen auswählen" />

![](https://downloads.intercomcdn.eu/i/o/4733874/ed316fdbc5cbe05af8dd0c48/Frame+8+%282%29.png)

<Note>
  Login und externe Zahlungen (zum Beispiel PayPal oder iDEAL) öffnen im Widget ein eigenes Fenster, damit WordPress nicht verlassen wird. Deine Website muss diese Fenster erlauben. Mehr dazu unter [Popups vom Widget](/widget-embed-advanced#popups-vom-widget).
</Note>


# Microsoft Enterprise SSO auf iOS einrichten
Source: https://docs.anny.co/enterprise-sso-ios

So richtest du das Microsoft Enterprise SSO Plug-in für anny auf Intune-verwalteten iOS-Geräten ein.

Auf iOS-Geräten nutzen alle Apps für den OAuth-Login intern Apples System-Browser (Safari-Engine). Wenn deine Organisation eine Conditional Access Policy hat, die nur Microsoft Edge erlaubt, kann der anny-Login dadurch blockiert werden.

Die Lösung ist das **Microsoft Enterprise SSO Plug-in**. Es fängt Anmeldeanfragen an Microsoft Entra ID auf Betriebssystem-Ebene ab und stellt Tokens automatisch bereit, ohne dass ein Browser geöffnet wird. Safari muss dafür **nicht** freigegeben werden.

Mit dem Enterprise SSO Plug-in kannst du:

* Deine Mitarbeitenden nahtlos bei anny anmelden, ohne Safari als Browser freizugeben
* Single Sign-On über alle Apps hinweg nutzen (anny, Microsoft 365, eigene Apps)
* Device Compliance und Gerätestatus automatisch an Conditional Access übergeben

<Info>
  Diese Einrichtung erfolgt vollständig auf IT-Admin-Seite in Microsoft Intune. An der anny App selbst sind keine Änderungen nötig.
</Info>

## Voraussetzungen

Bevor du das SSO Plug-in einrichtest, stelle sicher, dass folgende Punkte erfüllt sind:

* iOS 13.0 oder neuer auf den Geräten
* Die Geräte sind in **Microsoft Intune MDM** enrolled
* **Microsoft Entra ID** (ehemals Azure AD) wird als Identity Provider genutzt
* Der anny-Login läuft über SAML/OIDC Federation mit Entra ID (der Auth-Flow wird an `login.microsoftonline.com` weitergeleitet)

<Tip>
  Wenn der anny-Login nicht über Entra ID läuft, greift das SSO Plug-in nicht. In dem Fall muss anny als App in Entra ID registriert und SSO per SAML/OIDC Federation konfiguriert werden.
</Tip>

## SSO Plug-in einrichten

<Steps>
  <Step title="SSO App Extension Profil erstellen">
    Öffne das **Microsoft Intune Admin Center** (intune.microsoft.com) und navigiere zu **Devices > Manage devices > Configuration > Create > New Policy**.

    Wähle folgende Einstellungen:

    * **Platform:** iOS/iPadOS
    * **Profile type:** Templates > Device features
    * **Name:** z. B. `iOS: SSO App Extension`

    Unter **Configuration settings** > **Single sign-on app extension**:

    * **SSO app extension type:** Microsoft Entra ID
    * **Enable shared device mode:** Not configured
  </Step>

  <Step title="Empfohlene Konfiguration setzen">
    Füge unter **Additional configuration** folgende Key-Value-Paare hinzu:

    | Key | Type | Value | Zweck |
    | :- | :- | :- | :- |
    | `AppPrefixAllowList` | String | `co.anny.,com.apple.,com.microsoft.` | Erlaubt Apple- und Microsoft-Apps, SSO zu nutzen |
    | `browser_sso_interaction_enabled` | Integer | `1` | Aktiviert SSO in Safari und WebView-basierten Apps |
    | `disable_explicit_app_prompt` | Integer | `1` | Unterdrückt unnötige Zustimmungs-Popups pro App |
    | `device_registration` | String | `{{DEVICEREGISTRATION}}` | Aktiviert Just-in-Time Device Registration |

    <Warning>
      Achte darauf, dass vor und nach den Keys und Values keine Leerzeichen stehen. Andernfalls funktioniert die Registrierung nicht.
    </Warning>
  </Step>

  <Step title="Profil zuweisen">
    Weise das Profil einer **Device- oder User-Gruppe** zu, die deine iOS-Geräte enthält. Die Einstellungen werden beim nächsten Device-Check-in automatisch angewendet.
  </Step>

  <Step title="Microsoft Authenticator deployen">
    Navigiere zu **Apps > All Apps** und stelle sicher, dass **Microsoft Authenticator** als **Required App** derselben Gerätegruppe zugewiesen ist.

    <Info>
      Die Authenticator App muss nur installiert sein. Deine Mitarbeitenden müssen sie nicht aktiv einrichten oder nutzen. Die App muss über ein Apple Volume Purchase Program (VPP) bezogen werden.
    </Info>
  </Step>

  <Step title="Conditional Access Policy anpassen">
    Das ist der wichtigste Schritt. Statt einer Policy, die ausschließlich Edge als Browser erzwingt, sollte die Policy auf eine der folgenden Bedingungen umgestellt werden:

    * **Require compliant device** (empfohlen): Prüft, ob das Gerät Intune-compliant ist
    * **Require approved client app**: Erlaubt Authentifizierung über die Authenticator App

    Das SSO Plug-in liefert automatisch Device Identity und Compliance-Status mit jedem Auth-Request. Das bietet besseren Schutz als eine reine Browser-Einschränkung, weil nicht nur der Browser, sondern der gesamte Gerätestatus geprüft wird.

    <Warning>
      Ohne diese Anpassung blockiert die bestehende Edge-only-Policy den Login weiterhin, auch wenn das SSO Plug-in korrekt eingerichtet ist.
    </Warning>
  </Step>

  <Step title="Testen">
    Öffne die **anny App** auf einem enrolled iOS-Gerät und starte den Login:

    * **Erster Login nach Einrichtung:** Kurzer Auth-Dialog, in dem Entra ID Credentials eingegeben werden.
    * **Alle folgenden Logins:** SSO greift automatisch, kein erneutes Einloggen nötig.

    Prüfe im Intune Admin Center unter **Devices > Gerät > Device configuration**, ob das SSO-Profil als Succeeded angezeigt wird.
  </Step>
</Steps>

## Hintergrund: Warum nicht einfach Edge als In-App-Browser nutzen?

iOS erlaubt es Apps nicht, einen anderen Browser als Apples System-Browser (`ASWebAuthenticationSession`) für OAuth-Logins zu verwenden. Selbst wenn Edge als Standard-Browser eingestellt ist, nutzt iOS intern immer die Safari-Engine für Anmeldevorgänge.

Das Enterprise SSO Plug-in löst dieses Problem auf einer tieferen Ebene: Es arbeitet auf Betriebssystem-Ebene und fängt Anmeldeanfragen ab, bevor ein Browser geöffnet wird. Dadurch werden Conditional Access Policies korrekt erfüllt, ohne dass Safari als Browser freigegeben werden muss.

## FAQ

<AccordionGroup>
  <Accordion title="Muss Safari auf den Geräten freigegeben werden?">
    Nein. Safari kann weiterhin per Intune blockiert bleiben. Das SSO Plug-in nutzt nicht Safari als Browser, sondern arbeitet auf Betriebssystem-Ebene. Der Auth-Dialog ist ein sandboxed System-Dialog, kein offener Browser.
  </Accordion>

  <Accordion title="Muss an der anny App etwas geändert werden?">
    Nein. Das SSO Plug-in fängt Auth-Requests an Entra ID automatisch ab, unabhängig davon, welche App sie auslöst. Die gesamte Einrichtung erfolgt in Intune.
  </Accordion>

  <Accordion title="Funktioniert das nur mit anny oder auch mit anderen Apps?">
    Das SSO Plug-in bietet Single Sign-On über alle Apps hinweg, die gegen Microsoft Entra ID authentifizieren: Microsoft 365 Apps, anny, und jede andere App, deren Login-Flow über Entra ID läuft.
  </Accordion>

  <Accordion title="Was passiert auf nicht-verwalteten Geräten?">
    Das SSO Plug-in erfordert MDM-Enrollment. Auf nicht-verwalteten Geräten nutzt anny den normalen OAuth-Login über den System-Browser. Stelle sicher, dass deine Conditional Access Policy diesen Fallback erlaubt, falls Mitarbeitende auch auf privaten Geräten arbeiten.
  </Accordion>

  <Accordion title="Brauche ich eine zusätzliche Lizenz?">
    Nein. Das Enterprise SSO Plug-in ist Teil von Microsoft Intune und Entra ID. Es ist keine separate Lizenz oder Freigabe von Microsoft nötig.
  </Accordion>

  <Accordion title="Was ist der Unterschied zum Brokered Auth über MSAL?">
    Brokered Auth erfordert, dass die App das MSAL SDK eingebaut hat. Das SSO Plug-in arbeitet auf Betriebssystem-Ebene und funktioniert mit jeder App, unabhängig vom verwendeten SDK. Für anny ist das SSO Plug-in der richtige Ansatz.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Login schlägt trotz SSO Plug-in fehl">
    Prüfe folgende Punkte:

    1. Wurde die **Conditional Access Policy** angepasst? Eine Edge-only-Policy blockiert weiterhin.
    2. Ist die **Authenticator App** auf dem Gerät installiert?
    3. Hat das Gerät ein **Device Identity Certificate**? Prüfe unter Einstellungen > Allgemein > VPN und Geräteverwaltung > MDM-Profil > Mehr Details.
    4. Sind die URLs `login.microsoftonline.com` und `login.microsoft.com` durch Proxy oder Firewall erreichbar?
  </Accordion>

  <Accordion title="Mitarbeitende werden trotzdem nach Credentials gefragt">
    Der erste Login nach Einrichtung erfordert immer eine Eingabe, da dabei der Primary Refresh Token (PRT) erstellt wird. Danach sollte SSO greifen. Tipp: Lass deine Mitarbeitenden sich zuerst in **Microsoft Teams** einloggen. Das bootstrappt den SSO-Token am zuverlässigsten.
  </Accordion>

  <Accordion title="SSO funktioniert in anny, aber nicht in anderen Apps">
    Für Apps, die nicht von Apple oder Microsoft stammen, muss die Bundle ID der App unter **App bundle ID** im SSO-Profil hinzugefügt werden. Bundle IDs findest du über den Debug-Modus: Setze `admin_debug_mode_enabled = 1` temporär in der Additional Configuration, logge dich in der App ein, und prüfe die Authenticator Logs unter Hilfe > Protokolle senden > Protokolle anzeigen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Kontext:** Enterprise-Kunden mit Intune-verwalteten iOS-Geräten haben oft Conditional Access Policies, die nur Edge als Browser erlauben. Da iOS für OAuth-Logins intern immer die Safari-Engine nutzt (ASWebAuthenticationSession), schlägt der anny-Login fehl.
>
> **Lösung:** Das Microsoft Enterprise SSO Plug-in fängt Auth-Requests auf OS-Ebene ab. Es erfordert keine Änderung an anny. Die Einrichtung erfolgt komplett im Microsoft Intune Admin Center auf Kundenseite.
>
> **Voraussetzungen auf Kundenseite:** iOS 13+, Intune MDM Enrollment, Microsoft Authenticator App installiert, Entra ID als IdP, SAML/OIDC Federation mit Entra ID für den anny-Login.
>
> **Häufigster Fehler:** Conditional Access Policy wurde nicht angepasst. Eine Edge-only-Policy blockiert auch mit SSO Plug-in. Policy muss auf Require compliant device oder Require approved client app umgestellt werden.
>
> **Safari muss NICHT freigegeben werden.** Das ist der häufigste Irrtum bei Kunden. Das SSO Plug-in arbeitet unterhalb des Browsers auf OS-Ebene.
>
> **Kein MSAL SDK nötig:** Das Plug-in funktioniert mit Standard-OAuth/OIDC-Flows. anny muss kein Microsoft SDK integrieren.
>
> **Keine Extra-Lizenz:** Teil von Intune + Entra ID.


# Exklusive Zeitfenster
Source: https://docs.anny.co/exclusive-time-slots

Reserviere Zeitfenster exklusiv für eine Bestellung, damit Gruppen nicht mit anderen Kund:innen gemischt werden.

Mit der Funktion **Exklusive Zeitfenster** legst du fest, dass ein Zeitfenster nach der ersten Buchung für weitere Bestellungen als ausgebucht behandelt wird. So bleibt das Zeitfenster exklusiv für eine Kundengruppe reserviert, auch wenn rechnerisch noch freie Plätze vorhanden sind. Dasselbe Prinzip gilt für Tische, Boote oder Lanes: die Gruppe bleibt unter sich.

<Info>
  Das Feature **Mehrfachverfügbarkeit von Ressourcen** oder **Mehrfachverfügbarkeit mit Zuweisung** muss in deinem Account unter **Account Einstellungen** → **Features** aktiviert sein.
</Info>

## Wie funktioniert Exklusive Zeitfenster?

Sobald die erste Bestellung für ein Zeitfenster eingeht, wird dieses Zeitfenster für alle weiteren Bestellungen gesperrt. Das bedeutet konkret:

* Die erste Bestellung kann weiterhin mehrere Plätze innerhalb dieses Zeitfensters nutzen.
* Weitere externe Buchungen für dasselbe Zeitfenster werden nicht mehr zugelassen.
* Im Admin-Bereich bleibt die tatsächliche Auslastung sichtbar (z. B. 2 von 4 Plätzen belegt).

Bei **Child Ressourcen** gilt das pro Tisch, Boot oder Lane, nicht für die ganze Eltern-Ressource. Innerhalb **einer** Bestellung füllt anny zuerst eine Child-Ressource bis zu ihrer **Verfügbare Anzahl** und nimmt danach die nächste. Andere Bestellungen bekommen keine Child-Ressource, die in diesem Zeitraum schon eine Buchung hat.

Dadurch bleibt die Gruppe innerhalb des Zeitfensters unter sich, ohne dass du das Zeitfenster manuell blockieren musst.

<Note>
  "Ausgebucht" bedeutet hier nicht, dass die volle Kapazität erreicht wurde. Das Zeitfenster ist exklusiv für eine Bestellung reserviert.
</Note>

## Wann nutze ich das?

* **Aktivitäten mit Gruppenlogik**, bei denen mehrere Plätze pro Slot vorhanden sind, aber nur gemeinsam von einer Bestellung genutzt werden sollen (z. B. Axtwerfen-Lanes, Escape Rooms).
* **Verleih-Angebote**, bei denen ein Objekt mehrere Personen aufnehmen kann, aber nicht zwischen fremden Gruppen geteilt werden soll (z. B. Kanus, Boote, Tretboote).
* **Tische in Gastronomie oder Eventlocations**, bei denen jeder Tisch nur einer Firmen- oder Kundengruppe gehört, eine Gruppe aber mehrere Tische in einer Bestellung buchen darf.
* **Gruppenführungen und Touren**, bei denen ein Zeitfenster vollständig für eine geschlossene Gruppe reserviert bleiben soll (z. B. Museumsführungen, Stadttouren).
* **Kursangebote mit Exklusivbuchung**, bei denen eine Organisation oder Gruppe einen Kursslot komplett für sich bucht.

**Nicht geeignet für:** Angebote, bei denen unterschiedliche Kund:innen bewusst denselben Slot teilen sollen (z. B. offene Fitnesskurse, Lernplätze in Bibliotheken). Auch nicht geeignet: alle Sitzplätze als eine einzige mehrfach verfügbare Ressource (z. B. 440 Plätze), wenn **Exklusive Zeitfenster** an ist. Dann sperrt die erste Bestellung den ganzen Saal.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Mehrfachverfügbarkeit von Ressourcen | Pflichtvoraussetzung. Exklusive Zeitfenster ist nur bei mehrfach verfügbaren Ressourcen relevant. |
| Mehrfachverfügbarkeit mit Zuweisung (Child Ressourcen) | Den Toggle **Exklusive Zeitfenster** setzt du auf der Eltern-Ressource unter **Verfügbarkeit**. Jede Child-Ressource wird nach der ersten Buchung exklusiv blockiert. Der Toggle erscheint im Child-Modus, sobald mindestens eine Child-Ressource eine **Verfügbare Anzahl** größer 1 hat. |
| Smart Availability | Abgrenzung: Smart Availability verbindet Ressourcen dynamisch bei der Buchung. Exklusive Zeitfenster hingegen sperrt den Slot nach der ersten Bestellung komplett für andere. Beide können kombiniert werden. |

## Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| **Exklusive Zeitfenster** (Toggle) | Sperrt den Slot nach der ersten Buchung für andere Bestellungen. Bei Child Ressourcen gilt das pro Child-Ressource. |
| **Kunde darf Optionen wählen** | Ist ausgeblendet, sobald eine Child-Ressource eine **Verfügbare Anzahl** größer 1 hat. anny weist die Optionen dann automatisch in aufsteigender Reihenfolge nach Name zu. |
| **Buchungsart** | Nutze **Standard**: jede gebuchte Einheit (Person, Platz) blockiert eine Kapazitätseinheit. **Vollständig** blockiert die gesamte Eltern-Ressource und weist keine einzelnen Child-Ressourcen zu. |
| **Erlaubte Buchungen pro Bestellung** | Steht auf der Ressource und begrenzt, wie viele Plätze eine Bestellung maximal buchen darf. Sobald **Exklusive Zeitfenster** aktiv ist, ist **Max. Buchungsanzahl pro Bestellung** auf der Buchungsoption gesperrt und zeigt diesen Wert. |

<Tip>
  **Exklusive Zeitfenster** findest du unter **Ressource** → **Verfügbarkeit** → **Mehrfach verfügbar**. Bei Child Ressourcen unter **Ressource** → **Verfügbarkeit**, Typ **Child Ressourcen**. Denselben Pfad nutzt **Kunde darf Optionen wählen**, sofern der Toggle sichtbar ist.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Restaurant oder Eventlocation mit exklusiven Tischen">
    Du hast 44 Tische mit je 10 Sitzplätzen. Am selben Tisch sollen keine gemischten Gruppen oder Firmen sitzen. Eine Gruppe darf aber mehrere Tische in einer Bestellung buchen, zum Beispiel 5 Tische mit 45 Personen.

    Die Buchungsmenge ist die Zahl der **Personen bzw. Plätze**, nicht die Zahl der Tische. Setzt du 44 Tische mit **Verfügbare Anzahl** 1 an und nennst die Option "Platz pro Person" mit Maximum 10, bucht der Gast mit 10 Personen 10 Tische.

    <Steps>
      <Step title="Feature aktivieren">
        Aktiviere unter **Account Einstellungen** → **Features** die **Mehrfachverfügbarkeit mit Zuweisung**.
      </Step>

      <Step title="Eltern-Ressource anlegen">
        Öffne **Ressourcen** → **Neu+**. Vergib einen Namen (z. B. "Tische"). Unter **Verfügbarkeit** wählst du **Child Ressourcen**.
      </Step>

      <Step title="44 Tische als Child Ressourcen anlegen">
        Klicke auf **Child-Ressourcen hinzufügen**. Im Textfeld reicht eine Zeile wie `Tisch 1-44`. Bestätige mit **Child-Ressourcen erstellen**.
      </Step>

      <Step title="10 Plätze pro Tisch setzen">
        In der Child-Tabelle setzt du bei jedem Tisch die **Verfügbare Anzahl** auf **10**. Neue Child Ressourcen starten mit Anzahl 1. Der Toggle **Exklusive Zeitfenster** erscheint erst, wenn mindestens ein Tisch Anzahl größer 1 hat.
      </Step>

      <Step title="Exklusive Zeitfenster aktivieren">
        Aktiviere **Exklusive Zeitfenster** auf der Eltern-Ressource unter **Verfügbarkeit**. anny weist Tische automatisch zu. **Kunde darf Optionen wählen** ist bei Anzahl größer 1 nicht sichtbar.
      </Step>

      <Step title="Maximale Gruppengröße setzen">
        Setze **Erlaubte Buchungen pro Bestellung** auf der Eltern-Ressource auf die größte Gruppe, die du zulassen willst (z. B. 50 oder 440). Der Wert 10 begrenzt die ganze Bestellung auf 10 Plätze, nicht auf 10 Plätze pro Tisch.
      </Step>

      <Step title="Buchungsoption anlegen">
        Erstelle eine Buchungsoption (z. B. "Platz") mit **Buchungsart** **Standard**. Optional setzt du einen Preis pro Person und **Min. Buchungsanzahl pro Bestellung** auf 1.
      </Step>
    </Steps>

    Sobald das Setup aktiv ist, buchen Gäste die Personenzahl. Innerhalb einer Bestellung belegt anny Tische nacheinander (10, 10, 10, …). Im Shop gilt aktuell die Timeout-Obergrenze von 20 Plätzen pro Bestellung; 45 Personen in einem Durchgang brauchen den Bulk-Pfad wie bei Serienbuchungen.

    Mehr zur Ressourcenstruktur: [Ressource konfigurieren](/ressourcen-konfigurieren). Mehr zur Buchungsoption: [Buchungsoption](/configure-booking-option). Die Mengengrenze pro Bestellung liegt bei Exclusive slots auf der Ressource, siehe [Mindest- und Maximalauswahl](/min-max-selection).

    <Warning>
      Lege die 440 Sitzplätze nicht als eine Ressource **Mehrfach verfügbar** mit **Exklusive Zeitfenster** an. Die erste Bestellung würde den ganzen Saal sperren. **Exklusive Zeitfenster** brauchst du **pro Tisch**, also als Child Ressourcen.
    </Warning>
  </Accordion>

  <Accordion title="Kanu-Verleih mit Gruppentouren">
    In diesem Beispiel werden Kanus als Child Ressourcen angelegt. Zusätzlich wird eine Kanu-Tour als eigenes Gruppenangebot buchbar gemacht.

    <Steps>
      <Step title="Kanu-Ressource anlegen">
        Erstelle eine Ressource für die Kanus. Gehe zu **Ressource** → **Verfügbarkeit**, Typ **Child Ressourcen**, und lege folgende Child Ressourcen an:

        * Kanu 1
        * Kanu 2
        * Kanu 3
        * Kanu 4

        Setze für jede Child-Ressource die **Verfügbare Anzahl** auf 4 (Plätze pro Kanu).
      </Step>

      <Step title="Exklusive Zeitfenster aktivieren">
        Aktiviere **Exklusive Zeitfenster** unter **Ressource** → **Verfügbarkeit**. anny weist Kanus automatisch zu, sobald die **Verfügbare Anzahl** der Child Ressourcen größer 1 ist.
      </Step>

      <Step title="Buchungsoption konfigurieren">
        Erstelle eine Buchungsoption (z. B. "Miete") mit folgenden Einstellungen:

        * Preis pro Person oder pro Kanu, je nach deinem Tarif
        * **Min. Buchungsanzahl pro Bestellung**: 1
        * **Buchungsart**: **Standard** (jede Person bzw. jeder Platz ist eine Kapazitätseinheit)
      </Step>

      <Step title="Kanu-Tour-Ressource anlegen (optional)">
        Erstelle eine separate Ressource "Kanu-Tour". Unter **Verfügbarkeit** → **Mehrfach verfügbar** definierst du:

        * Verfügbare Anzahl: 16
        * Erlaubte Buchungen pro Bestellung: 16

        Erstelle zwei Buchungsoptionen:

        1. Einzeltarif (**Min. Buchungsanzahl pro Bestellung**: 1)
        2. Gruppentarif ab 4 Personen (**Min. Buchungsanzahl pro Bestellung**: 4)

        Verbinde unter **Ressource** → **Abhängigkeiten** die Kanu-Ressource. So wird pro Gruppenbuchung automatisch ein passendes Kanu mitreserviert und durch Exklusive Zeitfenster nicht mit fremden Gruppen geteilt.
      </Step>
    </Steps>

    Sobald Miete und Exclusive slots aktiv sind, belegt eine Gruppe zuerst ein Kanu bis zu 4 Plätzen und nimmt bei Bedarf das nächste. Andere Bestellungen bekommen kein schon belegtes Kanu.
  </Accordion>

  <Accordion title="Gruppenführungen im Museum">
    Ein Zeitfenster soll vollständig für eine Besuchergruppe reserviert werden, auch wenn nicht alle Plätze belegt sind.

    <Steps>
      <Step title="Ressource anlegen">
        Erstelle eine Ressource "Gruppenführung". Unter **Verfügbarkeit** → **Mehrfach verfügbar** definierst du:

        * Verfügbare Anzahl: 20
        * Erlaubte Buchungen pro Bestellung: 20
        * **Exklusive Zeitfenster**: aktiviert
      </Step>

      <Step title="Buchungsoption konfigurieren">
        Erstelle eine Buchungsoption "Ticket" und öffne die erweiterten Einstellungen:

        * **Min. Buchungsanzahl pro Bestellung**: 10
        * **Buchungsart**: **Standard**

        So müssen mindestens 10 Tickets in einer Bestellung liegen. Sobald eine Gruppe bucht, wird das Zeitfenster für andere Bestellungen gesperrt. Freie Plätze in derselben Bestellung bleiben nutzbar.
      </Step>
    </Steps>

    Sobald Ticket und Exclusive slots aktiv sind, bleibt jede Führung nach der ersten Bestellung für andere Kund:innen geschlossen.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was bedeutet 'ausgebucht', wenn noch Plätze frei sind?">
    "Ausgebucht" bedeutet in diesem Fall, dass das Zeitfenster bereits exklusiv für eine Bestellung reserviert ist. Es heißt nicht, dass alle verfügbaren Plätze belegt sind.
  </Accordion>

  <Accordion title="Warum bucht '10 Personen' 10 Tische statt einen Tisch mit 10 Plätzen?">
    Die Menge in der Buchungsoption zählt Kapazitätseinheiten der Ressource. Hast du 44 Tische mit **Verfügbare Anzahl** 1, ist eine Einheit ein ganzer Tisch. 10 Personen belegen dann 10 Tische. Setze pro Tisch die **Verfügbare Anzahl** auf 10 und aktiviere **Exklusive Zeitfenster**. Dann sind 10 Personen 10 Plätze an einem Tisch.
  </Accordion>

  <Accordion title="Können Gäste 5 Tische mit 45 Personen in einer Bestellung buchen?">
    Die Ressourcen-Logik erlaubt das: anny füllt Tische in derselben Bestellung bis 10 Plätze und nimmt dann den nächsten. **Erlaubte Buchungen pro Bestellung** muss mindestens 45 sein. Im Shop-Buchungsflow gilt zusätzlich eine Obergrenze von **20** Plätzen pro Bestellung, damit Warenkorb und Checkout nicht in den Request-Timeout laufen. 45 Personen in einem Durchgang brauchen denselben Bulk-Pfad wie Serienbuchungen.
  </Accordion>

  <Accordion title="Warum nicht einfach 440 Sitzplätze einstellen?">
    440 Plätze als eine Ressource **Mehrfach verfügbar** ohne Child Ressourcen würden bei **Exklusive Zeitfenster** nach der ersten Bestellung den ganzen Saal sperren. Child Ressourcen mit 10 Plätzen pro Tisch halten die Exklusivität auf den einzelnen Tisch. Andere Tische bleiben für andere Gruppen frei.
  </Accordion>

  <Accordion title="Können Admins weiterhin sehen, wie viele Plätze tatsächlich belegt sind?">
    Ja. Im Admin-Bereich bleibt die tatsächliche Belegung sichtbar (z. B. 2/4 belegt). Nur für externe Kund:innen erscheint der Slot als ausgebucht.
  </Accordion>

  <Accordion title="Kann ich Exklusive Zeitfenster mit 'Kunde darf Optionen wählen' kombinieren?">
    Nein. Sobald Child Ressourcen eine **Verfügbare Anzahl** größer 1 haben, blendet anny **Kunde darf Optionen wählen** aus und weist automatisch zu. Den Toggle findest du sonst unter **Ressource** → **Verfügbarkeit**.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ein Zeitfenster wird als ausgebucht angezeigt, obwohl noch Plätze frei sind">
    Das ist erwartetes Verhalten bei aktivierten Exklusiven Zeitfenstern. Das Zeitfenster wurde bereits durch eine Bestellung exklusiv reserviert und ist deshalb für weitere Kund:innen nicht mehr buchbar. Im Admin-Bereich siehst du weiterhin die tatsächliche Belegung.
  </Accordion>

  <Accordion title="Der Toggle 'Exklusive Zeitfenster' ist nicht sichtbar">
    Bei **Mehrfach verfügbar** ohne Children erscheint der Toggle, wenn die **Verfügbare Anzahl** größer 1 ist. Im Modus **Child Ressourcen** erscheint er, sobald mindestens eine Child-Ressource eine **Verfügbare Anzahl** größer 1 hat. Prüfe beides unter **Ressource** → **Verfügbarkeit**.
  </Accordion>

  <Accordion title="10 Personen belegen 10 Tische statt 10 Plätze an einem Tisch">
    Die Child Ressourcen haben **Verfügbare Anzahl** 1, deshalb ist eine Buchungseinheit ein Tisch. Setze die Anzahl pro Tisch auf 10 (Sitzplätze) und aktiviere **Exklusive Zeitfenster**. Setze **Erlaubte Buchungen pro Bestellung** nicht auf 10, wenn Gruppen größer als 10 Personen buchen dürfen.
  </Accordion>

  <Accordion title="Buchungen werden trotz aktivierter Funktion nicht exklusiv behandelt">
    Prüfe, ob **Exklusive Zeitfenster** auf der Eltern-Ressource aktiv ist und die Child Ressourcen eine **Verfügbare Anzahl** größer 1 haben. Stelle die **Buchungsart** nicht auf **Vollständig**: das blockiert die gesamte Eltern-Ressource statt einzelner Tische.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Toggle `exclusiveSlots` / `exclusive_slots` unter Ressource → Verfügbarkeit. Child-Modus: sichtbar wenn `hasChildWithMultipleQuantity` (irgendein Kind quantity > 1) ODER Toggle bereits an.
> * Feature-Gating: `multiple-availability` und/oder `multiple-availability-with-children` unter Account Einstellungen → Features.
> * `settings.checkout.customerCanPickChildren` ist ausgeblendet wenn `hasWeightedChildren` (Child quantity > 1). Auto-Zuweisung aufsteigend nach Name. Nicht mit Exclusive slots kombinierbar über UI.
> * Buchungsart: `weightTypes.simple` = Standard/Default (`defaultWeight=1`, `fullWeight=false`). `weightTypes.full` = Vollständig/Full setzt `fullWeight=true`, Associate hängt an Parent statt Child, weight = `resource.quantity`. NICHT Pflicht für Exclusive slots, für Tische/Boote falsch.
> * Same-order fill: ExclusiveSlotsBookingServiceTest, 3 Tickets bei Child quantity 2 → Distribution 2+1 auf zwei Children. Across orders: Children mit persisted overlap sind burnt (ChildBookingValidator).
> * Flache Ressource ohne Children: BookingCountValidator verbrennt bei exclusive\_slots die GANZE quantity nach erster persisted Buchung. Deshalb 440 Sitze + exclusive = ganzer Saal weg.
> * Service `maxBookingQuantity` disabled wenn `resource.exclusiveSlots`; UI **zeigt** `resource.maxBookingQuantity`, persistiert den Wert aber nicht. Shop-Stepper: `MAX_SYNC_BOOKING_QUANTITY = 20` (Axios add-booking + finish-order 30s, Octane `max_execution_time` 30s). Quantity N = N BookingBags in `MultiBookingBag`, je voller `createBookingsFromBookingBag` (Save + Model-Events).
> * Recurring analog: `CreateSeriesBookingsService` plant `OccurrenceDraft`s, `BookingProcessor::persist` nutzt `BulkEditService::bulkSave` (Chunks 100, `async: true` → `ProcessAsyncModelEvents`), `disableBookingChangeTracking`. Admin RecurringSettingsEditor count max 100. Shop-Include lädt `series_bookings` bewusst nicht.
> * Quantity > 10 **nicht** per mehrere add-booking-Requests chunken: `RESERVED` zählt in `BLOCKING_STATUSES`, `ChildBookingValidator` verbrennt das Child bei persisted overlap → Exclusive-Fill (10+5 am selben Tisch) bricht. Bulk muss **ein** Request bleiben.
> * Realistisch ohne Bulk-Pfad: bei 20 bleiben. Mit Recurring-Bulk-Pfad: 45–100 analog Serien-Count. 440 nicht (finish-order `confirmBookings` + Invoice-Items + JSON:API-Include).
> * `Resource::newChild` default quantity 1 und max\_booking\_quantity 1. Bulk: NewChildResources, Range-Syntax "Tisch 1-44" / "Seat 1-10", max 100 pro Durchgang.
> * "Ausgebucht" = exklusiv für eine Bestellung, NICHT volle Kapazität. Admins sehen echte Belegung.
> * Verwandte Artikel: /ressourcen-konfigurieren, /configure-booking-option, /min-max-selection, /getting-started-sailing-schools (Errata: Full als Pflicht), /smart-availability.
> * UI-Pfad: Ressourcen → Ressource → Verfügbarkeit → Child Ressourcen / Child-Ressourcen hinzufügen → Exclusive-slots-Toggle auf der Eltern-Ressource, nicht in der Child-Zeile.


# Föderiertes SAML
Source: https://docs.anny.co/federated-saml



Föderiertes SAML kommt zum Einsatz, wenn deine Organisation Teil eines größeren Identitätsnetzwerks ist (z. B. im Hochschulumfeld über DFN-AAI oder eduGAIN). Anstatt eine manuelle 1:1 Verbindung aufzubauen, kommunizieren anny und dein Identity Provider über diese gemeinsame Föderation. Die initiale Einrichtung wird dabei proaktiv von anny angestoßen.

## Für wen ist diese Funktion geeignet?

Dieses Setup richtet sich an IT-Admins von:

* Universitäten und Hochschulen, die über nationale Forschungsnetze authentifizieren.
* Großen Konzernen mit einer zentralen Föderation für mehrere Tochtergesellschaften.

## So funktioniert die Einrichtung

Der Prozess besteht aus zwei Phasen: Dem Anlegen in anny und der Freigabe in eurem System.

<Steps>
  <Step title="Die Verbindung in anny anstoßen">
    1. Öffne in anny die **Account-Einstellungen** und wechsle in den Bereich **SSO & Sicherheit**.
    2. Klicke auf den Button **+ IdP hinzufügen**.
    3. Wähle die Option **Föderation** und klicke anschließend auf dein Netzwerk (z. B. **DFN-AAI**).
    4. Gib nun die **Entity ID** deiner Organisation ein. **Tipp:** Wenn du DFN-AAI nutzt, findest du deine Entity ID in der [**DFN-AAI Tool-Übersicht**](https://tools.aai.dfn.de/entities/). Wähle dort den Bereich "Identity Provider" aus, suche nach deiner Organisation, kopiere die "SAML Entity ID" und füge sie in anny ein.
    5. Speichere die Eingabe in anny. Dadurch senden wir eine proaktive Anfrage an eure Föderation.

       <img alt="Image" />
  </Step>

  <Step title="Freigabe im Föderations-Interface">
    Wechsle nun in das Verwaltungssystem eurer Identitätsföderation, um die Anfrage von anny zu bearbeiten.

    1. **Anfrage im Interface prüfen** Sobald du die Verbindung in anny angestoßen hast, erhältst du auf eurer Seite (in eurem Föderations-Interface) eine Anfrage von anny. Diese Anfrage enthält die spezifische Entity ID von anny.
    2. **Domain beachten und akzeptieren** Prüfe die Entity ID. **Wichtig:** Achte hierbei genau auf die Domain-Endung! Je nachdem, auf welchem Server euer anny Account liegt, lautet die Domain der Entity ID entweder **anny.eu** oder **anny.co**. Akzeptiere die Anfrage für die exakt passende Domain in eurem Interface.
    3. **Attribute anlegen und freischalten** Der Login ist nun verknüpft. Damit anny aus dem Login ein echtes Nutzerprofil erstellen kann, müssen bei der Authentifizierung Daten übergeben werden. Lege auf eurer Seite die folgenden Attribute an und schalte diese explizit für anny (Attribute Release) frei:

    * **E-Mail (Erforderlich)** `urn:oid:1.2.840.113549.1.9.1` oder `urn:oid:0.9.2342.19200300.100.1.3`
    * **Vor- und Nachname (Erforderlich)** `givenName` (`urn:oid:2.5.4.42`) und `surname` (`urn:oid:2.5.4.4`)
    * **Name (Fallback)** Falls Vor- und Nachname systemseitig nicht getrennt übergeben werden können, nutze als Alternative den `displayName` (`urn:oid:2.16.840.1.113730.3.1.241`).

    Eure Nutzer:innen können sich nun über die Föderation in anny einloggen. Die freigeschalteten Attribute werden beim Login übergeben und können in anny zusätzlich für das **Attribute Mapping** genutzt werden, um Personen automatisch in die richtigen Buchungsbereiche (Communities) zu leiten.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Nutzer:innen können sich einloggen, haben aber leere Profile in anny">
    Das bedeutet, dass der Login funktioniert, eure Föderation aber keine Attribute an anny sendet. Prüfe in eurem Interface, ob du die Attribute (wie E-Mail oder Name) tatsächlich für die anny-Anwendung freigeschaltet hast.
  </Accordion>

  <Accordion title="Die Anfrage wird nicht gefunden">
    Stelle sicher, dass du im Interface nach der exakten Entity ID suchst und vergewissere dich beim anny Support, ob die Anfrage für **.eu** oder **.co** gestellt wurde.
  </Accordion>
</AccordionGroup>


# Generisches SAML 2.0 SSO
Source: https://docs.anny.co/generic-saml-sso

Richte einen Unternehmenslogin mit einem beliebigen SAML-2.0-Identity-Provider wie Okta, Auth0, Keycloak oder Shibboleth in anny ein.

In diesem Artikel erfährst du, wie du einen Unternehmenslogin mit einem beliebigen SAML-2.0-Identity-Provider bei anny einrichtest. Das ist der richtige Weg für alle Systeme, für die es keine eigene Anleitung gibt, zum Beispiel Okta, Auth0, Keycloak, Shibboleth, OneLogin oder Ping Identity.

<Info>
  Für Microsoft 365 und Google Workspace gibt es eigene Artikel mit Screenshots: [Microsoft SAML SSO](/microsoft-saml-sso) und [Google Workspace SSO](/google-workspace-sso).
</Info>

## Vorbereitung

Die SSO Verbindung kannst du selbstständig in deinem anny [Admin Bereich](https://app.anny.co/organization/settings/sso?o=) unter SSO & Sicherheit hinterlegen. Neben den anny Admin Rechten benötigst du administrativen Zugang zu deinem Identity Provider.

Halte dir am besten beide Systeme parallel in zwei Browser-Tabs offen, da du Werte zwischen anny und deinem Identity Provider hin- und herkopierst.

## Einrichtung

<Steps>
  <Step title="Identity Provider in anny anlegen">
    Gehe in die [SSO Einstellungen](https://app.anny.co/organization/settings/sso?o=), wähle "IDP hinzufügen" und dann als Provider "Custom SAML2". Vergib einen Namen, zum Beispiel "Unternehmenslogin".
  </Step>

  <Step title="anny Metadaten in deinem Identity Provider hinterlegen">
    Klicke unter "1. Metadaten der Anwendung kopieren" auf "Details anzeigen". Dort findest du die Werte, die dein Identity Provider für anny als Service Provider benötigt. Lege in deinem Identity Provider eine neue SAML-Anwendung an und trage die Werte ein.
  </Step>

  <Step title="Metadaten deines Identity Providers in anny eintragen">
    Wechsle zurück in anny und fülle das Formular unter "2. SAML-Metadaten einfügen" aus. Am einfachsten ist die Option "URL": Dort hinterlegst du die Metadaten-URL deines Identity Providers, anny liest dann alle Werte automatisch aus. Alternativ wählst du "Manuell" und trägst die Werte einzeln ein.
  </Step>

  <Step title="Signierung der SAML-Antwort aktivieren">
    Stelle in deinem Identity Provider sicher, dass die SAML-Antwort signiert wird. anny akzeptiert aus Sicherheitsgründen ausschließlich signierte Antworten.
  </Step>

  <Step title="Verbindung testen und aktivieren">
    Speichere die Konfiguration und teste die Verbindung über "Test Connection". Wenn der Login funktioniert, aktivierst du den Identity Provider über die drei Punkte > Aktivieren.
  </Step>
</Steps>

## Diese Werte benötigt dein Identity Provider von anny

Du findest alle Werte in den SSO Einstellungen unter "1. Metadaten der Anwendung kopieren" > "Details anzeigen".

| Wert | Beschreibung |
| - | - |
| **Metadaten-URL** | Enthält alle Angaben gebündelt. Viele Identity Provider können diese URL direkt importieren. |
| **Entity ID** | Die eindeutige Kennung von anny als Service Provider. Teilweise auch "Audience" oder "Audience URI" genannt. |
| **ACS-URL** | Die Adresse, an die dein Identity Provider die SAML-Antwort sendet. Teilweise auch "Assertion Consumer Service URL", "Reply URL" oder "Single Sign-On URL" genannt. |
| **Zertifikat** | Wird nur benötigt, wenn dein Identity Provider die Signatur der Loginanfrage (SAMLRequest) überprüfen soll. |

Die URLs folgen diesem Muster, wobei `{id}` die ID deiner Organisation ist:

Metadaten-URL: [**https://auth.anny.co/tenant/\{id}/saml/metadata**](https://auth.anny.co/tenant/\{id}/saml/metadata)

Zertifikat-URL: [**https://auth.anny.co/tenant/\{id}/saml/cert**](https://auth.anny.co/tenant/\{id}/saml/cert)

## Diese Werte benötigt anny von deinem Identity Provider

Wenn du die Option "Manuell" nutzt, trägst du folgende Werte ein:

| Feld in anny | Beschreibung |
| - | - |
| **Entity ID** | Die eindeutige Kennung deines Identity Providers. Teilweise auch "Issuer" oder "IdP Entity ID" genannt. |
| **X509-Zertifikat** | Das Signaturzertifikat deines Identity Providers. Kopiere den kompletten Inhalt inklusive der BEGIN- und END-Zeilen. |
| **SSO-URL** | Die Adresse, an die anny die Loginanfrage sendet. Teilweise auch "Single Sign-On Service URL" oder "Login URL" genannt. |
| **SLO-URL** | Die Adresse für den Logout. Teilweise auch "Single Logout Service URL" genannt. |

## Attribute

Für den Login benötigt anny mindestens eine E-Mail-Adresse sowie Vor- und Nachname. Wie du die Attribute deines Identity Providers auf anny abbildest und daraus automatisch Community-Zuordnungen ableitest, erfährst du im Artikel [Attribute Mapping](/attribute-mapping).

<Warning>
  **Wichtig:** anny akzeptiert ausschließlich signierte SAML-Antworten. Ist die Signierung in deinem Identity Provider nicht aktiviert, schlägt der Login mit der Meldung "Signatur fehlt" fehl.
</Warning>

## Häufige Bezeichnungen je Identity Provider

Die Begriffe unterscheiden sich je nach System. Diese Übersicht hilft dir beim Zuordnen.

<AccordionGroup>
  <Accordion title="Okta">
    Lege unter *Applications* > *Create App Integration* eine neue Anwendung mit "SAML 2.0" an. Die anny ACS-URL trägst du unter "Single sign on URL" ein, die anny Entity ID unter "Audience URI (SP Entity ID)". Die Metadaten-URL deines Identity Providers findest du anschließend unter "Identity Provider metadata".
  </Accordion>

  <Accordion title="Auth0">
    Aktiviere in deiner Auth0 Application die Erweiterung "SAML2 Web App". Die anny ACS-URL trägst du als "Application Callback URL" ein, die anny Entity ID im Feld "audience" der Settings. Die Metadaten-URL findest du im Reiter "Usage".
  </Accordion>

  <Accordion title="Keycloak">
    Lege einen neuen Client mit dem Typ "SAML" an. Die anny Entity ID trägst du als "Client ID" ein, die anny ACS-URL als "Valid Redirect URI" sowie unter "Master SAML Processing URL". Achte darauf, dass "Sign Documents" aktiviert ist. Die Metadaten-URL lautet `https://<dein-keycloak>/realms/<realm>/protocol/saml/descriptor`.
  </Accordion>

  <Accordion title="Shibboleth und andere Föderationen">
    Wenn dein Identity Provider Teil einer Föderation wie DFN-AAI oder eduGAIN ist, nutze statt dieser Anleitung den Artikel [Föderiertes SAML](/federated-saml). Dort wählst du deinen Identity Provider direkt aus der Föderation aus.
  </Accordion>
</AccordionGroup>

## Nach der Einrichtung

* Über die drei Punkte kannst du dir einen Wayfless-Link erzeugen. Damit landen deine Nutzer:innen direkt im Login deines Identity Providers.
* Mit [Attribute Mapping](/attribute-mapping) ordnest du Nutzer:innen automatisch Communities zu.
* Mit [SCIM](/scim-user-provisioning) legst du Nutzerkonten automatisch an, ohne dass sich die Personen vorher einloggen müssen.

Hier findest du eine Erläuterung zu potenziellen Fehlermeldungen: [SSO Troubleshooting](/sso-overview)


# Dein Start mit anny
Source: https://docs.anny.co/getting-started



Mit anny erstellst du in wenigen Minuten ein vollständiges Buchungssystem. Dieser Artikel führt dich von der Registrierung bis zur ersten Testbuchung, damit du schnell live gehen kannst.

## Deinen Account einrichten

<Steps>
  <Step title="Account erstellen">
    Öffne [anny.co](https://www.anny.co) und klicke auf **Kostenlos starten**. Gib deinen Namen, deine E-Mail-Adresse und ein Passwort ein. Nach der Bestätigung per E-Mail landest du direkt im Admin-Bereich.

    <img alt="Account Erstellen" />
  </Step>

  <Step title="Erste Ressource anlegen">
    Eine Ressource ist alles, was gebucht werden kann: ein Raum, ein Arbeitsplatz, ein Kurs oder eine Person zur Terminvereinbarung.

    Öffne in der Menüleiste **Ressourcen** und klicke auf **Neu +**. Vergib einen Namen (z. B. "Meetingraum A") und speichere. Unter **Verfügbarkeit** legst du anschließend Zeitpläne fest, also wann die Ressource buchbar ist.

    <img alt="Ressource Anlegen" />

    <Tip>
      Starte mit einer einzelnen Ressource un erweitere später. So lernst du die Grundlagen, ohne dich in Details zu verlieren.
    </Tip>

    Mehr zu Einstellungen und Optionen: [Ressource konfigurieren](ressourcen-konfigurieren)
  </Step>

  <Step title="Buchungsoption einrichten">
    Eine Buchungsoption (auch Service genannt) legt fest, WIE deine Ressource gebucht wird: Dauer, Preis, Formulare und Stornierungsbedingungen.

    Öffne in der Ressource den Reiter **Buchungsoption** und klicke auf **+ Hinzufügen**. Vergib einen Namen (z. B. "Stundenbuchung") und lege mindestens die Dauer fest. Speichere die Buchungsoption.

    Mehr zu allen Einstellungen: [Buchungsoption konfigurieren](/configure-booking-option)
  </Step>

  <Step title="Buchungsseite live schalten">
    Deine Buchungsseite ist die öffentliche Seite, über die Kund:innen buchen. Klicke im Admin-Bereich unten links auf **Buchungsseite live schalten**. Du gelangst zu den Organisationseinstellungen, wo du oben rechts die Buchungsseite aktivierst.

    <img alt="Buchungsseite Live Stellen" title="Buchungsseite Live Stellen" />

    <img alt="Buchungsseite Live Stellen" title="Buchungsseite Live Stellen" />

    Sobald die Seite aktiv ist, erscheint unten links der Link **Buchungsseite**. Darüber erreichst du die Ansicht, die auch deine Kund:innen sehen.

    Mehr zu Layout und Anpassung: [Layout deiner Buchungsseite](/booking-page-layout)
  </Step>

  <Step title="Buchungsprozess testen">
    Wähle die Ressource und Buchungsoption aus und schließe eine Testbuchung ab, genau so, wie es deine Kund:innen tun würden.

    **Kostenpflichtige Buchungsoptionen testen**: Erstelle einen Rabattcode mit 100 % Rabatt, damit keine echten Kosten entstehen. Aktiviere dazu unter **Account-Einstellungen** → **Features** die Funktion **Rabattcodes** und erstelle einen neuen Code mit 100 % relativem Rabatt für die gewünschte Ressource.

    <Warning>
      Testbuchungen können nur gelöscht werden, wenn keine 2-Wege Kalender-Integration hinterlegt ist. Prüfe das vorab, falls du Testdaten wieder entfernen möchtest.
    </Warning>
  </Step>
</Steps>

## Ergebnis prüfen

Nach Abschluss der Testbuchung erscheint deine Buchung im Admin-Bereich unter **Buchungen**. Du siehst dort alle Details wie Zeitraum, Ressource und Kundendaten. Im Kalender wird der gebuchte Slot als belegt angezeigt. Damit ist dein Buchungssystem bereit für echte Kund:innen.

## FAQ

<AccordionGroup>
  <Accordion title="Wie teste ich kostenpflichtige Buchungen, ohne echte Kosten?">
    Erstelle einen Rabattcode mit 100 % Rabatt für die gewünschte Ressource. Alternativ kannst du die Buchung nachträglich ablehnen (nicht stornieren), um den vollständigen Betrag zurückzuerstatten.
  </Accordion>

  <Accordion title="Wie lösche ich Testbuchungen aus meinem Account?">
    Kostenlose Testbuchungen kannst du direkt unter **Buchungen** löschen, solange keine 2-Wege Kalender-Integration aktiv ist. Kostenpflichtige Testbuchungen kann nur das Customer Success Team entfernen. Melde dich dazu im Chat oder per E-Mail an [support@anny.co](mailto:support@anny.co).
  </Accordion>

  <Accordion title="Wie teste ich Abo-Pläne?">
    Erstelle im Admin-Bereich unter **Abos** ein neues Abo mit 100 % Rabatt für dich selbst. So durchläufst du den kompletten Prozess, ohne dass Kosten entstehen.
  </Accordion>

  <Accordion title="Muss ich alle Schritte abschließen, bevor meine Buchungsseite funktioniert?">
    Ja. Du brauchst mindestens eine Ressource mit Verfügbarkeit und eine zugeordnete Buchungsoption, damit Kund:innen einen buchbaren Slot sehen.
  </Accordion>

  <Accordion title="Kann ich die Buchungsseite auch auf meiner eigenen Website einbetten?">
    Ja. Neben der eigenständigen anny Buchungsseite kannst du ein Widget direkt in deine Website integrieren. Mehr dazu: [Widget einbetten](/embed-booking-page)
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Auf meiner Buchungsseite werden keine buchbaren Termine angezeigt">
    Prüfe, ob du für die Ressource einen Zeitplan mit verfügbaren Zeiten hinterlegt hast. Ohne Verfügbarkeit gibt es keine buchbaren Slots. Öffne die Ressource und navigiere zu **Verfügbarkeit** → **Zeitpläne**.
  </Accordion>

  <Accordion title="Ich kann meine Testbuchung nicht löschen">
    Testbuchungen lassen sich nur löschen, wenn keine 2-Wege Kalender-Integration (z. B. Outlook oder Google Workspace) aktiv ist. Wende dich an [support@anny.co](mailto:support@anny.co).
  </Accordion>

  <Accordion title="Die Buchungsseite zeigt 'nicht live'">
    Gehe zu **Account-Einstellungen** und prüfe, ob die Buchungsseite oben rechts aktiviert ist. Stelle außerdem sicher, dass mindestens eine Ressource mit einer Buchungsoption existiert und die Ressource den Status **Live zur Buchung** hat.
  </Accordion>
</AccordionGroup>


# Los Geht's - Terminvereinbarung
Source: https://docs.anny.co/getting-started-appointments



Mit anny bildest du dein gesamtes Terminbuchungssystem ab: von der buchbaren Leistung über automatische Kalender-Synchronisation bis zur Online-Zahlung. In diesem Guide richtest du Schritt für Schritt alles ein, damit deine Kund:innen Termine direkt online buchen können.

<iframe />

## Terminvereinbarung im anny Kontext denken

Bei der Terminvereinbarung legst du dich selbst oder deine Mitarbeitenden als **Ressource** an. Jede Ressource bekommt einen oder mehrere **Services** (Buchungsoptionen), die definieren, welche Leistung zu welchem Preis und mit welcher Dauer buchbar ist. Das zentrale Prinzip: Kund:innen wählen über den **Service-first Flow** zuerst die gewünschte Leistung und sehen dann automatisch die verfügbaren Zeitfenster der passenden Person.

| Dein Angebot | anny Konzept |
| - | - |
| Du als Coach, Berater:in oder Trainer:in | **Ressource** (Person) |
| Erstgespräch, Coaching-Session, Beratungstermin | **Service** (Buchungsoption mit Dauer und Preis) |
| Deine buchbaren Zeiten | **Verfügbarkeit** (Zeitplan oder einzelne Termine) |
| Deine Buchungswebseite | **Buchungsseite** (öffentlich, einbettbar als Widget) |

Deine Kund:innen buchen über den **Buchungsbereich** (öffentliche Buchungsseite oder Widget). Du verwaltest alles im **Adminbereich** (Ressourcen, Services, Buchungen, Dashboard).

## Entscheidungshilfen: Wann nutze ich was?

### Wann feste Dauer und wann flexible Dauer?

| Kriterium | Feste Dauer | Flexible Dauer |
| - | - | - |
| Buchungslänge | Immer gleich (z. B. 60 Min) | Kund:in wählt Länge selbst |
| Typischer Use Case | Coaching-Session, Erstgespräch | Beratung nach Aufwand |
| Preisgestaltung | Festpreis pro Termin | Preis pro Zeiteinheit möglich |
| Beispiel | Coaching 60 Min für 120 EUR | Beratung ab 30 Min, je 50 EUR/Std |

**Faustregel:** Nutze feste Dauer, wenn deine Leistung immer gleich lang dauert. Nutze flexible Dauer nur, wenn Kund:innen die Länge selbst bestimmen sollen.

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressource anlegen">
    Öffne in der Menüleiste **Ressourcen** und klicke auf **Neu+**. Lege dich selbst oder eine:n Mitarbeiter:in als Ressource an. Hinterlege in den allgemeinen Informationen Name, Beschreibung und ein Profilbild.

    <Tip>
      Nutze **Eigenschaften**, damit Kund:innen auf der Buchungsseite nach relevanten Infos filtern können (z. B. Sprache, Spezialisierung, 1:1-Betreuung).
    </Tip>
  </Step>

  <Step title="Verfügbarkeit einrichten">
    Öffne die Ressource und wechsle zu **Verfügbarkeit**. Hier definierst du, wann du buchbar bist.

    Für **regelmäßige Verfügbarkeiten** legst du einen Zeitplan an (z. B. Mo bis Fr, 9:00 bis 17:00 Uhr). Einzelne Tage kannst du mehrfach anlegen, um Mittagspausen abzubilden.

    Für **unregelmäßige Verfügbarkeiten** empfehlen wir, einzelne verfügbare Termine direkt in der Verfügbarkeit anzulegen.

    Setze die Verfügbarkeit auf **Einfach verfügbar**, wenn du nur einen Termin gleichzeitig annehmen kannst (Standard für Einzelcoachings).
  </Step>

  <Step title="Service erstellen und konfigurieren">
    Öffne in der Menüleiste **Services** und erstelle einen neuen Service. Definiere:

    * **Name** der Leistung (z. B. Erstgespräch 30 Min)
    * **Dauer** (feste Dauer für die meisten Terminvereinbarungen)
    * **Preis** (entferne den Preis, wenn das Erstgespräch kostenlos sein soll)
    * **Verknüpfte Ressource(n)**: Wähle die Person aus, die diesen Service anbietet

    In den erweiterten Einstellungen kannst du optional eine **Vorlaufzeit** und **Vor- oder Nachbereitungszeiten** hinterlegen.

    <Tip>
      Aktiviere den [Service-first Flow](/service-first-flow), damit Kund:innen zuerst die Leistung wählen und danach den passenden Termin sehen. Das ist für Terminvereinbarung der empfohlene Ablauf.
    </Tip>
  </Step>

  <Step title="Kalender-Synchronisation einrichten">
    Verbinde deinen bestehenden Kalender, um Terminüberschneidungen automatisch zu vermeiden. Öffne dafür die Ressource und gehe zu **Integrationen**.

    Pro Ressource stehen dir folgende Optionen zur Verfügung:

    * [Google Kalender](/google) (Zwei-Wege-Synchronisation)
    * [Outlook Kalender](/outlook) (Zwei-Wege-Synchronisation)
    * Externe Kalender via ICS-Link (Ein-Wege-Synchronisation)

    <Tip>
      Im **Kalender** in der Menüleiste erhältst du eine zentrale Übersicht über alle gebuchten Termine deiner Ressourcen.
    </Tip>
  </Step>

  <Step title="Online-Zahlung und Rechnungsstellung einrichten (optional)">
    Automatisiere deine Rechnungsstellung unter **Account-Einstellungen** und **Rechnungsstellung**. Lege fest, wie deine Kund:innen zahlen:

    * **Offline-Zahlung** (Überweisung, vor Ort)
    * **Online-Zahlung** via Stripe (Kreditkarte, SEPA, Apple Pay, Google Pay)
    * **Pay-Later** (Rechnung nach dem Termin)

    Für Online-Zahlungen richtest du über anny einen [Stripe Connect Account](/stripe-connect-setup) ein. Weitere Details findest du unter [Online-Zahlung und Gebühren](/online-payments).
  </Step>

  <Step title="Buchungsseite einbetten">
    Das Script für dein Buchungs-Widget findest du unter **Account-Einstellungen** und **Buchungsseite** oder direkt bei der jeweiligen Ressource im Reiter **Buchungsseite**.

    Wie du das Widget auf deiner Website einbettest, erfährst du im Artikel [Buchungsseite einbetten](/embed-booking-page).

    <Tip>
      Mit Website Widgets v2 kannst du gezielt einzelne Komponenten wie ein Booking Panel, einen Button oder einen Cart auf deiner Website platzieren, statt immer die komplette Buchungsseite einzubetten.
    </Tip>
  </Step>
</Steps>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Coach mit wöchentlichen 1:1-Sessions">
    <Steps>
      <Step title="Ressource anlegen">
        Erstelle die Ressource Anna Müller mit Profilbild und der Eigenschaft Sprache: Deutsch, Englisch.
      </Step>

      <Step title="Verfügbarkeit eintragen">
        Lege einen regelmäßigen Zeitplan an: Mo bis Do, 9:00 bis 12:00 und 14:00 bis 17:00. Freitag bleibt frei.
      </Step>

      <Step title="Services erstellen">
        Erstelle zwei Services mit fester Dauer:

        * Erstgespräch (30 Min, kostenlos)
        * Coaching-Session (60 Min, 150 EUR)

        Verknüpfe beide mit der Ressource Anna Müller.
      </Step>

      <Step title="Kalender verbinden">
        Verbinde den Google Kalender von Anna, damit private Termine automatisch als nicht buchbar erkannt werden.
      </Step>

      <Step title="Service-first Flow aktivieren">
        Aktiviere den Service-first Flow, damit Kund:innen zuerst zwischen Erstgespräch und Coaching-Session wählen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Beratungsunternehmen mit mehreren Berater:innen">
    <Steps>
      <Step title="Ressourcen anlegen">
        Erstelle pro Berater:in eine Ressource (z. B. Max Schmidt, Lisa Weber) mit individuellen Eigenschaften wie Fachgebiet und Sprache.
      </Step>

      <Step title="Verfügbarkeiten eintragen">
        Hinterlege pro Ressource individuelle Zeitpläne, abgestimmt auf die jeweiligen Arbeitszeiten.
      </Step>

      <Step title="Service erstellen">
        Erstelle einen Service Beratungsgespräch (60 Min, 200 EUR) und verknüpfe alle Berater:innen-Ressourcen damit.
      </Step>

      <Step title="Service-first Flow aktivieren">
        Aktiviere den Service-first Flow. Kund:innen wählen Beratungsgespräch und können anschließend optional eine:n bevorzugte:n Berater:in auswählen, oder anny weist automatisch zu.
      </Step>

      <Step title="Kalender und Zahlung">
        Verbinde pro Berater:in den Outlook-Kalender. Richte Stripe Connect für Online-Vorabzahlung ein.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<Columns>
  <Column>
    <Card title="Kalender-Synchronisation">
      Synchronisiere deine Buchungen automatisch mit Google, Outlook oder Microsoft 365 und vermeide Terminüberschneidungen zuverlässig.

      [Erfahre hier mehr](/google)
    </Card>
  </Column>

  <Column>
    <Card title="Online-Meeting-Integrationen">
      Versende automatisch Zoom- oder Teams-Einladungen mit jeder Terminbuchung, damit deine Kund:innen sofort den Meeting-Link erhalten.

      [Erfahre hier mehr](/zoom)
    </Card>
  </Column>
</Columns>

<Columns>
  <Column>
    <Card title="Wiederkehrende Buchungen">
      Ermögliche Kund:innen, regelmäßige Termine in einem Schritt zu buchen, inklusive Preisgestaltung, Kontingente und Smart Availability.

      [Erfahre hier mehr](/recurring-bookings)
    </Card>
  </Column>

  <Column>
    <Card title="Stornierungsbedingungen">
      Lege fest, bis wann Kund:innen kostenfrei stornieren dürfen und welche Gebühren danach greifen, um No-Shows effektiv zu reduzieren.

      [Erfahre hier mehr](/cancellation-policy)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich ein kostenloses Erstgespräch anbieten?">
    Ja. Erstelle einen Service und entferne den Preis vollständig. Kund:innen können den Termin dann ohne Zahlungsschritt buchen.
  </Accordion>

  <Accordion title="Wie verhindere ich Doppelbuchungen mit meinem privaten Kalender?">
    Verbinde deinen Google- oder Outlook-Kalender als Zwei-Wege-Synchronisation mit deiner Ressource. anny erkennt dann automatisch belegte Zeitfenster und zeigt sie als nicht verfügbar an.
  </Accordion>

  <Accordion title="Können Kund:innen eine:n bestimmte:n Berater:in auswählen?">
    Ja. Im Service-first Flow können Kund:innen nach der Leistungsauswahl optional eine bevorzugte Ressource (Person) wählen. Alternativ weist anny automatisch zu.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Adminbereich und Buchungsbereich?">
    Im **Adminbereich** verwaltest du alle Einstellungen, Buchungen und Auswertungen. Der **Buchungsbereich** ist die öffentliche Seite, auf der deine Kund:innen Ressourcen entdecken und Termine buchen.
  </Accordion>

  <Accordion title="Kann ich auch Serientermine anbieten?">
    Ja. Nutze dafür den Dauer-Modus **Serie** auf der Buchungsoption. Die konkreten Termine pflegst du in den Verfügbarkeiten deiner Ressource und ordnest sie einer Serie zu. Kund:innen buchen dann alle Termine als Paket.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Terminvereinbarung nutzt primär den **Service-first Flow** (Kund:innen wählen Leistung, dann Termin). Desk Sharing und Coworking nutzen den Resource-first Flow.
> * Die Person (Coach, Berater:in) wird als **Ressource** angelegt. Der Service definiert Dauer und Preis.
> * Verfügbarkeit: Regelmäßige Zeiten: Zeitplan auf der Ressource anlegen. Unregelmäßige Zeiten: einzelne verfügbare Termine in der Verfügbarkeit anlegen.
> * UI-Pfade: Ressourcen, Neu+ | Ressource, Verfügbarkeit, Zeitpläne | Services, Buchungsoption bearbeiten, Dauer
> * Service und Buchungsoption werden im Terminvereinbarungs-Kontext synonym verwendet (Leitbegriff: Buchungsoption).
> * Verwandte Artikel für Anschlussfragen: /online-payments, /zoom, /embed-booking-page, /kalenderintegrationen


# Los Geht's – Kurse
Source: https://docs.anny.co/getting-started-courses

Richte Kurse mit Ressourcen, Terminen und automatischer Verwaltung ein.

Mit anny kannst du Kursreihen so aufsetzen, dass Angebot, Raum, Trainer:in, Equipment und Teilnehmende perfekt zusammenspielen. Dieser Guide zeigt dir, wie du Ressourcen, Services und verfügbare Termine für dein Kursangebot strukturierst, pro Termin weitere Ressourcen automatisch blockst und eine Mindestanzahl mit automatischer Stornierung nutzt.

## Kurse im anny Kontext denken

Das zentrale Prinzip: **Jeder Kurs ist eine eigene Ressource mit verfügbaren Terminen.** Pro Termin kannst du weitere Ressourcen (Raum, Trainer:in) als bereitgestellte Ressourcen verknüpfen, die automatisch für diese Zeit geblockt werden.

| Begriff aus dem Kursalltag | anny-Konzept |
| - | - |
| Kursangebot (z. B. "Yoga Anfänger:innen") | Ressource |
| Ticket oder Tarif (z. B. "Erwachsene", "Mitglieder") | Service / Buchungsoption |
| Fester Kurstermin (z. B. Di 18:00) | Verfügbarer Termin |
| Kursraum oder Studio | Bereitgestellte Ressource am Termin |
| Trainer:in oder Coach | Bereitgestellte Ressource am Termin |
| Maximale Teilnehmendenzahl | Verfügbare Anzahl (Mehrfach verfügbar) |

## Entscheidungshilfen: Wann nutze ich was?

### Eigene Ressource oder Service?

| Kriterium | Service | Eigene Ressource |
| - | - | - |
| Wann nutzen? | Angebot wird direkt von einer Person erbracht | Angebot hat eigene Verfügbarkeiten und mehrere Plätze |
| Struktur | Person = Ressource, Angebot = Service | Angebot = Ressource, Services = Ticket-Optionen |
| Trainer:in/Raum | Ist die Ressource selbst | Wird als bereitgestellte Ressource am Termin hinterlegt |
| Beispiel | "Trainer:in Alex" mit Service "Private Lesson" | "Yoga Kurs" mit Services "Tarif Extern" und "Tarif Mitglieder" |

<Tip>
  Faustregel: Kann nur eine Person gleichzeitig gebucht werden? Dann ist es ein Service auf einer Personen-Ressource. Hat das Angebot mehrere Plätze und feste Termine? Dann ist es eine eigene Ressource.
</Tip>

### Smart Availability oder bereitgestellte Ressourcen?

| Kriterium | Smart Availability (abhängige Ressource) | Bereitgestellte Ressourcen |
| - | - | - |
| Wann blockiert? | Erst bei Buchung (dynamisch) | Beim Erstellen des Termins (statisch) |
| Steuert was? | Ob und wann gebucht werden kann | Welche Ressourcen für den Termin reserviert sind |
| Typischer Einsatz | Raum muss nur verfügbar sein, wenn tatsächlich gebucht wird | Trainer:in und Raum sind fix für diesen Termin eingeplant |

<Tip>
  Faustregel: Weisst du beim Anlegen des Termins schon, dass die Ressource gebraucht wird? Dann bereitgestellte Ressource. Soll sie nur bei Bedarf dynamisch mitgebucht werden? Dann Smart Availability. Mehr dazu im Artikel [Smart Availability](/smart-availability).
</Tip>

<Warning>
  **Bereitgestellte Ressourcen**, **abhängige Ressourcen** (Smart Availability) und **On-Demand-Ressourcen** (dynamische Kapazitätsplanung) sind drei verschiedene Mechanismen. Bereitgestellte Ressourcen werden reserviert, wenn du den Termin anlegst. Abhängige Ressourcen werden erst bei einer Buchung zugewiesen. On-Demand-Ressourcen skalieren die Kapazität automatisch bei hoher Nachfrage. Nutze Smart Availability nicht, um eine Trainer:in zu verknüpfen, die fest zu diesem Termin gehört.
</Warning>

| Feature | Wofür wird es benötigt? | Vorher zu konfigurieren? |
| - | - | - |
| Ressourcen | Kurse, Räume, Trainer:innen als buchbare Einheiten anlegen | Nein |
| Services / Buchungsoptionen | Tarife und Preise für den Kurs definieren | Nein |
| **Mehrfachverfügbarkeit von Ressourcen** | Ermöglicht mehrere Buchungen (Tickets) pro Kurstermin | Ja, unter **Account-Einstellungen** → **Features** aktivieren. Das sind nicht **Child-Ressourcen**. |
| Verfügbare Termine | Feste Zeitfenster für Kurstermine anlegen | Ressource muss existieren |
| Bereitgestellte Ressourcen | Raum und Trainer:in pro Termin blockieren | Raum-/Trainer-Ressource muss existieren |
| Mindestanzahl & Stornierungsdeadline | Termin automatisch absagen bei zu wenig Buchungen | Verfügbarer Termin muss existieren |
| Buchungsserien | Mehrere Termine als zusammenhängenden Block buchbar machen | Verfügbare Termine müssen existieren |

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressourcenstruktur aufbauen">
    Lege dein Kursangebot (z. B. "Yoga"), die Räume (z. B. "Studio 1") und Trainer:innen (z. B. "Lisa") als eigenständige Ressourcen an.

    Klicke dazu im linken Menü auf **Ressourcen** und oben rechts auf **+ Neu**.
  </Step>

  <Step title="Services definieren">
    Öffne die Kurs-Ressource und gehe zum Reiter **Service / Buchungsoption**.

    Definiere hier den passenden Service, z. B. "Tarif Erwachsene" oder "Drop-In Ticket". Lege Preis, Dauer und Stornierungsbedingungen fest.
  </Step>

  <Step title="Verfügbare Termine planen">
    Öffne innerhalb der Kurs-Ressource den Reiter **Verfügbarkeit**.

    1. Stelle den Typ auf **Mehrfach verfügbar** und definiere bei der verfügbaren Anzahl die Teilnehmer:innen-Anzahl (z. B. 15).
    2. Scrolle runter zu den **Verfügbaren Terminen** und klicke auf **+ Verfügbaren Termin hinzufügen**.
    3. Lege unter dem Reiter **Allgemein** den Termin mit Titel, Datum und Zeit an.
    4. Für wiederkehrende Termine aktiviere **Wiederkehrend** und definiere den Rhythmus.
    5. Für eine Buchungsserie füge den Serientitel ein und lege die dazugehörigen Termine fest. Mehr dazu im Artikel [Buchungsserien](/booking-series).
  </Step>

  <Step title="Mindestanzahl und Stornierungsdeadline festlegen (optional)">
    Öffne den Reiter **Einstellungen** innerhalb des verfügbaren Termins.

    1. Definiere eine **Mindestanzahl pro Termin** (z. B. 7 Teilnehmende).
    2. Lege eine **Stornierungsdeadline** relativ zum Startzeitpunkt fest (z. B. 24 Stunden vorher).

    Wenn bis zur Frist nicht genug Buchungen vorliegen, wird der Termin automatisch abgesagt. Alle Buchungen werden storniert und vorhandene Zahlungen automatisch erstattet. Kund:innen erhalten automatische E-Mails.

    Admins erhalten ca. 1 Stunde vor der automatischen Absage eine Warnung und eine Info, sobald die Mindestanzahl erreicht wurde.
  </Step>

  <Step title="Bereitgestellte Ressourcen zuweisen">
    Bleib im Reiter **Einstellungen** des verfügbaren Termins und scrolle zu **Bereitgestellte Ressourcen**.

    Füge hier Trainer:innen und den Raum hinzu. Diese Ressourcen werden automatisch für die Dauer des Termins blockiert und sind in diesem Zeitraum nicht anderweitig buchbar.
  </Step>

  <Step title="Buchungsseite überprüfen">
    Schau dir die Darstellung in der Tages- oder Wochenansicht an. Teste die Sichtbarkeit der verfügbaren Termine und führe eine Testbuchung durch.
  </Step>
</Steps>

Den Bereich **Verfügbare Termine** findest du in der Verfügbarkeit der Kurs-Ressource. Nach dem Speichern verbindest du unter **Einstellungen** → **Bereitgestellte Ressourcen** Studio und Trainer:in.

<Frame>
  <img alt="Liste Verfügbare Termine mit dem Button Verfügbaren Termin hinzufügen, der das Formular Verfügbaren Termin erstellen für Morning Barre auf Barre Course öffnet" />
</Frame>

<Frame>
  <img alt="Reiter Einstellungen im Dialog Verfügbaren Termin erstellen mit Bereitgestellte Ressourcen, wo du Raum oder Trainer:in per Plus-Button hinzufügst" />
</Frame>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Yoga-Studio mit Drop-In-Kursen">
    <Steps>
      <Step title="Ressourcen anlegen">
        Erstelle drei Ressourcen: "Yoga Anfänger:innen" (Kurs), "Studio 1" (Raum) und "Trainerin Lisa" (Person).
      </Step>

      <Step title="Service konfigurieren">
        Lege auf der Ressource "Yoga Anfänger:innen" den Service "Drop-In Ticket" an mit einem Preis von 15 EUR und einer festen Dauer von 75 Minuten.
      </Step>

      <Step title="Verfügbare Termine erstellen">
        Stelle die verfügbare Anzahl auf 15. Erstelle einen wiederkehrenden Termin: Dienstag, 18:00 bis 19:15 Uhr.
      </Step>

      <Step title="Bereitgestellte Ressourcen zuweisen">
        Weise dem Termin "Trainerin Lisa" und "Studio 1" als bereitgestellte Ressourcen zu. Beide werden automatisch geblockt.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Pilates-Studio mit Mindestanzahl und mehreren Tarifen">
    <Steps>
      <Step title="Ressourcen anlegen">
        Erstelle die Ressourcen: "Reformer Pilates" (Kurs), "Reformer Studio" (Raum) und "Coach Milla" (Person).
      </Step>

      <Step title="Services konfigurieren">
        Lege zwei Services auf "Reformer Pilates" an: "Mitglieder-Tarif" (0 EUR, Kontingent) und "Extern-Tarif" (25 EUR).
      </Step>

      <Step title="Verfügbare Termine mit Mindestanzahl">
        Stelle die verfügbare Anzahl auf 10. Erstelle einen wiederkehrenden Termin: Donnerstag, 09:00 bis 10:00 Uhr. Unter den Termin-Einstellungen definiere eine Mindestanzahl von 5 und eine Stornierungsdeadline von 24 Stunden.
      </Step>

      <Step title="Bereitgestellte Ressourcen zuweisen">
        Weise "Coach Milla" und "Reformer Studio" als bereitgestellte Ressourcen zu.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<Columns>
  <Column>
    <Card title="Dynamische Kapazitätsplanung">
      Passe Kurskapazitäten automatisch an die Nachfrage an, indem Ressourcen erst bei Buchung zugewiesen werden.

      [Erfahre hier mehr](/dynamic-capacity-planning)
    </Card>
  </Column>

  <Column>
    <Card title="Smart Availability">
      Definiere komplexe Verfügbarkeitsregeln, damit Ressourcen dynamisch bei der Buchung geprüft und mitgebucht werden.

      [Erfahre hier mehr](/smart-availability)
    </Card>
  </Column>
</Columns>

<Columns>
  <Column>
    <Card title="Buchungsserien">
      Biete zusammenhängende Terminsblöcke als ein buchbares Paket an und verwalte Serien zentral in der Verfügbarkeit.

      [Erfahre hier mehr](/booking-series)
    </Card>
  </Column>

  <Column>
    <Card title="Wiederkehrende Buchungen">
      Ermögliche Kund:innen, regelmässige Buchungen mit flexiblem Rhythmus als Serie anzulegen und selbst zu verwalten.

      [Erfahre hier mehr](/recurring-bookings)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Sehen Kund:innen die Mindestanzahl auf der Buchungsseite?">
    Nein. Kund:innen sehen nicht, dass eine Mindestanzahl definiert wurde. Die automatische Stornierung erfolgt unsichtbar im Hintergrund.
  </Accordion>

  <Accordion title="Kann ich einen Termin trotzdem stattfinden lassen, wenn die Mindestanzahl nicht erreicht wird?">
    Ja. Öffne den Termin vor Ablauf der Stornierungsdeadline und passe die Mindestanzahl nach unten an (z. B. von 10 auf 6). Speichere, und die automatische Stornierung wird verhindert.
  </Accordion>

  <Accordion title="Was passiert, wenn ich einen Termin verschiebe?">
    Alle Buchungen, deren Start- und Endzeit exakt dem Termin entsprechen, werden automatisch mitverschoben. Buchende werden per E-Mail informiert. Buchungen, die nur überlappen, bleiben bewusst unverändert.
  </Accordion>

  <Accordion title="Kann ich beim Absagen eines Termins eine eigene Nachricht mitsenden?">
    Ja. Beim Ändern des Buchungsstatus erscheint ein Pop-up, in dem du eine kurze, individuelle Nachricht ergänzen kannst. Diese wird in die automatische E-Mail an die Buchenden übernommen.
  </Accordion>

  <Accordion title="Brauche ich für jede neue Kursserie eine neue Ressource?">
    Nein. Du kannst innerhalb einer Ressource mehrere Serien anlegen. Kund:innen wählen beim Buchen die passende Serie aus einem Dropdown. Mehr dazu unter [Buchungsserien](/booking-series).
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen bereitgestellten Ressourcen, Smart Availability und On-Demand-Ressourcen?">
    **Bereitgestellte Ressourcen** werden reserviert, wenn du den Termin anlegst (zum Beispiel Trainer:in und Studio, die fest eingeplant sind). **Smart Availability** weist eine **abhängige Ressource** erst bei einer Buchung zu. **On-Demand-Ressourcen** skalieren die Kapazität automatisch bei hoher Nachfrage. Nutze dafür [dynamische Kapazitätsplanung](/dynamic-capacity-planning).
  </Accordion>
</AccordionGroup>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Trainer:in oder Raum sind nach dem Anlegen des Kurstermins noch buchbar">
    Verknüpfe sie unter **Bereitgestellte Ressourcen** im Reiter **Einstellungen** des Termins. Eine Smart-Availability-Abhängigkeit reserviert sie nicht beim Anlegen des Termins — sie wird erst bei einer Buchung zugewiesen.
  </Accordion>

  <Accordion title="Ich kann am Kurs keine Child-Ressourcen anlegen">
    Kurstickets nutzen **Mehrfachverfügbarkeit von Ressourcen** (Verfügbarkeitstyp **Mehrfach verfügbar**). **Child-Ressourcen** brauchen das separate Feature **Mehrfachverfügbarkeit mit Zuweisung**.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Abgrenzung: "Bereitgestellte Ressourcen" (statisch, beim Termin-Erstellen geblockt) ≠ "Smart Availability / abhängige Ressource" (dynamisch, erst bei Buchung zugewiesen) ≠ "On-Demand Ressourcen" (dynamisch, automatische Kapazitätsskalierung bei Nachfrage)
> * UI-Pfad Mindestanzahl: Ressourcen > \[Kurs-Ressource] > Verfügbarkeit > Verfügbare Termine > \[Termin auswählen] > Einstellungen > Mindestanzahl pro Termin + Stornierungsdeadline
> * UI-Pfad bereitgestellte Ressourcen: Ressourcen > \[Kurs-Ressource] > Verfügbarkeit > Verfügbare Termine > \[Termin auswählen] > Einstellungen > Bereitgestellte Ressourcen
> * Wenn-Dann: Mindestanzahl nicht erreicht UND Stornierungsdeadline abgelaufen → Termin wird automatisch abgesagt, alle Buchungen abgelehnt, Zahlungen erstattet, E-Mails versendet
> * Wenn-Dann: Termin verschieben → nur Buchungen mit exakt gleichem Start/Ende werden mitverschoben. Überlappende Buchungen bleiben unverändert (Schutzfunktion)
> * Matching-Regel: Buchung wird nur dann mit dem Termin verschoben/storniert, wenn Start UND Ende der Buchung exakt dem Termin entsprechen
> * Verwandte Artikel: Smart Availability → /smart-availability | Dynamische Kapazitätsplanung → /dynamic-capacity-planning | Buchungsserien → /booking-series | Wiederkehrende Buchungen → /recurring-bookings | Zeitpläne → /schedules | Verfügbare Termine → /available-slots
> * Kursangebote werden als Ressource mit dem Verfügbarkeitstyp **Mehrfach verfügbar** angelegt. Zuerst das Org-Feature **Mehrfachverfügbarkeit von Ressourcen** aktivieren. Das sind nicht **Child-Ressourcen** (Feature **Mehrfachverfügbarkeit mit Zuweisung**). Die verfügbare Anzahl entspricht der maximalen Teilnehmer:innen-Zahl
> * Services auf einer Kurs-Ressource definieren die Ticket-Optionen/Tarife, nicht das Angebot selbst


# Los Geht's – Coworking
Source: https://docs.anny.co/getting-started-coworking



Mit diesem Guide richtest du deinen Coworking-Space in anny ein. Du kombinierst Ressourcen, Services, Communities und Abo-Pläne so, dass deine Mitglieder Arbeitsplätze, Räume und Equipment selbstständig buchen, bezahlen und nutzen können.

<iframe />

## Coworking im anny Kontext denken

In anny bildet jedes buchbare Objekt (Desk, Raum, Parkplatz) eine Ressource ab. Services legen fest, wie und zu welchem Preis gebucht wird. Communities steuern den Zugang, und Abo-Pläne automatisieren Mitgliedschaft und Abrechnung. Das zentrale Prinzip: Ressourcen zeigen, was buchbar ist. Communities bestimmen, wer buchen darf. Abo-Pläne verbinden beides mit automatischer Zahlung.

| Begriff im Coworking | anny-Konzept |
| - | - |
| Arbeitsplatz, Büro, Meetingraum | Ressource (ggf. mit Child-Ressourcen) |
| Tagespass, Stundenpreis | Service / Buchungsoption |
| Mitgliederbereich, Members-Only | Community |
| Mitgliedschaft, Monatsabo | Abo-Plan |

<Info>
  * **Essential-Plan** oder höher für Abo-Pläne und automatisierte Rechnungsstellung
  * [**Online-Zahlung**](/online-payments) muss vorab aktiviert werden, damit Abos und wiederkehrende Abbuchungen funktionieren
</Info>

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressourcen anlegen">
    Öffne im linken Menü **Ressourcen** und klicke auf **+Neu**. Lege jedes buchbare Objekt als eigene Ressource an: Arbeitsplätze, Büros, Meetingräume, Parkplätze, Equipment.

    Für mehrere Arbeitsplätze in einem Raum: Erstelle den Raum als Ressource und füge unter **Verfügbarkeit** die einzelnen Desks als **Child-Ressourcen** hinzu. Mehr zur Konfiguration findest du unter [Ressource konfigurieren](/ressourcen-konfigurieren).
  </Step>

  <Step title="Services definieren">
    Wechsle in einer Ressource zum Reiter **Service / Buchungsoption**. Lege fest, wie lange oder kurz eine Buchung sein darf (flexibel oder feste Dauer) und definiere den Preis. Details dazu findest du unter [Buchungsoption konfigurieren](/configure-booking-option).
  </Step>

  <Step title="Communities einrichten">
    Öffne aus der Menüleiste die **Communities** und erstelle eine neue Community. Mitglieder kannst du manuell per E-Mail einladen oder automatisch über einen verknüpften Abo-Plan zuweisen lassen.

    Weise der Community exklusive Buchungsoptionen zu, damit nur Mitglieder bestimmte Services oder Konditionen sehen.
  </Step>

  <Step title="Abo-Pläne erstellen">
    Öffne **Abo-Pläne** in der linken Navigation und klicke auf **+Neu**. Konfiguriere unter **Allgemeine Informationen** Preis, Laufzeit, Kündigungsbedingungen und automatische Verlängerung.

    Verknüpfe den Plan mit einer Community: Abonnent:innen werden automatisch hinzugefügt und bei Ablauf wieder entfernt. Füge optional Benefits hinzu, um die Vorteile des Plans sichtbar zu machen.

    <Tip>
      Pro Plan kannst du eine individuelle Widerrufsfrist konfigurieren. Innerhalb dieser Frist können Kund:innen zwischen sofortigem Widerruf (mit anteiliger Rückerstattung) und Kündigung zum Laufzeitende wählen.
    </Tip>
  </Step>

  <Step title="Rechnungsstellung konfigurieren">
    Aktiviere unter **Account Einstellungen** > **Online-Zahlung** die automatisierte Zahlungsabwicklung. Danach verwaltet anny Rechnungen, Zahlungseingänge und wiederkehrende Abbuchungen automatisch. Mehr Details findest du unter [Online-Zahlung & Gebühren](/online-payments).
  </Step>

  <Step title="Buchungsseite überprüfen">
    Öffne deine Buchungsseite im Browser und teste den gesamten Flow: Ressource finden, Service auswählen, buchen. Prüfe, dass Community-geschützte Bereiche nur nach Anmeldung sichtbar sind.
  </Step>
</Steps>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Coworking-Space mit Flex-Desks, Meetingräumen und Monatsabo">
    <Steps>
      <Step title="Ressourcenstruktur">
        * Ressource Open Space mit 20 Child-Ressourcen (Desk 1 bis Desk 20)
        * Ressource Meetingraum A (Einzelverfügbar)
        * Ressource Meetingraum B (Einzelverfügbar)
      </Step>

      <Step title="Services">
        * Open Space: Tagespass (8h, 25 Euro) und Halbtagespass (4h, 15 Euro)
        * Meetingräume: Stundenweise (ab 1h, 30 Euro/h)
      </Step>

      <Step title="Community und Abo-Plan">
        * Community Members mit exklusivem Service Meetingraum Members (20 Euro/h statt 30 Euro/h)
        * Abo-Plan Flex Membership (89 Euro/Monat, monatlich kündbar, verknüpft mit Community Members)
      </Step>

      <Step title="Ergebnis">
        Mitglieder zahlen monatlich 89 Euro, erhalten automatisch Zugang zur Members-Community und buchen Meetingräume zum Vorzugspreis. Nicht-Mitglieder buchen Desks zum regulären Tagespreis.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Premium-Coworking mit dediziertem Büro und Sammelrechnung">
    <Steps>
      <Step title="Ressourcenstruktur">
        * Ressource Büro 3. OG (1 feste Einheit)
        * Ressource Gemeinschaftsfläche mit 10 Child-Ressourcen (Platz 1 bis 10)
      </Step>

      <Step title="Services">
        * Büro: Monatsmiete (fest, 950 Euro/Monat)
        * Gemeinschaftsfläche: Tagespass (flexibel, 20 Euro/Tag)
      </Step>

      <Step title="Community und Abo-Plan">
        * Community Premium mit Sichtbarkeit auf die Gemeinschaftsfläche
        * Abo-Plan Premium Office (950 Euro/Monat, automatische Verlängerung, verknüpft mit Community Premium)
        * [Kundensalden](/customer-balances-and-collective-invoices) aktiviert: alle Buchungen eines Unternehmens werden monatlich gesammelt abgerechnet
      </Step>

      <Step title="Ergebnis">
        Das Unternehmen erhält ein festes Büro, Mitarbeitende buchen zusätzlich Gemeinschaftsplätze. Am Monatsende konsolidiert anny alles in einer Sammelrechnung.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<Columns>
  <Column>
    <Card title="Karten (interaktive Lagepläne)">
      Visualisiere Räume und Arbeitsplätze auf einem interaktiven Lageplan. Mitglieder wählen ihren Platz visuell aus und buchen direkt von der Karte.

      [Erfahre hier mehr](/maps-and-floor-plans)
    </Card>
  </Column>

  <Column>
    <Card title="Smart-Lock-Integrationen">
      Vergib automatisch digitale Zugangsberechtigungen für gebuchte Zeiträume, damit Kund:innen Zugang erhalten ohne Rezeption.

      [Erfahre hier mehr](/smart-locks-overview)
    </Card>
  </Column>

  <Column>
    <Card title="Abo-Management">
      Verwalte bestehende Abos zentral im Adminbereich: Anfragen bearbeiten, Benachrichtigungen steuern, Kündigungen und Verlängerungen im Blick behalten.

      [Erfahre hier mehr](/subscriptions-and-memberships)
    </Card>
  </Column>

  <Column>
    <Card title="Kundensalden & Sammelrechnungen">
      Sammle Rechnungsentwürfe pro Kund:in oder Unternehmen auf einem offenen Saldo und konsolidiere sie am Periodenende zu einer Sammelrechnung. 

      [Erfahre hier mehr](/customer-balances-and-collective-invoices)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Welche Zahlungsmethoden stehen für Abos zur Verfügung?">
    Für Abos können Kund:innen SEPA-Lastschrift, Kreditkarte, Apple Pay und Google Pay nutzen. Apple Pay und Google Pay stehen nur auf Mobilgeräten zur Verfügung. Für Abos in CHF sind Kreditkarte und PayPal verfügbar (TWINT unterstützt keine wiederkehrenden Zahlungen).
  </Accordion>

  <Accordion title="Können Mitglieder ein Abo ohne Login abschließen?">
    Ja. Pro Abo-Plan kannst du konfigurieren, ob ein Login erforderlich ist. Ist der Gast-Abschluss aktiviert, geben Kund:innen ihre Daten direkt im Checkout an und können das Abo nachträglich durch eine Registrierung ihrem Account zuordnen.
  </Accordion>

  <Accordion title="Kann ein Abo zu einem späteren Zeitpunkt starten?">
    Ja. Wenn du den zukünftigen Start für einen Plan aktivierst, können Kund:innen beim Abschluss ein Startdatum in der Zukunft wählen. Das Abo beginnt erst zum gewählten Zeitpunkt.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Coworking und Desk Sharing in anny?">
    Coworking richtet sich an Anbieter:innen, die Plätze an externe Kund:innen vermieten (öffentliche Buchungsseite, Abos, Online-Zahlung). [Desk Sharing](/getting-started-desk-sharing) richtet sich an Unternehmen, die interne Arbeitsplätze für eigene Mitarbeitende verwalten (geschlossene Community, SSO, keine Bezahlung).
  </Accordion>

  <Accordion title="Wie werden Mitglieder automatisch einer Community zugewiesen?">
    Verknüpfe einen Abo-Plan mit einer Community. Sobald eine Person den Plan abschließt, wird sie automatisch der Community hinzugefügt. Bei Ablauf oder Kündigung des Abos wird sie automatisch wieder entfernt.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Coworking vs. Desk Sharing: Coworking = externe Kund:innen, öffentliche Buchungsseite, Abos mit Online-Zahlung. Desk Sharing = interne Mitarbeitende, geschlossene Community, SSO, keine Bezahlung. Vertiefender Artikel: /getting-started-desk-sharing
> * Abo-Pläne erfordern mindestens Essential-Plan UND aktivierte Online-Zahlung (Account Einstellungen > Features > Abos und Mitgliedschaften + Account Einstellungen > Online-Zahlung)
> * Zahlungsmethoden für Abos: SEPA, Kreditkarte, Apple Pay, Google Pay. TWINT nur für Einmalbuchungen, nicht für Abos. CHF-Abos: Kreditkarte und PayPal.
> * Widerrufsfrist ist plan-spezifisch, nicht global. Nur relevant wenn aktiv gesetzt.
> * Gast-Abo-Abschluss: Pro Plan konfigurierbar. Nachträgliche Registrierung über Claim-Prozess.
> * Zukünftiger Abo-Start: Pro Plan konfigurierbar. Ohne Aktivierung startet Abo immer sofort.
> * Externe Community-Links: Max. 3 Links pro Community (Name, URL, Icon). Nur Web, nicht in der App.
> * Child-Ressourcen: UI-Pfad Ressource > Verfügbarkeit > Child-Ressourcen hinzufügen. Feature-Name ist Mehrfach verfügbar mit Zuweisung.
> * Für Kundensalden/Sammelrechnungen ist der Business-Plan erforderlich, nicht Essential.


# Los Geht's - Desk Sharing
Source: https://docs.anny.co/getting-started-desk-sharing

Richte Desk Sharing mit anny ein: Arbeitsplätze, Wochenplaner, Communities und SSO für dein Team.

Mit diesem Guide richtest du dein hybrides Büro in anny ein. Du lernst, wie du Arbeitsplätze und Meetingräume als buchbare Ressourcen anlegst, dein Team über Communities und SSO anbindest und den Wochenplaner als zentrales Buchungstool für Mitarbeitende aktivierst.

## Desk Sharing im anny Kontext denken

Beim Desk Sharing bildet anny die physische Bürostruktur digital ab. Das zentrale Prinzip: Jeder Raum ist eine **Ressource**, jeder einzelne Arbeitsplatz darin eine **Child-Ressource**.

| anny Konzept | Bedeutung im Desk Sharing |
| - | - |
| Ressource | Ein Raum, eine Etage oder ein Bereich (z. B. "Open Space 1. OG") |
| Child-Ressource | Ein einzelner Arbeitsplatz innerhalb des Raums (z. B. "Platz 1.001") |
| Buchungsoption | Definiert, wie gebucht wird: Tagesbuchung für Desks, Flex-Buchung für Meetingräume |
| Community | Steuert, wer welche Ressourcen sehen und buchen darf |
| Wochenplaner | Herzstück für Mitarbeitende: Favoriten setzen und die Woche in wenigen Klicks planen |
| Karte | Interaktiver Lageplan, auf dem Mitarbeitende Plätze direkt buchen und Kolleg:innen finden |

Dein Team bucht über den **Buchungsbereich** (Wochenplaner, Entdecken, Karten). Du verwaltest alles im **Adminbereich** (Ressourcen, Buchungen, Dashboard).

## Entscheidungshilfen: Wann nutze ich was?

### Wann Flex Desk und wann Fix Desk?

| Kriterium | Flex Desk | Fix Desk |
| - | - | - |
| Platzzuweisung | Mitarbeitende wählen täglich frei | Fester Platz pro Person |
| Buchungsoption | Tagesbuchung, offen für alle | Tagesbuchung, auf bestimmte Community beschränkt |
| Typischer Einsatz | Hybride Teams, die 2-3 Tage im Büro sind | Mitarbeitende mit täglicher Präsenzpflicht |
| Beispiel | Marketing-Team bucht je nach Bedarf | Geschäftsführung hat festen Platz |

**Faustregel:** Starte mit Flex Desks für alle und richte Fix Desks nur für Teams ein, die einen festen Platz benötigen.

<Info>
  Für diesen Use Case aktivierst du unter **Account-Einstellungen** → **Features**: **Mehrfachverfügbarkeit mit Zuweisung**, **Communities**, **Globale Suche**. Karten und Check-In sind optional, aber empfohlen. **Child-Ressourcen** brauchen **Mehrfachverfügbarkeit mit Zuweisung**. **Mehrfachverfügbarkeit von Ressourcen** setzt nur eine Anzahl auf einer Ressource und legt keine einzelnen Desks an.
</Info>

Folgende Features spielen in diesem Use Case zusammen:

| Feature | Wofür wird es benötigt? | Vorher zu konfigurieren? |
| - | - | - |
| **Mehrfachverfügbarkeit mit Zuweisung** | Ermöglicht **Child-Ressourcen** (einzelne Arbeitsplätze innerhalb eines Raums) | Ja, unter Features aktivieren |
| Communities | Steuert Sichtbarkeit und Zugang zu Ressourcen pro Team/Standort | Ja, nach Ressourcen anlegen |
| SSO (Microsoft/Google) | Mitarbeitende melden sich mit ihrem Unternehmens-Login an, ohne extra Account | Ja, IT muss SSO-Verbindung einrichten |
| Karten | Interaktive Lagepläne für die visuelle Platzauswahl | Nein, aber empfohlen |
| Globale Suche | Mitarbeitende können Kolleg:innen und Räume über die Suchleiste finden | Ja, unter Features aktivieren |

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressourcenstruktur aufbauen">
    Öffne im Adminbereich den Menüpunkt **Ressourcen** und klicke auf **Neu+**.

    1. Lege einen Raum oder Bereich als Ressource an (z. B. "Open Space 1. OG").
    2. Füge ein Bild, eine Beschreibung und Eigenschaften hinzu (Etage, Gebäude, Kapazität, Ausstattung).
    3. Wechsle zum Reiter **Verfügbarkeit** und aktiviere den Toggle **Child-Ressource**. Füge anschließend die einzelnen Arbeitsplätze als Child-Ressourcen hinzu.

    <Tip>
      Verwende eine klare Namenskonvention: Bei großen Unternehmen z. B. "G1.1.001" (Gebäude.Etage.Platz), bei kleineren "Open Space, Platz 3".
    </Tip>
  </Step>

  <Step title="Buchungsoptionen definieren">
    Öffne die Ressource und wechsle zum Reiter **Buchungsoption**. Klicke auf **+Hinzufügen** und **+Neu**.

    Empfohlene Einstellung für Arbeitsplätze:

    * **Name:** Tagesbuchung
    * **Zeitraum:** Feste Dauer, 1 Tag
    * **Buchungsintervall:** 1 Tag
    * **Vorlaufzeit:** -8 Stunden (sonst ist der heutige Tag nach Tagesbeginn nicht mehr buchbar)
    * **Vorausbuchungszeitraum:** 7-14 Tage
    * **Alle Buchungen automatisch annehmen:** Aktiviert
    * **Wiederkehrende Buchungen erlauben:** Optional (z. B. für feste Bürotage)

    <Tip>
      Buchungsoptionen liegen zentral im Account. Erstelle eine Tagesbuchung einmal und verknüpfe sie mit allen Arbeitsplatz-Ressourcen. **-8 Stunden Vorlaufzeit** hält den heutigen Tag nach dem Start noch 8 Stunden offen. Details: [Buchungsoption](/configure-booking-option).
    </Tip>
  </Step>

  <Step title="Community einrichten">
    Öffne im Adminbereich **Communities** und erstelle eine neue Community (z. B. "Unternehmen Alle").

    1. Verknüpfe die Ressourcen, die für diese Community sichtbar sein sollen.
    2. Setze die Sichtbarkeit auf **Sichtbar und buchbar für Mitglieder**.
    3. Füge Mitglieder hinzu: Manuell per E-Mail oder automatisch über SSO und Attribute Mapping.

    Für unterschiedliche Teams oder Standorte: Lege separate Communities an (z. B. "Standort Berlin", "Management").

    <Note>
      Soll ein Team die Buchungen eines anderen Teams sehen, ohne selbst buchen zu können? Nutze die Rolle **Beobachter** in den Community-Einstellungen.
    </Note>
  </Step>

  <Step title="SSO konfigurieren">
    Öffne **Einstellungen > Sicherheit > Single Sign-On** und richte die Verbindung zu eurem Identity Provider ein (Microsoft Entra ID oder Google Workspace).

    1. Hinterlege die Metadaten-URL.
    2. Generiere den Wayfless-Link für die direkte Weiterleitung zu anny.
    3. Richte optional Attribute Mapping ein, damit Mitarbeitende automatisch der richtigen Community zugewiesen werden.

    Dein Team meldet sich dann mit dem Unternehmens-Login an. Kein separater Account nötig.
  </Step>

  <Step title="Karten und Lagepläne anlegen (empfohlen)">
    Öffne im Adminbereich **Karten** und lade einen Grundriss hoch.

    1. Platziere Objekte (Tische, Räume) auf dem Plan.
    2. Verbinde jedes Objekt mit der entsprechenden Child-Ressource.
    3. Mitarbeitende sehen in der Kartenansicht, welche Plätze frei sind (grün) und wo Kolleg:innen sitzen.

    <Tip>
      Trainiere einen Admin mit Basic-Kartenkenntnissen, damit Tische bei Umzügen schnell neu angeordnet werden können.
    </Tip>
  </Step>
</Steps>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Flex Desk im Open Space (10 Arbeitsplätze)">
    <Steps>
      <Step title="Ressource anlegen">
        Erstelle die Ressource "Open Space 1. OG" mit Bild und Eigenschaften (Etage: 1, Kapazität: 10, Ausstattung: Monitor, Dockingstation).
      </Step>

      <Step title="Child-Ressourcen hinzufügen">
        Stelle unter **Verfügbarkeit** den Typ auf **Child Ressourcen** und füge 10 Arbeitsplätze hinzu ("Platz 1.001" bis "Platz 1.010").
      </Step>

      <Step title="Buchungsoption verknüpfen">
        Verknüpfe die zentrale Buchungsoption "Tagesbuchung" (Feste Dauer: 1 Tag, Vorlaufzeit: -8 Stunden, Vorausbuchungszeitraum: 14 Tage).
      </Step>

      <Step title="Community zuweisen">
        Weise die Ressource der Community "Unternehmen Alle" zu. Alle Mitarbeitenden mit SSO-Zugang sehen und buchen die Plätze.
      </Step>

      <Step title="Auf der Karte platzieren">
        Öffne den Grundriss "1. OG" und verbinde die 10 Tisch-Objekte mit den Child-Ressourcen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meetingraum mit Flex-Buchung und Jour-Fixe">
    <Steps>
      <Step title="Ressource anlegen">
        Erstelle die Ressource "Meetingraum Alster" mit Eigenschaften (Kapazität: 8, Ausstattung: Whiteboard, Videokonferenz).
      </Step>

      <Step title="Buchungsoption erstellen">
        Erstelle eine neue Buchungsoption "Flex-Buchung" mit: Flexible Dauer (Min: 30 Minuten, Max: 4 Stunden), Buchungsintervall: 30 Minuten, Wiederkehrende Buchungen erlauben: Aktiviert.
      </Step>

      <Step title="Wiederkehrende Buchung für Jour-Fixe">
        Mitarbeitende buchen über den Wochenplaner eine wiederkehrende Buchung (z. B. jeden Dienstag 10:00-11:00 Uhr). Die Ressource wird automatisch für alle folgenden Termine geblockt.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<Columns>
  <Column>
    <Card title="Globale Buchungsregeln">
      Begrenze die maximale Anzahl der Buchungen pro Tag oder in die Zukunft, damit Mitarbeitende nicht zu viele Plätze auf einmal blockieren.

      [Erfahre hier mehr](/booking-rules)
    </Card>
  </Column>

  <Column>
    <Card title="Outlook Add-In">
      Buche Meetingräume direkt aus Outlook heraus und lade externe Besucher:innen zu Terminen ein, ohne die anny Oberfläche öffnen zu müssen.

      [Erfahre hier mehr](/outlook-add-in)
    </Card>
  </Column>
</Columns>

<Columns>
  <Column>
    <Card title="Karten & interaktive Lagepläne">
      Visualisiere Räume und Arbeitsplätze auf interaktiven Lageplänen. Mitarbeitende sehen freie Plätze und buchen direkt über die Karte.

      [Erfahre hier mehr](/maps-and-floor-plans)
    </Card>
  </Column>

  <Column>
    <Card title="Communities">
      Steuere Sichtbarkeit und Zugang zu Ressourcen pro Team, Standort oder Abteilung. Automatische Zuweisung über SSO und Attribute Mapping.

      [Erfahre hier mehr](/communities)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Wie schnell kann ich Desk Sharing mit anny einrichten?">
    In der Regel benötigen Unternehmen 4-10 Tage für die vollständige Einrichtung und Implementierung, abhängig von der Anzahl der Standorte und Ressourcen.
  </Accordion>

  <Accordion title="Können Mitarbeitende auch über die mobile App oder MS Teams buchen?">
    Ja. Neben dem Wochenplaner im Browser können Mitarbeitende über die anny App (iOS/Android), die MS Teams App und das Outlook Add-In buchen.
  </Accordion>

  <Accordion title="Wie verhindere ich, dass einzelne Personen zu viele Plätze blockieren?">
    Nutze die globalen Buchungsregeln unter **Einstellungen > Buchungsregeln**. Dort kannst du z. B. festlegen, dass maximal 1 Buchung pro Tag und maximal 10 Buchungen in die Zukunft erlaubt sind.
  </Accordion>

  <Accordion title="Kann ich Buchungen nachträglich bearbeiten lassen?">
    Ja. Wenn du die Funktion in der Buchungsoption aktivierst, können Mitarbeitende den Arbeitsplatz wechseln oder Datum und Uhrzeit anpassen. Preisänderungen bei kostenpflichtigen Buchungen werden automatisch verrechnet.
  </Accordion>

  <Accordion title="Wie schütze ich personenbezogene Buchungsdaten (DSGVO)?">
    Unter **Einstellungen > Datenschutz** kannst du Anonymisierungsfristen festlegen. Für Desk Sharing empfehlen wir eine Anonymisierung nach 2-4 Wochen: Buchungsdaten bleiben erhalten, personenbezogene Daten (Namen, E-Mails) werden entfernt.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> **Abgrenzung Desk Sharing vs. Coworking:** Desk Sharing richtet sich an Unternehmen, die interne Arbeitsplätze für eigene Mitarbeitende verwalten (geschlossene Community, SSO, keine Bezahlung). Coworking richtet sich an Anbieter, die Plätze an externe Kund:innen vermieten (öffentliche Buchungsseite, Abos, Online-Zahlung). Für Coworking-Setups siehe den Guide "Los Geht's – Coworking".
>
> **Exakte UI-Pfade:**
>
> * Buchungsregeln: Adminbereich > Einstellungen > Buchungsregeln
> * Features aktivieren: Adminbereich > Einstellungen > Features
> * Community Auto-Join: Community > Einstellungen > Mitglieder > SSO-Zuweisung (erfordert Attribute Mapping in Microsoft Entra ID oder Google Workspace)
> * Anonymisierung: Adminbereich > Einstellungen > Datenschutz > Löschfristen
>
> **Standardwerte Tagesbuchung (Hybrid Work):** Feste Dauer: 1 Tag, Buchungsintervall: 1 Tag, Vorlaufzeit: -8 Stunden, Vorausbuchungszeitraum: 7-14 Tage, Wiederkehrende Buchungen: optional, Alle Buchungen automatisch annehmen: Ja. Onboarding interner Arbeitsplätze setzt `lead_time` auf -480 Minuten.
>
> **Verwandte Artikel für Anschlussfragen:**
>
> * Communities und Auto-Join: /communities
> * Buchungsoption im Detail: /buchungsoption-konfigurieren
> * SSO einrichten: /microsoft-saml-sso oder /google-workspace-sso
> * Karten erstellen: /maps-and-floor-plans
> * Outlook Integration: /m365-workspace
> * Wiederkehrende Buchungen: /wiederkehrende-buchungen


# Los Geht's - Tauchschulen
Source: https://docs.anny.co/getting-started-dive-schools

Richte deine Tauchschule in anny ein: Kurse, Mitgliedschaften, Zahlungen und Buchungsseite an einem Ort.

Dieser Guide zeigt dir, wie du deine Tauchschule mit anny abbildest. Du kombinierst Ressourcen, Buchungsoptionen, Communities und Abo-Pläne, sodass deine Kund:innen Kurse und Tauchgänge eigenständig online buchen und bezahlen können.

## Tauchschulen im anny Kontext denken

Bei einer Tauchschule bildet anny dein gesamtes Kursangebot digital ab. Das zentrale Prinzip: Jedes buchbare Angebot ist eine **Ressource**, die Buchungsbedingungen (Dauer, Preis, Teilnehmerzahl) definierst du über eine **Buchungsoption**.

| anny Konzept | Bedeutung für Tauchschulen |
| - | - |
| Ressource | Ein Kurs, ein Tauchgang oder ein Event (z.B. "Open Water Diver Kurs", "Schnuppertauchen") |
| Buchungsoption | Definiert Dauer, Preis und Kapazität einer Ressource (z.B. "4 Tage, 399 €, max. 6 Teilnehmer") |
| Community | Geschlossener Bereich für Mitglieder mit Sonderkonditionen (z.B. "Vereinsmitglieder") |
| Abo-Plan | Mitgliedschaft in deiner Tauchschule (z.B. "Gold-Mitgliedschaft" mit Zugang zur Members-Community) |
| Buchungspaket | Vergünstigtes Kontingent (z.B. "10er-Karte Pool-Training") |

Deine Kund:innen buchen über den **Buchungsbereich** (Buchungsseite, Entdecken-Seite). Du verwaltest alles im **Adminbereich** (Ressourcen, Buchungen, Rechnungen, Dashboard).

## Entscheidungshilfen: Wann nutze ich was?

### Wann Buchungsserie und wann Einzeltermine?

| Kriterium | Buchungsserie | Einzeltermine |
| - | - | - |
| Terminstruktur | Mehrere zusammenhängende Termine als Paket | Einzelne, unabhängige Termine |
| Buchungsverhalten | Kund:innen buchen alle Termine auf einmal | Kund:innen buchen jeden Termin separat |
| Beispiel | Open Water Diver Kurs (4 aufeinanderfolgende Tage) | Schnuppertauchen (einzelner Termin) |
| Abrechnung | Gesamtpreis für die Serie | Preis pro Einzelbuchung |

**Faustregel:** Besteht dein Angebot aus mehreren Terminen, die aufeinander aufbauen und zusammen gebucht werden sollen, nutze eine Buchungsserie. Für eigenständige Einzel-Events reichen normale Einzeltermine.

<Info>
  Aktiviere vorab folgende Features unter **Einstellungen** → **Features**, um alle Bausteine dieses Guides nutzen zu können:

  * Aktiviere **Zahlungsabwicklung & Rechnungsstellung**, um Online-Zahlungen zu akzeptieren und Rechnungen automatisch zu erstellen.
  * Aktiviere **Communities**, um geschützte Mitgliederbereiche mit eigener Buchungsseite einzurichten.
  * Aktiviere **Abos und Mitgliedschaften**, um wiederkehrende Mitgliedschafts-Pläne anzubieten.
</Info>

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressourcen anlegen">
    Öffne aus der Menüleiste **Ressourcen** und klicke auf **Neu+**. Erstelle für jedes buchbare Angebot eine eigene Ressource, z.B.:

    * "Open Water Diver Kurs"
    * "Schnuppertauchen"
    * "Pool-Training"
    * "Advanced Open Water Kurs"

    Vergib einen aussagekräftigen Namen, füge eine Beschreibung und ein Bild hinzu. Über **Gruppen & Kategorien** kannst du deine Ressourcen thematisch sortieren (z.B. "Kurse", "Erlebnisse", "Training").
  </Step>

  <Step title="Buchungsoptionen konfigurieren">
    Öffne eine Ressource und wechsle zu **Buchungsoptionen**. Klicke auf **Neu+** und lege fest:

    * **Dauer**: Feste Dauer (z.B. 2 Stunden für Schnuppertauchen) oder flexibel
    * **Preis**: Festpreis pro Buchung (z.B. 79 € für Schnuppertauchen)
    * **Kapazität**: Maximale Teilnehmerzahl pro Termin (z.B. 6 Personen)
    * **Modus**: Wähle "Serie" für mehrtägige Kurse oder "Standard" für Einzeltermine

    <Tip>
      Für Kurse mit mehreren aufeinanderfolgenden Terminen nutze den Modus "Serie". Du verwaltest die einzelnen Termine dann zentral in der Ressourcen-Verfügbarkeit und Kund:innen buchen alle Termine als Paket.
    </Tip>
  </Step>

  <Step title="Zeitpläne und Termine einrichten">
    Öffne die Ressource und wechsle zu **Verfügbarkeit** → **Zeitpläne**. Lege fest, wann deine Kurse und Tauchgänge stattfinden:

    * Für regelmäßige Angebote (z.B. Pool-Training jeden Mittwoch): Erstelle einen wiederkehrenden Zeitplan.
    * Für einzelne Kurstermine: Erstelle individuelle verfügbare Termine in der Verfügbarkeit.
    * Für Serien: Erstelle die einzelnen Termine und weise sie einer Serie zu (z.B. "OWD Kurs August 2026").
  </Step>

  <Step title="Zahlungsabwicklung einrichten">
    Öffne **Einstellungen** → **Zahlungsabwicklung** und verbinde dein Stripe-Konto über **Stripe Connect**. Nach der Verifizierung können deine Kund:innen direkt bei der Buchung online bezahlen. Du kannst pro Buchungsoption festlegen, ob Online-Zahlung, Zahlung vor Ort oder Zahlung auf Rechnung möglich ist.
  </Step>

  <Step title="Communities und Abo-Pläne einrichten (optional)">
    Wenn du Mitgliedschaften anbietest:

    1. Öffne **Einstellungen** → **Features** und aktiviere **Communities** und **Abos und Mitgliedschaften**.
    2. Erstelle eine Community (z.B. "Tauchclub-Mitglieder") und weise ihr exklusive Ressourcen oder vergünstigte Buchungsoptionen zu.
    3. Erstelle einen Abo-Plan (z.B. "Silber-Mitgliedschaft: 29 €/Monat") und verknüpfe ihn mit der Community. Kund:innen werden bei Abo-Abschluss automatisch der Community zugewiesen.

    Du kannst Mitglieder auch manuell per E-Mail-Adresse zur Community einladen.
  </Step>

  <Step title="Buchungsseite veröffentlichen">
    Deine Buchungsseite ist automatisch unter deiner anny-URL erreichbar. Unter **Einstellungen** → **Buchungsseite** kannst du das Layout anpassen, dein Logo hochladen und Farben konfigurieren. Teile den Link mit deinen Kund:innen oder bette die Buchungsseite in deine Website ein.
  </Step>
</Steps>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Tauchschule mit Kursangebot und Mitgliedschaft">
    <Steps>
      <Step title="Ressourcen anlegen">
        Erstelle drei Ressourcen: "Open Water Diver Kurs", "Schnuppertauchen" und "Pool-Training". Ordne sie in die Kategorien "Kurse" und "Erlebnisse" ein.
      </Step>

      <Step title="Buchungsoptionen definieren">
        * OWD Kurs: Modus "Serie", 4 Termine, 399 €, max. 6 Teilnehmer
        * Schnuppertauchen: Modus "Standard", feste Dauer 2h, 79 €, max. 4 Teilnehmer
        * Pool-Training: Modus "Standard", feste Dauer 1,5h, 25 € (15 € für Mitglieder)
      </Step>

      <Step title="Termine anlegen">
        * OWD Kurs: Erstelle 4 Termine (Sa + So, zwei Wochenenden) und weise sie der Serie "OWD August 2026" zu.
        * Schnuppertauchen: Wiederkehrender Zeitplan jeden Samstag 10:00 bis 12:00 Uhr.
        * Pool-Training: Wiederkehrender Zeitplan jeden Mittwoch 18:00 bis 19:30 Uhr.
      </Step>

      <Step title="Mitgliederbereich einrichten">
        Erstelle die Community "Tauchclub" und den Abo-Plan "Tauchclub-Mitgliedschaft" (29 €/Monat). Verknüpfe den Abo-Plan mit der Community. Erstelle eine separate Buchungsoption für Pool-Training mit 15 € und beschränke sie auf die Community "Tauchclub".
      </Step>

      <Step title="Zahlung und Veröffentlichung">
        Verbinde Stripe Connect. Aktiviere Online-Zahlung für alle Buchungsoptionen. Veröffentliche die Buchungsseite und teile den Link.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Schnuppertauchen mit dynamischer Kapazität (Trainer:innen)">
    <Steps>
      <Step title="Ressource erstellen">
        Erstelle die Ressource "Schnuppertauchen" mit einer Buchungsoption: feste Dauer 2,5h, 89 €, max. 4 Teilnehmer pro Trainer.
      </Step>

      <Step title="Zweiten Trainer als On-Demand Ressource anlegen">
        Erstelle eine zweite Ressource für deinen zusätzlichen Trainer (z.B. "Trainer:in 2"). Aktiviere das Feature **Dynamische Kapazitätsplanung** und verknüpfe den zweiten Trainer als On-Demand Ressource mit "Schnuppertauchen".
      </Step>

      <Step title="Zeitplan einrichten">
        Richte einen wiederkehrenden Zeitplan ein (z.B. jeden Samstag und Sonntag um 9:00 Uhr). Sobald die 4 Plätze beim ersten Trainer belegt sind, stellt anny automatisch 4 weitere Plätze über den zweiten Trainer bereit.
      </Step>

      <Step title="Zahlung aktivieren">
        Verbinde Stripe Connect und aktiviere Online-Zahlung für die Buchungsoption. Kund:innen zahlen direkt bei der Buchung.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<Columns>
  <Column>
    <Card title="Buchungspakete">
      Biete vergünstigte Mehrfachtickets wie eine 10er-Karte an. Kund:innen kaufen ein Kontingent und lösen es bei jeder Buchung als Guthaben ein.

      [Erfahre hier mehr](/booking-codes)
    </Card>
  </Column>

  <Column>
    <Card title="Dynamische Kapazitätsplanung">
      Passe die Kapazität deiner Termine automatisch an die Nachfrage an. Bei hoher Auslastung stellt anny zusätzliche Ressourcen bereit.

      [Erfahre hier mehr](/dynamic-capacity-planning)
    </Card>
  </Column>
</Columns>

<Columns>
  <Column>
    <Card title="Zertifikate">
      Erstelle automatisch Zertifikate nach bestandenem Kurs. Der Tauchschein wird inklusive Teilnehmerdaten direkt per E-Mail versendet.

      [Erfahre hier mehr](/certificates)
    </Card>
  </Column>

  <Column>
    <Card title="Buchungsseite einbetten">
      Bette deine anny-Buchungsseite direkt in deine eigene Website ein. Kund:innen buchen Kurse und Tauchgänge, ohne deine Seite zu verlassen.

      [Erfahre hier mehr](/embed-booking-page)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich unterschiedliche Preise für Mitglieder und Nicht-Mitglieder anbieten?">
    Ja. Erstelle eine Community für deine Mitglieder und lege pro Ressource eine separate Buchungsoption mit dem vergünstigten Mitgliederpreis an. Beschränke diese Buchungsoption auf die Community. Nicht-Mitglieder sehen nur den regulären Preis.
  </Accordion>

  <Accordion title="Wie bilde ich einen mehrtägigen Tauchkurs ab?">
    Nutze den Modus "Serie" in der Buchungsoption. Erstelle die einzelnen Kurstermine in der Ressourcen-Verfügbarkeit und weise sie einer Serie zu. Kund:innen buchen dann alle Termine als Gesamtpaket.
  </Accordion>

  <Accordion title="Können Kund:innen einzelne Restplätze in einem laufenden Kurs buchen?">
    Grundsätzlich werden Serien als Gesamtpaket gebucht. Wenn du einzelne Restplätze anbieten möchtest, erstelle zusätzliche Einzeltermine als separate Ressource oder Buchungsoption neben der Serie.
  </Accordion>

  <Accordion title="Wie funktionieren die Abo-Pläne für meine Mitgliedschaften?">
    Erstelle einen Abo-Plan mit dem gewünschten Preis und Intervall (monatlich, jährlich etc.) und verknüpfe ihn mit einer Community. Kund:innen können das Abo auf deiner Buchungsseite selbst abschließen und erhalten automatisch Zugang zur Community mit allen Mitglieder-Vorteilen.
  </Accordion>

  <Accordion title="Brauche ich Online-Zahlung oder kann ich auch auf Rechnung arbeiten?">
    Beides ist möglich. Du kannst pro Buchungsoption festlegen, ob Online-Zahlung (Stripe), Zahlung auf Rechnung oder Zahlung vor Ort akzeptiert wird. Für Mitgliedschaften mit automatischer Abrechnung empfiehlt sich Online-Zahlung.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Tauchschulen-Guide kombiniert: Ressourcen + Buchungsoptionen (Serie/Standard) + Communities + Abo-Pläne + Buchungspakete + Dynamische Kapazitätsplanung.
> * Mehrtägige Zertifizierungskurse (OWD, AOWD): immer Buchungsserie (Modus "Serie" in Buchungsoption, Termine in Ressourcen-Verfügbarkeit zuweisen).
> * Einzelangebote (Schnuppertauchen, Fun Dives): Modus "Standard" mit Einzelterminen oder wiederkehrendem Zeitplan.
> * Mitgliederpreise: Separate Buchungsoption mit Community-Beschränkung, nicht über Rabattcodes.
> * Dynamische Kapazitätsplanung: Nutze On-Demand Ressourcen (z.B. zusätzliche Trainer), um Kapazität bei hoher Nachfrage automatisch zu erweitern.
> * Abgrenzung zu "Los Geht's - Kurse": Tauchschulen nutzen zusätzlich Mitgliedschaften, Buchungspakete und dynamische Kapazitätsplanung. Für reine Kurs-Serienlogik auf den Kurse-Guide verweisen.
> * Verwandte Artikel: /booking-series (Serien-Details), /communities (Community-Setup), /subscriptions-and-memberships (Abo-Details), /booking-codes (Buchungspakete & Codes), /dynamic-capacity-planning (On-Demand Ressourcen), /certificates (Tauchschein-Zertifikate), /embed-booking-page (Widget-Einbettung).


# Los Geht's - Events
Source: https://docs.anny.co/getting-started-events

Richte Events in anny ein, damit Veranstaltungstermine, Kapazitäten und Zusatzressourcen sauber zusammenpassen.

Mit Events bildest du in anny Veranstaltungen ab, die einen klaren Event-Charakter haben: ein einzelner Termin oder wenige konkrete Termine, feste Kapazitäten und ein eindeutiger Anlass. So steuerst du Buchung, Raumplanung und Teilnehmerverwaltung zentral an einer Stelle und sorgst dafür, dass Kund:innen genau die Veranstaltung sehen, die tatsächlich verfügbar ist.

<Info>
  Für die Event-Einrichtung aktivierst du **Mehrfachverfügbarkeit von Ressourcen** unter **Account-Einstellungen** → **Features**. Damit nimmt ein Termin mehrere Tickets an. Das sind nicht **Child-Ressourcen** — die brauchen **Mehrfachverfügbarkeit mit Zuweisung**.
</Info>

## Events im anny Kontext denken

In anny bildet eine **Ressource** dein Event ab (z. B. "Afterwork Meetup"). Der zugehörige **Service bzw. die Buchungsoption** definiert das buchbare Ticket (z. B. "Eventticket"). Statt regelmäßiger Öffnungszeiten arbeitest du bei Events mit **verfügbaren Terminen**: ein fester Zeitslot pro Veranstaltungsdatum.

Das zentrale Prinzip: Pro verfügbarem Termin einer Ressource kannst du weitere Ressourcen als **bereitgestellte Ressourcen** verknüpfen (z. B. einen Veranstaltungsraum), die automatisch für diese Zeit geblockt werden.

| Dein Konzept | anny Baustein |
| - | - |
| Das Event selbst | Ressource |
| Das Ticket | Service / Buchungsoption |
| Das Veranstaltungsdatum | Verfügbarer Termin |
| Anzahl der Plätze | Verfügbare Anzahl (**Mehrfach verfügbar**) |
| Raum, Equipment, Personal | Bereitgestellte Ressourcen am Termin |

## Entscheidungshilfen: Wann nutze ich was?

### Events vs. Kurse

| Kriterium | Event | Kurs |
| - | - | - |
| Anzahl Termine | Einzelner oder wenige konkrete Termine | Wiederkehrende Sessions oder Terminreihen |
| Charakter | Veranstaltung mit klarem Anlass | Lern-, Trainings- oder Gruppenformat |
| Buchungslogik | Kund:innen buchen einen bestimmten Termin | Kund:innen buchen eine Serie oder Einzelsession |
| Typische Beispiele | Infoabend, Networking-Event, Webinar | Sprachkurs, Yogakurs, Workshop-Reihe |

**Faustregel:** Steht ein einzelner Anlass im Vordergrund, nutze ein Event. Steht eine wiederkehrende Struktur mit mehreren Sessions im Vordergrund, nutze einen [Kurs](/getting-started-courses).

| Feature | Wofür wird es benötigt? | Vorher zu konfigurieren? |
| - | - | - |
| **Mehrfachverfügbarkeit von Ressourcen** | Ermöglicht mehrere Buchungen (Tickets) pro Termin | Ja, unter **Account-Einstellungen** → **Features** aktivieren. Nicht **Child-Ressourcen**. |
| Bereitgestellte Ressourcen | Blockt Räume oder Equipment automatisch für den Event-Termin | Nein, direkt in den Termin-Einstellungen verfügbar |
| Warteliste (optional) | Benachrichtigt Kund:innen bei freien Plätzen eines ausgebuchten Events | Ja, unter Ressource > Verfügbarkeit aktivieren |
| Mindestteilnehmerzahl (optional) | Storniert einen Event-Termin automatisch, wenn zu wenig Anmeldungen vorliegen | Nein, direkt in den Termin-Einstellungen konfigurierbar |

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressourcenstruktur aufbauen">
    Lege dein Event als eigenständige Ressource an. Falls du einen Raum oder Equipment separat verwalten möchtest, lege diese ebenfalls als eigene Ressourcen an.

    Klicke dazu im linken Menü auf **Ressourcen** und oben rechts auf **+Neu**.
  </Step>

  <Step title="Service definieren">
    Öffne den Reiter **Buchungsoption** deiner Event-Ressource und erstelle eine Option (z. B. "Eventticket" oder "Teilnahme Workshop") mit **Dauer nach Zeitplan**.
  </Step>

  <Step title="Verfügbarkeit einrichten">
    Öffne den Reiter **Verfügbarkeit** der Event-Ressource.

    1. Stelle den Typ auf **Mehrfach verfügbar** und definiere bei **Verfügbare Anzahl** die Anzahl der verfügbaren Tickets (z. B. 15).
    2. Scrolle zu **Verfügbare Termine** und klicke auf **+ Verfügbaren Termin hinzufügen**.
    3. Lege unter dem Reiter **Allgemein** Datum und Uhrzeit deines Events fest.
  </Step>

  <Step title="Bereitgestellte Ressourcen verknüpfen (optional)">
    Öffne den Reiter **Einstellungen** des verfügbaren Termins. Unter **Bereitgestellte Ressourcen** verbindest du Räume, Equipment oder Personal, die für den Termin eingeplant und automatisch geblockt werden sollen.
  </Step>

  <Step title="Buchungsseite überprüfen">
    Schau dir die Darstellung auf deiner Buchungsseite an. Teste die Sichtbarkeit der verfügbaren Termine und den kompletten Buchungsvorgang.
  </Step>
</Steps>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Networking-Event mit Raumblockierung">
    **Ziel:** Du möchtest einen Netzwerkabend mit 80 Plätzen anbieten und den Veranstaltungsraum automatisch blocken.

    <Steps>
      <Step title="Ressourcen anlegen">
        Lege die Ressource **Afterwork Meetup** und die Ressource **Eventfläche Nord** an.
      </Step>

      <Step title="Service erstellen">
        Erstelle für die Ressource "Afterwork Meetup" den Service **Eventticket**.
      </Step>

      <Step title="Verfügbarkeit konfigurieren">
        Stelle die Verfügbarkeit auf **Mehrfach verfügbar** mit einer verfügbaren Anzahl von **80**. Füge einen verfügbaren Termin hinzu (z. B. Freitag, 18:00 bis 21:00 Uhr).
      </Step>

      <Step title="Raum verknüpfen">
        Öffne die **Einstellungen** des Termins und füge unter **Bereitgestellte Ressourcen** die Ressource "Eventfläche Nord" hinzu.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Webinar mit begrenzter Platzzahl und Mindestteilnehmerzahl">
    **Ziel:** Du möchtest ein Online-Event mit 50 Plätzen anbieten, das nur stattfindet, wenn sich mindestens 10 Personen anmelden.

    <Steps>
      <Step title="Ressource anlegen">
        Lege die Ressource **Webinar: Produktupdate Q3** an.
      </Step>

      <Step title="Service erstellen">
        Erstelle den Service **Teilnahme Webinar**.
      </Step>

      <Step title="Verfügbarkeit konfigurieren">
        Stelle auf **Mehrfach verfügbar** mit einer verfügbaren Anzahl von **50**. Füge den konkreten Webinar-Termin hinzu.
      </Step>

      <Step title="Mindestteilnehmerzahl setzen">
        Öffne die **Einstellungen** des Termins. Setze die Mindestteilnehmerzahl auf **10** und definiere eine Stornierungsfrist (z. B. 24 Stunden vor Beginn).
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<Columns>
  <Column>
    <Card title="Warteliste">
      Lass Kund:innen sich automatisch benachrichtigen, sobald bei einem ausgebuchten Event-Termin wieder ein Platz frei wird.

      [Erfahre hier mehr](/waitlist)
    </Card>
  </Column>

  <Column>
    <Card title="Zeitpläne & Termine">
      Verstehe den Unterschied zwischen regelmäßigen Zeitplänen und einzelnen verfügbaren Terminen für die Verfügbarkeitssteuerung.

      [Erfahre hier mehr](/schedules)
    </Card>
  </Column>
</Columns>

<Columns>
  <Column>
    <Card title="Check-In Terminal">
      Stelle QR-Code-Tickets für Event-Buchungen aus und ermögliche deinen Teilnehmenden einen unkomplizierten Check-in vor Ort am Terminal.

      [Erfahre hier mehr](/check-in-setup)
    </Card>
  </Column>

  <Column>
    <Card title="Personalisierung">
      Personalisiere das Ticket mit dem Namen der Person, die die Veranstaltung tatsächlich besucht.                                     

      [Erfahre hier mehr](/personalization)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Können Events mehrere Termine haben?">
    Ja. Du kannst mehrere konkrete Event-Termine unter **Verfügbarkeit** hinterlegen. Entscheidend ist, dass das Angebot inhaltlich als Veranstaltung gedacht ist und nicht als fortlaufender Kurs mit wiederkehrender Session-Logik.
  </Accordion>

  <Accordion title="Was passiert, wenn mein Event ausgebucht ist?">
    Sobald die verfügbare Anzahl erreicht ist, wird der Termin auf der Buchungsseite nicht mehr als buchbar angezeigt. Aktiviere die Warteliste, damit sich Kund:innen automatisch benachrichtigen lassen können, sobald ein Platz frei wird.
  </Accordion>

  <Accordion title="Kann ein Event automatisch abgesagt werden?">
    Ja. Wenn du eine Mindestteilnehmerzahl mit Stornierungsfrist hinterlegst, storniert anny den Termin automatisch, falls die Schwelle bis zur Frist nicht erreicht wird. Alle bereits angemeldeten Kund:innen werden benachrichtigt.
  </Accordion>

  <Accordion title="Warum wird mein Event auf der Buchungsseite nicht angezeigt?">
    Prüfe, ob der Termin unter **Verfügbarkeit** korrekt angelegt wurde und noch innerhalb der Buchungsregeln liegt. Auch eine erreichte Kapazitätsgrenze oder eine abgelaufene Buchungsfrist kann dazu führen, dass das Event nicht mehr sichtbar ist.
  </Accordion>

  <Accordion title="Sind einmalige Workshops eher Events oder Kurse?">
    Wenn der Workshop ein einzelner Termin mit Event-Charakter ist, passt ein Event-Setup. Wenn mehrere Sessions, aufeinander aufbauende Inhalte oder eine wiederkehrende Struktur im Vordergrund stehen, ist ein Kurs-Setup besser geeignet.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳


# Los Geht's - Raumbuchung
Source: https://docs.anny.co/getting-started-room-booking

Richte buchbare Räume ein und ermögliche externen Kund:innen die eigenständige Online-Buchung inkl. Zahlung.

Mit anny bildest du die Vermietung von Räumen vollständig digital ab: Kund:innen finden den passenden Raum, buchen online und erhalten automatisch Bestätigung, Rechnung und Zugang. Ob Business Center, Kulturstätte oder Tagungshaus, in diesem Guide richtest du alles Schritt für Schritt ein.

## Raumbuchung im anny Kontext denken

Bei der Raumbuchung ist jeder physische Raum eine eigene Ressource. Die Buchungsoption definiert, wie der Raum gebucht wird: stundenweise, halbtags oder ganztags, mit Preis und ggf. Staffelung. Kund:innen wählen auf der Buchungsseite zuerst den Raum und dann die gewünschte Buchungsoption (Resource-first Flow).

| Begriff aus dem Use Case | anny-Konzept |
| - | - |
| Meetingraum, Seminarraum, Saal | Ressource |
| Stundenweise / halbtags / ganztags buchen | Buchungsoption |
| Verfügbare Zeiten des Raums | Zeitplan |
| Catering, Beamer, Bestuhlung | Zusatzoption |
| Raumdetails abfragen (Personenanzahl, Zweck) | Eigene Formulare |
| AGB, Nutzungsordnung, Hausordnung | Rechtliche Dokumente |
| Gebäudeübersicht mit Räumen | Karte / Interaktiver Lageplan |

| Feature | Wofür wird es benötigt? | Vorher zu konfigurieren? |
| - | - | - |
| Zahlungsabwicklung & Rechnungsstellung | Online-Zahlung bei Buchung | Ja, Stripe Connect einrichten |
| Zusatzoptionen | Add-Ons, zusätzliche Räume oder Empfehlungen anbieten | Ja, unter Features aktivieren |
| Smart Availability | Teilbare Räume (z. B. Saal in zwei Hälften) | Ja, unter Features aktivieren |
| Karten & Interaktive Lagepläne | Räume visuell im Gebäudeplan zeigen | Ja, unter Features aktivieren |

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressource anlegen">
    Öffne in der Menüleiste **Ressourcen** und klicke auf **Neu**. Vergib einen Namen (z. B. "Konferenzraum Erdgeschoss"), hinterlege Kapazität, Ausstattung und ein Bild. Verwende Kategorien (z. B. "Seminarräume", "Veranstaltungssäle"), um mehrere Räume zu strukturieren.
  </Step>

  <Step title="Zeitplan erstellen">
    Navigiere zu **Ressource → Verfügbarkeit → Zeitpläne** und erstelle einen Zeitplan mit den buchbaren Tagen und Uhrzeiten. Für eine Kulturstätte z. B. Dienstag bis Samstag, 09:00 bis 22:00 Uhr.
  </Step>

  <Step title="Buchungsoption konfigurieren">
    Öffne die Ressource und wechsle zum Tab **Buchungsoptionen**. Erstelle eine oder mehrere Optionen:

    * **Stundenweise**: flexible Dauer, z. B. Min. 2 Stunden, Max. 10 Stunden, Stundenpreis 25 €
    * **Ganztags**: feste Dauer 8 Stunden, Pauschalpreis 150 €

    Aktiviere in den erweiterten Einstellungen eine **Vorlaufzeit** (z. B. 48 Stunden) und einen **Vorausbuchungszeitraum** (z. B. 90 Tage).
  </Step>

  <Step title="Formulare hinzufügen">
    Unter **Buchungsoption → Formular** kannst du pro Buchung zusätzliche Informationen abfragen. Typische Felder für Raumbuchung:

    * Anzahl Personen
    * Zweck der Nutzung (z. B. Workshop, Feier, Seminar)
    * Gewünschte Bestuhlung
    * Ansprechperson vor Ort

    Diese Daten siehst du als Admin direkt in der Buchungsübersicht.
  </Step>

  <Step title="Rechtliche Dokumente hinterlegen">
    Unter **Buchungsoption → Rechtliche Dokumente** lädst du AGB, Nutzungsordnung oder Hausordnung hoch. Kund:innen müssen diese beim Checkout akzeptieren. Optional kannst du eine digitale Signatur verlangen.
  </Step>

  <Step title="Online-Zahlung aktivieren">
    Richte unter **Zahlungsabwicklung** Stripe Connect ein. Aktiviere anschließend die Online-Zahlung auf der Buchungsoption. Kund:innen bezahlen direkt bei der Buchung per Kreditkarte, Apple Pay oder Google Pay.
  </Step>

  <Step title="Stornierungsbedingungen festlegen">
    Unter **Buchungsoption → Stornierungsbedingungen** definierst du, bis wann kostenlos storniert werden darf und welche Gebühren danach anfallen. Beispiel: kostenlose Stornierung bis 7 Tage vorher, danach 50 % Stornogebühr.
  </Step>

  <Step title="Buchungsseite prüfen">
    Öffne deine Buchungsseite und prüfe den gesamten Flow: Raumauswahl, Zeitauswahl, Formular, rechtliche Dokumente, Zahlung. Teste mit einer Beispielbuchung.
  </Step>
</Steps>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Business Center vermietet Konferenzräume an externe Kund:innen">
    Ein Business Center bietet 4 unterschiedlich große Konferenzräume zur stundenweisen Anmietung an. Externe Unternehmen buchen Räume für Workshops, Kundentermine oder Schulungen.
  </Accordion>

  <Accordion title="Kulturstätte vermietet Veranstaltungssaal für Feiern und Events">
    Ein Kulturhaus bietet seinen großen Saal und einen kleineren Seminarraum für externe Veranstaltungen an: Hochzeiten, Konzerte, Lesungen, Vereinsfeste.
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<Columns>
  <Column>
    <Card title="Karten & Interaktive Lagepläne">
      Zeichne deine Räume auf einer interaktiven Gebäudekarte ein, damit Kund:innen sie visuell finden und direkt buchen können.

      [Erfahre hier mehr](/maps-and-floor-plans)
    </Card>
  </Column>

  <Column>
    <Card title="Smart Availability">
      Verknüpfe Räume miteinander, um teilbare Flächen abzubilden. Wird der Gesamtraum gebucht, blockiert anny automatisch die Teilräume.

      [Erfahre hier mehr](/smart-availability)
    </Card>
  </Column>
</Columns>

<Columns>
  <Column>
    <Card title="Dynamic Pricing">
      Konfiguriere Rabatte ab einer bestimmten Buchungsdauer, Wochenend-Zuschläge oder auslastungsbasierte Preisanpassungen pro Buchungsoption.

      [Erfahre hier mehr](/dynamic-pricing)
    </Card>
  </Column>

  <Column>
    <Card title="Smart-Locks & Zutritt">
      Verbinde Schließsysteme mit anny, um pro Buchung automatisch einen zeitlich begrenzten PIN oder Zugang zum gebuchten Raum zu erstellen.

      [Erfahre hier mehr](/smart-locks-overview)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich Buchungsanfragen manuell bestätigen statt automatisch?">
    Ja. Deaktiviere in der Buchungsoption die Einstellung "Alle Buchungen automatisch annehmen". Kund:innen senden dann eine Anfrage, die du im Kalender oder unter Buchungen annimmst oder ablehnst.
  </Accordion>

  <Accordion title="Wie frage ich individuelle Informationen bei der Buchung ab?">
    Unter **Buchungsoption → Formular** erstellst du eigene Felder (Text, Dropdown, Zahl, Datei-Upload). Die Antworten siehst du in der Buchungsübersicht und im Export. Alternativ kannst du generelle Felder auch auf Organisationsebene unter Account-Einstellungen hinterlegen.
  </Accordion>

  <Accordion title="Kann ich einen großen Saal in zwei buchbare Hälften aufteilen?">
    Ja, mit Smart Availability. Du legst den Gesamtraum und die Hälften als separate Ressourcen an. In der Buchungsoption des **Gesamtraums** hinterlegst du die Teilräume unter **Abhängigkeiten**. Wird der Gesamtraum gebucht, blockiert anny beide Hälften. Hänge den Gesamtraum nicht als Abhängigkeit an die Teilräume — sonst blockieren sich die Hälften gegenseitig.
  </Accordion>

  <Accordion title="Können Kund:innen vor der Buchung AGB oder eine Nutzungsordnung akzeptieren?">
    Ja. Unter **Buchungsoption → Rechtliche Dokumente** hinterlegst du PDF-Dokumente, die im Checkout angezeigt werden. Kund:innen müssen diese akzeptieren (Checkbox) oder optional digital signieren, bevor sie abschließen können.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Raumbuchung nutzt den Resource-first Flow: Kund:innen wählen zuerst den Raum (Ressource), dann die Buchungsoption. Service-first Flow ist hier nicht relevant.
> * Terminologie: Im Raumbuchung-Kontext wird "Buchungsoption" verwendet, nicht "Service".
> * Für teilbare Räume: Smart Availability unter Features aktivieren. Gesamtraum UND Teilräume als eigene Ressourcen anlegen. Nur die Buchungsoption des Gesamtraums hängt die Teilräume als Abhängigkeiten an — nicht umgekehrt, sonst blockieren sich die Hälften.
> * Kalender-Sync: Outlook und Google sind persönliche Kalenderintegrationen. Für Raum-Kalender (shared mailbox) wird M365 Workspace benötigt.
> * Smart-Lock Integrationen (Glutz, Nuki, Salto, Comydo etc.) erstellen pro Buchung automatisch zeitlich begrenzten Zugang. Konfiguration über Integrationen → System → Regel anlegen (Ressource zu Zugangspunkt).
> * Wiederkehrende Buchungen funktionieren mit Pricing, Quota, Add-Ons und Smart Availability (seit Juni 2026).
> * Stornierungszeitraum = bis wann storniert werden darf. Stornierungsbedingungen = ob und welche Gebühren anfallen.
> * Verwandte Artikel: Smart Availability, Zeitpläne & Termine, Buchungsoption konfigurieren, Eigene Formulare, Rechtliche Dokumente, Stornierungsbedingungen, Karten & Interaktive Lagepläne, Dynamic Pricing, Smart-Locks Übersicht.


# Los Geht's - Segelschulen
Source: https://docs.anny.co/getting-started-sailing-schools



Mit anny bildest du deinen Bootsverleih digital ab. Du verwaltest Boote als Ressourcen, vermietest sie exklusiv an Gruppen und automatisierst Buchungen, Mitgliedschaften und Rechnungsstellung.

## Segelschulen im anny Kontext denken

In anny ist alles, was gebucht werden kann, eine Ressource. Für Segelschulen bedeutet das: Boote, Liegeplätze und Touren sind jeweils eigene Ressourcen. Jede Ressource erhält mindestens eine Buchungsoption, die festlegt, wie und zu welchem Preis gebucht wird.

Das zentrale Prinzip beim Bootsverleih: Mehrere Boote eines Typs fasst du als Child-Ressourcen zusammen und aktivierst **Exklusive Zeitfenster**. So wird ein Boot nach der ersten Buchung für andere Bestellungen blockiert und nicht mit fremden Gruppen geteilt.

| Segelschule | anny Konzept |
| - | - |
| Bootstyp (z. B. Kanu, 420er) | Ressource |
| Einzelnes Boot (z. B. Boot 1, Boot 2) | Child-Ressource |
| Personenanzahl pro Boot | Verfügbare Anzahl der Child-Ressource |
| Exklusivbuchung pro Gruppe | Exklusive Zeitfenster |
| Preis und Dauer | Buchungsoption |
| Vereinsmitgliedschaft | Abo-Plan |
| Mitgliederbereich | Community |

<Info>
  Folgende Features müssen in den Account-Einstellungen unter **Features** aktiviert werden:

  * **Mehrfachverfügbarkeit mit Zuweisung**: um individuelle Boote als Child-Ressourcen anzulegen
  * **Communities**: um geschützte Buchungsbereiche für Mitglieder zu erstellen
  * **Abos und Mitgliedschaften**: um wiederkehrende Mitgliedschaften anzubieten
  * **Zahlungsabwicklung & Rechnungsstellung**: um Online-Zahlungen zu akzeptieren und Rechnungen automatisch zu erstellen
</Info>

| Feature | Wofür wird es benötigt? | Vorher zu konfigurieren? |
| - | - | - |
| Mehrfachverfügbarkeit mit Zuweisung | Individuelle Boote eines Typs als Child-Ressourcen zusammenfassen | Feature aktivieren |
| Communities | Geschützte Buchungsbereiche nur für Mitglieder | Feature aktivieren |
| Abos und Mitgliedschaften | Wiederkehrende Mitgliedschaften und feste Liegeplätze abbilden | Feature aktivieren |
| Zahlungsabwicklung & Rechnungsstellung | Online-Zahlungen und automatische Rechnungserstellung | Feature aktivieren, Stripe verifizieren |

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Bootsressourcen anlegen">
    Öffne in der Menüleiste **Ressourcen** und klicke oben rechts auf **+Neu**. Lege pro Bootstyp eine Ressource an (z. B. "Kanu" oder "Segelboot 420er").

    Navigiere dann zu **Ressource** → **Verfügbarkeit** → **Child-Ressource** und lege die einzelnen Boote an (z. B. "Kanu 1", "Kanu 2"). Hinterlege pro Child-Ressource die **Verfügbare Anzahl** entsprechend der Personenkapazität (z. B. 4 Personen pro Kanu).

    Aktiviere auf der Ebene der Verfügbarkeit den Toggle **Exklusive Zeitfenster**. Damit wird ein Boot nach der ersten Buchung für andere Bestellungen als ausgebucht behandelt und die Gruppe bleibt unter sich.
  </Step>

  <Step title="Buchungsoptionen definieren">
    Gehe zum Reiter **Buchungsoption** innerhalb der Ressource. Definiere:

    * **Dauer**: Feste Dauer (z. B. 2 Stunden Bootsfahrt) oder flexibel (z. B. halber Tag).
    * **Preis**: Buchungspreis pro Zeiteinheit.
    * **Buchungsart**: Setze die Buchungsart auf **Vollständig**. Diese Einstellung ist Pflicht in Kombination mit Exklusiven Zeitfenstern.
    * **Min. Buchungsanzahl**: Lege fest, wie viele Plätze mindestens gebucht werden müssen (z. B. 1).

    <Tip>
      Deaktiviere "Kunde darf Option wählen" bei den Child-Ressourcen. Nur so funktioniert die Exklusive-Zeitfenster-Logik korrekt.
    </Tip>
  </Step>

  <Step title="Communities einrichten">
    Erstelle unter **Communities** eine neue Community (z. B. "Mitglieder Segelclub"). Weise der Community die Ressourcen zu, die nur für Mitglieder sichtbar und buchbar sein sollen.

    Mitglieder können auf zwei Wegen hinzugefügt werden:

    * **Manuell**: Per E-Mail-Adresse einzeln einladen.
    * **Automatisiert**: Kund:innen werden beim Abschluss eines Abo-Plans automatisch der richtigen Community zugewiesen.
  </Step>

  <Step title="Abo-Pläne erstellen">
    Erstelle unter **Abos** einen neuen Abo-Plan (z. B. "Jahresmitgliedschaft" oder "Saisonkarte"). Definiere:

    * Laufzeit und Abrechnungsintervall
    * Preis
    * Zugehörige Community (damit Mitglieder automatisch Zugang erhalten)

    Deine Kund:innen können Mitgliedschaften selbstständig anfragen, direkt abschließen oder eigenständig beenden.
  </Step>

  <Step title="Rechnungsstellung einrichten">
    Navigiere zu den **Account-Einstellungen** und richte unter **Zahlungsabwicklung & Rechnungsstellung** dein Stripe-Konto ein. Nach der Verifizierung können Kund:innen direkt online bezahlen und Rechnungen werden automatisch erstellt.
  </Step>
</Steps>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Bootsverleih mit exklusiver Gruppenbuchung">
    <Steps>
      <Step title="Ressource anlegen">
        Erstelle die Ressource "Kanu" mit Bild und Beschreibung.
      </Step>

      <Step title="Child-Ressourcen hinzufügen">
        Navigiere zu **Ressource** → **Verfügbarkeit** → **Child-Ressource**. Lege 4 Kanus an (Kanu 1 bis 4) mit jeweils einer Verfügbaren Anzahl von 4 (Personen pro Boot). Aktiviere **Exklusive Zeitfenster** und deaktiviere "Kunde darf Option wählen".
      </Step>

      <Step title="Buchungsoption konfigurieren">
        Definiere die Buchungsoption "Miete" mit Preis pro Stunde, Buchungsart **Vollständig** und Min. Buchungsanzahl 1.
      </Step>

      <Step title="Ergebnis">
        Kund:innen buchen ein Kanu für ihre Gruppe. Nach der Buchung ist dieses Kanu im Zeitfenster für andere Bestellungen blockiert. Die Gruppe bleibt unter sich.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Liegeplätze mit Mitgliedschaft">
    <Steps>
      <Step title="Liegeplatz-Ressource anlegen">
        Erstelle die Ressource "Liegeplätze A-Steg". Navigiere zu **Ressource** → **Verfügbarkeit** → **Child-Ressource** und lege die einzelnen Plätze an (z. B. "A-01", "A-02").
      </Step>

      <Step title="Buchungsoption konfigurieren">
        Definiere eine Buchungsoption mit flexibler Dauer (z. B. Saison- oder Monatsbuchung) und Preis.
      </Step>

      <Step title="Mitgliedschaft einrichten">
        Erstelle den Abo-Plan "Jahresmitgliedschaft Hafen" mit monatlicher Abrechnung. Verknüpfe den Plan mit der Community "Hafenmitglieder".
      </Step>

      <Step title="Sichtbarkeit steuern">
        Stelle die Liegeplatz-Ressourcen so ein, dass sie nur für Mitglieder der Community "Hafenmitglieder" sichtbar und buchbar sind.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<Columns>
  <Column>
    <Card title="Exklusive Zeitfenster">
      Verhindere, dass Boote mit Mehrfachkapazität zwischen verschiedenen Gruppen geteilt werden. Ein Zeitfenster gehört exklusiv einer Bestellung.

      [Erfahre hier mehr](/exclusive-time-slots)
    </Card>
  </Column>

  <Column>
    <Card title="Abos und Mitgliedschaften">
      Bilde feste Liegeplatz-Verträge oder Vereinsmitgliedschaften als wiederkehrende Abos ab und automatisiere die monatliche Abrechnung.

      [Erfahre hier mehr](/manage-subscriptions)
    </Card>
  </Column>

  <Column>
    <Card title="Buchungspakete">
      Biete Buchungskontingente an, zum Beispiel eine 10er-Karte für Bootsfahrten oder vergünstigte Mehrfachtickets für Vereinsmitglieder.

      [Erfahre hier mehr](/booking-codes)
    </Card>
  </Column>

  <Column>
    <Card title="Rechnungsstellung">
      Automatisiere den gesamten Abrechnungsprozess von der Online-Zahlung über die Rechnungserstellung bis zur automatischen Erstattung bei Stornierung.

      [Erfahre hier mehr](/invoicing)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Wie stelle ich sicher, dass ein Boot nicht von fremden Gruppen geteilt wird?">
    Aktiviere **Exklusive Zeitfenster** in der Ressourcenverfügbarkeit. Nach der ersten Buchung wird das Zeitfenster für andere Bestellungen als ausgebucht behandelt, auch wenn noch Plätze frei sind.
  </Accordion>

  <Accordion title="Wie bilde ich verschiedene Bootstypen mit mehreren Booten ab?">
    Lege pro Bootstyp eine Ressource an und füge die einzelnen Boote unter **Ressource** → **Verfügbarkeit** → **Child-Ressource** hinzu. Kund:innen buchen den Bootstyp und anny weist automatisch ein verfügbares Boot zu.
  </Accordion>

  <Accordion title="Können Kund:innen ihre Mitgliedschaft selbst verwalten?">
    Ja. Kund:innen können über die Buchungsseite ihren Abo-Plan selbstständig anfragen, abschließen oder kündigen. Du definierst in den Abo-Einstellungen, welche Aktionen möglich sind.
  </Accordion>

  <Accordion title="Warum wird ein Boot als ausgebucht angezeigt, obwohl noch Plätze frei sind?">
    Das ist erwartetes Verhalten bei aktivierten Exklusiven Zeitfenstern. Das Boot ist exklusiv für eine bestehende Bestellung reserviert. Im Admin-Bereich siehst du weiterhin die tatsächliche Belegung.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Exklusive Zeitfenster erfordern: Buchungsart "Vollständig" auf der Buchungsoption UND "Kunde darf Option wählen" muss deaktiviert sein.
> * Child-Ressourcen werden über Ressource → Verfügbarkeit → Child-Ressource angelegt (Feature "Mehrfachverfügbarkeit mit Zuweisung" muss aktiv sein).
> * Automatische Community-Zuweisung erfordert, dass der Abo-Plan mit einer Community verknüpft ist.
> * Buchungsoption ist der korrekte Leitbegriff für Segelschulen (Resource-first Flow).
> * Stripe-Verifizierung ist Voraussetzung für Online-Zahlungen.
> * Verwandte Artikel: Exklusive Zeitfenster (/exclusive-time-slots), Ressource konfigurieren (/ressourcen-konfigurieren), Buchungsoption konfigurieren (/buchungsoption-konfigurieren), Abo verwalten (/manage-subscriptions).


# Los Geht's - Universitäten
Source: https://docs.anny.co/getting-started-universities

Richte deinen anny Account für Lernplätze, Räume, Equipment und Beratung an deiner Hochschule ein.

<iframe />

Mit diesem Guide richtest du deinen anny Account für den Hochschulbetrieb ein. Du lernst, wie du Lernplätze, Räume, Equipment und Beratungstermine als Ressourcen abbildest, Studierende und Mitarbeitende über SSO und Communities steuerst und Buchungsregeln für den gesamten Campus definierst.

<Info>
  * Verfügbar ab **Enterprise** (für Single-Sign-On, eigene Löschfristen und unbegrenzte Communities).
  * Aktiviere vorab **Communities**, **Mehrfachverfügbarkeit von Ressourcen**, **Mehrfachverfügbarkeit mit Zuweisung**, **Check-In & Check-Out**, **Löschfristen**.
</Info>

## Universitäten im anny Kontext denken

Beim Hochschul-Use-Case bildet anny die gesamte Buchungsinfrastruktur digital ab. Das zentrale Prinzip: Jeder buchbare Ort oder Gegenstand ist eine **Ressource**, jeder einzelne Arbeitsplatz darin eine **Child-Ressource**. Wer was sehen und buchen darf, steuerst du über **Communities**.

| anny Konzept | Bedeutung im Hochschulkontext | Beispiel |
| - | - | - |
| Ressource | Ein buchbarer Raum, Bereich oder Gegenstand | Bibliothek Lesesaal, Seminarraum A1, Beamer-Set |
| Child-Ressource | Ein einzelner Platz innerhalb einer Ressource | Lernplatz 1 bis 50 im Lesesaal |
| Buchungsoption | Konfiguration, wie eine Ressource gebucht wird (Dauer, Zeitraster) | "Tagesbuchung" oder "Flexible Stundenbuchung" |
| Community | Geschützter Buchungsbereich für eine Nutzergruppe | "Studierende TH Nürnberg", "Mitarbeitende", "Externe" |
| Attribute Mapping | Automatische Zuordnung von Nutzer:innen zu Communities via SSO-Attribute | Alle mit Status "Student" landen in der Community "Studierende" |
| Buchungsregeln | Globale Limits für Buchungen pro Person | Max. 1 Buchung pro Zeitslot, max. 5 aktive Buchungen |

Dein Team verwaltet alles im **Adminbereich** (Ressourcen, Buchungen, Communities, Dashboard). Studierende und Mitarbeitende buchen über den **Buchungsbereich** (anny App, Wochenplaner, Karten).

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressourcenstruktur aufbauen">
    Lege für jeden buchbaren Bereich eine Ressource an. Verwende klare Bezeichnungen mit Gebäude, Etage und Kapazität (z. B. "Bibliothek EG, Lesesaal 1").

    Für Räume mit mehreren Einzelplätzen: Öffne die Ressource, navigiere zu **Verfügbarkeit** und erstelle unter **Child-Ressource** die einzelnen Plätze (z. B. Lernplatz 1 bis 30). So können Studierende einen konkreten Platz auswählen oder sich automatisch zuweisen lassen.

    Gruppiere zusammengehörige Ressourcen in **Ressourcengruppen** (z. B. "Alle Lernplätze Bibliothek", "Seminarräume Gebäude A") für bessere Übersicht und einfachere Rechtevergabe.
  </Step>

  <Step title="Buchungsoptionen konfigurieren">
    Erstelle pro Ressourcentyp mindestens eine Buchungsoption. Typische Setups:

    | Ressourcentyp | Buchungsoption | Dauer |
    | - | - | - |
    | Lernplätze | Flexible Stundenbuchung | 1 bis 8 Stunden |
    | Seminarräume | Zeitslot-Buchung | 45, 90 oder 180 Minuten |
    | Equipment | Tagesbuchung | Ganzer Tag |
    | Beratung | Terminbuchung | 15 oder 30 Minuten |

    Navigiere dazu in die jeweilige Ressource und erstelle unter **Buchungsoptionen** die passende Konfiguration.
  </Step>

  <Step title="SSO (Shibboleth) einrichten">
    Verbinde anny über die SAML-Schnittstelle mit dem hochschuleigenen Identity Provider (typischerweise Shibboleth über DFN-AAI oder eduGAIN).

    1. Öffne die **Account-Einstellungen** und navigiere zu **SSO & Sicherheit**.
    2. Klicke auf **+ IdP hinzufügen** und wähle **Föderation** sowie dein Netzwerk (z. B. DFN-AAI).
    3. Gib die **Entity ID** deiner Organisation ein und speichere.
    4. Schalte auf Seiten eures Rechenzentrums die Attribute frei (E-Mail, Vorname, Nachname und ggf. Gruppen-Attribute für das Mapping).

    <Tip>
      Die Entity ID deiner Organisation findest du in der DFN-AAI Tool-Übersicht unter "Identity Provider".
    </Tip>
  </Step>

  <Step title="Communities anlegen und Attribute Mapping konfigurieren">
    Erstelle Communities für jede Nutzergruppe, z. B.:

    * **Studierende** (Zugang zu Lernplätzen, Bibliothek, Hochschulsport)
    * **Mitarbeitende** (Zugang zu Büroarbeitsplätzen, Meetingräumen)
    * **Externe** (eingeschränkter Zugang, z. B. Gasthörer:innen)

    Richte anschließend das **Attribute Mapping** ein, damit Nutzer:innen beim SSO-Login automatisch der richtigen Community zugeordnet werden:

    1. Navigiere zu **Account-Einstellungen** → **SSO & Sicherheit** → **Attribute Mapping**.
    2. Klicke auf **Mapping hinzufügen** und wähle **Community**.
    3. Erstelle eine Regel: Wenn das Attribut (z. B. `urn:oid:xxxx`) den Wert "Student" enthält (Array), dann Community "Studierende".
    4. Speichere und teste den Login.

    <Tip>
      Aktiviere den **Inkognito-Modus** in den Community-Einstellungen, damit Studierende standardmäßig nicht füreinander sichtbar sind.
    </Tip>
  </Step>

  <Step title="Buchungsregeln festlegen">
    Definiere globale Buchungsregeln unter **Account-Einstellungen** → **Buchungsregeln**, um campusweite Limits zu setzen:

    * Max. Buchungen pro Zeitslot (z. B. 1 Buchung gleichzeitig)
    * Max. aktive Buchungen in die Zukunft (z. B. 5)

    Für feinere Steuerung pro Nutzergruppe (z. B. "Studierende dürfen max. 20 Stunden pro Woche buchen") nutze **Buchungskontingente** in den Community-Einstellungen.
  </Step>

  <Step title="Rechte und Rollen vergeben">
    Navigiere zu **Account-Einstellungen** → **Nutzerverwaltung** und lege Rollen an:

    * **Super Admin** (1 bis 2 Personen): Zentrale Verwaltung, Nutzer- und Rechtemanagement
    * **Fachbereichs-Admin** (1 pro Institut/Fachschaft): Operative Verwaltung der eigenen Ressourcen
    * **Sekretariat** (optional): Buchungsverwaltung ohne Zugriff auf Account-Einstellungen

    <Tip>
      Vergib Rechte nur gezielt und pro Ressourcengruppe. Weniger Admins bedeuten weniger Komplexität und weniger versehentliche Änderungen.
    </Tip>
  </Step>
</Steps>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Lernplatzbuchung in der Universitätsbibliothek">
    <Steps>
      <Step title="Ressource anlegen">
        Erstelle eine Ressource "Bibliothek EG, Lesesaal" mit Beschreibung, Gebäude und Kapazitätsangabe.
      </Step>

      <Step title="Child-Ressourcen erstellen">
        Navigiere zu **Verfügbarkeit** → **Child-Ressource** und lege 30 Lernplätze an (Lernplatz 1 bis 30). Aktiviere die automatische Zuweisung, wenn Studierende keinen bestimmten Platz wählen müssen.
      </Step>

      <Step title="Buchungsoption konfigurieren">
        Erstelle eine Buchungsoption "Flexible Stundenbuchung" mit einer Dauer von 1 bis 8 Stunden und einem Zeitraster von 30 Minuten.
      </Step>

      <Step title="Check-In aktivieren">
        Öffne die Ressource unter **Check-In** und aktiviere den Check-In-Zeitraum (z. B. 15 Minuten nach Buchungsstart). Aktiviere die Verfallsdauer, damit nicht genutzte Plätze automatisch freigegeben werden.
      </Step>

      <Step title="Karte erstellen">
        Lade den Grundriss des Lesesaals hoch und verbinde jeden Lernplatz auf der Karte mit der entsprechenden Child-Ressource. Studierende können dann direkt auf der Karte ihren Platz auswählen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Seminarraum-Buchung für Mitarbeitende">
    <Steps>
      <Step title="Ressource anlegen">
        Erstelle eine Ressource "Gebäude A, Seminarraum 1.01" mit Eigenschaften wie Kapazität (20 Personen), Ausstattung (Beamer, Whiteboard) und Standort.
      </Step>

      <Step title="Buchungsoption konfigurieren">
        Erstelle eine Buchungsoption "Zeitslot-Buchung" mit Slots von 45 oder 90 Minuten. Aktiviere die **wiederkehrende Buchung**, damit Dozierende regelmäßige Termine anlegen können.
      </Step>

      <Step title="Community zuordnen">
        Ordne die Ressource der Community "Mitarbeitende" zu, damit nur Lehrpersonal und Verwaltung buchen kann.
      </Step>

      <Step title="Raumdisplay einrichten">
        Verbinde ein Display vor dem Seminarraum über die anny Display App. Das Display zeigt in Echtzeit an, ob der Raum gerade belegt oder frei ist.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<Columns>
  <Column>
    <Card title="Check-In & Check-Out">
      Kontrolliere die Anwesenheit vor Ort per QR-Code-Scan und gib nicht genutzte Plätze automatisch nach Ablauf frei.

      [Erfahre hier mehr](/check-in-overview)
    </Card>
  </Column>

  <Column>
    <Card title="Karten & Interaktive Lagepläne">
      Visualisiere Räume und Arbeitsplätze auf interaktiven 3D-Gebäudeplänen, damit Nutzer:innen direkt auf der Karte buchen.

      [Erfahre hier mehr](/maps-and-floor-plans)
    </Card>
  </Column>
</Columns>

<Columns>
  <Column>
    <Card title="Datenschutz & Löschfristen">
      Anonymisiere oder lösche Buchungs- und Kundendaten nach einem definierten Zeitraum automatisch und DSGVO-konform.

      [Erfahre hier mehr](/data-privacy)
    </Card>
  </Column>

  <Column>
    <Card title="Anzeigetafeln & Raumdisplays">
      Zeige aktuelle und kommende Buchungen auf Displays vor Räumen an oder nutze die anny Check-In App als Terminal.

      [Erfahre hier mehr](/display-app)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich mehrere Communities mit unterschiedlichen Buchungsrechten anlegen?">
    Ja. Jede Community hat eine eigene Buchungsseite und eigene Zuordnungen. Du kannst beliebig viele Communities anlegen (im Enterprise Plan unbegrenzt) und pro Community steuern, welche Ressourcen und Buchungsoptionen sichtbar sind.
  </Accordion>

  <Accordion title="Wie werden Studierende automatisch der richtigen Community zugeordnet?">
    Über Attribute Mapping. Beim SSO-Login sendet euer Identity Provider Attribute mit (z. B. Rolle, Fakultät, Studiengang). anny wertet diese Attribute regelbasiert aus und ordnet Nutzer:innen automatisch den passenden Communities zu.
  </Accordion>

  <Accordion title="Was passiert, wenn Studierende nach dem Check-In den Platz wechseln möchten?">
    Studierende können eine Buchung auch nach dem Check-In stornieren, sofern das Stornierungszeitfenster der Buchungsoption es erlaubt. Danach buchen sie einfach einen neuen Platz. Kapazität und Kontingent werden vollständig freigegeben.
  </Accordion>

  <Accordion title="Brauche ich für jeden Standort einen eigenen anny Account?">
    In der Regel nicht. Die meisten Universitäten betreiben alle Use Cases in einem einzigen Account (Single-Tenant). Nur bei komplett getrennter Zahlungsabwicklung (z. B. Hochschulsport mit eigenem Abrechnungskreis) kann ein zweiter Account sinnvoll sein.
  </Accordion>

  <Accordion title="Welche Datenregion sollte ich wählen?">
    Für DSGVO-Konformität und Hosting auf deutschen Servern wähle **.eu**. Falls du Zahlungsabwicklung benötigst (z. B. für Hochschulsport oder Events), nutze **.co**. Innerhalb einer Universität sollten alle Accounts auf derselben Datenregion laufen.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Universitäten nutzen typischerweise den Enterprise Plan (SSO, Löschfristen, unbegrenzte Communities).
> * SSO-Anbindung erfolgt über föderiertes SAML via DFN-AAI oder eduGAIN (Shibboleth). Direktes SAML (1:1) ist ebenfalls möglich.
> * Attribute Mapping: Einstellung unter Account-Einstellungen → SSO & Sicherheit → Attribute Mapping. Max. 10 verschiedene Attribute zuordbar. Operator für Gruppen mit mehreren Werten: "enthält (Array)".
> * Buchungsregeln: Account-Einstellungen → Buchungsregeln (global). Feinere Steuerung pro Community über Buchungskontingente in den Community-Einstellungen.
> * Child-Ressource: Ressource → Verfügbarkeit → Child-Ressource.
> * Self Check-Out Update (Jan 2026): Stornieren nach Check-In ist möglich (richtet sich nach Stornierungszeitfenster der Buchungsoption). Check-Out vor Buchungsstart nicht mehr möglich. Minimale Nutzungsdauer konfigurierbar.
> * Datenregion: .eu für DSGVO-only, .co für Zahlungsabwicklung. Nie mischen innerhalb einer Uni.
> * Empfohlene Rollenstruktur: 1-2 Super Admins, 1 Admin pro Institut, optional Sekretariats-Rolle.
> * Verwandte Artikel: /check-in-overview, /communities, /attribute-mapping, /federated-saml, /data-privacy, /maps-and-floor-plans, /display-app, /booking-rules, /roles-and-permissions.


# Globale Blocker erstellen und verwalten
Source: https://docs.anny.co/global-blockers

Erstelle globale Blocker, um mehrere Ressourcen gleichzeitig für einen Zeitraum zu sperren

Mit globalen Blockern sperrst du mehrere oder alle Ressourcen deines Accounts gleichzeitig für einen bestimmten Zeitraum. Das ist besonders nützlich für Feiertage, Betriebsferien oder Wartungszeiträume, in denen keine Buchungen möglich sein sollen.

<iframe />

## Globalen Blocker erstellen

<Steps>
  <Step title="Account-Einstellungen öffnen">
    Klicke auf dein **Avatar** (oben rechts) und wähle **Account-Einstellungen**. Öffne den Bereich **Globale Blocker**.
  </Step>

  <Step title="Blocker anlegen">
    Klicke auf **Globalen Blocker erstellen** und vergib einen Titel (z. B. "Betriebsferien" oder "Wartung").
  </Step>

  <Step title="Zeitraum festlegen">
    Wähle Start- und Enddatum für den Blocker.
  </Step>

  <Step title="Zielgruppe wählen">
    Lege fest, welche Ressourcen gesperrt werden sollen:

    * **Alle Ressourcen**: Sperrt sämtliche Ressourcen im Account, auch zukünftig angelegte.
    * **Bestimmte Gruppen**: Sperrt nur Ressourcen der ausgewählten Gruppen.
    * **Bestimmte Kategorien**: Sperrt nur Ressourcen bestimmter Kategorien (z. B. Meetingräume, Parkplätze).
  </Step>

  <Step title="Speichern">
    Klicke auf **Speichern**. Der Blocker wird sofort aktiv und alle betroffenen Ressourcen erscheinen im Kalender als blockiert.
  </Step>
</Steps>

<Warning>
  Nutze globale Blocker nur, wenn du sicher bist, dass du die gewählten Ressourcen zu diesem Zeitpunkt blockieren möchtest. Bei der Option "Alle Ressourcen" werden auch zukünftig angelegte Ressourcen automatisch gesperrt.
</Warning>

## Feiertagsblocker einrichten

Mit Feiertagsblockern legt anny automatisch Blocker für gesetzliche Feiertage an.

<Steps>
  <Step title="Feiertagsblocker öffnen">
    Navigiere zu **Avatar** (oben rechts) > **Account-Einstellungen** > **Globale Blocker** und öffne den Bereich **Feiertagsblocker**.
  </Step>

  <Step title="Bundesland und Zeitraum wählen">
    Wähle das gewünschte Bundesland und den Zeitraum, für den Feiertage angelegt werden sollen (z. B. 7 Tage, 30 Tage oder das gesamte Jahr).
  </Step>

  <Step title="Speichern">
    Klicke auf **Speichern**. anny legt automatisch Blocker für alle gesetzlichen Feiertage im gewählten Zeitraum an.
  </Step>
</Steps>

## Buchungen über Blocker hinweg erlauben

Falls Buchungen vor und nach einem Blocker dennoch möglich sein sollen, kannst du das pro Buchungsoption aktivieren.

<Steps>
  <Step title="Buchungsoption öffnen">
    Öffne die entsprechende **Ressource** und navigiere zum Reiter **Buchungsoption**.
  </Step>

  <Step title="Erweiterte Einstellungen aufrufen">
    Klicke auf **Bearbeiten** und öffne die **Erweiterten Einstellungen**.
  </Step>

  <Step title="Funktion aktivieren">
    Aktiviere die Option **Blocker übergreifende Buchung erlauben**. Buchungen können nun über den Blocker hinweg erstellt werden.
  </Step>
</Steps>

<Tip>
  Diese Einstellung ist hilfreich, wenn z. B. ein Raum über ein Feiertagswochenende hinweg als Mehrtagesbuchung gebucht werden soll, ohne dass der Feiertag die Buchung verhindert.
</Tip>

## Ergebnis prüfen

Öffne den **Kalender** im Admin-Bereich. Betroffene Ressourcen zeigen den globalen Blocker als gestrichelten, grauen Eintrag im gewählten Zeitraum. In der Buchungsseite sind die gesperrten Zeiträume für Kund:innen nicht mehr buchbar.

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen einem normalen Blocker und einem globalen Blocker?">
    Ein normaler Blocker wird direkt im Kalender per Klicken und Ziehen erstellt und sperrt nur eine einzelne Ressource. Ein globaler Blocker wird in den Account-Einstellungen angelegt und kann mehrere oder alle Ressourcen gleichzeitig sperren.
  </Accordion>

  <Accordion title="Werden zukünftig angelegte Ressourcen automatisch von einem globalen Blocker betroffen?">
    Ja, wenn du als Zielgruppe "Alle Ressourcen" wählst. Bei der Auswahl bestimmter Gruppen oder Kategorien werden nur die Ressourcen gesperrt, die zum Zeitpunkt des Blockers dieser Gruppe oder Kategorie zugeordnet sind.
  </Accordion>

  <Accordion title="Kann ich Feiertagsblocker für mehrere Bundesländer gleichzeitig einrichten?">
    Ja, du kannst mehrere Feiertagsblocker mit unterschiedlichen Bundesländern anlegen. Jeder Feiertagsblocker wird separat konfiguriert.
  </Accordion>

  <Accordion title="Wie lösche ich einen globalen Blocker?">
    Navigiere zu **Avatar** (oben rechts) > **Account-Einstellungen** > **Globale Blocker**. Dort siehst du alle aktiven Blocker und kannst sie einzeln löschen. Alternativ können einzelne Blocker direkt im Kalender entfernt werden.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein globaler Blocker sperrt alle Ressourcen, obwohl ich nur bestimmte Gruppen gewählt habe">
    Prüfe, ob der Blocker korrekt gespeichert wurde, indem du ihn in den Account-Einstellungen erneut öffnest. Falls die Zielgruppe auf "ohne Beschränkung" steht, bearbeite den Blocker und wähle die Gruppe erneut aus.
  </Accordion>

  <Accordion title="Kund:innen können trotz Blocker buchen">
    Prüfe, ob auf der betroffenen Buchungsoption die Einstellung "Blocker übergreifende Buchung erlauben" aktiviert ist. Falls ja, deaktiviere diese Option in den erweiterten Einstellungen der Buchungsoption.
  </Accordion>

  <Accordion title="Feiertagsblocker werden nicht im Kalender angezeigt">
    Stelle sicher, dass du den Kalender auf den richtigen Zeitraum einstellst. Feiertagsblocker werden nur für den gewählten Zeitraum (z. B. 30 Tage) angelegt. Falls der Feiertag ausserhalb dieses Zeitraums liegt, erweitere die Einstellung auf "gesamtes Jahr".
  </Accordion>
</AccordionGroup>

> Wichtige Informationen fuer Agenten:
>
> * UI-Pfad: Avatar (oben rechts) > Account-Einstellungen > Globale Blocker
> * Zielgruppen-Optionen: alle Ressourcen (inkl. zukünftig angelegter), bestimmte Gruppen, bestimmte Kategorien
> * "Blocker übergreifende Buchung erlauben" liegt auf Buchungsoption-Ebene unter Erweiterte Einstellungen
> * Globaler Blocker ist nicht gleich normaler Blocker (Kalender, einzelne Ressource, per Drag and Drop)
> * Kein höherer Plan als Starter erforderlich
> * Verwandte Artikel: Zeitpläne (abweichende Öffnungszeiten), Buchungsregeln (Sperrlisten)


# Google Workspace SSO
Source: https://docs.anny.co/google-workspace-sso



In diesem Artikel erfährst du, wie du einen Unternehmenslogin mit Google Workspace bei anny einrichtest.

## Vorbereitung

Die SSO Verbindung kannst du selbstständig in deinem anny [Admin Bereich](https://app.anny.co/organization/settings/sso?o=) unter SSO & Sicherheit hinterlegen. Neben den anny Admin Rechten benötigst du den Zugang zum Adminbereich deines Google Workspaces.

## Einrichtung

Zur Einrichtung von SSO müssen die folgenden Schritte von dir ausgeführt werden. Wichtig: Du musst für diese Einrichtung Administrator in deinem Google Workspace sein.

Gehe als Erstes in den Adminbereich deines Google Workspaces unter [https://admin.google.com](https://admin.google.com) und melde dich ggf. an. Gehe nun auf Apps > Web- und mobile Apps.

Wir fügen nun eine neue App hinzu, welche dir den Login über SSO ermöglicht. Wähle hierzu "App hinzufügen" und dann "Benutzerdefinierte SAML-App hinzufügen" aus.

![Google Workspace App hinzufügen](https://downloads.intercomcdn.eu/i/o/8963206/1b62a17ba9ada20a9ec4d9a5/image.png)

Hier kannst du nun einen Namen für die App vergeben. Nenne sie z.B. "anny SSO Login". Wenn du magst, kannst du auch das anny Logo als App-Symbol hochladen.

![App benennen](https://downloads.intercomcdn.eu/i/o/8963531/5e4ab9eb670039f2a21883fe/image.png)

In der nächsten Ansicht findest du nun die benötigten Daten für die Einrichtung bei anny. Gehe dazu in die SSO Einstellungen im Adminbereich und wähle "IDP hinzufügen" und wähle dann als Provider "Google Workspace". Fülle das Formular unter "2. SAML-Metadaten einfügen" wie folgt aus:

1. Wähle die Option "Manuell".
2. Füge unter "Entity ID" die URL ein, welche in Google Workspace als Entitäts-ID angegeben ist.
3. Füge unter "X509-Zertifikat" das Zertifikat ein, welches in Google Workspace als Zertifikat angegeben ist.
4. Füge unter SSO-URL und SLO-URL jeweils die URL ein, welche in Google Workspace als SSO-URL angegeben ist.

Gehe nun auf weiter in Google Workspace, sodass wir hier die entsprechenden Informationen eintragen können. Fülle die Felder wie folgt aus:

1. Füge unter "ACS-URL" die URL ein, welche in anny als ACS-URL angegeben ist. Hierzu musst du unter "1. Metadaten der Anwendung kopieren" auf "Details anzeigen" klicken.
2. Füge unter "Entitäts-ID" die URL ein, welche in anny als Entity-ID angegeben ist.
3. Aktiviere die Checkbox "Signierte Antwort".
4. Wähle unter "Name-ID-Format" die Option "PERSISTENT".

![Google Workspace SAML Konfiguration](https://downloads.intercomcdn.eu/i/o/8965347/738a060b38b0b7af6d6e56bf/image.png)

In anny kannst du nun bereits auf Speichern drücken. In Google Workspace drückst du auf weiter.

Wir müssen nun noch einstellen, welche Attribute von Google zu anny übertragen werden sollen. Hierfür müssen wir in Google Workspace eine Attributzuordnung übernehmen. Folgende Zuordnungen müssen gesetzt werden (Google-Verzeichnisattribute > App-Attribute):

* First name > givenName
* Last name > surname
* Primary email > mail

![Attributzuordnung](https://downloads.intercomcdn.eu/i/o/8965586/622e776947eac7a3661b1405/image.png)

Wenn du außerdem Gruppen zu anny übertragen möchtest, z.B. um Nutzenden automatisch Rollen oder Communities zuzuweisen, kannst du außerdem einstellen, welche Gruppenmitgliedschaften übertragen werden sollen.

![Gruppenmitgliedschaften](https://downloads.intercomcdn.eu/i/o/8965619/06cd190d864b9e89fc699fc9/image.png)

Drücke nun auf Fertigstellen, um auch bei Google Workspace die Einrichtung abzuschließen.


# Gruppen & Kategorien
Source: https://docs.anny.co/groups-and-categories



Mit Gruppen gliederst du Ressourcen, Services, Produkte und Buchungspakete deiner Organisation. Du legst jede Art in einer eigenen Liste an und weist sie danach am Datensatz zu. [Tags](/tags) liegen auf derselben Seite. Sie kennzeichnen Datensätze farbig, statt sie in Abschnitte zu gliedern.

## Wann du Gruppen nutzt

| Du willst … | So helfen Gruppen |
| - | - |
| **Services auf der Buchungsseite bündeln** | Servicegruppen werden Abschnitte im Reiter **Services**, zum Beispiel Kurse und Einzelstunden. |
| **Produkte ordnen** | Produktgruppen gliedern den Reiter **Produkte** und den Filter **Gruppe** in der Produktliste. |
| **Buchungen nach Bereich filtern** | Ressourcengruppen filterst du in den **Buchungen** über **Gruppen** und kannst sie in [Buchungsregeln](/booking-rules) als Einschränkung nutzen. |

## Welche Gruppen es gibt

| Liste | Wofür | Feld am Datensatz |
| - | - | - |
| **Ressourcengruppen** | Filter **Gruppen** in den Buchungen, Einschränkung in Buchungsregeln | **Gruppe** an der Ressource |
| **Servicegruppen** | Abschnitte im Reiter **Services** der Buchungsseite | **Gruppe** am Service |
| **Produktgruppen** | Filter **Gruppe** in der Produktliste und Abschnitte im Reiter **Produkte** | **Gruppe** am Produkt |
| **Buchungspaket-Gruppen** | Übersicht der Buchungspakete und der Reiter **Pakete & Gutscheine** | **Gruppe** am Buchungspaket |

Der Abschnitt **Buchungspaket-Gruppen** erscheint nur, wenn Buchungspakete in deinem Account verfügbar sind.

## Gruppen anlegen

Alle vier Listen pflegst du an einer Stelle.

<Steps>
  <Step title="Gruppen öffnen">
    Öffne in der Seitenleiste **Account** und dann **Einstellungen**. Wechsle zum Reiter **Gruppen**.

    Die Listen stehen untereinander. Zuerst ist **Tags** aufgeklappt. Es ist immer nur eine Liste offen.
  </Step>

  <Step title="Liste aufklappen">
    Klicke auf die Liste, die du pflegen willst, zum Beispiel **Ressourcengruppen**.

    Die Zeilen dieser Liste erscheinen. Die anderen Listen klappen zu.
  </Step>

  <Step title="Eintrag anlegen">
    Klicke unter der Liste auf den Hinzufügen-Button. Der Text hängt von der Liste ab:

    * **Ressourcengruppen**: **Gruppe hinzufügen**
    * **Servicegruppen**: **Service Gruppe hinzufügen**
    * **Produktgruppen**: **Produktgruppe hinzufügen**
    * **Buchungspaket-Gruppen**: **Buchungspaket-Gruppe hinzufügen**

    Trage unter **Name** den Namen ein. Bei **Buchungspaket-Gruppen** kannst du zusätzlich eine **Beschreibung** setzen. anny speichert die Zeile sofort.
  </Step>
</Steps>

Sobald die Gruppe in der Liste steht, kannst du sie am passenden Datensatz auswählen.

<Frame>
  <img alt="Einstellungen, Reiter Gruppen, mit aufgeklappten Ressourcengruppen Main studio und Team und der Zeile Gruppe hinzufügen" />
</Frame>

### Namen ändern, sortieren und löschen

* **Umbenennen**: Klicke in der Zeile auf den Namen und ändere den Text. Die zugeordneten Datensätze zeigen den neuen Namen, weil sie auf die Gruppe verweisen.
* **Reihenfolge ändern**: Ziehe eine Zeile an die gewünschte Position. In dieser Reihenfolge steht die Liste hier. Die **Produktgruppen** auf der Buchungsseite folgen derselben Reihenfolge.
* **Löschen**: Klicke in der Zeile auf die drei Punkte, dann auf **Löschen**, und bestätige die Frage.

<Warning>
  Wenn du eine Gruppe löschst, bleiben die Datensätze erhalten. anny nimmt ihnen nur die Gruppe. Services, Produkte und Pakete ohne Gruppe stehen auf der Buchungsseite im Abschnitt **Andere**. Löschst du eine Ressourcengruppe, entfernt anny außerdem Buchungsregeln, die nur für diese Gruppe galten.
</Warning>

## Eine Gruppe zuweisen

<Steps>
  <Step title="Datensatz öffnen">
    Öffne die Ressource, den Service, das Produkt oder das Buchungspaket.

    In den Details findest du das Feld **Gruppe**. Es ist optional.
  </Step>

  <Step title="Gruppe wählen oder anlegen">
    Klicke auf **Gruppe**. Wähle eine bestehende Gruppe oder tippe einen neuen Namen, um eine Gruppe anzulegen.

    Die Gruppe steht im Feld.
  </Step>

  <Step title="Speichern">
    Klicke auf **Speichern**.

    Die Zuordnung in den Details gilt erst nach dem Speichern. In den Tabellen **Ressourcen** und **Services** speichert anny eine Änderung in der Zeile sofort.
  </Step>
</Steps>

In der Ressourcen-Tabelle lässt sich die Gruppe einer untergeordneten Ressource nicht in der Zeile ändern. Der Hinweis lautet **Wird von der übergeordneten Ressource übernommen**.

## Gruppen auf der Buchungsseite

Kund:innen sehen Gruppennamen als Abschnitte der Buchungsseite. Leere Gruppen bleiben ausgeblendet.

* **Services**: Jede Servicegruppe mit mindestens einem buchbaren Service wird ein Abschnitt. Services ohne Gruppe stehen unter **Andere**.
* **Produkte**: Produktgruppen gliedern den Reiter **Produkte** in der Reihenfolge der Liste unter **Gruppen**. Produkte ohne Gruppe stehen unter **Andere**.
* **Pakete & Gutscheine**: Eine Buchungspaket-Gruppe erscheint, sobald mindestens ein Paket darin live ist. Pakete ohne Gruppe stehen unter **Andere**. Mehr dazu unter [Buchungspakete & Codes](/booking-codes).

Ressourcengruppen werden keine Abschnitte der öffentlichen Ressourcenliste. Du nutzt sie im Admin-Bereich, zum Beispiel im Filter **Gruppen** der Buchungen.

## Wer Gruppen verwalten darf

* **Ressourcengruppen, Produktgruppen und Buchungspaket-Gruppen** anlegen, umbenennen, sortieren und löschen darfst du, wenn du Ressourcen erstellen oder bearbeiten darfst.
* **Servicegruppen** darfst du verwalten, wenn du Services erstellen oder bearbeiten darfst.

Ohne dieses Recht siehst du die Liste nur lesend. Es gibt keine Zeile zum Hinzufügen, kein **Löschen**, und der Name lässt sich nicht ändern.

Die Rechte stellst du unter **Admin-Nutzer** ein. Mehr dazu unter [Rollen und Berechtigungen](/roles-and-permissions).

## Einschränkungen

* Die gezogene Reihenfolge gilt für die Liste unter **Gruppen**. Auf der Buchungsseite folgt die Reihenfolge der Produktgruppen dieser Liste.
* Ressourcengruppen gliedern nicht die öffentliche Ressourcenliste.
* An einem Plan gibt es ein eigenes Feld **Gruppe**. Diese Plangruppen stehen nicht auf der Seite **Gruppen**. Ein Kunde kann nur ein Abonnement pro Plangruppe starten.
* **Buchungspaket-Gruppen** fehlen, wenn Buchungspakete für den Account nicht verfügbar sind.
* Eine Beschreibung trägst du nur bei **Buchungspaket-Gruppen** ein. Die anderen drei Listen haben nur die Spalte **Name**.

## FAQ

<AccordionGroup>
  <Accordion title="Sehen Kund:innen meine Ressourcengruppen?">
    Nein. Ressourcengruppen sind für dein Team: zum Filtern der Buchungen und als Einschränkung in Buchungsregeln. Auf der Buchungsseite sehen Kund:innen die Namen von Servicegruppen, Produktgruppen und Buchungspaket-Gruppen, jeweils als Abschnitt.
  </Accordion>

  <Accordion title="Was passiert mit den Datensätzen, wenn ich eine Gruppe lösche?">
    Die Datensätze bleiben. Ihnen fehlt danach die Gruppe. Auf der Buchungsseite rutschen Services, Produkte und Pakete in den Abschnitt **Andere**. Buchungsregeln, die nur für die gelöschte Ressourcengruppe galten, werden entfernt.
  </Accordion>

  <Accordion title="Muss ich nach dem Anlegen in der Liste noch speichern?">
    Nein. Eine neue Zeile unter **Gruppen** wird sofort gespeichert. Die Zuordnung in den Details eines Datensatzes speicherst du mit **Speichern**. In den Tabellen **Ressourcen** und **Services** speichert die Zeile sofort.
  </Accordion>

  <Accordion title="Warum heißt der Button bei Ressourcengruppen Gruppe hinzufügen?">
    Der Abschnitt heißt **Ressourcengruppen**. Der Button darunter legt eine Gruppe an und heißt **Gruppe hinzufügen**. Bei Servicegruppen heißt er **Service Gruppe hinzufügen**.
  </Accordion>

  <Accordion title="Kann ich eine Gruppe umbenennen, ohne die Zuordnung zu verlieren?">
    Ja. Die Datensätze verweisen auf die Gruppe. Nach dem Umbenennen zeigen sie den neuen Namen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich kann keine Gruppe hinzufügen">
    Dir fehlt das Recht, Ressourcen oder Services zu erstellen oder zu bearbeiten. Bitte eine Person mit Admin-Rechten, die Gruppe anzulegen oder dir das Recht zu geben. Ohne Recht ist die Liste nur lesend.
  </Accordion>

  <Accordion title="Eine Gruppe fehlt auf der Buchungsseite">
    Der Abschnitt erscheint nur, wenn etwas darin buchbar ist: ein buchbarer Service, ein sichtbares Produkt oder ein Live-Paket. Leere Gruppen bleiben ausgeblendet. Prüfe, ob der Datensatz der Gruppe zugeordnet und, in den Details, mit **Speichern** gesichert ist.
  </Accordion>

  <Accordion title="Buchungspaket-Gruppen werden nicht angezeigt">
    Der Abschnitt erscheint nur, wenn Buchungspakete für deinen Account verfügbar sind. Ohne sie gibt es diese Liste unter **Gruppen** nicht.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Slug der Seite bleibt `groups-and-categories` (historisch, inkl. Redirects). Sichtbarer Titel ist **Gruppen**. Kategorien (vordefinierte Ressourcenkategorien) werden hier nicht verwaltet und gehören nicht in die Antwort, außer zur Abgrenzung: die öffentliche Ressourcenliste gliedert nach Kategorien, nicht nach Ressourcengruppen.
> * Pfad: Seitenleiste **Account** → **Einstellungen** → Reiter **Gruppen** (Route `organization-settings-groups`). Akkordeon, nur eine Liste offen, Standard ist `tags`. Danach `resource-groups`, `service-groups`, `add-on-groups`, `booking-bundle-groups`. Letztere nur bei Feature `booking-bundles` (`features: null` zeigt sie).
> * Spalten: **Name**. **Beschreibung** nur bei Buchungspaket-Gruppen (lokalisiert) und bei Tags. Ressourcen-, Service- und Produktgruppen haben keine Beschreibungsspalte.
> * Hinzufügen-Buttons aus `common.actions.addItem` plus Singular: Ressourcengruppen **Gruppe hinzufügen** / **Add Group** (Singular ist „Gruppe“/„Group“, nicht „Ressourcengruppe“). Servicegruppen **Service Gruppe hinzufügen** / **Add Service group** (DE-Singular mit Leerzeichen „Service Gruppe“, Abschnittstitel „Servicegruppen“). Produktgruppen **Produktgruppe hinzufügen** / **Add Product group**. Buchungspaket-Gruppen **Buchungspaket-Gruppe hinzufügen** / **Add Booking bundle group**. Anlegen speichert sofort (`record.save()`), Name max. 80 Zeichen. Löschen über Zeilenmenü **Löschen**, Bestätigung „„Name“ löschen?“ / `Delete "Name"?`. Leerzustand **Noch keine Einträge** / **No entries yet**.
> * Zuweisen: Feld **Gruppe** / **Group** an Ressource, Service, Produkt (`components.addOnSelect.label`) und Buchungspaket. In den Details speichert `useDetailSave` über **Speichern**. In den Tabellen Ressourcen und Services speichert die Inline-Auswahl sofort (`save(false)`). Untergeordnete Ressourcen: Zelle in der Tabelle deaktiviert, Tooltip **Wird von der übergeordneten Ressource übernommen** / **Set on the parent resource**. Die Detailseite sperrt das Feld nicht.
> * Rechte: Ressourcen-, Produkt- und Buchungspaket-Gruppen bei `can('create','resources')` oder `can('update','resources')`. Servicegruppen bei create oder update von `services`. Sonst nur lesend, keine Ghost-Row, kein Löschen.
> * Löschen: ResourceGroup setzt `resources.group_id` null (auch soft-deleted), löscht BookingRules, die danach global würden (`withSingleRestrictionTo`), und `bookingQuotaRestrictions`. ServiceGroup setzt `services.group_id` null nur wo `original_id` null ist. BookingBundleGroup löst die Pakete und indiziert die Reihenfolge der Gruppe ohne Zuordnung neu. AddOnGroup hat keinen deleting-Hook; FK `add_ons.group_id` ist `onDelete('set null')`.
> * Buchungsseite: Servicegruppen über `offeredServiceGroups` (nicht versteckt, nicht archiviert, kein Miet-Service, nicht `hidden_in_list`), ohne `orderBy` auf `order_index`. Produktgruppen über `offeredAddOnGroups` mit `orderBy order_index, name`. Buchungspaket-Gruppen über `offeredBookingBundleGroups` (mindestens ein Live-Paket), ohne `orderBy` auf `order_index`. Abschnitt ohne Gruppe: **Andere** / **Other**. Leere Abschnitte per `v-show` bei `items.length > 0` ausgeblendet. Die gezogene Reihenfolge ist `order_index`. Auf der Buchungsseite folgen ihr nur Produktgruppen. Service- und Paketgruppen nicht als Buchungsseiten-Reihenfolge behaupten.
> * Buchungsregeln: erlaubte Einschränkungstypen enthalten `resource-groups` und `service-groups`. Die Auswahl zeigt die Singular-Labels **Gruppe** und **Service Gruppe**, nicht die Abschnittstitel.
> * Plangruppen sind nicht diese Seite. Feld **Gruppe** am Plan, Tooltip: ein Kunde kann nur ein Abonnement pro Gruppe starten.
> * Kalender: `useResourceToCalendarResource` setzt `groupId` auf `resource_group_{id}`, legt aber keine Eltern-Ressource mit dieser Id an. Timeline-Überschriften nach Gruppenname nicht behaupten.
> * Verwandt: [Tags](/tags), [Buchungspakete & Codes](/booking-codes), [Buchungsregeln](/booking-rules), [Rollen und Berechtigungen](/roles-and-permissions).


# Anfragen & Anfrageformulare
Source: https://docs.anny.co/inquiries

Sammle Anfragen aus Formularen, E-Mails und KI-Assistenten an einer Stelle, beantworte sie, schlage Buchungen vor und schicke ein Angebot.

Nicht jede Buchung beginnt mit einem Klick auf der Buchungsseite. Firmenevents, Raumanmietungen oder Workshops starten oft mit einer Frage. Unter **Anfragen** sammelt anny all diese Anfragen an einer Stelle: aus deinen Anfrageformularen, aus weitergeleiteten E-Mails und von deinen KI-Assistenten. Du antwortest direkt aus anny, schlägst Buchungen vor und schickst ein Angebot, das deine Kund:innen online annehmen.

Jede Anfrage ist in anny eine Bestellung mit einem **Anfrage-Status**. Alles, was zur Anfrage gehört, bleibt so zusammen: Kund:in, Antworten aus dem Formular, E-Mail-Verlauf, Buchungen, Rechnung und Angebote.

<Warning>
  Beta-Phase Admin 3.0 (Stand: 5. Oktober). Anpassungen sind möglich.
</Warning>

## Wie kommen Anfragen zu anny?

| Weg | Was passiert |
| :- | :- |
| **Anfrageformular** | Kund:innen füllen ein Formular auf deiner Website oder über den Formularlink aus. |
| **E-Mail** | Du leitest E-Mails an eine geheime Adresse von anny weiter. Jede neue E-Mail wird zur Anfrage. |
| **KI-Assistent** | Dein [Telefon- oder Chat-Assistent](/anny-ai-setup) nimmt eine Anfrage mit einem Anfrageformular auf. |
| **Antwort von Kund:innen** | Antwortet eine Kundin auf eine E-Mail zu einer bestehenden Buchung oder Bestellung, wird diese Bestellung ebenfalls zur Anfrage. |
| **Vom Team erfasst** | Du legst eine Anfrage selbst an, zum Beispiel nach einem Telefonat. |

## Die Anfragen-Übersicht

Du findest die Anfragen in der Seitenleiste unter **Management** → **Anfragen**.

<Frame>
  <img alt="Anfragen-Übersicht mit der Ansicht Handlungsbedarf: fünf Anfragen mit Nummer, Kunde, Anfrage, Anfrageformular, Anfrage-Status und Anzahl angefragter Buchungen" />
</Frame>

Oben wählst du eine Ansicht. Die Zahl unter dem Namen zeigt, wie viele Anfragen darin liegen.

| Ansicht | Enthält die Status |
| :- | :- |
| **Handlungsbedarf** | Neu, Handlungsbedarf, Buchung angefragt, Angebot abgelaufen |
| **Wartend** | Wartet auf Antwort, Angebot gesendet |
| **Alle** | Alle Anfragen |
| **Erledigt** | Erledigt |
| **Archiviert** | Archiviert |

Die Tabelle zeigt unter anderem die Spalten **Anfrage** (das Anliegen oder eine Zusammenfassung der E-Mail), **Anfrageformular**, **Bearbeitungsstatus** und **Angefragte Buchungen**. Mit dem Filter **Anfrage-Status** grenzt du die Liste weiter ein. Über **Anfrageformulare verwalten** in der Werkzeugleiste gelangst du direkt zu deinen Formularen.

Klicke auf eine Zeile, um die Anfrage in einem Seitenpanel zu öffnen. Mit den Pfeilen oben im Panel springst du zur vorherigen oder nächsten Anfrage.

## Anfrage-Status

Den Status musst du in der Regel nicht selbst pflegen. anny setzt ihn automatisch, sobald etwas passiert:

| Status | Bedeutung | Wann anny ihn setzt |
| :- | :- | :- |
| **Neu** | Die Anfrage ist gerade eingegangen. | Eine neue Anfrage kommt an. |
| **Handlungsbedarf** | Die Kundin hat sich gemeldet. | Die Kundin schreibt erneut. |
| **Buchung angefragt** | Eine Buchung wartet auf deine Freigabe. | Eine Buchung zur Anfrage muss bestätigt werden. |
| **Wartet auf Antwort** | Du hast geantwortet, der Ball liegt bei der Kundin. | Dein Team schreibt der Kundin. |
| **Angebot gesendet** | Die Kundin hat ein Angebot erhalten. | Du sendest ein Angebot. |
| **Angebot abgelaufen** | Das Angebot wurde nicht rechtzeitig angenommen. | Die Gültigkeit endet, ohne dass unterschrieben wurde. |
| **Erledigt** | Die Anfrage ist abgeschlossen. | Die letzte angefragte Buchung ist entschieden oder das letzte Angebot bestätigt. |
| **Archiviert** | Die Anfrage wird nicht weiterverfolgt. | Nur von Hand. |

<Note>
  Anfragen werden keiner Person zugewiesen. Wenn sich jemand Bestimmtes kümmern soll, lege im Verlauf eine Aufgabe an und weise sie zu. Mehr dazu unter [Aktivitäts-Log](/activity-log).
</Note>

## Eine Anfrage bearbeiten

Im Seitenpanel siehst du links die Details der Anfrage und rechts den Verlauf.

* **Zusammenfassung**: Anfrage-Status, angefragte Buchungen, Kund:in und das Anliegen.
* **Formularantworten**: Über welchen **Kanal** die Anfrage kam (zum Beispiel **Website-Formular** oder **Telefon-Assistent**), wann sie übermittelt wurde, über welches **Anfrageformular** und alle Antworten.
* **Buchungen**, **Produkte**, **Rechnungen** und weitere Bereiche wie bei jeder Bestellung.

### Antworten

Schreibe der Kundin direkt im Verlauf rechts eine E-Mail. Die Anfrage wechselt dann auf **Wartet auf Antwort**. Antwortet die Kundin, landet ihre E-Mail im Verlauf, dein Team wird benachrichtigt und die Anfrage wechselt auf **Handlungsbedarf**. Wie du E-Mails schreibst und Notizen anlegst, erfährst du im Artikel [Aktivitäts-Log](/activity-log).

Kam die Anfrage ohne Kund:in an, zum Beispiel über eine weitergeleitete E-Mail, klicke in der **Zusammenfassung** auf **Kunden hinzufügen**.

### Angefragte Buchungen annehmen oder ablehnen

Hat die Kundin Buchungen angefragt, die du freigeben musst, zeigt die **Zusammenfassung** die Zeile **Angefragte Buchungen**. Klicke dort auf **Buchungen akzeptieren** oder **Buchungen ablehnen**. Sobald alle angefragten Buchungen entschieden sind, wechselt die Anfrage auf **Erledigt**.

### Buchungen vorschlagen

Um der Kundin einen Termin vorzuschlagen, ohne die Ressource zu blockieren, legst du eine transparente Buchung an. Schließe dazu im [Kalender](/calendar) eine Buchung zu dieser Bestellung mit der Option **Transparente Buchungen** ab. Transparente Buchungen belegen keine Kapazität, die Ressource bleibt für andere buchbar.

Enthält eine Anfrage einen eindeutigen Wunschtermin mit Ressource und Service, legt anny automatisch einen solchen Buchungsvorschlag an. Prüfe ihn, bevor du ihn bestätigst oder in ein Angebot übernimmst.

Um einen Vorschlag direkt fest zu buchen, wähle an der Buchung **Buchung bestätigen**. anny prüft die Verfügbarkeit, bestätigt die Buchung und belegt ab dann die Kapazität. Mit **Bestätigung per E-Mail an den Kunden senden** informierst du die Kundin gleich mit.

### Ein Angebot senden

<Steps>
  <Step title="Rechnungsentwurf prüfen">
    Öffne in der Anfrage den Bereich **Rechnungen**. Prüfe den **Rechnungsentwurf** mit allen Buchungen und Produkten.

    Über **Angebot erstellen** kannst du dir das Angebot vorab als PDF ansehen.
  </Step>

  <Step title="Angebot vorbereiten">
    Klicke auf **Als Angebot senden**.

    anny erstellt das Angebots-PDF und öffnet ein Fenster zum Versand.
  </Step>

  <Step title="E-Mail und Gültigkeit festlegen">
    Prüfe **Empfänger**, **Betreff** und Text. Unter **Gültig bis** legst du fest, bis wann die Kundin das Angebot annehmen kann. Vorbelegt sind 14 Tage.

    Das Datum steht auf dem Angebot.
  </Step>

  <Step title="Buchungen reservieren (optional)">
    Aktiviere **Buchungen reservieren**, wenn die vorgeschlagenen Buchungen ihren Zeitraum ab dem Versand blockieren sollen. Mit **Buchungen mit dem Angebot ablaufen lassen** geben sie reservierte Plätze wieder frei, wenn das Angebot nicht rechtzeitig unterschrieben wird.

    Transparente Buchungen werden beim Senden zu Buchungsvorschlägen.
  </Step>

  <Step title="Senden">
    Sende das Angebot ab.

    Die Kundin erhält das Angebot per E-Mail mit einem Button, um es online anzunehmen und zu unterschreiben. Die Anfrage wechselt auf **Angebot gesendet**.
  </Step>
</Steps>

<Warning>
  Ist beim Senden mit **Buchungen reservieren** ein Zeitraum nicht mehr frei, sendet anny das Angebot nicht. Passe die Buchungen an und versuche es erneut.
</Warning>

Unter **Gesendete Angebote** siehst du den Stand jedes Angebots, zum Beispiel **Nicht unterschrieben** oder wer wann unterschrieben hat. Das unterschriebene Angebot legt anny als PDF an der Bestellung ab. Bestätige danach die vorgeschlagenen Buchungen mit **Buchung bestätigen**. Sobald keine Buchung mehr offen ist, wechselt die Anfrage auf **Erledigt**.

Zu jedem Angebot hast du diese Aktionen:

* **Für Kunden annehmen**: Die Kundin hat telefonisch oder per E-Mail zugestimmt. Die Annahme wird in deinem Namen gespeichert und die vorgeschlagenen Buchungen werden gleich bestätigt.
* **Gültigkeit verlängern**: Die Kundin bekommt mehr Zeit. Das PDF behält das ursprüngliche Datum, die Unterschriftsseite nutzt das neue.
* **Angebot zurückziehen**: Die Kundin kann das Angebot nicht mehr unterschreiben, zum Beispiel weil du ein korrigiertes Angebot senden willst.

### Anfrage abschließen oder archivieren

Im Feld **Anfrage-Status** der **Zusammenfassung** kannst du eine Anfrage **Als erledigt markieren**, **Archivieren** oder die **Archivierung aufheben**.

* **Als erledigt markieren** geht erst, wenn keine angefragte Buchung mehr offen ist und alle transparenten Buchungen bestätigt oder entfernt sind.
* **Archivieren** geht, sobald alle angefragten Buchungen entschieden sind. Offene transparente Buchungen entfernt anny dabei. Bestellung, Korrespondenz, Dateien, angenommene Buchungen und gesendete Angebote bleiben erhalten.
* **Archivierung aufheben** holt die Anfrage mit dem Status **Handlungsbedarf** zurück.

## Eine Anfrage selbst erfassen

<Steps>
  <Step title="Neue Anfrage öffnen">
    Klicke in der Anfragen-Übersicht auf **Neu**.

    Das Fenster **Neue Anfrage** öffnet sich.
  </Step>

  <Step title="Formular wählen und ausfüllen">
    Wähle unter **Anfrageformular** das passende Formular und fülle die Felder für die Kundin aus.

    Du siehst dieselben Fragen wie die Kundin auf deiner Website.
  </Step>

  <Step title="Anfrage anlegen">
    Klicke auf **Anfrage erstellen**.

    Die neue Anfrage öffnet sich im Seitenpanel. Als Kanal steht dort **Vom Team erfasst**.
  </Step>
</Steps>

## Anfrageformulare

Ein Anfrageformular fragt ab, was du zu einer Anfrage wissen musst, zum Beispiel Art der Veranstaltung, Wunschdatum und Personenzahl. Jede Einsendung kommt als Anfrage bei dir an. Du findest deine Formulare in der Seitenleiste unter **Katalog** → **Anfrageformulare**.

Die Liste zeigt pro Formular, wo es **Verfügbar** ist (**Website**, **KI** oder **Nicht verfügbar**), die **Tags**, wie viele Fragengruppen es hat und wie viele **Anfragen** darüber eingegangen sind.

### Anfrageformular anlegen

<Steps>
  <Step title="Formular anlegen">
    Klicke unter **Anfrageformulare** auf **Neu**. Gib einen Namen und eine Beschreibung ein und wähle die Fragengruppen, die das Formular abfragen soll.

    Klicke auf **Anfrageformular erstellen**. Die Detailseite des Formulars öffnet sich.
  </Step>

  <Step title="Fragen zusammenstellen">
    Im Bereich **Formulare** ziehst du Fragengruppen in das Formular und bringst sie in die gewünschte Reihenfolge. Über **Neu** legst du eine neue Fragengruppe an.

    Kund:innen beantworten die Fragengruppen in der gezeigten Reihenfolge. Die Antworten werden an der Anfrage gespeichert.
  </Step>

  <Step title="Verfügbarkeit einschalten">
    Schalte unter **Verfügbarkeit** **Auf der Website** und bei Bedarf **Für KI-Assistenten** ein und speichere.

    Das Formular nimmt ab jetzt Anfragen an.
  </Step>
</Steps>

<Frame>
  <img alt="Detailseite des Anfrageformulars Private event im Reiter Allgemeine Informationen mit Name, Beschreibung, Tags und den Schaltern für Kundenadresse, eigene Nachricht und Verfügbarkeit" />
</Frame>

### Einstellungen

| Einstellung | Wirkung |
| :- | :- |
| **Name** und **Beschreibung** | Erscheinen über dem Formular. Erkläre in der Beschreibung, wofür das Formular gedacht ist. |
| **Tags** | Ordnen das Formular für die Filter in der Liste ein. |
| **Kundenadresse abfragen** | Das Formular fragt zusätzlich die Anschrift ab. |
| **Eigene Nachricht** | Zeigt ein Freitextfeld für das Anliegen in eigenen Worten. Die Nachricht erscheint im Verlauf als E-Mail der Kundin. |
| **Auf der Website** | Kund:innen können über den Formularlink und die eingebetteten Varianten Anfragen senden. |
| **Für KI-Assistenten** | Telefon- und Chat-Assistenten können mit diesem Formular Anfragen aufnehmen. |

<Note>
  Ein Formular kann erst verfügbar werden, wenn es mindestens eine Fragengruppe hat. Außerdem nimmt es erst Anfragen an, wenn deine Organisation live ist.
</Note>

### Formular teilen und einbetten

Im Bereich **Teilen & Einbetten** findest du alles, um das Formular zu veröffentlichen:

* **Formularlink**: Ein direkter Link zum Formular, zum Beispiel für E-Mails oder Social Media. Unter **Sprache des Links** legst du fest, in welcher Sprache es sich öffnet. Mit **Automatisch (Sprache der Besucher)** passt es sich an.
* **Formular**: Bettet das Formular direkt in eine Seite deiner Website ein.
* **Button**: Ein Button, der das Formular in einem Pop-up öffnet.

Kopiere den Code der gewünschten Variante und füge ihn auf deiner Website ein. Ist das Formular noch nicht verfügbar, zeigen Link und Einbettungen das deinen Besucher:innen an.

Ein Formular löschst du in der Liste über das Drei-Punkte-Menü. Das öffentliche Formular nimmt danach keine Anfragen mehr an, bereits eingegangene Anfragen behalten ihre Antworten.

## Anfragen per E-Mail empfangen

Viele Anfragen kommen per E-Mail. Damit du sie nicht zwischen Postfach und anny abgleichen musst, leitest du sie an eine geheime Adresse weiter. anny legt jede neue E-Mail als Anfrage an, ordnet sie wenn möglich der Kundin zu und fasst sie automatisch zusammen. Antworten schickst du dann direkt aus anny.

### E-Mail-Empfang einrichten

<Steps>
  <Step title="Einstellungen öffnen">
    Öffne in der Seitenleiste unter **Account** die **Einstellungen** und wechsle zum Reiter **Anfragen**.

    Du siehst eine Erklärung in drei Schritten: **Weiterleiten**, **Erfassen**, **Antworten**.
  </Step>

  <Step title="E-Mail-Empfang einschalten">
    Schalte den Schalter in der Karte **Anfragen** ein.

    anny zeigt dir deine **Geheime E-Mail-Adresse**.
  </Step>

  <Step title="Adresse kopieren">
    Kopiere die Adresse über das Kopier-Icon im Feld.

    Du kannst sie jetzt in deinem Postfach als Weiterleitungsziel eintragen.
  </Step>

  <Step title="Absender einschränken (optional)">
    Trage unter **Erlaubte Absender** die E-Mail-Adressen oder Domains ein, von denen anny E-Mails annehmen soll, zum Beispiel `person@example.com` oder `example.com`. Klicke auf **Hinzufügen**.

    anny nimmt ab jetzt nur noch E-Mails von diesen Absendern an.
  </Step>
</Steps>

<Frame>
  <img alt="Einstellungen im Reiter Anfragen mit eingeschaltetem E-Mail-Empfang, der geheimen E-Mail-Adresse, dem Button Neue Adresse erzeugen und zwei erlaubten Absendern" />
</Frame>

Ohne Einträge unter **Erlaubte Absender** nimmt anny E-Mails von allen Absendern an. Antworten deiner Kund:innen auf E-Mails aus anny kommen immer an, auch wenn ihre Adresse nicht in der Liste steht.

<Warning>
  Nutze die geheime Adresse nur für interne Weiterleitungen und gib sie nicht an Kund:innen weiter. Kund:innen antworten an eine separate Adresse, die anny automatisch setzt.
</Warning>

### Einzeln weiterleiten oder per Weiterleitungsregel

Du hast zwei Möglichkeiten, E-Mails an anny zu schicken:

* **Einzeln weiterleiten**: Du leitest nur ausgewählte E-Mails von Hand weiter.
* **Weiterleitungsregel**: Du richtest in deinem Postfach eine Regel ein, die zum Beispiel alle E-Mails an `anfragen@deine-firma.de` automatisch an die geheime Adresse schickt.

Der Unterschied zeigt sich bei der Zuordnung zur Kundin. anny ordnet eine E-Mail anhand der Absenderadresse einer bestehenden Kundin zu oder legt eine neue an. Das klappt nur, wenn die E-Mail als Original ankommt. Erkennt anny eine E-Mail als von Hand weitergeleitet, zum Beispiel am Betreff „Fwd:“ oder „WG:“, oder als automatische Nachricht, bleibt die Anfrage ohne Kund:in. Füge sie dann in der Anfrage über **Kunden hinzufügen** hinzu.

<Tip>
  Nutze möglichst eine Weiterleitungsregel, die die Originalnachricht weitergibt. So erkennt anny die Absenderin und ordnet die Anfrage direkt der richtigen Kundin zu.
</Tip>

### Was mit einer weitergeleiteten E-Mail passiert

* Jede neue E-Mail wird zu einer Anfrage mit Status **Neu**. Betreff und Text stehen am Anfang, anny ersetzt sie durch eine kurze Zusammenfassung in der Spalte **Anfrage**.
* Dein Team wird über die neue Anfrage benachrichtigt.
* Nennt die E-Mail einen eindeutigen Termin mit Ressource und Service, legt anny einen Buchungsvorschlag an, der keine Kapazität belegt.
* Antwortet die Kundin später auf eine E-Mail aus anny, ordnet anny die Antwort der richtigen Anfrage zu. Es entsteht keine neue Anfrage.

### Neue Adresse erzeugen

Ist die geheime Adresse in falsche Hände geraten oder bekommst du Spam, klicke auf **Neue Adresse erzeugen**. Die bisherige Adresse wird sofort ungültig. Passe danach deine Weiterleitungsregeln an. Antworten von Kund:innen auf bestehende Anfragen kommen weiterhin an.

## Wann nutze ich das?

* **Firmenevents und Raumanmietungen**: Ein Anfrageformular „Private Veranstaltung“ fragt Datum, Personenzahl und Catering ab. Du schickst ein Angebot mit reservierten Buchungen.
* **Bestehendes Anfrage-Postfach**: Eine Weiterleitungsregel schickt alle E-Mails an deine Anfrage-Adresse an anny. Dein Team arbeitet sie in der Ansicht **Handlungsbedarf** ab.
* **Anfragen am Telefon**: Dein Telefon-Assistent nimmt Anfragen mit einem Anfrageformular auf, das **Für KI-Assistenten** freigegeben ist.
* **Anrufe im Team**: Nach einem Telefonat erfasst du die Anfrage über **Neu** und schickst später das Angebot.

## FAQ

<AccordionGroup>
  <Accordion title="Ist eine Anfrage schon eine Buchung?">
    Nein. Eine Anfrage ist eine Bestellung im Entwurf, ihre Buchungen sind zunächst nur Vorschläge. Fest sind sie erst, wenn du sie bestätigst oder unter **Gesendete Angebote** auf **Für Kunden annehmen** klickst.
  </Accordion>

  <Accordion title="Blockieren Buchungsvorschläge meinen Kalender?">
    Nein. Transparente Buchungen und Vorschläge belegen keine Kapazität. Sie blockieren den Zeitraum erst, wenn du sie bestätigst oder beim Senden des Angebots **Buchungen reservieren** aktivierst.
  </Accordion>

  <Accordion title="Kann ich den Anfrage-Status selbst ändern?">
    Du kannst eine Anfrage **Als erledigt markieren**, **Archivieren** oder die **Archivierung aufheben**. Alle anderen Status setzt anny automatisch.
  </Accordion>

  <Accordion title="Wie nimmt die Kundin ein Angebot an?">
    Sie öffnet den Link in der Angebots-E-Mail und unterschreibt online. Danach bestätigst du die vorgeschlagenen Buchungen. Stimmt sie per Telefon oder E-Mail zu, klickst du unter **Gesendete Angebote** auf **Für Kunden annehmen**. Dabei werden die Buchungen direkt bestätigt.
  </Accordion>

  <Accordion title="Was passiert, wenn ein Angebot abläuft?">
    Die Kundin kann es nicht mehr unterschreiben und die Anfrage wechselt auf **Angebot abgelaufen**. Hast du **Buchungen mit dem Angebot ablaufen lassen** gewählt, geben die Buchungen ihre Plätze frei. Du kannst die **Gültigkeit verlängern** oder ein neues Angebot senden.
  </Accordion>

  <Accordion title="Bekommen Kund:innen eine Bestätigung, wenn sie ein Anfrageformular absenden?">
    Nach dem Absenden sehen sie auf der Seite die Meldung **Anfrage erhalten**. Eine Bestätigungs-E-Mail verschickt anny nicht. Deine erste Antwort schreibst du im Verlauf der Anfrage.
  </Accordion>

  <Accordion title="Wer im Team wird über neue Anfragen benachrichtigt?">
    Alle, die in ihren Benachrichtigungen **Kundennachrichten** eingeschaltet haben. Darüber laufen sowohl neue Anfragen als auch Antworten von Kund:innen per E-Mail.
  </Accordion>

  <Accordion title="Sehen Kund:innen die geheime E-Mail-Adresse?">
    Nein. Antworten an Kund:innen verschickt anny mit einer eigenen Antwortadresse. Die geheime Adresse brauchst du nur für die Weiterleitung aus deinem Postfach.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Eine weitergeleitete E-Mail hat keine Kund:in">
    anny ordnet keine Kund:in zu, wenn die E-Mail als von Hand weitergeleitet oder automatisch erkannt wird, zum Beispiel am Betreff „Fwd:“ oder „WG:“. Klicke in der **Zusammenfassung** auf **Kunden hinzufügen**. Für künftige E-Mails hilft eine Weiterleitungsregel, die die Originalnachricht weitergibt.
  </Accordion>

  <Accordion title="Eine weitergeleitete E-Mail kommt nicht an">
    Prüfe, ob der Empfang im Reiter **Anfragen** eingeschaltet ist und du die aktuelle Adresse verwendest. Hast du **Erlaubte Absender** eingetragen, muss die weiterleitende Adresse oder ihre Domain in der Liste stehen. Wurde eine neue Adresse erzeugt, passe deine Weiterleitungsregel an.
  </Accordion>

  <Accordion title="Ich kann die Anfrage nicht als erledigt markieren">
    Es gibt noch offene Buchungen. Nimm angefragte Buchungen an oder lehne sie ab und bestätige oder entferne offene transparente Buchungen. anny zeigt dir im Feld **Anfrage-Status**, was noch fehlt.
  </Accordion>

  <Accordion title="Der Button Als Angebot senden fehlt oder ist nicht klickbar">
    Das Angebot braucht einen Rechnungsbetrag über 0 und eine E-Mail-Adresse der Kundin. Fehlt die Adresse, siehst du den Hinweis „Füge im Kundenbereich eine E-Mail-Adresse hinzu, um das Angebot zu senden.“ Außerdem brauchst du das Recht, Bestellungen zu bearbeiten.
  </Accordion>

  <Accordion title="Das Anfrageformular nimmt keine Anfragen an">
    Prüfe, ob das Formular mindestens eine Fragengruppe hat, unter **Verfügbarkeit** **Auf der Website** eingeschaltet und gespeichert ist und deine Organisation live ist.
  </Accordion>

  <Accordion title="Ich sehe den Reiter Anfragen in den Einstellungen nicht">
    Den E-Mail-Empfang dürfen nur Personen einrichten, die die Organisation bearbeiten dürfen. Bitte eine Person mit Admin-Rechten, den Empfang einzurichten.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Anfrage = Bestellung (Entwurf) mit `inquiry_status`. Quellen (`inbox_source`): Anfrageformular (form), E-Mail über geheime Adresse (email), KI-Assistent (chat, voice), vom Team erfasst. Eine Kundenantwort auf eine bestehende Buchung/Bestellung macht diese ebenfalls zur Anfrage. Keine Zuweisung an Personen (stattdessen Aufgabe im Verlauf).
> * Seitenleiste **Management** → **Anfragen**; Ansichten **Handlungsbedarf** (Neu, Handlungsbedarf, Buchung angefragt, Angebot abgelaufen), **Wartend** (Wartet auf Antwort, Angebot gesendet), **Alle**, **Erledigt**, **Archiviert**. Spalten u. a. **Anfrage**, **Anfrageformular**, **Bearbeitungsstatus**, **Angefragte Buchungen**, **Vorschläge**. Filter **Anfrage-Status**. Link **Anfrageformulare verwalten**. Zeile öffnet Seitenpanel (Bestell-Details + Verlauf).
> * Automatische Status: neue Anfrage → Neu; Kundin schreibt → Handlungsbedarf; Buchung wartet auf Freigabe → Buchung angefragt; Team schreibt → Wartet auf Antwort; Angebot gesendet → Angebot gesendet; unsigniert abgelaufen → Angebot abgelaufen; letzte angefragte Buchung entschieden bzw. letztes Angebot bestätigt → Erledigt. Von Hand: **Als erledigt markieren** (nur ohne offene angefragte und transparente Buchungen), **Archivieren** (nur ohne unentschiedene angefragte Buchungen; entfernt offene transparente Buchungen), **Archivierung aufheben**.
> * Panel: **Zusammenfassung** (Anfrage-Status, **Angefragte Buchungen** mit **Buchungen akzeptieren**/**Buchungen ablehnen**, **Kunden hinzufügen**), **Formularantworten** (**Kanal**: Website-Formular, Chat-Assistent, Telefon-Assistent, Vom Team erfasst; **Übermittelt**; **Anfrageformular**). Antworten per E-Mail im Verlauf.
> * Vorschläge: transparente Buchungen (belegen keine Kapazität) über Kalender-Abschluss **Transparente Buchungen**; KI legt bei eindeutigem Termin + Ressource + Service automatisch einen Vorschlag an (aus Formular, E-Mail, Kundenantwort). **Buchung bestätigen** prüft Verfügbarkeit, optional **Bestätigung per E-Mail an den Kunden senden**.
> * Angebot: Bereich **Rechnungen** → **Rechnungsentwurf**, **Angebot erstellen** (PDF), **Als Angebot senden** (Betrag > 0, E-Mail der Kundin, Bearbeitungsrecht). Fenster: **Empfänger**, **Betreff** („Angebot zu Nummer“), Text, **PDF aktualisieren**, **Gültig bis** (Standard +14 Tage), **Buchungen reservieren** (sendet nicht, wenn Zeitraum belegt; Vorlaufzeit ignoriert), **Buchungen mit dem Angebot ablaufen lassen**. Transparente Buchungen werden beim Senden zu Vorschlägen. Kundin unterschreibt online (Unterschrift bestätigt die Buchungen nicht, das Team bestätigt danach; signiertes PDF an der Bestellung). **Gesendete Angebote**: **Für Kunden annehmen** (bestätigt die Vorschläge gleich), **Gültigkeit verlängern** (PDF behält Datum), **Angebot zurückziehen**.
> * **Neu** → Fenster **Neue Anfrage**: **Anfrageformular** wählen, Felder ausfüllen, **Anfrage erstellen**; öffnet im Panel.
> * Anfrageformulare: **Katalog** → **Anfrageformulare**; Spalten Name, **Verfügbar** (Website, KI, Nicht verfügbar), Tags, **Fragen** (n Fragengruppen / Noch keine Fragen), **Anfragen**. **Neu** → **Anfrageformular erstellen**. Detail: **Allgemeine Informationen** (Name, Beschreibung, Tags, **Kundenadresse abfragen**, **Eigene Nachricht**, **Verfügbarkeit**: **Auf der Website**, **Für KI-Assistenten**), **Formulare** (Fragengruppen, Reihenfolge), **Teilen & Einbetten** (**Formularlink**, **Sprache des Links**, Einbettung **Formular** und **Button**). Verfügbar erst mit mindestens einer Fragengruppe; Annahme erst, wenn Organisation live. Löschen: öffentliches Formular nimmt nichts mehr an, bestehende Antworten bleiben.
> * E-Mail-Empfang: **Account** → **Einstellungen** → Reiter **Anfragen** (Recht: Organisation bearbeiten). Schalter **Anfragen per E-Mail empfangen**, **Geheime E-Mail-Adresse** (in-…@…; nur intern, Kund:innen antworten an separate Adresse), **Neue Adresse erzeugen** (alte sofort ungültig, Weiterleitungsregeln anpassen, bestehende Kundenantworten funktionieren weiter), **Erlaubte Absender** (Adressen oder Domains; leer = alle; Kundenantworten ausgenommen). Leerzustand der Anfragen-Übersicht: **E-Mail-Empfang einrichten**.
> * Neue E-Mail → Anfrage Neu, Team-Benachrichtigung, KI-Zusammenfassung in **Anfrage**, ggf. Buchungsvorschlag. Kundenzuordnung per Absender nur bei Original-E-Mails; als weitergeleitet erkannt (Betreff Fwd:/FW:/WG:, Absender wie noreply, Text „weitergeleitete Nachricht“, abweichendes Reply-To) oder automatisch → keine Kund:in. Antworten werden über die E-Mail-Header der richtigen Anfrage zugeordnet.
> * In der Oberfläche heißt die Funktion nicht „Magic Inbox“, sondern Anfragen per E-Mail / E-Mail-Empfang.


# Rechnung korrigieren oder stornieren
Source: https://docs.anny.co/invoice-corrections

Storniere Rechnungen vollständig, wähle die Erstattung als Geld oder Wertgutschein und erstelle Korrekturrechnungen.

Festgeschriebene und versendete Rechnungen lassen sich in anny nachträglich nicht direkt ändern, um eine nachvollziehbare Buchhaltung zu ermöglichen. Stattdessen erstellst du Storno- oder Korrekturrechnungen. Rechnungen im Entwurfsstatus kannst du weiterhin direkt über das Stift-Symbol bearbeiten.

Warum das so ist und was beim Festschreiben technisch passiert, steht unter [GoBD bei anny](/gobd).

## Buchung vollständig stornieren

Nutze diesen Weg, wenn eine Buchung komplett storniert und der Betrag erstattet werden soll. Bei einer festgeschriebenen Rechnung öffnet anny danach ein Modal. Dort wählst du, ob du das Geld zurückerstattest oder einen Wertgutschein ausstellst.

<Steps>
  <Step title="Bestellung öffnen">
    Navigiere zu **Bestellungen** in der Menüleiste. Suche und wähle die betroffene Bestellung aus.
  </Step>

  <Step title="Buchung stornieren oder ablehnen">
    Im Abschnitt **Buchungen** klickst du auf die **drei Punkte** neben der Buchung. Wähle eine der Optionen:

    * **Stornieren**: Erstattung gemäß den konfigurierten Stornierungsbedingungen, ggf. Teilerstattung
    * **Ablehnen**: Vollständige Erstattung unabhängig von Stornierungsbedingungen

    Es öffnet sich **Buchung stornieren** bzw. **Buchung ablehnen**. Eine Notiz ist optional. Die Glocke **Kunde benachrichtigen** ist standardmäßig aktiv.
  </Step>

  <Step title="Korrektur-Dialog prüfen">
    War die Originalrechnung bereits festgeschrieben, erscheint ein Modal mit der Korrekturrechnung. Die Überschrift nennt den Erstattungsbetrag, zum Beispiel **Die Änderung der Buchung führt zu einer Erstattung von 50,00 €**.

    Dieselbe Korrektur siehst du auf der Bestellseite im Panel **Neue Rechnung**.
  </Step>

  <Step title="Erstattungsart wählen">
    Klicke auf den Pfeil neben **Fertigstellen mit Rückerstattung** (**Mehr Optionen**). Im Dropdown stehen:

    * **Rückerstattung senden**: Das Geld geht an die ursprüngliche Online-Zahlung zurück.
    * **Rückerstattung als Gutschein** plus Name des Wertgutscheins: Die Kund:in erhält einen Buchungscode in Höhe des Erstattungsbetrags.

    Der Button **Fertigstellen mit Rückerstattung** selbst führt **Rückerstattung senden** aus. Den Wertgutschein wählst du nur über den Dropdown-Eintrag.
  </Step>

  <Step title="Korrektur fertigstellen">
    Lass die Glocke **Kunde benachrichtigen** aktiv, wenn die Kund:in die Korrekturrechnung per E-Mail erhalten soll. Alternativ **Fertigstellen ohne Erstattung**: Die Korrekturrechnung wird festgeschrieben, es fließt kein Geld zurück.
  </Step>
</Steps>

Sobald die Korrekturrechnung fertiggestellt ist, erscheint sie unter **Rechnungsverlauf**. Bei **Rückerstattung als Gutschein** kann die Kund:in den Buchungscode bei der nächsten Buchung einlösen.

<Frame>
  <img alt="Korrektur-Dialog nach Storno: geöffnetes Dropdown am Button Fertigstellen mit Rückerstattung, mit den Optionen Rückerstattung senden und Rückerstattung als Gutschein" />
</Frame>

<Tip>
  Die Erstattung startet nicht schon beim Klick auf **Stornieren** oder **Ablehnen**. Du schließt sie erst im Korrektur-Modal ab. **Rückerstattung als Gutschein** erscheint nur, wenn in der Organisation mindestens ein [Wertgutschein](/value-vouchers) existiert. Fehlt eine erstattungsfähige Online-Zahlung, zeigt anny einen Hinweis: Du musst den Betrag außerhalb von anny erstatten.
</Tip>

## Teilstornierung oder Korrekturrechnung erstellen

Nutze diesen Weg, wenn nur ein Teilbetrag erstattet oder eine Position korrigiert werden soll.

<Steps>
  <Step title="Bestellung öffnen">
    Gehe zu **Bestellungen** und wähle die betroffene Bestellung aus.
  </Step>

  <Step title="Neue Rechnung anlegen">
    Klicke auf **+ Neue Rechnung**. Es öffnet sich ein leerer Rechnungsentwurf.
  </Step>

  <Step title="Stornobetrag eintragen">
    Gib den Betrag ein, den du erstatten möchtest, und markiere ihn mit einem **negativen Vorzeichen** (z. B. -25,00 €). Trage eine aussagekräftige Beschreibung ein, die auf die ursprüngliche Rechnung verweist.
  </Step>

  <Step title="Entwurf prüfen und fertigstellen">
    Speichere als Entwurf, wenn du später noch ändern möchtest. Klicke auf **Fertigstellen**, um die Korrekturrechnung festzuschreiben und zu versenden. Ist der Betrag negativ und eine Online-Zahlung erstattungsfähig, gelten dieselben Optionen **Fertigstellen mit Rückerstattung**, **Rückerstattung senden** und **Rückerstattung als Gutschein**.
  </Step>
</Steps>

<Warning>
  Eine Rückerstattung über Stripe ist nur bis **180 Tage** nach Zahlungseingang möglich. Ältere Buchungen müssen manuell außerhalb des Systems erstattet werden.
</Warning>

Die Korrekturrechnung erhält eine neue Rechnungsnummer und sollte in der Beschreibung auf die ursprüngliche Rechnungsnummer verweisen.

## Rechnungsadresse nachträglich ändern

Wenn sich die Rechnungsadresse des Kunden geändert hat, kannst du diese korrigieren. anny erstellt dabei automatisch eine neue Rechnung mit der aktualisierten Adresse.

<Steps>
  <Step title="Bestellung öffnen">
    Gehe zu **Bestellungen** und wähle die betroffene Bestellung aus.
  </Step>

  <Step title="Empfänger bearbeiten">
    Klicke auf die **drei Punkte (...)** neben der Rechnung und wähle **Empfänger bearbeiten**.
  </Step>

  <Step title="Automatische Korrektur">
    anny macht die ursprüngliche Rechnung automatisch nichtig und erstellt eine neue Korrekturrechnung mit dem gleichen Betrag und der aktualisierten Adresse.
  </Step>
</Steps>

## Ergebnis prüfen

Nach der Korrektur erkennst du den Erfolg daran, dass:

* Die Stornorechnung oder Korrekturrechnung in der Rechnungsübersicht mit eigener Rechnungsnummer erscheint
* Bei vollständiger Stornierung mit **Rückerstattung senden** der Rechnungsstatus auf "Rückerstattet" wechselt
* Bei **Rückerstattung als Gutschein** der Buchungscode als Vorauszahlung auf der Korrekturrechnung steht. Die Originalzahlung wird dann nicht zurückgebucht.
* Bei Adressänderung die alte Rechnung als nichtig markiert ist und eine neue aktive Rechnung vorliegt

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich eine Rechnung im Entwurfsstatus auch korrigieren?">
    Ja, und das ist sogar einfacher. Rechnungen im Entwurfsstatus bearbeitest du direkt über das Stift-Symbol. Du brauchst keine Korrekturrechnung, da der Entwurf noch nicht festgeschrieben wurde.
  </Accordion>

  <Accordion title="Wird der Kunde über die Stornierung informiert?">
    Beim Statuswechsel und beim Fertigstellen der Korrekturrechnung steuerst du das mit der Glocke **Kunde benachrichtigen**. Standardmäßig ist sie aktiv. Wählst du **Rückerstattung als Gutschein**, erhält die Kund:in zusätzlich den Buchungscode.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Rückerstattung senden und Rückerstattung als Gutschein?">
    **Rückerstattung senden** zahlt den Betrag auf die ursprüngliche Online-Zahlung zurück. **Rückerstattung als Gutschein** erstellt einen Buchungscode in Höhe des Erstattungsbetrags. Die Kund:in löst ihn bei einer späteren Buchung ein. Das Geld bleibt im Unternehmen.
  </Accordion>

  <Accordion title="Was passiert mit dem Zahlungsstatus nach einer Stornierung?">
    Nach **Rückerstattung senden** setzt anny den Status bei Online-Zahlung auf "Rückerstattet". Nach **Rückerstattung als Gutschein** bleibt die Originalzahlung bestehen, weil der Betrag als Gutschein gutgeschrieben wird. Bei Offline-Zahlung oder **Fertigstellen ohne Erstattung** passt du den Geldfluss außerhalb von anny an.
  </Accordion>

  <Accordion title="Kann ich mehrere Korrekturrechnungen zu einer Bestellung erstellen?">
    Ja. Du kannst beliebig viele Rechnungen zu einer Bestellung hinzufügen. Jede erhält eine eigene Rechnungsnummer. Offene Änderungen einer Bestellung fasst anny in einer Korrektur zusammen.
  </Accordion>

  <Accordion title="Wann muss ich außerhalb von anny erstatten?">
    Immer dann, wenn anny den Betrag nicht über Stripe zurückbuchen kann:

    * Die ursprüngliche Zahlung war **offline** (Überweisung, bar, vor Ort). Nutze **Fertigstellen ohne Erstattung**.
    * Die Stripe-Zahlung liegt **mehr als 180 Tage** zurück. Das Limit setzt Stripe, nicht anny.
    * Nur ein Teilbetrag ist über Stripe erstattbar. Die UI zeigt den maximal automatisch erstattbaren Betrag; den Rest erstattest du außerhalb von anny.
    * Die Erstattung schlägt fehl, z. B. weil das Konto der Kund:in geschlossen ist, das Mandat widerrufen wurde oder auf dem Stripe-Connect-Konto nicht genug Guthaben für die Rückbuchung liegt.
  </Accordion>

  <Accordion title="Gelten für TWINT und PayPal andere Erstattungsfristen?">
    Nein. TWINT und PayPal laufen über denselben Stripe-Erstattungsweg wie Karten. Es gibt in anny keine kürzere oder längere methodeabhängige Frist. Beide Methoden stehen **nicht für Abos** zur Verfügung. Das Stripe-Fenster von 180 Tagen gilt auch hier.
  </Accordion>

  <Accordion title="Wird nach einem Admin-Storno automatisch erstattet?">
    Ja, wenn zur Bestellung eine erfolgreiche Online-Zahlung über Stripe gehört. anny stößt die Erstattung mit der Storno- bzw. Korrekturrechnung an. War die SEPA-Zahlung noch ausstehend, wartet anny bis zum nächsten Tag und versucht die Erstattung erneut. Ohne Stripe-Zahlung bleibt es bei **Fertigstellen ohne Erstattung**.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Option 'Stornieren' ist nicht verfügbar">
    Die Buchung wurde bereits storniert oder die Bestellung enthält keine aktive Buchung mehr. Prüfe den Status der Buchung in der Bestelldetailansicht.
  </Accordion>

  <Accordion title="Nach dem Storno ist kein Geld zurückgekommen">
    Die Korrekturrechnung muss im Modal noch fertiggestellt werden. **Stornieren** allein löst keine Zahlungserstattung aus. Prüfe, ob du **Fertigstellen ohne Erstattung** gewählt hast oder **Rückerstattung als Gutschein** statt **Rückerstattung senden**. Liegt die Zahlung mehr als 180 Tage zurück, musst du außerhalb von anny erstatten.
  </Accordion>

  <Accordion title="Im Dropdown fehlt Rückerstattung als Gutschein">
    Die Option erscheint nur, wenn mindestens ein Wertgutschein als Buchungspaket existiert. Lege unter **Buchungspakete** einen Eintrag im Tab **Wertgutschein** an. Details: [Wertgutscheine](/value-vouchers).
  </Accordion>

  <Accordion title="Nach Adressänderung erhält der Kunde zwei Rechnungen">
    Das ist erwartetes Verhalten. Die ursprüngliche Rechnung wird als nichtig markiert und eine neue Korrekturrechnung mit gleicher Summe erstellt. Beide Dokumente bleiben für die Nachvollziehbarkeit erhalten.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Festgeschriebene Rechnungen sind NICHT bearbeitbar. Korrekturen nur über Storno-/Korrekturrechnung.
> * Rechnungen im Entwurfsstatus: direkt über Stift-Symbol bearbeitbar (kein Korrekturprozess nötig).
> * UI-Pfad Storno: **Bestellungen** → Bestellung → Abschnitt **Buchungen** → drei Punkte → **Stornieren** oder **Ablehnen**. Gleicher Ablauf: Buchungsliste, Buchungsdetail, Kalender.
> * Nach Statuswechsel bei festgeschriebener Originalrechnung: Modal mit Korrekturrechnung (gleicher Editor wie Panel **Neue Rechnung** auf der Bestellung).
> * Primary **Fertigstellen mit Rückerstattung** = Featured-Aktion **Rückerstattung senden** (Geld). Wertgutschein nur über Dropdown **Rückerstattung als Gutschein** plus Name des Pakets.
> * Gutschein-Einträge = alle Buchungspakete mit Zahlungsmittel-Flag (Wertgutscheine). Fehlen sie, nur Geld-Refund im Dropdown.
> * **Fertigstellen ohne Erstattung**: Rechnung wird festgeschrieben, kein Payment-Refund.
> * Teilstornierung: **Neue Rechnung** → negativen Betrag eintragen → Fertigstellen (gleiche Refund-Optionen, wenn Betrag negativ und Zahlung erstattungsfähig).
> * Adressänderung: drei Punkte neben Rechnung → **Empfänger bearbeiten** → alte Rechnung wird nichtig, neue Korrekturrechnung mit gleichem Betrag.
> * Stripe-Limit: Rückerstattung über Stripe nur bis 180 Tage nach Zahlungseingang. Danach manuell außerhalb des Systems.
> * Abgrenzung Service-Einstellung **Stornierung als Wertgutschein**: Default für Kund:innen-Storno, nicht der Admin-Dropdown. Kund:innen-Storno kann den Gutschein automatisch ausstellen, Admin-Storno immer über das Modal.
> * Verwandte Artikel: Wertgutscheine, Stornierungsbedingungen, Rechnungsentwurf, Rechnungsstellung, GoBD.


# Rechnungsentwurf bearbeiten und fertigstellen
Source: https://docs.anny.co/invoice-drafts

Bearbeite offene Rechnungsentwürfe und stelle sie fertig, um die Rechnung an deine Kund:innen zu versenden.

Jede Buchung erzeugt in anny automatisch einen Rechnungsentwurf. Solange die Rechnung im Entwurfsstatus ist, kannst du Positionen anpassen, ergänzen oder entfernen. Erst beim Fertigstellen wird die Rechnung festgeschrieben, erhält eine Rechnungsnummer und wird an den Kunden versendet.

Kündigst du als Admin ein bezahltes Abo vor Periodenende, legt anny ebenfalls einen Rechnungsentwurf (Gutschrift) an. Die Erstattung läuft erst, wenn du diese Gutschrift versendest. Ablauf: [Abos & Mitgliedschaften](/subscriptions-and-memberships).

## Rechnungsentwurf bearbeiten

<Steps>
  <Step title="Bestellung öffnen">
    Navigiere in der Menüleiste zu **Bestellungen**. Wähle die passende Bestellung aus oder nutze die Suchleiste, um nach Bestellnummer oder Kundenname zu suchen. Die Suche findet auch Bestellungen, die du im Admin als Entwurf angelegt und noch nicht abgeschlossen hast. Du kannst die Liste zusätzlich nach **Erstellt am**, **Erstellt von** (Mitarbeiter:in) oder **Vor Ort erstellt** filtern. Die Spalte **Erstellt von** zeigt, wer die Bestellung angelegt hat.
  </Step>

  <Step title="Entwurf bearbeiten">
    Klicke auf die Bestellung, um die Detailansicht zu öffnen. Klicke auf das **Stift-Symbol** neben dem Rechnungsentwurf, um den Bearbeitungsmodus zu öffnen.
  </Step>

  <Step title="Positionen anpassen">
    Du kannst jetzt:

    * Neue Positionen ergänzen
    * Beträge ändern
    * Rabatte oder Gutscheine als negativen Betrag (-) eintragen
  </Step>

  <Step title="Rechnung fertigstellen">
    Wenn der Entwurf vollständig ist, klicke auf **Fertigstellen**. Die Rechnung wird festgeschrieben, erhält automatisch eine Rechnungsnummer und wird an den Kunden versendet.
  </Step>
</Steps>

<Tip>
  Über das **Glocken-Symbol** steuerst du, ob der Kunde bei Fertigstellung eine E-Mail-Benachrichtigung zur Rechnung erhält oder nicht.
</Tip>

## Neue Rechnung zu einer Bestellung hinzufügen

Du kannst zu einer bestehenden Bestellung auch manuell eine weitere Rechnung anlegen, zum Beispiel für Nachberechnungen oder zusätzliche Positionen.

<Steps>
  <Step title="Bestellung öffnen">
    Gehe zu **Bestellungen** und wähle die betroffene Bestellung aus.
  </Step>

  <Step title="Neue Rechnung erstellen">
    Klicke auf **+ Neue Rechnung**. Es öffnet sich ein leerer Rechnungsentwurf.
  </Step>

  <Step title="Positionen eintragen und fertigstellen">
    Trage die gewünschten Positionen ein. Speichere als Entwurf, um später weiterzuarbeiten, oder klicke auf **Fertigstellen**, um die Rechnung sofort zu versenden.
  </Step>
</Steps>

## Ergebnis prüfen

Nach dem Fertigstellen erkennst du den Erfolg daran, dass:

* Die Rechnung in der Rechnungsübersicht (Menüpunkt **Rechnungen**) mit Status "Versendet" erscheint
* Eine Rechnungsnummer automatisch vergeben wurde
* Der Kunde die Rechnung per E-Mail erhalten hat (sofern Benachrichtigung aktiv)

In der Rechnungsübersicht kannst du nach Status filtern (Entwurf, Versendet, Bezahlt, Rückerstattet), um offene Entwürfe schnell zu finden.

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich eine festgeschriebene Rechnung nachträglich ändern?">
    Nein. Festgeschriebene Rechnungen sind unveränderlich, um eine nachvollziehbare Buchhaltung zu gewährleisten. Korrekturen erfolgen über eine Storno- oder Korrekturrechnung. Siehe dazu den Artikel Rechnungskorrektur & Stornierung.
  </Accordion>

  <Accordion title="Wie lange bleibt ein Entwurf bearbeitbar?">
    Solange du die Rechnung nicht fertigstellst, bleibt sie als Entwurf gespeichert und bearbeitbar. Es gibt kein automatisches Zeitlimit. Bei aktiver automatischer Rechnungsgenerierung wird der Entwurf allerdings zum Buchungstag automatisch festgeschrieben.
  </Accordion>

  <Accordion title="Kann ich einen Rabatt auf der Rechnung eintragen?">
    Ja. Füge eine neue Position hinzu und trage den Rabattbetrag mit negativem Vorzeichen ein (z. B. -10,00 €). Die Position erscheint als Abzug auf der Rechnung.
  </Accordion>

  <Accordion title="Was passiert mit Entwürfen bei aktiven Kundensalden?">
    Bei aktiven Kundensalden werden Rechnungsentwürfe dem offenen Saldo zugeordnet und erst bei der Konsolidierung am Periodenende zusammengefasst. Du kannst einzelne Entwürfe aber trotzdem jederzeit manuell vorzeitig fertigstellen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Das Stift-Symbol ist nicht sichtbar">
    Die Rechnung wurde bereits festgeschrieben und ist nicht mehr bearbeitbar. Festgeschriebene Rechnungen können nur über eine Korrekturrechnung angepasst werden.
  </Accordion>

  <Accordion title="Die Rechnung wurde automatisch versendet, obwohl ich noch ändern wollte">
    Die Einstellung "Rechnung automatisch generieren" in der Buchungsoption bewirkt, dass der Entwurf zum Buchungstag automatisch festgeschrieben wird. Deaktiviere diese Einstellung, wenn du Entwürfe vor dem Versand manuell prüfen möchtest.
  </Accordion>

  <Accordion title="Der Kunde hat keine E-Mail zur Rechnung erhalten">
    Prüfe, ob das Glocken-Symbol beim Fertigstellen aktiv war. War es deaktiviert, wurde keine Benachrichtigung gesendet. Du kannst die Rechnung manuell erneut versenden oder dem Kunden das PDF aus der Bestellansicht weiterleiten.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Rechnungsentwurf = Rechnung im Status "Entwurf", noch nicht festgeschrieben und bearbeitbar.
> * UI-Pfad: Bestellungen → Bestellung auswählen → Stift-Symbol für Bearbeitung
> * Bestellliste-Filter: **Erstellt am** (`created_at_range`), **Erstellt von** (`created_by` + Staff), **Vor Ort erstellt** (`created_by_type=users`). Spalte **Erstellt von**. Backfill ca. 90 Tage.
> * Admin-Suche (Bestellungen + Cmd+K): indexiert Bestellungen mit `expires_at` null, inkl. unfertiger Admin-Entwürfe. Checkout-Warenkörbe mit Ablaufdatum bleiben draußen.
> * Entwürfe können: Positionen ergänzen, Beträge anpassen, negative Beträge als Rabatt/Gutschein eintragen.
> * Festschreiben = Rechnung wird final, erhält Rechnungsnummer und wird versendet (nicht rückgängig machbar).
> * Glocken-Symbol steuert, ob Kunde bei Fertigstellung eine E-Mail-Benachrichtigung erhält.
> * Festgeschriebene Rechnungen können NICHT mehr bearbeitet werden. Korrekturen nur über Storno-/Korrekturrechnung.
> * Kundensalden-Kontext: Bei aktiven Kundensalden bleiben Entwürfe auf dem Saldo bis zur Konsolidierung. Manuelles Fertigstellen ist trotzdem möglich.
> * Verwandte Artikel: Rechnungsstellung (Übersicht), Rechnung korrigieren, Kundensalden & Sammelrechnungen, Abos & Mitgliedschaften (Admin-Kündigung legt Gutschrift-Entwurf an).


# Rechnungsstellung
Source: https://docs.anny.co/invoicing

Konfiguriere Zahlungsmethoden, Rechnungseinstellungen und eigene Felder für die automatische Rechnungsstellung in anny.

Mit der Rechnungsstellung in anny erstellst du automatisch Rechnungen für Buchungen und Bestellungen. Du legst fest, wie deine Kund:innen zahlen, wann Rechnungen versendet werden und welche Informationen auf der Rechnung erscheinen.

## Wie funktioniert die Rechnungsstellung?

Sobald eine Buchung abgeschlossen wird, erstellt anny automatisch eine Bestellung mit zugehörigem Rechnungsentwurf. Je nach Konfiguration wird die Rechnung entweder sofort festgeschrieben und versendet oder zunächst als Entwurf gespeichert, bis du sie manuell fertigstellst.

Die Rechnungsstellung gliedert sich in drei Ebenen:

1. **Globale Einstellungen**: Fälligkeit, Zahlungserinnerungen, erlaubte Zahlungsarten und Bankverbindung für den gesamten Account.
2. **Zahlungsmethode pro Buchungsoption**: Für jede Buchungsoption legst du individuell fest, ob offline, vorab online oder auf Rechnung (Pay-Later) gezahlt wird.
3. **Rechnungsfelder**: Eigene Bestell- und Kundendaten, die im Checkout abgefragt und automatisch auf die Rechnung übernommen werden.

Rechnungsnummern werden automatisch aufsteigend vergeben. Festgeschriebene Rechnungen sind unveränderlich, Korrekturen erfolgen über Storno- oder Korrekturrechnungen.

## Zahlungsmethoden

Pro Buchungsoption wählst du eine von drei Zahlungsmethoden:

| Zahlungsmethode | Beschreibung |
| - | - |
| Offline-Zahlung | Zahlung außerhalb von anny (bar, Überweisung etc.) |
| Vorab online zahlen | Kunde zahlt im Checkout per Kreditkarte, PayPal, Apple Pay, Google Pay, iDEAL, TWINT, EPS, Bancontact, BLIK oder Przelewy24 |
| Zahlen auf Rechnung (Pay-Later) | Kunde erhält eine Rechnung und zahlt flexibel nach der Buchung |

<Tip>
  Vorab online zahlen setzt eine aktive Stripe-Connect-Verbindung voraus. Pay-Later setzt voraus, dass unter den globalen Einstellungen entweder Online-Zahlung oder Zahlung per Überweisung erlaubt ist.
</Tip>

Zusätzlich kannst du pro Buchungsoption die Option **Zahlung vor Ort** aktivieren: Kund:innen müssen dann keine Zahlungsdaten online hinterlegen.

## Wann nutze ich das?

* **Du möchtest Buchungen automatisch abrechnen und Rechnungen versenden**: Aktiviere die automatische Rechnungsgenerierung pro Buchungsoption.
* **Du bietest kostenpflichtige Services an und möchtest Sofortzahlung**: Wähle "Vorab online zahlen" und verbinde Stripe Connect.
* **Deine Kund:innen zahlen bevorzugt auf Rechnung oder per Überweisung**: Nutze Pay-Later und aktiviere Zahlungserinnerungen.
* **Du arbeitest mit Firmenkund:innen, die Sammelrechnungen benötigen**: Kombiniere Pay-Later oder Offline-Zahlung mit Kundensalden (ab Business Plan).
* **Nicht geeignet für**: Rein kostenlose Buchungen ohne Abrechnung. Hier kannst du die Rechnungsstellung einfach deaktiviert lassen.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Kundensalden & Sammelrechnungen | Rechnungsentwürfe werden auf einem Saldo gesammelt und später konsolidiert |
| Abos & Mitgliedschaften | Wiederkehrende Abrechnungen erzeugen automatisch Rechnungen pro Periode |
| Communities | Berechtigungssteuerung, wer auf Kundensaldo buchen darf |
| Stornierungsbedingungen | Stornierungen lösen Stornorechnungen oder Gutschriften aus |

## Einstellungen & Optionen

### Globale Rechnungseinstellungen

Pfad: **Avatar** (oben rechts) → **Account-Einstellungen** → **Rechnungsstellung**

| Einstellung | Beschreibung |
| - | - |
| Fälligkeit der Rechnung | Zahlungsfrist in Tagen |
| Zahlungserinnerung senden | Bis zu 3 Mahnungen automatisch |
| Online-Zahlung erlauben | Stripe Connect für den Account aktivieren |
| Zahlung per Überweisung erlauben | Banküberweisung als Option freigeben |
| Bankkonto / Hinweise | Kontodaten und Freitexthinweis auf Rechnung |
| Rechnungssprache | Sprache der Rechnungen pro Organisation |

<Note>
  Das **Logo** auf dem Rechnungs-PDF kommt nicht aus diesem Reiter. Hinterlege es unter **Avatar** → **Account-Einstellungen** → **Account**. Anschließend erscheint es automatisch auf neuen Rechnungs-PDFs. Mehr dazu unter [Account-Einstellungen](/account-settings).
</Note>

### Zahlungsmethode pro Buchungsoption

Pfad: **Ressource** → Buchungsoption **bearbeiten** → **Zahlungen**

| Einstellung | Beschreibung |
| - | - |
| Zahlungsmethode | Offline / Vorab online / Pay-Later |
| Rechnung automatisch generieren | Rechnungsnummer wird sofort vergeben |
| Zahlungsstatus verfolgen | Bestellungen auf "offen" statt auto. "bezahlt" |
| Zahlung vor Ort | Online-Zahlung ohne Zahlungsdaten-Pflicht |

### Eigene Rechnungsfelder

Du kannst benutzerdefinierte Daten im Checkout abfragen und automatisch auf Rechnungen anzeigen lassen, zum Beispiel Kostenstelle, Auftragsnummer oder Umsatzsteuer-ID.

<Steps>
  <Step title="Eigene Datenfelder anlegen">
    Öffne **Avatar** → **Account-Einstellungen** → Tab **Einstellungen**. Unter **Eigene Bestelldaten** oder **Eigene Kundendaten** erstellst du neue Felder. Aktiviere **Im Checkout abfragen** und optional **Pflichtfeld**.
  </Step>

  <Step title="Felder mit der Rechnung verknüpfen">
    Wechsle zum Tab **Rechnungsstellung** → **Rechnungsfelder** → **+ Datenfeld hinzufügen**. Wähle Name, Kategorie und das zuvor angelegte benutzerdefinierte Feld aus und speichere.
  </Step>
</Steps>

Die verknüpften Felder erscheinen anschließend auf dem Rechnungs-PDF und in elektronischen Rechnungen.

## Weiterführende Artikel

<CardGroup>
  <Card title="Pay-Later" icon="clock" href="/pay-later">
    Zahlung auf Rechnung einrichten und Zahlungsstatus verfolgen.
  </Card>

  <Card title="Rechnungsentwurf" icon="pen-to-square" href="/invoice-drafts">
    Entwürfe bearbeiten, Positionen anpassen und fertigstellen.
  </Card>

  <Card title="Rechnungskorrektur" icon="rotate-left" href="/invoice-corrections">
    Stornierung, Korrekturrechnung und Adressänderung.
  </Card>

  <Card title="Kundensalden & Sammelrechnungen" icon="layer-group" href="/customer-balances-and-collective-invoices">
    Rechnungsentwürfe sammeln und am Periodenende konsolidieren.
  </Card>

  <Card title="Buchhaltung mit anny" icon="calculator" href="/accounting">
    Kontoauszüge, Exportformate und DATEV-Workflow.
  </Card>

  <Card title="DATEV Import" icon="file-import" href="/datev-import">
    Automatische Rechnungsweiterleitung an DATEV einrichten.
  </Card>

  <Card title="GoBD bei anny" icon="scale-balanced" href="/gobd">
    Festschreibung, Unveränderlichkeit und Storno im Detail.
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Muss ich Online-Zahlung aktivieren, um Rechnungen zu erstellen?">
    Nein. Die Rechnungsstellung funktioniert auch ohne Online-Zahlung. Du kannst Rechnungen über Offline-Zahlung oder Pay-Later (Überweisung) generieren und versenden, ohne Stripe Connect einzurichten.
  </Accordion>

  <Accordion title="Kann ich verschiedene Zahlungsmethoden für verschiedene Buchungsoptionen nutzen?">
    Ja. Die Zahlungsmethode wird pro Buchungsoption einzeln eingestellt. Du kannst zum Beispiel Meetingräume mit Vorab-Online-Zahlung und Arbeitsplätze mit Pay-Later konfigurieren.
  </Accordion>

  <Accordion title="Wann wird eine Rechnung automatisch versendet?">
    Wenn "Rechnung automatisch generieren" aktiv ist, wird die Rechnung zum Buchungszeitpunkt festgeschrieben und versendet. Bei Pay-Later wird sie am Tag der Buchung generiert und per E-Mail an den Kunden geschickt.
  </Accordion>

  <Accordion title="Kann ich die Rechnungssprache ändern?">
    Ja. Unter den globalen Rechnungseinstellungen kannst du die Sprache pro Organisation festlegen. Rechnungen werden dann in der gewählten Sprache generiert.
  </Accordion>

  <Accordion title="Kann ich mein Logo auf die Rechnung setzen?">
    Ja. Das Rechnungs-PDF zeigt das **Logo**, das du unter **Avatar** → **Account-Einstellungen** → **Account** hinterlegst. Im Reiter **Rechnungsstellung** gibt es keine eigene Logo-Option — das Organisationslogo wird automatisch übernommen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Pay-Later ist nicht auswählbar">
    Stelle sicher, dass unter Avatar → Account-Einstellungen → Rechnungsstellung entweder "Online-Zahlung erlauben" oder "Zahlung per Überweisung erlauben" aktiviert ist. Ohne eine dieser beiden Optionen ist Pay-Later nicht verfügbar.
  </Accordion>

  <Accordion title="Meine eigenen Felder erscheinen nicht auf der Rechnung">
    Das Feld muss zusätzlich unter Rechnungsstellung → Rechnungsfelder verknüpft werden. Allein das Anlegen unter Eigene Bestell- oder Kundendaten reicht nicht aus.
  </Accordion>

  <Accordion title="Der Zahlungsstatus aktualisiert sich nicht automatisch">
    Bei Offline-Zahlung und Pay-Later per Überweisung musst du den Zahlungsstatus manuell auf "bezahlt" setzen. Nur bei aktiver Online-Zahlung über Stripe wird der Status automatisch aktualisiert.
  </Accordion>

  <Accordion title="Mein Logo erscheint nicht auf der Rechnung">
    Prüfe unter **Avatar** → **Account-Einstellungen** → **Account**, ob ein **Logo** hinterlegt ist. Nur neu erzeugte Rechnungs-PDFs übernehmen das Logo. Bereits festgeschriebene Rechnungen bleiben unverändert.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Zahlungsabwicklung & Rechnungsstellung. Muss nicht separat aktiviert werden, ist in allen Plänen enthalten.
> * Online-Zahlung muss separat über Stripe Connect eingerichtet und verifiziert werden.
> * UI-Pfad globale Einstellungen: Avatar → Account-Einstellungen → Rechnungsstellung
> * UI-Pfad Zahlungsmethode pro Service: Ressource → Buchungsoption bearbeiten → Zahlungen
> * Drei Zahlungsmodi pro Buchungsoption: Offline-Zahlung, Vorab online zahlen, Zahlen auf Rechnung (Pay-Later)
> * Pay-Later setzt voraus, dass unter Account-Einstellungen entweder Online-Zahlung oder Zahlung per Überweisung aktiv ist.
> * Rechnungsfelder: eigene Bestell- und Kundendaten unter Account-Einstellungen → Einstellungen anlegen, dann unter Rechnungsstellung verknüpfen.
> * Unterstützte Online-Zahlungsmethoden (via Stripe Connect): PayPal, Kreditkarte, Apple Pay, Google Pay, iDEAL, TWINT, EPS, Bancontact, BLIK, Przelewy24, SEPA-Lastschrift (nur für Abo-Abrechnungen).
> * Rechnungssprache: kann pro Organisation eingestellt werden (seit Juli 2026).
> * Logo auf dem Rechnungs-PDF: kommt aus Avatar → Account-Einstellungen → Account → Logo (Organisationslogo). Es gibt keine separate Logo-Option unter Rechnungsstellung. Nicht behaupten, dass kein Logo auf die Rechnung gesetzt werden kann.
> * Kundensalden (Sammelrechnungen) sind erst ab Business Plan verfügbar.
> * Verwandte Artikel für Anschlussfragen: Pay-Later, Rechnungsentwurf, Rechnungskorrektur, Kundensalden, Buchhaltung mit anny, Stripe Connect einrichten, Account-Einstellungen.


# Rechtliche Dokumente
Source: https://docs.anny.co/legal-documents

Lass rechtliche Dokumente direkt im Buchungsprozess per Checkbox oder digitaler Unterschrift bestätigen.

Mit rechtlichen Dokumenten kannst du Vereinbarungen, Haftungsausschlüsse oder AGB direkt im Buchungsprozess von deinen Kund:innen bestätigen lassen. Je nach Anforderung wählst du zwischen einer einfachen Checkbox (Kenntnisnahme) und einer digitalen Unterschrift (rechtssichere Signatur). Die bestätigten Dokumente werden automatisch gespeichert und sind jederzeit in der Kundenakte und in der Buchung abrufbar.

## Wie funktioniert Rechtliche Dokumente?

Du erstellst ein rechtliches Dokument und verknüpfst es mit einer Buchungsoption. Im Checkout müssen Kund:innen das Dokument bestätigen, bevor sie die Buchung abschließen können. Pro Buchungsoption können mehrere rechtliche Dokumente gleichzeitig aktiv sein.

### Bestätigungsformen

| Form | Einsatzzweck |
| - | - |
| Checkbox | Einfache Zustimmung oder Kenntnisnahme (z. B. AGB, Hygieneregeln, Hausordnung) |
| Digitale Unterschrift | Rechtssichere, explizite Unterschrift (z. B. Haftungsausschlüsse, Einwilligungen, verbindliche Vereinbarungen) |

### Abfragezeitpunkt

Sobald ein rechtliches Dokument einer Buchungsoption zugewiesen ist, legst du pro Dokument den **Abfragezeitpunkt** fest:

* **Bei Buchungsabschluss**: Kund:innen bestätigen das Dokument direkt im Checkout (Standardverhalten).
* **Später (beim Check-in)** (BETA): Kund:innen können das Dokument schon im Checkout optional bestätigen. Pflicht wird es erst beim Check-in, falls es noch fehlt. Das ist besonders nützlich, wenn Unterschriften erst vor Ort relevant sind.

Weitere Details zur verzögerten Abfrage beim Check-in findest du im Artikel [Check-in: Erste Schritte](/check-in-setup).

### Ablauf für Kund:innen

1. Das Dokument wird im Checkout angezeigt. Solange es nicht bestätigt wurde, erscheint der Button "Nicht unterzeichnet".
2. Kund:innen klicken auf **Überprüfen & Akzeptieren** (Checkbox) oder **Überprüfen & Unterschreiben** (Signatur).
3. Im geöffneten Fenster bestätigen sie per Checkbox oder Unterschriftenfeld.
4. Enthält das Dokument eingebettete Videos, muss jedes Video über die Wiedergabe **gestartet** werden, bevor Akzeptieren oder Unterschreiben möglich ist. Durchschauen ist nicht nötig. Der Hinweis lautet **Starte das Video, bevor du unterschreiben oder akzeptieren kannst**.
5. Nach der Bestätigung wechselt der Button auf "Bestätigt" bzw. "Unterzeichnet".
6. Nach Buchungsabschluss wird das Dokument automatisch in der Buchung gespeichert.

### Speicherung und Abruf

Bestätigte Dokumente findest du an zwei Stellen:

* **Kundenakte**: Navigiere zu **Kunden**, wähle den Kunden und öffne den Tab **Vereinbarungen**.
* **Buchung**: Navigiere zu **Buchungen**, wähle die Buchung und öffne den Tab **Dateien**.

## Wann nutze ich das?

* **Du willst eine Sicherheitseinweisung direkt beim Check-in**: Bette ein Video ins Dokument ein und setze den Abfragezeitpunkt auf "Später (beim Check-in)". Der Gast muss das Video starten, bevor der Check-in abgeschlossen werden kann.
* **Du brauchst eine einfache Zustimmung zu AGB, Hausordnung oder Hygieneregeln**: Nutze die Checkbox-Bestätigung.
* **Du benötigst eine rechtssichere Unterschrift (z. B. Haftungsausschluss, Einwilligung)**: Nutze die digitale Unterschrift.
* **Du willst Unterschriften erst vor Ort beim Check-in einholen**: Setze den Abfragezeitpunkt auf "Später (beim Check-in)".
* **Nicht geeignet für**: Inhaltliche Abfragen (z. B. Teilnehmerzahl, Catering-Wünsche). Dafür nutze [Eigene Formulare](/custom-forms).

## Zusammenhang mit anderen Features

* [**Eigene Formulare**](/custom-forms): Rechtliche Dokumente und eigene Formulare werden im gleichen Tab konfiguriert. Formulare erfassen inhaltliche Daten, rechtliche Dokumente sichern rechtlich ab.
* [**Abos und Mitgliedschaften**](/subscriptions-and-memberships): Bei Abos werden rechtliche Dokumente nur bei der initialen Abo-Buchung abgefragt, nicht bei jeder wiederkehrenden Verlängerung.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Name | Interner Name des Dokuments |
| Bestätigungsform | Checkbox oder Digitale Unterschrift |
| Text / Erklärung | Inhalt, den Kund:innen bestätigen müssen. Du kannst Fotos sowie YouTube-, Vimeo- oder Loom-Videos einbetten. Typischer Use Case: Sicherheitseinweisung per Video beim Check-in. Der Gast muss das Video starten, bevor der Check-in abgeschlossen werden kann. Das signierte PDF behält die Fotos und ein klickbares Video-Poster. |
| Abfragezeitpunkt | Bei Buchungsabschluss oder Später (beim Check-in, BETA) |

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Sicherheitseinweisung: Video muss beim Check-in gestartet werden">
    Ein Coworking, Fitnessstudio oder Industriestandort möchte, dass jede:r Gast die Sicherheitseinweisung am Terminal absolviert. Das Video muss gestartet werden, bevor der Check-in abgeschlossen werden kann.

    <Steps>
      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen**, wähle die Empfangs- oder Besuchsressource und öffne die **Buchungsoption**.
      </Step>

      <Step title="Tab Formulare öffnen">
        Wechsle zum Reiter **Formulare** und scrolle zum Bereich **Rechtliche Dokumente**.
      </Step>

      <Step title="Sicherheitsdokument anlegen">
        Klicke auf **Hinzufügen** und dann auf **+ Neu**. Vergib einen Namen (z. B. "Sicherheitseinweisung"). Wähle Checkbox oder digitale Unterschrift.
      </Step>

      <Step title="Video einbetten">
        Bette im Textfeld das Einweisungsvideo ein (YouTube, Vimeo oder Loom) und optional Fotos zu Wegen oder Notausgängen.
      </Step>

      <Step title="Abfrage auf den Check-in legen">
        Setze den Abfragezeitpunkt auf **Später (beim Check-in)**.
      </Step>

      <Step title="Am Terminal testen">
        Erstelle eine Testbuchung und scanne den QR-Code. Das Dokument öffnet sich mit dem Video-Poster. Starte das Video und bestätige danach. Der Check-in bleibt gesperrt, bis das Video gestartet wurde.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Fitnessstudio lässt AGB und Haftungsausschluss per Checkbox bestätigen">
    Ein Fitnessstudio möchte, dass Kund:innen bei jeder Buchung die AGB und Hausordnung per Checkbox akzeptieren, bevor der Termin bestätigt wird.

    <Steps>
      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen**, wähle die gewünschte Ressource und öffne die **Buchungsoption**.
      </Step>

      <Step title="Tab Formulare öffnen">
        Wechsle zum Reiter **Formulare** und scrolle zum Bereich **Rechtliche Dokumente**.
      </Step>

      <Step title="Neues Dokument erstellen">
        Klicke auf **Hinzufügen** und dann auf **+ Neu**.
      </Step>

      <Step title="Dokument konfigurieren">
        Vergib einen Namen (z. B. "AGB & Hausordnung"). Wähle als Bestätigungsform **Checkbox**. Trage im Textfeld den zu bestätigenden Text ein.
      </Step>

      <Step title="Abfragezeitpunkt belassen">
        Belasse den Abfragezeitpunkt auf **Bei Buchungsabschluss** (Standard).
      </Step>

      <Step title="Speichern und testen">
        Klicke auf **Speichern**. Öffne die Buchungsseite und prüfe, ob das Dokument im Checkout angezeigt wird und die Buchung erst nach Bestätigung abgeschlossen werden kann.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Tauchschule verlangt digitale Unterschrift für Haftungsverzichtserklärung">
    Eine Tauchschule benötigt vor jedem Tauchgang eine rechtssichere Unterschrift unter die Haftungsverzichtserklärung. Die Unterschrift soll erst vor Ort beim Check-in erfolgen.

    <Steps>
      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen**, wähle die Tauchkurs-Ressource und öffne die gewünschte **Buchungsoption**.
      </Step>

      <Step title="Tab Formulare öffnen">
        Wechsle zum Reiter **Formulare** und scrolle zum Bereich **Rechtliche Dokumente**.
      </Step>

      <Step title="Neues Dokument erstellen">
        Klicke auf **Hinzufügen** und dann auf **+ Neu**.
      </Step>

      <Step title="Dokument konfigurieren">
        Vergib einen Namen (z. B. "Haftungsverzicht"). Wähle als Bestätigungsform **Digitale Unterschrift**. Trage die vollständige Haftungsverzichtserklärung im Textfeld ein.
      </Step>

      <Step title="Abfragezeitpunkt ändern">
        Setze den Abfragezeitpunkt auf **Später (beim Check-in)**.
      </Step>

      <Step title="Speichern und testen">
        Klicke auf **Speichern**. Erstelle eine Testbuchung und prüfe, dass das Dokument im Checkout optional erscheint. Beim Check-in wird die Unterschrift Pflicht, wenn sie noch fehlt.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Checkbox und digitaler Unterschrift?">
    Die Checkbox eignet sich für einfache Zustimmungen (z. B. AGB akzeptieren). Die digitale Unterschrift ist für Fälle gedacht, in denen eine explizite, rechtssichere Signatur erforderlich ist (z. B. Haftungsausschlüsse).
  </Accordion>

  <Accordion title="Werden rechtliche Dokumente bei Abos erneut abgefragt?">
    Nein. Rechtliche Dokumente werden nur bei der initialen Abo-Buchung abgefragt, nicht bei jeder wiederkehrenden Verlängerung.
  </Accordion>

  <Accordion title="Was passiert, wenn ich den Text eines Dokuments ändere?">
    Bei Änderung eines bestehenden Dokuments wird es beim nächsten Buchungsvorgang erneut abgefragt. Die erneute Abfrage erfolgt nur, wenn auch tatsächlich eine neue Buchung vorgenommen wird.
  </Accordion>

  <Accordion title="Wo finde ich die bestätigten Dokumente?">
    In der Kundenakte unter dem Tab **Vereinbarungen** oder in der jeweiligen Buchung unter dem Tab **Dateien**.
  </Accordion>

  <Accordion title="Kann ich die Abfrage auf den Check-in verschieben?">
    Ja. Setze den Abfragezeitpunkt auf "Später (beim Check-in)" (BETA). Das Dokument wird dann nicht im Checkout, sondern erst beim Check-in-Vorgang angezeigt. Typischer Use Case: Sicherheitseinweisung per Video, das der Gast starten muss, bevor der Check-in abgeschlossen werden kann.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Das rechtliche Dokument wird im Checkout nicht angezeigt">
    Prüfe, ob das Dokument der richtigen Buchungsoption zugewiesen ist. Bei **Bei Buchungsabschluss** ist es im Checkout Pflicht. Bei **Später (beim Check-in)** erscheint es im Checkout nur optional.
  </Accordion>

  <Accordion title="Kund:innen können die Buchung nicht abschließen">
    Das Dokument muss vor Buchungsabschluss bestätigt werden. Prüfe, ob der Button noch auf "Nicht unterzeichnet" steht. Erst nach Bestätigung wird die Buchung freigegeben. Steht unter dem Dokument der Hinweis **Starte das Video, bevor du unterschreiben oder akzeptieren kannst**, muss jedes eingebettete Video zuerst über die Wiedergabe gestartet werden.
  </Accordion>

  <Accordion title="Ein geändertes Dokument wird nicht erneut abgefragt">
    Die erneute Abfrage erfolgt nur bei einer neuen Buchung. Bestehende, bereits abgeschlossene Buchungen werden nicht rückwirkend betroffen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Ressourcen** → Buchungsoption → Tab **Formulare** → **Rechtliche Dokumente**
> * Zwei Bestätigungsformen: Checkbox (einfache Zustimmung) vs. Digitale Unterschrift (rechtssichere Signatur)
> * Abfragezeitpunkt pro Dokument: "Bei Buchungsabschluss" (Standard, Pflicht im Checkout) oder "Später (beim Check-in)" (BETA: im Checkout optional mit Hint, beim Check-in Pflicht falls leer)
> * Gespeicherte Dokumente abrufbar unter: Kundenakte → Tab Vereinbarungen, und Buchung → Tab Dateien
> * Abos: Dokumente werden nur bei der initialen/eigenständigen Abo-Buchung abgefragt
> * Bei Änderung des Dokuments: erneute Abfrage, aber nur wenn eine neue Buchung erfolgt
> * Eingebettete Videos: Akzeptieren/Unterschreiben ist gesperrt, bis jedes Video über Play gestartet wurde (nicht bis zum Ende schauen). Copy: "Starte das Video, bevor du unterschreiben oder akzeptieren kannst" / "Start the video before you can sign or accept"
> * Rechtliche Dokumente ≠ Eigene Formulare: Dokumente sichern rechtlich ab, Formulare erfassen inhaltliche Daten
> * Typischer Use Case: Sicherheitseinweisung beim Check-in. Video einbetten, Abfrage später beim Check-in. Der Gast muss das Video starten, bevor der Check-in abgeschlossen werden kann.
> * Verwandte Artikel: /custom-forms, /check-in-setup, /subscriptions-and-memberships, /visitor-management


# Unternehmen verwalten
Source: https://docs.anny.co/manage-companies

Führe Firmen als eigene Datensätze: verwalte Mitglieder, Domain, Rechnungsadresse und USt.-ID zentral an einem Ort.

Mit Unternehmensprofilen werden Firmen in anny als eigenständige Datensätze geführt, statt nur als Freitext an einzelnen Kundenprofilen. Du verwaltest Mitglieder, Domain, Rechnungsadresse und USt.-ID zentral an einem Ort und schaffst eine konsistente Grundlage für gemeinsame Firmendaten, Auswertungen und spätere Abrechnungsprozesse.

## Wie funktioniert Unternehmensprofile?

Ein Unternehmen wird als eigener Datensatz angelegt und kann mit mehreren Kund:innen verknüpft werden. Firmendaten wie Domain, Rechnungsadresse und USt.-ID werden am Unternehmen gepflegt, nicht verteilt über einzelne Kundenprofile.

### Rollen im Unternehmensprofil

| Rolle | Beschreibung |
| - | - |
| Admin/Owner | Genau eine Person pro Unternehmen. Zentrale Hauptperson (z. B. Ansprechpartner:in). Per Default die erste verknüpfte Person. |
| Mitglieder | Alle weiteren zugeordneten Personen. Beliebig viele, manuell oder automatisch zugewiesen. |

### Zuordnung von Mitgliedern

Mitglieder können einem Unternehmen auf zwei Wegen zugeordnet werden:

* **Manuell**: Du weist Kund:innen über ihr Kundenprofil dem Unternehmen zu.
* **Automatisch**: Über Unternehmensname und geschäftliche E-Mail-Domain werden neue Kund:innen automatisch dem passenden Unternehmen zugeordnet.

### Abweichende Geschäftsadresse im Checkout

Optional kannst du in den Formular-Einstellungen von Abo-Plänen, Services oder Buchungspaketen eine abweichende Geschäftsadresse im Checkout abfragen lassen. Diese Einstellung ist unabhängig vom Unternehmensprofil und ergänzt es lediglich.

<Tip>
  Die automatische Zuordnung spart Arbeit, funktioniert aber nur zuverlässig, wenn Unternehmensnamen konsistent gepflegt sind und die E-Mail-Domain eindeutig zum richtigen Unternehmen passt.
</Tip>

## Wann nutze ich das?

* **Mehrere Mitarbeitende eines Unternehmens nutzen anny gemeinsam**: Bündle alle Personen unter einem Unternehmensprofil, statt Firmendaten mehrfach zu pflegen.
* **Du willst Rechnungsadresse, USt.-ID und Domain zentral verwalten**: Pflege diese Daten einmal am Unternehmen statt pro Person.
* **Du brauchst saubere Auswertungen nach Unternehmen**: Mit eigenen Datensätzen sind Firmenkund:innen in Listen und Exporten klar trennbar.
* **Du bereitest Sammelrechnungen oder unternehmensbezogene Abrechnungen vor**: Unternehmensprofile schaffen die strukturelle Grundlage dafür.
* **Nicht geeignet für**: Reine Privatkund:innen ohne gemeinsamen Unternehmenskontext. Dort reicht das normale Kundenprofil.

## Zusammenhang mit anderen Features

* [**Kunden verwalten**](/manage-customers): Kundenprofile bleiben eigenständig bestehen. Unternehmensprofile ergänzen die Personenebene um eine gemeinsame Firmenebene.
* [**Kundensalden & Sammelrechnungen**](/customer-balances-and-collective-invoices): Unternehmensprofile bilden die Basis für unternehmensbezogene Rechnungsprozesse.
* [**Communities**](/communities): Communities steuern Buchungszugang, Unternehmensprofile bündeln Firmendaten. Beide können kombiniert werden (z. B. Community pro Firmenkunde).

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Unternehmensname | Name des Unternehmens als Datensatz |
| Domain | Geschäftliche E-Mail-Domain für automatische Zuordnung |
| Rechnungsadresse | Zentrale Firmenadresse für Rechnungen |
| USt.-ID | Umsatzsteuer-ID des Unternehmens |
| Admin/Owner | Hauptperson des Unternehmens (genau eine) |
| Mitglieder | Zugeordnete Personen (manuell oder automatisch) |
| Abweichende Geschäftsadresse | Optional im Checkout abfragen (pro Abo-Plan/Service/Buchungspaket) |

Owner und Admins sehen die Salden des Firmenkontos direkt auf dem Homescreen des Unternehmensprofils.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Coworking-Space mit automatischer Zuordnung über E-Mail-Domain">
    Ein Coworking-Space betreut die Muster GmbH. Zwölf Mitarbeitende buchen Arbeitsplätze und Meetingräume. Alle sollen unter einem gemeinsamen Unternehmensprofil gebündelt werden.

    <Steps>
      <Step title="Unternehmensprofil anlegen">
        Öffne **Kunden** → **Unternehmen** und erstelle ein neues Unternehmensprofil für "Muster GmbH".
      </Step>

      <Step title="Firmendaten hinterlegen">
        Trage die Domain **muster.de**, die Rechnungsadresse und die USt.-ID ein.
      </Step>

      <Step title="Automatische Zuordnung prüfen">
        Prüfe bei neu registrierten Mitarbeitenden, ob E-Mail-Adressen wie [name@muster.de](mailto:name@muster.de) automatisch dem Unternehmensprofil zugeordnet werden.
      </Step>

      <Step title="Fehlende Personen ergänzen">
        Ergänze Personen manuell, die mit einer abweichenden E-Mail-Adresse buchen oder bereits vor Einführung der Funktion im System waren.
      </Step>

      <Step title="Ergebnis prüfen">
        Öffne das Unternehmensprofil und kontrolliere, ob alle relevanten Mitglieder sichtbar sind und die Firmendaten korrekt hinterlegt sind.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Weiterbildungsanbieter mit manueller Zuordnung">
    Ein Weiterbildungsanbieter arbeitet mit wenigen Firmenkund:innen. Die Zuordnung soll bewusst manuell erfolgen.

    <Steps>
      <Step title="Unternehmensprofil anlegen">
        Öffne **Kunden** → **Unternehmen** und erstelle ein Profil für "Stadtwerke Nord".
      </Step>

      <Step title="Firmendaten hinterlegen">
        Trage Rechnungsadresse und USt.-ID ein.
      </Step>

      <Step title="Kund:innen manuell zuweisen">
        Öffne die bestehenden Kundenprofile (z. B. Laura Jensen, Tim Becker) und weise sie dem Unternehmensprofil "Stadtwerke Nord" zu.
      </Step>

      <Step title="Ergebnis prüfen">
        Prüfe im Unternehmensprofil, ob beide Personen als Mitglieder erscheinen. Ergänze bei Bedarf weitere Kontakte.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Werden bestehende Kund:innen automatisch einem Unternehmen zugeordnet?">
    Nicht zwingend. Die Zuordnung kann manuell erfolgen oder automatisch über Unternehmensname und E-Mail-Domain. Bestehende Daten solltest du nach Einführung einmal gezielt prüfen.
  </Accordion>

  <Accordion title="Können Kund:innen auch ohne Unternehmensprofil weiter existieren?">
    Ja. Ein Kundenprofil bleibt eigenständig. Unternehmensprofile ergänzen die Personenebene, ohne sie zu ersetzen.
  </Accordion>

  <Accordion title="Ist die abweichende Geschäftsadresse im Checkout Pflicht?">
    Nein. Du aktivierst sie nur, wenn du in Formularen für Abo-Pläne, Services oder Buchungspakete eine andere Geschäftsadresse abfragen möchtest.
  </Accordion>

  <Accordion title="Sind Unternehmensprofile für Sammelrechnungen relevant?">
    Ja. Sie schaffen die strukturelle Grundlage, um Unternehmensdaten und zugehörige Personen konsistent zu führen. Dadurch werden spätere unternehmensbezogene Rechnungsprozesse einfacher.
  </Accordion>

  <Accordion title="Kann ich Unternehmen über die Globale Suche finden?">
    Ja. Unternehmen sind über die Globale Suche im Adminbereich findbar.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mitarbeitende werden nicht automatisch dem richtigen Unternehmen zugeordnet">
    Prüfe, ob Unternehmensname und E-Mail-Domain konsistent gepflegt sind. Schon kleine Abweichungen können die automatische Zuordnung verhindern.
  </Accordion>

  <Accordion title="Es entstehen doppelte Unternehmensprofile">
    Das ist meist ein Datenqualitätsproblem. Prüfe, ob ähnliche Unternehmensnamen parallel angelegt wurden und nutze die Domain als Kriterium für die Bereinigung.
  </Accordion>

  <Accordion title="Im Checkout erscheint keine Geschäftsadresse">
    Das ist erwartetes Verhalten, wenn die Option im Formular des Abo-Plans, Services oder Buchungspakets nicht aktiviert wurde. Die Checkout-Erweiterung ist optional.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Kunden** → **Unternehmen** (Unternehmensverwaltung)
> * Rollen: genau ein Admin/Owner pro Unternehmen (Hauptperson, per Default die erste verknüpfte Person), beliebig viele Mitglieder
> * Zuordnung: manuell über Kundenprofil oder automatisch über Unternehmensname + geschäftliche E-Mail-Domain
> * Firmendaten zentral am Unternehmen: Domain, Rechnungsadresse, USt.-ID
> * Unternehmensprofil ergänzt Kundenprofil, ersetzt es nicht. Kund:innen können ohne Unternehmen existieren.
> * Abweichende Geschäftsadresse im Checkout: optionale Formular-Einstellung pro Abo-Plan/Service/Buchungspaket
> * Owner/Admins sehen Salden des Firmenkontos auf dem Homescreen des Unternehmensprofils
> * Unternehmen in Globaler Suche findbar (seit 06.07.2026)
> * Automatische Zuordnung funktioniert nur zuverlässig bei konsistenten Unternehmensnamen und eindeutiger E-Mail-Domain
> * Verwandte Artikel: /manage-customers, /communities, /customer-balances-and-collective-invoices


# Kunden verwalten
Source: https://docs.anny.co/manage-customers

Verwalte alle Kundendaten deiner Organisation zentral: Profile, Buchungs- und Bestellhistorie sowie individuelle Felder.

Im Bereich **Kunden** findest du eine zentrale Tabellenübersicht aller Kundendaten deiner Organisation. Von hier aus legst du neue Kund:innen an, öffnest Kundenprofile, prüfst Buchungs- und Bestellhistorien und verwaltest individuelle Felder. Kundenkarteien werden automatisch erstellt, sobald eine Bestellung von einer neuen Person eingeht.

## Wie funktioniert Kunden verwalten?

### Kundenübersicht (Tabelle)

Die Kundenliste zeigt alle Kund:innen in einer Tabelle mit den Spalten Vorname, Nachname, E-Mail, Unternehmen, Wohnort und Erstellungsdatum. Du kannst:

* Über das **Suchfeld** nach Vorname, Nachname, E-Mail, Unternehmen oder Stadt filtern (Ergebnisse werden während der Eingabe aktualisiert)
* Per Klick auf Spaltenüberschriften die Liste **sortieren** (aufsteigend/absteigend)
* Über **Neu+** einen Kunden manuell anlegen
* Über **Export** Kundendaten exportieren

### Kundendetailseite

Durch Klick auf einen Eintrag öffnest du die Detailseite mit allen Informationen zum Kunden:

* **Kundendaten**: Alle hinterlegten Informationen (Name, E-Mail, Adresse, Telefon, Sprache, Custom Fields). Hier kannst du auch kundenspezifische **Custom Fields** anlegen, die auf allen Kundenprofilen erscheinen.
* **Buchungen**: Alle Buchungen des Kunden mit Kontextmenü (ablehnen, stornieren, löschen, Bestätigung erneut senden). Über **+ Neu** legst du eine neue Buchung mit vorausgefüllten Kundendaten an.
* **Bestellungen**: Alle verknüpften Bestellungen mit Kontextmenü (stornieren, Zahlungsstatus ändern, löschen, PDF herunterladen, Bestätigung erneut senden).
* **Vereinbarungen**: Alle bestätigten rechtlichen Dokumente (Checkboxen und digitale Unterschriften).

<Tip>
  Bestellungen mit dem Status "Entwurf" liegen noch im Warenkorb des Kunden oder wurden vom Admin manuell erstellt und noch nicht versendet. Über das Kontextmenü kannst du sie mit der Aktion "Senden" an den Kunden verschicken.
</Tip>

### Kunden automatisch vs. manuell anlegen

Eine Kundenkartei wird **automatisch** erstellt, sobald eine Bestellung von einer unbekannten Person eingeht. Buchungen und Bestellungen bekannter Kund:innen werden automatisch zugeordnet.

**Manuell** legst du Kund:innen über **Kunden** → **Neu+** an: Pflichtfelder ausfüllen, optional Adresse und Custom Fields ergänzen, speichern.

### Kundenprofile zusammenführen

Legt dieselbe Person mehrere Profile an — etwa, weil sie einmal mit privater und einmal mit geschäftlicher E-Mail gebucht hat — führst du die Profile zusammen, statt eines davon zu löschen. So bleibt die vollständige Historie erhalten.

<Steps>
  <Step title="Profil öffnen">
    Öffne das Profil, das du zusammenführen möchtest. Die Aktion **Zusammenführen** findest du sowohl im Kontextmenü der Kundentabelle als auch auf der Kundendetailseite.
  </Step>

  <Step title="Zielprofil auswählen">
    Wähle im Auswahlfeld das Profil aus, in das zusammengeführt werden soll. anny schlägt passende Profile anhand der E-Mail-Adresse vor.
  </Step>

  <Step title="Zusammenführen bestätigen">
    Bestätige die Aktion. Alle Buchungen, Bestellungen, Abos und Vereinbarungen wandern auf das Zielprofil. Felder, die dort noch leer sind, werden aus dem zweiten Datensatz ergänzt.
  </Step>
</Steps>

<Warning>
  Das Zusammenführen lässt sich nicht rückgängig machen. Prüfe vorher, welches Profil das Zielprofil sein soll, denn dessen bereits gefüllte Felder bleiben unverändert erhalten.
</Warning>

Zum Zusammenführen benötigst du die Berechtigung zum Bearbeiten von Kund:innen.

## Wann nutze ich das?

* **Du willst Kundeninformationen zentral einsehen und bearbeiten**: Öffne die Kundenliste und navigiere zum Profil.
* **Du brauchst zusätzliche Felder für deine Kund:innen** (z. B. Kundennummer, Abteilung, Allergien): Erstelle Custom Fields, die auf allen Profilen erscheinen.
* **Du möchtest eine Buchung für einen bestehenden Kunden anlegen**: Öffne das Kundenprofil und klicke unter Buchungen auf **+ Neu**.
* **Du willst bestätigte rechtliche Dokumente eines Kunden einsehen**: Öffne das Kundenprofil und wechsle zum Tab **Vereinbarungen**.
* **Du verwaltest Firmenkund:innen mit mehreren Mitarbeitenden**: Nutze [Unternehmensprofile](/manage-companies) für zentrale Firmendaten.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Suchfeld | Filtert nach Vorname, Nachname, E-Mail, Unternehmen, Stadt |
| Sortierung | Per Klick auf Spaltenüberschrift (aufsteigend/absteigend) |
| Neu+ | Neuen Kunden manuell anlegen |
| Export | Kundendaten exportieren |
| Custom Fields | Individuelle Felder, die auf allen Kundenprofilen erscheinen |
| Zusammenführen | Zwei Kundenprofile zu einem zusammenführen (nicht rückgängig zu machen) |
| Kontextmenü Buchungen | Ablehnen, stornieren, löschen, Bestätigung erneut senden |
| Kontextmenü Bestellungen | Stornieren, Zahlungsstatus ändern, löschen, PDF, erneut senden |

## Verwandte Bereiche

<CardGroup>
  <Card title="Unternehmensprofile" icon="building" href="/manage-companies">
    Verwalte Firmenkund:innen als eigene Datensätze mit zentraler Rechnungsadresse, Domain und Mitgliederzuordnung.
  </Card>

  <Card title="Communities" icon="users" href="/communities">
    Steuere über Mitgliedschaften, wer welche Ressourcen sehen und buchen darf.
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Werden Kund:innen automatisch angelegt?">
    Ja. Sobald eine Bestellung von einer neuen, unbekannten Person eingeht, erstellt anny automatisch eine Kundenkartei. Weitere Buchungen und Bestellungen derselben Person werden automatisch zugeordnet.
  </Accordion>

  <Accordion title="Was sind Custom Fields und wo lege ich sie an?">
    Custom Fields sind individuelle Felder (z. B. Kundennummer, Abteilung), die du im Kundenprofil über "Neues Feld" erstellst. Sie erscheinen dann auf allen Kundenprofilen deiner Organisation.
  </Accordion>

  <Accordion title="Was passiert, wenn ich eine Buchung lösche?">
    Gelöschte Buchungen können nicht wiederhergestellt werden und es wird keine E-Mail an den Kunden gesendet. Wenn du die Buchung absagen möchtest, nutze stattdessen "Stornieren", damit der Kunde informiert wird.
  </Accordion>

  <Accordion title="Wo finde ich bestätigte rechtliche Dokumente?">
    Im Kundenprofil unter dem Tab **Vereinbarungen**. Dort siehst du alle Dokumente, die der Kunde per Checkbox oder digitaler Unterschrift bestätigt hat.
  </Accordion>

  <Accordion title="Kann ich doppelte Kundenprofile zusammenführen?">
    Ja. Nutze die Aktion **Zusammenführen** in der Kundentabelle oder auf der Kundendetailseite. Buchungen, Bestellungen, Abos und Vereinbarungen wandern auf das Zielprofil, leere Felder werden aus dem zweiten Datensatz ergänzt. Die Aktion lässt sich nicht rückgängig machen. Mehr dazu unter [Kundenprofile zusammenführen](/manage-customers#kundenprofile-zusammenführen).
  </Accordion>

  <Accordion title="Kann ich Kund:innen einem Unternehmen zuordnen?">
    Ja. Über [Unternehmensprofile](/manage-companies) kannst du Kund:innen manuell oder automatisch einem Unternehmen zuweisen und Firmendaten zentral verwalten.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ein Kunde erscheint nicht in der Kundenliste">
    Kundenkarteien werden erst bei eingehender Bestellung automatisch erstellt. Wenn der Kunde noch nicht gebucht hat, lege ihn manuell über **Neu+** an.
  </Accordion>

  <Accordion title="Ich finde einen Kunden nicht über die Suche">
    Die Suche filtert nach Vorname, Nachname, E-Mail, Unternehmen und Stadt. Prüfe die Schreibweise oder nutze die Globale Suche in der Navigationsleiste für eine accountweite Suche.
  </Accordion>

  <Accordion title="Mehrere Kundenprofile für dieselbe Person">
    Das kann passieren, wenn Buchungen mit unterschiedlichen E-Mail-Adressen eingehen. Führe die Profile über die Aktion **Zusammenführen** zusammen, statt eines zu löschen — so bleiben Buchungen, Bestellungen, Abos und Vereinbarungen erhalten. Siehe [Kundenprofile zusammenführen](/manage-customers#kundenprofile-zusammenführen).
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Kunden** in der Menüleiste (Standard-Admin-UI, kein Feature)
> * Kundenkartei wird automatisch bei eingehender Bestellung von unbekannter Person angelegt
> * Suche: Vorname, Nachname, E-Mail, Unternehmen, Stadt
> * Kundendetailseite Bereiche: Kundendaten, Buchungen, Bestellungen, Vereinbarungen
> * Custom Fields: kundenübergreifend, über "Neues Feld" in der Detailseite anlegen
> * Kontextmenü Buchungen: ablehnen, stornieren, löschen (nicht wiederherstellbar, keine E-Mail), Bestätigung erneut senden
> * Zusammenführen: verfügbar in Kundentabelle und Detailseite, erfordert Bearbeitungsrecht für Kund:innen. Zielprofil behält seine gefüllten Werte, leere Felder werden ergänzt. Nicht rückgängig zu machen. Bei Duplikaten immer zusammenführen empfehlen, nicht löschen.
> * Kontextmenü Bestellungen: stornieren, Zahlungsstatus ändern, löschen, PDF herunterladen, Bestätigung erneut senden
> * Bestellung "Entwurf": noch im Warenkorb oder manuell erstellt, Aktion "Senden" versendet an Kunden
> * Broadcast-Nachrichten: im Kundenprofil einsehbar (seit 06/2026)
> * Payment Previews: letzte 4 Ziffern gespeicherter Karten/IBANs sichtbar im Admin (seit 07/2026)
> * Verwandte Artikel: /manage-companies, /communities, /buchungsverwaltung, /rechtliche-dokumente


# Interaktive 3D-Lagepläne in anny anlegen
Source: https://docs.anny.co/maps-and-floor-plans



Mit dem Karten-Designer kannst du Ressourcen wie Arbeitsplätze, Räume oder ganze Gebäude auf einer interaktiven Karte darstellen und direkt buchbar machen. Deine Kund:innen sehen die Karte auf der Buchungsseite und können Ressourcen visuell auswählen.

<Info>
  * Verfügbar ab **Essential**. Die **3D-Ansicht** und **Mehrfachkarten** erfordern den **Professional**-Plan.
  * Aktiviere vorab **Karten & Interaktive Lagepläne** unter **Account-Einstellungen** → **Features**.
</Info>

## Karte erstellen und einrichten

<Steps>
  <Step title="Neue Karte anlegen">
    Öffne im Admin-Bereich links **Ressourcen** und klicke auf **Karten**. Klicke auf **Neu**, um eine neue Karte anzulegen. Benenne deine Karte und verbinde sie mit der richtigen Adresse. Falls die Adresse noch nicht existiert, kannst du über **Standort hinzufügen** eine neue Adresse anlegen.

    Nach dem Speichern wird die Karte automatisch im Karten-Designer geöffnet.
  </Step>

  <Step title="Lageplan als Vorlage hochladen (optional)">
    Falls du einen bestehenden Grundriss hast, ziehe ihn per Drag-and-Drop in den Kartenbereich. Positioniere und skaliere den Lageplan über die Eckpunkte. Benenne ihn entsprechend der Etage und fixiere ihn über **Rechtsklick** → **Sperren**.

    Der Lageplan dient nur als Zeichenvorlage und wird auf der Buchungsseite nicht angezeigt. Akzeptierte Formate: .pdf, .jpg, .png. Aus diesem Bild kannst du anschließend eine [Ebene mit KI erzeugen](#lageplan-mit-ki-erzeugen).

    <iframe />
  </Step>

  <Step title="Gebäude und Wände zeichnen">
    Wähle aus der Symbolleiste das Werkzeug für Rechtecke, Polygone oder Kreise (**B**) und zeichne den Gebäudeumriss. Nutze das Wand-Tool (**W**), um Innenwände hinzuzufügen. Halte **Shift** gedrückt, um Wände im 90°-Winkel zu zeichnen.

    Platziere Türen (**D**) und Fenster (**N**) an den gewünschten Stellen.

    <iframe />
  </Step>

  <Step title="Möbel und Vorlagen platzieren">
    Öffne den Bereich **Vorlagen** auf der rechten Seite. Dort findest du **Öffentliche Vorlagen** (Standard-Möbel wie Tische, Stühle, Regale) und **Private Vorlagen** (eigene, account-weite Möbel). Ziehe Möbelstücke per Drag-and-Drop auf den Lageplan.

    Zum Skalieren halte die **Alt-Taste** und ziehe an den Eckpunkten.

    <iframe />
  </Step>

  <Step title="Ressourcen verknüpfen">
    Zeichne mit dem Ressourcen-Werkzeug (**R**) einen Bereich auf dem Lageplan ein (Polygon, Rechteck oder Kreis). Der Bereich wird orange eingefärbt.

    Öffne den Reiter **Ressourcen**, suche die gewünschte Ressource und klicke zum Verknüpfen auf den passenden Bereich in der Karte. Der Bereich wird grün, sobald die Verknüpfung erfolgreich ist.

    Für Child-Ressourcen (z. B. einzelne Arbeitsplätze): Klappe die Ressource auf, um alle untergeordneten Elemente anzuzeigen, und verbinde sie durch einfaches Anklicken. Drücke **Escape**, um die Maus zu leeren.

    <iframe />
  </Step>

  <Step title="Symbole und Text hinzufügen">
    Nutze Icons (**I**), um wichtige Bereiche wie Toiletten, Eingänge oder die Küche zu markieren. Über **T** kannst du Textelemente positionieren.
  </Step>

  <Step title="3D-Ansicht aktivieren (optional)">
    Klicke im Designer auf den 3D-Button (**V**), um eine Vorschau zu sehen. Damit die Karte auf der Buchungsseite in 3D angezeigt wird, navigiere zu den **Einstellungen** (Zahnrad-Icon) und aktiviere dort die 3D-Ansicht.

    <iframe />
  </Step>

  <Step title="Karte speichern und aktivieren">
    Der Designer speichert standardmäßig automatisch. Im **Einstellungsmenü** (Zahnrad-Icon) kannst du **Automatisch speichern** ausschalten oder das **Speicherintervall** ändern. Zusätzlich speicherst du jederzeit mit **Ctrl/Cmd + S**. Aktiviere die fertige Karte im selben Menü, damit sie auf der Buchungsseite sichtbar wird.
  </Step>
</Steps>

<Tip>
  Du kannst jederzeit Änderungen vornehmen. Alle Elemente der Karte lassen sich als Admin nachträglich bearbeiten. Klicke unten rechts auf die Karte, um zur Satellitenansicht zu wechseln.
</Tip>

## Lageplan mit KI erzeugen

Statt Wände und Möbel von Hand nachzuzeichnen, kannst du aus einem hochgeladenen Grundriss eine neue Ebene erzeugen lassen.

<Steps>
  <Step title="Grundriss in die Karte legen">
    Ziehe dein Bild wie oben unter **Lageplan als Vorlage hochladen** in den Kartenbereich. Positioniere und skaliere es über die Eckpunkte.
  </Step>

  <Step title="Generierung starten">
    Rechtsklick auf das Bild und **Ebene mit KI generieren**. Bestätige den Dialog. Das Bild wird zur Verarbeitung gesendet. Dabei können Nutzungskosten entstehen.
  </Step>

  <Step title="Entwurf prüfen">
    Die Generierung läuft im Hintergrund. Du kannst das Fenster schließen. anny benachrichtigt dich, sobald der Entwurf bereit ist. Das Ergebnis erscheint als Entwurf (**KI-Entwurf**). Prüfe Wände, Türen, Fenster und Möbel, bevor du die Karte aktivierst.
  </Step>
</Steps>

### Bestehende Ebene anpassen

Wähle eine Ebene und klicke in der Symbolleiste auf **Mit KI bearbeiten**, oder nutze denselben Befehl im Kontextmenü. Beschreibe die gewünschte Änderung. Gesperrte Objekte bleiben unverändert. Die Änderungen werden direkt übernommen und lassen sich rückgängig machen.

## Etagen verwalten

Eine neue Etage erstellst du über den Button **Ebene hinzufügen**. Um eine bestehende Etage zu kopieren, klicke per Rechtsklick in der Etagenübersicht auf **Duplizieren**.

## Elemente verschieben, drehen und skalieren

Alle Objekte im Designer (Möbel, Ressourcen, Vorlagen, Wände, Lagepläne) lassen sich nach dem gleichen Prinzip bearbeiten:

| Aktion | Bedienung |
| - | - |
| Auswählen | Linksklick oder **Shift** + Ziehen für Mehrfachauswahl |
| Verschieben | Drag-and-Drop, sobald der Verschiebe-Cursor erscheint |
| Drehen (stufenweise) | **Q** / **E** (1°-Schritte), **Shift + Q / E** (45°-Schritte) |
| Drehen (frei) | **Strg** + Maus auf Eckpunkt ziehen |
| Skalieren | **Alt** + Eckpunkt ziehen |
| Löschen | Element auswählen + **Del / ⌫** |

## Hotkeys

| Aktion | Hotkey |
| - | - |
| Select-Modus | **S** |
| Gebäude zeichnen | **B** |
| Landschaft zeichnen | **G** |
| Wände zeichnen | **W** |
| Türen einfügen | **D** |
| Fenster einfügen | **N** |
| Möbel zeichnen | **F** |
| Zonen zeichnen | **Z** |
| Ressourcen zeichnen | **R** |
| Symbole einfügen | **I** |
| Text einfügen | **T** |
| Linien zeichnen | **L** |
| Gestrichelte Linien | **Shift + L** |
| Snap to Line (Magnet) | **M** |
| 3D-Ansicht umschalten | **V** |

## Shortcuts

| Aktion | Shortcut |
| - | - |
| Elemente kopieren | **Ctrl/Cmd + C** |
| Elemente einfügen | **Ctrl/Cmd + V** |
| Elemente ausschneiden | **Ctrl/Cmd + X** |
| Elemente duplizieren | **Ctrl/Cmd + D** |
| Rückgängig | **Ctrl/Cmd + Z** |
| Wiederherstellen | **Ctrl/Cmd + Shift + Z** |
| Löschen | **Del / ⌫** |
| Gruppieren | **Ctrl/Cmd + G** |
| Gruppierung aufheben | **Ctrl/Cmd + Shift + G** |
| Speichern | **Ctrl/Cmd + S** |
| Verschieben (0,1 m) | **← ↑ → ↓** |
| Verschieben (1 m) | **Shift + ← ↑ → ↓** |
| Zeichnen im 90°-Winkel | **Shift** gedrückt halten |

## Karten mit verwalteten Organisationen teilen

Wenn deine Organisation andere Organisationen verwaltet (Menüpunkt **Organisationen**), kannst du Lagepläne mit ihnen teilen. Die verwalteten Organisationen sehen die Karte unter **Ressourcen** → **Karten** mit dem Badge **Geteilt**. Sie können dort nur ihre eigenen Ressourcen auf freie Plätze legen. Den Grundriss, Wände und Möbel ändern sie nicht.

Neue Karten in der verwaltenden Organisation sind standardmäßig geteilt. Du kannst das Teilen jederzeit starten oder beenden.

<Steps>
  <Step title="Karte in der verwaltenden Organisation anlegen">
    Zeichne Gebäude, Etagen und Ressourcenbereiche wie oben. Die Geometrie bleibt bei dir.
  </Step>

  <Step title="Teilen starten">
    In der Kartenliste wählst du **Mit verwalteten Organisationen teilen**. Die Karte erscheint automatisch in den Karten der verwalteten Organisationen. Dort können sie freien Plätzen ihre eigenen Ressourcen zuweisen, ohne deine Karte zu verändern.
  </Step>

  <Step title="Ressourcen in der verwalteten Organisation zuweisen">
    Öffne die geteilte Karte unter **Ressourcen** → **Karten**. Du weist nur eigene Ressourcen auf vorhandene freie Plätze zu. Zeichnen, Verschieben und Löschen von Grundriss-Elementen ist dort nicht möglich.
  </Step>

  <Step title="Teilen beenden">
    Wähle **Teilen beenden**. Die Karte verschwindet bei den verwalteten Organisationen, und alle dort zugewiesenen Ressourcen werden entfernt.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Wird mein hochgeladener Lageplan auf der Buchungsseite angezeigt?">
    Nein. Der Lageplan dient ausschließlich als Zeichenvorlage im Designer und ist auf der Buchungsseite nicht sichtbar. Eine mit KI erzeugte Ebene enthält dagegen gezeichnete Wände und Möbel und erscheint nach dem Aktivieren der Karte auf der Buchungsseite.
  </Accordion>

  <Accordion title="Kann die KI meinen Grundriss in eine Ebene umwandeln?">
    Ja. Nach dem Hochladen wählst du per Rechtsklick **Ebene mit KI generieren**. Das Ergebnis ist ein Entwurf. Prüfe ihn, bevor du die Karte live schaltest. Eine bestehende Ebene passt du über **Mit KI bearbeiten** an.
  </Accordion>

  <Accordion title="Welche Dateiformate kann ich als Lageplan hochladen?">
    Akzeptiert werden .pdf, .jpg und .png. Falls eine Datei nicht erkannt wird, ist sie möglicherweise zu groß. Komprimiere die Datei oder verwende einen Screenshot.
  </Accordion>

  <Accordion title="Kann ich nachträglich Änderungen an einer aktiven Karte vornehmen?">
    Ja. Als Admin kannst du alle Elemente der Karte jederzeit bearbeiten. Änderungen werden nach dem Speichern direkt auf der Buchungsseite sichtbar.
  </Accordion>

  <Accordion title="Wie verknüpfe ich einzelne Arbeitsplätze (Child-Ressourcen) mit der Karte?">
    Klappe im Ressourcen-Panel die übergeordnete Ressource auf, um die Child-Ressourcen anzuzeigen. Klicke dann auf die jeweilige Child-Ressource und anschließend auf den passenden Bereich in der Karte. Drücke **Escape**, um die Auswahl zu leeren.
  </Accordion>

  <Accordion title="Warum wird meine Karte auf der Buchungsseite nicht angezeigt?">
    Stelle sicher, dass du die Karte über das Einstellungsmenü (Zahnrad-Icon) aktiviert hast. Nur aktivierte Karten sind auf der Buchungsseite sichtbar.
  </Accordion>

  <Accordion title="Können verwaltete Organisationen den Lageplan ändern?">
    Nein. Sie weisen nur eigene Ressourcen auf vorhandene freie Plätze zu. Gebäude, Wände, Möbel und Karteneinstellungen bleiben bei der verwaltenden Organisation.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad Karten-Designer: **Ressourcen** → **Karten** → **Neu**
> * Feature muss vorab aktiviert werden: **Account-Einstellungen** → **Features** → **Karten & Interaktive Lagepläne**
> * Plan-Zuordnung: Karten & Interaktive Lagepläne ab Essential, 3D Raumplaner und Mehrfachkarten ab Professional
> * Akzeptierte Dateiformate für Lagepläne: .pdf, .jpg, .png
> * Lageplan/Bild dient nur als Zeichenvorlage im Designer, wird auf der Buchungsseite NICHT angezeigt
> * Ressourcen-Verknüpfung: orange = Bereich ohne Ressource, grün = erfolgreich verknüpft
> * Karte muss nach dem Zeichnen explizit über das Zahnrad-Menü aktiviert werden
> * Auto-save default on (`autoSave ?? true`), interval 1–60 minutes (default 2). UI: **Automatisch speichern** / **Speicherintervall**
> * AI floorplan (all designer users, not operator-only): right-click image **Ebene mit KI generieren**, toolbar/context **Mit KI bearbeiten**. Draft name **KI-Entwurf**. Confirm copy mentions usage costs. Do not document **Asset erstellen** (operator-only) or the standalone `/generate` wizard (admin entry not on release-admin)
> * Wände mit Türen/Fenstern: beim Verschieben/Drehen/Skalieren müssen alle zugehörigen Türen und Fenster mit ausgewählt sein
> * Rolle "Map Designer" existiert für eingeschränkte Karten-Berechtigungen
> * Cross-org sharing: only master orgs (`isMasterOrganization`). UI: **Mit verwalteten Organisationen teilen** / **Teilen beenden**, badge **Geteilt**. New master-org maps default `sharedWithManagedOrganizations: true`. Sub-orgs open assign-only designer (own resources on existing spots). Stop sharing unassigns sub-org resources. No extra plan flag beyond **Karten & Interaktive Lagepläne**.


# Microsoft SAML SSO
Source: https://docs.anny.co/microsoft-saml-sso



In diesem Artikel erfährst du, wie du einen Unternehmenslogin mit Microsoft bei anny einrichtest.

## Einrichtung

Zur Einrichtung von SSO müssen die folgenden Schritte von dir ausgeführt werden. Wichtig: Du musst für diese Einrichtung Administrator des Active Directories sein.

1. Gehe zu Azure Active Directory
2. Erstelle eine neue Unternehmensanwendung über *Unternehmensanwendungen* > *Neue Anwendung* > *Eigene Anwendung erstellen*
3. Gebe den Namen ein (z.B. anny SSO) und wähle "Integrate any other application you don't find in the gallery"
4. Gehe zu *SSO einrichten* bzw. *Einmaliges Anmelden*
5. Wähle SAML aus
6. Lade die [Metadaten XML Datei](https://app.anny.co/organization/settings/sso?o=) bei anny herunter und lade diese bei Microsoft über *Metadatendatei hochladen* hoch
7. Aktiviere die Signierung der Attribute
8. Lege fest, wer sich einloggen darf
9. Kopiere die App-Verbundsmetadaten-URL und hinterlege diese in anny

Im Anschluss kannst du direkt die SSO Verbindung testen und ggf. deine Einstellungen anpassen.

Hier findest du eine Erläuterung zu potenziellen Fehlermeldungen: [SSO Troubleshooting](/sso-overview)

Zur Einrichtung des Attribute Mappings findest du hier einen Artikel: [Attribute Mapping](/attribute-mapping)

## Schritt-für-Schritt Visualisierung

Folge den Screenshots, um das SSO mit Microsoft einzurichten.

### Erstelle eine neue Unternehmensanwendung

Zuerst musst du eine neue Unternehmensanwendung erstellen.

![Unternehmensanwendungen Übersicht](https://anny.intercom-attachments.eu/i/o/30918/b9ec9c95584720919a69e91f/image.png?expires=1784851200\&signature=3690b342130800b6c0e8fe2959462667f73a8bcd87e5547ad5e690375b4fe245\&req=09VmxFC2rTUh3Rr0v9tnrr%2Bb2x8gLt%2FkgbEicNrMpN0Buy%2B1yf4AbE0VigwB%0AIdXCeLfG6qyziWZkMX%2F8%0A)

![Neue Anwendung erstellen](https://anny.intercom-attachments.eu/i/o/30919/84c5ccc516757657fe33293c/image.png?expires=1784851200\&signature=d1a9014a769c6956b59c895429862b6b2bd2427ac1bcd3ca1842d783b94951be\&req=09VmxFG2rTUh3Rr0v9tnrnlBG2aZR3qziHi3lL6P751aDcxTqPZzEaIuxiat%0AuuYpB6NKOC%2B37phPLDZM%0A)

![Eigene Anwendung erstellen](https://anny.intercom-attachments.eu/i/o/30920/5dbf604fecfdbc7a5d7a32a9/image.png?expires=1784851200\&signature=76be7409177d694420060e2d29350c348fda6a574a131caf7f4536180717307d\&req=09Vmx1i2rTUh3Rr0v9tnrrHFQFmt2FdgSAJFHX%2FI326aAOSsmRQ1%2BWrzo3JW%0AKcl1XEWk8UQXnAK9%2FCkp%0A)

![Name und Galerie-Option](https://anny.intercom-attachments.eu/i/o/30921/8f4895167545a784776da90e/image.png?expires=1784851200\&signature=e4bc7d8ddcfc8c9c1234f32ee018e5cdb79130096d382e7948a662db873998db\&req=09Vmx1m2rTUh3Rr0v9tnrsi8Ciy5ZCWJXErnfpbW5KpMxXo42CdEKhqOQT26%0AVJN5zCStq3piGmqiUf%2FF%0A)

### SSO einrichten

Für die erstellte Anwendung musst du anschließend SSO einrichten.

![SSO einrichten Übersicht](https://anny.intercom-attachments.eu/i/o/30922/e8cb4b706e2547eac5a23d96/image.png?expires=1784851200\&signature=6d7b031c9e7050b00fe139ebc9f66de4364549d8d927cc095c337a07bea3ff27\&req=09Vmx1q2rTUh3Rr0v9tnrvCDCQ4xDL67pEQWnVoZqo4bLc8ZECCu9qS9csJz%0AJLf4%2BgnfNko07XFYC6Fc%0A)

![SAML auswählen](https://anny.intercom-attachments.eu/i/o/30923/697daf990514de5d6e901065/image.png?expires=1784851200\&signature=d2874625516aab842e2bedbf70bc996cd747d509b89ef8e2e3003ea01f8b9d24\&req=09Vmx1u2rTUh3Rr0v9tnrnyHMJVZvp1zu5gBAQOecimsbKZlO9JxaHBtDXdQ%0AXd4%2BI691vpBAkZfl6nfg%0A)

### Metadaten Datei hochladen

Um die meisten Einstellungen automatisch vorzunehmen, lädst du am besten die Metadaten Datei hoch.

![Metadatendatei hochladen](https://anny.intercom-attachments.eu/i/o/30924/9c2565950316e7b1c9996d4a/image.png?expires=1784851200\&signature=681efdcbbf389ee2c71c6d6dbf0756e712e5e6705da37bbf01e599a3cf83ac9b\&req=09Vmx1y2rTUh3Rr0v9tnrrvgamqFhrlbsvHN1hpwFgimsPrWK1Nhe6fa%2Bmrp%0AESEoex4jzZ1MLzSnz3Lx%0A)

### Aktiviere die Signierung der Attribute

Wir überprüfen aus Sicherheitsgründen immer die Signatur der übermittelten Attribute. Das ist standardmäßig deaktiviert. Unter dem Punkt "SAML Zertifikat" kannst du die Signierung aktivieren.

![SAML Zertifikat bearbeiten](https://downloads.intercomcdn.eu/i/o/2346033/0613700e6b79bbf72bfeda06/image.png?expires=1784851200\&signature=ab1771c8f68ded8a81b743d7cdb35d0df9daee23eeafcc0fc8d40965219d17d7\&req=0tZrw1j5r3sp2RPy89osp4otqxHG09cIB3ZC4a5Yx0xPnEtqAY9%2FnSA695eP%0AW1SL%2FARVZCO9jWiJJ5ZJgSc%3D%0A)

Wähle die Einstellungen wie im Screenshot dargestellt:

![Signierungsoptionen](https://downloads.intercomcdn.eu/i/o/2346168/fe78a9095532e1cd71223bbb/image.png?expires=1784851200\&signature=465222c808bb64f9de28bfe63134a03cc0d77d3942c3dc388a3ce173bbc7b520\&req=0tZrw1n8pHsp2RPy89osp3uAfYWVor%2B9O7z934cJAL0fnoEL7Pu64bvuIcZq%0A6krzfPySfOfbJxqWWtd%2FOe8%3D%0A)

### Lege fest, wer sich einloggen darf

Du musst nun noch festlegen, wer sich in die Applikation einloggen darf. Im Normalfall sollen sich alle deine Mitarbeiter:innen einloggen dürfen. Navigiere dazu zu "Eigenschaften" und setze die Option "Zuweisung erforderlich" auf "Nein".

![Zuweisung erforderlich auf Nein setzen](https://downloads.intercomcdn.eu/i/o/2346227/ead3275fa795b4b8b52b8ae7/image.png?expires=1784851200\&signature=a7b6de59ea9d3dd2cf597ab04cccfe4ad0c32279ea952e3b628c29a22f181a17\&req=0tZrw1r4q3sp2RPy89osp6wDFBLg%2Bxrn8jGxPqWA0DdJW%2FPiIMnHlpB%2Fi81Q%0AcTeN1OGg2ePuxDgtF7KiCdk%3D%0A)

Möchtest du nur bestimmten Benutzern den Zugriff erlauben, musst du die Option auf "Ja" einstellen und unter "Benutzer und Gruppen" die Benutzer auswählen, die Zugriff erhalten sollen.

### Metadaten URL kopieren und in anny hinterlegen

Abschließend kopierst du noch die Metadaten URL und hinterlegst diese in anny, sodass die Einrichtung abgeschlossen werden kann.

![Metadaten URL kopieren](https://anny.intercom-attachments.eu/i/o/30925/f737b4a007b8c20eb30f37e0/image.png?expires=1784851200\&signature=748eaf3c03cababc46b56f61fa55314b57976cb45cd37f8e1d5db4d85da0877f\&req=09Vmx122rTUh3Rr0v9tnruS045Y208OXng0%2FKOATGeHvrAZd0y7K09e6fQFc%0ABqAwJU7p33EcOi2jonWP%0A)

***

### Optional: Signatur der Anfrage überprüfen

Du hast die Möglichkeit die Signatur der Loginanfragen (SAMLRequest) überprüfen zu lassen. Dazu musst du das Zertifikat hochladen.

Zuerst musst du das Zertifikat herunterladen. Die URL dazu leitet sich von der Metadaten-URL ab.

Metadaten-URL: [**https://auth.anny.co/tenant/\{id}/saml/metadata**](https://auth.anny.co/tenant/\{id}/saml/metadata)

Zertifikat-URL: [**https://auth.anny.co/tenant/\{id}/saml/cert**](https://auth.anny.co/tenant/\{id}/saml/cert)

Dieses Zertifikat musst du anschließend hochladen:

![Zertifikat hochladen](https://downloads.intercomcdn.eu/i/o/2346333/e0eac70e209913a71cd3a0e2/image.png?expires=1784851200\&signature=38974f47cedd72fb16ca4c9be7d992d83734ccd1979a2192734b0498a1e76c2c\&req=0tZrw1v5r3sp2RPy89osp9zk796ccUHPtpQAkr%2BWY2e%2FYD1WhAB9htHQIe2s%0A72lxcVF0pfvn9jwCsswU4Vg%3D%0A)

![Verifizierungszertifikat](https://downloads.intercomcdn.eu/i/o/2346373/7513be2008d76b11dce1b650/image.png?expires=1784851200\&signature=6dd589e03ea7c28c891032fa4d218d5f5c235bbadfc56978e221df5606bc83e5\&req=0tZrw1v9r3sp2RPy89ospztuB81%2FdZjb0V6%2Fhg6X%2BIDZzMYyJsUdC6BeL9NH%0AoLz3yeScqjNnpEz2SuuhsV4%3D%0A)

## Gruppen für Attribute-Mapping freigeben

Damit du die Gruppen als zusätzliches Attribut in anny für das Attribute-Mapping nutzen kannst, muss dies erst im Azure Active Directory freigegeben werden. Folgende Schritte sind dafür nötig:

1. Gehe in das Azure Active Directory und wähle die angelegte Unternehmensanwendung aus.
2. Wähle hier den Reiter "Einmaliges Anmelden" aus.
3. Hier findest du die Kachel "Attribute & Ansprüche", drücke hier auf bearbeiten.
4. Hier kannst du nun über den Button "Gruppenanspruch hinzufügen" das Attribut hinzufügen.

![Gruppenanspruch hinzufügen](https://downloads.intercomcdn.eu/i/o/4812242/9aa47be57870170cdb867bd9/image.png?expires=1784851200\&signature=0144cbcf5c757836fd9b1a3ecb4004bd16d12258f053047a4ab760af40a37f3d\&req=1N1ux1r%2Brnsp2RPy89osp%2BAirYqrHDwT6H8ivqb7MashTUjTNGO9dTjL%2FwNR%0AewUWJ4gpkOI%2FhswVyRjTgZY%3D%0A)

5. Wähle dort "Alle Gruppen" aus und drücke auf speichern. Nun werden die Gruppen auch als Attribute mitgegeben und können in anny genutzt werden.

<Warning>
  **Wichtig:** Sollte der User zu vielen Gruppen zugeordnet sein, können diese von Microsoft nicht an uns übergeben werden. Dies zeigt sich z.B. darin, dass der User dann nicht durch das Attribute-Mapping zugeordnet werden kann. Hierzu ist folgender Workaround nötig:

  1. Wähle bei der Zuweisung von Gruppen nicht "Alle Gruppen" aus, sondern die Option "Der Anwendung zugewiesene Gruppen".
  2. Jetzt kann in der Anwendung unter "Benutzer & Gruppen" die Gruppen hinzugefügt werden, welche der Anwendung zugeordnet werden sollen. So werden nur die benötigten Gruppen zu anny übertragen.
</Warning>


# Mindest- und Maximalauswahl
Source: https://docs.anny.co/min-max-selection

Lege fest, wie viele Einheiten einer Buchungsoption mindestens oder maximal pro Bestellung gebucht werden dürfen.

Mit der Mindest- und Maximalauswahl steuerst du pro Buchungsoption, wie viele Einheiten innerhalb einer Bestellung mindestens oder maximal ausgewählt werden können. So bildest du Gruppenregeln und Mengenlimits direkt im Buchungsflow ab.

## Wie funktioniert die Mindest- und Maximalauswahl?

Du definierst für jede Buchungsoption individuell einen Minimal- und/oder Maximalwert. Diese Werte werden direkt im Buchungsprozess geprüft:

* Liegt die gewählte Menge **unter der Min. Auswahl**, kann die Bestellung nicht abgeschlossen werden.
* Liegt die gewählte Menge **über der Max. Auswahl**, wird diese Anzahl im Buchungsflow verhindert.

Die Limits gelten immer pro Buchungsoption und pro Bestellung. Jede Buchungsoption kann eigene Werte haben, unabhängig von anderen Optionen desselben Services. Ist **Exklusive Zeitfenster** auf der Ressource aktiv, gilt die Obergrenze **Erlaubte Buchungen pro Bestellung** der Ressource. Das Feld **Max. Buchungsanzahl pro Bestellung** auf der Buchungsoption ist dann nicht editierbar. Details: [Exklusive Zeitfenster](/exclusive-time-slots).

## Wann nutze ich das?

* **Du bietest Gruppentarife an**: Stelle sicher, dass eine Buchung erst ab einer bestimmten Personenzahl möglich ist (z. B. Gruppenausflug ab 6 Personen).
* **Du willst Mengenlimits pro Bestellung**: Begrenze, wie viele Tickets oder Plätze eine einzelne Person auf einmal buchen kann.
* **Du hast Mindestbestellmengen**: Verhindere Einzelbuchungen bei Angeboten, die nur ab einer bestimmten Menge wirtschaftlich sind.
* **Nicht geeignet für**: Globale Buchungslimits pro Zeitraum. Dafür nutze stattdessen Buchungsregeln (**Account-Einstellungen** → **Buchungsregeln**).

## Zusammenhang mit anderen Features

* **Buchungsregeln**: Während die Mindest-/Maximalauswahl die Menge pro Einzelbestellung steuert, limitieren Buchungsregeln die Gesamtanzahl an Buchungen pro Zeitraum accountweit.
* **Buchungskontingente**: Kontingente begrenzen die verfügbare Gesamtmenge einer Buchungsoption. Die Min-/Max-Auswahl steuert dagegen, wie viel davon in einer einzelnen Bestellung gebucht werden darf.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Min. Auswahl pro Bestellung | Mindestanzahl für eine gültige Bestellung |
| Max. Auswahl pro Bestellung | Maximal erlaubte Anzahl pro Bestellung |

Die Einstellungen findest du unter **Ressourcen** → Buchungsoption → **Erweiterte Einstellungen**.

<Tip>
  Beide Felder sind optional. Du kannst auch nur ein Minimum oder nur ein Maximum setzen, ohne den jeweils anderen Wert zu definieren.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Tauchcenter verkauft Gruppenausflüge ab 6 Personen">
    Ein Tauchcenter bietet Gruppenausflüge an, die sich erst ab 6 Personen lohnen. Maximal können 20 Personen teilnehmen.

    <Steps>
      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen** → die betreffende Ressource → Buchungsoption **Gruppenausflug**.
      </Step>

      <Step title="Erweiterte Einstellungen aufrufen">
        Scrolle zu **Erweiterte Einstellungen**.
      </Step>

      <Step title="Min. und Max. Auswahl setzen">
        Setze **Min. Auswahl pro Bestellung** auf **6** und **Max. Auswahl pro Bestellung** auf **20**.
      </Step>

      <Step title="Speichern">
        Klicke auf **Speichern**. Kund:innen können den Gruppenausflug jetzt nur für 6 bis 20 Personen buchen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Ein Yoga-Studio begrenzt Drop-In-Tickets auf max. 3 pro Bestellung">
    Ein Yoga-Studio möchte verhindern, dass eine Person mehr als 3 Drop-In-Plätze auf einmal bucht.

    <Steps>
      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen** → die betreffende Ressource → Buchungsoption **Drop-In**.
      </Step>

      <Step title="Erweiterte Einstellungen aufrufen">
        Scrolle zu **Erweiterte Einstellungen**.
      </Step>

      <Step title="Max. Auswahl setzen">
        Setze **Min. Auswahl pro Bestellung** auf **1** und **Max. Auswahl pro Bestellung** auf **3**.
      </Step>

      <Step title="Speichern">
        Klicke auf **Speichern**. Pro Bestellung sind jetzt maximal 3 Drop-In-Tickets buchbar.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Gelten die Limits pro Buchungsoption oder pro Service?">
    Pro Buchungsoption. Wenn du mehrere Buchungsoptionen an einem Service hast, kann jede eigene Min-/Max-Werte haben.
  </Accordion>

  <Accordion title="Was passiert, wenn ich nur ein Minimum setze?">
    Dann gibt es nach oben kein Limit (außer durch die verfügbare Kapazität der Ressource). Umgekehrt: Nur ein Maximum ohne Minimum bedeutet, dass ab 1 Einheit gebucht werden kann.
  </Accordion>

  <Accordion title="Sehen Kund:innen eine Fehlermeldung, wenn sie das Limit verletzen?">
    Ja. Liegt die Auswahl unter dem Minimum, kann die Bestellung nicht abgeschlossen werden. Liegt sie über dem Maximum, wird die Eingabe im Buchungsflow verhindert.
  </Accordion>

  <Accordion title="Funktioniert das auch bei kostenlosen Buchungsoptionen?">
    Ja. Die Min-/Max-Auswahl ist unabhängig davon, ob die Buchungsoption einen Preis hat oder nicht.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Min-/Max-Einstellung hat keinen sichtbaren Effekt">
    Prüfe, ob die Buchungsoption überhaupt eine Mengenauswahl im Buchungsflow anzeigt. Bei Buchungsoptionen mit Gewichtung 1 und ohne Mengenauswahl greifen die Felder nicht.
  </Accordion>

  <Accordion title="Kund:innen können trotzdem weniger als das Minimum buchen">
    Stelle sicher, dass du die Einstellung an der richtigen Buchungsoption vorgenommen hast. Die Limits gelten pro Buchungsoption, nicht pro Service oder Ressource.
  </Accordion>

  <Accordion title="Ich finde die Felder nicht in den Einstellungen">
    Die Felder befinden sich unter **Erweiterte Einstellungen** innerhalb der jeweiligen Buchungsoption. Scrolle in der Buchungsoptionskonfiguration nach unten.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Ressourcen** → Buchungsoption → **Erweiterte Einstellungen** → Min. Auswahl pro Bestellung / Max. Auswahl pro Bestellung
> * Die Limits gelten pro Buchungsoption, NICHT global pro Service oder Ressource.
> * Wirkt nur bei Mehrfachbuchungen (Gewichtung > 1 oder Mengenbuchung). Bei Buchungsoptionen mit Gewichtung 1 und ohne Mengenauswahl haben die Felder keinen sichtbaren Effekt.
> * Abgrenzung: Mindest-/Maximalauswahl ≠ Buchungsregeln. Buchungsregeln limitieren die Gesamtanzahl pro Zeitraum accountweit. Min/Max limitieren die Menge pro Einzelbestellung.
> * Abgrenzung: Mindest-/Maximalauswahl ≠ Buchungskontingente. Kontingente begrenzen die verfügbare Gesamtmenge. Min/Max steuert die Menge pro Bestellung.
> * Verfügbar in allen Plänen.


# Mobile Benachrichtigungen
Source: https://docs.anny.co/mobile-notifications

Sende Kund:innen und Gastgebern SMS, WhatsApp oder Telegram zu Buchungen, Check-ins und Erinnerungen.

Mit mobilen Benachrichtigungen erreichst du Kund:innen und Gastgeber auf dem Smartphone, zusätzlich zur E-Mail. Ob Buchungsbestätigung, Erinnerung oder die Info an den Gastgeber, dass ein Besucher da ist: SMS, WhatsApp und Telegram sorgen dafür, dass wichtige Nachrichten nicht untergehen.

<Info>
  Verfügbar ab dem **Essential** Plan. Jede gesendete Nachricht wird nach deinem Plan abgerechnet. Der Schalter heißt deshalb **Mobile Nachrichten aktivieren (kostenpflichtig)**.
</Info>

## Wie funktionieren mobile Benachrichtigungen?

Du findest die Einstellungen in der Seitenleiste unter **Account** → **Einstellungen** → Reiter **Allgemein** → **Shop-Einstellungen** → Gruppe **Mitteilungen**. Dort schaltest du die Kanäle und die Ereignisse ein. Kund:innen wählen im Checkout zwischen WhatsApp und SMS.

<Frame>
  <img alt="Account-Einstellungen, Reiter Allgemein: Seitenleiste Account, Einstellungen, Gruppe Mitteilungen mit aktiven mobilen Nachrichten, Kanälen und Ereignissen" />
</Frame>

### Verfügbare Kanäle

| Kanal | Voraussetzung |
| - | - |
| **Mobile Nachrichten per SMS** | Handynummer im Profil |
| **Mobile Nachrichten über WhatsApp** | Handynummer im Profil |
| **Mobile Nachrichten über Telegram** | Handynummer im Profil |

Schaltest du den letzten Kanal aus, gehen auch die mobilen Nachrichten aus.

### Verfügbare Ereignisse

Unter **Ereignisse** entscheidest du, wofür eine mobile Nachricht rausgeht. Schaltest du ein Ereignis ein, werden die mobilen Nachrichten mit aktiviert.

| Ereignis | Beschreibung |
| - | - |
| **Buchungsbestätigung** | Nachricht bei einer erfolgreichen Buchung |
| **Buchungs-Updates** | Änderungen an bestehenden Buchungen |
| **Buchungserinnerungen** | Erinnerung vor dem Buchungsbeginn |
| **Self Check-In** | Nachricht beim erfolgreichen Self Check-In |
| **Besucher eingecheckt (Gastgeber)** | Der Gastgeber wird informiert, sobald ein Besucher am Check-in eincheckt |
| **Zertifikat Benachrichtigungen** | Nachricht, wenn ein Zertifikat ausgestellt wird. Der Schalter erscheint, wenn Zertifikate für deinen Account aktiv sind. |
| **Ticket aufgerufen** | Nachricht, wenn ein Ticket in der Warteschlange aufgerufen wird. Der Schalter erscheint, wenn Warteschlangen aktiv sind. Dabei werden SMS und WhatsApp eingeschaltet. |

<Tip>
  **Immer mobile Benachrichtigung senden** schickt eine SMS, sobald eine Handynummer vorliegt, auch ohne Zustimmung der Kundin. Lass den Schalter aus, solange Kund:innen selbst entscheiden sollen.
</Tip>

## Wann nutze ich das?

* **Kund:innen müssen pünktlich erscheinen** (zum Beispiel im Salon oder in der Praxis). Eine Erinnerung per SMS oder WhatsApp senkt No-Shows.
* **Der Gastgeber soll sofort erfahren, dass ein Gast da ist.** **Besucher eingecheckt (Gastgeber)** informiert den Gastgeber, sobald der Gast eincheckt.
* **Kund:innen lesen E-Mails nicht zeitnah.** Eine Nachricht auf dem Handy kommt eher an als eine Mail im Postfach.
* **Nicht geeignet für** rein interne Planung ohne Kontakt zu Kund:innen. Dafür reichen E-Mail und das Dashboard.

## Zusammenhang mit anderen Features

* **Check-in.** **Besucher eingecheckt (Gastgeber)** setzt voraus, dass der Gastgeber der Buchung zugeordnet ist und eine Handynummer hat.
* **Broadcasting.** Broadcasting nutzt eigene Kanäle für Kampagnen. Mobile Benachrichtigungen hängen an einzelnen Ereignissen wie Bestätigung, Änderung oder Check-in.

## Einstellungen und Optionen

| Einstellung | Beschreibung |
| - | - |
| Mobile Nachrichten aktivieren (kostenpflichtig) | Schaltet mobile Nachrichten ein. Aus schaltet die Ereignisse aus, die eine Nachricht voraussetzen. |
| Mobile Nachrichten per SMS | SMS als Kanal |
| Mobile Nachrichten über WhatsApp | WhatsApp als Kanal |
| Mobile Nachrichten über Telegram | Telegram als Kanal |
| Immer mobile Benachrichtigung senden | Sendet eine SMS, sobald eine Handynummer da ist, auch ohne Opt-in |
| Ereignisse | Pro Ereignis festlegen, ob mobil benachrichtigt wird |

Die Preise pro Nachricht stehen in deinem Plan unter **Account** → **Einstellungen** → Reiter **Abo**.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Salon sendet die Buchungserinnerung per WhatsApp">
    Ein Salon will No-Shows senken und schaltet **Buchungserinnerungen** zusammen mit **Mobile Nachrichten über WhatsApp** ein. Zeitpunkt und Text der E-Mail-Erinnerung stellst du am Service unter [Mitteilungen](/configure-notifications#terminerinnerung-am-service) ein.
  </Accordion>

  <Accordion title="Der Gastgeber erfährt per SMS, wenn ein Besucher eincheckt">
    Schalte **Besucher eingecheckt (Gastgeber)** und **Mobile Nachrichten per SMS** ein. Der Gastgeber braucht eine Handynummer. Wenn die Nachricht auch ohne Opt-in raus soll, schalte zusätzlich **Immer mobile Benachrichtigung senden** ein.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Werden mobile Benachrichtigungen zusätzlich zur E-Mail gesendet?">
    Ja. Mobile Nachrichten ergänzen die E-Mail, sie ersetzen sie nicht. Beide können parallel aktiv sein.
  </Accordion>

  <Accordion title="Kann ich sehen, welche mobilen Nachrichten versendet wurden?">
    Ja. Im [Aktivitäts-Log](/activity-log) einer Buchung oder Bestellung siehst du den Versand mobiler Nachrichten mit Zustellstatus.
  </Accordion>

  <Accordion title="Was kostet eine mobile Nachricht?">
    Der Preis pro Nachricht hängt von deinem Plan ab. Du findest ihn unter **Account** → **Einstellungen** → Reiter **Abo**.
  </Accordion>

  <Accordion title="Können Kund:innen mobile Benachrichtigungen abbestellen?">
    Ja. Im Checkout und im Profil entscheiden Kund:innen, ob sie mobile Nachrichten wollen. **Immer mobile Benachrichtigung senden** übergeht diese Entscheidung und schickt die SMS trotzdem.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Es erscheint die Warnung zur Handynummer">
    Steht unter dem Schalter **Die Handynummer wird derzeit nicht in den Checkoutfelder angezeigt.**, wird die Nummer im Checkout nicht abgefragt. Öffne in derselben Ansicht **Shop-Einstellungen** die Gruppe **Zusätzliche Felder im Checkout** und zeige **Handynummer** an.
  </Accordion>

  <Accordion title="Kund:in erhält keine mobile Nachricht">
    Prüfe, ob **Mobile Nachrichten aktivieren (kostenpflichtig)** an ist, ob mindestens ein Kanal und das passende Ereignis aktiv sind und ob im Profil eine Handynummer steht.
  </Accordion>

  <Accordion title="Gastgeber wird nicht über den Check-in informiert">
    Stelle sicher, dass **Besucher eingecheckt (Gastgeber)** aktiv ist, **Mobile Nachrichten per SMS** eingeschaltet ist und beim Gastgeber eine Handynummer hinterlegt ist.
  </Accordion>

  <Accordion title="WhatsApp-Nachrichten werden nicht zugestellt">
    WhatsApp braucht eine Handynummer mit aktivem WhatsApp-Konto. Fehlt das Konto, kommt die Nachricht nicht an. Schalte zusätzlich **Mobile Nachrichten per SMS** ein.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature `mobile-notifications`, Planname **Mobile Nachrichten**, ab Essential, Abrechnung pro gesendeter Nachricht.
> * UI-Pfad: Account → Einstellungen → Allgemein → Shop-Einstellungen → Gruppe Mitteilungen. Die Komponente sitzt über **Zusätzliche E-Mail Informationen**. Die eigene Überschrift **Mobile Benachrichtigungen** ist in dieser Einbettung ausgeblendet. Sichtbar ist der Schalter **Mobile Nachrichten aktivieren (kostenpflichtig)**.
> * Alte Route Avatar → Account-Einstellungen → Mitteilungen gibt es nicht mehr.
> * Kanäle: SMS, WhatsApp, Telegram (Telegram nur, wenn zur Laufzeit eingeschaltet). Letzter Kanal aus schaltet die mobilen Nachrichten aus.
> * Ereignisse: Buchungsbestätigung, Buchungs-Updates, Buchungserinnerungen, Self Check-In, Besucher eingecheckt (Gastgeber), Zertifikat Benachrichtigungen (Feature `tests`), Ticket aufgerufen (Feature `queues`, schaltet SMS und WhatsApp ein).
> * **Immer mobile Benachrichtigung senden** schickt eine SMS ohne Opt-in, sobald eine Nummer da ist.
> * Warnung, wenn `checkout.additionalFields` die Handynummer nicht enthält. Gruppe **Zusätzliche Felder im Checkout**, Feld **Handynummer**.
> * Preise: Einstellungen → Abo.


# Änderung von Buchungen
Source: https://docs.anny.co/modify-bookings

Ermögliche Kund:innen, Buchungen selbst zu verschieben, Child-Ressourcen zu wechseln und Formulardaten anzupassen.

Mit der Buchungsbearbeitung können Endnutzer:innen ihre bestehenden Buchungen selbst anpassen, ohne den Support oder Admins kontaktieren zu müssen. Je nach Konfiguration lassen sich Datum, Uhrzeit, Child-Ressource, Zusatzoptionen und Formulardaten nachträglich ändern. Preisänderungen werden dabei automatisch als Nachzahlung oder Rückerstattung verarbeitet.

## Wie funktioniert Änderung von Buchungen?

Standardmäßig ist die Buchungsbearbeitung für Endnutzer:innen deaktiviert. Admins aktivieren sie pro Buchungsoption im Tab **Änderung & Stornierung** und legen dort fest:

* **Nachträgliche Bearbeitung von Start- und Enddatum**: Bestimmt, ob und wie Termine verschoben werden dürfen.
  * **Aktiviert**: Endnutzer:innen können Termine flexibel verschieben, auch auf einen früheren Zeitpunkt.
  * **Nur in der Zukunft**: Buchungen dürfen ausschließlich weiter in die Zukunft verschoben werden.
* **Nachträgliche Bearbeitung von Child-Ressource**: Erlaubt den Wechsel auf eine andere verfügbare Child-Ressource (z. B. einen anderen Desk oder Raum).
* **Nachträgliche Bearbeitung von Serviceoptionen**: Erlaubt das Anpassen von Zusatzoptionen nach der Buchung.
* **Nachträgliche Bearbeitung von Formularen erlauben**: Erlaubt Kund:innen, ihre übermittelten Formulardaten in der Buchungsübersicht einzusehen und zu bearbeiten (nur Web).
* **Umbuchungsfrist**: Definiert, bis wann vor dem Termin Änderungen erlaubt sind (z. B. bis 24 Stunden vor Start).

Endnutzer:innen sehen die Option **Bearbeiten** im Bereich **Meine Buchungen**, sobald die Funktion für ihre Buchung aktiv ist.

### Regeln bei Änderungen

**Vorlaufzeiten werden beachtet**: Hinterlegte Vorlaufzeiten für Services und Add-Ons gelten auch bei Änderungen. Eine Buchung kann nur auf einen neuen Termin verschoben werden, wenn die Vorlaufzeit eingehalten wird.

**Frühester möglicher neuer Termin**: Der früheste neue Termin ergibt sich aus der Formel: frühester neuer Termin = MIN(alter Termin, heute + Vorlaufzeit). Dadurch wird sichergestellt, dass Änderungen nur auf zulässige Zeitfenster möglich sind.

**Änderungsfrist**: Buchungen können nur bearbeitet werden, wenn sie noch innerhalb der definierten Umbuchungsfrist liegen. Ist die Frist überschritten, wird keine Bearbeitung mehr angeboten.

**Negative Umbuchungsfrist**: Eine negative Frist (z. B. -3 Stunden) hält das Bearbeitungsfenster auch nach dem Buchungsstart offen. In diesem Zeitfenster ist eine Verlängerung der aktuellen Buchung in beiden Modi ("Aktiviert" und "Nur in der Zukunft") möglich.

**Child-Ressourcen-Wechsel**: Nur möglich, wenn Admins die Option aktiviert haben und im gewünschten Zeitraum passende Child-Ressourcen verfügbar sind.

**Automatische Preisverarbeitung**: Preisänderungen durch die Bearbeitung werden automatisch verarbeitet. Je nach Änderung wird eine Nachzahlung oder eine Rückerstattung ausgelöst, ohne dass Admins manuell eingreifen müssen.

<Tip>
  Eine negative Umbuchungsfrist ist besonders nützlich für Raummieten: Fällt im Termin auf, dass mehr Zeit benötigt wird, kann die Buchung noch während der laufenden Nutzung verlängert werden.
</Tip>

## Wann nutze ich das?

* **Du betreibst Desk Sharing oder Coworking und möchtest Endnutzer:innen maximale Flexibilität geben**: Aktiviere die volle Bearbeitung inkl. Child-Ressourcen-Wechsel, damit Nutzer:innen selbst auf einen anderen Arbeitsplatz umbuchen können.
* **Du bietest Terminbuchungen an und willst Stornierungen reduzieren**: Erlaube das Verschieben in die Zukunft, sodass Kund:innen bei Verhinderung einfach umbuchen statt zu stornieren.
* **Du mietest Konferenzräume und brauchst aktuelle Formularangaben (Catering, Personenzahl)**: Aktiviere die nachträgliche Bearbeitung von Formularen, damit Kund:innen ihre Angaben bis kurz vor dem Termin selbst aktualisieren können.
* **Du hast kostenpflichtige Buchungen mit unterschiedlichen Preisstufen**: Preisänderungen bei Umbuchungen werden automatisch abgewickelt.
* **Nicht geeignet für**: Buchungen, bei denen nach Bestätigung keine Änderung mehr möglich sein soll (z. B. verbindliche Event-Tickets mit fester Kapazität). Deaktiviere in diesem Fall die Buchungsbearbeitung.

## Zusammenhang mit anderen Features

* [**Eigene Formulare**](/custom-forms): Der Toggle "Nachträgliche Bearbeitung von Formularen erlauben" ergänzt eigene Formulare, indem Kund:innen ihre übermittelten Daten nach der Buchung selbst korrigieren können.
* [**Stornierungsbedingungen**](/cancellation-policy): Stornierungsbedingungen und Buchungsbearbeitung werden im gleichen Tab konfiguriert. Die Buchungsbearbeitung kann als Alternative zur Stornierung positioniert werden.
* [**Wiederkehrende Buchungen**](/recurring-bookings): Formulardaten bei Serien werden nur auf dem Mastertermin gespeichert. Die nachträgliche Bearbeitung bezieht sich auf den Master.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Nachträgliche Bearbeitung Start-/Enddatum | Deaktiviert / Aktiviert / Nur in der Zukunft |
| Nachträgliche Bearbeitung Child-Ressource | Wechsel auf andere Child-Ressource erlauben |
| Nachträgliche Bearbeitung Serviceoptionen | Zusatzoptionen nach Buchung anpassen |
| Nachträgliche Bearbeitung von Formularen erlauben | Formulardaten in Buchungsübersicht bearbeitbar (nur Web) |
| Umbuchungsfrist | Zeitraum vor Start, bis wann Änderungen erlaubt sind |

Auf der Buchungsseite sehen Endnutzer:innen den Button **Bearbeiten** unter **Meine Buchungen**, sofern die Funktion aktiv und die Frist nicht abgelaufen ist.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Coworking-Space erlaubt Desk-Wechsel nach Buchung">
    Ein Coworking-Betreiber möchte, dass Mitglieder ihren gebuchten Arbeitsplatz selbst auf einen anderen verfügbaren Desk umbuchen können, z. B. weil ein ruhigerer Platz bevorzugt wird.
  </Accordion>

  <Accordion title="Konferenzraum mit nachträglicher Formularanpassung (Catering, Personenzahl)">
    Ein Unternehmen vermietet Konferenzräume und fragt bei der Buchung Catering-Wünsche und Personenzahl per Formular ab. Da sich diese Angaben oft kurzfristig ändern, sollen Kund:innen sie bis 2 Tage vor dem Termin selbst aktualisieren können.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Warum sehe ich die Bearbeiten-Option nicht in Meine Buchungen?">
    Mögliche Gründe: Die Buchungsbearbeitung wurde von Admins nicht aktiviert, die Änderungsfrist ist bereits abgelaufen, oder die Buchung erfüllt die Voraussetzungen für eine Änderung nicht mehr.
  </Accordion>

  <Accordion title="Warum kann ich den Termin ändern, aber nicht den Desk wechseln?">
    Der Wechsel von Child-Ressourcen ist nur möglich, wenn Admins diese Option separat freigeschaltet haben und im gewünschten Zeitraum passende Child-Ressourcen verfügbar sind.
  </Accordion>

  <Accordion title="Was passiert, wenn sich durch die Änderung der Preis verändert?">
    anny verarbeitet Preisänderungen automatisch. Je nach Fall wird eine Nachzahlung (z. B. bei Verlängerung) oder eine Rückerstattung (z. B. bei Wechsel auf günstigere Option) ausgelöst.
  </Accordion>

  <Accordion title="Werden Vorlaufzeiten auch bei Änderungen berücksichtigt?">
    Ja. Hinterlegte Vorlaufzeiten für Services und Add-Ons gelten auch bei der Bearbeitung bestehender Buchungen.
  </Accordion>

  <Accordion title="Können Kund:innen Formulardaten auch in der App bearbeiten?">
    Nein. Die nachträgliche Bearbeitung von Formulardaten ist aktuell nur in der Web-Version verfügbar. Die mobile App unterstützt diese Funktion noch nicht.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich kann meine Buchung nicht mehr bearbeiten">
    Die Änderungsfrist ist vermutlich überschritten, oder für den gewünschten neuen Termin wird die Vorlaufzeit nicht eingehalten. Prüfe beides in den Einstellungen der Buchungsoption.
  </Accordion>

  <Accordion title="Ich kann keinen anderen Desk oder Raum auswählen">
    Prüfe, ob der Wechsel von Child-Ressourcen aktiviert wurde und ob im gewünschten Zeitraum passende Child-Ressourcen verfügbar sind. Ohne beides ist kein Wechsel möglich.
  </Accordion>

  <Accordion title="Kund:innen können Formulardaten nicht bearbeiten">
    Prüfe, ob der Toggle **Nachträgliche Bearbeitung von Formularen erlauben** im betreffenden Service aktiv ist. Die Funktion ist nur in der Web-Version verfügbar, nicht in der mobilen App.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Ressourcen** → Buchungsoption → Tab **Änderung & Stornierung**
> * Default: Buchungsbearbeitung deaktiviert, muss von Admins explizit pro Buchungsoption aktiviert werden
> * Modi Start-/Enddatum: "Aktiviert" (flexibel in beide Richtungen) vs. "Nur in der Zukunft" (nur nach hinten verschieben)
> * Negative Umbuchungsfrist (z. B. -3h): Bearbeitungsfenster bleibt nach Buchungsstart offen, Verlängerung in beiden Modi möglich
> * Frühester neuer Termin = MIN(alter Termin, heute + Vorlaufzeit)
> * Preisänderungen: automatische Nachzahlung oder Rückerstattung, kein manueller Eingriff nötig
> * Formular-Toggle: "Nachträgliche Bearbeitung von Formularen erlauben" pro Service, nur Web-Version (mobile App nicht enthalten)
> * Mobile App: Buchungsbearbeitung insgesamt aktuell nicht in der App verfügbar
> * Child-Ressourcen-Wechsel: separater Toggle, nur wenn passende Child-Ressourcen im Zeitraum frei
> * Verwandte Artikel: /custom-forms, /cancellation-policy, /buchungsoption-konfigurieren, /recurring-bookings


# OAuth2 SSO
Source: https://docs.anny.co/oauth2-sso

Richte einen Unternehmenslogin über OAuth2 in anny ein, inklusive Callback-URL, Scopes und Attributzuordnung.

In diesem Artikel erfährst du, wie du einen Unternehmenslogin über OAuth2 bei anny einrichtest. Das ist die richtige Wahl, wenn dein Identity Provider weder SAML 2.0 noch OpenID Connect unterstützt.

<Info>
  Unterstützt dein Identity Provider SAML 2.0, empfehlen wir diesen Weg, da mehr Funktionen wie SCIM und föderierte Anmeldungen zur Verfügung stehen. Eine Anleitung findest du unter [Generisches SAML 2.0 SSO](/generic-saml-sso). Unterstützt er OpenID Connect, ist [OpenID Connect SSO](/openid-connect-sso) der einfachere Weg, weil anny die Endpunkte dort automatisch ausliest.
</Info>

## Vorbereitung

Die SSO Verbindung kannst du selbstständig in deinem anny [Admin Bereich](https://app.anny.co/organization/settings/sso?o=) unter SSO & Sicherheit hinterlegen. Neben den anny Admin Rechten benötigst du administrativen Zugang zu deinem Identity Provider, um dort eine OAuth2-Anwendung anzulegen.

Lege zuerst in deinem Identity Provider eine neue OAuth2-Anwendung (teilweise auch "Client" oder "App" genannt) an. Du erhältst dabei eine Client ID und ein Client Secret.

## Einrichtung

<Steps>
  <Step title="Identity Provider in anny anlegen">
    Gehe in die [SSO Einstellungen](https://app.anny.co/organization/settings/sso?o=), wähle "IDP hinzufügen" und dann als Provider "Custom OAuth2". Vergib einen Namen, zum Beispiel "Unternehmenslogin".
  </Step>

  <Step title="Zugangsdaten und URLs eintragen">
    Trage Client ID, Client Secret sowie die drei Endpunkte deines Identity Providers ein. Welche Werte gemeint sind, erklärt die Tabelle unten. Speichere anschließend.
  </Step>

  <Step title="Callback-URL bei deinem Identity Provider hinterlegen">
    Nach dem Speichern zeigt anny dir die Callback-URL an. Kopiere sie und trage sie in deinem Identity Provider als erlaubte Redirect-URL ein.
  </Step>

  <Step title="Verbindung testen und aktivieren">
    Aktiviere den Identity Provider über die drei Punkte > Aktivieren und teste den Login über "Test Connection".
  </Step>
</Steps>

<Warning>
  **Wichtig:** Die Callback-URL steht erst nach dem ersten Speichern zur Verfügung, da sie die ID des Identity Providers enthält. Solange die URL bei deinem Identity Provider nicht hinterlegt ist, bricht der Login mit einer Fehlermeldung wie "redirect\_uri mismatch" ab.
</Warning>

Die Callback-URL folgt diesem Muster, wobei `{id}` die ID des angelegten Identity Providers ist:

Callback-URL: [**https://auth.anny.co/identity-provider/\{id}/oauth/callback**](https://auth.anny.co/identity-provider/\{id}/oauth/callback)

## Pflichtfelder

| Feld in anny | Beschreibung |
| - | - |
| **Client ID** | Die Kennung der OAuth2-Anwendung, die du in deinem Identity Provider angelegt hast. |
| **Client Secret** | Das zugehörige Geheimnis. anny speichert es verschlüsselt. |
| **Authorization URL** | Der Endpunkt, zu dem anny deine Nutzer:innen zum Login weiterleitet. Endet häufig auf `/authorize`. |
| **Token URL** | Der Endpunkt, über den anny den Access Token abruft. Endet häufig auf `/token`. |
| **User Info URL** | Der Endpunkt, über den anny die Nutzerdaten abruft. Endet häufig auf `/userinfo`. |
| **Scopes** | Die angefragten Berechtigungen, getrennt durch Leerzeichen. Bei OpenID Connect üblicherweise `openid profile email`. |

<Tip>
  Viele Identity Provider veröffentlichen ihre Endpunkte unter `https://<dein-provider>/.well-known/openid-configuration`. Dort findest du die Werte für Authorization URL, Token URL und User Info URL gebündelt. Existiert dieses Dokument, unterstützt dein Identity Provider OpenID Connect — dann musst du die Endpunkte nicht von Hand eintragen, siehe [OpenID Connect SSO](/openid-connect-sso).
</Tip>

## Erweiterte Optionen

Die erweiterten Optionen brauchst du nur, wenn dein Identity Provider vom Standard abweicht. Du findest sie im Formular unter "Erweiterte Optionen".

| Feld in anny | Beschreibung |
| - | - |
| **PKCE verwenden** | Aktiviere diese Option, wenn dein Identity Provider Proof Key for Code Exchange voraussetzt. |
| **Scope-Trennzeichen** | Zeichen, mit dem die Scopes in der Anfrage getrennt werden. Die meisten OpenID-Connect-Anbieter erwarten ein Leerzeichen. |
| **Token-Anfrage als JSON senden** | Fordert den Access Token mit einem JSON-Body statt einer Formular-Kodierung an. |
| **Basic-Auth-Benutzername und -Passwort** | Werden als HTTP-Basic-Authentifizierung an den Token-Endpunkt gesendet, falls dein Identity Provider das verlangt. |
| **Attribut-Felder** | Legen fest, aus welchen Feldern der User-Info-Antwort anny ID, E-Mail, Vor- und Nachname liest. |

### Attribute zuordnen

Standardmäßig erwartet anny die Felder `id`, `email`, `firstname` und `lastname`. Viele Identity Provider nutzen abweichende Namen. Bei OpenID Connect sind zum Beispiel folgende Werte üblich:

| Feld in anny | Typischer Wert bei OpenID Connect |
| - | - |
| **Benutzer-ID-Attribut** | `sub` |
| **E-Mail-Attribut** | `email` |
| **Vorname-Attribut** | `given_name` |
| **Nachname-Attribut** | `family_name` |

Liegen die Werte verschachtelt in der Antwort, kannst du den Pfad mit Punkten angeben, zum Beispiel `data.user.id`.

<Note>
  Diese Felder steuern nur, woher anny die Nutzerdaten liest. Wenn du Nutzer:innen zusätzlich automatisch Communities zuordnen möchtest, nutze dafür das [Attribute Mapping](/attribute-mapping).
</Note>

## Nach der Einrichtung

* Über die drei Punkte kannst du dir einen Wayfless-Link erzeugen. Damit landen deine Nutzer:innen direkt im Login deines Identity Providers.
* Mit [Attribute Mapping](/attribute-mapping) ordnest du Nutzer:innen automatisch Communities zu.

## Troubleshooting

<AccordionGroup>
  <Accordion title="404: Seite nicht gefunden">
    Der Identity Provider ist noch nicht aktiviert. Aktiviere ihn über die drei Punkte > Aktivieren. Solange er deaktiviert ist, sind Login und Callback bewusst nicht erreichbar.
  </Accordion>

  <Accordion title="redirect_uri mismatch">
    Die Callback-URL ist bei deinem Identity Provider nicht oder nicht exakt hinterlegt. Kopiere sie erneut aus anny und achte darauf, dass sie zeichengenau übereinstimmt, inklusive `https://` und ohne abschließenden Schrägstrich.
  </Accordion>

  <Accordion title="Login funktioniert, aber es fehlen Nutzerdaten">
    Prüfe die Attribut-Felder in den erweiterten Optionen. Wenn dein Identity Provider zum Beispiel `given_name` statt `firstname` liefert, muss der Wert dort entsprechend hinterlegt sein. Prüfe außerdem, ob die angefragten Scopes ausreichen, um E-Mail und Namen zu erhalten.
  </Accordion>

  <Accordion title="Fehler beim Abrufen des Tokens">
    Kontrolliere Client ID und Client Secret sowie die Token URL. Verlangt dein Identity Provider HTTP-Basic-Authentifizierung oder einen JSON-Body, aktiviere die passenden erweiterten Optionen.
  </Accordion>
</AccordionGroup>

Eine allgemeine Übersicht zu SSO findest du hier: [SSO Übersicht](/sso-overview)


# Online-Zahlung & Gebühren
Source: https://docs.anny.co/online-payments



anny wickelt Zahlungen über **Stripe** ab. Pro Transaktion fällt eine anny-Plattformgebühr an: ein Prozentsatz plus ein kleiner Festbetrag. Wie genau sich die Gebühr zusammensetzt, hängt davon ab, in welchem Land deine Organisation registriert ist.

Die gute Nachricht: **Deine Gesamtkosten pro Zahlung sind überall vergleichbar.** Der einzige Unterschied ist, ob die Stripe-Zahlungsgebühren bereits in der anny-Gebühr enthalten sind oder ob Stripe sie dir separat berechnet.

## Gebührenmodelle nach Region

### All-inclusive-Gebühr (Europa, EWR, UK, Schweiz, Norwegen, USA)

Du zahlst **eine einzige Gebühr** pro Transaktion. Die Kosten für die Zahlungsabwicklung über Stripe sind darin bereits enthalten: du siehst keine separate Stripe-Rechnung.

**Online-Zahlungen:** 5 % + Festbetrag je Währung | **POS (Kartenlesegerät):** 1,35 %

| Währung | Festbetrag (Online) |
| - | - |
| EUR | 0,40 € |
| CHF | 0,40 CHF |
| USD | 0,40 \$ |
| GBP | 0,35 £ |
| AUD | 0,60 A\$ |
| NZD | 0,70 NZ\$ |
| HKD | 3,00 HK\$ |
| DKK | 3,00 kr |
| NOK | 4,50 kr |
| SEK | 4,50 kr |
| PLN | 1,75 zł |
| CZK | 10,00 Kč |
| HUF | 160 Ft |

**Beispiel:** Dein Kunde zahlt 100 € online → anny-Gebühr = 5 % × 100 € + 0,40 € = **5,40 €**. Du erhältst **94,60 €**. Fertig, keine weiteren Abzüge.

**Unterstützte Länder:**

| | | |
| - | - | - |
| Belgien | Lettland | Schweden |
| Bulgarien | Liechtenstein | Schweiz |
| Dänemark | Litauen | Slowakei |
| Deutschland | Luxemburg | Slowenien |
| Estland | Malta | Spanien |
| Finnland | Niederlande | Tschechien |
| Frankreich | Norwegen | Ungarn |
| Griechenland | Österreich | Vereinigtes Königreich |
| Irland | Polen | Vereinigte Staaten |
| Italien | Portugal | Zypern |
| Kroatien | Rumänien | |

### Getrennte Gebühren (Australien, Brasilien, Kanada und weitere)

In einigen Ländern außerhalb Europas berechnet Stripe die Zahlungsgebühren direkt über dein Stripe-Dashboard. Deshalb ist deine anny-Plattformgebühr hier **niedriger**: die Stripe-Gebühren kommen allerdings separat hinzu.

**Online-Zahlungen:** 2 % + Festbetrag je Währung | **POS (Kartenlesegerät):** 0,5 %

| Land | Währung | Festbetrag (Online) |
| - | - | - |
| Australien | AUD | 0,30 A\$ |
| Brasilien | BRL | 1,00 R\$ |
| Gibraltar | GIP | 0,20 £ |
| Hongkong | HKD | 1,50 HK\$ |
| Japan | JPY | 30 ¥ |
| Kanada | CAD | 0,30 C\$ |
| Malaysia | MYR | 1,00 RM |
| Mexiko | MXN | 4,00 MX\$ |
| Neuseeland | NZD | 0,35 NZ\$ |
| Singapur | SGD | 0,30 S\$ |
| Thailand | THB | 7,00 ฿ |
| VAE | AED | 0,75 د.إ |

**Beispiel:** Dein Kunde zahlt 100 A\$ online in Australien:

* anny-Gebühr: 2 % × 100 A$ + 0,30 A$ = **2,30 A\$**
* Stripe-Gebühr (separat): ca. 2,9 % + 0,30 A$ = ca. **3,20 A$\*\*
* **Gesamtkosten: ca. 5,50 A\$**, vergleichbar mit der All-inclusive-Gebühr in Europa.

## Kartenzahlung vor Ort (POS / Terminal)

Zahlungen per Kartenlesegerät sind **nicht in allen Ländern verfügbar**. Falls dein Land nicht unterstützt wird, ist die Terminal-Funktion auf deinem Konto automatisch deaktiviert.

### Länder mit Terminal-Unterstützung

| | | |
| - | - | - |
| Australien | Italien | Portugal |
| Belgien | Kanada | Schweden |
| Dänemark | Luxemburg | Schweiz |
| Deutschland | Malaysia | Singapur |
| Finnland | Neuseeland | Spanien |
| Frankreich | Niederlande | Tschechien |
| Irland | Norwegen | Vereinigtes Königreich |
| Österreich | | Vereinigte Staaten |

In allen anderen Ländern (z. B. Brasilien, Hongkong, Japan, Mexiko, Thailand, VAE, Gibraltar) sind Kartenlesegeräte derzeit nicht verfügbar.

## Unterstützte Zahlungsmethoden

| Zahlungsmethode | Online-Buchungen | Abos | Widget |
| - | - | - | - |
| Kreditkarte (VISA, Mastercard, Amex) | ✅ | ✅ | ✅ |
| Apple Pay | ✅ | ✅ | ✅ |
| Google Pay | ✅ | ✅ | ✅ |
| PayPal | ✅ | ❌ | ✅ |
| iDEAL | ✅ | ❌ | ✅ |
| TWINT | ✅ | ❌ | ✅ |
| EPS | ✅ | ❌ | ✅ |
| Bancontact | ✅ | ❌ | ✅ |
| BLIK | ✅ | ❌ | ✅ |
| Przelewy24 | ✅ | ❌ | ✅ |
| SEPA-Lastschrift | ❌ | ✅ | ❌ |

## Individuelle Tarife

Standardmäßig gelten die oben genannten Gebühren. Falls du eine individuelle Tarifvereinbarung mit anny hast, wird diese automatisch bevorzugt. In dem Fall siehst du deine individuellen Konditionen in deiner Gebührenübersicht.

## Schnellübersicht

| | Europa, UK, USA, … | Australien, Kanada, … |
| - | - | - |
| **anny-Gebühr (Online)** | 5 % + Festbetrag | 2 % + Festbetrag |
| **anny-Gebühr (POS)** | 1,35 % | 0,5 % |
| **Stripe-Gebühren** | In anny-Gebühr enthalten | Separat auf deinem Stripe-Konto |
| **Gesamtkosten** | \~5 % + Festbetrag | \~5 % + Festbetrag |
| **Erstattungen** | Werden über anny abgewickelt | Werden über dein Stripe-Konto abgewickelt |

<Tip>
  **Offene Plattformgebühren** siehst du unter **Account-Einstellungen** → **Online-Zahlungen**. Die Rechnungen von anny an dich liegen unter **Avatar** → **Abo & Abrechnung**, zusammen mit den Abo-Rechnungen deines Plans.
</Tip>

## Auswertung für die Buchhaltung

Offene anny-Plattformgebühren siehst du unter **Avatar** → **Account-Einstellungen** → **Online-Zahlungen** in der Auszahlungsübersicht als **Offene Plattformgebühren**. Sie werden bei der nächsten Auszahlung einbehalten.

Die Rechnungen von anny an dich (Abo-Rechnungen für deinen Plan und zugehörige Belege) findest du unter **Avatar** → **Abo & Abrechnung**. Dieselbe Liste enthält die Abrechnungen deines anny Plans.

Alle weiteren Informationen rund um die Auswertung der Online-Zahlung findest du im Artikel zur [Buchhaltung mit anny](/accounting).


# OpenID Connect (OIDC) SSO
Source: https://docs.anny.co/openid-connect-sso

anny unterstützt Unternehmenslogins über OpenID Connect. Die Einrichtung übernimmt derzeit unser Support.

anny unterstützt Unternehmenslogins über OpenID Connect (OIDC). Damit funktioniert grundsätzlich jeder Identity Provider, der OpenID Connect Discovery anbietet, zum Beispiel Entra ID, Okta, Keycloak, Auth0 oder Authentik.

Du hinterlegst nur die Adresse deines Identity Providers und die Zugangsdaten der Anwendung. Alle weiteren Endpunkte liest anny automatisch aus, auch wenn dein Identity Provider sie später ändert.

<Note>
  Die Einrichtung ist derzeit noch nicht selbst im Admin Bereich möglich. Schreib uns an [support@anny.co](mailto:support@anny.co), dann legen wir die Verbindung für dich an.
</Note>

<Info>
  Unterstützt dein Identity Provider SAML 2.0, empfehlen wir diesen Weg, da mehr Funktionen wie SCIM und föderierte Anmeldungen zur Verfügung stehen. Eine Anleitung findest du unter [Generisches SAML 2.0 SSO](/generic-saml-sso).
</Info>

## Was wir von dir brauchen

Lege in deinem Identity Provider eine neue Anwendung an, je nach Anbieter auch "Client" oder "App" genannt. Sie muss vertraulich sein, also mit einem Client Secret arbeiten. Schick uns anschließend diese drei Angaben:

| Angabe | Beschreibung |
| - | - |
| **Issuer URL** | Die Basisadresse deines Identity Providers, zum Beispiel `https://login.example.com/anny`. |
| **Client ID** | Die Kennung der Anwendung. |
| **Client Secret** | Das zugehörige Geheimnis. anny speichert es verschlüsselt. |

## Was du von uns bekommst

Sobald die Verbindung angelegt ist, melden wir uns mit:

* der **Callback-URL**, die du in deinem Identity Provider als erlaubte Redirect-URL hinterlegst;
* einer **Post-Logout-URL**, falls sich deine Nutzer:innen beim Abmelden auch bei deinem Identity Provider abmelden sollen.

<Warning>
  Solange die Callback-URL bei deinem Identity Provider nicht hinterlegt ist, bricht der Login mit einer Fehlermeldung wie "redirect\_uri mismatch" ab.
</Warning>

## Anforderungen an deinen Identity Provider

anny fragt die Scopes `openid profile email` an und erwartet diese Claims:

| Claim | Zweck |
| - | - |
| `sub` | Dauerhafte Kennung der Person. Der Wert muss stabil bleiben, auch wenn sich Name oder E-Mail-Adresse ändern. |
| `email` | Wird für die Zuordnung zum anny Konto verwendet. |
| `given_name` und `family_name` | Vor- und Nachname. Liefert dein Identity Provider nur `name`, genügt das ebenfalls. |
| `email_verified` | Optional. Meldet dein Identity Provider hier `false`, lehnt anny den Login ab. |

## Verwandte Artikel

<Columns>
  <Card title="SSO Übersicht" href="/sso-overview">
    Welche Anmeldeverfahren anny unterstützt und wann sich welches eignet.
  </Card>

  <Card title="Attribute Mapping" href="/attribute-mapping">
    Nutzer:innen anhand der Angaben deines Identity Providers automatisch Communities zuordnen.
  </Card>
</Columns>


# Teilnehmermanagement
Source: https://docs.anny.co/participant-management

Füge zusätzliche Personen zu einer Buchung hinzu und steuere Sichtbarkeit, Rechte und Kalender-Sync.

Mit dem Teilnehmermanagement kannst du neben dem eigentlichen Kunden weitere Personen zu einer Buchung hinzufügen. Teilnehmer sehen den Termin in ihrem eigenen anny, können je nach Berechtigung Details einsehen und ihre Teilnahme verwalten. Die Funktion ist besonders hilfreich bei Meetingraum-Buchungen, bei denen Kolleg:innen zum Termin eingeladen werden sollen.

## Wie funktioniert Teilnehmermanagement?

Pro Buchung gibt es immer genau **einen Kunden** (die buchende Person). Teilnehmer sind **zusätzliche Personen**, die zu dieser Buchung eingeladen werden. Sie können:

* Den Termin in ihrer anny Buchungsübersicht sehen (unter "Buchungen, an denen du teilnimmst")
* Je nach Recht ihre Teilnahme bearbeiten oder die Buchung stornieren
* Über die Kalender-Integration im externen Kalender (Outlook/Google) als Teilnehmer erscheinen
* Per .ics-Datei eine Einladung erhalten und per RSVP antworten

### Rollen und Status

| Rolle/Status | Beschreibung |
| - | - |
| Organisator | Zentrale Person der Buchung (einzigartig, wird als Kunde angelegt) |
| Teilnehmer | Zusätzliche eingeladene Personen |
| Intern | Personen deines Unternehmens |
| Extern | Personen außerhalb deines Unternehmens |
| Anwesenheitsstatus | Angenommen, Ausstehend, Mit Vorbehalt, Abgesagt |
| Darf bearbeiten | Teilnehmer darf die Buchung stornieren (wenn aktiviert) |
| Wird virtuell teilnehmen | Markierung für Online-Teilnahme |

### Kalender-Synchronisation

Teilnehmer erscheinen im externen Kalender (Outlook/Google), wenn die Kalender-Integration aktiv ist und **"Termine als Blocker anlegen"** deaktiviert ist. Blocker haben grundsätzlich keine Teilnehmer.

Zusätzlich wird eine .ics-Datei in die Bestätigungsmail integriert. Teilnehmer können den Termin ihrem persönlichen Kalender hinzufügen und per RSVP antworten. Die Antwort wird in anny aktualisiert.

## Wann nutze ich das?

* **Du buchst Meetingräume und willst Kolleg:innen einladen**: Aktiviere Teilnehmer auf der Buchungsoption und erlaube die Personensuche über die Community.
* **Du willst steuern, wer eine Buchung sehen und verwalten darf**: Setze Bearbeitungsrechte und Sichtbarkeit pro Teilnehmer.
* **Du brauchst Teilnehmer im externen Kalender**: Deaktiviere "Termine als Blocker" in der Kalender-Integration.
* **Du möchtest Mindest-/Höchstanzahl für Teilnehmer festlegen**: Konfiguriere Min/Max im Formular-Tab.
* **Nicht geeignet für**: Steuerung der Kapazität einer Ressource (dafür nutze die Verfügbare Anzahl) oder Begrenzung der Buchungsmenge im Warenkorb (dafür nutze [Min- & Max-Auswahl](/min-max-selection)).

## Zusammenhang mit anderen Features

* [**Kalenderintegrationen**](/calendar-integrations): Teilnehmer werden in externe Kalender synchronisiert, wenn "Termine als Blocker" deaktiviert ist.
* [**Outlook Add-In**](/outlook-add-in): Über das Outlook Add-In können Teilnehmer hinzugefügt und verwaltet werden (bei aktiver 2-Wege-Integration synchronisiert sich das mit anny).
* [**Communities**](/communities): Die Personensuche für Teilnehmer nutzt alle mit dem Service verbundenen Communities.
* [**Buchungsserien**](/booking-series): Teilnehmeränderungen bei Serien-Masterterminen werden automatisch auf alle Serientermine übertragen.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Weitere Teilnehmer erlauben | Aktiviert die Teilnehmer-Funktion auf der Buchungsoption |
| Minimale Teilnehmerzahl | Mindestanzahl an Teilnehmern pro Buchung |
| Maximale Teilnehmerzahl | Höchstanzahl an Teilnehmern pro Buchung |
| Personensuche erlauben | Mitglieder verbundener Communities durchsuchbar |
| Profilinfos anzeigen | Vollständiger Name, Profilbild, Abteilung sichtbar |
| Teilnehmer anzeigen | Teilnehmer in Community/Display bei bestehenden Buchungen sichtbar |
| Darf bearbeiten | Teilnehmer darf die Buchung stornieren |
| Art der Beteiligung | Organisator oder Teilnehmer |
| Anwesenheitsstatus | Angenommen / Ausstehend / Mit Vorbehalt / Abgesagt |

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Meetingraum-Buchung mit internen Teilnehmern">
    Ein Unternehmen möchte, dass Mitarbeitende bei der Buchung eines Meetingraums direkt Kolleg:innen als Teilnehmer hinzufügen können.

    <Steps>
      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen**, wähle den Meetingraum und öffne die **Buchungsoption**. Wechsle zum Tab **Formular**.
      </Step>

      <Step title="Teilnehmer aktivieren">
        Scrolle zum Abschnitt **Teilnehmer** und aktiviere **Weitere Teilnehmer erlauben**. Setze die **maximale Teilnehmerzahl** (z. B. 10).
      </Step>

      <Step title="Personensuche aktivieren">
        Aktiviere **Personensuche erlauben** und optional die Anzeige von vollständigem Namen, Profilbild und Abteilung.
      </Step>

      <Step title="Testen">
        Erstelle eine Testbuchung auf der Buchungsseite. Im Checkout sollte ein Bereich zum Hinzufügen von Teilnehmern aus der verbundenen Community erscheinen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Admin fügt nachträglich externe Teilnehmer hinzu">
    Ein Admin möchte zu einer bestehenden Buchung einen externen Gast hinzufügen, der per E-Mail eingeladen wird.

    <Steps>
      <Step title="Buchung öffnen">
        Öffne **Buchungen** und wähle die gewünschte Buchung aus.
      </Step>

      <Step title="Teilnehmer hinzufügen">
        In der Detailansicht unter der Komponente **Teilnehmer** klicke auf **+ Teilnehmer hinzufügen**. Gib die E-Mail-Adresse des externen Gastes ein.
      </Step>

      <Step title="Einstellungen festlegen">
        Setze die Art der Beteiligung auf **Teilnehmer**, den Anwesenheitsstatus auf **Ausstehend** und aktiviere bei Bedarf **Darf bearbeiten**.
      </Step>

      <Step title="Ergebnis prüfen">
        Der externe Gast erhält eine .ics-Einladung per E-Mail und kann per RSVP antworten. Die Antwort wird in anny automatisch aktualisiert.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Teilnehmern und der verfügbaren Anzahl der Ressource?">
    Die verfügbare Anzahl steuert, wie viele **parallele Buchungen** auf einer Ressource gleichzeitig möglich sind. Teilnehmer sind **Personen innerhalb einer einzelnen Buchung**. Beides ist unabhängig voneinander.
  </Accordion>

  <Accordion title="Können Teilnehmer auch von Kund:innen hinzugefügt werden?">
    Ja, im Checkout. Wenn "Weitere Teilnehmer erlauben" aktiviert ist, können Kund:innen bei der Buchung Personen hinzufügen. Nachträgliches Hinzufügen ist aktuell nur über den Admin-Bereich möglich.
  </Accordion>

  <Accordion title="Erscheinen Teilnehmer im externen Kalender?">
    Nur wenn die Kalender-Integration aktiv ist und "Termine als Blocker anlegen" deaktiviert ist. Blocker haben grundsätzlich keine Teilnehmer.
  </Accordion>

  <Accordion title="Was passiert mit Teilnehmern bei Buchungsserien?">
    Änderungen an Teilnehmern auf dem Mastertermin werden automatisch auf alle Serientermine übertragen.
  </Accordion>

  <Accordion title="Kann es mehr als einen Organisator pro Buchung geben?">
    Nein. Pro Buchung gibt es genau einen Organisator und einen Kunden (oft dieselbe Person). Alle weiteren Personen sind Teilnehmer.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Teilnehmer erscheinen nicht im externen Kalender">
    Prüfe, ob in der Kalender-Integration der Ressource "Termine als Blocker anlegen" deaktiviert ist. Blocker haben keine Teilnehmer. Außerdem muss ein Standardservice hinterlegt sein.
  </Accordion>

  <Accordion title="Kund:innen können keine Teilnehmer hinzufügen">
    Prüfe, ob "Weitere Teilnehmer erlauben" in der Buchungsoption unter Formular → Teilnehmer aktiviert ist.
  </Accordion>

  <Accordion title="Die Personensuche zeigt keine Ergebnisse">
    Prüfe, ob "Personensuche erlauben" aktiviert ist und ob die gewünschten Personen Mitglieder einer Community sind, die mit diesem Service verbunden ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Buchungsoption** → Tab **Formular** → Abschnitt **Teilnehmer**
> * Teilnehmer ≠ Kunden: Pro Buchung genau ein Kunde, Teilnehmer sind zusätzliche Personen
> * Teilnehmer ≠ Verfügbare Anzahl der Ressource: Verfügbare Anzahl = parallele Buchungen auf einer Ressource. Teilnehmeranzahl = Personen PRO Buchung.
> * Teilnehmer ≠ Min-Max Auswahl: Min-Max begrenzt Buchungsmenge im Warenkorb. Teilnehmer sind eingeladene Personen zu einer Buchung.
> * Teilnehmer können aktuell nur über den Admin-Bereich nachträglich hinzugefügt/bearbeitet/gelöscht werden
> * Bei Serien-Masterterminen: Teilnehmeränderungen auf alle Serientermine übertragen
> * Kalender-Sync: Teilnehmer in externem Kalender nur sichtbar wenn "Termine als Blocker anlegen" deaktiviert + Standardservice hinterlegt
> * .ics-Datei: wird in Bestätigungsmail integriert, RSVP-Antworten in anny aktualisiert, auch ohne Kalender-Integration verfügbar
> * Outlook Add-In: Teilnehmer können darüber hinzugefügt werden (synchronisiert bei aktiver 2-Wege-Integration)
> * Verwandte Artikel: /calendar-integrations, /buchungsoption-konfigurieren, /communities, /outlook-add-in, /booking-series, /min-max-selection


# Zahlen auf Rechnung (Pay-Later)
Source: https://docs.anny.co/pay-later

Ermögliche Kund:innen, nach der Buchung flexibel per Rechnung zu zahlen, statt im Checkout sofort zu bezahlen.

Mit der Zahlungsmethode "Zahlen auf Rechnung" (Pay-Later) buchen deine Kund:innen ohne sofortige Zahlungspflicht. Sie erhalten nach der Buchung eine Rechnung und können flexibel per Überweisung oder online bezahlen. Das reduziert Hürden im Checkout und eignet sich besonders für B2B-Kund:innen oder Szenarien, in denen die Zahlung erst später erfolgen soll.

<Info>
  Pay-Later setzt voraus, dass unter **Avatar** → **Account-Einstellungen** → **Rechnungsstellung** mindestens eine der folgenden Optionen aktiv ist: **Online-Zahlung erlauben** oder **Zahlung per Überweisung erlauben**.
</Info>

## Wie funktioniert Zahlen auf Rechnung?

Wenn du für eine Buchungsoption "Zahlen auf Rechnung" aktivierst, verändert sich der Checkout-Flow:

1. Kund:innen schließen die Buchung ab, ohne Zahlungsdaten einzugeben.
2. anny erstellt automatisch eine Bestellung mit Rechnungsentwurf.
3. Die Rechnung wird zum Buchungstag festgeschrieben und per E-Mail an den Kunden versendet (bei aktiver automatischer Rechnungsgenerierung).
4. Kund:innen zahlen anschließend flexibel: per Überweisung, online über den Rechnungslink oder vor Ort.

Bis zum Versand bleibt die Rechnung als Entwurf bearbeitbar. Du kannst Positionen anpassen, ergänzen oder Rabatte eintragen, bevor du sie fertigstellst.

<Tip>
  Sind Zahlungserinnerungen in den globalen Rechnungseinstellungen aktiviert, versendet anny automatisch bis zu drei Mahnungen (am Fälligkeitsdatum, 7 und 14 Tage danach).
</Tip>

## Wann nutze ich das?

* **Deine Kund:innen sind Unternehmen oder Behörden mit interner Rechnungsfreigabe**: Pay-Later ermöglicht die Buchung ohne Kreditkarte und liefert eine ordentliche Rechnung zur internen Weiterverarbeitung.
* **Du möchtest die Conversion im Checkout erhöhen**: Kund:innen müssen keine Zahlungsdaten eingeben, was Abbruchraten senkt.
* **Du bietest Services an, bei denen die Zahlung erst nach Leistungserbringung üblich ist**: Zum Beispiel Beratung, Raumvermietung oder Events.
* **Du willst Kund:innen die Wahl lassen**: In Kombination mit "Vorab online zahlen" sehen Kund:innen im Checkout beide Optionen und entscheiden selbst.
* **Nicht geeignet für**: Szenarien, in denen Vorauszahlung zwingend ist (z. B. hohe No-Show-Rate oder Tickets ohne Stornierungsmöglichkeit). Hier ist "Vorab online zahlen" die bessere Wahl.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Kundensalden & Sammelrechnungen | Pay-Later-Rechnungsentwürfe können auf einem Kundensaldo gesammelt und später konsolidiert abgerechnet werden (ab Business Plan) |
| Stornierungsbedingungen | Bei Stornierung einer Pay-Later-Buchung wird automatisch eine Stornorechnung erstellt |
| Abos & Mitgliedschaften | Abo-Rechnungen können ebenfalls im Pay-Later-Modus laufen, empfohlen ist aber Vorab-Online-Zahlung mit hinterlegter Zahlungsmethode |

## Einstellungen & Optionen

Pfad: **Ressource** → Buchungsoption **bearbeiten** → **Zahlungen**

| Einstellung | Beschreibung |
| - | - |
| Zahlen auf Rechnung | Zahlungsmethode aktivieren |
| Rechnung automatisch generieren | Rechnungsnummer wird vergeben, Rechnung zum Buchungstag versendet |
| Zahlungsstatus verfolgen | Bestellungen bleiben auf "offen" bis manuell als bezahlt markiert |

<Warning>
  Wenn "Zahlungsstatus verfolgen" deaktiviert ist, werden alle Bestellungen automatisch auf "bezahlt" gesetzt. Das kann bei Pay-Later zu Inkonsistenzen führen, da die Zahlung noch aussteht. Aktiviere diese Einstellung bei Pay-Later immer.
</Warning>

### Verhalten im Checkout

Kund:innen sehen im Checkout die verfügbaren Zahlungsmethoden auf einen Blick. Sind mehrere Optionen aktiv (z. B. "Vorab online zahlen" und "Zahlen auf Rechnung"), können Kund:innen frei wählen.

### Verhalten in der Bestellübersicht

In der Admin-Bestellübersicht erscheint bei Pay-Later-Bestellungen in der Spalte "Zahlung" der Wert **Online und Offline**. Das ist korrekt, weil zum Buchungszeitpunkt noch nicht feststeht, ob der Kunde später online (per Rechnungslink) oder offline (Überweisung, bar) zahlt.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Coworking Space mit monatlicher Raumvermietung an Firmenkund:innen">
    Ein Coworking Space vermietet Meetingräume an Unternehmen, die intern per Sammelrechnung abrechnen möchten.

    <Steps>
      <Step title="Zahlungsmethode konfigurieren">
        Öffne die Buchungsoption des Meetingraums unter **Ressource** → **Buchungsoption bearbeiten** → **Zahlungen**. Wähle **Zahlen auf Rechnung** und aktiviere **Rechnung automatisch generieren** sowie **Zahlungsstatus verfolgen**.
      </Step>

      <Step title="Zahlungserinnerungen aktivieren">
        Gehe zu **Avatar** → **Account-Einstellungen** → **Rechnungsstellung** und aktiviere **Zahlungserinnerung senden**. Setze die Fälligkeit auf 14 Tage.
      </Step>

      <Step title="Ergebnis prüfen">
        Firmenkund:innen buchen ohne Zahlungsdaten. Die Rechnung wird am Buchungstag versendet und der Zahlungsstatus bleibt auf "offen", bis du den Geldeingang bestätigst.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Beratungsunternehmen mit Zahlung nach Termin">
    Ein Berater möchte, dass Kund:innen erst nach dem Termin zahlen, aber trotzdem eine automatische Rechnung erhalten.

    <Steps>
      <Step title="Pay-Later einrichten">
        Öffne die Buchungsoption "Beratungstermin" unter **Ressource** → **Buchungsoption bearbeiten** → **Zahlungen**. Wähle **Zahlen auf Rechnung**.
      </Step>

      <Step title="Rechnungszeitpunkt konfigurieren">
        Aktiviere **Rechnung automatisch generieren**. Die Rechnung wird zum Buchungszeitpunkt erstellt. Alternativ: Deaktiviere die automatische Generierung und stelle Rechnungen manuell erst nach dem Termin fertig.
      </Step>

      <Step title="Zahlungseingang verfolgen">
        In der Bestellübersicht unter **Bestellungen** siehst du offene Zahlungen. Markiere sie nach Geldeingang manuell als "bezahlt".
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Können Kund:innen bei Pay-Later trotzdem online zahlen?">
    Ja. Kund:innen erhalten mit der Rechnung einen Online-Zahlungslink, über den sie per Kreditkarte, PayPal oder anderen Methoden bezahlen können. Voraussetzung ist, dass Online-Zahlung in den globalen Einstellungen erlaubt ist.
  </Accordion>

  <Accordion title="Wann genau wird die Rechnung versendet?">
    Bei aktiver automatischer Rechnungsgenerierung wird die Rechnung am Tag der Buchung festgeschrieben und per E-Mail versendet. Bis dahin bleibt sie als Entwurf bearbeitbar.
  </Accordion>

  <Accordion title="Was passiert, wenn ein Kunde nicht zahlt?">
    Wenn Zahlungserinnerungen aktiviert sind, versendet anny automatisch bis zu drei Mahnungen. Den Zahlungsstatus musst du anschließend manuell auf "bezahlt" oder "storniert" setzen.
  </Accordion>

  <Accordion title="Kann ich Pay-Later und Vorab-Online-Zahlung gleichzeitig anbieten?">
    Nicht für dieselbe Buchungsoption. Pro Buchungsoption wählst du eine Zahlungsmethode. Du kannst aber verschiedene Buchungsoptionen auf derselben Ressource mit unterschiedlichen Zahlungsmethoden anlegen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Pay-Later wird in den Buchungsoptionen nicht angezeigt">
    In den globalen Einstellungen unter Avatar → Account-Einstellungen → Rechnungsstellung muss entweder "Online-Zahlung erlauben" oder "Zahlung per Überweisung erlauben" aktiv sein. Ohne eine dieser Optionen ist Pay-Later nicht verfügbar.
  </Accordion>

  <Accordion title="Kunde erhält keine Rechnung">
    Prüfe, ob "Rechnung automatisch generieren" in der Buchungsoption aktiv ist. Ist die Einstellung deaktiviert, bleibt die Rechnung als Entwurf gespeichert und muss manuell fertiggestellt werden.
  </Accordion>

  <Accordion title="Alle Bestellungen stehen sofort auf bezahlt">
    Die Einstellung "Zahlungsstatus verfolgen" ist deaktiviert. Aktiviere sie in der Buchungsoption unter Zahlungen, damit Bestellungen im Status "offen" bleiben.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Pay-Later = Zahlungsmethode "Zahlen auf Rechnung" auf Buchungsoptions-Ebene.
> * Voraussetzung: In Account-Einstellungen → Rechnungsstellung muss entweder "Online-Zahlung erlauben" ODER "Zahlung per Überweisung erlauben" aktiv sein.
> * UI-Pfad Aktivierung: Ressource → Buchungsoption bearbeiten → Zahlungen → "Zahlen auf Rechnung"
> * In der Bestellübersicht erscheint bei Pay-Later als Zahlungsart "Online und Offline", weil zum Buchungszeitpunkt noch nicht feststeht, wie der Kunde später zahlt.
> * Rechnung wird automatisch am Tag der Buchung generiert und versendet (bei aktiver automatischer Rechnungsgenerierung). Bis dahin bleibt sie als Entwurf bearbeitbar.
> * Zahlungsstatus muss bei Überweisung manuell auf "bezahlt" gesetzt werden. Nur bei Online-Zahlung (Stripe) wird er automatisch aktualisiert.
> * Verwechslungsgefahr: Pay-Later ≠ Kundensalden. Pay-Later ist eine Zahlungsmethode pro Buchungsoption; Kundensalden sind ein Abrechnungsmodell, das Rechnungsentwürfe sammelt (ab Business Plan).
> * Verwandte Artikel: Rechnungsstellung (Übersicht), Rechnungsentwurf, Kundensalden & Sammelrechnungen, Stripe Connect einrichten.


# Personalisierung
Source: https://docs.anny.co/personalization

Erfasse pro Buchung individuelle Kundendaten, damit jede Person ihr eigenes Ticket und einen eigenen Kundendatensatz erhält.

Mit der Personalisierung erfasst du pro Buchung innerhalb einer Bestellung individuelle Kundendaten. So erhält jede gebuchte Person ein eigenes Ticket, eine eigene E-Mail-Bestätigung und einen eigenständigen Datensatz in deinem CRM.

<Info>
  Verfügbar ab **Essential**.
</Info>

## Wie funktioniert die Personalisierung?

Standardmäßig wird bei einer Bestellung mit mehreren Buchungen nur ein Kundendatensatz erfasst. Mit aktivierter Personalisierung werden Kund:innen im Checkout aufgefordert, jede Buchung einer konkreten Person zuzuordnen.

Das Grundprinzip:

1. Kund:innen legen mehrere Buchungen in den Warenkorb.
2. Im Checkout ordnen sie jede Buchung einer Person zu (Name, E-Mail, optional Adresse).
3. Jede zugeordnete Person erhält eine eigene E-Mail mit ihrer persönlichen Buchungsbestätigung.
4. Die Person, die für alle gebucht hat, erhält die Gesamtbestätigung der Bestellung.

Die erfassten Personendaten werden als eigenständige Kundendatensätze im CRM angelegt. Wird für dieselbe Person später erneut gebucht oder bucht sie selbst, werden alle Buchungen korrekt zugeordnet.

<Tip>
  anny erkennt Kund:innen anhand ihrer E-Mail-Adresse. Wird für mehrere Buchungen dieselbe E-Mail verwendet, behandelt anny sie als eine Person und aktualisiert den Namen mit der zuletzt eingegebenen Personalisierung.
</Tip>

## Wann nutze ich das?

* **Du bietest Events oder Kurse an**: Eltern buchen für ihre Kinder, Teamleiter:innen für Kolleg:innen. Jede Person erhält ein eigenes Ticket.
* **Du brauchst individuelle Daten pro Buchung**: Für Check-in, Zertifikate oder personalisierte QR-Codes ist ein Datensatz pro Person notwendig.
* **Du möchtest abweichende Adressen erfassen**: Bei Firmenbuchungen kann eine individuelle Adresse pro Person vorausgesetzt werden.
* **Nicht geeignet für**: Buchungen, bei denen immer nur eine Person für sich selbst bucht und keine Mehrfachbuchungen im Warenkorb entstehen.

## Zusammenhang mit anderen Features

* **Check-In & Check-Out**: Personalisierte Buchungen erzeugen pro Person ein eigenes QR-Code-Ticket für den Check-in.
* **Zertifikate**: Mit Personalisierung wird das Zertifikat auf den Namen der tatsächlichen Teilnehmer:in ausgestellt, nicht auf die buchende Person.
* **Teilnehmermanagement**: Ergänzt die Personalisierung um erweiterte Rechte und Sichtbarkeit für zusätzliche Personen.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Personalisierung von Buchungen | Kundendaten pro Buchung erfassen |
| Nachträgliche Personalisierung | Kund:innen können Daten nach der Buchung ergänzen |
| Personalisierung voraussetzen | Buchung nur mit vollständiger Personalisierung möglich |
| Personalisierung der ersten Buchung voraussetzen | Auch die erste Buchung muss personalisiert werden |
| Individuelle Adresse voraussetzen | Pro Person eine eigene Adresse erforderlich |

Die Einstellungen findest du unter **Ressourcen** → Buchungsoption → Tab **Formulare** → **Personalisierung**.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Veranstalter bucht Konzerttickets für eine Gruppe">
    Ein Konzertveranstalter möchte sicherstellen, dass jede Person im Warenkorb ein eigenes, persönliches Ticket mit QR-Code erhält.

    <Steps>
      <Step title="Personalisierung aktivieren">
        Öffne **Ressourcen** → Buchungsoption → Tab **Formulare** → **Personalisierung**. Aktiviere **Personalisierung von Buchungen**.
      </Step>

      <Step title="Personalisierung voraussetzen">
        Aktiviere zusätzlich **Personalisierung voraussetzen**, damit die Bestellung nur abgeschlossen werden kann, wenn alle Buchungen einer Person zugeordnet sind.
      </Step>

      <Step title="Speichern">
        Klicke auf **Speichern**. Kund:innen werden im Checkout nun aufgefordert, für jedes Ticket Name und E-Mail anzugeben. Jede Person erhält anschließend eine eigene E-Mail mit ihrem persönlichen Ticket.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Eltern buchen Sporttraining für ihre Kinder">
    Ein Sportverein bietet Trainings an. Eltern buchen für ihre Kinder, sollen die Kinderdaten aber erst nach der Buchung in Ruhe ergänzen können.

    <Steps>
      <Step title="Personalisierung aktivieren">
        Öffne **Ressourcen** → Buchungsoption → Tab **Formulare** → **Personalisierung**. Aktiviere **Personalisierung von Buchungen**.
      </Step>

      <Step title="Nachträgliche Personalisierung erlauben">
        Aktiviere **Nachträgliche Personalisierung von Buchungen**. So können Eltern die Buchung zunächst abschließen und die Daten der Kinder später ergänzen.
      </Step>

      <Step title="Speichern">
        Klicke auf **Speichern**. Eltern buchen das Training und tragen die Kinderdaten nachträglich über ihre Buchungsübersicht ein.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Warum wird bei allen Buchungen nur die zuletzt eingegebene Personalisierung angezeigt?">
    anny erkennt Kund:innen anhand ihrer E-Mail-Adresse. Wird dieselbe E-Mail für mehrere Personalisierungen verwendet, überschreibt anny den gespeicherten Namen mit dem zuletzt eingegebenen. Lösung: Verwende pro Person eine eindeutige E-Mail-Adresse.
  </Accordion>

  <Accordion title="Was passiert, wenn eine Person keine eigene E-Mail-Adresse hat?">
    Du kannst das Muster [vorname.nachname@placeholder.anny.co](mailto:vorname.nachname@placeholder.anny.co) verwenden. Es werden keine E-Mails versendet. Die Buchung ist dann nur über die Website oder App unter **Buchungen** einsehbar.
  </Accordion>

  <Accordion title="Erhält jede personalisierte Person eine eigene E-Mail?">
    Ja. Jede zugeordnete Person erhält eine eigene E-Mail mit ihrer persönlichen Buchungsbestätigung und ggf. QR-Code-Ticket. Die buchende Person erhält zusätzlich die Gesamtbestätigung.
  </Accordion>

  <Accordion title="Werden personalisierte Personen als eigene Kund:innen im CRM angelegt?">
    Ja. Jede personalisierte Person erhält einen eigenständigen Kundendatensatz. Spätere Buchungen derselben E-Mail werden automatisch zugeordnet.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Personalisierung wird im Buchungsflow nicht angezeigt">
    Prüfe, ob die Einstellung **Personalisierung von Buchungen** unter **Formulare** → **Personalisierung** in der betroffenen Buchungsoption aktiviert ist. Die Option greift nur, wenn mehrere Buchungen im Warenkorb liegen (oder wenn "Personalisierung der ersten Buchung voraussetzen" aktiv ist).
  </Accordion>

  <Accordion title="Kund:innen können die Personalisierung überspringen">
    Aktiviere **Personalisierung voraussetzen**. Ohne diese Option ist die Personalisierung optional und kann im Checkout übersprungen werden.
  </Accordion>

  <Accordion title="Personalisierte Personen erhalten keine E-Mail">
    Prüfe, ob eine gültige E-Mail-Adresse eingetragen wurde. Bei Adressen mit @placeholder.anny.co erfolgt kein E-Mail-Versand (nur Einsicht über Website/App).
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Ressourcen** → Buchungsoption → Tab **Formulare** → **Personalisierung**
> * Kundendaten werden pro personalisierter Buchung als eigenständiger Kundendatensatz im CRM angelegt (nicht nur als Zusatzinfo).
> * Erkennung per E-Mail: Wird dieselbe E-Mail für mehrere Personalisierungen genutzt, überschreibt anny den Namen mit dem zuletzt eingegebenen.
> * Fake-E-Mail-Pattern: [vorname.nachname@placeholder.anny.co](mailto:vorname.nachname@placeholder.anny.co) (kein Mailversand, Buchung nur über Website/App einsehbar).
> * Jede personalisierte Person erhält eine eigene E-Mail mit persönlichem Ticket/Buchungsbestätigung.
> * Verfügbar ab Essential.


# Buchungen und Zahlungen in der POS App verwalten
Source: https://docs.anny.co/pos-app-bookings-and-payments

Organisiere deinen Kalender, wechsle sicher im Team und wickle Zahlungen mit wenigen Klicks ab.

Die anny POS App bringt deine gesamte Buchungsverwaltung direkt an den Empfang. Du navigierst intuitiv durch den Kalender, erstellst neue Buchungen für Walk-ins und rechnest Services direkt über dein Tablet ab. Individuelle PINs ermöglichen es deinem Team, ein Tablet sicher gemeinsam zu nutzen.

## Für wen geeignet

Dieser Workflow richtet sich an alle Mitarbeiter:innen, die den operativen Betrieb vor Ort steuern:

* Front-Desk-Manager:innen, die Buchungen für Laufkundschaft anlegen.
* Support-Teams, die bestehende Termine bearbeiten oder stornieren.
* Admins, die das Kassensystem für das Personal vor Ort einrichten.

## Wo findest du die Funktion

Du nutzt für diese Prozesse die Hauptansichten der anny POS App: den **Kalender** sowie das **Nutzer-Menü** oben rechts.

Voraussetzungen:

* Du hast die App auf deinem Tablet installiert und dich eingeloggt.
* Du hast deine Ressourcen und Buchungsoptionen/ Services in anny vollständig angelegt.

<Warning>
  **Wichtig**: Zahlungen können im Kalender nur reibungslos über die POS App abgewickelt werden, wenn dein Tablet zuvor mit einem Kartenlesegerät oder Tap to Pay gekoppelt wurde.
</Warning>

## So funktioniert die Logik

Das Speichern und Bezahlen von Buchungen in der App folgt einem einfachen Prinzip:

* **Checkout**: Speichert die Buchung und öffnet sofort die Bezahlseite, um den Betrag direkt über das Lesegerät abzurechnen.
* **Speichern (Save)**: Erstellt die Buchung lediglich als Entwurf im Kalender. Die eigentliche Zahlung startest du später manuell aus dem Kalender heraus. So bleibst du flexibel und entscheidest situativ, ob die Zahlung sofort oder am Ende eines Termins erfolgt.

![Zahlungslogik im Kalender](https://downloads.intercomcdn.eu/i/o/niegcmk9/156817667/6e83103797517525de2fd982f221/posapp-paymentcalendar.png)

## Schritt für Schritt Anleitung

### Eine neue Buchung erstellen und sofort abrechnen

Du legst als Admin eine Buchung für eine Walk-in-Kund:in an und kassierst den Betrag sofort ab.

1. Öffne den **Kalender** in der anny POS App.
2. Klicke auf **+ Neu**, um eine neue Buchung zu starten.
3. Wähle die gewünschten Services und das Datum aus.
4. Klicke in der angezeigten Bestellübersicht auf **Kostenpflichtig abschließen**.
5. Prüfe die Zusammenfassung der Buchung und tippe auf **Bezahlen**. *Die Zahlungsmethode öffnet sich und die Kund:in kann ihre Karte an das verbundene Lesegerät halten. Die Buchung ist danach erfolgreich bezahlt und im Kalender sichtbar. Ist Check-In auf der Ressource aktiv, checkt anny die akzeptierte Buchung dabei automatisch zum Startzeitpunkt ein.*

![Buchung erstellen](https://downloads.intercomcdn.eu/i/o/niegcmk9/156817706/708ef4f76400fddd3eb972d16ace/posapp-bookingcreation.png)

![Zahlungszusammenfassung](https://downloads.intercomcdn.eu/i/o/niegcmk9/156817143/b16928fe3e67c4af3515198e774a/posapp-paymentsumcomplete.png)

### Sicherer Nutzerwechsel im Team

Wenn sich mehrere Mitarbeiter:innen ein Tablet am Empfang teilen, könnt ihr nahtlos und sicher wechseln.

1. Klicke oben rechts im Menü auf das **Nutzer-Profil**.
2. Logge dich als neues Teammitglied einmalig mit deinem normalen anny Passwort ein.
3. Setze im nächsten Schritt optional eine individuelle PIN.
4. Klickt zum Wechseln fortan einfach auf das Profil und gebt die jeweilige PIN ein. *Jede Mitarbeiter:in arbeitet sicher in ihrer eigenen Ansicht, ohne bei jedem Wechsel das lange Passwort neu eingeben zu müssen.*

![Nutzerwechsel](https://downloads.intercomcdn.eu/i/o/niegcmk9/156816865/c44855e31f913af7a3fcc56b3bee/posapp-profile.png)

## Trinkgeld

Bei Kartenzahlungen über das Lesegerät oder Tap to Pay kann **Trinkgeld** mit kassiert werden. Das Trinkgeld landet auf der Rechnung als eigene Position **Trinkgeld**, getrennt vom Umsatz.

So wertest du Trinkgeld aus:

* Im Dashboard-Widget **Trinkgeld pro Mitarbeiter** siehst du die Beträge im Zeitverlauf, zugeordnet der Person, die die Zahlung entgegengenommen hat.
* Der tägliche Buchhaltungsexport schlüsselt POS-Trinkgelder pro Person auf. Mehr dazu unter [Buchhaltung mit anny](/accounting).
* In der DATEV-Integration wird Trinkgeld auf das Konto **Trinkgeld** gebucht, nicht auf die Umsatzkonten. Mehr dazu unter [DATEV-Konten](/datev-accounts-and-tax-advisor).

<Warning>
  Trinkgeld in anny hängt an Kartenzahlungen (Terminal / POS). Bargeld-Trinkgeld erfasst die POS App nicht. Auf der Online-Buchungsseite gibt es kein Trinkgeld-Feld.
</Warning>

## Wann sinnvoll

* Die POS App ist dein zentrales Werkzeug, wenn du den Betrieb am Empfang dynamisch verwaltest.
* Wenn du Buchungen für Kund:innen flexibel anlegen, bearbeiten oder stornieren musst.
* Wenn dein Team aus mehreren Personen besteht, die am selben Gerät arbeiten.
* Wenn du situativ entscheiden möchtest, ob Zahlungen sofort oder später fällig sind. So hast du immer den vollen Überblick über alle Termine und Einnahmen des Tages.

<Note>
  Die Übersicht zu den Gebühren findest du hier unter [Online-Zahlung & Gebühren](/online-payments).
</Note>

## FAQ

<AccordionGroup>
  <Accordion title="Ich habe meine persönliche PIN vergessen. Was kann ich tun?">
    Du kannst deine PIN ganz einfach zurücksetzen. Klicke auf deinen Nutzer und gib dein reguläres anny Passwort erneut ein, um dich zu authentifizieren und eine neue PIN zu vergeben.
  </Accordion>

  <Accordion title="Können Berechtigungen über die PIN gesteuert werden?">
    Ja. Die PIN gilt individuell pro Nutzer:in. Ein bestimmter PIN-Code kann beispielsweise nur für Manager:innen eingerichtet werden, um auf spezielle Ansichten zuzugreifen.
  </Accordion>

  <Accordion title="Kann ich bestehende Buchungen im Kalender anpassen?">
    Ja. Klicke im Kalender auf eine Buchung, um diese direkt in der App zu bearbeiten oder bei Bedarf zu stornieren.
  </Accordion>

  <Accordion title="Kann ich Barzahlungen in der App erfassen?">
    Nein. Im ersten Release der App werden reine Kartenzahlungen über das Lesegerät oder Tap to Pay unterstützt.
  </Accordion>

  <Accordion title="Kann ich Trinkgeld über das Lesegerät annehmen?">
    Ja. Bei Kartenzahlungen über das Lesegerät oder Tap to Pay kann Trinkgeld mit kassiert werden. Es erscheint auf der Rechnung als **Trinkgeld** und wird der Mitarbeiter:in zugeordnet, die die Zahlung entgegengenommen hat. Auswertung über das Dashboard-Widget **Trinkgeld pro Mitarbeiter** und den täglichen Buchhaltungsexport.
  </Accordion>

  <Accordion title="Kann ich Gutscheine über das Lesegerät annehmen?">
    Gutscheine löst du im normalen Checkout ein, nicht als eigene Lesegerät-Funktion. Für Wertgutscheine siehe [Wertgutscheine](/value-vouchers).
  </Accordion>

  <Accordion title="Wie erhalten meine Kund:innen ihren Zahlungsbeleg?">
    Der Beleg kann an die E-Mail-Adresse gesendet werden, die bei der Buchung hinterlegt wurde, oder in A4 ausgedruckt werden.
  </Accordion>

  <Accordion title="Kann ich eine Zahlung direkt in der POS App zurückerstatten (Refund)?">
    Ja, dies funktioniert wie die Stornierung und Ablehnen Funktion im Admin-Bereich. Die Rückerstattung erfolgt digital ohne Karte.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich sehe meine neu angelegte Buchung nicht im Kalender">
    Möglicherweise befindest du dich in der falschen Zeitübersicht. Die App bietet verschiedene Kalenderansichten (z.B. Tag, Woche). *Wechsle die Ansicht oben im Menü, um Buchungen an anderen Tagen oder Uhrzeiten sichtbar zu machen.*
  </Accordion>

  <Accordion title="Die Zahlung für eine zuvor gespeicherte Buchung kann nicht gestartet werden">
    Prüfe, ob dein Kartenlesegerät verbunden ist. Gehe in den Kalender, klicke auf die bestehende Buchung und wähle die Option zum Bezahlen. *Wenn das Gerät keine Verbindung hat, starte das Pairing erneut oder zeige den integrierten QR-Code für eine Smartphone-Zahlung an.* Mehr dazu: [POS App - Kartenlesegeräte & Tap to Pay einrichten](/pos-app-setup)
  </Accordion>
</AccordionGroup>


# POS App - Kartenlesegeräte & Tap to Pay einrichten
Source: https://docs.anny.co/pos-app-setup

Verbinde dein Lesegerät mit der anny POS App und nimm Zahlungen direkt vor Ort entgegen.

Mit der anny POS App wickelst du Kartenzahlungen deiner Nutzer:innen direkt am Point of Sale (POS) ab. Du verbindest dazu einfach ein kompatibles Lesegerät über Netzwerk oder Bluetooth. Alternativ nutzt du Tap to Pay auf Android-Tablets, um kontaktlose Zahlungen völlig ohne Zusatzhardware zu akzeptieren.

## Für wen geeignet

Die Einrichtung ist ideal für Admins und Mitarbeiter:innen, die physische Zahlungen vor Ort annehmen.

* Coworking-Spaces mit Laufkundschaft und Tagespässen
* Beratungsstellen, bei denen die Zahlung direkt nach dem Termin erfolgt
* Event-Check-ins mit kurzfristigem Ticketverkauf an der Tageskasse

Kurz gesagt: Perfekt für alle, die ein professionelles und nahtloses Zahlungserlebnis am Empfang bieten möchten.

## Wo findest du die Funktion

Du startest die Einrichtung deines Geräts einmalig in der anny POS App während des Bezahlvorgangs (Checkout).

**Voraussetzungen:**

* Du hast die **anny POS App** aus dem Apple App Store oder Google Play Store heruntergeladen.
* Du hast ein Stripe S700/S710 (Netzwerk), ein BBPOS WisePad 3 (Bluetooth) oder ein unterstütztes Android-Tablet.

<Warning>
  Die anny POS App ist aktuell exklusiv für Tablets (iPad OS und Android) verfügbar. Smartphones werden nicht unterstützt.
</Warning>

## Schritt für Schritt Anleitung

Wenn du die POS App zum ersten Mal auf deinem Tablet verwendest und noch kein Gerät gekoppelt ist, startest du immer mit diesen grundlegenden Vorbereitungen:

<Steps>
  <Step title="App herunterladen und einloggen">
    Lade dir die **anny POS App** im Apple App Store oder Google Play Store herunter und logge dich ein.
  </Step>

  <Step title="Pair reader starten">
    Erstelle eine Buchung bis zum Checkout und klicke dort einmalig auf **Pair reader**.
  </Step>

  <Step title="Methode wählen">
    Es öffnet sich das Pop-up **Pair device**. Wähle hier deine gewünschte Methode: **Bluetooth**, **Network** oder **Tap to Pay**. Klicke anschließend auf **Pair new reader**.
  </Step>
</Steps>

![POS App ohne Reader](https://downloads.intercomcdn.eu/i/o/niegcmk9/156813649/8ed8d57f16ae4a5ed226401b0d0b/posapp-noreader.png?expires=1785161700\&signature=76f94888f8e972678edb0cd3c88e583e2cfab0f3e2656642e4dfc11b566a0ab6\&req=0dBpzVn5qjMhlxv889osp%2BuArM3Idjm9m9UXc%2B3yC1pp9thw7s%2BORWBcO7bF%0AX6QZdabESHyWyjkU4Q%3D%3D%0A)

![POS App Pairing](https://downloads.intercomcdn.eu/i/o/niegcmk9/156813511/5adff53ce97866b1154de84944bc/posapp-pairing.png?expires=1785161700\&signature=92fedc326f2898d22b9df7638ffd69da5e40698418ec003251ba8417793712d9\&req=0dBpzVn5qTYplxv889ospxH13EWXzfzQqo3vZ%2B0QMLWzMa%2B2LB2WXQ0dl3Kl%0AIxhpUZD4%2Bu%2FeR%2B43wg%3D%3D%0A)

Wähle nun die passende Anleitung für dein Setup, um die Kopplung abzuschließen:

### Netzwerk-Lesegerät Stripe S700/S710 einrichten

Schließe dein [Stripe S700](https://docs.stripe.com/terminal/payments/setup-reader/stripe-reader-s700-s710#settings) an den Strom an und schalte es ein. Das Gerät benötigt eine aktive WLAN-Verbindung.

1. Wische auf dem Display des Lesegeräts nach rechts und öffne die **Einstellungen**.
2. Gib die voreingestellte Admin-PIN **07139** ein.
3. Verbinde das Lesegerät mit deinem lokalen WLAN.
4. Tippe auf **Generate Pairing Code**, um einen Kopplungscode zu erzeugen.
5. Gehe in der anny POS App im Checkout auf **Pair reader**.
6. Wähle die Option **Network** und klicke auf **Pair new reader**.
7. Gib den generierten Pairing-Code in die App ein.
8. Dein Lesegerät ist nun erfolgreich gekoppelt und steht dir im Checkout dauerhaft unter "Payment methods" zur Verfügung.

### Bluetooth-Lesegerät BBPOS WisePad 3 verbinden

Wenn du das kompakte [Bluetooth-Lesegerät](https://docs.stripe.com/terminal/payments/setup-reader/bbpos-wisepad3) nutzt, ist die Einrichtung besonders schnell erledigt.

1. Schalte das BBPOS WisePad 3 über den Power-Button an.
2. Gehe in der anny POS App im Checkout auf **Pair reader**.
3. Wähle die Option **Bluetooth** und klicke auf **Pair new reader**.
4. Warte einen Moment ab. Das Gerät verbindet sich nun automatisch mit deinem Tablet und steht anschließend als Zahlungsmethode bereit.

### Tap to Pay auf einem Android-Tablet aktivieren

Wenn du kein externes Lesegerät hast, kannst du [Tap to Pay](https://docs.stripe.com/terminal/payments/setup-reader/tap-to-pay?platform=android#device-types) nutzen. Dies funktioniert auf ausgewählten Android-Tablets:

| Hersteller | Modell |
| - | - |
| HMD Global | HMD T21 |
| Samsung Galaxy | Tab Active5 |
| Sunmi | CPad |
| Oukitel | RT3 Plus |
| Ulefone | Armor Pad 4 Ultra |

1. Öffne die anny POS App und erstelle eine Buchung bis zum Checkout.
2. Klicke auf **Pair reader**.
3. Wähle die Option **Tap to Pay** aus.
4. Dein Tablet ist nun als Zahlungsempfänger konfiguriert. Kund:innen halten ihre Karte oder ihr Smartphone zum Bezahlen einfach direkt an dein Tablet.

## Wann sinnvoll

* Die einmalige Hardware-Einrichtung ist sinnvoll, wenn du regelmäßigen Kundenverkehr an einem festen Standort betreust.
* Wenn du Walk-in-Kund:innen hast, die sofort vor Ort buchen und bezahlen wollen.
* Wenn du offene Rechnungen bestehender Buchungen am Front Desk begleichen lässt.
* Wenn du ein professionelles Setup für den direkten Kundenkontakt benötigst.

Nach der schnellen Konfiguration sind deine Geräte dauerhaft für alle zukünftigen Zahlungen einsatzbereit.

## FAQ

<AccordionGroup>
  <Accordion title="Fallen für die Zahlungen über die POS App Gebühren an?">
    Ja, für die Abwicklung der Kartenzahlungen über das Lesegerät oder Tap to Pay fallen Transaktionsgebühren an. Mehr dazu: [Online-Zahlung & Gebühren bei anny](/online-payments)
  </Accordion>

  <Accordion title="Muss ich das Lesegerät vor jeder Zahlung neu verbinden?">
    Nein. Sobald du das Gerät einmal gekoppelt hast, ist es in deinem Checkout hinterlegt und für jede Buchung sofort auswählbar.
  </Accordion>

  <Accordion title="Kann ich mehrere Tablets mit demselben Netzwerk-Lesegerät verbinden?">
    Nein, mehrere Tablets können nicht das gleiche Gerät benutzen, aber es können mehrere Geräte pro Tablet verbunden werden.
  </Accordion>

  <Accordion title="Kann ich Barzahlungen in der App erfassen?">
    Nein. Im ersten Release der App werden reine Kartenzahlungen über das Lesegerät oder Tap to Pay unterstützt.
  </Accordion>

  <Accordion title="Kann ich Trinkgeld über das Lesegerät annehmen?">
    Ja. Bei Kartenzahlungen über das Lesegerät oder Tap to Pay kann Trinkgeld mit kassiert werden. Details: [Buchungen und Zahlungen in der POS App](/pos-app-bookings-and-payments).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein Bluetooth-Lesegerät verbindet sich, aber die Zahlung startet nicht.">
    Nach dem ersten Pairing führt ein Bluetooth-Reader (wie das WisePad 3) oft ein kurzes Firmware Update durch. Das Update kann einige Minuten dauern. Bitte warte ab, bis das Gerät den Abschluss auf dem Display anzeigt.
  </Accordion>

  <Accordion title="Das Lesegerät hat einen leeren Akku oder funktioniert kurzfristig nicht.">
    In diesem Fall bietet die anny POS App einen Fallback: Es wird ein QR-Code auf dem Tablet angezeigt. Die Kund:in scannt den Code mit dem eigenen Smartphone, gelangt auf die Pay-Later-Seite und bezahlt dort selbstständig mit Apple Pay, Google Pay oder PayPal.
  </Accordion>
</AccordionGroup>


# Über wiederkehrende Buchungen
Source: https://docs.anny.co/recurring-bookings

Erstelle automatisch wiederkehrende Termine als Serie, prüfe die Verfügbarkeit je Termin und rechne korrekt ab.

Mit wiederkehrenden Buchungen legst du einen Termin einmalig an, der sich automatisch in einem festen Rhythmus wiederholt. anny erstellt daraus eine Serie mit einer Anker-Buchung und einzelnen Folgeterminen, prüft jeden Termin auf Verfügbarkeit und übernimmt alle Buchungsdetails wie Add-Ons, zusätzliche Ressourcen und Preisberechnung auf jeden einzelnen Termin.

<Info>
  Der Toggle **Wiederkehrende Buchungen erlauben** muss in den erweiterten Einstellungen der Buchungsoption aktiviert sein.
</Info>

## Wie funktioniert eine wiederkehrende Buchung?

anny unterscheidet zwei Arten von Terminserien:

| Art | Beschreibung | Beispiel |
| - | - | - |
| Feste Terminserie (Buchungsserie) | Termine sind am Angebot vordefiniert und werden als Block gebucht | 8-wöchiger Kurs mit festen Terminen |
| Wiederkehrende Buchung | Kund:innen definieren selbst eine Wiederholungsregel | "Jeden Dienstag, bis Ende des Jahres" |

Dieser Artikel behandelt ausschließlich **wiederkehrende Buchungen**, bei denen Kund:innen selbst einen Rhythmus festlegen. Für feste Terminserien mit vordefinierten Terminen siehe [Buchungsserien](/booking-series).

Bei einer wiederkehrenden Buchung gibt es eine Anker-Buchung, die den Preis und die Wiederholungsregel trägt, sowie je einen eigenen Termin pro Wiederholung. Jeder Termin ist eine eigenständige Buchung im Kalender.

### Die Wiederholungsregel

Kund:innen legen auf der Buchungsseite folgende Parameter fest:

* **Frequenz**: täglich, wöchentlich oder monatlich
* **Intervall**: z. B. jede Woche, jede 2. Woche, jeden 3. Monat
* **Tage**: Wochentage (z. B. Montag + Mittwoch), Monatstag (z. B. "immer am 11.") oder Muster (z. B. "jeden 2. Dienstag im Monat")
* **Termindauer**: Dauer jedes einzelnen Termins
* **Endbedingung**: Enddatum oder unendliche Laufzeit

anny übersetzt die Einstellungen automatisch in einen lesbaren Satz (z. B. "Alle 2 Wochen am Montag"), der Kund:innen auf der Buchungsseite angezeigt wird.

<Warning>
  Eine unendliche Serie ist nur bei späterer Zahlung (pay-later) möglich. Bei sofortiger Zahlung oder Vorauszahlung ist ein Enddatum Pflicht.
</Warning>

### Was pro Termin übernommen wird

Jeder Termin der Serie ist eine vollwertige Buchung und enthält:

* Ressource, Zeitraum, Kund:in und Preis
* Zusatzoptionen und Add-Ons
* Zusätzliche Ressourcen (z. B. mitgebuchte Ausstattung)
* Kontingent-Verbrauch (Termin für Termin abgezogen)
* Preisberechnung inkl. Rabatte und Preisanpassungen
* Notizen, Beschreibung und Kundenhinweise vom Anker-Termin

<Tip>
  Add-Ons und Extra-Ressourcen müssen nur einmal eingestellt werden und gelten dann automatisch für alle Termine der Serie.
</Tip>

### Verfügbarkeitsprüfung und Vorschau

Vor dem Buchen prüft anny jeden einzelnen Termin auf Verfügbarkeit. Die Vorschau zeigt:

* Eine Liste aller Termine mit Datum und Uhrzeit
* Den Verfügbarkeitsstatus pro Termin
* Eine Zusammenfassung wie "12 von 15 Terminen verfügbar"

Nicht verfügbare Termine werden nicht gebucht. Alle anderen verfügbaren Termine der Serie werden trotzdem gebucht.

### Abrechnung

Das Abrechnungsmodell wird vom Admin im Reiter **Zahlungen** der Buchungsoption festgelegt. Bei Zahlung auf Rechnung kann der **Zahlungsmodus für wiederkehrende Buchungen** gewählt werden:

| Modell | Beschreibung |
| - | - |
| Alles im Voraus | Sammelrechnung über alle Termine |
| Pro Termin | Eigene Rechnung je Termin |

Bei "Pro Termin" wird immer nur der nächste anstehende Termin abgerechnet, nicht die gesamte Serie auf einmal.

### Serie verwalten

Bestehende Serien können nachträglich angepasst werden (z. B. Enddatum, Wochentage). anny gleicht automatisch ab: neue Termine werden ergänzt, wegfallende Termine storniert. Unendliche Serien verlängert anny automatisch im Hintergrund, damit immer genug künftige Termine vorhanden sind.

Im Shop und im Admin-Bereich kannst du Termine einer Serie stornieren.

Stornierst du einen einzelnen Folgetermin (nicht die Anker-Buchung), fragt anny:

* **Termin absagen**: Nur dieser Termin wird storniert.
* **Diesen und folgende Termine absagen**: Dieser Termin und alle späteren Termine der Serie werden storniert.

Im Shop öffnest du den Folgetermin und wählst **Stornieren**. Auf der Anker-Buchung findest du die Liste **Termine**.

Im Admin-Bereich öffnest du die Anker-Buchung. Unter **Buchungsserie** siehst du die einzelnen Termine. Stornierst du dort einen späteren Termin (zum Beispiel den zweiten oder dritten), erscheint dieselbe Auswahl.

Stornierst du die Anker-Buchung selbst, storniert anny die restliche Serie mit. Einen dritten Button für die gesamte Serie gibt es in diesem Dialog nicht.

## Wann nutze ich das?

* **Du vermietest Räume, Desks oder Equipment regelmäßig an dieselben Kund:innen**: Wiederkehrende Buchungen sparen den manuellen Aufwand, jeden Termin einzeln anzulegen.
* **Du bietest Kurse oder Trainings mit flexiblen Wiederholungen an**: Kund:innen können selbst einen Rhythmus festlegen und die Serie jederzeit anpassen.
* **Du möchtest Kontingente automatisch pro Termin abziehen**: Bei Buchungspaketen wird das Guthaben korrekt je Wiederholung verbraucht.
* **Nicht geeignet für**: Feste Kursreihen mit vordefinierten, zusammenhängenden Terminen, die als Block gebucht werden müssen. Dafür nutze [Buchungsserien](/booking-series).

## Zusammenhang mit anderen Features

* **Zusatzoptionen**: Add-Ons werden automatisch auf jeden Termin einer wiederkehrenden Buchung übernommen.
* **Buchungskontingente**: Kontingent-Guthaben wird Termin für Termin abgezogen, auch für Add-Ons.
* **Buchungsserien**: Buchungsserien haben vordefinierte, feste Termine am Angebot. Wiederkehrende Buchungen sind frei durch Kund:innen konfigurierbar.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Wiederkehrende Buchungen erlauben | Toggle in erweiterten Einstellungen aktivieren |
| Zahlungsmodus für wiederkehrende Buchungen | Alles im Voraus oder Pro Termin |

Auf der Buchungsseite wählen Kund:innen zusätzlich Frequenz, Intervall, Wochentage, Termindauer und Endbedingung.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Coworking-Space aktiviert wiederkehrende Buchungen für Meetingräume">
    Ein Coworking-Space möchte seinen Kund:innen ermöglichen, Meetingräume flexibel und wiederkehrend zu buchen.

    <Steps>
      <Step title="Ressource öffnen">
        Öffne die gewünschte Ressource (z. B. den Meetingraum) in der Ressourcenverwaltung.
      </Step>

      <Step title="Buchungsoption anlegen">
        Wechsle in den Reiter **Buchungsoption** und lege über **+Hinzufügen** eine neue Buchungsoption an, z. B. "Flex-Buchung".
      </Step>

      <Step title="Buchungsart konfigurieren">
        Wähle **Flexible Buchung** und stelle die Parameter ein: Min. Dauer 1 Stunde, Max. Dauer 8 Stunden, Abrechnung pro Stunde.
      </Step>

      <Step title="Wiederkehrende Buchungen aktivieren">
        Öffne die **Erweiterten Einstellungen** und aktiviere den Toggle bei **Wiederkehrende Buchungen erlauben**.
      </Step>

      <Step title="Zahlungsmodus festlegen">
        Wechsle in den Reiter **Zahlungen** und wähle aus, wie die Termine bezahlt werden sollen. Bei Zahlung auf Rechnung kann der **Zahlungsmodus für wiederkehrende Buchungen** festgelegt werden: a) **Alles im Voraus**, b) **Pro Termin**. Hier bestimmt der Admin, ob eine Sammelrechnung oder eine Einzelrechnung je Termin erstellt wird.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich eine unendliche Serie erstellen?">
    Nur wenn das Angebot auf spätere Zahlung (pay-later) eingestellt ist. Bei sofortiger Zahlung oder Vorauszahlung muss ein Enddatum gesetzt werden.
  </Accordion>

  <Accordion title="Was passiert, wenn ein Termin der Serie nicht verfügbar ist?">
    Der nicht verfügbare Termin wird übersprungen. Alle anderen verfügbaren Termine der Serie werden trotzdem gebucht.
  </Accordion>

  <Accordion title="Werden Add-Ons für jeden Termin einzeln berechnet?">
    Ja. Add-Ons und zusätzliche Ressourcen werden auf jeden Termin übernommen und je nach Abrechnungsmodell einzeln oder gesammelt berechnet.
  </Accordion>

  <Accordion title="Kann ich eine bestehende Serie nachträglich ändern?">
    Ja. Du kannst Enddatum, Wochentage und andere Parameter anpassen. anny ergänzt automatisch neue Termine und storniert wegfallende.
  </Accordion>

  <Accordion title="Kann ich im Shop die ganze Serie oder nur folgende Termine stornieren?">
    Ja. Bei einem Folgetermin wählst du **Termin absagen** oder **Diesen und folgende Termine absagen**. Stornierst du die Anker-Buchung, fällt die restliche Serie mit weg. Dieselbe Auswahl erscheint im Admin-Bereich, wenn du in der Anker-Buchung einen späteren Termin unter **Buchungsserie** stornierst.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein Kunde kann keine unendliche Serie einstellen">
    Ursache: Das Angebot ist auf sofortige Zahlung oder Vorauszahlung konfiguriert. Lösung: Entweder den Zahlungsmodus auf Zahlung auf Rechnung umstellen oder den Kunden bitten, ein Enddatum zu setzen.
  </Accordion>

  <Accordion title="Nicht alle Termine der Serie wurden gebucht">
    Ursache: Einzelne Termine waren zum Buchungszeitpunkt nicht verfügbar (z. B. durch Blocker oder andere Buchungen). anny bucht nur verfügbare Termine. Lösung: In der Buchungsvorschau prüfen, welche Termine betroffen waren, und bei Bedarf die Wiederholungsregel anpassen.
  </Accordion>

  <Accordion title="Das Kontingent wird zu schnell aufgebraucht">
    Ursache: Das Kontingent wird pro Termin abgezogen, inklusive Add-Ons. Bei langen Serien mit mehreren Terminen pro Woche kann das Guthaben schnell verbraucht sein. Lösung: Anzahl der Termine prüfen und das Kontingent-Volumen entsprechend anpassen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> Abgrenzung: "Buchungsserie" = feste vordefinierte Termine am Angebot (Block-Buchung, z. B. 8-wöchiger Kurs). "Wiederkehrende Buchung" = Kund:in konfiguriert Wiederholungsregel selbst (flexibel). Zwei verschiedene Features. Kernregel: "Unendlich + sofort bezahlen" geht nicht. Häufigster Grund, warum Kund:innen keine unendliche Serie einstellen können: Zahlungsmodus prüfen. UI-Pfad: Ressource > Buchungsoption > Erweiterte Einstellungen > Toggle "Wiederkehrende Buchungen erlauben". Zahlungsmodus: Reiter Zahlungen > Zahlungsmodus für wiederkehrende Buchungen. Verwandte Artikel: Buchungsserien (feste Terminserien), Zusatzoptionen (Add-Ons), Buchungskontingente (Guthaben-Verbrauch).
>
> Storno: Der Zwei-Button-Dialog erscheint nur auf einem Serien-Element (`is_series` = `series_id` gesetzt), nicht auf der Anker-Buchung (`is_series_master` = `series_type` gesetzt). Shop: Buchungsseite > **Stornieren** > **Termin absagen** oder **Diesen und folgende Termine absagen**. Admin: Anker-Buchung > Panel **Buchungsserie** > Folgetermin > **Stornieren** > dieselben zwei Buttons. Storno der Anker-Buchung storniert die restlichen offenen Termine mit, ohne Strategie-Dialog. Backend-Strategie `series` und i18n-Key `cancelEntireSeries` existieren, die sichtbare UI sendet sie nicht. Derselbe Dialog gilt auch für feste Buchungsserien.


# Ressourcen-Status
Source: https://docs.anny.co/resource-status

Steuere pro Ressource separat, ob sie sichtbar, buchbar und abrechnungsrelevant ist.

Mit dem Ressourcen-Status steuerst du in anny für jede Ressource einzeln, ob sie für Kund:innen sichtbar, buchbar oder nur intern verfügbar ist. So legst du Ressourcen wie Trainer oder Räume kostenlos zur Ansicht an, ohne dass sie deine Abrechnung beeinflussen.

## Wie funktioniert der Ressourcen-Status?

Jede Ressource hat ein **Status-Dropdown** mit fünf Optionen. Der Status bestimmt in Kombination mit der Einstellung **Buchung aktivieren** in den Service-Einstellungen, wie sich die Ressource verhält.

| Status | Sichtbarkeit | Buchbarkeit | Abrechnung |
| - | - | - | - |
| Live zur Buchung | Für Endnutzer:innen sichtbar | Ja | Zählt zur Abrechnung |
| Live zur Ansicht | Für Endnutzer:innen sichtbar | Nein | Kostenlos |
| Intern zur Buchung | Nur Admins | Ja (intern) | Zählt zur Abrechnung |
| Intern zur Verwaltung | Nur Admins | Nein | Kostenlos |
| Archiviert | Nicht sichtbar | Nein | Kostenlos |

Die bisherigen Bezeichnungen wurden umbenannt: "Aktiv" heißt jetzt **Live**, "Inaktiv" heißt jetzt **Intern**.

<img alt="Status-Dropdown einer Ressource mit den fünf Optionen" />

Das Status-Dropdown zeigt die fünf verfügbaren Optionen. Der aktuell gesetzte Status bestimmt zusammen mit der Buchungseinstellung das Gesamtverhalten der Ressource.

<Tip>
  Auch bei deaktivierter Buchung kannst du weiterhin Blocker manuell pflegen oder über den Kalender-Sync verwalten.
</Tip>

## Wann nutze ich das?

* **Du möchtest Trainer, Räume oder Equipment als Info-Ressourcen anzeigen, ohne dass sie buchbar sind:** Setze den Status auf "Live zur Ansicht". Die Ressource ist für Kund:innen sichtbar, aber nicht buchbar und kostenlos.
* **Du bereitest eine neue Ressource vor oder testest ein Setup:** Nutze "Intern zur Verwaltung". Nur Admins sehen die Ressource, sie ist kostenlos und wird nicht veröffentlicht.
* **Du brauchst eine Ressource, die nur intern (z. B. durch Admins) gebucht werden kann:** Wähle "Intern zur Buchung". Die Ressource ist nicht öffentlich sichtbar, aber intern buchbar und zählt zur Abrechnung.
* **Nicht geeignet für:** Ressourcen, die du dauerhaft nicht mehr brauchst. In diesem Fall nutze den Status "Archiviert", um die Ressource vollständig zu deaktivieren.

## Zusammenhang mit anderen Features

* **Communities:** Wenn eine Ressource einer Community zugewiesen ist, gelten die Sichtbarkeitsregeln der Community zusätzlich zum Ressourcen-Status. Der Status steuert die Grundsichtbarkeit, die Community schränkt weiter ein.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| **Status-Dropdown** | Wählt einen der 5 Status-Modi |
| **Buchung aktivieren** | Schaltet Buchbarkeit für die Ressource ein/aus |

<img alt="Einstellung Buchung aktivieren in den Service-Einstellungen der Ressource" />

Die Einstellung "Buchung aktivieren" findest du in den Service-Einstellungen der Ressource. Sie steuert in Kombination mit dem Status, ob Buchungen auf dieser Ressource möglich sind.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Kursanbieter mit Trainer und Raum nur zur Ansicht">
    Du bietest Kurse an und möchtest Trainer und Raum als Zusatzinformation anzeigen, ohne dass sie separat buchbar sind oder in die Abrechnung zählen.

    <Steps>
      <Step title="Kurs-Ressource auf Live zur Buchung setzen">
        Öffne die Kurs-Ressource und setze das **Status-Dropdown** auf **Live zur Buchung**. Stelle sicher, dass **Buchung aktivieren** in den Service-Einstellungen aktiv ist.
      </Step>

      <Step title="Trainer-Ressource auf Live zur Ansicht setzen">
        Öffne die Trainer-Ressource und setze das **Status-Dropdown** auf **Live zur Ansicht**. Die Buchung ist automatisch deaktiviert.
      </Step>

      <Step title="Raum-Ressource auf Live zur Ansicht setzen">
        Öffne die Raum-Ressource und setze das **Status-Dropdown** auf **Live zur Ansicht**.
      </Step>

      <Step title="Ergebnis prüfen">
        Kund:innen sehen Kurs, Trainer und Raum auf der Buchungsseite. Nur der Kurs ist buchbar und zählt zur Abrechnung. Trainer und Raum sind kostenlos.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Interne Testressource für Setup">
    Du möchtest eine neue Ressource vorbereiten und testen, bevor sie veröffentlicht wird.

    <Steps>
      <Step title="Neue Ressource anlegen">
        Erstelle eine neue Ressource mit den gewünschten Einstellungen.
      </Step>

      <Step title="Status auf Intern zur Verwaltung setzen">
        Setze das **Status-Dropdown** auf **Intern zur Verwaltung**. Die Ressource ist nur für Admins sichtbar, nicht buchbar und kostenlos.
      </Step>

      <Step title="Setup und Test durchführen">
        Konfiguriere Zeitpläne, Services und weitere Einstellungen. Nur Admins können die Ressource im Admin-Bereich sehen und bearbeiten.
      </Step>

      <Step title="Bei Fertigstellung live schalten">
        Wenn das Setup abgeschlossen ist, ändere den Status auf **Live zur Buchung**, um die Ressource für Kund:innen freizugeben.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Werden bestehende Ressourcen automatisch umgestellt?">
    Ja. Die bisherigen Status wurden automatisch umbenannt: "Aktiv" heißt jetzt "Live" und "Inaktiv" heißt jetzt "Intern". Deine bestehende Konfiguration bleibt dabei erhalten.
  </Accordion>

  <Accordion title="Zählt eine Ressource mit Status Live zur Ansicht in meine Abrechnung?">
    Nein. Nur Ressourcen mit aktivierter Buchung (Status "Live zur Buchung" oder "Intern zur Buchung") zählen zur Abrechnung. Alle anderen Status sind kostenlos.
  </Accordion>

  <Accordion title="Kann ich bei einer Ressource ohne Buchung trotzdem Blocker setzen?">
    Ja. Auch wenn die Buchung deaktiviert ist, kannst du Blocker manuell erstellen oder über den Kalender-Sync verwalten.
  </Accordion>

  <Accordion title="Was passiert, wenn ich eine Ressource archiviere?">
    Archivierte Ressourcen sind weder für Admins im Standard-View noch für Endnutzer:innen sichtbar. Sie sind nicht buchbar und zählen nicht zur Abrechnung.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Meine Ressource wird auf der Buchungsseite nicht angezeigt">
    Die Ressource hat vermutlich den Status "Intern zur Verwaltung", "Intern zur Buchung" oder "Archiviert". Nur Ressourcen mit dem Präfix "Live" sind für Endnutzer:innen sichtbar. Öffne die Ressource und setze den Status auf "Live zur Buchung" oder "Live zur Ansicht".
  </Accordion>

  <Accordion title="Die Ressource ist sichtbar, aber Kund:innen können nicht buchen">
    Der Status steht auf "Live zur Ansicht" oder die Einstellung "Buchung aktivieren" ist deaktiviert. Prüfe beides: Setze den Status auf "Live zur Buchung" und stelle sicher, dass "Buchung aktivieren" in den Service-Einstellungen aktiv ist.
  </Accordion>

  <Accordion title="Die Ressource wird trotz Status Intern zur Verwaltung berechnet">
    Das sollte nicht vorkommen. Prüfe, ob der Status wirklich korrekt gespeichert wurde und nicht versehentlich "Intern zur Buchung" ausgewählt ist. Bei "Intern zur Buchung" zählt die Ressource zur Abrechnung, bei "Intern zur Verwaltung" nicht.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Exakter UI-Pfad Status: **Ressource** > **Status-Dropdown** (5 Optionen: Live zur Buchung, Live zur Ansicht, Intern zur Buchung, Intern zur Verwaltung, Archiviert)
> * Billing-Regel: Nur Status mit aktiver Buchung (Live zur Buchung, Intern zur Buchung) zählen zur Abrechnung. Alle anderen drei Status sind kostenlos.
> * Terminologie-Mapping: Alt "Aktiv" = Neu "Live", Alt "Inaktiv" = Neu "Intern"
> * Abgrenzung Archiviert vs. Intern zur Verwaltung: Archiviert = komplett unsichtbar (auch für Admins nicht im Standard-View). Intern zur Verwaltung = nur für Admins sichtbar und bearbeitbar.
> * Blocker-Hinweis: Auch bei deaktivierter Buchung können Blocker manuell gepflegt oder via Kalender-Sync verwaltet werden.
> * Verwandte Artikel: "Ressource konfigurieren" für allgemeine Ressourcen-Einstellungen, "Communities" für Sichtbarkeitsregeln auf Community-Ebene.


# Ressource konfigurieren
Source: https://docs.anny.co/ressourcen-konfigurieren

Erstelle und konfiguriere Ressourcen in anny, um sie für deine Kund:innen buchbar zu machen.

Ressourcen sind das Herzstück von anny. Eine Ressource kann alles sein, was du zur Buchung anbieten möchtest und das nur begrenzt verfügbar ist: Räume, Equipment, Arbeitsplätze, Events oder Beratungen. In dieser Anleitung richtest du eine Ressource vollständig ein.

<Info>
  **Mehrfachverfügbarkeit von Ressourcen** und **Mehrfachverfügbarkeit mit Zuweisung** (Child-Ressourcen) müssen unter **Account-Einstellungen** → **Features** aktiviert werden, bevor die jeweiligen Verfügbarkeitstypen zur Auswahl stehen.
</Info>

## Ressource erstellen und konfigurieren

<Steps>
  <Step title="Ressource anlegen">
    Öffne aus der Menüleiste die **Ressourcen** und klicke oben rechts auf **Neu+**. Eine neue, leere Ressource wird erstellt.
  </Step>

  <Step title="Allgemeine Informationen ausfüllen">
    Konfiguriere die Grunddaten deiner Ressource:

    1. **Bild**: Lade ein Bild im Querformat hoch oder wähle eines aus der Galerie.
    2. **Name**: Wähle einen aussagekräftigen Namen. Bei mehreren Ressourcen empfehlen wir eine wiedererkennbare Bezeichnung.
    3. **URL**: Passe die URL-Endung an, damit der Link auf der Buchungsseite logisch und einheitlich ist (z. B. `https://anny.co/book/meeting-2-stairways-to-heaven`).
    4. **Kategorie**: Ordne die Ressource einer Kategorie zu (z. B. Meetingraum, Parkplatz, Flex Desk, Workshop).
    5. **Gruppe**: Ordne die Ressource optional einer Gruppe zu zur internen Verwaltung (z. B. Fachbereich, Abteilung).
    6. **Beschreibung**: Füge eine Beschreibung mit der Toolbar hinzu. Du kannst Überschriften, Listen, Bilder, Videos und Tabellen einfügen. Über das **@-Zeichen** verlinkst du direkt auf andere Ressourcen, Abo-Pläne oder Buchungspakete.
    7. **Dateien**: Lade optional ein Bild oder Video hoch, das auf der Ressourcenseite angesehen und heruntergeladen werden kann.
    8. **Eigenschaften**: Erstelle filterbare Eigenschaften (Checkbox, Zahl oder Text), nach denen Kund:innen auf der Buchungsseite filtern können.
    9. **Standort**: Gib den Standort als Adresse, Online oder keinen Standort an.
  </Step>

  <Step title="Verfügbarkeitstyp wählen">
    Unter dem Reiter **Verfügbarkeit** legst du fest, wie oft die Ressource gleichzeitig gebucht werden kann:

    | Typ | Beschreibung | Beispiel |
    | - | - | - |
    | **Einfach verfügbar** | Kann nur einmal zur gleichen Zeit gebucht werden. | Meetingraum, Coach, Trainer |
    | **Mehrfach verfügbar** | Kann bis zur eingestellten Anzahl gleichzeitig gebucht werden. | Event, Workshop, Kurs |
    | **Child-Ressourcen** | Kann mehrfach gebucht werden, wobei jeder Buchung eine konkrete Option aus einer Liste zugewiesen wird. | Arbeitsplätze, Fahrzeuge, Parkplätze |

    <Warning>
      Lege **Räume und Sportplätze als eigene Ressourcen** an, nicht als Child-Ressourcen. Im übergreifenden Kalender (Menü **Kalender**) werden Child-Ressourcen zusammengefasst: Du siehst Belegungszahlen der übergeordneten Ressource, nicht die einzelnen Plätze nebeneinander. Den Kalender der Child-Ressourcen siehst du erst, wenn du die übergeordnete Ressource aufklappst (**Child-Ressourcen anzeigen**) oder ihre Detailseite öffnest. Für Arbeitsplätze, Parkplätze, Sitzplätze oder Schließfächer sind Child-Ressourcen das passende Modell.
    </Warning>
  </Step>

  <Step title="Zeitplan definieren">
    Trage unter **Verfügbarkeit** deine regelmäßigen Verfügbarkeiten oder verfügbaren Termine ein. Einzelne Wochentage können mehrfach angelegt werden, um z. B. eine Mittagspause abzubilden.

    <Warning>
      Die Zeitangaben auf der Ressource überschreiben die der Buchungsoption. Sie müssen identisch oder größer als die der Buchungsoption sein.
    </Warning>
  </Step>

  <Step title="Ressource live testen">
    Prüfe, wie deine Ressource auf der Buchungsseite aussieht: Klicke in der Ressourcenliste oben rechts auf die **drei Punkte** und wähle **Anzeigen**. Die Ressource öffnet sich in der Buchungsansicht, auch wenn sie noch nicht live geschaltet ist.
  </Step>

  <Step title="Ressource live schalten">
    Setze die Ressource über den Status-Button in der Ressourcenliste auf **live**, damit sie auf der Buchungsseite sichtbar wird.
  </Step>
</Steps>

<Tip>
  Bilder für Ressourcen müssen im **Querformat** hochgeladen werden (optimal: 968 x 544 Pixel). Im Hochformat hochgeladene Bilder werden automatisch gedreht. Für Banner verwende 1920 x 1080 Pixel, für Logos 400 x 400 Pixel.
</Tip>

## Ergebnis prüfen

Deine Ressource ist korrekt konfiguriert, wenn sie in der Ressourcenliste als **live** angezeigt wird und auf der Buchungsseite sichtbar ist. Prüfe dort, ob Bild, Beschreibung, Eigenschaften und Verfügbarkeiten korrekt dargestellt werden.

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen einer Ressource und einer Child-Ressource?">
    Eine Ressource ist das übergeordnete buchbare Objekt (z. B. ein Büro mit mehreren Arbeitsplätzen). Child-Ressourcen sind die konkreten Einzeloptionen innerhalb dieser Ressource (z. B. Platz 1, Platz 2, Platz 3). Ob Kund:innen die Option selbst wählen, steuerst du unter **Ressource** → **Verfügbarkeit** (Child-Ressourcen / Mehrfachverfügbarkeit mit Zuweisung) mit **Kunde darf Optionen wählen**. Ist die Option aus, weist anny die Child-Ressourcen automatisch in aufsteigender Reihenfolge (Name) zu. Für Tische, die einer Gruppe exklusiv gehören sollen, kombiniere Child-Ressourcen mit [Exklusiven Zeitfenstern](/exclusive-time-slots).
  </Accordion>

  <Accordion title="Wann lege ich Räume oder Sportplätze als eigene Ressourcen an?">
    Immer dann, wenn du die Belegung jedes Raums oder Platzes im übergreifenden Kalender sehen und filtern willst. Child-Ressourcen erscheinen dort nur als Summe der übergeordneten Ressource. Deshalb: Meetingräume, Seminarräume und Sportplätze jeweils als eigene Ressource mit **Einfach verfügbar**. Child-Ressourcen eignen sich für austauschbare Einheiten wie Desks, Parkplätze, Sitzplätze oder Schließfächer.
  </Accordion>

  <Accordion title="Welche Buchungsarten gibt es für Ressourcen?">
    Pro Buchungsoption kannst du die Buchungsart einstellen:

    * **Standard**: Eine Buchung blockiert die Ressource für den Zeitraum. Bei mehrfach verfügbaren Ressourcen wird pro Buchung eine Kapazitätseinheit blockiert.
    * **Transparent**: Buchungen blockieren die Ressource nicht. Damit sind unbegrenzt viele Buchungen für denselben Zeitraum möglich.
    * **Mehrfach**: Eine einzelne Buchung blockiert die eingestellte Anzahl an Kapazitätseinheiten (z. B. für Gruppentickets). Nur für mehrfach verfügbare Ressourcen.
    * **Vollständig**: Eine Buchung blockiert die gesamte Kapazität der Ressource (z. B. um eine Ressource mit Child-Ressourcen als Ganzes zu buchen).
  </Accordion>

  <Accordion title="Wie übersetze ich meine Ressource in andere Sprachen?">
    Klicke über die drei Punkte oben rechts auf der Ressource auf **Übersetzen** und wähle die gewünschte Zielsprache. Für Child-Ressourcen können ebenfalls eigene Übersetzungen für die Namen hinterlegt werden.
  </Accordion>

  <Accordion title="Warum sehe ich die Option Mehrfach mit Zuweisung nicht?">
    Das Feature muss zuerst aktiviert werden: Navigiere zu **Avatar** (oben rechts) → **Account-Einstellungen** → **Features** und aktiviere **Mehrfachverfügbarkeit mit Zuweisung**.
  </Accordion>

  <Accordion title="Wo stelle ich ein, dass Kund:innen die Child-Ressource selbst wählen?">
    Unter **Ressource** → **Verfügbarkeit**, sobald der Typ Child-Ressourcen aktiv ist. Der Toggle heißt **Kunde darf Optionen wählen**. Er ist nicht sichtbar, wenn eine Child-Ressource eine verfügbare Anzahl größer 1 hat. Die Option ist nicht mit [Exklusiven Zeitfenstern](/exclusive-time-slots) kombinierbar: Dort weist anny Child-Ressourcen automatisch zu.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein Bild wird gedreht angezeigt">
    Bei Ressourcen können nur Bilder im Querformat hochgeladen werden. Bilder im Hochformat werden automatisch gedreht. Lade das Bild erneut im Querformat hoch.
  </Accordion>

  <Accordion title="Mein Bild kann nicht hochgeladen werden">
    Die Dateigröße ist wahrscheinlich zu groß. Reduziere die Dateigröße und versuche es erneut.
  </Accordion>

  <Accordion title="Mein Bild ist verpixelt oder wird abgeschnitten">
    Ein verpixeltes Bild entsteht, wenn die Auflösung zu niedrig ist. Verwende mindestens 968 x 544 Pixel für Ressourcen-Bilder. anny ist responsiv: In kleineren Ansichten können die äußeren Bereiche des Bildes abgeschnitten werden. Positioniere wichtige Inhalte daher immer mittig.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad Ressource anlegen: Menüleiste → Ressourcen → Neu+
> * UI-Pfad Child-Ressourcen: Ressource → Verfügbarkeit → Child-Ressourcen anzeigen
> * Toggle **Kunde darf Optionen wählen** (`settings.checkout.customerCanPickChildren`): Ressource → Verfügbarkeit (Child-Modus). Aus = automatische Zuweisung aufsteigend nach Name. Versteckt bei Child-quantity > 1. Nicht kombinierbar mit Exklusiven Zeitfenstern (CRs werden dort automatisch zugewiesen).
> * Feature-Aktivierung nötig für: „Mehrfachverfügbarkeit von Ressourcen“ (mehrfach buchbar) und „Mehrfachverfügbarkeit mit Zuweisung“ (Child-Ressourcen) unter Avatar → Account-Einstellungen → Features.
> * „Mehrfachverfügbarkeit mit Zuweisung“ = Child-Ressource (Leitbegriff). Nicht verwechseln mit „Mehrfachverfügbarkeit von Ressourcen“ (= einfache Kapazitätserhöhung ohne konkrete Zuordnung).
> * Kalender: Ressourcen mit `hasChildren` oder `quantity > 1` erscheinen im Organisationskalender aggregiert (Belegungszahlen, nicht einzelne Buchungsblöcke). Child-Ressourcen-Zeilen erst nach Expand (`Child-Ressourcen anzeigen`) oder auf der Ressourcendetailseite (Fullscreen-Kalender mit Child-Resource-Timeline). Listen filtern standardmäßig `exclude_child_resources`.
> * Empfehlung: Räume und Sportplätze = eigene Ressourcen (Einfach verfügbar). Child-Ressourcen = Desks, Parkplätze, Sitzplätze, Schließfächer, Fahrzeuge.
> * Zeitplan-Hierarchie: Zeitangaben Ressource überschreiben Zeitangaben Buchungsoption. Ressource >= Buchungsoption.
> * Buchungsarten (Standard, Transparent, Mehrfach, Vollständig) werden auf der Buchungsoption konfiguriert, nicht auf der Ressource selbst.
> * Bildformat Ressource: nur Querformat, optimal 968x544 px. Hochformat wird automatisch gedreht.
> * Verwandte Artikel: Buchungsoption konfigurieren (/buchungsoption-konfigurieren), Zeitpläne & Termine (/zeitplaene-termine), Exklusive Zeitfenster (/exklusive-zeitfenster).


# Admin-Nutzer und Rollen verwalten
Source: https://docs.anny.co/roles-and-permissions

Lade Admin-Nutzer ein, weise Rollen zu und steuere Berechtigungen granular pro Ressource.

Mit der Nutzerverwaltung in anny bestimmst du, welche Personen sich in deinen Account einloggen dürfen und welche Rechte sie haben. Du erreichst die Nutzerverwaltung über deinen **Avatar** (oben rechts) → **Admin-Nutzer verwalten**. Dort siehst du alle aktiven Admin-Nutzer mit Name, E-Mail-Adresse, Beitrittsdatum und zugewiesener Rolle.

## Nutzer einladen

<Tip>
  Offene Einladungen werden auf derselben Seite angezeigt. Du siehst dort auch, wann die Einladung versendet wurde und wie lange sie gültig ist. Bei Bedarf kannst du die Einladung zurückziehen.
</Tip>

<Steps>
  <Step title="Admin-Nutzer Verwaltung öffne">
    Navigiere zu deinem Avatar und öffne die **Admin-Nutzerverwaltung**.
  </Step>

  <Step title="Admin einladen">
    Klicke oben rechts auf das **+ Einladen**, um jemanden einzuladen. Trage den Namen, die E-Mail-Adresse sowie die Rolle für die Person ein. Optional können an der jeweiligen Rolle noch Anpassungen vorgenommen werden, indem die Häkchen bei den Berechtigungen entfernt oder hinzugefügt werden.
  </Step>
</Steps>

## Rollen erstellen und zuweisen

Rollen sind wiederverwendbare Berechtigungssets, die jedem Admin zugewiesen werden können. So musst du nicht für jeden Nutzer individuelle Rechte anlegen.

### Rollenbeispiele

| Rolle | Beschreibung | Typischer Einsatz |
| - | - | - |
| (Super-) Admin | Berechtigungsstufe Verwalten für alle Bereiche. Uneingeschränkte Kontrolle über den gesamten Account. | Zentrale IT-Verwaltung, Account-Inhaber:in. Max. 1-2 pro Account empfohlen. |
| Ressourcen-spezifischer Admin | Bearbeitender Zugriff auf ausgewählte Ressourcen. Kein Zugriff auf andere Bereiche. | Abteilungsleiter:innen, Facility Manager für bestimmte Räume oder Fahrzeuge. |
| Buchungs-spezifische Rolle | Nur lesender Zugriff auf Buchungen. Keine Änderungen möglich. | Empfang, Sicherheitspersonal, Facility Management. |

### Standardrolle Reception

Neue Organisationen erhalten automatisch die Rolle **Reception**. Diese Rolle darf Buchungen ansehen und bearbeiten, Bestellungen und Kund:innen verwalten sowie Rechnungen erstellen und bearbeiten. Sie hat keinen vollen Zugriff auf Account-Einstellungen, Integrationen oder die Nutzerverwaltung.

Bestehende Organisationen ziehen diese Vorgaben nicht automatisch nach. Wenn du **Reception** schon nutzt, prüfe die Rolle unter **Avatar** → **Admin-Nutzer verwalten** → **Rollen** und ergänze bei Bedarf **Rechnungen** mit **Erstellen** und **Bearbeiten**.

## Berechtigungen im Überblick

Jeder Admin-Nutzer erhält pro Bereich eine Berechtigungsstufe:

| Stufe | Bedeutung |
| - | - |
| Verwalten | Alle folgenden Rechte (höchste Stufe) |
| Listen | Listenansicht im Seitenmenü |
| Ansehen | Ressource oder Buchungsoption öffnen |
| Erstellen | Neue Elemente anlegen |
| Bearbeiten | Bestehende Elemente verändern (Text, Bilder, Preise) |
| Löschen | Elemente entfernen |

### Berechtigungsbereiche

Berechtigungen können auf folgende Bereiche angewendet werden:

| Bereich | Umfasst |
| - | - |
| **Ressource** | Beschreibung, Eigenschaften, Zeiten |
| **Services** | Buchungsoptionen und Services |
| Verfügbare Timeslots | Unregelmäßige Zeitfenster (Events) |
| Synchronisierte Kalender | Verbundene Kalender, Blocker |
| **Communities** | Communities |
| **Abo-Pläne** | Preise, Beschreibung, verbundene Communities |
| Abonnements | Kundenabonnements und Mitgliedschaften |
| Buchungskontingente | Kontingente pro Kunde |
| Buchungspakete | Buchungspakete |
| Buchungscodes | Buchungscodes |
| **Karten** | Interaktive Lagepläne |
| Standorte | Standorte aller Ressourcen/Karten |
| Gutscheine | Gutscheine vergeben und verwalten |
| Buchungen | Alle getätigten Buchungen |
| Bestellungen | Gesamte Bestellungen |
| Kunden | Buchende Personen |
| Check-In und Check-Out | Check-in/Check-out (auch per Scan) |
| Rechnungen | Rechnungen |
| Importe | Datenimporte |
| Export Zeitpläne | Automatische Rechnungsexporte |
| Exportziele | Ziel-E-Mail-Adressen der Exporte |
| Kontoauszüge | Guthaben aus Online-Zahlungen |
| Account | Account-Beschreibung, Impressum |
| Integration | Schnittstellen zu externen Systemen |
| Nutzer-Einladung | Weitere Nutzer in den Adminbereich einladen |
| Displays | Raumdisplays und Anzeigetafeln |
| Rollen | Zugriffsrechte der Rollen |
| Nutzer | Nutzer im Adminbereich |
| Warteschlangen | Warteschlangen einer Aufrufanlage |
| Schnellaufruf | Schnellaufruf einer Aufrufanlage |
| Tags | Tags anlegen, bearbeiten, sortieren und löschen. Tags vergeben darf, wer den Datensatz bearbeiten darf. |

<Note>
  **Fettgedruckte** Bereiche können zusätzlich auf bestimmte Elemente eingeschränkt werden (z. B. nur bestimmte Ressourcen oder Communities).
</Note>

## Berechtigung eines Nutzers anpassen

Du kannst die Berechtigungen eines einzelnen Nutzers individuell anpassen, ohne die zugewiesene Rolle global zu verändern.

<Tip>
  Eingeschränkte Berechtigungen lassen sich auf Ressourcen-, Gruppen- oder Kategorie-Ebene vergeben. So kannst du z. B. einem Abteilungsleiter nur die Konferenzräume seiner Abteilung freigeben.
</Tip>

## Ergebnis prüfen

Nach der Einrichtung erkennst du den Erfolg an folgenden Punkten:

* Der eingeladene Nutzer erscheint in der Nutzerverwaltung mit der zugewiesenen Rolle.
* Beim Login sieht der Nutzer nur die Bereiche und Ressourcen, für die Berechtigungen vergeben wurden.
* Neue Rollen erscheinen im Reiter Rollen und können bei Einladungen ausgewählt werden.

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich einem Nutzer Rechte geben, ohne die Rolle zu ändern?">
    Ja. Über die drei Punkte in der Zeile des Nutzers kannst du individuelle Berechtigungen setzen, die unabhängig von der globalen Rolle gelten.
  </Accordion>

  <Accordion title="Was passiert, wenn ich eine Rolle nachträglich ändere?">
    Die Änderung wirkt sich auf alle Nutzer aus, denen diese Rolle zugewiesen ist. Individuelle Berechtigungsanpassungen (über die drei Punkte) bleiben davon unberührt.
  </Accordion>

  <Accordion title="Wie viele Super Admins sollte ein Account haben?">
    Wir empfehlen maximal 1-2 Super Admins pro Account. Alle accountweiten Einstellungen (Nutzerverwaltung, Integrationen, Webhooks, Exporte/Importe) sollten ausschließlich von dieser Rolle verwaltet werden.
  </Accordion>

  <Accordion title="Kann ich Rollen auf Community-Ebene einschränken?">
    Nein. Eingeschränkte Berechtigungen können nur auf Ressourcen-, Gruppen- oder Kategorie-Ebene vergeben werden. Eine Zuordnung auf Community-Ebene ist aktuell nicht möglich.
  </Accordion>

  <Accordion title="Kann ein eingeschränkter Admin Servicegruppen bearbeiten oder löschen?">
    Ja, wenn die Gruppe selbst in seinem Geltungsbereich liegt oder er jede Leistung in der Gruppe bearbeiten darf. Eine leere Gruppe kann ein eingeschränkter Admin nicht ändern.
  </Accordion>

  <Accordion title="Kann ich die Benachrichtigungen anderer Admins ändern?">
    Ja, wenn du die Organisation bearbeiten darfst (Standardrolle Super Admin). Über die drei Punkte in der Zeile wählst du **Benachrichtigungen verwalten**. Details im Artikel [Admin-Benachrichtigungen](/admin-notifications).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein eingeladener Nutzer sieht Ressourcen, die er nicht sehen sollte">
    Prüfe in der Nutzerverwaltung über die drei Punkte, ob die eingeschränkten Berechtigungen korrekt auf die gewünschten Ressourcen gesetzt sind. Ohne aktive Einschränkung hat ein Nutzer mit dem Recht Ansehen auf Ressource-Ebene Zugriff auf alle Ressourcen.
  </Accordion>

  <Accordion title="Die Berechtigungen eines Nutzers werden nach dem Speichern zurückgesetzt">
    Bei aktiver SSO- oder SCIM-Anbindung kann die automatische Nutzerprovisionierung individuelle Berechtigungen überschreiben. Prüfe die Attribute-Mapping-Konfiguration und stelle sicher, dass Rolleninformationen korrekt übergeben werden.
  </Accordion>

  <Accordion title="Beim Einschränken auf eine Gruppe verschwindet die Auswahl">
    Stelle sicher, dass in deinem Account Ressourcengruppen angelegt sind. Die Gruppen-/Kategorie-Auswahl wird nur angezeigt, wenn entsprechende Gruppen existieren.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad zur Nutzerverwaltung: Avatar (oben rechts), dann Admin-Nutzer verwalten
> * Alternativer Einladungsweg: In der Ressourcenübersicht (Menü, Ressourcen) über die drei Punkte einer Ressource können Admins direkt für diese Ressource eingeladen werden. Dort lassen sich E-Mail, Rolle und spezifische Rechte eintragen. Dieser Weg ist nützlich, wenn ein Admin nur eine bestimmte Ressource verwalten soll.
> * Die Berechtigungsstufe Verwalten enthält automatisch ALLE untergeordneten Rechte (Listen, Ansehen, Erstellen, Bearbeiten, Löschen). Eine separate Vergabe ist nicht nötig.
> * Eingeschränkte Berechtigungen sind NUR auf Ressourcen-, Gruppen- oder Kategorie-Ebene möglich, NICHT auf Community-Ebene (häufige Kundenanfrage, Feature in Planung).
> * Servicegruppen update/delete: erlaubt wenn Ability auf der Gruppe, Gruppe im Servicegruppen-Scope, oder Service-Scope deckt jede Leistung der Gruppe. Leere Gruppen bleiben für eingeschränkte Admins gesperrt. Unscoped Service-Admins unverändert.
> * Empfehlung: max. 1-2 (Super-) Admins pro Account. Account-Einstellungen, Nutzerverwaltung, Integrationen, Webhooks und Exporte sollten nur von Super Admins verwaltet werden.
> * Bei SSO/SCIM-Anbindung: Automatische Provisionierung kann individuelle Berechtigungsanpassungen (über drei Punkte) überschreiben.
> * Child-Ressourcen sind in der Ressourcen-Berechtigung enthalten, wenn die übergeordnete Ressource ausgewählt wird.
> * Verwandter Artikel für Nutzereinführung: Einführung für Admin User
> * Default role title is hardcoded **Reception**. New orgs and org duplicates get create/update on invoices plus existing booking/order/customer/scan abilities via `NewOrganizationRoleService::createReceptionRole`. No migration for existing Reception roles.


# Zeitpläne
Source: https://docs.anny.co/schedules

Definiere regelmäßige Öffnungszeiten für deine Ressourcen und steuere saisonale Abweichungen über mehrere Zeitpläne.

Zeitpläne legen fest, wann deine Ressourcen regelmäßig verfügbar sind. Du definierst Wochentage und Uhrzeiten, und anny zeigt nur in diesen Zeitfenstern buchbare Slots an. Über mehrere Zeitpläne mit unterschiedlicher Priorität steuerst du saisonale Abweichungen, ohne bestehende Konfigurationen zu ändern.

<Info>
  Jede Ressource benötigt mindestens einen verbundenen Zeitplan oder einen verfügbaren Termin, damit sie auf der Buchungsseite angezeigt wird.
</Info>

## Wie funktionieren Zeitpläne?

Ein Zeitplan besteht aus einer oder mehreren regelmäßigen Verfügbarkeiten: Wochentag + Start- und Endzeit. Sobald du einen Zeitplan mit einer Ressource verbindest, erzeugt anny daraus die buchbaren Slots gemäß der Buchungsoption (Dauer, Intervall, Puffer).

Zeitpläne können mit mehreren Ressourcen geteilt werden. Änderungen am Zeitplan wirken sich sofort auf alle verbundenen Ressourcen aus.

Optional begrenzt du einen Zeitplan auf einen **Verfügbarkeitszeitraum** (Start- und Enddatum). Ohne Eintrag gilt der Zeitplan dauerhaft.

### Prioritätslogik bei mehreren Zeitplänen

Pro Ressource kannst du mehrere Zeitpläne hinterlegen. Die Reihenfolge bestimmt die Priorität: Zeitpläne weiter oben in der Liste haben Vorrang. Ein Zeitplan mit Verfügbarkeitszeitraum überschreibt in seinem Gültigkeitsfenster die darunterliegenden Zeitpläne. Passe die Reihenfolge per Drag & Drop an.

## Wann nutze ich das?

* **Du hast feste, wiederkehrende Öffnungszeiten (z. B. Mo bis Fr, 9:00 bis 18:00 Uhr)**: Ein einzelner Zeitplan ohne Verfügbarkeitszeitraum deckt das ab.
* **Du brauchst saisonale Abweichungen (z. B. Sommeröffnungszeiten, Ferienzeitraum)**: Lege einen Sonderzeitplan mit Verfügbarkeitszeitraum an und positioniere ihn oberhalb des Standardzeitplans.
* **Mehrere Ressourcen teilen dieselben Zeiten**: Verbinde einen gemeinsamen Zeitplan mit allen betroffenen Ressourcen.
* **Nicht geeignet für**: Einmalige Events, Kurse oder Workshops mit konkretem Datum. Nutze dafür [Verfügbare Termine](/available-slots).

## Zusammenhang mit anderen Features

* **[Service-Zeitpläne](/service-schedules):** Schränken die Verfügbarkeit auf Buchungsoptionsebene zusätzlich ein, ohne die Ressourcen-Zeitpläne zu verändern.
* **[Globale Blocker](/global-blockers):** Sperren mehrere Ressourcen gleichzeitig für einen Zeitraum, unabhängig von Zeitplänen.
* **[Smart Availability](/smart-availability):** Berechnet die kombinierte Verfügbarkeit verbundener Ressourcen dynamisch.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Titel | Aussagekräftiger Name (z. B. "Standardzeiten") |
| Regelmäßige Verfügbarkeit | Wochentag + Start-/Endzeit |
| Verfügbarkeitszeitraum | Optionales Start-/Enddatum |
| Verfügbare Anzahl | Parallele Buchungen pro Slot |
| Verbundene Ressourcen | Ressourcen, die diesen Zeitplan nutzen |

<Tip>
  Du kannst bestehende Zeitpläne mit mehreren Ressourcen verbinden, ohne sie neu anzulegen. Wechsle dafür im Zeitplan zum Reiter **Ressourcen** und füge weitere Ressourcen hinzu.
</Tip>

## Zeitplan erstellen

<Steps>
  <Step title="Ressource öffnen">
    Öffne im Menü **Ressourcen** und wähle die gewünschte Ressource aus. Navigiere zum Reiter **Verfügbarkeit**.
  </Step>

  <Step title="Neuen Zeitplan anlegen">
    Klicke unter **Verbundene Zeitpläne** auf **+ Hinzufügen** und wähle **Neuen Zeitplan erstellen**.
  </Step>

  <Step title="Titel vergeben">
    Gib deinem Zeitplan einen aussagekräftigen Titel (z. B. "Standardzeiten" oder "Sommeröffnungszeiten").
  </Step>

  <Step title="Verfügbarkeit definieren">
    Klicke auf **Regelmäßige Verfügbarkeit hinzufügen** und wähle die gewünschten Wochentage mit Start- und Endzeit aus.
  </Step>

  <Step title="Verfügbarkeitszeitraum festlegen (optional)">
    Falls der Zeitplan nur in einem bestimmten Zeitraum gelten soll, trage Start- und Enddatum im Feld **Verfügbarkeitszeitraum** ein. Ohne Eintrag gilt der Zeitplan dauerhaft.
  </Step>

  <Step title="Speichern">
    Bestätige deine Eingaben mit **Speichern**.
  </Step>
</Steps>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Coworking-Space mit Standardzeiten und Sonderzeitplan für Feiertage">
    Ein Coworking-Space ist regulär Mo bis Fr von 8:00 bis 20:00 Uhr geöffnet. Über Weihnachten gelten verkürzte Zeiten (10:00 bis 16:00 Uhr).

    <Steps>
      <Step title="Standardzeitplan erstellen">
        Öffne die Ressource unter **Ressourcen** → **Verfügbarkeit**. Klicke auf **+ Hinzufügen** → **Neuen Zeitplan erstellen**. Titel: "Standardzeiten". Füge Mo bis Fr, 8:00 bis 20:00 Uhr als regelmäßige Verfügbarkeit hinzu. Speichere ohne Verfügbarkeitszeitraum.
      </Step>

      <Step title="Sonderzeitplan für Feiertage anlegen">
        Klicke erneut auf **+ Hinzufügen** → **Neuen Zeitplan erstellen**. Titel: "Weihnachtszeiten". Füge Mo bis Fr, 10:00 bis 16:00 Uhr hinzu. Trage im Feld **Verfügbarkeitszeitraum** den Ferienzeitraum ein (z. B. 23.12. bis 02.01.).
      </Step>

      <Step title="Reihenfolge anpassen">
        Ziehe den Sonderzeitplan per Drag & Drop oberhalb des Standardzeitplans. Im Ferienzeitraum greift nun automatisch der Sonderzeitplan.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Ein Fitnessstudio mit unterschiedlichen Zeiten wochentags und am Wochenende">
    Ein Fitnessstudio ist Mo bis Fr von 6:00 bis 22:00 Uhr geöffnet und am Wochenende von 8:00 bis 18:00 Uhr.

    <Steps>
      <Step title="Zeitplan erstellen">
        Öffne die Ressource unter **Ressourcen** → **Verfügbarkeit**. Klicke auf **+ Hinzufügen** → **Neuen Zeitplan erstellen**. Titel: "Öffnungszeiten".
      </Step>

      <Step title="Wochentags-Verfügbarkeit hinzufügen">
        Klicke auf **Regelmäßige Verfügbarkeit hinzufügen**. Wähle Mo bis Fr, 6:00 bis 22:00 Uhr.
      </Step>

      <Step title="Wochenend-Verfügbarkeit hinzufügen">
        Klicke erneut auf **Regelmäßige Verfügbarkeit hinzufügen**. Wähle Sa und So, 8:00 bis 18:00 Uhr. Speichere den Zeitplan.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich einen Zeitplan mit mehreren Ressourcen teilen?">
    Ja. Öffne den Zeitplan und wechsle zum Reiter **Ressourcen**. Dort kannst du beliebig viele Ressourcen hinzufügen, die denselben Zeitplan nutzen sollen.
  </Accordion>

  <Accordion title="Was passiert, wenn sich zwei Zeitpläne überschneiden?">
    Der Zeitplan weiter oben in der Liste hat Priorität. Nutze Drag & Drop, um die Reihenfolge anzupassen.
  </Accordion>

  <Accordion title="Brauche ich für Ferien einen eigenen Zeitplan?">
    Ja. Lege einen separaten Zeitplan mit dem entsprechenden Verfügbarkeitszeitraum an und positioniere ihn oberhalb deines Standardzeitplans.
  </Accordion>

  <Accordion title="Wie beeinflusst die 'Verfügbare Anzahl' eines Zeitplans die Buchbarkeit?">
    Die verfügbare Anzahl steuert, wie oft eine Ressource im selben Zeitfenster gleichzeitig gebucht werden kann (Kapazität pro Slot).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Meine Ressource wird auf der Buchungsseite nicht angezeigt">
    Wahrscheinlich ist kein Zeitplan mit der Ressource verbunden. Öffne den Reiter **Verfügbarkeit** und stelle sicher, dass mindestens ein aktiver Zeitplan existiert.
  </Accordion>

  <Accordion title="Der Sonderzeitplan greift nicht wie erwartet">
    Prüfe die Reihenfolge: Der Sonderzeitplan muss oberhalb des Standardzeitplans stehen. Außerdem muss der Verfügbarkeitszeitraum korrekt eingetragen sein.
  </Accordion>

  <Accordion title="Änderungen am Zeitplan wirken sich nicht auf alle Ressourcen aus">
    Stelle sicher, dass die betroffenen Ressourcen tatsächlich mit diesem Zeitplan verbunden sind. Prüfe im Zeitplan den Reiter **Ressourcen**.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> Terminologie: "Öffnungszeiten" = Verbundene Zeitpläne (regelmäßig, wochentags). Zeitpläne heißen "verbunden", sobald sie mit einer Ressource verknüpft sind. Nicht verwechseln mit "Verfügbaren Terminen" (einmalig/seriell mit konkretem Datum) oder "Service-Zeitplänen" (buchungsoptionsspezifische Einschränkung).
>
> UI-Pfad: Ressource → Reiter "Verfügbarkeit" → Bereich "Verbundene Zeitpläne" (oben).
>
> Prioritätslogik: Bei mehreren Zeitplänen entscheidet die Reihenfolge (oben = höhere Priorität). Ein Zeitplan MIT Verfügbarkeitszeitraum überschreibt in seinem Gültigkeitsfenster die darunter liegenden Zeitpläne.
>
> Verfügbare Anzahl: Steuert, wie oft eine Ressource gleichzeitig im selben Zeitfenster gebucht werden kann (Kapazität).
>
> Verwandte Artikel: Verfügbare Termine → /available-slots | Service-Zeitpläne → /service-schedules | Globale Blocker → /global-blockers | Smart Availability → /smart-availability


# SCIM (User Provisioning)
Source: https://docs.anny.co/scim-user-provisioning



SCIM, System for Cross-domain Identity Management, ist ein offener Standard, der es dir ermöglicht, das Nutzerlebenszyklus-Management in Cloud-basierten Anwendungen und Diensten zu automatisieren. In diesem Artikel erklären wir dir, wie du eine SCIM-Integration mit anny durchführst.

## Für wen ist diese Funktion geeignet?

Diese Funktion richtet sich in erster Linie an IT-Admins. Sie ist besonders hilfreich für:

* Automatische Anlage neuer Mitarbeiter:innen, noch bevor diese sich das erste Mal einloggen.
* Sofortigen Entzug von Buchungsrechten, wenn jemand das Unternehmen verlässt.
* Zentrale Verwaltung und Synchronisierung von Profilattributen (wie Abteilungen oder Standorten) direkt aus dem IdP.

SCIM ist ideal für Organisationen, die manuelle Account-Pflege in anny komplett eliminieren und eine "Single Source of Truth" etablieren wollen.

## Was ändert sich durch SCIM?

* **Aus Admin-Sicht:** Du musst anny-Accounts nicht mehr manuell anlegen, anpassen oder deaktivieren. anny spiegelt automatisch den Status deines IdPs.
* **Aus Kund:innen-Sicht:** Nutzer:innen merken von der Umstellung nichts. Ihr Login erfolgt weiterhin über SSO (SAML), aber ihr Profil in anny ist immer auf dem neuesten Stand.

<Warning>
  **Wichtig:** Sobald SCIM aktiv ist, werden Nutzerattribute (wie Name, Abteilung oder Rolle) *ausschließlich* über SCIM übertragen. Das bestehende Attribute Mapping über den regulären SSO-Login (SAML) wird ab diesem Moment von anny ignoriert, da SCIM als alleinige Datenquelle fungiert.
</Warning>

## Wo findest du die Funktion in anny?

Du findest die Konfiguration unter **Account-Einstellungen** > **SSO & Sicherheit**. Voraussetzungen:

* Du hast Admin-Zugriff in anny.
* Du hast Admin-Zugriff auf deinen Identity Provider (z. B. Microsoft Entra).
* Die anny-Anwendung existiert in deinem IdP bereits für den SSO-Login.

![SSO & Sicherheit Übersicht](https://downloads.intercomcdn.eu/i/o/niegcmk9/135498013/746e0bfaebb3e13656f07e9ccc7a/generalsso.png?expires=1784851200\&signature=88a3522d0d6cd269e2870a7c02265e996b98debbe64cc9bdd5914985c7a6bd41\&req=0dZqwVHyrDYrlxv2%2BtxgpiWdkbWYJe%2FUkPzISax6atMagRJ3wjDcjRqo5V7%2B%0ALwvWi1GbNGhJTovnw0PS45lPJw%3D%3D%0A)

<Warning>
  **Wichtig:** Der SCIM-Token wird dir in anny aus Sicherheitsgründen nur ein einziges Mal angezeigt. Kopiere ihn direkt und hinterlege ihn sofort in deinem System. Es gibt keine Schaltfläche, um den Token selbst neu zu erzeugen. Wenn du den Token verloren hast oder erneut brauchst, wende dich an den **anny Support**.
</Warning>

## So funktioniert die Logik

* Dein Identity Provider überwacht Änderungen an den zugewiesenen Nutzer:innen (z. B. neue Abteilung, Account-Sperrung).
* Tritt eine Änderung auf, sendet der IdP diese Info über einen unsichtbaren Kanal (Backchannel) an die SCIM-Schnittstelle von anny.
* anny validiert die Anfrage mithilfe des geheimen Tokens.
* Das Profil in anny wird sofort aktualisiert, völlig unabhängig davon, ob die Person gerade eingeloggt ist.

Durch diesen kontinuierlichen Hintergrundprozess haben beide Systeme stets denselben Datenstand.

## SCIM mit einem generischen IdP einrichten (z. B. Okta, Google)

Das Prinzip ist bei fast allen Anbietern identisch, auch wenn die Menüs anders heißen.

<Steps>
  <Step title="URL und Token kopieren">
    Wähle in anny unter **SSO & Sicherheit** > **SCIM** aus und kopiere URL und Token.
  </Step>

  <Step title="Provisioning-Menü öffnen">
    Öffne das Provisioning-Menü in deiner IdP-Anwendung (oft als "API Integration" oder "App Provisioning" bezeichnet).
  </Step>

  <Step title="Credentials einfügen">
    Füge die Mandanten-URL als "Base URL" und den Token als "API Token" (oder Bearer Token) ein.
  </Step>

  <Step title="Verbindung testen">
    Teste die Verbindung und starte den Sync-Zyklus.
  </Step>
</Steps>

*Ergebnis:* Auch externe oder weniger verbreitete Systeme kommunizieren nun nahtlos mit der anny-Nutzerdatenbank.

## SCIM in Microsoft Entra einrichten

Mit dieser Anleitung richtest du SCIM so ein, dass Microsoft Entra deine Nutzer:innen automatisch für anny bereitstellt.

<Steps>
  <Step title="SCIM in anny öffnen">
    Öffne in anny die **Account-Einstellungen** > **SSO & Sicherheit** und wähle **SCIM** aus.
  </Step>

  <Step title="Mandanten-URL und Token kopieren">
    Kopiere die **Mandanten-URL** sowie den **Token**.
  </Step>

  <Step title="anny-Anwendung in Entra öffnen">
    Öffne in Microsoft Entra die bestehende anny-Anwendung, für die du die Bereitstellung einrichten willst.

    ![anny-Anwendung in Microsoft Entra](https://downloads.intercomcdn.eu/i/o/niegcmk9/135499866/5617750dba9e30465ec5fd89fcb2/scim3.png?expires=1784851200\&signature=85bda47e2c58a413f5b4471e2f18299a5ea7736e4b8c32ada7d2281eed517d3c\&req=0dZqwVHzpDEulxv2%2Btxgpq3QJOuAsNa6wSFg%2BX7sENaKUEBwDxNOs5UiJJCN%0AYJiV3dqaqy8P43G7PHN5rJv8Sw%3D%3D%0A)
  </Step>

  <Step title="Bereitstellung konfigurieren">
    Gehe in den Bereich **Bereitstellung** und starte dort eine neue Konfiguration (oder wähle die vorhandene aus).
  </Step>

  <Step title="Credentials eintragen">
    Trage die kopierte **Mandanten-URL** in das gleichnamige Feld ein und füge den **Token** in das Feld **Geheimes Token** ein.

    ![Mandanten-URL und Token einfügen](https://downloads.intercomcdn.eu/i/o/niegcmk9/135498982/eb8a9e78dab0fe6259bcf3628d8d/scim1.png?expires=1784851200\&signature=4d065e0a291bbb57010928d288a301294576eb41ef222a4c3b51ccbfb3b33110\&req=0dZqwVHypT8qlxv2%2BtxgpibUAYPUFEutS0tRKGhZavxJOaggnAKJWa%2FcErgH%0A4fraGRRuHqd%2FSi6D1xPDTPINdA%3D%3D%0A)
  </Step>

  <Step title="Verbindung testen">
    Klicke auf **Verbindung testen**, um zu prüfen, ob Entra die SCIM-Schnittstelle von anny erreichen kann.
  </Step>

  <Step title="Konfiguration speichern">
    Speichere die Konfiguration, sobald der Test erfolgreich ist.
  </Step>

  <Step title="Bereitstellung starten">
    Aktiviere anschließend die Bereitstellung über den Button **Bereitstellung starten.**

    <img alt="Image" />
  </Step>
</Steps>

Microsoft Entra stellt Nutzer:innen jetzt über SCIM bereit.

<Note>
  **Hinweis:** Die Bereitstellung dauert einige Zeit. Plane etwas Wartezeit ein, bevor du das Ergebnis in anny überprüfst.
</Note>


# SEPA-Lastschrift für Abos
Source: https://docs.anny.co/sepa-direct-debit

Mandat nachträglich zuordnen, auf ein anderes Abo übertragen, Verwendungszweck und warum einzelne Rechnungen nicht eingezogen werden.

SEPA-Lastschrift ist in anny die Online-Zahlungsmethode für **Abos**, nicht für einmalige Buchungen. Stripe zieht fällige Abo-Rechnungen ein, sobald ein gültiges Mandat am Abo hinterlegt ist. Ein Mandat an einer offenen Rechnung löst den Einzug nicht automatisch nachträglich aus.

<Info>
  SEPA-Lastschrift setzt [Online-Zahlung](/online-payments) (Stripe Connect) voraus. Für Einmalbuchungen stehen andere Methoden zur Verfügung, siehe die Tabelle in [Online-Zahlung & Gebühren](/online-payments).
</Info>

## Wie funktioniert SEPA in anny?

1. Kund:in oder Admin hinterlegt ein SEPA-Mandat am Abo (oder überträgt ein bestehendes Mandat).
2. Zum Abrechnungszeitpunkt erzeugt anny die Abo-Rechnung und stößt den Einzug an.
3. Die Zahlung bleibt **ausstehend**, bis Stripe den Einzug abgeschlossen hat. Das dauert in der Regel mehrere Werktage.
4. Schlägt der Einzug fehl (z. B. keine Deckung, Mandat widerrufen), wiederholt anny die Abbuchung **nicht automatisch**.

Auszahlungen an dein Konto brauchen bei SEPA laut Stripe **6 Werktage** Verarbeitungszeit. Details zur Auszahlung stehen unter [Stripe Connect einrichten](/stripe-connect-setup).

## Mandat nachträglich auf eine Rechnung oder ein Abo legen

Ein nachträglich hinterlegtes Mandat gilt für **künftige** Einzüge dieses Abos. Offene Rechnungen werden dadurch nicht von selbst eingezogen. Die Kund:in kann eine offene Rechnung über den Zahlungslink bzw. die Rechnungsübersicht selbst bezahlen.

<Steps>
  <Step title="Abo öffnen">
    Gehe im Admin zu **Abos** und öffne das betroffene Abo.
  </Step>

  <Step title="Zahlungsmethode ändern">
    Wähle **Zahlungsmethode ändern**. Du kannst eine Methode im Namen der Kund:in einrichten oder ein **bestehendes Mandat übertragen**. Die Kund:in muss informiert sein und zugestimmt haben.
  </Step>

  <Step title="Offene Rechnung prüfen">
    Liegt bereits eine unbezahlte Rechnung vor, wird sie durch das Mandat nicht automatisch belastet. Die Kund:in zahlt sie über die offene Rechnung, oder du klärst den offenen Betrag separat.
  </Step>
</Steps>

<Tip>
  Auf der Buchungsseite ändern Kund:innen die Methode unter **Abonnements** → drei Punkte → **Zahlungsmethode aktualisieren**, oder global unter **Profil** → **Zahlungsmethoden**.
</Tip>

## Mandat auf ein neues Abo übertragen

Bestehende Mandate kannst du beim Ändern der Zahlungsmethode auf ein anderes Abo derselben Kund:in übertragen (siehe Schritt oben).

**Abonnement übertragen** (Abo von einer Person auf eine andere) überträgt die Zahlungsmethode **nicht**. Zahlungsmethode und Rechnungs-E-Mail müssen am Ziel-Abo separat gesetzt werden.

## Verwendungszweck

| Kontext | Was auf dem Kontoauszug steht |
| - | - |
| Überweisung durch die Kund:in | Die **Rechnungsnummer**. Bitte Kund:innen, genau diese Nummer als Verwendungszweck anzugeben. |
| SEPA-Einzug über Stripe | Der **Verwendungszweck** deiner Organisation (Account-Einstellungen → Online-Zahlungen, max. 6 Zeichen) mit dem Präfix `anny`. |

Der Verwendungszweck der Organisation erscheint auf dem Kontoauszug der Kund:in, nicht als Freitext pro Rechnung.

## Warum wird Rechnung 10 eingezogen und Rechnung 11 nicht?

Typische Ursachen, wenn eine Abo-Rechnung eingezogen wird und die nächste nicht:

* **Zahlung noch ausstehend:** SEPA bleibt nach dem Anstoß erst einmal im Status ausstehend. Das ist kein Fehlschlag.
* **Einzug fehlgeschlagen:** Keine Deckung oder widerrufenes Mandat. anny unternimmt danach **keine** automatische Wiederholung. Filter in der Abo-Übersicht: **Fehlgeschlagene Zahlung**.
* **Kein Mandat am Abo:** Ohne gültige Zahlungsmethode am Abo entsteht die Rechnung, der Einzug startet nicht.
* **Mandat erst nach Rechnungsstellung hinterlegt:** Gilt nicht rückwirkend für die bereits offene Rechnung.
* **Abo übertragen:** Die Zahlungsmethode ist am neuen Abo nicht automatisch vorhanden.

anny informiert Kund:in und Admin bei fehlgeschlagenem Abo-Einzug. Weitere Einzüge startet anny nicht von selbst. Kontaktiere die Kund:in oder kündige das Abo, wenn der Betrag nicht beigetrieben werden kann.

## Bearbeitungszeiten

| Schritt | Dauer |
| - | - |
| SEPA-Einzug bis zur Bestätigung | Mehrere Werktage, Status zunächst ausstehend |
| Auszahlung an dein Bankkonto | 6 Werktage Verarbeitungszeit bei SEPA |

Kreditkarte und Wallets bestätigen in der Regel sofort. PayPal und TWINT stehen für Abos nicht zur Verfügung.

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich SEPA für eine einzelne Raumbuchung nutzen?">
    Nein. SEPA-Lastschrift ist in anny nur für Abo-Abrechnungen verfügbar.
  </Accordion>

  <Accordion title="Zieht anny fehlgeschlagene Lastschriften automatisch erneut ein?">
    Nein. Nach einem Fehlschlag musst du die offene Rechnung manuell klären oder die Kund:in eine neue Zahlung anstoßen lassen.
  </Accordion>

  <Accordion title="Was passiert mit dem Mandat, wenn ich ein Abo auf eine andere Person übertrage?">
    Zahlungsmethode und Rechnungs-E-Mail werden nicht übertragen. Lege am Ziel-Abo erneut eine Methode an oder übertrage ein bestehendes Mandat der neuen Person.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * SEPA = Stripe `sepa_debit`, nur Abos, nicht Einmalbuchungen. TWINT/PayPal nicht für Abos.
> * UI Admin: **Abos** → **Zahlungsmethode ändern**. Tooltip: bestehendes Mandat kann übertragen werden. Setzt `payment_setup_id`, `is_billed_offline`.
> * Mandat nach Rechnungsstellung zieht die offene Rechnung NICHT automatisch ein. Nova-Aktionen wie ChargeLastInvoice sind support-intern, nicht an Kund:innen dokumentieren.
> * **Abonnement übertragen** überträgt Zahlungsmethode und Billing-E-Mail NICHT (`transferSubscriptionNote`).
> * Verwendungszweck Überweisung = Rechnungsnummer. Stripe-Kontoauszug: Organisations-`statement_descriptor` max. 6 Zeichen, Präfix `anny`.
> * Kein Auto-Retry nach failed subscription charge. Filter **Fehlgeschlagene Zahlung**. Admin-Mail: anny unternimmt keine weiteren Schritte.
> * Auszahlung SEPA: 6 Werktage (siehe /stripe-connect-setup). Pending Refund wartet +1 Tag (`RefundCancellationInvoice`).
> * Gläubiger-ID intern: `DE89ZZZ00002355467` (`config/payment.php`), nicht als Kundenselbstservice bewerben.
> * Verwandte Artikel: /online-payments, /subscriptions-and-memberships, /manage-subscriptions, /invoicing, /stripe-connect-setup


# Service-First Flow
Source: https://docs.anny.co/service-first-flow

Stelle den Service in den Fokus: Kund:innen wählen zuerst die Leistung, dann optional die Ressource.

Mit dem Service-First Flow steht bei einer Buchung die Leistung im Vordergrund. Kund:innen wählen zuerst den Service (z. B. Herrenhaarschnitt, Beratung, Yoga-Kurs) und erst danach, falls erlaubt, die ausführende Person oder Ressource. anny weist die Ressource alternativ automatisch zu.

## Wie funktioniert der Service-First Flow?

Im Gegensatz zum Resource-First Flow (Kund:innen wählen zuerst eine konkrete Ressource, dann die Buchungsoption) dreht der Service-First Flow die Reihenfolge um:

1. Kund:innen sehen auf der Buchungsseite eine Liste aller Services
2. Nach Auswahl eines Services prüft anny die Verfügbarkeit aller verbundenen Ressourcen
3. Je nach Einstellung wird eine Ressource automatisch zugewiesen oder Kund:innen dürfen eine Präferenz wählen
4. Die Buchung wird abgeschlossen

### Zuweisungsstrategien

Wenn Kund:innen keine Ressource manuell auswählen (oder die manuelle Auswahl deaktiviert ist), greift eine der drei Zuweisungsstrategien:

| Strategie | Verhalten |
| - | - |
| First Available | Erste verfügbare Ressource nach definierter Reihenfolge |
| Round Robin | Rotierende Zuweisung für ausgewogene Auslastung |
| Random | Zufällige verfügbare Ressource |

<Tip>
  Mit der Option "Kunde darf Präferenz auswählen" erlaubst du, dass Kund:innen manuell eine Ressource wählen und so die automatische Zuweisung umgehen. Die Verfügbarkeit wird dabei in Echtzeit geprüft und angezeigt.
</Tip>

### Der Service Manager

Alle Services werden zentral im **Service Manager** verwaltet (erreichbar über **Services** in der Menüleiste). Dort kannst du:

* Services erstellen, bearbeiten und gruppieren
* Die Reihenfolge per Drag & Drop anpassen
* Services auf der Buchungsseite ein- oder ausblenden (Globus-Icon)
* Über die drei Punkte den Service direkt auf der Buchungsseite anzeigen lassen

### Buchungsseite umstellen

Die Umstellung erfolgt über **Avatar** → **Account-Einstellungen** → Reiter **Einstellungen**:

| Einstellung | Beschreibung |
| - | - |
| Standard-Reiter auf Buchungsseite | Services oder Ressourcen als ersten Reiter festlegen |
| Gliederung von Ressourcen nach | Ressourcen in Kategorien oder Gruppen gliedern |
| Ressourcen auf Buchungsseite anzeigen | Reiter "Ressourcen" ein- oder ausblenden |
| Services auf Buchungsseite anzeigen | Reiter "Services" ein- oder ausblenden |

<Tip>
  Je nach Einstellung ändert sich die URL deiner Buchungsseite. Wenn du Services als Standard-Reiter wählst, landen Kund:innen direkt auf der Service-Übersicht.
</Tip>

## Wann nutze ich das?

Wähle den Flow danach, **was Kund:innen zuerst entscheiden**.

| | Service-First | Resource-First |
| - | - | - |
| Kund:innen wählen zuerst | Die Leistung (Haarschnitt, Beratung, Anliegen) | Das konkrete Objekt (Raum 3, Platz A12, Fahrzeug) |
| Typische Angebote | Friseur, Massage, Coaching, Behördentermine | Meetingräume, Sportplätze, Schreibtische, Equipment |
| Ressource | Wird automatisch zugewiesen oder optional als Präferenz gewählt | Muss bewusst ausgewählt werden |
| Sichtbarkeit | Nur auf der **Organisations-Buchungsseite** unter `/explore/{org}/services` | Auf der Organisations-Buchungsseite **und** auf der globalen **Entdecken**-Seite |

**Wichtig:** Die globale Explore-Seite (**Entdecken** ohne Organisation) listet nur Ressourcen. Services erscheinen dort nicht. Wenn du Dienstleistungen verkaufst, müssen Kund:innen über den Organisationslink oder den Reiter **Services** auf deiner Buchungsseite einsteigen.

* **Du bietest Dienstleistungen an, die von verschiedenen Personen erbracht werden können** (z. B. Friseur, Massage, Coaching): Kund:innen wählen die Leistung, die Person ist zweitrangig oder wird automatisch zugewiesen
* **Du betreibst eine Behörde oder Beratungsstelle mit verschiedenen Anliegen** (z. B. Personalausweis, Meldebescheinigung): Kund:innen wählen ihr Anliegen, der zuständige Sachbearbeiter wird automatisch zugewiesen
* **Du möchtest die Auslastung gleichmäßig verteilen**: Die Zuweisungsstrategien Round Robin oder Random sorgen automatisch für eine ausgeglichene Verteilung
* **Nicht geeignet für**: Szenarien, in denen Kund:innen ein konkretes Objekt belegen möchten (z. B. einen bestimmten Raum, ein spezifisches Fahrzeug, einen Sportplatz). Hier ist der Resource-First Flow die bessere Wahl.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Smart Availability | Verbinde mehrere Ressourcen mit einem Service für kombinierte Verfügbarkeitsprüfung (z. B. Trainer + Raum) |
| [Buchungssequenzen](/booking-sequences) | Lasse Kund:innen mehrere Services hintereinander in einer Buchung kombinieren. Zahlung, MwSt. und Zeitraum müssen dabei gleich sein. |
| Communities | Schränke den Zugang zu bestimmten Services auf Mitglieder ein |

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Name | Anzeigename des Services auf der Buchungsseite |
| Gruppe | Interne Organisationseinheit, steuert Gliederung |
| URL-Endung | Individuelle URL für den Service |
| Beschreibung | Freitext mit Toolbar (Bilder, Videos, Tabellen, @-Verlinkungen) |
| Bild | Visualisierung auf der Buchungsseite |
| Zuweisungsstrategie | First Available, Round Robin oder Random |
| Kunde darf Präferenz auswählen | Manuelle Ressourcenwahl durch Kund:innen erlauben |
| Verbundene Ressourcen | Ressourcen, die den Service erbringen |

Auf der Buchungsseite sehen Kund:innen zusätzlich den Button "Präferenzen", über den sie (falls erlaubt) die gewünschte Ressource auswählen können.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Friseursalon lässt Kund:innen zuerst den Service wählen">
    Ein Friseursalon mit 3 Mitarbeitenden möchte, dass Kund:innen zuerst die gewünschte Leistung wählen und dann optional eine:n Friseur:in auswählen können. Die Auslastung soll gleichmäßig verteilt werden.
  </Accordion>

  <Accordion title="Eine Stadtverwaltung bietet Terminvereinbarungen für verschiedene Anliegen">
    Eine Stadtverwaltung möchte, dass Bürger:innen online Termine für verschiedene Anliegen buchen können. Die Zuweisung zum zuständigen Sachbearbeiter soll automatisch erfolgen.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Service-First und Resource-First?">
    Beim Resource-First Flow wählen Kund:innen zuerst eine konkrete Ressource (z. B. Raum, Gerät) und dann die Buchungsoption. Beim Service-First Flow wählen sie zuerst die Leistung und dann (optional) die Ressource. Die Wahl hängt davon ab, ob das Objekt oder die Leistung im Vordergrund steht. Services stehen nicht auf der globalen Entdecken-Seite.
  </Accordion>

  <Accordion title="Warum sehe ich Services nicht unter Entdecken?">
    Die globale **Entdecken**-Seite (`/explore`) zeigt nur Ressourcen über Organisationen hinweg. Services erscheinen ausschließlich auf der Buchungsseite deiner Organisation unter `/explore/{dein-org-slug}/services`.
  </Accordion>

  <Accordion title="Kann ich beide Flows gleichzeitig auf der Buchungsseite anzeigen?">
    Ja. Du kannst sowohl den Reiter "Services" als auch "Ressourcen" einblenden. Kund:innen können dann zwischen beiden Ansichten wechseln. Über den Standard-Reiter bestimmst du, welche Ansicht zuerst angezeigt wird.
  </Accordion>

  <Accordion title="Was passiert, wenn alle Ressourcen eines Services ausgebucht sind?">
    Der Service wird auf der Buchungsseite als nicht verfügbar für den jeweiligen Zeitraum angezeigt. Kund:innen können keinen Termin für diesen Zeitslot buchen.
  </Accordion>

  <Accordion title="Können verschiedene Services unterschiedliche Zuweisungsstrategien haben?">
    Ja. Die Zuweisungsstrategie wird pro Service festgelegt. Du kannst also für einen Service "Round Robin" und für einen anderen "First Available" verwenden.
  </Accordion>

  <Accordion title="Brauche ich ein bestimmtes Feature oder einen bestimmten Plan?">
    Der Service-First Flow ist in allen Plänen verfügbar. Für die Verknüpfung mehrerer Ressourcen mit einem Service muss das Feature **Smart Availability** aktiviert sein.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Reiter 'Services' wird auf der Buchungsseite nicht angezeigt">
    Prüfe unter **Account-Einstellungen** → **Buchungsseite**, ob "Services auf Buchungsseite anzeigen" aktiviert ist. Zusätzlich muss mindestens ein Service im Service Manager auf der Buchungsseite sichtbar sein (Globus-Icon aktiv).
  </Accordion>

  <Accordion title="Die automatische Zuweisung funktioniert nicht wie erwartet">
    Stelle sicher, dass die verbundenen Ressourcen verfügbar sind und ihre Zeitpläne mit dem Service kompatibel sind. Bei "First Available" ist die Reihenfolge der verbundenen Ressourcen entscheidend: sie wird nach der definierten Reihenfolge im Service gewählt.
  </Accordion>

  <Accordion title="Kund:innen können keine Präferenz wählen, obwohl die Option aktiviert ist">
    Prüfe, ob die Ressourcen korrekt mit dem Service verbunden sind und ob sie im relevanten Zeitraum verfügbar sind. Der Präferenz-Button erscheint nur, wenn mindestens eine Ressource verfügbar ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Service-First Flow wird über **Avatar** → **Account-Einstellungen** → Reiter **Einstellungen** aktiviert (Standard-Reiter auf **Services** umstellen, **Services auf Buchungsseite anzeigen**)
> * Org-URL ist `/explore/{orgSlug}` (nicht `/book/{org}`). Services: `/explore/{orgSlug}/services`. Resource-Detail: `/book/{resourceSlug}`. Service-Detail: `/services/{serviceSlug}`.
> * Globale Explore-Seite `/explore` lädt nur Ressourcen (`all-resources`). Kein Services-Reiter, keine `all-services`-Abfrage.
> * Zuweisungsstrategien: First Available (nach definierter Reihenfolge), Round Robin (rotierende Auslastung), Random (zufällig)
> * "Kunde darf Präferenz auswählen" = Kund:in kann optional eine Ressource manuell auswählen, umgeht dadurch die automatische Zuweisung
> * Service-First setzt voraus: mindestens ein Service mit verbundener Ressource; der Ressourcen-Reiter in der Service-Konfiguration braucht **Smart Availability**
> * Reiter "Services" kann auf der Buchungsseite ein- oder ausgeblendet werden, ebenso "Ressourcen"
> * Tab-Titel können individuell angepasst werden (max. 20 Zeichen)
> * Kalenderansichten (Tag/Woche/Board/Monat) gibt es nur auf dem Ressourcen-Reiter. Services werden als Raster/Liste gezeigt.


# Service-Zeitpläne
Source: https://docs.anny.co/service-schedules

Grenze die Verfügbarkeit einer Buchungsoption zeitlich weiter ein, ohne die Ressourcen-Verfügbarkeit zu verändern.

Mit Service-Zeitplänen grenzt du die Verfügbarkeit einer Buchungsoption zusätzlich zur Ressourcen-Verfügbarkeit ein. Buchungen werden nur zugelassen, wenn sowohl die Ressource als auch der Service verfügbar ist. So kannst du verschiedene Buchungsoptionen an derselben Ressource zu unterschiedlichen Zeiten anbieten.

<Info>
  Aktiviere vorab **Service Verfügbarkeiten** unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktionieren Service-Zeitpläne?

Service-Zeitpläne wirken als zusätzliche Filterebene auf die Grundverfügbarkeit der Ressource. Sie können die Verfügbarkeit nur weiter einschränken, nicht erweitern.

Das Grundprinzip:

1. Die Ressource definiert die Grundverfügbarkeit (z. B. Mo-So 08:00-20:00).
2. Der Service-Zeitplan schränkt ein, wann diese konkrete Buchungsoption innerhalb der Ressourcen-Verfügbarkeit buchbar ist (z. B. nur Mo-Fr 09:00-18:00).
3. Ergebnis: Die Buchungsoption ist nur in der Schnittmenge beider Zeiträume verfügbar.

Du findest die Einstellung in der Buchungsoption unter dem Reiter **Zeitpläne**. Dort kannst du regelmäßige Zeitpläne (wiederkehrende Wochentage mit Start- und Endzeit) oder verfügbare Termine (einzelne Datumswerte) anlegen.

<Warning>
  Service-Zeitpläne können die Verfügbarkeit der Ressource nicht erweitern. Wenn die Ressource an einem Tag nicht verfügbar ist, hilft auch ein Service-Zeitplan für diesen Tag nicht.
</Warning>

## Wann nutze ich das?

* **Du hast mehrere Buchungsoptionen mit unterschiedlichen Zeiten an derselben Ressource**: z. B. eine Standard-Option Mo-Fr und eine Premium-Option nur Di/Do nachmittags.
* **Du möchtest bestimmte Services zeitlich begrenzen**: z. B. ein Kursangebot nur vormittags, obwohl der Raum ganztägig verfügbar ist.
* **Du brauchst Mittagspausen für einen Service**: Lege denselben Tag zweimal an (z. B. Mo 09:00-12:00 und Mo 13:00-18:00).
* **Nicht geeignet für**: Die generelle Verfügbarkeit einer Ressource ändern. Dafür nutze die Zeitpläne auf Ressourcenebene (**Ressource** → **Verfügbarkeit** → **Zeitpläne**).

## Zusammenhang mit anderen Features

* **Ressourcen-Zeitpläne**: Definieren die Grundverfügbarkeit. Service-Zeitpläne sind eine zusätzliche Schicht darüber.
* **Globale Blocker**: Sperren Zeiträume komplett für alle Services. Service-Zeitpläne steuern dagegen die Verfügbarkeit pro Buchungsoption.
* **Buchungsregeln**: Limitieren die Anzahl der Buchungen. Service-Zeitpläne steuern, wann gebucht werden kann.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Wochentag | Tag, an dem der Service verfügbar ist |
| Startzeit | Beginn der Verfügbarkeit an diesem Tag |
| Endzeit | Ende der Verfügbarkeit an diesem Tag |

Die Einstellungen findest du unter **Buchungsoption** oder **Services** → Reiter **Zeitpläne**.

<Tip>
  Einzelne Tage können mehrfach angelegt werden. Nutze das, um Mittagspausen abzubilden: z. B. Montag 09:00-12:00 und Montag 13:00-18:00.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Ski-Verleih bietet eine Buchungsoption nur Mo-Fr an">
    Ein Ski-Verleih hat seine Ressource (Station) Mo-So geöffnet, möchte aber den Tagespass nur unter der Woche anbieten. Am Wochenende gilt ein separater Wochenend-Tarif.

    <Steps>
      <Step title="Feature aktivieren">
        Öffne **Account-Einstellungen** → **Features** und aktiviere **Service Verfügbarkeiten**.
      </Step>

      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen** → die betreffende Ressource → Buchungsoption **Tagespass**.
      </Step>

      <Step title="Zeitpläne konfigurieren">
        Wechsle zum Reiter **Zeitpläne**. Trage unter **Regelmäßige Zeitpläne** für Montag bis Freitag jeweils 09:00-18:00 ein.
      </Step>

      <Step title="Speichern">
        Klicke auf **Speichern**. Der Tagespass ist jetzt nur noch Mo-Fr buchbar, obwohl die Ressource auch am Wochenende verfügbar ist.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Ein Beratungsunternehmen bietet Premium-Consultation nur Di/Do nachmittags an">
    Ein Beratungsunternehmen hat seine Berater:innen Mo-Fr ganztägig verfügbar, möchte die Premium-Beratung aber nur dienstags und donnerstags nachmittags anbieten.

    <Steps>
      <Step title="Feature aktivieren">
        Öffne **Account-Einstellungen** → **Features** und aktiviere **Service Verfügbarkeiten** (falls noch nicht aktiv).
      </Step>

      <Step title="Buchungsoption öffnen">
        Öffne **Ressourcen** → die betreffende Ressource → Buchungsoption **Premium Consultation**.
      </Step>

      <Step title="Zeitpläne konfigurieren">
        Wechsle zum Reiter **Zeitpläne**. Trage unter **Regelmäßige Zeitpläne** Dienstag 14:00-18:00 und Donnerstag 14:00-18:00 ein.
      </Step>

      <Step title="Speichern">
        Klicke auf **Speichern**. Die Premium-Beratung ist jetzt ausschließlich Di und Do nachmittags buchbar.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was passiert, wenn ich keinen Service-Zeitplan anlege?">
    Ohne Service-Zeitplan gilt die volle Ressourcen-Verfügbarkeit für diese Buchungsoption. Der Service ist dann immer buchbar, wenn die Ressource verfügbar ist.
  </Accordion>

  <Accordion title="Kann ich mit Service-Zeitplänen die Ressource am Wochenende verfügbar machen?">
    Nein. Service-Zeitpläne können die Verfügbarkeit nur einschränken, nicht erweitern. Wenn die Ressource am Wochenende nicht verfügbar ist, kann der Service dort auch nicht gebucht werden.
  </Accordion>

  <Accordion title="Kann ich pro Zeitfenster ein Kontingent festlegen?">
    Ja. Über das Feld **Anzahl** kannst du optional definieren, wie viele Buchungen pro Zeitfenster maximal möglich sind.
  </Accordion>

  <Accordion title="Was ist der Unterschied zu Zeitplänen auf Ressourcenebene?">
    Ressourcen-Zeitpläne definieren, wann die Ressource grundsätzlich verfügbar ist. Service-Zeitpläne grenzen zusätzlich ein, wann eine bestimmte Buchungsoption innerhalb dieser Grundverfügbarkeit buchbar ist.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Reiter 'Zeitpläne' wird in meiner Buchungsoption nicht angezeigt">
    Prüfe, ob das Feature **Service Verfügbarkeiten** unter **Account-Einstellungen** → **Features** aktiviert ist. Ohne Aktivierung erscheint der Reiter nicht.
  </Accordion>

  <Accordion title="Mein Service-Zeitplan wird ignoriert und die Buchungsoption ist trotzdem ganztägig buchbar">
    Prüfe, ob du den Zeitplan an der richtigen Buchungsoption konfiguriert hast. Öffne die Buchungsoption und prüfe unter dem Reiter **Zeitpläne**, ob Einträge vorhanden und gespeichert sind.
  </Accordion>

  <Accordion title="Kund:innen können in der Mittagspause buchen">
    Lege den betroffenen Tag zweimal an: einmal für den Vormittag (z. B. 09:00-12:00) und einmal für den Nachmittag (z. B. 13:00-18:00). So entsteht eine Lücke, in der keine Buchung möglich ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Account-Einstellungen** → **Features** → **Service Verfügbarkeiten** aktivieren. Dann: **Buchungsoption** oder **Services** → Reiter **Zeitpläne**
> * Kernlogik: Service-Zeitpläne GRENZEN die Ressourcen-Verfügbarkeit WEITER EIN. Buchungen werden nur zugelassen, wenn sowohl Ressource ALS AUCH Service verfügbar ist.
> * Service-Zeitpläne können die Verfügbarkeit der Ressource NICHT erweitern.
> * Abgrenzung: Ressourcen-Zeitpläne definieren die Grundverfügbarkeit. Service-Zeitpläne sind eine zusätzliche Filterebene darüber.
> * Einzelne Tage können mehrfach angelegt werden (z. B. für Mittagspausen: Mo 09:00-12:00 + Mo 13:00-18:00).
> * Optional: Anzahl pro Zeitfenster (Kontingent auf Zeitslot-Ebene).
> * Verfügbar in allen Plänen (Feature muss unter Features aktiviert werden).


# Smart Availability
Source: https://docs.anny.co/smart-availability

Verbinde Ressourcen miteinander, damit bei einer Buchung automatisch alle abhängigen Ressourcen blockiert werden.

Mit Smart Availability machst du mehrere Ressourcen voneinander abhängig, ohne dass Kund:innen diese im Buchungsprozess extra auswählen müssen. Bei einer Buchung prüft anny automatisch die kombinierte Verfügbarkeit und blockiert alle verbundenen Ressourcen. Mit Smart Availability Groups erweiterst du das Prinzip um gruppierte Abhängigkeiten für komplexere Setups.

<Info>
  Aktiviere das Feature vorab unter **Avatar** (oben rechts) → **Account-Einstellungen** → **Features** → **Smart Availability**.
</Info>

## Wie funktioniert Smart Availability?

### Klassische Abhängigkeiten (verbundene Ressourcen)

Du verbindest Ressourcen über den Tab **Ressourcen** in einer Buchungsoption. Unter **Abhängigkeiten** fügst du per Drag & Drop oder über **+ Hinzufügen** weitere Ressourcen hinzu. Bei einer Buchung werden alle verbundenen Ressourcen automatisch blockiert, ohne dass Kund:innen sie sehen oder auswählen müssen.

Voraussetzung: Die verbundenen Ressourcen müssen übereinstimmende Verfügbarkeitszeiten und Buchungsoptionen haben.

### Smart Availability Groups

Smart Availability Groups erweitern die klassische Logik um **Pools von Ressourcen**. Statt feste Abhängigkeiten zu blockieren, definierst du Gruppen, aus denen anny automatisch passende verfügbare Ressourcen auswählt.

Für jede Gruppe gilt:

* Zum gewünschten Zeitpunkt muss **mindestens eine Ressource aus der Gruppe** verfügbar sein
* Bei der Buchung reserviert anny automatisch **pro Gruppe eine passende Ressource**
* Dieselbe Ressource wird innerhalb derselben Buchung **nicht doppelt belegt**

Ressourcen können gleichzeitig als verbundene Ressourcen am Service hängen und zusätzlich innerhalb einer Gruppe referenziert werden. Ziehe sie per Drag & Drop in die entsprechende Gruppe.

### Was passiert im Kalender?

Reservierte abhängige Ressourcen werden automatisch über **Subbuchungen** blockiert. Die mitreservierten Ressourcen sind in den jeweiligen Ressourcen-Kalendern sichtbar und für andere Buchungen gesperrt.

### Wie entstehen die Startzeiten?

anny bildet die **gemeinsame Öffnungszeit** aller Ressourcen, die für die Buchung nötig sind: die gewählte Ressource unter **Verbundene Ressourcen** plus alles unter **Abhängigkeiten - Alle müssen verfügbar sein**. Bei einer **Gruppe  - Eine muss verfügbar sein** reicht die Überschneidung mit mindestens einem Gruppenmitglied.

Das [Buchungsintervall](/configure-booking-option) zählt dann **ab dem ersten gemeinsamen Zeitpunkt**, nicht ab der vollen Stunde.

Beispiel: Die verbundene Ressource ist von 09:00–18:00 geöffnet, eine Abhängigkeit von 10:30–20:00. Die gemeinsame Verfügbarkeit beginnt um **10:30**. Bei einem Intervall von 60 Minuten erscheinen 10:30, 11:30, 12:30 — nicht 10:00, 11:00, 12:00.

Hängen mehrere Ressourcen unter **Verbundene Ressourcen**, berechnet anny für jede ein eigenes Fenster und zeigt die Vereinigung. Deshalb können auf derselben Buchungsseite volle Stunden und halbe Stunden nebeneinander stehen: eine Trainerin ab 10:00 erzeugt 10:00, 11:00, 12:00; eine Abhängigkeit oder eine zweite Trainerin, deren gemeinsames Fenster um 12:30 beginnt, erzeugt zusätzlich 12:30, 13:30.

Eine echte Lücke (zum Beispiel Mittagspause) startet danach ein neues Fenster und damit ein neues Raster.

## Wann nutze ich das?

* **Du hast teilbare Räume** (z. B. Trennwand entfernen = großer Raum): Verbinde die Teilräume als Abhängigkeiten des Gesamtraums.
* **Du brauchst mehrere Ressourcentypen gleichzeitig** (z. B. 2 Mitarbeitende + 1 Raum): Nutze Smart Availability Groups mit je einem Pool pro Typ.
* **Du hast Geräte-Pools, die automatisch zugewiesen werden sollen**: Lege eine Gruppe mit allen verfügbaren Geräten an.
* **Kund:innen sollen die Abhängigkeiten nicht sehen**: Verbundene Ressourcen werden im Buchungsprozess ausgeblendet (durchgestrichenes Auge).
* **Nicht geeignet für**: Optionale Zusatzleistungen, die Kund:innen selbst wählen sollen. Dafür nutze [Zusatzoptionen](/add-ons).

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Verbundene Ressourcen | Alle mit der Buchungsoption verbundenen Ressourcen |
| Abhängigkeiten | Weitere Ressourcen, die bei Buchung automatisch blockiert werden |
| Sichtbarkeit (Auge) | Abhängige Ressourcen für Kund:innen ausblenden |
| Smart Availability Groups | Pools von Ressourcen, aus denen anny automatisch wählt |
| Subbuchungen | Reservierungen erscheinen als Blocker in Ressourcen-Kalendern |

<Warning>
  Einzelne Child-Ressourcen können nicht als Abhängigkeit ausgewählt werden. Verwende dieselbe Ressource nicht in mehr als zwei Gruppen gleichzeitig.
</Warning>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Teilbarer Meetingraum: Zwei kleine Räume oder ein großer">
    Ein Büro hat zwei Meetingräume (Wolke und Meer), die durch eine Trennwand getrennt sind. Ohne Trennwand entsteht ein großer Raum (Waldhütte). Wird Waldhütte gebucht, sollen Wolke und Meer automatisch blockiert werden.

    <Steps>
      <Step title="Drei Ressourcen anlegen">
        Erstelle drei Ressourcen: "Meetingraum Wolke", "Meetingraum Meer" und "Meetingraum Waldhütte" mit übereinstimmenden Verfügbarkeitszeiten.
      </Step>

      <Step title="Buchungsoption öffnen">
        Öffne die Buchungsoption des großen Raums "Waldhütte" und wechsle zum Tab **Ressourcen**.
      </Step>

      <Step title="Abhängigkeiten hinzufügen">
        Füge unter **Abhängigkeiten** die Ressourcen "Wolke" und "Meer" per Drag & Drop oder **+ Hinzufügen** hinzu.
      </Step>

      <Step title="Testen">
        Buche den Meetingraum Waldhütte und prüfe im Admin-Kalender, ob Wolke und Meer automatisch als Blocker erscheinen.
      </Step>
    </Steps>

    <Warning>
      Hänge den Gesamtraum **nicht** als Abhängigkeit an die Buchungsoptionen der Teilräume. Dann setzt jede Hälfte den Gesamtraum voraus. Sobald eine Hälfte gebucht ist, gilt der Gesamtraum als belegt — und die andere Hälfte ist auf der Buchungsseite nicht mehr buchbar, auch wenn sie im Admin-Kalender frei wirkt.
    </Warning>
  </Accordion>

  <Accordion title="Paarmassage mit Smart Availability Groups">
    Ein Wellness-Studio bietet eine Paarmassage an, für die 2 unterschiedliche Mitarbeitende und 1 Behandlungsraum gleichzeitig verfügbar sein müssen.

    <Steps>
      <Step title="Service anlegen">
        Erstelle den Service "Paarmassage" und hinterlege alle qualifizierten Mitarbeitenden als **verbundene Ressourcen**.
      </Step>

      <Step title="Gruppe 1: Zweiter Mitarbeitender">
        Erstelle unter **Abhängigkeiten** eine Smart Availability Group "Zweiter Mitarbeitender" und füge alle qualifizierten Mitarbeitenden hinzu.
      </Step>

      <Step title="Gruppe 2: Behandlungsraum">
        Erstelle eine zweite Gruppe "Räume" und füge alle passenden Behandlungsräume hinzu.
      </Step>

      <Step title="Testen">
        Buche die Paarmassage und prüfe, ob anny automatisch 2 unterschiedliche Mitarbeitende und 1 Raum reserviert. Alle Reservierungen sollten in den jeweiligen Kalendern als Subbuchungen sichtbar sein.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen klassischer Smart Availability und Groups?">
    Klassische Smart Availability blockiert feste abhängige Ressourcen. Groups definieren Pools, aus denen anny automatisch verfügbare Ressourcen auswählt. Groups sind für flexiblere Setups mit mehreren Rollen oder Ressourcentypen gedacht.
  </Accordion>

  <Accordion title="Kann dieselbe Ressource in einer Buchung doppelt verwendet werden?">
    Nein. anny verhindert, dass dieselbe Ressource innerhalb derselben Buchung doppelt belegt wird.
  </Accordion>

  <Accordion title="Können Ressourcen gleichzeitig verbunden und Teil einer Gruppe sein?">
    Ja. Ressourcen können sowohl als verbundene Ressourcen am Service hängen als auch zusätzlich innerhalb einer Smart Availability Group verwendet werden.
  </Accordion>

  <Accordion title="Warum ist ein Teilraum auf der Buchungsseite nicht buchbar, obwohl er im Kalender frei ist?">
    Prüfe die Buchungsoption des Teilraums: Steht der Gesamtraum unter **Abhängigkeiten**, setzt diese Buchung den Gesamtraum voraus. Eine Buchung der anderen Hälfte blockiert den Gesamtraum und damit auch diesen Teilraum. Entferne den Gesamtraum aus den Abhängigkeiten der Teilräume. Der Gesamtraum soll die Teilräume blockieren, nicht umgekehrt.
  </Accordion>

  <Accordion title="Warum wurden bei einer Admin-Buchung keine abhängigen Ressourcen mitgebucht?">
    Wenn beim Erstellen der Buchung die Option **Verfügbarkeit prüfen** deaktiviert ist, werden abhängige Ressourcen nicht automatisch mitgebucht.
  </Accordion>

  <Accordion title="Funktioniert Smart Availability mit wiederkehrenden Buchungen?">
    Ja. Seit Juni 2026 werden wiederkehrende Buchungen vollständig unterstützt, inklusive Smart Availability, Pricing und Quota-Berechnung pro Termin.
  </Accordion>

  <Accordion title="Warum startet das Buchungsintervall nicht zur vollen Stunde?">
    Das Intervall zählt ab dem ersten gemeinsamen Zeitpunkt, nicht ab 00-Minuten. Liegt die Überschneidung bei 10:30, folgen 10:30, 11:30, 12:30 — auch bei 60 Minuten Intervall. Details stehen unter [Wie entstehen die Startzeiten?](#wie-entstehen-die-startzeiten).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Buchung ist nicht möglich, obwohl Ressourcen vorhanden sind">
    Prüfe, ob in jeder Smart Availability Group mindestens eine Ressource zum gewünschten Zeitpunkt verfügbar ist. Alle Gruppen müssen erfüllt sein.
  </Accordion>

  <Accordion title="Zwei Teilräume blockieren sich gegenseitig">
    Das passiert, wenn beide Teilräume den Gesamtraum als Abhängigkeit voraussetzen. Richtig ist: nur die Buchungsoption des **Gesamtraums** listet die Teilräume unter **Abhängigkeiten**.
  </Accordion>

  <Accordion title="Eine Ressource wurde nicht automatisch mitgebucht">
    Prüfe, ob es sich um eine Admin-Buchung mit deaktivierter Option "Verfügbarkeit prüfen" handelt. In diesem Fall werden abhängige Ressourcen bewusst nicht mitgebucht.
  </Accordion>

  <Accordion title="Ich sehe zusätzliche Blockierungen in den Ressourcen-Kalendern">
    Das ist erwartetes Verhalten. Abhängige Ressourcen werden automatisch über Subbuchungen reserviert und in den jeweiligen Kalendern sichtbar gemacht.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature aktivieren: **Avatar** → **Account-Einstellungen** → **Features** → **Smart Availability**
> * UI-Pfad: **Buchungsoption** → Tab **Ressourcen** → **Abhängigkeiten**
> * Klassische Smart Availability: feste Abhängigkeit, blockiert verbundene Ressourcen bei Buchung
> * Smart Availability Groups: gruppierte Abhängigkeiten, pro Gruppe mindestens eine Ressource verfügbar, anny wählt automatisch
> * Keine einzelnen Child-Ressourcen als Abhängigkeit auswählbar
> * Dieselbe Ressource nicht in mehr als zwei Gruppen verwenden
> * Admin-Buchungen mit deaktivierter Verfügbarkeitsprüfung: abhängige Ressourcen werden NICHT mitgebucht
> * Subbuchungen: reservierte abhängige Ressourcen erscheinen als Blocker in den jeweiligen Kalendern
> * Smart Availability ≠ Zusatzoptionen: SA blockiert transparent im Hintergrund, Zusatzoptionen sind sichtbar für Kund:innen
> * Wiederkehrende Buchungen mit SA: seit 06/2026 vollständig unterstützt (Pricing, Quota, per-appointment)
> * Ressourcen per Drag & Drop in Gruppen ziehen, wenn sie sowohl verbunden als auch in einer Gruppe sein sollen
> * Teilbare Räume: nur die Buchungsoption des Gesamtraums hängt die Teilräume als Abhängigkeiten an. Umgekehrt (Teilraum setzt Gesamtraum voraus) blockieren sich die Hälften gegenseitig — das ist erwartetes Verhalten, kein Bug. Admin-Kalender zeigt dann oft den leeren Teilraum als frei, die Buchungsseite nicht.
> * Startzeiten: Intervall ab dem ersten gemeinsamen Zeitpunkt der Schnittmenge, nicht clock-aligned. Mehrere verbundene Ressourcen = Vereinigung mehrerer Fenster (volle und halbe Stunden können gemischt erscheinen). Echte Lücke startet neues Raster. Gruppen-Attribution-Splits ohne Lücke sollen kein Extra-Start erzeugen (bookings-api#376).
> * Verwandte Artikel: /add-ons, /configure-booking-option, /wiederkehrende-buchungen


# SSO Key Rollover
Source: https://docs.anny.co/sso-key-rollover



Beim SAML SSO werden zwischen dem Service Provider (anny) und dem Identity Provider (z.B. Microsoft) Zertifikate ausgetauscht. Diese Zertifikate sind essentiell für die sichere Authentifizierung beim SSO. Mit den Zertifikaten wird der Austausch von Daten zwischen Service Provider und Identity Provider signiert. Beide Parteien können die Signatur überprüfen, um sicherzustellen, dass die Anfrage nicht kompromittiert ist.

## Key Rollover Erklärung

Diese Zertifikate werden bei der Einrichtung über die Metadaten ausgetauscht. Jedes Zertifikat hat ein bestimmtes Ablaufdatum. Ist dieses erreicht, ist das Zertifikat nicht mehr gültig. Alle Anfragen werden abgelehnt, welche mit einem abgelaufenen Zertifikat signiert sind.

Damit weiterhin ein Login möglich ist, wird regelmäßig ein Key Rollover durchgeführt. Das läuft in zwei Schritten ab.

**Schritt 1: Es wird ein neues Zertifikat erstellt und veröffentlicht**

Zu diesem Zeitpunkt sind beide Zertifikate gültig und der Identity Provider oder der Service Provider kann das neue Zertifikat speichern. Es werden weiterhin Anfragen mit dem bestehenden Zertifikat signiert. Dadurch kommt es zu keiner Unterbrechung.

**Schritt 2: Das alte Zertifikat wird nicht mehr verwendet**

Nach einer Karenzzeit wird das alte Zertifikat nicht mehr verwendet und nicht mehr in den Metadaten veröffentlicht. Alle Anfragen werden nun mit dem neuen Zertifikat signiert. Der Service Provider oder Identity Provider hat in der Zwischenzeit dieses Zertifikat bereits hinterlegt.

So ist gewährleistet, dass der Login durchgängig ohne Unterbrechungen möglich ist.

## Identity Provider Key Rollover

Wenn dein Identity Provider den Key Rollover durchführt und du bei anny die Metadaten URL hinterlegt hast, hast du nichts weiter zu tun. Wir überprüfen zweimal täglich, ob dein Identity Provider neue Zertifikate veröffentlicht hat und aktualisieren diese bei uns.

## Föderationen Key Rollover

Ist dein Identity Provider Teil einer Föderation wie z.B. der DFN AAI, so musst du ebenfalls nichts weiter machen. Wir kümmern uns automatisiert um die Key Rollover. Sobald dein Identity Provider das Zertifikat in der Föderation veröffentlicht hat, aktualisieren wir dieses bei uns.

## Service Provider (anny) Key Rollover

Als Service Provider führen wir voll automatisch den Key Rollover durch. 14 Tage bevor das Zertifikat abläuft, erstellen und veröffentlichen wir das neue Zertifikat. Du erhältst dann eine Benachrichtigung von uns.

Im Regelfall automatisiert dein Identity Provider diese Zertifikate voll automatisch. Passiert das nicht, musst du das neue Zertifikat in deinem Identity Provider hinterlegen.

### Zertifikatswechsel selbst starten und abschließen

Du musst nicht auf den automatischen Wechsel warten. Sobald ein SAML Identity Provider verbunden ist, findest du in den Account-Einstellungen unter [**SSO & Sicherheit**](https://app.anny.co/organization/settings/sso?o=) den Bereich **Zertifikatswechsel**. Dort siehst du:

* das aktuelle Zertifikat und bis wann es gültig ist,
* die Metadaten-URL,
* während eines Wechsels das neue Zertifikat, seit wann der Wechsel läuft und wann wir ihn spätestens automatisch abschließen,
* sonst, wann der nächste automatische Wechsel startet.

<Steps>
  <Step title="Wechsel starten">
    Klicke auf **Wechsel starten**. Wir erstellen ein neues Zertifikat und veröffentlichen ab sofort beide Zertifikate in unseren Metadaten. Der Login funktioniert weiter mit dem aktuellen Zertifikat.
  </Step>

  <Step title="Neue Metadaten im Identity Provider hinterlegen">
    Importiere unsere Metadaten über die **Metadaten-URL** erneut in deinen Identity Provider. Liest dein Identity Provider die Metadaten-URL regelmäßig ein, passiert das automatisch.
  </Step>

  <Step title="Wechsel abschließen">
    Sobald dein Identity Provider dem neuen Zertifikat vertraut, klicke auf **Wechsel abschließen** und bestätige. Ab dann signieren wir alle Anfragen mit dem neuen Zertifikat. Schließt du den Wechsel nicht selbst ab, übernehmen wir das nach 14 Tagen automatisch, spätestens kurz bevor das aktuelle Zertifikat abläuft.
  </Step>
</Steps>

<Warning>
  Schließe den Wechsel erst ab, wenn dein Identity Provider das neue Zertifikat kennt. Sonst schlägt die SSO-Anmeldung sofort fehl. Der Abschluss lässt sich nicht rückgängig machen.
</Warning>

<Note>
  Für Identity Provider aus einer Föderation wie der DFN AAI übernehmen wir den Zertifikatswechsel weiterhin vollständig.
</Note>


# Single-Sign-On (SSO) Übersicht
Source: https://docs.anny.co/sso-overview

Nutze SSO, um Logins zentral über deinen Identity Provider zu steuern und angrenzende Funktionen wie Attribute Mapping gezielt für interne Buchungslogiken zu nutzen.

Mit SSO verbindest du anny mit dem Identitätssystem deiner Organisation, damit sich Nutzer:innen mit ihrem bestehenden Unternehmens-Login anmelden können. Das vereinfacht die Anmeldung, reduziert manuelle Nutzerverwaltung und schafft eine gemeinsame Basis für weitere Funktionen wie Attribute Mapping. Der Artikel richtet sich an Admins und IT-Verantwortliche, die entscheiden möchten, welche SSO-Bausteine sie in anny brauchen und wie diese zusammenhängen.

## Für wen ist diese Funktion geeignet?

SSO in anny ist besonders für Organisationen geeignet, die Zugänge zentral steuern und interne Buchungsbereiche sauber mit bestehenden Nutzerkonten verbinden möchten.

## Wo findest du die Funktion in anny?

Du findest die SSO-bezogenen Einstellungen in deinen Account-Einstellungen im Bereich [**SSO & Sicherheit**](https://app.anny.co/organization/settings/sso?o=).

* Öffne die Account-Einstellungen deines anny Accounts.
* Wechsle in den Bereich SSO & Sicherheit.
* Dort findest du die Konfiguration für SSO sowie angrenzende Bereiche wie SCIM und Attribute Mapping.
* Im selben Kontext kannst du auch Mapping-Regeln anlegen.

![SSO & Sicherheit Einstellungen](https://downloads.intercomcdn.eu/i/o/niegcmk9/135497939/7fe5e7fc280ada81582c5998e904/generalsso.png)

<Warning>
  **Wichtig**: Für Attribute Mapping muss SSO bereits aktiv eingerichtet sein. Ohne aktive SSO-Verbindung stehen die benötigten Attribute in der Regel nicht zuverlässig zur Verfügung.
</Warning>

## So funktioniert die Logik

* SSO steuert in anny die Authentifizierung. Nutzer:innen melden sich also mit einem externen Identity Provider wie Microsoft 365, Google Workspace oder einem anderen SAML-2-System an.
* SCIM ist davon getrennt. SCIM kümmert sich um die automatische Bereitstellung und Synchronisierung von Nutzerkonten im Hintergrund und ist nicht dasselbe wie der eigentliche Login.
* Attribute Mapping nutzt die vom Identity Provider übergebenen Attribute oder Gruppen, um Nutzer:innen in anny gezielt Communities zuzuordnen.

## Überblick: Die beteiligten Elemente

| Element | Beschreibung |
| - | - |
| **Identity Provider (IdP)** | Das externe System, das die Identitäten deiner Nutzer:innen zentral verwaltet (z. B. Microsoft Entra ID, Google Workspace, Okta). |
| **SAML 2.0** | Das Standardprotokoll, das anny nutzt, um den sicheren Login (Single Sign-On) zwischen deinem IdP und anny durchzuführen. |
| **OAuth2** | Ein alternatives Protokoll für den sicheren Login und die Autorisierung, das du selbst einrichten kannst. Eine Anleitung findest du unter [OAuth2 SSO einrichten](/oauth2-sso). |
| **OpenID Connect (OIDC)** | Die Identitätsschicht auf OAuth2. anny liest dabei alle Endpunkte automatisch aus, du hinterlegst nur die Adresse deines Identity Providers. Siehe [OpenID Connect SSO](/openid-connect-sso). |
| **SCIM (User Provisioning)** | Ein separater Hintergrundprozess (Backchannel), der Nutzer:innen automatisch in anny anlegt, aktualisiert oder deaktiviert, ohne dass sie sich einloggen müssen. |
| **Attribute Mapping** | Die Übersetzungsregel, die festlegt, welche Daten vom IdP (z. B. Name, Abteilung) in welche Felder in anny geschrieben werden. |

## Einrichtung der SSO-Protokolle in anny

**Die SSO-Einrichtung (SAML 2.0)**

* [Microsoft 365 (SAML 2) einrichten](/microsoft-saml-sso)
* [Google Workspace (SAML 2) einrichten](/google-workspace-sso)
* [Generisches SAML 2.0 einrichten](/generic-saml-sso) (Okta, Auth0 etc.)
* Federiertes SAML 2.0 in anny nutzen
* [SCIM einrichten](/scim-user-provisioning) (u.a. auch in Microsoft Entra)

**Die SSO-Einrichtung (OAuth2 & OpenID Connect)**

* [OAuth2 einrichten](/oauth2-sso)
* [OpenID Connect einrichten](/openid-connect-sso)

## Attribut Mapping

Durch das [Attribute Mapping](/attribute-mapping) kannst du Benutzer-Eigenschaften aus deinem IDP (Usermanagement) zu anny Communities zuweisen. So können Mitglieder automatisch (Auto-Join) in die jeweiligen internen Buchungsbereiche (Communities) zugeordnet werden.

Mehr dazu findest du [hier](/attribute-mapping).

## Troubleshooting SSO

<AccordionGroup>
  <Accordion title="404: Seite nicht gefunden">
    ![404 Fehler](https://downloads.intercomcdn.eu/i/o/niegcmk9/133259518/51b6ba5e017fe84fbe867a3bfb84/image.png)

    Überprüfe bei diesem Fehler, ob der Identity Provider aktiviert wurde. Aktiviere den Identity Provider über die drei Punkte > Aktivieren.

    ![IdP aktivieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/133259574/742d06d0ed6f3e4551f347f5a468/image.png)
  </Accordion>

  <Accordion title="Microsoft Azure: AADSTS50105">
    ![AADSTS50105 Fehler](https://downloads.intercomcdn.eu/i/o/niegcmk9/133259894/0b99dcf1650edf4a96057dd78d3a/image.png)

    Dieser Fehler tritt auf, wenn Benutzer in Microsoft explizit zu der Anwendung hinzugefügt werden müssen und noch nicht hinzugefügt worden sind. Es gibt zwei Möglichkeiten, um dieses Problem zu beheben:

    **1. Zuweisung von Benutzern nicht erfordern**

    Gehe dazu auf die Anwendung in Microsoft Azure und dann zu Eigenschaft. Setze die Option "Zuweisung erforderlich" auf "Nein".

    ![Zuweisung erforderlich deaktivieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/133260323/4b0821500e0b03713b3fcde6428a/image.png)

    **2. Benutzer der Anwendung zuweisen**

    Du kannst die Benutzer zur Anwendung hinzufügen, welche sich darüber einloggen dürfen. Gehe dazu in Microsoft Azure auf deine Anwendung und dann auf Benutzer und Gruppen. Füge hier die Benutzer hinzu, die Zugriff erhalten sollen.
  </Accordion>

  <Accordion title="Signatur fehlt">
    Dieser Fehler bedeutet, dass der SAMLResponse, welche als Antwort vom Identity Provider zu anny gesendet wird, nicht signiert ist. Wir erfordern stets eine signierte SAMLResponse. Stelle sicher, dass die Signatur in deinem IDP hinzugefügt wird.

    ![Signatur fehlt](https://downloads.intercomcdn.eu/i/o/niegcmk9/133260786/b15ea7f7d545245729896ec59aaa/image.png)

    **Microsoft**

    Um die Signatur bei Microsoft Azure zu aktivieren, gehe zur Anwendung > Einmaliges Anmelden > SAML-Zertifikate > Bearbeiten. Stelle sicher, dass bei Signaturoption die Option "SAML-Antwort und-Assertion signieren" ausgewählt ist.

    ![SAML Signatur aktivieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/133261191/4a3fcefd2993ea49876bdff4408e/image.png)
  </Accordion>

  <Accordion title="E-Mail-Adresse fehlt">
    Beim Anmelden als M365-Administrator über den Wayfless-Link oder durch Klicken auf den Button *Test Connection* ist es wichtig zu beachten, mit welchem Benutzer du derzeit in M365 angemeldet bist. Ein Administrator-Benutzer ohne Lizenz für Exchange/Outlook und ohne eigene E-Mail-Adresse kann sich nicht bei anny anmelden. Wechsle zunächst zu deinem regulären M365-Konto und führe den Anmeldevorgang erneut durch.
  </Accordion>

  <Accordion title="Netzwerkfehler durch unvollständiges Attribut-Mapping">
    Grundsätzlich ist für die SSO-Anmeldung kein [Attribut-Mapping](/attribute-mapping) erforderlich. Es kann jedoch später für die automatische Zuordnung zu Buchungsbereichen/Rollen verwendet werden. Mapping-Regeln ohne Inhalt oder Zuordnung können bei der Anmeldung zum Fehlern führen, da anny versucht, die Regeln während des Anmeldevorgangs anzuwenden.

    Entferne die angelegten Regeln und teste die Anmeldung erneut.
  </Accordion>

  <Accordion title="User wird nicht nach Gruppen gemapped">
    Wenn einzelne User nicht korrekt über das Attribut-Mapping zugeordnet werden, kann es bei Microsoft 365 daran liegen, dass diese zu vielen Gruppen zugeordnet sind und wir somit die Gruppen nicht auslesen können. 
  </Accordion>
</AccordionGroup>


# Stripe Connect einrichten
Source: https://docs.anny.co/stripe-connect-setup

Richte Online-Zahlungen ein, um Buchungen direkt im Buchungsprozess abzurechnen.

Mit Stripe Connect integrierst du Online-Zahlungen in deinen Buchungsprozess. Kund:innen zahlen direkt beim Buchen, du erhältst automatische Rechnungsstellung und Rückerstattungen bei Stornierungen.

## Stripe Connect einrichten

<Steps>
  <Step title="Online-Zahlungen öffnen">
    Öffne über den **Avatar** (oben rechts) die **Account-Einstellungen** und wechsle zum Reiter **Online-Zahlungen**. Klicke auf **Online-Zahlung einrichten**.
  </Step>

  <Step title="Stripe Connect Account erstellen">
    Du wirst zu Stripe weitergeleitet. Gib dort deine E-Mail-Adresse, Unternehmensart, personenbezogene Angaben und Branche ein. Bestätige die Eingaben.
  </Step>

  <Step title="Verifizierung abwarten">
    Das anny CS-Team verifiziert deinen Account. Die Überprüfung dauert in der Regel wenige Stunden. Danach stehen dir die Online-Zahlungsoptionen in deinem anny Account zur Verfügung.
  </Step>

  <Step title="Online-Zahlung in Buchungsoptionen aktivieren">
    Öffne die gewünschte Buchungsoption und aktiviere den Modus **Online-Zahlung**. Kund:innen können ab sofort während des Buchungsprozesses online zahlen.
  </Step>
</Steps>

<Tip>
  Du kannst den Auszahlungsturnus unter **Account-Einstellungen** → **Online-Zahlungen** einstellen: täglich, wöchentlich, 2-wöchentlich oder monatlich. Außerhalb des Turnus kannst du jederzeit manuell über **Jetzt auszahlen** eine Auszahlung auslösen.
</Tip>

## Ergebnis prüfen

Nach erfolgreicher Verifizierung siehst du unter **Account-Einstellungen** → **Online-Zahlungen** den Status "Aktiv". In deinen Buchungsoptionen steht die Option **Online-Zahlung** zur Verfügung. Kund:innen können jetzt während des Buchungsprozesses mit Kreditkarte, Apple Pay, Google Pay, iDEAL, TWINT oder PayPal bezahlen.

## FAQ

<AccordionGroup>
  <Accordion title="Wie hoch sind die Gebühren?">
    0,40 € pro Buchung zzgl. 5 % des Gesamtbetrags (netto zzgl. MwSt.). Kostenlose Buchungen bleiben gebührenfrei.
  </Accordion>

  <Accordion title="Wann erhalte ich mein Geld?">
    Das Geld steht einen Tag nach dem Buchungstermin zur Verfügung, muss aber noch verarbeitet werden: frühestens 5 Werktage nach Zahlung, spätestens 90 Tage nach Zahlung wird der Betrag an dein Bankkonto freigegeben. Bei SEPA-Zahlungen benötigt Stripe 6 Werktage Verarbeitungszeit.
  </Accordion>

  <Accordion title="Kann ich einen bestehenden Stripe Account verwenden?">
    Nein. Du erstellst über anny einen neuen Stripe Connect Account. Stripe erkennt aber deine E-Mail, sodass du nur einen Login für beide Accounts brauchst.
  </Accordion>

  <Accordion title="Welche Zahlungsmethoden werden unterstützt?">
    Kreditkarte (VISA, Mastercard, American Express), Apple Pay, Google Pay, iDEAL, TWINT und PayPal. Apple Pay und Google Pay funktionieren auch im Widget und können für Abos verwendet werden.
  </Accordion>

  <Accordion title="Kann ich Zahlungen in mehreren Währungen anbieten?">
    Ja. Hinterlege ein weiteres Konto im Stripe Connect Dashboard. anny unterstützt EUR, USD, CHF, GBP, DKK, NOK, PLN und SEK.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Verifizierung dauert länger als erwartet">
    In Ausnahmefällen kann die Prüfung länger dauern. Kontaktiere den anny Support, damit wir den Status prüfen können.
  </Accordion>

  <Accordion title="Die Zahlung wurde durchgeführt, erscheint aber nicht im Stripe Dashboard">
    Bei asynchronen Zahlungsmethoden (z. B. Überweisung, Lastschrift) verzögert sich der Zahlungseingang um mehrere Tage. Erst nach Eingang wird die Zahlung im Dashboard sichtbar.
  </Accordion>

  <Accordion title="Rückerstattung schlägt fehl">
    Das Guthaben deines Stripe Connect Accounts reicht nicht aus. Stelle sicher, dass genügend Guthaben vorhanden ist, bevor du Stornierungen mit Rückerstattung durchführst. Den Erstattungsschritt selbst schließt du im Korrektur-Dialog ab: [Rechnung korrigieren](/invoice-corrections).
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Avatar** (oben rechts) → **Account-Einstellungen** → **Online-Zahlungen** → **Online-Zahlung einrichten**
> * Feature: Zahlungsabwicklung & Rechnungsstellung (ab Essential)
> * Verifizierung: Das anny CS-Team (nicht Stripe) verifiziert den Account
> * Gebühren: 0,40 €/Buchung + 5 % Gesamtbetrag (netto zzgl. MwSt.); anny Gebühren werden bei Stornierung nicht erstattet
> * Auszahlung: 1 Tag nach Buchungstermin verfügbar, frühestens 5 Werktage nach Zahlung verarbeitet, spätestens 90 Tage; SEPA: 6 Werktage
> * Zahlungsmethoden: Kreditkarte (VISA, Mastercard, Amex), Apple Pay, Google Pay, iDEAL, TWINT, PayPal
> * Apple Pay und Google Pay funktionieren jetzt auch im Widget und für Abos
> * Kein bestehender Stripe Account nutzbar, nur neuer Stripe Connect Account über anny
> * Währungen: EUR, USD, CHF, GBP, DKK, NOK, PLN, SEK
> * Buchung auf Anfrage: wird direkt abgerechnet; bei Ablehnung wird erstattet
> * Auszahlungskonto ändern: über Stripe Connect Dashboard → Profileinstellungen → Auszahlungsdetails
> * Verwandte Artikel: Online-Zahlung & Gebühren, Stripe Support, Stornierungsbedingungen


# Stripe Support
Source: https://docs.anny.co/stripe-support



Über dein Stripe Connect Profil verwaltest du Login-Daten, Teammitglieder und die Kontoinhaberschaft. Dieser Artikel zeigt dir, wie du diese Einstellungen erreichst und änderst.

## Stripe Connect Profil öffnen

<Steps>
  <Step title="Online-Zahlungen öffnen">
    Navigiere im Admin-Bereich von anny zu **Online-Zahlungen** (**Avatar** oben rechts → **Account-Einstellungen** → **Online-Zahlungen**).
  </Step>

  <Step title="Auszahlungskonto bearbeiten">
    Klicke auf **Auszahlungskonto bearbeiten**. Du wirst zu Stripe weitergeleitet.
  </Step>

  <Step title="Profil öffnen">
    Klicke unten links im Menü auf **Profil**, um dein Stripe Connect Profil zu öffnen.
  </Step>
</Steps>

## Authentifizierungsdetails bearbeiten

Hier kannst du deine E-Mail-Adresse und Mobilnummer für den Login anpassen.

<Warning>
  Diese Änderungen gelten für alle Stripe-Konten, die du nutzt.
</Warning>

## Teammitglieder hinzufügen

Du kannst weitere Personen einladen, die dein Stripe-Konto verwalten dürfen. Alle hinzugefügten Teammitglieder haben **vollen Zugriff**, z. B. auf Einkommens- und Steuerdokumente sowie Geschäfts- und Bankdaten.

<Steps>
  <Step title="Bearbeiten öffnen">
    Klicke im Profil auf **Bearbeiten**.
  </Step>

  <Step title="Teammitglied hinzufügen">
    Wähle **+ Teammitglied hinzufügen** und gib die E-Mail-Adresse der Person ein.
  </Step>
</Steps>

<Tip>
  Füge am besten mehrere Personen hinzu, um den Zugriff nicht zu verlieren, falls sich dein Team ändert.
</Tip>

## Kontoinhaberschaft übertragen

Wenn du den Eigentümer des Kontos wechseln möchtest:

<Steps>
  <Step title="Neue Person einladen">
    Lade die neue Person zuerst als **Teammitglied** ein (siehe oben).
  </Step>

  <Step title="Inhaberschaft übertragen">
    Sobald die Einladung angenommen wurde: Klicke auf **Teammitglieder** → **Bearbeiten** → **drei Punkte** neben dem Namen der Person → **Kontoinhaberschaft übertragen**.
  </Step>
</Steps>

## Kontovertreter ändern

Alternativ kannst du die Kontovertreter direkt unter **Management und Eigentum** ändern. Dort hast du zwei Möglichkeiten:

* Eine neue Person hinzufügen
* Ein bereits eingeladenes Teammitglied auswählen


# Abos & Mitgliedschaften
Source: https://docs.anny.co/subscriptions-and-memberships

Biete wiederkehrende oder einmalige Abos an, automatisiere die Abrechnung und gewähre Abonnent:innen über Communities Sonderkonditionen.

Mit Abos und Mitgliedschaften bietest du deinen Kund:innen wiederkehrende oder einmalige Pläne an, die automatisch abgerechnet werden. Abonnent:innen können über Communities exklusive Ressourcen, Buchungskontingente und Sonderkonditionen erhalten.

<Info>
  Aktiviere vorab das Feature **Abos und Mitgliedschaften** unter **Account-Einstellungen** → **Features**. Für den Self-Service-Abschluss durch Kund:innen muss **Online-Zahlung** (Stripe Connect) eingerichtet sein.
</Info>

## Wie funktioniert das Konzept?

Ein Abo-Plan definiert die Konditionen eines Abonnements: Preis, Abrechnungsintervall, Laufzeit, Kündigungsfrist und optionale Benefits. Kund:innen abonnieren einen Plan über deine Buchungsseite oder du hinterlegst ein Abo manuell im Admin-Bereich.

Der Lebenszyklus eines Abos:

1. **Abschluss**: Kund:in wählt einen Plan und schließt das Abo ab. Im Checkout ist immer ein **Startdatum** wählbar (**Sofort** oder ein späteres Datum).
2. **Geplant**: Liegt der Start in der Zukunft, bleibt das Abo bis dahin im Status **Geplant**.
3. **Aktiv**: Das Abo läuft, Zahlungen werden automatisch eingezogen, verknüpfte Communities und Kontingente sind aktiv.
4. **Verlängerung**: Bei aktivierter automatischer Verlängerung wird das Abo am Ende der Laufzeit erneuert.
5. **Kündigung**: Kund:in oder Admin kündigt. Das Abo läuft bis zum Ende der bezahlten Periode weiter.

**Abo-Plan-Gruppen** organisieren deine Pläne hierarchisch. Innerhalb einer Gruppe darf jede Person nur ein aktives Abo haben. Die Reihenfolge innerhalb der Gruppe bestimmt, ob ein Wechsel als Upgrade (nach oben) oder Downgrade (nach unten) gilt.

<Tip>
  Bei einem Upgrade wird der bereits gezahlte Betrag anteilig verrechnet. Bei einem Downgrade wird der neue Plan zum nächsten Abrechnungszeitpunkt wirksam.
</Tip>

## Wann nutze ich das?

* **Du betreibst ein Coworking-Space und möchtest Membership-Stufen anbieten**: Erstelle Abo-Pläne mit unterschiedlichen Kontingenten und Community-Zugängen pro Stufe.
* **Du willst Kurse oder Services nur für Mitglieder zugänglich machen**: Verknüpfe einen Abo-Plan mit einer Community und weise dieser Community exklusive Ressourcen zu.
* **Du möchtest wiederkehrende Einnahmen automatisieren**: Nutze Abos mit automatischer Verlängerung und Stripe-Anbindung.
* **Nicht geeignet für**: Einmalige Guthabenkäufe ohne Abo-Charakter. Nutze dafür Buchungspakete.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Communities | Abonnent:innen können automatisch einer Community hinzugefügt und bei Ablauf entfernt werden. |
| Buchungskontingente | Kontingente lassen sich an einen Abo-Plan knüpfen und werden bei Verlängerung automatisch erneuert. |
| Eigene Formulare | Pro Abo-Plan können Formulare hinterlegt werden, die beim Abschluss abgefragt werden (z. B. für KYC). |
| Online-Zahlung | Stripe wickelt die wiederkehrenden Zahlungen ab. Verfügbare Methoden: SEPA, Kreditkarte, Apple Pay, Google Pay und PayPal (nur CHF). |

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Preis & Währung | Monatlicher/jährlicher Betrag inkl. Steuer |
| Abrechnungsintervall | Monatlich, jährlich oder individuell |
| Mindestlaufzeit | Frühester Zeitpunkt, zu dem gekündigt werden kann |
| Kündigungsfrist | Vorlaufzeit vor Ende der aktuellen Periode |
| Automatisch verlängern | Abo erneuert sich am Ende der Laufzeit |
| Abrechnung zum 1. der Periode | Anteilige Berechnung bei Abschluss mitten im Monat |
| Bestätigung erforderlich | Admin muss Abo-Anfrage manuell freigeben |
| Anmeldung erforderlich | Wenn aktiv, müssen Kund:innen sich vor dem Abschluss einloggen. Wenn deaktiviert, können Gäste ohne Konto abonnieren und das Abo später beanspruchen. |
| Anmeldegebühr | Einmaliger Betrag zusätzlich zur ersten Periode |
| Community verknüpfen | Abonnent:innen werden automatisch zur Community hinzugefügt |
| Buchungskontingente | Ein oder mehrere Kontingente dem Plan zuweisen |
| Abo-Plan-Gruppe | Organisiert Pläne für Upgrade/Downgrade-Logik |
| Badge | Marketing-Label auf der Buchungsseite (z. B. "Beliebt") |
| Benefits | Vorteile, die auf der Buchungsseite angezeigt werden |
| Eigene Formulare | Formularfelder beim Abo-Abschluss abfragen |
| Widerrufsfrist | Individuelle Frist für B2C-Widerruf (pro Plan) |
| Lieferadresse anbieten | Separates Lieferadress-Feld im Abo-Checkout |

Auf der Buchungsseite sehen Kund:innen die verfügbaren Abo-Pläne mit Preis, Benefits und ggf. Badge. Im Checkout wählen sie das **Startdatum**: **Sofort** oder ein späteres Datum im Abstand der Abrechnungsperiode.

<Tip>
  Nutze die Vorschau rechts im Editor, um zu prüfen, wie dein Abo-Plan auf der Buchungsseite dargestellt wird.
</Tip>

## Abo-Plan erstellen

<Steps>
  <Step title="Abo-Pläne öffnen">
    Öffne **Abo-Pläne** in der Menüleiste links.
  </Step>

  <Step title="Neuen Plan anlegen">
    Klicke auf **Neu+** und vergib einen Namen.
  </Step>

  <Step title="Allgemeine Informationen konfigurieren">
    Lege Preis, Intervall, Laufzeit, Kündigungsfrist und Verlängerungsverhalten fest.
  </Step>

  <Step title="Community verknüpfen (optional)">
    Wähle unter **Community** eine bestehende Community aus, der Abonnent:innen automatisch beitreten.
  </Step>

  <Step title="Kontingente hinzufügen (optional)">
    Füge unter **Buchungskontingente** ein bestehendes Kontingent hinzu oder erstelle ein neues.
  </Step>

  <Step title="Benefits hinzufügen (optional)">
    Definiere sichtbare Benefits, die auf der Buchungsseite angezeigt werden.
  </Step>

  <Step title="Plan live schalten">
    Setze den Toggle **Live** auf der Plan-Seite. Der Plan erscheint danach auf deiner Buchungsseite.
  </Step>
</Steps>

<Warning>
  Für den öffentlichen Self-Service-Abschluss muss **Online-Zahlung** aktiviert und verifiziert sein. Ohne Online-Zahlung kannst du Abos weiterhin manuell im Admin-Bereich anlegen.
</Warning>

## Verwaltung im Admin-Bereich

### Abo manuell für Kund:innen anlegen

Du kannst Abos auch direkt im Admin-Bereich hinterlegen, z. B. für bestehende Verträge oder Kund:innen ohne eigenen Online-Zugang.

<Steps>
  <Step title="Abos öffnen">
    Öffne **Abos** in der Menüleiste links.
  </Step>

  <Step title="Neues Abo erstellen">
    Klicke auf **Neu+** und wähle einen Abo-Plan aus.
  </Step>

  <Step title="Kundendaten hinterlegen">
    Füge die Person hinzu (Name, E-Mail). Eine Registrierung bei anny ist nicht erforderlich.
  </Step>

  <Step title="Startdatum und Konditionen festlegen">
    Wähle ein Startdatum und optional einen prozentualen Rabatt.
  </Step>

  <Step title="Zahlungsmethode hinterlegen">
    Wähle die Zahlungsmethode (Offline oder Online). Der Kunde wird per E-Mail über das neue Abo informiert.
  </Step>
</Steps>

<Tip>
  Deaktiviere vor dem Speichern die Benachrichtigungs-Glocke, wenn der Kunde nicht per E-Mail informiert werden soll.
</Tip>

### Abo-Anfragen bearbeiten

Wenn **Bestätigung erforderlich** aktiv ist, findest du neue Anfragen unter **Abos** → **Beantragt**. Mit einem Klick auf den Namen kannst du die Mitgliedschaft bestätigen oder ablehnen. Mit der Bestätigung wird gleichzeitig die erste Abrechnung ausgelöst.

### Abo pausieren oder fortsetzen

In der Abo-Detailansicht kannst du ein aktives Abo **pausieren**. Die Laufzeit verlängert sich um den Pausierungszeitraum. Die Pausierung muss vor dem nächsten Abrechnungszeitpunkt greifen, sonst wird die laufende Periode noch abgebucht.

Ein gekündigtes Abo kannst du über **Fortsetzen** wieder aktivieren, solange das Kündigungsdatum noch nicht erreicht ist.

### Abo vorzeitig kündigen

Kündigst du ein bezahltes Abo als Admin vor Periodenende, erstattet anny nicht sofort. Stattdessen legt anny einen **Rechnungsentwurf** (Gutschrift) für den ungenutzten Zeitraum an. Das Popup öffnet sich nach der Kündigung in der Tabelle und in der Detailansicht. Dort prüfst oder bearbeitest du die Gutschrift und sendest sie mit **Fertigstellen mit Rückerstattung**. Die Erstattung läuft erst, wenn du die Gutschrift versendest.

In der Abo-Detailansicht siehst du den Entwurf unter **Rechnungsentwurf**. Hast du das Popup geschlossen, öffnest du es dort erneut. Die Erstattung bezieht sich auf die Rechnung der **aktuellen Periode** und auf das gewählte Kündigungsdatum.

<Tip>
  Ein Widerruf durch die Kund:in innerhalb der Widerrufsfrist erstattet weiterhin sofort anteilig. Der Rechnungsentwurf gilt für die Admin-Kündigung.
</Tip>

### Abo-Benachrichtigungen konfigurieren

Unter **Avatar** (oben rechts) → **Profil & Benachrichtigungen** → **Abo Benachrichtigungen** steuerst du, welche E-Mail-Benachrichtigungen du als Admin zu Abo-Ereignissen erhältst. Super Admins können dieselben Einstellungen für andere Admins setzen, siehe [Admin-Benachrichtigungen](/admin-notifications).

## Zahlungsmethoden für Abos

Für Abo-Zahlungen stehen folgende Methoden zur Verfügung:

| Methode | Verfügbarkeit |
| - | - |
| SEPA-Lastschrift | Desktop und Mobil (EUR) |
| Kreditkarte | Desktop und Mobil |
| Apple Pay | Mobilgeräte (Safari) |
| Google Pay | Mobilgeräte (Chrome) |
| PayPal | Nur CHF |

Im Checkout erscheinen die für Währung und Gerät passenden Methoden gemeinsam.

<Warning>
  TWINT unterstützt keine wiederkehrenden Zahlungen über Stripe. Für Abos in CHF stehen stattdessen Kreditkarte und PayPal zur Verfügung.
</Warning>

## Widerrufsfrist konfigurieren

Für B2C-Abos kannst du pro Plan eine individuelle Widerrufsfrist setzen. Wenn Kund:innen innerhalb dieser Frist kündigen, können sie zwischen zwei Optionen wählen:

* **Sofortiger Widerruf**: Das Abo endet sofort. Der ungenutzte Restbetrag wird automatisch anteilig zurückerstattet.
* **Kündigung zum Laufzeitende**: Das Abo läuft bis zum Ende der aktuellen Periode weiter.

Zusätzlich können Kund:innen eine Kündigung mehrere Monate im Voraus planen.

Die Einstellung findest du in den Optionen des jeweiligen Abo-Plans unter **Widerrufsfrist**. Sie gilt pro Plan, nicht global.

<Tip>
  Die Widerrufsfrist ist besonders relevant für Coworking- und Desk-Sharing-Abos, die von Privatpersonen online abgeschlossen werden.
</Tip>

## Abo zwischen Kund:innen übertragen

Admins können ein bestehendes Abonnement von einer Kund:in auf eine andere Kund:in innerhalb derselben Organisation übertragen, ohne das Abo neu anlegen zu müssen.

<Steps>
  <Step title="Abo-Detailansicht öffnen">
    Öffne **Abos** in der Menüleiste und klicke auf das betroffene Abonnement.
  </Step>

  <Step title="Transfer starten">
    Wähle die Aktion **Übertragen** (Transfer).
  </Step>

  <Step title="Zielkund:in auswählen">
    Wähle die Zielkund:in innerhalb derselben Organisation. Du kannst die Person bei Bedarf direkt neu anlegen oder bearbeiten.
  </Step>

  <Step title="Transfer bestätigen">
    Nach Bestätigung werden Kontingente, Subscriber-Zuordnung und Community-Mitgliedschaften auf die neue Kund:in übertragen.
  </Step>
</Steps>

<Warning>
  Zahlungsmethode und Billing-E-Mail werden nicht automatisch übertragen. Prüfe und aktualisiere diese nach dem Transfer separat.
</Warning>

## Identitätsprüfung bei Abo-Anfragen (Regpit)

Für Abo-Pläne, die eine Identitätsprüfung vor der Freigabe erfordern (z. B. Virtual-Office-Abos, Briefkasten-Vermietungen), kannst du die Regpit-Integration nutzen. Bei einer relevanten Abo-Anfrage startet anny automatisch einen Verifizierungsprozess in Regpit. Die Anfrage wird erst bestätigt, wenn alle erforderlichen Daten vorliegen und das Risiko unter dem definierten Schwellenwert liegt. Mehr zur Einrichtung findest du im Artikel zur [Regpit-Integration](/regpit-integration).

## Upgrade & Downgrade

Innerhalb einer Abo-Plan-Gruppe können Kund:innen selbstständig zwischen Plänen wechseln:

* **Upgrade** (Plan mit höherer Position): Wird sofort wirksam. Der bereits gezahlte Restbetrag der aktuellen Periode wird anteilig verrechnet.
* **Downgrade** (Plan mit niedrigerer Position): Wird zum nächsten Abrechnungszeitpunkt umgestellt.

<Warning>
  Wenn ein Kunde innerhalb einer Abo-Gruppe wechselt, gelten die festgelegten Startdatum- und Bestätigungs-Einstellungen des Ziel-Plans nicht. Der Wechsel erfolgt direkt.
</Warning>

## Mehrere Abo-Plan-Gruppen

Du kannst mehrere Gruppen erstellen. So kann eine Person in verschiedenen Gruppen jeweils ein aktives Abo haben (z. B. Membership + Fitness-Add-on). Jede Gruppe hat separate Abrechnung und individuelle Kündigungsmöglichkeiten.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Coworking mit Membership-Stufen und Kontingent">
    Ein Coworking-Space bietet Basic, Premium und Platinum Memberships an. Premium-Mitglieder erhalten 5 Meetingraum-Stunden pro Monat und Zugang zu einem Members-Only-Bereich.

    <Steps>
      <Step title="Community anlegen">
        Erstelle unter **Kunden** → **Communities** → **Neu+** eine Community (z. B. "Premium Members"). Weise ihr die exklusiven Ressourcen zu.
      </Step>

      <Step title="Kontingent erstellen">
        Erstelle unter **Buchungspakete** → **Buchungskontingente** → **Neu+** ein wiederkehrendes Dauer-Kontingent (300 Minuten/Monat), begrenzt auf Meetingräume.
      </Step>

      <Step title="Abo-Plan-Gruppe anlegen">
        Erstelle unter **Abo-Pläne** drei Pläne (Basic, Premium, Platinum) in einer Gruppe. Sortiere sie aufsteigend nach Wertigkeit.
      </Step>

      <Step title="Premium-Plan konfigurieren">
        Verknüpfe im Premium-Plan die Community und das Kontingent. Setze automatische Verlängerung und Abrechnung zum 1. der Periode.
      </Step>

      <Step title="Ergebnis prüfen">
        Nach Abo-Abschluss tritt der Kunde automatisch der Community bei, erhält das Meetingraum-Kontingent und kann exklusive Ressourcen buchen. Bei Kündigung wird beides automatisch entzogen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Fitnessstudio ohne Login und mit späterem Start">
    Ein Studio möchte Neukund:innen den Abo-Abschluss so einfach wie möglich machen: kein Login nötig, Start ab dem 1. des Folgemonats wählbar.

    <Steps>
      <Step title="Abo-Plan erstellen">
        Erstelle unter **Abo-Pläne** einen Plan (z. B. "Flex Membership", 49 Euro/Monat).
      </Step>

      <Step title="Anmeldung optional machen">
        Deaktiviere in den Plan-Einstellungen **Anmeldung erforderlich**, damit Gäste ohne Konto abonnieren können.
      </Step>

      <Step title="Plan live schalten">
        Setze den Plan auf **Live**.
      </Step>

      <Step title="Ergebnis prüfen">
        Neukund:innen können das Abo ohne Registrierung abschliessen. Im Checkout wählen sie **Sofort** oder ein späteres **Startdatum**. Die erste Abrechnung erfolgt am gewählten Startdatum.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Was passiert, wenn ich den Preis eines aktiven Abos ändere?">
    Bestehende Abonnent:innen behalten die Konditionen, die zum Zeitpunkt des Abschlusses galten. Neue Abschlüsse nutzen den aktualisierten Preis.
  </Accordion>

  <Accordion title="Welche Zahlungsmethoden stehen für Abos zur Verfügung?">
    SEPA-Lastschrift, Kreditkarte, Apple Pay, Google Pay und PayPal (nur CHF). Apple Pay und Google Pay sind nur auf Mobilgeräten nutzbar. TWINT unterstützt keine wiederkehrenden Zahlungen.
  </Accordion>

  <Accordion title="Können Gäste ohne Konto ein Abo abschließen?">
    Ja, wenn du im Abo-Plan **Anmeldung erforderlich** deaktivierst. Gäste können das Abo später über einen Claim-Link mit ihrem Konto verknüpfen.
  </Accordion>

  <Accordion title="Kann ich als Admin das Abo eines Kunden kündigen oder fortsetzen?">
    Ja. Unter **Abos** findest du alle aktiven Abos. Über die Detailansicht kannst du ein Abo kündigen oder zu einem späteren Zeitpunkt fortsetzen. Bei einer vorzeitigen Admin-Kündigung eines bezahlten Abos öffnet sich ein **Rechnungsentwurf**: Die Erstattung läuft erst, wenn du die Gutschrift versendest.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Abo-Plan-Gruppen?">
    Innerhalb einer Gruppe darf eine Person nur ein aktives Abo haben (Upgrade/Downgrade-Logik). Über mehrere Gruppen hinweg kann eine Person parallel verschiedene Abos haben (z. B. Membership + Fitness-Zusatz).
  </Accordion>

  <Accordion title="Kann ein Abo ohne Online-Zahlung genutzt werden?">
    Du kannst Abos manuell im Admin-Bereich anlegen und als "bereits bezahlt" markieren (z. B. bei Vor-Ort-Zahlung). Für den Self-Service-Abschluss durch Kund:innen ist Online-Zahlung erforderlich.
  </Accordion>

  <Accordion title="Wird die Zahlungsmethode mitübertragen, wenn ich ein Abo an eine andere Person übergebe?">
    Nein. **Abonnement übertragen** übernimmt Kontingente, Subscriber-Zuordnung und Community-Mitgliedschaften, aber nicht Zahlungsmethode und Rechnungs-E-Mail. Details: [SEPA-Lastschrift für Abos](/sepa-direct-debit).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein Abo-Plan lässt sich nicht live schalten">
    Prüfe, ob das Feature **Abos und Mitgliedschaften** aktiviert ist und die Online-Zahlung unter **Account-Einstellungen** → **Zahlungen** aktiviert und verifiziert ist.
  </Accordion>

  <Accordion title="Kund:innen sollen ohne Login abonnieren können">
    Deaktiviere im Abo-Plan die Option **Anmeldung erforderlich**. Ein separates Gast-Checkout-Toggle gibt es nicht.
  </Accordion>

  <Accordion title="Das Abo wurde trotz Pausierung abgebucht">
    Prüfe, ob die Pausierung vor dem Abrechnungsdatum aktiv war. Die Pausierung muss vor dem nächsten Abrechnungszeitpunkt greifen, um die Abbuchung zu verhindern.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Abos und Mitgliedschaften (`plan-subscriptions`). Gate ist das Org-Feature plus für Self-Service `uses_payments`. Kein separates Essential-Gate in der Admin-UI.
> * UI-Pfad Abo-Pläne verwalten: **Abo-Pläne** (Menüleiste links). Live-Status: Toggle **Live** (`plan.public`) auf der Plan-Seite, nicht über das Drei-Punkte-Menü.
> * UI-Pfad Abos verwalten: **Abos** (Menüleiste links).
> * UI-Pfad Abo-Benachrichtigungen: **Avatar** → **Profil & Benachrichtigungen** → **Abo Benachrichtigungen**.
> * Upgrade-Logik: Sofort wirksam, anteilige Verrechnung. Downgrade: zum nächsten Abrechnungszeitpunkt.
> * Bei Planwechsel innerhalb einer Gruppe: Startdatum- und Bestätigungseinstellungen des Ziel-Plans werden NICHT angewendet.
> * Abo-Plan-Gruppe = max. 1 aktives Abo pro Person. Mehrere Gruppen = parallele Abos möglich.
> * Startdatum im Checkout: immer vorhanden (Sofort + zukünftige Daten im Intervall-Abstand). KEIN Plan-Toggle „Zukünftigen Start erlauben“. Status vor Start: **Geplant**.
> * Gast-Abschluss: Plan-Feld `requires_login` (UI **Anmeldung erforderlich**). Deaktiviert = Gäste können abonnieren und später per Claim-URL beanspruchen. Es gibt kein Label „Gast-Checkout erlauben“.
> * Admin-Aktionen zusätzlich: **Pausieren** (verlängert Laufzeit), **Fortsetzen** vor Wirksamkeitsdatum, Claim-URL kopieren.
> * Vorzeitige Admin-Kündigung (seit Sep 2026): legt `tmp_invoice` auf dem Plan-Subscription an (Include `tmp_invoice`, `tmp_invoice.items`, `tmp_invoice.original_invoice`, `tmp_invoice.original_invoice.payment`). Versand der Gutschrift (`POST invoices/{id}/send`) führt die Erstattung aus. Nur Rechnungen der aktuellen Periode; Betrag nach `cancels_at`. Widerruf (`withdraw=true`) erstattet weiter sofort. UI: **Rechnungsentwurf**, **Fertigstellen mit Rückerstattung**. Drafts werden in der Rechnungsliste per `filter[exclude_status][]=draft` ausgeblendet, bis sie gesendet sind.
> * Abo-Transfers (seit Juli 2026): Abos können zwischen Kunden innerhalb derselben Organisation übertragen werden.
> * TWINT: Keine wiederkehrenden Zahlungen möglich. Für CHF-Abos: Kreditkarte oder PayPal.
> * Abgrenzung Buchungspakete: Einmalkauf mit Code, keine wiederkehrende Abrechnung.
> * Abgrenzung Communities: Community ist der Zugangsmechanismus, das Abo ist der kaufmännische Rahmen.
> * Widerrufsfrist (seit Juni 2026): Pro Plan konfigurierbar. Innerhalb der Frist: sofortiger Widerruf (anteilige Rückerstattung) oder Kündigung zum Laufzeitende. Auch vorausgeplante Kündigungen möglich.
> * Abo-Transfer (seit Juli 2026): Nur innerhalb derselben Organisation. Kontingente, Subscriber-Zuordnung, Community-Mitgliedschaften werden übertragen. Zahlungsmethode und Billing-E-Mail werden NICHT übertragen.
> * Regpit-Integration: Für Abo-Pläne mit KYC-/GWG-Pflicht (z. B. Virtual Office). Anfrage wird erst nach erfolgreicher Verifizierung bestätigt. Status sichtbar auf Kunden- und Abo-Detailseite.
> * Zahlungsmethoden: SEPA, Kreditkarte, Apple Pay (nur mobil), Google Pay (nur mobil), PayPal (nur CHF). TWINT nicht möglich für wiederkehrende Zahlungen. In der Org-UI nicht einzeln abwählbar.


# Tags
Source: https://docs.anny.co/tags

Kennzeichne Buchungen, Bestellungen, Kunden, Ressourcen und Services mit farbigen Tags und filtere deine Listen danach.

Mit Tags kennzeichnest du Datensätze mit farbigen Stichworten, zum Beispiel „VIP“, „Firmenkunde“ oder „Nachfassen“. So erkennst du wichtige Buchungen im Kalender auf einen Blick, filterst deine Listen nach einem Thema und behältst Sonderfälle im Team im Blick. Tags gelten für deine gesamte Organisation: Jede Person in deinem Team sieht dieselben Tags.

<Warning>
  Beta-Phase Admin 3.0 (Stand: 5. Oktober). Anpassungen sind möglich.
</Warning>

## Wo kann ich Tags vergeben?

Du kannst Tags an diesen Datensätzen vergeben:

* Buchungen
* Bestellungen
* Kunden
* Ressourcen
* Services
* Anfrageformulare

In den Details dieser Datensätze findest du dafür das Feld **Tags**. In den Tabellen gibt es eine Spalte **Tags** und einen Filter **Tags**.

## Tags anlegen und verwalten

Alle Tags deiner Organisation verwaltest du an einer Stelle: in den **Einstellungen** im Reiter **Gruppen**. Dort steht die Gruppe **Tags** ganz oben. Ressourcengruppen, Servicegruppen, Produktgruppen und Buchungspaket-Gruppen liegen auf derselben Seite und sind unter [Gruppen](/groups-and-categories) beschrieben.

<Frame>
  <img alt="Einstellungen, Reiter Gruppen, mit der Gruppe Tags: sieben farbige Tags mit Name und Beschreibung und darunter Tag hinzufügen" />
</Frame>

### Tag hinzufügen

<Steps>
  <Step title="Gruppen öffnen">
    Öffne die **Einstellungen** und wechsle zum Reiter **Gruppen**.

    Du siehst die Gruppe **Tags** mit allen vorhandenen Tags.
  </Step>

  <Step title="Neuen Eintrag anlegen">
    Klicke unter der Liste auf **Tag hinzufügen**.

    Am Ende der Liste erscheint eine neue Zeile.
  </Step>

  <Step title="Name, Farbe und Beschreibung festlegen">
    Trage unter **Name** den Namen des Tags ein. Über den Farbkreis links neben dem Namen wählst du eine Farbe. Unter **Beschreibung** kannst du optional festhalten, wofür das Tag gedacht ist.

    Das Tag steht sofort in allen Tag-Feldern zur Auswahl.
  </Step>
</Steps>

### Tags bearbeiten, sortieren und löschen

* **Umbenennen oder Beschreibung ändern**: Klicke in der Liste direkt auf den Namen oder die Beschreibung und ändere den Text.
* **Farbe ändern**: Klicke auf den Farbkreis vor dem Namen.
* **Reihenfolge ändern**: Ziehe ein Tag an die gewünschte Position. In dieser Reihenfolge erscheinen die Tags in der Auswahl und an den Datensätzen.
* **Löschen**: Klicke in der Zeile auf die drei Punkte, dann auf **Löschen** und bestätige.

<Warning>
  Wenn du ein Tag löschst, entfernt anny es von allen Datensätzen, an denen es hängt. Das lässt sich nicht rückgängig machen.
</Warning>

## Tags an einem Datensatz vergeben

<Steps>
  <Step title="Datensatz öffnen">
    Öffne die Details einer Buchung, einer Bestellung, eines Kunden, einer Ressource, eines Services oder eines Anfrageformulars.

    Unter den Stammdaten siehst du das Feld **Tags**.
  </Step>

  <Step title="Auswahl öffnen">
    Klicke auf das Feld **Tags** beziehungsweise auf **Tags hinzufügen…**.

    Eine Liste aller Tags öffnet sich. Über **Suchen** findest du ein Tag schnell.
  </Step>

  <Step title="Tags auswählen">
    Klicke auf ein oder mehrere Tags.

    Die gewählten Tags erscheinen als farbige Chips im Feld. anny speichert sie sofort, du musst den Datensatz nicht extra speichern.
  </Step>
</Steps>

<Frame>
  <img alt="Feld Tags einer Ressource mit den Tags Corporate, Ground floor und Wheelchair access und geöffneter Tag-Auswahl" />
</Frame>

Um ein Tag wieder zu entfernen, klicke am Chip auf das **×** oder wähle es in der Liste erneut ab. Mit **Alle entfernen** nimmst du alle Tags auf einmal heraus.

Auch in den Tabellen kannst du Tags direkt in der Spalte **Tags** ändern, ohne den Datensatz zu öffnen.

### Tags direkt in der Auswahl anlegen und bearbeiten

Wenn du Tags verwalten darfst, musst du dafür nicht in die Einstellungen wechseln:

* **Neues Tag anlegen**: Tippe in der Auswahl einen Namen ein, den es noch nicht gibt, und klicke auf den Eintrag mit **Erstellen**. Das neue Tag wird direkt vergeben.
* **Tag bearbeiten**: Klicke neben einem Tag auf die drei Punkte. Dort änderst du **Name** und **Farbe** oder löschst das Tag über **Löschen**. Vor dem Löschen zeigt dir anny, mit wie vielen Datensätzen das Tag verknüpft ist.
* **Alle Tags verwalten**: Das Zahnrad-Icon (**Tags verwalten**) oben in der Auswahl führt dich zu den Einstellungen im Reiter **Gruppen**.

## Tags für mehrere Datensätze gleichzeitig ändern

In den Tabellen **Buchungen** und **Ressourcen** änderst du die Tags vieler Einträge auf einmal.

<Steps>
  <Step title="Einträge auswählen">
    Setze in der Tabelle die Häkchen vor den gewünschten Einträgen.

    Unten erscheint eine Leiste, zum Beispiel mit **3 von 6 ausgewählt**.
  </Step>

  <Step title="Tags bearbeiten öffnen">
    Klicke in der Leiste auf **Tags bearbeiten**.

    Ein Fenster wie **Tags für 3 Datensätze** öffnet sich.
  </Step>

  <Step title="Hinzufügen oder Entfernen wählen">
    Wähle **Hinzufügen**, um Tags zu ergänzen, oder **Entfernen**, um Tags herauszunehmen. Wähle dann die Tags aus.

    Die gewählten Tags erscheinen im Feld.
  </Step>

  <Step title="Änderung anwenden">
    Klicke auf **Anwenden**.

    anny ändert die Tags aller ausgewählten Einträge.
  </Step>
</Steps>

<Note>
  Mit **Hinzufügen** bleiben die bisherigen Tags der Einträge erhalten. Mit **Entfernen** nimmt anny nur die gewählten Tags heraus, alle anderen bleiben bestehen.
</Note>

## Nach Tags filtern

Die Tabellen **Buchungen**, **Bestellungen**, **Kunden**, **Ressourcen**, **Services** und **Anfrageformulare** haben einen Schnellfilter **Tags**.

<Steps>
  <Step title="Filter öffnen">
    Klicke oberhalb der Tabelle auf **Tags**.

    Eine Liste aller Tags öffnet sich.
  </Step>

  <Step title="Tags auswählen">
    Wähle ein oder mehrere Tags aus und klicke auf **Anwenden**.

    Die Tabelle zeigt alle Einträge, die mindestens eines der gewählten Tags haben.
  </Step>
</Steps>

<Frame>
  <img alt="Tabelle Ressourcen mit geöffnetem Filter Tags, in dem Ground floor ausgewählt ist, und der Spalte Tags" />
</Frame>

Mit **Reset** setzt du den Filter zurück. Wenn du eine Ansicht mit diesem Filter speicherst, hast du die getaggten Einträge jederzeit mit einem Klick parat.

## Tags im Kalender

Im [Kalender](/calendar) siehst du die Tags direkt an den Buchungskarten und in der Agenda. Dabei führt anny die Tags der Buchung, der Bestellung und des Kunden zusammen. Hat eine Kundin das Tag „VIP“, siehst du es also an jeder ihrer Buchungen, ohne jede Buchung einzeln zu taggen.

<Frame>
  <img alt="Kalender in der Tagesansicht mit Buchungskarten, die die Tags VIP, Follow-up, Corporate und First visit zeigen" />
</Frame>

Eine Buchungskarte zeigt das erste Tag, weitere Tags fasst sie zu einer Zahl wie **+1** zusammen. Alle Tags siehst du, wenn du die Buchung öffnest.

<Tip>
  Kurze Buchungskarten zeigen keine Tags, weil der Platz nicht reicht. Öffne die Buchung, um ihre Tags zu sehen.
</Tip>

## Wer darf Tags vergeben?

* **Tags vergeben und entfernen**: Wer einen Datensatz bearbeiten darf, kann ihn auch taggen.
* **Tags anlegen, bearbeiten, sortieren und löschen**: Dafür brauchst du in deiner Rolle die Berechtigung **Tags** mit der Stufe **Verwalten**. Ohne sie siehst du die Liste in den Einstellungen nur lesend und kannst in der Auswahl keine neuen Tags anlegen.

Die Berechtigung **Tags** vergibst du in der Nutzer- und Rollenverwaltung: In der Seitenleiste unter **Admin-Nutzer** im Reiter **Rollen** für eine ganze Rolle oder über **Berechtigungen verwalten** für einzelne Nutzer. Mehr dazu unter [Rollen und Berechtigungen](/roles-and-permissions).

## Wann nutze ich das?

* **Stammkund:innen besonders betreuen**: Tagge den Kunden mit „VIP“. Das Tag erscheint an allen seinen Buchungen im Kalender.
* **Offene Punkte im Team markieren**: Vergib ein Tag wie „Nachfassen“ und filtere die Buchungen danach, bis alles erledigt ist.
* **Ressourcen nach Ausstattung ordnen**: Tagge Räume zum Beispiel mit „Barrierefrei“ oder „Erdgeschoss“ und filtere die Ressourcen danach.
* **Firmenbuchungen erkennen**: Tagge Bestellungen oder Kunden mit „Firmenkunde“, damit dein Team sie sofort sieht.

## FAQ

<AccordionGroup>
  <Accordion title="Sehen Kund:innen meine Tags?">
    Nein. Tags sind nur im Admin-Bereich für dein Team sichtbar. Auf der Buchungsseite und in E-Mails erscheinen sie nicht.
  </Accordion>

  <Accordion title="Warum sehe ich im Kalender ein Tag, das ich nicht an der Buchung vergeben habe?">
    Im Kalender zeigt anny die Tags der Buchung zusammen mit den Tags der zugehörigen Bestellung und des Kunden. Das Tag hängt dann an der Bestellung oder am Kunden. Öffne die Bestellung oder den Kunden, um es dort zu ändern.
  </Accordion>

  <Accordion title="Was passiert mit den Datensätzen, wenn ich ein Tag lösche?">
    Das Tag wird von allen Datensätzen entfernt. Die Datensätze selbst bleiben unverändert. Vor dem Löschen aus der Tag-Auswahl zeigt dir anny, mit wie vielen Datensätzen das Tag verknüpft ist.
  </Accordion>

  <Accordion title="Kann ich Tags für mehrere Buchungen gleichzeitig vergeben?">
    Ja. Wähle in der Tabelle **Buchungen** die Einträge aus und klicke auf **Tags bearbeiten**. Das funktioniert auch in der Tabelle **Ressourcen**.
  </Accordion>

  <Accordion title="Muss ich nach dem Vergeben eines Tags speichern?">
    Nein. Tags werden sofort gespeichert, sobald du sie auswählst oder entfernst.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich kann kein neues Tag anlegen">
    Neue Tags anlegen darf nur, wer die Berechtigung **Tags** mit der Stufe **Verwalten** hat. Ohne sie kannst du vorhandene Tags nur vergeben. Bitte eine Person mit Admin-Rechten, das Tag anzulegen oder dir die Berechtigung **Tags** zu geben.
  </Accordion>

  <Accordion title="Das Feld Tags lässt sich nicht bearbeiten">
    Tags vergeben kann nur, wer den Datensatz bearbeiten darf. Prüfe deine Rolle, zum Beispiel ob du Buchungen oder Ressourcen bearbeiten darfst.
  </Accordion>

  <Accordion title="Tags wurden nicht bei allen ausgewählten Einträgen geändert">
    Erscheint eine Meldung wie **Tags konnten bei 1 von 3 Datensätzen nicht aktualisiert werden.**, konnte anny einzelne Einträge nicht ändern, zum Beispiel wegen fehlender Rechte. Prüfe die betroffenen Einträge und vergib die Tags dort einzeln.
  </Accordion>

  <Accordion title="Eine Buchungskarte im Kalender zeigt keine Tags">
    Kurze Buchungskarten blenden Tags aus, weil der Platz nicht reicht. Öffne die Buchung, um ihre Tags zu sehen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Tags sind organisationsweit (Felder: Name, Farbe, Beschreibung, Reihenfolge). Vergabe an Buchungen, Bestellungen, Kunden, Ressourcen, Services und Anfrageformularen. Für Kund:innen nicht sichtbar.
> * Verwaltung: **Einstellungen** → Reiter **Gruppen** → Gruppe **Tags** (erste Gruppe, danach Ressourcengruppen, Servicegruppen, Produktgruppen, Buchungspaket-Gruppen). Inline-Bearbeitung von **Name** (mit Farbkreis) und **Beschreibung**, Drag & Drop für die Reihenfolge, **Tag hinzufügen**, Zeilenaktion **Löschen** mit Bestätigung „„Name“ löschen?“.
> * Löschen entfernt das Tag von allen Datensätzen (Kaskade), nicht rückgängig zu machen.
> * Feld **Tags** in den Details (Buchung inkl. Kalender-Panel, Bestellung, Kunde, Ressource, Service, Anfrageformular). Auswahl mit Platzhalter **Tags hinzufügen…**, **Suchen**, „n ausgewählt“, **Alle entfernen**. Speichert sofort („Tags werden sofort gespeichert.“). Tabellenspalte **Tags** ist direkt editierbar.
> * Mit Tag-Berechtigung: neues Tag durch Eintippen + **Erstellen**; drei Punkte pro Tag: **Name**, **Farbe**, **Löschen** (Bestätigung nennt die Zahl verknüpfter Datensätze); Zahnrad **Tags verwalten** → Einstellungen, Gruppen.
> * Massenbearbeitung **Tags bearbeiten** nur in den Tabellen **Buchungen** und **Ressourcen**: Fenster „Tags für n Datensätze“, Modus **Hinzufügen** / **Entfernen**, **Anwenden** / **Abbrechen**. Erfolg: „Tags bei n Datensätzen aktualisiert.“, Teilfehler: „Tags konnten bei x von n Datensätzen nicht aktualisiert werden.“
> * Schnellfilter **Tags** (mindestens eines der gewählten Tags) in Buchungen, Bestellungen, Kunden, Ressourcen, Services, Anfrageformulare; Buttons **Reset** / **Anwenden**.
> * Kalender: Buchungskarten (erstes Tag + „+n“), Agenda und schmale Terminleisten (als Farbpunkte) zeigen die zusammengeführten Tags von Buchung, Bestellung und Kunde (ohne Duplikate, in Tag-Reihenfolge); kurze Karten blenden Tags aus. Keine Hover-Vorschau.
> * Rechte: Tags vergeben = Bearbeitungsrecht am Datensatz. Tags anlegen/bearbeiten/sortieren/löschen = neuer Berechtigungspunkt **Tags** mit Stufe **Verwalten** (Seitenleiste **Admin-Nutzer** → Reiter **Rollen** bzw. **Berechtigungen verwalten** pro Nutzer); sonst Einstellungsliste nur lesend.


# 2-Faktor-Authentifizierung
Source: https://docs.anny.co/two-factor-authentication



Mit der **2-Faktor-Authentifizierung (2FA)** sicherst du dein anny Konto über das Passwort hinaus ab. Durch einen zweiten Bestätigungsschritt verhinderst du, dass unbefugte Personen Zugriff auf deine Daten erhalten, selbst wenn dein Passwort bekannt sein sollte.

## Was ist die 2-Faktor-Authentifizierung?

Die 2-Faktor-Authentifizierung ist eine zusätzliche Sicherheitsebene für deinen Login. Das bedeutet:

* du meldest dich wie gewohnt mit deiner E-Mail-Adresse und deinem Passwort an
* anschließend bestätigst du deine Anmeldung mit einem weiteren Faktor, zum Beispiel einem Sicherheitscode

So wird verhindert, dass sich andere Personen allein mit deinem Passwort in dein Konto einloggen können.

## Wofür ist die Funktion hilfreich?

Diese Funktion ist für alle Nutzer:innen und Administrator:innen innerhalb von anny relevant, um die Account-Sicherheit zu maximieren.

* Admins, die Zugriff auf sensible Buchungs- und Kundendaten haben.
* Anbieter:innen, die Zahlungen über anny abwickeln.
* Teammitglieder in Organisationen mit hohen Sicherheitsstandards.
* Endnutzer:innen, die ihr persönliches Buchungsprofil schützen möchten.

Die 2FA ist der Standard für moderne Datensicherheit im Web.

## Wo kann ich die 2-Faktor-Authentifizierung in anny aktivieren?

Du kannst die 2-Faktor-Authentifizierung entweder für dich persönlich einrichten oder als Admin für deine gesamte Organisation erzwingen.

### Persönliche 2FA aktivieren

Du kannst die 2-Faktor-Authentifizierung an zwei Stellen aktivieren:

1. **Im Admin-Bereich:** Öffne im Admin-Bereich dein [Profil](https://app.anny.co/user) und aktiviere dort die [2-Faktor-Authentifizierung](https://auth.anny.co/two-factor-settings)
2. **Über das Kundenprofil:** Endnutzer können ihr eigenes Konto zusätzlich absichern, indem sie in den Einstellungen der [Persönlichen Informationen](https://anny.co/profile?setting=personal) auf [Zwei-Faktor-Authentifizierung verwalten](https://auth.anny.co/two-factor-settings) klicken

![Screenshot: 2-Faktor-Authentifizierung aktivieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/122433676/cb4aefb16b84619f6e1161d0252b/2-fact-auth.png?expires=1784817000\&signature=02c6df8fabe08dd07fbcfcbee2b889fabd081ef4c86276afaee620a7701864c3\&req=0ddtwVv5qjAulxv889osp8Y0E6t3JDBK8NpbLlzcaqU5e6Ht6dJY70JucHTq%0AZnPG53eMHB2hOn3aeg%3D%3D%0A)

### 2-Faktor-Authentifizierung für die gesamte Organisation erzwingen

Du kannst die 2-Faktor-Authentifizierung auch für die gesamte Organisation erzwingen. Dabei kannst du festlegen, ob dies für alle gilt oder nur für Administratoren der Organisation.

1. Navigiere in dem **Admin-Bereich** zu den **Organisationseinstellungen** und dann auf **SSO & Sicherheit**.
2. Scrolle runter bis zum Punkt **zusätzliche Sicherheitsoptionen**.
3. Wähle nun unter "**Zwei-Faktor-Authentifizierung erzwingen**", ob diese nur für Admin gelten soll oder alle Benutzer der Organisation.


# UTM Tracking
Source: https://docs.anny.co/utm-tracking



Mit UTM Link Tracking kannst du nachvollziehen, über welche Kanäle und Kampagnen Buchungen, Abonnements oder Buchungspakete zustande kommen. So misst du die Performance deiner Marketingaktionen – ganz ohne zusätzliche Tools.

## **Warum UTM Tracking in anny sinnvoll ist**

Wenn du deine Buchungsseite über externe Kanäle wie Newsletter, Social Media, Anzeigen oder Partner verlinkst, möchtest du wissen:

* Welche Quelle bringt die meisten Buchungen?
* Welche Kampagne performt am besten?
* Welcher Partner hat welchen Umsatz vermittelt?

Dank UTM-Tracking kannst du genau das herausfinden – direkt in anny.

Das Feature eignet sich besonders für:

* **Marketingteams**, die Kampagnen-Performance analysieren möchten (Newsletter, Ads, Blog, Social Media)
* **Sales- oder Partnermanagement-Teams**, die Buchungen bestimmten Partnern zuordnen wollen (Referral-Kampagnen)
* **Organisationen**, die Conversiondaten ohne externe Tools erfassen wollen.

## UTM Tracking einrichten

In folgenden Bereichen findest du die Möglichkeit, einen UTM-Link zu generieren:

<Steps>
  <Step title="Buchungsseite im Adminbereich öffnen">
    Öffne im Admin-Bereich, die **Account-Einstellungen, Ressource oder Service** für das du ein UTM-Tracking einrichten möchtest. Gehe zu dem Reiter **Buchungsseite.**
  </Step>

  <Step title="UTM-Tracking erstellen">
    Klicke auf **Tracking-URL erstellen**

    1. Wähle eine `utm_source` (Plattform wie z.B. TikTok, Instagram, Newsletter etc. oder erstelle was eigenes)
    2. Definiere dein `utm_medium` (den Kanal, über den Traffic auf deine Buchungsseite gelangt wie z.B. social, email, referral oder cpc)
    3. Vergebe einen eigenen Kampagnennamen `utm_campaign` (z.B. happy\_2026)

    Mit einer der drei oder allen drei Parametern wird die URL erstellt und kann nun zum Teilen kopiert werden.
  </Step>
</Steps>

<Note>
  * Einheitliche Schreibweise für Parameter (z. B. alles **klein**, keine **Leerzeichen**)
  * Klare Namenskonventionen für `source`, `medium`, `campaign`
</Note>

**Praxisbeispiele**

| Kanal | Beispiel UTM-Parameter |
| - | - |
| Newsletter | `utm_source=newsletter`<br />`utm_medium=email`<br />`utm_campaign=mai24` |
| Google Ads | `utm_source=google`<br />`utm_medium=cpc`<br />`utm_campaign=search_brand` |
| Instagram | `utm_source=instagram`<br />`utm_medium=social`<br />`utm_campaign=event` |
| Partner-Seite | `utm_source=partnerxy`<br />`utm_medium=referral`<br />`utm_campaign=launch` |

## Auswertung

**Wann wird die Attribution gespeichert?**

* Kund:in klickt auf einen UTM-Link
* Innerhalb von **14 Tagen** werden Buchungen dieser Kampagne zugeordnet.

**Auswertung in Tabellen und Exporten**

Die UTM-Attribution wird auch in folgenden Übersichten und Export-Dateien angezeigt:

* **Buchungstabelle** / **Export**
* **Abo-Tabelle** / **Export**
* **Buchungspaket-Tabelle** / **Export**

<Note>
  Eine erweiterte Analyse im **Dashboard** ist in Planung.
</Note>

## Vergleich mit anderen Conversion Tracking Methoden

Neben dem UTM Link Tracking bietet anny auch die Möglichkeit, externe Trackingpixel einzubinden. So kannst du Conversions (z. B. Buchungen oder abgeschlossene Abos) direkt an Werbeplattformen zurückspielen. Hier findest du eine Übersicht:

| Tracking Methode | Ziel/ Plattform | Unterstützt in anny? | Funktioniert im Widget? | Funktioniert ohne Cookie Einwilligung |
| - | - | - | - | - |
| UTM Link Tracking | Quelle & Kampagne messen | ✅ Ja | ✅ Ja | ✅ Ja |
| Meta Ads | Meta Pixel | ✅ Ja | ⚠️ Ja, mit Offline Conversion API | ⚠️ Ja, mit Offline Conversion API |
| LinkedIn Ads Tracking | LinkedIn Insight Tag | ✅ Ja | ⚠️ Ja, mit Offline Conversion API | ⚠️ Ja, mit Offline Conversion API |
| TikTok Ads Tracking | TikTok Pixel | ✅ Ja | ⚠️ Ja, mit Offline Conversion API | ⚠️ Ja, mit Offline Conversion API |
| Google Ads & Google Analytics | Google Ads/ GA4 | ✅ Ja | ⚠️ Ja, mit Custom Code | ❌ Nein |

So richtest du die weiteren Conversion Tracking Möglichkeiten ein:

* [Meta Ads einrichten](/meta-ads-tracking)
* [TikTok Ads einrichten](/tiktok-ads-tracking)
* [LinkedIn Ads einrichten](/linkedin-ads-tracking)
* [Google Ads einrichten](/google-analytics)

Mehr zu der Custom Code Einbettung erfährst du hier:

* [Website-Widget Advanced](/widget-embed-advanced)

## Tracking im Widget

Damit UTM-Tracking auch bei eingebetteten Widgets funktioniert, müssen die UTM-Parameter korrekt in der URL enthalten sein, **auf der das Widget eingebunden ist**.

Wenn dein Widget z. B. auf der Seite `https://my-website.com/booking` eingebunden ist, dann verwende folgenden Link für deine Kampagne:

`https://my-website.com/booking?utm_source=google&utm_campaign=my_campaign`

**Wichtig bei Weiterleitungen oder internen Links**

Wenn deine Kampagne z. B. auf `https://my-website.com` verlinkt – und von dort aus der Kunde erst zum Widget auf `https://my-website.com/booking` navigiert – dann **müssen die UTM-Parameter mit übernommen werden**.

**Achte darauf**, dass deine internen Verlinkungen oder Weiterleitungen die Parameter **nicht verlieren**.

**❌ Falsch:**

```text theme={null}
https://my-website.com → https://my-website.com/booking
```

→ Parameter gehen verloren → keine Attribution möglich

**✅ Richtig:**

```text theme={null}
https://my-website.com?utm_source=google&utm_campaign=my_campaign →   https://my-website.com/booking?utm_source=google&utm_campaign=my_campaign
```

UTM-Parameter müssen **in der finalen URL sichtbar sein**, **bevor das Widget geladen wird** – sonst kann anny keine Attribution durchführen.


# Wertgutscheine
Source: https://docs.anny.co/value-vouchers

Biete flexible Geldwert-Gutscheine an, die Kund:innen als Zahlungsmittel bei beliebigen Buchungen einlösen können.

Ein Wertgutschein ist ein Mehrzweckgutschein mit reinem Geldwert, den Kund:innen flexibel für beliebige kostenpflichtige Leistungen einsetzen können. Im Gegensatz zu zweckgebundenen Buchungspaketen ist der Gutschein nicht an eine bestimmte Ressource oder ein Kontingent gebunden, sondern funktioniert beim Einlösen als Zahlungsmittel.

<Info>
  * Verfügbar ab dem Professional-Plan.
  * Aktiviere vorab das Feature **Buchungspakete** unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktioniert das Konzept?

Wertgutscheine nutzen eine besondere steuerliche Logik (Mehrzweckgutschein gemäß EU-Richtlinie):

1. **Beim Kauf**: Die Rechnung weist 0 % USt. aus. Der Kunde zahlt nur den Nettobetrag, da zum Kaufzeitpunkt noch unklar ist, für welche Leistung (mit welchem Steuersatz) der Gutschein eingesetzt wird.
2. **Beim Einlösen**: Der Gutscheinwert wird als Zahlungsmittel auf die Buchung angerechnet. Die korrekte Umsatzsteuer wird erst auf der finalen Buchungsrechnung ausgewiesen.

Das unterscheidet Wertgutscheine grundlegend von zweckgebundenen Buchungspaketen, bei denen die USt. bereits beim Kauf berechnet wird.

<Info>
  Wann ein Gutschein steuerlich wirklich als Mehrzweckgutschein gilt, welche Einstellungen das kippen können und wie die Vorgänge gebucht werden: [Gutscheine & Umsatzsteuer](/voucher-taxation).
</Info>

**Zwei Varianten:**

* **Fester Betrag**: Du definierst einen exakten Wert (z. B. 50 Euro). Kund:innen kaufen genau diesen Betrag.
* **Freier Betrag**: Kund:innen wählen den Wert selbst. Du setzt optional einen Standardbetrag und einen Mindestbetrag.

Nach dem Kauf erhalten Kund:innen einen **8-stelligen Buchungscode**, den sie im Checkout einer beliebigen kostenpflichtigen Buchung als Zahlungsmittel eingeben.

## Wann nutze ich das?

* **Du möchtest Geschenkgutscheine verkaufen**: Kund:innen kaufen einen Gutschein für Freunde oder Familie, die sich selbst aussuchen, was sie buchen.
* **Du willst Kund:innen einen flexiblen Wunschbetrag ermöglichen**: Aktiviere den freien Betrag mit Mindestgrenze.
* **Du möchtest bei Stornierungen kein Geld zurückerstatten, sondern Guthaben binden**: Verknüpfe den Wertgutschein mit deinen Stornierungsbedingungen.
* **Du brauchst Gutscheine für Promotions oder Entschädigungen**: Erstelle Codes manuell im Admin-Bereich.
* **Nicht geeignet für**: Kontingente für eine bestimmte Leistung (z. B. 10er-Karte). Nutze dafür ein zweckgebundenes Buchungspaket.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Buchungspakete & Codes | Wertgutscheine sind ein Modus innerhalb der Buchungspakete-Funktion. Die Code-Logik ist identisch. |
| Stornierungsbedingungen | Wertgutscheine können als Erstattungsform konfiguriert werden. Bei Stornierung erhält der Kunde automatisch einen Code. |
| Online-Zahlung | Der Gutscheinwert wird beim Einlösen mit dem Buchungspreis verrechnet. Bei Teilverrechnung zahlt der Kunde den Restbetrag online. |

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Fester Betrag | Exakter Gutscheinwert, z. B. 50 Euro |
| Freier Betrag | Kund:innen wählen selbst |
| Standardbetrag | Vorausgefüllter Wert bei freiem Betrag |
| Mindestbetrag | Untergrenze bei freiem Betrag |
| Verfallsdatum | Gültigkeit des Codes in **Tagen** oder **Jahren** (Standard: 730 Tage). Optional **Gültig bis Jahresende**: der Code gilt bis zum 31. Dezember des Jahres, in dem der Zeitraum endet. |
| Rechtliche Dokumente | Dokumente, die beim Kauf bestätigt werden müssen |
| Nutzung begrenzen | Einlösung auf bestimmte Ressourcen einschränken (Kategorie, Gruppe, Ressource, Service) |
| Dokumentvorlage | Dokument, das beim Kauf an Kund:innen gesendet wird |
| Vor-Ort-Dokumentvorlage | Zweites Template nur für Admin-Zwecke (z. B. Ausdruck) |
| Lieferadresse anbieten | Abweichende Lieferadresse im Checkout abfragen |
| Geschäftsadresse anbieten | Geschäftsadresse im Checkout abfragen |
| Versand | Deaktiviert, Optional oder Immer (inkl. Versandkosten) |
| Stornierung als Gutschein | Verknüpfung mit Stornierungsbedingungen einer Ressource |

Auf der Buchungsseite erscheinen Wertgutscheine im Reiter "Buchungspakete". Bei freiem Betrag sehen Kund:innen ein Eingabefeld für ihren Wunschbetrag.

## Wertgutschein erstellen

<Steps>
  <Step title="Buchungspakete öffnen">
    Öffne **Buchungspakete** in der Menüleiste links.
  </Step>

  <Step title="Neues Paket anlegen">
    Klicke auf **Neu+** und wähle den Tab **Wertgutschein**.
  </Step>

  <Step title="Name und Betrag konfigurieren">
    Vergib einen Namen (z. B. "Geschenkgutschein"). Trage einen festen Standardbetrag ein (z. B. 50 Euro) oder setze den Mindestbetrag auf 0, damit Kund:innen den Betrag frei wählen können.
  </Step>

  <Step title="Verfallsdatum setzen">
    Lege die Gültigkeit in Tagen oder Jahren fest (Standard: 730 Tage). Optional aktivierst du **Gültig bis Jahresende**.
  </Step>

  <Step title="Beschreibung hinzufügen">
    Ergänze eine Beschreibung, die auf der Buchungsseite angezeigt wird.
  </Step>

  <Step title="Optionale Einstellungen">
    Konfiguriere bei Bedarf: Dokumentvorlage, Nutzung begrenzen, Lieferadresse anbieten, Geschäftsadresse anbieten und Versandmodus.
  </Step>

  <Step title="Live schalten">
    Aktiviere den **Live-Toggle** oben rechts. Der Wertgutschein erscheint jetzt auf deiner Buchungsseite im Reiter "Buchungspakete".
  </Step>
</Steps>

<Tip>
  In den Account-Einstellungen kannst du festlegen, ob Buchungspakete auf der Buchungsseite als Standardreiter angezeigt werden.
</Tip>

## Nutzung begrenzen

Obwohl Wertgutscheine grundsätzlich als Mehrzweckgutschein konzipiert sind, kannst du die Einlösung optional auf bestimmte Ressourcen einschränken. Klicke dazu im Paket-Editor auf **Nutzung begrenzen** und wähle eine oder mehrere Ressourcen, Gruppen, Kategorien oder Services aus.

<Tip>
  Die Begrenzung ist optional. Ohne Einschränkung kann der Gutschein für jede kostenpflichtige Buchung in deiner Organisation eingelöst werden.
</Tip>

<Warning>
  **Steuerlich relevant:** Schränkst du die Einlösung so weit ein, dass Leistender, Leistungsort und Steuersatz bereits beim Verkauf feststehen (z. B. nur eine einzelne Ressource mit 19 %), kann der Gutschein rechtlich zum **Einzweckgutschein** werden — obwohl anny die Kaufrechnung weiterhin mit 0 % USt. erstellt. Die Umsatzsteuer wäre dann schon beim Verkauf entstanden. Details und Prüfschritte: [Gutscheine & Umsatzsteuer](/voucher-taxation).
</Warning>

## Versandmodus und Lieferadresse

Wenn du physische Gutscheinkarten per Post versenden möchtest, kannst du pro Wertgutschein einen Versandmodus einstellen:

| Modus | Verhalten |
| - | - |
| Deaktiviert | Kein Versand, rein digitale Zustellung |
| Optional | Kund:innen wählen im Checkout, ob Versand gewünscht ist |
| Immer | Versand ist verpflichtend, Versandkosten werden automatisch addiert |

Zusätzlich kannst du einen Versandkostenbetrag hinterlegen, der zum Gutscheinpreis addiert wird.

Mit den Toggles **Lieferadresse anbieten** und **Geschäftsadresse anbieten** fragst du im Checkout zusätzliche Adressfelder ab, damit die Zustellung an die richtige Adresse erfolgt.

Im Admin-Bereich siehst du, welche Gutscheine noch versendet werden müssen, und kannst sie nach dem Versand als **versendet** markieren.

## Stornierung als Wertgutschein konfigurieren

Anstatt bei einer Stornierung den Betrag zurückzuüberweisen, kannst du den Stornierungswert automatisch in einen Buchungscode umwandeln. Der Kunde erhält den Code per E-Mail und kann ihn bei der nächsten Buchung einlösen. Richte dies in der jeweiligen Buchungsoption im Reiter **Änderung & Stornierung** ein.

Nach einem Admin-Storno mit festgeschriebener Rechnung wählst du die Gutschein-Erstattung auch manuell im Korrektur-Dialog. Der Ablauf steht unter [Rechnung korrigieren](/invoice-corrections).

<Warning>
  Die automatische Gutschein-Erstattung funktioniert nur bei bereits festgeschriebenen Rechnungen. Bei Rechnungsentwürfen greift die Logik nicht.
</Warning>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Kosmetikstudio mit Geschenkgutscheinen (fester Betrag)">
    Ein Studio möchte 50-Euro-Gutscheine verkaufen, die Kund:innen für beliebige Behandlungen einlösen können.
  </Accordion>

  <Accordion title="Yoga-Studio mit Stornierungsguthaben statt Rückerstattung">
    Ein Studio möchte bei Stornierungen keinen Geldbetrag zurückerstatten, sondern Kund:innen einen Gutschein für die nächste Buchung geben.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Warum steht auf der Kaufrechnung 0 % USt.?">
    Das ist die korrekte steuerliche Behandlung eines Mehrzweckgutscheins. Da beim Kauf noch nicht feststeht, für welche Leistung der Gutschein eingesetzt wird, darf keine USt. ausgewiesen werden. Die Steuer wird erst bei der Einlösung berechnet. Mehr dazu: [Gutscheine & Umsatzsteuer](/voucher-taxation).
  </Accordion>

  <Accordion title="Was passiert mit Gutscheinen, die nie eingelöst werden?">
    Umsatzsteuerlich nichts — bei einem Mehrzweckgutschein entsteht ohne Einlösung nie ein steuerbarer Umsatz. Ertragsteuerlich wird die Verbindlichkeit ausgebucht, sobald der Anspruch verjährt ist (in der Regel drei Jahre ab Schluss des Ausgabejahres). Beachte: Das Verfallsdatum in anny ist nicht die Verjährungsfrist. Details: [Gutscheine & Umsatzsteuer](/voucher-taxation).
  </Accordion>

  <Accordion title="Was passiert, wenn der Gutscheinwert höher ist als der Buchungspreis?">
    Nur der benötigte Betrag wird vom Gutschein abgezogen. Das Restguthaben bleibt auf dem Code erhalten und kann bei einer späteren Buchung verwendet werden.
  </Accordion>

  <Accordion title="Kann ein Wertgutschein für mehrere Buchungen genutzt werden?">
    Ja, solange noch Restguthaben auf dem Code vorhanden ist.
  </Accordion>

  <Accordion title="Funktioniert die Stornierung als Gutschein auch bei Teilerstattungen?">
    Ja. Der Gutscheincode wird mit dem jeweiligen Erstattungsbetrag ausgestellt, inklusive gebuchter Add-ons.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kund:innen sehen kein Eingabefeld für den freien Betrag">
    Prüfe, ob der Modus auf **Wertgutschein** gesetzt ist und der frei wählbare Betrag aktiviert wurde. Stelle zudem sicher, dass Kund:innen über die übergeordnete Organisationsseite zugreifen, nicht über einen direkten Ressourcen-Link.
  </Accordion>

  <Accordion title="Bei Stornierung wird kein Gutscheincode verschickt">
    Die automatische Umwandlung greift nur bei festgeschriebenen Rechnungen. Prüfe, ob die Rechnung zum Zeitpunkt der Stornierung bereits finalisiert war. Bei Rechnungsentwürfen wird kein Code generiert.
  </Accordion>

  <Accordion title="Der Gutscheincode wird beim Einlösen nicht akzeptiert">
    Prüfe die Gültigkeit des Codes (Verfallsdatum). Importierte Codes können in seltenen Fällen Verrechnungsfehler auslösen. Wende dich mit dem Code an den Support.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Wertgutscheine (Modus B der Buchungspakete). Plan: Professional.
> * UI-Pfad: **Buchungspakete** (Menüleiste) → Neu+ → Modus Wertgutschein.
> * UI-Pfad Stornierung als Gutschein: Ressource → Buchungsoptionen → **Änderung & Stornierung**.
> * Steuerlogik: Kauf = 0 % USt. (Mehrzweckgutschein). Einlösung = USt. auf Buchungsrechnung.
> * Stornierungsgutschein: NUR bei festgeschriebenen Rechnungen. Add-ons werden eingerechnet.
> * Restguthaben: Bleibt auf dem Code erhalten, kann mehrfach verwendet werden.
> * Freier Betrag: Nur über Organisationsseite erreichbar, nicht über Direkt-Links zu Ressourcen.
> * Abgrenzung Buchungspaket (Modus A): Zweckgebunden, USt. beim Kauf, Einlösung = Rabatt.
> * Abgrenzung Rabattcodes: Prozentual/absoluter Preisnachlass im Checkout, kein Guthaben.
> * TWINT: Unterstützt keine Gutscheinzahlung separat, der Gutschein wird vor der Zahlung verrechnet.
> * Nutzung begrenzen: Optional, Einschränkung auf Ressource/Gruppe/Kategorie/Service. Ohne Begrenzung = für alle kostenpflichtigen Buchungen gültig.
> * Versandmodus (seit Juni 2026): Deaktiviert/Optional/Immer. Versandkosten werden addiert. Admin kann als "versendet" markieren.
> * Lieferadresse/Geschäftsadresse: Toggle pro Gutschein, fragt zusätzliche Adressfelder im Checkout ab.
> * Vor-Ort-Dokumentvorlage (seit Juli 2026): Zweites Dokument nur für Admin-Zwecke, wird nicht an Kund:innen gesendet.
> * Verfallsdatum: dieselbe Steuerung wie Buchungspakete (**Tage**/**Jahre**, optional **Gültig bis Jahresende**). Standard 730 Tage.


# Los Geht's – Besucherverwaltung (Check-In)
Source: https://docs.anny.co/visitor-management

Richte ein digitales Besuchermanagement mit Check-In Terminal, Host-Benachrichtigungen und Badge-Druck ein.

Mit diesem Guide richtest du ein vollständiges Besuchermanagement in anny ein. Am Ende können Gäste sich am Terminal per QR-Code einchecken oder spontan registrieren, Hosts werden sofort benachrichtigt und optional wird ein Besucherausweis gedruckt.

## Besucherverwaltung im anny Kontext denken

Bei der Besucherverwaltung bildet anny den physischen Empfangsprozess digital ab. Das zentrale Prinzip: Jedes **Gebäude** oder jede **Etage** ist eine **Ressource**, jeder Besuchstyp eine **Buchungsoption**, und die Personen, die Gäste empfangen, sind **Hosts** in einer **Community**.

| anny Konzept | Bedeutung in der Besucherverwaltung |
| - | - |
| Ressource | Ein Gebäude, eine Etage oder ein Empfangsbereich (z. B. "Hauptgebäude EG") |
| Buchungsoption | Ein Besuchstyp (z. B. "Beratungstermin" oder "Besuch Familie & Freunde") |
| Community | Pool aller Personen, die als Host Besucher:innen empfangen können |
| Check-In App | Das Terminal am Empfang, an dem Gäste per QR-Code einchecken oder sich registrieren |
| Host | Die Person, die den Besuch erwartet und beim Check-in benachrichtigt wird |

Deine Gäste registrieren sich über den **Buchungsbereich** (Buchungsseite, [Outlook Add-In](/outlook-add-in-user-guide) oder direkt am Terminal). Du verwaltest alles im **Adminbereich** (Ressourcen, Buchungen, Displays, Communities).

## Zwei Wege: Terminal-Check-in und Outlook-Registrierung

Die Besucherverwaltung nutzt zwei Ressourcen-Setups mit demselben mentalen Modell — benenne die Ressource nach dem **Gebäude** — aber nicht derselben Kategorie.

| Weg | Ressourcenkategorie | Wofür |
| - | - | - |
| Terminal-Check-in | **Gebäude** | Gäste checken am Empfangsterminal ein oder registrieren sich dort |
| Outlook-Registrierung | **Besucherregistrierung** | Das Outlook Add-In findet diese Ressource, wenn jemand einen Gast aus einem Termin registriert |

Eine Ressource, die **beide** Wege bedienen soll, braucht aktivierten Check-in und eine Display-Zuordnung. Nur die Kategorie **Gebäude** reicht nicht, damit die Ressource in Outlook erscheint.

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressource anlegen">
    Öffne **Ressourcen** und erstelle eine neue Ressource mit der **Kategorie Gebäude**. Benenne sie nach Gebäude oder Etage (z. B. "Hauptgebäude"). Stelle unter **Verfügbarkeit** auf **Mehrfach verfügbar** und setze die Anzahl auf die maximale gleichzeitige Besucherkapazität. Aktiviere unter **Check-In** den Check-in für diese Ressource.
  </Step>

  <Step title="Buchungsoption erstellen">
    Erstelle eine oder mehrere Buchungsoptionen für die Ressource (z. B. "Studierendenberatung" mit fester Dauer, "Lernplatzbuchung" mit flexibler Dauer). Stelle sicher, dass der Preis auf **kostenlos** steht und unter **Erweiterte Einstellungen** die Option **Alle Buchungen automatisch annehmen** aktiviert ist.
  </Step>

  <Step title="Host-Abfrage im Formular aktivieren">
    Öffne die Buchungsoption und wechsle zum Reiter **Formulare**. Aktiviere die **Abfrage des Hosts** als Pflichtfeld. Optional: Lege fest, welche Informationen in der Ergebnisliste angezeigt werden (vollständiger Name, Abteilung, Profilbild).
  </Step>

  <Step title="Host-Community erstellen">
    Navigiere zu **Kunden** → **Communities** und erstelle eine neue Community (z. B. "Hosts"). Füge alle Personen hinzu, die als Host Besucher:innen empfangen können. Verknüpfe die Community über den Zugang mit der Buchungsoption.
  </Step>

  <Step title="Terminal einrichten">
    Richte ein Check-In Terminal gemäß dem Artikel [Check-In Terminal einrichten](/check-in-setup) ein. Wähle als Modus **Personalisierte Registrierung & Check-In**, damit sowohl vorangemeldete Gäste per QR-Code einchecken als auch spontane Gäste sich vor Ort registrieren können.
  </Step>

  <Step title="Host-Benachrichtigungen aktivieren">
    Aktiviere in den **Organisationseinstellungen** unter **Mobile Benachrichtigungen** die Optionen **Mobile Nachrichten per SMS** und **Besucher eingecheckt (Gastgeber)**. Der Host braucht eine Mobilnummer. Optional: Aktiviere unter **anny AI** den Schalter **Gastgeber anrufen, wenn Besucher eincheckt**. Im Anruf kann der Host dem Gast eine SMS ausrichten lassen, wenn beim Gast eine Mobilnummer hinterlegt ist.
  </Step>

  <Step title="Testen">
    Erstelle eine Testbuchung mit einem Host. Checke am Terminal per QR-Code ein und prüfe, ob der Host per SMS oder Anruf benachrichtigt wird und ob (falls konfiguriert) ein Badge gedruckt wird.
  </Step>
</Steps>

<Tip>
  Setze den Modus auf "Check-In" statt "Personalisierte Registrierung & Check-In", wenn du ausschließlich vorangemeldete Gäste zulassen möchtest und spontane Registrierungen am Terminal unterbinden willst.
</Tip>

<Tip>
  Setze rechtliche Dokumente und eigene Formulare auf **Später (beim Check-in)**. Vorangemeldete Gäste müssen dann nicht schon bei der Registrierung unterschreiben. Beim Check-in werden offene Angaben und Unterschriften Pflicht.
</Tip>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Sicherheitseinweisung per Video am Check-In Terminal">
    Ein Coworking, Fitnessstudio oder Industriestandort möchte, dass jede:r Gast die **Sicherheitseinweisung am Terminal** absolviert, bevor er oder sie das Gelände betritt. Das Video muss gestartet werden, bevor der Check-in abgeschlossen werden kann.

    <Steps>
      <Step title="Rechtliches Dokument mit Video">
        Lege ein rechtliches Dokument an, z. B. "Sicherheitseinweisung". Bette das Einweisungsvideo ein (YouTube, Vimeo oder Loom) und optional Fotos zu Wegen oder Notausgängen. Nutze Checkbox oder digitale Unterschrift.
      </Step>

      <Step title="Abfrage beim Check-in">
        Setze den Abfragezeitpunkt auf **Später (beim Check-in)**, damit die Einweisung nicht schon im Checkout erscheint.
      </Step>

      <Step title="Gast startet das Video">
        Nach dem QR-Scan öffnet sich das Dokument mit dem Video-Poster. Der Gast tippt auf Play. Der Check-in bleibt gesperrt, bis das Video gestartet wurde. Danach bestätigt der Gast und der Check-in wird abgeschlossen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Unternehmen mit Empfang: Vorangemeldete und spontane Besucher">
    Ein Unternehmen möchte, dass Mitarbeitende Gäste vorab über die Buchungsseite einladen können (mit QR-Code per E-Mail), aber auch spontane Besucher:innen sich am Empfang registrieren können.

    <Steps>
      <Step title="Ressource und Buchungsoption">
        Ressource "Empfang EG" mit Kategorie Gebäude, flexible Dauer, kostenlos, automatisch annehmen.
      </Step>

      <Step title="Interne Buchungsseite">
        Setze die Buchungsoption auf **Sichtbar und buchbar nur für Community**, damit nur Mitarbeitende (Hosts) Gäste einladen können. Aktiviere unter Formulare die Option **Personalisierung voraussetzen**, sodass der Host die Buchung für den Gast personalisiert und dieser den QR-Code erhält.
      </Step>

      <Step title="Terminal mit Registrierung">
        Modus: **Personalisierte Registrierung & Check-In**. Vorangemeldete Gäste scannen ihren Code, spontane Gäste geben ihre Daten am Terminal ein.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Bürokomplex mit Empfangs-Check-in und Host-Anruf">
    Ein Bürokomplex möchte, dass Gäste am Empfang einchecken und der zugewiesene Host sofort per Anruf informiert wird, damit er den Gast abholen kann.

    <Steps>
      <Step title="Ressource und Buchungsoption">
        Ressource "Empfang Erdgeschoss" mit Kategorie Gebäude, flexible Dauer, kostenlos, automatisch annehmen. Host-Abfrage als Pflichtfeld aktivieren.
      </Step>

      <Step title="Host-Benachrichtigung per Anruf">
        Aktiviere in den **Organisationseinstellungen** die SMS-Benachrichtigung beim Check-in. Konfiguriere **anny AI** für den automatischen Anruf an den Host bei Check-in.
      </Step>

      <Step title="Terminal am Empfang">
        Modus: **Personalisierte Registrierung & Check-In**. Gast checkt ein, Host erhält sofort einen Anruf und kann dem Gast per SMS mitteilen: "Ich bin in 2 Minuten bei dir."
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Meeting aus Outlook: Gast voranmelden, mit oder ohne Raum">
    Ein Team arbeitet in Outlook und will externe Gäste schon beim Anlegen des Termins als Besucher:innen registrieren. Ein Meetingraum ist optional.

    <Steps>
      <Step title="Besucherregistrierung für Outlook">
        Richte eine Ressource der Kategorie für Besucherregistrierung ein, wie im Artikel [Outlook Add-In](/outlook-add-in) beschrieben. Aktiviere Check-in und Host-Abfrage auf dieser Ressource.
      </Step>

      <Step title="Gast im Termin registrieren">
        Die Organisator:in öffnet das Add-In, stellt die Person auf **Vor Ort** und wählt **Als Besucher registrieren**. Der Ablauf steht im Artikel [Buchen über das Outlook Add-In](/outlook-add-in-user-guide).
      </Step>

      <Step title="Check-in und Host-Nachricht">
        Am Terminal checkt der Gast ein. Formulare und Unterschriften mit **Später (beim Check-in)** werden jetzt abgefragt. Der Host erhält SMS oder anny-AI-Anruf und kann dem Gast eine SMS ausrichten.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<CardGroup>
  <Card title="Badge-Druck">
    Drucke Besucherausweise mit Name, Unternehmen und Host direkt beim Check-in. Konfiguriere Drucker und Vorlage im Terminal-Setup.

    [Erfahre hier mehr](/check-in-setup)
  </Card>

  <Card title="Sicherheitseinweisung beim Check-in">
    Zeige ein Sicherheitsvideo in einem rechtlichen Dokument am Terminal. Der Gast muss das Video starten, bevor der Check-in abgeschlossen werden kann. Nach der Unterschrift behält das PDF Poster und Watch-URL.

    [Erfahre hier mehr](/legal-documents)
  </Card>

  <Card title="Eigene Formulare beim Check-in">
    Frage zusätzliche Besucherdaten (z. B. Kennzeichen, Besuchszweck) erst beim Check-in statt im Checkout ab.

    [Erfahre hier mehr](/custom-forms)
  </Card>

  <Card title="Outlook Add-In">
    Registriere Besucher:innen direkt aus Outlook heraus, mit oder ohne Raumbuchung, und synchronisiere Termine mit anny.

    [Erfahre hier mehr](/outlook-add-in-user-guide)
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Welche Kategorie muss die Ressource haben?">
    Für den **Terminal-Check-in** muss die Ressource die Kategorie **Gebäude** verwenden. Für die **Outlook-Registrierung** findet das Add-In Ressourcen in der Kategorie **Besucherregistrierung**. Benenne beide nach dem Gebäude. Eine Ressource, die beide Wege bedienen soll, braucht aktivierten Check-in und eine Display-Zuordnung.
  </Accordion>

  <Accordion title="Welchen Modus wähle ich am Terminal?">
    **Personalisierte Registrierung & Check-In** für vorangemeldete und spontane Gäste. **Check-In** (ohne Registrierung), wenn nur vorangemeldete Gäste zugelassen sind.
  </Accordion>

  <Accordion title="Wie werden Hosts beim Check-in benachrichtigt?">
    Hosts können per E-Mail, Push-Benachrichtigung, SMS und optional per anny-AI-Anruf informiert werden. SMS schaltest du unter **Mobile Benachrichtigungen** mit **Besucher eingecheckt (Gastgeber)** ein. Den Anruf schaltest du getrennt unter **anny AI** mit **Gastgeber anrufen, wenn Besucher eincheckt** ein. Beides braucht eine Mobilnummer beim Host.
  </Accordion>

  <Accordion title="Kann ich Gäste schon in Outlook als Besucher:innen anlegen?">
    Ja. Mit dem [Outlook Add-In](/outlook-add-in-user-guide) registrierst du Teilnehmer:innen mit **Vor Ort** als Besucher:innen, mit oder ohne Raumbuchung.
  </Accordion>

  <Accordion title="Können mehrere Teilnehmer in einer Buchung eingeladen werden?">
    Ja. Bei der Buchung können mehrere Teilnehmer:innen eingeladen werden. Jede Person erhält einen eigenen QR-Code für den Check-in.
  </Accordion>

  <Accordion title="Kann der Host dem Gast beim Check-in eine Nachricht schicken?">
    Ja. Wenn anny AI konfiguriert ist und der Gast eine Mobilnummer hinterlegt hat, kann der Host über den AI-Flow eine SMS an den Gast ausrichten lassen (z. B. "Ich hole dich in 2 Minuten ab").
  </Accordion>

  <Accordion title="Kann ich eine Sicherheitseinweisung am Terminal machen?">
    Ja. Lege ein rechtliches Dokument mit eingebettetem Video an und setze den Abfragezeitpunkt auf **Später (beim Check-in)**. Der Gast muss das Video starten, bevor der Check-in abgeschlossen werden kann. Nach der Bestätigung behält das signierte PDF die Fotos und ein klickbares Video-Poster.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Zwei Wege: Terminal-Check-in braucht die Kategorie **Gebäude**. Das Outlook Add-In findet Ressourcen nur über den Kategorie-Slug `visitor-registration` (Label **Besucherregistrierung**). Das ist nicht die CMS-Kategorie **Gebäude**. Mentales Modell für beide: Ressource nach dem Gebäude benennen.
> * Eine Ressource für beide Wege: Check-in aktivieren und dem Display zuordnen.
> * Buchungsoption: kostenlos, automatisch annehmen, Host-Abfrage als Pflichtfeld im Formular
> * Host-Pool: Community erstellen, über Zugang mit Service verknüpfen
> * Terminal-Modi für Besucherverwaltung: "Personalisierte Registrierung & Check-In" (vorangemeldet + spontan) oder "Check-In" (nur vorangemeldet)
> * Interne Besuchereinladung: Buchungsoption auf "Sichtbar und buchbar nur für Community" + Personalisierung voraussetzen
> * Host-Benachrichtigungen: SMS über Org-Setting `mobileNotifications.hostedBookingCheckedIn` (Default aus) plus SMS-Kanal. Nur SMS, nicht WhatsApp/Telegram für dieses Event. AI-Anruf über `aiAgent.callHostOnCheckIn` (Default aus), Host-Mobilnummer. Beide können parallel feuern. `send_notification=false` beim Check-in unterdrückt SMS und Anruf.
> * AI-Anruf spricht den Host an und bietet eine Nachricht an den Gast an. Tool `visitor.send-sms` ist in diesem Callback automatisch verfügbar, kein manuelles SMS-Tool im AI-Dashboard nötig. Gast-SMS-Text: „Nachricht von : ". Ohne Gast-Mobilnummer kommt der Anruf trotzdem, die SMS entfällt.
> * Verzögerte Abfrage: Rechtliche Dokumente und Eigene Formulare auf "Später (beim Check-in)" (BETA in der Admin-UI). Im Checkout optional mit Hint, beim Check-in Pflicht falls noch leer. Bereits Ausgefülltes wird übersprungen.
> * Outlook-Registrierungen checken am selben Terminal nur ein, wenn Check-in auf der visitor-registration-Ressource aktiv ist und die Ressource dem Display zugeordnet ist.
> * Badge-Druck: Drucker + Vorlage im Terminal-Setup konfigurieren
> * Verzögerte Abfrage: Rechtliche Dokumente und Eigene Formulare auf "Später (beim Check-in)" setzen
> * Typischer Use Case: Sicherheitseinweisung beim Check-in. Video (YouTube/Vimeo/Loom) ins rechtliche Dokument einbetten, Abfrage beim Check-in. Der Gast muss das Video starten, bevor der Check-in abgeschlossen werden kann. Signiertes PDF: Bilder plus statisches Poster und klickbare URL.
> * Verwandte Artikel: /check-in-overview, /check-in-setup, /communities, /custom-forms, /legal-documents, /developers/guides/rich-content-media


# Gutscheine & Umsatzsteuer
Source: https://docs.anny.co/voucher-taxation

Wann ein Gutschein steuerlich als Einzweck- oder Mehrzweckgutschein gilt, wie anny Wertgutscheine behandelt und was deine Steuerkanzlei dafür braucht.

anny kennt drei Instrumente, die im Alltag alle "Gutschein" genannt werden: **Buchungspakete**, **Wertgutscheine** und **Rabattcodes**. Steuerlich sind das drei völlig verschiedene Dinge. Dieser Artikel erklärt die Einordnung nach deutschem Umsatzsteuerrecht, zeigt wo die typischen Fehler liegen und liefert deiner Steuerkanzlei die Fundstellen und Buchungssätze.

<Warning>
  Diese Dokumentation ersetzt keine steuerliche Beratung. Die Einordnung eines Gutscheins hängt von der konkreten Ausgestaltung deines Angebots ab und muss mit deiner Steuerkanzlei abgestimmt werden. anny bildet nur die von dir gewählte Konfiguration ab.
</Warning>

## Die Unterscheidung in einem Satz

Ein Gutschein ist ein **Einzweckgutschein**, wenn bei seiner Ausgabe bereits feststehen: der **leistende Unternehmer**, der **Ort der Leistung** und die **geschuldete Umsatzsteuer**. Fehlt auch nur eines davon, ist es ein **Mehrzweckgutschein**.

| | Einzweckgutschein | Mehrzweckgutschein |
| - | - | - |
| **Rechtsgrundlage** | § 3 Abs. 14 UStG | § 3 Abs. 15 UStG |
| **USt beim Verkauf** | Entsteht sofort, in voller Höhe | Keine — nicht steuerbar |
| **USt bei Einlösung** | Keine weitere (§ 3 Abs. 14 Satz 3 UStG) | Entsteht jetzt, mit dem dann geltenden Satz |
| **Rechnung beim Verkauf** | Mit USt-Ausweis | Ohne USt-Ausweis |
| **Verfall** | USt bleibt endgültig gezahlt | Nie umsatzsteuerbar |
| **In anny** | Buchungspaket | Wertgutschein |

<Note>
  Es gibt **kein Wahlrecht**. § 3 Abs. 15 UStG definiert den Mehrzweckgutschein rein negativ als "Gutschein, der kein Einzweckgutschein ist". Wenn die drei Kriterien objektiv feststehen, *ist* es ein Einzweckgutschein — unabhängig davon, wie der Gutschein bezeichnet oder gekennzeichnet wird.
</Note>

## Was in anny welcher Typ ist

| anny-Feature | Steuerliche Einordnung | Warum |
| - | - | - |
| [Buchungspaket](/booking-codes) | In der Regel **Einzweckgutschein** | Zweckgebunden auf ein konkretes Kontingent bei dir als Leistendem; Steuersatz steht fest. anny weist die USt deshalb bereits auf der Kaufrechnung aus. |
| [Wertgutschein](/value-vouchers) | **Mehrzweckgutschein** | Reiner Geldwert ohne Zweckbindung; die Kaufrechnung weist 0 % USt aus. Die Steuer entsteht erst auf der Buchungsrechnung bei Einlösung. |
| [Rabattcode](/discount-codes) | **Kein Gutschein** i. S. d. § 3 Abs. 13 UStG | Berechtigt nur zu einem Preisnachlass, nicht zum Bezug einer Leistung. Er mindert schlicht die Bemessungsgrundlage der Buchung. |

## Der häufigste Fehler: der Wertgutschein, der keiner ist

Die Voreinstellung eines anny-Wertgutscheins — freier oder fester Geldwert, einlösbar für **jede** kostenpflichtige Buchung deiner Organisation — ist ein sauberer Mehrzweckgutschein. Zwei Einstellungen können das kippen:

<Warning>
  **Nutzung begrenzen:** Schränkst du die Einlösung im Paket-Editor auf eine einzelne Ressource oder einen einzelnen Service ein, stehen Leistender, Leistungsort und Steuersatz bei Ausgabe unter Umständen bereits fest. Der Gutschein wird damit steuerlich zum **Einzweckgutschein** — obwohl anny die Kaufrechnung weiterhin mit 0 % USt erstellt. Die Umsatzsteuer wäre dann schon beim Verkauf entstanden.
</Warning>

Dasselbe gilt, wenn dein gesamtes buchbares Angebot ohnehin nur **einen einzigen Steuersatz** kennt und an einem Standort stattfindet. Prüfe deshalb vor dem Live-Schalten:

<Steps>
  <Step title="Leistender Unternehmer">
    Kommt für die Einlösung nur deine Organisation als Leistende in Frage? Bei einem Marktplatz- oder Mehr-Anbieter-Setup steht der Leistende nicht fest — das ist das stärkste Argument für einen Mehrzweckgutschein.
  </Step>

  <Step title="Leistungsort">
    Können Leistungen an unterschiedlichen Orten oder in unterschiedlichen Ländern eingelöst werden? Achtung: Raum- und Grundstücksleistungen werden nach § 3a Abs. 3 Nr. 1 UStG immer am Belegenheitsort besteuert — mehrere Räume am selben Standort helfen also nicht.
  </Step>

  <Step title="Steuersatz">
    Enthält das einlösbare Angebot mindestens zwei Steuersätze oder auch steuerfreie Leistungen (z. B. § 4 Nr. 12 oder Nr. 22 UStG)? Wenn ja, steht die geschuldete Steuer bei Ausgabe nicht fest.
  </Step>

  <Step title="Ergebnis dokumentieren">
    Halte das Prüfergebnis schriftlich fest und lass es von der Steuerkanzlei bestätigen — inklusive der Gutschein-AGB und der Einlöselogik.
  </Step>
</Steps>

### Verschiedene Leistungen reichen nicht aus

Ein verbreiteter Irrtum: "Der Gutschein gilt für viele verschiedene Leistungen, also ist er ein Mehrzweckgutschein." Das stimmt nicht. Nach Abschn. 3.17 Abs. 2 UStAE genügt die **gattungsmäßige** Angabe des Leistungsgegenstands. Solange derselbe Unternehmer, derselbe Leistungsort und derselbe Steuersatz feststehen, liegt ein Einzweckgutschein vor.

| Beispiel | Einordnung |
| - | - |
| Gutschein über 100 Euro, einlösbar für alle Meetingräume eines Standorts (alle 19 %) | Einzweckgutschein |
| Gutschein über 100 Euro, einlösbar für Räume (19 %) **und** Verpflegung (7 %) | Mehrzweckgutschein |
| Gutschein über 100 Euro, einlösbar bei mehreren Betreibern der Plattform | Mehrzweckgutschein |

<Info>
  Auch der **Leistungszeitpunkt** ist kein Kriterium. Ob der Gutschein auf einmal oder über Monate in Teilbeträgen eingelöst wird, ändert an der Einordnung nichts. Bei Mehrzweckgutscheinen entsteht die Umsatzsteuer bei jeder Teileinlösung anteilig, mit dem zu diesem Zeitpunkt geltenden Steuersatz.
</Info>

## Leistungen mit 7 % im Angebot

Wenn du bewusst einen zweiten Steuersatz im einlösbaren Angebot haben möchtest, muss die entsprechende Leistung **tatsächlich über den Gutschein einlösbar** sein und auch abgerufen werden. Ein Alibi-Artikel, den niemand kauft, trägt die Einordnung nicht und kann als Gestaltungsmissbrauch (§ 42 AO) gewertet werden.

Typische Artikel und Leistungen zum ermäßigten Steuersatz:

| Leistung / Artikel | Fundstelle | Hinweis |
| - | - | - |
| Speisen im Rahmen von Verpflegung und Catering (Tagungsverpflegung, Snackverkauf vor Ort) | § 12 Abs. 2 Nr. 15 UStG | Seit **01.01.2026** dauerhaft 7 %. **Getränke bleiben 19 %.** Bei Kombi-Angeboten erlaubt die Verwaltung eine Aufteilung mit 30 % Getränkeanteil. |
| Kurzfristige Beherbergung, Camping- und Stellplätze | § 12 Abs. 2 Nr. 11 UStG | Frühstück und sonstige Nebenleistungen bleiben 19 % (Aufteilungsgebot). |
| Gedruckte Bücher und Broschüren | Anlage 2 Nr. 49 UStG | Rechtlich die unstrittigste Variante. |
| E-Books, E-Paper und digitale Fachpublikationen | § 12 Abs. 2 Nr. 14 UStG | Nicht begünstigt, wenn der Inhalt überwiegend **Werbezwecken** dient oder überwiegend aus Video/Audio besteht. Ein Produkt-Whitepaper fällt damit heraus. |
| Röstkaffee (Bohnen oder gemahlen), Tee | Anlage 2 Nr. 12 UStG | Löslicher Kaffee und Kaffee-/Tee-Extrakte sind 19 %. |
| Verpackte Snacks: Nüsse, Riegel, Kekse, Obst | Anlage 2 UStG | Luxusartikel wie Kaviar, Hummer und Langusten bleiben 19 %. |
| Milch und Milchmischgetränke ab 75 % Milchanteil | Anlage 2 Nr. 35 UStG | Eine der wenigen Getränke-Ausnahmen. |
| Eintrittsberechtigungen für Theater, Konzerte und Museen | § 12 Abs. 2 Nr. 7a UStG | Relevant für Kultur- und Veranstaltungsbetriebe. |

<Warning>
  **Wasserflaschen sind nicht 7 %.** Anlage 2 Nr. 34 UStG nimmt Trinkwasser, Quellwasser und Tafelwasser ausdrücklich aus, sobald es **in Fertigpackungen** in den Verkehr gebracht wird — abgefülltes Wasser ist also 19 %, unabhängig von der Gebindegröße. Die 7 % gelten praktisch nur für die Lieferung durch Wasserversorger. Merksatz: **Getränke sind im Grundsatz 19 %**, Essbares überwiegend 7 %.
</Warning>

## Buchung und DATEV-Export

anny bucht Wertgutscheine über ein eigenes **Bestandskonto**, nicht über ein Erlöskonto. Beim Verkauf entsteht eine Verbindlichkeit gegenüber der Kundin oder dem Kunden; erst die Einlösung erzeugt Umsatz auf dem Erlöskonto des jeweiligen Steuersatzes.

| Geschäftsvorfall | Soll | Haben | USt |
| - | - | - | - |
| Verkauf Wertgutschein | Forderungen | Wertgutschein-Konto | ohne Steuerschlüssel |
| Einlösung (ganz oder teilweise) | Wertgutschein-Konto | Erlöskonto nach Steuersatz | mit Steuerschlüssel |
| Verkauf Buchungspaket (Einzweckgutschein) | Forderungen | Erlöskonto nach Steuersatz | mit Steuerschlüssel |
| Ausbuchung nach Verjährung | Wertgutschein-Konto | Sonstige betriebliche Erträge | ohne Steuerschlüssel |

Die Kontonummern hinterlegst du in der DATEV-Integration. Welche Konten dafür nötig sind, was sie bedeuten und was die Steuerkanzlei vorbereiten muss, steht in [DATEV-Konten und Vorbereitung mit dem Steuerberater](/datev-accounts-and-tax-advisor). Die technische Einrichtung des automatischen Exports findest du unter [DATEV mit anny verbinden](/datev-integration).

<Info>
  Im SKR 03 heißt das passende Konto üblicherweise **1796 "Ausgegebene Geschenkgutscheine"** (SKR 04: **3786**). Erlöse laufen üblicherweise über **8400** (19 %) und **8300** (7 %), sonstige betriebliche Erträge über **8600**. Die verbindliche Zuordnung kommt von deiner Steuerkanzlei — anny bildet nur ab, was du hinterlegst.
</Info>

<Note>
  Setze beim Verkauf eines Mehrzweckgutscheins **keinen** Umsatzsteuer-Schlüssel. Wird versehentlich mit USt gebucht und ausgewiesen, entsteht ein unrichtiger Steuerausweis nach § 14c Abs. 1 UStG — die ausgewiesene Steuer wird geschuldet, obwohl gar kein Umsatz vorliegt.
</Note>

## Nicht eingelöste Gutscheine

Bei einem Mehrzweckgutschein löst der Verfall **keine Umsatzsteuer** aus. Es wurde nie eine Leistung erbracht, es gibt also nichts zu versteuern und nichts nach § 17 UStG zu berichtigen. Ertragsteuerlich sieht es anders aus.

<Steps>
  <Step title="Verbindlichkeit bleibt passiviert">
    Der verkaufte Gutschein steht als sonstige Verbindlichkeit in der Bilanz, bis der Anspruch erloschen ist oder mit einer Inanspruchnahme ernsthaft nicht mehr zu rechnen ist.
  </Step>

  <Step title="Regelverjährung abwarten">
    Nach §§ 195, 199 Abs. 1 BGB verjährt der Anspruch in **drei Jahren**, gerechnet ab Schluss des Ausgabejahres. Ein am 15.03.2026 verkaufter Gutschein verjährt also mit Ablauf des 31.12.2029.
  </Step>

  <Step title="Ertragswirksam ausbuchen">
    Die Ausbuchung erfolgt gegen sonstige betriebliche Erträge. Der Ertrag unterliegt Körperschaft- und Gewerbesteuer, aber keiner Umsatzsteuer.
  </Step>
</Steps>

<Warning>
  **Das Verfallsdatum in anny ist nicht die Verjährungsfrist.** Der Standardwert von 730 Tagen steuert nur, wann anny den Code technisch sperrt. Zivilrechtlich unterliegt eine Befristung in AGB der Inhaltskontrolle nach § 307 BGB, und die Rechtsprechung hat kurze Laufzeiten bei entgeltlich erworbenen Wertgutscheinen wiederholt für unwirksam erklärt. Ist die Klausel unwirksam, gilt weiterhin die Dreijahresfrist — und selbst bei wirksamer Befristung kann bereicherungsrechtlich nach § 812 BGB Wertersatz abzüglich des entgangenen Gewinns verlangt werden. Buche deshalb nicht zum Ablauf des Codes aus, sondern nach Ablauf der Verjährung.
</Warning>

<Tip>
  Halte die offenen Gutscheine **nach Ausgabejahrgang** getrennt nach — über den Export unter **Buchungscodes** oder eigene Unterkonten. Ohne diese Staffelung lässt sich zum Abschluss nicht ermitteln, welcher Teil des Kontosaldos verjährt ist, und die Ausbuchung wird zur Schätzung. Stimme den Saldo des Gutscheinkontos zu jedem Stichtag gegen den offenen Bestand in anny ab.
</Tip>

<Note>
  Eine **statistische Teilausbuchung** nach erwarteter Einlösequote (Breakage) ist handels- und steuerbilanziell nicht zulässig — die Verbindlichkeit bleibt bis zum Erlöschen in voller Höhe passiviert. IFRS 15 erlaubt das abweichend; wenn du parallel nach IFRS-Logik reportest, laufen die Zahlen hier bewusst auseinander.
</Note>

## Fundstellen für die Steuerkanzlei

| Thema | Fundstelle |
| - | - |
| Gutschein-Definition | § 3 Abs. 13 UStG |
| Einzweckgutschein | § 3 Abs. 14 UStG |
| Mehrzweckgutschein | § 3 Abs. 15 UStG |
| Verwaltungsauffassung | Abschn. 3.17 UStAE |
| Einführung der Systematik | Gesetz vom 11.12.2018 (BGBl I 2018, 2338), anwendbar auf nach dem 31.12.2018 ausgestellte Gutscheine |
| Umsetzung EU-Recht | Gutschein-Richtlinie (EU) 2016/1065; Art. 30a, 30b MwStSystRL |
| BMF-Schreiben Gutscheine | BMF vom 02.11.2020, III C 2 – S 7100/19/10001 :002 |
| Digitale Publikationen | BMF vom 17.12.2021 zu § 12 Abs. 2 Nr. 14 UStG |
| Mehrstufiger Vertrieb | EuGH vom 18.04.2024, C-68/23 (Finanzamt O) |
| Übertragung von Einzweckgutscheinen | BFH vom 25.06.2025, XI R 14/24 |
| Verjährung | §§ 195, 199 BGB; AGB-Kontrolle § 307 BGB; Wertersatz § 812 BGB |

## Häufige Fragen

<AccordionGroup>
  <Accordion title="Können wir frei wählen, ob wir Einzweck- oder Mehrzweckgutscheine ausgeben?">
    Nein. Die Einordnung folgt aus den objektiven Umständen bei Ausgabe, nicht aus der Bezeichnung. Gestalten lässt sich nur der Sachverhalt: Wer kann leisten, wo wird geleistet, welche Steuersätze sind einlösbar. Die Kennzeichnung auf dem Gutschein ist Folge dieser Einordnung, nicht deren Ursache.
  </Accordion>

  <Accordion title="Was passiert, wenn wir einen Einzweckgutschein versehentlich als Mehrzweckgutschein behandelt haben?">
    Die Umsatzsteuer wäre bereits bei Ausgabe entstanden. In einer Betriebsprüfung führt das zu Nachzahlungen für alle offenen Jahre zuzüglich Zinsen nach § 233a AO. Zusätzlich entfällt rückwirkend die Steuerfreiheit der Erträge aus verfallenen Gutscheinen. Sprich den Fall frühzeitig mit deiner Steuerkanzlei durch.
  </Accordion>

  <Accordion title="Warum weist die Kaufrechnung eines Wertgutscheins 0 % USt aus?">
    Weil beim Verkauf eines Mehrzweckgutscheins noch kein steuerbarer Umsatz vorliegt — der Vorgang ist umsatzsteuerlich ein bloßer Tausch von Zahlungsmitteln. Die Umsatzsteuer entsteht erst auf der Buchungsrechnung bei Einlösung.
  </Accordion>

  <Accordion title="Wie werden Teileinlösungen behandelt?">
    Jede Teileinlösung erzeugt anteilig Umsatz mit dem zu diesem Zeitpunkt geltenden Steuersatz und eine eigene Rechnung. Das Restguthaben bleibt auf dem Gutscheinkonto stehen und ist weiterhin nicht steuerbar.
  </Accordion>

  <Accordion title="Was gilt bei einer Änderung des Steuersatzes zwischen Verkauf und Einlösung?">
    Beim Mehrzweckgutschein gilt für jede Einlösung der dann geltende Satz. Beim Einzweckgutschein ist der Satz mit der Ausgabe fixiert. Eine bevorstehende gesetzliche Satzänderung macht einen Gutschein übrigens nicht zum Mehrzweckgutschein.
  </Accordion>

  <Accordion title="Ist ein Stornierungsguthaben ein Gutschein im steuerlichen Sinn?">
    Wird eine Stornierung als Wertgutschein erstattet, entsteht ein neuer Mehrzweckgutschein — der ursprüngliche Umsatz wird über die Stornorechnung korrigiert. Die konkrete Behandlung hängt davon ab, ob die Ursprungsrechnung bereits festgeschrieben war; kläre den Ablauf mit deiner Steuerkanzlei.
  </Accordion>

  <Accordion title="Was gilt außerhalb Deutschlands?">
    Die Systematik Einzweck/Mehrzweck ist EU-weit über die Gutschein-Richtlinie harmonisiert, die konkreten Steuersätze und Verjährungsfristen sind es nicht. Für Organisationen in Österreich oder der Schweiz gelten abweichende Regeln — die Angaben in diesem Artikel beziehen sich auf Deutschland.
  </Accordion>
</AccordionGroup>

## Nächste Schritte

<Steps>
  <Step title="Konfiguration prüfen">
    Sieh dir für jedes aktive Paket an, ob "Nutzung begrenzen" gesetzt ist und welche Steuersätze im einlösbaren Angebot vorkommen.
  </Step>

  <Step title="Einordnung bestätigen lassen">
    Leg deiner Steuerkanzlei die Gutschein-AGB, die Einlöselogik und diesen Artikel vor und lass die Einordnung schriftlich bestätigen.
  </Step>

  <Step title="Konten hinterlegen">
    Trage die bestätigten Sachkonten in der [DATEV-Integration](/datev-accounts-and-tax-advisor) ein.
  </Step>

  <Step title="Ausbuchungsprozess festlegen">
    Vereinbare, wann und auf welches Konto verjährte Gutscheine ausgebucht werden, und verankere das als festen Schritt im Jahresabschluss.
  </Step>
</Steps>

> Wichtige Informationen für Agenten:
>
> **Zweck dieses Artikels:** Steuerliche Einordnung von Gutscheinen für Admins und Steuerkanzleien. Produktfunktionen stehen in `value-vouchers` und `booking-codes`, Konten in `datev-accounts-and-tax-advisor`.
>
> **Kernregel:** Einzweckgutschein = leistender Unternehmer, Leistungsort und geschuldete USt stehen bei Ausgabe fest (§ 3 Abs. 14 UStG). Alles andere ist Mehrzweckgutschein (§ 3 Abs. 15 UStG). Kein Wahlrecht.
>
> **anny-Zuordnung:** Wertgutschein = Mehrzweckgutschein (0 % USt beim Kauf). Buchungspaket = in der Regel Einzweckgutschein (USt beim Kauf). Rabattcode = kein Gutschein i. S. d. § 3 Abs. 13 UStG.
>
> **Wichtigster Produkt-Hinweis:** "Nutzung begrenzen" auf eine einzelne Ressource/Service kann einen Wertgutschein steuerlich zum Einzweckgutschein machen, obwohl anny weiter mit 0 % fakturiert. Immer flaggen.
>
> **Gattungsangabe genügt:** Verschiedene Leistungen mit gleichem Steuersatz, Ort und Leistendem = Einzweckgutschein (Abschn. 3.17 Abs. 2 UStAE). Leistungszeitpunkt ist kein Kriterium.
>
> **7 %:** Speisen (§ 12 Abs. 2 Nr. 15 UStG, seit 01.01.2026; Getränke bleiben 19 %), Beherbergung/Camping (Nr. 11), Bücher (Anlage 2 Nr. 49), E-Books (Nr. 14, nicht bei überwiegender Werbung), Röstkaffee/Tee, verpackte Snacks, Milch ab 75 %, Eintritte Theater/Konzert/Museum (Nr. 7a). **Wasser in Fertigpackungen ist 19 %** (Anlage 2 Nr. 34) — häufiger Irrtum.
>
> **Buchung:** Verkauf Forderungen an Gutscheinkonto ohne Steuerschlüssel; Einlösung Gutscheinkonto an Erlöskonto mit Steuerschlüssel. SKR 03: 1796 (SKR 04: 3786), Erlöse 8400/8300, sonstige betriebliche Erträge 8600. USt-Schlüssel beim Verkauf = § 14c-Risiko.
>
> **Verfall:** Umsatzsteuerlich folgenlos. Ausbuchung erst nach Verjährung (§§ 195, 199 BGB: 3 Jahre ab Schluss des Ausgabejahres), nicht zum anny-Verfallsdatum (730 Tage). Keine Breakage-Teilausbuchung in HGB/Steuerbilanz.
>
> **Rechtsstand:** Deutschland, Stand August 2026. Nie als Steuerberatung formulieren, immer auf die Steuerkanzlei verweisen.


# Warteliste
Source: https://docs.anny.co/waitlist

Benachrichtige Kund:innen automatisch, sobald ein ausgebuchter Zeitslot wieder frei wird.

Die Warteliste informiert deine Kund:innen automatisch per E-Mail, wenn ein zuvor ausgebuchter Zeitslot wieder verfügbar ist. So geht keine Nachfrage verloren und deine Ressourcen werden optimal ausgelastet.

<Info>
  Verfügbar ab dem Professional-Plan.
</Info>

## Wie funktioniert die Warteliste?

Die Warteliste greift, sobald alle Plätze eines Zeitslots belegt sind. Der Ablauf:

1. Eine Kund:in wählt auf der Buchungsseite eine Ressource und ein Datum.
2. Ist der gewünschte Zeitraum ausgebucht, erscheint der Hinweis "Der angefragte Zeitraum ist ausgebucht".
3. Mit Klick auf **Auf Warteliste setzen** sieht die Kund:in eine Zusammenfassung.
4. Nach Bestätigung ist die Kund:in auf der Warteliste eingetragen.
5. Wird der Slot frei (z. B. durch Stornierung), wartet anny die eingestellte Zeitverzögerung ab.
6. Ist der Slot nach Ablauf der Verzögerung noch frei, versendet anny eine Benachrichtigung per E-Mail.
7. Die Kund:in bucht den freigewordenen Slot selbst. Ein automatisches Nachrücken findet nicht statt.

Die Buchungsseite zeigt den Wartelisten-Button nur, wenn ein Slot tatsächlich ausgebucht ist. Bei manuell geblockten Zeiträumen (Globale Blocker) wird keine Warteliste angeboten.

<Tip>
  Die Warteliste wird vollständig vom System verwaltet. Du kannst Einträge weder manuell hinzufügen noch entfernen.
</Tip>

## Wann nutze ich das?

* **Du hast Ressourcen, die regelmäßig ausgebucht sind**: Die Warteliste hält die Nachfrage fest und sorgt dafür, dass freigewordene Plätze schnell neu belegt werden.
* **Du möchtest Stornierungslücken automatisch füllen**: Ohne manuellen Aufwand werden wartende Kund:innen über neue Verfügbarkeiten informiert.
* **Du bietest Events oder Kurse mit begrenzten Plätzen an**: Kund:innen können sich vormerken lassen, statt die Buchungsseite wiederholt zu prüfen.
* **Nicht geeignet für**: Ressourcen, die selten ausgebucht sind oder bei denen du Buchungen manuell zuweisen möchtest. In diesen Fällen reicht die reguläre Buchungslogik.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Erlaube Kunden der Warteliste beizutreten | Aktiviert die Warteliste für diese Ressource |
| Zeitverzögerung (in Minuten) | Wartezeit zwischen Freiwerden und E-Mail-Versand |

<Steps>
  <Step title="Ressource öffnen">
    Öffne unter Ressourcen die Ressource, für die eine Warteliste aktiviert werden soll. Navigiere zum Reiter **Verfügbarkeit**.
  </Step>

  <Step title="Warteliste aktivieren">
    Klappe die Warteliste über den >-Pfeil links auf und aktiviere den Toggle bei **Erlaube Kunden der Warteliste beizutreten**. Stelle die Zeitverzögerung der Benachrichtigung ein. 
  </Step>
</Steps>

<Tip>
  Setze die Zeitverzögerung auf wenige Minuten (z. B. 5), wenn du möchtest, dass freigewordene Slots schnell neu belegt werden. Eine längere Verzögerung (z. B. 30 Minuten) gibt mehreren Wartenden gleichzeitig eine faire Chance.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Kursanbieter mit limitierten Plätzen">
    Ein Yoga-Studio bietet Kurse mit 12 Plätzen an. Die Kurse sind häufig ausgebucht und Kund:innen sollen automatisch erfahren, wenn ein Platz frei wird.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Können sich auch nicht registrierte Nutzer:innen auf die Warteliste setzen?">
    Nein. Die Warteliste ist nur für registrierte Nutzer:innen verfügbar. Gast-Buchungen werden nicht unterstützt.
  </Accordion>

  <Accordion title="Was passiert, wenn der Slot während der Zeitverzögerung erneut gebucht wird?">
    In diesem Fall wird keine Benachrichtigung versendet. Die E-Mail geht nur raus, wenn der Slot nach Ablauf der Verzögerung noch frei ist.
  </Accordion>

  <Accordion title="Funktioniert die Warteliste bei Child-Ressourcen?">
    Ja, die Warteliste kann auch bei Child-Ressourcen aktiviert werden. Kund:innen können sich jedoch nicht für eine bestimmte Child-Ressource vormerken lassen, sondern nur für die Hauptressource.
  </Accordion>

  <Accordion title="Rückt die wartende Person automatisch nach?">
    Nein. Die Kund:in erhält lediglich eine Benachrichtigung und muss den Slot anschließend selbst buchen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Wartelisten-Button wird auf der Buchungsseite nicht angezeigt">
    Die Warteliste erscheint nur bei tatsächlich ausgebuchten Slots. Prüfe, ob ein Globaler Blocker den Zeitraum sperrt statt einer echten Ausbuchung. Bei Blockern wird keine Warteliste angezeigt.
  </Accordion>

  <Accordion title="Kund:innen erhalten keine Benachrichtigungs-E-Mail">
    Prüfe die eingestellte Zeitverzögerung. Wird der Slot innerhalb der Verzögerung erneut gebucht, geht keine Mail raus. Stelle außerdem sicher, dass die Kund:in eine gültige E-Mail-Adresse hinterlegt hat.
  </Accordion>

  <Accordion title="Die Warteliste wird in der mobilen App nicht angezeigt">
    Die Darstellung der Warteliste in der mobilen anny App wird aktuell noch optimiert. Nutze in der Zwischenzeit die Browser-Buchungsseite.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> UI-Pfad: **Ressourcen** > Ressource auswählen > **Verfügbarkeit** > Abschnitt **Warteliste**. Greift NUR bei ausgebuchten Slots (alle Plätze belegt). Bei geblockten Zeiträumen (Globale Blocker) wird KEINE Warteliste angeboten. Kein automatisches Nachrücken: nur Benachrichtigung, Kund:innen buchen selbst. Nur für registrierte Nutzer:innen, nicht für Gast-Buchungen. Bei Child-Ressourcen: Warteliste gilt für die Hauptressource, keine Auswahl einer bestimmten Child-Ressource möglich. Zeitverzögerung = Wartezeit in Minuten zwischen Freiwerden und E-Mail-Versand. Wird der Slot in dieser Zeit erneut belegt, geht keine Mail raus. Dashboard-Widget "Warteliste nach Ressource" zeigt aktive Wartelistenplätze. Verfügbar ab Professional-Plan.


# Willkommen bei anny
Source: https://docs.anny.co/welcome

Lerne anny kennen: das flexible Buchungssystem für Räume, Arbeitsplätze, Events und alles, was buchbar ist.

<img alt="Buchungsseite EN" />

## Was ist anny?

anny ist das flexible Buchungssystem für Ressourcen aller Art: Arbeitsplätze, Meetingräume, Parkplätze, Equipment, Events, Kurse, Dienstleistungen und mehr. Ersetze Insellösungen mit einer zentralen Plattform, die sich deinen Anforderungen anpasst.

## Wie ist anny aufgebaut?

anny besteht aus zwei Bereichen:

<Columns>
  <Column>
    **Adminbereich**<br />Hier richtest du deine Ressourcen ein, konfigurierst Buchungsregeln, verwaltest Buchungen und Kund:innen, aktivierst Features und steuerst deinen gesamten Account.
  </Column>

  <Column>
    **Buchungsseite**<br />Hier buchen deine Kund:innen, Mitarbeitenden oder Mitglieder deine Ressourcen. Die Buchungsseite bietet verschiedene Ansichten: Entdecken, Kalender, Wochenplaner und interaktive Karten.
  </Column>
</Columns>

## Für wen ist anny?

**HR, People & Culture** Teams, die hybrides Arbeiten organisieren: Arbeitsplätze, Meetingräume und Parkplätze zentral buchbar machen und die Auslastung transparent steuern.

**Operations & Facility Management** Facility-Teams, die Räume, Equipment, Besucher:innen und Gebäudeinfrastruktur effizient verwalten und Buchungsprozesse automatisieren möchten.

**Coworking-Betreiber:innen** Betreiber:innen, die Arbeitsplätze, Büros und Meetingräume mit flexiblen Mitgliedschaften und Kontingenten anbieten.

**Event- & Kursanbieter:innen** Organisationen, die Events, Workshops oder wiederkehrende Kurse mit Ticketing, Check-in und Teilnehmermanagement abwickeln.

**Bildungseinrichtungen** Universitäten und Bibliotheken, die Lernplätze, Lernräume und Laborzeiten kapazitätsgesteuert bereitstellen.

**Dienstleister:innen** Unternehmen, die Beratungstermine, Behandlungen oder individuelle Services mit Kalenderintegration und Online-Zahlung anbieten.

## Warum anny?

* **Ein System statt vieler Insellösungen:** Arbeitsplätze, Räume, Events, Equipment und mehr in einer Plattform verwalten, statt separate Tools für jeden Use Case zu betreiben.
* **Flexibel konfigurierbar:** Über 100 Features, die du nach Bedarf aktivierst. Von Communities über 3D-Karten bis hin zu dynamischem Pricing gestaltest du deinen Buchungsprozess ohne Kompromisse.
* **Integrationen:** Verbinde anny mit deinen bestehenden Tools wie Microsoft 365, Google Workspace, Personio, Zoom, Nuki und vielen mehr.
* **anny AI:** Ein KI-Assistent, der Anrufe entgegennimmt, Kund:innen berät, Verfügbarkeiten prüft und Buchungen erstellt, per Telefon und Chat.

## Sicherheit, Datenschutz & Compliance

anny wird in Deutschland entwickelt und gehostet. Deine Daten sind DSGVO-konform geschützt.

* **ISO 27001 zertifiziert:** Die gesamte Infrastruktur von anny ist nach ISO 27001 zertifiziert.
* **DSGVO-konform:** Alle Daten werden auf deutschen Servern verarbeitet und gespeichert.
* **Dedizierte Umgebung:** Für öffentliche Einrichtungen und Kommunen bietet anny eine eigene, getrennte Umgebung.
* **Löschfristen:** Konfigurierbare Löschfristen ermöglichen die automatische Anonymisierung von Buchungs- und Kundendaten.

<Tip>
  Besuche das [anny Trust Center](https://trust.anny.co/) für detaillierte Informationen zu Sicherheitszertifizierungen und Datenschutzrichtlinien.
</Tip>

## Nächste Schritte

<Columns>
  <Column>
    <Card title="Dein Start mit anny" icon="stairs">
      Erstelle deinen Account und mach dich mit dem Adminbereich vertraut, um deine erste Ressource anzulegen.

      [Erfahre hier mehr](/getting-started)
    </Card>
  </Column>

  <Column>
    <Card title="Buchungsseite" icon="butterfly">
      Schaue dir an, wie deine Ressourcen auf der Buchungsseite aussehen und Kund:innen buchen. 

      [Erfahre hier mehr](/booking-page-layout)
    </Card>
  </Column>

  <Column>
    <Card title="anny AI" icon="volume-control-phone">
      Richte den KI-Assistenten ein, der deine Kund:innen per Telefon & Chat berät und Buchungen erstellt.

      [Erfahre hier mehr](/anny-ai-setup)
    </Card>
  </Column>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="Muss ich technische Vorkenntnisse haben, um anny einzurichten?">
    Nein. anny ist so aufgebaut, dass du alles über den Adminbereich konfigurieren kannst, ohne Programmierkenntnisse. Bei Bedarf bietet anny eine offene API für individuelle Anbindungen.
  </Accordion>

  <Accordion title="Kann ich anny für mehrere Use Cases gleichzeitig nutzen?">
    Ja. Du kannst in einem Account verschiedene Ressourcentypen anlegen, zum Beispiel Arbeitsplätze, Meetingräume und Events. Jede Ressource wird unabhängig konfiguriert.
  </Accordion>

  <Accordion title="Welchen Plan brauche ich zum Start?">
    Nach der Account-Erstellung testest du **5 Tage** alle Features kostenlos. Danach bleibt der kostenlose **Starter-Plan** (5 Ressourcen, 5 Buchungsoptionen, 100 Buchungen/Monat), oder du wechselst auf Essential, Professional, Business oder Enterprise. Beim Upgrade auf Essential oder Professional gilt eine **14-tägige** Plan-Testphase. Details: [anny Plan verwalten](/anny-plan).
  </Accordion>

  <Accordion title="Ist anny auch für große Organisationen geeignet?">
    Ja. anny wird von Unternehmen mit über 1.000 Mitarbeitenden genutzt und bietet Enterprise-Features wie SSO, dedizierte Umgebungen und Priority Support.
  </Accordion>

  <Accordion title="In welchen Sprachen ist anny verfügbar?">
    anny ist in 29 Sprachen verfügbar. Die Buchungsseite wird automatisch in der Sprache deiner Kund:innen angezeigt.
  </Accordion>
</AccordionGroup>


# Widget Agent Skill
Source: https://docs.anny.co/widget-agent-skill



<Note>
  Verwende diesen Agent Skill, um die Widget Integration für deine Website einzurichten.
</Note>

```yaml theme={null}
---
name: anny-widget-integration
description: >
  How to embed anny booking widgets and the AI chat assistant on a website. Use when integrating
  anny widgets into a site, landing page, or web app. Covers script setup, widget types, seamless
  layout embedding (panels in cards, no extra padding, overflow hidden, border radius),
  full-page vs panel vs button vs AI chat widgets, fullscreen with nav-height for single-scroll
  pages, height behavior, design tokens, login/cart placement in the top-right nav,
  and asking for the correct resource/service/organization/plan/package slug before generating code.
---
```

# anny Widget Integration

## Quick Facts

* Widgets are **web components** (custom HTML elements).
* One `<script>` tag loads all widgets. Load it once per page.
* Widgets communicate via the iframe they contain — **no extra wrapper div or padding is needed**. Place the element directly where you want the content.
* Panels auto-resize to their content. Page widgets and maps support `fullscreen` or a fixed `height`.
* **Prefer `fullscreen="true"` + `nav-height` for full-page booking** so the page itself never scrolls — only the widget scrolls internally. This avoids the awkward double scrollbar (page scroll *and* widget scroll).
* **Put `a-login-button` and `a-cart-modal-button` in the top-right of the main navigation.** The cart should show icon + count indicator only (`show-icon="true"`, no label).
* `a-agent-chat` embeds the **anny AI chat assistant** — a launcher in the corner, an in-flow button, or an inline frame. It can drive the whole booking flow conversationally.
* UTMs and click IDs from the current page URL are forwarded automatically.
* Start in admin when possible. Admin-generated snippets are the safest source for widget type, slug wiring, and supported options.

## Ask First

Before generating integration code, make sure these inputs are known:

1. Which widget type is needed: page, panel, button, utility, or AI chat?
2. Which entity is being embedded: `resource`, `service`, `organization`, `plan`, or `package`?
3. What is the exact slug for that entity? (For `a-agent-chat`, the `organization` slug and an `assistant-id`.)
4. Is booking the main page content, part of an existing layout, or behind a CTA?
5. Are login and cart needed in the main nav (top-right)?

If the widget depends on an entity slug and the slug is missing, **ask the user for it before writing the final snippet**.

Use these prompts:

* "What is the exact resource slug?"
* "What is the exact service slug?"
* "What is the exact organization slug?"
* "What is the exact plan slug?"
* "What is the exact package slug?"

Do not guess slugs.

### When details are missing, ask for the admin snippet

If a required value isn't obvious — an `assistant-id` for `a-agent-chat`, an `idp-uuid` for SSO, or any slug — **ask the user to paste the widget code copied from the anny admin area** rather than guessing. Admin generates a ready-made snippet with the element, the correct slugs/ids, and supported options already wired.

Prompt:

* "Open this widget in the anny admin area, copy the generated embed code, and paste it here — I'll adapt it to your site."

Then keep the admin-provided slugs/ids verbatim and only adjust layout, theming, and placement around them.

## Integration Workflow

1. Ask for the missing slug if the widget is entity-based.
2. Choose the right widget type: page, panel, button, utility, or AI chat.
3. Load the widget script once.
4. Add the required entity slug attribute for that widget.
5. Place the widget directly into the page layout. For full-page booking, prefer `fullscreen="true"` + `nav-height` so only the widget scrolls.
6. If embedding inside a card, style the wrapper, not the widget.
7. Add `a-login-button` and `a-cart-modal-button` once in the top-right of the main nav when needed (cart = icon + count only).
8. Add design tokens as HTML attributes if brand customization is needed.
9. Add event listeners only if external tracking hooks such as GA4 are needed.

## Fast Decision Guide

| Need | Choose |
| - | - |
| Booking is the main content of the page | page widget (`fullscreen="true"` + `nav-height`) |
| Existing marketing/editorial page needs embedded booking flow | panel widget |
| Booking should open after a click | button widget |
| Shared auth or cart control in nav | utility widget (top-right) |
| Conversational / assisted booking, support-style helper | AI chat (`a-agent-chat`) |

Prefer admin-generated snippets when the user already has the widget configured in anny admin. Use manual HTML when building the integration directly in code or when custom layout control is needed.

## Preferred Defaults For New Websites

When building a new website from scratch, prefer these defaults unless the user asks for a different pattern:

1. Use page content plus a booking panel in the layout.
2. **For a dedicated booking page, use a fullscreen page widget with `nav-height` set to your header height.** This gives a single scroll *inside* the widget and none on the page — no double scrollbar.
3. **Put `a-login-button` and `a-cart-modal-button` in the top-right of the main navigation.** Render the cart as icon + count only (`show-icon="true"`, no `label`).
4. Use `a-subscription-button` for plans instead of embedding the plan page inline.
5. Use a fullscreen calendar page when calendar browsing is a primary use case.
6. Add `a-agent-chat` as a bottom-right launcher when the site benefits from assisted/conversational booking or a support helper.

| Scenario | Preferred pattern |
| - | - |
| Dedicated booking page | page widget with `fullscreen="true"` + `nav-height="64px"` (single in-widget scroll) |
| Landing page or marketing page with booking | content + `a-resource-booking-panel` or `a-service-booking-panel` |
| Auth + cart in site chrome | `a-login-button` + `a-cart-modal-button`, top-right of the main nav (cart = icon + count) |
| Plan / subscription sales | `a-subscription-button` |
| Calendar-first experience | `a-resource-calendar` or `a-organization-calendar` with `fullscreen="true"` + `nav-height` |
| Assisted / conversational booking | `a-agent-chat` launcher (`placement="bottom-right"`) |

Do not default every new site to a full embedded page widget *inside* a content layout. Either give booking its own fullscreen page (with `nav-height`), or embed a panel in the existing layout — pick based on whether booking is the whole page.

## Script

```html theme={null}
<script src="https://cdn.anny.co/widget/annyComponents.umd.latest.min.js"></script>
```

Place once in `<head>` or before `</body>`. Do not load more than once per page.

## Widget Types

| Type | Elements | Use when |
| - | - | - |
| **Page widget** | `a-organization-page`, `a-resource-page`, `a-service-page`, `a-resource-calendar`, `a-resource-map`, `a-organization-map`, `a-organization-calendar`, `a-subscription-page`, `a-package-page`, `a-my-bookings` | Booking is the main content of the page or section |
| **Panel widget** | `a-resource-booking-panel`, `a-service-booking-panel` | You already have a page layout and want the booking flow embedded inside it |
| **Button widget** | `a-resource-button`, `a-service-button`, `a-organization-button`, `a-subscription-button`, `a-package-button`, `a-modal-button` | Booking opens on user click in a modal |
| **Utility** | `a-login-button`, `a-cart-modal-button` | Shared auth/cart controls — place top-right in the main nav |
| **AI chat** | `a-agent-chat` | Conversational / assisted booking and support — launcher, in-flow button, or inline frame |

## Minimal Page Skeleton

```html theme={null}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Booking</title>
<script src="https://cdn.anny.co/widget/annyComponents.umd.latest.min.js"></script>
</head>
<body>
<!-- Main nav: brand on the left, links in the middle, auth + cart top-right -->
<header style="display: flex; align-items: center; gap: 16px; padding: 0 24px; height: 64px;">
<a href="/">Logo</a>
<nav style="flex: 1;"><!-- navigation links --></nav>
<a-login-button base-url="https://anny.co"></a-login-button>
<a-cart-modal-button base-url="https://anny.co" modal-layout="drawer" show-icon="true"></a-cart-modal-button>
</header>

<main>
<a-resource-booking-panel
base-url="https://anny.co"
resource="my-resource"
></a-resource-booking-panel>
</main>
</body>
</html>
```

For a **dedicated booking page** where booking is the whole page, swap the panel in `<main>` for a fullscreen page widget so only the widget scrolls:

```html theme={null}
<main>
<a-resource-page
base-url="https://anny.co"
resource="my-resource"
fullscreen="true"
nav-height="64px"
></a-resource-page>
</main>
```

## Seamless Embedding Patterns

### Panel inside a card

Panels resize dynamically. Put them directly inside a card — no extra wrapper or padding needed. Apply `overflow: hidden` and `border-radius` to the card, not the widget element.

```html theme={null}
<div style="border-radius: 16px; overflow: hidden; box-shadow: 0 4px 24px rgba(0,0,0,.1);">
<a-resource-booking-panel
base-url="https://anny.co"
resource="my-resource"
></a-resource-booking-panel>
</div>
```

Do **not** add padding inside the card around the widget — the widget handles its own internal spacing.

### Full-page widget with a single internal scroll (preferred for booking pages)

```html theme={null}
<section style="height: 100vh;">
<a-organization-page
base-url="https://anny.co"
organization="my-org"
fullscreen="true"
nav-height="64px"
></a-organization-page>
</section>
```

* `fullscreen="true"` → `height: 100vh`
* `nav-height` subtracts your sticky header: `calc(100vh - 64px)`. Match it to the real header height so the widget sits flush below the nav and fills the rest of the viewport exactly.
* The result: the **page does not scroll — only the widget scrolls internally**. This is the preferred pattern for any full-page booking, calendar, or map experience. It avoids the double-scrollbar problem where both the page and the widget scroll independently.
* If you give the widget a fixed `height` attribute, auto-resize is disabled — do not combine `height` with `fullscreen`.

Use this especially for booking-first and calendar-first pages where the widget should dominate the layout.

### Widget beside editorial content

```html theme={null}
<div style="display: grid; grid-template-columns: 1fr 420px; gap: 32px; align-items: start;">
<div>
<h1>Book your space</h1>
<p>…description…</p>
</div>
<a-resource-booking-panel
base-url="https://anny.co"
resource="my-resource"
></a-resource-booking-panel>
</div>
```

Panels expand vertically as the user navigates the booking flow. Use `align-items: start` so they don't stretch.

This is the preferred default for new marketing sites and content-driven pages.

### Button widget with a custom trigger

All button widgets accept a slotted element that replaces the built-in button.

```html theme={null}
<a-resource-button base-url="https://anny.co" resource="my-resource">
<button class="hero-cta">Book now</button>
</a-resource-button>
```

When a slot is provided, `label`, `button-background`, `button-text`, and `button-width` are ignored. Click and keyboard handling are still managed by the widget wrapper.

### Login and cart in the top-right of the main nav

Put `a-login-button` and `a-cart-modal-button` together in the **top-right of the main navigation** — the spot users instinctively look for account and cart. Render the cart as an **icon with a count indicator only** (no text label), like any e-commerce header.

```html theme={null}
<header style="display: flex; align-items: center; gap: 16px; padding: 0 24px; height: 64px;">
<a href="/">Logo</a>
<nav style="flex: 1;">…links…</nav>
<!-- pushed to the far right by the flex:1 nav above -->
<a-login-button base-url="https://anny.co"></a-login-button>
<a-cart-modal-button
base-url="https://anny.co"
modal-layout="drawer"
show-icon="true"
></a-cart-modal-button>
</header>
```

* These are utility widgets — put them in a stable position users can always find. They sync auth state and cart across all widgets on the page automatically.
* The cart button shows its own item-count indicator; keep it icon-only (omit `label`) so it reads as a standard cart icon.
* `drawer` is a good `modal-layout` for the cart so it slides in from the right, matching its top-right anchor.

For new sites, this top-right placement should be the default.

### Plan CTA button

For plans and subscriptions, prefer a button that opens checkout instead of embedding the full plan page into a mixed-content page.

```html theme={null}
<a-subscription-button
base-url="https://anny.co"
plan="my-plan"
label="Choose plan"
modal-layout="drawer"
></a-subscription-button>
```

Use `a-subscription-page` only when the whole page is dedicated to the plan checkout experience.

## AI Chat Assistant (`a-agent-chat`)

`a-agent-chat` embeds the anny **AI chat assistant**. The visitor can ask questions and the assistant can guide them through the booking flow conversationally; when it needs to show the booking UI it opens it in a modal over the host page. Login (when required) and the user's access token are handled first-party on the anny chat page — the widget only renders the launcher/panel chrome and forwards configuration.

It needs the `organization` slug and an `assistant-id` (created in anny admin). Ask for both before generating the snippet.

### Placement

Set `placement` to choose how the chat appears:

| `placement` | Result | Use when |
| - | - | - |
| `bottom-right` (default) | Fixed launcher button in the viewport corner; opens a floating panel | Site-wide support / assisted booking helper |
| `relative` / `none` | Launcher rendered in normal document flow (e.g. inside a section) | A "chat with us" button placed in your own layout |
| `inline` | No launcher — the chat frame is embedded directly | Chat *is* the page section; give the parent a fixed size |

### Floating launcher (most common)

```html theme={null}
<a-agent-chat
base-url="https://anny.co"
organization="my-org"
assistant-id="my-assistant"
placement="bottom-right"
greeting-message="Need a hand? Chat with us!"
></a-agent-chat>
```

The launcher is fixed bottom-right and the panel goes fullscreen on mobile. Place it once per page, near `</body>`.

### Inline frame

When the chat is itself a page section, use `placement="inline"` and give the **parent element** a fixed width/height — the frame fills it.

```html theme={null}
<div style="width: 400px; height: 560px;">
<a-agent-chat
base-url="https://anny.co"
organization="my-org"
assistant-id="my-assistant"
placement="inline"
></a-agent-chat>
</div>
```

### Chat attributes

| Attribute | Purpose |
| - | - |
| `organization` | **Required.** Organization slug whose chat to embed |
| `assistant-id` | Assistant identifier (from anny admin) |
| `placement` | `bottom-right` (default), `relative` / `none`, or `inline` |
| `start-message` | Message the conversation is pre-seeded with |
| `greeting-message` | Teaser bubble shown next to the launcher before it's opened |
| `launcher-label` | Accessible label for the launcher button |
| `launcher-color` | Launcher button background (defaults to `primary-color`, else the branded gradient) |
| `consent` | `accepted` (pre-opted-in, no banner) or `hidden` (no banner, no persistent visitor id); omit to show the chat's own consent banner |
| `supports-login` | Require login before the chat is usable (gate handled first-party) |

It also accepts the shared design tokens (`primary-color`, `primary-background`, `text-primary-color`, `text-secondary-color`, `button-text`, `logo-url`, `locale`, …) which are forwarded to the chat surface.

## Height Behavior

| Widget type | Default behavior | Override |
| - | - | - |
| Panel | Auto-resizes to content | Cannot be overridden — `height` and `fullscreen` are ignored |
| Page / map / calendar | Auto-resizes unless overridden | `height="700px"` (fixed) or `fullscreen="true"` (viewport fill) |
| Button widget | No height — opens modal | Modal size controlled by `modal-layout`, `modal-size`, `modal-width` |

## Required Attributes

Every widget needs:

* `base-url` — the anny base URL, e.g. `https://anny.co`
* The entity slug for the widget type (`resource`, `organization`, `service`, `plan`, or `package`)

Utility widgets are the exception:

* `a-login-button` only needs `base-url` unless SSO options are required
* `a-cart-modal-button` only needs `base-url`

```html theme={null}
<a-resource-booking-panel
base-url="https://anny.co"
resource="my-resource-slug"
></a-resource-booking-panel>
```

### Entity slug mapping

| Widget | Required entity attribute |
| - | - |
| `a-resource-page`, `a-resource-map`, `a-resource-calendar`, `a-resource-booking-panel`, `a-resource-button` | `resource` |
| `a-service-page`, `a-service-booking-panel`, `a-service-button` | `service` |
| `a-organization-page`, `a-organization-map`, `a-organization-calendar`, `a-organization-button` | `organization` |
| `a-subscription-page`, `a-subscription-button` | `plan` |
| `a-package-page`, `a-package-button` | `package` |
| `a-modal-button` | usually `resource` or `organization` |

### Common functional attributes

| Attribute | Meaning |
| - | - |
| `locale` | force widget language |
| `should-login` | require login before booking |
| `idp-uuid` | SSO identity provider |
| `height` | fixed iframe height for page widgets |
| `fullscreen` | full viewport height for page widgets |
| `nav-height` | subtract sticky header height from fullscreen widgets |
| `default-list` | initial tab for organization widgets |
| `view` | initial organization view |
| `calendar-view` | day/week/month/list view where supported |
| `default-category` | preselect category on `a-organization-page` |

### Date parameters

Many widgets support `start` and some also support `end`.

* ISO format: `2025-06-15`
* Relative values for `start`: `today`, `tomorrow`, `this_week`, `next_week`, `this_month`, `next_month`
* `end` should be an ISO date string
* Relative values are **not** supported by `a-resource-calendar` or `a-organization-calendar`

```html theme={null}
<a-resource-booking-panel
base-url="https://anny.co"
resource="my-resource"
start="tomorrow"
></a-resource-booking-panel>
```

## Design Token Pass-Through

Pass brand colors and styling directly as HTML attributes. No CSS override needed.

```html theme={null}
<a-organization-page
base-url="https://anny.co"
organization="my-org"
primary-color="#0f766e"
primary-background="#f8fafc"
panel-background="#ffffff"
small-border-radius="8px"
panel-shadow="0 8px 32px rgba(0,0,0,.08)"
text-primary-color="#111827"
></a-organization-page>
```

### Color tokens

| Token | Purpose | Fallback |
| - | - | - |
| `primary-color` | Main accent color | — |
| `primary-color-rgb` | RGB triplet for transparent accent usage, e.g. `15, 118, 110` | Auto-calculated from `primary-color` |
| `primary-color-hover` | Hover state of main accent | — |
| `primary-color-overlay` | Accent overlay surface | — |
| `secondary-color` | Secondary accent | — |
| `primary-stroke-color` | Stroke / outline accent; also sets table borders | — |

### Text tokens

| Token | Purpose |
| - | - |
| `text-primary-color` | Main text color |
| `text-secondary-color` | Secondary text color |
| `text-tertiary-color` | Muted text color |

### Background tokens

| Token | Purpose | Fallback |
| - | - | - |
| `primary-background` | Page/outer background | — |
| `primary-background-rgb` | RGB triplet for layered page background | Auto-calculated from `primary-background` |
| `panel-background` | Panel surface. Also sets `primary-background` if `primary-background` is not provided. | — |
| `panel-background-rgb` | RGB triplet for panel surface | Auto-calculated from `panel-background` or `primary-background` |
| `panel-background-light` | Lighter panel variant | — |
| `panel-background-overlay` | Overlay background | — |
| `panel-background-overlay-dense` | Dense overlay background | — |
| `panel-background-dark` | Dark panel surface | — |
| `input-background` | Input field background | — |

### Border and radius tokens

| Token | Purpose | Notes |
| - | - | - |
| `small-border-radius` | Base radius unit | All larger radii are calculated from this: `1.5×`, `2×`, `2.5×`, `3×`, `4×`, `5×` |
| `panel-border-radius` | Explicit large panel radius | Overrides the scale-up from `small-border-radius` |
| `detail-border-radius` | Explicit detail card radius | Overrides the scale-up from `small-border-radius` |
| `light-border-color` | Light border color | — |
| `table-border-color` | Table and grid border color | — |
| `panel-border-style` | Border style token | — |

### Shadow tokens

| Token | Purpose |
| - | - |
| `panel-shadow` | Panel shadow; also sets dropdown shadow |
| `detail-shadow` | Detail card shadow |

### Button styling tokens

These affect the outer CTA button for button widgets, cart button, and login button.

| Token | Purpose | Fallback |
| - | - | - |
| `button-background` | Trigger fill color | Falls back to `input-background` |
| `button-text` | Trigger text and icon color | Falls back to `text-primary-color` |
| `button-width` | Trigger width | — |
| `button-height` | Trigger height | — |
| `show-icon` | Show or hide icon on login/cart | — |

### Utility tokens

| Token | Purpose |
| - | - |
| `logo-url` | Custom logo shown in the pulsing loading animation only. Does not affect logos inside the booking UI. |

### RGB tokens — auto-calculation

`primary-color-rgb`, `panel-background-rgb`, and `primary-background-rgb` are automatically calculated from their hex counterparts when not explicitly provided. You only need to pass them if you want to supply a custom RGB triplet (e.g. for a non-hex color source).

Design rules:

* Prefer configuring design in admin first. HTML token overrides are for one-off page-specific changes.
* Keep contrast high between primary actions, text, and backgrounds.
* `small-border-radius` is the simplest way to control all corner radii at once. Use `panel-border-radius` and `detail-border-radius` only to override specific levels.
* Do not combine very strong shadows, very round corners, and low-contrast text simultaneously.

## Modal Layout Options

Button widgets open content in a modal. Control the layout with `modal-layout`:

| Value | Description |
| - | - |
| `dialog` | Centered dialog. Size with `modal-size` (`sm`/`md`/`lg`) or `modal-width` |
| `drawer` | Side panel from the right — good for checkout flows |
| `fullscreen` | Full viewport — best for mobile |

```html theme={null}
<a-resource-button
base-url="https://anny.co"
resource="my-resource"
modal-layout="drawer"
></a-resource-button>
```

### Modal behavior attributes

| Attribute | Purpose |
| - | - |
| `modal-layout` | `dialog`, `drawer`, or `fullscreen` |
| `modal-size` | `sm`, `md`, or `lg` for dialog layout |
| `modal-width` | custom width such as `80vw`; overrides `modal-size` |
| `modal-title` | modal header title |
| `close-on-backdrop` | allow close on outside click |
| `show-close-button` | show close button |
| `aria-label` | accessible label for modal |

## Tracking Events

Booking widgets can emit DOM custom events you can subscribe to on the widget element.

Supported event names:

* `view-page`
* `add-to-cart`
* `start-checkout`
* `complete-checkout`

Common payload fields:

* `event_name`
* `value`
* `gross_value`
* `tax`
* `currency`
* `transaction_id`
* `items`

```html theme={null}
<a-resource-page
id="booking-widget"
base-url="https://anny.co"
resource="my-resource"
></a-resource-page>

<script>
const widget = document.getElementById('booking-widget')

widget.addEventListener('complete-checkout', (event) => {
const data = event.detail
console.log('Checkout complete', data.transaction_id, data.gross_value)
})
</script>
```

`a-login-button` and `a-cart-modal-button` are utility widgets and are not booking event emitters.

## Common Mistakes to Avoid

| Mistake | Fix |
| - | - |
| Adding padding around a panel inside a card | Apply `border-radius` + `overflow: hidden` to the card wrapper; put the widget element directly inside |
| Wrapping the widget in a flex/grid container with `align-items: stretch` | Use `align-items: start` so the panel can grow freely |
| Loading the script multiple times | One `<script>` tag per page is enough |
| Setting `height` or `fullscreen` on a panel widget | These are ignored on panels — panels always auto-resize |
| Placing `a-login-button` / `a-cart-modal-button` per entity instead of once in the nav | These are page-level shared controls — one set, top-right of the main nav |
| A full-page widget that makes the page scroll *and* the widget scroll | Use `fullscreen="true"` + `nav-height` so only the widget scrolls; don't wrap a fullscreen widget in a tall scrolling container |
| Giving the cart button a text label in the header | Keep it icon + count only (`show-icon="true"`, no `label`) like a standard cart |
| Setting `height`/`fullscreen` on `a-agent-chat` inline mode | Size the **parent element** instead — the inline chat frame fills its container |
| Styling the widget element itself with CSS borders/radius | Style the wrapper element instead; the widget manages its own internal layout |

## Attribution Forwarding

UTM params and click IDs (`gclid`, `fbclid`, `ttclid`, `li_fat_id`) from the page URL are automatically forwarded into the widget iframe. No extra setup needed for conversion tracking.


# Widget Einbettung - Advanced
Source: https://docs.anny.co/widget-embed-advanced

Dieser Leitfaden erklärt, wie du Layout, Events, Modal-Verhalten und HTML-Attribute gezielt steuerst.

## HTML-Seitenstruktur

Minimale Seitenstruktur mit Header, optionaler Sidebar und einem Widget im Hauptbereich.

```html theme={null}
<!DOCTYPE html>
<html lang="de">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Meine Buchungsseite</title>
  <script src="https://cdn.anny.co/widget/annyComponents.umd.latest.min.js"></script>
</head>
<body>

  <header>
    <a href="/">Dein Logo</a>
    <nav><!-- Navigation --></nav>
    <a-login-button base-url="https://anny.co"></a-login-button>
    <a-cart-modal-button base-url="https://anny.co" modal-layout="drawer"></a-cart-modal-button>
  </header>

  <main>
    <aside><!-- optionale Sidebar --></aside>

    <div>
      <a-resource-booking-panel
        base-url="https://anny.co"
        resource="my-resource"
      ></a-resource-booking-panel>

      <!-- weiterer Seiteninhalt -->
    </div>
  </main>

</body>
</html>
```

* Das Script wird einmal im `<head>` geladen.
* `a-login-button` und `a-cart-modal-button` gehören in den Header, damit sie auf allen Seiten sichtbar bleiben.
* Ersetze das Panel durch ein Seiten-Widget mit `fullscreen="true"` und `nav-height`, wenn die Buchung die gesamte Viewport-Höhe füllen soll (siehe [Ganzseitige Widgets](#ganzseitige-widgets) weiter unten).

## Ganzseitige Widgets

Seiten-Widgets eignen sich, wenn das Widget den Hauptinhalt der Seite darstellt.

Seiten-Widgets:

* `a-organization-page`
* `a-organization-map`
* `a-organization-calendar`
* `a-resource-page`
* `a-resource-map`
* `a-resource-calendar`
* `a-service-page`
* `a-subscription-page`
* `a-package-page`
* `a-my-bookings`

## Empfohlene Integration für ganzseitige Layouts

Verwende `fullscreen="true"`, damit das Widget die verfügbare Viewport-Höhe ausfüllt. Wenn deine Website einen festen Header hat, übergib zusätzlich `nav-height`, damit das Widget nicht darunter gerendert wird.

```html theme={null}
<a-resource-calendar
  base-url="https://anny.co"
  resource="my-resource"
  fullscreen="true"
  nav-height="72px"
></a-resource-calendar>
```

Hinweise:

* `fullscreen="true"` entspricht `height: 100vh`.
* `nav-height` ändert das auf `calc(100vh - nav-height)`.
* Wenn du `height` setzt, wird die automatische Größenanpassung deaktiviert und der iframe hat eine feste Höhe.
* Für `*-page`, Map-, Kalender- und `a-my-bookings`-Widgets sind ganzseitige Layouts in der Regel die sauberste Integration.

## Organization-Map und Organization-Kalender

Diese sind Seiten-Widgets, keine Modal-Buttons. Behandle sie wie einen vollständigen Seitenbereich.

```html theme={null}
<a-organization-map
  base-url="https://anny.co"
  organization="my-org"
  fullscreen="true"
></a-organization-map>

<a-organization-calendar
  base-url="https://anny.co"
  organization="my-org"
  calendar-view="week"
  fullscreen="true"
></a-organization-calendar>
```

Verwende die Organization-Map, wenn die Karte die primäre Benutzeroberfläche ist. Verwende den Organization-Kalender, wenn die Verfügbarkeitsnavigation im Vordergrund steht. Wenn du stattdessen den vollständigen Explore-Flow möchtest, nimm `a-organization-page`.

## Panels

Booking-Panels sind bewusst kompakt gehalten und sperren die Navigation.

Panel-Widgets:

* `a-resource-booking-panel`
* `a-service-booking-panel`

Wichtiges Verhalten:

* Panels verwenden immer dynamische Höhe.
* Externe `height`- und `fullscreen`-Werte werden ignoriert.
* Panels sind dazu gedacht, den Buchungsfluss in dein eigenes Seitenlayout einzubetten.

```html theme={null}
<a-service-booking-panel
  base-url="https://anny.co"
  service="intro-call"
></a-service-booking-panel>
```

## Popups vom Widget

Das Widget öffnet für einige Schritte ein **eigenes Browserfenster**. Das gilt nicht nur für die Zahlung — **Login und Logout brauchen dieses Fenster immer**, auch wenn du keine externen Zahlungen anbietest.

Das Widget öffnet ein Popup für:

* **Login und Logout** über den Login-Button oder wenn eine Buchung eine Anmeldung verlangt
* **Externe Zahlungen** wie PayPal, iDEAL, giropay, Sofort, Bancontact, EPS, Przelewy24 oder TWINT
* **Kartenprüfung (3-D Secure)**, wenn die Bank eine zusätzliche Bestätigung verlangt

Deine Website muss diese Fenster erlauben. Sonst bleibt das Fenster leer oder der Browser zeigt **This content is blocked. Contact the site owner to fix the issue**. Login und Zahlung kommen dann nicht zum Abschluss.

<Warning>
  Ein häufiger Blocker ist der HTTP-Header **Cross-Origin-Opener-Policy** mit dem Wert **same-origin**. Damit isoliert der Browser jedes Fenster, das das Widget aus dem iframe öffnet.
</Warning>

### Was du auf der Website einstellen musst

1. Setze **Cross-Origin-Opener-Policy** auf **same-origin-allow-popups** — oder entferne den Header.
2. Lass Pop-up-Blocker für deine Buchungsseite zu (Browser und ggf. Firmenrichtlinie).
3. Ändere **nicht** `X-Frame-Options` oder `frame-ancestors` nur wegen dieses Problems. Die gelten dafür, ob *deine* Seite eingebettet werden darf, nicht dafür, ob das Widget ein Fenster öffnen darf.

<Note>
  Die anny-Buchungsseite unter anny.co ist davon nicht betroffen. Bis die Header-Änderung live ist, können Kund:innen dort statt im Website-Widget buchen.
</Note>

## Externe Zahlungen im Widget

Wenn Kund:innen im eingebetteten Checkout eine Zahlungsmethode wählen, die anny verlässt (PayPal, iDEAL, giropay, Sofort, Bancontact, EPS, Przelewy24, TWINT), öffnet das Widget die Zahlungsseite in einem **zentrierten Popup**. Karte und SEPA bleiben im Widget (Stripe-Overlay). Voraussetzungen für das Fenster: [Popups vom Widget](#popups-vom-widget).

Der Hinweis im Checkout lautet: **Deine Buchung muss online bezahlt werden. Dafür wird sich ein neues Fenster öffnen in dem du die Bezahlung durchführen kannst. Danach wird sich das Fenster automatisch schließen.**

Blockiert der Browser das Popup, erscheint im Widget der Hinweis **Dein Browser hat das Zahlungsfenster blockiert** und der Button **Zahlungsseite öffnen**. Das Widget lädt die Zahlungsseite nicht in sich selbst. Das Host-Dokument der Website wird nicht navigiert.

## Login-Button und Warenkorb-Button

Diese zwei Komponenten werden unter Organisation → Einstellungen → Buchungsseite → Globale Komponenten konfiguriert. Sie sind als gemeinsame Steuerelemente gedacht, die sich in der Regel im Site-Header oder in einer fixen Navigationsleiste befinden.

### Login-Button

Verwende `a-login-button`, wenn du ein gemeinsames Login/Logout-Element benötigst, das mit der Widget-Session synchron bleibt.

```html theme={null}
<a-login-button
  base-url="https://anny.co"
  locale="de"
  idp-uuid="your-idp-uuid"
></a-login-button>
```

Verhalten:

* Lädt einen eigenen Login-iframe.
* Öffnet Login und Logout in einem Popup. Deine Website muss das Fenster erlauben, siehe [Popups vom Widget](#popups-vom-widget).
* Wechselt automatisch in den eingeloggten Avatar-Zustand.
* Sendet Auth-Änderungen weiter, damit benachbarte Widgets ihren Authentifizierungszustand aktualisieren.

Gute Platzierungen:

* Haupt-Site-Header
* Mobile Navigation Drawer
* Obere Leiste auf Buchungs-Landingpages

### Warenkorb-Button

Verwende `a-cart-modal-button`, wenn Nutzer Artikel aus Booking-Widgets hinzufügen und später auschecken sollen.

```html theme={null}
<a-cart-modal-button
  base-url="https://anny.co"
  modal-layout="drawer"
  label="Warenkorb"
></a-cart-modal-button>
```

Verhalten:

* Zeigt eine Live-Badge mit der Artikelanzahl.
* Bleibt mit benachbarten Widgets auf derselben Seite synchron.
* Öffnet den Checkout in einem Modal-Overlay.

Häufige Kombinationen:

* `a-resource-booking-panel` zusammen mit `a-cart-modal-button`
* Mehrere Booking-Widgets auf einer Seite mit einem gemeinsamen Warenkorb-Button

## Events und Tracking

Die meisten Embed-Widgets leiten Buchungs-Lifecycle-Events als DOM Custom Events weiter. Trifft für alles aus den Login-Button zu.

Unterstützte Event-Namen:

* `view-page`
* `add-to-cart`
* `start-checkout`
* `complete-checkout`

Häufige Felder im Event-Payload:

* `event_name`
* `value`
* `gross_value`
* `tax`
* `currency`
* `transaction_id`
* `items`

Beispiel:

```html theme={null}
<a-resource-page
  id="booking-widget"
  base-url="https://anny.co"
  resource="my-resource"
></a-resource-page>

<script>
  const widget = document.getElementById('booking-widget')

  widget.addEventListener('complete-checkout', (event) => {
    const data = event.detail
    console.log('Checkout abgeschlossen', data.transaction_id, data.gross_value, data.currency)
  })
</script>
```

GA4-Beispiel:

```html theme={null}
<script>
  const widget = document.getElementById('booking-widget')

  widget.addEventListener('complete-checkout', (event) => {
    const data = event.detail

    gtag('event', 'purchase', {
      currency: data.currency,
      value: data.gross_value ?? data.value,
      transaction_id: data.transaction_id,
      items: (data.items || []).map((item) => ({
        item_id: item.id,
        item_name: item.name,
        quantity: item.quantity,
        price: item.price,
      })),
    })
  })
</script>
```

Hinweise:

* `a-login-button` und `a-cart-modal-button` sind Hilfs-Widgets und senden keine Buchungs-Events.
* Seiten-Widgets, Maps, Kalender, Booking-Panels und checkout-orientierte Seiten senden Buchungs-Events.
* Subscription- und Package-Widgets senden checkout-fokussierte Events. In der Praxis sind `view-page`, `start-checkout` und `complete-checkout` die relevantesten.

### UTM-Parameter und Click-IDs

Für Attribution musst du nichts weiter tun. Wenn ein Widget lädt, liest es den Query-String der **übergeordneten Seiten-URL** aus und leitet diese Parameter automatisch in den eingebetteten iframe weiter:

| Parameter | Plattform |
| - | - |
| `utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term` | Alle (Google Analytics u. a.) |
| `gclid` | Google Ads |
| `fbclid` | Meta / Facebook Ads |
| `ttclid` | TikTok Ads |
| `li_fat_id` | LinkedIn Ads |

Wenn ein Nutzer also über `?utm_campaign=fruehling&gclid=abc123` auf deine Seite kommt, trägt das Widget diese Werte durch den gesamten Buchungsfluss – Conversion-Tracking funktioniert ohne zusätzliche Konfiguration.

Es ist kein HTML-Attribut erforderlich – die Weiterleitung erfolgt automatisch bei jedem Widget-Ladevorgang.

## Start- und Enddatum

Die meisten Widgets akzeptieren `start` (und manchmal `end`), um Kalender oder Karte auf einen bestimmten Datumsbereich vorzunavigieren.

**ISO-8601-Datumsstring** – exaktes Datum:

```html theme={null}
<a-resource-page
  base-url="https://anny.co"
  resource="my-resource"
  start="2025-06-15"
></a-resource-page>
```

**Relativer Schlüsselwert** – wird zum Render-Zeitpunkt aufgelöst:

| Wert | Bedeutung |
| - | - |
| `today` | Aktueller Tag |
| `tomorrow` | Nächster Tag |
| `this_week` | Beginn der aktuellen Woche |
| `next_week` | Beginn der nächsten Woche |
| `this_month` | Beginn des aktuellen Monats |
| `next_month` | Beginn des nächsten Monats |

```html theme={null}
<a-resource-booking-panel
  base-url="https://anny.co"
  resource="my-resource"
  start="tomorrow"
></a-resource-booking-panel>
```

Relative Werte werden überall unterstützt – **außer** bei `a-resource-calendar` und `a-organization-calendar`, die ISO 8601 erfordern.

`end` erwartet immer einen ISO-8601-Datumsstring.

## Anpassungsoptionen nach Widget-Typ

Dieser Abschnitt dokumentiert die öffentlichen HTML-Attribute. Admin-generierte Snippets decken in der Regel die wichtigsten davon bereits ab.

### Gemeinsame Attribute für Embed-Widgets

Gilt für Seiten-Widgets und Panel-Widgets. Nicht anwendbar auf Button-Widgets.

| Attribut | Zweck |
| - | - |
| `base-url` | Erforderlich. anny-Basis-URL, z. B. `https://anny.co` |
| `locale` | Widget-Sprache erzwingen. Wird es weggelassen, wird die Browser-Sprache verwendet |
| `height` | Feste iframe-Höhe, z. B. `700px` oder `80vh`. Deaktiviert die automatische Größenanpassung. Nicht für Button-Widgets. |
| `fullscreen` | Viewport-Höhe füllen (`100vh`). Nicht für Button-Widgets. |
| `nav-height` | Abstand vom Viewport-Rand bei `fullscreen`, z. B. `64px` |
| `should-login` | Login vor der Buchung erforderlich |
| `idp-uuid` | UUID des SSO-Identity-Providers |
| `logo-url` | Eigenes Logo für die Lade-Animation |

Alle Embed-Widgets akzeptieren zusätzlich die Design-Attribute aus `WIDGET_DESIGNING.md`.

## Organization-Widgets

### `a-organization-page`

| Attribut | Zweck |
| - | - |
| `organization` | Erforderlicher Organization-Slug |
| `default-list` | Initialer Tab: `resources`, `services`, `subscriptions` oder `packages` |
| `view` | `grid`, `list` oder `calendar` |
| `calendar-view` | `day`, `week`, `month` oder `list` |
| `start` | Initiales Startdatum (siehe [Start- und Enddatum](#start--und-enddatum)) |
| `end` | Initiales Enddatum |
| `default-category` | Ressourcenkategorie vorauswählen |
| `hide-resource-header` | Ressource-Header ausblenden |
| `hide-organization-header` | Organization-Header ausblenden |
| `hide-organization-filters` | Filterleiste ausblenden |
| `hide-organization-map` | Karten-Umschalter ausblenden |

Hinweis:

* Die Option „Kalender-Board" im Admin entspricht `calendar-view="list"`.

### `a-organization-calendar`

| Attribut | Zweck |
| - | - |
| `organization` | Erforderlicher Organization-Slug |
| `calendar-view` | `day`, `week`, `month` oder `list` |
| `category` | Kategorie-Slug |
| `start` | Initiales Startdatum (nur ISO 8601) |
| `end` | Initiales Enddatum |
| `hide-organization-filters` | Filterleiste ausblenden |

### `a-organization-map`

| Attribut | Zweck |
| - | - |
| `organization` | Erforderlicher Organization-Slug |
| `start` | Initiales Startdatum (siehe [Start- und Enddatum](#start--und-enddatum)) |
| `end` | Initiales Enddatum |
| `hide-resource-header` | Ressource-Header ausblenden |
| `hide-organization-header` | Organization-Header ausblenden |

## Ressource-Widgets

### `a-resource-page`

| Attribut | Zweck |
| - | - |
| `resource` | Erforderlicher Ressource-Slug |
| `service` | Service vorauswählen |
| `start` | Initiales Startdatum (siehe [Start- und Enddatum](#start--und-enddatum)) |
| `end` | Initiales Enddatum |
| `hide-resource-header` | Ressource-Header ausblenden |
| `hide-organization-header` | Organization-Header ausblenden |
| `hide-calendar` | Kalender ausblenden |

### `a-resource-calendar`

| Attribut | Zweck |
| - | - |
| `resource` | Erforderlicher Ressource-Slug |
| `service` | Service vorauswählen |
| `calendar-view` | `day`, `week`, `month` oder `list` |
| `start` | Initiales Startdatum (nur ISO 8601) |
| `end` | Initiales Enddatum |
| `hide-resource-header` | Ressource-Header ausblenden |
| `hide-organization-header` | Organization-Header ausblenden |

### `a-resource-map`

| Attribut | Zweck |
| - | - |
| `resource` | Erforderlicher Ressource-Slug |
| `service` | Service vorauswählen |
| `start` | Initiales Startdatum (siehe [Start- und Enddatum](#start--und-enddatum)) |
| `end` | Initiales Enddatum |
| `hide-resource-header` | Ressource-Header ausblenden |
| `hide-organization-header` | Organization-Header ausblenden |

### `a-resource-booking-panel`

| Attribut | Zweck |
| - | - |
| `resource` | Erforderlicher Ressource-Slug |
| `service` | Service vorauswählen |
| `start` | Initiales Startdatum (siehe [Start- und Enddatum](#start--und-enddatum)) |
| `end` | Initiales Enddatum |

## Service-Widgets

### `a-service-page`

| Attribut | Zweck |
| - | - |
| `service` | Erforderlicher Service-Slug |
| `resource` | Optionale Ressource vorauswählen |

### `a-service-booking-panel`

| Attribut | Zweck |
| - | - |
| `service` | Erforderlicher Service-Slug |
| `resource` | Optionale Ressource vorauswählen |
| `start` | Initiales Startdatum (siehe [Start- und Enddatum](#start--und-enddatum)) |
| `end` | Initiales Enddatum |

## Subscription- und Package-Widgets

### `a-subscription-page`

| Attribut | Zweck |
| - | - |
| `plan` | Erforderlicher Plan-Slug |

### `a-subscription-button`

| Attribut | Zweck |
| - | - |
| `plan` | Erforderlicher Plan-Slug |
| `label` | Beschriftung des Trigger-Buttons |

### `a-package-page`

| Attribut | Zweck |
| - | - |
| `package` | Erforderlicher Package-Slug |

### `a-package-button`

| Attribut | Zweck |
| - | - |
| `package` | Erforderlicher Package-Slug |
| `label` | Beschriftung des Trigger-Buttons |

## Button-Widgets

Gilt für:

* `a-organization-button`
* `a-resource-button`
* `a-service-button`
* `a-subscription-button`
* `a-package-button`
* `a-modal-button`
* `a-cart-modal-button`

## Gemeinsame Modal-Attribute

| Attribut | Zweck |
| - | - |
| `modal-layout` | `dialog`, `drawer` oder `fullscreen` |
| `modal-size` | `sm`, `md` oder `lg` für Dialog-Layout |
| `modal-width` | Benutzerdefinierte Dialog-Breite, z. B. `80vw` |
| `modal-title` | Titel im Modal-Header |
| `close-on-backdrop` | Schließen per Klick außerhalb erlauben |
| `show-close-button` | Schließen-Button anzeigen |
| `aria-label` | Barrierefreies Label für den Modal-Dialog |

## Trigger-Attribute für Entity-Buttons

Gilt für:

* `a-organization-button`
* `a-resource-button`
* `a-service-button`
* `a-subscription-button`
* `a-package-button`

| Attribut | Zweck |
| - | - |
| `label` | Standard-Beschriftung des Buttons |
| `button-width` | Breite des Triggers |
| `button-background` | Hintergrundfarbe des Triggers |
| `button-text` | Textfarbe des Triggers |

`a-modal-button` ist anders:

* kein `label`-Prop
* keine eingebauten Trigger-Styling-Props
* verwende ein eigenes Element im Slot als Trigger

## Eigener Trigger (Slot)

Alle Button-Widgets akzeptieren einen Standard-Slot, der den eingebauten Trigger ersetzt. Nutze das, wenn du den Trigger selbst gestalten oder ein anderes Element als Button verwenden möchtest.

```html theme={null}
<!-- Eigener Button als Trigger -->
<a-resource-button
  base-url="https://anny.co"
  resource="my-resource"
>
  <button class="my-cta-button">Schreibtisch buchen</button>
</a-resource-button>

<!-- Link als Trigger -->
<a-organization-button
  base-url="https://anny.co"
  organization="my-org"
>
  <a href="#">Verfügbarkeit ansehen</a>
</a-organization-button>

<!-- a-modal-button erfordert immer einen Slot-Trigger -->
<a-modal-button
  base-url="https://anny.co"
  resource="my-resource"
>
  <button>Buchung öffnen</button>
</a-modal-button>
```

Wenn ein Slot verwendet wird, werden `label`, `button-background`, `button-text` und `button-width` ignoriert. Klick- und Tastatursteuerung werden weiterhin vom Widget-Wrapper übernommen.

### `a-resource-button`

| Attribut | Zweck |
| - | - |
| `resource` | Erforderlicher Ressource-Slug |
| `service` | Optionaler Service |
| `start` | Initiales Startdatum (siehe [Start- und Enddatum](#start--und-enddatum)) |
| `hide-resource-header` | Ressource-Header ausblenden |
| `hide-organization-header` | Organization-Header ausblenden |

### `a-service-button`

| Attribut | Zweck |
| - | - |
| `service` | Erforderlicher Service-Slug |
| `resource` | Optionale Ressource vorauswählen |

### `a-organization-button`

| Attribut | Zweck |
| - | - |
| `organization` | Erforderlicher Organization-Slug |
| `default-list` | Initialer Organization-Tab |
| `view` | `grid`, `list` oder `calendar` |
| `calendar-view` | `day`, `week`, `month` oder `list` |
| `hide-resource-header` | Ressource-Header ausblenden |
| `hide-organization-header` | Organization-Header ausblenden |

### `a-modal-button`

Verwende diesen Button, wenn du einen eigenen Modal-Trigger ohne entity-spezifische Button-Komponente benötigst.

| Attribut | Zweck |
| - | - |
| `resource` | Ressource-Buchungsseite öffnen |
| `service` | Service vorauswählen (zusammen mit `resource`) |
| `organization` | Organization-Explore-Seite öffnen |
| `default-list` | Initialer Organization-Tab |
| `view` | Initiale Organization-Ansicht |
| `calendar-view` | Initiale Organization-Kalenderansicht |
| `hide-resource-header` | Ressource-Header ausblenden |
| `hide-organization-header` | Organization-Header ausblenden |

## Hilfs-Widgets

### `a-cart-modal-button`

| Attribut | Zweck |
| - | - |
| `label` | Button-Beschriftung |
| `aria-label` | Barrierefreies Dialog-Label |
| `modal-layout` | `dialog`, `drawer` oder `fullscreen` |
| `modal-size` | Dialog-Größen-Preset |
| `modal-width` | Benutzerdefinierte Dialog-Breite |
| `modal-title` | Titel im Modal-Header |
| `close-on-backdrop` | Schließen per Klick außerhalb |
| `show-close-button` | Schließen-Button anzeigen |
| `button-width` | Trigger-Breite |
| `button-height` | Trigger-Höhe |
| `button-background` | Trigger-Hintergrund |
| `button-text` | Trigger-Text-/Icon-Farbe |
| `show-icon` | Icon ein-/ausblenden |

### `a-login-button`

| Attribut | Zweck |
| - | - |
| `locale` | Sprache des Login-Buttons |
| `idp-uuid` | UUID des SSO-Providers |
| `button-width` | Trigger-Breite |
| `button-height` | Trigger-Höhe |
| `button-background` | Trigger-Hintergrund |
| `button-text` | Trigger-Text-/Icon-Farbe |
| `small-border-radius` | Trigger-Eckenradius |
| `show-icon` | Icon ein-/ausblenden |

### `a-my-bookings`

| Attribut | Zweck |
| - | - |
| `base-url` | Erforderlich |
| `locale` | Optionale Sprache |
| `height` | Feste Höhe |
| `fullscreen` | Viewport-Höhe füllen |
| `nav-height` | Header-Abstand für Fullscreen |
| `idp-uuid` | UUID des SSO-Providers |

Hinweis:

* `a-my-bookings` erfordert immer eine Authentifizierung. `should-login` ist nicht verfügbar, da Login obligatorisch ist.

## Externe Zahlung im eingebetteten Checkout

Wenn Kund:innen im Widget mit einer externen Zahlungsmethode bezahlen (zum Beispiel PayPal, iDEAL, Giropay, Sofort, Bancontact, EPS, Przelewy24 oder TWINT), öffnet anny die Zahlungsseite in einem eigenen, zentrierten Fenster. Deine Website und das Widget bleiben geöffnet, der Checkout behält die eingegebenen Daten.

Karten- und SEPA-Zahlungen bleiben im Widget. Wird das Zahlungsfenster blockiert, erscheint der Button **Zahlungsseite öffnen** — die Zahlung läuft nicht im Widget-iframe weiter. Schließt jemand das Fenster, bevor die Zahlung fertig ist, erscheint der Hinweis, dass die Zahlung nicht durchgeführt werden konnte. Damit Login und Zahlung zuverlässig ein Fenster öffnen können, siehe [Popups vom Widget](#popups-vom-widget).

## Empfehlungen

* Nutze zuerst das Admin-generierte Snippet und verfeinere es manuell nur wenn nötig.
* Verwende Seiten-Widgets für dedizierte Buchungsseiten.
* Verwende Panels für redaktionelle Seiten rund um den Buchungsfluss.
* Verwende Button-Widgets, wenn die Buchung erst nach einem Klick sichtbar sein soll.
* Platziere `a-login-button` und `a-cart-modal-button` an stabilen, gut sichtbaren Stellen im UI.
* Stelle sicher, dass deine Website Popups vom Widget erlaubt — Login braucht sie unabhängig von der Zahlung. Siehe [Popups vom Widget](#popups-vom-widget).
* Bevorzuge `drawer` für Desktop-seitige Checkout-Flows und `fullscreen` für mobile Erlebnisse.


# Barrierefreiheit bei anny
Source: https://docs.anny.co/accessibility

Welche Standards anny umsetzt, wie Buchungen per Tastatur, Screenreader und Sprache funktionieren – und wie wir das prüfen.

Buchen muss für alle funktionieren – auch ohne Maus, ohne Bildschirm und ohne Formularkenntnisse. Deshalb ist Barrierefreiheit bei anny kein nachträgliches Add-on, sondern Teil der Komponenten, aus denen deine Buchungsseite gebaut ist. Jede Verbesserung an einem Eingabefeld, einem Kalender oder einem Auswahlmenü wirkt automatisch auf allen Buchungsseiten.

Die anny-Buchungsseite erfüllt **WCAG 2.2 Level AA**. Diese Seite beschreibt, was konkret umgesetzt ist, und dient zugleich als unsere Konformitätsaussage: Wir haben die Buchungsseite entlang der Erfolgskriterien von WCAG 2.2 AA und der EN 301 549 selbst geprüft, so wie es das BFSG vorsieht.

## Nach welchen Standards wir arbeiten

| Standard | Bedeutung für anny |
| - | - |
| **WCAG 2.2, Level AA** | Der internationale Referenzstandard des W3C für barrierefreie Webinhalte (seit Oktober 2023, seit 2025 zusätzlich als ISO/IEC 40500 normiert). Unser technischer Zielstandard. |
| **EN 301 549** | Die europäische Norm, die WCAG für den EU-Raum verbindlich macht. Die aktuell harmonisierte Fassung V3.2.1 referenziert WCAG 2.1 AA; die Folgeversion mit WCAG 2.2 ist für 2026 angekündigt. Wir entwickeln bereits gegen WCAG 2.2 und sind damit auf die neue Fassung vorbereitet. |
| **BFSG** (Barrierefreiheitsstärkungsgesetz) | Setzt den European Accessibility Act (EU 2019/882) in deutsches Recht um und gilt seit dem 28. Juni 2025 auch für private Anbieter:innen von Dienstleistungen im elektronischen Geschäftsverkehr. |
| **BITV 2.0** | Relevant für Kund:innen aus dem öffentlichen Sektor – Hochschulen, Bibliotheken, Verwaltungen. Baut ebenfalls auf EN 301 549 auf. |

<Info>
  Wenn du eine Buchungsseite für Verbraucher:innen betreibst, fällst du unter Umständen selbst unter das BFSG. Der Abschnitt **Was das für dich als Betreiber:in bedeutet** weiter unten fasst zusammen, was anny dafür mitbringt und was du selbst beisteuern musst.
</Info>

## Bedienung per Tastatur

Die gesamte Buchungsstrecke – Ressource auswählen, Datum und Zeitraum wählen, Optionen und Zusatzleistungen konfigurieren, Formular ausfüllen, bezahlen – ist ohne Maus bedienbar. Kein Schritt erfordert einen Klick, ein Hover oder eine Drag-Geste.

| Taste | Funktion |
| - | - |
| `Tab` / `Shift + Tab` | Zwischen Bedienelementen wechseln |
| `Pfeiltasten` | Innerhalb einer Komponente navigieren – Tage im Kalender, Einträge in Auswahllisten, Menüpunkte |
| `Enter` / `Leertaste` | Auswählen, bestätigen, öffnen |
| `Escape` | Menü, Kalender oder Dialog schließen – der Fokus springt zurück auf das auslösende Element |
| `Pos1` / `Ende` | Erster bzw. letzter Eintrag einer Liste oder Woche |
| `Bild auf` / `Bild ab` | Vorheriger bzw. nächster Monat im Kalender |
| `B` | Auf einer Ressourcenseite direkt ins Buchungsformular springen |

Technisch folgen wir dabei den [WAI-ARIA Authoring Practices](https://www.w3.org/WAI/ARIA/apg/) des W3C:

* **Roving Tabindex** für Menüs, Tabs und Auswahllisten – die Pfeiltasten bewegen den Fokus innerhalb der Komponente, `Tab` führt wieder heraus. Niemand bleibt in einem Widget stecken.
* **Combobox-Muster** für durchsuchbare Auswahlfelder – du kannst tippen und gleichzeitig mit den Pfeiltasten durch die Treffer navigieren.
* **Dialog-Muster** für Modals: Fokusfalle innerhalb des Dialogs, `Escape` schließt, der Fokus kehrt anschließend zum Auslöser zurück.
* **Sichtbarer Fokusindikator** auf jedem fokussierbaren Element – ein 2 Pixel starker Rahmen in deiner Akzentfarbe, global gesetzt und nicht abschaltbar.

## Bedienung mit Screenreader

Getestet mit VoiceOver (macOS/iOS) und NVDA (Windows).

**Struktur und Orientierung**

* Semantisches HTML als Basis: echte Buttons, echte Links, echte Formularfelder, `<nav>`- und `<main>`-Bereiche. ARIA ergänzt nur dort, wo HTML nicht ausreicht.
* Durchgängige Überschriftenhierarchie, über die sich Seiten anspringen lassen.
* Icon-Buttons ohne sichtbaren Text haben immer einen sprechenden Namen – etwa „Eingabe löschen" statt „Button".

**Fokus als Ansagemechanismus**

Bei jedem Schritt im Buchungsprozess wandert der Fokus auf die neue Überschrift. Der Screenreader liest sie automatisch vor, inklusive Fortschritt: *„Datum wählen (Schritt 2 von 4)"*. Die Schrittangabe ist bewusst nur für Screenreader hinterlegt und stört die visuelle Darstellung nicht. Das gilt genauso für die Bestätigungsseite nach einer erfolgreichen Buchung.

**Statusmeldungen**

Für Änderungen, bei denen der Fokus nicht springen soll, gibt es eine Live-Region: geänderter Kalendermonat, aktualisierte Trefferzahl, gespeicherte Änderungen, abgelaufene Sitzung. Dringende Meldungen unterbrechen, alles andere wartet auf eine Sprechpause – damit die Ansagen hilfreich bleiben und nicht zum Dauerrauschen werden.

**Zeitslots und Kalender**

* Jeder Zeitslot trägt einen vollständigen Namen aus Aktion, Ressource, Buchungsoption und Zeitpunkt – etwa *„Buchen: Besprechungsraum Nord – Meeting, 14. März 2026, 14:00"*.
* Ausgewählte Slots melden ihren Zustand, ladende Slots melden sich als beschäftigt.
* Der Datumskalender ist ein echtes Raster nach W3C-Muster: Wochentagsspalten mit ausgeschriebenem Namen, Monat und Jahr als Rasterbeschriftung, ausgewählte Tage als solche gekennzeichnet. Beim Fokus auf eine Zelle liest der Screenreader Tag und Wochentag – ohne dass bei jedem Tag das komplette Datum wiederholt wird.

**Formulare**

Labels sind programmatisch mit ihren Feldern verknüpft. Schlägt die Validierung fehl, springt der Fokus auf das erste fehlerhafte Feld, statt die Nutzer:in die Fehlermeldung suchen zu lassen.

## Buchen ohne Maus und ohne Bildschirm

<Steps>
  <Step title="Ressource finden">
    Über `Tab` zur Suche, Suchbegriff eingeben, mit den Pfeiltasten durch die Treffer. Die Trefferanzahl wird angesagt.
  </Step>

  <Step title="Buchungsoption wählen">
    Auswahllisten öffnen sich mit `Enter`, die Pfeiltasten navigieren, `Enter` bestätigt. Der ausgewählte Eintrag wird als solcher angesagt.
  </Step>

  <Step title="Datum und Zeit wählen">
    Im Kalenderraster mit den Pfeiltasten navigieren, `Bild auf` und `Bild ab` wechseln den Monat. Freie Zeitslots erscheinen als Buttons mit vollständiger Beschriftung.
  </Step>

  <Step title="Angaben ergänzen">
    Zusatzleistungen, Anzahl und Formularfelder sind normale Bedienelemente mit Label. Der Warenkorb meldet Änderungen über die Live-Region.
  </Step>

  <Step title="Abschließen">
    Nach dem Bezahlen springt der Fokus auf die Bestätigungsüberschrift – die Buchungsbestätigung wird also unmittelbar vorgelesen.
  </Step>
</Steps>

## Sehen, Lesen, Sprache

* **Fokusindikator** mit deutlichem Kontrast auf allen Hintergründen.
* **Zoom bis 200 %** ohne Layoutbruch; die Buchungsseite ist vollständig responsiv.
* **Keine blinkenden oder automatisch bewegten Inhalte**, die Aufmerksamkeit erzwingen.
* **Buchungsseite in über 25 Sprachen** – darunter alle EU-Amtssprachen. Sprachwahl und Zeitzone sind für Nutzer:innen frei umstellbar, Datums- und Zeitangaben werden entsprechend lokalisiert formatiert.

<Tip>
  Wenn du eigene Markenfarben hinterlegst, prüfe den Kontrast: WCAG 2.2 AA verlangt mindestens 4,5:1 für normalen Text und 3:1 für große Schrift und Bedienelemente. Ein sehr helles Akzentgrün auf Weiß sieht in der Vorschau gut aus, ist für viele Nutzer:innen aber nicht lesbar.
</Tip>

## anny AI: Buchen per Sprache

Nicht jede Barriere lässt sich durch eine bessere Oberfläche lösen. Manche Menschen kommen mit Formularen grundsätzlich schwer zurecht – wegen einer kognitiven Beeinträchtigung, wegen motorischer Einschränkungen, wegen fehlender Routine mit digitalen Anwendungen oder schlicht, weil sie lieber sprechen.

Mit [anny AI](/anny-ai-booking) bieten wir dafür einen vollwertigen zweiten Kanal: Buchen in natürlicher Sprache, per Telefon oder Chat.

* **Vollständige Buchung im Gespräch** – Verfügbarkeit prüfen, Preis nennen, Formularfelder abfragen, abschließen.
* **Bestehende Buchungen verwalten** – Termine abrufen und stornieren.
* **Ohne E-Mail-Adresse und ohne Konto** – bei telefonischer Buchung genügt die Handynummer, die Bestätigung kommt per SMS.
* **Rund um die Uhr erreichbar**, auch außerhalb deiner Geschäftszeiten.
* **Dieselben Regeln wie online**: anny AI prüft Verfügbarkeiten, Preise und Buchungsregeln in Echtzeit gegen dein System. Es kann keine Buchung entstehen, die über die Buchungsseite nicht ebenfalls möglich wäre.

<Note>
  anny AI ersetzt keine barrierefreie Oberfläche – beides muss funktionieren, und beides tut es. Der Sprachkanal ist ein zusätzlicher Weg, kein Ausweichweg.
</Note>

## Wie wir das prüfen

Barrierefreiheit verfällt, wenn man sie nur einmal herstellt. Deshalb prüfen wir auf drei Ebenen:

<AccordionGroup>
  <Accordion title="Automatisiert bei jeder Änderung">
    Unsere Entwicklungsumgebung prüft jede Komponente automatisch gegen einen Satz von Barrierefreiheitsregeln – unter anderem: Bilder brauchen Alternativtexte, Buttons brauchen einen zugänglichen Namen, ARIA-Rollen und -Attribute müssen gültig sein, Tab-Reihenfolgen dürfen nicht manuell verbogen werden, Auslöser von Auswahlmenüs müssen echte Buttons sein. Verstöße blockieren die Auslieferung. Ergänzt wird das durch eigens für anny geschriebene Prüfregeln für unsere wiederkehrenden Komponentenmuster.
  </Accordion>

  <Accordion title="Manuell durch das Team">
    Neue und geänderte Oberflächen werden gegen eine feste Checkliste geprüft: komplette Bedienung nur mit der Tastatur, Test mit VoiceOver und NVDA, logische Fokusreihenfolge, sichtbarer Fokus, Darstellung bei 200 % Zoom, Kontrastprüfung, Verhalten in hellem und dunklem Erscheinungsbild. Für unsere Entwickler:innen sind die dabei anzuwendenden Muster als verbindliche interne Richtlinien dokumentiert – sie beschreiben pro Komponententyp, welches ARIA-Muster, welche Tastaturbelegung und welche Ansagen vorgeschrieben sind.
  </Accordion>

  <Accordion title="Selbstbewertung nach BFSG">
    Das BFSG sieht ein Selbstbewertungsverfahren vor: Anbieter prüfen und dokumentieren die Barrierefreiheit ihres Angebots selbst, eine externe Zertifizierungspflicht gibt es nicht. Wir haben die anny-Buchungsseite entlang der Erfolgskriterien von WCAG 2.2 AA und der EN 301 549 geprüft. Ergebnis: Die Buchungsseite erfüllt WCAG 2.2 AA. Bei größeren Produktänderungen prüfen wir neu und aktualisieren diese Seite.
  </Accordion>
</AccordionGroup>

## Umfang der Aussage

Was diese Konformitätsaussage abdeckt und was nicht:

* Sie gilt für die **Buchungsseite und den Kundenbereich** – also dort, wo deine Endkund:innen unterwegs sind. Das ist der für das BFSG relevante Umfang.
* **Von dir eingestellte Inhalte** – Ressourcenbeschreibungen, Bilder, PDF-Anhänge, eigene Formulartexte – können wir technisch nicht barrierefrei machen. Dafür bist du verantwortlich.
* Inhalte von **Drittanbietern**, etwa eingebettete Zahlungsformulare oder Kartendarstellungen, unterliegen deren Barrierefreiheit.

<Warning>
  Ist dir eine Barriere begegnet? Melde sie an [support@anny.co](mailto:support@anny.co) mit einer kurzen Beschreibung, der betroffenen Seite und – falls bekannt – der verwendeten Hilfstechnologie. Meldungen zu Barrieren behandeln wir vorrangig.
</Warning>

## Was das für dich als Betreiber:in bedeutet

Seit dem 28. Juni 2025 gilt das BFSG für Dienstleistungen im elektronischen Geschäftsverkehr gegenüber Verbraucher:innen. Ausgenommen sind Kleinstunternehmen mit weniger als 10 Beschäftigten und höchstens 2 Mio. € Jahresumsatz. Ob du betroffen bist, hängt von deinem Angebot ab – das ist eine Rechtsfrage, die wir nicht für dich beantworten können.

| Bringt anny mit | Musst du selbst leisten |
| - | - |
| Barrierefreie Buchungsstrecke, Tastaturbedienung, Screenreader-Unterstützung | Alternativtexte und verständliche Beschreibungen für deine eigenen Inhalte |
| Standardkonforme Bedienelemente, Formulare und Kalender | Ausreichender Kontrast, wenn du eigene Markenfarben setzt |
| Mehrsprachige Oberfläche | Barrierefreie eigene Dokumente (z. B. PDF-Hausordnungen) |
| Alternativer Buchungskanal über anny AI | Deine eigene Barrierefreiheitserklärung mit Kontakt- und Feedbackmöglichkeit |

<Tip>
  Für deine eigene Barrierefreiheitserklärung kannst du auf diese Seite verweisen, um den Stand der eingesetzten Buchungssoftware zu belegen. Die Erklärung selbst muss von dir kommen und dein Gesamtangebot abdecken.
</Tip>

## FAQ

<AccordionGroup>
  <Accordion title="Kann eine blinde Person bei uns eigenständig buchen?">
    Ja. Die vollständige Buchungsstrecke ist per Tastatur und Screenreader bedienbar – von der Ressourcensuche bis zur Bestätigung. Zusätzlich kann sie über anny AI telefonisch buchen, ohne die Website zu nutzen.
  </Accordion>

  <Accordion title="Erfüllt anny WCAG 2.2 AA?">
    Ja. Die Buchungsseite ist nach WCAG 2.2 AA entwickelt und von uns selbst geprüft. Diese Seite ist die dazugehörige Konformitätsaussage. Wenn dir trotzdem eine Barriere begegnet, melde sie an [support@anny.co](mailto:support@anny.co) – solche Meldungen behandeln wir vorrangig.
  </Accordion>

  <Accordion title="Gibt es ein Zertifikat oder Prüfsiegel?">
    Das BFSG sieht ein Selbstbewertungsverfahren vor und verlangt kein externes Siegel. Unsere Prüfung nach WCAG 2.2 AA und EN 301 549 ist genau diese Selbstbewertung. Brauchst du für eine Ausschreibung eine ausformulierte Konformitätsaussage, schreib uns an [support@anny.co](mailto:support@anny.co).
  </Accordion>

  <Accordion title="Gilt die Barrierefreiheit auch für eingebettete Buchungsseiten (Widget/iFrame)?">
    Ja – es handelt sich um dieselbe Anwendung mit denselben Komponenten. Achte auf deiner Seite darauf, dass die Einbettung eine sinnvolle Beschriftung hat und der Tastaturfokus sie erreichen kann.
  </Accordion>

  <Accordion title="Funktioniert das auch in Microsoft Teams und den anny Apps?">
    Die Buchungsoberfläche in Teams basiert auf denselben Komponenten wie die Web-Buchungsseite. Die Tastatur- und Screenreader-Unterstützung des umgebenden Clients liegt jedoch bei Microsoft.
  </Accordion>

  <Accordion title="Wie hoch ist der Aufwand für uns?">
    Für die Buchungssoftware selbst: keiner. Sie ist so ausgeliefert. Aufwand entsteht bei deinen eigenen Inhalten – Beschreibungen, Bilder, Dokumente – und bei deiner Barrierefreiheitserklärung.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Konformität: Die anny-Buchungsseite ERFÜLLT WCAG 2.2 Level AA (nach interner Prüfung/Selbstbewertung). Diese Doku-Seite ist die zugehörige Konformitätsaussage.
> * Europäischer Rahmen EN 301 549 (harmonisiert derzeit V3.2.1 mit WCAG 2.1 AA, Folgeversion mit WCAG 2.2 für 2026 erwartet)
> * BFSG gilt seit 28.06.2025; setzt EAA (EU 2019/882) um; Kleinstunternehmen-Ausnahme: unter 10 Beschäftigte UND höchstens 2 Mio. € Jahresumsatz
> * BFSG sieht Selbstbewertungsverfahren vor – KEINE externe Zertifizierungspflicht. anny hat KEIN externes Prüfsiegel; niemals ein Zertifikat oder bestandenes externes Audit behaupten.
> * Umfang der Konformitätsaussage: Buchungsseite und Kundenbereich (BFSG-relevant)
> * Tastatur: Tab/Shift+Tab, Pfeiltasten, Enter/Leertaste, Escape, Pos1/Ende, Bild auf/ab; Taste B springt auf Ressourcenseiten ins Buchungsformular
> * Screenreader-getestet mit VoiceOver (macOS/iOS) und NVDA (Windows)
> * Fokusmanagement: Fokus springt bei jedem Buchungsschritt auf die Schrittüberschrift, Ansage inkl. Schritt X von Y (nur für Screenreader hinterlegt); Fokusrückgabe an Auslöser beim Schließen von Dialogen
> * Live-Region für Statusmeldungen (höflich/dringend), Kalenderraster nach W3C APG mit Wochentagsspalten
> * Automatisierte a11y-Prüfregeln blockieren die Auslieferung bei Verstößen; ergänzt durch anny-eigene Prüfregeln
> * anny AI = zusätzlicher barrierefreier Buchungskanal (Telefon/Chat), inkl. Stornierung; Buchungsänderung (Umbuchung) über anny AI aktuell NICHT möglich
> * Buchungsseite in über 25 Sprachen inkl. aller EU-Amtssprachen
> * Verantwortungsteilung: anny liefert die Software; Betreiber:in verantwortet eigene Inhalte, Markenfarben-Kontrast, eigene Dokumente und die eigene Barrierefreiheitserklärung
> * Barrieremeldungen an [support@anny.co](mailto:support@anny.co) werden vorrangig behandelt


# anny Agent: Dein KI-Mitarbeiter im Admin
Source: https://docs.anny.co/anny-agent

Was der anny Agent kann, wie du ihn bedienst und was du zu Kosten und Datenschutz wissen musst.

Der **anny Agent** ist ein KI-Mitarbeiter direkt in deinem Admin. Du sagst ihm in normaler Sprache, was du brauchst. Er arbeitet mit den echten Daten in deinem Account: Er legt Ressourcen und Services an, verschiebt Buchungen, schreibt Kunden und erklärt dir, wo du etwas einstellst. Standardmäßig fragt er dich, bevor er etwas ändert.

<Note>
  Der anny Agent ist Teil von Admin 3.0 und während der Beta kostenlos. Ab dem 5. Oktober kannst du auf anny.co in den neuen Admin wechseln, ab dem 19. Oktober auf anny.eu. Mehr dazu unter [Admin 3.0: Was sich ändert](/admin-3-0).
</Note>

<Tip>
  Der anny Agent ist nicht dieselbe KI wie anny AI am Telefon oder im Chat-Widget für deine Kunden. Die richtest du unter [anny AI einrichten](/anny-ai-setup) ein.
</Tip>

## Was der anny Agent kann

<Frame>
  <img alt="Funktionen des anny Agent im Überblick: startet mit Vorschlägen, kennt die aktuelle Seite, zeigt erst einen Plan, fragt vor jeder Änderung, macht jeden Schritt sichtbar, stellt Rückfragen mit Empfehlung, erklärt Schritt für Schritt und lässt sich seitlich, als Fenster oder im Vollbild öffnen" />
</Frame>

Du nutzt den Agenten auf drei Arten.

### Einrichten

Beschreibe dein Angebot, und der Agent baut es in anny auf: Ressourcen, Services, Öffnungszeiten und deine Buchungsseite.

> „Ich eröffne ein Massagestudio: drei Behandlungsräume, klassische Massage mit 60 und 90 Minuten, Hot Stone mit 75 Minuten. Geöffnet Montag bis Freitag 9 bis 20 Uhr, Samstag 10 bis 16 Uhr.“

Bei größeren Aufgaben zeigt er dir zuerst einen **Plan** mit allem, was er anlegen will, und mit den Annahmen, die er getroffen hat. Mit **Los geht's** startest du ihn, mit **Lieber anders** änderst du ihn. Reagierst du nicht, startet der Plan nach einem kurzen Countdown von selbst. Die einzelnen Änderungen gibst du trotzdem frei.

<Frame>
  <video aria-label="Der anny Agent zeigt einen Plan für ein Massagestudio mit Räumen, Services und Öffnungszeiten und legt danach alles an" />
</Frame>

### Erledigen

Gib ihm Aufgaben aus deinem Alltag, auch solche, die viele Datensätze auf einmal betreffen.

> „Der Salon fällt morgen aus. Verschieb alle Buchungen ins Atelier und sag den Kunden Bescheid.“

Der Agent sieht nach, was betroffen ist, und zeigt dir genau, welche Buchungen er ändert und wen er benachrichtigt. Erst nach deiner Freigabe führt er die Änderung aus.

<Frame>
  <video aria-label="Der anny Agent verschiebt alle Buchungen eines ausgefallenen Raums nach Freigabe und informiert die Kunden" />
</Frame>

### Erklären

Frag ihn, wie etwas in anny funktioniert. Er antwortet mit den richtigen Menüpunkten statt mit langen Hilfe-Artikeln und bietet dir an, es gleich für dich einzustellen. Gibt es mehrere Wege, fragt er nach und sagt dir, was er empfehlen würde.

> „Wie stelle ich ein, dass Stornos bis 24 Stunden vorher kostenlos sind?“

<Frame>
  <video aria-label="Der anny Agent erklärt die Einstellung kostenloser Stornierungen in drei Schritten und fragt, ob er sie für alle Services übernehmen soll" />
</Frame>

Außerdem kann der Agent:

* **Bilder und PDFs lesen:** Häng Screenshots, Fotos oder Dokumente an deine Nachricht, zum Beispiel eine Preisliste oder eine Fehlermeldung.
* **Den Support einschalten:** Kommt er nicht weiter, legt er eine Support-Anfrage an, die an das anny-Team geht. Der Button **Support** öffnet deshalb den Agenten.

## Einstieg

<Steps>
  <Step title="Agent öffnen">
    Klicke oben in der Leiste auf **KI-Agent** oder drücke ⌘L (Mac) bzw. Strg+L (Windows). Du kannst auch auf der Startseite direkt ins Feld „Wobei kann ich dir helfen?“ schreiben.
  </Step>

  <Step title="Aufgabe beschreiben">
    Wähle einen der Vorschläge oder schreib deine Frage in das Feld **Frag anny etwas …**. Die Seite, auf der du gerade bist, hängt automatisch als Chip am Gespräch. Mit **Seite nicht mitschicken** lässt du sie weg.
  </Step>

  <Step title="Plan und Änderungen prüfen">
    Bei **Freigabe nötig** siehst du, was sich ändert. Mit **Ausführen**, **Anlegen**, **Aktualisieren** oder **Endgültig löschen** gibst du frei, mit **Nicht ausführen** lehnst du ab.
  </Step>

  <Step title="Ergebnis ansehen">
    Der Agent zeigt dir, was er nachgeschaut und geändert hat. Du kannst im selben Gespräch nachfragen oder mit **Neues Gespräch** neu anfangen.
  </Step>
</Steps>

<Columns>
  <Frame>
    <img alt="Leeres Gespräch im anny Agent mit der Frage Was kann ich für dich tun und Vorschlägen wie Öffnungszeiten ändern oder Einen neuen Service anlegen" />
  </Frame>

  <Frame>
    <img alt="Freigabe nötig im anny Agent: 14 Buchungen vom Salon ins Atelier verschieben und 9 Kunden per E-Mail benachrichtigen, mit den Buttons Nicht ausführen und Ausführen" />
  </Frame>
</Columns>

<Tip>
  Deine erste Frage an den Agenten: „Was ist bei mir neu?“
</Tip>

## Bedienung im Detail

### Agent öffnen und schließen

Neben **Globale Suche** steht der Button **KI-Agent**. Ein Klick öffnet den Agenten, ein zweiter Klick schließt ihn wieder. Das Tastenkürzel steht am Button: auf dem Mac ⌘L, sonst Strg+L.

So öffnest du ihn noch:

* Auf der Startseite (Home in der Seitenleiste) über das Feld „Wobei kann ich dir helfen?“.
* Unten in der Seitenleiste über **Support**.
* In **Globale Suche** über die Zeile **anny KI-Agent fragen**. Was du schon eingetippt hast, steht darunter.
* An einem Hinweis mit dem Info-Symbol über **Agent fragen**. Der Text landet im Eingabefeld. Du sendest ihn selbst.

Der Agent merkt sich die Seite, auf der du gerade bist. Über dem Eingabefeld liegt ein Chip mit dem Seitentitel. Die Seite geht mit deiner Nachricht an anny. Mit **Seite nicht mitschicken** lässt du sie weg.

<Frame>
  <img alt="Kalender im Admin: Seitenleiste mit Kalender, oben der Button KI-Agent, rechts der geöffnete anny Agent mit Begrüßung, Vorschlägen und dem Seiten-Chip Calendar" />
</Frame>

### Eine Frage stellen

Im Fenster zeigt der Agent Vorschläge zur aktuellen Seite. Alternativ tippst du deine Frage selbst ins Eingabefeld und sendest sie mit **Senden**. Über die Büroklammer hängst du bis zu fünf Bilder (PNG, JPG, WebP, GIF) oder PDFs an, jede Datei höchstens 10 MB. Mit **Stopp** brichst du eine laufende Antwort ab.

Unter einer fertigen Antwort stehen **Hilfreich** und **Nicht hilfreich**. Du kannst im selben Gespräch nachfassen.

### Freigabe von Änderungen

Neben dem Eingabefeld steht die **Freigabe von Änderungen**. Standard ist **Nachfragen**.

| Modus | Was passiert |
| - | - |
| **Nachfragen** | anny zeigt dir jede Änderung und wartet auf deine Freigabe. |
| **Automatisch** | anny legt an, ändert und löscht ohne Rückfrage, bis du den Modus ausschaltest oder die Seite neu lädst. |

Bei **Nachfragen** erscheint „Freigabe nötig“. Der Button heißt je nach Aktion **Anlegen**, **Aktualisieren**, **Ausführen** oder **Endgültig löschen**. **Nicht ausführen** lehnt ab. Solange der Agent wartet, zeigt **KI-Agent** in der Leiste, dass anny auf deine Freigabe oder auf deine Antwort wartet.

**Automatisch** schaltest du über **Änderungen automatisch ausführen** ein und bestätigst mit **Einschalten**. Bei Einstellungen der ganzen Organisation und bei Aktionen, die sich nicht rückgängig machen lassen, fragt der Agent trotzdem.

### Darstellung

Über **Layout wechseln** wählst du Modal, Vollbild oder Sidebar.

### Frühere Gespräche

**Frühere Gespräche** öffnet deine bisherigen Unterhaltungen in diesem Account. **Neues Gespräch** startet ein leeres Gespräch.

## Du behältst die Kontrolle

* **Freigabe vor jeder Änderung:** Im Standardmodus **Nachfragen** wartet jede Änderung auf dein OK. Nur wenn du selbst **Automatisch** einschaltest, führt er Änderungen ohne Rückfrage aus – und auch dann nicht bei Einstellungen der ganzen Organisation oder bei endgültigen Aktionen.
* **Deine Rechte gelten auch für ihn:** Der Agent arbeitet in dem Account, in dem du angemeldet bist, und darf nur, was du mit deiner Rolle selbst darfst.
* **Alles nachvollziehbar:** Was der Agent ändert, schreibt oder verschickt, steht in der Aktivität am Datensatz mit dem Label **via KI-Agent**.

### Änderungen nachverfolgen

Änderungen, die der Agent im Admin ausführt, erkennst du im [Aktivitäts-Log](/activity-log). An einem Datensatz heißt die Zeitleiste **Aktivität**. Du findest sie in den Details einer Buchung, einer Bestellung oder eines Kunden. An einer Ressource oder einem Service öffnest du sie über die Aktion **Aktivität**.

Klicke auf **Filtern** und wähle **Änderungen**. Der Eintrag trägt das Label **via KI-Agent**. So siehst du, was nicht von einer Person aus deinem Team stammt. Klappst du den Eintrag auf, siehst du den alten und den neuen Wert und, falls vorhanden, die Begründung des Agenten.

<Frame>
  <img alt="Aktivitäts-Log mit Filter Änderungen und aufgeklappter Buchungsänderung via KI-Agent mit Begründung sowie alter und neuer Uhrzeit" />
</Frame>

<Note>
  Das Label **via KI-Agent** gibt es nicht nur bei Änderungen. Schreibt der Agent eine Notiz oder eine E-Mail, erscheint sie mit demselben Label unter **Notizen** beziehungsweise **Kommunikation**.
</Note>

## FAQ

### Kosten

<AccordionGroup>
  <Accordion title="Was kostet der anny Agent?">
    Während der Beta ist der anny Agent kostenlos.
  </Accordion>

  <Accordion title="Und nach der Beta?">
    Danach gibt es einen dauerhaft kostenlosen Free Tier. Die Details geben wir rechtzeitig vor dem Roll-out bekannt.
  </Accordion>

  <Accordion title="Muss ich den Agenten freischalten oder buchen?">
    Nein. Der Agent ist im neuen Admin auf anny.co und anny.eu bereits aktiv. Du musst ihn nicht nutzen: Solange du ihm nichts schreibst, tut er nichts in deinem Account.
  </Accordion>
</AccordionGroup>

### Datenschutz und Sicherheit

<AccordionGroup>
  <Accordion title="Wo werden meine Daten verarbeitet?">
    Der Agent nutzt **anny AI v1**, unser eigenes KI-Modell. Es läuft auf von anny betriebener Infrastruktur auf Servern in der EU. Die Verarbeitung ist DSGVO-konform. Das Modell siehst du auch am Eingabefeld.
  </Accordion>

  <Accordion title="Gehen meine Daten an OpenAI oder andere US-Anbieter?">
    Nein. Deine Daten gehen nicht an OpenAI oder andere US-Anbieter, und durch den Agenten findet keine Übermittlung in Länder außerhalb der EU statt. Welche Dienstleister am Betrieb beteiligt sind, steht im [anny Agent Datenblatt](/anny-agent-datenblatt).
  </Accordion>

  <Accordion title="Kann der Agent etwas ohne mein OK ändern?">
    Nicht im Standardmodus **Nachfragen**: Dort wartet jede Änderung auf deine Freigabe. Nur wenn du selbst **Automatisch** einschaltest, führt er Änderungen ohne Rückfrage aus – und auch dann fragt er bei Einstellungen der ganzen Organisation und bei endgültigen Aktionen nach.
  </Accordion>

  <Accordion title="Darf der Agent mehr als ich?">
    Nein. Er arbeitet mit deinen Rechten in deinem Account. Was du mit deiner Rolle nicht darfst, darf auch der Agent nicht.
  </Accordion>

  <Accordion title="Welche Daten sieht der Agent?">
    Die Daten deines Accounts, auf die du selbst zugreifen darfst, deine Nachrichten und Anhänge sowie die Seite, auf der du gerade bist. Die Seite lässt du mit **Seite nicht mitschicken** weg.
  </Accordion>

  <Accordion title="Kann ich sehen, was der Agent gemacht hat?">
    Ja. Jede Änderung, Notiz und E-Mail des Agenten steht in der [Aktivität](/activity-log) des Datensatzes mit dem Label **via KI-Agent**, inklusive altem und neuem Wert.
  </Accordion>

  <Accordion title="Wo finde ich weitere Informationen zur Sicherheit von anny?">
    Im [anny Agent Datenblatt](/anny-agent-datenblatt), im [anny Trust Center](https://trust.anny.co/) und unter [Datenschutz](/data-privacy).
  </Accordion>
</AccordionGroup>

### Sonstiges

<AccordionGroup>
  <Accordion title="Wo ist der Support-Chat hin?">
    Der Button **Support** öffnet jetzt den anny Agent. Er hilft dir direkt weiter und legt bei Bedarf eine Anfrage für das Support-Team an.
  </Accordion>

  <Accordion title="Kann ich anny mit ChatGPT, Claude & Co. nutzen?">
    Daran arbeiten wir als Nächstes: anny auch in deinen eigenen KI-Tools. Sobald es so weit ist, erfährst du es als Erstes.
  </Accordion>

  <Accordion title="Kann ich den Agenten ausschalten?">
    Ja. Unter **Apps & Integrationen → anny Apps → anny Agent** deaktivierst du den Agenten für deine ganze Organisation.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich kann im Gespräch nicht weiterschreiben">
    Ursache: Das Gespräch ist abgeschlossen oder hat sein Nachrichtenlimit erreicht. Steht „Diese Konversation ist abgeschlossen.“ oder „Dieses Gespräch hat sein Nachrichtenlimit erreicht. Starte ein neues Gespräch, um weiterzumachen.“, starte **Neues Gespräch**. Laufen schon zu viele Anfragen, wartet der Agent, bis eine fertig ist.
  </Accordion>

  <Accordion title="In der Leiste steht, dass anny wartet">
    Ursache: Eine Änderung braucht deine Freigabe, oder der Agent wartet auf eine Antwort. Öffne **KI-Agent** und gib die Änderung frei oder schreib im Gespräch weiter.
  </Accordion>

  <Accordion title="Automatisch ist nach dem Neuladen weg">
    Ursache: Der Modus gilt nur bis zum Ausschalten oder bis zum Neuladen der Seite. Schalte **Änderungen automatisch ausführen** erneut ein und bestätige mit **Einschalten**.
  </Accordion>
</AccordionGroup>

Single article for the in-admin agent (drawer title **anny Agent**, topbar button **KI-Agent**, ⌘L / Strg+L). Replaces the former `/anny-assistant` page, which redirects here. EN twin `/en/anny-agent`. Not the customer-facing phone/chat product (`/anny-ai-setup`, `/anny-ai-faq`) and not the **anny AI** tab under account settings. Technical and legal details (hosting, sub-processors, retention, training, EU AI Act) live in `/anny-agent-datenblatt`.

* Entry points: topbar **KI-Agent** next to **Globale Suche** (`components.cmdBar.agent.launcher`); home field „Wobei kann ich dir helfen?“ with „Was steht heute an?“, „Offene Anfragen prüfen“, „Freie Ressourcen finden“; sidebar footer **Support** (opens the agent, which can create a support request); Globale Suche row **anny KI-Agent fragen**; info-icon **Agent fragen** (prefills the composer, does not send).
* Attachments: up to 5 files (PNG, JPG, WebP, GIF, PDF), max 10 MB each.
* Approval: default **Nachfragen**; **Automatisch** until switched off or reload. Organization settings and irreversible actions always ask. Plan step for larger tasks auto-starts after a countdown; individual changes still need approval.
* Availability: no plan gate (`agentDrawerEnabled`, on by default) on anny.co and anny.eu. Usage optional. Organization-wide off switch: **Apps & Integrationen → anny Apps → anny Agent**.
* Costs: free during beta, afterwards a permanently free tier (do not state its scope).
* Model: anny AI v1, own model on anny-operated EU infrastructure; no OpenAI or other US providers; no third-country transfer. For sub-processors refer to the Datenblatt.
* Activity log: timeline **Aktivität**, label **via KI-Agent** under **Änderungen**, **Notizen** and **Kommunikation**. Not under **System**. No separate AI filter.
* External agents (ChatGPT, Claude): planned, no dates.


# anny Agent Datenblatt
Source: https://docs.anny.co/anny-agent-datenblatt



Dieses Datenblatt fasst die technischen und rechtlichen Eckdaten des **anny Agent** zusammen. Es richtet sich an Datenschutzbeauftragte, IT-Sicherheit und Beschaffung und hilft dir bei Sicherheitsfragebögen, Datenschutz-Folgenabschätzungen und internen KI-Freigaben. Wie du den Agenten bedienst, steht unter [anny Agent](/anny-agent).

<Tip>
  Der anny Agent ist nicht anny AI am Telefon oder im Chat-Widget für deine Kunden. Für anny AI gelten die [Zusatzvereinbarung anny AI](https://anny.co/agreement-anny-ai) und eigene Unterauftragsverarbeiter.
</Tip>

## Auf einen Blick

<table>
  <colgroup>
    <col />

    <col />
  </colgroup>

  <thead>
    <tr>
      <th />

      <th />
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>**Produkt**</td>
      <td>anny Agent, KI-Assistent im Admin (Admin 3.0)</td>
    </tr>

    <tr>
      <td>**Nutzende**</td>
      <td>Angemeldete Nutzer:innen im Admin, jeweils mit ihren eigenen Rechten</td>
    </tr>

    <tr>
      <td>**KI-Modell**</td>
      <td>anny AI v1: von anny feinjustiertes Sprachmodell auf Basis eines Open-Source-Modells (Qwen-Modellfamilie)</td>
    </tr>

    <tr>
      <td>**Betrieb**</td>
      <td>Auf von anny betriebener Infrastruktur, GPU-Server bei UpCloud (UpCloud Oy, Helsinki, Finnland)</td>
    </tr>

    <tr>
      <td>**Fallback**</td>
      <td>Bei Ausfall oder Überlast der eigenen GPU-Server: Melious AI GmbH (Saarbrücken) mit Inferenz ausschließlich bei Anbietern in der EU</td>
    </tr>

    <tr>
      <td>**Verarbeitungsort**</td>
      <td>Rechenzentren in der EU</td>
    </tr>

    <tr>
      <td>**US-Anbieter**</td>
      <td>Keine. Keine Übermittlung an OpenAI oder andere US-Anbieter</td>
    </tr>

    <tr>
      <td>**Training mit Kundendaten**</td>
      <td>Nein</td>
    </tr>

    <tr>
      <td>**Änderungen**</td>
      <td>Standardmäßig nur nach Freigabe durch dich</td>
    </tr>

    <tr>
      <td>**Protokollierung**</td>
      <td>Jede Änderung in der Aktivität des Datensatzes, Label **via KI-Agent**</td>
    </tr>

    <tr>
      <td>**Speicherdauer**</td>
      <td>Gesprächsverläufe werden nach 90 Tagen automatisch gelöscht</td>
    </tr>

    <tr>
      <td>**Kosten**</td>
      <td>Während der Beta kostenlos, danach dauerhaft kostenloser Free Tier</td>
    </tr>
  </tbody>
</table>

## Modell und Training

* **Basis:** anny AI v1 baut auf einem frei verfügbaren Open-Source-Sprachmodell auf. anny hat es für die Arbeit in anny feinjustiert.
* **Trainingsdaten:** Für die Feinjustierung hat anny ausschließlich eigens erstellte Szenarien genutzt. Echte Kunden-, Buchungs- oder Nutzerdaten sind nicht eingeflossen.
* **Keine Nutzung deiner Daten:** Deine Nachrichten, Anhänge, die Antworten des Agenten und die Daten in deinem Account werden nicht zum Training oder zur Feinjustierung von KI-Modellen verwendet.

## Welche Daten der Agent verarbeitet

| Datenart | Wann |
| - | - |
| Deine Nachrichten und die Antworten des Agenten | Bei jeder Nutzung |
| Anhänge (Bilder, Screenshots, PDFs) | Wenn du sie anhängst |
| Die Seite, auf der du gerade bist | Standardmäßig; mit **Seite nicht mitschicken** lässt du sie weg |
| Daten deines Accounts, z. B. Ressourcen, Services, Buchungen, Kundendaten, Einstellungen | Wenn der Agent sie für deine Anfrage nachschlägt – nur im Rahmen deiner Admin Rechte |
| Ausgeführte Aktionen mit altem und neuem Wert | Bei jeder Änderung, in der [Aktivität](/activity-log) |

Solange niemand dem Agenten schreibt, verarbeitet er keine Daten. Gesprächsverläufe werden nach 90 Tagen automatisch gelöscht.

## Kontrolle und Sicherheit

* **Freigabe:** Standard ist der Modus **Nachfragen**. Der Agent zeigt dir jede Änderung und wartet auf dein OK. Im Modus **Automatisch** führt er Änderungen ohne Rückfrage aus, bis du den Modus ausschaltest oder die Seite neu lädst. Bei Einstellungen der ganzen Organisation und bei Aktionen, die sich nicht rückgängig machen lassen, fragt er immer.
* **Rechte:** Der Agent arbeitet in dem Account, in dem du angemeldet bist, und darf nur, was du mit deiner Rolle selbst darfst. Er kann keine Rechte erweitern.
* **Mandantentrennung:** Der Agent sieht nur Daten der Organisation, in der du angemeldet bist.
* **Nachvollziehbarkeit:** Jede Änderung, Notiz und E-Mail des Agenten steht mit altem und neuem Wert in der [Aktivität](/activity-log) des Datensatzes.
* **Support:** Kommt der Agent nicht weiter, legt er eine Support-Anfrage an, die an das anny-Team geht.
* **Ausschalter:** Unter **Apps & Integrationen → anny Apps → anny Agent** deaktivierst du den Agenten für deine ganze Organisation. Danach verarbeitet er keine Daten mehr.

## Grenzen der KI

Antworten, Auswertungen und Vorschläge des Agenten werden automatisch erzeugt. Sie können unvollständig, veraltet oder falsch sein. Prüfe Ergebnisse, bevor du sie für wichtige oder rechtlich relevante Entscheidungen nutzt, und sieh dir bei jeder Freigabe an, was sich ändert.

## Rechtliche Einordnung

### Datenschutz (DSGVO)

* **Rollen:** Für die Daten in deinem Account bist du Verantwortlicher, anny ist Auftragsverarbeiter. Es gilt der Auftragsverarbeitungsvertrag (AVV) zwischen dir und anny.
* **Unterauftragsverarbeiter:** Für den Betrieb der GPU-Server setzt anny UpCloud ein. Als Fallback bei Ausfall oder Überlast nutzt anny Melious AI GmbH, Saarbrücken. Melious leitet Anfragen ausschließlich an Inferenz-Anbieter mit Sitz in der EU weiter. Beide sind im AVV als Unterauftragsverarbeiter aufgeführt.

- **Drittlandtransfer:** Durch den Agenten findet keine Übermittlung in Länder außerhalb der EU statt.
- **Automatisierte Entscheidungen:** Der Agent trifft keine Entscheidungen im Sinne von Art. 22 DSGVO. Er bereitet Aktionen vor, die du freigibst.
- **Datenschutzerklärung:** Details stehen in der [Datenschutzerklärung von anny](https://anny.co/privacy).

### EU AI Act

* **Rolle:** anny ist Anbieter des KI-Systems anny Agent. Du setzt es als Betreiber in deiner Organisation ein.
* **Risikoklasse:** Nach Einschätzung von anny ist der anny Agent kein Hochrisiko-KI-System im Sinne von Anhang III. Er dient der Verwaltung von Buchungen, Ressourcen und Einstellungen.
* **Transparenz:** Der Agent ist im Admin klar als KI gekennzeichnet (**KI-Agent**). Aktionen des Agenten sind in der Aktivität mit **via KI-Agent** markiert.
* **Nicht erlaubte Einsatzzwecke:** Nutze den Agenten nicht, um Entscheidungen über Beschäftigte, über Ansprüche auf öffentliche Unterstützungsleistungen oder über den Zugang zu Bildungseinrichtungen zu treffen oder vorzubereiten. Diese Einsatzzwecke schließen die AGB aus.
* **KI-Kompetenz:** Als Betreiber sorgst du dafür, dass deine Admins mit dem Agenten und seinen Grenzen vertraut sind. Dieses Datenblatt und der Artikel [anny Agent](/anny-agent) helfen dir dabei.

### Vertragsgrundlagen

| Dokument | Inhalt |
| - | - |
| [AGB](https://anny.co/terms), § 4a KI-Funktionen | Leistungsumfang, Freigabe, Grenzen der KI, nicht erlaubte Einsatzzwecke, kein Training |
| Auftragsverarbeitungsvertrag (AVV) | Datenverarbeitung im Auftrag, technische und organisatorische Maßnahmen, Unterauftragsverarbeiter |
| [Datenschutzerklärung](https://anny.co/privacy) | Informationen für Nutzer:innen des Admin |

## Fragen

Für Sicherheitsfragebögen, Datenschutz-Folgenabschätzungen oder Rückfragen deines Datenschutzbeauftragten erreichst du unseren Datenschutz unter [privacy@anny.co](mailto:privacy@anny.co). Weitere Informationen zur Sicherheit von anny findest du im [anny Trust Center](https://trust.anny.co/).

Fact sheet for the in-admin anny Agent (not the customer-facing anny AI phone/chat product). DE twin of `/en/anny-agent-fact-sheet`. Confirmed facts: model anny AI v1, fine-tuned from an open-source Qwen-family model using only synthetic, anny-created scenarios; customer data is never used for training or fine-tuning; runs on anny-operated infrastructure with GPU servers at UpCloud (UpCloud Oy, Helsinki, Finland) in the EU; fallback on outage or overload: Melious AI GmbH (Saarbrücken), routing only to EU-based inference providers; no OpenAI or other US providers; no third-country transfer. Approval modes Nachfragen (default) / Automatisch; organization settings and irreversible actions always ask. Works only with the logged-in user's permissions. Organization-wide off switch: Apps & Integrationen → anny Apps → anny Agent. Chat histories are deleted automatically after 90 days. Legal: anny is processor (GDPR) and provider (EU AI Act); not a high-risk AI system per anny's assessment; AGB § 4a: version dated 01.10.2026; for existing customers it applies on acceptance, at the latest 31.10.2026.


# Buchung über anny AI
Source: https://docs.anny.co/anny-ai-booking

Ermögliche deinen Kund:innen, per Telefon oder Chat Termine zu buchen – mit automatischer Verfügbarkeitsprüfung, Preisberechnung und Bestätigung. 

anny AI kann nicht nur Fragen beantworten, sondern vollständige Buchungen am Telefon und im Chat durchführen. Dein KI-Assistent kennt deine Ressourcen, Buchungsoptionen, Abos und Buchungspakete. Er prüft Verfügbarkeiten und berechnet Preise genau wie auf deiner Buchungsseite – und führt Kund:innen durch den gesamten Buchungsprozess.

## Für wen ist diese Funktion geeignet?

Die telefonische Buchung über anny AI ist ideal für Anbieter:innen, die:

* häufig Buchungsanfragen per Telefon oder Chat erhalten und diese automatisieren möchten
* Kund:innen erreichen wollen, die lieber anrufen oder chatten, als selbstständig online zu buchen
* Buchungen auch außerhalb der Geschäftszeiten annehmen möchten
* Telefon und Chat als zusätzliche Kanäle neben der Online-Buchungsseite anbieten wollen

## Was ändert sich durch das Feature?

**Für Kund:innen:**

* Sie können per Telefon oder Chat buchen und erhalten eine sofortige Bestätigung per SMS (Telefon) oder direkt im Chat.
* Sie müssen keine E-Mail-Adresse angeben – die Handynummer reicht aus.
* Bestehende Kund:innen werden automatisch erkannt und persönlich begrüßt.
* Sie können auf ihre bestehenden Kontingente, Community-Ressourcen und Buchungspakete zugreifen.

**Für Admins:**

* Buchungen über anny AI erscheinen wie reguläre Buchungen im System.
* Es kann nie zu einer „falschen" Buchung kommen, die so nicht über die Buchungsseite möglich gewesen wäre – anny AI prüft dieselben Regeln.
* Mehrere Buchungen können in einem Gespräch in den Warenkorb gelegt werden.

<Warning>
  Die E-Mail-Adresse ist bei telefonischen Buchungen optional. Entscheidend ist die Handynummer der anrufenden Person. Die Buchungsbestätigung wird kostenlos per SMS an diese Nummer gesendet.
</Warning>

## So funktioniert der Buchungsprozess

1. Der/die Anrufer:in nennt den Wunsch (z.B. „Ich möchte morgen um 14 Uhr einen Termin buchen").
2. anny AI kennt deine Ressourcen und Buchungsoptionen und prüft die Verfügbarkeit – genau wie auf der Buchungsseite.
3. anny AI berechnet den Preis und nennt ihn der anrufenden Person.
4. Wenn ein Formular mit zusätzlichen Angaben hinterlegt ist (Custom Fields), fragt anny AI diese vollständig ab.
5. Der Abschluss der Buchung erfolgt je nach Zahlungskonfiguration:
6. **Bei Zahlung vor Ort oder kostenloser Buchung:** Die Buchung wird direkt abgeschlossen und per SMS bestätigt.
7. **Bei Online-Zahlung oder rechtlichen Dokumenten (z.B. AGB-Bestätigung):** anny AI sendet einen Checkout-Link per SMS. Der/die Anrufer:in schließt die Zahlung oder Bestätigung über diesen Link ab.

![](https://downloads.intercomcdn.eu/i/o/niegcmk9/151477203/37fdb42c6f1649efc71d6808b2a0/ai-buchungenfu%CC%88ranny-checkout.jpg?expires=1784560500\&signature=39c58c50e71a95f359ec1e9ff57d81c81dee12fb28dd02d5b2615fca876fc84f\&req=0dBuwV%2F9rjcrlxv889osp3PIU5YeKBXOhQIe90CYd2oKMTK79gh4LaoOg37G%0AgVSl94Jtzrv1K3kSiQ%3D%3D%0A)

<Tip>
  Wenn du Online-Zahlung konfiguriert hast, empfehlen wir zusätzlich die Option „Zahlung vor Ort" zu aktivieren. So kann die Buchung auch vollständig am Telefon abgeschlossen werden, ohne dass ein Checkout-Link nötig ist.
</Tip>

## Personenerkennung und Kundenkonto

Kund:innen werden automatisch über ihre Handynummer und/ oder bei Anmeldung im Chat erkannt, sofern diese in anny als Kund:in gepflegt ist. Erkannte Kund:innen profitieren von:

* Persönlicher Begrüßung mit Namen
* Zugriff auf bestehende Kontingente und Buchungspakete
* Einsicht in Community-Ressourcen (geschützte Buchungsoptionen)
* Möglichkeit, bestehende Buchungen zu stornieren
* Abruf von Kalenderterminen

<Note>
  Damit die Erkennung funktioniert, muss die Handynummer im Kundenprofil in anny hinterlegt sein
</Note>

### **anny AI Chat: Sichtbarkeit und Zugriffsrechte**

Der Chat richtet sich streng nach den Zugangsregelungen, die du für deine Organisation und Buchungsseite festgelegt hast:

* **Community-Pflicht:** Wenn deine Organisation eine Community-Mitgliedschaft voraussetzt und für Gäste blockiert ist, ist auch der Chat für externe Gäste nicht sichtbar.
* **Nur Mitglieder-Buchungen:** Wenn Ressourcen nur für Mitglieder buchbar sind, sieht ein Gast den Chat und kann Ressourcen filtern oder Fragen stellen – er kann die Buchung jedoch nicht abschließen.
* **Plattform-Sichtbarkeit:** Community-Mitglieder sehen den Chat überall: auf der Startseite, auf der Planer-Seite (im Web und in Microsoft Teams (optional)) sowie auf der Entdecken-Seite.
* **Mehrere Organisationen:** Ist ein:e Nutzer:in in mehreren Organisationen Mitglied, die anny nutzen, fragt der Chat beim Öffnen zunächst ab, mit welcher Organisation gechattet werden soll. *Die KI bearbeitet immer nur die Buchungen der aktuell ausgewählten Organisation.*

Die Funktionen der KI passen sich automatisch an den Login-Status der Nutzer:innen an:

* *Gastnutzer:innen:* Die KI beantwortet Wissensfragen, prüft Verfügbarkeiten öffentlicher Ressourcen und führt Buchungen für öffentliche Ressourcen durch.
* *Eingeloggte Nutzer:innen:* Die KI kann zusätzlich Community-Ressourcen buchen, die eigene Buchungshistorie einsehen, bestehende Buchungen bearbeiten oder stornieren, Personen in der Community suchen und Einladungen versenden.

## Weitere Buchungsfunktionen

* Gutscheine einlösen – Anrufer:innen können Gutscheincodes nennen, die anny AI direkt verrechnet.
* Abos und Buchungspakete – anny AI erkennt bestehende Pakete und kann deren Kontingente nutzen. Neue Abos und Pakete können über einen Link abgeschlossen werden.
* Mehrere Buchungen – In einem Gespräch können mehrere Termine in den Warenkorb gelegt werden.
* Stornierung – Erkannte Kund:innen können bestehende Buchungen stornieren.

<Note>
  Das Ändern einer bestehenden Buchung (z.B. Zeitverschiebung) ist aktuell noch nicht über anny AI möglich. Hierfür muss die Buchung storniert und neu angelegt werden.
</Note>

## Fehlertoleranz und Sicherheit

anny AI kann im Gespräch Fehler machen – zum Beispiel ein Datum falsch verstehen. In solchen Fällen korrigiert sich der Assistent selbstständig. Unabhängig davon gilt: Es kann niemals zu einer Buchung kommen, die über die reguläre Buchungsseite nicht hätte vorgenommen werden können. Alle Verfügbarkeiten, Preise und Regeln werden in Echtzeit gegen dein anny-System geprüft.

### Praxisbeispiel

<AccordionGroup>
  <Accordion title="Buchung eines Beratungstermins">
    **Anrufer:in: „Ich möchte gerne morgen einen Beratungstermin bei Frau Schmidt."**

    anny AI prüft die Verfügbarkeit von Frau Schmidt für morgen, nennt freie Zeiten und Preise, fragt die im Formular hinterlegten Angaben ab (z.B. Anliegen, Name) und schließt die Buchung ab. Der/die Anrufer:in erhält eine SMS-Bestätigung mit den Buchungsdetails.
  </Accordion>

  <Accordion title="Buchung mit Online-Zahlung">
    **Anrufer:in: „Ich würde gerne am Samstag den Yoga-Kurs buchen."**

    anny AI bestätigt Verfügbarkeit und Preis (z.B. 25 €). Da Online-Zahlung konfiguriert ist, sendet anny AI einen Checkout-Link per SMS. Der/die Anrufer:in öffnet den Link, bezahlt und erhält die Bestätigung.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann anny AI auch Buchungen für morgen oder übermorgen machen?">
    Ja, anny AI kann Buchungen für jeden verfügbaren Zeitpunkt erstellen – genauso wie auf der Buchungsseite.
  </Accordion>

  <Accordion title="Wird mein vollständiges Formular abgefragt?">
    Ja, alle Custom Fields werden im Gespräch abgefragt. Pflichtfelder müssen beantwortet werden, bevor die Buchung abgeschlossen wird.
  </Accordion>

  <Accordion title="Was passiert, wenn der gewünschte Termin nicht verfügbar ist?">
    anny AI schlägt alternative Zeiten vor, basierend auf der tatsächlichen Verfügbarkeit deiner Ressourcen.
  </Accordion>

  <Accordion title="Können Kund:innen auch ohne E-Mail buchen?">
    Ja, die E-Mail-Adresse ist bei anny AI-Buchungen optional. Die Bestätigung erfolgt per SMS an die Handynummer.
  </Accordion>

  <Accordion title="Können mehrere Buchungen in einem Anruf gemacht werden?">
    Ja, mehrere Buchungen können in den Warenkorb gelegt und gemeinsam abgeschlossen werden.
  </Accordion>
</AccordionGroup>


# Rufweiterleitung einrichten
Source: https://docs.anny.co/anny-ai-call-forwarding

Leite Anrufe von deiner bestehenden Telefonnummer an deinen anny AI-Assistenten weiter – so bleibt deine bekannte Nummer erhalten.

Damit dein anny AI-Assistent Anrufe entgegennehmen kann, ohne dass du deine öffentliche Telefonnummer änderst, richtest du eine Rufweiterleitung ein. Eingehende Anrufe auf deiner bestehenden Nummer werden dann automatisch an die anny AI-Nummer weitergeleitet.

## Voraussetzungen

* anny AI ist aktiviert und du hast deine anny AI-Telefonnummer erhalten (zu finden unter Organisationseinstellungen > anny AI).
* Du hast Zugang zu deinem Telefon oder der Verwaltungsoberfläche deines Telefonanbieters.
* Die anny AI-Nummer liegt im internationalen Format vor (z.B. +49221...).

## Welche Art der Weiterleitung passt zu dir?

Je nach Situation kannst du verschiedene Weiterleitungsarten nutzen:

| **Weiterleitungsart** | **Erklärung** | **Geeignet für** |
| :- | :- | :- |
| **Sofortige Weiterleitung** | Alle Anrufe werden direkt an anny AI weitergeleitet. | Urlaub, außerhalb der Geschäftszeiten oder wenn anny AI alle Anrufe übernehmen soll. |
| **Bei Nichtannahme** | Anrufe werden erst nach einer einstellbaren Anzahl von Sekunden (z.B. 15–30 Sek.) weitergeleitet, wenn du nicht rangehst. | Geeignet für: Du möchtest selbst annehmen, wenn du verfügbar bist – andernfalls übernimmt anny AI. |
| **Bei Besetzt** | Anrufe werden nur weitergeleitet, wenn du bereits in einem Gespräch bist. | Geeignet für: Kein Anruf geht verloren, auch wenn du gerade telefonierst. |
| **Bei Nichterreichbarkeit** | Anrufe werden weitergeleitet, wenn dein Gerät ausgeschaltet oder ohne Netz ist. | Geeignet für: Backup-Sicherung bei technischen Problemen. |

<Tip>
  Die beliebteste Variante ist „Bei Nichtannahme". So kannst du persönlich ans Telefon gehen, wenn du möchtest – und anny AI springt nur ein, wenn du nicht erreichbar bist.
</Tip>

## So richtest du die Weiterleitung ein

Die Einrichtung hängt von deinem Gerät oder Anbieter ab. Im Folgenden findest du die gängigsten Methoden.

### Per GSM-Code (funktioniert bei den meisten Mobilfunk- und Festnetzanbietern)

Öffne die Telefon-App und gib den passenden Code ein, um die Weiterleitung zu aktivieren:

| **Weiterleitungsmodus** | **GSM-Code** |
| :- | :- |
| **Sofortige Weiterleitung aktivieren** | \**21*\[anny AI-Nummer]# |
| **Bei Nichtannahme (nach 20 Sekunden)** | \**61*\[anny AI-Nummer]\_11\_20# |
| **Bei Besetzt** | \**67*\[anny AI-Nummer]# |
| **Bei Nichterreichbarkeit** | \**62*\[anny AI-Nummer]# |

<Note>
  Gib die anny AI-Nummer immer im internationalen Format ein (mit +49 statt 0).
</Note>

Öffne die Telefon-App und gib den passenden Code ein, um die Weiterleitung zu deaktivieren:

| **Weiterleitungsmodus** | **GSM-Code** |
| :- | :- |
| **Sofortige Weiterleitung aus** | #21# |
| **Bei Nichtannahme aus** | #61# |
| **Bei Besetzt aus** | #67# |
| **Bei Nichterreichbarkeit aus** | #62# |
| **Alle Weiterleitungen aus** | ##002# |

Öffne die Telefon-App und gib den passenden Code ein, um den Status zu prüfen:

| **Weiterleitungsmodus** | **GSM-Code** |
| :- | :- |
| **Status der sofortigen Weiterleitung** | \*#21# |
| **Status bei Nichtannahme** | \*#61# |
| **Status bei Besetzt** | \*#67# |
| **Status bei Nichterreichbarkeit** | \*#62# |

<Tip>
  Wenn du eine Rufumleitung zu anny nutzt, stelle sicher, dass die Weiterleitung direkt im Netz deines Telefonanbieters eingerichtet ist. Wird die Umleitung lokal über ein Endgerät (z. B. eine FRITZ!Box) konfiguriert, übermittelt das Zielgerät nur deine eigene Festnetznummer statt der Original-Telefonnummer des Anrufers. anny kann die anrufende Person dann nicht korrekt zuordnen.
</Tip>

### Per iPhone-Einstellungen

1. Öffne Einstellungen > Telefon > Rufweiterleitung.
2. Aktiviere Rufweiterleitung.
3. Gib die anny AI-Nummer im internationalen Format ein.
4. Bestätige die Eingabe.

<Note>
  Über die iPhone-Einstellungen ist nur die sofortige Weiterleitung konfigurierbar. Für bedingte Weiterleitungen (bei Besetzt, bei Nichtannahme) nutze die GSM-Codes oben.
</Note>

### Per Android-Einstellungen

1. Öffne die Telefon-App > Einstellungen (drei Punkte) > Anrufeinstellungen.
2. Tippe auf Rufweiterleitung.
3. Wähle die gewünschte Weiterleitungsart (immer/bei Besetzt/bei Nichtannahme/bei Nichterreichbarkeit).
4. Gib die anny AI-Nummer ein und bestätige.

<Note>
  Der genaue Pfad kann je nach Android-Version und Hersteller variieren.
</Note>

### Per Telefonanlage oder VoIP-Anbieter

Wenn du eine Telefonanlage (z.B. Fritz!Box, Sipgate, Placetel, Starface) nutzt, konfiguriere die Rufweiterleitung in der Verwaltungsoberfläche deines Anbieters:

1. Logge dich in das Admin-Interface deines Telefonanbieters ein.
2. Navigiere zu den Rufweiterleitungseinstellungen.
3. Trage die anny AI-Nummer als Weiterleitungsziel ein.
4. Wähle die gewünschte Bedingung (immer, bei Besetzt, bei Nichtannahme).
5. Speichere die Einstellung.

<Note>
  Bei VoIP-Anlagen kannst du die Weiterleitung oft zeitgesteuert einrichten – z.B. nur außerhalb der Geschäftszeiten. So übernimmt anny AI automatisch nach Feierabend.
</Note>

Nach erfolgreicher Einrichtung werden Anrufe auf deine bestehende Nummer gemäß der gewählten Bedingung an anny AI weitergeleitet. Deine Kund:innen bemerken keine Änderung. Sie rufen weiterhin deine bekannte Nummer an und werden automatisch mit deinem KI-Assistenten verbunden.

<Tip>
  Die Nummer, von der weitergeleitet wird z.B. die öffentliche Nummer der Rezeption kann nicht wieder als Ziel für eine Durchstellung verwendet werden.
</Tip>

## FAQ

<AccordionGroup>
  <Accordion title="Weiterleitung funktioniert nicht.">
    Das kann daran liegen, dass die Nummer im nationalen Format (0221...) statt im internationalen Format (+49221...) eingegeben wurde. Um dies zu beheben, gib die anny AI-Nummer immer mit Ländervorwahl ein.
  </Accordion>

  <Accordion title="Anrufe kommen nicht bei anny AI an.">
    Dies kann damit zusammenhängen, dass dein Mobilfunkanbieter die Weiterleitung an bestimmte Nummern blockiert oder der Dienst nicht in deinem Tarif enthalten ist. Um dies zu lösen, kontaktiere deinen Anbieter und frage nach, ob Rufweiterleitungen an Festnetznummern möglich sind.
  </Accordion>

  <Accordion title="Du möchtest nur Anrufe weiterleiten, die du nicht annimmst – aber alle werden sofort weitergeleitet.">
    Das liegt daran, dass die „sofortige Weiterleitung" aktiv ist statt „bei Nichtannahme". Deaktiviere die sofortige Weiterleitung (#21#) und richte stattdessen die Weiterleitung bei Nichtannahme ein (\**61*\[Nummer]\_11\_20#).
  </Accordion>
</AccordionGroup>


# An Mitarbeiter durchstellen
Source: https://docs.anny.co/anny-ai-call-transfer

2

Nicht jedes Anliegen lässt sich vollständig automatisiert lösen. Mit der Mitarbeiter-Weiterleitung kann anny AI Anrufe gezielt an die richtige Person in deinem Team durchstellen. Du bestimmst, welche Mitarbeitenden erreichbar sind und zu welchen Zeiten weitergeleitet werden darf.

## Voraussetzungen

* anny AI ist aktiviert und konfiguriert.
* Mindestens ein:e Mitarbeiter:in ist mit Telefonnummer und Zuständigkeit hinterlegt.
* Das Tool „Mitarbeiter-Weiterleitung" ist im Assistenten aktiviert.
* Telefonzeiten (Erreichbarkeitszeiten) sind konfiguriert.

## So richtest du die Mitarbeiter-Weiterleitung ein

<Steps>
  <Step title="Mitarbeitende hinterlegen">
    1. Navigiere zu Organisationseinstellungen > anny AI > Konfigurieren.
    2. Öffne im linken Menü den Bereich Mitarbeitende.
    3. Klicke auf Mitarbeiter hinzufügen.
    4. Hinterlege für jede:n Mitarbeiter:in folgende Informationen:
       1. Name
       2. Telefonnummer (unter der die Person erreichbar ist)
       3. Abteilung oder Zuständigkeitsbereich (z.B. „Buchhaltung", „Terminvereinbarung")
       4. Rolle und ggf. spezielle Regeln (z.B. „Nur für Rückfragen zu Rechnungen")
  </Step>

  <Step title="Das Weiterleitungs-Tool im Assistenten aktivieren">
    1. Navigiere zu Organisationseinstellungen > anny AI > Konfigurieren.
    2. Öffne im linken Menü Assistenten und wähle deinen Assistenten aus.
    3. Wechsle zum Reiter Tools.
    4. Füge das Tool Mitarbeiter-Weiterleitung hinzu.
    5. Aktiviere die Mitarbeitenden, die für die Weiterleitung verfügbar sein sollen.
    6. Speichere die Einstellung.
  </Step>

  <Step title="Telefonzeiten konfigurieren">
    Die Telefonzeiten bestimmen, zu welchen Zeiten anny AI Anrufe an Mitarbeitende weiterleiten darf.

    1. Navigiere zu Organisationseinstellungen > anny AI > Konfigurieren.
    2. Öffne im linken Menü den Bereich Unternehmen.
    3. Hinterlege dort die Telefonzeiten (Erreichbarkeitszeiten).
  </Step>
</Steps>

<img alt="Image" />

<Note>
  Die hinterlegten Informationen zu Abteilung und Zuständigkeit helfen anny AI, Anrufe an die richtige Person weiterzuleiten. Je genauer du die Zuständigkeiten beschreibst, desto besser kann der Assistent entscheiden.
</Note>

![](https://downloads.intercomcdn.eu/i/o/niegcmk9/151485285/02055be37ba1d679f0e2139164ad/ai-anmitarbeiter-anrufweiterleitung.jpg?expires=1784559600\&signature=f6bb9d9a979318582ebce4f6617f352273188598839af625410f18fedcfef913\&req=0dBuwVD%2Frj8tlxv889ospxkks8dG9VprqrtufLsccs7AlycFtp5VpzoNEWft%0AxTqk2Fc%2Bevl1QDxnuA%3D%3D%0A)

<Note>
  Wenn das Tool „Mitarbeiter-Weiterleitung" nicht im Assistenten hinzugefügt wurde, kann dieser keine Anrufe durchstellen – auch wenn Mitarbeitende hinterlegt sind. Des Weiteren kann nicht die gleiche Nummer genutzt werden, von der aus zu anny AI weitergeleitet wird.
</Note>

![](https://downloads.intercomcdn.eu/i/o/niegcmk9/151487930/fd3c72727bab39f63374e40fd09d/ai-anmitarbeiterdurchstellen-o%CC%88ffnungszeiten.jpg?expires=1784559600\&signature=e94055a58a392d284e4743527b3e70d7ebbd67e54b85e4a20311fa76d153912f\&req=0dBuwVD9pTQolxv889osp2FvkcL6U0Aqn8lZ47icpbbSSCq0HxSy5w%2BmdC3e%0AUIlxtV%2BhpTF2lO%2FUMw%3D%3D%0A)

<Note>
  Die hier hinterlegten Zeiten beziehen sich ausschließlich auf die Erreichbarkeit der Mitarbeitenden für Durchstellungen – sie haben nichts mit den Verfügbarkeiten deiner Ressourcen oder Buchungsoptionen zu tun.
</Note>

Außerhalb der eingestellten Telefonzeiten informiert anny AI die anrufende Person darüber, dass aktuell niemand persönlich erreichbar ist, und bietet alternative Hilfe an (z.B. Buchung, FAQ-Beantwortung).

Nach der Einrichtung kann anny AI Anrufe gezielt weiterleiten:

* Wenn ein:e Anrufer:in ein persönliches Gespräch wünscht, leitet anny AI an die passende Person weiter.
* Der Assistent wählt den/die Mitarbeiter:in basierend auf dem Anliegen und den hinterlegten Zuständigkeiten aus.
* Weiterleitung erfolgt nur innerhalb der konfigurierten Telefonzeiten.

## Troubleshooting

<AccordionGroup>
  <Accordion title="anny AI bietet keine Weiterleitung an.">
    Das Tool „Mitarbeiter-Weiterleitung" wurde nicht im Assistenten aktiviert. Um dies zu lösen, gehe zu Konfigurieren > Assistenten > Tools und füge das Tool hinzu.
  </Accordion>

  <Accordion title="Weiterleitung wird angeboten, aber es klingelt bei niemandem.">
    Die Telefonnummern der Mitarbeitenden sind nicht korrekt hinterlegt oder die Telefonzeiten sind abgelaufen. Prüfe die Nummern im Bereich „Mitarbeitende" und die Telefonzeiten im Bereich „Unternehmen".
  </Accordion>

  <Accordion title="anny AI leitet immer an denselben Mitarbeitenden weiter.">
    Nur ein:e Mitarbeiter:in ist aktiviert oder die Zuständigkeiten sind nicht differenziert hinterlegt. Hinterlege für jede:n Mitarbeiter:in eine klare Abteilung und Zuständigkeit.
  </Accordion>
</AccordionGroup>


# Assistenten anpassen
Source: https://docs.anny.co/anny-ai-customize-assistant

Passe Stimme, Begrüßung, Name, Verhalten und Fähigkeiten deines anny AI-Assistenten individuell an dein Unternehmen an.

Dein anny AI-Assistent lässt sich umfassend konfigurieren. Du bestimmst, wie er klingt, in welcher Sprache er standardmäßig spricht, wie er Anrufer:innen begrüßt, welchen Namen er trägt, wie er sich verhält und welche Aufgaben er übernehmen darf. Darüber hinaus kannst du Szenarien definieren, die Aufzeichnung steuern und den rechtlichen Hinweis konfigurieren. Alle Anpassungen findest du im Konfigurationsinterface.

## Voraussetzungen

* anny AI ist aktiviert (Organisationseinstellungen > anny AI).
* Du hast Zugang zum Konfigurationsinterface.

## Wo findest du die Einstellungen?

1. Navigiere zu Organisationseinstellungen > anny AI.
2. Klicke auf Konfigurieren.
3. Im linken Menü findest du den Bereich Assistenten – wähle dort deinen Assistenten aus.

### Stimme und Standardsprache ändern

1. Öffne die Einstellungen deines Assistenten.
2. Navigiere zum Abschnitt Stimme.
3. Wähle aus den verfügbaren Stimmen (männlich und weiblich). Jede Stimme ist multilingual – sie funktioniert automatisch in allen unterstützten Sprachen.
4. Lege die Standardsprache fest, in der dein Assistent Gespräche beginnt.
5. Speichere die Änderung.

<Tip>
  Du musst nicht pro Sprache eine eigene Stimme wählen. Die gewählte Stimme passt sich automatisch an die Sprache des Gesprächs an. Wenn ein:e Anrufer:in in einer anderen Sprache spricht, wechselt der Assistent automatisch.
</Tip>

### Name ändern

1. Öffne die Einstellungen deines Assistenten.
2. Bearbeite das Feld Name.
3. Gib den gewünschten Namen ein, mit dem sich dein Assistent vorstellt.
4. Speichere die Änderung.

<Tip>
  Wähle einen Namen, der zu deinem Unternehmen passt. Der Assistent stellt sich im Gespräch mit diesem Namen vor.
</Tip>

### Startmeldung (Begrüßungsansage) konfigurieren

Die Startmeldung ist der erste Satz, den Anrufer:innen hören. Hier identifiziert sich der Assistent und gibt den Ton für das Gespräch vor.

1. Öffne die Einstellungen deines Assistenten.
2. Navigiere zum Feld Startmeldung.
3. Bearbeite den Text nach deinen Wünschen.
4. Speichere die Änderung.

<Warning>
  Nach EU-Verordnung muss sich eine KI bei der Interaktion mit Menschen eindeutig als KI identifizieren. Stelle sicher, dass deine Startmeldung einen klaren Hinweis enthält, dass es sich um einen KI-Assistenten handelt. Wenn die Gesprächsaufzeichnung aktiviert ist, muss zusätzlich darauf hingewiesen werden, dass das Gespräch aufgezeichnet wird.
</Warning>

<Tip>
  Baue den rechtlichen Hinweis (KI-Identifikation und ggf. Aufzeichnungshinweis) direkt in deine eigene Startmeldung ein. Das klingt natürlicher als die automatische Standardansage (siehe Abschnitt „Rechtlicher Hinweis" weiter unten).
</Tip>

### Abweichende Startmeldung außerhalb der Öffnungszeiten

Du kannst eine separate Startmeldung hinterlegen, die nur außerhalb der konfigurierten Telefonzeiten abgespielt wird. So kannst du Anrufer:innen darauf hinweisen, dass gerade niemand persönlich erreichbar ist, der Assistent aber gerne weiterhilft.

1. Öffne die Einstellungen deines Assistenten.
2. Navigiere zum Feld Startmeldung außerhalb der Öffnungszeiten.
3. Gib den gewünschten Text ein (z.B. „Hallo, du erreichst uns außerhalb unserer Geschäftszeiten. Ich bin dein KI-Assistent und helfe dir gerne weiter.").
4. Speichere die Änderung.

### Begrüßung bei Weiterleitung

Wenn Anrufe per Rufweiterleitung von einer anderen Nummer eingehen, kannst du eine spezielle Begrüßung hinterlegen, die in diesem Fall verwendet wird.

1. Öffne die Einstellungen deines Assistenten.
2. Navigiere zum Feld Begrüßung bei Weiterleitung.
3. Gib den gewünschten Text ein.
4. Speichere die Änderung.

<Note>
  Diese Begrüßung wird nur verwendet, wenn der Anruf über eine Rufweiterleitung eingeht – nicht bei direkten Anrufen auf die anny AI-Nummer.
</Note>

### Rechtlicher Hinweis (Toggle)

Im Konfigurationsinterface findest du den Toggle Rechtlicher Hinweis aktivieren. Wenn dieser aktiviert ist, wird vor deiner eigenen Startmeldung eine Standardansage abgespielt, die auf die KI und ggf. die Aufzeichnung hinweist.

<Note>
  Wir empfehlen, den Toggle zu deaktivieren und stattdessen den rechtlichen Hinweis direkt in deine eigene Startmeldung einzubauen. Das sorgt für einen natürlicheren Gesprächseinstieg, da keine separate Ansage vor deiner Begrüßung erfolgt.

  Der Toggle ist optional, sofern deine eigene Startmeldung:

  * klar kommuniziert, dass es sich um einen KI-Assistenten handelt
  * auf die Gesprächsaufzeichnung hinweist (falls diese aktiviert ist)
</Note>

### Rolle, Stil und eigene Regeln

Im Bereich Rolle kannst du dem Assistenten Verhaltensanweisungen geben, die seinen Gesprächsstil und sein Verhalten beeinflussen:

* Wie formal oder informell er spricht
* Ob er bestimmte Informationen bevorzugt erwähnen soll
* Wie er bei Unklarheiten reagieren soll
* Welche Themen er vermeiden soll

Zusätzlich kannst du eigene Regeln hinzufügen, die das Verhalten des Assistenten weiter verfeinern. Diese Regeln wirken wie zusätzliche Leitplanken für das Gespräch.

<Tip>
  Formuliere die Anweisungen klar und konkret. Statt „Sei freundlich" besser: „Begrüße Anrufer:innen mit ihrem Namen, falls bekannt, und biete aktiv Hilfe an."
</Tip>

### Szenarien definieren

Im Reiter Szenarien kannst du zusätzliche Gesprächsszenarien hinterlegen, die zu deinem Business passen. Szenarien sind Verhaltensregeln, die je nach Verlauf des Telefonats greifen. Sie helfen der KI, den Anruf am Ende in ein passendes Anrufszenario zu kategorisieren.

Beispiele für Szenarien:

* Mitgliedsanfrage
* Beschwerdemanagement
* Terminverschiebung
* Allgemeine Information

So legst du ein Szenario an:

1. Öffne die Einstellungen deines Assistenten.
2. Wechsle zum Reiter Szenarien.
3. Klicke auf Szenario hinzufügen.
4. Gib einen Namen und die Verhaltensregeln für dieses Szenario ein.
5. Speichere das Szenario

<Note>
  Szenarien beeinflussen, wie der Assistent in bestimmten Gesprächssituationen reagiert, und ermöglichen dir eine differenziertere Auswertung deiner Anrufe (z.B. „Wie viele Anrufe waren Mitgliedsanfragen?").
</Note>

### Fähigkeiten (Tools) verwalten

Im Reiter Tools kannst du festlegen, welche Fähigkeiten dein Assistent hat:

* Buchungen durchführen – Der Assistent kann Verfügbarkeiten prüfen und Buchungen erstellen.
* **Wissensdatenbank** – Der Assistent greift auf hinterlegte FAQ-Einträge zu.
* **Web-Suche** – Der Assistent kann deine Website nach Informationen durchsuchen.
* **Mitarbeiter-Weiterleitung** – Der Assistent kann Anrufe an echte Mitarbeitende durchstellen.
* Gespräch beenden – Der Assistent kann das Telefonat selbstständig beenden, wenn das Anliegen gelöst ist.
* Aufzeichnung auf Anfrage deaktivieren – Anrufer:innen können während des Gesprächs bitten, die Aufzeichnung zu stoppen.
* **SMS** - Der Assistent kann eine SMS zur Aufforderung eines Rückrufs an das Team versenden.

Jedes Tool kann einzeln aktiviert oder deaktiviert werden. Nur aktivierte Tools stehen dem Assistenten im Gespräch zur Verfügung.

<Accordion title="Beispiel: SMS mit Bitte um Rückruf ans Team">
  Um eine SMS zu erhalten, wenn Kunden um einen Rückruf bitten, gehe wie folgt vor:

  1. Öffne den **Assistenten** und klicke auf **+ Neues Tool** erstellen
  2. Wähle **SMS** aus
  3. Benenne das Tool als '**Rückrufanfrage senden**'
  4. Unter **Empfänger** wird eingestellt:
     1. SMS senden an: Feste Nummer
     2. Zielrufnummern: trage hier alle notwendigen Handynummern ein
  5. Bei **Nachricht** die Nachrichtenvorlage konfigurieren wie:<br />Rückrufanfrage: *Name* <br />Anliegen: *Anliegen*
  6. Bei der **KI-Variable** werden die während des Anrufs auszufüllenden Variablen eingetragen:<br />​\_Anliegen\_: Worum geht es bei der Anfrage des Kunden?<br />​\_Name\_: Wie heißt der Anrufer?
</Accordion>

<Accordion title="Beispiel: Host beim Besucher-Check-in per Anruf und SMS informieren">
  Wenn ein:e Besucher:in eincheckt, kann anny AI den zuständigen Host automatisch anrufen und über die Ankunft informieren. Liegt eine Mobilnummer des Gasts vor, kann der Host anschließend über den AI-Flow eine SMS an den Gast ausrichten lassen, zum Beispiel „Ich hole dich in 2 Minuten am Empfang ab.".

  <Steps>
    <Step title="SMS-Benachrichtigung an den Host aktivieren">
      Aktiviere in den **Organisationseinstellungen** unter **Benachrichtigungen** die **SMS-Benachrichtigung** für Hosts beim Check-in. Voraussetzung ist eine gültige Mobilnummer beim Host.
    </Step>

    <Step title="Anruf über anny AI konfigurieren">
      Aktiviere in den anny AI-Einstellungen den automatischen **Anruf an den Host** beim Check-in einer Besucherbuchung. Im Anruf teilt der Assistent mit, dass der:die Besucher:in eingecheckt hat.
    </Step>

    <Step title="SMS an den Gast über den AI-Flow ermöglichen">
      Lege im Reiter **Tools** ein **SMS**-Tool an, über das der Host im Anschluss an den Anruf eine Nachricht an den Gast ausrichten lassen kann. Diese Option steht nur zur Verfügung, wenn eine Mobilnummer des Gasts vorliegt.
    </Step>

    <Step title="Testen">
      Erstelle eine Testbuchung mit Host und checke am Terminal ein. Prüfe, ob der Host per SMS und Anruf informiert wird und ob sich anschließend eine SMS an den Gast auslösen lässt.
    </Step>
  </Steps>

  <Note>
    Die vollständige Einrichtung des Besuchermanagements mit Ressource, Buchungsoption, Host-Community und Terminal findest du im Guide [Besucherverwaltung](/visitor-management).
  </Note>
</Accordion>

### Aufzeichnung deaktivieren

Die Gesprächsaufzeichnung ist standardmäßig aktiviert. Du kannst sie vollständig deaktivieren:

1. Öffne die Einstellungen deines Assistenten.
2. Deaktiviere die Option Aufzeichnung.
3. Speichere die Änderung.

Wenn die Aufzeichnung deaktiviert ist:

* Es wird kein Audio-Mitschnitt erstellt.
* Der Hinweis auf die Aufzeichnung kann aus der Startmeldung entfernt werden.
* Transkript und Zusammenfassung des Gesprächs werden weiterhin erstellt.

<Note>
  Unabhängig von dieser Einstellung können Anrufer:innen auch während eines Gesprächs bitten, die Aufzeichnung zu stoppen – sofern das Tool „Aufzeichnung auf Anfrage deaktivieren" aktiviert ist.
</Note>

### KI-Modell

Das verwendete KI-Modell kann nicht eigenständig geändert werden. Auf Anfrage kann anny auf rein europäische Modelle umstellen.

<Warning>
  Eine Umstellung auf europäische Modelle wird aufgrund von Einbußen bei Qualität und Performance nicht empfohlen. Kontaktiere den anny Support, wenn du diese Option dennoch benötigst.
</Warning>

## FAQ

<AccordionGroup>
  <Accordion title="Muss ich sagen, dass es sich um eine KI handelt? ">
    Ja, das ist gesetzlich vorgeschrieben. Du kannst den Hinweis entweder direkt in deine Startmeldung einbauen (empfohlen) oder den Toggle „Rechtlicher Hinweis" aktivieren, der eine automatische Standardansage vorschaltet. 
  </Accordion>

  <Accordion title="Kann ich den rechtlichen Hinweis weglassen? ">
    Nein. Die KI muss sich immer als KI identifizieren. Du entscheidest nur, ob du den Hinweis selbst in die Startmeldung einbaust oder die automatische Ansage nutzt.
  </Accordion>

  <Accordion title="Welche Sprachen spricht der Assistent?">
    anny AI unterstützt über 20 Sprachen und wechselt automatisch in die Sprache des/der Anrufer:in. Die gewählte Stimme funktioniert in allen Sprachen.
  </Accordion>

  <Accordion title="Kann ich testen, wie mein Assistent klingt? ">
    Du kannst deinen Assistenten jederzeit testen, indem du die anny AI-Nummer anrufst.
  </Accordion>

  <Accordion title="Kann ich das KI-Modell wechseln? ">
    Nicht eigenständig. Auf Anfrage kann auf europäische Modelle umgestellt werden – dies wird aber aufgrund geringerer Qualität nicht empfohlen.
  </Accordion>

  <Accordion title="Wofür sind Szenarien gut?">
    Szenarien helfen der KI, sich in bestimmten Gesprächssituationen gezielt zu verhalten, und ermöglichen dir eine bessere Kategorisierung und Auswertung deiner Anrufe.
  </Accordion>
</AccordionGroup>


# FAQ, Tipps, Datenschutz und Abrechnung
Source: https://docs.anny.co/anny-ai-faq

Antworten auf die wichtigsten Fragen rund um anny AI: Datenschutz, Kosten, Sprachen, Tipps für den Betrieb und technische Details.

# Allgemeines

<AccordionGroup>
  <Accordion title="Wie funktioniert anny AI?">
    anny AI ist ein KI-gestützter Telefonassistent, der Anrufe entgegennimmt und vollständig automatisiert bearbeitet. Er kann Buchungen durchführen, häufige Fragen beantworten, Informationen zu deinem Angebot geben und bei Bedarf an echte Mitarbeitende weiterleiten. Der Assistent kennt deine Ressourcen, Buchungsoptionen und Preise und arbeitet mit denselben Regeln wie deine Online-Buchungsseite.
  </Accordion>

  <Accordion title="Welche Sprachen spricht anny AI?">
    anny AI unterstützt über 20 Sprachen und erkennt automatisch die Sprache der anrufenden Person. Ein Sprachwechsel im Gespräch ist ebenfalls möglich. Aktuell unterstützte Sprachen:

    • Deutsch (de-DE)

    • Englisch – US (en-US)

    • Englisch – Indien (en-IN)

    • Französisch (fr-FR)

    • Spanisch – US (es-US)

    • Italienisch (it-IT)

    • Portugiesisch – Brasilien (pt-BR)

    • Niederländisch (nl-NL)

    • Polnisch (pl-PL)

    • Rumänisch (ro-RO)

    • Ukrainisch (uk-UA)

    • Russisch (ru-RU)

    • Türkisch (tr-TR)

    • Arabisch (ar-EG)

    • Hindi (hi-IN)

    • Bengali (bn-BD)

    • Marathi (mr-IN)

    • Tamil (ta-IN)

    • Telugu (te-IN)

    • Indonesisch (id-ID)

    • Japanisch (ja-JP)

    • Koreanisch (ko-KR)

    • Thailändisch (th-TH)

    • Vietnamesisch (vi-VN)
  </Accordion>

  <Accordion title="Kann anny AI Fehler machen?">
    Ja, anny AI kann im Gespräch Fehler machen – zum Beispiel ein Datum oder einen Namen falsch verstehen. Der Assistent erkennt Missverständnisse in der Regel selbst und korrigiert sich. Unabhängig davon kann es niemals zu einer Buchung kommen, die gegen deine konfigurierten Regeln verstößt. Alle Verfügbarkeiten und Preise werden in Echtzeit geprüft.
  </Accordion>

  <Accordion title="Kann anny AI mehrere Anrufe gleichzeitig bearbeiten?">
    Das hängt von deinem anny AI-Paket ab. Im kleinsten Paket kann nur ein Anruf gleichzeitig bearbeitet werden – wie bei einem normalen Telefon. In größeren Paketen sind bis zu drei parallele Gespräche möglich. Benötigst du mehr, kontaktiere den anny Support.
  </Accordion>

  <Accordion title="Wie schnell antwortet anny AI im Gespräch?">
    anny AI antwortet mit einer natürlichen Gesprächspause, um Anrufer:innen nicht voreilig zu unterbrechen. Es gibt keine spürbare oder unangenehme Verzögerung. Wenn der Assistent etwas im System prüft (z.B. Verfügbarkeiten), sind Tippgeräusche zu hören – ähnlich wie bei einem menschlichen Mitarbeitenden, der etwas nachschlägt.
  </Accordion>

  <Accordion title="Gibt es eine maximale Gesprächsdauer?">
    Es gibt keine feste Obergrenze für die Gesprächsdauer. Sehr lange Gespräche (z.B. über 30 Minuten) werden berechnet wie jedes andere Gespräch – sekundengenau. Der Assistent beendet das Gespräch nicht automatisch nach einer bestimmten Zeit, sondern nur, wenn das Anliegen gelöst ist oder das Gespräch offensichtlich sinnlos wird (sofern das Tool „Gespräch beenden" aktiviert ist).
  </Accordion>

  <Accordion title="Was passiert bei einem technischen Ausfall von anny AI?">
    Sollte anny AI nicht erreichbar sein, klingelt ein weitergeleiteter Anruf ins Leere oder springt auf deine reguläre Mailbox zurück – je nach Konfiguration deines Telefonanbieters. Ein Ausfall betrifft nicht deine bestehende Telefonnummer oder dein anny-Buchungssystem.

    <Tip>
      Wenn du eine bedingte Weiterleitung „bei Nichtannahme" nutzt, gehen Anrufe in einem solchen Fall zurück an dein Telefon.
    </Tip>
  </Accordion>

  <Accordion title="Kann ich anny AI temporär deaktivieren?">
    Du kannst die Rufweiterleitung jederzeit auf deinem Telefon deaktivieren (z.B. per GSM-Code ##002#). anny AI bleibt technisch aktiv, erhält aber keine Anrufe mehr. So kannst du zwischen persönlicher Erreichbarkeit und KI-Betrieb wechseln.
  </Accordion>

  <Accordion title="Was passiert, wenn ein:e Anrufer:in während einer Buchung auflegt?">
    Wird das Gespräch vorzeitig beendet, bevor die Buchung abgeschlossen ist, wird keine Buchung erstellt. Es entstehen keine unvollständigen oder „hängenden" Buchungen im System.
  </Accordion>

  <Accordion title="Was passiert, wenn ein Mitarbeitender bei der Durchstellung nicht rangeht?">
    Wenn der/die Mitarbeiter:in nicht erreichbar ist, kehrt anny AI zum Gespräch zurück und informiert den/die Anrufer:in. Je nach Konfiguration kann der Assistent dann alternative Hilfe anbieten (z.B. eine Buchung vornehmen, eine Nachricht aufnehmen oder eine andere Person versuchen).
  </Accordion>

  <Accordion title="Kann anny AI auch ausgehende Anrufe tätigen?">
    Nein. anny AI nimmt ausschließlich eingehende Anrufe entgegen. Aktive ausgehende Anrufe (z.B. Erinnerungsanrufe oder Rückrufe) sind aktuell nicht möglich.
  </Accordion>

  <Accordion title="Funktioniert anny AI auch mit unterdrückter Nummer?">
    Ja, anny AI nimmt auch Anrufe von unterdrückten Nummern entgegen. Allerdings kann in diesem Fall keine automatische Personenerkennung stattfinden – der/die Anrufer:in wird nicht mit Namen begrüßt und hat keinen Zugriff auf bestehende Kontingente oder Buchungen.
  </Accordion>

  <Accordion title="Kann ich bestimmte Services von der Telefonbuchung ausschließen?">
    Die Buchbarkeit über anny AI richtet sich 1:1 nach deiner öffentlichen Buchungsseite – es gibt keine separate Einstellung für die Telefonbuchung. Was auf der Buchungsseite buchbar ist, kann auch telefonisch gebucht werden. Wenn Ressourcen nur für Community-Mitglieder sichtbar sind, gelten dieselben Einschränkungen: Sie sind für anny AI nur sichtbar, wenn die anrufende Person über ihre Handynummer als Community-Mitglied erkannt wird.
  </Accordion>

  <Accordion title="Kann anny AI Gruppenbuchungen durchführen?">
    Ja, anny AI kann mehrere Buchungen in einem Gespräch in den Warenkorb legen – z.B. mehrere Teilnehmer:innen für ein Event oder Buchungsserien für Kurse mit festgelegten Terminen. Wiederkehrende Buchungen (z.B. „jeden Montag") sind aktuell nicht über anny AI möglich.
  </Accordion>

  <Accordion title="Kann ich dem Assistenten eine Nachricht für mein Team hinterlassen?">
    Es gibt keine separate Voicemail-Funktion. Allerdings werden alle Informationen, die Anrufer:innen dem Assistenten mitteilen, in der Gesprächszusammenfassung festgehalten. Du erhältst diese per E-Mail nach jedem Gespräch. Ein Anruf kann daher auch als „Nachricht hinterlassen" genutzt werden.
  </Accordion>

  <Accordion title="Sind SMS-Bestätigungen und Checkout-Links im Preis enthalten?">
    Ja. Alle SMS, die anny AI im Rahmen von Buchungsbestätigungen oder Checkout-Links versendet, sind im Preis deines anny AI-Pakets enthalten und werden nicht separat berechnet.
  </Accordion>

  <Accordion title="Kann ich die Telefonie deaktivieren und nur den Chat benutzen?">
    Man kann die Telefonnummer nicht entfernen, aber man muss sie auch nicht benutzen. Man kann ausschließlich den Chat verwenden, indem man die Einbindung auf der Buchungsseite aktiviert.
  </Accordion>

  <Accordion title="Wie kann ich den Chat intern testen, ohne das Kund:innen ihn sehen?">
    Öffne in den Account-Einstellungen im Admin-Bereich den Reiter anny AI. Deaktiviere in der Chat-Widget Einrichtung die Option **KI-Chat auf der Buchungsseite anzeigen**.

    Teste den Chat nun unten rechts in deinem anny Admin-Bereich. *Wichtig:* Im Admin-Bereich siehst du standardmäßig die Gastversion des Chats, da du für die Chat-KI in dieser Ansicht nicht als Community-Mitglied eingeloggt bist.
  </Accordion>

  <Accordion title="Wie sorge ich dafür, dass verschiedene Optionen angeboten werden, statt direkt eine bestimmte Dienstleistung vorzuschlagen?">
    Wandle deine Buchungsoptionen in einen **Service** um, damit dieser als zentraler Einstiegspunkt dient und die KI eine Auswahl anbietet. Alternativ kannst du unter **anny AI** > **Konfigurieren** > **Szenarien** > **Buchung durchführen** in den **Regeln** festlegen, dass die KI vorab gezielt nach bestimmten Kriterien (wie z. B. der gewünschten Aufenthaltsdauer) fragen soll.
  </Accordion>
</AccordionGroup>

# **Datenschutz**

<AccordionGroup>
  <Accordion title="Muss ich die KI Nutzung in meiner Datenschutzerklärung aufnehmen?">
    Ja, Kunden, die anny AI nutzen, sind nach Art. 13/14 DSGVO verpflichtet, ihre Datenschutzerklärung um Informationen zur Telefonassistenten-Nutzung zu ergänzen: [hier ist die Vorlage.](/anny-ai-privacy-template)
  </Accordion>

  <Accordion title="Muss sich die KI als KI identifizieren?">
    Ja. Nach EU-Verordnung muss sich eine KI bei der Interaktion mit Menschen eindeutig als KI zu erkennen geben. In der Standardkonfiguration von anny AI ist dies bereits in der Startmeldung enthalten. Wenn du die Startmeldung anpasst, stelle sicher, dass dieser Hinweis erhalten bleibt.

    <Warning>
      Du als Nutzer:in von anny AI bist selbst für die Einhaltung der geltenden Vorschriften verantwortlich. Die Standardkonfiguration erfüllt diese Anforderungen – weiche nur ab, wenn du die rechtlichen Auswirkungen kennst.
    </Warning>
  </Accordion>

  <Accordion title="Werden Gespräche aufgezeichnet?">
    Standardmäßig ist die vollständige Gesprächsaufzeichnung (Audio) aktiviert. Dies wird in der Startmeldung angekündigt und ist gesetzlich erforderlich, solange die Aufzeichnung aktiv ist.

    Aufzeichnungen werden 7 Tage aufbewahrt und danach automatisch gelöscht.
  </Accordion>

  <Accordion title="Kann ich die Aufzeichnung deaktivieren?">
    Ja, die Aufzeichnung kann deaktiviert werden. In diesem Fall:

    * Kein Audio-Mitschnitt wird erstellt.
    * Der Hinweis auf die Aufzeichnung kann aus der Startmeldung entfernt werden.
    * Transkript und Zusammenfassung des Gesprächs werden weiterhin erstellt (diese basieren auf der Echtzeit-Verarbeitung, nicht auf einer Aufnahme).
    * Anrufer:innen können auch während eines Gesprächs bitten, die Aufzeichnung zu stoppen – sofern das entsprechende Tool aktiviert ist.

    <Note>
      Auch ohne Aufzeichnung erhältst du nach jedem Gespräch eine Zusammenfassung per E-Mail.
    </Note>
  </Accordion>

  <Accordion title="Müssen Anrufer:innen der Aufzeichnung aktiv zustimmen?">
    Nein, eine aktive Zustimmung ist nicht erforderlich. Es reicht, dass in der Startmeldung klar auf die Aufzeichnung hingewiesen wird. Wenn Anrufer:innen nach dem Hinweis im Gespräch bleiben, gilt das als konkludente Einwilligung. Wer nicht aufgezeichnet werden möchte, kann auflegen oder – sofern das Tool aktiviert ist – im Gespräch bitten, die Aufzeichnung zu stoppen.
  </Accordion>

  <Accordion title="Werden meine Gesprächsdaten für das Training der KI verwendet?">
    Nein. Deine Gesprächsdaten (Audio, Transkripte, Zusammenfassungen) werden nicht zum Training der KI-Modelle verwendet. Die Daten dienen ausschließlich der Gesprächsdokumentation für dein Unternehmen.
  </Accordion>

  <Accordion title="Was passiert, wenn sensible Daten im Gespräch genannt werden?">
    anny AI verarbeitet alle gesprochenen Inhalte in Echtzeit, um das Gespräch zu führen. Wenn Anrufer:innen sensible Informationen nennen (z.B. Gesundheitsdaten, Zahlungsdaten), erscheinen diese im Transkript. Es ist daher empfehlenswert, in den Verhaltensregeln deines Assistenten festzulegen, dass er keine sensiblen Daten wie Kreditkartennummern oder Gesundheitsinformationen aktiv abfragt.

    <Tip>
      Für Zahlungsvorgänge versendet anny AI einen sicheren Checkout-Link per SMS – Zahlungsdaten werden nie am Telefon erhoben.
    </Tip>
  </Accordion>

  <Accordion title="Wer hat Zugriff auf die Gesprächsaufzeichnungen und Transkripte?">
    Nur Personen mit Admin-Zugang in deiner anny-Organisation können auf die Aufzeichnungen und Transkripte zugreifen. anny-Mitarbeitende haben keinen Zugriff auf deine Gesprächsdaten, es sei denn, du erteilst im Supportfall eine explizite Berechtigung.
  </Accordion>

  <Accordion title="Kann ich Aufzeichnungen vorzeitig löschen?">
    Aufzeichnungen werden automatisch nach 7 Tagen gelöscht. Eine vorzeitige manuelle Löschung einzelner Aufzeichnungen ist über das Gesprächsprotokoll möglich.
  </Accordion>

  <Accordion title="Was passiert mit meinen Daten, wenn ich anny AI kündige?">
    Nach Beendigung deines anny AI-Pakets wird dein Account archiviert. Nach 7 Tagen werden alle Gesprächsaufzeichnungen, Transkripte und Zusammenfassungen gelöscht. Transkripte und Zusammenfassungen, die zu einer Buchung gehören sind nach wie vor im Nachrichten-Feed einer Buchung zu finden. Deine anny AI-Telefonnummer wird deaktiviert und kann nicht weiterverwendet werden.
  </Accordion>

  <Accordion title="Ist anny AI DSGVO-konform?">
    Ja. anny AI ist für den Betrieb innerhalb der EU konzipiert. Die Datenverarbeitung erfolgt DSGVO-konform. Details regelt die Zusatzvereinbarung, die du bei der Aktivierung bestätigst.
  </Accordion>

  <Accordion title="Wie werden Kund:innen erkannt?">
    Anrufer:innen werden über ihre Handynummer identifiziert, sofern diese als Kund:in in anny hinterlegt ist. Die Personenerkennung ist automatisch – du musst nichts zusätzlich konfigurieren, außer die Handynummern in den Kundenprofilen zu pflegen.
  </Accordion>

  <Accordion title="Wie werte ich die Buchungen, die über AI getätigt werden, aus?">
    Die anny AI hat eigene Analytics, diese können [<u>hier</u>](https://agents.anny.co/analytics) eingesehen werden.

    In der Buchungsübersicht lässt sich über die Filteroption Unter UTM-Source "anny AI" und dann als Medium "Chat" oder "Telefon" auswählen so können auch Exporte angefertigt werden.

    <Tip>
      Im Dashboard lassen sich die täglichen Buchungen auch nach UTM-Source anzeigen.
    </Tip>
  </Accordion>
</AccordionGroup>

# **Abrechnung**

<AccordionGroup>
  <Accordion title="Wie viel kostet ein Gespräch?">
    Die Abrechnung erfolgt sekundengenau basierend auf der tatsächlichen Gesprächsdauer. Der genaue Preis pro Minute hängt von deinem gewählten anny AI Paket ab.

    **Wichtige Regeln:**

    * Nur tatsächlich zustande gekommene Verbindungen werden berechnet.
    * Abgebrochene Anrufe (kein Gespräch zustande gekommen) zählen nicht und werden nicht berechnet.
    * Nicht genutztes Minutenkontingent verfällt am Ende des Monats und wird nicht erstattet.
    * Über das Kontingent hinaus verbrauchte Minuten werden zusätzlich in Rechnung gestellt.
  </Accordion>

  <Accordion title="Wie wird abgerechnet? ">
    * Die anny AI-Nutzung wird separat zu deinem bestehenden anny Abo in Rechnung gestellt.
    * Bei Aktivierung eines anny AI Pakets wird der Preis anteilig zum aktuellen Nutzungszeitraum berechnet.
    * Deinen aktuellen Minutenverbrauch kannst du jederzeit im Bereich anny AI einsehen.
  </Accordion>

  <Accordion title="Welcher Plan ist Voraussetzung?">
    anny AI ist ab dem Essential Plan verfügbar. In niedrigeren Plänen ist die Funktion nicht zugänglich.
  </Accordion>

  <Accordion title="Was passiert, wenn mein Minutenkontingent aufgebraucht ist?">
    Dein Assistent bleibt erreichbar. Über das Kontingent hinaus geführte Gespräche werden als Mehrverbrauch zum geltenden Minutenpreis zusätzlich abgerechnet. Es gibt keine automatische Sperre.
  </Accordion>

  <Accordion title="Zählen Spam-Anrufe oder Fehlverbindungen?">
    Nur tatsächlich verbundene Gespräche werden berechnet. Wenn eine Person anruft und sofort auflegt (bevor das Gespräch zustande kommt), entstehen keine Kosten. Kommt es jedoch zu einer Verbindung – auch bei Spam-Anrufen – zählt die Gesprächszeit.

    <Tip>
      anny AI beendet erkennbar sinnlose Gespräche selbstständig, sofern das Tool „Gespräch beenden" aktiviert ist. So bleiben die Kosten bei Spam minimal.
    </Tip>
  </Accordion>

  <Accordion title="Kann ich anny AI kündigen oder pausieren?">
    Du kannst dein anny AI-Paket zum Ende der Laufzeit kündigen. Eine temporäre Pause ist nicht als eigene Funktion vorgesehen – du kannst aber die Rufweiterleitung deaktivieren, sodass keine Anrufe mehr bei anny AI eingehen. Die Nummer bleibt in diesem Fall bestehen.
  </Accordion>
</AccordionGroup>

# **Tipps für den Betrieb**

<AccordionGroup>
  <Accordion title="anny sauber einrichten">
    Damit anny AI optimal funktioniert, sollte dein anny-System vollständig eingerichtet sein:

    * Ressourcen mit korrekten Verfügbarkeiten und Buchungsoptionen
    * Aktuelle Preise und Formulare
    * Aktuelle Website-Informationen (anny AI liest diese bei der Einrichtung aus)
    * Kundendaten mit Handynummern (für Personenerkennung)
  </Accordion>

  <Accordion title="Nur Anrufe weiterleiten, wenn niemand rangeht">
    Du möchtest weiterhin persönliche Gespräche führen und anny AI nur als Backup nutzen? Richte eine bedingte Rufweiterleitung ein:

    Nutze den GSM-Code \**\*61\**\[anny AI-Nummer]\_\*11\*\_20# – damit werden Anrufe erst nach 20 Sekunden Klingeln an anny AI weitergeleitet. So hast du Zeit, selbst ranzugehen.
  </Accordion>

  <Accordion title="Wissensdatenbank regelmäßig pflegen">
    Überprüfe regelmäßig die Gesprächsprotokolle und identifiziere Fragen, die dein Assistent nicht zufriedenstellend beantworten konnte. Ergänze entsprechende Einträge in der Wissensdatenbank.
  </Accordion>

  <Accordion title="Telefonzeiten aktuell halten">
    Stelle sicher, dass die Telefonzeiten im Bereich „Unternehmen" der anny AI-Konfiguration aktuell sind. Nur innerhalb dieser Zeiten werden Anrufe an Mitarbeitende durchgestellt.
  </Accordion>

  <Accordion title="E-Mail-Benachrichtigungen anpassen">
    Wenn du nicht nach jedem Gespräch eine E-Mail erhalten möchtest, kannst du die Benachrichtigung in deinen Profileinstellungen im Adminbereich unter Benachrichtigungen deaktivieren.
  </Accordion>
</AccordionGroup>


# Wissensmanagement
Source: https://docs.anny.co/anny-ai-knowledge-management

Pflege die Wissensdatenbank deines anny AI-Assistenten, damit er Fragen kompetent beantwortet und auf aktuelle Informationen zurückgreift.

Dein anny AI-Assistent greift auf eine Wissensdatenbank zu, um Fragen von Kund:innen zu beantworten. Diese Wissensdatenbank wird bei der Ersteinrichtung automatisch mit Informationen aus deiner Website befüllt. Du kannst sie jederzeit mit eigenen FAQ-Einträgen ergänzen, aktualisieren oder erweitern.

## Für wen ist diese Funktion geeignet?

Das Wissensmanagement ist relevant für alle Admins, die:

* häufig gestellte Fragen automatisch beantworten lassen möchten
* sicherstellen wollen, dass anny AI korrekte und aktuelle Informationen gibt
* spezifisches Wissen bereitstellen möchten, das nicht auf der Website steht
* die Qualität der Antworten ihres Assistenten verbessern wollen

## Was passiert bei der Ersteinrichtung?

Bei der Aktivierung von anny AI wird deine Website automatisch ausgelesen. Der Assistent wird dadurch mit allen Informationen versorgt, die bereits auf deiner Website und deren Unterseiten verfügbar sind. Das bedeutet:

* Öffnungszeiten, Preise, Angebote und häufige Fragen werden erkannt und als Wissen hinterlegt.
* Du musst nicht alles manuell eingeben – der Assistent ist bereits nach der Einrichtung gesprächsfähig.

<Note>
  Wenn auf deiner Website veraltete oder fehlerhafte Informationen stehen, übernimmt anny AI diese ebenfalls. Prüfe daher deine Website vor der Einrichtung auf Aktualität.
</Note>

## Wo findest du das Wissensmanagement?

1. Navigiere zu den Account-Einstellungen und öffne **anny AI**.
2. Klicke auf **Wissen verwalten**.

![](https://downloads.intercomcdn.eu/i/o/niegcmk9/151489646/8d51bebc842a1d7facf46c1178f2/ai-wissensdatenbank.jpg?expires=1784559600\&signature=ccf1935efd31efe90952fb97ad3b70e332d3614aab49f28b4cbffb60c81ab46f\&req=0dBuwVDzqjMulxv889ospz1Hy0yPQKBO7t81iFLhLvpibqmCNohFoTgFjp0h%0AaOKt8bugAXvIUGNOJQ%3D%3D%0A)

### Häufige Fragen pflegen

Du kannst Frage-Antwort-Paare manuell anlegen, die dein Assistent bei passenden Anfragen heranzieht.

So fügst du einen FAQ-Eintrag hinzu:

1. Öffne Wissen verwalten.
2. Klicke auf Eintrag hinzufügen.
3. Gib im Feld Frage die Frage ein, wie sie Kund:innen typischerweise stellen würden.
4. Gib im Feld Antwort die vollständige Information ein, die der Assistent geben soll.
5. Speichere den Eintrag.

**Tipp**: Formuliere Fragen so, wie echte Kund:innen sie stellen würden – natürlich und umgangssprachlich. Der Assistent erkennt auch ähnliche Formulierungen.

### Einträge importieren

Du kannst mehrere Einträge gleichzeitig importieren, um Zeit zu sparen:

* CSV- oder Excel-Import: Bereite eine Tabelle vor mit Spalte 1 = Frage und Spalte 2 = Antwort. Lade diese hoch, um alle Einträge auf einmal zu importieren.

<Note>
  Achte darauf, dass jede Zeile einen vollständigen Eintrag enthält (eine klare Frage und eine vollständige Antwort).
</Note>

### Web-Suche aktivieren

Zusätzlich zur gepflegten Wissensdatenbank kann anny AI bei Bedarf deine Website durchsuchen, um aktuelle Informationen zu finden.

So aktivierst du die Web-Suche:

1. Öffne die Konfiguration deines Assistenten (Organisationseinstellungen > anny AI > Konfigurieren).
2. Navigiere zu den Tools deines Assistenten.
3. Aktiviere das Web-Suche-Tool.
4. Beschränke die Suche auf deine eigene Website-Domain.

![](https://downloads.intercomcdn.eu/i/o/niegcmk9/151489809/56f07f3ebcc77d3664ca3b6578d2/ai-assistent-websuche.jpg?expires=1784559600\&signature=54e745b42a8b4130d48505effef4cce2887b0fc8d95e3cd40864494dfd38e2cb\&req=0dBuwVDzpDchlxv889osp6YAB2cB%2FzWIjHY%2FVfyMv7XHR9ojv%2BCayoibqbRP%0A0qSt0OIbnuJhdxXYbg%3D%3D%0A)

<Tip>
  Wir empfehlen, die Web-Suche auf deine eigene Website einzuschränken. So stellst du sicher, dass anny AI nur verifizierte Informationen aus deiner Quelle verwendet.
</Tip>

Der Assistent liest dabei deine Website inklusive aller Unterseiten aus und kann Anrufer:innen Informationen geben, die dort verfügbar sind – auch wenn sie nicht explizit als FAQ-Eintrag hinterlegt wurden.

## Best Practices für gutes Wissensmanagement

* Klare Formulierungen: Schreibe Fragen so, wie Anrufer:innen sie tatsächlich stellen. Verwende einfache, natürliche Sprache.
* Vollständige Antworten: Gib in der Antwort alle relevanten Informationen an – Preise, Zeiten, Bedingungen.
* Regelmäßige Aktualisierung: Halte die Wissensdatenbank auf dem neuesten Stand. Ändere Einträge, wenn sich Preise, Zeiten oder Angebote ändern.
* Lücken erkennen: Nutze die Gesprächsprotokolle, um Fragen zu identifizieren, die der Assistent nicht oder unzureichend beantworten konnte. Ergänze entsprechende Einträge.
* Website aktuell halten: Da anny AI deine Website als Informationsquelle nutzt, wirken sich Aktualisierungen dort direkt auf die Qualität der Antworten aus.

## FAQ

<AccordionGroup>
  <Accordion title="Muss ich alle Informationen manuell eingeben?">
    Nein, bei der Ersteinrichtung wird deine Website automatisch ausgelesen. Du musst nur Informationen ergänzen, die nicht auf deiner Website stehen oder dort veraltet sind.
  </Accordion>

  <Accordion title="Kann anny AI Informationen aus dem Internet suchen?">
    Nur wenn du die Web-Suche aktivierst und auf deine eigene Domain beschränkst. anny AI durchsucht nicht das gesamte Internet.
  </Accordion>

  <Accordion title="Wie viele FAQ-Einträge kann ich hinterlegen?">
    Es gibt kein festes Limit. Je mehr relevante Einträge du pflegst, desto besser kann anny AI Fragen beantworten.
  </Accordion>

  <Accordion title="Was passiert, wenn anny AI eine Frage nicht beantworten kann?">
    Der Assistent teilt der anrufenden Person mit, dass er die Frage nicht beantworten kann, und bietet je nach Konfiguration an, an einen Mitarbeitenden durchzustellen.
  </Accordion>
</AccordionGroup>


# Vorlage für die Datenschutzerklärung des Kunden (anny AI)
Source: https://docs.anny.co/anny-ai-privacy-template



Dieser Abschnitt ist kein Vertragsbestandteil, sondern eine unverbindliche Textvorlage. Kunden, die anny AI nutzen, sind nach Art. 13/14 DSGVO verpflichtet, ihre Datenschutzerklärung um Informationen zur Nutzung des KI-Assistenten über die aktivierten Kanäle zu ergänzen.

Der folgende Text kann als Ausgangspunkt dienen und sollte an die individuellen Gegebenheiten und die tatsächlich genutzten Kanäle angepasst werden. Eine rechtliche Prüfung durch eigene Rechtsberatung wird empfohlen.

**Mustertext: Ergänzung zur Datenschutzerklärung für Nutzer von anny AI Einsatz von anny AI** (KI-basierter Assistent über verschiedene Kommunikationskanäle)

Wir nutzen für unsere digitale Kundenkommunikation und Termin-/Buchungsprozesse das Produkt anny AI, einen Dienst der anny GmbH, Cäcilienstraße 30, 50667 Köln (nachfolgend „anny"). anny AI kann über verschiedene Kanäle bereitgestellt werden, z. B. Telefon, WhatsApp, WhatsApp Call, Instagram, ein Web-Chat-Widget auf unserer Website sowie — für interne Zwecke — Slack oder MS Teams.

Bitte passen Sie diese Aufzählung an die von Ihnen tatsächlich genutzten Kanäle an.

Was ist anny AI? anny AI ist ein KI-gestütztes Produkt- und Funktionsportfolio, das Anfragen automatisiert verarbeitet und Buchungsprozesse unterstützt. Eingehende Interaktionen werden automatisiert entgegengenommen. Zu Beginn der Interaktion werden Sie in kanalgeeigneter Weise darauf hingewiesen, dass Sie mit einem KI-System kommunizieren (bei Sprachkanälen durch eine Ansage, bei Textkanälen durch einen Hinweis im Chat).

**Welche Daten werden verarbeitet?**

Im Rahmen einer Interaktion können je nach Kanal folgende personenbezogene Daten verarbeitet werden:

* Ihre kanaltypische Kennung (z. B. Telefon- oder WhatsApp-Nummer, Instagram-Handle, bei unserem Web-Chat-Widget Ihre IP-Adresse sowie Session-/Geräte-Daten, bei Slack/MS Teams Ihre interne Nutzer-ID)
* Interaktionsinhalte (Sprach-, Text- bzw. Nachrichtendaten), die Sie im Austausch mit dem KI-Assistenten äußern Datum, Uhrzeit und Dauer der Interaktion
* Vom KI-Assistenten erzeugte Transkripte, Nachrichtenverläufe und Zusammenfassungen
* Buchungsdaten, sofern Sie eine Buchung oder Terminanfrage aufgeben
* Aufnahme des Gesprächs (Audio), sofern Sie einen Sprachkanal nutzen und die Aufzeichnungsfunktion aktiviert ist
* Zweck und Rechtsgrundlage der Verarbeitung

Die Verarbeitung Ihrer Daten erfolgt zum Zweck der Bearbeitung Ihrer Anliegen, Buchungsanfragen und sonstigen Anfragen sowie zur Sicherstellung unserer Erreichbarkeit über die genutzten Kanäle. Rechtsgrundlage ist Art. 6 Abs. 1 lit. b DSGVO (Vertragserfüllung oder vorvertragliche Maßnahmen) sowie Art. 6 Abs. 1 lit. f DSGVO (berechtigtes Interesse an einer effizienten Kommunikation und Erreichbarkeit).

Wenn ein Gespräch über einen Sprachkanal aufgezeichnet wird, werden Sie zu Beginn ausdrücklich darauf hingewiesen und um Ihr Einverständnis gebeten. Rechtsgrundlage der Aufzeichnung ist Ihre Einwilligung gemäß Art. 6 Abs. 1 lit. a DSGVO. Die Einwilligung kann jederzeit mit Wirkung für die Zukunft widerrufen werden.

Setzt unser Web-Chat-Widget Cookies oder vergleichbare Technologien ein, die für den Betrieb nicht unbedingt erforderlich sind, holen wir hierfür Ihre Einwilligung nach § 25 TDDDG bzw. Art. 6 Abs. 1 lit. a DSGVO ein.

Bei internen Kanälen (Slack, MS Teams) richtet sich der Einsatz gegenüber Beschäftigten nach § 26 BDSG / Art. 88 DSGVO; ergänzend können betriebliche Regelungen oder Betriebsvereinbarungen gelten.

**Auftragsverarbeitung**

Wir haben mit anny GmbH einen Auftragsverarbeitungsvertrag gemäß Art. 28 DSGVO geschlossen.

Die Verarbeitung Ihrer Daten erfolgt grundsätzlich innerhalb der Europäischen Union. Soweit im Einzelfall einzelne Funktionen oder Kanäle (z. B. bestimmte Voice-Modelle oder die Messaging-Dienste WhatsApp/Instagram) technisch bedingt eine Verarbeitung außerhalb der EU erfordern, erfolgt die Übermittlung auf Grundlage geeigneter Garantien gemäß Art. 46 DSGVO (z. B. EU-Standardvertragsklauseln und zusätzliche Schutzmaßnahmen). Sonstige Speicherung und Verarbeitung erfolgt soweit technisch möglich in Europa.

**Speicherfristen**

Ihre Daten werden nur so lange gespeichert, wie es für die Erreichung des Verarbeitungszwecks erforderlich ist:

* Anrufaufzeichnungen (Audio, nur Sprachkanäle): automatische Löschung nach 7 Tagen, sofern nicht anders vom Kunden eingestellt
* Transkripte, Nachrichten- und Gesprächsverläufe: Löschung gemäß vertraglich festgelegten Fristen; spätestens 60 Tage nach Vertragsende, soweit keine gesetzlichen Aufbewahrungspflichten bestehen
* Buchungsdaten: gemäß den allgemeinen Speicherfristen unserer Datenschutzerklärung

**Automatisierte Entscheidungsfindung**

Der KI-Assistent trifft keine vollautomatisierten Entscheidungen im Sinne von Art. 22 DSGVO, die Ihnen gegenüber rechtliche Wirkung entfalten oder Sie in ähnlicher Weise erheblich beeinträchtigen. Buchungsanfragen, die durch den Assistenten erfasst werden, werden durch unser System weiterverarbeitet; Sie können jederzeit Kontakt zu uns aufnehmen, um einen Vorgang zu korrigieren oder zu stornieren.

**Ihre Rechte**

Sie haben gegenüber uns als Verantwortlichem jederzeit das Recht auf Auskunft (Art. 15 DSGVO), Berichtigung (Art. 16 DSGVO), Löschung (Art. 17 DSGVO), Einschränkung der Verarbeitung (Art. 18 DSGVO) sowie das Recht auf Datenübertragbarkeit (Art. 20 DSGVO). Sofern die Verarbeitung auf einem berechtigten Interesse beruht, steht Ihnen ein Widerspruchsrecht gemäß Art. 21 DSGVO zu. Zur Ausübung Ihrer Rechte wenden Sie sich bitte an: **\[Name des Unternehmens], \[E-Mail-Adresse Datenschutzkontakt des Unternehmens]**

Sie haben zudem das Recht, sich bei einer Datenschutzaufsichtsbehörde zu beschweren. Die für Sie zuständige Aufsichtsbehörde ist: **\[Für Sie zuständige Datenschutzaufsichtsbehörde]**

<Warning>
  Ende der Vorlage: bitte an individuelle Gegebenheiten anpassen und rechtlich prüfen lassen
</Warning>

Weitere Details finden Sie hier: [https://anny.co/agreement-anny-ai](https://anny.co/agreement-anny-ai)


# Los Geht's - anny AI
Source: https://docs.anny.co/anny-ai-setup

Aktiviere deinen KI-Assistenten für Telefon und Chat, um Anfragen und Buchungen rund um die Uhr automatisch zu bearbeiten.

anny AI ist dein KI-gestützter Assistent, der sowohl telefonisch als auch per Chat für dich im Einsatz ist. Er beantwortet häufige Fragen, führt Buchungen durch, verwaltet bestehende Termine und stellt bei Bedarf Anrufe an dein Team durch. Dieser Artikel zeigt dir, wie du anny AI aktivierst und die ersten Schritte für Telefonie und Website-Chat erledigst.

## Voraussetzungen

• Du nutzt anny mindestens im **Essential Plan**.

• Du hast Zugang zu den Account-Einstellungen im anny Admin-Bereich.

• Für anny AI fallen zusätzliche Kosten an. Die Abrechnung erfolgt pro Minute nach dem gewählten anny AI Paket.

## So richtest du anny AI ein

<Steps>
  <Step title="anny AI aktivieren">
    Öffne den anny Admin-Bereich und navigiere zu den **Account-Einstellungen**. Wechsle zum Reiter **anny AI**. Lies die **Zusatzvereinbarung** und bestätige diese. Klicke auf **Jetzt einrichten**.
  </Step>

  <Step title="KI-Assistent konfigurieren">
    Nach der Aktivierung wird dir sofort deine persönliche anny AI-Telefonnummer angezeigt. Unter dieser Nummer ist dein KI-Assistent ab sofort erreichbar. Des Weiteren kannst du über Konfigurieren auf den Admin-Bereich deines KI-Assistenten zugreifen.
  </Step>
</Steps>

![](https://downloads.intercomcdn.eu/i/o/niegcmk9/151475817/b4142816344f2ab700841154632e/ai-losgehts-einrichtung.jpg?expires=1784558700\&signature=9b9aaa0289f08c25274a2e7dd0c017cc44a8aefc9350be97dc6f70afd23324b8\&req=0dBuwV%2F%2FpDYvlxv889osp3RQyo6aEr0IcR9rPvd%2B%2FuCsaoRL%2BG9%2FuKqp3c1d%0ADcAHV7EO2D%2B2BOxaoQ%3D%3D%0A)

<Note>
  Die Nutzung von anny AI wird separat zu deinem bestehenden anny Abo in Rechnung gestellt. Bei Aktivierung wird der Preis anteilig zum aktuellen Nutzungszeitraum berechnet.
</Note>

## Was passiert nach der Aktivierung?

* Du erhältst eine eigene Telefonnummer (aktuell eine Kölner Vorwahl). Unter dieser Nummer ist dein Assistent direkt erreichbar.
* Der Assistent ist bereits mit einer Standardkonfiguration aktiv – er begrüßt Anrufer:innen, identifiziert sich als KI und kann Informationen zu deinem Angebot geben.
* Deine Website wird automatisch ausgelesen. anny AI kennt dadurch bereits die Informationen, die auf deiner Website verfügbar sind.
* Nach jedem Gespräch erhältst du eine E-Mail-Zusammenfassung mit Direktlink zur Konversation.

<Tip>
  Wir empfehlen, die eigene bestehende Telefonnummer nach außen beizubehalten und die anny AI-Nummer intern für eine Rufweiterleitung zu nutzen. So ändern sich für deine Kund:innen keine Kontaktdaten. Mehr Infos dazu gibt es hier.
</Tip>

## anny AI Chat einrichten

Der KI-Chat greift auf denselben Wissensspeicher wie der Telefonassistent zu, bietet jedoch visuelle und interaktive Funktionen direkt auf deiner Buchungsseite oder deiner eigenen Website.

![](https://downloads.intercomcdn.eu/i/o/niegcmk9/153626787/1db6a20fb90816f09be881fdd3f7/ai-losgehts-chat.jpg?expires=1784558700\&signature=b25d5f456f82e14907c9e93748d9023aa140d65d911ede6dfb3db1cac99d1519\&req=0dBsw1r8qz8vlxv889osp5fs7ccSKuVmkh84FrUAeNzKz6zgBRu2sqJmguLl%0AQxaNf9Rt4D6BYRZwIA%3D%3D%0A)

<Steps>
  <Step title="KI-Chat aktivieren">
    Aktiviere den Toggle **KI-Chat auf Buchungsseite anzeigen**
  </Step>

  <Step title="Begrüßung- und Startblase einrichten ">
    Gib den Text für die **Begrüßungsblase** ein (z. B. *"Hi, ich bin dein Buchungsassistent."*). Diese schwebt über dem Chat Launcher und macht Kund:innen direkt auf den Chat aufmerksam.<br /><br />Definiere eine **Startnachricht**, die als Erstes im Chat angezeigt wird (z. B. *"Hallo, hast du eine Frage oder möchtest du eine Buchung vornehmen?"*). <br /><br />\_​Diese individuelle Startnachricht gilt nur für das Widget auf deiner eigenen Website. Auf der standardmäßigen anny Buchungsseite ist die Startnachricht fix und kann nicht bearbeitet werden.\_​
  </Step>

  <Step title="Als Mitglied oder Gast den Chat nutzen">
    Optional: Aktiviere den Toggle **Besucher zum Anmelden auffordern**. Dies ist sinnvoll, wenn du Communities nutzt und Nutzer:innen beim Öffnen des Chats gefragt werden sollen, ob sie sich einloggen oder als Gast fortfahren möchten.
  </Step>

  <Step title="Cookie- und Datenschutzeinstellungen">
    Bestimme: 

    * **Datenschutzeinwilligung:** Standardmäßig wird vor der Chat-Nutzung eine Einwilligung abgefragt. Du kannst diese Abfrage im Widget entfernen, sofern du die Hinweise zur Nutzung von anny in deiner eigenen Datenschutzerklärung und in deinem Cookie-Banner platziert hast.
    * **Tracking deaktivieren:** Um das Tracking der Konversation vollständig abzuschalten, aktiviere die Option **Keine Besucher-ID annehmen**.
  </Step>

  <Step title="Einbettung auf Website">
    Bette den KI-Chat auf deiner Website ein, indem du das Script sowie die Komponente als Code im Website-Builder einbettest.
  </Step>
</Steps>

<Warning>
  Der Chat und der KI-Telefonassistent greifen beide auf den gleichen Wissensspeicher und die gleichen Verhaltensregeln zu und verhalten sich damit identisch. Die Startnachricht, die man unter agents.anny.co angibt, ist allerdings ausschließlich für den Telefonassistenten und die Agenten bestimmt.
</Warning>

<Expandable title="Beispiele von Besucher:innen, Mitglieder:innen oder Mitarbeitenden">
  ​ **Intern**

  * *"Buche mir einen Arbeitsplatz für kommenden Montag im Open Space"*
  * *"Wo sitzt Maria am Mittwoch?"*
  * *"Ist der Meetingraum Great Conference am 28. Juni um 16 Uhr noch frei?"*

  **Extern**

  * *"Welche Mitgliedschaften kann ich abschließen?"*
  * *"Hat das Loft Coworking Space Parkplätze?"*
  * *"Welche Sportkurse bietet Club Space an?"*
</Expandable>

***

## Deine nächsten Schritte

* **Rufweiterleitung einrichten**: Leite Anrufe von deiner bestehenden Nummer an anny AI weiter.
* **Wissensmanagement**: Pflege häufige Fragen und ergänze Informationen für deinen Assistenten.
* **Mitarbeiter für Durchstellung hinterlegen**: Ermögliche es anny AI, Anrufe an dein Team weiterzuleiten.
* **Chat-Widget einrichten:** Binde den KI-Chat auf deiner eigenen Website ein, damit Kund:innen direkt dort Fragen stellen und Buchungen vornehmen können.

## Wie funktioniert die Abrechnung?

* Du wählst ein anny AI Paket mit einem monatlichen Minutenkontingent.
* Die Abrechnung erfolgt sekundengenau – nur tatsächlich geführte Gespräche werden berechnet.
* Abgebrochene Anrufe (ohne Verbindung) zählen nicht.
* Nicht verbrauchtes Kontingent verfällt am Ende des Monats und wird nicht erstattet.
* Überschreitest du dein Kontingent, werden zusätzliche Minuten berechnet.
* Deinen aktuellen Verbrauch kannst du jederzeit im Bereich anny AI einsehen.

## Auswertung und Zusammenfassungen

* Nach jedem erfolgreichen Gespräch erhältst du eine E-Mail mit einer Zusammenfassung und einem Direktlink zur vollständigen Konversation. Wurde eine Buchung erstellt, wird diese in der E-Mail ebenfalls verlinkt.
* Im Assistenten-Interface findest du ein Dashboard mit Angaben zur Gesamtdauer der Anrufe, zur Erfolgsrate und zu den verschiedenen Anrufarten.
* Zu jedem einzelnen Anruf kannst du das Transkript, eine Zusammenfassung und – wenn die Aufzeichnung aktiviert ist – die Audioaufnahme einsehen.
* Aufzeichnungen werden standardmäßig 7 Tage aufbewahrt und danach automatisch gelöscht.

<img />

![](https://downloads.intercomcdn.eu/i/o/niegcmk9/151492781/44296e1fd8ed356a49e9c98d253d/ai-losgehts-analyse.jpg?expires=1784558700\&signature=27b185d45e5c0317c3a137c53cbbca45013b87449957c6fbdc00c50d7174f8ab\&req=0dBuwVH4qz8plxv889osp9hzkxR0SdHkSRqBvJmJcZh4qI6%2FAN4WM7JJQ5kK%0AT0Z6NEfuTl%2Fbww6w0Q%3D%3D%0A)

<Note>
  Die E-Mail-Benachrichtigung nach abgeschlossenen Telefonaten kannst du in deinen [Profileinstellungen](https://app.anny.co/user) im Adminbereich unter *Benachrichtigungen* deaktivieren.
</Note>

## Datenschutz

Kunden, die anny AI nutzen, sind nach Art. 13/14 DSGVO verpflichtet, ihre Datenschutzerklärung um Informationen zur Telefonassistenten-Nutzung zu ergänzen:


# anny Apps im Überblick
Source: https://docs.anny.co/anny-apps-overview

Alle anny Apps auf einen Blick: von der Buchungsseite über mobile Apps bis zu POS und Display.

anny bietet dir ein ganzes Ökosystem an Apps, mit denen du Buchungen, Check-ins und Zahlungen genau dort abwickelst, wo sie gebraucht werden: im Browser, auf dem Smartphone, am Empfang oder direkt vor dem Meetingraum.

## Für Endnutzer:innen

<CardGroup>
  <Card title="anny Web" icon="globe" href="/booking-page-layout">
    Die zentrale Buchungsseite deiner Organisation im Browser. Entdecke Ressourcen, plane deine Woche und verwalte Buchungen.
  </Card>

  <Card title="anny Mobile App" icon="mobile" href="/anny-mobile-app">
    Buche flexibel über dein Smartphone. Verfügbar für iOS und Android.
  </Card>

  <Card title="anny Teams App" icon="users" href="/ms-teams-app">
    Buche direkt aus Microsoft Teams heraus, ohne den Arbeitskontext zu verlassen.
  </Card>

  <Card title="Outlook Add-In" icon="envelope" href="/outlook-add-in">
    Buche Räume und Ressourcen direkt aus deinem Outlook-Kalender heraus.
  </Card>
</CardGroup>

## Für den Betrieb vor Ort

<CardGroup>
  <Card title="anny Check-In App" icon="qrcode" href="/check-in-setup">
    Verwandle ein Tablet in ein Check-In Terminal für Events, Besuchermanagement oder Bibliotheken.
  </Card>

  <Card title="anny Display App" icon="display" href="/display-app">
    Zeige Raumbelegungen in Echtzeit und ermögliche Spontanbuchungen direkt am Türdisplay.
  </Card>

  <Card title="anny Admin (POS) App" icon="cash-register" href="/pos-app-setup">
    Verwalte Buchungen und wickle Kartenzahlungen direkt am Empfang ab.
  </Card>
</CardGroup>


# anny Glossar
Source: https://docs.anny.co/anny-glossary

Alle wichtigen Begriffe rund um anny, kurz und verständlich erklärt.

## Kernstruktur & Navigation

<AccordionGroup>
  <Accordion title="Ressource">
    Alles, was in anny buchbar ist: Räume, Arbeitsplätze, Equipment, Events, Kurse, Dienstleistungen oder Parkplätze. Ressourcen sind das zentrale Objekt, um das sich alles dreht.
  </Accordion>

  <Accordion title="Child-Ressource">
    Eine konkrete Einzeloption innerhalb einer mehrfach verfügbaren Ressource. Beispiel: Arbeitsplatz 1, 2, 3 innerhalb der Ressource "Open Space". Kund:innen wählen bei der Buchung eine bestimmte Child-Ressource oder bekommen automatisch eine zugewiesen. Im übergreifenden Admin-Kalender und auf der Organisations-Kalenderansicht siehst du Child-Ressourcen nur als Summe. Den Einzelkalender einer Child-Ressource öffnest du über die Parent-Detailseite oder indem du die Parent-Zeile im Kalender aufklappst. Deshalb Räume und Sportplätze als eigene Ressourcen anlegen, nicht als Child-Ressourcen.
  </Accordion>

  <Accordion title="Buchungsoption / Service">
    Definiert, wie eine Ressource gebucht wird: Dauer, Preis, Intervall und Regeln. Technisch identisch. Der angezeigte Begriff hängt von der Ressourcen-Kategorie ab (Räume/Equipment = Buchungsoption, Dienstleistungen = Service).
  </Accordion>

  <Accordion title="Kategorie">
    Von anny vorgegebene Klassifizierung einer Ressource (z. B. Meetingraum, Parkplatz, Flex Desk, Workshop). Pflichtfeld bei der Erstellung. Steuert die Gliederung auf der Buchungsseite.
  </Accordion>

  <Accordion title="Gruppe">
    Selbst erstellte Organisationseinheit für Services. Steuert die Gliederung der Services auf der Buchungsseite und im Admin-Kalender. Optional.
  </Accordion>

  <Accordion title="Admin-Bereich">
    Das Backend von anny. Hier werden Ressourcen eingerichtet, Buchungen verwaltet, Kunden gepflegt und alle Einstellungen konfiguriert.
  </Accordion>

  <Accordion title="Buchungsseite">
    Das Frontend für Kund:innen. Hier werden Ressourcen entdeckt, Buchungen vorgenommen und bestehende Reservierungen verwaltet. Bereiche: Home, Entdecken, Planer, Buchungen. Die globale **Entdecken**-Seite zeigt nur Ressourcen über Organisationen hinweg. Services erscheinen ausschließlich auf der Buchungsseite einer Organisation.
  </Accordion>

  <Accordion title="Account-Einstellungen">
    Zentrale Konfiguration der Organisation: Layout, Checkout, Features, Zahlungen, Sicherheit und mehr. Erreichbar über Avatar (oben rechts).
  </Accordion>
</AccordionGroup>

## Verfügbarkeit & Zeitsteuerung

<AccordionGroup>
  <Accordion title="Zeitplan">
    Definiert regelmäßige, wiederkehrende Öffnungszeiten einer Ressource (Wochentag + Start-/Endzeit). Kann mit mehreren Ressourcen geteilt werden. Mehrere Zeitpläne pro Ressource möglich, Priorität durch Reihenfolge.
  </Accordion>

  <Accordion title="Verfügbarer Termin">
    Ein konkretes, einzelnes Zeitfenster mit festem Datum. Für Kurse, Events oder Workshops. Kann optional als wiederkehrend konfiguriert werden. Nicht verwechseln mit Zeitplänen.
  </Accordion>

  <Accordion title="Service-Zeitplan">
    Schränkt die Verfügbarkeit einer Buchungsoption zusätzlich ein, ohne die Ressourcen-Zeitpläne zu verändern.
  </Accordion>

  <Accordion title="Verfügbarkeitstyp">
    Bestimmt, wie oft eine Ressource gleichzeitig gebucht werden kann: Einfach verfügbar (1x), Mehrfach verfügbar (bis zur eingestellten Anzahl) oder Child-Ressourcen (konkrete Einzeloptionen).
  </Accordion>

  <Accordion title="Verfügbarkeitszeitraum">
    Optionales Start- und Enddatum eines Zeitplans. Ohne Eintrag gilt der Zeitplan dauerhaft. Wird genutzt für saisonale Abweichungen.
  </Accordion>

  <Accordion title="Globaler Blocker">
    Sperrt mehrere Ressourcen gleichzeitig für einen definierten Zeitraum (z. B. Feiertag, Betriebsferien). Unabhängig von Zeitplänen.
  </Accordion>

  <Accordion title="Exklusives Zeitfenster">
    Reserviert einen Zeitslot exklusiv für eine einzelne Bestellung, sodass keine anderen Kund:innen im selben Slot buchen können (z. B. Gruppenevents).
  </Accordion>

  <Accordion title="Warteliste">
    Benachrichtigt Kund:innen automatisch, sobald ein ausgebuchter Zeitslot wieder frei wird.
  </Accordion>

  <Accordion title="Dynamische Kapazitätsplanung">
    Passt die Kapazität von Terminen automatisch an die Nachfrage an, indem On-Demand Ressourcen bei steigender Nachfrage hinzugeschaltet werden.
  </Accordion>

  <Accordion title="On-Demand Ressource">
    Eine Ressource, die erst bei Bedarf (steigende Nachfrage) automatisch zur Verfügung gestellt wird. Teil der dynamischen Kapazitätsplanung.
  </Accordion>
</AccordionGroup>

## Buchungsablauf & -arten

<AccordionGroup>
  <Accordion title="Resource-First Flow">
    Standard-Buchungsablauf: Kund:innen wählen zuerst eine konkrete Ressource, dann die gewünschte Buchungsoption.
  </Accordion>

  <Accordion title="Service-First Flow">
    Alternativer Buchungsablauf: Kund:innen wählen zuerst die Leistung (Service), dann optional die ausführende Person oder Ressource. anny kann die Ressource auch automatisch zuweisen. Services stehen nicht auf der globalen Explore-Seite.
  </Accordion>

  <Accordion title="Zuweisungsstrategie">
    Bestimmt beim Service-First Flow, welche Ressource automatisch zugewiesen wird: First Available (erste nach Reihenfolge), Round Robin (rotierende Verteilung) oder Random (zufällig).
  </Accordion>

  <Accordion title="Buchungsart">
    Steuert, wie eine Buchung die Ressource beeinflusst: Standard (blockiert), Transparent (blockiert nicht), Mehrfach (blockiert mehrere Kapazitätseinheiten) oder Vollständig (blockiert gesamte Kapazität, nur bei Child-Ressourcen).
  </Accordion>

  <Accordion title="Zeitraum-Modus">
    Bestimmt die Dauer einer Buchungsoption: Feste Dauer (vorgegeben), Flexible Dauer (Min/Max-Rahmen), Dauer nach Zeitplan (füllt den gesamten Slot) oder Serie (mehrere Termine als Paket).
  </Accordion>

  <Accordion title="Buchungsintervall">
    Zeitabstand zwischen möglichen Startterminen einer Buchungsoption (z. B. alle 30 Minuten). Das Raster startet am Beginn des Verfügbarkeitsfensters, nicht automatisch zur vollen Stunde. Mit [Smart Availability](/smart-availability) ist das der erste gemeinsame Zeitpunkt aller nötigen Ressourcen.
  </Accordion>

  <Accordion title="Vorlaufzeit">
    Frühestmöglicher Buchungszeitpunkt. Positiv verhindert kurzfristige Buchungen. Negativ (z. B. -8 Stunden) hält eine Tagesbuchung nach dem Start noch offen.
  </Accordion>

  <Accordion title="Vorausbuchungszeitraum">
    Maximaler Zeitraum, wie weit in die Zukunft gebucht werden kann.
  </Accordion>

  <Accordion title="Vorbereitungs-/Nachbereitungszeit">
    Automatisch geblockte Pufferzeit vor und/oder nach einer Buchung. Wird nicht abgerechnet.
  </Accordion>

  <Accordion title="Wiederkehrende Buchung">
    Automatisch wiederholte Buchung in einem regelmäßigen Intervall (z. B. wöchentlich).
  </Accordion>

  <Accordion title="Buchungsserie">
    Mehrere zusammengehörige Termine als buchbares Paket (z. B. 8-teiliger Yogakurs). Kund:innen buchen alle Termine auf einmal.
  </Accordion>

  <Accordion title="Bestellung (Order)">
    Ein Checkout-Vorgang, der eine oder mehrere Buchungen zusammenfasst. Enthält Preis, Zahlungsinformationen und Buchungsdetails.
  </Accordion>
</AccordionGroup>

## Smart Availability & Abhängigkeiten

<AccordionGroup>
  <Accordion title="Smart Availability">
    Verbindet Ressourcen miteinander, sodass bei einer Buchung automatisch alle abhängigen Ressourcen blockiert werden, ohne dass Kund:innen diese sehen oder auswählen.
  </Accordion>

  <Accordion title="Smart Availability Group">
    Pool von Ressourcen, aus dem anny automatisch eine verfügbare Ressource pro Gruppe auswählt. Für flexible Setups mit mehreren Ressourcentypen (z. B. 2 Mitarbeitende + 1 Raum).
  </Accordion>

  <Accordion title="Subbuchung">
    Automatisch erstellte Reservierung einer abhängigen Ressource bei Smart Availability. Erscheint als Blocker im Kalender der abhängigen Ressource.
  </Accordion>

  <Accordion title="Abhängigkeit (Dependency)">
    Eine Ressource, die bei Buchung einer anderen Ressource automatisch mitblockiert wird. Konfiguriert über den Ressourcen-Tab in der Buchungsoption.
  </Accordion>
</AccordionGroup>

## Kunden & Zugang

<AccordionGroup>
  <Accordion title="Community">
    Ein geschlossener Bereich innerhalb eines anny Accounts. Steuert, wer bestimmte Ressourcen sehen und buchen kann. Mitglieder werden manuell, per Auto-Join (Domain/SSO/Buchungsregel) oder über ein Abo hinzugefügt.
  </Accordion>

  <Accordion title="Buchungskontingent">
    Ein Guthaben, das einer Person zugeordnet wird und bei jeder passenden Buchung automatisch verbraucht wird. Typen: Menge, Dauer oder Budget. Einmalig oder wiederkehrend.
  </Accordion>

  <Accordion title="Buchungspaket">
    Ein käufliches, zweckgebundenes Leistungspaket (z. B. 10er-Karte). Kund:innen erhalten einen 8-stelligen Buchungscode, den sie bei zukünftigen Buchungen im Checkout einlösen.
  </Accordion>

  <Accordion title="Buchungscode">
    8-stelliger Code aus einem Buchungspaket. Wird im Checkout eingegeben und reduziert den Buchungspreis (Kontingent wird verbraucht).
  </Accordion>

  <Accordion title="Wertgutschein">
    Ein Mehrzweckgutschein mit reinem Geldwert (0 % USt. beim Kauf). Wird bei beliebigen Buchungen als Zahlungsmittel eingelöst. Nicht zweckgebunden.
  </Accordion>

  <Accordion title="Rabattcode">
    Ein prozentualer oder absoluter Preisnachlass, den Kund:innen im Checkout eingeben. Ohne Guthabenlogik, rein preisreduzierend.
  </Accordion>

  <Accordion title="Abo-Plan">
    Definiert die Konditionen eines Abonnements: Preis, Intervall, Laufzeit, Kündigungsfrist und optionale Benefits (Community-Zugang, Kontingent).
  </Accordion>

  <Accordion title="Abo-Plan-Gruppe">
    Organisiert Abo-Pläne hierarchisch. Innerhalb einer Gruppe darf eine Person nur ein aktives Abo haben. Die Reihenfolge bestimmt Upgrade- und Downgrade-Logik.
  </Accordion>

  <Accordion title="Connected Persons">
    Verbundene Personen, für die du im Namen buchen kannst (z. B. Kolleg:innen). Ermöglicht Buchungen durch Dritte.
  </Accordion>

  <Accordion title="Buchungsregeln">
    Accountweite Regeln, die die Anzahl erlaubter Buchungen pro Zeitraum begrenzen. Mit Geltungsbereich (Ressource/Gruppe/Kategorie) und Nutzersteuerung (Sperrliste/White-List).
  </Accordion>
</AccordionGroup>

## Buchungserweiterungen

<AccordionGroup>
  <Accordion title="Zusatzoptionen (Add-Ons)">
    Optionale Extras, die Kund:innen im Buchungsprozess dazubuchen können (z. B. Catering, Equipment, Getränke).
  </Accordion>

  <Accordion title="Eigene Formulare">
    Individuelle Formularfelder pro Buchungsoption, die im Checkout oder beim Check-in abgefragt werden (z. B. Allergien, T-Shirt-Größe).
  </Accordion>

  <Accordion title="Rechtliche Dokumente">
    Dokumente (AGB, Hausordnung, Haftungsausschluss), die im Buchungsprozess per Checkbox oder digitaler Unterschrift bestätigt werden müssen.
  </Accordion>

  <Accordion title="Personalisierung">
    Erfasst pro Buchung individuelle Daten für jede teilnehmende Person, sodass jede:r ein eigenes Ticket und einen eigenen Kundendatensatz erhält.
  </Accordion>

  <Accordion title="Teilnehmermanagement">
    Ermöglicht es, zusätzliche Personen zu einer Buchung hinzuzufügen und deren Sichtbarkeit, Rechte und Kalender-Sync zu steuern.
  </Accordion>

  <Accordion title="Zertifikate">
    Automatisch generierte, personalisierte Teilnahmenachweise für Seminare, Workshops oder Kurse.
  </Accordion>

  <Accordion title="Dynamisches Pricing">
    Preismodifikatoren, die den Basispreis einer Buchungsoption automatisch anpassen: nach Wochentag, Uhrzeit, Auslastung, Community-Zugehörigkeit, Vorlaufzeit oder Buchungsanzahl.
  </Accordion>

  <Accordion title="Preismodifikator">
    Eine Regel innerhalb des dynamischen Pricings, die den Preis erhöht oder senkt. Typen: Einmaliger Rabatt/Aufschlag, Pro Intervall, Prozentual.
  </Accordion>

  <Accordion title="Stornierungsbedingungen">
    Regeln, die festlegen, bis wann und zu welchen Kosten Kund:innen ihre Buchungen stornieren können.
  </Accordion>

  <Accordion title="Mitteilungen">
    Zusätzliche E-Mail-Informationen, die auf Account-, Ressourcen- oder Buchungsoptionsebene in Bestätigungsmails und Erinnerungen eingefügt werden.
  </Accordion>
</AccordionGroup>

## Zahlungen & Rechnungen

<AccordionGroup>
  <Accordion title="Online-Zahlung (Stripe Connect)">
    Zahlungsabwicklung über Stripe. Unterstützt SEPA, Kreditkarte, Apple Pay, Google Pay. Voraussetzung für Abos und kostenpflichtige Buchungen mit Online-Checkout.
  </Accordion>

  <Accordion title="Zahlen auf Rechnung (Pay-Later)">
    Ermöglicht Kund:innen, nach der Buchung per Rechnung zu zahlen, statt im Checkout sofort zu bezahlen.
  </Accordion>

  <Accordion title="Rechnungsentwurf">
    Eine noch nicht finalisierte Rechnung. Kann bearbeitet werden, bevor sie an Kund:innen versendet wird.
  </Accordion>

  <Accordion title="Kundensaldo">
    Sammelt Rechnungsentwürfe pro Kund:in oder Unternehmen auf einem Saldo, der später als Sammelrechnung konsolidiert wird.
  </Accordion>

  <Accordion title="Sammelrechnung">
    Fasst mehrere Rechnungsentwürfe eines Kundensaldos in einer einzigen Rechnung zusammen.
  </Accordion>

  <Accordion title="POS App">
    Point-of-Sale-App für Vor-Ort-Zahlungen per Kartenlesegerät oder Tap to Pay. Verwaltet Kalender und Zahlungen. Trinkgeld kann bei Kartenzahlungen mit kassiert werden.
  </Accordion>

  <Accordion title="Trinkgeld">
    Zusatzbetrag bei Kartenzahlungen (POS / Terminal). Erscheint auf der Rechnung getrennt vom Umsatz und wird der Mitarbeiter:in zugeordnet, die die Zahlung entgegengenommen hat.
  </Accordion>
</AccordionGroup>

## Kommunikation & CRM

<AccordionGroup>
  <Accordion title="Aktivitäts-Log">
    Chronologischer Feed aller Änderungen, E-Mails und internen Notizen zu Buchungen, Bestellungen und Kunden.
  </Accordion>

  <Accordion title="Broadcasting">
    Gezielte Nachrichten an Kund:innen, basierend auf Buchungen, Kundenprofilen oder Abonnements.
  </Accordion>

  <Accordion title="Mobile Benachrichtigungen">
    SMS, WhatsApp oder Telegram-Nachrichten zu Buchungen, Check-Ins und Erinnerungen an Kund:innen oder Gastgeber.
  </Accordion>
</AccordionGroup>

## Check-In & Vor-Ort

<AccordionGroup>
  <Accordion title="Check-In / Check-Out">
    Einlasskontrolle per QR-Code-Ticket. Steuert den Zugang, verwaltet Kapazitäten in Echtzeit und ermöglicht Formularabfragen erst vor Ort.
  </Accordion>

  <Accordion title="QR-Code-Ticket">
    Ein bei der Buchung ausgestelltes Ticket mit QR-Code, das beim Einlass gescannt wird. Pro Ressource aktivierbar.
  </Accordion>

  <Accordion title="Check-In Terminal">
    Ein Tablet mit der anny Check-In App, das am Eingang steht und QR-Codes scannt oder Vor-Ort-Registrierungen ermöglicht.
  </Accordion>

  <Accordion title="Warteschlangensystem">
    Verwaltet Laufkundschaft und Terminbuchungen mit Nummernaufruf, Schaltern und Aufrufanzeigen.
  </Accordion>

  <Accordion title="Display App">
    Verwandelt Tablets und Smart-TVs in interaktive Raumdisplays mit Live-Status, Ad-hoc-Buchung und Check-in.
  </Accordion>

  <Accordion title="URL Anzeigetafel">
    Zeigt die Belegung von Ressourcen in Echtzeit auf jedem browserfähigen Gerät an, ohne App-Installation.
  </Accordion>
</AccordionGroup>

## Integrationen & Sicherheit

<AccordionGroup>
  <Accordion title="SSO (Single-Sign-On)">
    Zentrales Login über einen externen Identity Provider (z. B. Microsoft Entra ID, Google Workspace). Nutzer:innen melden sich mit ihren Unternehmens-Credentials an. Warum die Anmeldeseite nicht wie anny aussieht, erklärt [Mit SSO bei anny anmelden](/sso-login).
  </Accordion>

  <Accordion title="SAML">
    Authentifizierungsprotokoll für SSO. anny unterstützt Microsoft SAML und Google Workspace SSO.
  </Accordion>

  <Accordion title="SCIM (User Provisioning)">
    Automatische Synchronisierung von Benutzerkonten zwischen Identity Provider und anny (Anlegen, Aktualisieren, Deaktivieren).
  </Accordion>

  <Accordion title="Attribute Mapping">
    Synchronisiert Benutzerattribute (z. B. Abteilung, Standort) aus dem Identity Provider mit anny. Ermöglicht automatische Community-Zuordnung basierend auf Benutzergruppen.
  </Accordion>

  <Accordion title="Kalenderintegration">
    Synchronisiert Buchungen und Termine in Echtzeit mit externen Kalendern (Google, Outlook, Microsoft 365, ICS).
  </Accordion>

  <Accordion title="n8n">
    Automatisierungsplattform mit einem eigenen anny-Node. Trigger legen Webhook-Abonnements selbst an. Make.com nutzt dagegen generische Webhooks und die anny API.
  </Accordion>

  <Accordion title="Smart Lock">
    Integration mit digitalen Türschlössern (Nuki, Salto, Tapkey, dormakaba, EVVA, Comydo u. a.). Gewährt Zugang automatisch basierend auf aktiven Buchungen.
  </Accordion>
</AccordionGroup>

## Apps & Plattform

<AccordionGroup>
  <Accordion title="anny AI">
    KI-Assistent, der Anrufe entgegennimmt, Kund:innen berät, Verfügbarkeiten prüft und Buchungen erstellt, per Telefon und Chat.
  </Accordion>

  <Accordion title="anny Mobile App">
    Native App für iOS und Android. Ermöglicht Buchungen, Check-ins und Kontoverwaltung unterwegs.
  </Accordion>

  <Accordion title="Outlook Add-In">
    Buche Räume und Arbeitsplätze direkt aus Outlook heraus, ohne die anny Buchungsseite zu öffnen.
  </Accordion>

  <Accordion title="MS Teams App">
    Integration für Microsoft Teams, um Buchungen direkt aus Teams heraus vorzunehmen.
  </Accordion>

  <Accordion title="Widget (Einbettung)">
    Ermöglicht es, die Buchungsseite oder einzelne Ressourcen per iFrame oder Script direkt auf der eigenen Website einzubetten.
  </Accordion>

  <Accordion title="Interaktiver Lageplan (3D-Karte)">
    Visuelle Darstellung von Räumlichkeiten als interaktiver Plan. Grün markierte Ressourcen sind verfügbar und direkt buchbar.
  </Accordion>

  <Accordion title="Planer (Wochenplaner)">
    Bereich auf der Buchungsseite, der favorisierte Ressourcen in einer Wochenübersicht zeigt. Ermöglicht schnelle Buchung der gesamten Arbeitswoche.
  </Accordion>
</AccordionGroup>

## Auswertung & Daten

<AccordionGroup>
  <Accordion title="Dashboards">
    Visuelle Auswertungen von Buchungsdaten, Auslastung und Nutzungsverhalten im Admin-Bereich.
  </Accordion>

  <Accordion title="Exporte">
    Buchungen, Kunden, Rechnungen und mehr als CSV oder Excel exportieren, einmalig oder automatisch in festen Intervallen. Einstieg über **Export** → **Exportübersicht**, nicht über die linke Menüleiste.
  </Accordion>

  <Accordion title="Buchhaltung">
    Kontoauszüge, Belege und Umsatzübersichten aus anny exportieren und in DATEV oder andere Buchhaltungssysteme integrieren.
  </Accordion>
</AccordionGroup>


# anny Mobile App
Source: https://docs.anny.co/anny-mobile-app

Buche Arbeitsplätze, Meetingräume und mehr unterwegs mit der anny App für iOS und Android.

Mit der anny App planst du deine Woche, buchst Ressourcen und checkst vor Ort ein, alles direkt vom Smartphone. Die App bietet dieselben Kernfunktionen wie die Browserversion in einem mobilen Format.

## App installieren

<CardGroup>
  <Card title="iOS" icon="apple" href="https://apps.apple.com/us/app/anny/id6448261664">
    Im App Store herunterladen
  </Card>

  <Card title="Android" icon="android" href="https://play.google.com/store/apps/details?id=co.anny.app">
    Im Play Store herunterladen
  </Card>
</CardGroup>

<Tip>
  Achte bei der Anmeldung darauf, die richtige **Datenhost-Region** auszuwählen (meistens EU+). So verbindest du dich mit dem richtigen Server deiner Organisation.
</Tip>

## Video: Rundgang durch die App

<iframe />

## Aufbau der App

Die anny App besteht aus sechs Bereichen:

| Bereich | Funktion |
| - | - |
| Home | Tagesübersicht: heutige Buchungen, Self-Check-In, Favoriten und kürzlich gebuchte Ressourcen |
| Wochenplaner | Plane deine Woche in wenigen Klicks. Listen- und Kartenansicht verfügbar. |
| Erkunden | Alle buchbaren Ressourcen mit Filtern nach Kategorie, Verfügbarkeit und Eigenschaften. Community-Wechsel oben links. |
| Kalender | Buchungen einsehen und verwalten (Listen- und Wochenansicht) |
| Checkout | Warenkorb für mehrere Buchungen gleichzeitig. Buchungen werden 15 Minuten reserviert, bei E-Mail-Bestätigung von Gästen 30 Minuten. |
| Profil | Persönliche Daten, Zahlungsmethoden, Benachrichtigungen, Inkognito-Modus, Sprache |

## Wochenplaner

Der Wochenplaner ist das Herzstück der App. Favorisiere deine Lieblingsressourcen und plane deine gesamte Woche in 5 Klicks und 5 Swipes. In der Kartenansicht buchst du visuell direkt auf dem interaktiven Lageplan.

## Erkunden und buchen

Unter Erkunden findest du alle Ressourcen, auf die du Zugriff hast:

* Wechsle zwischen deinen Communities (oben links)
* Filtere nach Kategorien, Verfügbarkeiten und Eigenschaften
* Scanne anny QR-Codes, um eine Ressource direkt in der App zu öffnen

## Self-Check-In

Checke dich direkt in der App ein. Auf dem Homescreen siehst du deine heutige Buchung und kannst per Tap einchecken. Bei aktivierter Standortvalidierung muss der genaue Standort in den Geräteeinstellungen freigegeben sein.

## Push-Benachrichtigungen

Die Push-Benachrichtigungen informieren dich über Buchungsänderungen, Check-In-Aufforderungen und Einladungen. Unter iOS sind sie interaktiv: du kannst Buchungen direkt aus der Benachrichtigung heraus stornieren oder einchecken.

## anny Pässe

Der anny Pass ist dein digitaler Zugangsschlüssel:

* Erstelle einen QR-Code als anny Pass
* Verbinde bestehende QR-Codes oder NFC-Karten
* Füge deinen Pass zum Apple Wallet oder Google Wallet hinzu
* Nutze den Pass zum Einchecken an interaktiven Raumdisplays

## Weitere Features

* **Gastbuchungen:** Auch ohne Login möglich
* **Gutscheine:** Im Checkout einlösbar
* **Dark Mode:** Passt sich automatisch an dein Betriebssystem an
* **Zahlungsmethoden:** Kreditkarte und SEPA direkt in der App speichern

<AccordionGroup>
  <Accordion title="Welche Datenregion muss ich auswählen?">
    Die meisten Organisationen in DACH nutzen **EU+**. On-Prem-Kunden haben eine eigene Region. Frage im Zweifel bei deinem IT-Team nach.
  </Accordion>

  <Accordion title="Warum erhalte ich keine Push-Benachrichtigungen?">
    Prüfe in den Geräteeinstellungen, ob Push-Benachrichtigungen für die anny App aktiviert sind. Stelle zusätzlich im Profil unter Benachrichtigungen sicher, dass die gewünschten Kategorien eingeschaltet sind.
  </Accordion>

  <Accordion title="Kann ich über die App für andere buchen?">
    Ja, Connected Persons ist auch in der App verfügbar. Verbinde dich mit Kolleg:innen und buche im Planer in deren Namen.
  </Accordion>

  <Accordion title="Mein Check-In funktioniert nicht">
    Aktiviere den genauen Standort für die anny App in deinen Geräteeinstellungen. Stelle sicher, dass du dich im Gebäude befindest und GPS-Empfang hast.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * App Store: [https://apps.apple.com/us/app/anny/id6448261664](https://apps.apple.com/us/app/anny/id6448261664)
> * Play Store: [https://play.google.com/store/apps/details?id=co.anny.app](https://play.google.com/store/apps/details?id=co.anny.app)
> * Datenregion: EU+ für .co und .eu Kunden, eigene Region für On-Prem
> * Warenkorb reserviert Buchungen für 15 Minuten (`ORDER_EXPIRY`). Bei Gast-E-Mail-Bestätigung 30 Minuten (`ORDER_EXTEND_EXPIRY`).
> * Push-Benachrichtigungen: unter iOS interaktiv (Stornierung, Check-In direkt aus Notification)
> * Self-Check-In mit Standortvalidierung: "Genauen Standort" muss in Geräteeinstellungen aktiv sein
> * anny Pass: QR-Code, NFC-Karte, Apple Wallet, Google Wallet
> * Dark Mode: automatisch vom OS übernommen
> * Connected Persons: in App verfügbar
> * Gastbuchungen: ohne Login möglich
> * Verwandter Admin-Artikel: nicht vorhanden (reines Endnutzer-Feature)


# anny Videoanrufe
Source: https://docs.anny.co/anny-video-calls

Erstelle, starte und führe Video-Meetings direkt in anny durch, ohne externes Tool oder zusätzlichen Account.

anny Videoanrufe (anny Video Calls) ist die native Video-Funktion von anny. Damit erstellst, startest und führst du Video-Meetings direkt in anny durch, ohne externes Tool und ohne zusätzlichen Account. So bleiben Planung, Buchung und Durchführung eines Termins in einer Plattform.

Mit anny Videoanrufen kannst du in anny:

* Video-Meetings automatisch für deine Buchungen erzeugen
* Meetings starten und halten, komplett innerhalb von anny
* Termine ohne Toolwechsel und ohne zusätzliche Lizenzen durchführen

Die Integration passt, wenn du Beratungen, Gespräche oder Termine direkt aus anny heraus per Video durchführen möchtest, ohne auf ein externes Videotool zu wechseln.

<Info>
  anny Videoanrufe ist aktuell eine Beta-Funktion. Die Integration erscheint unter **Integrationen** → **anny Videoanrufe**, sobald sie für deine Organisation freigeschaltet ist.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Studienberatung an Hochschulen | **Beratung ohne Toolwechsel.** Studierende buchen ihren Beratungstermin in anny und nehmen ihn direkt als Videoanruf in anny wahr. Ein separates Videotool entfällt. |
| 1:1-Beratung & Coaching | **Einzelgespräche per Video.** Biete Coaching- oder Beratungstermine als Videoanruf an. Der Videolink entsteht automatisch mit der Buchung. |
| Remote-Termine für verteilte Teams | **Standortunabhängige Gespräche.** Führe wiederkehrende Termine mit Teilnehmenden an unterschiedlichen Orten direkt in anny durch. |

## Wie anny Videoanrufe funktioniert

anny Videoanrufe ist nativ in anny integriert. Es ist kein externer Account und keine separate Anmeldung nötig, weder für dich noch für Teilnehmende. Die Video-Meetings werden innerhalb von anny erzeugt und gehalten.

Du steuerst über **Meeting-Regeln**, für welche Termine ein Videoanruf erzeugt wird. Eine Meeting-Regel verknüpft eine **Ressource** mit einer oder mehreren **Buchungsoptionen**. Triffst du keine Auswahl, gilt die Regel für **Alle Buchungsoptionen**. Pro Ressource kannst du genau eine Regel anlegen. Eine Regel auf einer übergeordneten Ressource gilt auch für Buchungen ihrer Unterressourcen.

Der Videoanruf entsteht, sobald eine passende Buchung bestätigt ist. Buchungsanfragen erhalten ihren Videoanruf erst mit der Annahme. Wird eine Buchung storniert oder abgelehnt, löscht anny den Videoanruf und der Link wird ungültig. Verschiebt sich nur die Uhrzeit, bleibt der Link gleich. Bei Serienbuchungen erhält jeder Termin einen eigenen Videoanruf.

Kund:innen finden den Link als Button **Videoanruf beitreten** auf ihrer Buchungsseite, in der Bestätigungs-E-Mail und im Kalendereintrag. Als Admin trittst du über die Buchungsdetails bei: Dort zeigt anny den Hinweis „Diese Buchung enthält einen Videoanruf." und du startest das Meeting per **Videoanruf beitreten** als Moderator:in.

## anny Videoanrufe einrichten

### Voraussetzungen

Bevor du anny Videoanrufe einrichtest, stelle sicher, dass du Folgendes hast:

* Eine passende Rolle bzw. Berechtigung in anny, um Integrationen zu verwalten
* Mindestens eine **Ressource** und eine **Buchungsoption**, die du mit Videoanrufen verknüpfen möchtest

### Verbindung einrichten

<Steps>
  <Step title="Integration öffnen">
    Öffne **Integrationen** → **anny Videoanrufe**. Lass die Integration zunächst deaktiviert: Meeting-Regeln kannst du nur bearbeiten, solange der **Toggle** ausgeschaltet ist.
  </Step>

  <Step title="Meeting-Regel hinzufügen">
    Klicke auf **Hinzufügen**, wähle die **Ressource** und dann eine oder mehrere **Buchungsoptionen**. Ohne Auswahl gilt die Regel für **Alle Buchungsoptionen**. Speichere mit **Bestätigen**.
  </Step>

  <Step title="Integration aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts.
  </Step>

  <Step title="Verbindung prüfen">
    Die neue Meeting-Regel erscheint unter **Meeting-Regeln**. Ab jetzt wird für passende bestätigte Buchungen automatisch ein Videoanruf erzeugt.
  </Step>
</Steps>

Sobald die Integration aktiv ist und eine Meeting-Regel besteht, erhalten passende bestätigte Buchungen automatisch einen anny Videoanruf.

<Tip>
  Triffst du bei den Buchungsoptionen keine Auswahl, findet grundsätzlich jeder Termin der Ressource per Video statt. Für einzelne Formate wählst du stattdessen gezielt die passenden Buchungsoptionen aus. Möchtest du Regeln später ändern, deaktiviere die Integration vorher kurz über den **Toggle**.
</Tip>

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, erstellt anny keine neuen Videoanrufe mehr und bestehende Meeting-Links funktionieren vorübergehend nicht. Nach dem erneuten Aktivieren sind sie wieder nutzbar. Beim Löschen werden alle Meeting-Regeln endgültig entfernt und bereits erstellte Meeting-Links bleiben dauerhaft ungültig.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Brauchen Teilnehmende einen anny Account für den Videoanruf?">
    Nein. Der Videoanruf findet direkt in anny statt. Teilnehmende benötigen keinen eigenen Account und kein zusätzliches Tool.
  </Accordion>

  <Accordion title="Für welche Termine wird automatisch ein Videoanruf erstellt?">
    Für alle bestätigten Buchungen, die zu einer aktiven Meeting-Regel passen. Eine Meeting-Regel verknüpft eine Ressource mit einer oder mehreren Buchungsoptionen (ohne Auswahl: alle). Buchungsanfragen erhalten ihren Videoanruf, sobald du sie annimmst.
  </Accordion>

  <Accordion title="Kann ich mehrere Meeting-Regeln anlegen?">
    Ja, für jede Ressource kannst du über **Hinzufügen** eine eigene Meeting-Regel anlegen. Pro Ressource ist genau eine Regel möglich. Mehrere Buchungsoptionen derselben Ressource wählst du innerhalb dieser einen Regel aus.
  </Accordion>

  <Accordion title="Fallen zusätzliche Kosten oder Lizenzen an?">
    Für dich und deine Teilnehmenden sind keine externen Videotool-Lizenzen und keine zusätzlichen Accounts nötig. anny Videoanrufe läuft direkt in anny.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Für meine Buchung wurde kein Videoanruf erstellt">
    Meist ist keine passende Meeting-Regel aktiv oder die Buchung ist noch nicht bestätigt. Prüfe unter **Integrationen** → **anny Videoanrufe**, ob die Integration aktiviert ist und eine Meeting-Regel die gebuchte Ressource und Buchungsoption abdeckt. Buchungsanfragen erhalten ihren Videoanruf erst mit der Annahme; außerdem muss eine Kund:in an der Buchung hinterlegt sein.
  </Accordion>

  <Accordion title="Die Meeting-Regel lässt sich nicht speichern">
    Meist ist die Integration noch aktiv oder für die Ressource existiert bereits eine Regel. Deaktiviere die Integration über den **Toggle** und bearbeite die bestehende Regel der Ressource, statt eine zweite anzulegen. Die Buchungsoptionen sind optional: Ohne Auswahl gilt die Regel für alle.
  </Accordion>

  <Accordion title="Der Videoanruf lässt sich nicht starten">
    Meist ist die Integration deaktiviert oder die Buchung wurde storniert. Prüfe, ob die Integration unter **Integrationen** → **anny Videoanrufe** aktiv ist und die Buchung weiterhin bestätigt ist. Bei stornierten oder abgelehnten Buchungen löscht anny den Videoanruf.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** anny Videoanrufe (anny Video Calls) ist eine native anny-Funktion, KEINE externe Integration, trotz Platzierung unter „Integrationen". Nicht verwechseln mit den externen Video-Integrationen Zoom, MS Teams und Purpleview, mit Teams-Meetings aus den Kalenderintegrationen (Outlook, Microsoft 365) oder mit der MS-Teams-App.
>
> **UI-Pfade & Wortlaut:** Menüleiste → **Integrationen** → Kachel „anny Videoanrufe (Beta)". Panel „Meeting-Regeln" mit Button „Hinzufügen"; Felder im Regel-Dialog: „Wähle die Ressource", „Buchungsoptionen auswählen" (Mehrfachauswahl, Platzhalter „Alle Buchungsoptionen"), Speichern über „Bestätigen". Bei aktiver Integration erscheint der Hinweis „Um die Einstellungen bearbeiten zu können, muss die Integration deaktiviert werden." Admin-Buchungsdetails: Banner „Diese Buchung enthält einen Videoanruf." + „Videoanruf beitreten". Meeting-Seite (Lobby): Buttons „Videoanruf beitreten", „Anruf verlassen", nach Ende „Anruf beendet" + „Erneut beitreten".
>
> **Quirks:** (1) Technischer Unterbau ist der Videokonferenz-Anbieter Digital Samba; anny konfiguriert ihn global, Organisationen hinterlegen keine Zugangsdaten. (2) Die Dauer eines Meeting-Raums entspricht der Buchungsdauer, maximal 24 Stunden. (3) Wechselt die Ressource einer Buchung, wird der Videoanruf neu erstellt und der Link ändert sich; bereits verschickte E-Mails/Kalendereinträge enthalten dann den alten, ungültigen Link. (4) Die Meeting-Oberfläche startet in der Standardsprache der Organisation; Teilnehmende können die Sprache im Meeting umstellen. (5) Schlägt die Raum-Erstellung kurzzeitig fehl, wiederholt anny sie automatisch mehrfach. (6) Teilnehmende treten mit dem Namen der Kund:in oder als Gast bei; die Meeting-Lobby zeigt eine Buchungsübersicht, wenn der Link den Buchungszugriff erlaubt. (7) Buchungen ohne hinterlegte Kund:in erhalten keinen Videoanruf.
>
> **Beziehungen:** Die Sichtbarkeit der Integration hängt an einem Plan-Feature (Video-Meeting) und an der plattformweiten Freischaltung durch anny (Beta). Der Meeting-Link erscheint zusätzlich in der Bestätigungs-E-Mail und in der ICS-Kalenderdatei der Buchung.


# (Automatische) Exporte
Source: https://docs.anny.co/automatic-exports

Exportiere Buchungen, Kunden, Rechnungen und mehr als CSV oder Excel, einmalig oder automatisch in festen Intervallen.

Mit der Export-Funktion in anny kannst du deine Daten strukturiert exportieren: entweder als einmaligen Export auf Knopfdruck oder als automatischen Export-Zeitplan, der in festen Intervallen an ein definiertes Ziel gesendet wird. So stellst du Buchungsübersichten, Kundenlisten oder Rechnungsdaten regelmäßig für dein Team, deine Buchhaltung oder externe Partner:innen bereit.

<Info>
  Export-Zeitpläne sind planabhängig limitiert: Essential 1, Professional 3, Business 5, Enterprise 12. Einmalige Exporte sind in allen Plänen unbegrenzt verfügbar.
</Info>

## Wie funktioniert das Export-System?

Das Export-System in anny unterscheidet zwei Modi:

* **Einmaliger Export:** Du löst einen Export direkt aus. anny erstellt die Datei sofort und stellt sie zum Download bereit.
* **Export-Zeitplan:** Du konfigurierst einen automatischen Export, der in einem definierten Intervall (täglich, wöchentlich oder monatlich) erstellt und an ein Ziel gesendet wird.

Beide Modi erreichst du über **Export** auf den Listen **Buchungen**, **Kunden**, **Rechnungen**, **Bestellungen** oder **Abos**. Dort wählst du **Exportübersicht**. Die Seiten **Exporte** (`/exports`) und **Automatische Exporte** (`/export-schedules`) sind nicht in der linken Menüleiste.

* **Exporte:** Übersicht aller durchgeführten Exporte mit Status und Download-Option.
* **Automatische Exporte:** Übersicht aller aktiven automatischen Export-Konfigurationen.

Über **Neu** erstellst du in beiden Bereichen einen neuen einmaligen Export oder einen neuen Export-Zeitplan.

## Wann nutze ich das?

* **Du brauchst regelmäßig eine Buchungsübersicht für dein Team oder Management:** Konfiguriere einen wöchentlichen oder monatlichen Export-Zeitplan mit den relevanten Filtern.
* **Du arbeitest mit externen Partner:innen (z. B. Catering, Reinigung) zusammen:** Sende automatisch tägliche Exporte mit gefilterten Buchungsdaten per E-Mail.
* **Du benötigst Daten für die Buchhaltung:** Exportiere Rechnungen, Bestellungen oder Kundenlisten in regelmäßigen Abständen.
* **Du brauchst schnell eine aktuelle Datei:** Nutze den einmaligen Export für Ad-hoc-Auswertungen.
* **Nicht geeignet für:** Echtzeit-Datenanbindungen. Dafür nutze Webhooks oder die API. DATEV-Buchhaltungsexporte laufen über die [DATEV-Integration](/datev-integration), nicht über diese Export-Funktion.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Zusatzoptionen | Add-On-Gruppen können als eigene Spalten im Buchungsexport eingeblendet werden. |
| Communities | Buchungsexporte lassen sich nach Community filtern. |

## Einstellungen & Optionen

### Exporttypen

| Exporttyp | Beschreibung |
| - | - |
| Buchungen | Alle Buchungsdaten inkl. Custom Fields und Add-Ons |
| Bestellungen | Bestellübersicht mit Zahlungsstatus |
| Rechnungen | Tabellarische Rechnungsdaten. Im Zeitplan zusätzlich als PDF möglich. |
| Kunden | Kundenstammdaten und Custom Fields |
| Gutscheine | Rabattcodes mit Einlösestatus |
| Buchungscodes | Buchungspaket-Codes mit Nutzungsstatus (UI-Typ **Buchungspakete**) |
| Kontoauszug | Kontobewegungen. Für DE, AT und CH optional als CAMT.053 (XML). Nur mit Online-Zahlung. |
| Abos | Abonnementdaten (Abo Export). Nur im Backend bzw. über die passende Berechtigung, nicht in jedem Zeitplan-Formular. |

### Exportformate

| Format | Beschreibung |
| - | - |
| CSV | Kommagetrennte Textdatei |
| XLSX | Excel-Datei |

### Spaltenauswahl

| Option | Beschreibung |
| - | - |
| Alle Spalten | Exportiert alle verfügbaren Datenfelder |
| Konfigurierte Spalten | Nur ausgewählte Spalten (individuell zusammenstellbar) |

<Tip>
  Nutze "Konfigurierte Spalten", um nur die relevanten Daten zu exportieren. Du kannst Custom Fields, Add-On-Gruppen und Kundenattribute als eigene Spalten hinzufügen.
</Tip>

### Filter (Buchungsexport)

Beim Buchungsexport kannst du die Ergebnisse vorab eingrenzen:

| Filter | Beschreibung |
| - | - |
| Ressourcen | Nur Buchungen bestimmter Ressourcen |
| Gruppe | Nach Ressourcen-Gruppe filtern |
| Services | Nach Buchungsoption/Service filtern |
| Status | Z. B. nur bestätigte Buchungen |
| Communities | Nur Buchungen aus bestimmten Communities |
| Zusätzliche Optionen | Nach gebuchten Add-Ons filtern |
| Check-In / Check-Out | Nach Check-In- oder Check-Out-Status filtern |

### Export-Zeitplan: Konfiguration

Ein automatischer Export-Zeitplan besteht aus vier Bereichen:

| Bereich | Einstellungen |
| - | - |
| Allgemeine Einstellungen | Name, Beschreibung, Benachrichtigungen (Toggle) |
| Intervall | Täglich, Wöchentlich oder Monatlich + Uhrzeit + Wochentage |
| Inhalt | Exporttyp, Exportformat, Filter, Spalten |
| Ziel des Exports | Ein oder mehrere Ziele (E-Mail, FTP, Implizites FTP, S3) |

### Ziel-Typen

| Typ | Beschreibung |
| - | - |
| E-Mail | Export wird als Anhang an eine E-Mail-Adresse gesendet |
| FTP | Upload auf einen FTP-Server |
| Implizites FTP | Upload auf einen FTPS-Server |
| S3 | Upload in einen S3-kompatiblen Cloud-Speicher |

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Coworking-Space sendet wöchentlich eine Buchungsübersicht an das Management">
    Das Management möchte jeden Montagmorgen eine aktuelle Übersicht aller bestätigten Buchungen der kommenden Woche erhalten.

    <Steps>
      <Step title="Export-Zeitplan erstellen">
        Öffne eine Liste mit **Export** → **Exportübersicht**. Wechsle zu **Automatische Exporte** und klicke auf **Neu**.
      </Step>

      <Step title="Allgemeine Einstellungen">
        Vergib den Namen "Wöchentliche Buchungsübersicht" und aktiviere optional **Benachrichtigen**, um bei jedem Export eine Bestätigung zu erhalten.
      </Step>

      <Step title="Intervall konfigurieren">
        Wähle **Wöchentlich**, aktiviere **Montag** als Wochentag und setze die Uhrzeit auf 07:00.
      </Step>

      <Step title="Inhalt festlegen">
        Wähle Exporttyp **Buchungen** und Exportformat **CSV**. Setze im Filter den Status auf **Bestätigt** und wähle die relevanten Ressourcen aus.
      </Step>

      <Step title="Ziel hinzufügen">
        Klicke unter **Ziel des Exports** auf **+ Erstellen**. Vergib den Namen "Management", wähle **E-Mail** als Art des Ziels und trage die E-Mail-Adresse ein. Klicke auf **Speichern**.
      </Step>

      <Step title="Export-Zeitplan speichern">
        Klicke auf **Speichern**. Der Export-Zeitplan erscheint in der Übersicht und wird ab sofort jeden Montag um 07:00 ausgeführt.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Ein Veranstaltungsort informiert den Catering-Partner täglich über gebuchte Zusatzoptionen">
    Der Catering-Partner soll jeden Morgen eine Liste der heutigen Buchungen mit gebuchten Catering-Zusatzoptionen erhalten.

    <Steps>
      <Step title="Export-Zeitplan erstellen">
        Öffne **Exportübersicht** → **Automatische Exporte** → **Neu**.
      </Step>

      <Step title="Allgemeine Einstellungen">
        Vergib den Namen "Catering-Übersicht täglich".
      </Step>

      <Step title="Intervall konfigurieren">
        Wähle **Täglich** und setze die Uhrzeit auf 06:00.
      </Step>

      <Step title="Inhalt festlegen">
        Wähle Exporttyp **Buchungen** und Exportformat **CSV**. Wähle unter Spalten **Konfigurierte Spalten** und füge nur Buchungsnummer, Zeitraum, Ressource und die Catering-Add-On-Gruppe hinzu.
      </Step>

      <Step title="Ziel hinzufügen">
        Erstelle ein E-Mail-Ziel mit der Adresse des Catering-Partners.
      </Step>

      <Step title="Speichern">
        Klicke auf **Speichern**. Der Partner erhält ab sofort täglich um 06:00 die relevante Übersicht.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich einen Export-Zeitplan nachträglich bearbeiten?">
    Ja. Öffne **Automatische Exporte**, klicke auf den gewünschten Zeitplan und passe Intervall, Inhalt oder Ziel an. Die Änderungen gelten ab dem nächsten geplanten Export.
  </Accordion>

  <Accordion title="Wie lange sind einmalige Exporte zum Download verfügbar?">
    Einmalige Exporte bleiben 3 Tage in der Export-Übersicht zum Download verfügbar. Danach wird die Datei gelöscht.
  </Accordion>

  <Accordion title="Kann ich mehrere Ziele für einen Export-Zeitplan festlegen?">
    Ja. Du kannst unter **Ziel des Exports** mehrere Ziele hinzufügen. Der Export wird an alle konfigurierten Ziele gleichzeitig gesendet.
  </Accordion>

  <Accordion title="Welche Spalten sind im Export verfügbar?">
    Neben den Standardspalten kannst du Custom Fields, Add-On-Gruppen und Kundenattribute als eigene Spalten hinzufügen. Wähle dafür unter Inhalt die Option **Konfigurierte Spalten**.
  </Accordion>

  <Accordion title="Zählen einmalige Exporte gegen mein Plan-Limit?">
    Nein. Nur aktive Export-Zeitpläne sind limitiert. Einmalige Exporte kannst du unbegrenzt durchführen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein automatischer Export enthält keine Daten">
    Prüfe die Filter im Export-Zeitplan. Häufig ist ein zu enger Zeitraumfilter oder ein Statusfilter gesetzt, der zum Exportzeitpunkt keine Treffer liefert. Passe die Filter an und löse testweise einen einmaligen Export mit denselben Einstellungen aus.
  </Accordion>

  <Accordion title="Die E-Mail mit dem Export kommt nicht an">
    Prüfe die hinterlegte E-Mail-Adresse im Ziel. Schau außerdem im Spam-Ordner nach. Falls du eine externe Adresse nutzt, stelle sicher, dass der Mailserver E-Mails von anny nicht blockiert.
  </Accordion>

  <Accordion title="Custom Fields fehlen im Export">
    Custom Fields erscheinen nur, wenn du unter Spalten die Option **Konfigurierte Spalten** wählst und die gewünschten Felder explizit hinzufügst. Bei "Alle Spalten" werden nur die Standard-Datenfelder exportiert.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **UI-Pfad:** Kein Sidebar-Eintrag „Exporte“. Einstieg über **Export** auf Buchungen/Kunden/Rechnungen/Bestellungen/Abos → **Exportübersicht** (`/exports`). Zeitpläne: **Automatische Exporte** (`/export-schedules`). Neuer Export: **Neu**.
>
> **Plan-Limits Export-Zeitpläne:** Essential 1, Professional 3, Business 5, Enterprise 12. Einmalige Exporte sind unlimitiert. Feature: `export-schedules`.
>
> **Exporttypen (i18n):** Buchungsexport, Kundenexport, Export von Bestellungen, Export von Rabattcodes, Rechnungsexport, Buchungscode Export, Abo Export, Export Kontobewegungen. UI-Zeitplan-Formular: Buchungen, Kunden, Bestellungen, Gutscheine, Rechnungen (+PDF), Buchungspakete, Kontoauszug (wenn `usesPayments`). `plan-subscriptions` existiert als Ability, ist nicht in jedem Formular.
>
> **Ziel-Typen:** E-Mail, FTP, Implizites FTP, S3. SFTP ist im Code vorhanden, in der UI derzeit deaktiviert.
>
> **Filter Buchungsexport:** Ressourcen, Gruppe, Services, Status, Communities, Zusätzliche Optionen (inkl. **Beliebige**), Check-In, Check-Out, Blocker ausblenden.
>
> **Spaltenauswahl:** "Alle Spalten" oder "Konfigurierte Spalten" (inkl. Custom Fields, Add-On-Gruppen, Kundenattribute).
>
> **Intervall-Optionen:** CronEditor, typischerweise täglich/wöchentlich/monatlich plus Uhrzeit.
>
> **Abgrenzung DATEV-Integration:** DATEV-Buchhaltungsexporte nutzen eine eigene Integration unter Integrationen → Buchhaltung → DATEV und sind kein Teil der hier beschriebenen Export-Funktion.
>
> **Bekannte Einschränkung:** Bei Serien-Elementen können Custom Fields in der Buchungsübersicht fehlen (bekanntes Verhalten).


# Die Buchungsseite im Überblick
Source: https://docs.anny.co/booking-page-overview

Finde dich auf deiner anny Buchungsseite zurecht: Home, Entdecken, Planer und Buchungen auf einen Blick.

Die Buchungsseite ist dein zentraler Einstiegspunkt bei anny. Von hier aus entdeckst du verfügbare Ressourcen, planst deine Woche und verwaltest bestehende Buchungen.

## Die vier Bereiche

<CardGroup>
  <Card title="Home" icon="house">
    Deine Tagesübersicht: aktuelle Buchungen, favorisierte Kolleg:innen und Ressourcen, Communities und Kontingente.
  </Card>

  <Card title="Entdecken" icon="magnifying-glass">
    Globale Übersicht aller buchbaren **Ressourcen** deiner Organisationen. Services erscheinen hier nicht.
  </Card>

  <Card title="Planer" icon="calendar-week">
    Dein Wochenplaner: favorisierte Ressourcen in der Liste oder auf der interaktiven Karte.
  </Card>

  <Card title="Buchungen" icon="list-check">
    Übersicht aller Buchungen. Einchecken, stornieren oder bearbeiten. 
  </Card>
</CardGroup>

## Home

Auf der Home-Seite siehst du auf einen Blick:

* Deine tagesaktuelle Buchung
* Favorisierte Kolleg:innen und ob sie heute vor Ort sind
* Deine favorisierten Arbeitsplätze und Meetingräume
* Die Communities, denen du angehörst
* Deine Buchungskontingente (sofern vorhanden)
* Heutige Zugänge: Smart-Lock-Zugänge zu deinen gebuchten Räumen (sofern vorhanden)
* Deine Abonnements (sofern vorhanden)
* Offene Salden (sofern vorhanden)
* Zuletzt besuchte Organisationen

## Entdecken

Im Bereich Entdecken findest du buchbare **Ressourcen**. Die globale Entdecken-Seite listet Ressourcen über Organisationen hinweg. **Services** siehst du nur, wenn du die Buchungsseite einer konkreten Organisation öffnest und dort den Reiter **Services** wählst.

Nutze den Datums- und Zeitfilter, um nur verfügbare Ressourcen anzuzeigen. Filtere zusätzlich nach Eigenschaften wie Ausstattung, Kapazität oder Standort.

Dir stehen drei Kalenderansichten zur Verfügung:

| Ansicht | Beschreibung |
| - | - |
| Wochenansicht | Klassische Zeitachse mit Tages- und Stundenraster. Buchungen ab 7 Stunden erscheinen im Ganztagsbereich. |
| Boardansicht | Termine chronologisch untereinander, ohne Zeitachse. Ideal für Kurs- und Eventübersichten. |
| Monatsansicht | Schneller Überblick über viele Termine innerhalb eines Monats. |

<Tip>
  Deine Filter und die gewählte Ansicht werden gespeichert und beim nächsten Besuch automatisch geladen.
</Tip>

## Planer

Im Planer planst du deine Woche: Favorisiere Ressourcen unter Entdecken und sie erscheinen automatisch im Wochenplaner. Von hier aus buchst du in wenigen Klicks deine gesamte Arbeitswoche.

Die Kartenansicht zeigt dir die Räumlichkeiten als interaktiven 3D-Lageplan. Alle grün markierten Ressourcen sind verfügbar und direkt buchbar.

## Buchungen

Unter Buchungen findest du alle deine Reservierungen. Hier kannst du:

* Buchungen einchecken
* Buchungen stornieren
* Buchungen bearbeiten (sofern vom Anbieter aktiviert)

Bei der Bearbeitung kannst du je nach Einstellung den Arbeitsplatz wechseln, Zeit und Datum anpassen oder Zusatzoptionen ändern. Preisänderungen werden automatisch verarbeitet.

Des Weiteren kannst du deine Buchungen einsehen, sowie die anderer Personen oder die, an denen du teilnimmst.

## Weiterführende Themen

<CardGroup>
  <Card title="Nutzerprofil & Einstellungen" icon="user" href="/user-profile-settings">
    Passe dein Profil an, ändere dein Passwort und verwalte Benachrichtigungen.
  </Card>

  <Card title="Lernplatzbuchung" icon="book-open" href="/study-space-booking-intro">
    So buchst du deinen Lernplatz an der Universität.
  </Card>

  <Card title="Arbeitsplatz & Meetingraum" icon="building" href="/einfuehrung-arbeitsplatz-and-meetingraumbuchung">
    Plane deinen Arbeitsplatz und buche Meetingräume.
  </Card>

  <Card title="anny Mobile App" icon="mobile" href="/anny-mobile-app">
    Buche flexibel über dein Smartphone.
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Warum sehe ich die Bearbeiten-Option nicht?">
    Mögliche Gründe: Die Buchungsbearbeitung wurde vom Admin nicht aktiviert, die Änderungsfrist ist abgelaufen, oder die Buchung erfüllt die Voraussetzungen nicht mehr.
  </Accordion>

  <Accordion title="Wie finde ich schnell freie Ressourcen?">
    Nutze im Bereich Entdecken den Datums- und Zeitfilter. Stelle eine exakte Zeit ein oder gib unter Dauer die gewünschte Stundenzahl an, um alle passenden Slots zu sehen.
  </Accordion>

  <Accordion title="Kann ich für andere Personen buchen?">
    Ja, über Connected Persons. Verbinde dich mit Kolleg:innen und buche im Planer oder auf der Ressourcenseite in deren Namen.
  </Accordion>

  <Accordion title="Wie lange bleibt eine Buchung im Warenkorb?">
    Der Warenkorb hält die Auswahl **15 Minuten**. Danach verfällt die Bestellung, und die Zeiten werden wieder frei. Startet im Checkout eine E-Mail-Bestätigung für Gäste, verlängert anny die Frist auf **30 Minuten**.
  </Accordion>
</AccordionGroup>


# Kalenderintegrationen
Source: https://docs.anny.co/calendar-integrations

Vergleiche die Kalender-Integrationen und synchronisiere Buchungen und Termine in Echtzeit mit Outlook, Google und Microsoft 365.

Kalender-Integrationen verbinden anny mit Outlook, Google Kalender, Microsoft 365 oder Google Workspace. Buchungen erscheinen automatisch als Termine im verbundenen Kalender, und Kalendertermine blockieren die Verfügbarkeit deiner Ressourcen in anny. So vermeidest du Doppelbuchungen, ohne zwei Kalender zu pflegen.

<Info>
  Kalender-Integrationen setzen voraus, dass das Feature **Kalendersynchronisation** in deinem Plan enthalten ist. Ohne das Feature erscheinen die Integrationen nicht in deiner Integrationsliste.
</Info>

## Wie funktioniert die Kalendersynchronisation?

Alle vier Integrationen arbeiten als 2-Wege-Synchronisation in Echtzeit. Beim Aktivieren importiert anny zunächst alle zukünftigen Termine und Buchungen. Danach übertragen die Kalenderanbieter jede Änderung sofort an anny und umgekehrt.

Synchronisiert wird der Zeitraum ab heute bis rund 13 Monate in die Zukunft. anny verlängert diesen Zeitraum automatisch jeden Monat. Vergangene Termine und Buchungen werden nicht übertragen.

### Was wird synchronisiert?

| Daten | Richtung | Häufigkeit |
| :- | :- | :- |
| Buchungen werden als Termine angelegt, aktualisiert und entfernt | anny → Kalender | Echtzeit |
| Kalendertermine erscheinen als Blocker oder Buchungen | Kalender → anny | Echtzeit |

In Richtung Kalender überträgt anny nur Buchungen mit blockierendem Status, also bestätigte, angefragte und eingeladene Buchungen. Wird eine Buchung storniert oder abgelehnt, entfernt anny den Termin wieder.

In Richtung anny entstehen aus Kalenderterminen standardmäßig **Blocker**: Sie belegen die Ressource, ohne eine echte Buchung zu erzeugen. Wählst du stattdessen einen **Standardservice für Buchungen**, erstellt anny echte Buchungen inklusive Kund:in und Teilnehmer:innen aus dem Termin. Termine, die im Kalender als „frei" markiert sind, ignoriert anny standardmäßig; als privat markierte Termine werden immer anonymisiert übernommen.

### Unterstützte Integrationen

Wähle die Integration, um Voraussetzungen, Einrichtung und Einschränkungen im Detail zu prüfen.

<Columns>
  <Card title="Outlook" href="/outlook">
    Persönlicher Kalender: verbinde dein Microsoft-Konto direkt mit einer Ressource.
  </Card>

  <Card title="Google Kalender" href="/google">
    Persönlicher Kalender: verbinde dein Google-Konto direkt mit einer Ressource.
  </Card>

  <Card title="Microsoft 365" href="/m365-workspace">
    Workspace: synchronisiere Raum- und Nutzerkalender deines Microsoft-Tenants.
  </Card>

  <Card title="Google Workspace" href="/google-workspace">
    Workspace: synchronisiere die Ressourcenkalender deiner Google Workspace Umgebung.
  </Card>
</Columns>

### Persönliche Kalender oder Workspace-Integration?

**Persönliche Kalender-Integrationen** (Outlook, Google Kalender) richtest du direkt an der Ressource ein: Du meldest dich mit deinem eigenen Konto an und wählst einen Kalender aus. Jede Verbindung koppelt genau einen Kalender mit genau einer Ressource. Das passt, wenn einzelne Personen ihre Verfügbarkeit mit einer Ressource teilen möchten.

**Workspace-Integrationen** (Microsoft 365, Google Workspace) richtet deine IT einmal zentral für die ganze Organisation ein. Danach verbindest du beliebig viele Ressourcen mit den Raum- und Nutzerkalendern eures Unternehmens, ohne dass sich jemand einzeln anmelden muss. Das passt für Meetingräume und geteilte Ressourcen im Unternehmen.

| Integration | Typ | Einrichtung | Verbindungen | Online-Meetings |
| :- | :- | :- | :- | :- |
| [Outlook](/outlook) | Persönlicher Kalender | Anmeldung mit Microsoft-Konto | 1 Kalender pro Ressource | Teams Meeting |
| [Google Kalender](/google) | Persönlicher Kalender | Anmeldung mit Google-Konto | 1 Kalender pro Ressource | Google Meet |
| [Microsoft 365](/m365-workspace) | Workspace | Admin-Einrichtung im Microsoft-Tenant | Mehrere Verbindungen für die Organisation | Online-Meeting |
| [Google Workspace](/google-workspace) | Workspace | Dienstkonto mit domänenweiter Delegierung | Mehrere Verbindungen für die Organisation | Google Meet |

## Wann nutze ich das?

Kalender-Integrationen eignen sich für:

* **Meetingräume:** Räume bleiben buchbar, egal ob Kolleg:innen sie in anny oder direkt im Firmenkalender reservieren.
* **Persönliche Verfügbarkeit:** Deine privaten Termine blockieren automatisch deine buchbare Ressource, ohne dass Kund:innen Details sehen.
* **Doppelbuchungen vermeiden:** Beide Kalender zeigen jederzeit denselben Stand, weil Änderungen sofort übertragen werden.
* **Online-Termine:** Buchungen erhalten auf Wunsch automatisch ein Google Meet oder Teams Meeting.

## Zusammenhang mit anderen Features

Die **Vor- und Nachbereitungszeit** aus den Service-Einstellungen kann auf Wunsch in die Termine übernommen werden, damit der Kalender die volle Belegung zeigt. Über **Aktive Buchungsoptionen auswählen** begrenzt du die Synchronisation auf bestimmte Buchungsoptionen.

In den Buchungsdetails zeigt das Panel **Kalender-Synchronisation**, mit welchem Konto und Kalender eine Buchung verknüpft ist. Das Aktivitätsprotokoll dokumentiert, wann anny Termine erstellt, aktualisiert oder entfernt hat und wann eine Buchung durch den Kalender geändert wurde.

## Einstellungen & Optionen

Diese Einstellungen bieten alle vier Integrationen in ähnlicher Form:

| Einstellung | Beschreibung |
| :- | :- |
| Kalender | Bestimmt, welcher Kalender bzw. welche Workspace-Ressource mit der anny Ressource verbunden wird |
| Aktive Buchungsoptionen auswählen | Synchronisiert nur Buchungen der gewählten Buchungsoptionen |
| Termine als Blocker anlegen | Legt Kalendertermine in anny als Blocker an |
| Standardservice für Buchungen | Erstellt aus Kalenderterminen echte Buchungen mit diesem Service |
| Titel der Termine | Legt fest, wie Termine im Kalender heißen, z. B. Titel der Buchung, Buchungsnummer oder Name der Ressource |
| Titel der Buchungen in anny | Übernimmt den Termintitel oder anonymisiert ihn |
| Vor- und Nachbereitungszeit hinzufügen | Verlängert den Termin um die im Service konfigurierte Vor- und Nachbereitungszeit |
| Alle Ereignisse synchronisieren | Übernimmt auch Termine, die im Kalender als „frei" markiert sind |
| Google Meet / Teams Meeting | Hängt Terminen ein Online-Meeting an, wahlweise nur für ausgewählte Buchungsoptionen |

Die verfügbaren Einstellungen unterscheiden sich im Detail je nach Integration. Prüfe deshalb immer den verlinkten Einzelartikel.

## FAQ

<AccordionGroup>
  <Accordion title="Blockiert jeder Termin aus meinem Kalender die Ressource?">
    Nein. anny übernimmt standardmäßig nur Termine, die im Kalender als „beschäftigt" gelten. Als „frei" markierte Termine werden ignoriert, außer du aktivierst **Alle Ereignisse synchronisieren**.
  </Accordion>

  <Accordion title="Werden private Termine synchronisiert?">
    Ja, aber ohne Inhalt: Als privat markierte Termine erscheinen in anny immer mit anonymisiertem Titel. Zusätzlich kannst du über **Titel der Buchungen in anny** alle übernommenen Termine anonymisieren.
  </Accordion>

  <Accordion title="Entstehen aus Kalenderterminen echte Buchungen?">
    Standardmäßig entstehen Blocker, die nur die Verfügbarkeit belegen. Wählst du einen **Standardservice für Buchungen**, erstellt anny stattdessen echte Buchungen. Bestehende zukünftige Blocker der Verbindung wandelt anny beim Umschalten automatisch um.
  </Accordion>

  <Accordion title="Was passiert beim Deaktivieren oder Löschen der Integration?">
    Deaktivieren pausiert die Synchronisation, vorhandene Termine und Blocker bleiben bestehen. Beim Löschen entfernt anny die erstellten Synchronisierungen auf beiden Seiten. Du wählst dabei, ob alle oder nur zukünftige Synchronisierungen entfernt werden.
  </Accordion>

  <Accordion title="Wie weit in die Zukunft wird synchronisiert?">
    Rund 13 Monate ab heute. anny verlängert den Zeitraum automatisch jeden Monat, du musst nichts tun. Vergangene Termine und Buchungen werden nicht synchronisiert.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ein Termin aus meinem Kalender erscheint nicht in anny">
    Der Termin ist vermutlich als „frei" markiert, liegt in der Vergangenheit oder mehr als 13 Monate in der Zukunft. Prüfe außerdem, ob der Termin im verbundenen Kalender liegt und nicht in einem anderen Unterkalender.
  </Accordion>

  <Accordion title="Eine Buchung erscheint nicht im Kalender">
    Meist filtert die Einstellung **Aktive Buchungsoptionen auswählen** die Buchungsoption heraus oder die Buchung ist nicht bestätigt. Prüfe auch, ob die Verbindung einen Fehler anzeigt: Ein nicht erreichbarer Kalender wird nicht mehr synchronisiert.
  </Accordion>

  <Accordion title="Die Integration hat sich selbst deaktiviert">
    Die Authentifizierung ist fehlgeschlagen, z. B. nach einem Passwortwechsel oder entzogenen Berechtigungen. Melde dich neu an bzw. prüfe die Berechtigungen im Microsoft-Tenant oder Google Workspace und aktiviere die Integration danach wieder über den **Toggle**.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Einordnung:** Dies ist der Übersichtsartikel der Untergruppe „Kalendersynchronisation". Einzelartikel: Outlook (`/outlook`), Google Kalender (`/google`), Microsoft 365 (`/m365-workspace`), Google Workspace (`/google-workspace`). Detaillierte Setup-Anleitungen stehen nur dort.
>
> **UI-Pfade:** Persönliche Kalender: Ressource → Tab **Integrationen** → Abschnitt „Persönliche Kalender-Integrationen" (Buttons „Outlook verbinden" / „Google Kalender verbinden"; Setup-Schritte: „Autorisiere deine Integration" → „Wähle einen Kalender" → „Anpassen der Einstellungen" → „Sync starten"). Workspace-Integrationen: Menüleiste → **Integrationen** → „Microsoft 365" / „Google Workspace"; Verbindungen (Regeln) mit Spalten „Ressource", „Kalender"/„Workspace Ressource", „Buchungsoptionen", „Sync als" (Werte: „Blocker" / „Buchung ()"). Workspace-Einstellungen sind nur bei deaktivierter Integration editierbar.
>
> **Quirks/Präzisierungen:** (1) Sync-Zeitraum: heute 00:00 bis 365+30 Tage voraus, monatliche automatische Verlängerung. (2) Ausgehend synchronisiert werden nur Buchungen mit blockierendem Status (bestätigt, angefragt, eingeladen); der Buchungsoptionen-Filter greift nie für Blocker. (3) Eingehend gilt der Termin-Status: „frei" (Google: „verfügbar"; Microsoft zusätzlich „abwesend") erzeugt standardmäßig keinen Blocker; Statuswechsel auf „frei" löscht den Blocker. (4) Termine, deren Organisator nicht das verbundene Konto ist, werden als schreibgeschützte Blocker angelegt. (5) Ganztägige Termine blockieren 00:00 bis 24:00 Uhr in der Zeitzone der Ressource; Serientermine werden als Einzelinstanzen synchronisiert. (6) Eine Verbindung auf einer übergeordneten Ressource synchronisiert auch Buchungen ihrer Unterressourcen. (7) Duplikat-Schutz: dieselbe Kombination aus Konto/Kalender und Ressource kann nicht doppelt aktiviert werden; Google Kalender ist blockiert, wenn Google Workspace die Ressource schon synchronisiert, Microsoft 365, wenn Outlook sie schon abdeckt. (8) Deaktivieren bestellt nur die Webhooks ab; Reaktivieren startet einen vollständigen Neuabgleich. (9) Löschen bietet die Wahl „Alle Synchronisierungen (einschließlich vergangene)" oder „Nur zukünftige Synchronisierungen" und entfernt von anny erstellte Termine im Kalender sowie aus Terminen erstellte Blocker/Buchungen in anny. (10) Bei Authentifizierungsfehlern deaktiviert sich die Integration selbst und benachrichtigt Admins; Fehler auf einzelnen Verbindungen stoppen nur die Synchronisation dieses Kalenders. (11) Beim Umschalten von Blockern auf einen Standardservice wandelt anny nur zukünftige Blocker in Buchungen um; Kund:in wird aus dem Termin-Organisator erzeugt, Termin-Gäste werden Teilnehmer:innen.
>
> **Abgrenzung:** Keine Kalender-Integrationen sind: „Externe Kalender" (ICS-Abo, nur lesend) und „Geteilte Kalender" auf der Ressourcen-Seite, das Outlook Add-In (`/outlook-add-in`), die MS Teams App (`/ms-teams-app`) sowie die Video-Meeting-Integrationen Zoom/MS Teams (eigene Artikel). Die Optionen Google Meet / Teams Meeting innerhalb der Kalender-Integrationen funktionieren unabhängig von den Video-Meeting-Integrationen.
>
> **Beziehungen:** Alle vier Integrationen hängen am Plan-Feature „Kalendersynchronisation" (integrations-calendar-sync); die konkrete Plan-Zuordnung ist nicht dokumentiert. Aktivitätsprotokoll-Texte: „Es wurde ein Termin für diese Buchung erstellt/aktualisiert/entfernt", „Diese Buchung wurde durch die … Integration geändert". Buchungsdetails-Panel „Kalender-Synchronisation" mit „Name des Accounts", „Name des Kalenders", Quelle („Das Kalenderereignis wurde aufgrund dieser Buchung erstellt." / „Die Buchung wurde aufgrund des Kalenderereignisses erstellt.") und Aktion „Ereignis im externen Kalender anzeigen".


# Los Geht's – Ticketing & Events (Check-In)
Source: https://docs.anny.co/check-in-ticketing-events

Nutze QR-Code-Tickets für den Einlass bei Events, Workshops und Kursen mit automatischer Anwesenheitskontrolle.

Mit diesem Guide richtest du einen Ticket-basierten Check-in für Events, Workshops oder Kurse ein. Am Ende erhalten Teilnehmer:innen bei der Buchung ein QR-Code-Ticket, das am Einlass gescannt wird, und du hast jederzeit Übersicht über die Anwesenheit.

## Ticketing und Events im anny Kontext denken

Beim Ticketing bildet anny den Einlassprozess digital ab. Das zentrale Prinzip: Jedes **Event** oder jeder **Kurs** ist eine **Ressource** mit begrenzter Kapazität, jedes verkaufte Ticket eine **Buchung** mit QR-Code, und das **Check-In Terminal** am Einlass prüft die Gültigkeit.

| anny Konzept | Bedeutung beim Ticketing |
| - | - |
| Ressource | Ein Veranstaltungsort, Raum oder Bereich (z. B. "Saal A") |
| Buchungsoption | Ein Tickettyp (z. B. "Standard-Ticket", "VIP-Ticket", "Workshop-Platz") |
| Mehrfach verfügbar | Maximale Teilnehmerkapazität |
| QR-Code-Ticket | Bestätigung mit Scancode, die Teilnehmer:innen bei der Buchung erhalten |
| Check-In App | Terminal oder Handscanner am Einlass |

Teilnehmer:innen buchen über den **Buchungsbereich** (Buchungsseite, Widget oder App). Du verwaltest alles im **Adminbereich** (Ressourcen, Buchungen, Displays, Auslastung).

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressource anlegen">
    Öffne **Ressourcen** und erstelle eine Ressource für den Veranstaltungsort (z. B. "Saal A" oder "Workshop-Raum"). Stelle unter **Verfügbarkeit** auf **Mehrfach verfügbar** und setze die Anzahl auf die maximale Teilnehmerkapazität. Aktiviere unter **Check-In** den Check-in.
  </Step>

  <Step title="Buchungsoption erstellen">
    Erstelle eine oder mehrere Buchungsoptionen als Tickettypen (z. B. "Standard-Ticket" mit fester Dauer nach Zeitplan). Konfiguriere den Preis (kostenlos oder kostenpflichtig) und stelle **Alle Buchungen automatisch annehmen** ein.
  </Step>

  <Step title="Formulare für Teilnehmerdaten konfigurieren (optional)">
    Wenn du Teilnehmerdaten erst beim Einlass abfragen möchtest (z. B. Ernährungswünsche beim Workshop-Catering), erstelle ein [Eigenes Formular](/custom-forms) und setze den Abfragezeitpunkt auf **Später (beim Check-in)**.
  </Step>

  <Step title="Terminal einrichten">
    Richte ein Check-In Terminal gemäß [Check-In Terminal einrichten](/check-in-setup) ein. Wähle als Modus **Check-In**. Für Events mit freiem Eintritt und Laufpublikum alternativ: **Personalisierte Registrierung und Check-In**, damit sich Teilnehmer:innen auch spontan vor Ort registrieren können.
  </Step>

  <Step title="Check-In Zeitraum festlegen">
    Konfiguriere unter **Ressource** > **Check-In** den **Check-In Zeitraum** (z. B. ab 30 Minuten vor Eventbeginn). So wird der Einlass erst kurz vor dem Event geöffnet.
  </Step>

  <Step title="Testen">
    Erstelle eine Testbuchung, prüfe ob das QR-Code-Ticket per E-Mail verschickt wird, und scanne es am Terminal. Prüfe, ob der Check-in bestätigt und die Kapazität korrekt reduziert wird.
  </Step>
</Steps>

<Tip>
  Für Events mit unterschiedlichen Ticketkategorien (z. B. Standard und VIP) erstelle separate Buchungsoptionen mit unterschiedlichen Preisen oder Kontingenten auf derselben Ressource.
</Tip>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Workshop mit begrenzten Plätzen und Vorab-Buchung">
    Ein Workshop-Anbieter verkauft 30 Plätze online. Am Eventtag scannen Teilnehmer:innen ihr QR-Ticket am Eingang.

    <Steps>
      <Step title="Ressource und Buchungsoption">
        Ressource "Workshop-Raum" mit 30 Plätzen (Mehrfach verfügbar: 30). Buchungsoption "Workshop-Ticket" mit fester Dauer nach Zeitplan, Preis z. B. 49 Euro, automatisch annehmen.
      </Step>

      <Step title="Terminal-Modus">
        Modus: **Check-In**. Nur Teilnehmer:innen mit gültigem QR-Code-Ticket können einchecken. Kein spontaner Einlass.
      </Step>

      <Step title="Formular beim Check-in">
        Optional: Ernährungswünsche als Eigenes Formular mit Abfragezeitpunkt "Später (beim Check-in)" konfigurieren, damit die Angabe erst am Einlass erfolgt.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Offenes Event mit Registrierung vor Ort">
    Ein Community-Event bietet freien Eintritt. Teilnehmer:innen können vorab online buchen oder sich spontan am Einlass registrieren.

    <Steps>
      <Step title="Ressource und Buchungsoption">
        Ressource "Veranstaltungssaal" mit 200 Plätzen. Buchungsoption "Freier Eintritt" mit fester Dauer nach Zeitplan, kostenlos, automatisch annehmen.
      </Step>

      <Step title="Terminal-Modus">
        Modus: **Personalisierte Registrierung und Check-In**. Teilnehmer:innen mit Buchung scannen ihren QR-Code, spontane Gäste geben ihre E-Mail ein und werden vor Ort registriert.
      </Step>

      <Step title="Kapazität in Echtzeit">
        Das Dashboard zeigt dir live, wie viele Plätze noch frei sind. Ist die Kapazität erreicht, werden keine weiteren Registrierungen am Terminal zugelassen.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen und Optionen

<CardGroup>
  <Card title="Dynamisches Pricing">
    Staffele Ticketpreise nach Frühbucher-Rabatt, Gruppengröße oder Zeitpunkt und optimiere so deinen Ticketverkauf automatisch.

    [Erfahre hier mehr](/dynamic-pricing)
  </Card>

  <Card title="Eigene Formulare beim Check-in">
    Frage Teilnehmerdaten wie Ernährungswünsche, Allergien oder T-Shirt-Größe erst beim Einlass ab, nicht schon bei der Buchung.

    [Erfahre hier mehr](/custom-forms)
  </Card>

  <Card title="Rechtliche Dokumente beim Check-in">
    Lass Haftungsausschlüsse oder Teilnahmebedingungen erst am Einlass per Checkbox oder digitaler Unterschrift bestätigen.

    [Erfahre hier mehr](/legal-documents)
  </Card>

  <Card title="Buchungscodes und Pakete">
    Biete Mehrfachtickets, Wertgutscheine oder Gruppenpakete für Veranstaltungsreihen an.

    [Erfahre hier mehr](/booking-codes)
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich verhindern, dass ein Ticket mehrfach gescannt wird?">
    Ja. Standardmäßig ist ein QR-Code nur einmal gültig. Erst wenn du Mehrfach Check-In in den Ressourceneinstellungen aktivierst, kann ein Ticket wiederholt gescannt werden.
  </Accordion>

  <Accordion title="Wie gehe ich mit verschiedenen Ticketkategorien um?">
    Erstelle pro Kategorie eine eigene Buchungsoption auf derselben Ressource (z. B. "Standard" und "VIP"). Jede Kategorie kann einen eigenen Preis und ein eigenes Kontingent haben.
  </Accordion>

  <Accordion title="Kann ich den Einlass zeitlich begrenzen?">
    Ja. Konfiguriere den Check-In Zeitraum unter Ressource, Check-In. Der Einlass wird erst innerhalb dieses Zeitfensters geöffnet.
  </Accordion>

  <Accordion title="Was passiert, wenn die Kapazität erreicht ist?">
    Sobald alle Plätze belegt sind, können keine weiteren Buchungen oder Registrierungen am Terminal vorgenommen werden. Online ist die Buchungsoption ebenfalls als ausgebucht markiert.
  </Accordion>

  <Accordion title="Kann ich Teilnehmer:innen nachträglich manuell einchecken?">
    Ja. Öffne die Buchung im Adminbereich und führe den Check-in direkt in den Buchungsdetails durch.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Ressource: Veranstaltungsort/Raum, Verfügbarkeit auf "Mehrfach verfügbar" (Anzahl = Kapazität)
> * Buchungsoption: Tickettyp, Dauer nach Zeitplan für feste Eventtermine, Preis frei konfigurierbar
> * Modi für Ticketing: "Check-In" (nur mit Ticket) oder "Personalisierte Registrierung und Check-In" (Ticket + spontane Registrierung)
> * Check-In Zeitraum: steuert, wann der Einlass geöffnet wird (z. B. 30 Min. vor Start)
> * Mehrfach Check-In: standardmäßig deaktiviert (Ticket nur einmal gültig), bei Bedarf aktivieren
> * Verzögerte Formularabfrage: Eigene Formulare und Rechtliche Dokumente können auf "Später (beim Check-in)" gesetzt werden
> * Verschiedene Ticketkategorien: separate Buchungsoptionen auf derselben Ressource
> * Verwandte Artikel: /check-in-allgemeine-informationen, /check-in-setup, /custom-forms, /legal-documents, /dynamic-pricing, /booking-codes


# Los Geht's – Universitätsbibliothek (Check-In)
Source: https://docs.anny.co/check-in-university

Richte Lernplatzbuchung mit Check-In Terminal, Kapazitätssteuerung und Vor-Ort-Registrierung für Bibliotheken ein.

Mit diesem Guide richtest du ein Selbstbedienungsterminal für deine Universitätsbibliothek ein. Am Ende können Studierende per QR-Code einchecken, sich spontan vor Ort registrieren, und ungenutzte Plätze werden automatisch wieder freigegeben.

## Universitätsbibliothek im anny Kontext denken

Bei der Lernplatzverwaltung bildet anny die physische Bibliotheksstruktur digital ab. Das zentrale Prinzip: Jeder **Lesesaal** oder **Bereich** ist eine **Ressource** mit begrenzter Kapazität, und das **Check-In Terminal** steuert die Anwesenheit in Echtzeit.

| anny Konzept | Bedeutung in der Bibliothek |
| - | - |
| Ressource | Ein Lesesaal, ein Bereich oder eine Etage (z. B. "Lesesaal 2. OG") |
| Buchungsoption | Ein Buchungstyp (z. B. "Lernplatz Halbtag" oder "Lernplatz flexibel") |
| Mehrfach verfügbar | Anzahl der gleichzeitig verfügbaren Lernplätze |
| Check-In App | Terminal am Eingang zum Ein- und Auschecken |
| Kapazität freigeben | Nach Check-Out wird der Platz sofort für andere Studierende buchbar |

Studierende buchen über den **Buchungsbereich** (Web oder App) oder registrieren sich spontan am Terminal. Du verwaltest alles im **Adminbereich** (Ressourcen, Buchungen, Displays, Auslastung).

## Schritt-für-Schritt Einrichtung

<Steps>
  <Step title="Ressource anlegen">
    Öffne **Ressourcen** und erstelle eine Ressource für den Bibliotheksbereich (z. B. "Lesesaal Hauptgebäude"). Stelle unter **Verfügbarkeit** auf **Mehrfach verfügbar** und setze die Anzahl auf die verfügbaren Lernplätze. Aktiviere unter **Check-In** den Check-in für diese Ressource.
  </Step>

  <Step title="Check-In Einstellungen konfigurieren">
    Unter **Ressource** → **Check-In**: Aktiviere **Kapazität freigeben**, damit nach einem Check-Out der Platz sofort wieder buchbar wird. Aktiviere **Mehrfach Check-In**, falls Studierende den Bereich kurz verlassen und zurückkehren dürfen. Setze optional eine **Minimum Check-In Zeit** (z. B. 30 Minuten), um vorzeitige Check-Outs zur Kontingent-Optimierung zu verhindern.
  </Step>

  <Step title="Buchungsoption erstellen">
    Erstelle eine Buchungsoption (z. B. "Lernplatz flexibel" mit flexibler Dauer oder "Lernplatz Halbtag" mit fester Dauer). Stelle sicher: **kostenlos**, **alle Buchungen automatisch annehmen**.
  </Step>

  <Step title="Check-In und Check-Out getrennt steuern">
    Deaktiviere den selbstständigen **Check-In** in den Ressourceneinstellungen, sodass ein Check-In nur am Terminal vor Ort möglich ist (kontrollierte Anwesenheitsprüfung). Erlaube einen flexiblen, selbstständigen **Check-Out** durch Studierende über die mobile App oder Web-Anwendung, um Schlangen am Ausgang zu vermeiden.
  </Step>

  <Step title="Terminal einrichten">
    Richte ein Check-In Terminal gemäß [Check-In Terminal einrichten](/check-in-setup) ein. Wähle den passenden Modus:

    * **Check-In & Check-Out**: Nur vorangemeldete Studierende (mit Buchung) können ein- und auschecken.
    * **Personalisierte Registrierung, Check-In & Check-Out**: Vorangemeldete und spontane Studierende können sich registrieren, einchecken und auschecken.
  </Step>

  <Step title="Mehrere Terminals aufstellen (optional)">
    Stelle separate Terminals für Ein- und Ausgang auf: Ein Terminal im Modus **Check-In** am Eingang, ein Terminal im Modus **Check-Out** am Ausgang. Beide werden mit der gleichen Ressource verbunden.
  </Step>

  <Step title="Testen">
    Erstelle eine Testbuchung, checke am Eingangs-Terminal ein und prüfe, ob die Kapazität korrekt reduziert wird. Checke anschließend aus und prüfe, ob der Platz wieder freigegeben wird.
  </Step>
</Steps>

<Tip>
  Mit der getrennten Steuerung von Check-In (nur am Terminal) und Check-Out (flexibel per App) vermeidest du Schlangen am Ausgang und behältst trotzdem die Kontrolle über die Anwesenheit.
</Tip>

## Typische Beispiele

<AccordionGroup>
  <Accordion title="Bibliothek mit reinem Voranmeldungs-System">
    Eine Universitätsbibliothek möchte, dass Studierende ausschließlich mit vorheriger Online-Buchung einen Lernplatz nutzen können. Spontane Besuche ohne Buchung sind nicht erlaubt.

    <Steps>
      <Step title="Ressource und Buchungsoption">
        Ressource "Lesesaal" mit 200 Plätzen (Mehrfach verfügbar: 200), Buchungsoption "Lernplatz" mit flexibler Dauer, kostenlos, automatisch annehmen.
      </Step>

      <Step title="Terminal-Modus">
        Modus: **Check-In & Check-Out**. Nur Studierende mit gültigem QR-Code-Ticket können einchecken.
      </Step>

      <Step title="Kapazität freigeben">
        Aktiviere **Kapazität freigeben**, damit No-Shows und frühe Check-Outs sofort wieder Plätze freigeben.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Bibliothek mit Vor-Ort-Registrierung und Online-Buchung">
    Eine Bibliothek möchte sowohl Online-Buchungen als auch spontane Registrierungen am Terminal ermöglichen, um die Auslastung zu maximieren.

    <Steps>
      <Step title="Ressource und Buchungsoption">
        Ressource "Lesesaal" mit 150 Plätzen, Buchungsoption "Lernplatz flexibel" mit flexibler Dauer, kostenlos, automatisch annehmen.
      </Step>

      <Step title="Terminal-Modus">
        Modus: **Personalisierte Registrierung, Check-In & Check-Out**. Studierende mit Buchung scannen ihren QR-Code, spontane Besucher:innen geben ihre E-Mail ein und werden vor Ort registriert.
      </Step>

      <Step title="Getrennte Ein-/Ausgänge">
        Ein Terminal am Eingang (Modus: **Personalisierte Registrierung & Check-In**), ein Terminal am Ausgang (Modus: **Check-Out**). Alternativ: Check-Out über die mobile App erlauben.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Weitere Einstellungen & Optionen

<CardGroup>
  <Card title="Buchungen pro Startzeit">
    Begrenze die Ankünfte pro Zeitslot, um Ansturm am Terminal zu entlasten und den Einlass zu staffeln (z. B. max. 50 Check-Ins pro halbe Stunde).

    [Erfahre hier mehr](/check-in-overview)
  </Card>

  <Card title="Communities">
    Beschränke die Lernplatzbuchung auf bestimmte Gruppen (z. B. nur eingeschriebene Studierende) und steuere den Zugang über Community-Mitgliedschaft.

    [Erfahre hier mehr](/communities)
  </Card>

  <Card title="Eigene Formulare beim Check-in">
    Frage zusätzliche Daten (z. B. Matrikelnummer, Fachbereich) erst beim Check-in ab, statt im Buchungsprozess.

    [Erfahre hier mehr](/custom-forms)
  </Card>

  <Card title="Globale Buchungsregeln">
    Definiere übergreifende Regeln für Buchungslimits, z. B. maximale Buchungen pro Person und Tag oder Woche, um faire Platzverteilung sicherzustellen.

    [Erfahre hier mehr](/booking-rules)
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Wie verhindere ich No-Shows?">
    Aktiviere **Kapazität freigeben** in den Check-In-Einstellungen der Ressource. Wenn Studierende nicht einchecken, wird der Platz nach Ablauf des Check-In-Zeitraums automatisch wieder freigegeben.
  </Accordion>

  <Accordion title="Kann ich Check-In nur am Terminal und Check-Out über die App erlauben?">
    Ja. Deaktiviere den selbstständigen Check-In in den Ressourceneinstellungen (Check-In nur am Terminal) und erlaube den flexiblen Check-Out über App oder Web.
  </Accordion>

  <Accordion title="Können Studierende sich spontan einen Platz sichern?">
    Ja, wenn der Terminal-Modus "Personalisierte Registrierung" enthält. Studierende ohne vorherige Buchung können sich am Terminal registrieren und sofort einchecken.
  </Accordion>

  <Accordion title="Kann ich verschiedene Bereiche mit unterschiedlichen Terminals abdecken?">
    Ja. Erstelle pro Bereich eine eigene Ressource und verbinde jeweils ein Terminal damit. Alternativ können mehrere Terminals mit derselben Ressource verbunden werden.
  </Accordion>

  <Accordion title="Wie setze ich eine Mindest-Check-In-Zeit?">
    Konfiguriere unter **Ressource** → **Check-In** eine Minimum Check-In Zeit (z. B. 30 Minuten). Damit wird ein Check-Out erst nach Ablauf dieser Zeit akzeptiert.
  </Accordion>
</AccordionGroup>

Viel Erfolg bei der Einrichtung! 🥳

> Wichtige Informationen für Agenten:
>
> * Ressource: Lesesaal/Bereich, Verfügbarkeit auf "Mehrfach verfügbar" (Anzahl = Lernplätze)
> * Buchungsoption: kostenlos, automatisch annehmen, flexible oder feste Dauer
> * Check-In Einstellungen (Ressource → Check-In): Kapazität freigeben, Mehrfach Check-In, Minimum Check-In Zeit
> * Getrennte Steuerung: Check-In nur am Terminal (selbstständiger Check-In deaktivieren), Check-Out flexibel per App/Web (selbstständiger Check-Out erlauben)
> * Modi für Bibliotheken: "Check-In & Check-Out" (nur mit Buchung) oder "Personalisierte Registrierung, Check-In & Check-Out" (mit Vor-Ort-Registrierung)
> * Mehrere Terminals: Check-In am Eingang, Check-Out am Ausgang, gleiche Ressource
> * Windows Desktop App: Download unter cdn.anny.co/apps/checkin-app/latest-windows-setup.exe, Interaktion deaktivieren für PC ohne Touch
> * Verwandte Artikel: /check-in-overview, /check-in-setup, /custom-forms, /exklusive-zeitfenster


# ClassPass mit anny verbinden
Source: https://docs.anny.co/class-pass

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. Die Standort-ID stammt aus deiner Organisation. Die Partner-ID vergibt anny beim Anlegen der Integration; bei älteren Integrationen erzeugst du sie einmalig über **Partner-ID generieren**. Sie bleibt danach stabil, auch wenn sich deine Organisationsstruktur ändert.

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
* 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 bei ClassPass registrieren">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **ClassPass**. Oben steht das Panel **Bei ClassPass registrieren**. Kopiere die vorbereitete **Registrierungsnachricht** (sie enthält deine **Partner-ID** und **Standort-ID**) und sende sie an ClassPass: als bestehender Partner über das **ClassPass Partner Dashboard** (Tab Integrations, Plattform anny) oder während des Onboardings über das Formular aus den ClassPass-Mails bzw. an `launch@classpass.com`. Der Status im Panel wechselt von *Noch keine Anfragen von ClassPass* zu *ClassPass ruft deine Daten ab — die Registrierung ist abgeschlossen*, sobald ClassPass deine Daten abruft.
  </Step>

  <Step title="Partner-Einstellungen prüfen">
    In den **Partner-Einstellungen** findest du deine **Partner-ID**. Fehlt sie bei einer älteren Integration, klicke auf **Partner-ID generieren**. Kopiere den Wert aus diesem Feld, wenn du ihn an ClassPass weitergibst. **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. Ü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.

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Partner-ID | Kennung gegenüber ClassPass. Wird beim Anlegen der Integration vergeben. Bei älteren Integrationen einmalig über **Partner-ID generieren**. Bleibt danach stabil, auch wenn sich die Organisationsstruktur ändert. **Partner-ID neu generieren** löscht die aktuelle ID: ClassPass erkennt die Integration unter der alten ID nicht mehr. |
| 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.
* **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.
* **Duplizieren des ClassPass-Services:** Den automatisch erstellten **Service für ClassPass-Buchungen** kannst du nicht duplizieren.

## 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 deine **Partner-ID** aus den **Partner-Einstellungen** und deine **Standort-ID** aus den **Standort-Einstellungen** mit. Die **Registrierungsnachricht** im Panel **Bei ClassPass registrieren** kannst du als Vorlage nutzen.
  </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="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>
</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: **Bei ClassPass registrieren** (Statusbox pending/registered, Schritte, **Registrierungsnachricht**, Copy-Button; die Nachricht interpoliert weiterhin `integration.id`, nicht die Partner-ID-Sync; Standort-ID = `organization.external_id`; Endpoint `registration-status`), **Partner-Einstellungen** (Felder „Partner-ID" (read-only nach Generate, sonst Button **Partner-ID generieren**), **Partner-ID neu generieren** mit Confirm, „Partnername", „Partnerbeschreibung"; Endpoints `GET/POST …/partner-id`, `POST …/partner-id/regenerate`), **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". Unvollständige Setup-Panels öffnen sich automatisch; vollständige zeigen einen Haken und sind zugeklappt.
>
> **Quirks:** (1) Identifikatoren: Partner-ID = `class_pass_partner_id` ModelSync (`ClassPass::partnerIdFor`), nicht mehr die Integrations-UUID (außer Fallback für Integrationen ohne Sync). Neue Integrationen bekommen die ID in `created()`. Generate übernimmt die ID einer Sibling-Integration derselben Master-Org, sonst eine frische UUID. Regenerieren löscht den Sync und vergibt neu (ClassPass erkennt die alte ID nicht mehr). 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. Die Registrierungsnachricht in `ClassPassRegistration.vue` nutzt noch `integration.id` — die verbindliche ID steht in den Partner-Einstellungen. `POST /services/{id}/duplicate` auf `is_protected` wirft `service_is_protected`. Der Registrierungsstatus kommt von `GET …/registration-status` (`registered`, `first_polled_at`, `last_polled_at`). Weiter: Kurs-/Termin-Kennungen = numerische IDs der Ressourcen und Leistungen (als String), Termin-Kennung eines Kurses = interne Zeitfenster-Kennung. Slugs sind weder Pflicht noch gesperrt. ClassPass-Buchungsanfragen mit altem Slug statt numerischer ID → `BOOKABLE_NOT_FOUND` / `SERVICE_NOT_FOUND`. Das Wechseln der Trainer-Kategorien setzt den Standard-Trainer zurück. (2) Aktivierungsprüfungen: Ressource doppelt in Kurs- bzw. Termin-Regeln → „Resource doppelt ausgewählt"; leere oder unauflösbare 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.


# Comydo mit anny verbinden
Source: https://docs.anny.co/comydo

Automatisiere QR-Code-Zutritte und kennzeichenbasierte Zufahrten für Buchungen mit Comydo.

[Comydo](https://comydo.com/) ist ein digitales Zutrittssystem für Türen, Tore und Schranken, das QR-Codes und Kennzeichen als Schlüssel nutzt. Mit der Integration automatisiert anny den passenden Zutritt für Buchungen und Community-Mitglieder.

Mit Comydo kannst du in anny:

* Zeitlich begrenzte QR-Code-Zugänge für Buchungen erstellen
* Ressourcen und Communities mit einer oder mehreren Comydo-Geräte-IDs verknüpfen
* Den Zugang vor und nach der Buchung um eine Pufferzeit erweitern
* Parkplatzschranken per Kennzeichen öffnen und optional beim ersten Scan ein- und beim zweiten Scan auschecken

Die Integration passt besonders zu Räumen, Gemeinschaftsflächen und Parkplätzen, bei denen der Zutritt ohne manuelle Schlüsselübergabe funktionieren soll.

<Info>
  Verfügbar ab dem Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| - | - |
| Räume per QR-Code öffnen | **Zutritt passend zur Buchung.** Kund:innen erhalten einen QR-Code in der anny App oder Buchungsbestätigung und scannen ihn am Comydo-Gerät. |
| Community-Mitglieder freischalten | **Mitgliedsbasierte Zutritte verwalten.** Verknüpfe eine Community mit einem oder mehreren Comydo-Zugängen. |
| Parkplätze per Kennzeichen öffnen | **Automatische Einfahrt ohne Ticket.** Comydo erkennt das bei der Buchung erfasste Kennzeichen und öffnet die verknüpfte Schranke. |

## Wie die Comydo-Verbindung funktioniert

Die Einrichtung besteht aus zwei Teilen. Zuerst trägst du in anny deinen **Auth-Key** ein, den du in der Comydo-Admin-App findest. Danach zeigt anny eine **Webhook-URL** an, die du im Comydo-Admin-Bereich hinterlegst. Anschließend definierst du Regeln, die Ressourcen oder Communities mit Comydo-Geräten verknüpfen.

Bei einer passenden Buchung erstellt anny einen zeitlich begrenzten Zugang und speichert ihn selbst: das Buchungsticket als QR-Code oder, bei Parkplätzen, einen verschlüsselten Prüfwert des Kennzeichens. Kund:innen erhalten den QR-Code in der anny App oder Buchungsbestätigung.

Scannt jemand am Comydo-Gerät, fragt Comydo über die Webhook-URL bei anny an. anny prüft die gespeicherten Zugänge und antwortet, ob der Zutritt gültig ist. anny sendet also keine Buchungsdaten oder Kennzeichen an Comydo, sondern bestätigt jeden Scan einzeln.

Wird die Verbindung deaktiviert oder gelöscht, bestätigt anny keine Zutritte mehr über Comydo.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Zutrittsanfrage bei einem Scan (Geräte-ID und gescannter Code) | Comydo → anny | Bei jedem Scan an einem Comydo-Gerät |
| Zutrittsbestätigung (gültig oder nicht gültig) | anny → Comydo | Als Antwort auf jede Anfrage |

## Comydo verbinden

### Voraussetzungen

Bevor du Comydo verbindest, stelle sicher, dass:

* dein Comydo-Zugang eingerichtet ist und die benötigten Türen oder Schranken mit ihren Geräte-IDs im Comydo-Portal angelegt sind,
* deine Ressourcen oder Communities in anny eingerichtet sind,
* für QR-Code-Zutritte die **Check-In-Funktion** der Ressource aktiviert ist, denn das Buchungsticket wird für den Eintritt gescannt,
* du bei Parkplatzbuchungen ein benutzerdefiniertes Formularfeld für das Kennzeichen verwendest, das als **Pflichtfeld** abgefragt wird,
* du deinen **Auth-Key** aus der Comydo-Admin-App zur Hand hast.

### Verbindung einrichten

<Steps>
  <Step title="Auth-Key eintragen">
    Öffne aus der **Menüleiste** die **Integrationen** und gehe zu **Comydo**. Trage deinen **Auth-Key** aus der Comydo-Admin-App ein und speichere ihn. Danach zeigt anny die **Webhook-URL** an. Kopiere sie und hinterlege sie im Comydo-Admin-Bereich, damit Comydo jeden Scan bei anny bestätigen kann.
  </Step>

  <Step title="Konfigurieren">
    Lege die benötigten Regeln an:

    1. Klicke auf **Hinzufügen**.
    2. Wähle eine Ressource oder Community aus.
    3. Trage eine oder mehrere **Geräte-IDs** deiner Comydo-Geräte ein.
    4. Lege bei Buchungsregeln **Zugang vor der Buchung** und **Zugang nach der Buchung** fest.
    5. Aktiviere bei einer Parkplatzregel die **Kennzeichenerkennung** und wähle das **Benutzerdefinierte Feld für Kennzeichen** aus.
    6. Aktiviere bei Bedarf **Beim ersten Scan einchecken** und **Beim zweiten Scan auschecken**.
    7. Erstelle eine Testbuchung und prüfe den vollständigen Zutrittsablauf.
  </Step>
</Steps>

Das Bild zeigt den Bereich der Comydo-Integration, in dem du die Webhook-Verbindung einrichtest.

<Frame>
  ![Comydo-Integration mit Webhook-Einstellungen](https://downloads.intercomcdn.eu/i/o/niegcmk9/69658451/469102e8a654cb2ec41bf1f5cdf6/Frame+31+%2810%29.png?expires=1785256200\&signature=5f0ea22b3d91dac4600bee0311bbfb67fa34ef750d08a8417f7f1ef6cdf6e517\&req=1txpwFD%2BqTZk2hL085ZhoXo7ejC4mK0%2FRDAOUyGzQyR3%2FPd0Eny9FTgdFG7c%0AX1mVzkfJjWrECtzM%0A)
</Frame>

Das erste Bild zeigt eine Regel für Buchungszugänge. Das zweite Bild zeigt die erweiterten Einstellungen einer Regel. Das dritte Bild zeigt die Zuordnung von Community-Mitgliedern.

<Frame>
  ![Comydo-Regel für Zugänge durch Buchungen](https://downloads.intercomcdn.eu/i/o/niegcmk9/69656306/855f4c81703cc35b945dbe5738c1/Frame-2B10-284-29.png?expires=1785256200\&signature=1111a7b3f25bf9d17fa9eb97502d61c86b074ce3c240b69876bb946c4b036a79\&req=1txpwF75rDFk2hL085ZhoY7NUYerqq%2BrLVBK0GyMSHDN59lR%2Fys1OW5M3OoA%0ARSWn%2F%2FjzamgNWMd8%0A)
</Frame>

<Frame>
  ![Erweiterte Einstellungen einer Comydo-Regel](https://downloads.intercomcdn.eu/i/o/niegcmk9/69656304/e2a16a782f516367210e98dcc3d5/Frame-2B10-2B--2B2025-01-16T172911_733.png?expires=1785256200\&signature=39f8e3de0240a5f041a4985bc1fd0d6ed53de558dcfc8804f3a2ef05a6f37b10\&req=1txpwF75rDNk2hL085ZhoWRFnm5qWDaSlm5giftKTYgveA67Lv3UMgaUOhw8%0AugVAdV%2BERy2F9D%2BK%0A)
</Frame>

<Frame>
  ![Comydo-Regel für Zugänge durch Communities](https://downloads.intercomcdn.eu/i/o/niegcmk9/69656305/094d17725c189be2f08f88d33496/Frame-2B10-285-29.png?expires=1785256200\&signature=51e35d5c99aa26d8df4c6bd441d88f484990b207cc17c44b6766ff08ff26e497\&req=1txpwF75rDJk2hL085ZhodksOcqBgRT15QM30ai0XV5AMRvAUuEAr7EzvUPI%0Ak8ObUwUQMzGNCXt6%0A)
</Frame>

Sobald die Verbindung aktiv ist und eine Regel greift, erstellt anny automatisch den passenden Zutritt für neue Buchungen oder Community-Mitglieder.

<Tip>
  Du kannst mehrere Comydo-Geräte in einer Regel zuordnen. Pro Ressource ist aber nur eine Buchungsregel möglich. Bestehende Regeln bearbeitest oder löschst du über die **drei Punkte** rechts neben der Regel.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Ressource | Bestimmt, welche Buchung einen Zugang erstellt. Pro Ressource ist eine Buchungsregel möglich. |
| Community | Gewährt Mitgliedern der ausgewählten Community Zugang zu den verknüpften Geräten. |
| Geräte-IDs | Geräte-IDs der Comydo-Türen, -Tore oder -Schranken, die durch die Regel freigeschaltet werden. |
| Zugang vor der Buchung | Zeitraum vor Buchungsbeginn, in dem der Zugang bereits gültig ist. |
| Zugang nach der Buchung | Zeitraum nach Buchungsende, in dem der Zugang noch gültig bleibt. |
| Kennzeichenerkennung | Aktiviert für Parkplatzregeln den Zutritt per Kennzeichen. |
| Benutzerdefiniertes Feld für Kennzeichen | Legt fest, aus welchem Buchungsfeld das Kennzeichen gelesen wird. |
| Beim ersten Scan einchecken | Checkt die Buchung automatisch ein, wenn das Kennzeichen zum ersten Mal gescannt wird (Einfahrt). |
| Beim zweiten Scan auschecken | Checkt die Buchung automatisch aus, wenn das Kennzeichen erneut gescannt wird (Ausfahrt). Ein zweiter Scan innerhalb von 5 Minuten nach dem Check-in wird ignoriert. |

### Parkplatzbuchungen und Schranken

Für eine Schrankenöffnung per Kennzeichen müssen Buchung, Kennzeichenfeld und Comydo-Regel sauber zusammenspielen.

<Steps>
  <Step title="Kennzeichen erfassen">
    Füge dem Buchungsformular der Parkplatz-Ressource ein benutzerdefiniertes Formularfeld für das Kennzeichen hinzu und markiere es als **Pflichtfeld**. Ist das Feld nicht als Pflichtfeld gesetzt oder fehlt es in einem Service der Ressource, lässt sich die Regel nicht speichern.
  </Step>

  <Step title="Feld zuordnen">
    Öffne die passende Comydo-Regel, aktiviere die **Kennzeichenerkennung** und wähle unter **Benutzerdefiniertes Feld für Kennzeichen** das Kennzeichenfeld aus. Nur das zugeordnete Feld wird ausgewertet.
  </Step>

  <Step title="Scan-Logik wählen">
    Aktiviere bei Bedarf **Beim ersten Scan einchecken** und **Beim zweiten Scan auschecken**. Nutze diese Optionen, wenn die tatsächliche Nutzungszeit statt nur der geplanten Buchungszeit erfasst werden soll.
  </Step>

  <Step title="Ablauf testen">
    Erstelle eine Testbuchung mit Kennzeichen. Prüfe die Einfahrt und bei aktiviertem Check-out auch die Ausfahrt.
  </Step>
</Steps>

Sobald ein zur Buchung passendes Kennzeichen gescannt wird, bestätigt anny den Zutritt und die Schranke kann öffnen. Bei aktivierter Scan-Logik checkt anny die Buchung beim ersten Scan ein und beim zweiten Scan wieder aus.

### Zugänge in Buchungen prüfen

In der Buchungsdetailansicht siehst du die zugehörigen Zugänge. Öffne einen Zugang, um Status, Zugriffszeitraum, Gerät und Erstellungsdatum einzusehen. Je nach Regel steht dort **Buchungsticket an der Tür scannen** oder **Dein Kennzeichen wird gescannt**.

| Status | Bedeutung |
| - | - |
| In Bearbeitung | anny richtet den Zugang gerade ein. |
| Erfolgreich | Der Zugang ist aktiv und kann im angezeigten Zeitraum verwendet werden. |
| Entfernt | Der Zugang wurde durch das System oder eine:n Admin entfernt. |

## Einschränkungen

Die Comydo-Integration unterstützt nicht:

* Automatische Zutritte ohne passende Regel zwischen Ressource oder Community und Comydo-Geräten.
* QR-Code-Zutritte, wenn die **Check-In-Funktion** der Ressource nicht aktiviert ist.
* Kennzeichenbasierte Zufahrt, wenn im Buchungsformular kein Kennzeichen-Pflichtfeld abgefragt und in der Regel zugeordnet wird.
* Die zuverlässige Erfassung der tatsächlichen Parkdauer, wenn **Beim zweiten Scan auschecken** deaktiviert ist. In diesem Fall bleibt die geplante Buchungszeit maßgeblich.
* Fernöffnung: Comydo-Geräte lassen sich nicht per Knopfdruck aus anny öffnen, der Zutritt läuft immer über Scan.
* Zugänge zu Türen oder Schranken, die nicht vorher in Comydo eingerichtet wurden.

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Wie erhalten Kund:innen ihren Comydo-Zugang?">
    Bei Buchungszugängen erhalten Kund:innen einen QR-Code in der anny App oder Buchungsbestätigung. Diesen scannen sie am Comydo-Gerät.
  </Accordion>

  <Accordion title="Kann ich mehrere Türen mit einer Ressource verbinden?">
    Ja. Eine Regel kann eine Ressource mit mehreren Geräte-IDs verknüpfen. Pro Ressource ist aber nur eine Buchungsregel möglich.
  </Accordion>

  <Accordion title="Kann ich Community-Mitgliedern Zugang geben?">
    Ja. Erstelle eine Community-Regel und ordne ihr einen oder mehrere Comydo-Zugänge zu.
  </Accordion>

  <Accordion title="Brauche ich für Parkplatzbuchungen ein eigenes Kennzeichenfeld?">
    Ja. Verwende ein benutzerdefiniertes Kennzeichenfeld, markiere es als **Pflichtfeld** und ordne es über die **Kennzeichenerkennung** in der Comydo-Regel zu.
  </Accordion>

  <Accordion title="Was bewirken die Optionen für Check-in und Check-out beim Scan?">
    **Beim ersten Scan einchecken** checkt die Buchung beim ersten Kennzeichen-Scan automatisch ein. **Beim zweiten Scan auschecken** checkt sie beim nächsten Scan wieder aus. Ein zweiter Scan innerhalb von 5 Minuten nach dem Check-in wird ignoriert. So lässt sich die tatsächliche statt nur der geplanten Nutzungszeit erfassen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein QR-Code öffnet den Zugang nicht">
    Prüfe, ob die **Check-In-Funktion** der Ressource aktiviert ist, die Buchung zur richtigen Ressource gehört, die Regel die richtige Geräte-ID enthält und der aktuelle Zeitpunkt innerhalb des Zugriffszeitraums liegt.
  </Accordion>

  <Accordion title="Die Schranke öffnet sich trotz Buchung nicht">
    Prüfe, ob das Kennzeichen im Kennzeichenfeld gespeichert und genau dieses Feld über die **Kennzeichenerkennung** in der Comydo-Regel ausgewählt ist. Kontrolliere außerdem die zugeordneten Geräte-IDs der Parkplatz-Ressource.
  </Accordion>

  <Accordion title="Die Buchung wird bei der Ausfahrt nicht ausgecheckt">
    Prüfe, ob **Beim zweiten Scan auschecken** in der Comydo-Regel aktiviert ist und das Kennzeichen bei der Ausfahrt erkannt wurde. Ein zweiter Scan innerhalb von 5 Minuten nach dem Check-in löst noch keinen Check-out aus.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Plan:** Comydo läuft über das Feature für Smart-Lock-Integrationen (ab Professional-Plan); genaue Plangrenze produktseitig geführt.
>
> **UI-Pfad:** Menüleiste → Integrationen → Comydo. Felder: „Auth-Key" (Authentifizierung), danach „Webhook-URL" (kopieren). Regel-Panels „Zugang durch Buchungen" und „Zugang durch Communities", Button „Hinzufügen". Regelfelder: „Geräte-IDs", „Zugang vor der Buchung", „Zugang nach der Buchung", „Kennzeichenerkennung", „Benutzerdefiniertes Feld für Kennzeichen", „Beim ersten Scan einchecken", „Beim zweiten Scan auschecken". Verbindung trennen: Toggle oben rechts → drei Punkte → Löschen.
>
> **Datenfluss (wichtig):** Validierungsmodell, kein Datenexport. anny speichert Zugänge lokal (Buchungsticket-Code oder SHA256-Hash des normalisierten Kennzeichens). Bei jedem Scan ruft Comydo den Webhook von anny mit Geräte-ID + Inhalt auf; anny prüft gespeicherte, gültige, nicht entfernte Grants und antwortet gültig/ungültig. anny sendet keine Buchungsdaten oder Kennzeichen aktiv an Comydo.
>
> **Setup-Reihenfolge:** Erst Auth-Key aus Comydo-Admin-App in anny eintragen (Comydo → anny), dann angezeigte Webhook-URL im Comydo-Admin-Bereich hinterlegen (anny → Comydo). Kein „Support-Team"-Versand.
>
> **Zutrittsarten:** QR-/Ticket-Zutritt setzt aktivierte Check-In-Funktion der Ressource voraus (sonst Grant „Fehlgeschlagen"). Kennzeichen-Zutritt setzt ein als Pflichtfeld abgefragtes Kennzeichenfeld voraus; sonst lässt sich die Regel nicht speichern. Kennzeichen-Schreibweise (Leer-/Bindestriche) egal, da normalisiert und gehasht.
>
> **Check-in/Check-out per Scan:** „Beim ersten Scan einchecken" → erster Scan checkt ein. „Beim zweiten Scan auschecken" → späterer Scan checkt aus, aber erst 5 Minuten nach dem Check-in (Schutzzeit gegen Doppelscan). Ist Check-in-Toggle aus und wird nie manuell eingecheckt, greift der Auto-Check-out nicht.
>
> **Regeln:** Pro Ressource nur eine Buchungsregel (Duplikat-Validierung). Mehrere Geräte-IDs pro Regel möglich. Community-Regeln kennen nur Community + Geräte-IDs (keine Kennzeichen, keine Puffer, keine Scan-Toggles); Community-Zugang nutzt den Pass-Code des Accounts.
>
> **Grant-Status/Anzeige:** „In Bearbeitung" (pending) → „Erfolgreich"; „Entfernt"; „Fehlgeschlagen". Zugangsanzeige: „Buchungsticket an der Tür scannen" (Ticket) oder „Dein Kennzeichen wird gescannt" (Kennzeichen). Keine Zugangs-URL, kein PIN-Code, kein PIN-/Keypad-Feld bei Comydo.
>
> **Abgrenzung:** Comydo unterstützt KEINE Fernöffnung (Remote Open); der Zutritt läuft ausschließlich über Scan. Abgelaufene Zugänge entfernt Comydo selbst.
>
> **Quirk:** Bei deaktivierter Integration lehnt der Webhook alle Scans ab, auch bereits erstellte Zugänge. Deaktivieren stoppt also faktisch auch bestehende Zutritte (mit Team abzuklären, ob die „bestehende Zugänge behalten"-Formulierung angepasst werden muss).


# Connected Persons
Source: https://docs.anny.co/connected-persons

Vernetze dich mit Kolleg:innen, buche in deren Namen und verwalte gemeinsame Buchungsberechtigungen.

Mit Connected Persons verbindest du dich in anny mit anderen Personen und vergibst individuelle Berechtigungen. So kannst du für Kolleg:innen buchen, deren Buchungen einsehen oder dein Buchungsmanagement in andere Hände geben.

## Verbindungen einsehen

<Steps>
  <Step title="Profil öffnen">
    Navigiere zu deinem **Profil** und wähle **Connected Persons**.
  </Step>

  <Step title="Übersicht prüfen">
    Hier siehst du alle Personen, mit denen du verbunden bist. Du kannst bestehende Verbindungen anpassen oder neue hinzufügen.
  </Step>
</Steps>

## Verbindung hinzufügen

<Steps>
  <Step title="Neue Verbindung starten">
    Klicke auf **Verbindung hinzufügen**.
  </Step>

  <Step title="Person auswählen">
    Wähle eine Person aus der Liste (alle sichtbaren Community-Mitglieder werden angezeigt) oder gib direkt eine E-Mail-Adresse ein.
  </Step>

  <Step title="Anfrage senden">
    Klicke auf **Verbindungsanfrage senden**. Es öffnet sich das Fenster zur Rechteverwaltung.
  </Step>
</Steps>

<Tip>
  Du kannst auch Personen außerhalb deiner Community per E-Mail einladen. Das Feature funktioniert unabhängig von Community-Mitgliedschaften.
</Tip>

## Berechtigungen verwalten

Für jede Verbindung gibt es zwei Richtungen:

**Freigegebene Berechtigungen:** Rechte, die du anderen für deine Buchungen gibst.

**Zugängliche Berechtigungen:** Rechte, die du für die Buchungen anderer anfragst. Neue Berechtigungsanfragen werden per E-Mail an die andere Person gesendet.

| Berechtigung | Beschreibung |
| - | - |
| Buchungen lesen | Buchungen der anderen Person einsehen |
| Für andere buchen (Book-on-behalf) | Buchungen im Namen der anderen Person durchführen |
| Buchungen bearbeiten | Buchungen der anderen Person stornieren oder ändern |
| Über Buchungen benachrichtigen | Benachrichtigung erhalten, wenn die verbundene Person bucht |

## Für verbundene Personen buchen

Du kannst an zwei Stellen für andere buchen:

* **Im Planer:** Tippe in der Listen- oder Kartenansicht auf den Auswahlpfeil oder die drei Punkte und wähle die Person aus.
* **Auf der Ressourcenseite:** Nutze die Auswahl **Buchen für** und wähle die verbundene Person.

<Tip>
  Alternativ kannst du über das Papierflieger-Symbol auch Personen zu einer Buchung einladen, mit denen du nicht verbunden bist.
</Tip>

## Buchungen einsehen

Unter **Buchungen** kannst du oben links bei **Meine Buchungen** zwischen deinen eigenen und den Buchungen verbundener Personen wechseln. So siehst du alle Reservierungen, für die du Leserechte hast.

Bei jeder Buchung kannst du einsehen:

* Buchungsoption, Datum und Uhrzeit
* Standort der Ressource (inkl. Kartenvorschau)
* Details der Bestellung
* Anbieter der Buchung

## Kontingente und Buchungsregeln

Connected Persons berücksichtigt Buchungsregeln und Kontingente pro Nutzer:in. Wenn du für eine andere Person buchst, werden die Kontingente bei der Person abgezogen, für die die Buchung durchgeführt wurde.

<AccordionGroup>
  <Accordion title="Meine Verbindungsanfrage wird nicht angenommen">
    Die andere Person muss die Anfrage aktiv bestätigen. Die Anfrage wird per E-Mail versendet. Bitte die Person, ihren Posteingang (und Spam-Ordner) zu prüfen.
  </Accordion>

  <Accordion title="Ich finde eine Person nicht in der Liste">
    Personen im Inkognito-Modus werden nicht in der Auswahlliste angezeigt. Nutze in diesem Fall die direkte E-Mail-Einladung.
  </Accordion>

  <Accordion title="Meine Buchung für eine andere Person taucht unter meinen eigenen Buchungen auf">
    Wechsle in der Buchungsübersicht oben links von "Meine Buchungen" zur verbundenen Person. Buchungen, die du für andere tätigst, erscheinen unter deren Namen.
  </Accordion>

  <Accordion title="Kann ich Benachrichtigungen ohne Buchungsrechte erhalten?">
    Ja. Du kannst die Berechtigung "Über Buchungen benachrichtigen" unabhängig von den anderen Rechten anfordern.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: Avatar (oben rechts) → Profil → Connected Persons
> * Feature funktioniert unabhängig von Communities
> * Freigabe der eigenen Benachrichtigungen an Dritte erfordert Bestätigung der anderen Person
> * Kontingente und Buchungsregeln gelten pro gebuchte Person, nicht pro buchende Person
> * Book-on-behalf: Buchung erscheint bei der Zielperson, nicht bei der buchenden Person
> * Inkognito-Personen: nicht über Liste findbar, nur per E-Mail einladbar
> * Verfügbar in Web und anny App (iOS/Android)
> * Verwandter Admin-Artikel: nicht vorhanden (reines Endnutzer-Feature)


# Custom Remote Open mit anny verbinden
Source: https://docs.anny.co/custom-remote-open

Öffne eigene Türen, Tore und Schranken per Knopfdruck aus anny, auch ohne fertige Anbieter-Integration.

Custom Remote Open ist die offene Variante der Fernöffnung: Statt ein bestimmtes Schließsystem anzubinden, hinterlegst du eine eigene **Endpunkt-URL**. Drückt eine berechtigte Person in anny den Öffnen-Button, schickt anny eine Anfrage an diese URL. Was danach passiert, entscheidet dein eigenes System.

Mit Custom Remote Open kannst du in anny:

* ein Schließsystem anbinden, für das es keine fertige Integration gibt
* Kund:innen für ihre Buchungszeit einen Öffnen-Button geben
* Community-Mitgliedern dauerhaften Zugang zu ausgewählten Geräten geben

Besonders praktisch ist die Integration, wenn du Türen, Tore oder Schranken schon über eine eigene Steuerung öffnest und diese Steuerung nur noch mit deinen Buchungen verbinden möchtest.

<Info>
  Verfügbar ab dem Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Eigene Schließsteuerung anbinden | **Ein vorhandenes System öffnet Türen, ohne dass anny den Hersteller kennen muss.** Du baust einen Endpunkt, der die Öffnung auslöst, und verbindest ihn mit deinen Ressourcen. |
| Schranke am Parkplatz oder Hof | **Kund:innen öffnen die Schranke zur gebuchten Zeit selbst.** Die Öffnung ist an den Zeitraum der Buchung gebunden, inklusive Vor- und Nachlauf. |
| Dauerzugang für Coworking-Mitglieder | **Mitglieder einer Community öffnen freigegebene Geräte dauerhaft.** Der Zugang gilt ohne Enddatum, solange die Mitgliedschaft besteht. |

## Wie die Custom-Remote-Open-Verbindung funktioniert

Die Verbindung besteht aus zwei Angaben: der **Endpunkt-URL** deines Systems und einem **Endpunkt-Token**, den anny für dich erzeugt. anny sendet den Token bei jeder Anfrage als `Authorization: Bearer <token>` mit. Dein Endpunkt prüft den Token und löst die Öffnung aus.

anny fragt dein System zu keinem anderen Zeitpunkt an. Es gibt keine Geräteliste, die anny abruft, und keine Statusabfrage am Schloss. Der einzige Kontakt ist die Öffnungsanfrage per Knopfdruck. Zutrittsrechte entstehen ausschließlich in anny.

So läuft ein Zugang ab:

1. Eine Buchung wird angenommen. anny prüft, ob eine Regel die gebuchte Ressource abdeckt.
2. anny legt für jede Geräte-ID der Regel ein Zutrittsrecht mit dem Status **Erfolgreich** an. Dein System erhält dabei noch keine Anfrage.
3. Im gültigen Zeitraum sehen Kund:innen den Öffnen-Button in anny.
4. Beim Klick sendet anny die Anfrage an deine Endpunkt-URL und wertet die Antwort aus.

Die Anfrage ist ein `POST` mit diesen Angaben:

| Feld | Inhalt |
| - | - |
| `is_remote_open_request` | Immer `true`. Kennzeichnet die Anfrage als Öffnungsanfrage. |
| `lock_id` | Die Geräte-ID aus der Regel, also das zu öffnende Gerät. |
| `booking_number` | Die Buchungsnummer. Bei Zugängen über eine Community bleibt das Feld leer. |
| `customer_name` | Der Name der Person, für die der Zugang erstellt wurde. |

Den passenden Beispiel-Request zeigt anny direkt in den Einstellungen der Integration unter **Beispiel-Request**.

Für den Erfolg zählt allein der Antwortstatus deines Endpunkts. Antwortet er erfolgreich, meldet anny die Öffnung als erfolgreich. Antwortet er mit einem Fehler oder ist er nicht erreichbar, sehen Kund:innen **Öffnen fehlgeschlagen**. Generierst du den Token neu, verliert der alte Token sofort seine Gültigkeit und alle Anfragen scheitern, bis dein Endpunkt den neuen Token kennt.

## Custom Remote Open verbinden

### Voraussetzungen

Bevor du Custom Remote Open verbindest, stelle sicher, dass du Folgendes hast:

* Admin-Rechte in deinem anny Account und den Professional-Plan
* einen öffentlich erreichbaren Endpunkt in deinem System, der `POST`-Anfragen mit JSON annimmt und mit `https://` beginnt
* eine Prüfung des Bearer-Tokens in deinem Endpunkt, damit niemand ohne Berechtigung öffnen kann
* eine Logik, die anhand der übergebenen Geräte-ID das richtige Gerät öffnet
* festgelegte Geräte-IDs, denn Kund:innen sehen diese ID als Namen des Türschlosses

### Verbindung einrichten

<Steps>
  <Step title="Endpunkt hinterlegen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Custom Remote Open**. Trage unter **Einstellungen** die **Endpunkt-URL** ein und speichere. Klicke danach auf **Token generieren** und kopiere den **Endpunkt-Token** sofort, denn anny zeigt ihn nur einmal an. Hinterlege den Token anschließend in deinem eigenen System.
  </Step>

  <Step title="Konfigurieren">
    Sobald Endpunkt-URL und Token gespeichert sind, erscheinen die Bereiche für Regeln. Lege dort deine Zugangsregeln an:

    1. Klicke unter **Zugang durch Buchungen** oder **Zugang durch Communities** auf **Hinzufügen**.
    2. Wähle die **Ressource** oder die **Community** aus.
    3. Trage unter **Geräte-IDs für Remote Open** eine oder mehrere IDs ein, zum Beispiel `Haupttür-1`. Bereits verwendete IDs schlägt anny zur Auswahl vor.
    4. Lege bei Buchungsregeln fest, wie lange der **Zugang vor der Buchung** und der **Zugang nach der Buchung** gelten soll.
    5. Speichere die Regel.
    6. Aktiviere die Integration über den **Toggle** oben rechts.
  </Step>
</Steps>

Sobald die Integration aktiv ist, erstellt anny für passende Buchungen und Community-Mitgliedschaften automatisch Zutrittsrechte mit Öffnen-Button.

<Tip>
  Teste die Verbindung mit einer eigenen Testbuchung auf der betroffenen Ressource. Öffne die Buchung, klicke auf **Schloss entsperren** und prüfe, ob dein System die Anfrage erhält.
</Tip>

### Einstellungen & Optionen

| Einstellung | Funktion |
| - | - |
| Endpunkt-URL | Die Adresse in deinem System, an die anny die Öffnungsanfrage sendet. Sie muss mit `http://` oder `https://` beginnen. |
| Endpunkt-Token | Der von anny erzeugte Token für alle Anfragen dieser Verbindung. Über **Token neu generieren** tauschst du ihn aus. |
| Ressource | Bestimmt, bei welcher Buchung ein Zutrittsrecht entsteht. Eine Regel auf einer übergeordneten Ressource gilt auch für Buchungen ihrer Unterressourcen. |
| Community | Gibt allen Mitgliedern der Community Zugang zu den hinterlegten Geräten. |
| Geräte-IDs für Remote Open | Die Kennungen, die anny als `lock_id` übergibt. Du vergibst sie frei. Kund:innen sehen die ID als **Türschloss** in der Buchung. |
| Zugang vor der Buchung | Verschiebt den Beginn des Zugangs nach vorn, damit Kund:innen schon vorher öffnen können. |
| Zugang nach der Buchung | Verlängert den Zugang über das Buchungsende hinaus. |

Einen Schalter für die Fernöffnung gibt es hier nicht. Bei Custom Remote Open ist sie immer aktiv, denn die Integration kennt keine andere Zugangsmethode. Bestehende Regeln bearbeitest oder löschst du über die **drei Punkte**.

Unter **Zugang durch Communities** findest du zusätzlich die Aktion **Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen**. Damit versorgst du Mitglieder, die der Community schon vor der Regel beigetreten sind.

### Remote Open

Mit Remote Open öffnen Kund:innen ein freigegebenes Gerät per Knopfdruck, ohne App und ohne Konto beim Schließsystem. Der Button erscheint, sobald das Zutrittsrecht gültig ist, und verschwindet nach Ablauf des Zeitraums.

| Ort | Wo öffnest du die Tür? |
| - | - |
| E-Mail | Der Link **Öffnen** in der Buchungsbestätigung führt in den Browser. Dort erscheint der Button **Tür entriegeln**. |
| anny App | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** und in der Buchung. |
| Browser | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** und in der Buchung. |

Als Admin-Nutzer:in öffnest du dasselbe Gerät in den Buchungsdetails über **Schloss entsperren**. Zugänge aus einer Community gelten dauerhaft und haben kein Enddatum.

## Einschränkungen

Die Custom-Remote-Open-Integration unterstützt nicht:

* **Geräteerkennung:** anny ruft keine Geräteliste ab. Du trägst die Geräte-IDs von Hand ein und musst sie in deinem System selbst zuordnen.
* **Statusabfrage:** anny weiß nicht, ob eine Tür offen oder geschlossen ist. Es wird nur die Öffnungsanfrage gesendet.
* **Andere Zugangsmethoden:** Es gibt keinen PIN-Code, keinen QR-Code, keinen Zugangslink und keine Anbieter-App. Ohne Öffnen-Button gibt es keinen Zugang.
* **Automatische Wiederholung:** Schlägt eine Öffnung fehl, versucht anny es nicht erneut. Kund:innen müssen den Button noch einmal drücken.
* **Mehrere Buchungsregeln pro Ressource:** Jede Ressource darf in nur einer Buchungsregel vorkommen, sonst lässt sich die Regel nicht speichern.
* **Zugänge ohne Kund:in:** Interne Blocker und noch nicht angenommene Buchungen erhalten kein Zutrittsrecht.

Alle Anfragen einer Verbindung gehen an dieselbe Endpunkt-URL und verwenden denselben Token. Die Unterscheidung zwischen mehreren Geräten läuft ausschließlich über die übergebene Geräte-ID.

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zutrittsrechte behalten möchtest, aber keine neuen erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration. In deinem eigenen System musst du danach nichts zurücknehmen, denn anny hinterlegt dort keine Berechtigungen.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Welches Schließsystem brauche ich für Custom Remote Open?">
    Jedes System, das sich über eine eigene Schnittstelle öffnen lässt. anny sendet nur eine Anfrage an deine Endpunkt-URL. Die eigentliche Öffnung steuerst du selbst, zum Beispiel über die Steuerung deiner Tür, deines Tors oder deiner Schranke.
  </Accordion>

  <Accordion title="Woher kommen die Geräte-IDs?">
    Du vergibst sie selbst. anny übergibt die eingetragene ID unverändert an deinen Endpunkt. Wähle sprechende IDs wie `Haupttür-1`, denn Kund:innen sehen die ID in der Buchung als Namen des Türschlosses.
  </Accordion>

  <Accordion title="Brauchen Kund:innen eine App oder ein Konto beim Schließsystem?">
    Nein. Der Button erscheint in der anny App, im Browser und über den Link in der Buchungsbestätigung. Ein Konto beim Schließsystem ist nicht nötig.
  </Accordion>

  <Accordion title="Was passiert mit dem Zugang, wenn eine Buchung storniert wird?">
    anny entfernt das Zutrittsrecht, sobald die Stornierung verarbeitet ist. Der Öffnen-Button verschwindet damit. Eine Rückmeldung an dein System ist nicht nötig, weil dort keine Berechtigung hinterlegt wurde.
  </Accordion>

  <Accordion title="Wie tausche ich den Endpunkt-Token aus?">
    Klicke auf **Token neu generieren** und kopiere den neuen Token direkt aus dem Fenster. Der alte Token gilt ab diesem Moment nicht mehr. Hinterlege den neuen Token sofort in deinem System, sonst schlagen alle Öffnungen fehl.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kund:innen sehen keinen Öffnen-Button">
    Meist besteht kein gültiges Zutrittsrecht. Prüfe, ob die Integration aktiv ist, ob eine Regel die gebuchte Ressource abdeckt und ob die Buchung angenommen wurde. Prüfe danach in den Buchungsdetails den Zeitraum des Zugangs, denn außerhalb davon ist der Button nicht nutzbar.
  </Accordion>

  <Accordion title="Die Öffnung schlägt fehl">
    Dein Endpunkt hat die Anfrage nicht erfolgreich beantwortet. Prüfe, ob die **Endpunkt-URL** korrekt und öffentlich erreichbar ist und ob sie mit `https://` beginnt. Prüfe außerdem, ob der in deinem System hinterlegte Token noch mit dem aktuellen **Endpunkt-Token** übereinstimmt.
  </Accordion>

  <Accordion title="Bei einer Serienbuchung fehlt der Zugang noch">
    Für Serienbuchungen plant anny die Zutrittsrechte und erstellt sie erst kurz vor dem jeweiligen Termin. In den Buchungsdetails steht der Zugang so lange auf **Geplant**. Das ist kein Fehler, der Button erscheint rechtzeitig zum Termin.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Einordnung:** Custom Remote Open ist eine Zutritts-Integration auf derselben Basis wie die Smart-Lock-Integrationen (KleverKey, Nuki, SaltoKS, Comydo, UniFi Access, KeyCafe, EVVA AirKey, Tapkey, Glutz eAccess, dormakaba, iLOQ) und läuft über das Feature INTEGRATIONS\_SMART\_LOCKS. Sie ist KEIN Produkt eines Herstellers, sondern eine generische Fernöffnung gegen eine kundeneigene HTTP-Schnittstelle. Die Plan-Zuordnung „ab Professional" liegt in der Datenbank und ist aus dem Code nicht final verifizierbar. In der Übersicht „Smart-Lock-Integrationen" ist Custom Remote Open bisher weder als Karte noch in der Liste der Remote-Open-Anbieter aufgeführt.
>
> **UI-Pfade:** Menüleiste → **Integrationen** → **Custom Remote Open**. Panel „Einstellungen" mit den Feldern „Endpunkt-URL", „Endpunkt-Token" (Buttons „Token generieren" / „Token neu generieren") und der Vorschau „Beispiel-Request:". Regeln darunter: „Zugang durch Buchungen" und „Zugang durch Communities", Lock-Feld „Geräte-IDs für Remote Open" (Platzhalter „z. B. Haupttür-1"), Felder „Ressource", „Community", „Zugang vor der Buchung", „Zugang nach der Buchung". Community-Aktion „Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen". Deaktivieren: Toggle oben rechts; Löschen: drei Punkte → Löschen.
>
> **Terminologie:** Adminseitig heißt der Öffnen-Button „Schloss entsperren" (Erfolg: „Schloss wird entsperrt", Fehler: „Entsperrung fehlgeschlagen"). Kundenseitig heißt er „Tür entriegeln" (Erfolg: „Tür ist geöffnet", Fehler: „Öffnen fehlgeschlagen"); der Grant-Block heißt kundenseitig „Schlüsselloser Zugang", adminseitig „Smartlock Zugänge", die Home-Sektion „Heutige Zugänge". In der Buchungsbestätigung heißt der Link „Öffnen" und führt auf die Buchungsseite. Statuswerte: In Bearbeitung, Geplant, Erfolgreich, Entfernt, Aufräumen, Fehlgeschlagen, Nicht autorisiert, Unbestätigt.
>
> **Quirks:** (1) Es gibt KEINEN Toggle „Fernöffnung verwenden" wie bei den anderen Smart-Locks; die Fernöffnung ist immer aktiv. (2) Die Zutrittsrechte entstehen rein in anny und stehen sofort auf „Erfolgreich"; beim Anlegen, Ändern und Entfernen geht keine Anfrage an das Kundensystem. Der einzige ausgehende Aufruf ist der Klick auf den Öffnen-Button. (3) Die eingetragene Geräte-ID wird gleichzeitig als Lock-Name gespeichert und Kund:innen angezeigt. (4) Die Auswahlliste der Geräte-IDs ist ein Freitextfeld; vorgeschlagen werden nur IDs, die bereits in einer anderen Regel dieser Verbindung vorkommen. (5) Nur angenommene Buchungen mit Kund:in erhalten Zugänge; Blocker nicht. (6) Regeln auf übergeordneten Ressourcen greifen auch für Unterressourcen, die spezifischere Regel gewinnt. (7) Pro Ressource ist nur eine Buchungsregel erlaubt, sonst schlägt das Speichern fehl. (8) Serienbuchungen erhalten geplante Zugänge, die etwa 48 Stunden vor Beginn erstellt werden. (9) Community-Zugänge haben kein valid\_until und gelten dauerhaft („Dauerhaft gültig"). (10) Abgelaufene Buchungszugänge werden etwa einen Tag nach Ende automatisch aufgeräumt. (11) Der Token ist eine von anny erzeugte UUID, wird nur einmal im Modal angezeigt und beim Neugenerieren sofort ersetzt. (12) Die Endpunkt-URL wird beim Speichern nicht auf Erreichbarkeit geprüft; ein Fehler zeigt sich erst beim Klick auf den Öffnen-Button. (13) Die Integration hat weder Logo noch Beschreibung in der Integrationsübersicht.
>
> **Beziehungen:** Community-Regeln setzen das Feature Communities voraus. Der Öffnen-Button erscheint kundenseitig auf der Home-Seite (nur Zugänge, die heute gültig sind), in der Buchungsansicht und über den Link aus der Buchungsbestätigung; ein Login ist nicht zwingend, der Zugriff über den Buchungslink genügt. Verwandte Artikel: Übersicht Smart-Locks, Communities.


# Dashboards
Source: https://docs.anny.co/dashboards



Mit den Dashboards in anny analysierst du zentrale Kennzahlen rund um Auslastung, Umsatz, Kunden und Services übersichtlich an einem Ort. Du kannst individuelle Auswertungen erstellen, Zeiträume flexibel definieren, Widgets konfigurieren und relevante Dashboards mit deinem Team teilen.

## Wie funktioniert Dashboards?

Im Admin-Bereich erreichst du die Dashboards über den Menüpunkt **Dashboard** in der linken Menüleiste. Dort siehst du eine Übersicht deiner privaten und geteilten Dashboards.

### Dashboard erstellen

<Steps>
  <Step title="Dashboard anlegen">
    Klicke oben rechts auf **+Neu** und vergib einen Namen für dein Dashboard (z. B. Office CGN).
  </Step>

  <Step title="Optional: Dashboard teilen">
    Aktiviere den Toggle, um das Dashboard mit deiner Organisation zu teilen. Geteilte Dashboards sind für berechtigte Nutzer:innen sichtbar.
  </Step>

  <Step title="Widgets hinzufügen">
    Klicke auf **Widgets** und wähle die gewünschten Auswertungen aus. Du kannst unbegrenzt viele Widgets pro Dashboard hinzufügen und per Drag-and-Drop über die sechs grauen Punkte anordnen.
  </Step>
</Steps>

### Private vs. geteilte Dashboards

| | Private Dashboards | Geteilte Dashboards |
| - | - | - |
| Sichtbarkeit | Nur für dich | Für berechtigte Nutzer:innen |
| Ideal für | Persönliche Auswertungen | Teamweite Reports (z. B. Marketing, Revenue) |
| Auswirkung | Keine Auswirkungen auf andere | Einheitliche Datengrundlage für Meetings |

### Rollen und Berechtigungen

In der Admin-Nutzerverwaltung definierst du pro Rolle, welche geteilten Dashboards sichtbar sind. Pro Entity **Dashboards** kannst du **Alle erlauben** oder **Ausgewählte** setzen.

Zusätzlich lassen sich Berechtigungen pro Widget-Kategorie setzen: **Buchungen**, **Analysen**, **Finanzen**, **Kunden**, **Warteschlangen** und **Trinkgeld**.

## Widget-Übersicht

Widgets sind die einzelnen Auswertungsbausteine deines Dashboards. Jedes Widget hat einen eigenen Zeitraum und eigene Filteroptionen.

### Allgemeine Widget-Funktionen

* **Fullscreen-Modus**: Öffne jedes Widget im Vollbild für detaillierte Analysen
* **Zeitraum pro Widget**: Dynamische Zeiträume (z. B. diese Woche, letzte 30 Tage) oder ein eigener Zeitraum mit frei wählbarem Start- und Enddatum (max. 365 Tage)
* **Konsistente Ressourcen-Farben**: Alle Widgets verwenden dieselben Farben pro Ressource
* **Export**: Über das Menü oben rechts im Widget als **CSV** (Rohdaten) oder **PNG** (Bildexport) herunterladen
* **Anzeigeoptionen**: Je nach Widget kannst du Legende, Mittelwerte und weitere Darstellungsoptionen anpassen

<CardGroup>
  <Card title="Buchungs-Widgets" icon="calendar-check">
    Buchungsvolumen, Trends, Check-Ins und operative Vorschau auf kommende Termine.
  </Card>

  <Card title="Kunden" icon="users">
    Top-Kunden, Kundenwachstum und Neukundenübersicht.
  </Card>

  <Card title="Finanzen" icon="coins">
    Saldo, Gesamtumsatz, MRR, Buchungscode-Verkäufe und Umsatz nach Produkt.
  </Card>

  <Card title="Analysen" icon="chart-line">
    Auslastung, Heatmaps, Top-Ressourcen, Kategorienverteilung, Kontingente und mehr.
  </Card>

  <Card title="Warteschlangen" icon="ticket">
    Ticket-Auswertungen für Bürger- und Servicebüros.
  </Card>
</CardGroup>

***

### Buchungs-Widgets

<AccordionGroup>
  <Accordion title="Buchungen nach Datum">
    Zeigt die Anzahl der Buchungen im Zeitverlauf als Balkendiagramm. Je nach Gruppierung werden Buchungen zusätzlich segmentiert (z. B. nach Ressource, Service oder UTM-Source).

    Typische Fragen: Welche Tage sind besonders stark gebucht? Gibt es wöchentliche Muster? Welche Kampagne bringt die meisten Buchungen?
  </Accordion>

  <Accordion title="Buchungen nach Erstellungsdatum">
    Zeigt, wann Buchungen im System angelegt wurden, unabhängig vom tatsächlichen Buchungszeitpunkt. Das Erstellungsdatum liegt immer in der Vergangenheit. Abgrenzung: Buchungen nach Datum zeigt das stattfindende Buchungsdatum, dieses Widget zeigt den Buchungseingang.
  </Accordion>

  <Accordion title="Neue Buchungen">
    Zeigt die neu eingegangenen Buchungen und den zugehörigen Umsatz im gewählten Zeitraum. Eignet sich für Tages- oder Wochenmonitoring und kurzfristige Performance-Analysen.
  </Accordion>

  <Accordion title="Anstehende Bestellungen">
    Operative Vorschau auf Bestellungen, die demnächst anstehen. Ergänzt **Als Nächstes** um die Bestellperspektive.
  </Accordion>

  <Accordion title="Als Nächstes">
    Operative Vorschau auf die anstehenden Buchungen. Unter **Zeitraum** wählst du **Heute**, **7 Tage** (Standard) oder **30 Tage**. Zeigt Zeit, Ressource, Status und Check-in-Option. Spalten lassen sich über das Zahnrad-Icon anpassen.
  </Accordion>

  <Accordion title="Buchungsanfragen">
    Zeigt alle offenen Buchungsanfragen, die noch nicht bestätigt oder abgelehnt wurden. Du kannst Anfragen direkt aus dem Widget bestätigen oder ablehnen und optional eine Nachricht mitsenden.
  </Accordion>

  <Accordion title="Check-Ins">
    Echtzeit-Überblick über aktuell eingecheckte Buchungen im Verhältnis zur Gesamtanzahl (z. B. 2/5 eingecheckt).
  </Accordion>

  <Accordion title="Hauptzeiten und Tage">
    Zeigt, wann deine Ressourcen am stärksten ausgelastet sind: nach Wochentagen oder nach Uhrzeiten. Hilft bei Kapazitätsplanung, Personalplanung und Preisoptimierung.
  </Accordion>
</AccordionGroup>

### Kunden

<AccordionGroup>
  <Accordion title="Top-Kunden">
    Die umsatz- oder buchungsstärksten Kunden im gewählten Zeitraum. Du wählst die Metrik: Buchungen, Umsatz oder beides kombiniert. Ideal zur Identifikation von Key Accounts.
  </Accordion>

  <Accordion title="Kundenwachstum">
    Zeigt die Entwicklung der Neukundengewinnung im Zeitverlauf. Ein Kunde gilt als neu, wenn im gewählten Zeitraum seine erste Buchung erfolgt ist. Inkl. Vergleich zum vorherigen Zeitraum.
  </Accordion>

  <Accordion title="Neue Kunden">
    Tabelle mit Neukunden. Du stellst ein, ob die erste Buchung in den letzten 7, 14, 30, 60 oder 90 Tagen lag.
  </Accordion>
</AccordionGroup>

### Finanzen

<AccordionGroup>
  <Accordion title="Saldo">
    Zeigt den aktuellen Kontostand auf Basis aller gebuchten Umsätze und Zahlungen, inkl. vorgemerkter Zahlungen.
  </Accordion>

  <Accordion title="Gesamtumsatz">
    Gesamte Einnahmen im gewählten Zeitraum, aufgeschlüsselt nach Buchungen, Abonnements und Paketen. Der Umsatz wird nach dem Tag der Umsatzentstehung ausgewertet (Rechnungserstellung), nicht nach dem Buchungszeitpunkt. Steueransicht: Brutto, Netto, Brutto nach Gebühren, Netto nach Gebühren. Zahlungsstatus-Filter: Fehlgeschlagene Zahlungen, Unbezahlt, Mit Online-Zahlung, Offline-Zahlung, Erstattet.
  </Accordion>

  <Accordion title="MRR">
    Monatlich wiederkehrender Umsatz aus laufenden Abonnements. Einmalige Buchungen oder Pakete werden nicht berücksichtigt.
  </Accordion>

  <Accordion title="Buchungscode-Verkäufe">
    Verkaufsstatistiken für Gutscheine und Mehrfachkarten, gruppiert nach Paketen im Zeitverlauf. Bildet den Kaufzeitpunkt ab, unabhängig von der Einlösung.
  </Accordion>

  <Accordion title="Umsatz nach Produkt">
    Schlüsselt den Umsatz nach einzelnen Produkten auf und stellt ihn den Online-Transaktionsgebühren gegenüber. Wie andere Widgets exportierst du die Ansicht als **CSV** oder **PNG**.
  </Accordion>

  <Accordion title="Trinkgeld pro Mitarbeiter">
    Trinkgelder aus POS- und Terminal-Zahlungen im Zeitverlauf, gruppiert nach der Person, die die Zahlung entgegengenommen hat. Voraussetzung: Online-Zahlung und die Widget-Berechtigung **Trinkgeld**.

    Unter **Ansicht** wählst du **Alle Mitarbeiter** oder **Mein Trinkgeld**. **Alle Mitarbeiter** setzt zusätzlich die Dashboard-Kategorie **Finanzen**. Fehlt dieses Recht, zeigt das Widget nur die eigenen Tipps und die Überschrift **Mein Trinkgeld**.
  </Accordion>

  <Accordion title="Neue Abonnements nach Datum">
    Neue Abos im Zeitverlauf. Voraussetzung: Feature **Abos und Mitgliedschaften**.
  </Accordion>

  <Accordion title="Gekündigte Abos nach Datum">
    Gekündigte Abos pro Tag, umschaltbar zwischen Kündigungsdatum und effektivem Enddatum.
  </Accordion>

  <Accordion title="Kündigungsgründe">
    Gründe für Abo-Kündigungen als absolute Werte. Das ist kein Widget für Buchungsstornos.
  </Accordion>

  <Accordion title="Abo Cashflow Prognose">
    Erwartete wiederkehrende Einnahmen aus laufenden Abos.
  </Accordion>

  <Accordion title="Aktive Abos nach Plan">
    Anzahl aktiver Abos, aufgeschlüsselt nach Abo-Plan.
  </Accordion>
</AccordionGroup>

### Analysen

<AccordionGroup>
  <Accordion title="Auslastung">
    Prozentuale Nutzung deiner Ressourcen im gewaehlten Zeitraum. Filterbar nach Ressource, Service, Kategorie, Gruppe, Community und Adresse.
  </Accordion>

  <Accordion title="Heatmap">
    Buchungsverteilung als Matrixdarstellung. Wählbar: Tag x Stunde (Wochenanalyse) oder Tag x Monat (saisonale Betrachtung). Je dunkler ein Feld, desto höher die Auslastung.
  </Accordion>

  <Accordion title="Auslastungs-Heatmap">
    Zeigt die Auslastung von Arbeitsplätzen und Räumen auf einer interaktiven Karte (inkl. 3D-Ansicht), pro Standort oder standortübergreifend.
  </Accordion>

  <Accordion title="Top-Ressourcen">
    Die leistungsstärksten Ressourcen basierend auf Buchungen, Einnahmen oder beidem. Darstellung als Balkendiagramm.
  </Accordion>

  <Accordion title="Top-Services">
    Die beliebtesten und umsatzstärksten Services im gewählten Zeitraum. Vergleich von Nutzung und wirtschaftlicher Performance.
  </Accordion>

  <Accordion title="Kategorienverteilung">
    Verteilung von Buchungen oder Einnahmen auf deine Kategorien als Kreis- oder Donut-Diagramm. Zeigt die führende Kategorie mit prozentualem Anteil.
  </Accordion>

  <Accordion title="Tests nach Datum">
    Verfügbar bei aktiviertem Feature Zertifikate. Zeigt durchgeführte oder geplante Tests im zeitlichen Verlauf.
  </Accordion>

  <Accordion title="Bereitgestellte Ressourcen">
    Visualisiert Dauer, Kosten und Anzahl der Termine für bereitgestellte Ressourcenzuweisungen. Waehlbar: Dauer und Kosten oder Anzahl und Kosten.
  </Accordion>

  <Accordion title="Buchungsfrequenz">
    Durchschnittliche Buchungen pro Kunde im Zeitverlauf. Filterbar nach allen Kunden oder nur aktiven Kunden sowie nach Ressource, Service oder Kategorie.
  </Accordion>

  <Accordion title="Kontingentauslastung">
    Nutzungsraten von Kontingenten im Zeitverlauf, aufgeteilt nach Ausgabetyp (Community oder Abonnement). Zeigt, wie viel Prozent der zugewiesenen Guthaben tatsächlich beansprucht werden.
  </Accordion>

  <Accordion title="Aktuelle Kontingentnutzung">
    Offene Kontingentzuweisungen aggregiert pro Kontingent. Stellt genutzten Wert dem Gesamtwert in gestapelten Balken gegenüber. Filterbar nach Ausgabeart.
  </Accordion>

  <Accordion title="Warteliste nach Ressource">
    Anzahl der aktiven Wartelistenplätze gruppiert nach Ressource. Macht Engpässe und Ressourcen mit hoher Nachfrage sofort sichtbar.
  </Accordion>

  <Accordion title="Buchungen nach Rolle">
    Wertet tägliche Buchungen nach Nutzerrollen bzw. Skills aus (zum Beispiel Rollen, Sprachen oder Tools). Ermöglicht eine Soll-Ist-Prüfung definierter Präsenzquoten (z. B. Mindestanzahl Ersthelfer:innen vor Ort).
  </Accordion>
</AccordionGroup>

### Warteschlangen

<AccordionGroup>
  <Accordion title="Tickets pro Benutzer">
    Anzahl geschlossener Tickets pro Mitarbeiter:in, gruppiert nach Warteschlange. Macht die Arbeitslast und Verteilung im Team sichtbar.
  </Accordion>

  <Accordion title="Tickets nach Datum">
    Anzahl der täglich geschlossenen Tickets, aufgeteilt nach Warteschlangen. Zeigt zeitliche Trends und saisonale Auslastungsspitzen.
  </Accordion>
</AccordionGroup>

## Wann nutze ich das?

* **Du möchtest KPIs teamweit teilen**: Erstelle ein geteiltes Dashboard und vergib Berechtigungen pro Rolle.
* **Du brauchst einen schnellen Tagesüberblick**: Nutze die Widgets Neue Buchungen und Als Nächstes auf einem privaten Dashboard.
* **Du willst Kampagnenwirkung messen**: Gruppiere Buchungen nach Datum nach UTM-Source.
* **Du planst Kapazitäten oder Personal**: Nutze Hauptzeiten und Tage, Auslastung und die Heatmap.
* **Nicht geeignet für**: Tabellarische Rohdaten-Exporte. Dafür nutze [(Automatische) Exporte](/automatic-exports).

## Einstellungen und Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| +Neu | Erstellt ein neues Dashboard |
| Toggle Mit Organisation teilen | Macht Dashboard für berechtigte Nutzer:innen sichtbar |
| Widgets | Öffnet die Widget-Auswahl |
| Zeitraum (pro Widget) | Dynamisch oder eigener Zeitraum (max. 365 Tage) |
| Gruppierung (pro Widget) | Segmentiert nach Ressource, Service, Kategorie, UTM-Source |
| Steueransicht (Umsatz-Widgets) | Brutto, Netto, Brutto/Netto nach Gebühren |
| Zahlungsstatus (Umsatz-Widgets) | Fehlgeschlagene Zahlungen, Unbezahlt, Mit Online-Zahlung, Offline-Zahlung, Erstattet |
| Drag-and-Drop | Widgets über die sechs grauen Punkte verschieben |
| Spalten anpassen | Über das Zahnrad-Icon konfigurierbar |

<Tip>
  Definiere Standard-Dashboards für wiederkehrende Reporting-Anforderungen (z. B. Operations, Revenue, Marketing) und teile sie, statt dass jede Person eigene Auswertungen pflegt.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Coworking-Space trackt Finanzen und Abos">
    Ein Coworking-Space moechte Umsatzentwicklung und Mitgliedschaften zentral auswerten, um Preisanpassungen datenbasiert zu planen.

    <Steps>
      <Step title="Geteiltes Dashboard erstellen">
        Öffne **Dashboard** in der Menüleiste und klicke auf **+Neu**. Vergib den Namen Finance und aktiviere den Toggle **Mit Organisation teilen**.
      </Step>

      <Step title="Umsatz-Widgets hinzufügen">
        Klicke auf **Widgets** und füge **Gesamtumsatz** und **MRR** hinzu. Setze den Zeitraum auf einen eigenen 90-Tage-Zeitraum. Wähle bei Gesamtumsatz die Steueransicht Netto nach Gebühren und den Status Bezahlt.
      </Step>

      <Step title="Buchungscode-Verkäufe ergänzen">
        Füge das Widget **Buchungscode-Verkäufe** hinzu, um den Absatz von Mehrfachkarten und Gutscheinen im Zeitverlauf zu sehen.
      </Step>

      <Step title="Berechtigung einschränken">
        Gehe über **Avatar** (oben rechts) und dann **Admin-Nutzer verwalten**. Erstelle oder bearbeite die Rolle Finance und aktiviere den Zugriff auf das Dashboard Finance sowie die Widget-Kategorie Finanzen.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Ein Unternehmen trackt Sitzplatz-Auslastung und Ersthelfer-Praesenz">
    Ein Unternehmen mit Desk Sharing möchte die Auslastung der Arbeitsplätze überwachen und sicherstellen, dass täglich die Mindestanzahl an Ersthelfer:innen vor Ort ist.

    <Steps>
      <Step title="Dashboard erstellen">
        Oeffne **Dashboard** und klicke auf **+Neu**. Vergib den Namen Office Compliance und aktiviere **Mit Organisation teilen**.
      </Step>

      <Step title="Auslastungs-Widget hinzufuegen">
        Füge das Widget **Auslastung** hinzu. Filtere nach der Adresse deines Standorts und der Kategorie Arbeitsplatz. Setze den Zeitraum auf diese Woche.
      </Step>

      <Step title="Buchungen nach Rolle hinzufügen">
        Füge das Widget **Buchungen nach Rolle** hinzu. Dieses zeigt die tägliche Soll-Ist-Auswertung: Wie viele Personen mit der Rolle Ersthelfer haben an jedem Tag eine Buchung?
      </Step>

      <Step title="Ergebnis prüfen">
        Im Widget Buchungen nach Rolle siehst du auf einen Blick, ob an den kommenden Tagen die Mindestquote erfüllt ist. Bei Untererfüllung kannst du proaktiv qualifizierte Personen ins Büro einladen.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Wie exportiere ich Widget-Daten?">
    Klicke auf das Menü oben rechts im Widget und wähle **CSV** (Rohdaten) oder **PNG** (Bildexport). Der Export berücksichtigt den aktuell gesetzten Zeitraum und die aktiven Filter.
  </Accordion>

  <Accordion title="Warum sieht ein Teammitglied ein geteiltes Dashboard nicht?">
    Pruefe in **Avatar** und dann **Admin-Nutzer verwalten**, ob die Rolle der Person Zugriff auf das spezifische Dashboard und die relevanten Widget-Kategorien hat.
  </Accordion>

  <Accordion title="Warum weichen die Zahlen in meinem Widget von meinen Erwartungen ab?">
    Pruefe zuerst den eingestellten Zeitraum (dynamisch vs. eigener Zeitraum) und die aktiven Filter (Ressource, Community, Adresse, Status). Jedes Widget hat eigene Einstellungen.
  </Accordion>

  <Accordion title="Wie erstelle ich Marketing-Reports zur Kampagnenanalyse?">
    Gruppiere das Widget Buchungen nach Datum nach **UTM-Source**. Kombiniere zusaetzlich mit der Gruppierung nach Datum, um die Performance einzelner Kanaele im Zeitverlauf zu vergleichen.
  </Accordion>

  <Accordion title="Wie viele Dashboards kann ich erstellen?">
    Es gibt keine Begrenzung. Du kannst unbegrenzt viele private und geteilte Dashboards erstellen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein geteiltes Dashboard wird anderen Nutzer:innen nicht angezeigt">
    Die Rolle der betroffenen Person hat keinen Zugriff. Gehe zu **Avatar** und dann **Admin-Nutzer verwalten**, bearbeite die entsprechende Rolle und aktiviere den Zugriff auf das Dashboard.
  </Accordion>

  <Accordion title="Die Umsatzzahlen im Widget stimmen nicht mit meinen Rechnungen ueberein">
    Das Gesamtumsatz-Widget wertet nach Umsatzentstehungsdatum (Rechnungserstellung) aus, nicht nach Buchungszeitpunkt. Prüfe ausserdem die Steueransicht und den Zahlungsstatus-Filter.
  </Accordion>

  <Accordion title="Die Heatmap zeigt Auslastung zu falschen Uhrzeiten">
    Pruefe, ob die Zeitzone in deinen Account-Einstellungen korrekt gesetzt ist. Bei Abweichungen kann es zu einer Verschiebung der dargestellten Stunden kommen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen fuer Agenten:
>
> UI-Pfad: **Dashboard** (Menüleiste links), dann **Neu** zum Erstellen. Berechtigungen: **Avatar** → **Admin-Nutzer verwalten** → Rolle → Entity **Dashboards** mit **Alle erlauben** oder **Ausgewählte**. Widget-Kategorien: Buchungen, Analysen, Finanzen, Kunden, Warteschlangen, Trinkgeld. Zeitraum-Limit: max. 365 Tage bei eigenen Zeiträumen. Export: **CSV** / **PNG** (keine i18n-Labels „herunterladen“). Kein Plan-Gate. Standard-Widgets: Buchungen nach Datum und Auslastung. Abgrenzung: Dashboard = Visualisierung, Exporte = tabellarische Rohdaten. Es gibt KEIN Buchungs-Storno-Widget. **Kündigungsgründe** bezieht sich auf Abo-Kündigungen. Gesamtumsatz-Filter: `payment_state` (Fehlgeschlagen, Unbezahlt, Online, Offline, Erstattet), nicht Rechnungsstatus Entwurf/Offen/Bezahlt. Finanz-Widgets brauchen Feature `payments`. Abo-Widgets brauchen `plan-subscriptions`. Trinkgeld-Widget: `tips-by-user`, Ability `dashboard:tips`, Setting **Ansicht** = Alle Mitarbeiter / Mein Trinkgeld; **Alle Mitarbeiter** braucht `dashboard:financial`. Check-Ins-Widget: Ressourcen-Filter ist Pflicht. Neue Kunden: 7/14/30/60/90 Tage, nicht fest 7 Tage. **Als Nächstes** sendet `filter[start_date_range]` als `today`, `next_7_days` (Default) oder `next_30_days`; UI-Labels **Heute**, **7 Tage**, **30 Tage**.


# DATEV-Konten und Vorbereitung mit dem Steuerberater
Source: https://docs.anny.co/datev-accounts-and-tax-advisor

Welche Sachkonten die DATEV-Integration braucht, was sie bedeuten und was dein Steuerberater vor der Einrichtung vorbereiten muss.

Mit der DATEV-Integration erzeugt anny **keine Live-Verbindung** zu DATEV Unternehmen online. Stattdessen erstellt anny periodisch (oder auf Abruf) eine DATEV-Buchungsstapel-Datei (EXTF-CSV) und versendet sie automatisch per E-Mail an deine Steuerkanzlei. Die Datei kann dort in DATEV Kanzlei-Rechnungswesen importiert werden.

Damit das steuerlich korrekt funktioniert, müssen die **richtigen Sachkonten** hinterlegt sein — und die kommen von deiner Steuerkanzlei.

Dieser Artikel erklärt die einzelnen Konten und was dein Steuerberater vor der Einrichtung vorbereiten sollte. Die technische Einrichtung findest du unter [DATEV mit anny verbinden](/datev-integration).

<Warning>
  Diese Dokumentation ersetzt keine steuerliche Beratung. Kontenrahmen, Steuersätze und Sonderfälle immer mit der Steuerkanzlei abstimmen.
</Warning>

<Warning>
  Importiere dieselbe Exportdatei **nicht doppelt**. Jede Buchungszeile trägt eine Buchungs-GUID und die Rechnungsnummer im Belegfeld 1 — trotzdem entstehen bei einem zweiten Import doppelte Buchungen, wenn DATEV die Datei erneut einspielt. Behalte den Überblick über bereits importierte Zeiträume.
</Warning>

## Was der Steuerberater vorbereiten muss

Bevor du die Integration aktivierst, brauchst du von deiner Kanzlei eine klare Vorgabe. Am besten schickst du diesen Artikel (oder die Checkliste) an deine Steuerberatung und lässt dir die Werte schriftlich bestätigen.

### Checkliste für die Steuerkanzlei

<Steps>
  <Step title="Stammdaten bestätigen">
    Beraternummer, Mandantennummer, Beginn des Geschäftsjahres und die Sachkontenlänge des Mandantenkontenrahmens (meist 4 Stellen bei SKR 03/04).
  </Step>

  <Step title="Kontenrahmen festlegen">
    Welcher Kontenrahmen gilt (z. B. SKR 03 oder SKR 04)? Die Platzhalter in anny orientieren sich an **SKR 03** — bei SKR 04 oder einem individuellen Rahmen müssen die Nummern angepasst werden.
  </Step>

  <Step title="Sachkonten zuordnen">
    Für jedes Pflichtkonto in anny die passende Kontonummer nennen. Optional: bereits Konten für Pfand, Anzahlungen und außer-Haus-Umsatz hinterlegen (derzeit noch nicht automatisch bebucht).
  </Step>

  <Step title="Verrechnungskonto Stripe / anny festlegen">
    Ein eigenes Konto für das anny-Zahlungskonto — zu behandeln wie ein **Bankkonto**. Darüber laufen alle Online-Zahlungen, Erstattungen, Gebühren und Auszahlungen.
  </Step>

  <Step title="Importweg und Empfänger festlegen">
    Wie die CSV in DATEV Kanzlei-Rechnungswesen importiert wird und an welche E-Mail-Adresse der Export gehen soll (Kanzlei-Postfach oder internes Buchhaltungs-Postfach).
  </Step>

  <Step title="Umgang mit Doppel- und Leer-Exporten klären">
    anny kann auf Abruf und nach Zeitplan exportieren. Dieselbe Datei darf nicht zweimal importiert werden. Leere Perioden erzeugen trotzdem eine Datei mit Kopfzeilen — das ist gewollt.
  </Step>
</Steps>

<Tip>
  Empfehlung an die Kanzlei: Export **monatlich**, Versandtag **3.–7.** des Folgemonats. So landen auch spät festgeschriebene Rechnungen des Vormonats im Stapel und der Rhythmus passt zur Umsatzsteuer-Voranmeldung.
</Tip>

### Was anny liefert — und was die Kanzlei noch macht

| anny erledigt | Kanzlei übernimmt |
| - | - |
| Buchungssätze als DATEV-Buchungsstapel (EXTF) per E-Mail | Import und Sichtung in DATEV |
| Zuordnung auf die hinterlegten Sachkonten | **Manuelle Festschreibung** nach Prüfung |
| Rechnungsnummer, Beleginfos, Buchungs-GUID | Abstimmung mit Bank und Belegen |
| Gebühren inkl. Steuersatz für Vorsteuer | Vorsteuerabzug und USt-Voranmeldung |
| Nur EUR und DE | Nicht-EUR-Vorgänge und Sonderfälle |

<Note>
  In der Exportdatei ist das Kennzeichen **Festschreibung** auf `0` gesetzt. Die Buchungen sind damit noch nicht festgeschrieben. Deine Steuerkanzlei kann den Stapel zuerst sichten und die Festschreibung anschließend **manuell** in DATEV vornehmen.
</Note>

Rechnungen ohne Online-Zahlung (z. B. Rechnungskauf oder Barzahlung) erscheinen nur als **Umsatz** (Forderungen an Erlöskonto). Den Zahlungsausgleich bucht die Kanzlei selbst, sobald das Geld auf dem Geschäftskonto eingeht.

## Stammdaten

| Feld in anny | Bedeutung | Quelle |
| - | - | - |
| Beraternummer | 1–7-stellige Nummer der Steuerkanzlei bei DATEV | Steuerberater |
| Mandantennummer | 1–5-stellige Nummer deiner Organisation beim Berater | Steuerberater |
| Beginn des Geschäftsjahres | Format `MM-TT`, z. B. `01-01` | Gesellschaftsvertrag / Kanzlei |
| Sachkontenlänge | Stellenanzahl der Sachkonten, Standard `4` | Kontenrahmen |

Ohne Berater- und Mandantennummer lässt sich die Integration nicht aktivieren — diese Werte stehen im DATEV-Dateikopf und müssen zum Mandanten in der Kanzlei passen.

## Die Konten im Überblick

anny gruppiert die Konten in drei Bereiche: **Konten**, **Umsatzkonten** und **Transferkonten**. Die Vorschläge beziehen sich auf den DATEV-Standardkontenrahmen **SKR 03**. Bei abweichendem Rahmen ersetzt die Kanzlei die Nummern.

### Konten (Bestand / Verrechnung)

#### Verrechnungskonto Stripe Connect

| | |
| - | - |
| **Rolle** | Virtuelles Bankkonto für alle Bewegungen über anny Payments |
| **SKR 03** | nach Absprache (eigenes Bank-/Verrechnungskonto) |
| **Wann bebucht** | Zahlungseingang, Erstattung, Rückbuchung, Gebühren, Auszahlung |

Das Verrechnungskonto ist wie ein **eigenes Bankkonto** zu verstehen: Es bildet den Saldo auf dem anny-Zahlungskonto (Stripe Connect) ab — nicht dein klassisches Geschäftsbankkonto bei der Hausbank.

* Kundenzahlungen erhöhen den Saldo (Verrechnungskonto an Forderungen).
* Gebühren und Erstattungen belasten das Verrechnungskonto.
* **Auszahlungen** von anny auf dein Geschäftsbankkonto sind **keine neuen Erlöse**, sondern **Umbuchungen**: Geldtransit an Verrechnungskonto. Die Gegenbuchung (Zahlungseingang auf dem Bankkonto) kommt über den Bankimport der Kanzlei.

<Note>
  Das Verrechnungskonto ist **Pflicht**. Ohne dieses Konto können Zahlungen, Gebühren und Auszahlungen nicht korrekt abgebildet werden.
</Note>

#### Forderungen aus Lieferungen und Leistungen

| | |
| - | - |
| **Rolle** | Sammelforderungen gegenüber Kunden (kein Personenkonto je Kunde) |
| **SKR 03 (üblich)** | `1400` |
| **Wann bebucht** | Bei festgeschriebener Rechnung (Soll); beim Zahlungseingang / bei Gutscheineinlösung (Haben); bei Erstattung / Rückbuchung (Soll) |

anny nutzt ein **kollektives** Forderungskonto. Es gibt keine Debitorenbuchhaltung je Kunde im Export. Offene Posten werden über Rechnungsnummer und Betrag nachvollzogen.

### Umsatzkonten

Die Erlöskonten werden anhand des Steuersatzes auf der Rechnung gewählt. Unbekannte Sätze (nicht 19 / 7 / 0 %) fallen auf das Konto für 19 % zurück; der tatsächliche Satz steht trotzdem in der DATEV-Spalte **Steuersatz**.

anny verwendet **automatische Konten** (keine BU-Schlüssel). Die Steuerkennzeichnung erfolgt über Steuersatz und Kontenzuordnung.

#### Reguläre Umsatzsteuer (19 %)

| | |
| - | - |
| **Rolle** | Erlöse zum Regelsteuersatz |
| **SKR 03 (üblich)** | `8400` |
| **Wann bebucht** | Festgeschriebene Rechnungspositionen mit 19 % USt |

#### Reduzierte Umsatzsteuer (7 %)

| | |
| - | - |
| **Rolle** | Erlöse zum ermäßigten Steuersatz |
| **SKR 03 (üblich)** | `8300` |
| **Wann bebucht** | Festgeschriebene Rechnungspositionen mit 7 % USt |

#### Keine Umsatzsteuer

| | |
| - | - |
| **Rolle** | Steuerfreie bzw. nicht steuerbare Umsätze |
| **SKR 03 (üblich)** | `8100` |
| **Wann bebucht** | Positionen mit 0 % USt (ohne Mehrzweckgutschein-Verkauf — der läuft über das Gutschein-Konto) |

#### Trinkgeld

| | |
| - | - |
| **Rolle** | Trinkgelder aus Online-Zahlungen |
| **SKR 03** | nach Absprache |
| **Wann bebucht** | Wenn auf der Zahlung / Rechnung Trinkgeld enthalten ist |

Trinkgeld wird getrennt vom Umsatz auf dieses Konto gebucht (Forderungen an Trinkgeld-Konto).

#### Wertgutscheine (anny)

| | |
| - | - |
| **Rolle** | Bestandskonto für verkaufte, noch nicht eingelöste Mehrzweckgutscheine |
| **SKR 03** | nach Absprache |
| **Wann bebucht** | Verkauf: Forderungen an Wertgutscheine (ohne USt); Einlösung: Wertgutscheine an Forderungen |

anny-Wertgutscheine sind **Mehrzweckgutscheine**: Beim Verkauf entsteht noch keine Umsatzsteuer. Der steuerpflichtige Umsatz entsteht erst bei der Einlösung auf der jeweiligen Leistungsrechnung.

<Info>
  Einzweckgutscheine (falls vorhanden) werden wie regulärer Umsatz auf den Erlöskonten gebucht — nicht über dieses Konto.
</Info>

Im SKR 03 wird dafür üblicherweise das Konto `1796` („Ausgegebene Geschenkgutscheine", SKR 04: `3786`) verwendet. Wann ein Gutschein steuerlich als Einzweck- oder Mehrzweckgutschein gilt, welche anny-Einstellungen die Einordnung beeinflussen und wann verfallene Gutscheine ausgebucht werden dürfen, steht in [Gutscheine & Umsatzsteuer](/voucher-taxation) — dieser Artikel eignet sich auch zur Vorlage bei der Steuerkanzlei.

<Warning>
  Der Gutschein-Verkauf darf **keinen** Umsatzsteuer-Schlüssel tragen. Wird versehentlich mit USt gebucht und ausgewiesen, entsteht ein unrichtiger Steuerausweis nach § 14c Abs. 1 UStG.
</Warning>

### Transferkonten

#### Konto für Geldbewegungen (Geldtransit)

| | |
| - | - |
| **Rolle** | Zwischenkonto für die Umbuchung Auszahlung anny → Geschäftsbankkonto |
| **SKR 03 (üblich)** | `1360` |
| **Wann bebucht** | Bei jeder erfolgreichen Auszahlung (inkl. negativer Auszahlung / Einzug): **Geldtransit an Verrechnungskonto** |

Auszahlungen sind in anny **bereits implementiert**: Für jede erfolgreiche Auszahlung vom anny-Zahlungskonto erzeugt der Export einen Buchungssatz auf dem Geldtransit-Konto gegen das Verrechnungskonto. Das ist eine reine Umbuchung — kein zusätzlicher Umsatz.

Die Gegenbuchung auf dem Geschäftsbankkonto (Zahlungseingang) erfolgt über den Bankimport der Kanzlei. anny bucht nur die Seite Verrechnungskonto / Geldtransit.

#### Nebenkosten des Geldverkehrs (anny-Gebühren)

| | |
| - | - |
| **Rolle** | Aufwandskonto für anny- und Zahlungsgebühren |
| **SKR 03 (üblich)** | `4970` |
| **Wann bebucht** | Einbehaltene Gebühren-Differenz und nachbelastete Gebühren |

Die [anny-Gebühren](/online-payments) enthalten USt (19 % für DE). Der Steuersatz steht in der DATEV-Spalte **Steuersatz**, damit die Vorsteuer gezogen werden kann. Bei nachbelasteten Gebühren steht die Nummer der anny-Gebührenrechnung im **Belegfeld 1**.

### Optionale Konten (derzeit nicht automatisch bebucht)

Diese Felder kannst du bereits hinterlegen. anny erzeugt dafür **noch keine** Buchungssätze — die Konten sind für spätere Erweiterungen bzw. manuelle Abstimmung vorgesehen:

| Einstellung | Bedeutung | Hinweis |
| - | - | - |
| Reduzierte Umsatzsteuer außer Haus (7 %) | Ermäßigte Erlöse Außer-Haus | Noch nicht bebucht |
| Pfand | Pfandbeträge | Noch nicht bebucht |
| Anzahlung (reguläre / reduzierte USt) | Erhaltene Anzahlungen | Noch nicht bebucht |

## Typischer Buchungsfluss (Kurzüberblick)

```mermaid theme={null}
flowchart LR
  invoice[Rechnung festgeschrieben] --> receivables[Forderungen]
  receivables --> revenue[Erlöskonto nach USt]
  payment[Zahlungseingang] --> clearing[Verrechnungskonto wie Bank]
  clearing --> receivables
  fee[anny-Gebühr] --> fees[Nebenkosten Geldverkehr]
  fees --> clearing
  payout[Auszahlung Umbuchung] --> transit[Geldtransit]
  transit --> clearing
```

| Geschäftsvorfall | Soll | Haben |
| - | - | - |
| Rechnung (je USt-Satz) | Forderungen | Erlöskonto |
| Wertgutschein-Verkauf | Forderungen | Wertgutscheine |
| Wertgutschein-Einlösung | Wertgutscheine | Forderungen |
| Trinkgeld | Forderungen | Trinkgeld |
| Zahlungseingang | Verrechnungskonto | Forderungen |
| anny-Gebühr | Nebenkosten Geldverkehr | Verrechnungskonto |
| Erstattung (Refund) | Forderungen | Verrechnungskonto |
| Dispute / Rückbuchung | Forderungen | Verrechnungskonto |
| Auszahlung (Umbuchung) | Geldtransit | Verrechnungskonto |

<Note>
  **Dispute vs. Erstattung:** Bei einer Zahlungsanfechtung (Dispute) bucht anny nur die Zahlung zurück — der Umsatz auf dem Erlöskonto wird **nicht** reduziert. Bei einer Erstattung entsteht zusätzlich eine Stornorechnung, die den Umsatz ausgleicht. Details: [DATEV mit anny verbinden](/datev-integration#erstattungen-und-zahlungsanfechtungen-disputes).
</Note>

## Empfehlungen für die Steuerkanzlei nach dem Import

1. **Buchungsstapel einmal importieren** — dieselbe Datei nicht erneut einspielen.
2. **Sichten** anhand Rechnungsnummer und Betrag; die Spalte / das Kennzeichen **Festschreibung** ist `0`.
3. Nach Prüfung die **Festschreibung manuell** in DATEV setzen.
4. **Auszahlungen** mit dem Bankeingang auf dem Geschäftskonto abstimmen (Geldtransit ↔ Bank) — Auszahlungen sind Umbuchungen vom Verrechnungskonto.
5. **Gebühren** und Vorsteuer anhand der anny-Gebührenrechnung prüfen.
6. Leere Perioden und Abruf-Exporte im Blick behalten, damit Zeiträume nicht doppelt importiert werden.

## Häufige Fragen

<AccordionGroup>
  <Accordion title="Ist das eine Anbindung an DATEV Unternehmen online?">
    Nein. anny erzeugt eine Exportdatei und sendet sie per E-Mail. Es gibt keine native / Live-Integration zu DATEV Unternehmen online. Der Import erfolgt in DATEV Kanzlei-Rechnungswesen (oder vergleichbarer Software) über den DATEV-Buchungsstapel.
  </Accordion>

  <Accordion title="Müssen wir SKR 03 verwenden?">
    Nein. SKR 03 ist nur die Vorlage für die Platzhalter in anny. Bei SKR 04 oder einem individuellen Kontenrahmen trägst du die von der Kanzlei genannten Nummern ein — die Logik der Buchungen bleibt gleich.
  </Accordion>

  <Accordion title="Brauchen wir Debitorenkonten je Kunde?">
    Nein. anny bucht auf ein Sammelforderungskonto. Eine personenbezogene OPOS-Führung ist im Export nicht enthalten.
  </Accordion>

  <Accordion title="Warum gibt es ein separates Gutschein-Konto?">
    Weil Mehrzweckgutscheine beim Verkauf noch nicht der Umsatzsteuer unterliegen. Das Bestandskonto trennt den noch nicht erbrachten Umsatz vom steuerpflichtigen Erlös bei Einlösung. Die vollständige Einordnung inklusive Rechtsgrundlagen: [Gutscheine & Umsatzsteuer](/voucher-taxation).
  </Accordion>

  <Accordion title="Wann dürfen nicht eingelöste Gutscheine ausgebucht werden?">
    Umsatzsteuerlich löst der Verfall eines Mehrzweckgutscheins nichts aus. Ertragsteuerlich bleibt die Verbindlichkeit auf dem Gutschein-Konto stehen, bis der Anspruch verjährt ist — in der Regel drei Jahre ab Schluss des Ausgabejahres (§§ 195, 199 BGB). Die Ausbuchung erfolgt dann gegen sonstige betriebliche Erträge, ohne Steuerschlüssel. anny bucht das **nicht automatisch**; die Ausbuchung nimmt die Steuerkanzlei im Jahresabschluss vor. Details: [Gutscheine & Umsatzsteuer](/voucher-taxation).
  </Accordion>

  <Accordion title="Wie unterscheiden sich Kontoauszug-Export und DATEV-Buchungsstapel?">
    Der [Kontoauszug / CAMT-Export](/accounting) bildet die Bewegungen auf dem anny-Zahlungskonto ab. Die DATEV-Integration liefert fertige **Soll-/Haben-Buchungssätze** (Umsatz, Zahlung, Gebühr, Auszahlung) auf die hinterlegten Sachkonten. Beides kann sich ergänzen — stimme den Workflow mit der Kanzlei ab.
  </Accordion>

  <Accordion title="Was passiert bei einer Zahlungsanfechtung (Dispute)?">
    anny bucht nur die Zahlung zurück (Forderungen an Verrechnungskonto, Buchungstext „Rückbuchung"). Der Umsatz wird **nicht** automatisch storniert. Im Unterschied zur Erstattung gibt es keine Stornorechnung. Ob der Umsatz nachträglich korrigiert wird, entscheidet die Steuerkanzlei.
  </Accordion>

  <Accordion title="Was passiert bei gemischten Rechnungen?">
    Enthält eine Rechnung mehrere Steuersätze oder Gutschein plus steuerpflichtige Leistung, erzeugt anny je Steuergruppe einen eigenen Buchungssatz.
  </Accordion>
</AccordionGroup>

## Nächste Schritte

1. Checkliste an die Steuerkanzlei schicken und Kontonummern bestätigen lassen
2. Werte in anny eintragen und die Integration aktivieren: [DATEV mit anny verbinden](/datev-integration)

<Info>
  Bei Unsicherheiten zu Konten oder Steuersätzen immer die Steuerkanzlei fragen — anny bildet nur die von dir hinterlegte Zuordnung ab.
</Info>

> Wichtige Informationen für Agenten:
>
> **Zweck dieses Artikels:** Erklärung der Sachkonten und Vorbereitung durch den Steuerberater. Einrichtungsschritte stehen in `datev-integration`.
>
> **Kein DATEV Unternehmen online:** Nur E-Mail-Versand einer EXTF-CSV, keine native Anbindung.
>
> **Festschreibung:** Header-Kennzeichen 0 — Kanzlei sichtet und festschreibt manuell. Dateien nicht doppelt importieren.
>
> **Verrechnungskonto:** wie Bankkonto; Auszahlungen = Umbuchung Geldtransit an Verrechnungskonto (bereits implementiert in `DatevBookingCollector::collectPayoutRows`).
>
> **Disputes:** Nur Zahlungsrückbuchung („Rückbuchung") — **kein** Umsatzstorno. Erstattungen erzeugen zusätzlich eine Stornorechnung.
>
> **Pflichtkonten:** stripe\_clearing, receivables, revenue\_standard (19 %), revenue\_reduced (7 %), revenue\_no\_vat, tip, vouchers, money\_transit, payment\_fees — plus Beraternummer, Mandantennummer, ≥1 Empfänger.
>
> **Optional / noch nicht bebucht:** revenue\_reduced\_takeaway, deposit, down\_payment\_standard, down\_payment\_reduced.
>
> **Dateiname:** `EXTF_Buchungsstapel_{organizationUuid}_{Ymd}-{Ymd}.csv`. Betreff: `anny DATEV-Export :period für :organization`.
>
> **Abgrenzung:** Nicht verwechseln mit `buchhaltung-mit-anny` (CAMT/Kontoauszug).


# DATEV mit anny verbinden
Source: https://docs.anny.co/datev-integration

Exportiere Rechnungen und Zahlungen deiner Organisation automatisch als DATEV-Buchungsstapel und sende sie an deine Steuerkanzlei.

Mit der DATEV-Integration erzeugt anny **keine native Anbindung** an DATEV Unternehmen online. Stattdessen erstellt anny regelmäßig (oder auf Abruf) eine DATEV-Buchungsstapel-Datei (EXTF-Format) und sendet sie automatisch per E-Mail an deine Buchhaltung oder Steuerkanzlei. Die Datei lässt sich dort in DATEV Kanzlei-Rechnungswesen importieren.

<Note>
  Die Integration unterstützt Organisationen mit Sitz in **Deutschland** und Zahlungen in **EUR** über anny Payments (Stripe). Verfügbar ab dem **Essential**-Plan.
</Note>

## Voraussetzungen

* Aktivierte anny Payments, siehe [Stripe Connect einrichten](/stripe-connect-setup)
* **Beraternummer** und **Mandantennummer** deiner Steuerkanzlei
* Die **Sachkonten** deines Kontenrahmens für die Kontenzuordnung

<Warning>
  Die Kontenvorschläge orientieren sich am DATEV-Standardkontenrahmen **SKR 03**. Stimme die Kontenzuordnung vor der Aktivierung mit deiner Steuerkanzlei ab. Sie ist die Grundlage für eine steuerlich korrekte Buchführung.
</Warning>

## Integration einrichten

<Steps>
  <Step title="Integration hinzufügen">
    Öffne **Organisationseinstellungen → Integrationen**, suche die Karte **DATEV** und klicke auf **Einrichten**. Die Einstellungen der Integration öffnen sich automatisch.
  </Step>

  <Step title="Stammdaten eintragen">
    Trage die Daten ein, die du von deiner Steuerkanzlei erhältst:

    | Feld | Beschreibung |
    | - | - |
    | Beraternummer | 1–7-stellige Nummer deiner Steuerkanzlei |
    | Mandantennummer | 1–5-stellige Nummer deiner Organisation bei der Kanzlei |
    | Beginn des Geschäftsjahres | Format `MM-TT`, z. B. `01-01` für den 1. Januar |
    | Sachkontenlänge | Standard: `4` (SKR 03/04) |
  </Step>

  <Step title="Konten zuordnen">
    Ordne die Sachkonten zu. Für SKR 03 sind gängige Werte als Platzhalter hinterlegt.

    Welche Rolle jedes Konto hat und was dein Steuerberater vorbereiten muss, steht ausführlich unter [DATEV-Konten und Vorbereitung mit dem Steuerberater](/datev-konten-steuerberater).

    | Einstellung | Verwendung | SKR 03 (üblich) |
    | - | - | - |
    | Verrechnungskonto Stripe Connect | Alle anny-Zahlungen (wie ein Bankkonto) | nach Absprache mit SB |
    | Forderungen aus Lieferungen und Leistungen | Offene Kundenforderungen | 1400 |
    | Reguläre Umsatzsteuer (19 %) | Umsätze zum Regelsteuersatz | 8400 |
    | Reduzierte Umsatzsteuer (7 %) | Umsätze zum ermäßigten Steuersatz | 8300 |
    | Keine Umsatzsteuer | Steuerfreie Umsätze | 8100 |
    | Trinkgeld | Trinkgelder aus Zahlungen | nach Absprache mit SB |
    | Wertgutscheine (anny) | Verkauf und Einlösung von Mehrzweckgutscheinen | nach Absprache mit SB |
    | Konto für Geldbewegungen | Auszahlungen = Umbuchung (Geldtransit) | 1360 |
    | Nebenkosten des Geldverkehrs | anny-Gebühren | 4970 |

    Die Felder für Pfand, Anzahlungen und reduzierte Umsatzsteuer außer Haus kannst du bereits hinterlegen. Sie werden derzeit noch nicht automatisch bebucht und sind lediglich Platzhalter für zukünftige Funktionen.
  </Step>

  <Step title="Export-Zeitplan festlegen">
    Wähle, wie oft der Export erstellt wird, und die Uhrzeit in der Zeitzone deiner Organisation. Exportiert wird immer der zuletzt abgeschlossene Zeitraum:

    * **Wöchentlich** an einem Wochentag deiner Wahl → Export der Vorwoche
    * **Monatlich** an Tag 1–7 des Monats → Export des Vormonats
    * **Quartalsweise** an Tag 1–7 des ersten Quartalsmonats → Export des Vorquartals

    <Tip>
      Empfehlung: **monatlich, Tag 3–7, früh morgens**.
    </Tip>
  </Step>

  <Step title="E-Mail-Empfänger hinterlegen">
    Füge eine oder mehrere E-Mail-Adressen hinzu, zum Beispiel das Postfach deiner Steuerkanzlei. An diese Adressen sendet anny die Exportdatei als Anhang. Der Betreff lautet z. B. `anny DATEV-Export 01.06.2026 - 30.06.2026 für Deine Organisation`.
  </Step>

  <Step title="Speichern und aktivieren">
    Speichere die Einstellungen und aktiviere die Integration über den Schalter auf der Integrationskarte.

    <Check>
      Die Integration ist aktiv, sobald der Schalter grün ist. Der erste Export wird zum nächsten geplanten Termin erstellt und versendet.
    </Check>

    Die Aktivierung ist erst möglich, wenn Stammdaten, Pflichtkonten und mindestens ein Empfänger hinterlegt sind.
  </Step>
</Steps>

## Export für einen bestimmten Zeitraum erstellen

Zusätzlich zum automatischen Zeitplan kannst du jederzeit einen Export auf Abruf erstellen:

1. Öffne die DATEV-Integrationseinstellungen.
2. Wähle im Bereich **Export auf Abruf** einen Zeitraum, z. B. **Letzter Monat**, **Dieser Monat** oder über **Benutzerdefiniert** einen eigenen Datumsbereich.
3. Klicke auf **Export erstellen**.

anny erstellt die Datei im Hintergrund und sendet sie an die hinterlegten E-Mail-Empfänger.

<Warning>
  Exporte auf Abruf können sich zeitlich mit den automatischen Exporten überschneiden. Importiere denselben Zeitraum nicht doppelt. Bei Unsicherheit prüfe Organisations-ID und Zeitraum im Dateinamen.
</Warning>

## Was wird wie gebucht?

Die Integration erstellt für jeden Geschäftsvorfall einen Buchungssatz:

| Geschäftsvorfall | Buchungsdatum | Buchung (Soll an Haben) |
| - | - | - |
| Festgeschriebene Rechnung (je USt-Satz) | Rechnungsdatum | Forderungen an Erlöskonto |
| Verkauf Wertgutschein (Mehrzweck, ohne USt) | Rechnungsdatum | Forderungen an Wertgutschein-Konto |
| Einlösung Wertgutschein | Rechnungsdatum | Wertgutschein-Konto an Forderungen |
| Trinkgeld | Rechnungsdatum | Forderungen an Trinkgeld-Konto |
| Zahlungseingang (voller Zahlbetrag) | Wertstellung | Verrechnungskonto an Forderungen |
| anny-Gebühr (einbehalten oder nachbelastet) | Wertstellung / Belastung | Nebenkosten Geldverkehr an Verrechnungskonto |
| Erstattung (Refund) | Wertstellung | Forderungen an Verrechnungskonto |
| Zahlungsanfechtung / Dispute (Rückbuchung) | Wertstellung | Forderungen an Verrechnungskonto |
| Auszahlung aufs Bankkonto (Umbuchung) | Auszahlungsdatum | Geldtransit an Verrechnungskonto |

Das **Verrechnungskonto** ist wie ein Bankkonto zu verstehen: Es bildet das anny-Zahlungskonto ab. Auszahlungen von anny sind keine Erlöse, sondern **Umbuchungen** vom Verrechnungskonto über das **Geldtransit**-Konto auf dein Geschäftsbankkonto (Gegenbuchung über den Bankimport). Diese Auszahlungsbuchungen sind bereits Bestandteil des Exports.

Gutschriften und Stornorechnungen bucht die Integration automatisch mit umgekehrtem Soll/Haben-Kennzeichen. Enthält eine Rechnung mehrere Steuersätze oder eine Mischung aus Gutschein und steuerpflichtiger Leistung, zum Beispiel Versand, entsteht je Steuergruppe ein eigener Buchungssatz.

### Erstattungen und Zahlungsanfechtungen (Disputes)

Beide Fälle buchen den Geldfluss zurück (**Forderungen an Verrechnungskonto**), unterscheiden sich aber beim Umsatz:

| | Erstattung (Refund) | Zahlungsanfechtung (Dispute / Chargeback) |
| - | - | - |
| Buchungstext | Erstattung | Rückbuchung |
| Zahlung | wird zurückgebucht | wird zurückgebucht |
| Umsatz / Erlöskonto | wird ausgeglichen — anny erstellt zusätzlich eine **Stornorechnung**, die den Umsatz storniert | wird **nicht** reduziert — es gibt **keine** automatische Stornorechnung |

Bei einer verlorenen Zahlungsanfechtung bleibt die ursprüngliche Umsatzbuchung (Forderungen an Erlöskonto) bestehen. anny bucht nur die Zahlung zurück. Ob und wie der Umsatz steuerlich nachträglich korrigiert wird, entscheidet deine Steuerkanzlei.

<Note>
  Optionaler Differenzbetrag einer Anfechtung (Charge gegen Forderungen) ist ebenfalls nur eine Zahlungsrückbuchung, kein Umsatzstorno. Eine etwaige Bearbeitungsgebühr würde auf die Nebenkosten des Geldverkehrs gebucht — anny gibt solche Dispute-Gebühren in der Regel nicht weiter.
</Note>

### anny-Gebühren und Vorsteuer

Die [anny-Gebühren](/online-payments) enthalten die gesetzliche Umsatzsteuer (19 % für deutsche Organisationen). Die Gebühren-Buchungen tragen den Steuersatz in der DATEV-Spalte **Steuersatz**, sodass deine Kanzlei die Vorsteuer ziehen kann. Als Beleg dient die anny-Gebührenrechnung: bei nachbelasteten Gebühren steht ihre Nummer im **Belegfeld 1**. Die Gebührenrechnung selbst ist eine Eingangsrechnung und wird nicht als Umsatz exportiert.

### Wertgutscheine

anny-Wertgutscheine sind Mehrzweckgutscheine: Beim Verkauf fällt noch keine Umsatzsteuer an, der Betrag wird auf das Wertgutschein-Konto gebucht. Erst bei der Einlösung entsteht der steuerpflichtige Umsatz auf der jeweiligen Rechnung. Der eingelöste Betrag gleicht die Forderung vom Wertgutschein-Konto aus.

## Die Exportdatei

* **Format:** DATEV-Buchungsstapel EXTF, Version 700/12 (Kategorie 21)
* **Kodierung:** Windows-1252, Trennzeichen Semikolon, direkt in DATEV importierbar
* **Dateiname:** `EXTF_Buchungsstapel_{Organisations-ID}_{JJJJMMTT}-{JJJJMMTT}.csv` — der DATEV-Präfix `EXTF_Buchungsstapel` bleibt erhalten, ergänzt um Organisations-ID und Zeitraum
* **E-Mail-Betreff:** `anny DATEV-Export {Zeitraum} für {Organisationsname}`
* **Festschreibung:** Kennzeichen `0` (nicht festgeschrieben). Deine Kanzlei sichtet den Stapel und nimmt die Festschreibung manuell vor
* **Referenzen:** Rechnungsnummer im Belegfeld 1, anny- und Stripe-Referenzen in den Beleginfo-Feldern, eindeutige Buchungs-GUID je Buchungssatz

## Häufige Fragen

<AccordionGroup>
  <Accordion title="Ist das eine Anbindung an DATEV Unternehmen online?">
    Nein. anny erzeugt eine Exportdatei und sendet sie per E-Mail. Es gibt keine native Live-Integration zu DATEV Unternehmen online.
  </Accordion>

  <Accordion title="Warum kann ich die Integration nicht aktivieren?">
    Die Aktivierung setzt voraus, dass Beraternummer, Mandantennummer, alle Pflichtkonten und mindestens ein E-Mail-Empfänger hinterlegt sind. Prüfe die Einstellungen auf leere Felder und speichere erneut.
  </Accordion>

  <Accordion title="Was passiert mit Rechnungen, die erst nach dem Export festgeschrieben werden?">
    Der Export umfasst Rechnungen anhand ihres Rechnungsdatums im jeweiligen Zeitraum. Wird eine Rechnung erst nach dem Export ihres Zeitraums festgeschrieben, erscheint sie nicht automatisch im Folgeexport. Wähle den Export-Tag deshalb mit Puffer (Tag 3–7) oder erstelle bei Bedarf einen Export auf Abruf für den betroffenen Zeitraum.
  </Accordion>

  <Accordion title="Kann ich das Export-Intervall später ändern?">
    Ja. Beim Wechsel, zum Beispiel von monatlich auf wöchentlich, kann sich der nächste Exportzeitraum mit bereits exportierten Zeiträumen überschneiden. Stimme den Wechsel mit deiner Kanzlei ab und importiere Zeiträume nicht doppelt.
  </Accordion>

  <Accordion title="Es kam ein Export ohne Buchungen an. Ist das ein Fehler?">
    Nein. Gab es im Zeitraum keine festgeschriebenen Rechnungen, Zahlungen oder Auszahlungen, enthält die Datei nur die Kopfzeilen. Der Versand erfolgt trotzdem, damit deine Kanzlei weiß, dass der Zeitraum leer war.
  </Accordion>

  <Accordion title="Welche Zahlungen werden nicht exportiert?">
    Rechnungen ohne Online-Zahlung, zum Beispiel Rechnungskauf oder Barzahlung, werden nur als Umsatz gebucht. Den Zahlungsausgleich bucht deine Buchhaltung. Rechnungen in anderen Währungen als EUR fallen vollständig aus dem Export, also auch ihr Umsatz. anny exportiert ausschließlich Vorgänge in EUR.
  </Accordion>

  <Accordion title="Wie werden Erstattungen und Rückbuchungen gebucht?">
    **Erstattungen** (Buchungstext „Erstattung"): Die Zahlung wird zurückgebucht (Forderungen an Verrechnungskonto). Zusätzlich erstellt anny eine **Stornorechnung**, die den Umsatz auf den Erlöskonten ausgleicht.

    **Zahlungsanfechtungen / Disputes** (Buchungstext „Rückbuchung"): Es wird **nur die Zahlung** zurückgebucht (Forderungen an Verrechnungskonto). Der Umsatz wird **nicht** automatisch reduziert — es gibt keine Stornorechnung. Die ursprüngliche Erlösbuchung bleibt bestehen; eine etwaige umsatzseitige Korrektur übernimmt die Steuerkanzlei.
  </Accordion>

  <Accordion title="Wann genau wird der Export versendet?">
    anny prüft die fälligen Exporte stündlich. Die eingestellte Uhrzeit legt den nächsten Lauf fest, die Zustellung kann sich aber um bis zu etwa eine Stunde verzögern. Plane den Termin deshalb nicht auf eine minutengenaue Zustellung, sondern mit etwas Puffer.
  </Accordion>

  <Accordion title="Was passiert, wenn der Versand fehlschlägt?">
    anny wiederholt die Erstellung eines Exports automatisch. Gelingt sie endgültig nicht, erscheint ein Fehlerhinweis in den Integrationseinstellungen. Ein fehlgeschlagener Lauf blockiert die künftigen geplanten Exporte nicht, weil der nächste Termin bereits vorher gesetzt wird.
  </Accordion>
</AccordionGroup>

<Info>
  Diese Dokumentation ersetzt keine steuerliche Beratung. Stimme Kontenrahmen, Steuersätze und den Umgang mit Sonderfällen mit deiner Steuerkanzlei ab.
</Info>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** DATEV-Buchungsstapel (EXTF-CSV) per E-Mail — keine native Anbindung an DATEV Unternehmen online.
>
> **Dateiname / Betreff:** `EXTF_Buchungsstapel_{organizationUuid|id}_{Ymd}-{Ymd}.csv`; Betreff `anny DATEV-Export :period für :organization`.
>
> **Festschreibung:** Header-Kennzeichen 0 — Kanzlei sichtet und festschreibt manuell. Dateien nicht doppelt importieren.
>
> **Verrechnungskonto:** wie Bankkonto; Auszahlungen = Umbuchung Geldtransit an Verrechnungskonto (`collectPayoutRows`, bereits implementiert).
>
> **Disputes / Rückbuchung:** Nur Zahlungsrückbuchung (Forderungen an Verrechnungskonto). **Kein** automatisches Umsatzstorno / keine Stornorechnung. Erstattungen hingegen erzeugen zusätzlich eine Stornorechnung.
>
> **Voraussetzungen/Gating:** Nur DE + EUR, anny Payments (Stripe Connect), Accounting-Feature. Plan: Essential und höher (`INTEGRATIONS_ACCOUNTING`, seit Sep 2026 nicht mehr erst ab Professional).
>
> **UI-Pfade:** Organisationseinstellungen → Integrationen → DATEV. Stammdaten, Konten, Umsatzkonten, Transferkonten, Export-Zeitplan, Export auf Abruf.
>
> **Pflichtkonten:** Verrechnungskonto, Forderungen, 19 %, 7 %, keine USt, Trinkgeld, Wertgutscheine, Geldtransit, Nebenkosten; plus Berater-/Mandantennummer und ≥1 Empfänger. Optional/nicht bebucht: Pfand, Anzahlung, außer Haus.


# Admin Booking Creation
Source: https://docs.anny.co/developers/guides/admin/booking-creation



Create bookings and orders directly from the admin API using the `orders/from-config` endpoint. This bypasses the public checkout flow and is designed for back-office operations.

The same endpoint also **edits** an existing order when the config carries an `order_id` — see [Editing an Existing Order](#editing-an-existing-order). To change one confirmed booking in place (resource, dates, fields, add-ons, sub-bookings) without rewriting the whole order, use [Admin Booking Edit](/developers/guides/admin/booking-edit).

For the public checkout flow, see [Order & Checkout Flow](/developers/guides/customer/checkout). For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions).

***

## Prerequisites

* A valid Bearer token with admin access — see [Authentication](/developers/guides/authentication)
* Organization context (`?o={organization_id}`)
* At least one resource and service configured in the organization

***

## Recommended Flow (Admin UI Forms)

For Admin UI integrations, prefer the dynamic form flow over manually assembling all custom-field and participant payloads.

### Step A - Build a Dynamic Checkout Form

```http theme={null}
POST /api/v1/ui/admin/checkout-form?o={org_id}

{
  "booking_config": {
    "order_customer_id": null,
    "bookings": [
      {
        "customer_id": null,
        "service_id": { "{service_uuid}": 1 },
        "resource_id": "{resource_uuid}",
        "start_date": "2026-04-15T09:00:00+02:00",
        "end_date": "2026-04-15T10:00:00+02:00"
      },
      {
        "customer_id": "{optional_existing_customer_uuid}",
        "service_id": { "{service_uuid}": 1 },
        "resource_id": "{resource_uuid}",
        "start_date": "2026-04-15T10:00:00+02:00",
        "end_date": "2026-04-15T11:00:00+02:00"
      }
    ]
  }
}
```

This returns a form object (`components`, `validations`, `default`) that includes:

* customer group (`customer-group`)
* customer custom fields
* order custom fields
* per-booking personalization groups (booking custom fields, host, participants)

### Step B - Apply Submitted Form Data

```http theme={null}
POST /api/v1/ui/admin/checkout-form/apply?o={org_id}

{
  "form_data": {
    "customer": {
      "email": "newcustomer@example.com",
      "given_name": "Test",
      "family_name": "Customer"
    },
    "bookings_data": {
      "b_205": {
        "service_custom_fields": {
          "{custom_field_uuid}": "Wheelchair access"
        },
        "participants": [
          {
            "email": "participant@example.com",
            "given_name": "Alex",
            "family_name": "Example"
          }
        ]
      }
    }
  },
  "booking_config": {
    "bookings": [
      {
        "_booking_id": 205,
        "resource_id": "{resource_uuid}",
        "service_id": { "{service_uuid}": 1 },
        "start_date": "2026-04-15T09:00:00+02:00",
        "end_date": "2026-04-15T10:00:00+02:00"
      }
    ]
  }
}
```

The response is an enriched config that is directly compatible with `POST /api/v1/orders/from-config`.

### Step C - Create the Order

Use the enriched payload from Step B as input for `POST /api/v1/orders/from-config`.

### Standalone Forms for Existing Records

You can also fetch standalone admin UI forms for existing records, such as customer, order, and booking edit forms.

The payload structure and persistence rules for those admin UI form endpoints are documented in [Admin UI Forms](/developers/guides/internal/admin-ui-forms), not in this booking-creation guide.

***

## When to Use

| Scenario | Use |
| - | - |
| Customer books through the website | [Public Checkout](/developers/guides/customer/checkout) |
| Admin creates a booking on behalf of a customer | **This guide** |
| Bulk/batch booking creation | **This guide** |
| Booking without availability check (override) | **This guide** |
| Admin edits an existing order | [Editing an Existing Order](#editing-an-existing-order) |
| Admin edits one confirmed booking | [Admin Booking Edit](/developers/guides/admin/booking-edit) |

***

## Step 1 — Pre-Calculate Pricing (Optional)

Request path documentation:

* `paths/admin/orders.yaml` for `POST /api/v1/orders/calculate`

Before creating the order, preview the pricing and resolve available booking quota grants:

```http theme={null}
POST /api/v1/orders/calculate?o={org_id}

{
  "order_customer_id": "{customer_uuid}",
  "bookings": [
    {
      "booking_ref": "bk-1",
      "resource_id": "{resource_uuid}",
      "service_id": { "{service_uuid}": 1 },
      "start_date": "2026-04-15T09:00:00+02:00",
      "end_date": "2026-04-15T10:00:00+02:00"
    }
  ],
  "voucher_code": "SUMMER20",
  "booking_code": "PASS123"
}
```

Returns calculated totals, taxes, and per-booking pricing without persisting anything.

Each booking in the response includes `services_label`: the concatenated service list the admin calendar already shows for sequenced services (for example `1 x Cut, 1 x Wash`). For a single service it matches `service.name`.

Each booking also includes a `booking_quota_grants` array with all eligible grants, their applicability, projected usage, and which one is preselected. This allows the UI to display a grant selection dropdown directly from the calculate response — no separate endpoint call needed.

When the user selects a different grant, re-call calculate with `booking_quota_grant_id` set on the booking. Set `prevent_applying_default_quota: true` to deselect all grants.

<Note>
  With an `order_id`, `orders/calculate` previews an **edit** of that order instead: it runs the same resolution and planning as `orders/from-config` without writing anything. See [Preview an edit](#step-2-preview-the-edit-optional) under Editing an Existing Order.
</Note>

***

## Step 2 — Create the Order

Request path documentation:

* `paths/admin/orders.yaml` for `POST /api/v1/orders/from-config`

```http theme={null}
POST /api/v1/orders/from-config?o={org_id}

{
  "order_customer_id": "{customer_uuid}",
  "bookings": [
    {
      "resource_id": "{resource_uuid}",
      "service_id": { "{service_uuid}": 1 },
      "start_date": "2026-04-15T09:00:00+02:00",
      "end_date": "2026-04-15T10:00:00+02:00",
      "quantity": 1,
      "description": "Team meeting",
      "booking_add_ons": [
        { "add_on_id": "{add_on_uuid}", "quantity": 2 }
      ]
    }
  ],
  "notify_customer": true,
  "complete_order": true,
  "check_availability": true,
  "timezone": "Europe/Berlin"
}
```

### Top-Level Fields

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `order_id` | string | No | — | Existing order to update. Absent creates a new order — see [Editing an Existing Order](#editing-an-existing-order). |
| `order_customer_id` | string | No | — | Customer UUID for the entire order |
| `bookings` | array | Yes\* | — | Array of booking configurations. \*May be empty or omitted when `add_ons` or `booking_passes` are present. |
| `add_ons` | array | No | — | Standalone add-ons `{ add_on_id, quantity, custom_price }`, billed on the order invoice. `custom_price` replaces the per-unit price. |
| `booking_passes` | array | No | — | Booking passes from bundles `{ booking_bundle_id, quantity, custom_amount }`, billed on the order invoice |
| `voucher_code` | string | No | — | Discount voucher code |
| `discount_relative` | number | No | — | Ad-hoc percentage discount (0.01–100). Mutually exclusive with `voucher_code`. |
| `discount_absolute` | number | No | — | Ad-hoc fixed-amount discount. Mutually exclusive with `voucher_code`. |
| `notify_customer` | boolean | No | `true` | Send confirmation email to customer |
| `complete_order` | boolean | No | `true` | `false` creates a draft order |
| `check_availability` | boolean | No | `true` | `false` skips availability validation |
| `timezone` | string | No | — | Timezone for date interpretation |

### Booking Object Fields

| Field | Type | Required | Description |
| - | - | - | - |
| `resource_id` | string/array | Yes | Resource UUID(s). Array for multi-resource bookings. |
| `service_id` | object | Yes | Map of `service_uuid → quantity` (e.g. `{"uuid": 1}`) |
| `start_date` | string | Yes\* | Booking start (Atom format). \*Optional when `booking_id` is set; the booking keeps its current period. |
| `end_date` | string | Yes\* | Booking end (Atom format). \*Optional when `booking_id` is set. |
| `customer_id` | string | No | Per-booking customer (overrides `order_customer_id`) |
| `quantity` | integer | No | Number of slots/participants |
| `booking_id` | string | No | Persisted booking this entry updates. Only read when the config carries an `order_id` — see [Editing an Existing Order](#editing-an-existing-order). |
| `custom_price` | number | No | Admin override of the booking subtotal. Add-ons are unaffected. |
| `booking_quota_grant_id` | string | No | Quota grant to charge this booking against |
| `availability_override` | boolean | No | Skip the availability check for this booking only |
| `host` | string | No | Host email address |
| `participants` | array | No | Array of `{ email, name, can_edit, attending_virtually }` |
| `description` | string | No | Internal description |
| `note` | string | No | Admin-visible note |
| `customer_note` | string | No | Customer-visible note |
| `booking_add_ons` | array | No | Array of `{ add_on_id, quantity }` |
| `sub_bookings` | array | No | Array of `{ service_id, resource_id, quantity }` for linked sub-bookings |
| `service_custom_fields` | object | No | Custom field values (UUID → value) |
| `order_custom_fields` | object | No | Order-level custom field values |
| `recurring` | object | No | Recurring rules (frequency, interval, until, count) |
| `timeslot_series_id` | string | No | Link to a specific timeslot series |

### Response

Returns a standard JSON-API `orders` resource with the created bookings:

```json theme={null}
{
  "data": {
    "type": "orders",
    "id": "order-uuid",
    "attributes": {
      "status": "completed",
      "manually_created": true,
      "total": 5000,
      "currency": "EUR"
    },
    "relationships": {
      "bookings": {
        "data": [{ "type": "bookings", "id": "b1" }]
      },
      "customer": {
        "data": { "type": "customers", "id": "c1" }
      }
    }
  }
}
```

***

## Multiple Bookings in One Order

Add multiple booking objects to create them in a single order:

```json theme={null}
{
  "order_customer_id": "{customer_uuid}",
  "bookings": [
    {
      "resource_id": "{room_uuid}",
      "service_id": { "{meeting_service}": 1 },
      "start_date": "2026-04-15T09:00:00+02:00",
      "end_date": "2026-04-15T10:00:00+02:00"
    },
    {
      "resource_id": "{desk_uuid}",
      "service_id": { "{desk_service}": 1 },
      "start_date": "2026-04-15T10:00:00+02:00",
      "end_date": "2026-04-15T17:00:00+02:00"
    }
  ]
}
```

***

## Editing an Existing Order

An order that already exists can be read back as a config, edited, and posted to the very same `orders/from-config` endpoint. The config carries an `order_id`, and that is what tells the endpoint to update that order instead of creating a new one. The config is the **complete desired state** of the order, so one document drives updates, additions and removals in a single request.

To change **one** confirmed booking without rewriting the order, use the per-booking actions in [Admin Booking Edit](/developers/guides/admin/booking-edit) instead.

### Step 1 — Read the Current Config

```http theme={null}
GET /api/v1/orders/{order_id}/config?o={org_id}
```

The response is the same document `orders/from-config` accepts, with the order's own `order_id` at the top level and the persisted `booking_id` on every entry in `bookings`. Removed and cancelled bookings are omitted, and sub-bookings and sequence members are nested inside their parent entry rather than listed on their own.

`check_availability` and `notify_customer` come back as `false`, so posting an unchanged config straight back is a no-op.

### Step 2 — Preview the Edit (Optional)

```http theme={null}
POST /api/v1/orders/calculate?o={org_id}

{ "order_id": "{order_id}", "bookings": [ ... ], ... }
```

The same document, sent to `orders/calculate` with its `order_id`, is priced as an edit of that order: the request goes through the same reference resolution and planning as the save below, against the persisted state, and nothing is written, reserved or consumed. The target order has to be configurable (see the errors below); a missing or foreign `order_id` is a `404`.

The response carries a `calculation_scope`:

| `calculation_scope` | When | What the amounts mean |
| - | - | - |
| `order` | The order's invoice is still a draft | The regenerated totals of the whole order after the edit |
| `correction` | The order's invoice is already issued | The **delta** the edit adds — what the parked correction draft will carry. Amounts can be negative. |

Per booking the response still lists the resolved prices, `services_label`, `resource` (with its `parent`), the extras and `booking_quota_grants`, in the order the entries were sent. A preview is not a reservation: availability and quota are validated again on save.

### Step 3 — Post the Edited Config Back

```http theme={null}
POST /api/v1/orders/from-config?o={org_id}

{ "order_id": "{order_id}", "bookings": [ ... ], ... }
```

| Booking entry | Effect |
| - | - |
| has `booking_id` | Updates that booking |
| no `booking_id` | Added to the order and confirmed, like a newly created admin booking |
| missing from the config | Soft-deleted, on confirmed orders as well as drafts |

<Warning>
  The body is the complete desired state, not a patch. Sending only the bookings you changed will soft-delete every booking you left out.
</Warning>

Updatable per booking: dates, resource, service configuration (`service_id`), quota grant, add-ons, sub-bookings, customer, participants and host, custom fields, `custom_price`, and the note fields. Order-level fields behave as on create: `order_customer_id`, `voucher_code` / `discount_relative` / `discount_absolute`, `add_ons` and `booking_passes`.

The response is the updated order; `meta.calculation` carries the full normalized totals of the order after the update — the whole order, not the delta of the edit.

### Behaviour to Know

* Pricing follows the admin booking edit: changes apply immediately. Vouchers, credit quota, payment-method codes, and gift cards on the invoice **recap** to the new totals so payable stays at or above zero. While the order's invoice is still a draft it is **regenerated in place**; once issued, the change produces a correction that stays an **unlocked draft invoice** on the order for an admin to issue.
* Applies are **serialized per order** — concurrent requests queue instead of diffing against a half-updated order. They are **not atomic**: a step that fails part-way leaves the earlier steps applied, so re-read the config before retrying.
* Removals are soft deletes: the bookings are priced out of the order and the rows stay recoverable.
* `notify_customer` only reaches **added** bookings. Removals are silent — soft-deleting a booking sends the customer nothing, so tell them separately if the change warrants it.
* Changing `add_ons` rewrites the standalone lines rather than patching them, so their ids change. An unchanged `add_ons` array is left untouched.
* Standalone `add_ons` and `booking_passes` are both synced to the config. A pass is one model per purchased unit, so lowering a bundle's `quantity` soft-deletes the surplus passes (newest first, so the oldest codes survive) along with their booking quota grants. A pass whose grants have already been used is rejected with `booking_pass_in_use` rather than orphaning the bookings it paid for.
* A `recurring` block on an entry that carries a `booking_id` is rejected — an existing booking cannot be expanded into a series. Series members round-trip as individual entries.
* An empty config is rejected rather than dissolving the order.
* Shop checkout drafts (`status=draft` and `manually_created=false`) cannot be configured. Admin-created drafts and reserved admin carts can. The API still returns `cannot_modify_reserved_booking` for a customer checkout cart that is still mid-flow.
* Without an `order_id` the very same document creates a new order, so dropping the key is how you duplicate an existing order.

***

## Skipping Availability Checks

Set `check_availability: false` to override availability constraints. Use this for:

* Overbooking scenarios
* Creating bookings in the past
* Special arrangements outside normal schedules

> **Warning:** Skipping availability checks can create conflicting bookings. Use with care.

***

## Re-Sending Order Notifications

If the customer didn't receive the confirmation:

```http theme={null}
GET /api/v1/orders/{order_id}/send-notification?o={org_id}
```

Triggers the order confirmation notification to the associated customer.

***

## Common Errors

| Error | Cause | Solution |
| - | - | - |
| `422` — resource\_id required | Missing resource in booking object | Include `resource_id` for each booking |
| `422` — service\_id required | Missing service mapping | Provide `service_id` as `{ "uuid": quantity }` |
| `422` — slot unavailable | Time conflict with existing booking | Set `check_availability: false` to override, or pick a different time |
| `422` — customer not found | Invalid `order_customer_id` | Verify the customer UUID exists in the organization |
| `403` — unauthorized | Insufficient permissions | Requires order creation permission, or order update permission when `order_id` is set |
| `404` — booking not part of order | A `booking_id` that does not belong to the order in `order_id` | Re-read the config from `GET /orders/{id}/config` |
| `400` — order empty | The config lists no bookings, add-ons or passes | Send at least one item, or cancel the order explicitly |
| `400` — cannot modify reserved booking | `order_id` points at a shop customer checkout draft (`status=draft` and not admin-created) | Wait until checkout finishes, or edit an admin-created order |


# Admin Booking Edit
Source: https://docs.anny.co/developers/guides/admin/booking-edit



Edit a confirmed booking from the admin API, one concern at a time: **resource and dates**, then **fields**, then **add-ons and sub-bookings**. These `/bookings/{booking_id}/edit/*` actions are the per-booking counterpart of rewriting a whole order through [Editing an Existing Order](/developers/guides/admin/booking-creation#editing-an-existing-order).

For creating bookings, see [Admin Booking Creation](/developers/guides/admin/booking-creation). For status changes, check-in, and cancellation, see [Admin Booking Lifecycle](/developers/guides/admin/booking-lifecycle). Customer self-service edits live in [Customer Booking Lifecycle](/developers/guides/customer/booking-lifecycle).

***

## When to use which API

| Goal | Use |
| - | - |
| Change one confirmed booking (resource, dates, customer, participants, add-ons, sub-bookings) | **This guide** — `POST /api/v1/bookings/{booking_id}/edit/*` |
| Rewrite the whole order (add or remove bookings, standalone add-ons, booking passes) | `GET /api/v1/orders/{order_id}/config` then `POST /api/v1/orders/from-config` |
| Customer changes their own booking | [Customer Booking Lifecycle](/developers/guides/customer/booking-lifecycle) |

The admin edit actions sit next to the public `edit-*` routes but under `edit/` so the two surfaces do not collide. They require the admin guard, `update` on `bookings`, and `read` on the booking's resource.

***

## Prerequisites

* A valid Bearer token with admin access — see [Authentication](/developers/guides/authentication)
* Organization context (`?o={organization_id}`)
* A confirmed booking (not `reserved`) that belongs to the active organization

***

## Shared behaviour

Every admin edit action:

* **Applies immediately.** There is no preview / `precalculate` step and no `cancel-edit-booking` counterpart. A `200` means the change is persisted.
* **Ignores customer edit gates.** Service settings such as `canEditPeriod` and `canEditServiceOptions` do not apply. Admins are not bound by the customer reschedule deadline.
* **Parks price corrections as an unlocked draft invoice** on the order (`tmp_invoice_id`). The already issued invoice is left untouched. A later edit replaces the previous draft rather than merging into it. Issue the draft explicitly when you are ready — see [Invoices](/developers/guides/admin/invoices).
* **Does not run the customer pay-now flow.** The customer is not sent a payment link as part of the edit.
* **Rejects reserved bookings** with HTTP `400` and `cannot_modify_reserved_booking`. Carts and still-reserved orders must go through checkout, not this API.

<Note>
  Each call is self-contained. Walk the steps below in UI order (resource → date → fields → add-ons / sub-bookings), or call only the action you need.
</Note>

***

## Step 1 — Resource, service, and dates

Request path documentation:

* `POST /api/v1/bookings/{booking_id}/edit/base-data`

```http theme={null}
POST /api/v1/bookings/{booking_id}/edit/base-data?o={org_id}

{
  "resource_id": "{resource_id}",
  "service_id": { "{service_id}": 1 },
  "start_date": "2026-04-16T10:00:00+02:00",
  "end_date": "2026-04-16T11:00:00+02:00",
  "booking_quota_grant_id": "{optional_grant_id}",
  "padding_before": 15,
  "padding_after": 0,
  "override_duration": false,
  "send_notification": true,
  "status_reason": "Moved to the afternoon slot you requested."
}
```

| Field | Type | Required | Description |
| - | - | - | - |
| `start_date` | string | Yes | New start (Atom). Omitting it is rejected with `422` — it is not treated as "keep current". |
| `end_date` | string | Yes\* | New end (Atom), `after_or_equal:start_date`. \*Not required when `duration` is set. Unless `override_duration` or `duration` is set, the server snaps this to the last validated end interval of the (new) service that still fits the request. |
| `duration` | integer | No | Manual duration in the service unit (usually minutes). Sets `end_date` to `start_date + duration` and skips interval snapping. |
| `override_duration` | boolean | No | Keep the requested `end_date` as-is instead of snapping it to a validated service interval. Implied when `duration` is set. |
| `padding_before` | integer | No | Override the service's preparation padding for this edit (blocker before start). `0` clears it. Omit to use the (new) service default. Does not write the Service row. |
| `padding_after` | integer | No | Override the service's follow-up padding for this edit (blocker after end). `0` clears it. Omit to use the (new) service default. |
| `resource_id` | integer | No | Target resource. Omit to keep the current resource. |
| `service_id` | object | No | Map of `service_id → quantity`. Omit to keep the current service configuration. |
| `booking_quota_grant_id` | string/int | No | Quota grant to charge the edited booking against. Must belong to the active organization. |
| `send_notification` | boolean | No | Whether to email or push the customer about this edit. Defaults to `true` when omitted. Set `false` for a silent admin calendar move. |
| `status_reason` | string | No | Customer-facing message included in the booking-updated email. Distinct from the admin-only `note`. Stored on the booking under `status_reason` keyed by the new start unix time. |

Availability is **not** enforced on this admin action. The booking can move onto a resource that is not wired to the booked service.

### Resource scope

| Payload | What the resource lookup allows |
| - | - |
| No `service_id` (plain date / sibling switch) | If the booking already sits on a child resource, `resource_id` must be a **sibling of the same parent**. A standalone resource is rejected with `422`. |
| `service_id` present (coupled selection) | Any resource in the active organization, including a standalone resource. Moving off a child group clears `parent_resource_id`. |

### Duration when the service changes

Changing `service_id` **does** update the booking duration on the backend — but through end-interval snapping, not by copying `min_duration` blindly:

* The requested `start_date` / `end_date` are resolved against the **new** service's validated end intervals.
* The last interval whose end is still `<=` the requested end wins. If none fit (for example a 60-minute window on a 90-minute fixed service), the first interval of the new service is used.
* `charged_duration` follows the new service's pricing rules: a fixed-duration service stays one charged interval; a flexible service uses `ceil(window / calculation_interval)`.
* Blocker padding (`blocker_start_date` / `blocker_end_date`) comes from the **new** service's `padding_before` / `padding_after`, unless you send those params to override them.

To keep a window the new service would not validate, send `override_duration: true` or an explicit `duration`.

### Service configuration and sequences

* A single-service `service_id` map changes the booking's service.
* Adding a second service on a resource with `create_booking_sequence` turns the booking into a **sequence parent**: `is_sequence` is true, the parent carries no `service_id`, and one sequenced child is created per selected service. The parent span is snapped to the first child's start and the last child's end.
* Dropping back to one service **collapses** the sequence: `is_sequence` is cleared, the remaining service is restored on the booking, and the sequenced children are removed.
* Quota usage follows the children while the booking is a sequence, then returns to the parent when it collapses. Prepaid (currency) grants settle against the balance instead of charging twice.

### Extras and sub-bookings on a base-data edit

`edit/base-data` does not take an add-on or sub-booking payload. Existing extras follow the booking:

* **Date change, same service** — extras are re-attached on the new slot. Combined placeholders that only exist on the rebuilt booking are ignored instead of failing the request.
* **Resource change, same service** — leftover extra rows stay on the original booking as-is.
* **Service change** — extras belong to the old service. Leftover sub-bookings are canceled so the correction draft can refund them.

To add, change, or remove extras after a base-data edit, call `edit/service-options` (step 3).

The response is the refreshed [Booking](/developers/models/bookings). Pass `include` (for example `resource.parent`) to sideload the switched-to resource.

***

## Step 2 — Fields

Customer, participants, and custom fields are separate actions. They do not go through `edit/base-data`.

### Reassign the customer

```http theme={null}
POST /api/v1/bookings/{booking_id}/edit/customer?o={org_id}

{
  "customer_id": "{customer_id}"
}
```

| Field | Type | Required | Description |
| - | - | - | - |
| `customer_id` | string/int | Yes | Customer in the active organization. A foreign customer is `422`. |

* When the booking is **not personalized** (its customer matches the order customer), the change also updates the order customer.
* When the booking **is personalized**, only this booking is reassigned.
* Sub-bookings and sequenced children adopt the new customer as well.

### Sync participants

```http theme={null}
POST /api/v1/bookings/{booking_id}/edit/participants?o={org_id}

{
  "participants": [
    {
      "email": "keep@example.com",
      "name": "Keep Me",
      "can_edit": false,
      "attending_virtually": false
    }
  ]
}
```

| Field | Type | Description |
| - | - | - |
| `email` | string | Participant email (max 200 chars) |
| `name` | string | Display name (nullable, max 200) |
| `can_edit` | boolean | Whether the participant can edit their own data |
| `attending_virtually` | boolean | Virtual attendance flag |

This is a **sync of the participants you send**: matching emails are updated in place. Participants missing from the payload are **kept** — the action never deletes attendees.

### Custom fields

Booking custom fields are not on `/edit/*`. Load the standalone admin form, collect values, then apply them:

```http theme={null}
POST /api/v1/ui/admin/booking-form?o={org_id}

{ "booking_id": "{booking_id}" }
```

```http theme={null}
POST /api/v1/ui/admin/booking-form/apply?o={org_id}

{
  "booking_id": "{booking_id}",
  "form_data": {
    "custom_entry_map": {
      "{field_uuid}": { "value": "Wheelchair access" }
    }
  }
}
```

The apply endpoint persists the submitted `custom_entry_map` values, deletes entries that were cleared to `""` / `null`, and returns the booking plus a rebuilt `meta.form_default`. Payload shape and persistence rules are in [Admin UI Forms](/developers/guides/internal/admin-ui-forms).

You can also `PATCH /api/v1/bookings/{booking_id}` with `custom_entry_map` if you already know the field UUIDs.

***

## Step 3 — Add-ons and sub-bookings

Request path documentation:

* `POST /api/v1/bookings/{booking_id}/edit/service-options`

```http theme={null}
POST /api/v1/bookings/{booking_id}/edit/service-options?o={org_id}

{
  "addons": [
    { "add_on_id": 12, "quantity": 2 }
  ],
  "sub_bookings": [
    { "service_id": "{service_id}", "resource_id": "{resource_id}", "quantity": 1 }
  ]
}
```

| Field | Type | Description |
| - | - | - |
| `addons` | array | Desired add-ons `{ add_on_id, quantity }`. `add_on_id` and `quantity` are required integers. |
| `sub_bookings` | array | Desired linked bookings `{ service_id, resource_id, quantity }`. `quantity` is optional. |

Unlike the customer `edit-service-options` action, an admin may attach:

* an add-on the organization owns that is **not wired** to the booked service
* a sub-resource / sub-service pair that is **not registered** as a sub-resource of the booked service

Items that belong to **another organization** are ignored (the request still returns `200`; those rows are not written).

Quantity `0` on an add-on **removes** it in admin org context. That override still wins when `always_apply` is `true` — the API does not floor an admin `0` back to `min_quantity`. Customer checkout is different: omitted or zero quantity is floored to `min_quantity` when `always_apply` is `true`, and skipped when `always_apply` is `false`. See [Add-On](/developers/models/add-ons).

The replacement set is applied immediately and a correction draft is parked on the order when the issued invoice would otherwise change.

For the checkout-time `add_ons_by_service` / `sub_bookings_by_service` grouping (quantity > 1 at create time), see [Add-Ons and Sub-Bookings](/developers/guides/internal/add-ons-subbooking). This admin action takes a flat list for the one booking you are editing.

***

## Whole-order alternative

When the change is not "this one booking" but the order as a whole — extra bookings, standalone add-ons, booking passes, or removals — read the order back as a config and post the **complete desired state**:

```http theme={null}
GET /api/v1/orders/{order_id}/config?o={org_id}
```

```http theme={null}
POST /api/v1/orders/from-config?o={org_id}

{ "order_id": "{order_id}", "bookings": [ ... ], ... }
```

A booking entry with `booking_id` updates that booking; an entry without one is added; an omitted booking is soft-deleted. Sending only the bookings you changed will remove every booking you left out.

That flow, including invoice regeneration, serialization, and `notify_customer` rules, is documented in [Editing an Existing Order](/developers/guides/admin/booking-creation#editing-an-existing-order).

<Note>
  `POST /api/v1/orders/calculate` with the same `order_id` previews the edit before it is applied and reports a `calculation_scope` of `order` (regenerated totals) or `correction` (the delta a locked invoice will receive) — see [Preview the Edit](/developers/guides/admin/booking-creation#step-2-preview-the-edit-optional). The per-booking `/edit/*` actions on this page have no preview step.
</Note>

***

## Common errors

| Error | Cause | Solution |
| - | - | - |
| `400` — `cannot_modify_reserved_booking` | The booking (or the order, for `/config`) is still reserved, a cart, or a base order | Wait until the booking is confirmed, or complete checkout |
| `400` — `service_and_resource_not_related` | The resource does not offer the service (or the booking has no service) | Send a `resource_id` / `service_id` pair that is linked. The API no longer swaps in another service. Blockers are exempt. |
| `403` — unauthorized | Missing `update` on bookings or `read` on the resource | Check the admin role |
| `404` | Booking / order is not in the active organization | Pass the correct `?o=` and identifier |
| `422` — `start_date` / `end_date` required | `edit/base-data` without dates | Always send both Atom timestamps |
| `422` — resource / service / grant / customer does not exist | Identifier is unknown or belongs to another organization | Stay inside the active organization |
| `422` — out-of-group resource | Plain `edit/base-data` tried to leave the parent resource group | Send `service_id` for a coupled move, or pick a sibling |
| `422` — invalid `form_data` | Custom-field apply failed validation | Fix the errors keyed by `custom_entry_map.{uuid}.value` and retry |


# Admin Booking Lifecycle
Source: https://docs.anny.co/developers/guides/admin/booking-lifecycle



Admin-specific booking operations: status changes, check-in/out, and document generation.

For customer booking management, see [Customer Booking Lifecycle](/developers/guides/customer/booking-lifecycle). For creating bookings, see [Admin Booking Creation](/developers/guides/admin/booking-creation). For changing a confirmed booking's resource, dates, fields, add-ons, or sub-bookings, see [Admin Booking Edit](/developers/guides/admin/booking-edit). For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions).

***

## Prerequisites

* A valid Bearer token with admin access — see [Authentication](/developers/guides/authentication)
* Organization context (`?o={organization_id}`)

***

## Status Changes

Request path documentation:

* `paths/admin/bookings.yaml` for `PATCH /api/v1/bookings/{booking_id}`
* `paths/admin/bookings.yaml` for `GET /api/v1/bookings/{booking_id}/cancel`

### Accept a Requested Booking

When a booking has status `requested`, accept it by updating the booking status:

```http theme={null}
PATCH /api/v1/bookings/{booking_id}?o={org_id}
```

Example payload:

```json theme={null}
{
	"data": {
		"id": "{booking_id}",
		"type": "bookings",
		"attributes": {
			"status": "accepted"
		}
	}
}
```

### Reject a Requested Booking

Reject a requested booking with the same update endpoint:

```http theme={null}
PATCH /api/v1/bookings/{booking_id}?o={org_id}
```

Example payload:

```json theme={null}
{
	"data": {
		"id": "{booking_id}",
		"type": "bookings",
		"attributes": {
			"status": "rejected"
		}
	}
}
```

### Cancel a Booking

Cancel an accepted or requested booking with the dedicated cancel action:

```http theme={null}
GET /api/v1/bookings/{booking_id}/cancel?o={org_id}
```

This runs the booking cancellation flow. Refunds and invoice adjustments follow the configured cancellation policy.

***

## Change resource or service

Calendar drag-and-drop and other in-place resource moves use the same JSON:API update:

```http theme={null}
PATCH /api/v1/bookings/{booking_id}?o={org_id}

{
  "data": {
    "type": "bookings",
    "id": "{booking_id}",
    "relationships": {
      "resource": {
        "data": { "type": "resources", "id": "{resource_id}" }
      }
    }
  }
}
```

The current service must already be offered on the target resource (or on its parent, when you move a child resource). If it is not, the request fails with HTTP `400` and `service_and_resource_not_related`. The API does **not** silently switch the booking to another service on the destination.

To keep the service when you move the booking, attach that service to the target resource first, or send both `relationships.resource` and `relationships.service` in the same `PATCH` so the pair is valid together.

Blockers and sequence bookings skip this check. To change resource, dates, add-ons, or sub-bookings on a confirmed booking as a dedicated admin action, use [Admin Booking Edit](/developers/guides/admin/booking-edit).

***

## Check-In / Check-Out

Request path documentation:

* `paths/admin/bookings.yaml` for `POST /api/v1/bookings/{booking_id}/check-in`
* `paths/admin/bookings.yaml` for `POST /api/v1/bookings/{booking_id}/check-out`
* [Scan](/developers/models/scans) for `POST /api/v1/scans` (staff / kiosk scanner)

Record customer arrivals and departures.

### Web admin Presence section

The current web admin booking-details **Presence** card (`app-admin/pages/bookings/[bookingId]/index.vue`) uses these JSON:API fields and endpoints. Use the same fields to decide whether to show a check-in/out section.

#### Fields that gate the section

Include `resource` on `GET /api/v1/bookings/{booking_id}`. Show the section when **all** of these are true:

| Field | JSON:API path | Show the section when |
| - | - | - |
| Editable | `data.attributes.is_editable` | `true` |
| Not a blocker | `data.attributes.is_blocker` | `false` |
| Has a resource | `data.relationships.resource.data` | present |
| Resource check-in enabled | included resource `attributes.settings.checkIn.isEnabled` | `true` |

`is_editable` is `false` when any of these apply: `external_calendar` is set, `status` is `reserved`, `is_sequence` is `true`, `is_via_protected_channel` is `true`, or the booking meta `IS_READ_ONLY` is set.

The org feature **Check-In & Check-Out** is not a booking attribute. The UI still keys off `settings.checkIn.isEnabled` on the included resource.

**Buttons** (`Check-In` / `Check-Out`) are not booking fields. Show both when the user can `create` `scans` (`user.can('create', 'scans')`). They are not disabled by start/end time. The overflow-menu actions additionally require `data.attributes.status === "accepted"`.

#### Fields to render presence

| Purpose | JSON:API path |
| - | - |
| Current check-in time | booking `attributes.check_in_date` (Atom) |
| Current check-out time | booking `attributes.check_out_date` (Atom) |
| History type | scan `attributes.scan_type` (`check_in` / `check_out`) |
| History status | scan `attributes.status` (`valid`, `scanned`, `unpaid`, `too_early`, `too_late`, `invalid`, `requires_details`, …) |
| History timestamp | scan `attributes.created_at` |
| Who scanned | included `scanner` (`given_name` / `name`) |
| Device label | scan `attributes.device_identifier` |

`check_in_date` is the newest check-in scan with status `valid` or `unpaid`. `check_out_date` is the newest check-out after that time, otherwise `null`. Recalculated on scan save and delete (`Booking::updatePresenceDates()`).

#### Endpoints the Presence card uses

| Action | Method | Path | Query | Body |
| - | - | - | - | - |
| Load booking (section fields) | `GET` | `/api/v1/bookings/{booking_id}` | `include=resource` (admin page also includes more), `o={org_id}` | — |
| Load history | `GET` | `/api/v1/bookings/{booking_id}/scans` | `include=scanner`, `sort=-createdAt`, `select[users]=given_name`, `select[customers]=given_name`, `o={org_id}` | — |
| Check-in | `POST` | `/api/v1/bookings/{booking_id}/check-in` | `o={org_id}` | `{ "data": {} }` |
| Check-out | `POST` | `/api/v1/bookings/{booking_id}/check-out` | `o={org_id}` | `{ "data": {} }` |
| Delete a history row | `DELETE` | `/api/v1/scans/{scan_id}` | `o={org_id}` | — |

Named routes: `api:v1:bookings.check-in`, `api:v1:bookings.check-out`. History is the JSON:API related `scans` on `bookings`. Standalone `GET /api/v1/scans` is not registered (`scans` is `except('index')`).

<Warning>
  The current admin `Booking.checkIn()` does **not** send `X-Supports-Dynamic-Form`. If delayed check-in documents or custom fields are still missing, `POST /check-in` returns **HTTP 400** `scans.check_in_requires_details_unsupported` instead of `requires_details`. Shop `checkInWithToken` **does** send the header. See [X-Supports-Dynamic-Form](#x-supports-dynamic-form).
</Warning>

Related endpoints **not** used by the Presence buttons:

| Action | Method | Path | Notes |
| - | - | - | - |
| Scan a QR / kiosk code | `POST` | `/api/v1/scans?o={org_id}&code={booking_code}&scannable_type=bookings` | Timing and Admin Check-In Period apply (`Scan::validate(false)`). |
| Fetch delayed check-in form | `GET` | `/api/ui/booking-check-in-form?booking={booking_id}` | Also returned as `meta.form_url`. Optional `access_token`. |

Guest self check-in uses the same `POST .../check-in` with `access_token` (and optional `lat` / `lng`). That path enforces `selfCheckIn.disabledUntil` / `allowedUntil`.

### Check-In

```http theme={null}
POST /api/v1/bookings/{booking_id}/check-in?o={org_id}
X-Supports-Dynamic-Form: true
```

Optional body fields:

| Field | Type | Description |
| - | - | - |
| `latitude` / `longitude` | number | Required when the resource uses geo check-in |
| `form_data` | object | Submitted after collecting delayed check-in details (see below) |
| `send_notification` | boolean | Defaults to `true` |

### Check-Out

```http theme={null}
POST /api/v1/bookings/{booking_id}/check-out?o={org_id}
```

Both endpoints:

* Log a `Scan` record with the timestamp
* Update the booking's check-in/check-out status
* Can be triggered by admin users or via self-service terminals

<Note>
  Resources can be configured with auto-expiry — if a customer doesn't check in within a configured window, the booking expires automatically.
</Note>

### X-Supports-Dynamic-Form

Clients that can render the delayed check-in form (legal documents / custom fields with collection timing `check_in`) must send:

```http theme={null}
X-Supports-Dynamic-Form: true
```

The API reads the header with `str_to_bool` (`FILTER_VALIDATE_BOOLEAN`: `true`, `1`, `yes`, `on`). CORS allow-lists it (`config/cors.php`). Constant: `CheckInFormService::DYNAMIC_FORM_HEADER`.

Check-out (`POST .../check-out`) does **not** use this header. Delayed collection applies to **check-in** only.

#### Booking action (`POST /api/v1/bookings/{id}/check-in`)

When `Booking::requiresCheckInDetails()` is true and the request has **no** top-level `form_data`:

| Header | Result |
| - | - |
| Missing / false | **HTTP 400**. JSON:API error `scans.check_in_requires_details_unsupported`. No scan, `check_in_date` stays `null`. |
| `true` | **HTTP 200**. Booking document with `meta.status: "requires_details"` and `meta.form_url`. **Check-in is not completed** (`check_in_date` stays `null`). |

Then `GET {form_url}` and retry `POST /check-in` with top-level `form_data`. On success, `meta.status` is the scan status (for example `valid`) and `check_in_date` is set.

#### Scanner create (`POST /api/v1/scans`)

When details are required and the request has **no** form payload:

| Header | Result |
| - | - |
| Missing / false | **HTTP 400** `scans.check_in_requires_details_unsupported`. **No** scan. |
| `true` | Scan **is created** with `data.attributes.status: "requires_details"` and `data.attributes.meta.form_url`. Booking is **not** checked in until form data is submitted. |

Submit answers on a later `POST /scans` as either:

1. Top-level `form_data` (same shape as the booking action), or
2. `data.attributes.meta.form_data`.

`ScanAdapter::extractCheckInFormData` accepts both.

### Delayed forms at check-in

Legal documents and custom forms can be configured with collection timing `check_in`. If those details are still missing when you check a booking in, the API does not complete the check-in until the client collects and submits them.

Advertise support for the dynamic check-in form with:

```http theme={null}
X-Supports-Dynamic-Form: true
```

Without that header (and without `form_data`), check-in fails with HTTP 400 and code `scans.check_in_requires_details_unsupported`.

**1. First attempt** — details still required:

```json theme={null}
{
  "meta": {
    "status": "requires_details",
    "form_url": "https://…/api/ui/booking-check-in-form?booking={id}&access_token=…"
  },
  "data": {
    "type": "bookings",
    "id": "{booking_id}",
    "attributes": {
      "check_in_date": null
    }
  }
}
```

**2. Load the form** from `meta.form_url` (`GET /api/ui/booking-check-in-form`). It returns the same dynamic-form shape as checkout (`components`, `validations`), limited to still-missing items (`documents.{uuid}`, `service_custom_fields.{uuid}`).

**3. Re-submit check-in** with the collected values:

```http theme={null}
POST /api/v1/bookings/{booking_id}/check-in?o={org_id}
X-Supports-Dynamic-Form: true

{
  "form_data": {
    "documents": {
      "{document_uuid}": { "accepted": true, "send_copy": false }
    },
    "service_custom_fields": {
      "{field_uuid}": "value"
    }
  }
}
```

On success, `meta.status` is the resulting scan status (for example `valid`) and `check_in_date` is set. Invalid `form_data` returns HTTP 422. Timing / geo / business-rule failures return HTTP 400 with a `scans.*` error code.

### Scanner endpoint (`POST /scans`)

Staff and kiosk clients that create scans by booking code use the same delayed-form flow. Submit details as **either** top-level `form_data` **or** `data.attributes.meta.form_data`. See [X-Supports-Dynamic-Form](#x-supports-dynamic-form).

```http theme={null}
POST /api/v1/scans?o={org_id}&code={booking_code}&scannable_type=bookings
X-Supports-Dynamic-Form: true

{
  "data": {
    "type": "scans",
    "attributes": {
      "scan_type": "check_in"
    }
  }
}
```

| Situation | Result |
| - | - |
| Header present, no form payload, details pending | Scan is created with `data.attributes.status: "requires_details"` and `data.attributes.meta.form_url`; booking is **not** checked in |
| Header missing, no form payload, details pending | HTTP 400, `scans.check_in_requires_details_unsupported` |
| Top-level `form_data` or `data.attributes.meta.form_data` provided (and valid) | Details are persisted, scan resolves to `valid`, booking `check_in_date` is set |

```http theme={null}
POST /api/v1/scans?o={org_id}&code={booking_code}&scannable_type=bookings
X-Supports-Dynamic-Form: true

{
  "data": {
    "type": "scans",
    "attributes": {
      "scan_type": "check_in",
      "meta": {
        "form_data": {
          "documents": {
            "{document_uuid}": { "accepted": true, "send_copy": false }
          },
          "service_custom_fields": {
            "{field_uuid}": "value"
          }
        }
      }
    }
  }
}
```

See [Scan](/developers/models/scans) for the resource schema and create parameters.

***

## Generating Documents

Generate a PDF or ticket from a document template:

```http theme={null}
GET /api/v1/bookings/{booking_id}/generate-file/{template_id}?o={org_id}
```

| Parameter | Description |
| - | - |
| `template_id` | UUID of the document template to use |
| `override` (query) | `true` to regenerate if a file already exists |

Returns a `files` resource with the generated document.

***

Booking exports are documented with the other admin export endpoints in [Exports](/developers/guides/admin/exports).

***

## Common Errors

| Error | Cause | Solution |
| - | - | - |
| `403` — unauthorized | Insufficient admin permissions | Verify role has booking management permission |
| `400` — `service_and_resource_not_related` | `PATCH` moved the booking to a resource that does not offer the current service | Offer the service on the target resource, or send a matching `relationships.service` in the same request |
| `422` — already checked in | Duplicate check-in attempt | Check booking status before check-in |
| `400` — `scans.check_in_requires_details_unsupported` | Delayed check-in details are required but the client did not send `X-Supports-Dynamic-Form: true` (and no `form_data`) | Send the capability header, load `form_url`, then re-submit with `form_data` |
| `422` — invalid `form_data` | Missing required signature or custom field | Fix validation errors from the check-in form and retry |
| `404` — template not found | Invalid document template UUID | Verify template exists in the organization |


# Broadcast Campaigns
Source: https://docs.anny.co/developers/guides/admin/broadcasting



Send bulk email/SMS messages to targeted audiences. A campaign combines a **template** with an **audience**.

***

## Headers (every request)

```http theme={null}
Authorization: Bearer {token}
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
```

All endpoints include `?o={organization_id}` for tenant context.

***

## Concepts

| Resource | Type | Description |
| - | - | - |
| Campaign | `broadcast-campaigns` | Orchestrates sending; tracks status and progress |
| Template | `broadcast-templates` | Email/SMS content with i18n and variable placeholders |
| Audience | `broadcast-audiences` | Recipient targeting based on dynamic customer, booking, or community criteria |
| Message | `broadcast-messages` | Individual message instance per recipient |

### Status Lifecycle

`draft` → `scheduled` → `pending` → `in-progress` → `completed`

| Status | Meaning |
| - | - |
| `draft` | Not yet started; can be edited |
| `scheduled` | Queued for future send (`scheduled_at`) or next cron run |
| `pending` | About to be processed |
| `in-progress` | Messages are being sent |
| `completed` | All messages processed |
| `delivered` | Message delivered (per-message status) |
| `failed` | Send failed |

### Audience Types

| Type | Description |
| - | - |
| `customers` | Dynamic — uses customer filters (same filters as `/customers`) |
| `bookings` | Dynamic — uses booking filters (same filters as `/bookings`) |
| `community` | All members of a linked community |

### Template Variables

Templates support placeholder variables like `{first_name}`, `{last_name}`, etc. These are replaced per-recipient using the recipient model's `getVariableBindings()`. The template body is localized per customer's preferred locale.

***

<Steps>
  <Step title="Create a Template">
    ```http theme={null}
    POST {BASE_URL}/broadcast-templates?o={org_id}
    ```

    ```json theme={null}
    {
      "data": {
        "type": "broadcast-templates",
        "attributes": {
          "name": "March Newsletter",
          "subject": "Hello {first_name}!",
          "body": "<p>Hi {first_name}, here's your monthly update...</p>",
          "body_short": "Hi {first_name}, check your monthly update.",
          "action_label": "View Details",
          "action_url": "https://example.com/updates",
          "channels": ["mail"],
          "is_template": false
        }
      }
    }
    ```

    | Attribute | Type | Description |
    | - | - | - |
    | `name` | string | Internal name |
    | `subject` | string | Email subject (supports variables and i18n) |
    | `body` | string | HTML email body (supports variables and i18n) |
    | `body_short` | string | SMS body (supports variables and i18n) |
    | `action_label` | string | CTA button text |
    | `action_url` | string | CTA button URL |
    | `channels` | string\[] | `["mail"]`, `["sms"]`, or `["mail", "sms"]` |
    | `is_template` | boolean | `true` = reusable template; `false` = one-off |
    | `binding_type` | string | Variable binding context |

    For i18n, send localized versions via `subject_i18n`, `body_i18n`, etc. as objects keyed by locale.

    ### Includes

    | Include | Description |
    | - | - |
    | `files` | Attached files |

    ### Filters

    | Filter | Description |
    | - | - |
    | `filter[search]` | Name search |
    | `filter[binding_type]` | Filter by binding type |
    | `filter[is_template]` | `true` for reusable templates only |
  </Step>

  <Step title="Create an Audience">
    ```http theme={null}
    POST {BASE_URL}/broadcast-audiences?o={org_id}
    ```

    <Tabs>
      <Tab title="Dynamic audience (filtered customers)">
        ```json theme={null}
        {
          "data": {
            "type": "broadcast-audiences",
            "attributes": {
              "name": "Active Customers 2026",
              "audience_type": "customers",
              "filters": {
                "search": "active"
              },
              "is_template": false
            }
          }
        }
        ```

        The `filters` object accepts the same filters available on the `/customers` endpoint (for `customers` type) or `/bookings` endpoint (for `bookings` type).
      </Tab>

      <Tab title="Dynamic audience (filtered bookings)">
        ```json theme={null}
        {
          "data": {
            "type": "broadcast-audiences",
            "attributes": {
              "name": "Upcoming Bookings",
              "audience_type": "bookings",
              "filters": {
                "status": "accepted",
                "date_from": "2026-04-01"
              }
            }
          }
        }
        ```
      </Tab>
    </Tabs>

    | Attribute | Type | Required | Description |
    | - | - | - | - |
    | `name` | string | yes | Audience name |
    | `audience_type` | string | yes | `customers`, `bookings`, or `community` |
    | `filters` | object | no | Dynamic filter criteria |
    | `is_template` | boolean | no | Reusable audience template |

    ### Includes

    | Include | Description |
    | - | - |
    | `community` | Linked community (for `community` type) |
  </Step>

  <Step title="Create a Campaign">
    ```http theme={null}
    POST {BASE_URL}/broadcast-campaigns?o={org_id}
    ```

    ```json theme={null}
    {
      "data": {
        "type": "broadcast-campaigns",
        "attributes": {
          "name": "March 2026 Newsletter"
        },
        "relationships": {
          "template": { "data": { "type": "broadcast-templates", "id": "{template_id}" } },
          "audience": { "data": { "type": "broadcast-audiences", "id": "{audience_id}" } }
        }
      }
    }
    ```

    | Attribute | Type | Required | Description |
    | - | - | - | - |
    | `name` | string | yes | Campaign name |
    | `scheduled_at` | datetime | no | Schedule for future send |
    | `recurring` | boolean | no | Enable recurring sends |
    | `cron` | string | no | Cron expression (required when `recurring=true`). Format: `minute hour day month weekday` |

    ### Optional: Schedule or make recurring

    ```json theme={null}
    {
      "data": {
        "type": "broadcast-campaigns",
        "attributes": {
          "name": "Weekly Reminder",
          "scheduled_at": "2026-04-01T09:00:00Z",
          "recurring": true,
          "cron": "0 9 * * 1"
        },
        "relationships": {
          "template": { "data": { "type": "broadcast-templates", "id": "{template_id}" } },
          "audience": { "data": { "type": "broadcast-audiences", "id": "{audience_id}" } }
        }
      }
    }
    ```
  </Step>

  <Step title="Preview Draft Messages">
    Before sending, preview the generated messages (max 10):

    ```http theme={null}
    GET {BASE_URL}/broadcast-campaigns/{id}/draft-messages?o={org_id}
    ```

    Returns a collection of `broadcast-messages` with variable placeholders resolved per recipient, channels determined (invalid channels auto-removed if customer lacks email/mobile), and content localized.
  </Step>

  <Step title="Start the Campaign">
    ```http theme={null}
    GET {BASE_URL}/broadcast-campaigns/{id}/start?o={org_id}
    ```

    Behavior depends on campaign config:

    | Scenario | What happens |
    | - | - |
    | No `scheduled_at` | Sends immediately |
    | `scheduled_at` in the future | Queues for scheduled delivery |
    | `recurring=true` | Calculates next run from `cron`, sends at that time, then reschedules |

    The campaign transitions through: `scheduled` → `pending` → `in-progress` → `completed`.

    Progress is tracked via `sent_count`, `failed_count`, and `total_count` attributes. These update in real-time (a WebSocket event `broadcast-campaigns.updated` fires every 5 messages and on completion).
  </Step>
</Steps>

***

## Stop a Campaign

Reverts the campaign to `draft` and deletes all unsent (pending/draft) messages:

```http theme={null}
GET {BASE_URL}/broadcast-campaigns/{id}/stop?o={org_id}
```

***

## List Campaigns

```http theme={null}
GET {BASE_URL}/broadcast-campaigns?o={org_id}&include=template,audience
```

### Filters

| Filter | Description |
| - | - |
| `filter[search]` | Name search |

### Sorting

| Sort | Description |
| - | - |
| `name` | Campaign name |
| `created_at` | Creation date |

### Includes

| Include | Description |
| - | - |
| `template` | The message template |
| `template.files` | Template with file attachments |
| `audience` | The target audience |

***

## List Campaign Messages

```http theme={null}
GET {BASE_URL}/broadcast-campaigns/{id}/messages?o={org_id}&include=customer
```

### Message Attributes

| Attribute | Type | Description |
| - | - | - |
| `subject` | string | Resolved email subject |
| `body` | string | Resolved HTML body |
| `body_short` | string | Resolved SMS body |
| `action_label` | string | CTA text |
| `action_url` | string | CTA URL |
| `channels` | string\[] | Delivery channels for this recipient |
| `locale` | string | Recipient's locale |
| `email` | string | Recipient email |
| `mobile` | string | Recipient mobile |
| `status` | string | `draft`, `pending`, `completed`, `delivered`, `failed` |
| `created_at` | datetime | |

### Message Includes

| Include | Description |
| - | - |
| `campaign` | Parent campaign |
| `recipient` | The recipient (customer or booking) |
| `customer` | Related customer |
| `sent_email` | Tracked email record |

***

## Full Workflow

```text theme={null}
1. POST /broadcast-templates          → Create message content
2. POST /broadcast-audiences          → Define recipients
3. POST /broadcast-campaigns          → Create campaign linking template + audience
4. GET  /broadcast-campaigns/{id}/draft-messages → Preview
5. GET  /broadcast-campaigns/{id}/start          → Send
6. GET  /broadcast-campaigns/{id}/messages       → Monitor delivery
```

All endpoints include `?o={organization_id}` for tenant context.


# Businesses
Source: https://docs.anny.co/developers/guides/admin/businesses



Manage B2B customer entities. Businesses group customers and enable consolidated billing via [Customer Balances](/developers/guides/admin/customer-balances).

For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For authentication, see [Authentication](/developers/guides/authentication).

***

## Prerequisites

* A valid Bearer token with admin access
* Organization context (`?o={organization_id}`)

***

## Overview

A **Business** represents a company or organization. Customers can be assigned to a business — either manually by an admin or automatically during checkout based on the customer's email domain.

Key use cases:

* Group customers by employer for B2B billing
* Collect business-level billing addresses and VAT IDs
* Consolidate invoices under a single business balance

***

## Business vs. Business Account

Similar to the Customer/CustomerAccount distinction, the platform separates business data into two scopes:

| Entity | Scope | Purpose |
| - | - | - |
| **Business** | Per-organization | An org-level record holding billing info, customers, and balances. Managed by admins via the API. |
| **BusinessAccount** | Global (platform-wide) | A cross-organization identity that links Business records across multiple organizations. Enables deduplication — the same company booking with different providers is recognized as one entity. |

A single company may have multiple `Business` records (one per organization), all linked to the same `BusinessAccount` via domain and name matching. The `BusinessAccount` is managed automatically by the platform and is not directly accessible through the admin API.

***

## Creating a Business

```http theme={null}
POST /api/v1/businesses?o={org_id}

{
  "data": {
    "type": "businesses",
    "attributes": {
      "name": "Acme Corp",
      "billing_email": "billing@acme.com",
      "domain": "acme.com",
      "vat_id": "DE123456789"
    }
  }
}
```

### Key Attributes

| Attribute | Type | Description |
| - | - | - |
| `name` | string | Business name (required) |
| `brand_name` | string | Optional short brand name (auto-generated from `name` if empty) |
| `domain` | string | Email domain for automatic customer assignment |
| `billing_email` | string | Billing contact email |
| `vat_id` | string | VAT identification number |
| `notes` | string | Internal notes (admin-only visibility) |
| `custom_entry_map` | object | Custom field entries keyed by field UUID |

***

## Automatic Assignment via Domain

During checkout, customers are automatically assigned to a business when **both** conditions are met:

1. **Domain match** — the customer's email domain matches the business's `domain` (e.g., `jane@acme.com` → `acme.com`). Generic email providers (gmail.com, outlook.com, etc.) are excluded.
2. **Name match** — the company name provided at checkout matches the business name after normalization (legal form suffixes like "GmbH", "Inc", "Ltd" are stripped before comparison).

Both criteria must match to prevent false grouping — e.g., two different companies sharing the same email domain (co-working spaces, shared tenants) are kept separate because their names differ.

If only the name matches (generic email domain), the system falls back to name-based deduplication without cross-organization linking.

This assignment also triggers cross-organization deduplication via **BusinessAccounts** — businesses with the same domain and normalized name across different organizations are linked automatically.

***

## Reading Businesses

### List All

```http theme={null}
GET /api/v1/businesses?o={org_id}
```

### Search by Name

```http theme={null}
GET /api/v1/businesses?o={org_id}&filter[search]=acme
```

Searches across name, domain, and VAT ID.

### Include Relationships

```http theme={null}
GET /api/v1/businesses/{uuid}?o={org_id}&include=billing_address,customers,customer_balances,logo_image,payment_setup
```

***

## Including Business on Other Resources

The `business` relationship is available as an include on several resources:

### On Customers

```http theme={null}
GET /api/v1/customers?o={org_id}&include=business,business.logo_image,business.billing_address
```

### On Orders

```http theme={null}
GET /api/v1/orders?o={org_id}&include=customer.business,customer.business.logo_image
```

### On Plan Subscriptions

```http theme={null}
GET /api/v1/plan-subscriptions?o={org_id}&include=customer.business,customer.business.custom_entries.field
```

### On Bookings

```http theme={null}
GET /api/v1/bookings/{id}?o={org_id}&include=customer.business
```

***

## Updating a Business

```http theme={null}
PATCH /api/v1/businesses/{uuid}?o={org_id}

{
  "data": {
    "type": "businesses",
    "id": "{uuid}",
    "attributes": {
      "name": "Acme Corporation",
      "billing_email": "invoices@acme.com"
    }
  }
}
```

***

## Deleting a Business

```http theme={null}
DELETE /api/v1/businesses/{uuid}?o={org_id}
```

Customers previously linked to the deleted business will be unlinked (their `business` relationship becomes `null`).

***

## Sorting

| Parameter | Description |
| - | - |
| `name` | Alphabetical by business name |
| `created_at` | By creation date |

***

## Filtering

| Filter | Description |
| - | - |
| `filter[ids]` | Comma-separated UUIDs |
| `filter[exclude_ids]` | Exclude specific UUIDs |
| `filter[name]` | Exact name match |
| `filter[search]` | Full-text search (name, domain, VAT ID) |


# Booking Calendars
Source: https://docs.anny.co/developers/guides/admin/calendar-events



Retrieve booking-focused calendar data and occupancy counts for display in calendar UIs. This endpoint belongs to the Bookings surface, even though the aggregate route itself lives in the misc path file.

For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For availability search, see [Availability & Booking Search](/developers/guides/availability).

***

## Prerequisites

* At least one resource with a configured schedule
* Public endpoint — no authentication required for basic usage

***

## Unified Calendar View

Request path documentation:

* `paths/public/misc.yaml` for `GET /api/v1/calendar-events`

The main endpoint aggregates multiple data sources into a single response:

```http theme={null}
GET /api/v1/calendar-events?resource_id={resource_uuid}&start_date=2026-04-01T00:00:00Z&end_date=2026-04-30T23:59:59Z
```

### Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `resource_id` | string/array | Yes | Single UUID or array of resource UUIDs |
| `start_date` | string | No | Range start (ISO 8601). If omitted, uses the start of `end_date`'s day, or the start of today in the request timezone. |
| `end_date` | string | No | Range end (ISO 8601). If omitted, uses the end of the start day's day. |
| `timezone` | string | No | Timezone for local date calculations (e.g. `Europe/Berlin`) |
| `filter[exclude_child_resources]` | boolean | No | Only show parent resource data |
| `filter[with_empty_booking_counts]` | boolean | No | Include `booking_count` periods whose count is `0`. Off by default. |

### Multiple Resources

Query multiple resources in a single request:

```http theme={null}
GET /api/v1/calendar-events?resource_id[]={uuid_1}&resource_id[]={uuid_2}&start_date=2026-04-01T00:00:00Z
```

***

## Event Types

The response contains events of different types, combined from booking and availability data sources:

| Type | Description |
| - | - |
| `period` | A raw availability slot from the resource's schedule |
| `period_fragment` | Remaining availability after bookings are subtracted |
| `booking` | An accepted booking (includes customer data for small-capacity resources) |
| `reserved_booking` | A temporary hold — no customer details exposed |
| `blocker` | A manually blocked time slot included in the aggregated calendar response |
| `booking_count` | Aggregated booking count for high-capacity resources (>25 slots) |

### Response Structure

```json theme={null}
{
  "data": {
    "events": [
      {
        "id": "event-uuid",
        "type": "booking",
        "timeslot_id": "9a93435a-86b2-449f-85ef-d47d477b9abe",
        "title": "Session 1",
        "start_date": "2026-04-15T10:00:00Z",
        "end_date": "2026-04-15T11:00:00Z",
        "resource_id": "res-uuid",
        "resource_name": "Meeting Room A",
        "resource_info": [
          {
            "id": 15,
            "name": "Projector",
            "slug": "projector",
            "category_name": "Equipment"
          }
        ],
        "quota": 1,
        "occupancy": 1.0,
        "is_available": false,
        "is_blocker": false,
        "display_label": "Jane Doe - Workshop",
        "customers": [
          { "id": "cust-1", "first_name": "Jane", "last_name": "Doe" }
        ],
        "bookings": [
          { "id": "book-uuid", "status": "accepted" }
        ],
        "color_map": { "bg": "#3b82f6", "text": "#ffffff" }
      },
      {
        "id": "period-uuid",
        "type": "period_fragment",
        "start_date": "2026-04-15T11:00:00Z",
        "end_date": "2026-04-15T18:00:00Z",
        "resource_id": "res-uuid",
        "is_available": true,
        "quota": 1,
        "occupancy": 0.0
      }
    ],
    "resources_with_schedule": ["res-uuid"]
  }
}
```

Timeslot-backed events can include `timeslot_id`. Use it to fetch the canonical timeslot resource through the admin timeslot endpoints, open the matching editor, or reconcile calendar cards with `resource_info` and allocation state.

### Admin context (`display_lines`)

When the request runs with an organization context, the admin calendar renders backend-composed `display_lines` below `display_label`. Each line is `{ key, icon, label, image, object }`; order is significant. `key` identifies the line kind so clients can find or override a specific line without parsing `label` (`time` for the formatted clock range, `timeslot` for the timeslot title, `customer`, `service`, `resource`, `admin_note`, `customer_note`, `order_item`).

For `timeslot` events the lines are: `time`, then `timeslot` when the title is non-empty, then `resource`. Untitled timeslots omit the title line; the time range is the information.

For a single confirmed booking in admin context the lines are: `customer` (only when the headline is a custom description) → `time` → `timeslot` (when the timeslot has a specific title) → `service` → `resource` → `admin_note` → `customer_note`.

Non-admin responses do not receive this enrichment: `display_lines` stay the public composition, and `is_paid` stays `null`.

For a single confirmed booking in admin context, the event also includes `add_on_count`: the sum of add-on quantities on that booking. Aggregated events leave the field `null` at the event level and put the count on each nested `bookings[]` entry. Sequence wrappers report only their own add-ons, not those of child bookings. Non-admin responses always get `null`.

### Capacity-Based Rendering

The API adapts its response based on resource capacity:

* **Small resources** (capacity ≤ 25): Returns individual `booking` events with customer details. Use these to render detailed calendar entries.
* **Large resources** (capacity > 25): Returns `booking_count` events with aggregated occupancy numbers. Use these for heatmap or occupancy bar display. Periods with count `0` are omitted unless you send `filter[with_empty_booking_counts]=true`.

***

## Booking Detail Preview

For calendar detail views, use the booking preview endpoint to get a summary of a specific booking without fetching the full resource:

```http theme={null}
GET /api/v1/customer-accounts/{account_id}/booking-preview/{booking_id}
```

***

## Common Patterns

### Daily Calendar View

```http theme={null}
GET /api/v1/calendar-events?resource_id={uuid}&start_date=2026-04-15T00:00:00Z&end_date=2026-04-15T23:59:59Z&timezone=Europe/Berlin
```

### Weekly Multi-Resource View

```http theme={null}
GET /api/v1/calendar-events?resource_id[]={uuid_1}&resource_id[]={uuid_2}&start_date=2026-04-14T00:00:00Z&end_date=2026-04-20T23:59:59Z
```

### Correlate a Calendar Event to Timeslot CRUD

When an event includes `timeslot_id`, you can jump from the aggregate calendar response to the admin timeslot resource:

```http theme={null}
GET /api/v1/timeslots/{timeslot_id}?include=resource,series,resource_allocations.resource
```

For the full admin workflow, see [Admin Timeslot Management](/developers/guides/admin/timeslot-management).

## Common Errors

| Error | Cause | Solution |
| - | - | - |
| Empty `events` array | Resource has no schedule configured | Verify the resource has an active schedule |
| Missing customer data | High-capacity resource | Use `booking_count` events instead of individual bookings |
| `422` — resource\_id required | Missing parameter | Always include at least one `resource_id` |


# Customer Balances
Source: https://docs.anny.co/developers/guides/admin/customer-balances



Consolidated billing buckets that group draft invoices across a billing period for automatic or manual issuance.

For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For authentication, see [Authentication](/developers/guides/authentication).

***

## Prerequisites

* A valid Bearer token with admin access
* Organization context (`?o={organization_id}`)
* Customer balance feature enabled on the organization's subscription plan

***

## Overview

A **Customer Balance** collects draft invoices over a billing period (e.g., one month) and consolidates them into a single master invoice at the end of the period. This reduces invoice noise for frequent bookers.

Balances are created automatically when invoices enter the `pay-to-balance` payment flow. They cannot be created directly via the API.

### Balanceable Entity

Each balance belongs to a **balanceable** — either a `Customer` or a `Business`. When the organization enables "group by business" billing, invoices for customers assigned to a business are collected on the business's balance instead of individual customer balances.

***

## Status Lifecycle

```text theme={null}
open → issued → paid
  ↓        ↓
  void    void
  ↓
  rolled_over
```

| Status | Description |
| - | - |
| `open` | Actively collecting invoices. New drafts are appended here. |
| `issued` | Billing period ended. A master invoice has been generated and optionally auto-charged. |
| `paid` | The master invoice has been paid (manually or via auto-charge). |
| `rolled_over` | Balance was below the de minimis threshold; amount rolls into the next period. |
| `void` | Cancelled. Attached invoices are released. |

***

## Listing Balances

```http theme={null}
GET /api/v1/customer-balances?o={org_id}
```

### Filter by Status

```http theme={null}
GET /api/v1/customer-balances?o={org_id}&filter[status]=open
```

### Filter by Balanceable

```http theme={null}
GET /api/v1/customer-balances?o={org_id}&filter[balanceable_type]=businesses&filter[balanceable_id]={business_uuid}
```

### Filter by Date Range

```http theme={null}
GET /api/v1/customer-balances?o={org_id}&filter[start_date_from]=2026-01-01&filter[start_date_to]=2026-01-31
```

***

## Reading a Balance

```http theme={null}
GET /api/v1/customer-balances/{uuid}?o={org_id}&include=balanceable,invoices,master_invoice,payment_setup
```

### Available Includes

| Include | Description |
| - | - |
| `balanceable` | The Customer or Business this balance belongs to |
| `customer_account` | The associated customer account |
| `invoices` | Draft invoices attached to this balance |
| `invoices.items` | Line items on each draft invoice |
| `invoices.reference` | Booking/order reference for each invoice |
| `master_invoice` | The consolidated invoice (after issuance) |
| `master_invoice.items` | Line items on the master invoice |
| `payment_setup` | Payment method used for auto-charge |

***

## Adding Invoices to a Balance

### At Creation Time

When creating a manual invoice, pass `?add_to_balance=1` to automatically attach it to the customer's open balance:

```http theme={null}
POST /api/v1/invoices?o={org_id}&add_to_balance=1

{
  "data": {
    "type": "invoices",
    "attributes": { ... },
    "relationships": {
      "customer": {
        "data": { "type": "customers", "id": "{customer_id}" }
      }
    }
  }
}
```

The system resolves the customer's balanceable (Customer or Business) and attaches the invoice to the current open balance, creating one if none exists.

### Moving an Existing Invoice

To move an existing draft invoice to a balance (or transfer between balances):

```http theme={null}
POST /api/v1/invoices/{uuid}/move-to-balance?o={org_id}

{
  "balanceable_type": "businesses",
  "balanceable_id": "{business_uuid}",
  "issued_at": "2026-06-01"
}
```

| Field | Required | Description |
| - | - | - |
| `balanceable_type` | yes | `customers` or `businesses` |
| `balanceable_id` | yes | UUID of the target entity |
| `issued_at` | no | Override the balance issue date (must be today or later) |

This detaches the invoice from any current balance, recalculates the old balance total, and attaches to the target's open balance. Locked invoices and consolidated child invoices are rejected (HTTP 400).

***

## Updating a Balance

Status transitions are the primary update operation:

```http theme={null}
PATCH /api/v1/customer-balances/{uuid}?o={org_id}

{
  "data": {
    "type": "customer-balances",
    "id": "{uuid}",
    "attributes": {
      "status": "void"
    }
  }
}
```

### Allowed Transitions

| From | To | Effect |
| - | - | - |
| `open` | `void` | Cancels the balance, releases attached invoices |
| `issued` | `paid` | Marks as paid after manual payment confirmation |
| `issued` | `void` | Cancels after issuance |

***

## Automatic Issuance

Balances with a scheduled `issue_at` timestamp are automatically processed by a background job. When issued:

1. All attached draft invoices are finalized
2. A **master invoice** is created summing all line items
3. If a `payment_setup` is configured, an auto-charge is attempted
4. A notification is sent to the customer/business

If the balance total is below the organization's de minimis threshold, the balance is `rolled_over` into the next period instead.

***

## Sorting

| Parameter | Description |
| - | - |
| `issue_at` | By scheduled issuance date |
| `total` | By balance amount |
| `start_date` | By billing period start |
| `end_date` | By billing period end |
| `created_at` | By creation date |

***

## Key Attributes

| Attribute | Type | Description |
| - | - | - |
| `total` | number | Sum of attached draft invoice totals (read-only, server-calculated) |
| `currency` | string | ISO 4217 currency code |
| `label` | string | Period label (e.g., "May 2026" or "KW 20 2026") |
| `status` | string | Current lifecycle status |
| `start_date` | date | Billing period start |
| `end_date` | date | Billing period end |
| `issue_at` | datetime | Scheduled auto-issuance timestamp |
| `issued_at` | datetime | Actual issuance timestamp (set when issued) |

***

## Relationship to Businesses

When an organization enables business-level balance grouping:

* Invoices for customers with a `business` are grouped onto the **business's balance**
* The `balanceable` relationship points to the `businesses` resource instead of `customers`
* Filter with `filter[balanceable_type]=businesses` to find business balances

See [Businesses](/developers/guides/admin/businesses) for managing business entities.


# Admin Customer Management
Source: https://docs.anny.co/developers/guides/admin/customer-management



Create, search, and manage customer records from the admin API.

For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For authentication, see [Authentication](/developers/guides/authentication).

***

## Prerequisites

* A valid Bearer token with admin access
* Organization context (`?o={organization_id}`)

***

## Customer vs. Customer Account

The platform distinguishes between two entities:

| Entity | Scope | Purpose |
| - | - | - |
| **Customer** | Per-organization | A business record with contact info, bookings, and custom fields. Owned by a specific organization. |
| **Customer Account** | Global (platform-wide) | An end-user identity that can log in. Linked to `Customer` records across multiple organizations via `account_id`. |

A single person may have multiple `Customer` records (one per organization they interact with), all linked to the same `CustomerAccount`.

***

## Creating a Customer

```http theme={null}
POST /api/v1/customers?o={org_id}

{
  "data": {
    "type": "customers",
    "attributes": {
      "given_name": "Jane",
      "family_name": "Doe",
      "email": "jane@example.com",
      "mobile": "+49 170 1234567",
      "company": "Acme Corp",
      "locale": "de-DE"
    }
  }
}
```

### Key Attributes

| Attribute | Type | Description |
| - | - | - |
| `given_name` | string | First name |
| `family_name` | string | Last name |
| `email` | string | Email address |
| `mobile` | string | Mobile phone number |
| `phone` | string | Landline phone number |
| `company` | string | Company name |
| `sex` | string | Gender |
| `birth_date` | string | Date of birth (Y-m-d) |
| `locale` | string | Preferred language (defaults to organization locale) |

***

## Custom Fields

Organizations can define custom fields (type `custom-fields`) to collect additional data on customer records — member numbers, preferences, notes, etc. Each field value is stored as a `custom-entry` linked to the customer.

### Reading Custom Field Data

There are two ways to retrieve custom field values on a customer.

**Option 1 — `custom_entry_map` attribute (recommended for display)**

This attribute is always returned on the customer resource. It is a map keyed by the custom field's UUID:

```http theme={null}
GET /api/v1/customers/{customer_id}?o={org_id}
```

```json theme={null}
{
  "data": {
    "type": "customers",
    "id": "{customer_uuid}",
    "attributes": {
      "given_name": "Jane",
      "custom_entry_map": {
        "{field_uuid_1}": {
          "value": "Gold",
          "label": "Membership Tier",
          "formatted_value": "Gold",
          "type": "select"
        },
        "{field_uuid_2}": {
          "value": "12345",
          "label": "Member Number",
          "formatted_value": "12345",
          "type": "text"
        }
      }
    }
  }
}
```

| Key | Type | Description |
| - | - | - |
| `value` | varies | The raw stored value (see field type table below) |
| `label` | string | Human-readable field name |
| `formatted_value` | string | Display-ready value (e.g. option labels for select fields) |
| `type` | string | Field type (`text`, `textarea`, `number`, `select`, `multiselect`, `checkbox`, `date`) |

**Option 2 — `include=custom_entries,custom_entries.field` (full JSON:API resources)**

Use this when you need the full `custom-entries` and `custom-fields` resource objects:

```http theme={null}
GET /api/v1/customers/{customer_id}?o={org_id}&include=custom_entries,custom_entries.field
```

Returns `custom_entries` as a JSON:API `has-many` relationship in the response, with `field` sideloaded in `included`.

***

### Writing Custom Field Data

Send the `custom_entry_map` attribute inside a `PATCH` request on the customer. The backend performs an **atomic upsert and delete**: entries in the map are created or updated, and any entries for fields **not present** in the map are deleted.

```http theme={null}
PATCH /api/v1/customers/{customer_id}?o={org_id}

{
  "data": {
    "type": "customers",
    "id": "{customer_uuid}",
    "attributes": {
      "custom_entry_map": {
        "{field_uuid_1}": { "value": "Gold" },
        "{field_uuid_2}": { "value": "12345" }
      }
    }
  }
}
```

To **clear a specific field**, omit it from the map (alongside all fields you want to keep). To **clear all custom fields**, send an empty object:

```json theme={null}
"custom_entry_map": {}
```

> **Note:** Always include all fields you want to retain in a single request. Any field UUID not present in the map will have its entry deleted.

***

### Value Format by Field Type

| Field type | Expected `value` format | Example |
| - | - | - |
| `text` | `string` | `"Jane"` |
| `textarea` | `string` | `"Long text..."` |
| `number` | `number` or numeric `string` | `42` |
| `select` | `string` (option key or label) | `"gold"` |
| `multiselect` | `string[]` (array of option keys) | `["yoga", "pilates"]` |
| `checkbox` | `boolean` or `"1"`/`"0"` | `true` |
| `date` | `string` in `Y-m-d` format | `"1990-06-15"` |

File upload fields (`file`, `image`) are managed through a separate upload flow and cannot be set via `custom_entry_map`.

***

### Full Example: Create Customer with Custom Fields

```http theme={null}
POST /api/v1/customers?o={org_id}

{
  "data": {
    "type": "customers",
    "attributes": {
      "given_name": "Jane",
      "family_name": "Doe",
      "email": "jane@example.com",
      "custom_entry_map": {
        "{field_uuid_membership_tier}": { "value": "Gold" },
        "{field_uuid_member_number}":   { "value": "12345" }
      }
    }
  }
}
```

Then read back the values:

```http theme={null}
GET /api/v1/customers/{customer_uuid}?o={org_id}
```

The `custom_entry_map` in the response will contain the stored values with their labels and formatted representations.

***

## Finding Customers

### By Email (Exact Match)

```http theme={null}
GET /api/v1/customers?o={org_id}&filter[email]=jane@example.com
```

### By Search (Fuzzy)

Searches across name, email, and phone:

```http theme={null}
GET /api/v1/customers?o={org_id}&filter[search]=jane
```

### By Custom Field

See the custom field filter syntax in [JSON-API Conventions](/developers/guides/json-api-conventions#custom-field-filters).

***

## Resolving a Customer by Code

Look up a customer from a QR code, barcode, or account pass:

```http theme={null}
GET /api/v1/customers/resolve-code?o={org_id}&code={identifier_code}
```

Resolves the code via the `ModelIdentifier` system and returns the associated customer resource.

### Creating Custom Model Identifiers

To assign a custom identifier (barcode, member number, etc.) to a customer, create a `model-identifier` linked to the customer:

```http theme={null}
POST /api/v1/model-identifiers?o={org_id}

{
  "data": {
    "type": "model-identifiers",
    "attributes": {
      "code": "MEMBER-12345",
      "type": "custom"
    },
    "relationships": {
      "identifiable": {
        "data": {
          "type": "customers",
          "id": "{customer_uuid}"
        }
      }
    }
  }
}
```

Once created, the customer can be looked up using `resolve-code` with the assigned code. You can also view a customer's existing identifiers via the `model-identifiers` relationship:

```http theme={null}
GET /api/v1/customers/{customer_id}/model-identifiers?o={org_id}
```

***

## Merging Duplicate Customers

Combine two customer records into one:

```http theme={null}
POST /api/v1/customers/{source_customer_id}/merge?o={org_id}

{
  "referenceId": "{target_customer_uuid}"
}
```

The merge process:

1. Fills empty fields on the target customer from the source (name, phone, birth date, etc.)
2. Merges custom field data (target values take priority on conflicts)
3. Transfers all relationships (bookings, orders, invoices) to the target
4. Links the global account if the source had one and the target doesn't
5. Deletes the source customer record

> **Warning:** This operation is irreversible. The source customer is permanently deleted.

***

## Removing a Customer from a Community

```http theme={null}
GET /api/v1/customers/{customer_id}/remove-from-community?o={org_id}&community_id={community_uuid}
```

Removes the customer's membership from the specified community.

***

## Exporting Customers

Trigger an asynchronous export:

```http theme={null}
POST /api/v1/exports?o={org_id}

{
  "data": {
    "type": "exports",
    "attributes": {
      "type": "customers",
      "filters": {
        "search": "jane"
      }
    }
  }
}
```

The export is processed in the background. Retrieve the download URL from the export resource once complete.

***

## Common Errors

| Error | Cause | Solution |
| - | - | - |
| `422` — email already exists | Duplicate email in organization | Use search to find the existing record, or merge |
| `404` — code not found | Invalid identifier code | Verify the code belongs to this organization |
| `422` — merge reference not found | Invalid target customer UUID | Verify the target customer exists |

***

## Delivery Address

Customers can have a **delivery address** stored as a separate `address` resource. This is used when a service or plan requires a delivery address during checkout (configured via `requires_delivery_address` on the service/plan).

### Reading the Delivery Address

Include the `delivery_address` relationship:

```http theme={null}
GET /api/v1/customers/{customer_uuid}?o={org_id}&include=delivery_address
```

The response includes the address in the `included` array:

```json theme={null}
{
  "data": {
    "type": "customers",
    "id": "{uuid}",
    "relationships": {
      "delivery_address": {
        "data": { "type": "addresses", "id": "{address_uuid}" }
      }
    }
  },
  "included": [
    {
      "type": "addresses",
      "id": "{address_uuid}",
      "attributes": {
        "street_address": "123 Main St",
        "city": "Berlin",
        "zip_code": "10115",
        "country_code": "DE"
      }
    }
  ]
}
```

### How Delivery Addresses Are Set

Delivery addresses are collected during checkout when the booked service has `requires_delivery_address: true`. The address is submitted as part of the order form data and stored on the customer record. The order also snapshots the delivery address text at the time of purchase.

### Including on Other Resources

```http theme={null}
GET /api/v1/orders?o={org_id}&include=customer.delivery_address
GET /api/v1/bookings/{id}?o={org_id}&include=customer.delivery_address
GET /api/v1/plan-subscriptions?o={org_id}&include=customer.delivery_address
```


# Exports
Source: https://docs.anny.co/developers/guides/admin/exports



Admin export endpoints are grouped here so bulk data extraction is documented in one place.

For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For authentication, see [Authentication](/developers/guides/authentication).

***

## Prerequisites

* Bearer token with admin access
* Organization context (`?o={organization_id}`) where required

***

## Data Export Endpoints

These endpoints trigger a CSV/Excel export for a filtered dataset.

| Dataset | Endpoint |
| - | - |
| Bookings | `GET /api/v1/bookings/export?o={org_id}` |
| Customers | `GET /api/v1/customers/export?o={org_id}` |
| Orders | `GET /api/v1/orders/export?o={org_id}` |
| Vouchers | `GET /api/v1/vouchers/export?o={org_id}` |
| Invoices | `GET /api/v1/invoices/export?o={org_id}` |
| Booking Passes | `GET /api/v1/booking-passes/export?o={org_id}` |

The resource-specific export endpoints accept the same filter parameters as their corresponding list endpoints.

***

## Export Jobs

Use the export job endpoints to inspect generated exports and manage retries or downloads.

| Action | Endpoint |
| - | - |
| List exports | `GET /api/v1/exports?o={org_id}` |
| Get one export | `GET /api/v1/exports/{export_id}?o={org_id}` |
| Download export file | `GET /api/v1/exports/{export_id}/download?o={org_id}` |
| Cancel export | `GET /api/v1/exports/{export_id}/cancel?o={org_id}` |
| Retry export | `GET /api/v1/exports/{export_id}/retry?o={org_id}` |

***

## Export Destinations

Export destinations define where scheduled exports are delivered.

| Action | Endpoint |
| - | - |
| List destinations | `GET /api/v1/export-destinations?o={org_id}` |
| Create destination | `POST /api/v1/export-destinations?o={org_id}` |
| Get destination | `GET /api/v1/export-destinations/{export_destination_id}?o={org_id}` |
| Update destination | `PATCH /api/v1/export-destinations/{export_destination_id}?o={org_id}` |
| Delete destination | `DELETE /api/v1/export-destinations/{export_destination_id}?o={org_id}` |
| Test connection | `GET /api/v1/export-destinations/{export_destination_id}/test-connection?o={org_id}` |

***

## Export Schedules

Export schedules automate recurring exports.

| Action | Endpoint |
| - | - |
| List schedules | `GET /api/v1/export-schedules?o={org_id}` |
| Create schedule | `POST /api/v1/export-schedules?o={org_id}` |
| Get schedule | `GET /api/v1/export-schedules/{export_schedule_id}?o={org_id}` |
| Update schedule | `PATCH /api/v1/export-schedules/{export_schedule_id}?o={org_id}` |
| Delete schedule | `DELETE /api/v1/export-schedules/{export_schedule_id}?o={org_id}` |
| Duplicate schedule | `GET /api/v1/export-schedules/{export_schedule_id}/duplicate?o={org_id}` |
| Run schedule now | `GET /api/v1/export-schedules/{export_schedule_id}/run?o={org_id}` |


# Invoices
Source: https://docs.anny.co/developers/guides/admin/invoices



Create, send, and manage invoices through the admin API.

For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For authentication, see [Authentication](/developers/guides/authentication).

***

## Prerequisites

* Bearer token with admin access + `?o={organization_id}`

***

## Invoice Actions

### Cancel an Invoice

```http theme={null}
POST /api/v1/invoices/{invoice_id}/cancel?o={org_id}
```

Creates a credit note and voids the invoice.

### Mark as Paid

Mark a SENT invoice as paid without processing a payment:

```http theme={null}
PUT /api/v1/invoices/{invoice_id}/set-paid?o={org_id}

{
  "send_notification": true
}
```

Set `send_notification` to `true` to email the customer a payment confirmation.

### Change Recipient

Transfers an invoice to a different customer. This cancels the original invoice and creates a new copy for the new recipient:

```http theme={null}
POST /api/v1/invoices/{invoice_id}/change-recipient?o={org_id}

{
  "customer_id": "new-customer-uuid"
}
```

***

## Creating an Invoice

All examples below assume `BASE_URL = https://{your-domain}/api/v1`.

<Steps>
  <Step title="Find a Customer by Email">
    ```http theme={null}
    GET {BASE_URL}/customers?o={org_id}&filter[email]=jane@example.com&include=address
    ```

    The `email` filter performs an exact (case-insensitive) match.

    For a fuzzy name/email/phone search, use the `search` filter instead:

    ```http theme={null}
    GET {BASE_URL}/customers?o={org_id}&filter[search]=jane&include=address
    ```

    #### Filter by Custom Field

    Custom fields are referenced by their UUID. See [Custom Field Filters](/developers/guides/json-api-conventions#custom-field-filters) for the full syntax and supported operators.

    ```http theme={null}
    GET {BASE_URL}/customers?o={org_id}&filter[custom_fields][{FIELD_UUID}][f_id]={FIELD_UUID}&filter[custom_fields][{FIELD_UUID}][o]==&filter[custom_fields][{FIELD_UUID}][v]=Premium
    ```

    For checkbox fields, pass `true` / `false` as the value. For multi-select fields, the `in` operator accepts comma-separated values.
  </Step>

  <Step title="Create a Customer (if not found)">
    ```http theme={null}
    POST {BASE_URL}/customers?o={org_id}
    ```

    ```json theme={null}
    {
      "data": {
        "type": "customers",
        "attributes": {
          "given_name": "Jane",
          "family_name": "Doe",
          "email": "jane@example.com",
          "company": "Acme Inc",
          "locale": "de",
          "mobile": "+4917612345678"
        }
      }
    }
    ```

    **Required:** `email`, `locale`

    Create the customer's address as a separate resource:

    ```http theme={null}
    POST {BASE_URL}/addresses?o={org_id}
    ```

    ```json theme={null}
    {
      "data": {
        "type": "addresses",
        "attributes": {
          "name": "Jane Doe",
          "street_address": "Hauptstraße 42",
          "zip_code": "50667",
          "city": "Köln",
          "country_code": "DE"
        },
        "relationships": {
          "addressable": {
            "data": { "type": "customers", "id": "{customer_id}" }
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Create the Invoice (draft)">
    ```http theme={null}
    POST {BASE_URL}/invoices?o={org_id}
    ```

    ```json theme={null}
    {
      "data": {
        "type": "invoices",
        "attributes": {
          "currency": "EUR",
          "recipient": "Acme Inc\nJane Doe\nHauptstraße 42\n50667 Köln",
          "calculate_from_net": true
        },
        "relationships": {
          "customer": {
            "data": { "type": "customers", "id": "{customer_id}" }
          }
        }
      }
    }
    ```

    #### Customer linking

    | Method | When to use |
    | - | - |
    | `relationships.customer` in the request body | Manual invoices — pass the customer ID directly |
    | `relationships.reference` (order, subscription, booking pass) | Backend derives customer from the referenced entity |
    | Neither | Create without a customer; link one later via PATCH |

    When the invoice is **sent**, the backend snapshots `recipient` and `buyer_data` from the customer so the invoice stays valid even if the profile changes later.

    #### Attributes

    | Attribute | Type | Required | Notes |
    | - | - | - | - |
    | `currency` | string | **yes** | e.g. `"EUR"`, `"USD"` |
    | `recipient` | string | no | Free-text address block; auto-filled from customer on send if blank |
    | `invoicing_party` | string | no | Your company's address block |
    | `calculate_from_net` | boolean | no | Default `false`. Set `true` when entering net amounts |
    | `issued_at` | date | no | Required when status ≠ `draft` |
    | `due_date` | date | no | |
    | `notes` | string | no | Appears on the invoice |
    | `vat_number` | string | no | |
    | `is_quote` | boolean | no | Set `true` to create a quote instead |
    | `number` | string | no | Must be unique within org if provided |
  </Step>

  <Step title="Add Line Items">
    ```http theme={null}
    POST {BASE_URL}/items?o={org_id}&calculate_from_net=true
    ```

    ```json theme={null}
    {
      "data": {
        "type": "items",
        "attributes": {
          "title": "Consulting — March 2026",
          "quantity": 10,
          "single_net_amount": 150.00,
          "tax_rate": 19
        },
        "relationships": {
          "document": {
            "data": { "type": "invoices", "id": "{invoice_id}" }
          }
        }
      }
    }
    ```

    | Attribute | Type | Required | Notes |
    | - | - | - | - |
    | `title` | string | **yes** | Max 185 chars |
    | `quantity` | integer | **yes** | |
    | `tax_rate` | number | **yes** | ≥ 0 (e.g. `19` for 19%) |
    | `single_net_amount` | number | **yes**\* | Required when `calculate_from_net=true` |
    | `single_gross_amount` | number | **yes**\* | Required when `calculate_from_net=false` |
    | `subtitle` | string | no | Max 185 chars |

    \* Provide the amount matching the invoice direction. The backend derives the other automatically.

    Repeat for each line item. Invoice totals recalculate after each item.
  </Step>

  <Step title="Send the Invoice">
    ```http theme={null}
    POST {BASE_URL}/invoices/{invoice_id}/send?o={org_id}
    ```

    Transitions status to `sent` and delivers via the configured notification channel.
  </Step>

  <Step title="Mark as Paid (optional)">
    ```http theme={null}
    POST {BASE_URL}/invoices/{invoice_id}/set-paid?o={org_id}&sendNotification=true
    ```
  </Step>
</Steps>

***

## Full Workflow Summary

```text theme={null}
1. GET  /customers?filter[email]=...&include=address     → Find customer
2. POST /customers                                        → Create customer (if new)
3. POST /addresses                                        → Create customer address (if new)
4. POST /invoices                                         → Create draft invoice
5. POST /items  (repeat per line item)                    → Add line items
6. POST /invoices/{id}/send                               → Send invoice
7. POST /invoices/{id}/set-paid                           → Mark as paid
```

All endpoints include `?o={organization_id}` for tenant context.

***

## Common Errors

| Error | Cause | Solution |
| - | - | - |
| `403` — unauthorized | Missing permissions for invoice operations | Ensure admin token has the required abilities |
| `422` — invoice not in SENT status | `set-paid` on draft or already-paid invoice | Check invoice status first |


# Webhooks & Events
Source: https://docs.anny.co/developers/guides/admin/webhooks



Receive real-time notifications when resources change in anny. Register a webhook subscription, and the platform will POST event payloads to your URL.

For general request conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For authentication, see [Authentication](/developers/guides/authentication).

***

## Prerequisites

* A valid Bearer token with admin access
* An HTTPS endpoint capable of receiving POST requests
* Organization context (`?o={organization_id}`)

***

<Tabs>
  <Tab title="Creating Webhooks via the Admin Dashboard">
    The easiest way to set up webhooks is through the anny admin dashboard:

    1. Navigate to **Organization Settings → API → Webhooks**
    2. Click **Create Webhook**
    3. Enter your HTTPS endpoint URL, select the events to subscribe to, and save

    For a step-by-step walkthrough with screenshots, see the [help center article on webhooks](https://docs.anny.co/en/articles/349740-webhooks).
  </Tab>

  <Tab title="Creating a Webhook Subscription via API">
    Request path documentation: `paths/admin/webhooks.yaml`

    ```http theme={null}
    POST /api/v1/webhook-subscriptions?o={org_id}

    {
      "data": {
        "type": "webhook-subscriptions",
        "attributes": {
          "name": "My Integration",
          "url": "https://example.com/webhooks/anny",
          "events": ["bookings.created", "bookings.updated", "orders.created"]
        }
      }
    }
    ```

    ### Attributes

    | Attribute | Type | Required | Description |
    | - | - | - | - |
    | `name` | string | Yes | Descriptive label for the subscription |
    | `url` | string | Yes | HTTPS endpoint to receive webhook POSTs |
    | `events` | string\[] | Yes | Array of event identifiers to subscribe to |
    | `custom_headers` | object | No | Additional headers sent with each webhook request |
    | `is_active` | boolean | No | Defaults to `true`. Set to `false` to pause delivery. |

    ### Response

    The response includes a `signing_key` — store this securely. It is auto-generated (64-character random string) and used to verify payload signatures.

    ```json theme={null}
    {
      "data": {
        "type": "webhook-subscriptions",
        "id": "ws-uuid",
        "attributes": {
          "name": "My Integration",
          "url": "https://example.com/webhooks/anny",
          "events": ["bookings.created", "bookings.updated", "orders.created"],
          "signing_key": "a1b2c3...64chars",
          "is_active": true,
          "failure_count": 0,
          "created_at": "2026-03-25T10:00:00+00:00"
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Event Catalog

<AccordionGroup>
  <Accordion title="Bookings">
    | Event | Triggered when |
    | - | - |
    | `bookings.created` | A new booking is created |
    | `bookings.updated` | Booking attributes change (status, dates, etc.) |
    | `bookings.started` | Booking start time is reached |
    | `bookings.ended` | Booking end time is reached |
    | `bookings.checked-in` | Customer checks in |
    | `bookings.checked-out` | Customer checks out |
    | `bookings.deleted` | Booking is permanently deleted |
  </Accordion>

  <Accordion title="Orders">
    | Event | Triggered when |
    | - | - |
    | `orders.created` | Checkout is completed and order is placed |
    | `orders.updated` | Order attributes change |
    | `orders.deleted` | Order is permanently deleted |
  </Accordion>

  <Accordion title="Invoices">
    | Event | Triggered when |
    | - | - |
    | `invoices.created` | Invoice is generated |
    | `invoices.finalised` | Invoice is locked and assigned a number |
    | `invoices.updated` | Invoice attributes change |
    | `invoices.deleted` | Invoice is deleted |
  </Accordion>

  <Accordion title="Customers">
    | Event | Triggered when |
    | - | - |
    | `customers.created` | Customer record is created |
    | `customers.updated` | Customer data changes |
    | `customers.deleted` | Customer is deleted |
  </Accordion>

  <Accordion title="Subscriptions (Plans)">
    | Event | Triggered when |
    | - | - |
    | `subscriptions.created` | Subscription is created |
    | `subscriptions.started` | Subscription period begins |
    | `subscriptions.updated` | Subscription attributes change |
    | `subscriptions.renewed` | Subscription renews for a new period |
    | `subscriptions.charged` | Subscription payment is processed |
    | `subscriptions.suspended` | Subscription is paused |
    | `subscriptions.canceled` | Subscription is cancelled |
    | `subscriptions.reactivated` | Suspended subscription resumes |
    | `subscriptions.ended` | Subscription expires |
  </Accordion>

  <Accordion title="Timeslots">
    | Event | Triggered when |
    | - | - |
    | `timeslots.created` | Timeslot is created |
    | `timeslots.updated` | Timeslot changes |
    | `timeslots.started` | Timeslot start time is reached |
    | `timeslots.ended` | Timeslot end time is reached |
    | `timeslots.deleted` | Timeslot is deleted |
  </Accordion>

  <Accordion title="Communities">
    | Event | Triggered when |
    | - | - |
    | `community-accounts.joined` | Member joins a community |
    | `community-accounts.left` | Member leaves a community |
  </Accordion>
</AccordionGroup>

***

## Payload Structure

Every webhook delivery is a POST request with `Content-Type: application/json`. The payload uses a **normalized flat JSON** format — not JSON-API.

```json theme={null}
{
  "event": "bookings.updated",
  "event_id": "evt-a1b2c3d4-...",
  "webhook_id": "ws-uuid",
  "triggered_at": "2026-03-25T10:00:00+00:00",
  "data": {
    "id": "b1",
    "type": "bookings",
    "start_date": "2026-04-01T10:00:00+02:00",
    "end_date": "2026-04-01T11:00:00+02:00",
    "status": "accepted",
    "resource": {
      "id": "r1",
      "type": "resources",
      "name": "Meeting Room A",
      "slug": "meeting-room-a"
    },
    "service": {
      "id": "s1",
      "type": "services",
      "name": "Standard Hourly"
    },
    "customer": {
      "id": "c1",
      "type": "customers",
      "first_name": "Jane",
      "last_name": "Doe"
    }
  }
}
```

### Key differences from JSON-API

| | JSON-API (management endpoints) | Webhook payload |
| - | - | - |
| Attributes | Nested under `data.attributes` | Flat on `data` top level |
| Relationships | Under `data.relationships` as ID references | Nested as full objects under their name |
| Side-loaded | `included` array | Not used — relations are inline |
| Content-Type | `application/vnd.api+json` | `application/json` |

### Included relations per entity

| Entity | Included relations |
| - | - |
| Bookings | `resource`, `resource.parent`, `service`, `customer`, `customer.address` |
| Orders | `customer`, `bookings` |
| Invoices | `customer`, `order` |
| Customers | `address` |
| Subscriptions | `customer`, `plan` |
| Timeslots | `resource`, `service` |
| Community Accounts | `customer`, `community` |

<Note>
  Included relations and fieldsets may vary by event. The table above shows typical inclusions.
</Note>

***

## Signature Verification

Every webhook request includes a `Signature` header containing an HMAC SHA-256 hash of the request body, signed with your subscription's `signing_key`.

### Verifying the Signature

```text theme={null}
received_signature = request.headers["Signature"]
expected_signature = HMAC-SHA256(signing_key, request.body)

if received_signature != expected_signature:
    reject request (return 401)
```

<Warning>
  Always verify the signature before processing the payload. This prevents spoofed requests.
</Warning>

***

## Retry Policy

If your endpoint doesn't respond with a `2xx` status code within **10 seconds**, the delivery is retried:

| Attempt | Timing |
| - | - |
| 1st | Immediate |
| 2nd | Exponential backoff |
| 3rd | Exponential backoff |

After **3 failed attempts** for a single event, that delivery is abandoned.

***

## Auto-Deactivation

If deliveries fail repeatedly across events, the subscription's `failure_count` increments. After **5 consecutive failures**, the subscription is automatically deactivated:

* `is_active` is set to `false`
* `failure_count` resets to `0`
* Organization admins receive a notification about the deactivation

To reactivate, update the subscription:

```http theme={null}
PATCH /api/v1/webhook-subscriptions/{id}?o={org_id}

{
  "data": {
    "type": "webhook-subscriptions",
    "id": "{id}",
    "attributes": {
      "is_active": true
    }
  }
}
```

***

## Managing Subscriptions

### List All Subscriptions

```http theme={null}
GET /api/v1/webhook-subscriptions?o={org_id}
```

### Update Events

```http theme={null}
PATCH /api/v1/webhook-subscriptions/{id}?o={org_id}

{
  "data": {
    "type": "webhook-subscriptions",
    "id": "{id}",
    "attributes": {
      "events": ["bookings.created", "bookings.updated", "customers.created"]
    }
  }
}
```

### Delete a Subscription

```http theme={null}
DELETE /api/v1/webhook-subscriptions/{id}?o={org_id}
```

***

## Best Practices

1. **Respond quickly** — return `200` immediately and process the payload asynchronously. The 10-second timeout is strict.
2. **Handle duplicates** — use `event_id` to deduplicate. The same event may be delivered more than once on retries.
3. **Verify signatures** — always validate the `Signature` header before trusting the payload.
4. **Subscribe selectively** — only subscribe to events you actually process to minimize traffic.
5. **Monitor `failure_count`** — periodically check subscription status to catch issues before auto-deactivation.

***

## Normalized JSON via Accept Header

Webhook management endpoints (and all other API `GET` endpoints) also support `Accept: application/json` to receive the same flat/normalized format used in webhook payloads.

```http theme={null}
GET /api/v1/webhook-subscriptions?o={org_id}
Accept: application/json
```

This returns attributes at the top level instead of nested under `data.attributes`, matching the webhook payload structure.

> `POST` and `PATCH` requests must still use `Content-Type: application/vnd.api+json` with standard JSON-API format.


# Authentication
Source: https://docs.anny.co/developers/guides/authentication



All API requests require a Bearer token in the `Authorization` header:

```http theme={null}
Authorization: Bearer {access_token}
```

***

<Tabs>
  <Tab title="Quickstart: Access Token via Dashboard">
    The fastest way to get started is to create a long-lived access token directly in the admin dashboard:

    1. Go to [Organization Settings → API](https://app.anny.co/en-us/organization/settings/api)
    2. Create a new access token and select the scopes you need
    3. Copy the token and use it in your API requests

    This is the recommended approach for server-side integrations and scripts.
  </Tab>

  <Tab title="Integration Connectors">
    For no-code/low-code integrations, anny provides native connectors for **Make.com** and **n8n**. These handle authentication automatically — no manual token management needed.
  </Tab>

  <Tab title="OAuth2 Authorization Code Flow">
    <Note>
      A custom OAuth2 Client ID is a special case. Contact [support@anny.co](mailto:support@anny.co) with your use case to request one.
    </Note>

    For applications that need user-delegated access, anny supports the standard OAuth2 Authorization Code Flow (with optional PKCE for public clients).

    <Steps>
      <Step title="Authorization Request">
        Redirect the user to the authorization endpoint:

        ```http theme={null}
        https://auth.anny.co/oauth/authorize?client_id={client_id}&response_type=code&redirect_uri={redirect_uri}&state={random_state}&scope=
        ```

        For **PKCE** (mobile/SPA apps), also include `code_challenge={challenge}&code_challenge_method=S256`.

        After the user signs in, the **Authorization Request** screen lists the requested permissions and an optional **Organization access** control. The default is **All organizations**. Choosing one organization restricts the grant: the access token then includes a `tenant` claim with that organization's UUID, and refresh tokens keep the same restriction. Profile permissions still apply. Leave the default if the integration should not be limited to one organization.
      </Step>

      <Step title="Code Exchange">
        After the user authorizes, exchange the callback `code` for tokens:

        ```js theme={null}
        const response = await fetch('https://auth.anny.co/oauth/token', {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({
            client_id: '{client_id}',
            client_secret: '{client_secret}', // omit for PKCE
            code: '{authorization_code}',
            redirect_uri: '{redirect_uri}',
            grant_type: 'authorization_code',
            code_verifier: '{code_verifier}' // PKCE only
          })
        })

        const { access_token, refresh_token, expiresIn } = await response.json()
        ```

        ### Token Response

        ```json theme={null}
        {
          "access_token": "eyJ...",
          "refresh_token": "def...",
          "expiresIn": 1440,
          "expiresAt": "2026-03-30T10:00:00+00:00"
        }
        ```

        Use `refresh_token` to obtain new access tokens before expiry.
      </Step>
    </Steps>
  </Tab>
</Tabs>


# Availability & Booking Search
Source: https://docs.anny.co/developers/guides/availability



Find available time slots for services and resources. This guide covers the typical search flow and advanced scenarios like recurring bookings, series, and waitlists.

For general request conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For authentication, see [Authentication](/developers/guides/authentication).

***

## Prerequisites

* An organization with at least one **resource** and one **service** configured
* Public API endpoints — no authentication required (availability is public by default)
* Organization context is derived from the resource/service being queried

***

## Domain Model

```text theme={null}
Organization
  ├── Resources (rooms, desks, people, etc.)
  │     └── Schedule Groups → Schedules (weekly recurring) + Timeslots (fixed date-time blocks)
  └── Services (what can be booked — duration, pricing, capacity)
        └── Optional: own Schedules/Timeslots to constrain time further
```

Resources and Services exist at the same level under an Organization with a **many-to-many** relationship. A service can be offered on multiple resources, and a resource can have multiple services.

* A **resource** is the bookable entity (e.g. a meeting room, a therapist). It has **schedule groups** containing **schedules** (weekly recurring availability) and/or **timeslots** (fixed date-time blocks).
* A **service** defines booking rules: duration constraints, pricing, capacity. Services may optionally have their own schedules/timeslots — when present, a slot is bookable only when the resource's and service's availability periods overlap.
* A **booking** always belongs to both a resource and a service.
* A **blocker** is a booking without a service, with `is_blocker` flag set to `true`. It blocks availability on a resource without representing a real booking.

### How Availability is Calculated

The availability engine merges a resource's schedules and timeslots into **availability periods** (= opening hours). These are then combined with the service's duration settings to generate **bookable intervals**. Existing bookings and blockers reduce the remaining capacity.

***

## Typical Search Flow

Request path documentation:

* `paths/public/availability.yaml` for all `/api/v1/availability/*` endpoints in this guide
* `paths/public/availability.yaml` for `GET /api/v1/service-configuration`
* `paths/public/availability.yaml` for `GET /api/v1/intervals/waitlist-start` and `GET /api/v1/intervals/waitlist-end`

The standard booking search follows these steps:

<Steps>
  <Step title="Get Service Configuration">
    Retrieve booking rules and the next available date for a service:

    ```http theme={null}
    GET /api/v1/service-configuration?service_id={service_uuid}&resource_id={resource_uuid}
    ```

    **Response** includes:

    | Field | Description |
    | - | - |
    | `mainService` | Service identity and pricing |
    | `unit` | Duration unit (minutes, hours, days) |
    | `minDuration` / `maxDuration` | Allowed booking duration range |
    | `price` | Pricing rules and modifiers |
    | `meta.next_available_date` | First date with availability |

    Use `next_available_date` to initialize the calendar view.
  </Step>

  <Step title="Find Available Dates">
    Get a list of dates with available slots within a range:

    ```http theme={null}
    GET /api/v1/availability/start-dates?service_id={service_uuid}&start_date=2026-04-01&end_date=2026-04-30
    ```

    Optional parameters:

    | Parameter | Description |
    | - | - |
    | `resource_id` | Limit to a specific resource |
    | `original_booking_id` | Exclude an existing booking's time (for rebooking) |

    **Response:** An array of date strings that have at least one available slot.
  </Step>

  <Step title="Get Start Time Intervals">
    Once the user selects a date, fetch available start times:

    ```http theme={null}
    GET /api/v1/availability/start?service_id={service_uuid}&date=2026-04-15
    ```

    Optional parameters:

    | Parameter | Type | Description |
    | - | - | - |
    | `resource_id` | string | Limit to a specific resource |
    | `duration` | integer | Desired duration in minutes (narrows results) |

    **Response:** An array of interval objects:

    ```json theme={null}
    [
      {
        "start_date": "2026-04-15T09:00:00+02:00",
        "available": true,
        "number_available": 3,
        "remaining_number_available": 2,
        "resource_ids": ["r1", "r2", "r3"]
      },
      {
        "start_date": "2026-04-15T10:00:00+02:00",
        "available": false,
        "unavailability_type": "booked_out"
      }
    ]
    ```

    #### Unavailability Types

    | Type | Meaning |
    | - | - |
    | `none` | Available |
    | `booked_out` | All capacity taken |
    | `lead_time_conflict` | Too close to current time |
    | `under_min_duration` | Remaining time is below minimum |
    | `staggered_conflict` | Conflicts with staggered booking rules |
  </Step>

  <Step title="Get End Time Intervals (Flexible Duration Only)">
    If the service allows flexible (variable) duration, fetch valid end times after the user picks a start. This lets the user request multiple possible end intervals for the chosen start interval.

    ```http theme={null}
    GET /api/v1/availability/end?service_id={service_uuid}&date_time=2026-04-15T09:00:00%2B02:00
    ```

    Optional parameters:

    | Parameter | Type | Description |
    | - | - | - |
    | `resource_id` | string | Limit to a specific resource |
    | `adhoc` | boolean | Whether this is an ad-hoc booking |

    **Response:** Array of end intervals with availability status.

    <Note>
      Skip this step for services with fixed or auto duration — the end time is calculated automatically from `start_date + duration`.
    </Note>
  </Step>
</Steps>

***

## Additional Endpoints

### Next Available Date

Get the absolute next available date without scanning a range:

```http theme={null}
GET /api/v1/availability/next-date?service_id={service_uuid}
```

Useful for "book next available" shortcuts.

### Availability Periods (Opening Hours)

Get raw availability blocks (opening hours) for a resource:

```http theme={null}
GET /api/v1/availability/periods?service_id={service_uuid}&resource_id={resource_uuid}
```

These represent the merged schedule/timeslot periods — the times when the resource is generally open. Useful for calendar heatmaps or dense schedule displays.

### Upcoming Intervals

Get the next N available intervals from now. This endpoint allows a list-based selection flow without requiring the user to pick a day in a calendar first:

```http theme={null}
GET /api/v1/availability/upcoming-intervals?service_id={service_uuid}
```

| Parameter | Type | Description |
| - | - | - |
| `start_date` | string | Start scanning from this date |
| `duration` | integer | Desired duration in minutes |
| `include_unavailable` | boolean | Include unavailable slots in results |

***

## Advanced Scenarios

<AccordionGroup>
  <Accordion title="Recurring Bookings">
    For bookings that repeat on a schedule:

    ```http theme={null}
    GET /api/v1/availability/recurring?service_id={service_uuid}&resource_id={resource_uuid}
    ```

    Returns availability data structured for recurring selection (e.g. "every Monday 10:00–11:00").
  </Accordion>

  <Accordion title="Series / Timeslot-Based Bookings">
    Some services use predefined **timeslot series** (e.g. a course with 10 sessions):

    ```http theme={null}
    GET /api/v1/availability/series?timeslot_series_id={series_uuid}&service_id={service_uuid}
    ```

    Get individual intervals within a series:

    ```http theme={null}
    GET /api/v1/availability/series-intervals?timeslot_series_id={series_uuid}
    ```
  </Accordion>

  <Accordion title="Waitlist">
    When a slot is fully booked, the waitlist endpoints provide intervals where customers can register interest:

    ```http theme={null}
    GET /api/v1/intervals/waitlist-start?service_id={service_uuid}&date=2026-04-15
    GET /api/v1/intervals/waitlist-end?service_id={service_uuid}&date_time=2026-04-15T09:00:00%2B02:00
    ```

    These follow the same pattern as start/end intervals but return waitlist-eligible slots.

    For the concrete UI rule set, auth requirements, and the `POST /api/v1/waitlist-spots` payload, see [Waitlist](/developers/guides/customer/waitlist).
  </Accordion>
</AccordionGroup>

***

## Timezone Handling

All dates in requests should include timezone offsets (ISO 8601 / Atom format):

```text theme={null}
2026-04-15T09:00:00+02:00
```

Pass the `timezone` parameter when the user's timezone differs from the resource's configured timezone:

```http theme={null}
GET /api/v1/availability/start?service_id={id}&date=2026-04-15&timezone=America/New_York
```

The API returns dates in the resource's timezone by default. Interval objects include both UTC (`start_date`) and local (`local_date_time`) representations when timezone conversion applies.

***

## Common Errors

| Error | Cause | Solution |
| - | - | - |
| `422` — service\_id required | Missing `service_id` parameter | Always include `service_id` in availability requests |
| `422` — invalid date format | Date not in `Y-m-d` or Atom format | Use `YYYY-MM-DD` for date-only params, Atom for datetime |
| Empty results | Resource has no schedule or service is inactive | Verify the resource has an active schedule and the service is published |


# Booking Bundle Groups
Source: https://docs.anny.co/developers/guides/booking-bundle-groups

JSON:API contract for grouping booking bundles in admin and native apps. Mirror service groups and add-on groups.

Booking bundles (packages / codes) can be assigned to **booking bundle groups**, the same pattern as [service groups](/developers/models/service-groups) and [add-on groups](/developers/models/add-on-groups).

This is the contract for admin clients and native apps. For JSON:API conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions).

<Info>
  JSON:API type: `booking-bundle-groups`. Bundles expose a nullable `group` relationship (`booking-bundle-groups`). Deleting a group **detaches** bundles (`group_id` is set to `null`); it does not delete the bundles.
</Info>

***

## Resource

| | |
| - | - |
| Type | `booking-bundle-groups` |
| Admin collection | `GET/POST /api/v1/booking-bundle-groups` |
| Admin resource | `GET/PATCH/DELETE /api/v1/booking-bundle-groups/{id}` |
| Public catalog | Organization relationships `offered-booking-bundle-groups` and `available-booking-bundles` |

Index is readable without a write permission. Create, update, and delete require `create` / `update` on any resource plus access to the organization (`?o=`).

<Note>
  Shop and native apps must load groups from the organization with `include=offered_booking_bundle_groups` or the related resource `GET /api/v1/organizations/{slug}/offered-booking-bundle-groups`.
</Note>

### Attributes

| Attribute | Type | Visibility | Description |
| - | - | - | - |
| `name` | string | public | Resolved name for `Accept-Language` |
| `description` | string | public | Resolved description for `Accept-Language` |
| `order_index` | number | public | Display order among groups |
| `created_at` | datetime | public | Creation timestamp |
| `local_name_i18n` | object | admin | Full name translation map |
| `description_i18n` | object | admin | Full description translation map |

Write `name` (required, max 191) and optional `description` / `order_index`. Send translations as `local_name_i18n.{locale}` and `description_i18n.{locale}`.

### Relationships

| Relationship | Type | Include |
| - | - | - |
| `booking_bundles` | has-many `booking-bundles` | `include=booking_bundles` |

Allowed sort: `order_index`, `name`, `created_at`. Allowed filters: `filter[ids]`, `filter[search]`.

***

## Bundle relationship and filters

Every `booking-bundles` resource has a nullable `group` relationship. Include it on list, read, and public catalog requests:

```http theme={null}
GET /api/v1/booking-bundles?include=group&sort=order_index
GET /api/v1/booking-bundles/{slug}?include=group
GET /api/v1/organizations/{slug}/available-booking-bundles?include=group,cover_image,organization.logo_image&sort=order_index
```

### Filters on `booking-bundles` and `available-booking-bundles`

| Filter | Type | Description |
| - | - | - |
| `filter[group_id]` | string | Bundles in one group |
| `filter[groups]` | string or string\[] | Bundles in any of the given group ids |
| `filter[without_group]` | string | Pass `true` (string) to return ungrouped bundles only |

<Warning>
  Send `filter[without_group]=true` as a **string**. A JSON boolean query value is rejected by the JSON:API decoder.
</Warning>

```http theme={null}
GET /api/v1/organizations/{slug}/available-booking-bundles?filter[group_id]=16&include=group&sort=order_index
GET /api/v1/organizations/{slug}/available-booking-bundles?filter[without_group]=true&include=group&sort=order_index
```

Assign or clear a group on create/update via the JSON:API relationship (same as services / add-ons):

```json theme={null}
{
  "data": {
    "type": "booking-bundles",
    "attributes": { "name": "10er Karte" },
    "relationships": {
      "group": {
        "data": { "type": "booking-bundle-groups", "id": "16" }
      }
    }
  }
}
```

Set `relationships.group.data` to `null` to ungroup.

***

## Public catalog (shop and native customer apps)

Load the live groups that currently have at least one **live** bundle, then load bundles per group.

<Tabs>
  <Tab title="Include on the organization">
    ```http theme={null}
    GET /api/v1/organizations/{slug}?include=offered_booking_bundle_groups,available_booking_bundles.group,available_booking_bundles.cover_image
    ```
  </Tab>

  <Tab title="Related resources">
    ```http theme={null}
    GET /api/v1/organizations/{slug}/offered-booking-bundle-groups?sort=order_index
    GET /api/v1/organizations/{slug}/available-booking-bundles?filter[group_id]={groupId}&include=group,cover_image,organization.logo_image&sort=order_index&page[size]=10
    GET /api/v1/organizations/{slug}/available-booking-bundles?filter[without_group]=true&include=group,cover_image,organization.logo_image&sort=order_index
    ```
  </Tab>
</Tabs>

`offered-booking-bundle-groups` only returns groups that have at least one live bundle. Empty groups do not appear in the shop catalog.

### How to render the package list

Match the web shop: one collapsible section per offered group (title = `name`, optional subtitle = `description`), then an **Other** section for `filter[without_group]=true`.

<Steps>
  <Step title="Load offered groups">
    Request `offered_booking_bundle_groups` (or the related resource). Sort by `order_index`.
  </Step>

  <Step title="Load bundles per group">
    For each group, request `available-booking-bundles` with `filter[group_id]` set to that group's id, plus `include=group,cover_image` and `sort=order_index`.
  </Step>

  <Step title="Load ungrouped bundles">
    Request `available-booking-bundles` with `filter[without_group]=true`. If the collection is empty, hide the Other section.
  </Step>

  <Step title="Reuse service-group UI">
    This is the same layout as services (`offered-service-groups` + ungrouped services). Reuse that component; swap the resource type.
  </Step>
</Steps>

<Tip>
  Do not invent grouping from bundle names. Always use `relationships.group` / `filter[group_id]`. After a group is deleted, previously grouped bundles show up under Other.
</Tip>

***

## Admin (native admin app)

Mirror the web admin:

1. **Bundle form** — taggable group select (create a group by typing a new name, same as service groups). Persist via the `group` relationship. Include `group` when loading a bundle.
2. **Bundle list** — grouped panels by `booking-bundle-groups` (`sort=order_index`), plus an ungrouped section (`filter[without_group]=true`).
3. **CRUD** — create/update/delete groups with `name`, `description`, and translations. On delete, keep the bundles; they become ungrouped.

```http theme={null}
GET /api/v1/booking-bundle-groups?filter[search]=gift&sort=order_index&include=booking_bundles
POST /api/v1/booking-bundle-groups?o={organization_id}
PATCH /api/v1/booking-bundle-groups/{id}?o={organization_id}
DELETE /api/v1/booking-bundle-groups/{id}?o={organization_id}
```

Create payload:

```json theme={null}
{
  "data": {
    "type": "booking-bundle-groups",
    "attributes": {
      "name": "Gift cards",
      "description": "Vouchers and gift packages",
      "order_index": 1
    }
  }
}
```

***

## Example group resource

```json theme={null}
{
  "data": {
    "type": "booking-bundle-groups",
    "id": "16",
    "attributes": {
      "name": "Gift cards",
      "description": "Vouchers and gift packages",
      "order_index": 1,
      "created_at": "2026-08-16T12:00:00+00:00"
    },
    "relationships": {
      "booking_bundles": {
        "data": [
          { "type": "booking-bundles", "id": "geschenkgutschein-50" }
        ]
      }
    }
  }
}
```

***

## Related

* [BookingBundle](/developers/models/booking-bundles) — bundle resource; include `group`
* [BookingBundleGroup](/developers/models/booking-bundle-groups) — group resource
* [ServiceGroup](/developers/models/service-groups) — same grouping pattern for services
* [AddOnGroup](/developers/models/add-on-groups) — same grouping pattern for add-ons


# Rate Limiting
Source: https://docs.anny.co/developers/guides/rate-limiting



The anny API enforces rate limits to protect platform stability and ensure fair usage. Limits vary by **authentication level** (admin, customer, anonymous) and **operation type** (read vs. write).

***

## How It Works

Every request is classified along two dimensions:

1. **Identity** — resolved from the access token:
   * **Admin** — authenticated team member (via Admin API)
   * **Customer** — authenticated end-user (via Customer API)
   * **Anonymous** — no token provided (public endpoints)

2. **Operation type**:
   * **Reads** — `GET` requests
   * **Writes** — `POST`, `PATCH`, `PUT`, `DELETE` requests

Each combination of identity and operation type has its own request budget per time window.

***

## Default Limits

<Info>
  Limits are configured per organization and may be adjusted upon request. The values below are the platform defaults.
</Info>

| Identity | Reads | Writes |
| - | - | - |
| **Admin** | 400 requests / 60 s | 100 requests / 60 s |
| **Customer** | 150 requests / 60 s | 60 requests / 60 s |
| **Anonymous** | 150 requests / 60 s | 60 requests / 60 s |

### Identical Request Guard

In addition to the per-identity limits above, the API enforces a **duplicate request guard**: at most **4 identical requests per second**. Two requests are considered identical when they share the same HTTP method, path, query parameters, and JSON body.

This prevents accidental request floods from retry loops or UI bugs without impacting normal usage.

***

## Response Headers

When a rate limit is exceeded, the API responds with HTTP status **`429 Too Many Requests`**:

```http theme={null}
HTTP/1.1 429 Too Many Requests
Retry-After: 42
Content-Type: application/json
```

```json theme={null}
{
  "errors": [
    {
      "status": "429",
      "title": "Too Many Requests",
      "detail": "Too many requests."
    }
  ]
}
```

| Header | Description |
| - | - |
| `Retry-After` | Seconds until the limit resets and requests are accepted again. |

<Warning>
  The API does **not** include `X-RateLimit-Remaining` or `X-RateLimit-Limit` headers on successful responses. You should implement your own request counting on the client side if you need to track remaining quota.
</Warning>

***

## Best Practices

<Steps>
  <Step title="Use Exponential Backoff">
    When you receive a `429` response, wait at least the number of seconds indicated by the `Retry-After` header before retrying. Increase the delay on subsequent retries.
  </Step>

  <Step title="Avoid Duplicate Requests">
    Debounce user-triggered actions (e.g. save buttons) and deduplicate programmatic calls. The identical-request guard will block rapid-fire duplicates.
  </Step>

  <Step title="Use Sparse Fieldsets & Filters">
    Reduce the number of requests by fetching only the data you need. Use `fields[]` and `filter[]` parameters to minimize round-trips — see [JSON:API Conventions](/developers/guides/json-api-conventions).
  </Step>

  <Step title="Cache Where Possible">
    Cache responses for data that changes infrequently (e.g. resource lists, service configurations). This keeps you well within rate limits during normal operation.
  </Step>
</Steps>

***

## Admin API vs. Customer API

The Admin API grants higher limits because admin integrations typically manage bulk operations (exports, calendar sync, multi-booking workflows). The Customer API is tuned for interactive end-user flows like searching availability and completing checkouts.

| Scenario | API | Typical Budget |
| - | - | - |
| Dashboard sync, bulk exports | Admin API | 400 reads / min |
| POS / booking terminal | Admin API | 100 writes / min |
| Storefront availability search | Customer API | 150 reads / min |
| Checkout & booking creation | Customer API | 60 writes / min |
| Public embed (no auth) | Customer API | 150 reads / min |

If your integration requires higher throughput, contact [support@anny.co](mailto:support@anny.co) to discuss custom limits.


# Rich Content Media
Source: https://docs.anny.co/developers/guides/rich-content-media

How images and videos are embedded in TipTap HTML fields, and how native apps should render them.

Resource descriptions, service descriptions, and legal document content are stored as **HTML strings** produced by the TipTap editor. Native apps must not treat these fields as plain text or as a generic WebView dump — images and videos use custom nodes with `data-*` attributes.

This guide is the contract for rendering that HTML in iOS, Android, and other non-web clients.

***

## Where this HTML appears

| JSON:API type | Attribute | i18n attribute | Typical use |
| - | - | - | - |
| `resources` | `description` | `description_i18n` | Resource detail |
| `services` | `description` | `description_i18n` | Service / booking-option detail |
| `legal-documents` | `content` | `content_i18n` | Checkout, check-in, public legal page, signed PDF |

Locale selection follows `Accept-Language`. The flat attribute is the resolved translation; `*_i18n` is the full map (admin only).

<Note>
  The same HTML shape is used in all three places. Implement one renderer and reuse it.
</Note>

***

## Use case: Safety briefing at check-in

Legal-document HTML is often a **safety briefing** collected only at check-in (`Later (at check-in)`). The guest must **start** every embedded video before confirm / check-in is enabled.

1. Parse `legal-documents.content` as in this guide (poster + play button, not a live iframe on bind).
2. On play tap, start the player (or open the watch URL) and mark that video as started.
3. Keep the confirm / sign / check-in action **disabled** until every `data-video-embed` node in the document has been started.
4. Starting the video is enough. Do not require the video to play to the end unless your product adds that later.

Signed PDFs still cannot play video: they get a static poster plus the clickable watch URL (see [PDF rendering](#pdf-rendering)).

***

## Storage format

Content is **HTML**, not TipTap JSON. Custom nodes serialize to semantic tags plus `data-*` attributes so non-JS clients still have a fallback.

Allowed tags after server sanitization include `h1`–`h3`, `p`, `br`, `strong`, `b`, `em`, `i`, `u`, `s`, `ul`, `ol`, `li`, `table`, `thead`/`tbody`/`tr`/`th`/`td`, `a`, `img`, `div`, and `iframe` (video hosts only).

`script`, `style`, and `javascript:` URLs are stripped on save.

***

## Images

Images persist as a normal `<img>` with extra metadata:

```html theme={null}
<img
  class="tiptap-image"
  src="https://cdn.example.com/storage/images/description-images/original/abc.jpg"
  alt="Meeting room"
  loading="lazy"
  data-image-id="123"
  data-width="50%"
  data-align="center"
/>
```

| Attribute | Required | Meaning |
| - | - | - |
| `src` | Yes | Absolute or root-relative URL of the uploaded image |
| `alt` | No | Accessible label |
| `data-image-id` | Yes for uploaded images | Internal `images` resource id |
| `data-width` | No | Display width: `25%`, `50%`, `75%`, `100%`, or a pixel value |
| `data-align` | No | `left`, `center`, or `right` |

### Native rendering

1. Render `src` with an image view. If `src` is root-relative (`/storage/...`), prefix the API origin.
2. Honor `data-width`: treat percentages as a fraction of the content column, not the device width if you have padded margins.
3. Apply `data-align` as horizontal alignment of the image block.
4. Use `alt` for VoiceOver / TalkBack.
5. Do **not** require `data-image-id` to display the image. It is for lifecycle tracking on the backend.

<Tip>
  Prefer the `src` already present in the HTML. You do not need a second request to `/api/v1/images/{id}` just to show the picture.
</Tip>

***

## Videos

Videos are **not** stored as `<video>` or as a live iframe. The editor persists a fallback link:

```html theme={null}
<a
  class="video-embed"
  data-video-embed="true"
  data-platform="youtube"
  data-video-id="dQw4w9WgXcQ"
  data-src="https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  data-embed-url="https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ"
  data-thumbnail-url="https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
  data-width="640"
  data-height="360"
  data-aspect-ratio="16/9"
  title="Safety briefing"
  href="https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  target="_blank"
  rel="noopener noreferrer"
>Link to video</a>
```

Older or sanitized content may instead look like:

```html theme={null}
<div class="video-embed" data-video-embed="true">
  <iframe
    src="https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ"
    width="640"
    height="360"
    allowfullscreen
    sandbox="allow-same-origin allow-scripts allow-presentation"
    referrerpolicy="no-referrer"
  ></iframe>
</div>
```

Detect a video node if **any** of these are true:

* `a[data-video-embed]` or `*[data-video-embed]`
* `a.video-embed` / `div.video-embed`
* `iframe` whose `src` host is an allowed provider (see below)

### Attributes

| Attribute | Meaning |
| - | - |
| `data-platform` | `youtube`, `vimeo`, or `loom` |
| `data-video-id` | Provider video id |
| `data-src` / `href` | Canonical watch URL (open this in the system browser or in-app player) |
| `data-embed-url` | Iframe embed URL, already parameterized |
| `data-thumbnail-url` | Poster image, when the editor could resolve one |
| `data-aspect-ratio` | Usually `16/9` |
| `title` | Video title, when fetched |

### Supported providers

| Platform | Watch URL examples | Embed host |
| - | - | - |
| YouTube | `youtube.com/watch?v=`, `youtu.be/`, `/shorts/`, `/embed/` | `www.youtube-nocookie.com`, `www.youtube.com` |
| Vimeo | `vimeo.com/{id}`, `player.vimeo.com/video/{id}` | `player.vimeo.com` |
| Loom | `loom.com/share/{id}`, `loom.com/embed/{id}` | `www.loom.com` |

Only **HTTPS** embed hosts from that list are accepted by the API. Reject any other iframe host.

YouTube thumbnail fallback when `data-thumbnail-url` is missing:

```text theme={null}
https://i.ytimg.com/vi/{videoId}/hqdefault.jpg
```

Vimeo and Loom thumbnails are only available when `data-thumbnail-url` is present (resolved via oEmbed at edit time).

***

## How to render videos in a native app

Match the web TipTap renderer: **thumbnail + play button first**, load the player only after a tap.

<Steps>
  <Step title="Parse the node">
    Read `data-src` / `href` as the watch URL, `data-embed-url` as the player URL, and `data-thumbnail-url` as the poster. If you only have an iframe, derive the watch URL from the embed `src`.
  </Step>

  <Step title="Draw the poster">
    Show the thumbnail as a 16:9 cover image. If no thumbnail is available, use a neutral grey background (`#6B7280`). Center a circular play control (dark translucent disc, white triangle) on top.
  </Step>

  <Step title="Handle the tap">
    Preferred: replace the poster with an in-app player / `WKWebView` / `WebView` loaded with `data-embed-url` (add `autoplay=1` after the user gesture). Fallback: open the watch URL in the system browser or YouTube / Vimeo / Loom app. At check-in, treat this tap as "video started" and only then enable confirm.
  </Step>

  <Step title="Always keep the plain URL">
    Under the poster, render the watch URL as a tappable text link. Signed PDFs do the same. This keeps the video reachable when embeds are blocked, offline, or inaccessible.
  </Step>
</Steps>

### Layout

* Default aspect ratio: **16:9** (`data-aspect-ratio` wins when present).
* Width: fill the content column; do not exceed it.
* The play control should stay visually centered on the poster.
* Use `title` (or “YouTube / Vimeo / Loom video”) as the accessibility label of the play control.

### Do not

* Autoplay or preload the iframe on bind. That wastes bandwidth and breaks data-saving modes.
* Execute arbitrary iframe hosts. Stick to the allow-list above.
* Treat the anchor text (`Link to video`) as the only UI. Replace the node with the poster + URL treatment.
* Enable accept, sign, or check-in while any embedded video is still unplayed. Checkout and check-in **block** confirmation until every video in the document has been **started** via the play control (watch-through is not required). Show the same copy as web: **Start the video before you can sign or accept**. See [Use case: Safety briefing at check-in](#use-case-safety-briefing-at-check-in).

***

## Files and entity links

Rich content may also include:

```html theme={null}
<a class="tiptap-file" data-type="file" data-file-id="{uuid}" href="https://.../files/{uuid}">filename.pdf</a>
```

```html theme={null}
<a class="entity-link" data-entity-model="resources" data-entity-id="meeting-room" href="/resources/meeting-room">Meeting room</a>
```

Render files as a download / preview row. Render entity links as in-app navigation to the referenced resource, service, plan, or bundle using `data-entity-model` + `data-entity-id` (slug).

***

## PDF rendering

Signed legal-document PDFs cannot play video. The backend transforms TipTap HTML before TCPDF:

* **Images** are embedded (resolved from `data-image-id` when the file is available).
* **Videos** become a static 16:9 poster (thumbnail + play button, or grey if no thumbnail) **and** the plain watch URL as a clickable link under it.

Native print / share flows should follow the same rule if they generate their own PDF.

***

## Minimal detection cheat sheet

```ts theme={null}
function isVideoNode(el: Element): boolean {
  return el.getAttribute('data-video-embed') === 'true'
    || el.classList.contains('video-embed')
    || (el.tagName === 'IFRAME' && isAllowedVideoHost(el.getAttribute('src')))
}

function isImageNode(el: Element): boolean {
  return el.tagName === 'IMG' && !el.closest('[data-video-embed]')
}
```

Parse with a real HTML parser (`NSAttributedString` + custom HTML, Android `Html` is not enough). Walk the DOM, swap image/video nodes for native views, and render the remaining safe tags as text.

***

## Related

* [JSON-API Conventions](/developers/guides/json-api-conventions) — locale headers and sparse fieldsets
* [Authentication](/developers/guides/authentication) — tokens for fetching resources and legal documents


# Getting Started
Source: https://docs.anny.co/developers/index



anny is a modern booking platform built to power demanding real-world scheduling — from co-working spaces and meeting rooms to medical clinics, rental fleets, and large-scale event venues. The API gives you programmatic access to everything: resources, services, availability, bookings, orders, customers, and more.

This guide helps you find the right API and the right starting point for what you're building.

***

## Two APIs, Two Audiences

anny exposes two distinct APIs. Pick the one that fits your integration:

<Columns>
  <Card title="Admin API" icon="gear">
    **For backend developers and server-side integrations.**

    Full read/write access to your organization. Requires an API token from the admin dashboard — no OAuth setup needed to get started.

    Use it to automate workflows, sync data with external systems, build custom dashboards, and react to real-time events via webhooks.

    [Admin API Reference](/developers/api-reference/admin)
  </Card>

  <Card title="Customer API" icon="user">
    **For frontend developers building end-user experiences.**

    Public-facing surface for booking flows, availability displays, and customer account features. Many endpoints work without any token.

    Use it to embed a custom booking experience in your own app, display live availability on a public website, or build a headless checkout.

    [Customer API Reference](/developers/api-reference/customer)
  </Card>
</Columns>

***

## Which API do I need?

| I want to… | Use |
| - | - |
| Sync customer records from my CRM | Admin API |
| Create bookings from a back-office tool | Admin API |
| Issue or forward invoices to customers | Admin API |
| React to booking events via webhooks | Admin API |
| Feed live data to a digital display panel | Admin API |
| Show availability on a public website | Customer API |
| Embed a custom booking flow in my app | Customer API |
| Build a headless checkout experience | Customer API |
| Let customers manage their own bookings | Customer API |

***

## Admin API — Getting Started

The Admin API is secured with an OAuth2 Bearer token scoped to your organization. The fastest way to get a token is directly from the dashboard — no OAuth flow needed.

<Steps>
  <Step title="Get an API token">
    Go to **[Organization Settings → API](https://app.anny.co/en-us/organization/settings/api)** in the admin panel and generate a long-lived access token. Copy it — you'll use it on every request.
  </Step>

  <Step title="Find your organization ID">
    Your organization ID (`o`) is required as a query parameter on every Admin API request. Find it in the URL of your admin dashboard or in the organization settings page.
  </Step>

  <Step title="Make your first request">
    ```bash theme={null}
    curl https://b.anny.co/api/v1/resources?o={organization_id} \
      -H "Authorization: Bearer {access_token}"
    ```
  </Step>

  <Step title="Subscribe to events (optional)">
    Register a webhook to receive real-time notifications when bookings are created, cancelled, or updated — no polling required.

    See the [Webhooks guide](/developers/guides/admin/webhooks).
  </Step>
</Steps>

***

## Customer API — Getting Started

Many Customer API endpoints require no authentication at all. You can start fetching availability and public resource data immediately.

<Steps>
  <Step title="Find the organization slug">
    Customer API requests are scoped by the organization's public slug (e.g. `acme-gmbh`). You can find it in the anny booking URL or ask the organization owner.
  </Step>

  <Step title="Fetch a resource — no token needed">
    ```bash theme={null}
    curl "https://b.anny.co/api/v1/resources/{resource_slug}"
    ```
  </Step>

  <Step title="Let customers authenticate (optional)">
    To access personal data — bookings, account details, passes — your customers need a bearer token. This requires a custom OAuth2 client. Contact [support@anny.co](mailto:support@anny.co) with your use case to request one.
  </Step>
</Steps>

***

## Platform Capabilities

anny handles the full complexity of real-world booking operations out of the box:

<Columns>
  <Card title="Flexible Availability" icon="calendar">
    Multi-resource scheduling, schedule groups, custom blockers, capacity management, and real-time conflict detection.
  </Card>

  <Card title="Billing & Orders" icon="receipt">
    Full order lifecycle, invoicing, refunds, payment gateway integrations, and price modifiers including vouchers and dynamic pricing.
  </Card>

  <Card title="Communities & Access Control" icon="users">
    Membership groups, booking quotas, community-gated services, and granular access control per resource.
  </Card>
</Columns>

<Columns>
  <Card title="Plans & Passes" icon="ticket">
    Subscription plans, booking passes, quota grants, and account skill tracking for complex membership models.
  </Card>

  <Card title="Webhooks & Automation" icon="arrows-rotate">
    Real-time event delivery for every booking state change. Integrates natively with Make.com and n8n for no-code automation.
  </Card>

  <Card title="Multi-tenant & White-label" icon="building">
    Full multi-tenancy with row-level isolation. Support for custom domains, white-label deployments, and Gov-Cloud hosting.
  </Card>
</Columns>

***

## Guides

Start here based on what you're building:

| Guide | What it covers |
| - | - |
| [Authentication](/developers/guides/authentication) | API tokens, OAuth2 flows, and customer authentication |
| [Availability & Booking Search](/developers/guides/availability) | Search open slots, filter by resource and service |
| [Admin Booking Creation](/developers/guides/admin/booking-creation) | Create bookings and orders from the back office |
| [Admin Booking Edit](/developers/guides/admin/booking-edit) | Edit a confirmed booking: resource, dates, fields, add-ons, sub-bookings |
| [Order & Checkout Flow](/developers/guides/customer/checkout) | Customer-facing cart, checkout steps, and payment handling |
| [Webhooks & Events](/developers/guides/admin/webhooks) | Real-time booking events and event-driven workflows |
| [JSON:API Conventions](/developers/guides/json-api-conventions) | Request format, filtering, pagination, and error handling |

***

<Tip>
  Not sure where to start? For server-side integrations, grab an API token from the dashboard and try the [Admin Booking Creation](/developers/guides/admin/booking-creation) guide. For frontend work, the [Availability & Booking Search](/developers/guides/availability) guide needs no token at all.
</Tip>


# anny Display App
Source: https://docs.anny.co/display-app

Verwandle Tablets und Smart-TVs in interaktive Raumdisplays mit Live-Status, Ad-hoc-Buchung und Check-in.

Die anny Display App zeigt den Belegungsstatus deiner Ressourcen in Echtzeit direkt vor Ort an. Mitarbeitende sehen auf einen Blick, ob ein Raum frei oder belegt ist, und können Buchungen per Touch, anny Pass oder NFC direkt am Display vornehmen.

<Info>
  Aktiviere vorab das Feature **Anzeigetafeln & Raumdisplays** unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktioniert die Display App?

Die Display App läuft als eigenständige Anwendung auf einem Tablet oder Smart-TV und verbindet sich über einen 6-stelligen Pairing-Code mit deinem anny Account. Nach dem Pairing wählst du im Admin-Bereich unter **Displays** die Ressourcen aus, die auf dem Gerät angezeigt werden sollen (Widgets). Das Display aktualisiert sich in Echtzeit: Buchungen, Check-ins und Statusänderungen werden sofort übernommen.

Der grundlegende Ablauf:

## Wann nutze ich das?

* **Du willst Meetingräume mit einem Türdisplay ausstatten**: Die Display App zeigt den aktuellen Status und ermöglicht Spontanbuchungen direkt vor Ort.
* **Deine Mitarbeitenden sollen ohne Anmeldung schnell einen freien Raum buchen können**: Per Gastmodus oder anny Pass ist die Buchung in Sekunden erledigt.
* **Du betreibst Phone Booths oder Fokusräume, die spontan genutzt werden**: Kurze Ad-hoc-Buchungen (10, 20, 30 Minuten) werden direkt am Display angeboten.
* **Nicht geeignet für**: Reine Übersichtsanzeigen ohne App-Installation (z. B. auf einem Smart-TV per Browser). Nutze dafür die [URL Anzeigetafeln](/url-display-boards).

## Zusammenhang mit anderen Features

* **Check-In & Check-Out**: Aktiviere Check-in auf der Ressource, damit Buchungen ohne Check-in nach einer definierten Zeit automatisch verfallen und der Raum freigegeben wird.
* **Communities**: Community-Berechtigungen gelten auch am Display. So schränkst du den Zugriff auf bestimmte Räume ein.
* **Karten & Interaktive Lagepläne**: Wähle als Standardansicht die Kartenansicht, um Ressourcen visuell auf dem Display darzustellen.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Display-Name | Interner Name zur Organisation der Geräte |
| Standardansicht | Karte oder Grid |
| Anonymisierung | Buchungsbeschreibungen auf dem Display ausblenden |
| Interaktion erlauben | Buchungen direkt am Display ermöglichen |
| Sleep Mode | Aktive Tage, Start-/Endzeit und Helligkeit |
| Widgets | Ressourcen, die auf dem Display angezeigt werden |
| Widgets pro Seite | Anzahl Ressourcen pro Seite (Auto-Paginierung) |
| Alternative Widgets | Ausweich-Ressourcen bei Belegung anzeigen |
| Ad-hoc-Buchungen | Schnellbuchung mit vorberechneten Zeitfenstern |
| Gastmodus | Buchung ohne Anmeldung erlauben |

<Tip>
  Die Ad-hoc-Buttons berechnen sich aus minimaler Dauer, maximaler Dauer und Buchungsintervall der ersten verbundenen Buchungsoption. Empfehlung für Meetingräume: min. 30 Min, max. 8h, Intervall 15 Min (ergibt Buttons: 15m, 30m, 45m).
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Unternehmen richtet ein Raumdisplay vor dem Meetingraum ein">
    Mitarbeitende sollen direkt an der Tür sehen, ob der Raum frei ist, und spontan per Ad-hoc-Buchung einbuchen können.
  </Accordion>

  <Accordion title="Ein Coworking-Space ermöglicht Spontanbuchungen per anny Pass am Phone Booth">
    Mitglieder sollen Phone Booths direkt am Display per anny Pass buchen, ohne sich einzuloggen.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Welche Betriebssysteme werden unterstützt?">
    Die Display App ist verfügbar für iOS, macOS (M1 oder neuer), Android, Smart-TVs und Windows (als APK). Lade die App im [App Store](https://apps.apple.com/us/app/anny-room-display/id6468954884), [Google Play](https://play.google.com/store/apps/details?id=co.anny.display\&hl=en_SG\&gl=US) oder als [APK für Windows](https://cdn.anny.co/apps/display-app/latest.apk) herunter.
  </Accordion>

  <Accordion title="Wie funktioniert die Einbuchung per anny Pass?">
    Drücke am Display auf **Buchen** und scanne deinen anny Pass mit der Kamera. Der Pass kann auch im Apple oder Google Wallet hinterlegt werden. Community-Berechtigungen werden dabei automatisch geprüft.
  </Accordion>

  <Accordion title="Können mehrere Ressourcen auf einem Display angezeigt werden?">
    Ja. Füge unter **Widgets** mehrere Ressourcen hinzu und lege fest, wie viele pro Seite angezeigt werden. Das Display paginiert automatisch und blättert zwischen den Seiten.
  </Accordion>

  <Accordion title="Was ist der Unterschied zur URL Anzeigetafel?">
    Die Display App ist eine native Anwendung mit Touch-Interaktion, Ad-hoc-Buchung, Gastmodus, Sleep Mode und anny Pass. URL Anzeigetafeln sind browserbasierte Übersichtsseiten ohne App-Installation, ideal für reine Informationsdisplays.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Das Display zeigt nicht alle Buchungen des Tages an">
    Dies kann bei wiederkehrenden Buchungen auftreten, wenn die Serientermine noch nicht vollständig generiert wurden. Prüfe im Admin-Kalender, ob die Buchungen dort korrekt erscheinen. Falls ja, starte die Display App neu, um die Synchronisation zu erzwingen.
  </Accordion>

  <Accordion title="Die Helligkeit des Displays wird trotz korrekter Sleep-Mode-Zeiten abgedunkelt">
    Die Display App steuert die Helligkeit nur innerhalb der konfigurierten aktiven Zeiten. Prüfe zusätzlich die Energiespar-Einstellungen des Betriebssystems (z. B. iOS Auto-Helligkeit oder Android Adaptive Brightness) und deaktiviere diese gegebenenfalls.
  </Accordion>

  <Accordion title="Der Pairing-Code wird nicht akzeptiert">
    Der Code ist zeitlich begrenzt gültig. Stelle sicher, dass du den aktuell angezeigten Code verwendest und dass das Tablet eine aktive Internetverbindung hat. Für anny.eu und On-Prem: Wähle vorab die korrekte Data Host Region in der App aus.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature-Name in Account-Einstellungen: "Anzeigetafeln & Raumdisplays"
> * UI-Pfad Aktivierung: **Account-Einstellungen** → **Features** → **Anzeigetafeln & Raumdisplays**
> * UI-Pfad Verwaltung: **Displays** in der linken Menüleiste (erscheint nach Aktivierung)
> * Pairing: 6-stelliger Code, generiert in der App, eingegeben im Admin unter **Displays** → **Pair Display App**
> * Ad-hoc-Button-Logik: Bis zu 3 Buttons, berechnet aus min. Dauer, max. Dauer und Buchungsintervall der ERSTEN verbundenen Buchungsoption
> * Gastmodus: Buchung ohne Personalisierung, kein Kundendatensatz
> * anny Pass: QR-Code oder NFC (NFC geräteabhängig), prüft Community-Berechtigungen
> * Abgrenzung URL Anzeigetafeln: Browserbasiert, kein Pairing nötig, keine App-Installation, keine nativen Features (Sleep Mode, NFC). Separater Artikel: /url-display-boards
> * Kompatibilität: iOS, macOS M1+, Android, Smart-TV, Windows (APK)
> * Data Host Region: Muss für anny.eu und On-Prem Kunden VOR dem Pairing in der App gewählt werden
> * Bekannte Einschränkungen: Wiederkehrende Buchungen werden ggf. nicht sofort angezeigt (Bug war gefixt, Stand 08/2025)


# dormakaba exivo mit anny verbinden
Source: https://docs.anny.co/dormakaba-exivo

Vergib bei Buchungen und Community-Mitgliedschaften automatisch zeitlich begrenzte Zugänge zu deinen exivo-Schlössern.

[dormakaba exivo](https://www.dormakaba.com/de-de/exivo) ist ein cloudbasiertes Zutrittskontrollsystem für kleine und mittlere Objekte. Mit der Integration kann anny bei Buchungen und Community-Mitgliedschaften automatisch zeitlich begrenzte Zugänge zu exivo-Komponenten vergeben.

Mit dormakaba exivo kannst du in anny:

* Buchungsbasierte Zugänge mit Vorlauf- und Nachlaufzeit automatisch erstellen
* Community-Mitgliedern dauerhafte Zugänge zu bestimmten Schlössern zuweisen
* Zugangsstatus und Pin-Codes direkt in der Buchungsdetailansicht einsehen

Besonders praktisch ist die Integration, wenn du Räume oder Coworking-Flächen mit dormakaba exivo absicherst und den Zugang vollständig automatisieren möchtest.

<Info>
  Verfügbar ab Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Coworking-Räume automatisch freischalten | **Kund:innen erhalten nach der Buchung automatisch einen zeitlich begrenzten Zugangslink plus Pin.** Du musst keine Schlüssel mehr übergeben oder manuell Zugänge anlegen. |
| Community-Zugang für Mitglieder | **Mitglieder einer Community erhalten dauerhaften Zugang zu definierten Schlössern.** So steuerst du Berechtigungen zentral über anny, ohne jeden Zugang einzeln im Schließsystem zu pflegen. |
| Gebäudezugang bei Tagestickets | **Tagesgäste bekommen nur für die gebuchte Dauer Zutritt.** Der Zugang wird nach Ablauf automatisch entfernt, ohne dass du eingreifen musst. |

## Wie die Exivo-Verbindung funktioniert

Die Integration nutzt die dormakaba exivo REST-API. Du authentifizierst dich mit der **ID der Anlage**, einem **API Schlüssel** und einem **API Geheimnis**, die du in deiner exivo-App findest. Damit autorisierst du anny, Zugänge (Zutrittsrechte mit Zeitfenster und Pin) für die Komponenten deiner Anlage zu erstellen und zu entfernen. Den Pin erzeugt anny dabei automatisch.

Wenn die Zugangsdaten in der exivo-App widerrufen oder neu erzeugt werden, verliert anny den Zugriff. Du musst die Integration in anny dann mit den neuen Zugangsdaten erneut authentifizieren.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Zugänge (erstellen/entfernen) | anny → exivo | Echtzeit bei Buchung/Stornierung |
| Komponenten (Liste) | exivo → anny | Bei Regelkonfiguration |

## dormakaba Exivo verbinden

### Voraussetzungen

Bevor du dormakaba exivo verbindest, stelle sicher, dass du Folgendes hast:

* Einen aktiven dormakaba exivo Account mit Adminrechten
* Deine Zugangsdaten aus der exivo-App: **ID der Anlage**, **API Schlüssel** und **API Geheimnis**
* Mindestens eine Komponente, die im dormakaba Adminbereich eingerichtet und online ist
* anny Professional-Plan oder höher

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **exivo**. Trage die **ID der Anlage**, den **API Schlüssel** und das **API Geheimnis** aus deiner exivo-App ein. Klicke auf **Authentifizierung überprüfen**.
  </Step>

  <Step title="Konfigurieren">
    Erstelle Regeln für buchungsbasierte (**Zugang durch Buchungen**) oder Community-basierte Zugänge (**Zugang durch Communities**):

    1. Klicke auf **Hinzufügen**, um eine neue Regel zu erstellen
    2. Wähle eine **Ressource** (für Buchungszugänge) oder eine **Community** (für Mitgliederzugänge)
    3. Wähle unter **Komponenten auswählen** eine oder mehrere Komponenten aus
    4. Lege bei Buchungszugängen **Zugang vor der Buchung** und **Zugang nach der Buchung** fest (jeweils in Minuten)
    5. Aktiviere optional **Zugang über Keypad verwenden**, wenn Kund:innen den Pin direkt an der Tastatur des Schlosses eingeben sollen
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, werden Zugänge automatisch bei neuen Buchungen erstellt und bei Stornierungen entfernt.

<Tip>
  Bestehende Regeln kannst du über die **drei Punkte** rechts neben der Regel bearbeiten oder löschen.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Zugang vor der Buchung | Minuten, die der Zugang vor Buchungsbeginn aktiv ist |
| Zugang nach der Buchung | Minuten, die der Zugang nach Buchungsende aktiv bleibt |
| Zugang über Keypad verwenden | Ist der Schalter aus, bekommen Kund:innen einen Link plus Pin per E-Mail. Ist er an, bekommen sie nur einen Pin für die Tastatur am Schloss |
| Komponenten | Eine oder mehrere exivo-Komponenten pro Regel |

## Buchungsprozess für Kund:innen

So erleben deine Kund:innen die Integration:

<Steps>
  <Step title="Raum buchen">
    Kund:innen buchen eine Ressource über anny.
  </Step>

  <Step title="Zugangslink erhalten">
    anny generiert automatisch einen individuellen Zugangslink plus Pin und versendet beides in der Buchungsbestätigung per E-Mail.
  </Step>

  <Step title="Schloss öffnen">
    Kund:innen öffnen den **Link aus der E-Mail**, geben den **Pin** ein und klicken auf **Login**. Dort werden die Zugänge angezeigt, die zur gebuchten Ressource gehören. Ist für die Regel **Zugang über Keypad verwenden** aktiv, geben Kund:innen den Pin stattdessen direkt an der Tastatur des Schlosses ein.
  </Step>
</Steps>

## Zugänge im Adminbereich einsehen

In der **Buchungsdetailansicht** werden aktive und inaktive Zugänge angezeigt. Klicke auf einen Zugang, um Details einzusehen:

| Status | Bedeutung |
| - | - |
| In Bearbeitung | Der Zugang wurde von anny angefordert, aber noch nicht vom Schließsystem vergeben |
| Erfolgreich | Der Zugang ist aktiv und Kund:innen können das Schloss im definierten Zeitraum bedienen |
| Geplant | Der Zugang ist vorgemerkt und wird kurz vor dem Termin erstellt. Das betrifft Serien- und wiederkehrende Buchungen |
| Fehlgeschlagen | Der Zugang konnte nicht erstellt werden. anny benachrichtigt die hinterlegten Admins |
| Entfernt | Der Zugang wurde vom System oder einem Admin entfernt |

<Tip>
  Über die **drei Punkte** in der Zugangsdetailansicht kannst du den Zugang über **Zugang beim Anbieter anzeigen** im exivo-Besucherportal öffnen, die **Integrationseinstellungen** aufrufen oder mit **Zugänge neu erstellen** einen fehlgeschlagenen Zugang erneut anlegen.
</Tip>

## Einschränkungen

Die dormakaba exivo-Integration unterstützt nicht:

* Remote Open (Türöffnung per Knopfdruck aus anny heraus): Kund:innen nutzen stattdessen den Zugangslink plus Pin oder den Tastatur-Pin am Schloss
* Mehrere Anlagen pro Integration: Pro Integration kann nur eine exivo-Anlage verbunden werden
* Automatische Erneuerung der Zugangsdaten: Bei neuen Zugangsdaten muss die Integration manuell neu authentifiziert werden

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</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 Hardware ist mit exivo kompatibel?">
    Alle Informationen zur unterstützten Hardware findest du auf der [dormakaba exivo Webseite](https://www.dormakaba.com/de-de/exivo). anny kommuniziert über die exivo Cloud-API, die Hardware-Kompatibilität wird von dormakaba bestimmt.
  </Accordion>

  <Accordion title="Können Kund:innen mehrere Komponenten mit einer Buchung öffnen?">
    Ja. Du kannst pro Regel mehrere Komponenten zuweisen. Alle zugewiesenen Komponenten erscheinen nach dem Login auf der Zugangsseite.
  </Accordion>

  <Accordion title="Bekommen meine Kund:innen einen Link oder einen Pin für die Tastatur?">
    Das steuerst du pro Regel über **Zugang über Keypad verwenden**. Ist der Schalter aus, bekommen deine Kund:innen einen Zugangslink plus Pin per E-Mail. Ist er an, bekommen sie nur einen Pin, den sie direkt an der Tastatur des Schlosses eingeben. Den Pin erzeugt anny in beiden Fällen automatisch.
  </Accordion>

  <Accordion title="Was passiert bei einer Stornierung?">
    Bei Stornierung der Buchung wird der Zugang automatisch entfernt. Der Status wechselt auf "Entfernt" und Kund:innen können das Schloss nicht mehr bedienen.
  </Accordion>

  <Accordion title="Kann ich unterschiedliche Zugangszeiten pro Ressource setzen?">
    Die Zeiten **Zugang vor der Buchung** und **Zugang nach der Buchung** gelten pro Regel. Pro Ressource ist nur eine Regel möglich. Brauchst du für dieselben Komponenten unterschiedliche Zeiten, verknüpfe sie über getrennte Ressourcen mit eigenen Regeln.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Zugang bleibt im Status 'In Bearbeitung'">
    Die Komponente ist möglicherweise offline oder nicht erreichbar. Prüfe im dormakaba Adminbereich, ob die Komponente online ist und eine aktive Verbindung zur exivo Cloud hat.
  </Accordion>

  <Accordion title="Authentifizierung schlägt fehl">
    Die Zugangsdaten sind ungültig oder abgelaufen. Prüfe **ID der Anlage**, **API Schlüssel** und **API Geheimnis** in deiner exivo-App und trage sie erneut in anny ein.
  </Accordion>

  <Accordion title="Komponenten erscheinen nicht in der Auswahl">
    Stelle sicher, dass die Komponenten im dormakaba Adminbereich der korrekten Anlage zugeordnet und eingerichtet sind. Nur Komponenten der authentifizierten Anlage werden in anny angezeigt. Drahtlose Gateways erscheinen bewusst nicht in der Auswahl.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> UI-Pfad: Menüleiste → Integrationen → exivo. Authentifizierungsfelder (offizielle Labels): **ID der Anlage**, **API Schlüssel**, **API Geheimnis**; Button **Authentifizierung überprüfen**. Die Zugangsdaten stammen aus der exivo-App (dormakaba nennt in der Doku auch das Portal customer.exivo.io). Plan-Gating: Feature INTEGRATIONS\_SMART\_LOCKS, laut Doku ab Professional (Plan-Stufe nicht aus dem Code verifizierbar). Env-Flag: EXIVO\_ACTIVE.
>
> Regeltypen: **Zugang durch Buchungen** (mit Ressource, Komponenten, **Zugang vor der Buchung**, **Zugang nach der Buchung**, **Zugang über Keypad verwenden**) und **Zugang durch Communities** (mit Community, Komponenten, Keypad-Schalter; keine Vor-/Nachlaufzeit). Regel-Tabellenspalten u. a.: Ressource, Komponenten, Zugang vor/nach der Buchung, **Verwendet Tastatur-Pin**. Die Schloss-Auswahl heißt bei exivo **Komponenten** / **Komponenten auswählen** (nicht „Schlösser", nicht „Zylinder"). Gateways (wireless-gateway) werden aus der Auswahl gefiltert.
>
> Zugangsformat: Keypad aus → Link + Pin per E-Mail (Kund:in wird als Besucher:in mit E-Mail angelegt); Keypad an → nur Pin für die Tastatur. Pin wird von anny automatisch generiert (4- bis 6-stellig), nicht konfigurierbar.
>
> Timing: Einzelbuchungen erhalten den Zugang sofort. Serien-/wiederkehrende Buchungen werden vorgemerkt (Status **Geplant**) und \~48 h vor dem Termin erstellt. Nur bestätigte Buchungen; angefragte/abgelehnte/stornierte Buchungen und interne Blocker erhalten keinen Zugang. Eine Regel pro Ressource (Speichern einer zweiten Regel für dieselbe Ressource wird blockiert). Regeln wirken auch für Unterressourcen. Community-Zugänge ohne Enddatum erhalten intern ein \~3-Jahres-Fenster.
>
> Statuswerte für exivo: In Bearbeitung, Erfolgreich, Geplant, Fehlgeschlagen, Nicht autorisiert, Entfernt. „Unbestätigt" und „Aufräumen" werden bei exivo nicht verwendet (exivo setzt Erfolg synchron, kein zweistufiger Verify-Schritt; abgelaufene Zugänge räumt exivo selbst ab). Zugangsdetail-Aktionen: **Zugang beim Anbieter anzeigen** (öffnet customer.exivo.io/visitors), **Integrationseinstellungen**, **Zugangs-URL kopieren**, **Zugänge neu erstellen**. Kein Remote Open (im Regel-Editor erscheint für exivo kein Fernöffnung-Schalter).
>
> Abgrenzung: exivo ist eine von drei dormakaba-Integrationen mit eigenem Integration-Key (`exivo`). Nicht verwechseln mit exos-9300 (`kabaExos9300`, „Profile", optionale Mobilnummer/SMS) und resivo (`resivo`, „Sites"/Autorisierungen, Tastatur-Pin). Alle drei teilen sich den Zugangskontroll-Unterbau in anny, unterscheiden sich aber in Authentifizierung und Zustellung.
>
> Verbindung trennen: Menüleiste → Integrationen → exivo → Toggle (deaktivieren, bestehende Zugänge bleiben) oder drei Punkte → Löschen (setzt in anny alles zurück).


# dormakaba Exos 9300 mit anny verbinden
Source: https://docs.anny.co/dormakaba-exos-9300

Automatisiere zeitlich begrenzte Zutritte zu deinen dormakaba Exos 9300-Türen bei Buchungen und Community-Mitgliedschaften.

[dormakaba Exos 9300](https://www.dormakaba.com/de-de/angebot/produkte/systemloesungen-zutritt-und-zeit/zutrittskontrollloesungen-fuer-grossunternehmen/kaba-exos-9300-basissystem--ka_500000) ist eine Zutrittskontrolllösung für Großunternehmen und komplexe Gebäude. Mit der Integration kann anny bei Buchungen und Community-Mitgliedschaften automatisch zeitlich begrenzte Zugänge zu Exos-Schlössern vergeben.

Mit dormakaba Exos 9300 kannst du in anny:

* Buchungsbasierte Zugänge mit Zeitpuffer vor und nach der Buchung automatisch erstellen
* Community-Mitgliedern dauerhafte Zugänge zu bestimmten Schlössern zuweisen
* Zugangsstatus und Pin-Codes direkt in der Buchungsdetailansicht einsehen

Die Integration eignet sich vor allem für Betreiber:innen großer Gebäude oder Campus-Umgebungen, die ihre Zutrittskontrolle über dormakaba Exos 9300 steuern und Buchungen über anny automatisieren möchten.

<Info>
  Verfügbar ab Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Konferenzräume im Gebäudekomplex | **Kund:innen erhalten nach der Buchung automatisch einen zeitlich begrenzten Zugangslink plus Pin.** Empfang und Facility-Team müssen keine Schlüssel oder Karten mehr manuell ausgeben. |
| Community-Zugang für Mietparteien | **Mitglieder einer Community erhalten dauerhaften Zugang zu definierten Türen.** Berechtigungen werden zentral über anny gesteuert, ohne einzelne Zugänge im Exos-System anzulegen. |
| Veranstaltungsräume mit Tagesbuchung | **Tagesgäste bekommen nur für die gebuchte Dauer Zutritt.** Der Zugang wird nach Ablauf automatisch entfernt. |

## Wie die Exos 9300-Verbindung funktioniert

Die Integration nutzt die dormakaba Exos 9300 API. Du authentifizierst dich mit einer API-URL, einem Benutzernamen und einem Passwort, die du von deinem dormakaba Ansprechpartner erhältst. Damit autorisierst du anny, Zugänge (Zutrittsrechte mit Zeitfenster und Pin) für die Schlösser deiner Anlage zu erstellen und zu entfernen.

Wenn die Zugangsdaten auf der dormakaba-Seite geändert oder widerrufen werden, verliert anny den Zugriff. Du musst die Integration in anny dann mit den neuen Credentials erneut authentifizieren.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Zugänge (erstellen/entfernen) | anny → Exos 9300 | Echtzeit bei Buchung/Stornierung |
| Profile (Liste) | Exos 9300 → anny | Bei Regelkonfiguration |

## dormakaba Exos 9300 verbinden

### Voraussetzungen

Bevor du dormakaba Exos 9300 verbindest, stelle sicher, dass du Folgendes hast:

* API-URL, Benutzername und Passwort von deinem dormakaba Ansprechpartner oder Admin
* Mindestens ein Schloss, das im dormakaba Adminbereich eingerichtet und online ist
* anny Professional-Plan oder höher

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Exos 9300**. Füge die **API URL**, den **Benutzernamen** und das **Passwort** ein. Klicke auf **Authentifizierung überprüfen**, um den Vorgang abzuschließen.
  </Step>

  <Step title="Konfigurieren">
    Erstelle Regeln für buchungsbasierte oder Community-basierte Zugänge:

    1. Klicke auf **Hinzufügen**, um eine neue Regel zu erstellen
    2. Wähle eine **Ressource** (für Buchungszugänge) oder eine **Community** (für Mitgliederzugänge)
    3. Wähle über **Profile auswählen** die zugehörigen Profile aus
    4. Lege bei Buchungszugängen **Zugang vor der Buchung** und **Zugang nach der Buchung** fest (jeweils in Minuten)
    5. Aktiviere optional **Handynummer und E-Mail übermitteln**, damit Kund:innen mobilen Zutritt per Smartphone statt per Pin erhalten
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, werden Zugänge automatisch bei neuen Buchungen erstellt und bei Stornierungen entfernt.

<Tip>
  Bestehende Regeln kannst du über die **drei Punkte** rechts neben der Regel bearbeiten oder löschen.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Zugang vor der Buchung | Minuten, die der Zugang vor Buchungsbeginn aktiv ist |
| Zugang nach der Buchung | Minuten, die der Zugang nach Buchungsende aktiv bleibt |
| Profile | Ein oder mehrere Exos-Profile pro Regel |
| Handynummer und E-Mail übermitteln | Optional: Ist dieser Schalter aktiv, übermittelt anny Handynummer und E-Mail der gebuchten Person an Exos 9300, damit sie mobilen Zutritt per Smartphone erhält. In diesem Fall wird kein Pin ausgegeben |

### Aktivierungsverlauf

In den Integrationseinstellungen kannst du den **Aktivierungsverlauf** einsehen. Dort werden alle erstellten und entfernten Zugänge chronologisch aufgelistet.

## Buchungsprozess für Kund:innen

So erleben deine Kund:innen die Integration:

<Steps>
  <Step title="Raum buchen">
    Kund:innen buchen eine Ressource über anny.
  </Step>

  <Step title="Zugangslink erhalten">
    anny generiert automatisch einen individuellen Zugangslink plus Pin und versendet beides in der Buchungsbestätigung per E-Mail.
  </Step>

  <Step title="Schloss öffnen">
    Kund:innen öffnen den **Link aus der E-Mail**, geben den **Pin** ein und klicken auf **Login**. Dort werden die Zugänge angezeigt, die zur gebuchten Ressource gehören.
  </Step>
</Steps>

## Zugänge im Adminbereich einsehen

In der **Buchungsdetailansicht** werden aktive und inaktive Zugänge angezeigt. Klicke auf einen Zugang, um Details einzusehen:

| Status | Bedeutung |
| - | - |
| Geplant | Der Zugang ist vorgemerkt und wird kurz vor dem Termin erstellt. Diesen Status siehst du bei zukünftigen Terminen und bei Serienbuchungen |
| In Bearbeitung | Der Zugang wird gerade eingerichtet. Bei Einzelbuchungen ist das nur ein kurzer Moment |
| Erfolgreich | Der Zugang ist aktiv und Kund:innen können das Schloss im definierten Zeitraum bedienen |
| Entfernt | Der Zugang wurde vom System oder einem Admin entfernt |

<Tip>
  Über die **drei Punkte** in der Zugangsdetailansicht kannst du zu den **Integrationseinstellungen** in anny navigieren.
</Tip>

## Einschränkungen

Die dormakaba Exos 9300-Integration unterstützt nicht:

* Remote Open (Türöffnung per Knopfdruck aus anny heraus): Kund:innen nutzen stattdessen den Zugangslink plus Pin
* Gebündelte Zugänge pro Bestellung: anny fasst mehrere Buchungen einer Bestellung nicht zu einem Zugang zusammen, sondern legt Zugänge je Buchung an
* Selbstständige Credential-Generierung: API-Zugangsdaten müssen vom dormakaba-Ansprechpartner bereitgestellt werden

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</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 Hardware ist mit Exos 9300 kompatibel?">
    Alle Informationen zur unterstützten Hardware findest du auf der [dormakaba Webseite](https://www.dormakaba.com/de-de/angebot/produkte/systemloesungen-zutritt-und-zeit/zutrittskontrollloesungen-fuer-grossunternehmen/kaba-exos-9300-basissystem--ka_500000). anny kommuniziert über die Exos 9300 API, die Hardware-Kompatibilität wird von dormakaba bestimmt.
  </Accordion>

  <Accordion title="Wie viele Zugänge werden pro Buchung erstellt?">
    anny legt für jedes in der Regel ausgewählte Profil einen eigenen Zugang an. Buchen Kund:innen mehrere Räume in einer Bestellung, erhält jede Buchung ihre eigenen Zugänge. Eine ganze Bestellung wird nicht zu einem einzelnen Zugang zusammengefasst.
  </Accordion>

  <Accordion title="Was passiert bei einer Stornierung?">
    Bei Stornierung der Buchung wird der Zugang automatisch entfernt. Der Status wechselt auf "Entfernt" und Kund:innen können das Schloss nicht mehr bedienen.
  </Accordion>

  <Accordion title="Wann bekommen Kund:innen bei Serienbuchungen ihren Zugang?">
    Bei Serien- und weit im Voraus gebuchten Terminen wird der Zugang nicht sofort erstellt, sondern etwa 48 Stunden vor dem jeweiligen Termin. Bis dahin steht er auf Status "Geplant" und es liegt noch kein Pin vor. Einzelbuchungen erhalten ihren Zugang sofort.
  </Accordion>

  <Accordion title="Können Kund:innen den Zugang über die Kaba Exos App nutzen?">
    Ja. Aktivierst du in der Regel den Schalter **Handynummer und E-Mail übermitteln**, sendet anny Handynummer und E-Mail der gebuchten Person an Exos 9300. Kund:innen erhalten dann mobilen Zutritt über die Kaba Exos App statt eines Pins.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Zugang bleibt im Status 'In Bearbeitung'">
    Das Schloss ist möglicherweise offline oder nicht erreichbar. Prüfe im dormakaba Adminbereich, ob das Schloss online ist und eine aktive Verbindung zur Exos-Infrastruktur hat.
  </Accordion>

  <Accordion title="Authentifizierung schlägt fehl">
    Die API-Zugangsdaten sind ungültig. Wende dich an deinen dormakaba Ansprechpartner, um die korrekten Werte für API-URL, Benutzername und Passwort zu erhalten.
  </Accordion>

  <Accordion title="Kein Zugang erstellt trotz erfolgreicher Buchung">
    Prüfe, ob für die gebuchte Ressource eine aktive Regel existiert. Kontrolliere außerdem im Aktivierungsverlauf, ob ein Fehler protokolliert wurde.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> UI-Pfad: Menüleiste → Integrationen → Exos 9300. Regeltypen: „Zugang durch Buchungen" (Ressource) und „Zugang durch Communities" (Community).
>
> Abgrenzung zu den anderen dormakaba-Integrationen: Exos 9300 ist die On-Premise-Variante. anny verbindet sich mit der URL des kundeneigenen Exos-Servers. Auth-Felder: **API URL** (On-Premise-Basis-URL), **Benutzername**, **Passwort** (HTTP-Basic, vom dormakaba-Ansprechpartner, kein Self-Service). Resivo und Exivo sind dagegen Cloud-Dienste (feste Cloud-Adresse). Die auswählbaren Schließeinheiten heißen bei Exos **„Profile"** (Feld „Profile auswählen"), bei Exivo/Resivo „Components"/„Sites". Terminologie nicht mischen. Alle drei teilen denselben Zutritts-Unterbau.
>
> Regel-Felder: **Profile auswählen** (mehrere möglich), **Zugang vor der Buchung** / **Zugang nach der Buchung** (Minuten), Schalter **Handynummer und E-Mail übermitteln**. Ist der Schalter aktiv, wird kein Pin ausgegeben; Handynummer und E-Mail stammen aus der Buchung (nicht aus der Regel) und der Gast erhält mobilen Zutritt per Smartphone. Der Schalter lässt sich nur speichern/aktivieren, wenn alle Services der Ressource eine Handynummer verlangen. Es gibt kein konfigurierbares Pin-Feld; der Pin kommt automatisch vom Exos-System.
>
> Verhalten: nur angenommene Buchungen mit Kund:in erhalten Zugang (keine Anfragen, keine Blocker). Pro Buchung wird je ausgewähltem Profil ein Zugang erstellt (mehrere Profile = mehrere Zugänge); eine Bestellung wird nicht gebündelt. Einzelbuchungen: sofort. Serien-/zukünftige Buchungen: geplant, Erstellung ca. 48 h vor Termin, bis dahin Status „Geplant". Zeitänderung aktualisiert den bestehenden Zugang, Ressourcenwechsel erstellt ihn neu, Stornierung entfernt ihn (am Exos-System entfernt). Eine Regel pro Ressource (Duplikat wird beim Speichern blockiert). Regeln auf einer übergeordneten Ressource greifen auch für Unterressourcen.
>
> Community: Zugang dauerhaft (kein Enddatum in anny, am Exos-System 3-Jahres-Laufzeit). Button „Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen" für nachträgliches Nachziehen.
>
> Status-Labels: Geplant, In Bearbeitung, Erfolgreich, Fehlgeschlagen, Entfernt. Buchungsdetail-Bereich heißt „Smartlock Zugänge". Es gibt keinen externen Anbieter-Link („Zugang beim Anbieter anzeigen" fehlt für Exos), nur Navigation zu den Integrationseinstellungen. Aktivierungsverlauf in den Integrationseinstellungen. Kein anny-natives Remote Open. Plan: Professional (Feature INTEGRATIONS\_SMART\_LOCKS).
>
> Verbindung trennen: Menüleiste → Integrationen → Exos 9300 → Toggle (deaktivieren, bestehende Zugänge bleiben) oder drei Punkte → Löschen (setzt in anny zurück).


# dormakaba resivo mit anny verbinden
Source: https://docs.anny.co/dormakaba-resivo

Vergib bei Buchungen und Community-Mitgliedschaften automatisch zeitlich begrenzte Zugänge zu deinen resivo-Türen.

[dormakaba Resivo](https://resivo.dormakaba.com/) ist ein cloudbasiertes Zutrittskontrollsystem, das speziell für die Verwaltung von Liegenschaften und Mietobjekten konzipiert ist. Mit der Integration kann anny bei Buchungen und Community-Mitgliedschaften automatisch zeitlich begrenzte Zugänge zu Resivo-Schlössern vergeben.

Mit dormakaba Resivo kannst du in anny:

* Buchungsbasierte Zugänge mit Vorlauf- und Nachlaufzeit automatisch erstellen
* Community-Mitgliedern dauerhafte Zugänge zu bestimmten Türen zuweisen
* Zugangsstatus und Zugangsdaten direkt in der Buchungsdetailansicht einsehen

Besonders praktisch ist die Integration, wenn du Liegenschaften oder Gemeinschaftsräume mit dormakaba Resivo absicherst und den Zugang für Buchungen oder Mieter:innen automatisieren möchtest.

<Info>
  Verfügbar ab Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Gemeinschaftsräume in Liegenschaften | **Mieter:innen erhalten nach der Buchung automatisch einen zeitlich begrenzten Zugang per Pincode oder resivo-App.** Die Hausverwaltung muss keine Schlüssel oder Karten ausgeben. |
| Community-Zugang für Mietparteien | **Mitglieder einer Community erhalten dauerhaften Zugang zu definierten Türen.** So steuerst du Berechtigungen zentral über anny, z. B. für Waschküchen, Fitnessräume oder Paketboxen. |
| Gebäudezugang für externe Dienstleister | **Externe erhalten nur für die gebuchte Dauer Zutritt.** Der Zugang wird nach Ablauf automatisch entfernt, ohne dass die Hausverwaltung eingreifen muss. |

## Wie die Resivo-Verbindung funktioniert

Die Integration nutzt die dormakaba resivo API. Du authentifizierst dich mit der **ID des Eigentümers der Liegenschaft**, einer **Client ID** und einem **Client Geheimnis**, die du in den resivo-API-Einstellungen generierst. Damit autorisierst du anny, Zugänge (Zutrittsrechte mit Zeitfenster) für die Türen deiner Liegenschaft zu erstellen und zu entfernen. Je nach **Zugangsart** ist das ein Pincode für ein Keypad, eine Einladung in die resivo-App oder der persönliche Badge der buchenden Person. Zusätzlich kannst du **Fernöffnung** aktivieren.

Wenn die Zugangsdaten in den resivo-API-Einstellungen widerrufen oder neue Credentials generiert werden, verliert anny den Zugriff. Du musst die Integration in anny dann mit den neuen Credentials erneut authentifizieren.

<Warning>
  Das **Client Geheimnis** ist nur einmalig bei Erstellung sichtbar. Speichere es sofort sicher ab.
</Warning>

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Zugänge (erstellen/entfernen) | anny → resivo | Echtzeit bei Buchung, Serien rund 48 Stunden vorab |
| Türen (Liste) | resivo → anny | Bei Regelkonfiguration |

## dormakaba Resivo verbinden

### Voraussetzungen

Bevor du dormakaba Resivo verbindest, stelle sicher, dass du Folgendes hast:

* Einen aktiven dormakaba resivo Account mit Eigentümer-Rechten
* API-Credentials aus den resivo-API-Einstellungen (ID des Eigentümers der Liegenschaft, Client ID, Client Geheimnis)
* Mindestens eine Tür, die im resivo-Adminbereich eingerichtet und online ist
* anny Professional-Plan oder höher

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Resivo**. Füge die **ID des Eigentümers der Liegenschaft**, die **Client ID** und das **Client Geheimnis** aus den resivo-API-Einstellungen ein. Klicke auf **Authentifizierung überprüfen**.
  </Step>

  <Step title="Liegenschaft wählen">
    Wähle unter **Aktive Liegenschaft** die Liegenschaft aus, die du über anny steuern möchtest, und klicke auf **Liegenschaft speichern**. Erst danach erscheinen die Regel-Bereiche. Über **Liegenschaft zurücksetzen** kannst du die Auswahl später ändern, wobei alle bestehenden Regeln entfernt werden.
  </Step>

  <Step title="Konfigurieren">
    Erstelle Regeln unter **Zugang durch Buchungen** oder **Zugang durch Communities**:

    1. Klicke auf **Hinzufügen**, um eine neue Regel zu erstellen
    2. Wähle eine **Ressource** (für Buchungszugänge) oder eine **Community** (für Mitgliederzugänge)
    3. Wähle unter **Türen auswählen** eine oder mehrere Türen aus
    4. Lege bei Buchungszugängen **Zugang vor der Buchung** und **Zugang nach der Buchung** fest (in Minuten)
    5. Wähle die **Zugangsart**: **E-Mail-Link** (Einladung in die resivo-App), **PIN-Code** oder **Persönlicher Badge**. Bei **Persönlicher Badge** legst du zusätzlich eine **Fallback-Zugangsart** fest (PIN-Code oder E-Mail-Link), falls die Person im Schließsystem nicht eindeutig zugeordnet werden kann
    6. Aktiviere bei Bedarf **Fernöffnung verwenden**, damit Kund:innen das Schloss per Knopfdruck aus anny öffnen können
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, werden Zugänge automatisch bei neuen Buchungen erstellt und bei Stornierungen entfernt.

<Tip>
  Bestehende Regeln kannst du über die **drei Punkte** rechts neben der Regel bearbeiten oder löschen.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Zugang vor der Buchung | Minuten, die der Zugang vor Buchungsbeginn aktiv ist |
| Zugang nach der Buchung | Minuten, die der Zugang nach Buchungsende aktiv bleibt |
| Zugangsart | **E-Mail-Link** (Standard): Einladung in die resivo-App. **PIN-Code**: anny erzeugt automatisch einen 6-stelligen Pincode. **Persönlicher Badge**: Kund:innen nutzen ihren hinterlegten Badge an der Tür |
| Fallback-Zugangsart | Nur bei **Persönlicher Badge**. PIN-Code oder E-Mail-Link, wenn die buchende Person im Schließsystem nicht eindeutig zugeordnet werden kann |
| Fernöffnung verwenden | Aktiv: Kund:innen öffnen das Schloss per Knopfdruck aus ihrem anny-Konto. Unabhängig von der Zugangsart, Standard aus |
| Türen | Eine oder mehrere resivo-Türen pro Regel |

## Buchungsprozess für Kund:innen

So erleben deine Kund:innen die Integration:

<Steps>
  <Step title="Raum buchen">
    Kund:innen buchen eine Ressource über anny.
  </Step>

  <Step title="Zugang erhalten">
    anny erstellt automatisch den Zugang und teilt ihn in der Buchungsbestätigung per E-Mail mit. Je nach Regel ist das ein **Pincode**, eine **Einladung in die resivo-App**, der Hinweis auf den **persönlichen Badge** oder zusätzlich ein Button zur **Fernöffnung**.
  </Step>

  <Step title="Tür öffnen">
    Im Bereich **Schlüsselloser Zugang** sehen Kund:innen ihre Zugänge für die gebuchte Ressource. Sie geben den **Pincode** am Keypad ein, öffnen die Tür über die **resivo-App**, nutzen den **persönlichen Badge** oder drücken bei aktiver Fernöffnung den Öffnen-Button in anny.
  </Step>
</Steps>

## Zugänge im Adminbereich einsehen

In der **Buchungsdetailansicht** werden aktive und inaktive Zugänge angezeigt. Klicke auf einen Zugang, um Details einzusehen:

| Status | Bedeutung |
| - | - |
| Geplant | Der Zugang für eine Serien- oder Zukunftsbuchung wird erst rund 48 Stunden vor Beginn erstellt |
| In Bearbeitung | Der Zugang wurde von anny angefordert, aber noch nicht vom Schließsystem vergeben |
| Erfolgreich | Der Zugang ist aktiv und Kund:innen können die Tür im definierten Zeitraum bedienen |
| Fehlgeschlagen | Der Zugang konnte nicht erstellt werden, etwa weil die Tür nicht erreichbar war |
| Entfernt | Der Zugang wurde vom System oder einem Admin entfernt |

<Tip>
  Über die **drei Punkte** in der Zugangsdetailansicht kannst du den Zugang direkt im resivo-Adminbereich öffnen oder zu den Integrationseinstellungen in anny navigieren.
</Tip>

## Einschränkungen

Die dormakaba resivo-Integration unterstützt nicht:

* Mehrere Liegenschaften pro Integration: Pro Integration kann nur eine Liegenschaft verbunden werden
* Automatische Credential-Rotation: Bei neuen API-Credentials muss die Integration manuell neu authentifiziert werden

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</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 Hardware ist mit Resivo kompatibel?">
    Alle Informationen zur unterstützten Hardware findest du auf der [dormakaba Resivo Webseite](https://resivo.dormakaba.com/). anny kommuniziert über die Resivo Cloud-API, die Hardware-Kompatibilität wird von dormakaba bestimmt.
  </Accordion>

  <Accordion title="Können Kund:innen mehrere Türen mit einer Buchung öffnen?">
    Ja. Du kannst pro Regel mehrere Türen zuweisen. Alle zugewiesenen Türen erscheinen im Bereich **Schlüsselloser Zugang**.
  </Accordion>

  <Accordion title="Was passiert bei einer Stornierung?">
    Bei Stornierung der Buchung wird der Zugang automatisch entfernt. Der Status wechselt auf "Entfernt" und Kund:innen können die Tür nicht mehr bedienen.
  </Accordion>

  <Accordion title="Erhalten meine Kund:innen den Zugang sofort?">
    Bei Einzelbuchungen wird der Zugang sofort erstellt. Bei Serien- und weit im Voraus gebuchten Terminen erstellt anny den Zugang erst rund 48 Stunden vor Beginn. Bis dahin steht er auf "Geplant", und Pincode, App-Einladung, Badge-Zugang oder Fernöffnung folgen kurz vor dem Termin.
  </Accordion>

  <Accordion title="Mein Client Geheimnis ist verloren gegangen. Was tun?">
    Das Client Geheimnis ist nur einmalig sichtbar. Generiere in den resivo-API-Einstellungen neue Credentials und authentifiziere die Integration in anny erneut.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Zugang bleibt in Bearbeitung oder wird 'Fehlgeschlagen'">
    Die Tür ist möglicherweise offline oder nicht erreichbar. Prüfe im resivo-Adminbereich, ob die Tür online ist und eine aktive Verbindung zur resivo-Cloud hat.
  </Accordion>

  <Accordion title="Authentifizierung schlägt fehl">
    Die API-Credentials sind ungültig oder das Client Geheimnis wurde falsch kopiert. Generiere in den resivo-API-Einstellungen neue Credentials und trage sie erneut in anny ein. Achte darauf, das Client Geheimnis sofort nach Erstellung zu sichern.
  </Accordion>

  <Accordion title="Türen erscheinen nicht in der Auswahl">
    Stelle sicher, dass die Türen im resivo-Adminbereich der korrekten Liegenschaft zugeordnet und eingerichtet sind. Nur Türen, die der authentifizierten Liegenschaft gehören, werden in anny angezeigt.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> UI-Pfad: Menüleiste → Integrationen → Resivo. Feature-Gating: INTEGRATIONS\_SMART\_LOCKS (laut Doku ab Professional-Plan, DB-seitig, nicht aus Code verifizierbar).
>
> Auth: ID des Eigentümers der Liegenschaft + Client ID + Client Geheimnis (aus den resivo-API-Einstellungen; Maschinen-Token gegen api.resivo.io; Client Geheimnis nur einmalig sichtbar). NICHT customer.exivo.io, das ist die Exivo-Integration. Button: „Authentifizierung überprüfen". Zugangsdaten nur bei deaktivierter Integration änderbar; schlägt die Prüfung fehl, werden die eingegebenen Secrets verworfen.
>
> Pflicht-Setup nach Auth: „Aktive Liegenschaft" wählen und speichern („Liegenschaft speichern"). Erst danach erscheinen die Regel-Bereiche. „Liegenschaft zurücksetzen" entfernt alle Regeln.
>
> Zwei Regel-Typen: „Zugang durch Buchungen" (Ressource) und „Zugang durch Communities" (Community). Feld „Türen auswählen" (Konzept „Türen", nicht Schlösser/Zylinder), mehrere Türen pro Regel. Nur „Zugang vor der Buchung"/„Zugang nach der Buchung" bei Buchungsregeln (Minuten). Community-Zugänge dauerhaft (kein Enddatum). Eine Regel pro Ressource (Doppelbelegung wird beim Speichern blockiert). Regel auf Oberressource greift auch für Unterressourcen.
>
> Zugangsart pro Regel über Dropdown **Zugangsart** (`access_mode`, Default `remote` = **E-Mail-Link** / resivo-App). Weitere Werte: `pin` = **PIN-Code** (6-stellig), `badge` = **Persönlicher Badge**. Bei Badge erscheint **Fallback-Zugangsart** (`fallback_mode`, PIN oder E-Mail-Link). Tabellenspalte **Zugangsart**. Legacy-Regeln ohne `access_mode` nutzen weiter `use_keypad`. Toggle **Fernöffnung verwenden** (`remote_open`, Default aus, unabhängig von der Zugangsart; Spalte **Fernöffnung**). Shop-Button Badge: **Nutze deinen persönlichen Badge an der Tür**. Admin-Grant: **Persönlicher Badge von&#x20;**. Kundenbereich: **Schlüsselloser Zugang**.
>
> Timing: Einzelbuchungen sofort; Serien-/Zukunftsbuchungen rund 48 h vor Beginn (Status „Geplant", Kund:innen-Hinweis „Zugang geplant, Erstellung nach "). Statuslabels: Geplant, In Bearbeitung, Erfolgreich, Fehlgeschlagen, Entfernt. Nur bestätigte Buchungen; Blocker, angefragte, abgelehnte und stornierte Buchungen erhalten keinen Zugang. Stornierung widerruft den Zugang bei resivo.
>
> Verbindung trennen: Menüleiste → Integrationen → Resivo → Toggle (deaktivieren, behält bestehende Zugänge) oder drei Punkte → Löschen. Achtung: Beim Löschen entfernt anny nur die eigenen Zugangs-Datensätze und ruft resivo NICHT zum Widerruf auf; bereits erstellte Pins/App-Zugänge können bis zu ihrem Enddatum aktiv bleiben.
>
> Abgrenzung: Resivo, Exos 9300 und Exivo teilen denselben anny-Zutritts-Unterbau (Regel-Typen, Status, 48-h-Planung, eine Regel pro Ressource). Resivo-spezifisch: Auth mit ID des Eigentümers/Client ID/Client Geheimnis, Pflicht-Liegenschaftswahl, „Türen", Keypad-Pin vs. resivo-App, Deeplink portal.resivo.io. Exivo nutzt customer.exivo.io; Exos 9300 hat eine Handynummer-Pflicht pro Regel.


# Einführung Arbeitsplatz- & Meetingraumbuchung
Source: https://docs.anny.co/einfuehrung-arbeitsplatz-and-meetingraumbuchung

Plane deine Arbeitswoche mit anny: Arbeitsplatz buchen, Meetingräume reservieren und dein Team finden.

Mit anny buchst du Arbeitsplätze und Meetingräume in wenigen Klicks. Nutze den Wochenplaner, die Kartenansicht oder die anny Apps, um deine Arbeitswoche effizient zu organisieren.

<Tip>
  Wenn dein Unternehmen SSO aktiviert hat, melde dich wie gewohnt mit deinem Unternehmens-Login an. Alternativ kannst du ein Nutzerprofil mit eigenem Passwort erstellen (siehe [Nutzerprofil & Einstellungen](/user-profile-settings)).
</Tip>

## Die Buchungsseite im Überblick

Deine Buchungsseite besteht aus vier Bereichen:

* **Home:** Tagesübersicht mit aktuellen Buchungen, Kolleg:innen in deiner Nähe und favorisierten Ressourcen
* **Entdecken:** Alle verfügbaren Arbeitsplätze und Meetingräume mit Filter nach Datum, Zeit und Eigenschaften
* **Planer:** Wochenplaner mit deinen Favoriten in der Listen- und Kartenansicht
* **Buchungen:** Übersicht aller Reservierungen mit Check-In, Stornierung und Bearbeitung

## Woche planen im Wochenplaner

Der Wochenplaner ist der schnellste Weg, deine Arbeitswoche zu organisieren:

<Steps>
  <Step title="Ressourcen favorisieren">
    Gehe zu **Entdecken** und markiere deine Lieblingsarbeitsplätze und Meetingräume als Favoriten.
  </Step>

  <Step title="Planer öffnen">
    Wechsle zum **Planer**. Dort siehst du deine favorisierten Ressourcen in der Wochenübersicht.
  </Step>

  <Step title="Slots buchen">
    Tippe auf freie Zeitslots, um direkt zu buchen. In wenigen Klicks ist deine gesamte Woche geplant.
  </Step>
</Steps>

## Buchen über die Kartenansicht

In der Kartenansicht siehst du die Räumlichkeiten deiner Organisation als interaktiven 3D-Lageplan:

* **Grün** markierte Ressourcen sind verfügbar und direkt buchbar
* Tippe einen Platz an und klicke auf **Jetzt buchen**
* Bestätige deine Buchung in der Übersicht mit **Abschließen**

## Team finden (Mitarbeitersuche)

Du möchtest wissen, wo deine Kolleg:innen sitzen? Nutze die Mitarbeitersuche im Planer, um zu sehen, wer heute im Büro ist und wo sie gebucht haben. So kannst du gezielt in der Nähe deines Teams buchen.

## Team einladen (Buchungseinladungen)

Mit Buchungseinladungen lädst du Kolleg:innen ein, gemeinsam im Büro zu arbeiten:

<Steps>
  <Step title="Papierflieger antippen">
    Öffne den Wochenplaner und tippe auf das **Papierflieger-Symbol** neben einem Tag.
  </Step>

  <Step title="Kolleg:innen auswählen">
    Wähle die Personen aus, die du einladen möchtest.
  </Step>

  <Step title="Plätze vorschlagen">
    Optional: Schlage passende Arbeitsplätze für deine Kolleg:innen vor.
  </Step>
</Steps>

Eingeladene Personen erhalten eine E-Mail und können die Einladung annehmen oder ablehnen.

## Buchen über die Apps

Neben dem Browser stehen dir weitere Buchungskanäle zur Verfügung:

| App | Beschreibung |
| - | - |
| anny Mobile App | Buche unterwegs über dein Smartphone. Verfügbar im [App Store](https://apps.apple.com/us/app/anny/id6448261664) und [Play Store](https://play.google.com/store/apps/details?id=co.anny.app). |
| anny MS Teams App | Füge die anny App in Teams hinzu und pinne sie in deiner Seitenleiste. Buche direkt aus Teams heraus (siehe unten). |
| Outlook Add-In | Erstelle einen neuen Termin in Outlook, öffne das anny Add-In und wähle einen verfügbaren Raum. Der Raum wird automatisch als Standort hinzugefügt. |

### Buchen über Microsoft Teams

Wenn dein Organisationsadmin die anny MS Teams App freigegeben hat, kannst du sie direkt in Teams hinzufügen und deine Buchungsseite nutzen, ohne Teams zu verlassen:

Die anny MS Teams App funktioniert wie die Web-Buchungsseite: Alle Funktionen (Favoriten, Planer, Kartenansicht, Check-In) stehen dir direkt in Teams zur Verfügung.

## Connected Persons: Für andere buchen

Mit Connected Persons buchst du im Namen von Kolleg:innen. Das ist besonders praktisch für Assistenzrollen oder wenn jemand im Urlaub ist. Mehr dazu im Artikel [Connected Persons](/connected-persons).

## Buchungen verwalten

Unter **Buchungen** siehst du alle deine Reservierungen. Je nach Einstellung deines Unternehmens kannst du:

* Buchungen einchecken
* Buchungen stornieren
* Buchungen bearbeiten (Arbeitsplatz wechseln, Zeit anpassen, Zusatzoptionen ändern)

<AccordionGroup>
  <Accordion title="Meine Kolleg:innen tauchen nicht in der Mitarbeitersuche auf">
    Stelle sicher, dass die gesuchte Person nicht im Inkognito-Modus ist. Nur sichtbare Community-Mitglieder werden in der Suche angezeigt.
  </Accordion>

  <Accordion title="Ich sehe keine Favoriten im Planer">
    Du musst zuerst unter **Entdecken** Ressourcen als Favoriten markieren. Diese erscheinen dann automatisch im Wochenplaner.
  </Accordion>

  <Accordion title="Die Buchungseinladung kommt nicht an">
    Prüfe, ob die eingeladene Person in derselben Community ist. Die Einladung wird per E-Mail versendet. Gegebenenfalls den Spam-Ordner prüfen.
  </Accordion>

  <Accordion title="Mein Outlook-Termin synchronisiert sich nicht">
    Stelle sicher, dass du den Raum über das anny Add-In ausgewählt hast (nicht über die Outlook-Raumsuche). Wenn du den Termin verschiebst, ändert sich die Buchung in Echtzeit mit.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Zielgruppe: Mitarbeitende in Unternehmen mit Hybrid-Work-Setup
> * Login: SSO (falls vom Unternehmen konfiguriert) oder eigenes Passwort
> * Wochenplaner URL: [https://anny.co/planner](https://anny.co/planner)
> * Mitarbeitersuche: nur sichtbare (nicht-inkognito) Community-Mitglieder
> * Buchungseinladungen: Papierflieger-Symbol im Planer, Empfänger erhält E-Mail + App-Push
> * Outlook Add-In: Raum wird als Standort im Termin gespeichert, Verschieben = Live-Update der Buchung
> * MS Teams App: separat aus dem Teams App Store installieren, kann vom IT-Admin zentral deployed werden
> * Connected Persons: funktioniert unabhängig von Communities, Kontingente werden für die gebuchte Person abgezogen
> * Profil-Einstellungen: eigener Artikel /user-profile-settings


# EVVA AirKey mit anny verbinden
Source: https://docs.anny.co/evva-airkey

Erstelle pro Buchung automatisch einen App-Zugang für EVVA-gesicherte Türen, zeitlich begrenzt und ohne Schlüsselübergabe.

[EVVA AirKey](https://www.evva.com/de-de/produkte/elektronische-schliesssysteme-zutrittskontrolle/airkey/) ist ein elektronisches Schließsystem, das Türen per Smartphone-App steuert. Mit der Integration erstellt anny pro Buchung automatisch einen zeitlich begrenzten App-Zugang für die passende EVVA-gesicherte Tür.

Mit EVVA AirKey kannst du in anny:

* Pro Buchung automatisch einen zeitlich begrenzten App-Zugang für EVVA-gesicherte Bereiche erstellen
* anny-Ressourcen über Regeln mit einem oder mehreren EVVA-Schlössern verknüpfen
* Kund:innen ohne Registrierung oder Schlüsselübergabe Zutritt gewähren

Besonders praktisch ist die Integration, wenn du EVVA-gesicherte Räume über anny buchbar machst und den Zugang vollständig automatisieren möchtest, ohne manuelle Freigabe oder Schlüsselkoordination.

<Info>
  Verfügbar ab dem Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Meetingräume automatisch freischalten | **Zugang genau zum gebuchten Zeitpunkt.** Wird ein Meetingraum gebucht, erhält die buchende Person kurz vor Beginn per E-Mail den Link zur EVVA-App. Der Raum lässt sich dann im gebuchten Zeitfenster öffnen. |
| Coworking- und Studioflächen | **Schlüsselloser Zutritt ohne Rezeption.** Kund:innen betreten gebuchte Flächen eigenständig per App, ohne dass das Team manuell freigeben muss. |
| Buchungen mit wechselnden Nutzer:innen | **Automatische Zuordnung über Handynummer.** Jede buchende Person bekommt ihren eigenen Zugang, zeitlich passend erstellt und nach Ende wieder entfernt. |

## Wie die EVVA AirKey-Verbindung funktioniert

Die Verbindung wird über einen API-Key hergestellt. Du erstellst den Key im EVVA-Adminbereich und hinterlegst ihn in anny. Damit authentifiziert sich anny bei deinem EVVA AirKey Cloud-Zugang und darf dort Zugänge anlegen und entfernen.

Sobald eine Ressource mit passender Regel gebucht wird, plant anny einen Zugang für genau diese Buchung ein und schreibt ihn erst etwa 30 Minuten bevor der Zugang gültig wird an das passende Schloss. Die Zuordnung zur buchenden Person erfolgt über die hinterlegte Handynummer. Beim Schreiben verschickt EVVA an neue Gäste eine E-Mail mit dem Link zur Einrichtung in der EVVA-App. Wer bereits ein aktiviertes AirKey-Medium hat, bekommt keine neue E-Mail und nutzt den bestehenden App-Zugang.

<Tip>
  Der Zugang wird bewusst erst kurz vor Zugangsbeginn beim Schloss angelegt, nicht schon beim Buchen. Das ist kein Fehler, sondern Teil der Integrationslogik. Bei weit im Voraus liegenden Terminen ist der Zugang deshalb erst kurz vorher sichtbar.
</Tip>

Wenn du den API-Key widerrufst oder änderst, verliert anny den Zugriff und kann keine neuen Zugänge erstellen. Aktualisiere in diesem Fall den Key in der Integration.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Zugänge (Erstellen, Entfernen) | anny → EVVA | Etwa 30 Minuten vor Zugangsbeginn bzw. bei Stornierung |
| Benachrichtigung (E-Mail) | EVVA → Kund:in | Beim Erstellen des Zugangs, nur für neue Gäste |

## EVVA AirKey verbinden

### Voraussetzungen

Bevor du EVVA AirKey verbindest, stelle sicher, dass du Folgendes hast:

* Einen aktiven EVVA AirKey Cloud-Zugang mit eingerichteten Schlössern und Bereichen
* Einen API-Key aus dem EVVA-Adminbereich (unter **Einstellungen** → **Allgemein** → **AirKey Cloud Interface (API)** → **Key erstellen**)
* Admin-Rechte mit Zugriff auf die **Integrationen** in anny
* Eine Buchungsoption, bei der die Handynummer im Formular abgefragt wird

### Verbindung einrichten

<Steps>
  <Step title="Integration öffnen">
    Öffne aus der **Menüleiste** die **Integrationen** und wähle **EVVA AirKey**.
  </Step>

  <Step title="Autorisieren">
    Erstelle im EVVA-Adminbereich unter **Einstellungen** → **Allgemein** → **AirKey Cloud Interface (API)** einen neuen API-Key. Kopiere den Key und füge ihn in anny im Feld **API-Key** ein. Klicke auf **Speichern**.
  </Step>

  <Step title="Konfigurieren">
    Verknüpfe über eine **Regel** eine anny-Ressource mit einem oder mehreren EVVA-**Bereichen** (Schlössern):

    1. Klicke auf **Hinzufügen**, um eine neue Regel zu erstellen.
    2. Wähle die **Ressource** aus, die bei Buchung Zugang geben soll.
    3. Wähle die zugehörigen **Bereiche** aus, zu denen Zugang gewährt wird.
    4. Lege über **Zugang vor der Buchung** und **Zugang nach der Buchung** fest, wie lange vor und nach der Buchung der Zugang gültig ist.

    Pro Ressource ist nur eine Regel möglich. Eine Regel auf einer übergeordneten Ressource greift auch für Buchungen ihrer Unterressourcen. 
  </Step>

  <Step title="Handynummer im Formular aktivieren">
    Gehe zu **Ressourceneinstellungen** → **Buchungsoption bearbeiten** → **Formular** und aktiviere **Handynummer immer abfragen**. Aktiviere dies für alle betroffenen Ressourcen, bevor du die Regel speicherst, sonst lässt sich die Regel nicht sichern. Ohne Handynummer kann kein Zugang zugeordnet werden.
  </Step>

  <Step title="Verbindung prüfen">
    Prüfe in den **Integrationen**, ob EVVA AirKey als aktiv angezeigt wird. Lege eine Testbuchung an und prüfe, ob der Zugang kurz vor Zugangsbeginn erstellt wird.
  </Step>
</Steps>

Sobald die Verbindung aktiv ist und eine Regel greift, erstellt anny bei jeder passenden Buchung automatisch kurz vor Beginn einen App-Zugang.

<Tip>
  Bestehende Regeln kannst du über die **drei Punkte** rechts neben der Regel bearbeiten oder löschen.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Zugang vor der Buchung | Minuten vor Buchungsbeginn, ab denen der Zugang aktiv ist. |
| Zugang nach der Buchung | Minuten nach Buchungsende, bis zu denen der Zugang aktiv bleibt. |
| Handynummer im Formular | Muss aktiviert sein, damit die buchende Person dem Zugang zugeordnet werden kann. |

### Zugänge im Adminbereich einsehen

In der **Buchungsdetailansicht** siehst du unter **Smartlock Zugänge** aktive und vergangene Zugänge. Für jeden Zugang siehst du:

| Information | Beschreibung |
| - | - |
| Status | **Geplant** (angelegt, wird kurz vor Einsatz erstellt), **Erfolgreich** (Zugang aktiv), **Fehlgeschlagen** (Erstellen fehlgeschlagen), **Aufräumen** (wird gelöscht) oder **Entfernt** (Zugang widerrufen). |
| Zugang beginnt am / Zugang endet am | Zeitfenster, in dem der Zugang gültig ist. |
| Türschloss | Der verknüpfte EVVA-Bereich. |
| Erstellt am | Wann der Zugang angelegt wurde. |

Über die **drei Punkte** am Zugang kannst du zu den Integrationseinstellungen navigieren.

## Einschränkungen

Die EVVA AirKey-Integration unterstützt nicht:

* PIN-Code-Zugang: Es wird ausschließlich der App-Zugang über die EVVA-App unterstützt.
* Remote Open (Fernöffnung): Es gibt keinen Button zum Öffnen aus anny heraus.
* Sofortigen Zugang nach Buchung: Der Zugang wird erst kurz vor Zugangsbeginn erstellt.
* Communities: Zugänge lassen sich nur über Buchungen vergeben, nicht über Community-Mitgliedschaften.

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Wann genau wird der Zugang erstellt?">
    Der Zugang wird geplant, sobald die Buchung feststeht, und erst etwa 30 Minuten vor Zugangsbeginn beim Schloss angelegt. Bei Serienbuchungen plant anny jeden Termin erst etwa 48 Stunden vorher ein. Das späte Anlegen ist beabsichtigt und Teil der Integrationslogik.
  </Accordion>

  <Accordion title="Wann erhalten Kund:innen die Benachrichtigung?">
    EVVA versendet die E-Mail mit dem Link zur Einrichtung des Zugangs, wenn anny den Zugang anlegt, also etwa 30 Minuten vor Zugangsbeginn. Neue Gäste bekommen den Registrierungslink, Gäste mit bereits aktiviertem AirKey-Medium nutzen ihren bestehenden App-Zugang.
  </Accordion>

  <Accordion title="Warum ist die Handynummer so wichtig?">
    Die Zuordnung des Zugangs zur buchenden Person läuft über die Handynummer. Fehlt sie oder ist sie nicht im erwarteten Format hinterlegt, kann anny den Zugang nicht zuordnen.
  </Accordion>

  <Accordion title="Brauchen Kund:innen ein EVVA-Konto?">
    Nein. Kund:innen müssen sich nicht bei EVVA registrieren. Die Einrichtung läuft über den Link in der E-Mail und die EVVA-App.
  </Accordion>

  <Accordion title="Kann ich mehrere Schlösser pro Ressource freischalten?">
    Ja. Pro Regel kannst du eine Ressource mit einem oder mehreren EVVA-Bereichen verknüpfen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Vor dem Buchungsstart ist noch kein Zugang sichtbar">
    Das ist in den meisten Fällen erwartetes Verhalten. Der Zugang wird bewusst erst etwa 30 Minuten vor Zugangsbeginn beim Schloss angelegt. Bei Serienbuchungen erscheint der Zugang für einen Termin erst etwa 48 Stunden vorher. Warte bis kurz vor dem Buchungszeitpunkt und prüfe dann erneut.
  </Accordion>

  <Accordion title="Kund:in erhält keinen nutzbaren Zugang">
    Prüfe zuerst, ob die Ressource korrekt einem EVVA-Bereich zugeordnet ist. Kontrolliere dann, ob für die buchende Person eine gültige Handynummer hinterlegt ist. Ohne beides kann anny den Zugang nicht erstellen.
  </Accordion>

  <Accordion title="Kund:in sucht nach einem PIN-Code">
    EVVA AirKey unterstützt ausschließlich App-Zugang. Ein fehlender PIN ist kein Fehler, sondern Teil des vorgesehenen Flows. Weise Kund:innen auf die EVVA-App hin.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> UI-Pfad Einrichten: Menüleiste → Integrationen → EVVA AirKey → API-Key eintragen → Speichern. Regel-Editor: Regel „Zugang durch Buchungen" → Hinzufügen. Felder: Ressource, Bereiche auswählen, Zugang vor der Buchung, Zugang nach der Buchung. Regel-Spalten: Ressource, Schlösser, Zugang vor der Buchung, Zugang nach der Buchung. Verbindung trennen: Integrationen → EVVA AirKey → Toggle oben rechts deaktivieren → drei Punkte → Löschen.
>
> Authentifizierung: API-Key (nicht OAuth). Key in EVVA unter Einstellungen → Allgemein → AirKey Cloud Interface (API) → Key erstellen.
>
> Zugangserstellung: Just in time. Zugang wird bei Buchung als „Geplant" angelegt und erst ca. 30 Minuten vor Zugangsbeginn (= Buchungsbeginn minus „Zugang vor der Buchung") beim Anbieter geschrieben. Der oft genannte Grund „pro Schloss nur 1 Zugang gleichzeitig" ist nicht bestätigt; mehrere Berechtigungen pro Bereich können koexistieren.
>
> Serien-/wiederkehrende Buchungen: jeder Termin wird erst ca. 48 h vor Zugangsbeginn eingeplant; vorher kein Zugangsdatensatz sichtbar. Einzelbuchungen: Datensatz sofort (Status „Geplant").
>
> Benachrichtigung: EVVA „Send a Key" per E-Mail beim Schreiben des Zugangs. Nur für neue/nicht aktivierte Handynummern; Gäste mit aktiviertem AirKey-Medium bekommen keine neue E-Mail. SMS aus anny-Code nicht belegt.
>
> Zuordnung: Person → Handynummer → Zugang. Ohne Handynummer kein Zugang. „Handynummer immer abfragen" wird beim Speichern erzwungen: fehlt sie an einem Service einer verregelten Ressource, schlägt das Speichern fehl.
>
> Kein PIN-Code, kein Remote Open, keine Community-Regeln. Nur App-Zugang über Buchungen.
>
> Nur akzeptierte Buchungen erhalten Zugang (keine Anfragen/Blocker). Storno/Ablehnung → entfernt; Zeitänderung → Zeitraum aktualisiert; Ressourcenwechsel → neu erstellt; Blocker↔Buchung → erstellt/entfernt.
>
> Eine Regel pro Ressource (Speichern sonst blockiert). Regel auf übergeordneter Ressource greift auch für Unterressourcen. Mehrere Bereiche pro Regel möglich.
>
> Buchungsdetail-Bereich „Smartlock Zugänge". Felder: Status, Zugang beginnt am, Zugang endet am, Türschloss, Erstellt am. Zugangsstatus: Geplant | Erfolgreich | Fehlgeschlagen | Aufräumen | Entfernt (auch möglich: In Bearbeitung, Unbestätigt, Nicht autorisiert). Kein Anbieter-Deep-Link am Zugang, nur Sprung zu den Integrationseinstellungen.
>
> Feature INTEGRATIONS\_SMART\_LOCKS, verfügbar ab Professional-Plan (DB-seitig, nicht code-verifiziert). Verwandte Artikel: Smart-Locks Übersicht, Glutz eAccess, Nuki, Salto KS.


# FAQ
Source: https://docs.anny.co/faq

Antworten auf die häufigsten Fragen rund um anny: Einrichtung, Buchungen, Zahlungen, Integrationen und mehr.

## Erste Schritte & Einrichtung

<AccordionGroup>
  <Accordion title="Was brauche ich, um mit anny zu starten?">
    Du brauchst nur einen anny Account. Nach der Registrierung richtest du im [Admin-Bereich](/admin-area-intro) dein Profil ein, erstellst deine erste [Ressource](/ressourcen-konfigurieren) und verknüpfst eine [Buchungsoption](/configure-booking-option). Sobald die Ressource auf "live" steht, ist sie auf deiner [Buchungsseite](/booking-page-overview) sichtbar und buchbar.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Ressource und Buchungsoption?">
    Eine **Ressource** ist das buchbare Objekt (Raum, Arbeitsplatz, Kurs). Eine **Buchungsoption** definiert, wie gebucht wird: Dauer, Preis, Intervall und Regeln. Eine Ressource kann mehrere Buchungsoptionen haben (z. B. stundenweise und tageweise), und eine Buchungsoption kann mit mehreren Ressourcen verknüpft sein. **Child-Ressourcen** sind konkrete Einheiten unter einer Parent-Ressource (z. B. Schreibtische in einem Open Space). Meetingräume und Sportplätze solltest du als eigene Ressourcen anlegen: Im übergreifenden Kalender werden Child-Ressourcen nur aggregiert angezeigt. Mehr dazu: [Ressource konfigurieren](/ressourcen-konfigurieren) und [Buchungsoption](/configure-booking-option).
  </Accordion>

  <Accordion title="Wie mache ich meine Ressource auf der Buchungsseite sichtbar?">
    Eine Ressource braucht drei Dinge: (1) mindestens einen [Zeitplan](/schedules) oder [Verfügbaren Termin](/available-slots), (2) eine verknüpfte [Buchungsoption](/configure-booking-option) und (3) den Status "live". Ohne eines davon wird sie auf der Buchungsseite nicht angezeigt.
  </Accordion>

  <Accordion title="Welchen anny Plan brauche ich?">
    Nach der Account-Erstellung testest du **5 Tage** alle Features kostenlos. Danach steht der kostenlose Starter-Plan zur Verfügung, plus Essential, Professional, Business und Enterprise. Beim Upgrade auf Essential oder Professional gilt eine **14-tägige** Plan-Testphase. Der passende Plan hängt von deinen Features und der Anzahl deiner Ressourcen ab. Details: [anny Plan verwalten](/anny-plan).
  </Accordion>

  <Accordion title="Kann ich anny in mehreren Sprachen nutzen?">
    Ja. anny ist in 29 Sprachen verfügbar. Die Buchungsseite wird automatisch in der Sprache deiner Kund:innen angezeigt. Ressourcen und Services kannst du manuell übersetzen (drei Punkte > Übersetzen).
  </Accordion>
</AccordionGroup>

## Verfügbarkeit & Zeitsteuerung

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Zeitplänen und Verfügbaren Terminen?">
    [Zeitpläne](/schedules) definieren regelmäßige, wiederkehrende Öffnungszeiten (z. B. Mo bis Fr, 9:00 bis 18:00 Uhr). [Verfügbare Termine](/available-slots) sind konkrete, einzelne Zeitfenster mit festem Datum (z. B. Workshop am 15.09. um 10:00 Uhr). Beide können auf derselben Ressource kombiniert werden.
  </Accordion>

  <Accordion title="Wie bilde ich saisonale Abweichungen ab (z. B. Ferienzeitraum)?">
    Lege einen zusätzlichen [Zeitplan](/schedules) mit einem Verfügbarkeitszeitraum (Start-/Enddatum) an und positioniere ihn per Drag and Drop oberhalb deines Standardzeitplans. Im definierten Zeitraum überschreibt der obere Zeitplan automatisch den unteren.
  </Accordion>

  <Accordion title="Wie sperre ich Ressourcen für einen Zeitraum (z. B. Feiertag)?">
    Nutze [Globale Blocker](/global-blockers). Sie sperren mehrere Ressourcen gleichzeitig für einen definierten Zeitraum, unabhängig von bestehenden Zeitplänen.
  </Accordion>

  <Accordion title="Was bewirkt die Vorlaufzeit und der Vorausbuchungszeitraum?">
    Die **Vorlaufzeit** bestimmt, wie kurzfristig gebucht werden kann (z. B. mindestens 2 Stunden vorher). Für **Tagesbuchungen** setzt du sie negativ (z. B. -8 Stunden), damit der heutige Tag nach dem Start noch buchbar bleibt. Der **Vorausbuchungszeitraum** begrenzt, wie weit in die Zukunft gebucht werden kann (z. B. maximal 4 Wochen). Beides konfigurierst du in der [Buchungsoption](/configure-booking-option) unter den erweiterten Einstellungen.
  </Accordion>

  <Accordion title="Kann ich die Kapazität automatisch an die Nachfrage anpassen?">
    Ja, mit [Dynamischer Kapazitätsplanung](/dynamic-capacity-planning). On-Demand Ressourcen werden bei steigender Nachfrage automatisch hinzugeschaltet.
  </Accordion>
</AccordionGroup>

## Buchungsablauf & Konfiguration

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen Resource-First und Service-First Flow?">
    Beim **Resource-First Flow** wählen Kund:innen zuerst eine konkrete Ressource, dann die Buchungsoption. Beim [Service-First Flow](/service-first-flow) wählen sie zuerst die Leistung, dann optional die Ressource. Service-First eignet sich für Dienstleistungen (Friseur, Beratung), Resource-First für konkrete Objekte (Räume, Equipment). Services stehen nur auf der Organisations-Buchungsseite, nicht auf der globalen Explore-Seite **Entdecken**.
  </Accordion>

  <Accordion title="Kann ich beide Flows gleichzeitig auf der Buchungsseite anzeigen?">
    Ja. Unter **Avatar** → **Account-Einstellungen** → Reiter **Einstellungen** kannst du sowohl den Reiter "Services" als auch "Ressourcen" einblenden. Kund:innen wechseln dann zwischen beiden Ansichten. Services erscheinen nur auf der Organisations-Buchungsseite, nicht auf der globalen **Entdecken**-Seite. Mehr dazu: [Service-First Flow](/service-first-flow).
  </Accordion>

  <Accordion title="Was sind die Buchungsarten (Standard, Transparent, Mehrfach, Vollständig)?">
    **Standard** blockiert die Ressource für den Buchungszeitraum. **Transparent** blockiert nicht (unbegrenzte parallele Buchungen). **Mehrfach** blockiert mehrere Kapazitätseinheiten pro Buchung. **Vollständig** blockiert die gesamte Kapazität (nur bei Child-Ressourcen). Konfiguration in der [Buchungsoption](/configure-booking-option).
  </Accordion>

  <Accordion title="Wie funktioniert Smart Availability?">
    [Smart Availability](/smart-availability) verbindet Ressourcen so, dass bei einer Buchung automatisch alle abhängigen Ressourcen blockiert werden (z. B. teilbare Räume mit Trennwand). Mit Smart Availability Groups definierst du Pools, aus denen anny automatisch verfügbare Ressourcen auswählt (z. B. 2 Mitarbeitende + 1 Raum für eine Paarmassage).
  </Accordion>

  <Accordion title="Wie begrenze ich, wie oft eine Person buchen darf?">
    Mit [Buchungsregeln](/booking-rules). Sie limitieren accountweit die Anzahl erlaubter Buchungen pro Zeitraum. Du kannst den Geltungsbereich auf bestimmte Ressourcen/Services einschränken und Ausnahmen über White-Lists definieren. Verfügbar ab Professional.
  </Accordion>

  <Accordion title="Können Kund:innen ihre Buchungen selbst ändern oder stornieren?">
    Ja, wenn du es aktivierst. [Änderung von Buchungen](/modify-bookings) erlaubt Verschiebungen und Anpassungen. [Stornierungsbedingungen](/cancellation-policy) definieren Fristen und Kosten. Beides wird pro Buchungsoption konfiguriert.
  </Accordion>
</AccordionGroup>

## Kunden, Communities & Zugang

<AccordionGroup>
  <Accordion title="Wie mache ich Ressourcen nur für bestimmte Personen zugänglich?">
    Nutze [Communities](/communities). Erstelle eine Community, verknüpfe Ressourcen und füge Mitglieder hinzu. Nur Mitglieder sehen und buchen die zugewiesenen Ressourcen. Mitglieder können manuell, per E-Mail-Domain, SSO, Buchungsregel oder über ein Abo hinzugefügt werden.
  </Accordion>

  <Accordion title="Was ist ein Buchungskontingent und wie vergebe ich es?">
    Ein [Buchungskontingent](/booking-quotas) ist ein Guthaben (Menge, Dauer oder Budget), das pro Person bei Buchungen verbraucht wird. Vergabe über: manuell in der Kundendetailansicht, automatisch über Abo-Plan, Community oder Buchungspaket. Beispiel: 5 Meetingraum-Stunden pro Monat im Coworking-Abo.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Buchungspaket, Wertgutschein und Rabattcode?">
    Ein [Buchungspaket](/booking-codes) ist zweckgebunden (konkretes Kontingent, USt. beim Kauf, 8-stelliger Buchungscode). Ein [Wertgutschein](/value-vouchers) ist ein Mehrzweckgutschein (reiner Geldwert, 0 % USt. beim Kauf, wird als Zahlungsmittel eingelöst). Ein [Rabattcode](/discount-codes) ist ein prozentualer oder absoluter Preisnachlass ohne Guthabenlogik.
  </Accordion>

  <Accordion title="Wie richte ich Mitgliedschaften mit automatischer Abrechnung ein?">
    Erstelle einen [Abo-Plan](/subscriptions-and-memberships) mit Preis und Intervall. Verknüpfe optional eine Community (für exklusiven Zugang) und ein Kontingent (für inkludierte Leistungen). Bei Abo-Abschluss erhalten Kund:innen automatisch beides. Voraussetzung: Online-Zahlung (Stripe) muss aktiv sein.
  </Accordion>

  <Accordion title="Können Kund:innen zwischen Abo-Stufen wechseln?">
    Ja. Innerhalb einer [Abo-Plan-Gruppe](/subscriptions-and-memberships) ist Upgrade (sofort wirksam, anteilig verrechnet) und Downgrade (zum nächsten Abrechnungszeitpunkt) möglich. Kund:innen können selbstständig auf der Buchungsseite wechseln.
  </Accordion>
</AccordionGroup>

## Zahlungen & Rechnungen

<AccordionGroup>
  <Accordion title="Welche Zahlungsmethoden unterstützt anny?">
    Über Stripe Connect: SEPA-Lastschrift, Kreditkarte, Apple Pay und Google Pay. Für Abos in CHF zusätzlich PayPal (TWINT unterstützt keine wiederkehrenden Zahlungen). Details: [Online-Zahlung & Gebühren](/online-payments).
  </Accordion>

  <Accordion title="Kann ich Kund:innen auf Rechnung buchen lassen?">
    Ja, mit [Zahlen auf Rechnung (Pay-Later)](/pay-later). Kund:innen zahlen nach der Buchung per Rechnung. Alternativ nutze [Kundensalden & Sammelrechnungen](/customer-balances-and-collective-invoices), um Rechnungsentwürfe zu sammeln und gebündelt abzurechnen.
  </Accordion>

  <Accordion title="Wie funktioniert Dynamisches Pricing?">
    [Dynamisches Pricing](/dynamic-pricing) passt Preise über Preismodifikatoren automatisch an: nach Wochentag, Uhrzeit, Auslastung, Community-Zugehörigkeit, Vorlaufzeit oder Buchungsanzahl. Du definierst Bedingungen und anny wendet den Preis bei der Buchung automatisch an. Verfügbar ab Professional.
  </Accordion>

  <Accordion title="Wie korrigiere oder storniere ich eine Rechnung?">
    Über [Rechnung korrigieren](/invoice-corrections) kannst du Rechnungen vollständig stornieren, Korrekturrechnungen erstellen oder die Rechnungsadresse nachträglich ändern. Rechnungsentwürfe können vor der Finalisierung noch frei bearbeitet werden: [Rechnungsentwurf](/invoice-drafts).
  </Accordion>
</AccordionGroup>

## Check-In, Displays & Vor-Ort

<AccordionGroup>
  <Accordion title="Wie richte ich einen Check-In mit QR-Code ein?">
    Aktiviere das Feature unter Account-Einstellungen > Features > Check-In & Check-Out. Konfiguriere dann pro Ressource unter dem Reiter "Check-In" das QR-Code-Ticket. Kund:innen erhalten bei der Buchung ein Ticket, das am Eingang gescannt wird. Details: [Check-In & Check-Out](/check-in-overview), [Anwesenheit in den Buchungsdetails](/check-in-booking-details) und [Check-In Terminal einrichten](/check-in-setup).
  </Accordion>

  <Accordion title="Kann ich Raumdisplays mit anny verbinden?">
    Ja. Die [Display App](/display-app) verwandelt Tablets und Smart-TVs in interaktive Raumdisplays mit Live-Status und Ad-hoc-Buchung. Alternativ: [URL Anzeigetafeln](/url-display-boards) für browserbasierte Anzeigen ohne App-Installation. Für Joan-Displays: [Joan einrichten](/joan-setup). Für tapirx E-Ink-Displays: [tapirx](/tapirx-setup).
  </Accordion>

  <Accordion title="Kann ich Formulare erst beim Check-In abfragen statt im Checkout?">
    Ja (BETA). Setze den Abfragezeitpunkt bei [Eigenen Formularen](/custom-forms) oder [Rechtlichen Dokumenten](/legal-documents) auf "Später (beim Check-in)". Die Abfrage erscheint dann erst beim Check-in-Vorgang am Terminal.
  </Accordion>

  <Accordion title="Wie nehme ich Zahlungen vor Ort entgegen?">
    Mit der [POS App](/pos-app-setup). Verbinde ein Kartenlesegerät oder nutze Tap to Pay (iPhone) und wickle Zahlungen direkt vor Ort ab. Trinkgeld kann bei Kartenzahlungen mit kassiert werden. Buchungen und Zahlungen verwaltest du in der [POS App](/pos-app-bookings-and-payments).
  </Accordion>
</AccordionGroup>

## Integrationen & Kalender

<AccordionGroup>
  <Accordion title="Welche Kalender kann ich mit anny verbinden?">
    [Google Kalender](/google), [Outlook](/outlook), [Microsoft 365](/m365-workspace), [Google Workspace](/google-workspace) und [ICS-Kalender](/ics-calendar) (alle Anbieter). Eine Vergleichsübersicht findest du unter [Kalenderintegrationen](/calendar-integrations).
  </Accordion>

  <Accordion title="Wie verbinde ich ein Smart Lock mit anny?">
    anny integriert mit [Nuki](/nuki), [Salto KS](/salto-ks), [Tapkey](/tapkey), [dormakaba exivo](/dormakaba-exivo), [dormakaba resivo](/dormakaba-resivo), [EVVA AirKey](/evva-airkey), [Comydo](/comydo), [Keycafe](/keycafe), [Klever Key](/klever-key), [Glutz eAccess](/glutz-eaccess), [UniFi](/unifi) und [Shelly](/shelly). Übersicht: [Smart Locks](/smart-locks-overview). Zugang wird automatisch basierend auf aktiven Buchungen gewährt.
  </Accordion>

  <Accordion title="Kann ich SSO (Single-Sign-On) nutzen?">
    Ja. anny unterstützt [Microsoft SAML SSO](/microsoft-saml-sso), [Google Workspace SSO](/google-workspace-sso), [generisches SAML](/generic-saml-sso) und [OAuth2](/oauth2-sso). Ergänzend: [SCIM](/scim-user-provisioning) für automatische User-Synchronisierung und [Attribute Mapping](/attribute-mapping) für Community-Zuordnung. Übersicht: [SSO Übersicht](/sso-overview). Endnutzer:innen werden beim Login zu eurem Identity Provider weitergeleitet (Microsoft, Google, SAML oder OAuth). Das ist beabsichtigt: anny prüft das Passwort nicht selbst, sondern vertraut der Anmeldung im Unternehmens-Login.
  </Accordion>

  <Accordion title="Kann ich Buchungen mit meinem HR-Tool synchronisieren?">
    Ja. anny integriert mit [Personio](/personio) und [HRworks](/hrworks). Bei Abwesenheit werden Buchungen automatisch storniert. Umgekehrt können Buchungen als Abwesenheiten in das HR-System geschrieben werden.
  </Accordion>

  <Accordion title="Gibt es eine Anbindung an Buchhaltungssysteme?">
    Ja. Über die [DATEV-Integration](/datev-integration) exportierst du Kontoauszüge und Belege DATEV-konform. Für andere Systeme nutze [automatische Exporte](/automatic-exports) als CSV oder Excel in festen Intervallen. Allgemeine Infos: [Buchhaltung mit anny](/accounting).
  </Accordion>

  <Accordion title="Kann ich anny mit Automatisierungstools verbinden?">
    Ja. Über [Make.com](/make-com) verbindest du anny per Webhooks und API. Zusätzlich gibt es einen eigenen anny-Node für n8n (Community-Node `n8n-nodes-anny`) mit OAuth2 und Webhook-Triggern.
  </Accordion>
</AccordionGroup>

## anny AI

<AccordionGroup>
  <Accordion title="Was kann anny AI?">
    [anny AI](/anny-ai-setup) ist ein KI-Assistent, der Anrufe entgegennimmt, Kund:innen berät, Verfügbarkeiten prüft und Buchungen erstellt, per Telefon und Chat. Du kannst Stimme, Begrüßung und Verhalten individuell [anpassen](/anny-ai-customize-assistant) und eine [Wissensdatenbank](/anny-ai-knowledge-management) pflegen, damit der Assistent kompetent antwortet.
  </Accordion>

  <Accordion title="Wie leite ich Anrufe an anny AI weiter?">
    Über eine [Rufweiterleitung](/anny-ai-call-forwarding) von deiner bestehenden Telefonnummer. Deine bekannte Nummer bleibt erhalten, Anrufe werden an den anny AI-Assistenten weitergeleitet.
  </Accordion>

  <Accordion title="Kann anny AI an einen Mitarbeiter durchstellen?">
    Ja. Wenn der Assistent nicht weiterhelfen kann, stellt er auf Wunsch an einen [Mitarbeiter durch](/anny-ai-call-transfer). Du konfigurierst, an welche Nummern durchgestellt werden darf.
  </Accordion>

  <Accordion title="Was kostet anny AI und wie steht es um den Datenschutz?">
    Alle Infos zu Kosten, unterstützten Sprachen, Datenschutz und Tipps für den Betrieb findest du unter [FAQ, Tipps, Datenschutz und Abrechnung](/anny-ai-faq).
  </Accordion>
</AccordionGroup>

## Apps & Einbettung

<AccordionGroup>
  <Accordion title="Welche Apps bietet anny?">
    [Mobile App](/anny-mobile-app) (iOS und Android), [Outlook Add-In](/outlook-add-in), [MS Teams App](/ms-teams-app), [Display App](/display-app), [POS App](/pos-app-setup) und [Check-In App](/check-in-setup). Übersicht aller Apps: [anny Apps](/anny-apps-overview).
  </Accordion>

  <Accordion title="Wie bette ich die Buchungsseite auf meiner Website ein?">
    Über das [Widget](/embed-booking-page). Auf WordPress installierst du das Plugin [anny bookings](https://wordpress.org/plugins/anny-bookings/) und fügst Blöcke ein, siehe [WordPress](/embed-wordpress). Auf anderen Websites funktioniert es per iFrame oder Script. Weitere Anleitungen: [Wix](/embed-wix), [Google Sites](/embed-google-sites). Für erweiterte Konfiguration (Events, Modal-Verhalten, HTML-Attribute): [Einbettung für Fortgeschrittene](/widget-embed-advanced).
  </Accordion>

  <Accordion title="Kann ich über Outlook buchen, ohne anny zu öffnen?">
    Ja. Das [Outlook Add-In](/outlook-add-in-user-guide) ermöglicht dir, Räume und Arbeitsplätze direkt aus Outlook heraus zu buchen. Admin-Einrichtung: [Outlook Add-In verbinden](/outlook-add-in).
  </Accordion>

  <Accordion title="Gibt es eine interaktive Kartenansicht für Ressourcen?">
    Ja. Mit [interaktiven 3D-Lageplänen](/maps-and-floor-plans) kannst du Grundrisse hochladen und Ressourcen darauf platzieren. Kund:innen sehen verfügbare Ressourcen grün markiert und können direkt über die Karte buchen.
  </Accordion>
</AccordionGroup>

## Sicherheit & Datenschutz

<AccordionGroup>
  <Accordion title="Ist anny DSGVO-konform?">
    Ja. anny wird in Deutschland entwickelt und gehostet. Alle Daten werden auf deutschen Servern verarbeitet. Die Infrastruktur ist ISO 27001 zertifiziert. Mehr dazu im [anny Trust Center](https://trust.anny.co/).
  </Accordion>

  <Accordion title="Kann ich Löschfristen für personenbezogene Daten konfigurieren?">
    Ja. Unter [Datenschutz & Löschfristen](/data-privacy) definierst du eigene Fristen für die automatische Anonymisierung oder Löschung von Buchungs- und Kundendaten.
  </Accordion>

  <Accordion title="Unterstützt anny 2-Faktor-Authentifizierung?">
    Ja. [2-Faktor-Authentifizierung](/two-factor-authentication) kann für Admin-Accounts aktiviert werden und erhöht die Login-Sicherheit.
  </Accordion>

  <Accordion title="Bietet anny eine dedizierte Umgebung für öffentliche Einrichtungen?">
    Ja. Für Kommunen und öffentliche Einrichtungen bietet anny eine eigene, getrennte Umgebung mit erhöhten Sicherheitsanforderungen.
  </Accordion>
</AccordionGroup>


# Glutz eAccess mit anny verbinden
Source: https://docs.anny.co/glutz-eaccess

Erstelle mit Glutz eAccess pro Buchung automatisch zeitlich begrenzte PIN-Zugänge für die passende Tür.

[Glutz eAccess](https://www.glutz.com) ist ein Zutrittssystem, das Türen über digitale Schließkomponenten und PIN-Codes steuert. anny verbindet sich dabei mit deinem lokalen Glutz eAccess Server. Mit der Integration erstellt anny pro Buchung automatisch einen zeitlich begrenzten Zugang mit individuellem PIN-Code für die passende Tür.

Mit Glutz eAccess kannst du in anny:

* Pro Buchung automatisch einen zeitlich begrenzten Zugang mit individuellem PIN-Code erstellen
* anny-Ressourcen über Regeln mit einem oder mehreren Glutz-Zugangspunkten verknüpfen
* Zugänge bei Buchungsänderungen automatisch anpassen und bei Stornierungen wieder entfernen
* Türen per Remote Open direkt aus der anny Buchungsansicht oder Homepage öffnen

Besonders praktisch ist die Integration, wenn du Räume oder Ressourcen mit einem Glutz-Schließsystem vermietest und deinen Kund:innen automatisierten, zeitlich begrenzten Zutritt ohne manuelle Schlüsselübergabe bieten möchtest.

<Info>
  Verfügbar ab dem Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Meetingräume automatisch freischalten | **Zugang genau im gebuchten Zeitfenster.** Wird ein Meetingraum gebucht, erhält die buchende Person automatisch einen PIN für die passende Tür, gültig inklusive Vor- und Nachlaufzeit. |
| Coworking- und Büroflächen | **Schlüsselloser Zutritt ohne Rezeption.** Kund:innen betreten gebuchte Flächen eigenständig per PIN, ganz ohne manuelle Schlüsselübergabe. |
| Kurzfristige Umbuchungen | **Zugang bleibt automatisch aktuell.** Ändert sich die Buchungszeit, passt anny das Zugangsfenster in Glutz automatisch an. |

## Wie die Glutz eAccess-Verbindung funktioniert

Die Verbindung wird über Zugangsdaten hergestellt, nicht über OAuth. Du hinterlegst die **API-Basis-URL** (die Server-Adresse deiner Glutz-Instanz) sowie Benutzername und Passwort eines Glutz-Benutzers. Damit authentifiziert sich anny bei deinem laufenden Glutz eAccess Server und darf dort Zugänge anlegen, aktualisieren und entfernen.

Sobald eine Ressource mit passender Regel gebucht wird, legt anny in Glutz einen separaten Zugang für genau diese Buchung an und vergibt einen individuellen PIN-Code. In Glutz werden dabei keine personenbezogenen Daten gespeichert, sondern nur die Buchungsnummer als Referenz.

Bei Einzelbuchungen erstellt anny den Zugang sofort. Bei Serienbuchungen bereitet anny jeden Termin einzeln kurz vor Zugangsbeginn vor: Der Zugang steht bis dahin auf **Geplant** und wird rund zwei Tage vor dem Termin erzeugt.

Wenn du das hinterlegte Passwort änderst oder den Glutz-Benutzer deaktivierst, verliert anny den Zugriff und kann keine neuen Zugänge erstellen. Aktualisiere in diesem Fall die Zugangsdaten in der Integration.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Zugänge (Erstellen, Aktualisieren, Entfernen) | anny → Glutz | Bei Buchungserstellung, -änderung und -stornierung |
| PIN-Codes | anny → Glutz | Bei Buchungserstellung |

## Glutz eAccess verbinden

### Voraussetzungen

Bevor du Glutz eAccess verbindest, stelle sicher, dass du Folgendes hast:

* Admin-Rechte mit Zugriff auf die **Integrationen** in anny
* Einen laufenden Glutz eAccess Server
* Die **API-Basis-URL** (Server-Adresse) deiner Glutz-Instanz
* Benutzername und Passwort eines Glutz-Benutzers mit ausreichenden Rechten
* In Glutz eingerichtete Zugangspunkte (Türen)
* Die in Glutz festgelegte Codelänge, die du in anny übernimmst

### Verbindung einrichten

<Steps>
  <Step title="Integration öffnen">
    Öffne aus der **Menüleiste** die **Integrationen** und wähle **Glutz eAccess**.
  </Step>

  <Step title="Authentifizieren">
    Trage die **API-Basis-URL** (deine Glutz-Server-Adresse), **Benutzername** und **Passwort** ein und klicke auf **Authentifizierung überprüfen**. anny verbindet sich damit mit deinem laufenden Glutz eAccess Server.
  </Step>

  <Step title="Regeln anlegen">
    Verknüpfe über eine **Regel** eine anny-Ressource mit einem oder mehreren Glutz-**Zugangspunkten**. Lege pro Regel **Zugang vor der Buchung** und **Zugang nach der Buchung** fest und aktiviere optional **Fernöffnung verwenden**.
  </Step>

  <Step title="Codelänge festlegen">
    Trage unter **PIN-Codes** die **Codelänge (Stellen)** ein, die du in Glutz konfiguriert hast. Erlaubt sind 4 bis 8 Stellen (Standard 6). Der Wert in anny muss mit der Einstellung in Glutz übereinstimmen.
  </Step>

  <Step title="Verbindung prüfen">
    Prüfe in den **Integrationen**, ob Glutz eAccess als aktiv angezeigt wird.
  </Step>
</Steps>

Sobald die Verbindung aktiv ist und eine Regel greift, erstellt anny bei jeder passenden Buchung automatisch einen zeitlich begrenzten Zugang mit PIN.

<Tip>
  Plane bei **Zugang vor der Buchung** und **Zugang nach der Buchung** genügend Puffer ein, damit Kund:innen kurz vor Buchungsbeginn eintreten und den Raum kurz nach Buchungsende verlassen können.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Zugang vor der Buchung | Minuten vor Buchungsbeginn, ab denen der Zugang aktiv ist. |
| Zugang nach der Buchung | Minuten nach Buchungsende, bis zu denen der Zugang aktiv bleibt. |
| Fernöffnung verwenden | Aktiviert das Öffnen der Tür per Knopfdruck aus anny. |
| Codelänge (Stellen) | Länge des generierten PIN-Codes (4 bis 8 Stellen, Standard 6). Muss mit der in Glutz hinterlegten Einstellung übereinstimmen. |

### Remote Open

Mit der Remote-Open-Funktion können Kund:innen Türschlösser per Knopfdruck öffnen: direkt über die anny Homepage oder die Buchungsansicht. So ist ein Zutritt auch ohne PIN-Eingabe am Zugangspunkt möglich. Aktiviere **Fernöffnung verwenden** pro Regel, damit der Button für die verknüpften Zugangspunkte erscheint. Der Button lässt sich nur innerhalb des Zugangsfensters (Buchungszeit plus Vor- und Nachlaufzeit) nutzen.

| Ort | Wo öffnest du die Tür? |
| - | - |
| E-Mail | Der Link **Öffnen** in der Buchungs-E-Mail führt auf die Buchungsseite im Browser, dort erscheint der Button |
| Buchungsseite (Kund:innen) | Button **Tür entriegeln** in der Buchungsansicht der Kund:innen |
| Buchungsübersicht (Admin) | Button **Schloss entsperren** in der Buchungsübersicht in anny |

## Einschränkungen

Die Glutz eAccess-Integration unterstützt nicht:

* Zugänge zu Türen, die nicht als Zugangspunkt in Glutz eingerichtet sind.
* Automatische Zugänge ohne passende Regel: Ohne Zuordnung von Ressource zu Zugangspunkt wird kein Zugang erstellt.
* Speicherung personenbezogener Daten in Glutz: Zur Zuordnung wird ausschließlich eine Buchungsreferenz übergeben.

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Wie lang ist der PIN-Code?">
    Die **Codelänge (Stellen)** ist konfigurierbar (4 bis 8 Stellen, Standard 6). Du legst in Glutz fest, wie lang der Code sein darf, und trägst denselben Wert in anny ein. Beide Einstellungen müssen übereinstimmen.
  </Accordion>

  <Accordion title="Erhalten meine Kund:innen den PIN automatisch?">
    Ja. Sobald eine passende Buchung erstellt wird, generiert anny automatisch einen individuellen PIN für die zugehörige Tür und das gebuchte Zeitfenster. Bei Serienbuchungen wird der PIN pro Termin erst kurz vorher erzeugt, rund zwei Tage vor Zugangsbeginn.
  </Accordion>

  <Accordion title="Was passiert, wenn eine Buchung geändert oder storniert wird?">
    Bei einer Zeitänderung passt anny das Zugangsfenster automatisch an. Bei Stornierung oder Löschung entfernt anny den Zugang samt PIN wieder aus Glutz.
  </Accordion>

  <Accordion title="Kann ich mehrere Türen pro Ressource freischalten?">
    Ja. Pro Regel kannst du eine Ressource mit einem oder mehreren Glutz-Zugangspunkten verknüpfen.
  </Accordion>

  <Accordion title="Welche Daten speichert anny in Glutz?">
    anny übergibt keine personenbezogenen Daten an Glutz. Zur Zuordnung wird ausschließlich eine Buchungsreferenz verwendet.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der PIN funktioniert noch nicht">
    Prüfe die Einstellung **Zugang vor der Buchung** und den Buchungsbeginn. Der Zugang ist erst ab Buchungsbeginn minus dieser Vorlaufzeit aktiv. Kontrolliere außerdem, ob die Ressource in einer Regel korrekt einem Zugangspunkt zugeordnet ist. Bei Serienbuchungen wird der Zugang zudem erst rund zwei Tage vor dem Termin erstellt.
  </Accordion>

  <Accordion title="Der PIN funktioniert nach einer Verlängerung nicht">
    Prüfe, ob die Buchung tatsächlich aktualisiert wurde und die Änderung in Glutz durchgelaufen ist. anny passt das Zugangsfenster nur an, wenn die Buchungszeit erfolgreich geändert wurde.
  </Accordion>

  <Accordion title="Der PIN öffnet die falsche Tür">
    Prüfe das Regelmapping. Kontrolliere, ob die Ressource dem richtigen Glutz-Zugangspunkt zugeordnet ist.
  </Accordion>

  <Accordion title="Der Zugang ist nach einer Stornierung noch aktiv">
    Prüfe, ob die Buchung korrekt storniert oder gelöscht wurde und ob die Verbindung zu Glutz aktiv ist. Nur bei aktiver Verbindung kann anny den Zugang entfernen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> On-Premise, NICHT Cloud: anny verbindet sich mit einem lokalen Glutz eAccess Server. Das Feld heißt in der UI "API-Basis-URL" (Tooltip: "Basis-URL deines lokalen Glutz eAccess Servers", Platzhalter z. B. [https://dein-server:8332](https://dein-server:8332)). Formulierungen wie "Glutz Cloud" sind falsch.
>
> UI-Pfad Einrichten: Menüleiste → Integrationen → Glutz eAccess → API-Basis-URL, Benutzername, Passwort eingeben → Button "Authentifizierung überprüfen". Danach Bereich "PIN-Codes" (Codelänge) und Regeln ("Zugang durch Buchungen"). Verbindung trennen: Integrationen → Glutz eAccess → Toggle oben rechts deaktivieren → drei Punkte → Löschen.
>
> Authentifizierung: Basic-Auth (API-Basis-URL + Benutzername + Passwort), NICHT OAuth. Abgrenzung zu OAuth-Locks wie Nuki.
>
> Codelänge: UI-Label "Codelänge (Stellen)" im Bereich "PIN-Codes", zulässig 4–8, Standard 6. Muss mit der Glutz-Einstellung identisch sein. Pro Buchung ein eigener Glutz-Nutzer (Label "anny ") mit zufälligem PIN dieser Länge.
>
> Regel-Felder (gemeinsame Smart-Lock-Oberfläche): "Zugang vor der Buchung" / "Zugang nach der Buchung" (Padding), "Fernöffnung verwenden" (Remote-Open-Schalter), "Zugangspunkte" (Locks). Gültigkeit des Zugangs = Buchungszeit + Vorlauf + Nachlauf.
>
> Remote Open pro Regel aktivierbar; Button nur innerhalb des Zugangsfensters aktiv. Beschriftungen: E-Mail-Link "Öffnen" (→ Buchungsseite im Browser), Kund:innen-Buchungsansicht "Tür entriegeln", Admin-Buchungsübersicht "Schloss entsperren".
>
> Serien vs. Einzel: Einzelbuchung → Zugang sofort + gesonderte Zugangs-Benachrichtigung. Serienbuchung → pro Termin Status "Geplant", Erstellung ca. 48 h vor Zugangsbeginn, KEINE gesonderte Benachrichtigung.
>
> Auslösebedingungen: nur angenommene Buchungen mit Kund:in; Blocker und Anfragen lösen nichts aus. Regel auf Elternressource greift auch für Unterressourcen (spezifischere Regel hat Vorrang). Nur eine Regel pro Ressource (Duplikat wird beim Speichern abgelehnt).
>
> Statuswerte eines Zugangs: In Bearbeitung, Geplant, Unbestätigt, Erfolgreich (Label "Erfolgreich", nicht "Erfolgreich erstellt"), Fehlgeschlagen, Nicht autorisiert, Aufräumen, Entfernt.
>
> Keine harten Limits für gleichzeitige/zukünftige Zugänge pro Zugangspunkt (anders als Nuki mit 200). Abgelaufene Zugänge werden bei Glutz NICHT automatisch aufgeräumt; der PIN wird durch das Ablaufdatum (validTo) ungültig, der Glutz-Nutzer bleibt bestehen.
>
> Wenn-Dann: Buchung erstellt → Zugang + PIN angelegt. Buchungszeit geändert → nur Zugangsfenster angepasst, PIN bleibt gleich. Buchung storniert/gelöscht → Glutz-Nutzer + PIN aktiv gelöscht.
>
> Datenschutz: keine personenbezogenen Daten in Glutz, nur die Buchungsnummer als Referenz.
>
> Regel-Pflicht: Ohne Regel (Ressource ↔ Zugangspunkt) kein automatischer Zugang. Zugangspunkte müssen zuvor in Glutz existieren.
>
> Verfügbar ab Professional-Plan (Feature INTEGRATIONS\_SMART\_LOCKS; Plan-Grenze nicht aus dem Code verifizierbar). Per Env-Flag standardmäßig aktiv/GA. Haupt-Use-Case: Room Booking. Verwandte Artikel: Smart-Locks Übersicht, Nuki, SaltoKS, Dormakaba Exivo/Resivo.


# GoBD bei anny
Source: https://docs.anny.co/gobd

Wie anny Rechnungen festschreibt, unveränderlich hält und storniert – und was du als Betreiber:in für eine GoBD-konforme Buchführung selbst beisteuern musst.

Die GoBD – die „Grundsätze zur ordnungsmäßigen Führung und Aufbewahrung von Büchern, Aufzeichnungen und Unterlagen in elektronischer Form sowie zum Datenzugriff“ – beschreiben, wie steuerlich relevante Daten in Software entstehen, gesichert und aufbewahrt werden müssen. Für dich als Betreiber:in einer anny-Instanz sind vor allem zwei Fragen relevant: Kann jemand eine ausgestellte Rechnung nachträglich verändern? Und lässt sich jeder Geschäftsvorfall lückenlos nachvollziehen?

Die kurze Antwort: Sobald eine Rechnung in anny festgeschrieben ist, ist sie unveränderlich. Korrekturen entstehen ausschließlich als neue Dokumente – Stornorechnung, Korrekturrechnung oder Neuausstellung. Diese Seite beschreibt die Prozesse dahinter im Detail.

<Info>
  anny ist die Software, in der deine Belege entstehen – nicht dein Buchführungssystem und keine Steuerberatung. Die Buchführungs-, Aufzeichnungs- und Aufbewahrungspflichten treffen dich als Steuerpflichtige:n. Der Abschnitt **Was das für dich als Betreiber:in bedeutet** trennt beide Seiten auf.
</Info>

## Die GoBD-Grundsätze und ihre Umsetzung

| Grundsatz | Umsetzung in anny |
| - | - |
| **Nachvollziehbarkeit und Nachprüfbarkeit** | Jede Rechnung ist fest mit Bestellung, Buchung, Zahlung und – falls vorhanden – Storno verknüpft. |
| **Vollständigkeit** | Jede kostenpflichtige Buchung erzeugt automatisch eine Bestellung mit Rechnung. Rechnungsnummern werden je Nummernkreis fortlaufend vergeben. |
| **Richtigkeit** | Beträge, Steuersätze und die USt-Aufteilung werden aus den Positionen berechnet und beim Festschreiben eingefroren – inklusive Rundung je Steuergruppe statt kumulierter Einzelrundungen. |
| **Zeitgerechte Erfassung** | Der Beleg entsteht mit dem Geschäftsvorfall. Wann genau festgeschrieben wird, hängt an der Zahlungsart – siehe [Wann festgeschrieben wird](#wann-festgeschrieben-wird). |
| **Ordnung** | Getrennte Nummernkreise je Organisation und Jahr, eindeutige Rechnungsnummern, feste Status. |
| **Unveränderbarkeit** | Festgeschriebene Rechnungen sind schreibgeschützt – über die Oberfläche, über die API und im internen Adminbereich gleichermaßen. |
| **Aufbewahrung** | Beim Festschreiben werden PDF und E-Rechnung erzeugt und archiviert. Beide bleiben abrufbar und liegen jedem Buchhaltungsexport bei. |

## Entwurf, Festschreibung, Unveränderlichkeit

Jede Rechnung durchläuft in anny genau zwei Zustände. Der Übergang dazwischen ist der Moment der Festschreibung – und er ist eine Einbahnstraße.

<Steps>
  <Step title="Entwurf">
    Ein Rechnungsentwurf hat noch **keine Rechnungsnummer**. Du kannst Positionen ändern, Beträge korrigieren, den Empfänger tauschen oder den Entwurf komplett löschen. Ein Entwurf ist kein Beleg und geht in keinen Buchhaltungsexport ein. Mehr dazu unter [Rechnungsentwurf bearbeiten](/invoice-drafts).
  </Step>

  <Step title="Festschreiben">
    Beim Fertigstellen passiert dreierlei in einem Zug: anny vergibt die nächste Rechnungsnummer aus deinem Nummernkreis, setzt den Status (versendet oder bezahlt) und erzeugt die Belegdateien – ein PDF und eine strukturierte E-Rechnung im XML-Format. Beide werden unter einem eindeutigen Dateinamen archiviert.
  </Step>

  <Step title="Festgeschrieben">
    Ab jetzt sind Positionen, Beträge, Steuersätze, Rechnungsdatum und Rechnungsnummer unveränderlich. Änderungsversuche werden abgewiesen – die Oberfläche bietet keine Bearbeitung mehr an, die API antwortet mit einem Fehler, und auch der interne Adminbereich verweigert die Bearbeitung. Löschen ist ebenfalls ausgeschlossen.
  </Step>
</Steps>

### Wann festgeschrieben wird

Der Zeitpunkt hängt an der [Zahlungsart der Buchungsoption](/invoicing) – nicht an einer globalen Einstellung:

| Zahlungsart | Zeitpunkt der Festschreibung |
| - | - |
| **Vorab online zahlen** | Mit dem Abschluss der Buchung, gemeinsam mit der Zahlung. |
| **Kartenzahlung vor Ort (POS)** | Mit dem Start des Zahlvorgangs am Lesegerät. |
| **Zahlen auf Rechnung (Pay-Later)** | Zum gewählten Rechnungsdatum. Das lässt sich bewusst nach hinten legen, etwa auf den Buchungstermin, damit Änderungen bis dahin ohne Storno möglich bleiben. Ein stündlicher Lauf schreibt jede fällige Rechnung fest und versendet sie. |
| **Offline-Zahlung** | Optional: mit Rechnungsstellung wie bei Pay-Later, ohne Rechnungsstellung gar nicht. |
| **Sammelrechnung aus [Kundensalden](/customer-balances-and-collective-invoices)** | Am Periodenende, wenn die gesammelten Entwürfe zu einer Rechnung konsolidiert werden. |

<Warning>
  Schaltest du bei Offline-Zahlung die Rechnungsstellung bewusst ab, erzeugt anny für diese Buchungen keinen Beleg und schreibt nichts fest. Wir gehen dann davon aus, dass die Rechnung in einem anderen System entsteht. Die ordnungsgemäße Rechnungsstellung liegt in diesem Fall vollständig bei dir.
</Warning>

<Note>
  Rechnungen über 0,00 € erhalten keine Nummer und werden nicht festgeschrieben. Sie dokumentieren eine kostenlose Buchung, sind aber kein steuerlich relevanter Beleg.
</Note>

## Rechnungsnummern

Rechnungsnummern werden je Nummernkreis lückenlos aufsteigend vergeben. Ein Nummernkreis besteht aus dem Präfix deiner Organisation und dem Jahr, in dem die Rechnung ausgestellt wird:

```text theme={null}
R-B{ORG_ID}-{JJ}-######
│ │         │    └── laufende Nummer, zum Jahreswechsel auf 0 zurückgesetzt
│ │         └─────── Jahr der Ausstellung
│ └───────────────── Präfix deiner Organisation
└─────────────────── Dokumentkennzeichen
```

Für die Vergabe gilt:

* anny ermittelt die höchste bereits vergebene Nummer des Kreises und zählt um eins hoch. Es entstehen keine Lücken durch Zufallswerte oder Zeitstempel.
* Die Vergabe läuft unter einer Sperre. Auch wenn mehrere Buchungen in derselben Sekunde abgeschlossen werden, erhält jede Rechnung genau eine eigene Nummer.
* Eine einmal vergebene Nummer wird nie erneut verwendet – auch nicht nach einer Stornierung.
* Zum Jahreswechsel wird der Zähler auf 0 zurückgesetzt. Das Jahr im Präfix trennt die Kreise, sodass sich Nummern verschiedener Jahre nie überschneiden.

<Note>
  Das Präfix leitet anny aus deiner Organisation ab. Es lässt sich nicht manuell ändern – damit kann auch niemand einen Nummernkreis nachträglich verschieben oder doppelt eröffnen.
</Note>

## Korrekturen: Storno statt Änderung

Eine festgeschriebene Rechnung wird nicht korrigiert, sondern durch ein zweites Dokument ausgeglichen. Das Original bleibt in jedem Fall erhalten und abrufbar.

| Fall | Was anny tut | Ergebnis |
| - | - | - |
| **Vollständige Stornierung** | Erzeugt eine Stornorechnung mit gespiegelten Positionen und negativen Beträgen, vergibt dafür eine eigene Rechnungsnummer und setzt das Original auf „nichtig“ bzw. „erstattet“. | Zwei Dokumente, Summe null |
| **Teilstornierung / Korrektur** | Erzeugt eine Korrekturrechnung über den Differenzbetrag mit eigener Nummer. | Original bleibt gültig, Differenz separat belegt |
| **Empfänger ändern** (Adresse vorhanden) | Storniert das Original und stellt eine neue Rechnung mit gleicher Leistung, neuer Nummer und korrigiertem Empfänger aus. Zahlungen und Zahlungsstatus wandern auf das neue Dokument. | Drei Dokumente: Original, Storno, Neuausstellung |
| **Empfänger ergänzen** (keine Adresse hinterlegt) | Ergänzt die Empfängerdaten am bestehenden Beleg und erzeugt ihn neu. | Ein Dokument, kein Storno |
| **Rückerstattung einer Online-Zahlung** | Erstellt die Stornorechnung und stößt die Erstattung über Stripe an. | Storno plus Geldfluss |

Die Verknüpfung bleibt dabei in beide Richtungen erhalten: Die Stornorechnung verweist auf die Nummer der Originalrechnung – im PDF sichtbar und in der E-Rechnung als strukturierte Referenz auf das Vorgängerdokument. Das Original zeigt umgekehrt auf sein Storno.

Die Bedienschritte dazu stehen unter [Rechnung korrigieren oder stornieren](/invoice-corrections).

<Note>
  Eine Ausnahme gibt es beim Empfänger: Ist bisher gar keine Anschrift hinterlegt – etwa bei einer anonymen Buchung – oder steht dort nur ein Name ohne Adresszeilen, lassen sich die Empfängerdaten nachträglich ergänzen und der Beleg wird neu erzeugt. Es entsteht keine Stornorechnung, weil die Leistung, die Beträge und die Nummer unverändert bleiben. Sobald eine vollständige Adresse hinterlegt ist, geht jede weitere Änderung den Weg über Storno und Neuausstellung.
</Note>

## Belege und Archivierung

Beim Festschreiben erzeugt anny zwei Dateien und legt sie unveränderlich ab:

| Datei | Inhalt |
| - | - |
| **PDF** | Der menschenlesbare Beleg mit Positionen, USt-Aufschlüsselung, Zahlungsangaben und – bei Stornos – dem Verweis auf die Originalrechnung. |
| **XML (E-Rechnung)** | Der strukturierte Datensatz nach europäischem Standard (UBL im Peppol-Profil, EN 16931). Stornos werden als Gutschrift mit Vorgängerreferenz ausgegeben. |

Beide Dateien liegen im Objektspeicher und bleiben abrufbar: in der Rechnungsübersicht, über den Downloadlink in der Rechnungs-E-Mail sowie in jedem [Buchhaltungsexport](/accounting). Da die zugrunde liegenden Daten nach dem Festschreiben nicht mehr veränderbar sind, ist der Beleg jederzeit identisch reproduzierbar.

<Warning>
  Festgeschriebene Rechnungen lassen sich nicht löschen – auch nicht auf Wunsch einer Kund:in. Das ist beabsichtigt: Die steuerliche Aufbewahrungspflicht geht dem Löschanspruch aus der DSGVO vor (Art. 17 Abs. 3 lit. b DSGVO). Wie anny mit personenbezogenen Daten umgeht, steht unter [Datenschutz](/data-privacy).
</Warning>

## Übergabe an die Buchhaltung

Für die eigentliche Buchführung übergibt anny die Daten an dein Buchhaltungssystem – festgeschrieben, referenziert und mit Beleg:

* [**DATEV-Buchungsstapel**](/datev-integration) im EXTF-Format: je Geschäftsvorfall ein Buchungssatz, die Rechnungsnummer im Belegfeld 1, eine eindeutige GUID je Buchungssatz. Das Festschreibungskennzeichen steht bewusst auf `0` – die Festschreibung im Sinne der Buchführung nimmt deine Kanzlei nach Sichtung selbst vor.
* [**Kontoauszüge und Belegarchiv**](/accounting): CAMT.053 oder CSV, dazu ein ZIP mit allen Rechnungs-PDFs, einer `receipt-index.csv` für die Zuordnung Transaktion → Beleg und einer Umsatzübersicht nach Steuersätzen.
* [**Automatische Exporte**](/automatic-exports) an E-Mail, SFTP, FTP oder S3 – zum Beispiel monatlich direkt an deine Steuerkanzlei.

<Tip>
  Für den Datenzugriff im Rahmen einer Betriebsprüfung sind die maschinell auswertbaren Exporte der richtige Weg: Buchungsstapel für die Buchungssätze, ZIP-Archiv für die Belege. Beides lässt sich für jeden beliebigen Zeitraum nachträglich erzeugen.
</Tip>

## Grenzen und Abgrenzung

Damit du nichts annimmst, was anny nicht leistet:

* **Kein Kassensystem mit TSE.** anny ist kein elektronisches Aufzeichnungssystem im Sinne der Kassensicherungsverordnung und hat keine zertifizierte technische Sicherheitseinrichtung. Die [POS App](/pos-app-bookings-and-payments) verarbeitet Kartenzahlungen über das Lesegerät, keine Bargeschäfte. Wenn du Bargeld vereinnahmst, brauchst du dafür eine eigene, KassenSichV-konforme Lösung.
* **Kein GoBD-Zertifikat.** Die Finanzverwaltung erteilt keine Positivtestate oder Zertifikate für Software – weder anny noch einem anderen Anbieter. Beurteilt wird immer das konkrete Verfahren beim Steuerpflichtigen, nicht das Produkt.
* **Keine Buchführung.** anny erzeugt Belege und Auswertungen. Gebucht wird in deinem Buchhaltungssystem beziehungsweise bei deiner Kanzlei.
* **Keine Steuerberatung.** Kontenrahmen, Steuersätze, Sonderfälle und Fristen stimmst du mit deiner Steuerkanzlei ab.

## Was das für dich als Betreiber:in bedeutet

| Bringt anny mit | Musst du selbst leisten |
| - | - |
| Festschreibung mit fortlaufender Nummer, unveränderliche Belege | Verfahrensdokumentation für dein Unternehmen, in der anny als eingesetztes Vorsystem beschrieben ist |
| Storno- und Korrekturprozesse, die das Original erhalten | Fachlich richtige Entscheidung, wann storniert und wann korrigiert wird |
| PDF und E-Rechnung je Beleg, jederzeit abrufbar | Aufbewahrung der Belege und Exporte im eigenen Archiv über die gesetzliche Frist |
| Buchungsstapel, Kontoauszüge und Belegarchiv als Export | Import, Prüfung und Festschreibung in der Buchhaltung, Abstimmung des Kontenrahmens |
| Lückenlose Verknüpfung von Buchung, Rechnung, Zahlung und Storno | Umgang mit Bargeld und allem, was außerhalb von anny abgerechnet wird |
| Belege für alle Buchungen, bei denen die Rechnungsstellung aktiv ist | Rechnungsstellung für Buchungen, bei denen du sie in anny bewusst abgeschaltet hast |

<Tip>
  Für Buchungsbelege und Rechnungen gelten in Deutschland derzeit acht Jahre Aufbewahrungsfrist, für Bücher, Inventare und Abschlüsse zehn Jahre. Verlass dich für die Aufbewahrung nicht allein auf deinen anny-Account: Richte einen automatischen Export an dein Archiv oder deine Kanzlei ein, dann liegen Belege und Buchungsdaten dort, wo du sie auch nach einem Systemwechsel brauchst.
</Tip>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ein Admin eine bereits versendete Rechnung nachträglich ändern?">
    Nein. Sobald eine Rechnung festgeschrieben ist, sind Positionen, Beträge, Steuersätze, Datum und Nummer gesperrt – für alle Rollen und über alle Wege, auch über die API. Möglich ist nur der Weg über eine Storno- oder Korrekturrechnung.
  </Accordion>

  <Accordion title="Kann ich eine Rechnung löschen?">
    Entwürfe ja, festgeschriebene Rechnungen nein. Eine ausgestellte Rechnung wird storniert, nicht gelöscht – Original und Storno bleiben beide erhalten.
  </Accordion>

  <Accordion title="Entstehen bei Stornierungen Lücken in den Rechnungsnummern?">
    Nein. Die Originalrechnung behält ihre Nummer und ihren Beleg, die Stornorechnung erhält die nächste freie Nummer desselben Kreises. Beide Dokumente bleiben in der Nummernfolge sichtbar.
  </Accordion>

  <Accordion title="Ist anny GoBD-konform?">
    Konform sein kann immer nur dein Verfahren als Ganzes, nicht eine einzelne Software – die Finanzverwaltung zertifiziert Produkte grundsätzlich nicht. anny setzt die Anforderungen um, die im Vorsystem zu erfüllen sind: unveränderliche Belege, fortlaufende Nummern, revisionssichere Korrekturprozesse und maschinell auswertbare Exporte. Verfahrensdokumentation, Buchführung und Aufbewahrung liegen bei dir.
  </Accordion>

  <Accordion title="Brauche ich eine TSE, wenn ich mit anny abrechne?">
    Für Kartenzahlungen über die POS App nicht – die Kassensicherungsverordnung zielt auf die Aufzeichnung von Bargeschäften. Nimmst du zusätzlich Bargeld an, brauchst du dafür ein eigenes Kassensystem mit zertifizierter technischer Sicherheitseinrichtung.
  </Accordion>

  <Accordion title="Was passiert bei einer Betriebsprüfung?">
    Du stellst die Daten aus deinem Buchhaltungssystem bereit. Aus anny lieferst du dazu die Belege und Buchungsdaten: DATEV-Buchungsstapel und ZIP-Archiv mit allen Rechnungs-PDFs lassen sich für jeden Zeitraum nachträglich erzeugen. Brauchst du Unterstützung bei einer Auswertung, schreib uns an [support@anny.co](mailto:support@anny.co).
  </Accordion>

  <Accordion title="Wie stelle ich sicher, dass keine Rechnung fehlt?">
    Prüfe die Rechnungsübersicht auf offene Entwürfe. Entwürfe sind noch nicht festgeschrieben und erscheinen deshalb in keinem Export. Bei [Sammelrechnungen](/customer-balances-and-collective-invoices) ist das erwartetes Verhalten bis zum Periodenende, bei einzelnen Buchungen ein Hinweis auf eine Rechnung, die noch fertiggestellt werden muss.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * GoBD-Konformität ist IMMER verfahrensbezogen, nie produktbezogen. anny hat KEIN GoBD-Zertifikat und KEIN Positivtestat — die Finanzverwaltung erteilt solche grundsätzlich nicht (GoBD Rz. 179). Niemals ein Zertifikat oder Testat behaupten.
> * Zwei Zustände: Entwurf (keine Nummer, änderbar, löschbar, NICHT in Exporten) und festgeschrieben (Nummer vergeben, PDF + XML erzeugt, unveränderlich, nicht löschbar).
> * Zeitpunkt der Festschreibung hängt an der Zahlungsart der Buchungsoption: Vorab-Online-Zahlung → mit Buchungsabschluss/Zahlung; POS-Kartenzahlung → mit Start des Zahlvorgangs; Pay-Later → zum gewählten Rechnungsdatum (bewusst spät wählbar, z. B. Buchungstermin, damit Änderungen ohne Storno möglich bleiben); Offline-Zahlung → optional mit oder ganz ohne Rechnungsstellung; Sammelrechnung → am Periodenende. Fällige Rechnungen werden von einem stündlichen Lauf festgeschrieben und versendet.
> * Offline-Zahlung mit bewusst deaktivierter Rechnungsstellung: anny erzeugt keinen Beleg und schreibt nichts fest. Annahme ist, dass ein anderes Rechnungssystem im Einsatz ist; die ordnungsgemäße Rechnungsstellung liegt dann vollständig bei der Betreiber:in.
> * Sperre gilt für alle Wege: Oberfläche, JSON:API (Fehler beim Update/Delete festgeschriebener Rechnungen) und interner Adminbereich.
> * Rechnungsnummer: Format `R-B{ORG_ID}-{JJ}-######`. Präfix wird aus der Organisation abgeleitet und ist NICHT manuell änderbar. Zähler wird zum Jahreswechsel auf 0 zurückgesetzt, das Jahr im Präfix trennt die Kreise. Vergabe unter Sperre (keine Doppelvergabe bei paralleler Buchung), Nummern werden nie wiederverwendet.
> * Rechnungen über 0,00 € erhalten keine Nummer und werden nicht festgeschrieben.
> * Korrektur ausschließlich durch neue Dokumente: Stornorechnung (gespiegelte Positionen, eigene Nummer, Original wird nichtig/erstattet), Teilstorno/Korrekturrechnung (Differenzbetrag), Neuausstellung bei Empfängerwechsel (Storno + neue Rechnung, Zahlungen wandern mit).
> * Ausnahme bei Empfängerdaten: Ist keine Anschrift hinterlegt (anonyme Buchung) oder nur ein Name ohne Adresszeilen, können die Empfängerdaten nachträglich ergänzt werden — der Beleg wird neu erzeugt, es entsteht KEINE Stornorechnung (Leistung, Beträge und Nummer bleiben unverändert). Bei bereits vollständiger Adresse immer Storno + Neuausstellung.
> * Belege: PDF + E-Rechnung als UBL im Peppol-Profil (EN 16931); Stornos als Gutschrift mit strukturierter Referenz auf die Originalrechnung.
> * Exporte: DATEV-Buchungsstapel EXTF (Rechnungsnummer in Belegfeld 1, GUID je Buchungssatz, Festschreibungskennzeichen 0 — Kanzlei schreibt selbst fest), CAMT.053/CSV + ZIP mit receipts/, receipt-index.csv, revenue-summary.pdf.
> * KEINE TSE / kein elektronisches Aufzeichnungssystem nach KassenSichV. POS App verarbeitet nur Kartenzahlungen, keine Bargeschäfte.
> * Festgeschriebene Rechnungen werden auch bei DSGVO-Löschverlangen nicht gelöscht (Art. 17 Abs. 3 lit. b DSGVO).
> * Aufbewahrungsfristen DE: derzeit 8 Jahre für Rechnungen und Buchungsbelege, 10 Jahre für Bücher, Inventare und Abschlüsse. Immer an die Steuerkanzlei verweisen.
> * Verantwortungsteilung: anny liefert unveränderliche Belege und Exporte; Betreiber:in verantwortet Verfahrensdokumentation, Buchführung, Aufbewahrung, Kontenrahmen und Bargeldprozesse.
> * Verwandte Artikel: Rechnungsstellung, Rechnungsentwurf, Rechnung korrigieren, Buchhaltung mit anny, DATEV, Kundensalden & Sammelrechnungen, Datenschutz.


# Google Kalender mit anny verbinden
Source: https://docs.anny.co/google

Synchronisiere Buchungen und Termine zwischen anny und deinem persönlichen Google Kalender in Echtzeit.

[Google Kalender](https://calendar.google.com) ist der Kalenderdienst von Google. Mit der Integration verbindest du eine Ressource in anny mit einem Kalender deines persönlichen Google-Kontos und hältst beide Seiten automatisch synchron (2-Wege-Synchronisation).

Mit Google Kalender kannst du in anny:

* Buchungen deiner Ressource automatisch als Termine in deinem Google Kalender anlegen
* Termine aus deinem Google Kalender als Blocker oder Buchungen in anny übernehmen und Doppelbuchungen vermeiden
* Auf Wunsch für Buchungen automatisch ein Google Meet erstellen und die Kund:in einladen

Besonders praktisch ist die Integration, wenn du oder deine Teammitglieder persönliche Kalender pflegen und die Verfügbarkeit einer Ressource beides berücksichtigen soll, z. B. bei Beratungsterminen, Coachings oder personengebundenen Räumen. Einen Vergleich aller Kalender-Integrationen findest du im Übersichtsartikel [Kalenderintegrationen](/calendar-integrations).

<Info>
  Die Kalendersynchronisation muss in deinem anny Plan enthalten sein, sonst bleibt der Button **Google Kalender verbinden** ausgegraut.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Beratungs- und Coachingtermine | **Buchungen landen automatisch im persönlichen Kalender.** Berater:innen sehen alle anny Buchungen in ihrem Google Kalender, ohne anny öffnen zu müssen. |
| Verfügbarkeit aus dem Kalender übernehmen | **Private Termine blockieren die Ressource automatisch.** Ein Termin im Google Kalender erzeugt einen Blocker in anny, die Zeit ist dann nicht mehr buchbar. |
| Online-Meetings mit Google Meet | **Jede Buchung erhält automatisch einen Meeting-Link.** anny erstellt ein Google Meet und lädt die Kund:in ein, der Link ist in den Buchungsdetails abrufbar. |

## Wie die Google Kalender-Verbindung funktioniert

Die Verbindung wird über den Login mit deinem Google-Konto hergestellt (**Über Google anmelden**). anny erhält dabei Zugriff auf deine Kalenderliste (nur lesen) und auf die Termine der Kalender (lesen und schreiben). Andere Google-Daten wie E-Mails oder Kontakte liest anny nicht. Widerrufst du den Zugriff in deinem Google-Konto, stoppt die Synchronisation: Die Integration zeigt ein Warnsymbol und bietet **Erneut autorisieren** an.

Synchronisiert wird in beide Richtungen und in Echtzeit:

| Daten | Richtung | Häufigkeit |
| :- | :- | :- |
| Alle zukünftigen Termine und Buchungen (Erst-Import) | beide Richtungen | einmalig beim Aktivieren |
| Buchungen der Ressource als Termine | anny → Google Kalender | sofort bei Erstellung, Änderung und Stornierung |
| Termine als Blocker oder Buchungen | Google Kalender → anny | sofort per Push-Benachrichtigung |

anny synchronisiert dabei den Zeitraum von heute bis rund 13 Monate in die Zukunft; er verlängert sich automatisch jeden Monat. Wird eine Buchung in anny abgesagt oder abgelehnt, löscht anny den zugehörigen Termin. Wird umgekehrt ein Termin in Google gelöscht, entfernt anny den Blocker bzw. storniert die daraus entstandene Buchung. Jede Sync-Aktion wird im Aktivitätsprotokoll der Buchung dokumentiert, und in den Buchungsdetails zeigt der Abschnitt **Kalender-Synchronisation** Konto, Kalender und Herkunft der Verknüpfung.

## Google Kalender verbinden

### Voraussetzungen

Bevor du Google Kalender verbindest, stelle sicher, dass du Folgendes hast:

* Ein Google-Konto mit Zugriff auf den gewünschten Kalender (für fremde Kalender brauchst du Schreibzugriff, nur diese erscheinen in der Auswahl)
* Bearbeitungsrechte für die Ressource in deinem anny Account
* Einen anny Plan, der die Kalendersynchronisation enthält
* Die Ressource ist nicht bereits über die Google Workspace-Integration verbunden

### Verbindung einrichten

<Steps>
  <Step title="Einrichtung starten">
    Öffne aus der Menüleiste die **Ressourcen**, wähle deine Ressource und gehe zum Reiter **Integrationen**. Klicke im Abschnitt **Persönliche Kalender-Integrationen** auf **Google Kalender verbinden**.
  </Step>

  <Step title="Autorisieren">
    Klicke auf **Über Google anmelden**, wähle dein Google-Konto und bestätige den Zugriff. Nach erfolgreichem Login zeigt anny „Erfolgreich authentifiziert".
  </Step>

  <Step title="Kalender wählen">
    Wähle im Feld **Kalender** den Kalender, der mit der Ressource synchronisiert werden soll. Dein Hauptkalender ist vorausgewählt. Du kannst auch einen eigenen Unterkalender in deinem Google-Konto für genau diese Integration anlegen.
  </Step>

  <Step title="Einstellungen anpassen und starten">
    Passe die Einstellungen an (siehe unten) und klicke auf **Sync starten**.
  </Step>
</Steps>

Sobald die Integration aktiv ist, importiert anny zunächst alle zukünftigen Termine und Buchungen. Danach werden alle Änderungen in Echtzeit synchronisiert.

<Tip>
  Lege für die Integration einen eigenen Unterkalender in deinem Google-Konto an. So bleiben synchronisierte Buchungen sauber von deinen privaten Terminen getrennt.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Aktive Buchungsoptionen auswählen | Termine werden nur für Buchungen der ausgewählten Buchungsoptionen erstellt. Ohne Auswahl gilt **Alle Buchungsoptionen**. |
| Titel der Termine in Google Kalender | Bestimmt den Termin-Titel: **Titel der Buchung**, **Buchungsnummer**, **Name der Ressource**, **Name des Services** oder **Name der Ressource und der Buchungsoption**. |
| Titel der Buchungen in anny | Bestimmt den Titel übernommener Termine: **Titel der Veranstaltung** oder **Anonymisiert**. Als privat gekennzeichnete Termine werden immer anonymisiert. |
| Vor- und Nachbereitungszeit hinzufügen | Verlängert den Termin um die Vor- und Nachbereitungszeit der Buchung. Beispiel: 30 Minuten Buchung mit 15 Minuten Vorbereitungszeit ergeben einen Termin von 45 Minuten. |
| Alle Ereignisse synchronisieren | Übernimmt auch Termine, die in Google den Status „Verfügbar" haben. Andernfalls werden nur Termine übernommen, die als „Beschäftigt" gelten. |
| Termine als Blocker anlegen | Übernommene Termine werden als Blocker angelegt (Standard). Schaltest du die Option aus, entstehen stattdessen bestätigte Buchungen mit dem gewählten Standardservice. |
| Standardservice für Buchungen | Die Buchungsoption, mit der aus Terminen Buchungen erstellt werden. Die Kund:in ermittelt anny aus dem Termin-Organisator und legt sie bei Bedarf neu an. |
| Bestehende Blocker in Buchungen umwandeln | Erscheint beim Umschalten vom Blocker- in den Buchungs-Modus. Wandelt zukünftige, früher aus Terminen erstellte Blocker einmalig in Buchungen um, sobald du speicherst und aktivierst. |
| Google Meet zum Termin hinzufügen | Erstellt für synchronisierte Buchungen ein Google Meet und lädt die Kund:in als Gast ein. Mit **Für ausgewählte Buchungsoptionen** kannst du das auf einzelne Buchungsoptionen begrenzen. |

<Tip>
  Eine Verbindung auf einer übergeordneten Ressource gilt automatisch auch für Buchungen ihrer Unterressourcen. Du musst nicht jede Unterressource einzeln verbinden.
</Tip>

## Einschränkungen

Die Google Kalender-Integration unterstützt nicht:

* **Vergangene Termine:** Synchronisiert wird nur ab dem heutigen Tag, bis rund 13 Monate in die Zukunft. Vergangene Einträge werden nie importiert.
* **Serien als Ganzes:** Serientermine werden als einzelne Termine bzw. einzelne Buchungen synchronisiert, ohne Verknüpfung der Serie.
* **Einladungs-E-Mails durch Google:** anny legt Termine ohne Google-Benachrichtigungen an. Gäste werden nur eingetragen, wenn **Google Meet zum Termin hinzufügen** aktiv ist.
* **Kalenderwechsel im Nachhinein:** Der Kalender wird nur beim Einrichten gewählt. Für einen anderen Kalender löschst du die Verbindung und richtest sie neu ein.
* **Parallelbetrieb mit Google Workspace:** Eine Ressource, die bereits über die Google Workspace-Integration verbunden ist, kann nicht zusätzlich mit einem persönlichen Google Kalender verbunden werden.
* **Fremde Termine bearbeiten:** Bist du bei einem übernommenen Termin nur eingeladen (nicht Organisator:in), ist die entstandene Buchung in anny schreibgeschützt.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, stoppt die Synchronisation sofort in beide Richtungen. Bereits synchronisierte Termine, Buchungen und Blocker bleiben bestehen. Beim Löschen entfernt anny dagegen die erstellten Synchronisierungen: Von anny erstellte Termine werden aus deinem Google Kalender gelöscht, aus Terminen entstandene Buchungen und Blocker aus anny entfernt. Du wählst dabei zwischen **Nur zukünftige Synchronisierungen** und **Alle Synchronisierungen (einschließlich vergangene)**.
</Warning>

Beides findest du in den Einstellungen deiner Ressource unter **Integrationen**: Deaktivieren über den **Toggle** in der Integrationszeile, Löschen über die **drei Punkte** → **Löschen**.

## FAQ

<AccordionGroup>
  <Accordion title="Kann ich mehrere Google Kalender mit einer Ressource verbinden?">
    Ja. Du kannst mehrere Verbindungen anlegen, z. B. die Kalender mehrerer Teammitglieder. Nur die exakt gleiche Kombination aus Konto und Kalender kann pro Ressource nicht doppelt verbunden werden.
  </Accordion>

  <Accordion title="Was passiert mit privaten Terminen aus meinem Kalender?">
    Termine, die in Google als privat oder vertraulich markiert sind, übernimmt anny immer anonymisiert mit dem Titel „Nicht verfügbar". Das gilt unabhängig von der Einstellung **Titel der Buchungen in anny**.
  </Accordion>

  <Accordion title="Werden Teilnehmer:innen zu den Terminen eingeladen?">
    Nur wenn **Google Meet zum Termin hinzufügen** aktiv ist: Dann trägt anny die Kund:in und die Teilnehmer:innen der Buchung als Gäste ein. Google verschickt dabei keine Einladungs-E-Mails. Umgekehrt übernimmt anny Gäste eines Termins samt Zu- oder Absage als Teilnehmer:innen der Buchung, wenn Termine als Buchungen synchronisiert werden.
  </Accordion>

  <Accordion title="Kann ich Termine als richtige Buchungen statt als Blocker übernehmen?">
    Ja. Schalte **Termine als Blocker anlegen** aus und wähle einen **Standardservice für Buchungen**. Neue Termine werden dann als bestätigte Buchungen angelegt, die Kund:in ermittelt anny aus dem Termin-Organisator. Bestehende Blocker wandelst du mit **Bestehende Blocker in Buchungen umwandeln** um.
  </Accordion>

  <Accordion title="Woran erkenne ich, ob eine Buchung synchronisiert wurde?">
    In den Buchungsdetails zeigt der Abschnitt **Kalender-Synchronisation** das verbundene Konto, den Kalender und ob die Buchung aus einem Termin entstand oder der Termin aus der Buchung. Zusätzlich protokolliert das Aktivitätsprotokoll jede Erstellung, Änderung und Löschung durch die Integration.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Termine aus meinem Google Kalender erscheinen nicht in anny">
    Häufigste Ursache: Der Termin hat in Google den Status „Verfügbar" und die Einstellung **Alle Ereignisse synchronisieren** ist aus. Prüfe außerdem, ob der Termin in der Zukunft und innerhalb der nächsten rund 13 Monate liegt, ob der richtige Kalender verbunden ist und ob die Integration aktiv ist (Toggle in der Integrationszeile).
  </Accordion>

  <Accordion title="Beim Aktivieren erscheint die Meldung „Doppelte Integration“">
    Für diese Ressource existiert bereits eine Verbindung mit demselben Konto und Kalender, oder die Ressource ist über die Google Workspace-Integration verbunden. Entferne eine der beiden Verbindungen und aktiviere danach erneut.
  </Accordion>

  <Accordion title="Die Integration zeigt ein Warnsymbol oder hat sich selbst deaktiviert">
    Ursache ist meist ein widerrufener Google-Zugriff, ein nicht mehr erreichbarer Kalender oder fehlender Schreibzugriff. Klicke in der Integrationszeile auf **Erneut autorisieren** und melde dich neu an. Prüfe bei fremden Kalendern, ob dein Konto weiterhin Schreibzugriff hat, und aktiviere die Integration anschließend wieder. Beim Aktivieren gleicht anny alle Daten automatisch neu ab.
  </Accordion>

  <Accordion title="Eine aus einem Termin entstandene Buchung lässt sich nicht bearbeiten">
    Die Buchung stammt aus einem Termin, bei dem das verbundene Konto nur eingeladen ist. Solche Buchungen sind in anny schreibgeschützt. Änderungen nimmt die Organisator:in im Google Kalender vor, anny übernimmt sie automatisch.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Dieser Artikel behandelt die Integration „Google Kalender" (persönlicher Kalender eines einzelnen Google-Kontos, pro Ressource eingerichtet). Sie ist NICHT die Google Workspace-Integration (zentrale Verbindung von Workspace-Ressourcenkalendern, eigener Artikel google-workspace). Beide schließen sich pro Ressource gegenseitig aus. Übersicht und Vergleich: Artikel kalenderintegrationen.
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Ressourcen** → Ressource → Reiter **Integrationen** → Abschnitt „Persönliche Kalender-Integrationen" → Button „Google Kalender verbinden". Setup-Modal-Schritte: „Autorisiere deine Integration" (Button „Über Google anmelden"), „Wähle einen Kalender" (Feld „Kalender"), „Anpassen der Einstellungen", Abschluss „Sync starten". Einstellungen später über das Zahnrad-Symbol in der Integrationszeile. Drei-Punkte-Menü: „Integration aktivieren", „Integration deaktivieren", „Löschen", „Verbindung testen". Buchungsdetails: Abschnitt „Kalender-Synchronisation" mit Aktionen „Ereignis im externen Kalender anzeigen" und „Kalender neu synchronisieren".
>
> **Quirks:** (1) Sync-Status der Buchung: auch angefragte und eingeladene Buchungen erzeugen bereits Termine; reservierte (im Checkout) nicht; bei Absage/Ablehnung/Stornierung wird der Termin gelöscht. (2) Termin in Google gelöscht: Blocker werden gelöscht, Buchungen storniert (nicht gelöscht). (3) Wechselt ein Termin nachträglich auf Status „Verfügbar", wird der zugehörige Blocker entfernt (sofern „Alle Ereignisse synchronisieren" aus ist). (4) Ganztägige Termine werden 00:00 bis 00:00 in der Zeitzone der Ressource übernommen. (5) Termin-Beschreibung in Google enthält Ressource/Buchungsoption und bei echten Buchungen Kundenname, E-Mail und Add-ons; bei Blockern nur Ressource/Buchungsoption. (6) Wird der Standardservice gelöscht, fällt die Integration automatisch in den Blocker-Modus zurück. (7) Beim Löschen der Integration gibt es die Auswahl „Nur zukünftige Synchronisierungen" / „Alle Synchronisierungen (einschließlich vergangene)"; schlägt das Aufräumen fehl, wird das Löschen abgebrochen und Admins benachrichtigt. (8) Erneutes Aktivieren startet immer einen vollständigen Neuabgleich. (9) Während des Initial-Syncs zeigt die Integrationszeile einen Lade-Spinner und Aktionen sind blockiert. (10) In der Kalenderauswahl erscheinen nur Kalender mit Schreibzugriff; der Hauptkalender ist vorausgewählt. (11) Serienbuchungen aus anny: nur die einzelnen Serien-Elemente werden synchronisiert, der Serien-Kopf nicht.
>
> **Beziehungen:** Plan-Gating über das Feature Kalendersynchronisation (gleiche Freischaltung wie Outlook, Microsoft 365 Workspace und Google Workspace). Aktivitätsprotokoll-Texte: „Es wurde ein Termin für diese Buchung erstellt/aktualisiert/entfernt.", „Diese Buchung wurde durch die Google Kalender Integration geändert". Fehlerfall „Kalender nicht erreichbar": Selbst-Deaktivierung plus Benachrichtigung an Admins; Reaktivierung nach Behebung möglich.


# Google Analytics & Google Ads mit anny verbinden
Source: https://docs.anny.co/google-analytics

Miss Seitenaufrufe, Warenkorb und Buchungsabschlüsse deiner anny Buchungsseiten in Google Analytics und Google Ads.

[Google Analytics](https://analytics.google.com) ist Googles Werkzeug zur Webanalyse: Es zeigt dir, wie viele Menschen deine Seiten besuchen und welche Schritte sie bis zur Buchung gehen. Mit der Integration **Google Ads & Analytics** lädt anny dein Google-Tag auf deinen öffentlichen Buchungsseiten und meldet dort die wichtigsten Buchungsereignisse an deine Google-Analytics-4-Property. Optional gibt anny dieselben Abschlüsse zusätzlich als Conversions an Google Ads weiter.

Mit Google Ads & Analytics kannst du in anny:

* Seitenaufrufe und den Weg von der Buchungsseite bis zum Abschluss in Google Analytics auswerten
* Umsätze aus abgeschlossenen Buchungen als `purchase`-Ereignis nach Google Analytics melden
* Buchungsbestätigungen als Google Ads Conversions zählen und deinen Kampagnen zuordnen

Das ist praktisch, wenn du deine Buchungsseiten bewirbst und wissen willst, welche Kanäle und Kampagnen tatsächlich zu Buchungen führen.

<Info>
  Diese Integration erscheint nur, wenn für deinen Account Marketing-Integrationen freigeschaltet sind. Fehlt sie in deiner Übersicht **Integrationen**, wende dich an das anny Team.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Kampagnen-Erfolg messen | **Du siehst, welche Anzeige oder Quelle zu echten Buchungen führt.** Google Analytics ordnet die `purchase`-Ereignisse deinen Besuchsquellen zu, statt nur Klicks zu zählen. |
| Buchungs-Funnel verstehen | **Du erkennst, wo Besucher:innen abspringen.** anny meldet Seitenaufruf, Warenkorb und Checkout-Start, sodass du die Schritte bis zur Buchung nachvollziehst. |
| Google Ads Conversions zählen | **Deine Google-Ads-Kampagnen erhalten die Buchungsabschlüsse als Conversion.** So optimierst du Gebote und Budget auf tatsächliche Buchungen statt auf Klicks. |

## Wie die Google-Analytics-Verbindung funktioniert

Es gibt keine Anmeldung bei Google. Du trägst in anny nur deine **GA4 Mess-ID** ein (Format `G-XXXXXXXXXX`), optional dazu deine Google-Ads-Conversion-Aktionen. anny speichert diese Kennungen und lädt damit im Browser deiner Besucher:innen das Google-Tag. anny bekommt keinen Zugriff auf dein Google-Konto, und aus Google fließen keine Daten zurück nach anny.

Gemessen wird ausschließlich im Browser deiner Besucher:innen, und nur nach deren Zustimmung:

* Das Google-Tag wird erst geladen, nachdem Besucher:innen im Cookie-Banner die Kategorie **Marketing** akzeptiert haben. Ohne Zustimmung lädt anny kein Skript von Google und sendet kein Ereignis.
* Die Option **Marketing** erscheint im Cookie-Banner nur, solange eine Tracking-Integration aktiv ist. Aktivierst du diese Integration, kommt auf deinen Buchungsseiten also eine zusätzliche Auswahl im Banner hinzu.
* Widerruft jemand die Marketing-Zustimmung, sendet anny ab diesem Moment keine weiteren Ereignisse mehr.
* Stimmt jemand erst auf der Bestätigungsseite zu, sendet anny den Buchungsabschluss nachträglich.

anny meldet vier Ereignisse an Google Analytics: Seitenaufruf (`page_view`), Buchung in den Warenkorb gelegt (`add_to_cart`), Checkout gestartet (`begin_checkout`) und Buchung abgeschlossen (`purchase`). Übergeben werden der Netto-Betrag als Wert, der Steuerbetrag, die Währung (Standard EUR), die Bestellnummer als Transaktions-ID und die Rechnungspositionen mit Bezeichnung, Menge und Netto-Einzelpreis. anny sendet keine Namen, E-Mail-Adressen, Adressen oder Buchungszeiten an Google. Google selbst erhält beim Laden des Tags zusätzlich die üblichen technischen Daten wie IP-Adresse, Gerät, Browser und Seiten-URL.

<Warning>
  Der Wert in Google Analytics ist der Netto-Umsatz, die Steuer wird separat übergeben. Erwartest du Brutto-Zahlen, siehst du in Google deshalb niedrigere Umsätze als in deinen anny Berichten.
</Warning>

## Google Ads & Analytics verbinden

### Voraussetzungen

Bevor du die Integration einrichtest, stelle sicher, dass du Folgendes hast:

* Admin-Rechte in deinem anny Account und freigeschaltete Marketing-Integrationen
* Eine Google-Analytics-4-Property mit ihrer **GA4 Mess-ID** (Format `G-XXXXXXXXXX`)
* Optional: ein Google-Ads-Konto mit angelegten Conversion-Aktionen, jeweils mit **Conversion ID** und **Conversion label**
* Ein aktives Cookie-Banner auf deinen Buchungsseiten, damit Besucher:innen der Kategorie **Marketing** zustimmen können

### Verbindung einrichten

<Steps>
  <Step title="Integration öffnen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Google Ads & Analytics**.
  </Step>

  <Step title="Mess-ID eintragen">
    Trage im Bereich **Google Analytics (GA4)** deine **GA4 Mess-ID** im Format `G-XXXXXXXXXX` ein. Die Mess-ID ist Pflicht, ohne sie lässt sich die Integration nicht aktivieren.
  </Step>

  <Step title="Optional: Conversions anlegen">
    Willst du zusätzlich Google Ads Conversions zählen, klicke im Bereich **Google Ads Conversion Tracking (optional)** auf **Conversion-Aktion hinzufügen** und lege je Aktion **Event Typ**, **Conversion ID** und **Conversion label** fest. Du kannst mehrere Aktionen anlegen, auch mehrere für denselben **Event Typ**.
  </Step>

  <Step title="Prüfen und speichern">
    Klicke auf **Verbindung testen** und dann auf Speichern. Aktiviere die Integration anschließend über den **Toggle** oben rechts.
  </Step>
</Steps>

Sobald die Integration aktiv ist, lädt anny das Google-Tag auf deinen öffentlichen Buchungsseiten und meldet die Buchungsereignisse an Google, sobald Besucher:innen der Kategorie **Marketing** zugestimmt haben.

<Tip>
  **Verbindung testen** meldet bereits Erfolg, sobald eine Mess-ID gespeichert ist. Es prüft nicht, ob die Mess-ID existiert oder ob Daten in Google ankommen. Ob Ereignisse eintreffen, siehst du nur in Google Analytics, etwa im Echtzeit-Bericht oder in der DebugView.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| GA4 Mess-ID | Deine Google-Analytics-4-Property im Format `G-XXXXXXXXXX`. Es gibt genau ein Feld, also genau eine Property pro anny Account. Pflichtfeld. |
| Google Ads Conversion Tracking (optional) | Liste von Conversion-Aktionen mit den Spalten **Event Typ**, **Conversion ID** und **Conversion label**. Passt der **Event Typ** zum eingetretenen Ereignis, sendet anny zusätzlich zum Google-Analytics-Ereignis ein Conversion-Event an Google Ads. Ohne GA4 Mess-ID funktioniert das nicht. |
| Verbindung testen | Bestätigt, dass eine Mess-ID gespeichert ist. Keine Prüfung bei Google. |
| Änderungen | **GA4 Mess-ID** und die Conversion-Tabelle sind gesperrt, solange die Integration aktiv ist. Zum Ändern: deaktivieren, ändern, speichern, wieder aktivieren. |

## Einschränkungen

Die Integration Google Ads & Analytics unterstützt nicht:

* **Serverseitige Messung:** anny sendet keine Daten von Server zu Server an Google. Es gibt keine Offline-Conversions. Wird das Tag blockiert (fehlende Zustimmung, Adblocker, Browser-Schutz), fehlt die Conversion.
* **Messung im eingebetteten Widget:** In eingebetteten Widgets lädt anny kein Google-Tag, weil dort kein Cookie-Banner erscheint. Das Widget gibt die Ereignisse stattdessen an die umgebende Website weiter, die sie mit ihrem eigenen Google-Tag verarbeiten kann (siehe [Widget-Einbettung für Fortgeschrittene](/widget-embed-advanced)).
* **Mehrere Properties:** Es gibt genau ein Mess-ID-Feld, also nur eine GA4-Property pro Account.
* **Automatische Seitenaufrufe:** Googles automatische Seitenmessung ist abgeschaltet. anny sendet `page_view` nur auf den öffentlichen Buchungsseiten, nicht bei jedem Schritt im Buchungsfluss.
* **Erfolgskontrolle in anny:** anny protokolliert nur, wann die Integration aktiviert oder deaktiviert wurde. Ob Ereignisse ankommen, siehst du ausschließlich in Google Analytics.

## Verbindung trennen

<Warning>
  Deaktivierst du die Integration, entfernt anny das Google-Tag von deinen öffentlichen Buchungsseiten, und es werden keine Ereignisse mehr gesendet. Löschen entfernt die gespeicherten Kennungen. Deaktiviere die Integration deshalb immer zuerst und lösche sie erst danach, damit auf deinen Seiten kein Tracking zurückbleibt.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Warum sind die Zahlen in Google niedriger als in anny?">
    Dafür gibt es zwei Gründe. Erstens misst anny nur bei Besucher:innen, die im Cookie-Banner der Kategorie **Marketing** zugestimmt haben. Wer ablehnt oder das Tag blockiert (Adblocker, Browser-Schutz), taucht in Google nicht auf. Zweitens meldet anny den Netto-Umsatz, während deine anny Berichte auch die Steuer enthalten.
  </Accordion>

  <Accordion title="Kann ich mehrere Google-Analytics-Properties gleichzeitig messen?">
    Nein. Es gibt genau ein Feld für die **GA4 Mess-ID**, also eine Property pro anny Account. Mehrere Google Ads Conversion-Aktionen sind dagegen möglich.
  </Accordion>

  <Accordion title="Wird auch im eingebetteten Widget gemessen?">
    Nein, dort lädt anny kein Google-Tag. Das Widget reicht die Ereignisse an die umgebende Website weiter, die sie mit ihrem eigenen Google-Tag auswerten kann. Wie das geht, steht in [Widget-Einbettung für Fortgeschrittene](/widget-embed-advanced).
  </Accordion>

  <Accordion title="Muss ich mich bei Google anmelden oder ein Konto verbinden?">
    Nein. Du trägst nur deine **GA4 Mess-ID** und optional deine Conversion-Aktionen ein. Es gibt keinen Login und keinen Zugriff auf dein Google-Konto.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="In Google Analytics kommen keine Daten an">
    Häufigste Ursache: Die Integration ist nicht aktiviert oder Besucher:innen haben der Kategorie **Marketing** nicht zugestimmt. Prüfe, ob der **Toggle** der Integration aktiv ist, und teste selbst mit angenommenem Cookie-Banner. Kontrolliere die Ankunft im Echtzeit-Bericht oder in der DebugView von Google Analytics, nicht über **Verbindung testen**.
  </Accordion>

  <Accordion title="Die Option Marketing fehlt im Cookie-Banner">
    Die Kategorie **Marketing** erscheint nur, solange eine Tracking-Integration aktiv ist. Aktiviere die Integration über den **Toggle**. Erscheint die Option danach immer noch nicht, wende dich an das anny Team, denn dann ist das Tracking auf deinen öffentlichen Seiten möglicherweise plattformseitig nicht freigeschaltet.
  </Accordion>

  <Accordion title="Ich kann die Mess-ID oder eine Conversion nicht ändern">
    Die Felder sind gesperrt, solange die Integration aktiv ist. Deaktiviere sie zuerst über den **Toggle**, ändere die **GA4 Mess-ID** oder die Conversion-Aktion, speichere und aktiviere die Integration wieder.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Reines Browser-Tracking über das Google-Tag (gtag), rein clientseitig. Kein Server-zu-Server-Versand, keine Offline-Conversions, kein serverseitiger Nachtrag. Die Integration greift NICHT auf Google-Konten zu (kein OAuth, kein Login); es werden nur die eingetragenen Kennungen im Browser verwendet, aus Google fließen keine Daten zurück. Nicht zu verwechseln mit der UTM-Attribution: Kampagnen-Parameter (utm\_\*, gclid) aus der Aufruf-URL wertet anny separat und unabhängig von dieser Integration und von der Cookie-Zustimmung aus.
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **Google Ads & Analytics**. Bereich **Google Analytics (GA4)** mit Pflichtfeld **GA4 Mess-ID** (`G-XXXXXXXXXX`). Bereich **Google Ads Conversion Tracking (optional)** mit Button **Conversion-Aktion hinzufügen** und Tabelle mit Spalten **Event Typ**, **Conversion ID**, **Conversion label**. Aktion **Verbindung testen**. Aktivieren/Deaktivieren: **Toggle** oben rechts; Löschen: **drei Punkte** → **Löschen**. anny protokolliert nur den Aktivierungsverlauf (aktiviert/deaktiviert), kein Ereignisprotokoll.
>
> **Quirks:** (1) **Verbindung testen** bestätigt nur, dass eine Mess-ID gespeichert ist, es findet keine Prüfung bei Google statt. (2) GA4 Mess-ID ist Pflicht; Google-Ads-Conversions funktionieren nur zusammen mit einer GA4 Mess-ID, nie allein. (3) Genau eine GA4-Property pro Account (ein Feld), aber beliebig viele Conversion-Aktionen, auch mehrere für denselben Event Typ (feuern alle). (4) Gemessene Seiten: öffentliche Buchungsseiten von Ressourcen/Services, Organisations-Übersicht, Abo-/Buchungspaket-Seiten, Checkout, Bestätigungsseite; kein Tracking im Adminbereich. (5) Googles automatische page\_view-Messung ist deaktiviert; page\_view feuert nur auf den genannten Seitentypen. (6) Vier Ereignisse: page\_view, add\_to\_cart, begin\_checkout, purchase. (7) Übergebene Daten: Netto-Betrag als Wert, Steuerbetrag, Währung (Standard EUR), Bestellnummer als Transaktions-ID, Rechnungspositionen (Bezeichnung, Menge, Netto-Einzelpreis); ohne Positionen eine Sammelposition „anny Booking". Keine personenbezogenen Daten (Name, E-Mail, Adresse, Buchungszeit) an Google. (8) Umsatz = netto; Erwartung von Brutto-Zahlen führt zu scheinbar niedrigeren Werten. (9) Aufträge über mehrere Organisationen: pro Organisation ein eigenes Abschluss-Event an die jeweils dort hinterlegte Mess-ID. (10) Felder GA4 Mess-ID und Conversion-Tabelle sind bei aktiver Integration gesperrt.
>
> **Cookie-Consent:** Das Google-Tag lädt erst nach Zustimmung zur Cookie-Kategorie **Marketing**. Die Kategorie erscheint im Banner nur, solange eine Tracking-Integration aktiv ist. Widerruf stoppt weitere Ereignisse ab sofort. Zustimmung erst auf der Bestätigungsseite lässt den purchase nachträglich zu. Zusätzlich existiert ein plattformseitiger Schalter für das Tracking auf öffentlichen Seiten; ist er aus, erscheint Marketing nicht im Banner und es wird trotz aktiver Integration nicht gemessen (Support-relevant).
>
> **Beziehungen:** Feature-Gating über „Marketing-Integrationen"; die Integration erscheint nur bei freigeschaltetem Feature (Plan-Zuordnung liegt in der DB, kein fixer Plan-Name im Artikel). Im eingebetteten Widget kein anny Google-Tag; das Widget reicht Ereignisse (view-page, add-to-cart, start-checkout, complete-checkout inkl. Betrag, Währung, Bestellnummer, Positionen) an die Host-Seite weiter, GA4-Beispiel in `widget-einbettung-advanced.mdx`. Verwandte Artikel: UTM-Tracking (`utm-tracking.mdx`, verlinkt diese Integration teils als „Google Ads einrichten"), Datenschutz. In anny heißt die Integration **Google Ads & Analytics**; der Artikel-Slug ist `google-analytics`, Nav-Gruppe „Marketing & Tracking".


# Google Workspace mit anny verbinden
Source: https://docs.anny.co/google-workspace

Verbinde die Ressourcenkalender deiner Google Workspace Organisation mit anny und halte Buchungen automatisch synchron.

[Google Workspace](https://workspace.google.com) ist Googles Produktivitätsplattform für Unternehmen mit Gmail, Google Kalender und verwalteten Ressourcen wie Konferenzräumen. Die Integration verbindet die Ressourcen-Kalender deiner Workspace-Organisation mit Ressourcen in anny und hält beide Seiten in einer Zwei-Wege-Synchronisation aktuell.

Mit Google Workspace kannst du in anny:

* Buchungen automatisch als Termine in den Ressourcen-Kalendern deiner Räume anlegen
* Termine aus Google Kalender als Blocker oder Buchungen in anny übernehmen und so Doppelbuchungen vermeiden
* synchronisierten Terminen optional ein Google Meet anhängen

Besonders praktisch ist die Integration, wenn deine Räume sowohl über anny als auch direkt in Google Kalender gebucht werden, z. B. Meetingräume, die Mitarbeitende intern über Google und Externe über deine anny Buchungsseite reservieren. Sie wird einmal zentral von deiner IT bzw. deinem Workspace-Admin eingerichtet; einzelne Mitarbeitende müssen ihre Kalender nicht selbst verbinden. Für persönliche Kalender einzelner Nutzer:innen gibt es eigene Integrationen, ein Überblick steht im Artikel zu den Kalenderintegrationen.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Meetingräume doppelt buchbar machen | **Ein Raum, zwei Buchungswege ohne Konflikte.** Kolleg:innen laden den Raum wie gewohnt in Google Kalender ein, Kund:innen buchen über anny. Beide Seiten sehen sofort, wann der Raum belegt ist. |
| Bestehende Raumverwaltung übernehmen | **Termine aus Google erscheinen als Blocker in anny.** Du führst anny ein, ohne die gewohnte Google-Raumbuchung abzuschalten: Bestehende und neue Google-Termine blockieren die Ressource automatisch. |
| Hybride Meetings | **Buchungen erzeugen Termine mit Google Meet.** Für ausgewählte Buchungsoptionen hängt anny dem Termin ein Google Meet an und trägt Teilnehmer:innen als Gäste ein. |

## Wie die Google Workspace-Verbindung funktioniert

Die Verbindung läuft über ein Google-**Dienstkonto** mit domänenweiter Delegation. Du lädst den JSON-Schlüssel des Dienstkontos in anny hoch und legst einen Workspace-Nutzer fest, in dessen Namen die Integration handelt. anny greift damit ausschließlich auf zwei Dinge zu: die Liste deiner Workspace-Ressourcen (nur lesend) und die Termine der Ressourcen-Kalender, die du freigibst (lesend und schreibend). Auf persönliche Kalender, E-Mails oder andere Workspace-Daten hat anny keinen Zugriff.

Anschließend koppelst du in anny jede gewünschte Ressource mit einem Ressourcen-Kalender. Pro Kalender meldet sich anny für Push-Benachrichtigungen an, Änderungen aus Google kommen dadurch nahezu in Echtzeit an.

| Daten | Richtung | Häufigkeit |
| :- | :- | :- |
| Buchungen (anlegen, ändern, stornieren) | anny → Google | sofort bei jeder Änderung |
| Termine im Ressourcen-Kalender | Google → anny | nahezu in Echtzeit per Push-Benachrichtigung |
| Vollständiger Abgleich | beide Richtungen | beim Aktivieren, danach automatisch rollierend |

Synchronisiert wird der Zeitraum ab heute bis etwa 13 Monate in die Zukunft; anny verlängert ihn automatisch jeden Monat. Ist ein einzelner Kalender nicht erreichbar oder fehlen Schreibrechte, markiert anny nur diese Verbindung als fehlerhaft und benachrichtigt dich per E-Mail und in anny; die übrigen Kalender synchronisieren weiter. Sind alle Kalender unerreichbar, deaktiviert sich die Integration selbst und informiert dich ebenfalls.

## Google Workspace verbinden

### Voraussetzungen

Bevor du Google Workspace verbindest, stelle sicher, dass du Folgendes hast:

* Eine Google Workspace-Organisation mit Zugriff auf die Google Admin-Konsole und die Google Cloud Console
* In Google Workspace angelegte Ressourcen der Kategorie Konferenzraum (nur diese erscheinen später in der Auswahl)
* Admin-Rechte in deinem anny Account

### Verbindung einrichten

<Steps>
  <Step title="Projekt erstellen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Google Workspace**. Erstelle oder verwende ein bestehendes Google-Cloud-Projekt und aktiviere darin die **Google Kalender-API** und die **Admin SDK API**. Die Einrichtungsseite in anny verlinkt dich direkt zu den passenden Stellen der Google Cloud Console.
  </Step>

  <Step title="Dienstkonto erstellen">
    Erstelle im Projekt ein neues Dienstkonto und lade dessen Schlüssel als JSON-Datei herunter. Lade die Datei anschließend in anny hoch.
  </Step>

  <Step title="Domainweite Delegierung hinzufügen">
    Gewähre dem Dienstkonto in der Google Admin-Konsole die domänenweite Delegation. Kopiere dafür in anny die **Client-ID** (Button **Client-ID kopieren**) und die OAuth-Bereiche (Button **OAuth-Bereiche kopieren**) und trage beides bei Google ein.
  </Step>

  <Step title="Nutzer des Dienstkontos erstellen">
    Lege einen Workspace-Nutzer an, in dessen Namen die Integration handelt. anny schlägt eine E-Mail wie `anny-workspace-integration@deine-domain` vor (Button **E-Mail kopieren**); über **Eine abweichende E-Mail verwenden** kannst du auch einen bestehenden Nutzer eintragen.
  </Step>

  <Step title="Berechtigungen festlegen">
    Melde dich bei Google Kalender als dieser Workspace-Nutzer an. Navigiere in den Einstellungen unter „Kalender hinzufügen" zu „Ressourcen ansehen" und wähle jede Ressource aus, die anny synchronisieren soll.
  </Step>

  <Step title="Authentifizierung überprüfen">
    Klicke in anny auf **Authentifizierung überprüfen**. anny prüft sichtbar vier Punkte: die erforderlichen APIs sind aktiviert, Workspace-Ressourcen sind abrufbar (mit Anzahl), der Kalender einer Ressource kann gelesen und bearbeitet werden. Erst wenn alle Punkte grün sind, ist die Authentifizierung abgeschlossen.
  </Step>

  <Step title="Verbindungen anlegen">
    Lege unter **Google Workspace Verbindungen** über **Hinzufügen** fest, welche anny Ressource mit welcher Workspace Ressource gekoppelt wird. Wähle dazu die **Google Workspace Ressource**, die anny **Ressource** und die gewünschten Optionen (siehe Einstellungen unten). Jede Kombination aus Ressource und Workspace Ressource kann nur einmal verbunden werden.
  </Step>

  <Step title="Integration aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. anny startet dann den vollständigen Erstabgleich in beide Richtungen.
  </Step>
</Steps>

Sobald die Integration aktiv ist, werden Buchungen und Termine automatisch in beide Richtungen synchronisiert.

<Tip>
  Der Erstabgleich kann bei gut gefüllten Kalendern oder vielen Verbindungen einige Minuten dauern, weil anny die Anfragen an Google drosselt. Prüfe danach stichprobenartig, ob Termine und Blocker auf beiden Seiten erscheinen.
</Tip>

### Einstellungen & Optionen

Diese Optionen legst du pro Verbindung fest. Zum Bearbeiten muss die Integration deaktiviert sein.

| Einstellung | Beschreibung |
| :- | :- |
| Aktive Buchungsoptionen auswählen | Termine werden nur für Buchungen der ausgewählten Buchungsoptionen erstellt. Ohne Auswahl gilt **Alle Buchungsoptionen**. Blocker in anny werden immer synchronisiert. |
| Titel der Buchungen in anny | Bestimmt den Titel übernommener Termine in anny: **Titel der Veranstaltung** oder **Anonymisiert**. Als privat oder vertraulich markierte Termine werden immer anonymisiert. |
| Titel der Termine in Google Workspace Kalender | Bestimmt den Termin-Titel: **Titel der Buchung**, **Buchungsnummer**, **Name der Ressource**, **Name des Services** oder **Name der Ressource und der Buchungsoption**. |
| Vor- und Nachbereitungszeit hinzufügen | Verlängert den Termin um die Vor- und Nachbereitungszeit der Buchung. Eine 30-Minuten-Buchung mit 15 Minuten Vorbereitung wird z. B. als 45-Minuten-Termin synchronisiert. |
| Alle Ereignisse synchronisieren | Übernimmt auch Termine, die in Google als „verfügbar" markiert sind. Standardmäßig ignoriert anny solche Termine; wird ein synchronisierter Termin auf „verfügbar" umgestellt, entfernt anny den zugehörigen Eintrag. |
| Google Meet zum Termin hinzufügen | Hängt dem Termin ein Google Meet an. Teilnehmer:innen und Kund:in der Buchung werden dann als Gäste eingetragen. |
| Termine als Blocker anlegen | Übernommene Termine werden als Blocker angelegt (Standard). Deaktivierst du die Option, erstellt anny stattdessen Buchungen mit dem gewählten **Standardservice für Buchungen**; Termin-Organisator:innen werden als Kund:innen, Gäste als Teilnehmer:innen übernommen. |
| Bestehende Blocker in Buchungen umwandeln | Erscheint beim Umstellen von Blockern auf Buchungen: Bereits aus Terminen erstellte Blocker werden beim nächsten Aktivieren in Buchungen umgewandelt. |

## Einschränkungen

Die Google Workspace-Integration unterstützt nicht:

* **Andere Ressourcen-Kategorien:** In der Auswahl erscheinen nur Workspace-Ressourcen der Kategorie Konferenzraum, keine Geräte oder sonstigen Ressourcen.
* **Persönliche Kalender:** Kalender einzelner Nutzer:innen werden nicht synchronisiert; dafür gibt es die Integration Google Kalender.
* **Vergangenheit und ferne Zukunft:** Synchronisiert wird nur der Zeitraum ab heute bis etwa 13 Monate im Voraus. Vergangene Termine werden nie übernommen.
* **Serien-Verknüpfung:** Serientermine aus Google werden als einzelne, unabhängige Einträge übernommen.
* **Einladungs-E-Mails:** Für Termine, die anny anlegt oder ändert, verschickt Google keine Einladungen an Gäste. Gäste werden zudem nur eingetragen, wenn Google Meet für die Verbindung aktiv ist.
* **Bearbeiten fremder Termine:** Einträge aus Terminen, deren Organisator:in nicht der verbundene Ressourcen-Kalender ist, sind in anny schreibgeschützt.
* **Änderungen im laufenden Betrieb:** Verbindungen und Dienstkonto lassen sich nur bei deaktivierter Integration bearbeiten. Eine zweite Integration mit identischer Einrichtung kann nicht parallel aktiv sein.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, stoppt die Synchronisation sofort; bereits erstellte Termine, Blocker und Buchungen bleiben auf beiden Seiten bestehen. Beim Löschen entfernt anny die durch die Integration erstellten Synchronisierungen: Du wählst im Dialog, ob nur zukünftige oder alle (einschließlich vergangene) entfernt werden. Von anny erstellte Termine werden dann aus Google Kalender gelöscht, aus Terminen entstandene Blocker und Buchungen aus anny entfernt.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Brauche ich für jeden Raum eine eigene Verbindung?">
    Ja. Jede Verbindung koppelt genau eine anny Ressource mit genau einer Workspace Ressource. Du kannst beliebig viele Verbindungen in einer Integration anlegen; dieselbe Kombination lässt sich nicht doppelt verbinden.
  </Accordion>

  <Accordion title="Warum sehe ich meine Workspace-Ressource nicht in der Auswahl?">
    Es erscheinen nur Ressourcen der Kategorie Konferenzraum, die für den Workspace-Nutzer der Integration sichtbar sind. Prüfe die Kategorie in der Google Admin-Konsole und füge die Ressource dem Nutzer in Google Kalender unter „Ressourcen ansehen" hinzu.
  </Accordion>

  <Accordion title="Werden private Termine aus Google übernommen?">
    Ja, sie blockieren die Ressource, ihr Titel wird in anny aber immer anonymisiert. Über die Einstellung **Titel der Buchungen in anny** kannst du zusätzlich alle übernommenen Termine anonymisieren.
  </Accordion>

  <Accordion title="Was passiert mit Terminen, die in Google als „verfügbar“ markiert sind?">
    Standardmäßig ignoriert anny sie, denn sie blockieren den Raum in Google ja ebenfalls nicht. Sollen sie trotzdem übernommen werden, aktiviere in der Verbindung **Alle Ereignisse synchronisieren**.
  </Accordion>

  <Accordion title="Kann ich aus Google-Terminen echte Buchungen statt Blocker machen?">
    Ja. Deaktiviere in der Verbindung **Termine als Blocker anlegen** und wähle einen **Standardservice für Buchungen**. Bereits erstellte Blocker kannst du über **Bestehende Blocker in Buchungen umwandeln** nachträglich umwandeln.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Authentifizierung schlägt fehl">
    Meist fehlt einer der vier Prüfpunkte. Kontrolliere, ob im Cloud-Projekt die Google Kalender-API und die Admin SDK API aktiviert sind, ob die domänenweite Delegation exakt die kopierte Client-ID und beide OAuth-Bereiche enthält und ob der eingetragene Workspace-Nutzer existiert. Klicke danach erneut auf **Authentifizierung überprüfen**.
  </Accordion>

  <Accordion title="Eine Verbindung wird durchgestrichen mit Warnsymbol angezeigt">
    anny kann diesen Ressourcen-Kalender nicht erreichen oder darf ihn nicht bearbeiten; der Kalender wird aktuell nicht synchronisiert. Stelle sicher, dass die Ressource noch existiert und für den Workspace-Nutzer der Integration freigegeben ist, oder wähle einen anderen Kalender. Reaktiviere anschließend die Integration, damit anny die Verbindung neu abgleicht.
  </Accordion>

  <Accordion title="Die Integration hat sich selbst deaktiviert">
    Das passiert, wenn kein einziger verbundener Kalender erreichbar ist oder die Push-Benachrichtigungen nicht eingerichtet werden konnten; du erhältst dazu eine Benachrichtigung. Prüfe Dienstkonto, Delegation und Kalender-Freigaben und aktiviere die Integration wieder über den **Toggle**. Beim Aktivieren startet automatisch ein vollständiger Abgleich.
  </Accordion>

  <Accordion title="Ein Google-Termin erscheint nicht in anny">
    Prüfe drei Dinge: Der Termin liegt im synchronisierten Zeitraum (ab heute bis ca. 13 Monate), er ist nicht als „verfügbar" markiert (oder **Alle Ereignisse synchronisieren** ist aktiv) und die Integration ist aktiviert. Direkt nach dem Aktivieren kann der Erstabgleich außerdem einige Minuten dauern.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Google Workspace ist die Organisations-Integration für Ressourcen-Kalender (Dienstkonto + domänenweite Delegation, von Admins eingerichtet). Sie ist NICHT die persönliche Google Kalender-Integration (Artikel „google", OAuth-Login einzelner Nutzer:innen). Microsoft-Pendant auf Organisations-Ebene: Artikel „m365-workspace". Grundlagen: Artikel „kalenderintegrationen".
>
> **UI-Pfade:** Menüleiste → **Integrationen** → **Google Workspace**. Authentifizierungs-Panel „Authentifizierung via Dienstkontoschlüssel" mit 5 Schritten: „Projekt erstellen", „Dienstkonto erstellen", „Domainweite Delegierung hinzufügen", „Nutzer des Dienstkontos erstellen", „Berechtigungen festlegen"; Buttons „Client-ID kopieren", „OAuth-Bereiche kopieren", „E-Mail kopieren", „Authentifizierung überprüfen". Regel-Tabelle „Google Workspace Verbindungen" mit Spalten „Ressource", „Workspace Ressource", „Buchungsoptionen", „Sync als" (Werte: „Blocker" / „Buchung ()"), „Google Meet"; Editor-Modal „Verbindung erstellen"/„Verbindung bearbeiten". Aktionen der Integration: „Integration aktivieren/deaktivieren", „Verbindung testen", „Authentifizierung entfernen", „Löschen".
>
> **Quirks:** (1) OAuth-Scopes: calendar.events (read/write) + admin.directory.resource.calendar.readonly. (2) Workspace-Ressourcenliste ist auf die Kategorie CONFERENCE\_ROOM gefiltert. (3) Auch angefragte und eingeladene (noch nicht angenommene) Buchungen erzeugen bereits Termine, da sie die Ressource blockieren; bei Ablehnung/Stornierung wird der Termin gelöscht. (4) Serienbuchungs-Master werden nicht synchronisiert, ihre Einzeltermine schon; Google-Serien kommen als aufgelöste Einzelinstanzen an. (5) Ganztägige Google-Termine blockieren 00:00 bis 00:00 in der Zeitzone der anny Ressource. (6) „Verfügbar"-Transparenz: transparent markierte Termine werden ohne „Alle Ereignisse synchronisieren" ignoriert; Wechsel auf transparent wirkt wie Löschen (Blocker wird gelöscht, Buchung storniert). (7) Terminlöschung in Google: Blocker werden endgültig gelöscht, Buchungen storniert (nicht gelöscht). (8) Fremd organisierte Termine erzeugen schreibgeschützte Einträge; deren Titeländerungen fließen weiter aus Google ein. (9) Sync-Zeitraum 365 Tage + 30 Tage Puffer, monatliche automatische Verlängerung mit erneutem Voll-Abgleich. (10) Fehler-Markierung pro Verbindung: unerreichbarer Kalender oder entzogene Schreibrechte nehmen nur diese Verbindung vom Sync aus (Tooltip-Warnung in der Tabelle, E-Mail + In-App-Benachrichtigung); Reaktivieren setzt Fehler zurück. (11) Selbst-Deaktivierung, wenn alle Verbindungen fehlerhaft sind oder die Webhook-Erstellung scheitert. (12) Duplikat-Schutz: identisch konfigurierte zweite Integration kann nicht parallel aktiv sein; Editor verhindert doppelte Ressource-Kalender-Paare. (13) Ratenlimit ca. 40 Anfragen pro 5 Sekunden pro Integration; Erstabgleich entsprechend verzögert. (14) Löschen bietet „Nur zukünftige Synchronisierungen" oder „Alle Synchronisierungen (einschließlich vergangene)"; von anny erstellte Events werden in Google gelöscht, aus Events entstandene Blocker/Buchungen in anny entfernt. (15) Dienstkonto hochladen/entfernen nur bei deaktivierter Integration; Schreibtest legt kurz einen Termin in der Vergangenheit an und löscht ihn wieder. (16) Beim Erstellen einer Buchung aus einem Termin wird der Termin-Organisator als Kund:in verknüpft oder neu angelegt (außer der Organisator ist der Ressourcen-Kalender selbst); Kundenbenachrichtigungen werden dabei unterdrückt, Google verschickt keine Einladungen (sendUpdates=none).
>
> **Beziehungen:** Plan-Gating über das gemeinsame Kalender-Synchronisations-Feature aller vier Kalenderintegrationen (outlook, google, m365-workspace, google-workspace); konkrete Plan-Zuordnung nicht im Artikel dokumentiert. Synchronisierte Einträge erscheinen im Aktivitätsprotokoll der Buchung als Aktionen der Integration. Die Blocker/Buchungs-Logik (Standardservice, Umwandlung) entspricht der von m365-workspace.


# HRworks mit anny verbinden
Source: https://docs.anny.co/hrworks

Storniere Buchungen bei Abwesenheit automatisch und erstelle Abwesenheiten aus Buchungen in HRworks.

[HRworks](https://www.hrworks.de/) ist eine cloudbasierte HR-Software für Personalverwaltung, Zeiterfassung und Abwesenheitsmanagement. Mit der Integration kann anny Abwesenheiten und Krankmeldungen aus HRworks erkennen und darauf reagieren.

Mit HRworks kannst du in anny:

* Buchungen automatisch stornieren, wenn Mitarbeitende in HRworks als abwesend gemeldet sind
* Abwesenheiten in HRworks erstellen, wenn Mitarbeitende bestimmte Ressourcen in anny buchen (z. B. Homeoffice)
* Abwesenheitsregeln pro Abwesenheitstyp und Ressource individuell konfigurieren

Besonders praktisch ist die Integration, wenn dein Team hybride Arbeitsplätze über anny verwaltet und Abwesenheiten zentral in HRworks gepflegt werden.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Automatische Stornierung bei Krankheit | **Buchungen werden automatisch storniert, wenn eine Krankmeldung in HRworks vorliegt.** Mitarbeitende müssen Buchungen nicht manuell absagen, und blockierte Ressourcen werden freigegeben. |
| Homeoffice-Tage tracken | **Buchungen einer bestimmten Ressource erstellen automatisch eine Abwesenheit in HRworks.** So werden Homeoffice-Tage im HR-System erfasst, ohne doppelte Datenpflege. |
| Urlaub mit Ressourcenfreigabe | **Bei genehmigtem Urlaub in HRworks werden alle Buchungen im Urlaubszeitraum storniert.** Meetingräume und Schreibtische werden für andere Mitarbeitende verfügbar. |

## Wie die HRworks-Verbindung funktioniert

Die Authentifizierung erfolgt über ein API-Schlüsselpaar (Access Key und Secret Access Key), das du in HRworks generierst. Damit autorisierst du anny, Personen-Stammdaten, Abwesenheiten und Krankmeldungen zu lesen sowie Abwesenheiten und Krankmeldungen zu erstellen und zu löschen. Auf andere HRworks-Daten (z. B. Gehälter oder Dokumente) greift anny nicht zu.

anny ordnet Mitarbeitende über die E-Mail-Adresse zu: Jede Person in HRworks braucht dieselbe E-Mail-Adresse wie ihr anny-Konto. Personen ohne übereinstimmende E-Mail-Adresse werden ignoriert.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Abwesenheiten und Krankmeldungen (Stornierungsregeln) | HRworks → anny | Stündlich (automatisch) oder manuell |
| Abwesenheiten und Krankmeldungen (Erstellungsregeln) | anny → HRworks | Bei Buchung, Änderung und Stornierung (sofort) |

<Warning>
  Die Synchronisation prüft ausschließlich Abwesenheiten, die am aktuellen Tag beginnen. Zukünftige Abwesenheiten (z. B. ein Urlaub nächste Woche) werden erst am jeweiligen Tag erkannt und verarbeitet, nicht im Voraus.
</Warning>

## HRworks verbinden

### Voraussetzungen

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

* In HRworks: Admin-Zugang mit Berechtigung zur API-Schlüsselpaar-Erstellung unter **Grundlagen > Integrationen > HRworks-API**
* In HRworks: Leseberechtigung auf den Endpunkt `/v2/persons/master-data`, damit anny Personalnummern den E-Mail-Adressen deiner Mitarbeitenden zuordnen kann
* In anny: Admin-Rolle in der Organisation

<Warning>
  Ohne die Leseberechtigung auf `/v2/persons/master-data` kann anny Abwesenheiten keinem Kunden zuordnen. Die automatische Stornierung von Buchungen funktioniert dann nicht.
</Warning>

### Verbindung einrichten

<Steps>
  <Step title="Integration öffnen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **HRworks**.
  </Step>

  <Step title="Schlüsselpaar in HRworks generieren">
    Melde dich in HRworks an und navigiere zu **Grundlagen > Integrationen > HRworks-API > Reiter Schlüsselpaare**.

    1. Klicke auf **Neues Schlüsselpaar**
    2. Wähle im Dropdown-Menü die Vorlage **Default**
    3. Lade die Textdatei mit Access Key und Secret Access Key herunter
  </Step>

  <Step title="Authentifizierung in anny prüfen">
    Gib in anny den Access Key in das Feld **Client ID** und den Secret Access Key in das Feld **Client Secret** ein. Klicke danach auf **Authentifizierung überprüfen**.
  </Step>

  <Step title="Regeln konfigurieren">
    Richte nach erfolgreicher Authentifizierung die gewünschten Regeln ein (siehe Einstellungen & Optionen).
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, kannst du Stornierungsregeln und Abwesenheits-Erstellungsregeln konfigurieren.

### Einstellungen & Optionen

Die HRworks-Integration bietet zwei Regeltypen, die unabhängig voneinander konfiguriert werden.

#### Stornierung von Buchungen durch Abwesenheiten

Lege fest, bei welchen Abwesenheitstypen Buchungen automatisch storniert werden. Storniert werden nur bestätigte Buchungen; die Stornierung greift auch nach Ablauf einer Stornofrist, und als Stornogrund erscheint der Name des Abwesenheitstyps im Aktivitätsprotokoll.

<Steps>
  <Step title="Neue Regel hinzufügen">
    Klicke im Bereich **Stornierung von Buchungen durch Abwesenheiten** auf **Hinzufügen**.
  </Step>

  <Step title="Abwesenheitstypen auswählen">
    Wähle einen oder mehrere Abwesenheitstypen aus HRworks (z. B. Krankheit, Urlaub). Auch Krankmeldungstypen stehen in der Liste zur Auswahl.
  </Step>

  <Step title="Einschränkung hinzufügen (optional)">
    Ohne Einschränkung gilt die Regel für alle Ressourcen. Über **Einschränkung hinzufügen** kannst du die Regel auf eine bestimmte Ressource, Gruppe oder Kategorie beschränken. Eine Regel auf einer Ressource mit Unterressourcen gilt für deren Unterressourcen.
  </Step>

  <Step title="Bestätigen">
    Speichere die Regel mit **Bestätigen**. Durch **Synchronisieren** kannst du die Synchronisation sofort auslösen, andernfalls wird sie stündlich automatisch ausgeführt.
  </Step>
</Steps>

<Tip>
  Standardmäßig ist der Schalter **Nur akzeptierte Abwesenheiten stornieren** aktiv: anny storniert dann nur bei genehmigten Abwesenheiten. Deaktiviere den Schalter, wenn auch noch nicht genehmigte Abwesenheitsanfragen Buchungen stornieren sollen.
</Tip>

#### Automatische Erstellung von Abwesenheiten

Lege fest, bei welcher Ressource eine Buchung automatisch eine Abwesenheit in HRworks erstellt. Die Abwesenheit wird erstellt, sobald die Buchung bestätigt ist, und erscheint in HRworks als Antrag mit dem Status „beantragt" (Krankmeldungen mit dem Status „gemeldet"). Sie wird nicht automatisch genehmigt.

<Steps>
  <Step title="Neue Regel hinzufügen">
    Klicke im Bereich **Erstellung von Abwesenheiten durch Buchungen** auf **Hinzufügen**.
  </Step>

  <Step title="Auslöser in anny wählen">
    Wähle die Ressource, Gruppe oder Kategorie aus, deren Buchung eine Abwesenheit auslösen soll (z. B. die Ressource „Homeoffice"). Hat eine Ressource Unterressourcen, wähle die übergeordnete Ressource: Die Regel deckt dann alle Unterressourcen ab.
  </Step>

  <Step title="Abwesenheitstyp in HRworks wählen">
    Wähle den Abwesenheitstyp, der in HRworks erstellt werden soll (z. B. „Homeoffice").
  </Step>

  <Step title="Bestätigen">
    Speichere die Regel mit **Bestätigen**.
  </Step>
</Steps>

Stornierst du die Buchung später, löscht anny die erstellte Abwesenheit in HRworks. Verschiebst oder änderst du die Buchung, wird die Abwesenheit mit den neuen Daten neu erstellt.

Die Abwesenheit übernimmt Beginn- und Enddatum der Buchung. Die Zuordnung zur Tageshälfte erfolgt automatisch:

| Buchungszeit | Erstellte Abwesenheit |
| - | - |
| Endzeit vor 15:00 Uhr | Erste Tageshälfte |
| Startzeit ab 12:00 Uhr | Zweite Tageshälfte |
| Beides (Buchung zwischen 12:00 und 15:00 Uhr) | Zweite Tageshälfte |

## Einschränkungen

Die HRworks-Integration unterstützt nicht:

* Vorausschauende Prüfung: Abwesenheiten werden ausschließlich tagesaktuell erkannt, nicht im Voraus (z. B. kein Stornieren nächste Woche eingetragener Urlaube)
* Echtzeit-Synchronisation für Stornierungen: Buchungen werden stündlich geprüft, nicht in Echtzeit
* Nutzerzuordnung ohne Personalnummer-Endpunkt: Ohne Leseberechtigung auf `/v2/persons/master-data` kann anny keine Abwesenheiten zuordnen
* Halbtägige Stornierung: Bei der Stornierung wertet anny jede Abwesenheit ganztägig. Eine halbtägige Abwesenheit am Vormittag storniert auch Buchungen am Nachmittag desselben Tages
* Automatische Genehmigung: In HRworks erstellte Abwesenheiten bleiben Anträge und durchlaufen den normalen Freigabeprozess in HRworks

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, werden keine neuen Synchronisationen durchgeführt. Bestehende Regeln bleiben gespeichert, aber inaktiv. Beim Löschen werden alle Regeln und die Verbindungskonfiguration entfernt. Bereits in HRworks erstellte Abwesenheiten bleiben in beiden Fällen bestehen.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Wie oft synchronisiert anny die Abwesenheiten aus HRworks?">
    Die Synchronisation läuft automatisch einmal pro Stunde. Du kannst sie jederzeit manuell über den Button **Synchronisieren** auslösen, solange die Integration aktiv ist.
  </Accordion>

  <Accordion title="Werden auch zukünftige Abwesenheiten berücksichtigt?">
    Nein. Die Integration prüft ausschließlich Abwesenheiten, die am aktuellen Tag beginnen. Zukünftige Einträge (z. B. ein Urlaub in zwei Wochen) werden erst am jeweiligen Starttag verarbeitet. Dann storniert anny alle Buchungen im gesamten Abwesenheitszeitraum.
  </Accordion>

  <Accordion title="Was passiert, wenn eine Abwesenheit in HRworks noch nicht genehmigt ist?">
    Standardmäßig nichts: Der Schalter **Nur akzeptierte Abwesenheiten stornieren** ist aktiv, anny storniert dann nur bei genehmigten Abwesenheiten. Wenn du den Schalter deaktivierst, führen auch noch nicht genehmigte Anfragen zur Stornierung.
  </Accordion>

  <Accordion title="Kann ich die Stornierung auf bestimmte Ressourcen beschränken?">
    Ja. Beim Erstellen einer Regel kannst du eine Einschränkung auf bestimmte Ressourcen, Gruppen oder Kategorien hinzufügen. Ohne Einschränkung gilt die Regel für alle Ressourcen.
  </Accordion>

  <Accordion title="Was passiert mit der Abwesenheit in HRworks, wenn ich die Buchung storniere?">
    anny löscht die automatisch erstellte Abwesenheit in HRworks. Verschiebst du die Buchung stattdessen, wird die Abwesenheit mit den neuen Daten neu erstellt.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Buchungen werden nicht storniert, obwohl eine Abwesenheit in HRworks eingetragen ist">
    Häufigste Ursache: Die Leseberechtigung auf `/v2/persons/master-data` fehlt in deinem HRworks-API-Schlüsselpaar. Ohne diese Berechtigung kann anny die Personalnummer keiner E-Mail-Adresse zuordnen und erkennt die betroffene Person nicht. Prüfe die API-Berechtigungen in HRworks unter **Grundlagen > Integrationen > HRworks-API**. Prüfe außerdem, ob die Abwesenheit schon genehmigt ist: Standardmäßig storniert anny nur bei genehmigten Abwesenheiten.
  </Accordion>

  <Accordion title="Die Synchronisation storniert nur bei manuellem Klick">
    Prüfe, ob die Integration aktiv ist (Toggle oben rechts auf der Integrationsseite). Ist sie aktiv, läuft der Sync automatisch stündlich. Beachte, dass nur Abwesenheiten geprüft werden, die am aktuellen Tag beginnen.
  </Accordion>

  <Accordion title="Die Abwesenheit in HRworks wird nicht erstellt">
    Ursache ist meist die Regel-Konfiguration oder die Zuordnung. Stelle sicher, dass die Regel die gebuchte Ressource abdeckt (bei Unterressourcen die übergeordnete Ressource wählen) und die Buchung bestätigt ist. Prüfe außerdem, ob der Mitarbeitende in HRworks mit derselben E-Mail-Adresse wie in anny registriert ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: Menüleiste > Integrationen > HRworks. Die anny-UI schreibt die Plattform als „HRWorks", der Hersteller als „HRworks".
> * Exakte UI-Begriffe: Felder **Client ID** und **Client Secret**; Buttons **Authentifizierung überprüfen**, **Hinzufügen**, **Bestätigen**, **Einschränkung hinzufügen**, **Synchronisieren**; Toggle **Nur akzeptierte Abwesenheiten stornieren** (standardmäßig aktiv); Regel-Tabellen mit Spalten **Abwesenheitstyp** und **Beschränkung**. Der zweite Bereich heißt in der UI „Erstellung von Abwesenheiten durch Buchungen" (Artikel-Überschrift lautet „Automatische Erstellung von Abwesenheiten").
> * Regel-Anatomie: Stornierungsregeln erlauben mehrere Abwesenheitstypen pro Regel, Erstellungsregeln genau einen Typ und zwingend eine Ressource/Gruppe/Kategorie.
> * Nutzerzuordnung: anny lädt Personen-Stammdaten (/v2/persons/master-data) und ordnet Personalnummern über exakt übereinstimmende E-Mail-Adressen zu; die Zuordnung wird pro Kund:in gespeichert. Fehlt die Berechtigung, schlägt Stornierung UND Erstellung fehl.
> * Ressourcen-Zuordnung (Quirk): Stornierungsregeln auf einer Ressource mit Unterressourcen gelten nur für die Unterressourcen, nicht für Buchungen der Ressource selbst. Bei Erstellungsregeln zählt immer die übergeordnete Ressource der gebuchten Ressource; eine Regel direkt auf einer Unterressource greift nicht.
> * Stornierung: nur bestätigte Buchungen, umgeht Stornofristen (auch nach Frist), Stornogrund = Name des Abwesenheitstyps, Verursacher im Aktivitätsprotokoll ist die Integration. Abwesenheitszeiträume werden ganztägig gewertet (Halbtags-Angaben aus HRworks werden ignoriert).
> * Sync-Fenster: Der stündliche Job prüft nur heute startende Abwesenheiten; beim Verarbeiten werden aber Buchungen im gesamten Abwesenheitszeitraum storniert. Der manuelle Sync erfordert eine aktive Integration; im Fehlerzustand pausiert der automatische Sync.
> * Erstellung: erst nach Buchungsbestätigung (Anfragen erst nach Annahme); Status „requested"/„beantragt", Krankmeldungen „reported"/„gemeldet". anny wartet max. ca. 20 Sekunden auf die HRworks-Verarbeitung, sonst gilt die Erstellung als fehlgeschlagen.
> * Tageshälfte-Logik exakt: Endstunde ≤ 14 (vor 15:00) → erste Hälfte; Startstunde ≥ 12 → zweite Hälfte; beides → zweite Hälfte. Flags gelten für ersten/letzten Tag mehrtägiger Buchungen.
> * Krankmeldungen sind in HRworks ein eigener Datentyp; anny behandelt sie wie Abwesenheiten (eigene Typenliste, eigene Endpunkte).
> * Abgrenzung: keine Synchronisation von Anwesenheiten, Zeiterfassung oder sonstigen Personaldaten; keine Genehmigung von Anträgen in HRworks.
> * Verwandte Artikel: Personio-Integration (gleiche Regel-Oberfläche und Funktionslogik, andere Authentifizierung, dort OAuth-ähnliche API-Zugangsdaten).


# ICS-Kalender mit anny verbinden
Source: https://docs.anny.co/ics-calendar

Importiere externe Kalender per ICS-Link als Blocker auf deine Ressource, unabhängig vom Kalender-Anbieter.

Ein ICS-Kalender (iCal) ist ein standardisiertes Kalenderformat, das von nahezu allen Kalender-Anwendungen unterstützt wird. Mit der Integration kann anny externe Kalendertermine über einen ICS-Link importieren und als Blocker auf einer Ressource nutzen.

Mit der ICS-Kalenderintegration kannst du in anny:

* Externe Kalendertermine als Blocker auf einer Ressource anzeigen
* Buchungen an bereits belegten Terminen automatisch verhindern
* Jeden beliebigen Kalender-Anbieter anbinden (Google, Outlook, Apple, andere)

Besonders praktisch ist die Integration, wenn du einen Kalender-Anbieter nutzt, für den anny keine native 2-Wege-Integration anbietet, oder wenn du nur eine Einweg-Synchronisation (extern → anny) benötigst.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Externe Belegung als Blocker nutzen | **Verhindere Doppelbuchungen durch externe Termine.** Termine aus einem beliebigen Kalender erscheinen als Blocker auf der Ressource. Buchungen in belegten Zeitslots werden automatisch verhindert. |
| Apple Kalender anbinden | **Verbinde einen iCloud-Kalender mit anny.** Da keine native Apple-Integration existiert, nutzt du den ICS-Link als Brücke. |
| Drittanbieter-Kalender synchronisieren | **Importiere Termine aus Booking-Plattformen oder anderen Tools.** Jeder Dienst, der einen ICS-Feed bereitstellt, kann als Blocker-Quelle genutzt werden. |

## Wie die ICS-Kalender-Verbindung funktioniert

Die Integration arbeitet als **Einweg-Import** (extern → anny): anny liest den ICS-Link in regelmäßigen Abständen aus und überträgt neue oder geänderte Termine als Blocker auf die Ressource.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Termine (als Blocker) | Externer Kalender → anny | Gestaffelt (siehe unten) |

**Sync-Intervalle:**

| Zeitraum | Aktualisierung |
| - | - |
| Aktueller Tag | Alle 5 Minuten |
| Nächste 7 Tage | Alle 15 Minuten |
| Nächste 30 Tage | Jede Stunde |
| Nächste 365 Tage | Täglich um 02:00 Uhr |

<Info>
  Die Synchronisation läuft nur in eine Richtung (extern → anny). anny Buchungen werden nicht in den externen Kalender zurückgeschrieben. Für eine 2-Wege-Synchronisation nutze die native Google- oder Outlook-Integration.
</Info>

## ICS-Kalender verbinden

### Voraussetzungen

Bevor du einen ICS-Kalender verbindest, stelle sicher, dass du Folgendes hast:

* Einen ICS-/iCal-Link aus deinem externen Kalender (als URL verfügbar)
* Admin-Zugriff in deinem anny Account
* Die Ressource, die synchronisiert werden soll, ist bereits angelegt

### Verbindung einrichten

<Steps>
  <Step title="Ressource öffnen">
    Öffne die gewünschte Ressource und wechsle zum Reiter **Integrationen**.
  </Step>

  <Step title="ICS-Link hinterlegen">
    Unter **Externe Kalender** fügst du den ICS-Link in das Feld **ICAL URL** ein und speicherst.
  </Step>
</Steps>

Sobald der Link hinterlegt ist, beginnt anny mit der gestaffelten Synchronisation der Termine.

<Tip>
  Falls dein ICS-Link ein @-Zeichen enthält, ersetze es durch `%40`. Sonst kann anny den Link nicht korrekt verarbeiten.
</Tip>

### ICS-Link generieren (nach Anbieter)

| Anbieter | So findest du den ICS-Link |
| - | - |
| Google Kalender | [calendar.google.com](https://calendar.google.com) → Einstellungen → Kalender auswählen → Kalendereinstellungen → "Link zum Freigeben abrufen" |
| Outlook | [outlook.office.com](https://outlook.office.com) → Einstellungen → Alle Outlook-Einstellungen → Kalender → Geteilte Kalender → Kalender auswählen → "Veröffentlichen" → ICS-Link kopieren |
| Apple (iCloud) | [icloud.com/calendar](https://www.icloud.com/calendar/) → Seitenleiste → Kalender-Symbol → "Öffentlicher Kalender" → Link kopieren → `webcal://` durch `https://` ersetzen |
| Andere | ICS-/iCal-Link aus dem externen Kalender kopieren. Falls nötig: `@` durch `%40` ersetzen. |

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| ICAL URL | Der ICS-Link des externen Kalenders. Pflichtfeld. |
| Anonymisierung | Ereignisse aus dem externen Kalender können anonymisiert dargestellt werden (nur als "Belegt" statt mit Titel). |
| Freigegebener Kalender (Export) | Um anny Buchungen in einem externen Kalender zu sehen, kannst du den freigegebenen anny-Kalender-Link in deinem externen Kalender hinterlegen. |

## Einschränkungen

Die ICS-Kalenderintegration unterstützt nicht:

* 2-Wege-Synchronisation (nur externer Kalender → anny, nicht umgekehrt)
* Echtzeit-Synchronisation (gestaffelte Intervalle, siehe oben)
* Änderungen an externen Terminen direkt in anny vornehmen (Blocker können nur in anny gelöscht werden)

## Verbindung trennen

<Warning>
  Beim Löschen des ICS-Links werden die importierten Blocker entfernt. Neue Termine aus dem externen Kalender werden nicht mehr synchronisiert.
</Warning>

Entferne den ICS-Link unter **Ressource** → **Integrationen** → **Externe Kalender**.

## FAQ

<AccordionGroup>
  <Accordion title="Ab welchem Plan kann ich ICS-Kalender nutzen?">
    Die ICS-Kalenderintegration ist ab dem Essential-Plan verfügbar.
  </Accordion>

  <Accordion title="Werden anny Buchungen auch in meinen externen Kalender übertragen?">
    Nicht über den ICS-Import. Für den Export kannst du den freigegebenen anny-Kalender-Link in deinem externen Kalender hinterlegen. Für eine vollständige 2-Wege-Synchronisation nutze die native Google- oder Outlook-Integration.
  </Accordion>

  <Accordion title="Wie schnell werden Änderungen übernommen?">
    Abhängig vom Zeitraum: Termine am selben Tag werden alle 5 Minuten aktualisiert, Termine in der nächsten Woche alle 15 Minuten. Details in der Sync-Intervall-Tabelle oben.
  </Accordion>

  <Accordion title="Kann ich mehrere ICS-Kalender auf einer Ressource hinterlegen?">
    Ja. Du kannst mehrere ICS-Links für eine Ressource hinterlegen. Alle werden als Blocker-Quelle genutzt.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Termine aus dem externen Kalender erscheinen nicht als Blocker">
    Prüfe, ob der ICS-Link korrekt hinterlegt ist (kein @-Zeichen, sondern %40). Teste den Link im Browser: Er sollte eine .ics-Datei herunterladen. Beachte, dass die erste Synchronisation je nach Zeitraum bis zu einer Stunde dauern kann.
  </Accordion>

  <Accordion title="Blocker verschwinden nach einiger Zeit">
    Der ICS-Link ist möglicherweise abgelaufen oder wurde vom Anbieter geändert. Generiere einen neuen Link und hinterlege ihn erneut.
  </Accordion>

  <Accordion title="Nur manche Termine werden synchronisiert">
    Die Synchronisation deckt maximal 365 Tage ab. Termine außerhalb dieses Zeitraums werden ignoriert. Außerdem werden nur Termine mit dem Status "beschäftigt" als Blocker übernommen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad: **Ressource** → **Integrationen** → **Externe Kalender** → ICAL URL Feld
> * Plan: ab Essential
> * Nur Einweg-Import (extern → anny). Keine Rückschreibung. Für 2-Wege: native Google- oder Outlook-Integration empfehlen.
> * Sync-Intervalle: 5 min (heute), 15 min (7 Tage), 1h (30 Tage), täglich 02:00 (365 Tage)
> * @-Zeichen im Link muss durch %40 ersetzt werden
> * Mehrere ICS-Links pro Ressource möglich
> * Apple iCloud: webcal:// durch https\:// ersetzen
> * Abgrenzung: ICS = Einweg-Import für beliebige Anbieter. Google/Outlook = native 2-Wege-Sync mit OAuth.
> * Verwandte Artikel: Kalenderintegrationen (Übersicht), Google Kalender, Outlook Kalender


# Joan mit anny verbinden
Source: https://docs.anny.co/joan-setup

Synchronisiere Raumbuchungen zwischen anny und Joan Displays über Outlook oder Google Kalender.

[Joan](https://getjoan.com/) ist ein Anbieter für ePaper-Raumdisplays mit Touch-Funktion und Akku-Betrieb. Mit der Verbindung über einen gemeinsamen Kalender (Outlook, Google oder ICS) werden anny-Buchungen automatisch auf dem Joan Display angezeigt.

Mit Joan kannst du in anny:

* Buchungen in Echtzeit auf dem Joan Display vor dem Raum darstellen
* Spontanbuchungen am Joan Display vornehmen, die in anny synchronisiert werden
* Den Belegungsstatus deiner Meetingräume ohne Stromanschluss oder PoE anzeigen

Besonders praktisch ist die Integration für kleinere Unternehmen mit bis zu 10 Meetingräumen, die kabellose Displays mit langer Akkulaufzeit bevorzugen.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Meetingraum-Status an der Tür anzeigen | **Echtzeit-Belegung ohne Verkabelung.** Das Joan Display zeigt den aktuellen Status des Raums und bevorstehende Buchungen an, ohne dass ein Stromanschluss nötig ist. |
| Spontanbuchung direkt am Display | **Ad-hoc-Buchung ohne Laptop oder Smartphone.** Mitarbeitende buchen freie Räume per Touch direkt am Joan Display. Die Buchung wird über Outlook in anny synchronisiert. |
| Bestehende Outlook-Räume auf Displays bringen | **Nahtlose Ergänzung zur Outlook-Raumbuchung.** Wenn Räume bereits über Outlook gebucht werden, zeigt Joan den Kalender direkt auf dem Display an, während anny die Verfügbarkeit steuert. |

## Wie die Joan-Verbindung funktioniert

Joan verbindet sich nicht direkt mit anny, sondern über einen gemeinsamen Kalender als Brücke. Der typische Synchronisationspfad:

**anny ↔ Outlook (oder Google Kalender) ↔ Joan**

anny synchronisiert Buchungen in Echtzeit mit dem Outlook-Raumkalender (Microsoft 365 Workspace-Integration). Joan liest denselben Kalender aus und zeigt die Buchungen auf dem Display an. Buchungen, die am Joan Display vorgenommen werden, landen im Outlook-Kalender und werden von dort nach anny synchronisiert.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Buchungen | anny → Outlook → Joan | Echtzeit |
| Buchungen am Display | Joan → Outlook → anny | Echtzeit |

<Tip>
  Alternativ zu Outlook kannst du auch Google Kalender oder einen ICS-Link verwenden. Bei ICS sind keine Buchungen direkt am Joan Display möglich (nur Lesezugriff).
</Tip>

## Joan verbinden

### Voraussetzungen

Bevor du Joan mit anny verbindest, stelle sicher, dass du Folgendes hast:

* Ein aktives Joan-Abo und Zugang zum [Joan Portal](https://portal.getjoan.com/)
* Ein Joan Display, das per WLAN verbunden und im Portal registriert ist
* Einen Microsoft 365 Raumkalender (Raum-Postfach) oder Google Workspace Raumkalender für den gewünschten Meetingraum
* Die Microsoft 365 Workspace-Integration in anny (für die Zwei-Wege-Synchronisation zwischen anny und Outlook)

### Verbindung einrichten

Sobald die Verbindung aktiv ist, werden Buchungen aus anny automatisch auf dem Joan Display dargestellt und Buchungen vom Display zurück nach anny synchronisiert.

### Einstellungen & Optionen

| Einstellung | Wo | Beschreibung |
| - | - | - |
| Kalender-Typ | Joan Portal → Settings → Calendar | Outlook, Google oder ICS |
| Raum-Zuweisung | Joan Portal → Manage → Rooms | Welcher Kalender zu welchem Display |
| Display-Verhalten | Joan Portal → Devices | Touch-Buchung, Anzeige-Optionen |
| anny-Synchronisation | anny → Integrationen → Microsoft 365 | Welche Ressource mit welchem Outlook-Kalender |

## Einschränkungen

Die Joan-Verbindung unterstützt nicht:

* Direkte API-Verbindung zwischen Joan und anny (immer über Kalender als Brücke)
* Check-in/Check-out über das Joan Display in anny (Check-in-Status wird nicht synchronisiert)
* Community-Berechtigungen am Joan Display (jede Person mit Zugang zum Display kann buchen)
* Bei ICS-Verbindung: Keine Buchung am Joan Display möglich (nur Lesezugriff)

## FAQ

<AccordionGroup>
  <Accordion title="Welche Joan-Modelle gibt es?">
    Joan bietet Displays von 6" bis 13" in Versionen mit und ohne Touch. Preise liegen zwischen 349€ und 899€ (plus Abo). Aktuelle Modelle und Preise findest du auf [getjoan.com](https://getjoan.com/).
  </Accordion>

  <Accordion title="Wie lange hält der Akku?">
    Je nach Modell und Nutzung 2 bis 6 Monate. Das Display kann über USB-C geladen oder mit einem PoE-Adapter dauerhaft mit Strom versorgt werden.
  </Accordion>

  <Accordion title="Kann ich auch Google Kalender statt Outlook verwenden?">
    Ja. Im Joan Portal kannst du unter **Settings** → **Calendar** auch Google Workspace als Kalenderquelle wählen. Die anny-Seite verbindest du dann über die Google Workspace Integration.
  </Accordion>

  <Accordion title="Brauche ich die anny Display App zusätzlich?">
    Nein. Joan ist ein eigenständiges Display-System mit eigener App und eigenem Portal. Die anny Display App ist eine Alternative für Standard-Tablets (iOS/Android) mit direkter anny-Anbindung.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Buchungen aus anny erscheinen nicht auf dem Joan Display">
    Die Synchronisation läuft über Outlook. Prüfe zuerst, ob die Buchung im Outlook-Raumkalender erscheint. Falls ja: Prüfe im Joan Portal, ob der richtige Kalender mit dem richtigen Display verknüpft ist. Falls nein: Prüfe die Microsoft 365 Integration in anny.
  </Accordion>

  <Accordion title="Buchungen vom Joan Display kommen nicht in anny an">
    Prüfe, ob die Buchung im Outlook-Kalender erscheint. Wenn ja, liegt das Problem an der anny-Outlook-Synchronisation. Stelle sicher, dass die Microsoft 365 Integration in anny aktiv ist und die richtige Ressource verknüpft ist.
  </Accordion>

  <Accordion title="Das Joan Display zeigt 'Offline' an">
    Das Display hat die WLAN-Verbindung verloren. Prüfe die WLAN-Verfügbarkeit und starte das Display ggf. neu. Im Joan Portal siehst du unter **Devices** den Verbindungsstatus.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Joan hat KEINE direkte anny-Integration. Die Verbindung läuft IMMER über einen Kalender (Outlook, Google, ICS) als Brücke.
> * Synchronisationspfad: anny ↔ Outlook/Google ↔ Joan
> * Voraussetzung anny-Seite: Microsoft 365 Workspace-Integration ODER Google Workspace Integration aktiv
> * Joan ist ein ePaper-Display mit Akku (kein Strom nötig), Modelle 6" bis 13", 349€ bis 899€ + Abo
> * Joan Portal: [https://portal.getjoan.com/](https://portal.getjoan.com/)
> * ICS-Einschränkung: Nur Lesezugriff, keine Buchung am Display möglich
> * Empfehlung: Kleinere Firmen mit bis zu 10 Meetingräumen ohne PoE/Stromanschluss
> * Abgrenzung anny Display App: Direkte anny-Anbindung, native Features (Sleep Mode, Ad-hoc, anny Pass, NFC). Joan = eigenständiges System über Kalender-Brücke.
> * Abgrenzung tapirx: ePaper mit WiFi und direkter anny-Integration (kein Kalender nötig)
> * Navigation Mintlify: Admin → Displays & Terminals → Display App → Joan


# Keycafe mit anny verbinden
Source: https://docs.anny.co/keycafe

Schlüsselübergaben automatisieren: Weise Schlüssel pro Buchung zu und spare manuelle Koordination.

[Keycafe](https://www.keycafe.com/de) ist ein Schlüsselverwaltungssystem mit physischen SmartBox-Terminals, in denen Schlüssel sicher aufbewahrt und per Code abgeholt werden. Mit der Integration kann anny Schlüssel automatisch pro Buchung der richtigen Kund:in zuweisen.

Mit Keycafe kannst du in anny:

* Schlüssel automatisch für den Buchungszeitraum an Kund:innen zuweisen
* Vor- und Nachlaufzeiten für die Schlüsselabholung konfigurieren
* Aktive und inaktive Schlüsselzugänge pro Buchung im Adminbereich einsehen

Besonders praktisch ist die Integration, wenn du physische Schlüssel für Fahrzeuge, Räume oder Equipment verwaltest und manuelle Übergaben vermeiden möchtest.

<Info>
  Verfügbar ab dem Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Fahrzeugverleih | **Schlüsselübergabe ohne Personal vor Ort.** Kund:innen buchen ein Fahrzeug in anny und holen den Schlüssel eigenständig an der SmartBox ab. Dein Team muss keine Übergabezeiten koordinieren. |
| Coworking & Büroräume | **Raumzugang über physische Schlüssel steuern.** Kund:innen erhalten automatisch Zugang zum gebuchten Raum für den exakten Buchungszeitraum. Nach Ablauf wird der Zugang entzogen. |
| Equipment & Geräte | **Spezialschlüssel für gebuchtes Equipment zuweisen.** Bei der Buchung eines Geräts wird der passende Schlüssel automatisch für den Buchungszeitraum freigegeben. |

## Wie die Keycafe-Verbindung funktioniert

Die Authentifizierung erfolgt über einen dedizierten Keycafe-Benutzeraccount (E-Mail + Passwort + SMS-Verifizierung). anny meldet sich mit diesen Zugangsdaten bei Keycafe an und erhält Zugriff auf die dort hinterlegten Schlüssel.

Nach der Einrichtung verbindest du anny Ressourcen mit Keycafe-Schlüsseln. Bei jeder bestätigten Buchung überträgt anny die Buchungsinformationen an Keycafe, das den verknüpften Schlüssel automatisch der buchenden Kund:in für den Buchungszeitraum zuweist. Nur bestätigte Buchungen erzeugen einen Zugang: angefragte, noch nicht angenommene Buchungen und interne Blocker lösen keine Schlüsselzuweisung aus.

Bei Serienbuchungen legt anny den Zugang nicht sofort an, sondern plant ihn und erstellt ihn erst kurz vor dem jeweiligen Termin. Die E-Mail mit dem Booking-Code erreicht die Kund:in dann wenige Tage vor dem Termin, nicht direkt nach der Buchung.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Buchungen (Zugangsgewährung) | anny → Keycafe | Echtzeit |
| Booking-Code (E-Mail an Kund:in) | Keycafe → Kund:in | Echtzeit |
| Rückgabe-Erinnerungen | Keycafe → Kund:in | Automatisch |

## Keycafe verbinden

### Voraussetzungen

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

* Einen Keycafe-Account mit mindestens einem registrierten Schlüssel in einem SmartBox-Terminal
* Einen dedizierten Keycafe-Benutzeraccount (Vollnutzer) für die anny-Integration
* Admin-Rechte mit Zugang zu den **Integrationen** in anny

<Tip>
  Wir empfehlen, einen eigenen Keycafe-Benutzeraccount speziell für die anny-Integration anzulegen. Die Erstellung eines Benutzeraccounts bei Keycafe ist kostenlos.
</Tip>

### Verbindung einrichten

<Steps>
  <Step title="Keycafe-Benutzer anlegen">
    Gehe in Keycafe auf **Hinzufügen** → **Nutzer** → **Vollnutzer** und folge den Schritten, um einen neuen Benutzer zu erstellen. Dieser Account wird für die Verbindung mit anny verwendet.
  </Step>

  <Step title="Integration in anny öffnen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Keycafe**.
  </Step>

  <Step title="Authentifizieren">
    Gib die **E-Mail** und das **Passwort** des angelegten Keycafe-Benutzers ein und klicke auf **SMS-Verifizierungscode erhalten**. Gib den empfangenen Code im anny Adminbereich ein und bestätige ihn über **Authentifizierung überprüfen**.
  </Step>

  <Step title="Verbindung prüfen">
    Nach erfolgreicher Authentifizierung zeigt anny die Keycafe-Integration als aktiv an. Du kannst jetzt Ressourcen mit Schlüsseln verbinden.
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, kannst du Regeln erstellen, die anny Ressourcen mit Keycafe-Schlüsseln verknüpfen.

### Einstellungen & Optionen

Nach der Authentifizierung konfigurierst du die Schlüsselzuweisung über Regeln:

| Einstellung | Beschreibung |
| - | - |
| Ressource | Die anny Ressource, deren Buchung Zugang zum Schlüssel gewährt. Du kannst übergeordnete Ressourcen und Unterressourcen auswählen. Pro Ressource ist nur eine Regel möglich. Eine Regel auf einer übergeordneten Ressource gilt auch für Buchungen ihrer Unterressourcen. Eine Regel direkt auf einer Unterressource hat Vorrang. |
| Schlüssel | Ein oder mehrere Keycafe-Schlüssel, die bei Buchung der Ressource zugewiesen werden. Bei mehreren Schlüsseln erhält die Kund:in Zugang zu allen. |
| Zugang vor der Buchung | Zeit vor Buchungsbeginn, in der der Schlüssel bereits abgeholt werden kann. |
| Zugang nach der Buchung | Zeit nach Buchungsende, in der der Schlüssel noch zurückgegeben werden kann. |

<Steps>
  <Step title="Regel erstellen">
    Klicke auf **Hinzufügen**, um eine neue Verbindung zu erstellen.
  </Step>

  <Step title="Ressource und Schlüssel zuordnen">
    Wähle die **Ressource** aus, die bei Buchung Zugang gewähren soll, und einen oder mehrere zugehörige **Keycafe-Schlüssel**. Du kannst eine übergeordnete Ressource oder eine Unterressource wählen.
  </Step>

  <Step title="Zeitfenster festlegen">
    Bestimme **Zugang vor der Buchung** und **Zugang nach der Buchung** für die Schlüsselabholung und -rückgabe.
  </Step>
</Steps>

Sobald eine Regel aktiv ist, wird bei jeder Buchung der verknüpfte Schlüssel automatisch zugewiesen.

<Tip>
  Bestehende Verbindungen kannst du über die **drei Punkte** rechts neben der Regel bearbeiten oder löschen.
</Tip>

### Buchungsprozess für Kund:innen

Der Ablauf nach einer erfolgreichen Buchung:

1. Kund:in erhält von Keycafe eine E-Mail mit einem Booking-Code.
2. Zur Abholzeit gibt die Kund:in den Code am Keycafe-Terminal ein.
3. Das Fach mit dem Schlüssel öffnet sich.
4. Nach der Buchung gibt die Kund:in den Schlüssel per Code-Eingabe am Terminal zurück.

### Zugänge im Adminbereich einsehen

In der Buchungsdetailansicht findest du unter **Smartlock Zugänge** die aktiven und entfernten Zugänge. Per Klick auf einen Zugang werden angezeigt:

| Information | Beschreibung |
| - | - |
| Status | In Bearbeitung, Geplant, Unbestätigt, Erfolgreich, Fehlgeschlagen, Nicht autorisiert, Aufräumen oder Entfernt |
| Zugang beginnt am / Zugang endet am | Start- und Endzeit des Schlüsselzugangs |
| Türschloss | Der zugewiesene Keycafe-Schlüssel |
| Erstellt am | Wann der Zugang angelegt wurde |
| Zugang | Der Booking-Code für das Terminal, per Klick einblendbar (falls verfügbar) |

## Einschränkungen

Die Keycafe-Integration unterstützt nicht:

* Dauerhafter Community-Zugang: Schlüssel können nur über Buchungen zugewiesen werden, nicht dauerhaft für Community-Mitglieder.
* Remote Open: Da Keycafe mit physischen Schlüsseln an einem Terminal arbeitet, gibt es keine Fernöffnungsfunktion.
* Verspätete Rückgabe verhindern: anny hat keinen Einfluss auf die Nutzbarkeit des Schlüssels außerhalb der Zugangszeiten. Kund:innen können den Schlüssel physisch behalten.

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Woher bekommt mein Kunde den Booking-Code?">
    Keycafe sendet den Booking-Code per E-Mail direkt an die Kund:in. Die E-Mail kommt von Keycafe, nicht von anny.
  </Accordion>

  <Accordion title="Kann ich mehrere Schlüssel einer Ressource zuordnen?">
    Ja. Du kannst einer Regel mehrere Schlüssel zuordnen, die Kund:in erhält dann Zugang zu allen. Pro Ressource ist jedoch nur eine Regel möglich. Für unterschiedliche Ressourcen legst du jeweils eine eigene Regel an.
  </Accordion>

  <Accordion title="Was passiert bei einer Stornierung?">
    Bei Stornierung der Buchung wird der Zugang in Keycafe entfernt. Die Kund:in kann den Schlüssel nicht mehr abholen.
  </Accordion>

  <Accordion title="Wann bekommen Kund:innen bei Serienbuchungen ihren Code?">
    Bei Serienbuchungen plant anny den Zugang und erstellt ihn erst kurz vor dem jeweiligen Termin. Die Keycafe-E-Mail mit dem Booking-Code kommt daher wenige Tage vor dem Termin, nicht direkt nach der Buchung. Bis dahin steht der Zugang im Adminbereich auf Status **Geplant**.
  </Accordion>

  <Accordion title="Brauche ich einen speziellen Keycafe-Plan?">
    Du benötigst einen Keycafe-Account mit mindestens einem registrierten SmartBox-Terminal und Schlüssel. Die Erstellung eines Benutzeraccounts ist kostenlos.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein Kunde hat keinen Booking-Code erhalten">
    Die E-Mail wird von Keycafe versendet, nicht von anny. Prüfe, ob die Keycafe-Integration in anny aktiv ist und ob die Ressource korrekt mit einem Keycafe-Schlüssel verknüpft ist. Lass die Kund:in auch den Spam-Ordner prüfen.
  </Accordion>

  <Accordion title="Der Zugang zeigt den Status 'In Bearbeitung'">
    anny hat den Zugang an Keycafe übermittelt, aber Keycafe hat ihn noch nicht bestätigt. Prüfe, ob die Keycafe-Authentifizierung noch gültig ist und ob der Schlüssel im Keycafe-System verfügbar ist.
  </Accordion>

  <Accordion title="Schlüssel wurde nicht rechtzeitig zurückgegeben">
    anny hat keinen Einfluss auf die physische Rückgabe. Keycafe sendet automatisch Rückgabe-Erinnerungen. Kontaktiere die Kund:in direkt, wenn der Schlüssel nicht zurückgegeben wurde.
  </Accordion>

  <Accordion title="Ich kann die Keycafe-Zugangsdaten nicht ändern">
    Solange die Integration aktiv ist, lassen sich die Zugangsdaten nicht ändern. Deaktiviere sie zuerst über den **Toggle** oben rechts und authentifiziere dich danach mit den neuen Daten neu.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Feature & Plan:** Feature INTEGRATIONS\_SMART\_LOCKS, laut Artikel ab Professional-Plan. Plan-Zuordnung ist nicht code-verifizierbar (DB-basiert), im Zweifel mit Produkt/Sales abgleichen.
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **Keycafe**. Auth-Panel „Authentifizierung" mit Feldern „E-mail" + „Passwort" → Button „SMS-Verifizierungscode erhalten" → Feld „Keycafe SMS-Verifizierungscode" → Button „Authentifizierung überprüfen". Regeln: Panel **„Zugang durch Buchungen"** → „Hinzufügen" (Modal „Verbindung herstellen"). Regel-Editor-Felder: Ressource (Einfachauswahl, inkl. Unterressourcen), Schlüssel (Mehrfachauswahl, „Schlüssel auswählen"), „Zugang vor der Buchung", „Zugang nach der Buchung". Regel-Tabelle-Spalten: „Ressource", „Schlüssel", „Zugang vor der Buchung", „Zugang nach der Buchung". Regeln bearbeiten/löschen über die drei Punkte (Aktionen „Verbindung bearbeiten"/löschen). Aktivieren/Deaktivieren: Toggle oben rechts; Löschen: drei Punkte → Löschen.
>
> **Auth-Methode:** E-Mail + Passwort + SMS-Verifizierungscode (2FA), kein OAuth, kein API-Key-Direktfeld. Das Passwort wird nach erfolgreicher Verifizierung verworfen, danach nutzt anny ein Token. Erneute Authentifizierung ist nur bei **deaktivierter** Integration möglich. Empfehlung: eigener Keycafe-Vollnutzer (nicht code-verifizierbar, Keycafe-seitig).
>
> **Regel-Mechanik:** Genau eine Regel pro Ressource (Speichern lehnt doppelte Ressource ab). Eine Regel kann mehrere Schlüssel enthalten, pro Schlüssel entsteht ein eigener Zugang mit eigenem Code. Regel auf übergeordneter Ressource greift auch für Unterressourcen (spezifischere Regel hat Vorrang). Regeländerungen (Schlüssel/Ressource) erneuern Zugänge zukünftiger Buchungen automatisch, gelöschte Regeln entfernen sie.
>
> **Zugangslogik:** Ausschließlich buchungsbasiert. Nur bestätigte (angenommene) Buchungen erzeugen Zugänge, angefragte Buchungen und interne Blocker (ohne Kund:in) nicht. Zugangsfenster = Buchungszeitraum + „Zugang vor/nach der Buchung". Serienbuchungen: Zugang wird geplant und erst ca. 48 h vor Zugangsbeginn erstellt (Status „Geplant"), Einzelbuchungen sofort. Kein dauerhafter Community-Zugang in der UI (Backend hat Community-Regel-Logik, aber die Keycafe-Oberfläche zeigt sie nicht).
>
> **Zugangs-Detail (Buchung):** Abschnitt „Smartlock Zugänge". Status-Labels: In Bearbeitung, Geplant, Unbestätigt, Erfolgreich, Fehlgeschlagen, Nicht autorisiert, Aufräumen, Entfernt. Felder: Status, „Zugang beginnt am", „Zugang endet am", „Türschloss", „Zugang" (Code, einblendbar), „Erstellt am", ggf. „Fehler". Aktionen pro Zugang: „Zugang beim Anbieter anzeigen", „Integrationseinstellungen", übergreifend „Zugänge neu erstellen". Bei fehlgeschlagener Zugangserstellung werden die zuständigen Admins benachrichtigt.
>
> **Booking-Code:** Wird von Keycafe per E-Mail an Kund:in gesendet, nicht von anny. Bei fehlendem Code: Authentifizierung und Ressource-Schlüssel-Mapping prüfen.
>
> **Rückgabe:** Rückgabe-Erinnerungen kommen von Keycafe (nicht code-verifizierbar). Verspätete Rückgabe physisch möglich, anny kann Schlüsselzugriff außerhalb der Zugangszeiten nicht unterbinden.
>
> **Kein Remote Open:** Keycafe arbeitet mit physischen Schlüsseln an einem Terminal, keine Fernöffnung (Regeln haben keine Remote-Open-Option).
>
> **Trennen:** Deaktivieren behält bestehende Keycafe-Zugänge und erstellt keine neuen. Löschen entfernt alle Zugänge und Ressourcen-Verknüpfungen.
>
> **Abgrenzung zu anderen Smart-Locks:** Keycafe ist keine elektronische Türschlossintegration (wie Nuki, Salto, Dormakaba), sondern ein physisches Schlüsselverwaltungssystem mit SmartBox-Terminal (technisch aber eine Access-Control-Integration wie die Smart-Locks).
>
> **Verwandte Artikel:** Smart-Lock Übersicht, Nuki, Salto KS, Dormakaba Exivo, Dormakaba Resivo, Glutz eAccess.


# KleverKey mit anny verbinden
Source: https://docs.anny.co/klever-key

Automatisiere zeitlich begrenzte, schlüssellose Zutritte für Buchungen und Community-Mitglieder.

[KleverKey](https://www.kleverkey.com/) ist ein Smart-Lock-System für digitale und zeitlich gesteuerte Türzugänge. Mit der Integration erstellt anny automatisch passende Zutrittsrechte für Buchungen und Communities.

Mit KleverKey kannst du in anny:

* digitale Gastzugänge für Buchungen erstellen
* Ressourcen und Communities mit einem oder mehreren Schlössern verbinden
* Türen per Zugangslink oder Remote Open ohne zusätzlichen KleverKey Account öffnen

Besonders praktisch ist die Integration für Teams, die Räume ohne Schlüsselübergabe und zusätzlichen Vor-Ort-Aufwand bereitstellen.

<Info>
  Verfügbar ab dem Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Räume nach einer Buchung öffnen | **Kund:innen erhalten automatisch einen zeitlich begrenzten Zugang.** Der Zugang gilt für das verknüpfte Schloss und den in der Regel festgelegten Zeitraum. |
| Community-Mitgliedern Zutritt geben | **Mitglieder erhalten Zugang zu gemeinsam genutzten Bereichen.** Du verknüpfst eine Community mit einem oder mehreren Schlössern. |
| Türen direkt über anny öffnen | **Remote Open öffnet ein berechtigtes Schloss per Knopfdruck.** Der Button erscheint auf der anny Homepage oder in der Buchungsansicht. |

## Wie die KleverKey-Verbindung funktioniert

anny authentifiziert die Verbindung über einen KleverKey API-Token und die Organisations-ID. Der Token erlaubt anny, Schlösser abzurufen und anhand deiner Regeln zeitlich begrenzte Gastzugänge zu erstellen.

Bei einer Buchung erstellt KleverKey einen individuellen digitalen Schlüssel. anny zeigt den Zugang in der Buchung an und kann ihn mit der Buchungsbestätigung versenden. Wird eine Buchung storniert, wird das zugehörige Zutrittsrecht entzogen. anny erstellt den Zugang nur für angenommene Buchungen. Eine Regel auf einer übergeordneten Ressource gilt auch für Buchungen ihrer Unterressourcen.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Schlösser und Organisationsdaten | KleverKey → anny | Beim Einrichten und Aktualisieren der Verbindung |
| Buchungsbezogene Zutrittsrechte | anny → KleverKey | Bei Erstellung, Änderung oder Stornierung einer Buchung |
| Zugangslink und Zugangsdetails | KleverKey → anny | Als Antwort beim Erstellen oder Ändern eines Zugangs |

Wenn der API-Token widerrufen oder ersetzt wird, kann anny keine neuen Zugänge erstellen, bis du die Verbindung mit einem gültigen Token aktualisierst.

## KleverKey verbinden

### Voraussetzungen

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

* einen eingerichteten KleverKey Account mit mindestens einem funktionsfähigen Schloss
* aktivierte Gastzutritte in den KleverKey Organisationseinstellungen
* einen KleverKey API-Token und deine Organisations-ID
* den Professional-Plan in anny

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste **Integrationen** und gehe zu **KleverKey**. Trage deinen [API-Token](https://portal.kleverkey.com/account/api-keys) und die [Organisations-ID](https://portal.kleverkey.com/organization/settings) ein. Wähle außerdem die **Zeitzone**, in der die Zugangszeiten gelten sollen. Standard ist die Zeitzone deiner Organisation.

    ![In den KleverKey Organisationseinstellungen aktivierst du Gastzutritte, damit anny individuelle Zugangslinks erstellen kann.](https://downloads.intercomcdn.eu/i/o/5628905/439db7400f53aa8da93090bd/Frame+10+%282%29.png?expires=1785256200\&signature=dfde2c42153f9a5b67666fa68deed3e5b5219fc4ff2f2cd3d1d1e28010222196\&req=1dNtzVH6qXsp0xr0v9tnrm4HVhdUsJRg4Rn8%2FosYbQ7bqKZdRLvwVyR9P0I2%0A)

    ![In anny hinterlegst du API-Token und Organisations-ID, um die Verbindung zu autorisieren.](https://downloads.intercomcdn.eu/i/o/5628921/216e1d88f929a703b292051e/Frame+3+%282%29.png?expires=1785256200\&signature=4ade4fef8e82e3dfcf88221bb680de0948822dfccb3be0e1cdb282315ac01894\&req=1dNtzVH4rXsp0xr0v9tnrsT9karsoDVwi8R2KKH%2Fe8mv1Ao9SX6vlbHMflky%0A)
  </Step>

  <Step title="Konfigurieren">
    Lege anschließend deine Zugangsregeln fest:

    1. Klicke im Bereich für Buchungs- oder Community-Regeln auf **Hinzufügen**.
    2. Wähle die Ressource oder Community aus.
    3. Ordne ein oder mehrere KleverKey Schlösser zu.
    4. Lege bei Buchungsregeln fest, wie lange der Zugang vor und nach der Buchung gelten soll.
    5. Aktiviere bei Bedarf **Zusätzliche Einladungen von KleverKey versenden** oder **Fernöffnung**.

    ![Eine Buchungsregel verknüpft eine Ressource mit den zu öffnenden KleverKey Schlössern.](https://downloads.intercomcdn.eu/i/o/niegcmk9/34294692/4c209828c0d6f58a357ab832105b/Frame-2B10-284-29.png?expires=1785256200\&signature=12e90868857e754c8bbac54693ba911f6d976d43a9aa5aedcfc0fb83088e95ac\&req=09FtzFz8pTVk2hL085ZhoQxToXgxhH9%2BfySadKTSt%2FqfhWLtzuanfkTpyikl%0AckpNG8ru0WJl1M2g%0A)

    ![Eine Community-Regel gibt den Mitgliedern der ausgewählten Community Zugang zu den verknüpften Schlössern.](https://downloads.intercomcdn.eu/i/o/niegcmk9/34294693/7ea6464ea8ed7812141278e757c1/Frame-2B10-285-29.png?expires=1785256200\&signature=b2ee2a53ed5bdaa94a38f257a78c78cc26947dfdf9a08e48e4c965de78aa8497\&req=09FtzFz8pTRk2hL085Zhob46p233fvNLXNcrHxcqReumNB5wlBzEFia9Od9x%0AIBJyUCiD0RgR6w3s%0A)
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, erstellt anny anhand der Regeln automatisch passende KleverKey Zugänge.

Das [Video zur KleverKey-Einrichtung](https://www.loom.com/share/707db5b54f7d47b0a7bc5f78eaf1d5df) zeigt den vollständigen Ablauf im KleverKey Portal und im anny Admin-Bereich.

<Tip>
  Du kannst mehrere Schlösser mit einer Ressource verbinden oder dasselbe Schloss mehreren Ressourcen zuordnen.
</Tip>

### Einstellungen & Optionen

| Einstellung | Funktion |
| - | - |
| Ressource | Bestimmt, bei welcher Buchung ein Zutrittsrecht erstellt wird. |
| Community | Gibt Mitgliedern der ausgewählten Community Zugang zu den zugeordneten Schlössern. |
| Schlösser | Legt fest, welche Türen mit der Regel geöffnet werden können. |
| Zugang vor der Buchung | Erweitert den Zugangszeitraum vor der gebuchten Zeit. |
| Zugang nach der Buchung | Erweitert den Zugangszeitraum nach der gebuchten Zeit. |
| Zusätzliche Einladungen von KleverKey versenden | Lässt KleverKey zusätzlich eine eigene Einladungs-E-Mail mit dem Zugangslink verschicken. |
| Fernöffnung (Remote Open) | Erlaubt berechtigten Kund:innen, das Schloss direkt über anny zu öffnen. Der Toggle heißt **Fernöffnung verwenden**. |

Bestehende Regeln kannst du über die **drei Punkte** bearbeiten oder löschen.

### Remote Open

Mit Remote Open können Kund:innen berechtigte Türschlösser per Knopfdruck öffnen. Der Zugang erscheint für heutige Buchungen und Community-Berechtigungen auf der anny Homepage sowie in den Buchungsdetails.

| Ort | Wo öffnest du die Tür? |
| - | - |
| E-Mail | Der Link **Öffnen** in der Buchungsbestätigung führt in den Browser. Dort erscheint der Button **Tür entriegeln**. |
| anny App | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** und in der Buchung unter **Meine Buchungen**. |
| Browser | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** und in der Buchung unter **Meine Buchungen**. |

![Remote Open zeigt berechtigten Kund:innen den Button zum Öffnen auf der anny Homepage und in der Buchungsansicht.](https://downloads.intercomcdn.eu/i/o/niegcmk9/69585893/057d12084a97c5397a5d6589ca83/Frame+49+%282%29.png?expires=1785369600\&signature=806a2889b293ef451f54c099908e1720aa2be04820e0c30f97fde91b6f61fea3\&req=1txqzV3ypTRk2hj99dpg6tKn%2FzXv1%2FpYbkbxjX5NpB5vEG6awD9x8gXxKjpA%0AlWpROSMWNQl8xGHg%2FDCAafUC%0A)

Für Remote Open über eine Community aktivierst du die Funktion in den Community-Berechtigungen der Smart-Lock-Integration.

### Zugänge prüfen

Öffne eine Buchung und wähle den zugehörigen Smart-Lock-Zugang aus. Dort siehst du Status, Zugriffszeitraum, Türschloss, Erstellungsdatum und Zugangslink.

![Die Buchungsdetails zeigen aktive und inaktive KleverKey Zugänge mit ihren wichtigsten Informationen.](https://downloads.intercomcdn.eu/i/o/niegcmk9/34294694/abb138fdc357491b8bb982c595c2/Frame-2B10-286-29.png?expires=1785256200\&signature=a0d30282c501823a37544583aa92c9e0a4a29d3190c917948f921cdc9205aa92\&req=09FtzFz8pTNk2hL085ZhoeccYfU4c9MGtNGnJXKhf0PFTqMwsyDuOL%2B3ATCJ%0A5SJfLOye0xKSS691%0A)

| Status | Bedeutung |
| - | - |
| In Bearbeitung | anny hat den Zugang angefordert, KleverKey hat ihn aber noch nicht erstellt. |
| Geplant | Bei Serienbuchungen plant anny den Zugang und erstellt ihn kurz vor Beginn des jeweiligen Termins. |
| Erfolgreich | Der Zugang ist aktiv und kann im angezeigten Zeitraum genutzt werden. |
| Entfernt | Das System oder ein:e Admin-Nutzer:in hat den Zugang entfernt. Das Schloss kann damit nicht mehr geöffnet werden. |

Das [Video zum Buchungsablauf](https://www.loom.com/share/ed44e7768f13451392cf0da986e5f67a) zeigt, wie Kund:innen den digitalen Schlüssel nach der Buchung verwenden.

## Einschränkungen

Die KleverKey-Integration unterstützt nicht:

* Zugänge ohne aktivierte Gastzutritte im KleverKey Account
* die Erstellung neuer Zugänge mit einem widerrufenen oder ungültigen API-Token
* Zugänge außerhalb des in der Regel definierten Zeitraums
* mehr als eine Buchungsregel für dieselbe Ressource
* eine Statusabfrage am Schloss: anny sendet Zugänge, fragt aber den Live-Zustand des Schlosses nicht ab

Die Anzahl der Gastzugänge ist laut KleverKey nicht begrenzt. Hardwarepreise und verfügbare Schlossmodelle können sich ändern. Prüfe aktuelle Angaben direkt im [KleverKey Shop](https://www.kleverkey.com/shop).

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Brauchen Kund:innen einen KleverKey Account oder die KleverKey App?">
    Nein. Ein individueller Gastzugangslink kann das Schloss ohne zusätzlichen KleverKey Account öffnen.
  </Accordion>

  <Accordion title="Kann ich mehrere Schlösser mit einer Ressource verbinden?">
    Ja. Eine Regel kann mehrere Schlösser enthalten. Du kannst ein Schloss außerdem mehreren Ressourcen zuordnen.
  </Accordion>

  <Accordion title="Was passiert mit dem Zugang, wenn eine Buchung storniert wird?">
    anny entzieht das mit der Buchung verknüpfte Zutrittsrecht, sobald die Stornierung verarbeitet wurde.
  </Accordion>

  <Accordion title="Wo sehe ich den Status eines Zugangs?">
    Öffne die Buchungsdetails und wähle den Smart-Lock-Zugang aus. Dort findest du Status, Zeitraum, Schloss und Zugangslink.
  </Accordion>

  <Accordion title="Wie erhalten Kund:innen ihren Zugangslink?">
    anny kann den Link in der Buchungsbestätigung senden. Optional versendet KleverKey eine zusätzliche E-Mail mit demselben Link.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Für meine Buchung wurde kein Zugang erstellt">
    Prüfe nacheinander:

    1. Die KleverKey-Integration ist aktiv.
    2. Der API-Token und die Organisations-ID sind gültig.
    3. Gastzutritte sind im KleverKey Account aktiviert.
    4. Für die gebuchte Ressource besteht eine Regel mit mindestens einem Schloss.
  </Accordion>

  <Accordion title="Der Zugang bleibt in Bearbeitung">
    KleverKey hat den von anny angeforderten Zugang noch nicht bestätigt. Öffne den Zugang in den Buchungsdetails und prüfe über die **drei Punkte** die zugehörige Verbindung in KleverKey.
  </Accordion>

  <Accordion title="Remote Open wird nicht angezeigt">
    Prüfe, ob **Remote Open** in der Integration aktiviert ist und aktuell ein gültiger Zugang besteht. Für Community-Zugänge muss die Funktion zusätzlich in den Community-Berechtigungen aktiviert sein.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Einordnung:** KleverKey ist eine Smart-Lock-Integration (Zutritt), gemeinsame Basis mit den anderen Smart-Lock-Integrationen (Salto KS, Nuki, Comydo, UniFi Access, Key Cafe). Freischaltung über das Feature INTEGRATIONS\_SMART\_LOCKS (Plan-Zuordnung „ab Professional" liegt in der Datenbank, aus dem Code nicht final verifizierbar).
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **KleverKey**. Auth-Felder: „KleverKey API Token", „KleverKey Organisations ID", plus Zeitzone-Auswahl. Regeln im selben Bereich: „Zugang durch Buchungen" und „Zugang durch Communities". Deaktivieren: Toggle oben rechts; Löschen: drei Punkte → Löschen.
>
> **Terminologie (wichtig):** Adminseitig heißt die Fernöffnung „Fernöffnung verwenden" (Spalte „Fernöffnung"); kundenseitig zeigt anny das Badge „Remote Open" und den Button „Tür entriegeln". Der Zusatz-Mail-Toggle heißt „Zusätzliche Einladungen von KleverKey versenden". Padding-Felder heißen „Zugang vor der Buchung" / „Zugang nach der Buchung". Der Grant-Block in der Buchung heißt „Smartlock Zugänge". Statuswerte: In Bearbeitung, Geplant, Erfolgreich, Entfernt, Unbestätigt, Fehlgeschlagen, Nicht autorisiert.
>
> **Quirks:** (1) Nur angenommene Buchungen erhalten Zugänge; angefragte/abgelehnte/stornierte Buchungen und interne Blocker nicht. (2) Genau eine Buchungsregel pro Ressource (Speichern wird sonst abgelehnt); mehrere Schlösser pro Regel und ein Schloss für mehrere Ressourcen sind erlaubt. (3) Eine Regel auf einer übergeordneten Ressource greift auch für Unterressourcen; die spezifischere Regel hat Vorrang. (4) Serienbuchungen erhalten geplante Zugänge (Status „Geplant"), Erstellung kurz vor Beginn; Einzelbuchungen sofort. (5) Ändern der Schlösser/Ressource einer Regel aktualisiert bzw. entfernt zukünftige Zugänge automatisch. (6) Community-Regeln bieten die Aktion „Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen". (7) Keine Statusabfrage am Schloss und kein laufender Statussync. (8) Die gewählte Zeitzone bestimmt die Gültigkeitszeiten inkl. Vor-/Nachlauf.
>
> **Remote Open:** separater Zugang zusätzlich zum Link-Zugang. Button in App/Browser nur bei heute gültigem Zugang aktiv; Home-Seite listet ihn unter „Heutige Zugänge". Für Community-Zugänge muss die Fernöffnung in den Community-Berechtigungen aktiviert sein. In der Buchungsbestätigung erscheinen die Zugänge im Abschnitt „Schlüsselloser Zugang" mit dem Link „Öffnen".
>
> **Verbindung trennen:** Deaktivieren behält bestehende Zugänge und erstellt keine neuen; Löschen entfernt die lokal gespeicherten Zugänge. Hinweis für Support: Beim Löschen der gesamten Integration werden die einzelnen Links nicht aktiv aus KleverKey entfernt, sie laufen über ihr Zeitprofil aus (im Gegensatz zum Stornieren einer einzelnen Buchung, das den Link per API löscht).


# LinkedIn Ads mit anny verbinden
Source: https://docs.anny.co/linkedin-ads-tracking

Miss den Erfolg deiner LinkedIn-Kampagnen: melde Seitenaufrufe und Buchungen als Conversions an den Campaign Manager.

[LinkedIn Ads](https://www.linkedin.com/campaignmanager) ist die Werbeplattform von LinkedIn. Über das LinkedIn Insight Tag und das Conversion-Tracking misst du, wie deine Kampagnen wirken. Mit der Integration verbindet anny deine öffentlichen Buchungsseiten mit dem LinkedIn Campaign Manager und meldet dorthin, was Besucher:innen bei dir tun.

Mit LinkedIn Ads kannst du in anny:

* Seitenaufrufe deiner Buchungsseiten an LinkedIn melden und daraus Retargeting-Zielgruppen aufbauen
* Buchungen, Warenkorb-Schritte und den Checkout als Conversions an LinkedIn übergeben
* Abschlüsse zusätzlich serverseitig melden, auch wenn Besucher:innen keine Marketing-Cookies akzeptieren

So siehst du im LinkedIn Campaign Manager, welche Kampagnen tatsächlich zu Buchungen führen, und optimierst dein Budget gezielt.

<Info>
  Diese Integration ist Teil des Conversion Trackings und muss für deinen Plan freigeschaltet sein. Fehlt die Freischaltung, siehst du die Integration, kannst sie aber nicht aktivieren.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Reichweite messen und Zielgruppen aufbauen | **Das Insight Tag zählt Seitenaufrufe automatisch.** Schon mit der Partner ID misst du, wie viele Menschen deine Buchungsseiten besuchen, und baust daraus Retargeting-Zielgruppen für neue Kampagnen. |
| Buchungen als Conversion nachweisen | **Abgeschlossene Buchungen werden als Conversion gemeldet.** Du legst eine Conversion Aktion vom Typ **Checkout abschließen** an und siehst im Campaign Manager, welche Anzeige zu einer Buchung geführt hat, inklusive Nettowert. |
| Conversions ohne Cookie erfassen | **Die Offline conversion API meldet Abschlüsse serverseitig.** Auch ohne Marketing-Einwilligung ordnet anny eine Buchung dem passenden Anzeigenklick zu und meldet sie an LinkedIn. |

## Wie die LinkedIn-Ads-Verbindung funktioniert

Die Integration hat drei Bereiche, die du unter **Integrationen → LinkedIn Ads** findest:

* **LinkedIn Insight Tag**: Hier trägst du die **Partner ID** ein. Sie lädt das Insight Tag auf deinen Buchungsseiten und ist Pflicht für die Aktivierung.
* **LinkedIn Ads Conversion-Tracking**: Hier legst du **Conversion Aktionen** an, die einzelne Ereignisse als Conversion an LinkedIn melden.
* **Offline conversion API**: Hier hinterlegst du optional ein **Zugriffstoken**, mit dem anny Abschlüsse zusätzlich serverseitig meldet.

Es gibt zwei Meldewege, die sich ergänzen:

**Im Browser (Insight Tag).** Sobald Kund:innen im Cookie-Banner die Option **Marketing** akzeptieren, lädt anny das Insight Tag auf allen öffentlichen Buchungsseiten deiner Organisation: Ressourcen-, Service-, Explore-, Abo- und Buchungspaket-Seite sowie Checkout und Bestätigungsseite. Das gilt auch für die eingebettete Buchungsseite (Widget). Im Admin-Bereich von anny lädt kein Tag. Ohne Marketing-Einwilligung wird kein Skript geladen und kein Ereignis gemeldet. Wird die Einwilligung zurückgenommen, stoppt das Tracking sofort ohne Neuladen.

**Serverseitig (Offline conversion API).** Klickt jemand auf eine LinkedIn-Anzeige, hängt LinkedIn eine Klick-ID an die Ziel-URL. anny speichert sie beim ersten Seitenaufruf und ordnet sie 14 Tage lang späteren Abschlüssen zu. Kommt es innerhalb dieser Zeit zu einer Buchung, einem Abo oder einem Buchungspaket, meldet anny die Conversion serverseitig an LinkedIn, unabhängig von Cookies. Ist bereits eine Klick-ID gespeichert, bleibt sie erhalten: der erste Klick gewinnt.

Die Verbindung ist einseitig. anny meldet Conversions an LinkedIn, holt aber keine Kampagnen-, Budget- oder Zielgruppendaten zurück. Auswertungen finden im LinkedIn Campaign Manager statt.

| Daten an LinkedIn | Richtung | Wann |
| :- | :- | :- |
| Seitenaufrufe, Warenkorb- und Checkout-Ereignisse | anny → LinkedIn (Browser) | Beim Aufruf bzw. Ereignis, nur mit Marketing-Einwilligung |
| Conversion-Regel, Zeitpunkt, Nettobetrag, Währung, Klick-ID, Ereignis-Kennung | anny → LinkedIn (serverseitig) | Beim Abschluss, wenn Klick-ID und Zugriffstoken vorliegen |

anny überträgt keine Namen, keine E-Mail-Adressen und keine Buchungsdetails. Die Ereignis-Kennung enthält die anny-Auftragsnummer. Der gemeldete Wert ist der Nettobetrag des Auftrags, bei kostenlosen Buchungen 0.

## LinkedIn Ads verbinden

### Voraussetzungen

Bevor du LinkedIn Ads verbindest, stelle sicher, dass du Folgendes hast:

* Admin-Rechte in deinem anny Account und Conversion Tracking in deinem Plan
* Zugang zum [LinkedIn Campaign Manager](https://www.linkedin.com/campaignmanager)
* Die **Partner ID** aus dem Insight Tag: Campaign Manager → Daten → Signal Manager → Insight Tag → „Ich verwende einen Tag Manager"
* Optional je Conversion die **Conversion ID**: Campaign Manager → Messung → Conversion Tracking
* Optional ein **Zugriffstoken** für die Offline conversion API: Campaign Manager → Daten → Signal Manager → Direct API

### Verbindung einrichten

<Steps>
  <Step title="Partner ID eintragen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **LinkedIn Ads**. Trage im Panel **LinkedIn Insight Tag** deine **Partner ID** ein. Sie darf nur die von LinkedIn vorgegebenen Zeichen enthalten, sonst lässt sich die Integration nicht aktivieren.
  </Step>

  <Step title="Conversion Aktionen anlegen (optional)">
    Klicke im Panel **LinkedIn Ads Conversion-Tracking** auf **Conversion Aktion hinzufügen**. Wähle den **Event Typ** und trage die passende **Conversion ID** aus LinkedIn ein. Für die reine Reichweitenmessung brauchst du keine Aktion: Seitenaufrufe zählt das Insight Tag von selbst.
  </Step>

  <Step title="Offline conversion API einrichten (optional)">
    Hinterlege im Panel **Offline conversion API** dein **Zugriffstoken**, wenn anny Abschlüsse zusätzlich serverseitig melden soll. Damit die serverseitige Meldung greift, muss außerdem mindestens eine Conversion Aktion angelegt sein.
  </Step>

  <Step title="Integration aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. Erst mit dem Aktivieren erhält deine Buchungsseite die Partner ID und die Conversion Aktionen.
  </Step>
</Steps>

Sobald die Integration aktiv ist, lädt das Insight Tag auf deinen Buchungsseiten und meldet Ereignisse an LinkedIn, sofern Besucher:innen die Marketing-Cookies akzeptieren.

<Warning>
  Einstellungen lassen sich nur bei deaktivierter Integration ändern. Solange die Integration aktiv ist, sind **Partner ID** und **Conversion Aktion hinzufügen** ausgegraut und das **Zugriffstoken** nimmt anny nicht an. Der Ablauf für Änderungen ist immer: deaktivieren, ändern, speichern, wieder aktivieren.
</Warning>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Partner ID | Die ID aus deinem LinkedIn Insight Tag. Pflicht für die Aktivierung. Lädt das Insight Tag auf deinen Buchungsseiten. |
| Event Typ | Das Ereignis, das eine Conversion Aktion im Browser meldet: **Seite ansehen**, **In den Warenkorb legen**, **Checkout starten** oder **Checkout abschließen**. Pro Ereignis kannst du mehrere Aktionen anlegen. |
| Conversion ID | Die Kennung der Conversion-Regel aus dem LinkedIn Campaign Manager. Jede Conversion Aktion braucht eine eigene ID. |
| Zugriffstoken | Optionales Token für die Offline conversion API. Nur damit meldet anny Abschlüsse serverseitig, unabhängig von Cookies. |

<Tip>
  Eine Conversion Aktion vom Typ **Seite ansehen** brauchst du nur, wenn LinkedIn den Seitenaufruf zusätzlich als Conversion werten soll. Für Reichweite und Retargeting-Zielgruppen genügt die Partner ID allein.
</Tip>

## Einschränkungen

Die LinkedIn-Ads-Integration unterstützt nicht:

* **Datenabruf aus LinkedIn:** Die Verbindung ist einseitig. anny meldet Conversions, holt aber keine Kampagnen-, Budget- oder Zielgruppendaten zurück. Auswertungen findest du nur im LinkedIn Campaign Manager.
* **Sichtbares Conversion-Protokoll:** anny protokolliert einzelne Conversion-Meldungen nicht sichtbar. Ob eine Conversion angekommen ist, prüfst du in LinkedIn.
* **Browser-Tracking ohne Einwilligung:** Das Insight Tag lädt erst, wenn Besucher:innen die Cookie-Option **Marketing** akzeptieren. Ohne Einwilligung meldet nur die serverseitige Offline conversion API.
* **Personenbezogene Übergabe:** anny überträgt keine Namen, E-Mail-Adressen oder Buchungsdetails an LinkedIn.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, wird die Partner ID von deiner Buchungsseite entfernt: Das Insight Tag lädt nicht mehr und es gehen keine Offline-Meldungen mehr an LinkedIn. Beim Löschen werden Partner ID, Conversion Aktionen und Zugriffstoken entfernt; anny deaktiviert die Integration dafür zuerst automatisch. In LinkedIn bleiben deine Conversion-Regeln und bereits gemeldete Conversions unverändert.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Brauche ich eine Conversion Aktion, um Reichweite zu messen?">
    Nein. Sobald die Partner ID hinterlegt und die Integration aktiv ist, zählt das Insight Tag Seitenaufrufe automatisch und du kannst Retargeting-Zielgruppen aufbauen. Conversion Aktionen brauchst du nur, damit LinkedIn bestimmte Ereignisse als Conversion wertet.
  </Accordion>

  <Accordion title="Wozu dient das Zugriffstoken?">
    Das Zugriffstoken aktiviert die Offline conversion API. Damit meldet anny abgeschlossene Buchungen, Abos und Buchungspakete serverseitig an LinkedIn, auch wenn Besucher:innen keine Marketing-Cookies akzeptiert haben. Ohne Token läuft das Tracking nur im Browser.
  </Accordion>

  <Accordion title="Welche Daten sendet anny an LinkedIn?">
    Im Browser meldet das Insight Tag Seitenaufrufe sowie die von dir angelegten Ereignisse. Serverseitig sendet anny Conversion-Regel, Zeitpunkt, Nettobetrag, Währung, die LinkedIn-Klick-ID und eine Ereignis-Kennung mit der Auftragsnummer. Namen, E-Mail-Adressen und Buchungsdetails werden nicht übertragen.
  </Accordion>

  <Accordion title="Kann ich LinkedIn Ads zusammen mit anderen Tracking-Integrationen nutzen?">
    Ja. Google Ads, Meta Ads, TikTok Ads und LinkedIn Ads lassen sich gleichzeitig aktivieren. Sie teilen sich dieselbe Marketing-Einwilligung im Cookie-Banner und dieselben Ereignisse auf deinen Buchungsseiten.
  </Accordion>

  <Accordion title="Warum sehe ich in anny keine Liste der gemeldeten Conversions?">
    anny protokolliert die einzelnen Conversion-Meldungen nicht sichtbar. Ob und welche Conversions angekommen sind, siehst du im LinkedIn Campaign Manager.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="LinkedIn zeigt keine Conversions an">
    Prüfe, ob die Integration aktiv ist und mindestens eine Conversion Aktion mit gültiger Conversion ID angelegt wurde. Für serverseitige Meldungen muss zusätzlich ein Zugriffstoken hinterlegt sein und die Buchung über einen LinkedIn-Anzeigenklick zustande gekommen sein. Ohne Klick-ID gibt es keine Offline-Conversion.
  </Accordion>

  <Accordion title="Das Insight Tag lädt nicht auf meiner Buchungsseite">
    Das Insight Tag lädt nur, wenn Besucher:innen im Cookie-Banner die Option **Marketing** akzeptieren. Erscheint die Option nicht, ist keine Tracking-Integration aktiv oder Marketing wurde zuvor bewusst abgelehnt. Prüfe außerdem, ob die Partner ID korrekt eingetragen und die Integration aktiviert ist.
  </Accordion>

  <Accordion title="Ich kann die Partner ID oder das Zugriffstoken nicht speichern">
    Solange die Integration aktiv ist, sind diese Felder gesperrt. Deaktiviere die Integration zuerst über den **Toggle**, ändere die Werte, speichere und aktiviere danach wieder. Wird die Partner ID abgelehnt („Ungültiges Tracking-Pixel"), enthält sie unerlaubte Zeichen wie Leerzeichen oder Klammern.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** LinkedIn Ads ist eine reine Tracking-/Conversion-Integration, keine Datensync- oder Kalender-Integration. anny liest keine Daten aus LinkedIn (einseitig: nur Meldung von Conversions). Kein sichtbares Conversion-Protokoll in anny; Kontrolle nur im LinkedIn Campaign Manager. Gehört zur Gruppe der Tracking-Integrationen zusammen mit Google Ads, Meta Ads und TikTok Ads (gemeinsame Marketing-Einwilligung, gemeinsame Ereignisse).
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **LinkedIn Ads**. Drei Panels: **LinkedIn Insight Tag** (Feld **Partner ID**), **LinkedIn Ads Conversion-Tracking** (Button **Conversion Aktion hinzufügen**; Dialog mit **Event Typ** + **Conversion ID**), **Offline conversion API** (Feld **Zugriffstoken**). Aktivieren/Deaktivieren: **Toggle** oben rechts; Löschen: **drei Punkte** → **Löschen**. Event-Typ-Optionen: **Seite ansehen**, **In den Warenkorb legen**, **Checkout starten**, **Checkout abschließen**.
>
> **Quirks:** (1) Nur die Partner ID ist Pflicht; Zugriffstoken und Conversion Aktionen sind optional. (2) Partner ID wird beim Aktivieren auf erlaubte Zeichen geprüft; Fehler „Ungültiges Tracking-Pixel". (3) Insight Tag lädt auf allen öffentlichen Buchungsseiten (Ressource, Service, Explore/Organisation, Abo, Buchungspaket, Checkout, Bestätigung) inkl. eingebettetem Widget, nicht im Admin-Bereich, und nur bei akzeptierter Marketing-Cookie-Option. Widerruf stoppt Tracking sofort ohne Reload. (4) Seitenaufrufe zählt das Insight Tag automatisch; Event Typ **Seite ansehen** ist nur für zusätzliche Conversion-Wertung. (5) Conversion-Wert = Nettobetrag + Währung des Auftrags, 0 bei kostenlosen Buchungen. (6) Offline conversion API: Klick-ID wird beim ersten Seitenaufruf serverseitig gespeichert, 14 Tage gültig, erster Klick gewinnt (kein Überschreiben, auch nicht durch andere Plattformen). Meldung bei Abschluss von Buchung, Abo, Buchungspaket, pro Auftrag getrennt, unabhängig von Cookie-Einwilligung. Ohne Klick-ID keine Offline-Conversion (reiner UTM-Link genügt nicht). (7) Serverseitige Meldung sendet: Conversion-Regel, Zeitpunkt, Nettobetrag, Währung, Klick-ID, Ereignis-Kennung mit Auftragsnummer; keine Namen/E-Mails/Buchungsdetails. (8) Einstellungen nur bei deaktivierter Integration änderbar; Ablauf deaktivieren → ändern → speichern → aktivieren. Änderungen greifen erst mit dem Aktivieren. (9) Deaktivieren entfernt Partner ID von der Buchungsseite und stoppt beide Meldewege; Löschen deaktiviert zuerst automatisch und entfernt alle Felder, LinkedIn-seitige Regeln/Conversions bleiben.
>
> **Beziehungen:** Plan-Gating über Feature „Conversion Tracking" (konkreter Plan aus dem Code nicht ableitbar, nicht benennen). Eingebettete Buchungsseite (Widget) sendet Tracking-Ereignisse zusätzlich an die Elternseite (postMessage-Prinzip), unabhängig von LinkedIn und ohne anny-Cookie-Einwilligung, da dabei keine Daten an LinkedIn gehen. Datenschutz: Klick-ID wird 14 Tage serverseitig gespeichert und beim Abschluss auch ohne Marketing-Einwilligung an LinkedIn gemeldet (konsistent mit utm-tracking.mdx „Offline Conversion API"); rechtlich/Datenschutzhinweise prüfen. Verwandte Artikel: utm-tracking, datenschutz, sowie die übrigen Tracking-Integrationen.


# Microsoft 365 mit anny verbinden
Source: https://docs.anny.co/m365-workspace

Synchronisiere Raum- und Personenkalender deiner Microsoft 365 Organisation in Echtzeit mit deinen anny Ressourcen.

[Microsoft 365](https://www.microsoft.com/de-de/microsoft-365) ist die Cloud-Plattform von Microsoft mit Outlook-Kalendern für Personen sowie Raum- und Ressourcenpostfächern. Mit der Integration verbindet anny deine Ressourcen direkt mit diesen Kalendern: Eine Zwei-Wege-Synchronisation hält Buchungen und Termine auf beiden Seiten aktuell.

Mit Microsoft 365 kannst du in anny:

* Raum-, Ressourcen- und Personenkalender deiner Organisation mit anny Ressourcen koppeln (2-Wege-Synchronisation in Echtzeit)
* Kalendertermine automatisch als Blocker oder als Buchungen in anny übernehmen und Doppelbuchungen vermeiden
* Für Buchungen automatisch Teams-Meetings mit Einladung an Kund:innen erstellen

Die Integration richtet sich an Organisationen, die ihre Microsoft-365-Umgebung zentral verwalten: Ein:e Administrator:in verbindet einmalig die gesamte Organisation, ohne dass sich einzelne Mitarbeiter:innen anmelden müssen. Für die Anbindung einzelner persönlicher Postfächer gibt es die persönliche Outlook-Integration; einen Vergleich findest du im Übersichtsartikel [Kalenderintegrationen](/calendar-integrations).

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Meetingräume mit Raumpostfach | **Ein Raum ist über anny und Outlook gleichzeitig buchbar, ohne Doppelbuchungen.** Termine aus dem Raumpostfach blocken die Ressource in anny, anny Buchungen erscheinen als Termine im Raumkalender. |
| Personenkalender für Beratung & Services | **Buchungen landen direkt im Kalender der zuständigen Person.** Bestehende Termine der Person blocken ihre Verfügbarkeit in anny, private Termine bleiben anonym. |
| Online-Termine mit Teams | **Jede Buchung erhält automatisch ein Teams-Meeting.** Kund:innen und Teilnehmer:innen werden als Eingeladene hinzugefügt und bekommen den Teilnahme-Link über den Kalender. |

## Wie die Microsoft-365-Verbindung funktioniert

Die Verbindung wird auf Organisations-Ebene hergestellt. Ein:e Administrator:in deiner Microsoft-365-Organisation klickt in anny auf **Autorisieren**, meldet sich bei Microsoft an und erteilt die Zustimmung für die Organisation (Admin Consent). Danach kann anny auf die Kalender der Benutzer:innen sowie der Raum- und Ressourcenpostfächer zugreifen. Einzelne Mitarbeiter:innen müssen sich nicht anmelden.

anny greift nur auf die Kalender zu, die du in den Einstellungen ausdrücklich mit einer Ressource verknüpfst; synchronisiert wird jeweils der Hauptkalender des ausgewählten Kontos. Widerrufst du die Zustimmung im Microsoft-Admin-Center, deaktiviert sich die Integration selbst und benachrichtigt die Admins.

| Daten | Richtung | Häufigkeit |
| :- | :- | :- |
| Buchungen (bestätigt und angefragt) werden als Termine angelegt, aktualisiert und bei Stornierung gelöscht | anny → Microsoft 365 | Sofort bei jeder Änderung |
| Termine werden als Blocker oder Buchungen übernommen, aktualisiert und bei Löschung entfernt | Microsoft 365 → anny | In Echtzeit per Push-Benachrichtigung von Microsoft |
| Kontenliste der Organisation (Name und E-Mail) für die Kalender-Auswahl | Microsoft 365 → anny | Beim Bearbeiten der Einstellungen |

Synchronisiert wird der Zeitraum ab heute bis rund 12 Monate im Voraus; anny verlängert diesen Zeitraum automatisch. Vergangene Termine werden nicht importiert. Nach der Aktivierung importiert anny zunächst alle zukünftigen Termine und Buchungen, danach kommen Änderungen laufend in Echtzeit an.

## Microsoft 365 verbinden

### Voraussetzungen

Bevor du Microsoft 365 verbindest, stelle sicher, dass du Folgendes hast:

* Eine Microsoft-365-Organisation mit Exchange-Online-Postfächern (Cloud, nicht On-Premise)
* Administrator-Rechte in Microsoft 365, um die Zustimmung für die Organisation zu erteilen
* Admin-Rechte in deinem anny Account
* Die Kalender, die du verbinden möchtest, existieren bereits (z. B. Raumpostfächer für deine Räume)

### Verbindung einrichten

<Steps>
  <Step title="Integration erstellen">
    Öffne aus der Menüleiste die **Integrationen** und wähle **Microsoft 365** aus.
  </Step>

  <Step title="Autorisieren">
    Klicke auf **Autorisieren**. Du wirst zu Microsoft weitergeleitet: Melde dich mit einem Administrator-Konto deiner Organisation an und erteile die Zustimmung. Danach kehrst du automatisch zu anny zurück.
  </Step>

  <Step title="Verbindungen anlegen">
    Lege im Panel **Einstellungen für die Kalendersynchronisierung** fest, welche Kalender mit welchen Ressourcen gekoppelt werden:

    1. Klicke auf **Hinzufügen**.
    2. Wähle unter **Wähle die zu synchronisierende Ressource:** die anny Ressource.
    3. Wähle unter **Microsoft Kalender** das Konto (Person oder Raum-/Ressourcenpostfach), dessen Kalender synchronisiert werden soll. Über die Suche findest du Konten anhand der E-Mail-Adresse.
    4. Passe bei Bedarf die weiteren Optionen an (siehe Einstellungen & Optionen).
    5. Klicke auf **Bestätigen** und wiederhole die Schritte für weitere Kalender.
  </Step>

  <Step title="Aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. anny prüft die Verbindungen und startet den Initial-Sync.
  </Step>
</Steps>

Sobald die Integration aktiv ist, werden alle zukünftigen Termine und Buchungen abgeglichen und Änderungen laufend in Echtzeit synchronisiert.

<Tip>
  Nutze nach dem Anlegen einer Verbindung die Aktion **Fehlerdiagnose** in der Regel-Tabelle. Sie prüft unter anderem, ob der Kalender erreichbar ist, ob automatische Antworten aktiv sind und ob sich andere Integrationen oder ICS-Importe mit dem Kalender überschneiden.
</Tip>

### Einstellungen & Optionen

Jede Verbindung (Zeile in der Tabelle) hat eigene Einstellungen. Zum Bearbeiten muss die Integration deaktiviert sein.

| Einstellung | Beschreibung |
| :- | :- |
| Buchungsoptionen auswählen | Nur Buchungen der ausgewählten Buchungsoptionen werden in den Kalender synchronisiert. Ohne Auswahl gilt **Alle Buchungsoptionen**. |
| Als Online-Meeting erstellen | Für synchronisierte Buchungen wird der Termin als Teams-Meeting erstellt. Kund:in und Teilnehmer:innen werden als Eingeladene hinzugefügt und erhalten den Teilnahme-Link. |
| Vor- und Nachbereitungszeit hinzufügen | Der Termin im Kalender umfasst zusätzlich die Vor- und Nachbereitungszeit der Buchung (z. B. wird eine Buchung von 30 Minuten mit 15 Minuten Vorbereitungszeit als Termin über 45 Minuten angelegt). |
| Alle Ereignisse synchronisieren | Standardmäßig ignoriert anny Termine mit dem Status „frei" oder „an einem anderen Ort tätig". Mit dieser Option werden auch sie als Blocker bzw. Buchung übernommen. |
| Termine als Blocker anlegen | Eingehende Termine werden als Blocker angelegt. Deaktivierst du die Option, musst du einen **Standardservice für Buchungen** wählen: Termine werden dann als bestätigte Buchungen mit diesem Service erstellt, inklusive Organisator:in als Kund:in und Teilnehmer:innen. |
| Termine anonymisieren | Alle übernommenen Termine erhalten in anny einen anonymen Betreff. Als privat oder vertraulich markierte Termine werden immer anonymisiert, auch ohne diese Option. |
| Bestehende Blocker in Buchungen umwandeln | Erscheint beim Umstellen einer Verbindung von Blocker auf Buchungen: Bereits erstellte Blocker dieser Verbindung werden beim nächsten Aktivieren neu synchronisiert und in Buchungen umgewandelt. |

In der Buchungsansicht zeigt das Panel **Kalender-Synchronisation** für jede synchronisierte Buchung die Quelle, den verbundenen Kalender und die Richtung der Synchronisation. Dort findest du auch den Link **Ereignis im externen Kalender anzeigen** und den Button **Kalender neu synchronisieren**.

## Einschränkungen

Die Microsoft-365-Integration unterstützt nicht:

* **On-Premise-Postfächer:** Es funktionieren nur Exchange-Online-Kalender in der Cloud. Nicht erreichbare Postfächer werden mit „Microsoft-Kalender nicht erreichbar" markiert und übersprungen.
* **Unterkalender:** Synchronisiert wird immer der Hauptkalender des ausgewählten Kontos, keine zusätzlichen Kalender eines Postfachs.
* **Vergangene Termine:** Importiert werden nur Termine ab dem Tag der Aktivierung; ältere Einträge bleiben unberührt.
* **Doppelte Verbindungen:** Jeder Kalender kann nur in einer Verbindung verwendet werden. Ist eine Ressource zusätzlich über eine persönliche Outlook-Integration verbunden, lässt sich die Integration nicht aktivieren.
* **Bearbeiten im aktiven Zustand:** Verbindungen lassen sich nur ändern, solange die Integration deaktiviert ist.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, stoppt die Synchronisation sofort; bereits synchronisierte Termine, Blocker und Buchungen bleiben auf beiden Seiten bestehen. Wenn du die Integration löschst, entfernt anny die dadurch erstellten Synchronisierungen: Von anny angelegte Termine werden aus den Microsoft-Kalendern gelöscht und aus Terminen erstellte Blocker und Buchungen aus anny entfernt. Beim Löschen wählst du, ob das für **Nur zukünftige Synchronisierungen** oder **Alle Synchronisierungen (einschließlich vergangene)** gilt.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zur persönlichen Outlook-Integration?">
    Die Microsoft-365-Integration verbindet die gesamte Organisation: Ein:e Administrator:in autorisiert einmalig, danach lassen sich beliebige Personen- und Raumkalender der Organisation mit Ressourcen koppeln. Bei der persönlichen Outlook-Integration meldet sich dagegen jede Person mit dem eigenen Konto an. Mehr dazu im Übersichtsartikel [Kalenderintegrationen](/calendar-integrations).
  </Accordion>

  <Accordion title="Welche Kalender kann ich verbinden?">
    Alle Konten deiner Microsoft-365-Organisation, die eine E-Mail-Adresse haben: Benutzer:innen ebenso wie Raum- und Ressourcenpostfächer. Synchronisiert wird jeweils der Hauptkalender des Kontos. In der Auswahl **Microsoft Kalender** kannst du nach der E-Mail-Adresse suchen.
  </Accordion>

  <Accordion title="Werden private Termine übernommen?">
    Ja, aber ohne Inhalt: Als privat oder vertraulich markierte Termine erscheinen in anny immer mit einem anonymen Betreff. Mit der Option **Termine anonymisieren** kannst du zusätzlich alle Termine einer Verbindung anonymisieren.
  </Accordion>

  <Accordion title="Was passiert, wenn eine Buchung storniert wird?">
    anny löscht den zugehörigen Termin im Microsoft-Kalender. Umgekehrt gilt: Wird ein Termin im Kalender gelöscht, entfernt anny den Blocker bzw. storniert die daraus entstandene Buchung.
  </Accordion>

  <Accordion title="Wie schnell werden Änderungen synchronisiert?">
    Buchungsänderungen aus anny werden sofort übertragen. Änderungen im Kalender meldet Microsoft per Push-Benachrichtigung, meist innerhalb von Sekunden. Bei sehr vielen Änderungen auf einmal kann Microsoft die Verbindung kurz drosseln; anny holt die Änderungen danach automatisch nach.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ein Kalender wird nicht synchronisiert">
    Meist ist das Postfach nicht erreichbar, etwa weil es On-Premise liegt oder nicht mehr existiert; die Verbindung ist dann mit „Microsoft-Kalender nicht erreichbar" markiert und wird übersprungen. Deaktiviere die Integration, prüfe die Verbindung über die Aktion **Fehlerdiagnose**, korrigiere den Kalender und aktiviere die Integration erneut. Beim Aktivieren setzt anny den Fehler zurück und versucht es noch einmal.
  </Accordion>

  <Accordion title="Die Integration hat sich selbst deaktiviert">
    Die Autorisierung ist ungültig geworden, zum Beispiel weil die Zustimmung im Microsoft-Admin-Center widerrufen oder eingeschränkt wurde, oder Microsoft hat die Push-Verbindung dauerhaft abgelehnt. Die betroffenen Admins erhalten eine Benachrichtigung mit dem Grund. Klicke auf **Autorisieren**, erteile die Zustimmung erneut und aktiviere die Integration wieder.
  </Accordion>

  <Accordion title="Termine oder Blocker erscheinen doppelt">
    Der Kalender oder die Ressource ist mehrfach verbunden, zum Beispiel zusätzlich über eine persönliche Outlook-Integration oder einen ICS-Import/-Export der Ressource. Die Aktion **Fehlerdiagnose** zeigt solche Überschneidungen an. Entferne die doppelte Verbindung und synchronisiere anschließend über **Kalender neu synchronisieren** in der betroffenen Buchung.
  </Accordion>

  <Accordion title="Eine Buchung erscheint nicht im Kalender">
    Prüfe, ob die Buchung zu den in **Buchungsoptionen auswählen** gewählten Buchungsoptionen gehört und ob sie bestätigt oder angefragt ist; abgelehnte und stornierte Buchungen werden nicht übertragen. Buchungen, die weiter als etwa 12 Monate in der Zukunft liegen, werden erst synchronisiert, sobald sie in den Synchronisations-Zeitraum rücken.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Dieser Artikel behandelt die organisationsweite Integration „Microsoft 365" (Admin Consent für den gesamten Tenant, App-Zugriff ohne Nutzer-Login). NICHT gemeint sind: die persönliche Outlook-Integration (Login pro Person, Artikel „Outlook"), das Outlook-Add-In, die MS-Teams-App und die MS-Teams-Videomeeting-Integration. Das Google-Pendant ist „Google Workspace".
>
> **UI-Pfade:** Menüleiste → **Integrationen** → **Microsoft 365**. Authentifizierung: Panel mit Button „Autorisieren" (OAuth-Weiterleitung zu Microsoft Admin Consent). Regeln: Panel „Einstellungen für die Kalendersynchronisierung" → Button „Hinzufügen" → Modal „Microsoft-Verbindung erstellen"/„Microsoft-Verbindung bearbeiten". Felder exakt: „Wähle die zu synchronisierende Ressource:", „Buchungsoptionen auswählen", „Microsoft Kalender", „Als Online-Meeting erstellen", „Vor- und Nachbereitungszeit hinzufügen", „Alle Ereignisse synchronisieren", „Termine als Blocker anlegen", „Standardservice für Buchungen", „Termine anonymisieren", Checkbox „Bestehende Blocker in Buchungen umwandeln". Tabellen-Spalten: „Ressource", „Kalender", „Buchungsoptionen", „Sync als" (Werte „Blocker" / „Buchung ()"), „Online-Meetings". Regel-Aktionen (nur bei deaktivierter Integration): „Fehlerdiagnose", „Bearbeiten", „Löschen". Integration-Aktionen: „Integration aktivieren", „Integration deaktivieren", „Einstellungen öffnen", „Verbindung testen", „Löschen".
>
> **Quirks:** (1) Sync-Zeitraum: heute bis 365 Tage voraus, wird alle 30 Tage um 30 Tage verlängert. (2) Ausgehend synchronisiert werden Buchungen mit Status bestätigt, angefragt und eingeladen; Buchungen von Unterressourcen einer verknüpften Ressource werden über die Regel der Elternressource mitsynchronisiert. (3) Erstellte Termine erhalten die Kategorie „anny " und als Beschreibung die Buchungsinfos; Terminname ist immer der Buchungsname (Fallback Buchungsnummer), nicht konfigurierbar. (4) Eingehende Termine mit Status „frei"/„an einem anderen Ort tätig" werden standardmäßig ignoriert; wechselt ein bestehender Termin auf „frei", wird der Blocker entfernt (Behandlung wie Löschung). (5) Serientermine aus Microsoft: jedes Vorkommen wird einzeln als Blocker/Buchung geführt; Teil-Änderungen und Teil-Löschungen der Serie werden nachgezogen. (6) Ganztägige Termine werden auf Tagesgrenzen in der Zeitzone der Ressource gesetzt. (7) Bei „Standardservice für Buchungen": Organisator:in des Termins wird als Kund:in angelegt bzw. per E-Mail einem bestehenden Kundenprofil zugeordnet (außer sie ist selbst Kalenderbesitzer:in); Teilnehmer:innen werden Buchungsteilnehmer:innen; es werden keine Kunden-Benachrichtigungen verschickt. Wird der Quell-Termin gelöscht, wird die Buchung storniert (nicht gelöscht), ein Blocker wird gelöscht. (8) Aktivierung schlägt fehl mit „Doppelte Integration" („Es darf jeweils nur eine Integration bestehen, die denselben (Unter-)Kalender und dieselbe Ressource verbindet."), wenn derselbe Kalender in zwei Regeln steckt oder eine Ressource zusätzlich per persönlicher Outlook-Integration verbunden ist. (9) Nicht erreichbares Postfach (404, z. B. On-Premise): Regel-Fehler „Microsoft-Kalender nicht erreichbar", Regel wird übersprungen, Fehler wird bei erneuter Aktivierung zurückgesetzt. Schlägt die Webhook-Einrichtung mit Serverfehlern fehl, wird nach 3 Versuchen (Abstände ca. 30 min / 2,5 h / 5 h) die Regel mit Fehler markiert und benachrichtigt; übrige Regeln laufen weiter. (10) Push-Verbindungen (Webhook-Subscriptions) laufen knapp 3 Tage und werden automatisch erneuert. (11) Bei Microsoft-Drosselung (HTTP 429/503) pausiert die Integration und arbeitet den Rückstand danach automatisch ab. (12) Änderungen, die anny selbst im Kalender vorgenommen hat, werden als Echo erkannt und nicht zurücksynchronisiert. (13) Löschen einer Regel (bei deaktivierter Integration) entfernt die Synchronisierungen dieser Regel; Löschen der Integration fragt nach dem Umfang („Nur zukünftige Synchronisierungen" / „Alle Synchronisierungen (einschließlich vergangene)"). Scheitert die Löschung, wird sie abgebrochen und benachrichtigt. (14) Ressource gelöscht → Regel wird entfernt; Service gelöscht → aus Regel-Filtern entfernt, war er Standardservice, stellt die Regel auf Blocker um. (15) Mehrere Microsoft-365-Integrationen pro Organisation sind möglich („Weitere Integration erstellen").
>
> **Beziehungen:** Feature-Gating über das Plan-Feature Kalendersynchronisation (gemeinsam mit Outlook, Google Kalender, Google Workspace); Plan-Zuordnung nicht im Artikel dokumentiert. Verwandte Artikel: „Kalenderintegrationen" (Übersicht, Vergleich persönlich vs. Workspace), „Outlook" (persönlich), „Google Workspace" (Pendant), „Outlook-Add-In" (Buchen aus Outlook heraus). Das Buchungs-Panel „Kalender-Synchronisation" zeigt Quelle „Microsoft 365", „Name des Accounts", „Name des Kalenders", Richtung („Das Kalenderereignis wurde aufgrund dieser Buchung erstellt." / „Die Buchung wurde aufgrund des Kalenderereignisses erstellt."), Link „Ereignis im externen Kalender anzeigen" und Button „Kalender neu synchronisieren" (voller Neuabgleich, nur bei aktiver Integration).


# make.com mit anny verbinden
Source: https://docs.anny.co/make-com

Verbinde anny per Webhooks und API mit Make.com und automatisiere deine Buchungs-Workflows ohne Programmierung.

[Make.com](https://www.make.com) ist eine Automatisierungsplattform, auf der du Tools ohne Programmierung in visuellen Szenarien verbindest. Ein Szenario reagiert auf ein Ereignis in einem System und führt daraufhin Aktionen in anderen aus. anny bindest du an Make.com über zwei allgemeine Bausteine an: **Webhooks** senden Ereignisse aus anny an Make, und über die anny **API** löst Make Aktionen in anny aus.

Mit Make.com kannst du in anny:

* auf Ereignisse reagieren, etwa auf eine neue Buchung, eine Stornierung oder neue Kund:innen, und die Daten in anderen Tools weiterverarbeiten
* Buchungen, Bestellungen, Rechnungen und Kund:innen automatisch in andere Systeme wie Tabellen, Chat oder dein CRM übertragen
* Aktionen in anny aus einem Make-Szenario heraus auslösen, zum Beispiel Buchungen oder Kund:innen anlegen

Ideal für Teams, die anny ohne eigene Programmierung mit Tools wie Google Sheets, Slack oder ihrem CRM verbinden möchten.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Neue Buchung in einer Tabelle festhalten | **Jede neue Buchung landet automatisch in deiner Tabelle.** anny sendet das Ereignis an dein Make-Szenario, das daraus eine neue Zeile in Google Sheets anlegt. |
| Team bei Stornierungen benachrichtigen | **Dein Team erfährt sofort von Änderungen.** Wird eine Buchung gelöscht, postet Make automatisch eine Nachricht in Slack oder Microsoft Teams. |
| Kund:innen ins CRM übernehmen | **Neue Kund:innen wandern automatisch in dein CRM.** Sobald anny eine:n neue:n Kund:in anlegt, erstellt Make den passenden Kontakt in deinem CRM. |

## Wie die Make.com-Verbindung funktioniert

Make.com ist kein fest eingebautes Modul in anny und erscheint nicht in der Integrationen-Liste. Du verbindest beide Systeme über den Tab **API & Webhooks** in den **Einstellungen** deiner Organisation. Dort richtest du zwei Dinge ein:

* Einen **Personal Access Token** für den Zugriff auf die anny API. Make authentifiziert sich damit als vertrauenswürdiger Zugang zu deiner Organisation. Über den Token kann Make die Daten lesen und anlegen, die auch ein Admin über die API erreicht (zum Beispiel Buchungen, Bestellungen, Rechnungen und Kund:innen).
* Ein oder mehrere **Webhook-Abonnements**, die Ereignisse aus anny an eine von dir angegebene Endpunkt-URL senden. Diese URL stammt aus deinem Make-Szenario.

Widerrufst du den Zugang, endet die Verbindung sofort: Löschst oder rotierst du den Token, kann Make nicht mehr auf die anny API zugreifen. Deaktivierst oder löschst du das Webhook-Abonnement, sendet anny keine Ereignisse mehr an Make.

So laufen die Daten zwischen anny und Make:

| Richtung | Baustein | Beispiele |
| :- | :- | :- |
| anny → Make (Auslöser) | Webhook-Abonnement | Buchung erstellt, Buchung eingecheckt, Bestellung erstellt, Kund:in erstellt |
| Make → anny (Aktionen) | anny API mit Personal Access Token | Buchung lesen oder anlegen, Kund:in anlegen |

<Tip>
  anny signiert jeden Webhook-Aufruf mit einem **Signaturschlüssel**. In Make kannst du damit prüfen, dass ein eingehender Aufruf wirklich von anny stammt.
</Tip>

## Make.com verbinden

### Voraussetzungen

Bevor du Make.com verbindest, stelle sicher, dass du Folgendes hast:

* Zugriff auf den Tab **API & Webhooks** in den Organisations-Einstellungen (Admin-Rechte)
* Ein Make.com-Konto
* Ein Szenario in Make mit einem **Webhook**-Modul für Auslöser und, falls du Aktionen in anny auslösen willst, einem **HTTP**-Modul für die anny API

### Verbindung einrichten

<Steps>
  <Step title="Personal Access Token erstellen">
    Öffne **Einstellungen** und gehe zum Tab **API & Webhooks**. Klicke im Bereich **Personal Access Tokens** auf **Token erstellen**, vergib einen **Token-Name** (z. B. „Make.com") und kopiere den Token sofort. anny zeigt ihn nur einmal an.
  </Step>

  <Step title="Webhook-URL in Make vorbereiten">
    Lege in Make ein Szenario an und füge ein **Webhook**-Modul als Auslöser hinzu. Make erzeugt dafür eine eindeutige URL. Kopiere diese URL.
  </Step>

  <Step title="Webhook-Abonnement in anny anlegen">
    Klicke im Bereich **Webhooks** auf **Webhook erstellen**. Trage einen **Namen** und die kopierte URL als **Endpunkt-URL** ein, wähle unter **Auswahl der Events** die gewünschten Ereignisse und aktiviere den **Aktiv**-Schalter. Optional beschränkst du Buchungsereignisse auf bestimmte Ressourcen, Gruppen oder Kategorien. Speichere das Abonnement.
  </Step>

  <Step title="Aktionen über die anny API einrichten">
    Möchtest du aus Make heraus Daten in anny anlegen oder lesen, füge in deinem Szenario ein **HTTP**-Modul hinzu und hinterlege den Personal Access Token als Bearer-Token. Die verfügbaren Endpunkte findest du in der API-Dokumentation von anny.
  </Step>
</Steps>

Sobald das Webhook-Abonnement aktiv ist, sendet anny bei jedem ausgewählten Ereignis die Daten an dein Make-Szenario.

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Name | Frei wählbare Bezeichnung des Webhook-Abonnements. |
| Endpunkt-URL | Die Adresse, an die anny die Ereignisse sendet (die Webhook-URL aus deinem Make-Szenario). |
| Auswahl der Events | Die Ereignisse, die den Webhook auslösen, gruppiert in **Buchungen**, **Bestellungen**, **Rechnungen**, **Kunden**, **Abonnements**, **Termine** und **Community-Mitglieder**. Die einzelnen Ereignisse erscheinen als technische Bezeichnungen wie `bookings.created`. |
| Aktiv | Schaltet das Abonnement ein oder aus. Nur aktive Abonnements senden Ereignisse. |
| Einschränkungen | Optional: begrenzt Buchungsereignisse auf bestimmte Ressourcen, Gruppen oder Kategorien. |
| Signaturschlüssel | Automatisch erzeugt und schreibgeschützt. anny signiert damit jeden Aufruf, damit du die Echtheit in Make prüfen kannst. |

<Tip>
  Über **Aufrufverlauf anzeigen** siehst du pro Abonnement die Webhook-Versuche der letzten 30 Tage mit Status, HTTP-Statuscode und Antwort. Fehlgeschlagene Aufrufe kannst du dort manuell erneut auslösen.
</Tip>

## Einschränkungen

Die Anbindung an Make.com über Webhooks und die anny API unterstützt nicht:

* **Fertiges anny-Modul:** anny hat keinen vorgefertigten Connector im Make-Marktplatz. Du baust die Verbindung mit den generischen Modulen von Make (Webhook, HTTP).
* **Feingranulare Berechtigungen:** Die Auswahl einzelner Berechtigungen für einen Token ist noch nicht verfügbar. Ein Token erhält Zugriff auf alle über die API erreichbaren Daten deiner Organisation.
* **Eigene Kopfzeilen:** Ein Webhook-Abonnement sendet keine benutzerdefinierten HTTP-Header. Zur Absicherung dient der Signaturschlüssel.
* **Deutsche Ereignisnamen:** Die einzelnen Ereignisse zeigt anny als technische Bezeichnungen (z. B. `bookings.created`), nicht als übersetzte Namen.

## Verbindung trennen

<Warning>
  Löschst oder rotierst du den Personal Access Token, kann Make nicht mehr auf die anny API zugreifen, und bestehende Szenarien schlagen fehl. Deaktivierst oder löschst du das Webhook-Abonnement, sendet anny keine Ereignisse mehr an Make.
</Warning>

Beides findest du unter **Einstellungen** im Tab **API & Webhooks**: den Token über **Rotieren** oder Löschen, das Webhook-Abonnement über den **Aktiv**-Schalter oder Löschen.

## FAQ

<AccordionGroup>
  <Accordion title="Gibt es ein fertiges anny-Modul in Make.com?">
    Nein. Du verbindest anny und Make über die generischen Bausteine: ein Webhook-Modul in Make empfängt die Ereignisse aus anny, und ein HTTP-Modul spricht die anny API an. Ein branded anny-Connector im Make-Marktplatz existiert nicht. Für n8n gibt es dagegen den offiziellen Community-Node, siehe [n8n](/n8n).
  </Accordion>

  <Accordion title="Welche Ereignisse kann ich an Make senden?">
    Ereignisse aus den Kategorien Buchungen, Bestellungen, Rechnungen, Kunden, Abonnements, Termine und Community-Mitglieder, zum Beispiel eine neue Buchung, ein Check-In oder eine neue Rechnung. Du wählst sie beim Anlegen des Webhook-Abonnements aus.
  </Accordion>

  <Accordion title="Wie sichere ich meine Webhooks ab?">
    Jedes Abonnement hat einen automatisch erzeugten Signaturschlüssel. anny signiert damit jeden Aufruf. In deinem Make-Szenario kannst du die Signatur prüfen und so sicherstellen, dass der Aufruf wirklich von anny stammt.
  </Accordion>

  <Accordion title="Wo sehe ich, ob ein Ereignis zugestellt wurde?">
    Über **Aufrufverlauf anzeigen** beim jeweiligen Webhook-Abonnement. Dort siehst du die Versuche der letzten 30 Tage mit Status, HTTP-Statuscode, Anfrage und Antwort.
  </Accordion>

  <Accordion title="Brauche ich Programmierkenntnisse?">
    Nein, du klickst die Szenarien in Make zusammen. Ein Grundverständnis von Webhooks und HTTP-Anfragen hilft aber beim Einrichten der Verbindung.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Make empfängt keine Ereignisse aus anny">
    Das Webhook-Abonnement ist möglicherweise nicht aktiv, die Endpunkt-URL stimmt nicht, oder es sind nicht die passenden Ereignisse ausgewählt. Prüfe den **Aktiv**-Schalter, die **Endpunkt-URL** und die ausgewählten Ereignisse. Über **Aufrufverlauf anzeigen** siehst du, ob und mit welchem Status anny gesendet hat.
  </Accordion>

  <Accordion title="Mein Webhook wurde automatisch deaktiviert">
    anny deaktiviert ein Abonnement, dessen Aufrufe wiederholt fehlschlagen. Ursache ist meist eine nicht erreichbare oder falsche Endpunkt-URL. Korrigiere die URL in Make und in anny und aktiviere das Abonnement wieder über den **Aktiv**-Schalter.
  </Accordion>

  <Accordion title="API-Anfragen aus Make schlagen fehl">
    Der Personal Access Token ist wahrscheinlich abgelaufen, wurde rotiert oder gelöscht. Erstelle im Tab **API & Webhooks** einen neuen Token und hinterlege ihn im HTTP-Modul deines Make-Szenarios.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Make.com ist KEINE fest eingebaute anny-Integration. Es gibt kein Backend-Modul, keinen Eintrag in der Integrationen-Liste und keinen Integrations-Toggle. Die Anbindung läuft rein über zwei generische anny-Bausteine: Personal Access Tokens (API-Zugriff) und Webhook-Abonnements (Auslöser). anny selbst erwähnt „Make"/„Make.com"/„Zapier" nirgends; ob es einen offiziellen anny-Connector im Make-Marktplatz gibt, ist aus dem Code nicht belegbar.
>
> **UI-Pfade:** Einrichtung nicht unter „Integrationen", sondern unter **Einstellungen → Tab „API & Webhooks"**. Dort zwei Bereiche: **„Personal Access Tokens"** (Button „Token erstellen", Feld „Token-Name"; Aktionen „Rotieren"/Löschen; Token wird nur einmal angezeigt) und **„Webhooks"** (Tabelle „Webhook-Abonnements", Button „Webhook erstellen"; Felder „Name", „Endpunkt-URL", „Aktiv", „Auswahl der Events", optional Einschränkungen; Signaturschlüssel schreibgeschützt). Zustellungen über „Aufrufverlauf anzeigen".
>
> **Auth & API:** Make authentifiziert sich mit dem Personal Access Token als Bearer-Token gegen die anny JSON:API unter `/api/v1`. Feingranulare Token-Berechtigungen (Scopes) sind im UI noch nicht wählbar („Berechtigungen demnächst verfügbar"); ein Token ohne gesetzte Scopes hat aktuell Vollzugriff auf die Organisation. Sicherheitsrelevant.
>
> **Ereignisse (Auslöser):** Kategorien lokalisiert (Buchungen, Bestellungen, Rechnungen, Kunden, Abonnements, Termine, Community-Mitglieder); einzelne Ereignisse NICHT lokalisiert, als technische IDs. Vollständige Liste: `bookings.created/updated/started/ended/checked-in/checked-out/deleted`, `orders.created/updated/deleted`, `invoices.created/finalised/updated/deleted`, `customers.created/updated/deleted`, `subscriptions.created/started/updated/canceled/renewed/suspended/ended/charged/reactivated`, `timeslots.created/updated/started/ended/deleted`, `community-accounts.joined/left`, `call-sessions.completed`.
>
> **Payload:** Umschlag pro Aufruf mit `event`, `event_id`, `webhook_id`, `triggered_at`, `data`. Signatur per HMAC über den Signaturschlüssel des Abonnements (Signature-Header). Keine benutzerdefinierten Header konfigurierbar.
>
> **Quirks:** (1) Webhook-Abonnements werden nach wiederholten Zustellfehlern automatisch deaktiviert; optionale E-Mail „Webhook-Deaktivierungsbenachrichtigung"; danach manuell reaktivieren. (2) Aufrufverlauf zeigt Versuche der letzten 30 Tage; fehlgeschlagene sind manuell wiederholbar, erfolgreiche und bereits wiederholte nicht. (3) Einschränkungen gelten nur für Buchungsereignisse. (4) Der Tab „API & Webhooks" erscheint nur mit der Berechtigung für Webhook-Abonnements; mögliche Plan-Bindung aus dem Code nicht verifizierbar.
>
> **Beziehungen:** Für den Aktions-Weg (Make → anny) dient die anny API; Querverweis auf den API-Dokumentations-Tab, sobald befüllt. Verwandter Automatisierungs-Kontext: „(Automatische) Exporte". Offizieller n8n-Community-Node: `/n8n` (GitHub anny-co/anny-n8n). Make hat KEINEN vergleichbaren branded Connector.


# Zahlungs- & Abomanagement
Source: https://docs.anny.co/manage-subscriptions

Verwalte deine Abonnements, hinterlege Zahlungsmethoden und behalte offene Salden im Blick.

In diesem Bereich verwaltest du alles rund um deine Abonnements und Zahlungsmethoden als Endnutzer:in: Abos abschließen, kündigen, widerrufen, Upgrades/Downgrades durchführen und deine Zahlungsmethode aktualisieren.

## Abo abschließen

<Steps>
  <Step title="Buchungsseite öffnen">
    Öffne die Buchungsseite der Organisation, bei der du ein Abo abschließen möchtest.
  </Step>

  <Step title="Abo auswählen">
    Navigiere zu **Abonnements** und wähle das passende Abo. Der Button heißt **Abonnieren**. Wenn der Anbieter das Abo erst bestätigen muss, heißt er **Jetzt anfragen**.
  </Step>

  <Step title="Checkout ausfüllen">
    Wähle das **Startdatum** (**Sofort** oder ein späteres Datum), hinterlege deine Angaben und wähle eine Zahlungsmethode.
  </Step>

  <Step title="Kostenpflichtig buchen">
    Klicke auf **Kostenpflichtig buchen**, um das Abo zu aktivieren oder die Anfrage zu senden.
  </Step>
</Steps>

## Abo kündigen

<Steps>
  <Step title="Abonnements öffnen">
    Gehe in deinem Profil zu **Abonnements** und wähle den Tab **Aktiv**.
  </Step>

  <Step title="Kündigen">
    Klicke auf die drei Punkte neben dem Abo und wähle **Kündigen**.
  </Step>

  <Step title="Bestätigen">
    Bestätige die Kündigung. Das Abo läuft bis zum Ende der bezahlten Periode weiter. Innerhalb der Widerrufsfrist siehst du zusätzlich **Widerrufen**: Dann endet das Abo sofort und der ungenutzte Restbetrag wird anteilig erstattet.
  </Step>
</Steps>

## Abo upgraden oder downgraden

Öffne **Abonnements** und klicke auf die drei Punkte des aktiven Abos, dann auf **Plan verwalten**.

| Aktion | Wann aktiv? | Abrechnung |
| - | - | - |
| Upgrade | Sofort | Nur die Differenz zum neuen Plan wird berechnet |
| Downgrade | Am Ende der laufenden Periode | Keine Verrechnung, neuer Preis ab nächster Periode |

<Tip>
  Ein Upgrade lohnt sich sofort, da du nur die anteilige Differenz zahlst. Ein Downgrade greift erst mit der nächsten Abrechnungsperiode.
</Tip>

## Zahlungsmethode hinterlegen

Du kannst Zahlungsmethoden an zwei Stellen verwalten:

**Im Profil (für alle zukünftigen Abos und Rechnungen):**

<Steps>
  <Step title="Profil öffnen">
    Navigiere über deinen **Avatar** (oben rechts) zu **Profil** und dann zu **Zahlungsmethoden**.
  </Step>

  <Step title="Methode hinzufügen">
    Klicke auf **Zahlungsmethode hinzufügen**. Je nach Währung und Gerät stehen Kreditkarte, SEPA-Lastschrift, Apple Pay, Google Pay oder PayPal (CHF) zur Verfügung.
  </Step>
</Steps>

**Pro Abo (für ein spezifisches Abonnement):**

<Steps>
  <Step title="Abonnements öffnen">
    Gehe zu **Abonnements** und klicke auf die drei Punkte des aktiven Abos.
  </Step>

  <Step title="Zahlungsmethode aktualisieren">
    Wähle **Zahlungsmethode aktualisieren** und hinterlege die neue Karte oder SEPA-Daten.
  </Step>
</Steps>

## Zahlungsmethode pro Rechnung ändern

Bei einzelnen Rechnungen kannst du die Zahlungsmethode auch individuell anpassen. Öffne dazu die jeweilige Rechnung und ändere die hinterlegte Methode direkt dort.

## Abonnementübersicht

Unter **Abonnements** im Profil siehst du alle deine Abos in diesen Tabs:

* **Alle:** Gesamte Übersicht
* **Aktiv:** Laufende Abos mit aktuellen Konditionen
* **Inaktiv:** Gekündigte oder ausgelaufene Abos
* **Beantragt:** Abos, die auf Bestätigung durch den Anbieter warten

Ein Abo mit Start in der Zukunft erscheint als **Geplant**, bis es aktiv wird.

## Buchungskontingente

Sofern dein Abo Buchungskontingente beinhaltet, siehst du den aktuellen Stand auf der **Home-Seite** deiner Buchungsseite. Kontingente können Mengen (z. B. 10 Buchungen), Zeitbudgets (z. B. 20 Stunden) oder Geldbeträge sein.

## Offene Salden

Wenn du offene Rechnungen hast, werden diese auf der **Home-Seite** unter **Offene Salden** angezeigt. Bezahle offene Beträge, um deine Buchungsfähigkeit aufrechtzuerhalten.

## FAQ

<AccordionGroup>
  <Accordion title="Warum wird mein Upgrade sofort berechnet, aber das Downgrade nicht?">
    Bei einem Upgrade erhältst du sofort Zugang zu den erweiterten Funktionen, daher wird die Differenz direkt abgerechnet. Ein Downgrade greift erst am Periodenende, damit du den bezahlten Zeitraum vollständig nutzen kannst.
  </Accordion>

  <Accordion title="Kann ich meine Zahlungsmethode nachträglich ändern?">
    Ja, sowohl im Profil (gilt für alle zukünftigen Zahlungen) als auch pro Abo über die drei Punkte → **Zahlungsmethode aktualisieren**. Je nach Währung und Gerät stehen Kreditkarte, SEPA, Apple Pay, Google Pay oder PayPal zur Verfügung.
  </Accordion>

  <Accordion title="Mein Abo wurde für mich hinterlegt. Wie hinterlege ich meine Zahlungsmethode?">
    Öffne Abonnements, klicke auf die drei Punkte des aktiven Abos und wähle **Zahlungsmethode aktualisieren**.
  </Accordion>

  <Accordion title="Wo sehe ich meine verbleibenden Kontingente?">
    Auf der Home-Seite deiner Buchungsseite. Dort werden Kontingente angezeigt, sofern dein Abo welche beinhaltet.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Kündigen und Widerrufen?">
    **Kündigen** beendet das Abo zum Periodenende oder zum Ende der Mindestlaufzeit. **Widerrufen** steht nur innerhalb der Widerrufsfrist. Das Abo endet dann sofort, der ungenutzte Restbetrag wird anteilig erstattet.
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="Mein Abo-Downgrade ist nicht sofort aktiv">
    Das ist erwartetes Verhalten. Ein Downgrade greift erst am Ende der aktuellen Abo-Periode, damit du den bezahlten Zeitraum vollständig nutzen kannst.
  </Accordion>

  <Accordion title="Meine Zahlung schlägt fehl">
    Prüfe, ob deine Kreditkarte noch gültig ist und ausreichend Deckung hat. Bei SEPA stelle sicher, dass das Lastschriftmandat korrekt erteilt wurde. Aktualisiere bei Bedarf deine Zahlungsmethode im Profil. Warum einzelne Abo-Rechnungen nicht eingezogen werden: [SEPA-Lastschrift für Abos](/sepa-direct-debit).
  </Accordion>

  <Accordion title="Ich sehe mein Abo nicht unter Aktiv">
    Prüfe die Tabs **Beantragt** und **Alle**. Ein Abo mit Start in der Zukunft erscheint als **Geplant**. Falls es dort ebenfalls nicht erscheint, wende dich an den Anbieter.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad Abonnements: Avatar (oben rechts) → Profil → Abonnements
> * UI-Pfad Zahlungsmethoden: Avatar (oben rechts) → Profil → Zahlungsmethoden
> * CTA auf Plan-Karten: **Abonnieren** bzw. **Jetzt anfragen** (nicht „Jetzt starten“)
> * Checkout ist eine eigene Seite, kein Pop-up. Startdatum immer wählbar (Sofort oder später).
> * Tabs: Alle, Aktiv, Inaktiv, Beantragt. Status zusätzlich **Geplant** vor dem Startdatum.
> * Upgrade: sofort aktiv, Differenzberechnung
> * Downgrade: erst am Periodenende, keine Verrechnung
> * Kündigung: Abo läuft bis zum Ende der bezahlten Periode weiter. **Widerrufen** = sofortiges Ende plus anteilige Erstattung innerhalb der Widerrufsfrist.
> * Gekündigte Abos können vor dem Wirksamkeitsdatum **Fortsetzen**.
> * Zahlungsmethoden: Kreditkarte, SEPA, Apple Pay, Google Pay, PayPal (CHF)
> * Zahlungsmethode kann pro Abo ODER global im Profil geändert werden
> * Buchungskontingente: Anzeige auf Home-Seite, Typen: Menge, Zeit, Geldbetrag
> * Offene Salden: Anzeige auf Home-Seite
> * Abo-Antrag: bei manchen Anbietern muss das Abo manuell bestätigt werden


# Meta Ads mit anny verbinden
Source: https://docs.anny.co/meta-ads-tracking

Miss Seitenaufrufe und Buchungen deiner anny-Buchungsseite als Conversions in Meta Ads und optimiere deine Kampagnen.

[Meta Ads](https://www.facebook.com/business/ads) ist die Werbeplattform von Facebook und Instagram. Das **Meta Pixel** ist ein kleines Skript, das misst, was Besucher:innen auf deiner Buchungsseite tun. Mit der Integration bindet anny dein Meta Pixel automatisch auf deinen öffentlichen anny-Buchungs- und Shop-Seiten ein und meldet Buchungen als Conversions an Meta.

Mit Meta Ads kannst du in anny:

* Seitenaufrufe und Buchungen deiner anny-Buchungsseite direkt an Meta melden
* Abgeschlossene Buchungen als **Kauf**-Conversion mit Bestellwert an Meta übergeben
* Deine Meta-Kampagnen auf tatsächliche Buchungen optimieren und den Werbeerfolg messen

Besonders sinnvoll ist die Integration, wenn du über Facebook- oder Instagram-Anzeigen Besucher:innen auf deine anny-Buchungsseite bringst und wissen willst, welche Anzeigen zu echten Buchungen führen.

<Info>
  Die Meta-Ads-Integration ist Teil der Marketing-Integrationen und benötigt einen entsprechenden Plan. Prüfe deinen Plan oder frage das anny-Team, falls die Integration bei dir nicht auswählbar ist.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Kampagnen auf Buchungen optimieren | **Meta lernt, welche Anzeigen zu Buchungen führen.** anny meldet jede abgeschlossene Buchung als Kauf-Conversion, sodass Meta dein Budget auf die erfolgreichsten Anzeigen lenkt. |
| Werbeerfolg messen | **Du siehst im Events Manager, wie viele Buchungen aus Anzeigen entstehen.** Seitenaufruf, Checkout-Start und Kauf landen als Ereignisse in deinem Meta-Konto. |
| Attribution absichern | **Die Offline Conversion API meldet Käufe zusätzlich server-seitig.** So gehen Conversions auch dann nicht verloren, wenn ein Browser das Pixel blockiert. |

## Wie die Meta-Ads-Verbindung funktioniert

Die Verbindung besteht aus zwei Bausteinen, die du unabhängig voneinander nutzen kannst.

**Meta Pixel im Browser.** Du trägst deine **Pixel ID** ein und aktivierst die Integration. Danach lädt anny das Meta-Pixel-Skript auf deinen öffentlichen anny-Buchungs- und Shop-Seiten und meldet Ereignisse direkt aus dem Browser deiner Besucher:innen an Meta. Für diesen Baustein genügt die Pixel ID.

**Offline Conversion API.** Zusätzlich kannst du einen **Access token** hinterlegen und **Autorisieren**. Damit sendet anny Kauf-Conversions zusätzlich direkt vom anny-Server an Meta, unabhängig vom Browser. Das verbessert die Attribution. Dieser Baustein meldet nur den **Kauf** und feuert nur für Besucher:innen, die über eine Meta-Anzeige auf deine Buchungsseite kamen.

Worauf anny **zugreift**: anny sendet Ereignisse an dein Meta-Konto, das über Pixel ID und Access token bestimmt ist. Worauf anny **nicht** zugreift: anny liest keine Daten aus deinem Meta-Werbekonto und ändert dort nichts. Es werden nur Ereignisse gesendet.

Welche Daten anny beim Kauf an Meta übergibt:

| Daten | Zweck |
| :- | :- |
| Meta-Klick-Kennung der Besucher:in | Ordnet die Buchung der richtigen Anzeige zu |
| Bestellwert (netto) und Währung | Misst den Umsatz der Conversion |
| Bestellnummer und Zeitpunkt | Identifiziert die Buchung eindeutig |

anny übergibt für die Conversion keine Namen und keine E-Mail-Adressen an Meta.

**Cookie-Zustimmung:** Das Meta Pixel lädt im Browser erst, wenn Besucher:innen im Cookie-Banner **Marketing** akzeptieren. Ohne diese Zustimmung sendet anny keine Browser-Ereignisse. Widerrufen Besucher:innen die Zustimmung während der Sitzung, stoppt anny das Tracking sofort.

## Meta Ads verbinden

### Voraussetzungen

Bevor du Meta Ads verbindest, stelle sicher, dass du Folgendes hast:

* Ein Meta-Business-Konto mit einem eingerichteten Meta Pixel und Zugriff auf die **Pixel ID** (Meta: Events Manager → Datensätze → Pixel auswählen → Pixel ID)
* Für die Offline Conversion API zusätzlich einen **Access token** (Meta: Events Manager → Tag auswählen → Einstellungen → Conversion API → Zugriffstoken generieren)
* Ein aktives Cookie-Banner auf deiner anny-Buchungsseite, damit Besucher:innen dem Marketing-Tracking zustimmen können
* Admin-Rechte in deinem anny Account

### Verbindung einrichten

<Steps>
  <Step title="Pixel ID eintragen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Meta Ads**. Trage im Panel **Meta Pixel** deine **Pixel ID** ein.
  </Step>

  <Step title="Offline Conversion API einrichten (optional)">
    Möchtest du Käufe zusätzlich server-seitig melden, trage im Panel **Offline Conversion API** deinen **Access token** ein und klicke auf **Autorisieren**. Ohne diesen Schritt läuft nur das Meta Pixel im Browser.
  </Step>

  <Step title="Integration aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. anny bindet das Pixel danach auf deinen öffentlichen Buchungs- und Shop-Seiten ein.
  </Step>
</Steps>

Sobald die Integration aktiv ist und Besucher:innen Marketing-Cookies akzeptieren, meldet anny Seitenaufrufe und Buchungen automatisch an Meta.

<Tip>
  Prüfe die Verbindung im Meta Events Manager: Öffne deine anny-Buchungsseite, akzeptiere die Marketing-Cookies und lege eine Testbuchung an. Kurz darauf sollten die Ereignisse **PageView** und **Purchase** in Meta erscheinen.
</Tip>

### Einstellungen & Optionen

Diese Ereignisse meldet anny an Meta:

| Ereignis | Meta-Event | Wann es ausgelöst wird |
| :- | :- | :- |
| Seitenaufruf | PageView | Eine Besucher:in öffnet eine anny-Buchungs- oder Shop-Seite. |
| In den Warenkorb | AddToCart | Eine Leistung wird zur Buchung ausgewählt. |
| Checkout gestartet | InitiateCheckout | Die Besucher:in beginnt den Checkout. |
| Kauf | Purchase | Die Buchung wird abgeschlossen. anny übergibt Bestellwert (netto), Währung und Bestellnummer. |

Seitenaufruf, In den Warenkorb und Checkout gestartet laufen ausschließlich über das Meta Pixel im Browser. Der Kauf wird zusätzlich über die Offline Conversion API gemeldet, falls du einen Access token hinterlegt hast.

## Einschränkungen

Die Meta-Ads-Integration unterstützt nicht:

* **Tracking auf externen Seiten:** anny bindet das Pixel nur auf deinen anny-Buchungs- und Shop-Seiten ein, nicht auf deiner eigenen Website oder anderen Seiten.
* **Auslesen von Meta-Daten:** anny sendet nur Ereignisse an Meta. Kampagnen, Zielgruppen oder Statistiken aus deinem Werbekonto werden nicht in anny angezeigt.
* **Eigene Ereignisdefinitionen:** Es werden die festen Ereignisse Seitenaufruf, In den Warenkorb, Checkout gestartet und Kauf gesendet. Zusätzliche oder umbenannte Ereignisse sind nicht möglich.
* **Tracking ohne Cookie-Zustimmung:** Ohne akzeptierte Marketing-Cookies lädt das Meta Pixel im Browser nicht.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, bindet anny das Meta Pixel nicht mehr auf deinen Buchungsseiten ein und sendet keine neuen Conversions mehr an Meta. Bereits an Meta übermittelte Ereignisse bleiben in deinem Meta-Konto erhalten. Beim Löschen entfernt anny deine gespeicherte Pixel ID und den Access token; weitere Schritte sind nicht erforderlich.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Brauche ich für das Tracking einen Access token?">
    Nein. Für das Meta Pixel im Browser genügt die **Pixel ID**. Der **Access token** ist nur nötig, wenn du zusätzlich die **Offline Conversion API** nutzen willst, die Käufe server-seitig an Meta meldet.
  </Accordion>

  <Accordion title="Werden Buchungen auch ohne Cookie-Zustimmung erfasst?">
    Das Meta Pixel im Browser lädt nur, wenn Besucher:innen im Cookie-Banner **Marketing** akzeptieren. Ohne Zustimmung sendet anny aus dem Browser keine Ereignisse an Meta.
  </Accordion>

  <Accordion title="Auf welchen Seiten läuft das Meta Pixel?">
    Auf deinen öffentlichen anny-Buchungs- und Shop-Seiten, zum Beispiel Ressourcen-, Service-, Paket- und Checkout-Seiten. anny bindet das Pixel nicht auf deiner eigenen Website ein.
  </Accordion>

  <Accordion title="Welchen Wert meldet die Kauf-Conversion?">
    anny übergibt den **Nettobetrag** der Buchung, die **Währung** und die **Bestellnummer**. Namen oder E-Mail-Adressen werden für die Conversion nicht an Meta gesendet.
  </Accordion>

  <Accordion title="Wo finde ich meine Pixel ID und den Access token?">
    Die **Pixel ID** findest du im Meta Events Manager unter Datensätze im gewählten Pixel. Den **Access token** erzeugst du im Events Manager unter den Einstellungen deines Tags im Bereich Conversion API.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Im Meta Events Manager kommen keine Ereignisse an">
    Meist ist die Integration nicht aktiv oder Besucher:innen haben keine Marketing-Cookies akzeptiert. Prüfe, ob der **Toggle** aktiv ist, ob die **Pixel ID** korrekt eingetragen ist und ob auf deiner Buchungsseite die Marketing-Cookies akzeptiert wurden.
  </Accordion>

  <Accordion title="Der Access token lässt sich nicht speichern">
    Der Access token lässt sich nur bei deaktivierter Integration setzen. Deaktiviere die Integration zuerst über den **Toggle**, trage dann den Access token ein und klicke auf **Autorisieren**. Aktiviere die Integration danach wieder.
  </Accordion>

  <Accordion title="Server-seitige Conversions fehlen trotz eingerichtetem Access token">
    Die Offline Conversion API meldet nur den **Kauf** und nur für Besucher:innen, die über eine Meta-Anzeige auf deine Buchungsseite kamen. Prüfe, ob der Access token gültig und nicht abgelaufen ist und ob die Buchung tatsächlich aus einem Anzeigenklick stammt.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Meta Ads ist eine Marketing-/Tracking-Integration (Meta Pixel + Conversions API), KEINE Smart-Lock- oder Kalender-Integration. anny sendet nur Ereignisse an Meta und liest keine Daten aus dem Meta-Werbekonto zurück. Kein Import von Kampagnen, Zielgruppen oder Statistiken.
>
> **Zwei unabhängige Bausteine:** (1) Meta Pixel im Browser: braucht nur die Pixel ID; lädt `fbevents.js` auf den öffentlichen anny-Buchungs-/Shop-Seiten (app-shop: Ressourcen-, Service-, Plan-, Paket-, Explore-, Checkout-Seiten), nicht in der Admin-Oberfläche und nicht auf externen Websites. Feuert PageView, AddToCart, InitiateCheckout, Purchase. (2) Offline Conversion API (Metas Conversions API/CAPI): braucht zusätzlich den Access token; sendet server-seitig nur das Ereignis Purchase.
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **Meta Ads**. Panel „Meta Pixel" mit Feld „Pixel ID"; Panel „Offline Conversion API" mit Feld „Access token" + Button „Autorisieren". Pixel ID und Access token sind im aktiven Zustand gesperrt; zum Ändern zuerst über den Toggle deaktivieren. Aktivieren/Deaktivieren: Toggle oben rechts; Löschen: drei Punkte → Löschen.
>
> **Quirks:** (1) Cookie-Consent steuert NUR das Browser-Pixel (Marketing-Zustimmung nötig, Widerruf stoppt sofort). Die server-seitige CAPI-Conversion sendet unabhängig von der Browser-Zustimmung. (2) Die server-seitige Purchase-Conversion feuert nur, wenn zur Buchung eine Meta-Klick-ID (fbc aus fbclid oder fbp) vorliegt, also nur für Besucher:innen aus einem Meta-Anzeigenklick. (3) Purchase-Wert = Nettobetrag; zusätzlich Währung und Bestellnummer; keine Namen/E-Mails. (4) Ungültige Pixel ID (unerlaubte Zeichen) verhindert die Aktivierung mit Fehlermeldung. (5) Fehlgeschlagene server-seitige Conversions werden bei Server-/Ratenlimit-Fehlern bis zu dreimal mit wachsendem Abstand wiederholt, bei inhaltlichen Fehlern nicht.
>
> **Beziehungen:** Gehört zur Kategorie Marketing-Integrationen gemeinsam mit Google Ads, TikTok Ads und LinkedIn Ads (gleiche Feature-/Plan-Gruppe, gleiche Cookie-Consent-Logik). Die Klick-ID-Erfassung (fbclid, \_fbp, UTM-Parameter) teilt sich die technische Grundlage mit dem UTM-Tracking, siehe Artikel „utm-tracking". Cookie-Consent siehe Artikel „datenschutz". Plan-Verfügbarkeit über das Marketing-Feature; konkrete Plan-Stufe liegt in der Datenbank und ist im Code nicht final verifizierbar.


# Microsoft Teams mit anny verbinden
Source: https://docs.anny.co/ms-teams

Erstelle automatisch Teams-Meetings für deine Buchungen und stelle Kund:innen den Beitritts-Link bereit.

[Microsoft Teams](https://www.microsoft.com/de-de/microsoft-teams/group-chat-software) ist die Videokonferenz- und Kollaborationslösung von Microsoft. Mit der Integration erstellt anny für deine Buchungen automatisch Termine mit Teams-Meeting in den Kalendern deiner Microsoft-Organisation.

Mit Microsoft Teams kannst du in anny:

* Für jede bestätigte Buchung automatisch einen Termin mit Teams-Meeting im Kalender einer festgelegten Person anlegen
* Kund:innen den Beitritts-Link automatisch über die Buchungsbestätigung und den Kalendereintrag bereitstellen
* Meetings bei Umbuchungen, Stornierungen und Ressourcenwechseln automatisch aktuell halten

Die Integration eignet sich besonders für Online-Beratungen, Sprechstunden, Coachings und Kurse, bei denen deine Termine digital stattfinden.

<Info>
  Die Microsoft Teams-Integration setzt einen Plan voraus, der das Feature Video-Meetings enthält.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Online-Beratung | **Jede gebuchte Beratung erhält automatisch ein Teams-Meeting.** Kund:innen bekommen den Beitritts-Link mit der Buchungsbestätigung, dein Team sieht den Termin direkt im Kalender. |
| Sprechstunde pro Fachbereich | **Pro Ressource legst du fest, in wessen Kalender die Termine landen.** Standard-Teilnehmer wie Assistenzen oder Co-Berater:innen werden automatisch zu jedem Meeting eingeladen. |
| Online-Kurs mit mehreren Teilnehmer:innen | **Alle Buchungen desselben Zeitfensters teilen sich ein Meeting.** Bei Ressourcen mit mehrfacher Verfügbarkeit fügt anny jede weitere Kund:in demselben Meeting hinzu, ohne dass die Teilnehmer:innen einander sehen. |

## Wie die Microsoft Teams-Verbindung funktioniert

Die Verbindung wird einmalig für deine gesamte Microsoft-Organisation freigegeben. Beim Autorisieren leitet dich anny zu Microsoft weiter. Dort bestätigt ein:e Administrator:in deines Microsoft-Verzeichnisses (Active Directory) den Zugriff. Einzelne Mitarbeiter:innen müssen sich nicht anmelden.

anny nutzt den Zugriff ausschließlich für zwei Dinge: Es liest die Nutzerliste deiner Organisation (Namen und E-Mail-Adressen), damit du Organisator:innen und Standard-Teilnehmer auswählen kannst. Und es erstellt, aktualisiert und löscht Termine mit Teams-Meeting in den Kalendern der gewählten Organisator:innen. Auf Chats, Dateien oder andere Inhalte greift anny nicht zu.

Entzieht dein:e Microsoft-Administrator:in die Freigabe, kann anny keine Meetings mehr erstellen, aktualisieren oder löschen. Autorisiere die Integration in dem Fall neu.

| Daten | Richtung | Häufigkeit |
| :- | :- | :- |
| Termin mit Teams-Meeting | anny → Microsoft-Kalender | bei Bestätigung der Buchung |
| Terminzeit | anny → Microsoft-Kalender | bei Umbuchung |
| Teilnehmerliste (geteilte Meetings) | anny → Microsoft-Kalender | bei weiteren Buchungen und Stornierungen im selben Zeitfenster |
| Termin-Löschung | anny → Microsoft-Kalender | bei Stornierung, Ablehnung oder Löschung der Buchung |
| Nutzerliste (Namen, E-Mail) | Microsoft → anny | beim Einrichten, bis zu 1 Stunde zwischengespeichert |

## Microsoft Teams verbinden

### Voraussetzungen

Bevor du Microsoft Teams verbindest, stelle sicher, dass du Folgendes hast:

* Eine Microsoft 365 Organisation mit Microsoft Teams; die Organisator:innen benötigen ein eigenes Kalender-Postfach
* Eine:n Administrator:in deines Microsoft-Verzeichnisses, die:der die Freigabe bestätigen kann
* Admin-Rechte in deinem anny Account
* Angelegte Ressourcen und Buchungsoptionen, für die Meetings erstellt werden sollen

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen** und wähle **Teams**. Klicke auf **Autorisieren** und melde dich bei Microsoft an. Die Freigabe kann nur ein:e Administrator:in deines Microsoft-Verzeichnisses bestätigen.
  </Step>

  <Step title="Verbindungen anlegen">
    Lege im Panel **Microsoft Teams-Einstellungen** fest, für welche Ressourcen Meetings erstellt werden:

    1. Klicke auf **Hinzufügen**.
    2. Wähle im Feld **Wähle die Ressource** die gewünschte Ressource. Pro Ressource ist genau eine Verbindung möglich.
    3. Optional: Begrenze die Verbindung über **Buchungsoptionen auswählen** auf bestimmte Buchungsoptionen. Ohne Auswahl gilt **Alle Buchungsoptionen**.
    4. Wähle im Feld **Wähle den Organisator des Meetings** die Person, in deren Kalender die Termine angelegt werden.
    5. Optional: Lege über **Wähle die Standardteilnehmer des Meetings aus** Personen fest, die zu jedem Meeting eingeladen werden.
    6. Bestätige die Verbindung und wiederhole die Schritte für weitere Ressourcen.
  </Step>

  <Step title="Aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts.
  </Step>
</Steps>

Sobald die Integration aktiv ist, erstellt anny für jede neu bestätigte Buchung der verknüpften Ressourcen automatisch einen Termin mit Teams-Meeting. Deine Kund:innen erhalten den Beitritts-Link mit der Buchungsbestätigung.

<Tip>
  Solange die Integration aktiv ist, sind die Einstellungen gesperrt. Deaktiviere sie kurz über den **Toggle**, wenn du Verbindungen anlegen, bearbeiten oder löschen möchtest.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Wähle die Ressource | Die Ressource, für deren Buchungen Meetings erstellt werden. Jede Ressource darf nur eine Verbindung haben. |
| Buchungsoptionen auswählen | Begrenzt die Verbindung auf bestimmte Buchungsoptionen. Ohne Auswahl (**Alle Buchungsoptionen**) erstellt anny für jede Buchung der Ressource ein Meeting. |
| Wähle den Organisator des Meetings | Die Person aus deiner Microsoft-Organisation, in deren Kalender der Termin angelegt wird. Sie ist Organisator:in des Meetings und sieht als einzige alle Teilnehmer:innen. |
| Wähle die Standardteilnehmer des Meetings aus | Personen, die zu jedem erstellten Meeting eingeladen werden, z. B. feste Berater:innen oder Assistenzen. |

Der erstellte Termin trägt den Namen der Buchungsoption und der Ressource, liegt in der Zeitzone der Ressource und erhält die Kalender-Kategorie „anny \[Ressourcenname]". Die Kund:in wird als Teilnehmer:in hinzugefügt. Teilnehmer:innen können keine neuen Zeiten vorschlagen, und die Teilnehmerliste ist verborgen: Kund:innen sehen einander nicht.

Bei Ressourcen mit mehrfacher Verfügbarkeit teilen sich alle Buchungen desselben Zeitfensters ein gemeinsames Meeting. anny ergänzt weitere Kund:innen als Teilnehmer:innen und entfernt sie bei Stornierung wieder. Erst wenn die letzte Buchung storniert wird, löscht anny das Meeting.

## Einschränkungen

Die Microsoft Teams-Integration unterstützt nicht:

* **Meetings für unbestätigte Buchungen:** Buchungsanfragen erhalten ihr Meeting erst, wenn du sie annimmst. Buchungen ohne Kund:in (z. B. interne Blocker) erhalten kein Meeting.
* **Nachträgliche Meetings:** Buchungen, die vor der Aktivierung der Integration entstanden sind, erhalten kein Meeting.
* **Persönliche Microsoft-Konten:** Die Integration benötigt eine Microsoft-Organisation mit Administrator-Freigabe. Für das Microsoft-Konto einer Einzelperson nutze die Outlook-Kalenderintegration mit der Option „Teams Meeting zum Termin hinzufügen".
* **Mehrere Organisator:innen pro Ressource:** Jede Ressource kann nur mit einer Verbindung und damit einem Organisator verknüpft werden.
* **Änderungen im laufenden Betrieb:** Einstellungen lassen sich nur bearbeiten, solange die Integration deaktiviert ist.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, erstellt, aktualisiert und löscht anny keine Teams-Meetings mehr. Das gilt auch für bestehende Buchungen: Wird eine Buchung während der Deaktivierung verschoben oder storniert, bleibt ihr Meeting unverändert im Kalender stehen. Beim Löschen der Integration werden deine Verbindungen entfernt. Bereits erstellte Termine bleiben in den Kalendern der Organisator:innen bestehen und müssen dort bei Bedarf manuell gelöscht werden.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Wie erhalten meine Kund:innen den Beitritts-Link?">
    Die Buchungsbestätigung per E-Mail enthält den Button **Teams Meeting beitreten**. Auch der Kalendereintrag der Buchung enthält den Link. Zusätzlich wird die Kund:in dem Termin bei Microsoft als Teilnehmer:in hinzugefügt. Als Admin siehst du den Link in der Buchungsübersicht unter **MS Teams-Meeting starten**.
  </Accordion>

  <Accordion title="Was passiert bei Umbuchungen oder Stornierungen?">
    anny hält das Meeting automatisch aktuell: Bei einer Terminverschiebung wird der Termin angepasst, der Beitritts-Link bleibt gültig. Bei Stornierung, Ablehnung oder Löschung der Buchung wird das Meeting gelöscht. Wechselt die Buchung auf eine andere Ressource, löscht anny das alte Meeting und erstellt ein neues nach der Verbindung der neuen Ressource.
  </Accordion>

  <Accordion title="Sehen sich die Teilnehmer:innen eines geteilten Meetings gegenseitig?">
    Nein. Die Teilnehmerliste des Termins ist verborgen. Nur die Organisator:in sieht, wer eingeladen ist. Das ist besonders bei Kursen mit mehreren Buchungen im selben Zeitfenster relevant.
  </Accordion>

  <Accordion title="Ich nutze bereits eine Kalenderintegration mit Teams-Meetings. Brauche ich diese Integration zusätzlich?">
    Die Kalenderintegrationen Outlook und Microsoft 365 können Teams-Meetings direkt an synchronisierte Termine anhängen. Die Microsoft Teams-Integration arbeitet davon unabhängig und braucht keine Kalendersynchronisierung. Nutze pro Ressource nur einen der beiden Wege: Laufen beide parallel, entstehen zwei getrennte Meetings pro Buchung.
  </Accordion>

  <Accordion title="Warum erscheint eine Person nicht in der Organisator-Auswahl?">
    Die Auswahl zeigt nur Personen aus deinem Microsoft-Verzeichnis, die eine eigene E-Mail-Adresse mit Postfach haben. Die Liste wird außerdem bis zu einer Stunde zwischengespeichert: Neu angelegte Personen erscheinen deshalb verzögert.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Für eine Buchung wird kein Meeting erstellt">
    Meist ist die Integration deaktiviert oder es passt keine Verbindung zur Buchung. Prüfe, ob der **Toggle** aktiv ist, ob eine Verbindung für die Ressource existiert und ob die gebuchte Buchungsoption darin enthalten ist. Beachte außerdem: Meetings entstehen nur für bestätigte Buchungen mit Kund:in und erst nach Abschluss des Buchungsvorgangs.
  </Accordion>

  <Accordion title="Die Autorisierung schlägt fehl">
    Die Freigabe wurde nicht von einem:einer Administrator:in deines Microsoft-Verzeichnisses bestätigt oder abgebrochen. Starte die Autorisierung erneut und lass sie von einer Person mit Microsoft-Admin-Rechten bestätigen. Über die **drei Punkte** → **Verbindung testen** prüfst du anschließend, ob die Verbindung steht.
  </Accordion>

  <Accordion title="Der Beitritts-Link führt auf eine Fehlerseite">
    Entweder wurde das Meeting noch nicht erstellt oder es existiert nicht mehr. Direkt nach der Buchung kann es einen Moment dauern, bis das Meeting bei Microsoft angelegt ist. Wurde die Buchung storniert oder auf eine andere Ressource verschoben, ist der alte Link ungültig; im zweiten Fall enthält die aktuelle Buchung einen neuen Link.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Dieser Artikel behandelt die eigenständige Video-Meeting-Integration (Kachel **Teams** unter Integrationen, Kategorie Video-Meetings). NICHT gemeint sind: die MS-Teams-App (anny innerhalb von Microsoft Teams nutzen, Artikel ms-teams-app), das Outlook-Add-In (Artikel outlook-add-in) und die Teams-Meeting-Optionen der Kalenderintegrationen („Teams Meeting zum Termin hinzufügen" bei Outlook, „Als Online-Meeting erstellen" bei Microsoft 365; Artikel outlook und m365-workspace).
>
> **Beziehungen:** Plan-Feature Video-Meetings, gemeinsam mit Zoom, anny Video Calls und PurpleView; existiert bereits eine aktive Verbindung, bleibt die Integration auch ohne das Plan-Feature sichtbar. Die Autorisierung funktioniert wie bei Microsoft 365 Workspace (Admin Consent für den Tenant, App-Zugriff ohne Nutzer-Login), ist aber eine getrennte Verbindung; die Freigabe wird nicht zwischen den Integrationen geteilt. Parallelbetrieb mit einer Kalenderintegration inkl. Online-Meeting-Option erzeugt zwei getrennte Teams-Meetings pro Buchung.
>
> **UI-Pfade:** Menüleiste → **Integrationen** → Kachel **Teams**. Authentifizierung: Panel mit Button „Autorisieren" (Weiterleitung zum Microsoft Admin Consent; Hinweistext: Aktivierung nur durch einen Administrator aus dem Active Directory). Einstellungen: Panel „Microsoft Teams-Einstellungen" → Button „Hinzufügen" → Modal „Microsoft Teams-Verbindung erstellen" / „Microsoft Teams-Verbindung bearbeiten". Felder exakt: „Wähle die Ressource", „Buchungsoptionen auswählen" (Platzhalter „Alle Buchungsoptionen"), „Wähle den Organisator des Meetings", „Wähle die Standardteilnehmer des Meetings aus" (Platzhalter „Keine Standard-Teilnehmer"). Tabellen-Spalten: „Ressource", „Buchungsoptionen", „Organisator des Meetings", „Standard-Teilnehmer". Regel-Aktionen „Bearbeiten"/„Löschen" nur bei deaktivierter Integration; aktive Integration zeigt den Hinweis „Um die Einstellungen bearbeiten zu können, muss die Integration deaktiviert werden." Admin-Buchungsdetail: Hinweis „Für diese Buchung wird ein MS Teams-Meeting erstellt", Link „MS Teams-Meeting starten" mit Kopier-Aktion. E-Mail-Button: „Teams Meeting beitreten".
>
> **Quirks:** (1) Der Beitritts-Link ist ein anny-Weiterleitungslink (Pfad integrations/teams/open/); er zeigt eine Fehlerseite, bis das Meeting erstellt ist, und wird bei einem Ressourcenwechsel neu erzeugt, alte Links aus früheren E-Mails sind dann ungültig. Bei reinen Terminverschiebungen bleibt der Link gleich. (2) Geteilte Meetings bei Kapazität > 1: anny sucht im Organisator-Kalender nach einem Termin mit identischer Zeit und identischem Titel und ergänzt bzw. entfernt Kund:innen als Teilnehmer:innen; gelöscht wird das Meeting erst, wenn keine Kund:in mehr übrig ist. (3) Termin-Eigenschaften: Teilnehmerliste verborgen (hideAttendees), keine Zeitvorschläge erlaubt, Kategorie „anny \[Ressourcenname]", Titel nach Muster „\[Buchungsoption], \[Ressource]" bzw. „\[Ressource] (\[Mietoption])". (4) Bei automatisch zugewiesenen Unterressourcen greift die Verbindung der übergeordneten Ressource. (5) Organisator-/Teilnehmer-Auswahl: nur Verzeichnis-Einträge mit Anzeigename UND E-Mail; Liste bis zu 1 Stunde zwischengespeichert. (6) Fehlgeschlagene Microsoft-Aufrufe werden bis zu 5-mal mit kurzen Abständen wiederholt. (7) Wechselt der Buchungsstatus weg von „bestätigt" (z. B. Ablehnung), wird das Meeting leicht verzögert gelöscht; eine erneute Bestätigung erstellt ein neues Meeting. (8) Meetings entstehen erst beim Abschluss des Buchungsvorgangs (Auftrag abgeschlossen) bzw. bei Annahme einer Buchungsanfrage, nicht schon beim Anlegen der Buchung.


# anny MS Teams App
Source: https://docs.anny.co/ms-teams-app



Mit der anny MS Teams App greifst du direkt aus Microsoft Teams auf deine Buchungsseite zu, ohne die Anwendung zu wechseln. So buchst du Räume, Arbeitsplätze oder Termine, ohne Teams zu verlassen.

## anny App als Nutzer:in hinzufügen

![Screenshot: anny App in der Teams-Seitenleiste anpinnen](https://downloads.intercomcdn.eu/i/o/niegcmk9/57724841/7dbc642b45d98d42ca1e67f43d5a/screenshot-2025-07-10-at-140010-image.png?expires=1785938400\&signature=1a5b49a035cc7669983e4f0670ea1ad72ae12b8a9f9ea07f20a6f31ffa35f934\&req=1dJox1zyqDZk2hL085ZhofaDqJK3dSU6L7vD17e%2B1aEsOiYOXrtI%2FxXkhNzL%0A6Q%3D%3D%0A)

<Tip>
  Als Admin kannst du die anny App für dein gesamtes Team anpinnen, sodass sie bei allen Teammitgliedern automatisch in der linken Leiste erscheint.
</Tip>

## anny App für die Organisation bereitstellen (Admin)

Sobald die App bereitgestellt ist, können alle ausgewählten Nutzer:innen die anny App in Teams sehen und verwenden.

## Automatischer Login

Beim ersten Öffnen der anny App in Teams wird jede:r Nutzer:in einmalig um die Berechtigung gebeten, den aktiven Microsoft-Account auszulesen. Anschließend erfolgt der Login automatisch.

![Screenshot: Berechtigungsanfrage beim ersten Login](https://downloads.intercomcdn.eu/i/o/niegcmk9/57724872/ff8b09efbff59eac50b6ddb1494a/scr-20250710-mlvg-image.png?expires=1785938400\&signature=6873f779b0fdc0edbb8df80b62345fce6ab1e203a1a4c10f4d6c997508afcc04\&req=1dJox1zyqzVk2hL085ZhoZw%2FnQEvpRD5vTwdhuKzBgmbYPJqW%2B%2BpJZyPzyFV%0Ajy%2FdEyc4aFszGHWf%0A)

<Tip>
  Als Admin kannst du die Berechtigung zentral für alle Nutzer:innen deiner Organisation vergeben, sodass der Consent nicht einzeln erfolgen muss.
</Tip>

![Screenshot: Admin-Consent für alle Nutzer vergeben](https://downloads.intercomcdn.eu/i/o/niegcmk9/57724893/e728df6eccbdad6adde4af96ef1c/scr-20250710-mlvg-2-image.png?expires=1785938400\&signature=b1076bb8f3fdd639ab35c91996e58a2bce3e3a019acd69d56c9c50bee3d861\&req=1dJox1zypTRk2hL085ZhoerPUXOS%2B%2FD9F0tnTSPkiGwj9e4puX4bM7iWAXFH%0APYt6Mk21HVZSR7OB%0A)

<Warning>
  Falls in Microsoft Entra deaktiviert ist, dass Nutzer:innen selbstständig einen App-Consent vergeben können, muss ein Administrator die anny Teams App einmalig freischalten.
</Warning>

## Ergebnis prüfen

Die anny App erscheint in deiner linken Teams-Leiste. Beim Öffnen siehst du deine anny Buchungsseite und kannst direkt buchen, ohne Teams zu verlassen.

## FAQ

<AccordionGroup>
  <Accordion title="Brauche ich einen separaten anny Account für die Teams App?">
    Nein. Die Teams App nutzt deinen bestehenden anny Account. Der Login erfolgt automatisch über deinen Microsoft-Account.
  </Accordion>

  <Accordion title="Funktioniert die App auch in der Teams Desktop-Version und im Browser?">
    Ja, die anny App funktioniert in Teams Desktop, im Browser und in der mobilen Teams App.
  </Accordion>

  <Accordion title="Kann ich die App wieder entfernen?">
    Ja. Rechtsklicke auf die anny App in der linken Leiste und wähle **Deinstallieren**. Deine Buchungen und dein anny Account bleiben davon unberührt.
  </Accordion>

  <Accordion title="Muss ich als Admin etwas konfigurieren, damit die App funktioniert?">
    Nur wenn der App-Consent in Entra zentral gesteuert wird. In diesem Fall musst du die Berechtigung einmalig für die Organisation erteilen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die App zeigt einen schwarzen Bildschirm">
    Dieses Problem kann nach einem Microsoft Teams Client-Update auftreten. Entferne die anny App (Rechtsklick → **Deinstallieren**) und füge sie anschließend erneut hinzu. Falls das Problem bestehen bleibt, kontaktiere den anny Support.
  </Accordion>

  <Accordion title="Die App kann nicht geladen werden">
    Prüfe, ob dein Teams-Admin die anny App für deine Organisation freigegeben hat. Falls die App unter **Für Ihre Organisation entwickelt** nicht erscheint, wende dich an deinen IT-Admin.
  </Accordion>

  <Accordion title="Der automatische Login funktioniert nicht">
    Stelle sicher, dass der App-Consent erteilt wurde. Falls dein Unternehmen den Self-Service-Consent deaktiviert hat, muss ein Admin die Berechtigung zentral vergeben (Microsoft Entra → Enterprise Applications → anny → Permissions → Grant admin consent).
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Die anny MS Teams App ist keine Integration im Sinne einer Datenverbindung, sondern eine eingebettete Ansicht der anny Buchungsseite innerhalb von Teams.
> * Login erfolgt per Microsoft SSO (automatischer Login). Wenn der Entra-App-Consent für Nutzer:innen deaktiviert ist, muss ein Admin den Consent einmalig erteilen (Entra → Enterprise Applications → anny → Permissions → Grant admin consent).
> * Bekanntes Problem (Aug 2026): Nach MS Teams Client-Update auf Build 26183.1903.x kann ein schwarzer Bildschirm auftreten. Workaround: App entfernen und neu hinzufügen.
> * Verwandte Artikel: Microsoft 365 Workspace Integration (Kalender-Sync), Outlook Add-In (Buchung direkt aus Outlook).
> * Die Teams App selbst hat keine Konfigurationsoptionen in anny. Alle Einstellungen betreffen die Bereitstellung im Microsoft 365 Admin Center.


# n8n mit anny verbinden
Source: https://docs.anny.co/n8n

Automatisiere Buchungen, Kund:innen und Rechnungen mit dem offiziellen anny-Node in n8n.

[n8n](https://n8n.io) ist eine Workflow-Plattform, in der du Automatisierungen visuell baust. anny stellt dafür den Community-Node [`n8n-nodes-anny`](https://github.com/anny-co/anny-n8n) bereit. Anders als bei [Make.com](/make-com) brauchst du Webhooks und API-Aufrufe nicht von Hand zu verdrahten: Der Node verwaltet Anmeldung und Webhook-Abonnements selbst.

Mit n8n kannst du in anny:

* auf Ereignisse reagieren, zum Beispiel eine neue Buchung, einen Check-in oder eine neue Rechnung
* Buchungen, Kund:innen, Bestellungen, Rechnungen, Abos, Ressourcen und Services lesen oder ändern
* Verfügbarkeiten abfragen und beliebige anny-API-Aufrufe aus einem Workflow heraus ausführen

Ideal für Teams, die anny mit CRM, Tabellen, Chat oder Buchhaltung verbinden wollen, ohne eigene Integrationen zu programmieren.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Neue Buchung ins CRM | **Jede neue Buchung erzeugt automatisch einen Datensatz.** Der **Anny Trigger** startet bei `bookings.created`, der **Anny**-Node lädt Kund:in und Buchung nach. |
| Check-in in einem anderen System | **Der Check-in in anny stößt den nächsten Schritt an.** Zum Beispiel eine Nachricht im Chat oder ein Eintrag in deiner Tabelle. |
| Rechnung weiterverarbeiten | **Fertiggestellte Rechnungen landen dort, wo du buchst.** Der Trigger **Invoice Finalized** liefert das Ereignis an deinen Workflow. |

## Wie die n8n-Verbindung funktioniert

n8n erscheint nicht in der Integrationen-Liste von anny. Du installierst den Node in deiner n8n-Instanz (Cloud oder selbst gehostet) und hinterlegst Zugangsdaten:

* **OAuth2** (Standard): Du wählst die Region (**anny.co** oder **anny.eu**) und schließt den Login im Browser ab. n8n erhält damit Zugriff im Namen deines Admin-Kontos, inklusive Webhook-Abonnements.
* **Access Token**: Du hinterlegst einen **Personal Access Token** aus anny (**Einstellungen** → Tab **API & Webhooks**).

Der **Anny Trigger** legt in anny automatisch ein Webhook-Abonnement an und löscht es, wenn du den Trigger entfernst. Der **Anny**-Node spricht die anny API für Aktionen an.

Widerrufst du den Zugang, stoppen die Workflows: Löschst du die Credentials in n8n oder rotierst du den Token in anny, schlagen API-Aufrufe fehl. Entfernst du den Trigger, verschwindet das zugehörige Webhook-Abonnement.

So laufen die Daten:

| Richtung | Baustein | Beispiele |
| :- | :- | :- |
| anny → n8n (Auslöser) | **Anny Trigger** | Buchung erstellt, Check-in, Rechnung finalisiert, Kund:in erstellt |
| n8n → anny (Aktionen) | **Anny**-Node | Buchung lesen, stornieren, einchecken; Kund:in anlegen; API Call |

## n8n verbinden

### Voraussetzungen

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

* Ein n8n-Konto (n8n Cloud oder selbst gehostete Instanz), in dem du Community-Nodes installieren darfst
* Ein anny-Admin-Konto für die gewählte Region
* Für Access Token zusätzlich Zugriff auf den Tab **API & Webhooks**

### Verbindung einrichten

<Steps>
  <Step title="Community-Node installieren">
    Installiere in n8n das Paket `n8n-nodes-anny` als Community-Node. Die Schritte stehen in der [n8n-Dokumentation zu Community-Nodes](https://docs.n8n.io/integrations/community-nodes/installation/).
  </Step>

  <Step title="Zugangsdaten anlegen">
    Lege in n8n die Credential **Anny OAuth2 API** an, wähle die **Region** (**anny.co** oder **anny.eu**) und schließe den OAuth-Login ab. Alternativ nutzt du **Anny Access Token API** mit einem Personal Access Token aus anny.
  </Step>

  <Step title="Trigger oder Aktion hinzufügen">
    Für Ereignisse fügst du den Node **Anny Trigger** hinzu und wählst die **Events**, zum Beispiel **Booking Created**. Für Aktionen fügst du den Node **Anny** hinzu und wählst Ressource und Operation, zum Beispiel Booking → Get.
  </Step>

  <Step title="Workflow aktivieren">
    Speichere und aktiviere den Workflow. Der Trigger erzeugt dann das Webhook-Abonnement in anny.
  </Step>
</Steps>

Sobald der Workflow aktiv ist, startet n8n bei jedem ausgewählten Ereignis automatisch.

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Authentication | **OAuth2** oder **Access Token** am jeweiligen Node. |
| Region | **anny.co (default)** oder **anny.eu (Gov-Cloud)**. Muss zu deinem anny-Account passen. |
| Events (Trigger) | Die Ereignisse, die den Workflow starten, zum Beispiel Booking Created, Booking Checked In, Invoice Finalized. |
| Resource / Operation (Anny-Node) | Booking, Customer, Order, Invoice, Plan Subscription, Resource, Service, Availability oder API Call. |
| Simplify | Liefert bei Get/Get All eine vereinfachte Antwort statt des rohen JSON:API-Dokuments. |

<Tip>
  Für Endpunkte, die der Node nicht abbildet, nutze die Operation **API Call** gegen `/api/v1/…`.
</Tip>

## Einschränkungen

Die n8n-Anbindung unterstützt nicht:

* **Eintrag unter Integrationen:** Der Node wird in n8n installiert, nicht über die Integrationen-Liste in anny.
* **Alle Webhook-Ereignisse:** Der Trigger deckt Buchungen, Kund:innen, Bestellungen und Rechnungen ab. Abos, Termine und Community-Mitglieder richtest du bei Bedarf über ein manuelles Webhook-Abonnement wie bei [Make.com](/make-com) ein.
* **Feingranulare Token-Rechte:** Ein Personal Access Token erhält den Zugriff, den auch ein Admin über die API hat. Einzelne Berechtigungen sind im UI noch nicht wählbar.

## Verbindung trennen

<Warning>
  Löschst du die Credentials in n8n oder rotierst du den Personal Access Token in anny, schlagen bestehende Workflows fehl. Entfernst du einen **Anny Trigger**, löscht n8n das zugehörige Webhook-Abonnement in anny.
</Warning>

Credentials verwaltest du in n8n. Den Personal Access Token findest du in anny unter **Einstellungen** im Tab **API & Webhooks** (Rotieren oder Löschen).

## FAQ

<AccordionGroup>
  <Accordion title="Ist das ein offizieller anny-Node?">
    Ja. anny pflegt den Community-Node im GitHub-Repository [anny-co/anny-n8n](https://github.com/anny-co/anny-n8n) (npm-Paket `n8n-nodes-anny`). Es ist kein generisches HTTP-Modul, sondern ein eigener Node mit Trigger und Aktionen.
  </Accordion>

  <Accordion title="Wann nutze ich n8n, wann Make.com?">
    n8n, wenn du den fertigen anny-Node mit OAuth und automatischen Webhooks willst. Make.com, wenn du bereits Make nutzt: Dort verbindest du anny über generische Webhooks und HTTP, siehe [make.com](/make-com).
  </Accordion>

  <Accordion title="Welche Ereignisse kann der Trigger empfangen?">
    Buchungen (erstellt, aktualisiert, gestartet, beendet, eingecheckt, ausgecheckt, gelöscht), Kund:innen, Bestellungen und Rechnungen (inklusive finalisiert). Die Bezeichnungen im Node sind englisch, zum Beispiel **Booking Created**.
  </Accordion>

  <Accordion title="Brauche ich Programmierkenntnisse?">
    Nein. Du baust den Workflow in n8n zusammen. Ein Grundverständnis von Webhooks hilft beim Fehlersuchen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Trigger startet nicht">
    Der Workflow ist möglicherweise nicht aktiv, die Region stimmt nicht, oder die gewählten Events passen nicht. Aktiviere den Workflow und prüfe in anny unter **API & Webhooks**, ob ein Abonnement mit dem Namen `n8n Trigger - Workflow …` existiert.
  </Accordion>

  <Accordion title="OAuth-Login schlägt fehl">
    Meist ist die falsche Region gewählt. **anny.co** und **anny.eu** sind getrennte Umgebungen. Wähle die Region, in der dein Account liegt, und schließe den Login erneut ab.
  </Accordion>

  <Accordion title="API-Aktionen schlagen fehl">
    Die Credentials sind abgelaufen, der Token wurde rotiert, oder der Access Token hat keinen Zugriff mehr. Lege die Credential in n8n neu an oder erstelle unter **API & Webhooks** einen neuen Token.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** n8n ist KEINE Integration in der anny Integrationen-Liste. Offizieller Community-Node: GitHub anny-co/anny-n8n, npm `n8n-nodes-anny`, Nodes **Anny** (`anny`) und **Anny Trigger** (`annyTrigger`). Make.com hat KEINEN vergleichbaren branded Connector.
>
> **Auth:** Credentials **Anny OAuth2 API** (Region co/eu/staging/local, Grant authorizationCode, Scopes `user:read b.* b.webhook-subscriptions:*`, preAuthentication holt `organizationId` via `/api/v1/user?include=active_organization`) oder **Anny Access Token API** (PAT Bearer). UI-Regionen für Kund:innen: anny.co und anny.eu (Gov-Cloud). Staging/Local nicht im sichtbaren Artikel.
>
> **Trigger:** legt POST `/api/v1/webhook-subscriptions` an, Name `n8n Trigger - Workflow {id}`; löscht beim Entfernen. Events im Node: bookings.created/updated/started/ended/checked-in/checked-out/deleted, customers.*, orders.*, invoices.created/updated/deleted/finalized. NICHT im Trigger: subscriptions.*, timeslots.*, community-accounts.*, call-sessions.* (die gibt es in anny-Webhooks, siehe Make-Artikel).
>
> **Aktionen:** Availability, Booking (get/list/cancel/check-in/check-out), Customer (CRUD+list), Order/Invoice/Plan Subscription/Resource/Service (get/list), API Call für beliebige `/api/*`.
>
> **UI-Pfade anny:** Personal Access Token nur unter Einstellungen → API & Webhooks. Kein Integrationen-Toggle.
>
> **Beziehungen:** Make.com-Artikel `/make-com` (generische Webhooks+HTTP). Changelog 2025-12-16 erwähnt n8n Cloud. API-Doku darf Make nicht als native Connector behaupten.


# Nuki mit anny verbinden
Source: https://docs.anny.co/nuki

Automatisiere den schlüssellosen Zugang zu deinen Räumen über Nuki Smart Locks und anny Buchungen.

[Nuki](https://nuki.io/de/) ist ein Smart-Lock-System, das auf bestehende Türschlösser montiert wird und schlüssellosen Zugang per App oder Keypad-PIN ermöglicht. Mit der Integration erstellt anny automatisch Zugangscodes für deine Kund:innen, sobald eine Buchung bestätigt wird.

Mit Nuki kannst du in anny:

* Zugangscodes automatisch bei Buchungsbestätigung erstellen und nach Ablauf entfernen
* Kund:innen per Keypad-PIN oder Nuki-App Zutritt gewähren
* Türen per Remote Open direkt aus der anny Buchungsansicht oder Homepage öffnen

Die Integration passt, wenn du Räume oder Flächen vermietest und deinen Kund:innen automatisierten, schlüssellosen Zugang ohne manuelle Schlüsselübergabe bieten möchtest.

<Info>
  Verfügbar ab dem Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Meetingräume im Coworking-Space | **Automatischer Zugang nur im gebuchten Zeitfenster.** Kund:innen erhalten den PIN per Mail und betreten den Raum ohne Rezeption. |
| Ferienwohnungen und Apartments | **Schlüssellose Übergabe ohne persönlichen Kontakt.** Gäste erhalten vor Check-in ihren Zugangscode und können eigenständig einchecken. |
| Gemeinschaftsräume mit Community-Zugang | **Dauerhafte Zugangsrechte für Mitglieder.** Community-Mitglieder erhalten permanenten Zugang zu definierten Schlössern. |
| Universitätsräume und Labore | **Zeitlich begrenzter Zugang für gebuchte Slots.** Studierende erhalten Zugang nur für den reservierten Zeitraum. |

## Wie die Nuki-Verbindung funktioniert

Du autorisierst anny in deinem Nuki-Account, und anny erhält Zugriff auf deine registrierten Smart Locks. anny erstellt und entfernt Zugangscodes automatisch basierend auf deinen konfigurierten Regeln.

Wenn du die Autorisierung im Nuki-Account widerrufst oder die Verbindung abläuft, verliert anny den Zugriff und kann keine neuen Zugänge erstellen. Du musst die Verbindung in diesem Fall neu autorisieren.

Einzelbuchungen erhalten ihren Zugangscode sofort bei der Bestätigung. Bei Serienbuchungen erstellt anny den Zugang erst kurz vor dem jeweiligen Termin (etwa 48 Stunden vorher). Bis dahin steht der Zugang auf **Geplant**.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Zugangscodes (Erstellen/Entfernen) | anny → Nuki | Bei Buchungserstellung und -ablauf |
| Keypad-PIN-Codes | anny → Nuki | Bei Buchungserstellung |

## Nuki verbinden

### Voraussetzungen

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

* Ein Nuki Smart Lock mit WiFi-Funktion (Smart Lock 3.0 Pro oder Smart Lock + Bridge)
* Optional: ein [Nuki Keypad](https://nuki.io/de/keypad/) für den Zugang per PIN-Code
* Einen Nuki-Account mit Zugangsdaten

<Tip>
  Für anny-Buchungen ist ein Nuki-Schloss mit WiFi (Fernzugriff) zwingend erforderlich. Ohne WiFi kann anny keine Zugänge erstellen.
</Tip>

### Verbindung einrichten

<Steps>
  <Step title="Nuki autorisieren">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Nuki**. Autorisiere Nuki, indem du dich mit deinen Zugangsdaten von Nuki anmeldest. Du gibst anny damit die Berechtigung, Zugänge auf deinen Smart Locks zu verwalten.
  </Step>

  <Step title="Zugänge konfigurieren">
    Nach erfolgreicher Autorisierung richtest du Zugangsregeln ein. Du hast zwei Möglichkeiten:

    **Zugang durch Buchungen:**

    1. Klicke auf **Hinzufügen** im Bereich "Zugang durch Buchungen".
    2. Wähle die **Ressource** aus, deren Buchung Zugang zum Schloss gewähren soll.
    3. Wähle unter **Zylinder auswählen** ein oder mehrere Schlösser aus, zu denen Zugang gewährt wird.
    4. Lege über **Zugang vor der Buchung** und **Zugang nach der Buchung** fest, wie viele Minuten der Zugang vor und nach der Buchung aktiv ist.
    5. Falls ein Nuki Keypad vorhanden ist, aktiviere **Zugang über Keypad verwenden**. Kund:innen erhalten dann einen PIN-Code per Mail. Ohne diese Option lädst du Kund:innen als Nuki-App-Nutzer:innen per E-Mail ein.

    **Zugang durch Communities:**

    1. Klicke auf **Hinzufügen** im Bereich "Zugang durch Communities".
    2. Wähle die **Community** aus, deren Mitglieder dauerhaften Zugang erhalten sollen.
    3. Wähle unter **Zylinder auswählen** ein oder mehrere Schlösser aus, zu denen Zugang gewährt wird.
  </Step>
</Steps>

Sobald Regeln konfiguriert sind, erstellt anny automatisch Zugänge bei neuen Buchungen. Pro Ressource ist eine Buchungsregel möglich, du kannst darin aber mehrere Schlösser hinterlegen. Eine Regel auf einer übergeordneten Ressource gilt auch für Buchungen ihrer Unterressourcen.

<Tip>
  Die Nutzung des Keypads ist empfohlen: Kund:innen benötigen keine App-Installation und erhalten den PIN direkt in der Buchungsbestätigung.
</Tip>

## Einstellungen & Optionen

### Remote Open

Mit der Remote-Open-Funktion können Kund:innen Türen direkt über die anny Homepage oder Buchungsansicht per Knopfdruck öffnen, ohne PIN oder App.

Aktiviere dazu in der jeweiligen Regel den Schalter **Fernöffnung verwenden**: in einer Buchungsregel für den Zugang über die Buchungsansicht, in einer Community-Regel für den Zugang über die Homepage. In der Regel-Tabelle erscheint die Spalte **Fernöffnung**.

Kund:innen sehen den Button **Tür entriegeln** in ihrer Buchungsansicht und im Bereich **Schlüsselloser Zugang** ihres anny-Kontos. Er ist nur während des gültigen Zugangszeitraums aktiv. Als Admin kannst du in der Buchungsübersicht über **Schloss entsperren** öffnen.

<Info>
  Für Remote Open muss die Integration neu autorisiert werden, falls sie vor der Aktivierung dieser Funktion eingerichtet wurde.
</Info>

### Zugänge im Admin-Bereich einsehen

In der Buchungsdetailansicht findest du unter **Smartlock Zugänge** die aktiven und inaktiven Zugänge. Pro Zugang siehst du:

* Status
* **Zugang beginnt am** und **Zugang endet am**
* **Türschloss**
* **Erstellt am**
* Zugang (z. B. PIN-Code)

| Status | Bedeutung |
| - | - |
| Geplant | Die Erstellung ist geplant. Der Zugang wird kurz vor dem Termin erstellt (etwa 48 Stunden vorher, vor allem bei Serienbuchungen). |
| In Bearbeitung | Die Einrichtung des Zugangs läuft gerade. |
| Unbestätigt | Der Zugang wurde angefragt und wird in Kürze bestätigt. Ein Keypad-PIN ist bereits nutzbar. |
| Erfolgreich | Der Zugang ist aktiv. Kund:innen können das Schloss im angezeigten Zeitraum bedienen. |
| Fehlgeschlagen | Das Erstellen des Zugangs ist fehlgeschlagen. |
| Entfernt | Der Zugang wurde vom System oder Admin entfernt. Kein Zugriff mehr. |

## Einschränkungen

Die Nuki-Integration unterstützt nicht:

* Mehr als 200 gleichzeitig offene/zukünftige Zugänge pro Schloss. Wenn das Limit erreicht ist, kann anny keine neuen Zugänge erstellen.
* Mehrere gespeicherte Zugriffszeiträume pro Nutzer:in in der Nuki-App. Bei aufeinanderfolgenden Buchungen muss das alte Schloss zunächst aus der App entfernt werden.
* Synchronisation im Batteriesparmodus. Wenn das Nuki-Schloss in den Energiesparmodus wechselt, trennt es die WiFi-Verbindung.

<Tip>
  Nuki eignet sich am besten für kleinere Unternehmen mit moderatem Buchungsvolumen (unter 200 gleichzeitig aktive Zugänge). Bei höherem Volumen prüfe alternative Smart-Lock-Integrationen.
</Tip>

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</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 Nuki-Geräte sind kompatibel?">
    Du benötigst ein Nuki Smart Lock mit WiFi-Funktion: entweder das Nuki Smart Lock 3.0 Pro (mit integriertem WiFi) oder ein älteres Smart Lock mit separater Nuki Bridge. Ohne WiFi ist keine Fernsteuerung über anny möglich.
  </Accordion>

  <Accordion title="Erhalten meine Kund:innen den Zugangscode automatisch?">
    Ja. Bei Einzelbuchungen erstellt anny den Zugang sofort nach der Bestätigung. Bei Serienbuchungen entsteht er erst kurz vor dem jeweiligen Termin und steht bis dahin auf **Geplant**. Bei aktiviertem Keypad erhalten Kund:innen den PIN-Code per E-Mail in der Buchungsbestätigung. Ohne Keypad bekommen sie eine Einladung als Nuki-App-Nutzer:in.
  </Accordion>

  <Accordion title="Kann ich mehrere Schlösser pro Ressource zuordnen?">
    Ja. Pro Zugangsregel kannst du ein oder mehrere Schlösser auswählen, die bei Buchung der Ressource freigeschaltet werden.
  </Accordion>

  <Accordion title="Was passiert mit dem Zugang nach Ablauf der Buchung?">
    anny entfernt den Zugang automatisch nach Ablauf des konfigurierten Zeitfensters (Buchungszeit plus Puffer). Kund:innen haben danach keinen Zugriff mehr.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Der Zugangscode erscheint nicht in der Buchungsbestätigung">
    Prüfe, ob die Nuki-Integration in den Integrationen als aktiv angezeigt wird und ob das Smart Lock online ist. Falls das Schloss im Batteriesparmodus ist, trennt es die WiFi-Verbindung und anny kann keinen Zugang erstellen. Stelle sicher, dass das Schloss ausreichend Strom hat oder deaktiviere den Energiesparmodus.
  </Accordion>

  <Accordion title="Die Verbindung ist unterbrochen und der Re-Auth-Button fehlt">
    Dies kann passieren, wenn der Refresh-Token abgelaufen ist. Öffne Nuki in den **Integrationen**, lösche die Verbindung über die drei Punkte oben rechts und autorisiere erneut mit deinen Nuki-Zugangsdaten.
  </Accordion>

  <Accordion title="Das 200-Zugänge-Limit ist erreicht">
    Nuki erlaubt maximal 200 gleichzeitig aktive/zukünftige Zugänge pro Schloss. Prüfe im Nuki-Admin, ob alte Zugänge noch aktiv sind, und entferne nicht mehr benötigte Einträge manuell. Alternativ warte, bis abgelaufene Zugänge automatisch entfernt werden.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **Nuki** → Autorisieren (OAuth-Redirect zu Nuki Web). Regeln: gleicher Ort, Panels **Zugang durch Buchungen** und **Zugang durch Communities** → **Hinzufügen**. Buchungsregel-Felder: **Ressource**, **Zylinder auswählen** (Schloss-Auswahl; für Nuki heißt das Label „Zylinder", nicht „Schlösser"), **Zugang vor der Buchung**, **Zugang nach der Buchung**, Schalter **Zugang über Keypad verwenden**, Schalter **Fernöffnung verwenden**. Regel-Tabellen-Spalten: Ressource, Zylinder, Zugang vor/nach der Buchung, **Verwendet Tastatur-Pin**, **Fernöffnung**. Deaktivieren: **Toggle** oben rechts; Löschen: **drei Punkte** → **Löschen**.
>
> **Authentifizierung:** OAuth (Nuki Web API), Scopes account/smartlock.readOnly/smartlock.auth/smartlock.action. Refresh-Token kann ablaufen → Re-Autorisierung nötig. Reine Passwortänderung widerruft die Autorisierung nicht zwingend.
>
> **Zugangsarten:** Pro Regel entweder Keypad-PIN (Keypad-Schalter an) ODER Nuki-App-Einladung per E-Mail (Keypad-Schalter aus), diese schließen sich aus. **Remote Open** ist zusätzlich und unabhängig (eigener Grant-Typ). Keypad-PIN: 6 Ziffern, nur 1–9 (keine 0), beginnt nie mit „12", pro Konto eindeutig.
>
> **Timing/Status:** Einzelbuchungen → Zugang sofort bei Bestätigung. Serien-/wiederkehrende Buchungen → Status **Geplant**, Erstellung ca. 48 h vor Termin. Nach Anlage Status **Unbestätigt**, nach ca. 2 Min Prüfung → **Erfolgreich**/**Fehlgeschlagen**. Weitere Status: In Bearbeitung, Aufräumen, Entfernt, Nicht autorisiert. Zugang läuft am Buchungsende + „Zugang nach der Buchung" ab (Nuki-seitig erzwungen); anny räumt den Eintrag etwa einen Tag später auf.
>
> **Quirks:** (1) Nur bestätigte/angenommene Buchungen; angefragte, abgelehnte, stornierte Buchungen und interne Blocker erhalten keinen Zugang. Blocker→Buchung erstellt Zugang, Buchung→Blocker entfernt ihn. (2) Statuswechsel weg von „angenommen" entfernt den Zugang; Zeitänderung aktualisiert das Fenster; Ressourcenwechsel erstellt neu. (3) Eine Buchungsregel pro Ressource (Duplikat wird beim Speichern blockiert), mehrere Schlösser pro Regel erlaubt. (4) Regel auf Oberressource greift auch für Unterressourcen. (5) Community-Zugang ist dauerhaft (kein Enddatum). (6) Keypad-Regel: Aktivierung schlägt fehl, wenn ein gewähltes Schloss kein gekoppeltes Keypad hat oder ein referenziertes Schloss fehlt; Integration bleibt inaktiv. (7) Remote Open braucht neue Scopes → Re-Autorisierung; Schalter „Fernöffnung verwenden" erscheint erst danach.
>
> **Remote-Open-Button:** Kund:innen „**Tür entriegeln**" in Buchungsansicht + Bereich „Schlüsselloser Zugang" (Homepage/Konto, Browser), nur im gültigen Zeitfenster. Admin „**Schloss entsperren**" in der Buchungsübersicht.
>
> **Nuki-Plattform (nicht aus anny-Code, vor Nutzung verifizieren):** 200 gleichzeitige Zugänge pro Schloss, WiFi-Pflicht (Bridge oder Pro), Batteriesparmodus trennt WiFi, nur ein Zugriffszeitraum pro Nutzer:in pro Schloss in der Nuki-App (Keypad-PIN betroffen nicht).
>
> **Beziehungen:** Feature INTEGRATIONS\_SMART\_LOCKS, Plan-Stufe („ab Professional") DB-seitig, nicht code-verifiziert. Verwandte Artikel: Smart-Lock-Integrationen (Übersicht), KleverKey, Salto KS, Tapkey, Dormakaba Resivo.


# Outlook Kalender mit anny verbinden
Source: https://docs.anny.co/outlook

Synchronisiere Buchungen und Termine zwischen anny und deinem persönlichen Outlook-Kalender in Echtzeit.

[Outlook](https://outlook.com) ist der E-Mail- und Kalenderdienst von Microsoft. Mit der Integration verbindest du eine Ressource in anny mit einem Kalender deines persönlichen Outlook-Kontos und hältst beide Seiten automatisch synchron (2-Wege-Synchronisation). Einen Überblick über alle Kalender-Integrationen findest du im Artikel zu den Kalenderintegrationen.

Mit Outlook kannst du in anny:

* Buchungen deiner Ressource automatisch als Termine in deinem Outlook-Kalender anlegen
* Termine aus deinem Outlook-Kalender als Blocker oder Buchungen in anny übernehmen, damit belegte Zeiten nicht doppelt gebucht werden
* Optional zu jedem synchronisierten Termin ein Teams-Meeting erstellen lassen

Besonders praktisch ist die Integration, wenn eine Ressource an deinen persönlichen Kalender gekoppelt ist, z. B. bei Berater:innen, Trainer:innen oder einem persönlich verwalteten Raum.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Beratungstermine im Blick | **Alle Buchungen erscheinen automatisch in deinem Outlook-Kalender.** Du siehst deine anny Termine dort, wo du ohnehin planst, ohne manuelles Übertragen. |
| Doppelbuchungen vermeiden | **Private und externe Termine blockieren deine Ressource in anny.** Trägst du in Outlook einen Termin ein, ist die Zeit in anny nicht mehr buchbar. |
| Online-Beratung mit Teams | **Jede Buchung erhält automatisch ein Teams-Meeting.** Kund:innen und Teilnehmer:innen werden direkt zum Termin eingeladen. |

## Wie die Outlook-Verbindung funktioniert

Die Verbindung wird über dein Microsoft-Konto hergestellt: Du meldest dich einmalig bei Microsoft an und erlaubst anny den Zugriff. anny fordert dabei nur Lese- und Schreibzugriff auf deine Kalender und dein Basisprofil an, keinen Zugriff auf E-Mails, Kontakte oder Dateien.

Nach dem Start der Synchronisation importiert anny zunächst alle zukünftigen Termine und Buchungen. Danach werden Änderungen in Echtzeit synchronisiert: Microsoft benachrichtigt anny aktiv über Änderungen im Kalender, und anny überträgt Buchungsänderungen sofort in den Kalender.

| Daten | Richtung | Häufigkeit |
| :- | :- | :- |
| Buchungen und Blocker der Ressource (inkl. Änderungen, Stornierungen) | anny → Outlook | Echtzeit |
| Termine des gewählten Kalenders (inkl. Serienterminen, Änderungen, Löschungen) | Outlook → anny | Echtzeit |
| Teams-Meeting-Link (optional) | anny → Outlook | bei Terminerstellung |

Synchronisiert wird ab dem heutigen Tag bis rund 13 Monate in die Zukunft; der Zeitraum wird automatisch monatlich verlängert. Vergangene Termine und Buchungen werden nicht importiert.

Läuft deine Autorisierung ab, etwa weil du dein Passwort geändert oder den Zugriff widerrufen hast, deaktiviert sich die Integration. Admins werden per E-Mail benachrichtigt, und in der Integrationszeile erscheint **Erneut autorisieren**.

## Outlook verbinden

### Voraussetzungen

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

* Ein Microsoft-Konto mit Outlook-Kalender (persönliches Konto; für gemeinsame Ressourcen- und Raumkalender deiner Organisation gibt es die Microsoft 365 Workspace-Integration)
* Bearbeitungsrechte für die Ressource in deinem anny Account
* Optional: einen eigenen Unterkalender in Outlook, wenn du die anny Termine getrennt halten möchtest

### Verbindung einrichten

<Steps>
  <Step title="Outlook verbinden öffnen">
    Öffne die Einstellungen deiner Ressource, wechsle zum Tab **Integrationen** und klicke im Abschnitt **Persönliche Kalender-Integrationen** auf **Outlook verbinden**.
  </Step>

  <Step title="Autorisiere deine Integration">
    Klicke auf **Autorisieren** und melde dich mit deinem Microsoft-Konto an. Nach erfolgreicher Anmeldung erscheint die Bestätigung „Erfolgreich authentifiziert".
  </Step>

  <Step title="Wähle einen Kalender">
    Wähle im Feld **Kalender** den Kalender aus, mit dem die Ressource synchronisiert werden soll. Alle Kalenderaktivitäten laufen in diesem Kalender. Du kannst auch einen eigenen Unterkalender in Outlook anlegen und hier auswählen.
  </Step>

  <Step title="Anpassen der Einstellungen">
    Lege fest, wie Termine und Buchungen übernommen werden (siehe Einstellungen & Optionen), und klicke anschließend auf **Sync starten**.
  </Step>
</Steps>

Sobald die Synchronisation gestartet ist, importiert anny alle zukünftigen Termine und Buchungen. Danach werden alle Änderungen in Echtzeit synchronisiert.

<Tip>
  Verbinde jede Ressource mit einem eigenen (Unter-)Kalender. Verbindest du denselben Kalender mit mehreren Ressourcen, kann es zu doppelten Einträgen kommen; die **Fehlerdiagnose** weist dich auf solche Überschneidungen hin.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Aktive Buchungsoptionen auswählen | Ein Termin wird nur für Buchungen der ausgewählten Buchungsoptionen erstellt. Ohne Auswahl gilt **Alle Buchungsoptionen**. Blocker werden immer synchronisiert. |
| Titel der Buchungen in anny | Bestimmt den Titel importierter Termine in anny: **Titel der Veranstaltung** oder **Anonymisiert**. Als privat oder vertraulich markierte Termine werden immer anonymisiert und erscheinen als „Nicht verfügbar". |
| Titel der Termine in Outlook | Bestimmt den Termintitel im Kalender: **Titel der Buchung**, **Buchungsnummer**, **Name der Ressource**, **Name des Services** oder **Name der Ressource und der Buchungsoption**. |
| Vor- und Nachbereitungszeit hinzufügen | Ist der Toggle aktiv, umfasst der Termin auch die Vor- und Nachbereitungszeit der Buchung. Eine 30-Minuten-Buchung mit 15 Minuten Vorbereitungszeit wird z. B. als 45-Minuten-Termin synchronisiert. |
| Alle Ereignisse synchronisieren | Ist der Toggle aktiv, werden auch Termine mit dem Status „frei" und „an einem anderen Ort tätig" nach anny übernommen. Andernfalls werden solche Termine übersprungen. |
| Termine als Blocker anlegen | Ist der Toggle aktiv, werden importierte Termine als Blocker angelegt. Andernfalls entstehen echte Buchungen mit dem gewählten Standardservice. |
| Standardservice für Buchungen | Der Service, den aus Terminen erstellte Buchungen erhalten. Der Termin-Organisator wird als Kund:in übernommen, Termin-Teilnehmende werden Buchungsteilnehmer:innen. |
| Teams Meeting zum Termin hinzufügen | Der für eine Buchung erstellte Termin wird zusätzlich als Teams-Online-Meeting angelegt; Kund:in und Teilnehmer:innen werden eingeladen. Über **Für ausgewählte Buchungsoptionen** kannst du das auf bestimmte Buchungsoptionen begrenzen. |

Wenn du von **Termine als Blocker anlegen** auf Buchungen umstellst, bietet anny die Option **Bestehende Blocker in Buchungen umwandeln** an: Alle zuvor aus Terminen erstellten zukünftigen Blocker werden dann beim Speichern und Aktivieren in Buchungen mit dem Standardservice umgewandelt.

<Tip>
  Über das Drei-Punkte-Menü der Integration erreichst du die **Fehlerdiagnose**. Sie prüft unter anderem die Erreichbarkeit des Kalenders, automatische Antworten, Überschneidungen mit anderen Kalender-Verbindungen und die Echtzeit-Verbindung.
</Tip>

## Einschränkungen

Die Outlook-Integration unterstützt nicht:

* **Vergangene Termine:** Synchronisiert wird nur ab dem heutigen Tag, bis rund 13 Monate in die Zukunft.
* **Mehrere Ressourcen pro Verbindung:** Jede Integration verbindet genau eine Ressource mit genau einem Kalender. Für weitere Ressourcen richtest du jeweils eine eigene Verbindung ein. Eine Integration auf einer übergeordneten Ressource synchronisiert allerdings auch die Buchungen ihrer Unterressourcen.
* **Gemeinsame Ressourcen- und Raumpostfächer:** Dafür gibt es die Microsoft 365 Workspace-Integration.
* **Termine mit Status „frei":** Diese werden standardmäßig nicht übernommen (änderbar über **Alle Ereignisse synchronisieren**).
* **Doppelte Verbindung desselben Kalenders:** Eine zweite Outlook-Verbindung derselben Ressource mit demselben Konto und Kalender lässt sich nicht aktivieren.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, stoppt die Synchronisation sofort; bereits synchronisierte Termine und Blocker bleiben bestehen. Beim Löschen fragt anny, ob **Alle Synchronisierungen (einschließlich vergangene)** oder **Nur zukünftige Synchronisierungen** entfernt werden: Aus Terminen erstellte Blocker und Buchungen werden gelöscht und aus Buchungen erstellte Termine aus deinem Outlook-Kalender entfernt. Ursprünglich in Outlook erstellte Termine und ursprünglich in anny erstellte Buchungen bleiben 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="Was passiert mit meinen privaten Terminen?">
    Als privat oder vertraulich markierte Termine werden immer anonymisiert übernommen und erscheinen in anny als „Nicht verfügbar". Zusätzlich kannst du über **Titel der Buchungen in anny** alle importierten Termine anonymisieren.
  </Accordion>

  <Accordion title="Werden Termine als Blocker oder als Buchungen übernommen?">
    Standardmäßig als Blocker: Die Zeit ist dann in anny nicht buchbar. Wenn du **Termine als Blocker anlegen** deaktivierst und einen **Standardservice für Buchungen** wählst, entstehen stattdessen echte Buchungen inklusive Kund:in (Termin-Organisator) und Teilnehmer:innen.
  </Accordion>

  <Accordion title="Wie schnell wird synchronisiert?">
    In Echtzeit. Microsoft benachrichtigt anny aktiv über Kalenderänderungen, und anny überträgt Buchungsänderungen sofort. Nach dem ersten Verbinden kann der Import aller zukünftigen Termine einige Minuten dauern.
  </Accordion>

  <Accordion title="Werden Serientermine unterstützt?">
    Ja. Serientermine aus Outlook werden als einzelne Blocker bzw. Buchungen übernommen. Auch Änderungen an einzelnen Terminen einer Serie oder das Löschen ab einem bestimmten Datum werden nachgezogen.
  </Accordion>

  <Accordion title="Was passiert, wenn ich einen synchronisierten Termin in Outlook lösche?">
    Entstand der Termin aus einer anny Buchung, wird die Buchung storniert und die Kund:in benachrichtigt. Hat der Termin einen Blocker erzeugt, wird der Blocker entfernt.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Bei der Integration steht „Erneut autorisieren“">
    Deine Autorisierung ist abgelaufen, z. B. nach einer Passwortänderung oder weil der Zugriff widerrufen wurde. Klicke auf **Erneut autorisieren**, melde dich mit deinem Microsoft-Konto an und aktiviere die Integration danach wieder über den **Toggle**.
  </Accordion>

  <Accordion title="Ein Outlook-Termin erscheint nicht in anny">
    Häufigste Ursache: Der Termin steht in Outlook auf „frei" oder „an einem anderen Ort tätig" und wird deshalb übersprungen. Aktiviere **Alle Ereignisse synchronisieren**, wenn auch diese Termine übernommen werden sollen. Prüfe außerdem, ob der Termin im verbundenen Kalender liegt, in der Zukunft beginnt und ob die Integration aktiv ist. Die **Fehlerdiagnose** im Drei-Punkte-Menü zeigt weitere mögliche Ursachen.
  </Accordion>

  <Accordion title="In anny oder Outlook erscheinen doppelte Einträge">
    Vermutlich ist derselbe Kalender oder dieselbe Ressource mehrfach verbunden, etwa über eine zweite Outlook-Verbindung, eine Microsoft 365-Regel oder einen ICS-Import. Führe die **Fehlerdiagnose** aus; sie zeigt solche Überschneidungen an. Entferne dann die überzählige Verbindung.
  </Accordion>

  <Accordion title="Die Integration hat sich von selbst deaktiviert">
    anny konnte die Echtzeit-Verbindung zu Microsoft nicht aufbauen oder die Autorisierung ist fehlgeschlagen; die betroffenen Admins wurden per E-Mail benachrichtigt. Bei vorübergehenden Störungen versucht anny es mehrfach automatisch erneut. Prüfe die Autorisierung und aktiviere die Integration wieder über den **Toggle**.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** „Outlook" ist die persönliche Kalender-Integration (ein Microsoft-Konto einer Einzelperson, pro Ressource eingerichtet). Sie ist NICHT: die Microsoft 365 Workspace-Integration (zentrale Verbindung des Organisations-Tenants mit Regeln für Ressourcen-/Personenkalender, Artikel m365-workspace), das Outlook Add-In (Buchen aus Outlook heraus, Artikel outlook-add-in) und nicht die MS-Teams-Videomeeting-Integration (Artikel ms-teams). Übersicht: Artikel kalenderintegrationen.
>
> **UI-Pfade:** Einrichtung NICHT über die zentrale Integrationsseite, sondern: Ressource → Tab **Integrationen** → Abschnitt „Persönliche Kalender-Integrationen" → Button „Outlook verbinden". Setup-Schritte: „1. Autorisiere deine Integration" (Button „Autorisieren"), „2. Wähle einen Kalender" (Feld „Kalender", erster Unterkalender vorausgewählt), „3. Anpassen der Einstellungen", Abschluss-Button „Sync starten". Einstellungs-Labels wortgleich: „Aktive Buchungsoptionen auswählen", „Titel der Buchungen in anny" (Optionen „Titel der Veranstaltung", „Anonymisiert"), „Titel der Termine in Outlook" (Optionen „Titel der Buchung", „Buchungsnummer", „Name der Ressource", „Name des Services", „Name der Ressource und der Buchungsoption"), „Vor- und Nachbereitungszeit hinzufügen", „Alle Ereignisse synchronisieren", „Termine als Blocker anlegen", „Standardservice für Buchungen", „Teams Meeting zum Termin hinzufügen" (+ „Für ausgewählte Buchungsoptionen"), Checkbox „Bestehende Blocker in Buchungen umwandeln". Aktionen im Drei-Punkte-Menü: Aktivieren/Deaktivieren, Löschen (Abfrage „Alle Synchronisierungen (einschließlich vergangene)" / „Nur zukünftige Synchronisierungen"), Verbindung testen, „Fehlerdiagnose" (Modal „Regel-Diagnose").
>
> **Quirks:** (1) Sync-Fenster: heute bis 365+30 Tage, monatliche automatische Verlängerung; Vergangenheit wird nie importiert. (2) Auch angefragte (noch nicht bestätigte) Buchungen und Blocker werden als Termin synchronisiert; abgelehnte/stornierte Buchungen führen zur Terminlöschung. (3) Termin-Teilnehmende werden nur eingeladen, wenn „Teams Meeting zum Termin hinzufügen" aktiv ist; sonst wird der Termin ohne Eingeladene angelegt (keine Einladungs-Mails aus Outlook). (4) Termine aus anny erhalten die Outlook-Kategorie „anny \[Ressourcenname]" und die Informationsnotiz der Buchung als Beschreibung. (5) Im Buchungs-Modus wird der Termin-Organisator automatisch als Kund:in angelegt (falls E-Mail unbekannt) und ein abgeschlossener Auftrag ohne Preis erzeugt; ist der Organisator der Kalender-Inhaber selbst, wird keine Kund:in gesetzt. (6) Termine mit Anzeigestatus „frei"/„an einem anderen Ort tätig" werden ohne „Alle Ereignisse synchronisieren" übersprungen; wechselt ein bestehender Termin auf „frei", wird der zugehörige Blocker/die Buchung entfernt. (7) Wechselt eine Buchung die Ressource, wird der Termin im alten Kalender gelöscht und im neuen angelegt. (8) Duplikat-Sperre nur pro Ressource (gleiches Konto + gleicher Kalender); derselbe Kalender an mehreren Ressourcen ist möglich, wird aber nur von der Fehlerdiagnose als Duplikat-Risiko gemeldet. (9) Webhook-Einrichtung wird bei Microsoft-Störungen nach 30 min / 2,5 h / 5 h wiederholt, danach Fehler + Selbst-Deaktivierung + E-Mail. (10) Beim Löschen der Buchung in anny wird die Kund:innen-Benachrichtigung unterdrückt, wenn die Buchung aus einem Termin entstand. (11) Synchronisierte Buchungen verlinken auf den Termin unter outlook.office365.com.
>
> **Beziehungen:** Feature-Gating über das Plan-Feature Kalendersynchronisation (gleiches Feature wie Google Kalender, Microsoft 365 Workspace, Google Workspace); ohne Feature ist der Bereich gesperrt. Voraussetzung außerdem Bearbeitungsrechte auf die Ressource. Teams-Meetings entstehen über dasselbe Microsoft-Konto (kein separater Teams-Artikel-Bezug). Parallel zur Outlook-Integration kann dieselbe Ressource auch mit Google Kalender verbunden werden; Konflikte mit ICS-Import/-Export meldet die Fehlerdiagnose.


# Outlook Add-In mit anny verbinden
Source: https://docs.anny.co/outlook-add-in

Buche Räume, registriere Besucher:innen und synchronisiere Termine direkt aus Outlook heraus.

Das anny [Outlook Add-In](https://appsource.microsoft.com/en-us/product/office/WA200006281) erweitert Microsoft Outlook um eine direkte Buchungsfunktion für anny. Mit dem Add-In kannst du Ressourcen buchen, Teilnehmer:innen verwalten und Besucher:innen registrieren, ohne Outlook zu verlassen.

* Räume und Arbeitsplätze direkt beim Erstellen eines Outlook-Termins buchen
* Besucher:innen für Meetings registrieren, auch ohne Raumbuchung
* Private Termine automatisch als Inkognito-Buchungen anlegen

Das Add-In eignet sich besonders für Unternehmen, die Raumbuchung, Desk Sharing oder Visitor Management nutzen und deren Teams vorwiegend in Outlook arbeiten.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| - | - |
| Raumbuchung aus Outlook | **Buche einen Meetingraum** direkt beim Anlegen eines Outlook-Termins, ohne in den anny Admin-Bereich wechseln zu müssen. |
| Besucherregistrierung | **Registriere externe Gäste** als Besucher:innen für einen Termin, auch wenn kein Raum gebucht wird. |
| Inkognito-Buchungen | **Lege private Termine** als Inkognito-Buchungen an, damit sensible Termine in anny nicht für andere sichtbar sind. |

## Wie das Outlook Add-In funktioniert

Das Add-In wird als Microsoft 365 App über das M365 Admin Center bereitgestellt. Nach der Installation erscheint es automatisch in Outlook und aktiviert sich beim Senden eines Termins (OnAppointmentSend-Event).

Die Kommunikation läuft über die anny API. Nutzer:innen authentifizieren sich mit ihrem Microsoft-Konto. Das Add-In benötigt Lesezugriff auf Kalendereinträge und grundlegende Profilinformationen.

| Daten | Richtung | Beschreibung |
| - | - | - |
| Buchungen | Outlook → anny | Neue Buchungen werden beim Terminsenden in anny erstellt |
| Teilnehmer:innen | Outlook → anny | Teilnehmer:innen des Outlook-Termins werden an anny übermittelt |
| Buchungsstatus | anny → Outlook | Bestätigung oder Ablehnung wird im Add-In angezeigt |
| Besucherregistrierung | Outlook → anny | Gäste werden als Besucher:innen in anny erfasst |

## Outlook Add-In verbinden

### Voraussetzungen

**Microsoft-Seite:**

* Microsoft 365 Admin-Rechte (für organisationsweite Bereitstellung) oder Exchange-Admin-Rechte (für On-Premise)
* Outlook Version 2206 (Build 15330.20196) oder neuer
* Freigegebene Hostnamen in der Firewall: `outlook.anny.co`, `cdn.anny.co`, `auth.anny.co`, `b.anny.co`, `api.anny.co`, `select.anny.eu`, `appsforoffice.microsoft.com`

**anny-Seite:**

* Ein aktiver anny Account mit mindestens einer buchbaren Ressource

### Installation über M365 Admin Center

<Steps>
  <Step title="M365 Admin Center öffnen">
    Gehe zu [admin.microsoft.com](https://admin.microsoft.com) und navigiere zu **Einstellungen** → **Integrierte Apps**.
  </Step>

  <Step title="anny Add-In suchen">
    Klicke auf **Apps abrufen** und suche nach **anny bookings**. Klicke auf **Jetzt abrufen**.
  </Step>

  <Step title="Bereitstellung konfigurieren">
    Wähle aus, für wen das Add-In bereitgestellt werden soll (gesamte Organisation, bestimmte Gruppen oder einzelne Nutzer:innen) und bestätige die Bereitstellung.
  </Step>

  <Step title="Berechtigungen akzeptieren">
    Akzeptiere die erforderlichen Berechtigungen. Das Add-In benötigt Lesezugriff auf Kalendereinträge, Profilinformationen und die Berechtigung zum Lesen und Schreiben von Terminelementen.
  </Step>
</Steps>

Nach der Bereitstellung erscheint das Add-In automatisch in Outlook und aktiviert sich beim Erstellen oder Senden von Terminen.

### Installation über Exchange (On-Premise)

<Steps>
  <Step title="Manifest herunterladen">
    Lade das Add-In-Manifest herunter: [https://b.anny.co/integrations/outlookAddIn/manifest](https://b.anny.co/integrations/outlookAddIn/manifest)
  </Step>

  <Step title="Mailbox-Version anpassen">
    Falls die Installation fehlschlägt, ersetze in der XML-Datei an beiden Stellen die Mailbox-Version `1.12` durch `1.1`:

    ```xml theme={null}
    <Set Name="Mailbox" MinVersion="1.1"/>
    ```
  </Step>

  <Step title="Manifest im Exchange Admin Center hochladen">
    Lade die angepasste XML-Datei im Exchange Admin Center als Add-In für deine Organisation hoch.
  </Step>
</Steps>

Nach der Installation steht das Add-In für alle Nutzer:innen in der Organisation zur Verfügung.

<Tip>
  Falls das Add-In nicht über den Microsoft App Store installiert werden kann, nutze alternativ den direkten Manifest-Download: [https://store.office.com/app/download?assetid=WA200006281\&cmu=en-US](https://store.office.com/app/download?assetid=WA200006281\&cmu=en-US)
</Tip>

### Berechtigungen im Detail

| Berechtigung | Beschreibung |
| - | - |
| Kalender lesen | Erlaubt dem Add-In, Termine in allen zugänglichen Kalendern zu lesen |
| Profil-Zugriff | Ermöglicht die Anmeldung mit dem Geschäftskonto und den Zugriff auf grundlegende Profilinformationen |
| ReadWrite Item | Erlaubt das Lesen und Bearbeiten des aktuellen Terminelements |
| Send Data | Ermöglicht das Senden von Buchungsdaten an anny |
| Auto-Start | Das Add-In startet automatisch beim Senden eines Termins |

### Besucherregistrierung einrichten

Um Besucher:innen direkt aus dem Outlook Add-In zu registrieren, brauchst du mindestens eine Ressource der Kategorie für Besucherregistrierung mit mindestens einer Buchungsoption. Sobald eine solche Ressource in deinem Account existiert, erscheint im Add-In neben den Teilnehmer:innen das Icon **Als Besucher registrieren**. Eine Raumbuchung ist dafür nicht nötig.

Richte die Ressource so ein, dass sie zu deinem Empfang passt:

<Steps>
  <Step title="Ressource und Buchungsoption anlegen">
    Lege eine Ressource in der Kategorie für Besucherregistrierung an und füge mindestens eine Buchungsoption hinzu. Die Verfügbarkeit muss die Uhrzeiten abdecken, zu denen Meetings stattfinden.
  </Step>

  <Step title="Check-in und Host vorbereiten">
    Aktiviere Check-in und die Host-Abfrage, wenn Gäste am Terminal einchecken und Hosts benachrichtigt werden sollen. Den vollständigen Empfangsprozess beschreibst du unter [Besucherverwaltung](/visitor-management).
  </Step>

  <Step title="Formulare und Unterschriften zeitlich legen">
    Setze rechtliche Dokumente und eigene Formulare auf **Später (beim Check-in)**, wenn Unterschriften und Zusatzangaben erst vor Ort nötig sind. Im Outlook-Overlay bleiben diese Felder optional. Beim Check-in werden sie Pflicht, falls sie noch leer sind.
  </Step>
</Steps>

Sobald die Kategorie-Ressource live ist und Nutzer:innen Community-Zugang haben, können sie Teilnehmer:innen im Add-In registrieren. Der genaue Ablauf steht im Artikel [Buchen über das Outlook Add-In](/outlook-add-in-user-guide).

<Frame>
  <img alt="Outlook Add-In mit Teilnehmerliste. Das Icon neben einem Gast öffnet das Overlay Als Besucher registrieren." />
</Frame>

Beim Senden des Outlook-Termins legt anny die Besucherbuchung an. Das gilt mit einer Raumbuchung im selben Termin und ohne Raum. Die Organisator:in wird Host der Besucherbuchung. Die Checkbox **Benachrichtigung senden** steuert, ob die Besucher:in eine anny-Bestätigung erhält. Sie ist standardmäßig aktiv.

## Einschränkungen

* Das Add-In funktioniert nur mit Outlook Version 2206 (Build 15330.20196) oder neuer
* On-Premise-Installationen erfordern gegebenenfalls eine manuelle Anpassung der Mailbox-Version im Manifest
* Die Besucherregistrierung erscheint nur, wenn mindestens eine Ressource der Kategorie für Besucherregistrierung mit einer Buchungsoption existiert
* Registrieren kannst du nur Teilnehmer:innen mit **Vor Ort**. Bei **Remote** ist das Icon deaktiviert. Eine vorhandene Registrierung wird entfernt
* Die Organisator:in (Host) hat kein Registrierungs-Icon
* Wenn du die Terminzeit änderst, entfallen noch nicht gesendete Besucherregistrierungen und müssen neu angewendet werden
* Terminverschiebungen durch einen anderen Termin-Owner als den ursprünglichen Buchenden können zu neuen Buchungen statt Änderungen führen

## Add-In entfernen

<Warning>
  Wenn du das Add-In entfernst, können Nutzer:innen keine neuen Buchungen mehr über Outlook erstellen. Bestehende Buchungen in anny bleiben erhalten.
</Warning>

<Steps>
  <Step title="M365 Admin Center öffnen">
    Gehe zu [admin.microsoft.com](https://admin.microsoft.com) und navigiere zu **Einstellungen** → **Integrierte Apps**.
  </Step>

  <Step title="anny Add-In auswählen">
    Suche in der Liste der integrierten Apps nach **anny bookings** und klicke darauf.
  </Step>

  <Step title="Add-In entfernen">
    Klicke auf **Entfernen** und bestätige die Deinstallation. Das Add-In wird für alle Nutzer:innen in der Organisation entfernt.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Muss jede:r Nutzer:in das Add-In selbst installieren?">
    Nein. Bei der Bereitstellung über das M365 Admin Center wird das Add-In automatisch für die ausgewählten Nutzer:innen oder die gesamte Organisation verfügbar.
  </Accordion>

  <Accordion title="Funktioniert das Add-In mit Outlook im Browser?">
    Ja. Das Add-In ist mit Outlook für Windows, Mac und Outlook im Web kompatibel, sofern die Mindestversion erfüllt ist.
  </Accordion>

  <Accordion title="Kann ich Besucher:innen registrieren, ohne einen Raum zu buchen?">
    Ja. Sobald eine Ressource der Kategorie für Besucherregistrierung existiert, kannst du Teilnehmer:innen mit **Vor Ort** registrieren. Ein Raum im selben Termin ist optional.
  </Accordion>

  <Accordion title="Wann füllen Besucher:innen Formulare oder unterschreiben Dokumente?">
    Pflichtfelder der Buchung füllst du im Add-In aus. Dokumente und Formulare mit **Später (beim Check-in)** sind dort optional. Fehlen sie noch, werden sie beim Check-in abgefragt.
  </Accordion>

  <Accordion title="Was passiert mit privaten Terminen?">
    Private Termine können als Inkognito-Buchungen in anny angelegt werden. Dadurch werden sie in anny nicht für andere Nutzer:innen sichtbar angezeigt.
  </Accordion>

  <Accordion title="Funktioniert das Add-In auf .eu und .co?">
    Ja. Das Add-In funktioniert mit beiden anny-Instanzen. Nutzer:innen müssen nicht zwingend in der Cloud sein.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Das Add-In wird in Outlook nicht angezeigt">
    Prüfe, ob deine Outlook-Version mindestens 2206 (Build 15330.20196) ist. Stelle sicher, dass das Add-In im M365 Admin Center für deine Nutzergruppe bereitgestellt wurde. Bei Firewall-Einschränkungen müssen die Hostnamen `outlook.anny.co`, `cdn.anny.co`, `auth.anny.co`, `b.anny.co`, `api.anny.co`, `select.anny.eu` und `appsforoffice.microsoft.com` freigegeben sein.
  </Accordion>

  <Accordion title="Die Installation im Exchange schlägt fehl">
    In Exchange-Umgebungen ist die Mailbox-Versionierung anders. Ersetze im Manifest an beiden Stellen die Mailbox-Version `1.12` durch `1.1` und versuche die Installation erneut.
  </Accordion>

  <Accordion title="Das Besucher-Badge erscheint nicht in der Teilnehmeransicht">
    Das Icon **Als Besucher registrieren** erscheint nur neben weiteren Teilnehmer:innen, nicht neben dir als Host. Die Person muss auf **Vor Ort** stehen. Außerdem braucht dein Account mindestens eine Ressource der Kategorie für Besucherregistrierung mit einer Buchungsoption. Eine Raumbuchung ist dafür nicht nötig.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Das Outlook Add-In wird NICHT in annys Integrationen-Menü im Admin-Bereich verwaltet. Installation und Deinstallation erfolgen ausschließlich über das M365 Admin Center (admin.microsoft.com → Einstellungen → Integrierte Apps) oder über Exchange (On-Premise mit Manifest).
> * Minimum-Version: Outlook 2206 (Build 15330.20196) oder neuer. Bezieht sich auf OnMessageSend/OnAppointmentSend/Smart Alerts Support.
> * Firewall: Hostnamen (keine IPs, Cloudflare rotiert): outlook.anny.co, cdn.anny.co, auth.anny.co, b.anny.co, api.anny.co, select.anny.eu, appsforoffice.microsoft.com
> * Manifest-URL für On-Premise: [https://b.anny.co/integrations/outlookAddIn/manifest](https://b.anny.co/integrations/outlookAddIn/manifest)
> * Exchange On-Premise Workaround: Mailbox MinVersion 1.12 → 1.1 ersetzen an beiden Stellen in der XML
> * Besucherregistrierung (kein Beta-Flag im Produkt, Stand 14.08.2026): Add-In lädt Ressourcen ausschließlich über Kategorie-Slug `visitor-registration` (singular, nicht `visitor-registrations`). Das Dropdown-Label im Overlay ist **Gebäude** / **Building** und ist nicht die CMS-Kategorie **Gebäude** (Slug `Gebäude`).
> * Badge-Bedingung: `visitorRegistrationAvailable` = mindestens eine solche Ressource mit Service im Account UND Teilnehmer ist nicht Host UND Typ ist Vor Ort. Unabhängig von einer Raumbuchung.
> * Finalisierung beim OnAppointmentSend: Besucherbuchungen (`is_visitor`) reichen ohne Resource-Mailbox-Attendee. Mit Raum werden beide Buchungstypen in derselben Order bestätigt. Channel `anny_outlook_add_in`. `visitor_registration_id` = lowercase Attendee-E-Mail (idempotent).
> * Host der Besucherbuchung = eingeloggte Organisator:in. Checkbox **Benachrichtigung senden** mappt auf `send_notification` (UI-Default an). Checkout-getimte Formulare/Dokumente sind im Overlay Pflicht, Check-in-Timing optional mit Hint `forms.collectionTiming.canBeFilledAtCheckIn`.
> * Zeitänderung oder Wechsel auf Remote entfernt die Draft-Besucherbuchung aus der Order.
> * Inkognito-Buchungen: Private Outlook-Termine werden als Inkognito-Buchungen in anny angelegt (Feature seit 22.07.2026).
> * Verwandte Artikel: /outlook-add-in-user-guide (Nutzung), /visitor-management (Empfang, Host-SMS, AI-Anruf), /legal-documents, /custom-forms, /outlook (Kalender-Sync), /m365-workspace.
> * Das Add-In funktioniert auf .eu und .co Instanzen.


# Buchen über das Outlook Add-In
Source: https://docs.anny.co/outlook-add-in-user-guide

Buche Räume und registriere Besucher:innen direkt aus Outlook, ohne die anny Buchungsseite zu öffnen.

Mit dem anny Outlook Add-In buchst du Meetingräume und Arbeitsplätze direkt beim Erstellen eines Outlook-Termins. Du kannst Teilnehmer:innen außerdem als Besucher:innen registrieren, mit oder ohne Raumbuchung. Der gewählte Raum wird automatisch als Standort hinzugefügt und bleibt mit dem Termin synchron.

<Info>
  Das Outlook Add-In muss von deinem IT-Admin im Exchange bereitgestellt worden sein. Falls du es nicht siehst, wende dich an dein IT-Team.
</Info>

## Buchung durchführen

<Steps>
  <Step title="Neuen Termin erstellen">
    Öffne Outlook und klicke auf **Neuer Termin**. Stelle wie gewohnt deine gewünschte Zeit ein.
  </Step>

  <Step title="anny Add-In öffnen">
    Klicke im Termin-Pop-up oben rechts auf die **drei Punkte** und wähle **anny** aus. Das Add-In öffnet sich auf der rechten Seite.
  </Step>

  <Step title="Verfügbare Ressourcen prüfen">
    Dir werden alle verfügbaren Ressourcen für den gewählten Zeitraum angezeigt (z. B. Meetingräume, Arbeitsplätze).
  </Step>

  <Step title="Raum auswählen">
    Klicke bei der gewünschten Ressource auf **Auswählen**. Der Raum wird als Standort zum Outlook-Termin hinzugefügt.
  </Step>

  <Step title="Termin senden">
    Klicke auf **Senden**. Deine Buchung ist abgeschlossen.
  </Step>
</Steps>

<Tip>
  Du kannst auch mehrere Räume zu einem Termin hinzufügen, z. B. einen Meetingraum und einen Parkplatz.
</Tip>

## Besucher:innen registrieren

Du registrierst externe Gäste als Besucher:innen direkt im Termin. Das funktioniert zusammen mit einer Raumbuchung und auch ohne Raum. Dein Admin muss dafür eine Ressource der Kategorie für Besucherregistrierung eingerichtet haben. Details zur Einrichtung stehen im Artikel [Outlook Add-In](/outlook-add-in).

<Steps>
  <Step title="Teilnehmer:innen zum Termin hinzufügen">
    Erstelle den Outlook-Termin und füge die Gäste wie gewohnt hinzu. Stelle die gewünschte Zeit ein.
  </Step>

  <Step title="anny Add-In öffnen">
    Klicke im Termin-Pop-up oben rechts auf die **drei Punkte** und wähle **anny** aus.
  </Step>

  <Step title="Anwesenheit festlegen">
    Unter **Teilnehmer** siehst du die Notiz **Wähle aus, wer persönlich oder remote an der Besprechung teilnehmen wird.** Stelle die Person auf **Vor Ort**.
  </Step>

  <Step title="Registrierung öffnen">
    Klicke neben der Person auf **Als Besucher registrieren**.
  </Step>

  <Step title="Gebäude und Service wählen">
    Wähle **Gebäude** und **Service**. Liegt der Termin außerhalb der Verfügbarkeit, erscheint **Für diese Besprechung ist keine Besucherregistrierung verfügbar.**
  </Step>

  <Step title="Daten prüfen und anwenden">
    Belasse **Benachrichtigung senden** aktiv, wenn die Person eine anny-Bestätigung erhalten soll. Prüfe **Vorname**, **Nachname** und weitere Felder. Klicke auf **Anwenden**.
  </Step>

  <Step title="Termin senden">
    Das Icon wechselt zu **Besucherregistrierung bereit**. Klicke auf **Senden**. Die Registrierung wird erst dann in anny bestätigt.
  </Step>
</Steps>

Sobald der Termin gesendet ist, ist die Besucherregistrierung in anny angelegt. Die Organisator:in ist Host der Besucherbuchung.

<Frame>
  <img alt="Outlook Add-In mit Teilnehmerliste. Das Icon neben einem Gast öffnet das Overlay Als Besucher registrieren mit Gebäude, Service, Benachrichtigung senden und Namensfeldern." />
</Frame>

<Frame>
  <img alt="Overlay Als Besucher registrieren mit Gebäude, Service und Namensfeldern. Nach dem Anwenden zeigt die Teilnehmerzeile ein grünes Häkchen für Besucherregistrierung bereit." />
</Frame>

<Tip>
  Eine Raumbuchung im selben Termin ist optional. Registrierte Besucher:innen erscheinen nicht in der Raumliste, sondern nur am Icon neben der Person. Stellst du die Person auf **Remote**, wird das Icon deaktiviert und eine schon angelegte Registrierung in diesem Entwurf entfernt. Änderst du die Terminzeit, musst du die Registrierung erneut anwenden.
</Tip>

## Filtermöglichkeiten

Im Add-In kannst du deine Suche verfeinern:

* **Zeitraum anpassen:** Wähle unter "Buchung finden" zwischen **Exakte Übereinstimmung**, **Am selben Tag** oder **Innerhalb der Woche**.
* **Nach Eigenschaften filtern:** Öffne das Filter-Symbol, um nach Ausstattung, Kapazität oder Standort zu suchen.

## Login

Du kannst dich im Outlook Add-In mit deinem **SSO** (Single Sign-On) oder deinem anny-Account einloggen. Der Login bleibt gespeichert, du musst dich nicht bei jedem Termin erneut anmelden.

## Gut zu wissen

* **Termin verschieben:** Wenn du deinen Outlook-Termin verschiebst, ändert sich die anny-Buchung automatisch in Echtzeit mit.
* **Termin löschen:** Beim Löschen des Termins wird auch die Buchung in anny storniert.
* **Inkognito-Buchung:** Wenn du einen privaten Outlook-Termin über das Add-In sendest, wird die Buchung in anny als Inkognito-Buchung erstellt (für andere Admin-Nutzer:innen nicht sichtbar).

<AccordionGroup>
  <Accordion title="Ich sehe das anny Add-In nicht in Outlook">
    Das Add-In muss von deinem IT-Admin im Exchange oder M365 Admin Center bereitgestellt werden. Frage bei deinem IT-Team nach, ob "anny bookings" installiert ist.
  </Accordion>

  <Accordion title="Mein Termin wird verschoben, aber die Buchung nicht">
    Stelle sicher, dass du den Raum über das anny Add-In hinzugefügt hast (nicht über die native Outlook-Raumsuche). Nur über das Add-In gebuchte Räume synchronisieren sich.
  </Accordion>

  <Accordion title="Ich sehe keine verfügbaren Ressourcen">
    Prüfe, ob der gewählte Zeitraum korrekt ist. Falls keine Ressourcen angezeigt werden, sind möglicherweise alle für diesen Zeitraum ausgebucht. Passe den Zeitfilter an.
  </Accordion>

  <Accordion title="Kann ich über das Add-In für andere buchen?">
    Nein, das Add-In bucht immer im Namen des eingeloggten Nutzers. Für Buchungen im Namen anderer nutze die Connected Persons Funktion auf der Buchungsseite.
  </Accordion>

  <Accordion title="Kann ich eine Person als Besucher:in registrieren, ohne einen Raum zu buchen?">
    Ja. Füge die Person zum Termin hinzu, stelle sie auf **Vor Ort** und wähle **Als Besucher registrieren**. Ein Raum ist nicht nötig.
  </Accordion>

  <Accordion title="Ich sehe das Icon zum Registrieren nicht">
    Das Icon erscheint nur neben weiteren Teilnehmer:innen, nicht neben **Du**. Die Person muss auf **Vor Ort** stehen. Außerdem muss dein Admin eine Ressource der Kategorie für Besucherregistrierung eingerichtet haben.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Installation: M365 Admin Center → Einstellungen → Integrierte Apps → "anny bookings"
> * Login im Add-In: SSO oder anny-Account, bleibt persistiert
> * Sync-Logik: Outlook-Termin verschieben = Buchung wird in Echtzeit aktualisiert
> * Outlook-Termin löschen = Buchung wird storniert
> * Privater Termin über Add-In = Inkognito-Buchung in anny
> * Native Outlook-Raumsuche ist NICHT mit anny verbunden, nur das Add-In
> * Mehrere Räume pro Termin möglich
> * Kein Book-on-behalf über das Add-In
> * Besucherregistrierung: Icon nur für Nicht-Host + Vor Ort, wenn Account mindestens eine Ressource mit Kategorie-Slug `visitor-registration` und Service hat. Finalisierung erst beim Senden. Host der Besucherbuchung = Organisator:in. **Benachrichtigung senden** Default an. Zeit ändern oder Remote entfernt den Draft.
> * Verwandter Admin-Artikel: /outlook-add-in (Einrichtung). Empfang/Check-in: /visitor-management


# Personio mit anny verbinden
Source: https://docs.anny.co/personio

Storniere Buchungen bei Abwesenheit automatisch und erstelle Abwesenheiten aus Buchungen in Personio.

[Personio](https://www.personio.de/) ist eine All-in-One HR-Software für Personalverwaltung, Recruiting, Gehaltsabrechnung und Abwesenheitsmanagement. Mit der Integration kann anny Abwesenheiten aus Personio erkennen und darauf reagieren.

Mit Personio kannst du in anny:

* Buchungen automatisch stornieren, wenn Mitarbeitende in Personio als abwesend gemeldet sind
* Abwesenheiten in Personio erstellen, wenn Mitarbeitende bestimmte Ressourcen in anny buchen (z. B. Homeoffice)
* Abwesenheitsregeln pro Abwesenheitstyp und Ressource individuell konfigurieren

Besonders praktisch ist die Integration, wenn dein Team hybride Arbeitsplätze über anny verwaltet und Abwesenheiten zentral in Personio gepflegt werden.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Automatische Stornierung bei Krankheit | **Buchungen werden automatisch storniert, wenn eine Krankmeldung in Personio vorliegt.** Mitarbeitende müssen Buchungen nicht manuell absagen, und blockierte Ressourcen werden freigegeben. |
| Homeoffice-Tage tracken | **Buchungen einer bestimmten Ressource erstellen automatisch eine Abwesenheit in Personio.** So werden Homeoffice-Tage im HR-System erfasst, ohne doppelte Datenpflege. |
| Urlaub mit Ressourcenfreigabe | **Bei genehmigtem Urlaub in Personio werden alle Buchungen im Urlaubszeitraum storniert.** Meetingräume und Schreibtische werden für andere Mitarbeitende verfügbar. |

## Wie die Personio-Verbindung funktioniert

Die Authentifizierung erfolgt über OAuth mit Client ID und Client Secret, die du in Personio generierst. Damit autorisierst du anny, Mitarbeiterdaten und Abwesenheiten zu lesen sowie Abwesenheiten zu erstellen. Werden die Zugangsdaten ungültig (z. B. weil sie in Personio gelöscht wurden), pausiert die Synchronisation, bis du die Authentifizierung in anny erneut erfolgreich prüfst.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Abwesenheiten (Stornierungsregeln) | Personio → anny | Stündlich (automatisch) oder manuell |
| Abwesenheiten (Erstellungsregeln) | anny → Personio | Bei Buchung (Echtzeit) |

<Warning>
  Die Synchronisation prüft ausschließlich Abwesenheiten, die am aktuellen Tag beginnen. Zukünftige Abwesenheiten (z. B. ein Urlaub nächste Woche) werden erst am jeweiligen Tag erkannt und verarbeitet, nicht im Voraus.
</Warning>

## Personio verbinden

### Voraussetzungen

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

* In Personio: Admin-Zugang mit Berechtigung zur Erstellung von API-Zugriffsdaten unter **Einstellungen > Integrationen > API-Zugriffsdaten**
* In Personio: Die folgenden API-Scopes müssen aktiviert sein:
  * Mitarbeiter lesen
  * Abwesenheiten lesen/bearbeiten
  * Anwesenheiten lesen/bearbeiten
  * Webhooks lesen/bearbeiten
* In anny: Admin-Rolle in der Organisation

### Verbindung einrichten

<Steps>
  <Step title="Integration öffnen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Personio**.
  </Step>

  <Step title="API-Zugriffsdaten in Personio generieren">
    Melde dich in Personio an und navigiere zu **Einstellungen > Integrationen > API-Zugriffsdaten**.

    1. Klicke auf **Neue Zugriffsdaten hinzufügen**
    2. Gib als Namen z. B. „anny API-Schlüssel“ ein
    3. Wähle die Integration **Andere**
    4. Aktiviere die Scopes: Mitarbeiter lesen, Abwesenheiten lesen/bearbeiten, Anwesenheiten lesen/bearbeiten, Webhooks lesen/bearbeiten
    5. Klicke auf **Neue Zugriffsdaten generieren**
  </Step>

  <Step title="Authentifizierung in anny prüfen">
    Trage die generierte Client ID und das Client Secret in die Felder **Client ID** und **Client Secret** in anny ein und klicke auf **Authentifizierung überprüfen**.
  </Step>

  <Step title="Regeln konfigurieren">
    Richte nach erfolgreicher Authentifizierung die gewünschten Regeln ein (siehe Einstellungen & Optionen).
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, kannst du Stornierungsregeln und Abwesenheits-Erstellungsregeln konfigurieren.

### Einstellungen & Optionen

Die Personio-Integration bietet zwei Regeltypen, die unabhängig voneinander konfiguriert werden.

#### Stornierung von Buchungen durch Abwesenheiten

Lege fest, bei welchen Abwesenheitstypen Buchungen automatisch storniert werden.

<Steps>
  <Step title="Neue Regel hinzufügen">
    Klicke im Bereich **Stornierung von Buchungen durch Abwesenheiten** auf **Hinzufügen**.
  </Step>

  <Step title="Abwesenheitstyp auswählen">
    Wähle einen oder mehrere Abwesenheitstypen aus Personio (z. B. Krankheit, Urlaub).
  </Step>

  <Step title="Einschränkung hinzufügen (optional)">
    Ohne Einschränkung gilt die Regel für alle Ressourcen. Über **Einschränkung hinzufügen** kannst du die Regel auf eine Ressource, Gruppe oder Kategorie beschränken. Wählst du eine Ressource mit Unterressourcen, gilt die Regel für deren Unterressourcen. Für mehrere Einschränkungen legst du mehrere Regeln an.
  </Step>

  <Step title="Bestätigen">
    Speichere die Regel mit **Bestätigen**. Durch **Synchronisieren** kannst du die Synchronisation sofort auslösen, andernfalls wird sie stündlich automatisch ausgeführt.
  </Step>
</Steps>

Sobald eine Regel aktiv ist, storniert anny bestätigte Buchungen der betroffenen Person automatisch. Die Stornierung greift auch nach Ablauf der Stornofrist, und als Stornierungsgrund erscheint der Name des Abwesenheitstyps. Bei mehrtägigen Abwesenheiten werden sofort alle Buchungen im gesamten Abwesenheitszeitraum storniert.

<Tip>
  Standardmäßig lösen auch nicht genehmigte Abwesenheitsanfragen in Personio eine Stornierung aus. Mit dem Schalter **Nur akzeptierte Abwesenheiten stornieren** beschränkst du die Stornierung auf genehmigte Abwesenheiten.
</Tip>

#### Automatische Erstellung von Abwesenheiten

Lege fest, bei welcher Ressource eine Buchung automatisch eine Abwesenheit in Personio erstellt.

<Steps>
  <Step title="Neue Regel hinzufügen">
    Klicke im Bereich **Erstellung von Abwesenheiten durch Buchungen** auf **Hinzufügen**.
  </Step>

  <Step title="Auslöser in anny wählen">
    Wähle die Ressource, Gruppe oder Kategorie aus, deren Buchung eine Abwesenheit auslösen soll (z. B. die Ressource „Homeoffice“). Bei Ressourcen mit Unterressourcen wählst du die übergeordnete Ressource: Buchungen der Unterressourcen zählen mit, eine Regel direkt auf einer Unterressource greift nicht.
  </Step>

  <Step title="Abwesenheitstyp in Personio wählen">
    Wähle den Abwesenheitstyp, der in Personio erstellt werden soll (z. B. „Homeoffice“).
  </Step>

  <Step title="Bestätigen">
    Speichere die Regel mit **Bestätigen**.
  </Step>
</Steps>

Sobald die Regel aktiv ist, erstellt jede bestätigte Buchung der gewählten Ressource eine Abwesenheit in Personio. Die Abwesenheit durchläuft dort den normalen Genehmigungsprozess und trägt den Kommentar „automatically created by anny“. Stornierst du die Buchung, löscht anny die erstellte Abwesenheit wieder; verschiebst du sie, wird die Abwesenheit automatisch neu erstellt.

Die Zuordnung zur Tageshälfte erfolgt automatisch:

| Buchungszeit | Erstellte Abwesenheit |
| - | - |
| Endzeit vor 15:00 Uhr | Erste Tageshälfte |
| Startzeit ab 12:00 Uhr | Zweite Tageshälfte |
| Komplett zwischen 12:00 und 15:00 Uhr | Zweite Tageshälfte |
| Start vor 12:00 Uhr und Ende ab 15:00 Uhr | Ganzer Tag |

Bei mehrtägigen Buchungen gilt die Zuordnung für den ersten bzw. letzten Tag der Abwesenheit.

## Einschränkungen

Die Personio-Integration unterstützt nicht:

* Vorausschauende Prüfung: Abwesenheiten werden ausschließlich tagesaktuell erkannt, nicht im Voraus (z. B. kein Stornieren nächste Woche eingetragener Urlaube)
* Echtzeit-Synchronisation für Stornierungen: Buchungen werden stündlich geprüft, nicht in Echtzeit
* User Provisioning oder Deprovisioning: Mitarbeitende werden nicht automatisch in anny angelegt oder entfernt
* Automatische Wiederherstellung: Stornierte Buchungen bleiben storniert, auch wenn die Abwesenheit in Personio später abgelehnt oder gelöscht wird
* Fehler-Benachrichtigungen: Schlägt die Erstellung einer Abwesenheit in Personio fehl, wiederholt anny den Versuch nicht und informiert Admins nicht

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, werden keine neuen Synchronisationen durchgeführt. Bestehende Regeln bleiben gespeichert, aber inaktiv. Beim Löschen werden alle Regeln und die Verbindungskonfiguration entfernt.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Wie oft synchronisiert anny die Abwesenheiten aus Personio?">
    Die Synchronisation läuft automatisch einmal pro Stunde. Du kannst sie jederzeit manuell über den Button **Synchronisieren** auslösen.
  </Accordion>

  <Accordion title="Werden auch zukünftige Abwesenheiten berücksichtigt?">
    Nein. Die Integration prüft ausschließlich Abwesenheiten, die am aktuellen Tag beginnen. Zukünftige Einträge (z. B. ein Urlaub in zwei Wochen) werden erst am jeweiligen Starttag verarbeitet.
  </Accordion>

  <Accordion title="Was passiert, wenn eine Abwesenheit in Personio noch nicht genehmigt ist?">
    Standardmäßig führen auch nicht genehmigte Abwesenheitsanfragen zur automatischen Stornierung der betroffenen Buchungen. Mit dem Schalter **Nur akzeptierte Abwesenheiten stornieren** kannst du das auf genehmigte Abwesenheiten beschränken. Beachte: Wird eine Anfrage später abgelehnt, bleiben bereits stornierte Buchungen storniert.
  </Accordion>

  <Accordion title="Welche Personio-Scopes brauche ich genau?">
    Du benötigst vier Scopes: Mitarbeiter lesen, Abwesenheiten lesen/bearbeiten, Anwesenheiten lesen/bearbeiten und Webhooks lesen/bearbeiten. Ohne diese Berechtigungen kann anny keine Abwesenheiten abrufen oder erstellen.
  </Accordion>

  <Accordion title="Kann ich die Stornierung auf bestimmte Ressourcen beschränken?">
    Ja. Beim Erstellen einer Regel kannst du über **Einschränkung hinzufügen** eine Ressource, Gruppe oder Kategorie festlegen; für mehrere Einschränkungen legst du mehrere Regeln an. Ohne Einschränkung gilt die Regel für alle Ressourcen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Buchungen werden nicht storniert, obwohl eine Abwesenheit in Personio eingetragen ist">
    Prüfe, ob alle vier API-Scopes korrekt gesetzt sind (besonders „Mitarbeiter lesen“ und „Abwesenheiten lesen/bearbeiten“). Stelle außerdem sicher, dass der Mitarbeitende in Personio mit derselben E-Mail-Adresse wie in anny registriert ist. Ist der Schalter **Nur akzeptierte Abwesenheiten stornieren** aktiv, prüfe, ob die Abwesenheit in Personio bereits genehmigt wurde. Beachte auch: Nur bestätigte Buchungen werden storniert.
  </Accordion>

  <Accordion title="Die Synchronisation storniert nur bei manuellem Klick">
    Prüfe, ob die Integration aktiv ist (Toggle oben rechts auf der Integrationsseite). Ist sie aktiv, läuft der Sync automatisch stündlich. Beachte, dass nur Abwesenheiten geprüft werden, die am aktuellen Tag beginnen.
  </Accordion>

  <Accordion title="Die Abwesenheit in Personio wird nicht erstellt">
    Stelle sicher, dass der Scope „Abwesenheiten lesen/bearbeiten“ aktiv ist und die Regel korrekt konfiguriert ist. Wichtig bei Unterressourcen: Die Regel muss auf die übergeordnete Ressource (oder deren Gruppe bzw. Kategorie) zeigen, nicht auf die Unterressource selbst. Prüfe außerdem, ob die buchende Person in Personio mit derselben E-Mail-Adresse existiert.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Sync-Präzisierung: Maßgeblich für „heute" ist die Zeitzone der Organisation. Abwesenheiten ohne Enddatum werden behandelt, als endeten sie 5 Jahre nach dem Start.
> * Stornierungs-Präzisierung: Storniert werden nur bestätigte Buchungen; Stornobedingungen/Stornofristen werden übergangen; als Stornierungsgrund wird der Name des Personio-Abwesenheitstyps gespeichert.
> * Schalter „Nur akzeptierte Abwesenheiten stornieren": bei Personio standardmäßig AUS (offene Anfragen stornieren mit).
> * Erstellungsregeln reagieren auf: neue Buchung sowie Änderung von Status, Zeitraum oder Ressource. Andere Änderungen (z. B. Teilnehmerzahl, Formulare) aktualisieren die Abwesenheit nicht. Bei Änderungen wird die Abwesenheit gelöscht und neu erstellt.
> * Nutzerzuordnung: E-Mail-Abgleich ohne Beachtung von Groß-/Kleinschreibung; nach dem ersten Treffer merkt sich anny die Personio-Personen-ID der Person.
> * Zugangsdaten: Nach erfolgreicher Authentifizierung sind die Felder Client ID/Client Secret gesperrt und können nicht direkt geändert werden.
> * Abgrenzung: Keine Synchronisation von Anwesenheiten oder Arbeitszeiten, keine Kalender-Synchronisation, kein SSO. Personio ist keine Kalender-Integration.
> * Beziehungen: HRworks-Integration hat identische Regel-Logik und Oberfläche, aber andere Authentifizierung (API-Key statt OAuth mit Client ID + Client Secret). Kein Plan-/Feature-Gating für Personio.
> * UI-Pfade/Labels: Menüleiste > Integrationen > Personio; Bereiche „Stornierung von Buchungen durch Abwesenheiten" und „Erstellung von Abwesenheiten durch Buchungen" (die Artikel-Überschrift „Automatische Erstellung von Abwesenheiten" ist historisch); Tabellenspalten „Abwesenheitstyp" und „Beschränkung" (ohne Einschränkung: „Keine"); Modal „Regel erstellen"/„Regel bearbeiten" mit Auswahl „Arten der Abwesenheit von Personio" und „Auswahl in anny:"; Buttons „Hinzufügen", „Bestätigen", „Einschränkung hinzufügen", „Synchronisieren" (zeigt danach „Synchronisiert").


# anny Display App auf Philips 10BDL4551T installieren
Source: https://docs.anny.co/philips-setup

Installiere die anny Display App per USB oder SD-Karte auf dem Philips Android Signage PoE Display.

Mit dieser Anleitung installierst du die anny Display App auf dem Philips 10BDL4551T Android Signage Display. Nach der Installation kannst du das Display direkt mit deinem anny Account verbinden und als Raumdisplay nutzen.

## Gerät einrichten und verbinden

## Admin-Modus aufrufen

<Tip>
  Du kannst das Admin-Passwort später ändern unter **Einstellungen** → **Anzeigeeinstellungen** → **Systemwerkzeuge** → **Administratorpasswort ändern**.
</Tip>

## anny Display App installieren

## anny Display App einrichten

Eine ausführliche Anleitung zur Konfiguration der Display App findest du im Artikel [anny Display App](/display-app).

## Ergebnis prüfen

Nach der Einrichtung zeigt das Philips Display den Belegungsstatus der verknüpften Ressource in Echtzeit an. Erstelle eine Testbuchung in anny und prüfe, ob sie innerhalb weniger Sekunden auf dem Display erscheint.

## FAQ

<AccordionGroup>
  <Accordion title="Wo finde ich die APK-Datei für die anny Display App?">
    Die aktuelle Version ist verfügbar unter [cdn.anny.co/apps/display-app/latest.apk](https://cdn.anny.co/apps/display-app/latest.apk). Alternativ kannst du den Support unter [support@anny.co](mailto:support@anny.co) kontaktieren.
  </Accordion>

  <Accordion title="Kann ich das Display auch per Google Play installieren?">
    Nein. Das Philips 10BDL4551T ist ein Signage-Display ohne Google Play Store. Die Installation erfolgt ausschließlich per APK über USB-Stick oder SD-Karte.
  </Accordion>

  <Accordion title="Wie komme ich zurück zum Admin-Modus, wenn das Display die App im Vollbild zeigt?">
    Drücke gleichzeitig die **Ein-/Austaste** und **Lautstärke verringern** auf der Rückseite. Gib das Passwort ein (Standard: 1234).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Das Display zeigt nach dem Start einen schwarzen Bildschirm">
    Das Display befindet sich im Standard-Source-Modus. Drücke **Ein-/Austaste + Lautstärke verringern** auf der Rückseite, gib das Passwort 1234 ein und navigiere zu den Eingangseinstellungen, um die anny Display App als Custom App festzulegen.
  </Accordion>

  <Accordion title="Die APK-Datei lässt sich nicht installieren">
    Prüfe, ob die Installation aus unbekannten Quellen erlaubt ist. Gehe zu **Settings** → **Security** und aktiviere **Unknown Sources**. Versuche die Installation erneut.
  </Accordion>

  <Accordion title="Das Display verbindet sich nicht mit dem Netzwerk">
    Prüfe, ob das PoE-Kabel auch Datendurchsatz liefert (nicht nur Strom). Bei Wi-Fi: Stelle sicher, dass das Netzwerk auf 2,4 GHz sendet, da einige Signage-Displays 5 GHz nicht unterstützen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Modell: Philips 10BDL4551T (10" Android Signage PoE Display)
> * Kein Google Play Store verfügbar, Installation nur per APK (USB/SD)
> * APK-URL: [https://cdn.anny.co/apps/display-app/latest.apk](https://cdn.anny.co/apps/display-app/latest.apk)
> * Admin-Modus: Ein-/Austaste + Lautstärke verringern (Rückseite), Passwort: 1234 (Standard)
> * Autostart: Settings → Signage Display → Source Settings → Custom App → anny Display App
> * Handbuch: [https://www.p4c.philips.com/files/1/10bdl4551t\_93/10bdl4551t\_93\_dfu\_eng.pdf](https://www.p4c.philips.com/files/1/10bdl4551t_93/10bdl4551t_93_dfu_eng.pdf)
> * Abgrenzung: Dieser Artikel beschreibt NUR die Hardware-Installation. Die App-Konfiguration (Widgets, Pairing etc.) steht im Artikel /display-app (anny Display App).
> * PoE-Hinweis: Display unterstützt Power over Ethernet, d.h. ein Kabel für Strom + Netzwerk


# Datenschutzerklärung
Source: https://docs.anny.co/privacy-policy

Die Datenschutzerklärung für Website, Adminbereich und verbundene anny Subdomains.

*Version 1.5*

*If copies of these GTC have been made in languages other than German, only the German version is binding for anny and the provider.*

Diese Datenschutzerklärung gilt auch für [app.anny.co](http://app.anny.co) und [try.anny.co](http://try.anny.co) sowie weitere Subdomains von [anny.co](http://anny.co).

Für unsere Kunden stellen wir einen AVV, welcher den Umgang mit den Daten vertraglich vereinbart.

## 1. Datenschutz auf einen Blick

### Allgemeine Hinweise

Die folgenden Hinweise geben einen einfachen Überblick darüber, was mit Ihren personenbezogenen Daten passiert, wenn Sie diese Website besuchen. Personenbezogene Daten sind alle Daten, mit denen Sie persönlich identifiziert werden können. Ausführliche Informationen zum Thema Datenschutz entnehmen Sie unserer unter diesem Text aufgeführten Datenschutzerklärung.

### Datenerfassung auf dieser Website

#### Wer ist verantwortlich für die Datenerfassung auf dieser Website?

Die Datenverarbeitung auf dieser Website erfolgt durch den Websitebetreiber. Dessen Kontaktdaten können Sie dem Impressum dieser Website entnehmen.

#### Wie erfassen wir Ihre Daten?

Ihre Daten werden zum einen dadurch erhoben, dass Sie uns diese mitteilen. Hierbei kann es sich z. B. um Daten handeln, die Sie in ein Kontaktformular eingeben.

Andere Daten werden automatisch oder nach Ihrer Einwilligung beim Besuch der Website durch unsere IT-Systeme erfasst. Das sind vor allem technische Daten (z. B. Internetbrowser, Betriebssystem oder Uhrzeit des Seitenaufrufs). Die Erfassung dieser Daten erfolgt automatisch, sobald Sie diese Website betreten.

#### Wofür nutzen wir Ihre Daten?

Ein Teil der Daten wird erhoben, um eine fehlerfreie Bereitstellung der Website zu gewährleisten. Andere Daten können zur Analyse Ihres Nutzerverhaltens verwendet werden.

#### Welche Rechte haben Sie bezüglich Ihrer Daten?

Sie haben jederzeit das Recht, unentgeltlich Auskunft über Herkunft, Empfänger und Zweck Ihrer gespeicherten personenbezogenen Daten zu erhalten. Sie haben außerdem ein Recht, die Berichtigung oder Löschung dieser Daten zu verlangen. Wenn Sie eine Einwilligung zur Datenverarbeitung erteilt haben, können Sie diese Einwilligung jederzeit für die Zukunft widerrufen. Außerdem haben Sie das Recht, unter bestimmten Umständen die Einschränkung der Verarbeitung Ihrer personenbezogenen Daten zu verlangen. Des Weiteren steht Ihnen ein Beschwerderecht bei der zuständigen Aufsichtsbehörde zu.

Hierzu sowie zu weiteren Fragen zum Thema Datenschutz können Sie sich jederzeit unter der im Impressum angegebenen Adresse an uns wenden.

#### Analyse-Tools und Tools von Drittanbietern

Beim Besuch dieser Website kann Ihr Surf-Verhalten statistisch ausgewertet werden. Das geschieht vor allem mit sogenannten Analyseprogrammen.

Detaillierte Informationen zu diesen Analyseprogrammen finden Sie in der folgenden Datenschutzerklärung.

## 2. Hosting und Content Delivery Networks (CDN)

### Externes Hosting

Diese Website wird bei einem externen Dienstleister gehostet (Hoster). Die personenbezogenen Daten, die auf dieser Website erfasst werden, werden auf den Servern des Hosters gespeichert. Hierbei kann es sich v. a. um IP-Adressen, Kontaktanfragen, Meta- und Kommunikationsdaten, Vertragsdaten, Kontaktdaten, Namen, Websitezugriffe und sonstige Daten, die über eine Website generiert werden, handeln.

Der Einsatz des Hosters erfolgt zum Zwecke der Vertragserfüllung gegenüber unseren potenziellen und bestehenden Kunden (Art. 6 Abs. 1 lit. b DSGVO) und im Interesse einer sicheren, schnellen und effizienten Bereitstellung unseres Online-Angebots durch einen professionellen Anbieter (Art. 6 Abs. 1 lit. f DSGVO).

Unser Hoster wird Ihre Daten nur insoweit verarbeiten, wie dies zur Erfüllung seiner Leistungspflichten erforderlich ist und unsere Weisungen in Bezug auf diese Daten befolgen.

### Abschluss eines Vertrages über Auftragsverarbeitung

#### Webflow

Anbieter ist die Webflow, Inc., 398 11th Street, 2nd Floor, San Francisco, CA 94103, USA (nachfolgend Webflow). Wenn Sie unsere Website besuchen, erfasst Webflow verschiedene Logfiles inklusive Ihrer IP-Adressen.

Webflow ist ein Tool zum Erstellen und zum Hosten von Websites. Webflow speichert Cookies oder sonstige Wiedererkennungstechnologien, die für die Darstellung der Seite, zur Bereitstellung bestimmter Webseitenfunktionen und zur Gewährleistung der Sicherheit erforderlich sind (notwendige Cookies).

Details entnehmen Sie der Datenschutzerklärung von Webflow: [https://webflow.com/legal/eu-privacy-policy](https://webflow.com/legal/eu-privacy-policy).

Die Verwendung von Webflow erfolgt auf Grundlage von Art. 6 Abs. 1 lit. f DSGVO. Wir haben ein berechtigtes Interesse an einer möglichst zuverlässigen Darstellung unserer Website. Sofern eine entsprechende Einwilligung abgefragt wurde, erfolgt die Verarbeitung ausschließlich auf Grundlage von Art. 6 Abs. 1 lit. a DSGVO und § 25 Abs. 1 TTDSG, soweit die Einwilligung die Speicherung von Cookies oder den Zugriff auf Informationen im Endgerät des Nutzers (z. B. Device-Fingerprinting) im Sinne des TTDSG umfasst. Die Einwilligung ist jederzeit widerrufbar.

Die Datenübertragung in die USA wird auf die Standardvertragsklauseln der EU-Kommission gestützt. Details finden Sie hier: [https://webflow.com/legal/eu-privacy-policy](https://webflow.com/legal/eu-privacy-policy).

#### [bunny.net](http://bunny.net)

Wir nutzen den Service "[bunny.net](http://bunny.net)". Anbieter ist die BUNNYWAY, informacijske storitve d.o.o., Cesta komandanta Staneta 4A, 1215 Medvode, Slovenia (im Folgenden „[bunny.net](http://bunny.net)”).

[bunny.net](http://bunny.net) bietet ein weltweit verteiltes Content Delivery Network mit Firewall an. Dabei wird technisch der Informationstransfer zwischen Ihrem Browser und unserer Website über das Netzwerk von [bunny.net](http://bunny.net) geleitet. Das versetzt [bunny.net](http://bunny.net) in die Lage, den Datenverkehr zwischen Ihrem Browser und unserer Website zu analysieren und als Filter zwischen unseren Servern und potenziell bösartigem Datenverkehr aus dem Internet zu dienen. Hierbei kann [bunny.net](http://bunny.net) auch Cookies oder sonstige Technologien zur Wiedererkennung von Internetnutzern einsetzen, die jedoch allein zum hier beschriebenen Zweck verwendet werden.

Der Einsatz von [bunny.net](http://bunny.net) beruht auf unserem berechtigten Interesse an einer möglichst fehlerfreien und sicheren Bereitstellung unseres Webangebotes (Art. 6 Abs. 1 lit. f DSGVO).

Weitere Informationen zum Thema Sicherheit und Datenschutz bei [bunny.net](http://bunny.net) finden Sie hier: [https://bunnycdn.com/privacy](https://bunnycdn.com/privacy).

#### Cloudflare

Wir nutzen den Service „Cloudflare“. Anbieter ist die Cloudflare Inc., 101 Townsend St., San Francisco, CA 94107, USA (im Folgenden „Cloudflare”).

Cloudflare bietet ein weltweit verteiltes Content Delivery Network mit DNS an. Dabei wird technisch der Informationstransfer zwischen Ihrem Browser und unserer Website über das Netzwerk von Cloudflare geleitet. Das versetzt Cloudflare in die Lage, den Datenverkehr zwischen Ihrem Browser und unserer Website zu analysieren und als Filter zwischen unseren Servern und potenziell bösartigem Datenverkehr aus dem Internet zu dienen. Hierbei kann Cloudflare auch Cookies oder sonstige Technologien zur Wiedererkennung von Internetnutzern einsetzen, die jedoch allein zum hier beschriebenen Zweck verwendet werden.

Der Einsatz von Cloudflare beruht auf unserem berechtigten Interesse an einer möglichst fehlerfreien und sicheren Bereitstellung unseres Webangebotes (Art. 6 Abs. 1 lit. f DSGVO).

Die Datenübertragung in die USA wird auf die Standardvertragsklauseln der EU-Kommission gestützt. Details finden Sie hier: [https://www.cloudflare.com/privacypolicy/](https://www.cloudflare.com/privacypolicy/).

Weitere Informationen zum Thema Sicherheit und Datenschutz bei Cloudflare finden Sie hier: [https://www.cloudflare.com/privacypolicy/](https://www.cloudflare.com/privacypolicy/).

#### Auftragsverarbeitung

Wir haben einen Vertrag über Auftragsverarbeitung (AVV) mit dem oben genannten Anbietern geschlossen. Hierbei handelt es sich um einen datenschutzrechtlich vorgeschriebenen Vertrag, der gewährleistet, dass dieser die personenbezogenen Daten unserer Websitebesucher nur nach unseren Weisungen und unter Einhaltung der DSGVO verarbeitet.

Um die datenschutzkonforme Verarbeitung zu gewährleisten, haben wir einen Vertrag über Auftragsverarbeitung mit unserem Hoster geschlossen.

## 3. Allgemeine Hinweise und Pflichtinformationen

### Datenschutz

Die Betreiber dieser Seiten nehmen den Schutz Ihrer persönlichen Daten sehr ernst. Wir behandeln Ihre personenbezogenen Daten vertraulich und entsprechend der gesetzlichen Datenschutzvorschriften sowie dieser Datenschutzerklärung.

Wenn Sie diese Website benutzen, werden verschiedene personenbezogene Daten erhoben. Personenbezogene Daten sind Daten, mit denen Sie persönlich identifiziert werden können. Die vorliegende Datenschutzerklärung erläutert, welche Daten wir erheben und wofür wir sie nutzen. Sie erläutert auch, wie und zu welchem Zweck das geschieht.

Wir weisen darauf hin, dass die Datenübertragung im Internet (z. B. bei der Kommunikation per E-Mail) Sicherheitslücken aufweisen kann. Ein lückenloser Schutz der Daten vor dem Zugriff durch Dritte ist nicht möglich.

#### Hinweis zur verantwortlichen Stelle

Die verantwortliche Stelle für die Datenverarbeitung auf dieser Website ist:

anny GmbH Cäcilienstraße 30 50667 Köln Telefon: +49 241 93688158 E-Mail: [hello@anny.co](mailto:hello@anny.co)

Verantwortliche Stelle ist die natürliche oder juristische Person, die allein oder gemeinsam mit anderen über die Zwecke und Mittel der Verarbeitung von personenbezogenen Daten (z. B. Namen, E-Mail-Adressen o. Ä.) entscheidet.

#### Speicherdauer

Soweit innerhalb dieser Datenschutzerklärung keine speziellere Speicherdauer genannt wurde, verbleiben Ihre personenbezogenen Daten bei uns, bis der Zweck für die Datenverarbeitung entfällt. Wenn Sie ein berechtigtes Löschersuchen geltend machen oder eine Einwilligung zur Datenverarbeitung widerrufen, werden Ihre Daten gelöscht, sofern wir keine anderen rechtlich zulässigen Gründe für die Speicherung Ihrer personenbezogenen Daten haben (z. B. steuer- oder handelsrechtliche Aufbewahrungsfristen); im letztgenannten Fall erfolgt die Löschung nach Fortfall dieser Gründe.

#### Allgemeine Hinweise zu den Rechtsgrundlagen der Datenverarbeitung auf dieser Website

Sofern Sie in die Datenverarbeitung eingewilligt haben, verarbeiten wir Ihre personenbezogenen Daten auf Grundlage von Art. 6 Abs. 1 lit. a DSGVO bzw. Art. 9 Abs. 2 lit. a DSGVO, sofern besondere Datenkategorien nach Art. 9 Abs. 1 DSGVO verarbeitet werden. Im Falle einer ausdrücklichen Einwilligung in die Übertragung personenbezogener Daten in Drittstaaten erfolgt die Datenverarbeitung außerdem auf Grundlage von Art. 49 Abs. 1 lit. a DSGVO. Sofern Sie in die Speicherung von Cookies oder in den Zugriff auf Informationen in Ihr Endgerät (z. B. via Device-Fingerprinting) eingewilligt haben, erfolgt die Datenverarbeitung zusätzlich auf Grundlage von § 25 Abs. 1 TTDSG. Die Einwilligung ist jederzeit widerrufbar. Sind Ihre Daten zur Vertragserfüllung oder zur Durchführung vorvertraglicher Maßnahmen erforderlich, verarbeiten wir Ihre Daten auf Grundlage des Art. 6 Abs. 1 lit. b DSGVO. Des Weiteren verarbeiten wir Ihre Daten, sofern diese zur Erfüllung einer rechtlichen Verpflichtung erforderlich sind auf Grundlage von Art. 6 Abs. 1 lit. c DSGVO. Die Datenverarbeitung kann ferner auf Grundlage unseres berechtigten Interesses nach Art. 6 Abs. 1 lit. f DSGVO erfolgen. Über die jeweils im Einzelfall einschlägigen Rechtsgrundlagen wird in den folgenden Absätzen dieser Datenschutzerklärung informiert.

#### Gesetzlich vorgeschriebener Datenschutzbeauftragter

Wir haben für unser Unternehmen einen Datenschutzbeauftragten bestellt.

anny GmbH Adriaan Wind Cäcilienstraße 30 50667 Köln Telefon: +49 241 93688158 E-Mail: [privacy@anny.co](mailto:privacy@anny.co)

### Hinweis zur Datenweitergabe in datenschutzrechtlich nicht sichere Drittstaaten

Beim Besuch von [try.anny.co](http://try.anny.co) verwenden unter anderem Tools von Unternehmen mit Sitz in datenschutzrechtlich nicht sicheren Drittstaaten. Wenn diese Tools aktiv sind, können personenbezogene Daten in diese Staaten übertragen und dort verarbeitet werden. Wir weisen darauf hin, dass in datenschutzrechtlich unsicheren Drittstaaten kein mit der EU vergleichbares Datenschutzniveau garantiert werden kann.

Wir weisen darauf hin, dass die USA als sicherer Drittstaat grundsätzlich ein mit der EU vergleichbares Datenschutzniveau aufweisen. Eine Datenübertragung in die USA ist danach zulässig, wenn der Empfänger eine Zertifizierung unter dem „EU-US Data Privacy Framework“ (DPF) besitzt oder über geeignete zusätzliche Garantien verfügt. Informationen zu Übermittlungen an Drittstaaten einschließlich der Datenempfänger finden Sie in dieser Datenschutzerklärung.

### Widerruf Ihrer Einwilligung zur Datenverarbeitung

Viele Datenverarbeitungsvorgänge sind nur mit Ihrer ausdrücklichen Einwilligung möglich. Sie können eine bereits erteilte Einwilligung jederzeit widerrufen. Die Rechtmäßigkeit der bis zum Widerruf erfolgten Datenverarbeitung bleibt vom Widerruf unberührt.

### Widerspruchsrecht gegen die Datenerhebung in besonderen Fällen sowie gegen Direktwerbung (Art. 21 DSGVO)

WENN DIE DATENVERARBEITUNG AUF GRUNDLAGE VON ART. 6 ABS. 1 LIT. E ODER F DSGVO ERFOLGT, HABEN SIE JEDERZEIT DAS RECHT, AUS GRÜNDEN, DIE SICH AUS IHRER BESONDEREN SITUATION ERGEBEN, GEGEN DIE VERARBEITUNG IHRER PERSONENBEZOGENEN DATEN WIDERSPRUCH EINZULEGEN; DIES GILT AUCH FÜR EIN AUF DIESE BESTIMMUNGEN GESTÜTZTES PROFILING. DIE JEWEILIGE RECHTSGRUNDLAGE, AUF DENEN EINE VERARBEITUNG BERUHT, ENTNEHMEN SIE DIESER DATENSCHUTZERKLÄRUNG. WENN SIE WIDERSPRUCH EINLEGEN, WERDEN WIR IHRE BETROFFENEN PERSONENBEZOGENEN DATEN NICHT MEHR VERARBEITEN, ES SEI DENN, WIR KÖNNEN ZWINGENDE SCHUTZWÜRDIGE GRÜNDE FÜR DIE VERARBEITUNG NACHWEISEN, DIE IHRE INTERESSEN, RECHTE UND FREIHEITEN ÜBERWIEGEN ODER DIE VERARBEITUNG DIENT DER GELTENDMACHUNG, AUSÜBUNG ODER VERTEIDIGUNG VON RECHTSANSPRÜCHEN (WIDERSPRUCH NACH ART. 21 ABS. 1 DSGVO).

WERDEN IHRE PERSONENBEZOGENEN DATEN VERARBEITET, UM DIREKTWERBUNG ZU BETREIBEN, SO HABEN SIE DAS RECHT, JEDERZEIT WIDERSPRUCH GEGEN DIE VERARBEITUNG SIE BETREFFENDER PERSONENBEZOGENER DATEN ZUM ZWECKE DERARTIGER WERBUNG EINZULEGEN; DIES GILT AUCH FÜR DAS PROFILING, SOWEIT ES MIT SOLCHER DIREKTWERBUNG IN VERBINDUNG STEHT. WENN SIE WIDERSPRECHEN, WERDEN IHRE PERSONENBEZOGENEN DATEN ANSCHLIESSEND NICHT MEHR ZUM ZWECKE DER DIREKTWERBUNG VERWENDET (WIDERSPRUCH NACH ART. 21 ABS. 2 DSGVO).

### Beschwerderecht bei der zuständigen Aufsichtsbehörde

Im Falle von Verstößen gegen die DSGVO steht den Betroffenen ein Beschwerderecht bei einer Aufsichtsbehörde, insbesondere in dem Mitgliedstaat ihres gewöhnlichen Aufenthalts, ihres Arbeitsplatzes oder des Orts des mutmaßlichen Verstoßes zu. Das Beschwerderecht besteht unbeschadet anderweitiger verwaltungsrechtlicher oder gerichtlicher Rechtsbehelfe.

### Recht auf Datenübertragbarkeit

Sie haben das Recht, Daten, die wir auf Grundlage Ihrer Einwilligung oder in Erfüllung eines Vertrags automatisiert verarbeiten, an sich oder an einen Dritten in einem gängigen, maschinenlesbaren Format aushändigen zu lassen. Sofern Sie die direkte Übertragung der Daten an einen anderen Verantwortlichen verlangen, erfolgt dies nur, soweit es technisch machbar ist.

### SSL- bzw. TLS-Verschlüsselung

Diese Seite nutzt aus Sicherheitsgründen und zum Schutz der Übertragung vertraulicher Inhalte, wie zum Beispiel Bestellungen oder Anfragen, die Sie an uns als Seitenbetreiber senden, eine SSL- bzw. TLS-Verschlüsselung. Eine verschlüsselte Verbindung erkennen Sie daran, dass die Adresszeile des Browsers von „http\://“ auf „https\://“ wechselt und an dem Schloss-Symbol in Ihrer Browserzeile.

Wenn die SSL- bzw. TLS-Verschlüsselung aktiviert ist, können die Daten, die Sie an uns übermitteln, nicht von Dritten mitgelesen werden.

### Verschlüsselter Zahlungsverkehr auf dieser Website

Besteht nach dem Abschluss eines kostenpflichtigen Vertrags eine Verpflichtung, uns Ihre Zahlungsdaten (z. B. Kontonummer bei Einzugsermächtigung) zu übermitteln, werden diese Daten zur Zahlungsabwicklung benötigt.

Der Zahlungsverkehr über die gängigen Zahlungsmittel (Visa/MasterCard, Lastschriftverfahren) erfolgt ausschließlich über eine verschlüsselte SSL- bzw. TLS-Verbindung. Eine verschlüsselte Verbindung erkennen Sie daran, dass die Adresszeile des Browsers von „http\://“ auf „https\://“ wechselt und an dem Schloss-Symbol in Ihrer Browserzeile.

Bei verschlüsselter Kommunikation können Ihre Zahlungsdaten, die Sie an uns übermitteln, nicht von Dritten mitgelesen werden.

### Auskunft, Löschung und Berichtigung

Sie haben im Rahmen der geltenden gesetzlichen Bestimmungen jederzeit das Recht auf unentgeltliche Auskunft über Ihre gespeicherten personenbezogenen Daten, deren Herkunft und Empfänger und den Zweck der Datenverarbeitung und ggf. ein Recht auf Berichtigung oder Löschung dieser Daten. Hierzu sowie zu weiteren Fragen zum Thema personenbezogene Daten können Sie sich jederzeit unter der im Impressum angegebenen Adresse an uns wenden.

### Recht auf Einschränkung der Verarbeitung

Sie haben das Recht, die Einschränkung der Verarbeitung Ihrer personenbezogenen Daten zu verlangen. Hierzu können Sie sich jederzeit unter der im Impressum angegebenen Adresse an uns wenden. Das Recht auf Einschränkung der Verarbeitung besteht in folgenden Fällen:

* Wenn Sie die Richtigkeit Ihrer bei uns gespeicherten personenbezogenen Daten bestreiten, benötigen wir in der Regel Zeit, um dies zu überprüfen. Für die Dauer der Prüfung haben Sie das Recht, die Einschränkung der Verarbeitung Ihrer personenbezogenen Daten zu verlangen.
* Wenn die Verarbeitung Ihrer personenbezogenen Daten unrechtmäßig geschah/geschieht, können Sie statt der Löschung die Einschränkung der Datenverarbeitung verlangen.
* Wenn wir Ihre personenbezogenen Daten nicht mehr benötigen, Sie sie jedoch zur Ausübung, Verteidigung oder Geltendmachung von Rechtsansprüchen benötigen, haben Sie das Recht, statt der Löschung die Einschränkung der Verarbeitung Ihrer personenbezogenen Daten zu verlangen.
* Wenn Sie einen Widerspruch nach Art. 21 Abs. 1 DSGVO eingelegt haben, muss eine Abwägung zwischen Ihren und unseren Interessen vorgenommen werden. Solange noch nicht feststeht, wessen Interessen überwiegen, haben Sie das Recht, die Einschränkung der Verarbeitung Ihrer personenbezogenen Daten zu verlangen.

Wenn Sie die Verarbeitung Ihrer personenbezogenen Daten eingeschränkt haben, dürfen diese Daten von ihrer Speicherung abgesehen nur mit Ihrer Einwilligung oder zur Geltendmachung, Ausübung oder Verteidigung von Rechtsansprüchen oder zum Schutz der Rechte einer anderen natürlichen oder juristischen Person oder aus Gründen eines wichtigen öffentlichen Interesses der Europäischen Union oder eines Mitgliedstaats verarbeitet werden.

## 4. Datenerfassung auf dieser Website

### Cookies

Unsere Internetseiten verwenden so genannte „Cookies“. Cookies sind kleine Textdateien und richten auf Ihrem Endgerät keinen Schaden an. Sie werden entweder vorübergehend für die Dauer einer Sitzung (Session-Cookies) oder dauerhaft (permanente Cookies) auf Ihrem Endgerät gespeichert. Session-Cookies werden nach Ende Ihres Besuchs automatisch gelöscht. Permanente Cookies bleiben auf Ihrem Endgerät gespeichert, bis Sie diese selbst löschen oder eine automatische Löschung durch Ihren Webbrowser erfolgt.

Teilweise können auch Cookies von Drittunternehmen auf Ihrem Endgerät gespeichert werden, wenn Sie unsere Seite betreten (Third-Party-Cookies). Diese ermöglichen uns oder Ihnen die Nutzung bestimmter Dienstleistungen des Drittunternehmens (z.B. Cookies zur Abwicklung von Zahlungsdienstleistungen).

Cookies haben verschiedene Funktionen. Zahlreiche Cookies sind technisch notwendig, da bestimmte Websitefunktionen ohne diese nicht funktionieren würden (z.B. die Warenkorbfunktion oder die Anzeige von Videos). Andere Cookies dienen dazu, das Nutzerverhalten auszuwerten oder Werbung anzuzeigen.

Cookies, die zur Durchführung des elektronischen Kommunikationsvorgangs (notwendige Cookies) oder zur Bereitstellung bestimmter, von Ihnen erwünschter Funktionen (funktionale Cookies, z. B. für die Warenkorbfunktion) oder zur Optimierung der Website (z.B. Cookies zur Messung des Webpublikums) erforderlich sind, werden auf Grundlage von Art. 6 Abs. 1 lit. f DSGVO gespeichert, sofern keine andere Rechtsgrundlage angegeben wird. Der Websitebetreiber hat ein berechtigtes Interesse an der Speicherung von Cookies zur technisch fehlerfreien und optimierten Bereitstellung seiner Dienste. Sofern eine Einwilligung zur Speicherung von Cookies abgefragt wurde, erfolgt die Speicherung der betreffenden Cookies ausschließlich auf Grundlage dieser Einwilligung (Art. 6 Abs. 1 lit. a DSGVO); die Einwilligung ist jederzeit widerrufbar.

Sie können Ihren Browser so einstellen, dass Sie über das Setzen von Cookies informiert werden und Cookies nur im Einzelfall erlauben, die Annahme von Cookies für bestimmte Fälle oder generell ausschließen sowie das automatische Löschen der Cookies beim Schließen des Browsers aktivieren. Bei der Deaktivierung von Cookies kann die Funktionalität dieser Website eingeschränkt sein.

Soweit Cookies von Drittunternehmen oder zu Analysezwecken eingesetzt werden, werden wir Sie hierüber im Rahmen dieser Datenschutzerklärung gesondert informieren und ggf. eine Einwilligung abfragen.

### Server-Log-Dateien

Der Provider der Seiten erhebt und speichert automatisch Informationen in so genannten Server-Log-Dateien, die Ihr Browser automatisch an uns übermittelt. Dies sind:

* Browsertyp und Browserversion
* verwendetes Betriebssystem
* Referrer URL
* Hostname des zugreifenden Rechners
* Uhrzeit der Serveranfrage
* IP-Adresse

Eine Zusammenführung dieser Daten mit anderen Datenquellen wird nicht vorgenommen.

Die Erfassung dieser Daten erfolgt auf Grundlage von Art. 6 Abs. 1 lit. f DSGVO. Der Websitebetreiber hat ein berechtigtes Interesse an der technisch fehlerfreien Darstellung und der Optimierung seiner Website. Hierzu müssen die Server-Log-Files erfasst werden.

### Kontaktformular

Wenn Sie uns per Kontaktformular Anfragen zukommen lassen, werden Ihre Angaben aus dem Anfrageformular inklusive der von Ihnen dort angegebenen Kontaktdaten zwecks Bearbeitung der Anfrage und für den Fall von Anschlussfragen bei uns gespeichert. Diese Daten geben wir nicht ohne Ihre Einwilligung weiter.

Die Verarbeitung dieser Daten erfolgt auf Grundlage von Art. 6 Abs. 1 lit. b DSGVO, sofern Ihre Anfrage mit der Erfüllung eines Vertrags zusammenhängt oder zur Durchführung vorvertraglicher Maßnahmen erforderlich ist. In allen übrigen Fällen beruht die Verarbeitung auf unserem berechtigten Interesse an der effektiven Bearbeitung der an uns gerichteten Anfragen (Art. 6 Abs. 1 lit. f DSGVO) oder auf Ihrer Einwilligung (Art. 6 Abs. 1 lit. a DSGVO) sofern diese abgefragt wurde.

Die von Ihnen im Kontaktformular eingegebenen Daten verbleiben bei uns, bis Sie uns zur Löschung auffordern, Ihre Einwilligung zur Speicherung widerrufen oder der Zweck für die Datenspeicherung entfällt (z. B. nach abgeschlossener Bearbeitung Ihrer Anfrage). Zwingende gesetzliche Bestimmungen insbesondere Aufbewahrungsfristen bleiben unberührt.

### Anfrage per E-Mail, Telefon oder Telefax

Wenn Sie uns per E-Mail, Telefon oder Telefax kontaktieren, wird Ihre Anfrage inklusive aller daraus hervorgehenden personenbezogenen Daten (Name, Anfrage) zum Zwecke der Bearbeitung Ihres Anliegens bei uns gespeichert und verarbeitet. Diese Daten geben wir nicht ohne Ihre Einwilligung weiter.

Die Verarbeitung dieser Daten erfolgt auf Grundlage von Art. 6 Abs. 1 lit. b DSGVO, sofern Ihre Anfrage mit der Erfüllung eines Vertrags zusammenhängt oder zur Durchführung vorvertraglicher Maßnahmen erforderlich ist. In allen übrigen Fällen beruht die Verarbeitung auf unserem berechtigten Interesse an der effektiven Bearbeitung der an uns gerichteten Anfragen (Art. 6 Abs. 1 lit. f DSGVO) oder auf Ihrer Einwilligung (Art. 6 Abs. 1 lit. a DSGVO) sofern diese abgefragt wurde.

Die von Ihnen an uns per Kontaktanfragen übersandten Daten verbleiben bei uns, bis Sie uns zur Löschung auffordern, Ihre Einwilligung zur Speicherung widerrufen oder der Zweck für die Datenspeicherung entfällt (z. B. nach abgeschlossener Bearbeitung Ihres Anliegens). Zwingende gesetzliche Bestimmungen insbesondere gesetzliche Aufbewahrungsfristen bleiben unberührt.

### Weglot

Wir nutzen den Service Weglot. Anbieter ist Weglot 138 rue Pierre Joigneaux, 92270 Bois-Colombes, Frankreich (im Folgenden „Weglot”).

Weglot wird beim Aufruf der Website geladen, sodass unsere Seite in verschiedenen Sprachen angezeigt werden kann. Dadurch kann beim Besuch dieser Website eine direkte Verbindung zwischen Ihrem Browser und dem Weglot-Server hergestellt werden. Weglot erhält dadurch die Information, dass Sie mit Ihrer IP-Adresse diese Website besucht haben.

Die Speicherung und Analyse der Daten erfolgt auf Grundlage von Art. 6 Abs. 1 lit. f DSGVO. Der Anbieter der Website hat ein berechtigtes Interesse an der Darstellung eines wesentlichen Umfangs seiner Website in gängigen Sprachen für nicht deutschsprachige Besucher. Weitere Informationen hierzu finden Sie in der Datenschutzerklärung von Weglot: [https://weglot.com/privacy/](https://weglot.com/privacy/).

### Pipedrive

Wir nutzen Pipedrive CRM auf dieser Website. Anbieter ist Pipedrive OÜ, Mustamäe tee 3a, 10615 Tallinn, Estland (nachfolgend Pipedrive).

Pipedrive ermöglicht es uns unter anderem, bestehende und potenzielle Kunden von anny sowie Kundenkontakte zu verwalten. Mit Hilfe von Pipedrive sind wir in der Lage, Kundeninteraktionen per E-Mail, Social Media oder Telefon über verschiedene Kanäle hinweg zu erfassen, zu sortieren und zu analysieren. Die so erfassten personenbezogenen Daten können ausgewertet und für die Kommunikation mit dem (potenziellen) Kunden verwendet werden.

Von der Datenverarbeitung sind nur Kunden betroffen, welche im direkten Zusammenhang zu anny stehen, somit explizit nicht Personenkreise, welche über anny Services oder Dienstleistungen bei anderen Betreibern buchen und anny nur als Auftragsverarbeiter agiert.

Details entnehmen Sie der Datenschutzerklärung von Hubspot: [https://www.pipedrive.com/en/privacy](https://www.pipedrive.com/en/privacy).

### Typeform

Wir haben Typeform auf dieser Website eingebunden. Anbieter ist die TYPEFORM S.L., Carrer Bac de Roda, 163, 08018 Barcelona, Spanien (nachfolgend Typeform).

Typeform ermöglicht es uns, Online-Formulare zu erstellen und sie auf unserer Website einzubinden. Die von Ihnen in unsere Typeform-Formulare eingegebenen Daten werden auf den Servern von Typeform gespeichert, bis Sie uns zur Löschung auffordern, eine abgegebene Einwilligung zur Speicherung widerrufen oder der Zweck für die Datenspeicherung entfällt (z. B. nach abgeschlossener Bearbeitung Ihrer Anfrage). Zwingende gesetzliche Bestimmungen insbesondere Aufbewahrungsfristen bleiben unberührt.

Die Verwendung von Typeform erfolgt auf Grundlage von Art. 6 Abs. 1 lit. f DSGVO. Der Websitebetreiber hat ein berechtigtes Interesse an funktionierenden Online-Formularen. Sofern eine entsprechende Einwilligung abgefragt wurde, erfolgt die Verarbeitung ausschließlich auf Grundlage von Art. 6 Abs. 1 lit. a DSGVO und § 25 Abs. 1 TTDSG, soweit die Einwilligung die Speicherung von Cookies oder den Zugriff auf Informationen im Endgerät des Nutzers (z. B. Device-Fingerprinting) im Sinne des TTDSG umfasst. Die Einwilligung ist jederzeit widerrufbar.

### Registrierung auf dieser Website

Sie können sich auf dieser Website registrieren, um zusätzliche Funktionen auf der Seite zu nutzen. Die dazu eingegebenen Daten verwenden wir nur zum Zwecke der Nutzung des jeweiligen Angebotes oder Dienstes, für den Sie sich registriert haben. Die bei der Registrierung abgefragten Pflichtangaben müssen vollständig angegeben werden. Anderenfalls werden wir die Registrierung ablehnen.

Für wichtige Änderungen etwa beim Angebotsumfang oder bei technisch notwendigen Änderungen nutzen wir die bei der Registrierung angegebene E-Mail-Adresse, um Sie auf diesem Wege zu informieren.

Die Verarbeitung der bei der Registrierung eingegebenen Daten erfolgt zum Zwecke der Durchführung des durch die Registrierung begründeten Nutzungsverhältnisses und ggf. zur Anbahnung weiterer Verträge (Art. 6 Abs. 1 lit. b DSGVO).

Die bei der Registrierung erfassten Daten werden von uns gespeichert, solange Sie auf dieser Website registriert sind und werden anschließend gelöscht. Gesetzliche Aufbewahrungsfristen bleiben unberührt.

## 5. Analyse-Tools und Werbung

### Google Tag Manager

Wir setzen den Google Tag Manager ein. Anbieter ist die Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland. Dieser Dienst wird nicht auf der Buchungsseite sowie dem Adminbereich von anny eingesetzt.

Der Google Tag Manager ist ein Tool, mit dessen Hilfe wir Tracking- oder Statistik-Tools und andere Technologien auf unserer Website einbinden können. Der Google Tag Manager selbst erstellt keine Nutzerprofile, speichert keine Cookies und nimmt keine eigenständigen Analysen vor. Er dient lediglich der Verwaltung und Ausspielung der über ihn eingebundenen Tools. Der Google Tag Manager erfasst jedoch Ihre IP-Adresse, die auch an das Mutterunternehmen von Google in die Vereinigten Staaten übertragen werden kann.

Der Einsatz des Google Tag Managers erfolgt auf Grundlage von Art. 6 Abs. 1 lit. f DSGVO. Der Websitebetreiber hat ein berechtigtes Interesse an einer schnellen und unkomplizierten Einbindung und Verwaltung verschiedener Tools auf seiner Website. Sofern eine entsprechende Einwilligung abgefragt wurde, erfolgt die Verarbeitung ausschließlich auf Grundlage von Art. 6 Abs. 1 lit. a DSGVO und § 25 Abs. 1 TTDSG, soweit die Einwilligung die Speicherung von Cookies oder den Zugriff auf Informationen im Endgerät des Nutzers (z. B. Device-Fingerprinting) im Sinne des TTDSG umfasst. Die Einwilligung ist jederzeit widerrufbar.

### Google Analytics

Diese Website nutzt Funktionen des Webanalysedienstes Google Analytics. Anbieter ist die Google Ireland Limited („Google“), Gordon House, Barrow Street, Dublin 4, Irland. Dieser Dienst wird nicht auf der Buchungsseite sowie dem Adminbereich von anny eingesetzt.

Google Analytics ermöglicht es dem Websitebetreiber, das Verhalten der Websitebesucher zu analysieren. Hierbei erhält der Websitebetreiber verschiedene Nutzungsdaten, wie z. B. Seitenaufrufe, Verweildauer, verwendete Betriebssysteme und Herkunft des Nutzers. Diese Daten werden in einer User-ID zusammengefasst und dem jeweiligen Endgerät des Websitebesuchers zugeordnet.

Des Weiteren können wir mit Google Analytics u. a. Ihre Maus- und Scrollbewegungen und Klicks aufzeichnen. Ferner verwendet Google Analytics verschiedene Modellierungsansätze, um die erfassten Datensätze zu ergänzen und setzt Machine-Learning-Technologien bei der Datenanalyse ein.

Google Analytics verwendet Technologien, die die Wiedererkennung des Nutzers zum Zwecke der Analyse des Nutzerverhaltens ermöglichen (z. B. Cookies oder Device-Fingerprinting). Die von Google erfassten Informationen über die Benutzung dieser Website werden in der Regel an einen Server von Google in den USA übertragen und dort gespeichert.

Die Nutzung dieses Dienstes erfolgt auf Grundlage Ihrer Einwilligung nach Art. 6 Abs. 1 lit. a DSGVO und § 25 Abs. 1 TTDSG. Die Einwilligung ist jederzeit widerrufbar.

Die Datenübertragung in die USA wird auf die Standardvertragsklauseln der EU-Kommission gestützt. Details finden Sie hier: [https://privacy.google.com/businesses/controllerterms/mccs/](https://privacy.google.com/businesses/controllerterms/mccs/).

#### IP Anonymisierung

Wir haben auf dieser Website die Funktion IP-Anonymisierung aktiviert. Dadurch wird Ihre IP-Adresse von Google innerhalb von Mitgliedstaaten der Europäischen Union oder in anderen Vertragsstaaten des Abkommens über den Europäischen Wirtschaftsraum vor der Übermittlung in die USA gekürzt. Nur in Ausnahmefällen wird die volle IP-Adresse an einen Server von Google in den USA übertragen und dort gekürzt. Im Auftrag des Betreibers dieser Website wird Google diese Informationen benutzen, um Ihre Nutzung der Website auszuwerten, um Reports über die Websiteaktivitäten zusammenzustellen und um weitere mit der Websitenutzung und der Internetnutzung verbundene Dienstleistungen gegenüber dem Websitebetreiber zu erbringen. Die im Rahmen von Google Analytics von Ihrem Browser übermittelte IP-Adresse wird nicht mit anderen Daten von Google zusammengeführt.

#### Browser Plugin

Sie können die Erfassung und Verarbeitung Ihrer Daten durch Google verhindern, indem Sie das unter dem folgenden Link verfügbare Browser-Plugin herunterladen und installieren: [https://tools.google.com/dlpage/gaoptout?hl=de](https://tools.google.com/dlpage/gaoptout?hl=de).

Mehr Informationen zum Umgang mit Nutzerdaten bei Google Analytics finden Sie in der Datenschutzerklärung von Google: [https://support.google.com/analytics/answer/6004245?hl=de](https://support.google.com/analytics/answer/6004245?hl=de).

#### Google-Signale

Wir nutzen Google-Signale. Wenn Sie unsere Website besuchen, erfasst Google Analytics u. a. Ihren Standort, Suchverlauf und YouTube-Verlauf sowie demografische Daten (Besucherdaten). Diese Daten können mit Hilfe von Google-Signal für personalisierte Werbung verwendet werden. Wenn Sie über ein Google-Konto verfügen, werden die Besucherdaten von Google-Signal mit Ihrem Google-Konto verknüpft und für personalisierte Werbebotschaften verwendet. Die Daten werden außerdem für die Erstellung anonymisierter Statistiken zum Nutzerverhalten unserer User verwendet.

#### Auftragsverarbeitung

Wir haben mit Google einen Vertrag zur Auftragsverarbeitung abgeschlossen und setzen die strengen Vorgaben der deutschen Datenschutzbehörden bei der Nutzung von Google Analytics vollständig um.

#### Speicherdauer

Bei Google gespeicherte Daten auf Nutzer- und Ereignisebene, die mit Cookies, Nutzerkennungen (z. B. User ID) oder Werbe-IDs (z. B. DoubleClick-Cookies, Android-Werbe-ID) verknüpft sind, werden nach 26 Monaten anonymisiert bzw. gelöscht. Details hierzu ersehen Sie unter folgendem Link: [https://support.google.com/analytics/answer/7667196?hl=de](https://support.google.com/analytics/answer/7667196?hl=de)

Der Websitebetreiber verwendet Google Ads. Google Ads ist ein Online-Werbeprogramm der Google Ireland Limited („Google“), Gordon House, Barrow Street, Dublin 4, Irland.

Google Ads ermöglicht es uns Werbeanzeigen in der Google-Suchmaschine oder auf Drittwebseiten auszuspielen, wenn der Nutzer bestimmte Suchbegriffe bei Google eingibt (Keyword-Targeting). Ferner können zielgerichtete Werbeanzeigen anhand der bei Google vorhandenen Nutzerdaten (z. B. Standortdaten und Interessen) ausgespielt werden (Zielgruppen-Targeting). Wir als Websitebetreiber können diese Daten quantitativ auswerten, indem wir beispielsweise analysieren, welche Suchbegriffe zur Ausspielung unserer Werbeanzeigen geführt haben und wie viele Anzeigen zu entsprechenden Klicks geführt haben.

Die Nutzung dieses Dienstes erfolgt auf Grundlage Ihrer Einwilligung nach Art. 6 Abs. 1 lit. a DSGVO und § 25 Abs. 1 TTDSG. Die Einwilligung ist jederzeit widerrufbar.

Die Datenübertragung in die USA wird auf die Standardvertragsklauseln der EU-Kommission gestützt. Details finden Sie hier: [https://policies.google.com/privacy/frameworks](https://policies.google.com/privacy/frameworks) und [https://privacy.google.com/businesses/controllerterms/mccs/](https://privacy.google.com/businesses/controllerterms/mccs/).

### Meta Pixel

Diese Website nutzt zur Konversionsmessung der Besucheraktions-Pixel von Facebook/Meta. Anbieter dieses Dienstes ist die Meta Platforms Ireland Limited, 4 Grand Canal Square, Dublin 2, Irland. Die erfassten Daten werden nach Aussage von Facebook jedoch auch in die USA und in andere Drittländer übertragen. Dieser Dienst wird nicht auf der Buchungsseite sowie dem Adminbereich von anny eingesetzt.

So kann das Verhalten der Seitenbesucher nachverfolgt werden, nachdem diese durch Klick auf eine Facebook-Werbeanzeige auf die Website des Anbieters weitergeleitet wurden. Dadurch können die Wirksamkeit der Facebook-Werbeanzeigen für statistische und Marktforschungszwecke ausgewertet werden und zukünftige Werbemaßnahmen optimiert werden.

Die erhobenen Daten sind für uns als Betreiber dieser Website anonym, wir können keine Rückschlüsse auf die Identität der Nutzer ziehen. Die Daten werden aber von Facebook gespeichert und verarbeitet, sodass eine Verbindung zum jeweiligen Nutzerprofil möglich ist und Facebook die Daten für eigene Werbezwecke, entsprechend der Facebook-Datenverwendungsrichtlinie verwenden kann. Dadurch kann Facebook das Schalten von Werbeanzeigen auf Seiten von Facebook sowie außerhalb von Facebook ermöglichen. Diese Verwendung der Daten kann von uns als Seitenbetreiber nicht beeinflusst werden.

Die Nutzung dieses Dienstes erfolgt auf Grundlage Ihrer Einwilligung nach Art. 6 Abs. 1 lit. a DSGVO und § 25 Abs. 1 TTDSG. Die Einwilligung ist jederzeit widerrufbar.

Die Datenübertragung in die USA wird auf die Standardvertragsklauseln der EU-Kommission gestützt. Details finden Sie hier: [https://www.facebook.com/legal/EU\_data\_transfer\_addendum](https://www.facebook.com/legal/EU_data_transfer_addendum) und [https://de-de.facebook.com/help/566994660333381](https://de-de.facebook.com/help/566994660333381).

Soweit mit Hilfe des hier beschriebenen Tools personenbezogene Daten auf unserer Website erfasst und an Facebook weitergeleitet werden, sind wir und die Meta Platforms Ireland Limited, 4 Grand Canal Square, Grand Canal Harbour, Dublin 2, Irland gemeinsam für diese Datenverarbeitung verantwortlich (Art. 26 DSGVO). Die gemeinsame Verantwortlichkeit beschränkt sich dabei ausschließlich auf die Erfassung der Daten und deren Weitergabe an Facebook. Die nach der Weiterleitung erfolgende Verarbeitung durch Facebook ist nicht Teil der gemeinsamen Verantwortung. Die uns gemeinsam obliegenden Verpflichtungen wurden in einer Vereinbarung über gemeinsame Verarbeitung festgehalten. Den Wortlaut der Vereinbarung finden Sie unter: [https://www.facebook.com/legal/controller\_addendum](https://www.facebook.com/legal/controller_addendum). Laut dieser Vereinbarung sind wir für die Erteilung der Datenschutzinformationen beim Einsatz des Facebook-Tools und für die datenschutzrechtlich sichere Implementierung des Tools auf unserer Website verantwortlich. Für die Datensicherheit der Facebook-Produkte ist Facebook verantwortlich. Betroffenenrechte (z. B. Auskunftsersuchen) hinsichtlich der bei Facebook verarbeiteten Daten können Sie direkt bei Facebook geltend machen. Wenn Sie die Betroffenenrechte bei uns geltend machen, sind wir verpflichtet, diese an Facebook weiterzuleiten.

In den Datenschutzhinweisen von Facebook finden Sie weitere Hinweise zum Schutz Ihrer Privatsphäre: [https://de-de.facebook.com/about/privacy/](https://de-de.facebook.com/about/privacy/).

Sie können außerdem die Remarketing-Funktion „Custom Audiences“ im Bereich Einstellungen für Werbeanzeigen unter [https://www.facebook.com/ads/preferences/?entry\_product=ad\_settings\_screen](https://www.facebook.com/ads/preferences/?entry_product=ad_settings_screen) deaktivieren. Dazu müssen Sie bei Facebook angemeldet sein.

Wenn Sie kein Facebook Konto besitzen, können Sie nutzungsbasierte Werbung von Facebook auf der Website der European Interactive Digital Advertising Alliance deaktivieren: [http://www.youronlinechoices.com/de/praferenzmanagement/](http://www.youronlinechoices.com/de/praferenzmanagement/).

### TikTok Pixel

Wir haben das TikTok Pixel auf dieser Website eingebunden. Anbieter ist die TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Irland (nachfolgend TikTok). Dieser Dienst wird nicht auf der Buchungsseite sowie dem Adminbereich von anny eingesetzt.

Mit Hilfe von TikTok Pixel können wir Websitebesuchern, die sich unsere Angebote angesehen haben, interessengerechte Werbung bei TikTok anzeigen (TikTok Ads). Gleichzeitig können wir mit Hilfe des TikTok Pixels feststellen, wie effektiv unsere Werbung bei TikTok ist. Dadurch kann die Wirksamkeit der TikTok-Werbeanzeigen für statistische und Marktforschungszwecke ausgewertet und für zukünftige Werbemaßnahmen optimiert werden. Hierbei werden verschiedene Nutzungsdaten verarbeitet, wie z. B. IP-Adresse, Seitenaufrufe, Verweildauer, verwendete Betriebssysteme und Herkunft des Nutzers, Informationen über die Anzeige, auf die eine Person auf TikTok geklickt hat oder ein Ereignis, das ausgelöst wurde (Zeitstempel). Diese Daten werden in einer User-ID zusammengefasst und dem jeweiligen Endgerät des Websitebesuchers zugeordnet.

Die Nutzung dieses Dienstes erfolgt auf Grundlage Ihrer Einwilligung nach Art. 6 Abs. 1 lit. a DSGVO und § 25 Abs. 1 TTDSG. Die Einwilligung ist jederzeit widerrufbar.

Die Datenübertragung in Drittstaaten wird auf die Standardvertragsklauseln der EU-Kommission gestützt. Details finden Sie hier: [https://www.tiktok.com/legal/page/eea/privacy-policy/de-DE](https://www.tiktok.com/legal/page/eea/privacy-policy/de-DE) und [https://ads.tiktok.com/i18n/official/policy/controller-to-controller](https://ads.tiktok.com/i18n/official/policy/controller-to-controller).

#### Auftragsverarbeitung

Wir haben einen Vertrag über Auftragsverarbeitung (AVV) zur Nutzung des oben genannten Dienstes geschlossen. Hierbei handelt es sich um einen datenschutzrechtlich vorgeschriebenen Vertrag, der gewährleistet, dass dieser die personenbezogenen Daten unserer Websitebesucher nur nach unseren Weisungen und unter Einhaltung der DSGVO verarbeitet.

### LinkedIn Insight Tag

Diese Website nutzt das Insight-Tag von LinkedIn. Anbieter dieses Dienstes ist die LinkedIn Ireland Unlimited Company, Wilton Plaza, Wilton Place, Dublin 2, Irland. Dieser Dienst wird nicht auf der Buchungsseite sowie dem Adminbereich von anny eingesetzt.

Mit Hilfe des LinkedIn Insight Tags erhalten wir Informationen über die Besucher unserer Website. Ist ein Websitebesucher bei LinkedIn registriert, können wir u. a. die beruflichen Eckdaten (z. B. Karrierestufe, Unternehmensgröße, Land, Standort, Branche und Berufsbezeichnung) unserer Websitebesucher analysieren und so unsere Seite besser auf die jeweiligen Zielgruppen ausrichten. Ferner können wir mit Hilfe von LinkedIn Insight Tags messen, ob die Besucher unserer Webseiten einen Kauf oder eine sonstige Aktion tätigen (Conversion-Messung). Die Conversion-Messung kann auch geräteübergreifend erfolgen (z. B. von PC zu Tablet). LinkedIn Insight Tag bietet außerdem eine Retargeting-Funktion an, mit deren Hilfe wir den Besuchern unserer Website zielgerichtete Werbung außerhalb der Website anzeigen lassen können, wobei laut LinkedIn keine Identifikation des Werbeadressaten stattfindet.

LinkedIn selbst erfasst außerdem sogenannte Logfiles (URL, Referrer-URL, IP-Adresse, Geräte- und Browsereigenschaften und Zeitpunkt des Zugriffs). Die IP-Adressen werden gekürzt oder sofern sie genutzt werden, um LinkedIn-Mitglieder geräteübergreifend zu erreichen gehasht (pseudonymisiert). Die direkten Kennungen der LinkedIn-Mitglieder werden nach sieben Tagen von LinkedIn gelöscht. Die verbleibenden pseudonymisierten Daten werden dann innerhalb von 180 Tagen gelöscht.

Die von LinkedIn erhobenen Daten können von uns als Websitebetreiber nicht bestimmten Einzelpersonen zugeordnet werden. LinkedIn wird die erfassten personenbezogenen Daten der Websitebesucher auf seinen Servern in den USA speichern und sie im Rahmen eigener Werbemaßnahmen nutzen. Details entnehmen Sie der Datenschutzerklärung von LinkedIn unter [https://www.linkedin.com/legal/privacy-policy#choices-oblig](https://www.linkedin.com/legal/privacy-policy#choices-oblig).

Soweit eine Einwilligung (Consent) eingeholt wurde, erfolgt der Einsatz des o. g. Dienstes ausschließlich auf Grundlage von Art. 6 Abs. 1 lit. a DSGVO und § 25 TTDSG. Die Einwilligung ist jederzeit widerrufbar. Soweit keine Einwilligung eingeholt wurde, erfolgt die Verwendung dieses Dienstes auf Grundlage von Art. 6 Abs. 1 lit. f DSGVO. Der Websitebetreiber hat ein berechtigtes Interesse an effektiven Werbemaßnahmen unter Einschluss der sozialen Medien.

Die Datenübertragung in die USA wird auf die Standardvertragsklauseln der EU-Kommission gestützt. Details finden Sie hier: [https://www.linkedin.com/legal/l/dpa](https://www.linkedin.com/legal/l/dpa) und [https://www.linkedin.com/legal/l/eu-sccs](https://www.linkedin.com/legal/l/eu-sccs).

Der Analyse des Nutzungsverhaltens sowie zielgerichtete Werbung durch LinkedIn unter folgendem Link widersprechen: [https://www.linkedin.com/psettings/guest-controls/retargeting-opt-out](https://www.linkedin.com/psettings/guest-controls/retargeting-opt-out).

Des Weiteren können Mitglieder von LinkedIn die Nutzung ihrer personenbezogenen Daten zu Werbezwecken in den Kontoeinstellungen steuern. Um einer Verknüpfung von auf unserer Website erhobenen Daten durch LinkedIn und Ihrem LinkedIn Account zu vermeiden, müssen Sie sich aus Ihrem LinkedIn-Account ausloggen bevor Sie unsere Website aufsuchen.

Wir haben einen Vertrag über Auftragsverarbeitung (AVV) mit dem oben genannten Anbieter geschlossen. Hierbei handelt es sich um einen datenschutzrechtlich vorgeschriebenen Vertrag, der gewährleistet, dass dieser die personenbezogenen Daten unserer Websitebesucher nur nach unseren Weisungen und unter Einhaltung der DSGVO verarbeitet.

### PostHog

Diese Website verwendet Funktionen des Dienstes PostHog, um das Nutzerverhalten und die Nutzerfreundlichkeit unserer Seite zu analysieren und zu optimieren. Diese Funktionen werden angeboten durch PostHog Inc, 965 Mission Street, San Francisco, CA 94103 USA. PostHog kann Ihr Verhalten auf unserer Webseite aufzeichnen und wiedergeben.

Die Speicherung dieser Daten ist zeitlich begrenzt und wird ausschließlich zur Verbesserung unseres Dienstes anhand Ihrer Bedürfnisse verwendet. Dabei werden die Daten in Deutschland gespeichert und persönliche Informationen, wie z.B. die IP-Adresse, nicht übertragen. Weitere Informationen hierzu finden Sie in der Datenschutzerklärung von PostHog: [https://posthog.com/privacy](https://posthog.com/privacy).

#### Auftragsverarbeitung

Wir haben einen Vertrag über Auftragsverarbeitung (AVV) zur Nutzung des oben genannten Dienstes geschlossen. Hierbei handelt es sich um einen datenschutzrechtlich vorgeschriebenen Vertrag, der gewährleistet, dass dieser die personenbezogenen Daten unserer Websitebesucher nur nach unseren Weisungen und unter Einhaltung der DSGVO verarbeitet.

## 6. Newsletter

### Newsletterdaten

Wenn Sie den auf der Website angebotenen Newsletter beziehen möchten, benötigen wir von Ihnen eine E-Mail-Adresse sowie Informationen, welche uns die Überprüfung gestatten, dass Sie der Inhaber der angegebenen E-Mail-Adresse sind und mit dem Empfang des Newsletters einverstanden sind. Weitere Daten werden nicht bzw. nur auf freiwilliger Basis erhoben. Diese Daten verwenden wir ausschließlich für den Versand der angeforderten Informationen und geben diese nicht an Dritte weiter.

Die Verarbeitung der in das Newsletteranmeldeformular eingegebenen Daten erfolgt ausschließlich auf Grundlage Ihrer Einwilligung (Art. 6 Abs. 1 lit. a DSGVO). Die erteilte Einwilligung zur Speicherung der Daten, der E-Mail-Adresse sowie deren Nutzung zum Versand des Newsletters können Sie jederzeit widerrufen, etwa über den „Austragen“-Link im Newsletter. Die Rechtmäßigkeit der bereits erfolgten Datenverarbeitungsvorgänge bleibt vom Widerruf unberührt.

Die von Ihnen zum Zwecke des Newsletter-Bezugs bei uns hinterlegten Daten werden von uns bis zu Ihrer Austragung aus dem Newsletter bei uns bzw. dem Newsletterdiensteanbieter gespeichert und nach der Abbestellung des Newsletters oder nach Zweckfortfall aus der Newsletterverteilerliste gelöscht. Wir behalten uns vor, E-Mail-Adressen aus unserem Newsletterverteiler nach eigenem Ermessen im Rahmen unseres berechtigten Interesses nach Art. 6 Abs. 1 lit. f DSGVO zu löschen oder zu sperren.

Nach Ihrer Austragung aus der Newsletterverteilerliste wird Ihre E-Mail-Adresse bei uns bzw. dem Newsletterdiensteanbieter ggf. in einer Blacklist gespeichert, um künftige Mailings zu verhindern. Die Daten aus der Blacklist werden nur für diesen Zweck verwendet und nicht mit anderen Daten zusammengeführt. Dies dient sowohl Ihrem Interesse als auch unserem Interesse an der Einhaltung der gesetzlichen Vorgaben beim Versand von Newslettern (berechtigtes Interesse im Sinne des Art. 6 Abs. 1 lit. f DSGVO). Die Speicherung in der Blacklist ist zeitlich nicht befristet. Sie können der Speicherung widersprechen, sofern Ihre Interessen unser berechtigtes Interesse überwiegen.

## 7. Plugins und Tools

### Mapbox

Wir nutzen im Administrationsbereich den Kartendienst von Mapbox. Anbieter ist Mapbox, Inc, 740 15th St Nw Suite 500 Washington, DC 20005 United States.

Wenn Sie eine Website besuchen, auf der Mapbox eingebunden ist, werden u. a. Ihre IP-Adresse und weitere Informationen gespeichert. Diese Informationen werden in der Regel an einen Server von Apple in den USA übertragen und dort gespeichert. Der Anbieter dieser Seite hat keinen Einfluss auf diese Datenübertragung.

Die Nutzung von Mapbox erfolgt im Interesse einer ansprechenden Darstellung unserer Online-Angebote und einer leichten Auffindbarkeit der von uns auf der Website angegebenen Orte. Dies stellt ein berechtigtes Interesse im Sinne von Art. 6 Abs. 1 lit. f DSGVO dar. Sofern eine entsprechende Einwilligung abgefragt wurde z. B. eine Einwilligung zur Speicherung von Cookies erfolgt die Verarbeitung ausschließlich auf Grundlage von Art. 6 Abs. 1 lit. a DSGVO. Die Einwilligung ist jederzeit widerrufbar.

Mehr Informationen zum Umgang mit Nutzerdaten finden Sie in der Datenschutzerklärung von Mapbox: [https://www.mapbox.com/legal/privacy/](https://www.mapbox.com/legal/privacy/).

### MessageBird

Bei einer Buchung existiert für den Buchenden die Möglichkeit, sich per SMS oder WhatsApp-Nachricht benachrichtigen zu lassen. Wir nutzen hierfür MessageBird und geben diesem Dienst die Telefonnummer des Buchenden weiter. MessageBird ist ein von MessageBird B.V. bereitgestellter SMS, Chat und Voice API Service.

Zudem nutzen wir MessageBird als Provider für die anny Supporthotline. Hierbei wird der Anruf direkt durch MessageBird angenommen und ggf. an uns weitergeleitet.

Mehr Informationen zum Umgang mit Daten finden Sie in der Datenschutzerklärung von MessageBird: [https://www.messagebird.com/en/legal/privacy](https://www.messagebird.com/en/legal/privacy).

### Intercom

Wir nutzen für Chat- und Supportanfragen den Dienst Intercom. Anbieter ist Intercom Inc., 55 2nd Street, 4th Floor, San Francisco, CA 94105, United States.

Wir nutzen Interkom, um Ihre Anfragen schnell und effizient bearbeiten zu können. Dies stellt ein berechtigtes Interesse im Sinne des Art. 6 Abs. 1 lit. f DSGVO dar. Ist ein Nutzer:in bei uns registriert, werden bestimmte personenbezogene Daten in regelmäßigen Abständen an Intercom weitergegeben, um Anfragen personalisiert zu beantworten.

Intercom verarbeitet Daten unter anderem auch in der USA. Erfolgt eine Datenweitergage in sogenannte Drittstaaten wie die USA, verwendet Intercom Standardvertragsklauseln. Weitere Informationen hierzu finden Sie in den Dokumenten der Datenverarbeitungsbedingungen: [https://www.intercom.com/de/legal/data-processing-agreement](https://www.intercom.com/de/legal/data-processing-agreement)

Weitere Informationen zum Umgang mit Daten finden Sie in der Datenschutzerklärung von Intercom: [https://www.intercom.com/de/legal/privacy](https://www.intercom.com/de/legal/privacy).

### Google reCAPTCHA

Wir nutzen „Google reCAPTCHA“ im Folgenden „reCAPTCHA“ auf dieser Website. Anbieter ist die Google Ireland Limited „Google“, Gordon House, Barrow Street, Dublin 4, Irland. Dieser Dienst wird nicht auf der Buchungsseite sowie dem Adminbereich von anny eingesetzt.

Mit reCAPTCHA soll überprüft werden, ob die Dateneingabe auf dieser Website z. B. in einem Kontaktformular durch einen Menschen oder durch ein automatisiertes Programm erfolgt. Hierzu analysiert reCAPTCHA das Verhalten des Websitebesuchers anhand verschiedener Merkmale. Diese Analyse beginnt automatisch, sobald der Websitebesucher die Website betritt. Zur Analyse wertet reCAPTCHA verschiedene Informationen aus z. B. IP-Adresse, Verweildauer des Websitebesuchers auf der Website oder vom Nutzer getätigte Mausbewegungen. Die bei der Analyse erfassten Daten werden an Google weitergeleitet.

Die reCAPTCHA-Analysen laufen vollständig im Hintergrund. Websitebesucher werden nicht darauf hingewiesen, dass eine Analyse stattfindet.

Die Speicherung und Analyse der Daten erfolgt auf Grundlage von Art. 6 Abs. 1 lit. f DSGVO. Der Websitebetreiber hat ein berechtigtes Interesse daran, seine Webangebote vor missbräuchlicher automatisierter Ausspähung und vor SPAM zu schützen. Sofern eine entsprechende Einwilligung abgefragt wurde, erfolgt die Verarbeitung ausschließlich auf Grundlage von Art. 6 Abs. 1 lit. a DSGVO und § 25 Abs. 1 TTDSG, soweit die Einwilligung die Speicherung von Cookies oder den Zugriff auf Informationen im Endgerät des Nutzers z. B. Device-Fingerprinting im Sinne des TTDSG umfasst. Die Einwilligung ist jederzeit widerrufbar.

Weitere Informationen zu Google reCAPTCHA entnehmen Sie den Google-Datenschutzbestimmungen und den Google Nutzungsbedingungen unter folgenden Links: [https://policies.google.com/privacy?hl=de](https://policies.google.com/privacy?hl=de) und [https://policies.google.com/terms?hl=de](https://policies.google.com/terms?hl=de).

Das Unternehmen verfügt über eine Zertifizierung nach dem „EU-US Data Privacy Framework“ DPF. Der DPF ist ein Übereinkommen zwischen der Europäischen Union und den USA, der die Einhaltung europäischer Datenschutzstandards bei Datenverarbeitungen in den USA gewährleisten soll. Jedes nach dem DPF zertifizierte Unternehmen verpflichtet sich, diese Datenschutzstandards einzuhalten. Weitere Informationen hierzu erhalten Sie vom Anbieter unter folgendem Link: [https://www.dataprivacyframework.gov/s/participant-search/participant-detail?contact=true\&id=a2zt000000001L5AAI\&status=Active](https://www.dataprivacyframework.gov/s/participant-search/participant-detail?contact=true\&id=a2zt000000001L5AAI\&status=Active)

### ChatGPT

Wir nutzen OpenAI für unsere Kundenkommunikation. Anbieter ist die OpenAI, 3180 18th St, San Francisco, CA 94110, USA, [https://openai.com](https://openai.com). Wir nutzen ChatGPT für folgende Tools:

* Chatbot

Wenn über die Website oder den Adminbereich ein Chat gestartet wird, werden die Eingaben und der Vorname an die Server von OpenAI übertragen und dort verarbeitet, um eine passende Antwort zu generieren.

Wir haben OpenAI so konfiguriert, dass die eingegebenen personenbezogenen Daten nicht zum Trainieren des Algorithmus von OpenAI benutzt werden.

Die Verwendung von OpenAI erfolgt auf Grundlage von Art. 6 Abs. 1 lit. f DSGVO. Der Websitebetreiber hat ein berechtigtes Interesse an einer möglichst effizienten Kundenkommunikation unter Einsatz moderner technischer Lösungen. Sofern eine entsprechende Einwilligung abgefragt wurde, erfolgt die Verarbeitung ausschließlich auf Grundlage von Art. 6 Abs. 1 lit. a DSGVO und § 25 Abs. 1 TTDSG. Die Einwilligung ist jederzeit widerrufbar.

Weitere Informationen erhalten Sie hier: [https://openai.com/policies/privacy-policy](https://openai.com/policies/privacy-policy).

#### Auftragsverarbeitung

Wir haben einen Vertrag über Auftragsverarbeitung (AVV) zur Nutzung des oben genannten Dienstes geschlossen. Hierbei handelt es sich um einen datenschutzrechtlich vorgeschriebenen Vertrag, der gewährleistet, dass dieser die personenbezogenen Daten unserer Websitebesucher nur nach unseren Weisungen und unter Einhaltung der DSGVO verarbeitet.

## 8. eCommerce und Zahlungsanbieter

### Verarbeiten von Daten (Kunden- und Vertragsdaten)

Wir erheben, verarbeiten und nutzen personenbezogene Daten nur, soweit sie für die Begründung, inhaltliche Ausgestaltung oder Änderung des Rechtsverhältnisses erforderlich sind (Bestandsdaten). Dies erfolgt auf Grundlage von Art. 6 Abs. 1 lit. b DSGVO, der die Verarbeitung von Daten zur Erfüllung eines Vertrags oder vorvertraglicher Maßnahmen gestattet. Personenbezogene Daten über die Inanspruchnahme dieser Website (Nutzungsdaten) erheben, verarbeiten und nutzen wir nur, soweit dies erforderlich ist, um dem Nutzer die Inanspruchnahme des Dienstes zu ermöglichen oder abzurechnen.

Die erhobenen Kundendaten werden nach Abschluss des Auftrags oder Beendigung der Geschäftsbeziehung gelöscht. Gesetzliche Aufbewahrungsfristen bleiben unberührt.

### Datenübermittlung bei Vertragsschluss für Dienstleistungen und digitale Inhalte

Wir übermitteln personenbezogene Daten an Dritte nur dann, wenn dies im Rahmen der Vertragsabwicklung notwendig ist, etwa an das mit der Zahlungsabwicklung beauftragte Kreditinstitut.

Eine weitergehende Übermittlung der Daten erfolgt nicht bzw. nur dann, wenn Sie der Übermittlung ausdrücklich zugestimmt haben. Eine Weitergabe Ihrer Daten an Dritte ohne ausdrückliche Einwilligung etwa zu Zwecken der Werbung erfolgt nicht.

Grundlage für die Datenverarbeitung ist Art. 6 Abs. 1 lit. b DSGVO, der die Verarbeitung von Daten zur Erfüllung eines Vertrags oder vorvertraglicher Maßnahmen gestattet.

### Zahlungsdienste

Wir binden Zahlungsdienste von Drittunternehmen auf unserer Website ein. Wenn Sie einen Kauf bei uns tätigen, werden Ihre Zahlungsdaten z. B. Name, Zahlungssumme, Kontoverbindung, Kreditkartennummer vom Zahlungsdienstleister zum Zwecke der Zahlungsabwicklung verarbeitet. Für diese Transaktionen gelten die jeweiligen Vertrags- und Datenschutzbestimmungen der jeweiligen Anbieter. Der Einsatz der Zahlungsdienstleister erfolgt auf Grundlage von Art. 6 Abs. 1 lit. b DSGVO Vertragsabwicklung sowie im Interesse eines möglichst reibungslosen, komfortablen und sicheren Zahlungsvorgangs Art. 6 Abs. 1 lit. f DSGVO. Soweit für bestimmte Handlungen Ihre Einwilligung abgefragt wird, ist Art. 6 Abs. 1 lit. a DSGVO Rechtsgrundlage der Datenverarbeitung. Einwilligungen sind jederzeit für die Zukunft widerrufbar.

Folgende Zahlungsdienste und Zahlungsdienstleister setzen wir im Rahmen dieser Website ein:

#### Stripe

Anbieter für Kunden innerhalb der EU ist die Stripe Payments Europe, Ltd.,1 Grand Canal Street Lower, Grand Canal Dock, Dublin, Irland im Folgenden „Stripe“.

Die Datenübertragung in die USA wird auf die Standardvertragsklauseln der EU-Kommission gestützt. Details finden Sie hier: [https://stripe.com/de/privacy](https://stripe.com/de/privacy) und [https://stripe.com/de/guides/general-data-protection-regulation](https://stripe.com/de/guides/general-data-protection-regulation).

Details hierzu können Sie in der Datenschutzerklärung von Stripe unter folgendem Link nachlesen: [https://stripe.com/de/privacy](https://stripe.com/de/privacy).

#### PayPal

Anbieter dieses Zahlungsdienstes ist PayPal Europe S.à.r.l. et Cie, S.C.A., 22-24 Boulevard Royal, L-2449 Luxembourg im Folgenden „PayPal“.

Die Datenübertragung in die USA wird auf die Standardvertragsklauseln der EU-Kommission gestützt. Details finden Sie hier: [https://www.paypal.com/de/webapps/mpp/ua/pocpsa-full](https://www.paypal.com/de/webapps/mpp/ua/pocpsa-full).

Details entnehmen Sie der Datenschutzerklärung von PayPal: [https://www.paypal.com/de/webapps/mpp/ua/privacy-full](https://www.paypal.com/de/webapps/mpp/ua/privacy-full).


# Purpleview mit anny verbinden
Source: https://docs.anny.co/purpleview

Verbinde Purpleview mit anny und versende automatisch Videoberatungs-Links mit jeder bestätigten Buchung.

[Purpleview](https://www.purpleview.de) ist ein Anbieter für professionelle Videoberatung, mit dem Organisationen wie Verwaltungen und Beratungsstellen Termine per Video durchführen. Mit der Integration erzeugt anny für jede passende bestätigte Buchung automatisch einen persönlichen Videotermin-Link zu deiner Purpleview-Umgebung.

Mit Purpleview kannst du in anny:

* jede bestätigte Buchung automatisch mit einem persönlichen Videotermin-Link ausstatten
* Ressourcen und Dienstleistungen über Regeln gezielt einzelnen Beratungsgruppen und Terminarten zuordnen
* Kund:innen den Link direkt über die Buchungsbestätigung und den Kalendereintrag bereitstellen

Besonders praktisch ist die Integration für Bürgerbüros, Beratungsstellen und Serviceteams, die ihre Termine über anny buchbar machen und direkt per Video durchführen möchten.

<Info>
  Verfügbar in Plänen mit dem Feature für Video-Meeting-Integrationen.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Bürgerservice der Verwaltung | **Videotermine für Anliegen wie KFZ-Zulassung oder BAföG.** Kund:innen buchen online einen Termin und erhalten den Beratungslink automatisch mit der Buchungsbestätigung. |
| Fachbereiche mit eigenen Beratungsgruppen | **Jede Ressource führt in die passende Beratungsgruppe.** Über Gruppen-Hash und Terminart der Regel landet jeder Termin beim richtigen Team in Purpleview. |
| Hybride Terminangebote | **Nur ausgewählte Dienstleistungen erhalten einen Videolink.** Über den Dienstleistungs-Filter der Regeln bleiben Vor-Ort-Termine ohne Link, Online-Termine bekommen ihn automatisch. |

## Wie die Purpleview-Verbindung funktioniert

Die Verbindung basiert auf einem gemeinsamen Geheimschlüssel, dem **Shared Secret**. Du erzeugst ihn in anny und hinterlegst ihn in deiner Purpleview-Umgebung. anny ruft keine Purpleview-Schnittstelle auf und liest keine Daten aus deiner Purpleview-Umgebung. Stattdessen erzeugt anny für jede passende Buchung einen mit dem Shared Secret signierten Link, den Purpleview beim Öffnen prüft.

Der Ablauf:

1. Eine Buchung wird abgeschlossen. Nur bestätigte Buchungen mit zugeordneter Kund:in erhalten einen Link.
2. anny prüft, ob eine Regel zur Ressource und Dienstleistung der Buchung passt. Regeln auf einer übergeordneten Ressource gelten auch für Buchungen ihrer Unterressourcen.
3. Trifft eine Regel zu, erzeugt anny den Videotermin-Link und hängt ihn an die Buchung. Kund:innen sehen ihn als Button **Online Termin beitreten** in den Buchungs-E-Mails und im Kalendereintrag. Du findest ihn in den Buchungsdetails über **Meeting öffnen**.

Im Link stecken der Name der Kund:in, die Terminart, die Startzeit und eine Termin-ID. Diese Daten werden erst an Purpleview übertragen, wenn jemand den Link öffnet.

anny hält den Link automatisch aktuell: Wird eine Buchung verschoben, auf eine andere Ressource verlegt oder ändert sich ihr Status, ersetzt anny den Link durch einen neuen. Bei Stornierung, Ablehnung oder Löschung entfernt anny den Link von der Buchung. Wird eine Buchung erst später bestätigt, entsteht der Link im Moment der Bestätigung. Serienbuchungen erhalten für jeden Termin einen eigenen Link.

Generierst du das Shared Secret neu, passen zuvor erzeugte Links nicht mehr zum neuen Secret. Sobald Purpleview das neue Secret verwendet, funktionieren die alten Links nicht mehr.

## Purpleview verbinden

### Voraussetzungen

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

* Eine eigene Purpleview-Umgebung mit Basis-URL und Mandanten-Hash
* Die Gruppen-Hashes deiner Beratungsgruppen und die Bezeichnungen der Terminarten aus Purpleview
* Die Möglichkeit, das Shared Secret aus anny in deiner Purpleview-Umgebung zu hinterlegen (kläre das mit deinem Purpleview-Kontakt)
* Admin-Rechte in deinem anny Account

### Verbindung einrichten

<Steps>
  <Step title="Grunddaten eintragen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **PurpleView**. Trage die **Basis-URL** deiner Purpleview-Umgebung und den **Mandanten-Hash** ein.
  </Step>

  <Step title="Shared Secret erzeugen">
    Klicke bei **Shared Secret** auf **Secret generieren**. Kopiere das Secret sofort, denn es wird nur ein einziges Mal angezeigt. Hinterlege es anschließend in deiner Purpleview-Umgebung.
  </Step>

  <Step title="Regeln anlegen">
    Klicke im Bereich **Regeln** auf **Hinzufügen**. Wähle die **Ressource**, optional einzelne **Dienstleistungen** (ohne Auswahl gilt die Regel für **Alle Dienstleistungen**) und trage **Gruppen-Hash** und **Terminart** aus Purpleview ein. Speichere mit **Bestätigen**.
  </Step>

  <Step title="Integration aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts.
  </Step>
</Steps>

Sobald die Integration aktiv ist, erhält jede neue bestätigte Buchung mit passender Regel automatisch ihren Videotermin-Link.

<Tip>
  Teste die Einrichtung mit einer Testbuchung: Prüfe, ob der Button **Online Termin beitreten** in der Bestätigungs-E-Mail erscheint und der Link deine Purpleview-Umgebung öffnet.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Basis-URL | Adresse deiner Purpleview-Umgebung. Sie bildet den Anfang aller erzeugten Links. |
| Mandanten-Hash | Kennung deines Mandanten bei Purpleview. Sie ist Teil jedes erzeugten Links. |
| Shared Secret | Geheimschlüssel zur Signierung der Links. Über **Secret generieren** bzw. **Secret regenerieren** erzeugst du ihn neu; er wird nur einmal angezeigt. |
| Ressource | Die Ressource, für die die Regel gilt. Regeln auf einer übergeordneten Ressource gelten auch für deren Unterressourcen. |
| Dienstleistungen | Optionaler Filter: Die Regel greift nur für die gewählten Dienstleistungen. Ohne Auswahl gilt sie für **Alle Dienstleistungen**. |
| Gruppen-Hash | Kennung der Purpleview-Beratungsgruppe, in die der Termin führt. |
| Terminart | Bezeichnung der Terminart, die Purpleview dem Termin zuordnet (z. B. KFZ). |

<Tip>
  Lege pro Ressource möglichst eindeutige Regeln an. Passt mehr als eine Regel auf eine Buchung, verwendet anny die zuerst angelegte passende Regel.
</Tip>

## Einschränkungen

Die Purpleview-Integration unterstützt nicht:

* **Kalender- oder Datensync:** anny legt keine Termine in Purpleview an und liest dort keine Daten aus. Alle Informationen stecken im Link und werden erst beim Öffnen übertragen.
* **Separater Moderations-Link:** anny erzeugt genau einen Link pro Buchung; dein Team und deine Kund:innen nutzen denselben Link.
* **Echter Verbindungstest:** **Verbindung testen** prüft nur, ob Basis-URL, Mandanten-Hash und Shared Secret hinterlegt sind, nicht ob die Werte auf Purpleview-Seite stimmen.
* **Eigene Link-E-Mail:** Der Link wird ausschließlich über die normalen Buchungs-E-Mails und den Kalendereintrag geteilt; eine separate Benachrichtigung gibt es nicht.
* **Namensänderungen:** Ändert sich der Name der Kund:in nachträglich, behält der bestehende Link den alten Namen. Erst eine Termin- oder Statusänderung erzeugt einen neuen Link.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, erzeugt anny keine neuen Videotermin-Links mehr. Bereits erzeugte Links bleiben auf den Buchungen bestehen und werden bei Änderungen oder Stornierungen nicht mehr aktualisiert oder entfernt. Beim Löschen werden Einstellungen, Regeln und das Shared Secret entfernt; bereits erzeugte Links bleiben ebenfalls bestehen. Möchtest du bestehende Links ungültig machen, ändere das hinterlegte Secret in deiner Purpleview-Umgebung.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Wo sehen meine Kund:innen den Videotermin-Link?">
    Als Button **Online Termin beitreten** in den Buchungs-E-Mails und als Link im Kalendereintrag der Buchung. Du selbst findest ihn in den Buchungsdetails im Bereich **Kalender Synchronisationen** über **Meeting öffnen**.
  </Accordion>

  <Accordion title="Was passiert, wenn eine Buchung verschoben wird?">
    anny ersetzt den Link automatisch durch einen neuen mit der aktualisierten Startzeit. Der aktuelle Link steht in der neuesten Buchungs-E-Mail und in den Buchungsdetails; ältere E-Mails enthalten noch den vorherigen Link.
  </Accordion>

  <Accordion title="Bekommen unbestätigte Buchungsanfragen einen Link?">
    Nein. Nur bestätigte Buchungen mit zugeordneter Kund:in erhalten einen Videotermin-Link. Bestätigst du eine Anfrage später, erzeugt anny den Link im Moment der Bestätigung.
  </Accordion>

  <Accordion title="Was passiert, wenn ich das Shared Secret neu generiere?">
    Du musst das neue Secret auch in deiner Purpleview-Umgebung hinterlegen. Bestehende Links wurden mit dem alten Secret signiert und funktionieren nicht mehr, sobald Purpleview das neue Secret verwendet. Erzeuge das Secret deshalb am besten nur, wenn du es wirklich austauschen möchtest.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Buchungen bekommen keinen Videotermin-Link">
    Ursache: Die Integration ist deaktiviert, es passt keine Regel oder die Buchung ist nicht bestätigt bzw. hat keine zugeordnete Kund:in. Prüfe den **Toggle** der Integration und die Regel: Stimmen Ressource und Dienstleistung? Bei Unterressourcen lege die Regel auf die übergeordnete Ressource.
  </Accordion>

  <Accordion title="Der Link zeigt bei Purpleview einen Fehler">
    Ursache: Die Signatur oder die Kennungen passen nicht zusammen, z. B. weil das Shared Secret neu generiert, aber nicht bei Purpleview hinterlegt wurde, oder weil Basis-URL, Mandanten-Hash oder Gruppen-Hash fehlerhaft sind. Vergleiche die Werte mit deiner Purpleview-Umgebung und hinterlege bei Bedarf ein frisch generiertes Secret auf beiden Seiten.
  </Accordion>

  <Accordion title="Kund:innen öffnen einen Link mit alter Uhrzeit">
    Ursache: Der Link stammt aus einer älteren E-Mail von vor der Terminänderung. Der aktuelle Link steht in der neuesten Buchungs-E-Mail und in den Buchungsdetails; teile ihn bei Bedarf erneut.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Purpleview ist eine der Video-Meeting-Integrationen (Kategorie „Online Meeting-Integrationen") neben Zoom, MS Teams und anny Videoanrufen. Anders als Zoom/MS Teams gibt es keine API- oder OAuth-Verbindung und keinen Terminaustausch: anny erzeugt ausschließlich lokal signierte Links (HMAC über Gruppen-Hash, Termin-ID, Kundenname, Terminart und Start-Zeitstempel mit dem Shared Secret).
>
> **UI-Pfade & Wortlaut:** Menüleiste → **Integrationen** → Kachel „PurpleView" (UI-Schreibweise mit großem V; der UI-Beschreibungstext nennt die Purpleview-Plattform „empathy"). Panel „PurpleView-Einstellungen": Felder „Basis-URL", „Mandanten-Hash", Zeile „Shared Secret" mit Button „Secret generieren" bzw. „Secret regenerieren" (Modal-Hinweis: „Kopiere dieses Secret jetzt. Es wird nicht erneut angezeigt."). Panel „Regeln" → Button „Hinzufügen"; Dialog „Regel erstellen"/„Regel bearbeiten" mit Feldern „Ressource", Dienstleistungs-Auswahl (Platzhalter „Alle Dienstleistungen"), „Gruppen-Hash", „Terminart" (Platzhalter „EWID, KFZ, BAFOEG..."), Speichern über „Bestätigen". Tabellen-Spalten: „Ressource", „Dienstleistungen", „Gruppen-Hash", „Terminart". Drei-Punkte-Menü: „Integration aktivieren"/„Integration deaktivieren", „Verbindung testen", „Authentifizierung entfernen" (nur bei deaktivierter Integration sichtbar; löscht das gespeicherte Shared Secret), „Löschen". Buchungsdetails: Panel „Kalender Synchronisationen" → Button „Meeting öffnen". Ressourcen-Detailseite → Integrationen → Panel „Online Meeting-Integrationen" listet Integrationen, deren Regeln die Ressource verwenden.
>
> **Quirks:** (1) Bei mehreren passenden Regeln gewinnt die zuerst angelegte; es gibt keine Sortierfunktion für Regeln. (2) Der Regelabgleich läuft immer über die oberste Ressource der Buchung. (3) Jede relevante Änderung (Ressource, Status, Start, Ende) erzeugt einen komplett neuen Link mit neuer Termin-ID; alte Links aus früheren E-Mails werden dadurch nicht technisch entwertet, weil ihre Signatur gültig bleibt. (4) Im Kalendereintrag (ICS) steht der Link als „Join Meeting"-Zeile in der Beschreibung; der E-Mail-Button heißt „Online Termin beitreten". (5) In den Buchungsdetails erscheint als Quelle des Link-Eintrags „anny", nicht „Purpleview". (6) Die Link-Erzeugung setzt einen nicht leeren Kundennamen voraus. (7) Serienbuchungen: ein eigener Link pro Serientermin, kein Link für den Serienmaster.
>
> **Beziehungen:** Freischaltung über dasselbe Plan-Feature wie alle Video-Meeting-Integrationen (Zoom, MS Teams, anny Video-Calls); die Plan-Zuordnung ist nicht im Artikel dokumentiert. Verwandte Artikel: zoom, ms-teams, anny-video-calls.


# Warteschlangensystem
Source: https://docs.anny.co/queuing-system

Verwalte Laufkundschaft und Terminbuchungen mit Nummernaufruf, Schaltern und Aufrufanzeigen.

Mit dem Warteschlangensystem organisierst du den Vor-Ort-Ablauf für Laufkundschaft und Terminbuchungen. Wartende erhalten ein Ticket mit Nummer und werden per Schnellaufruf an den richtigen Schalter geleitet. Eine Aufrufanzeige zeigt auf einem Bildschirm die aktuell aufgerufene Nummer an.

<Info>
  * Verfügbar ab Business.
  * Aktiviere vorab unter **Account-Einstellungen** → **Features** das **Warteschlangensystem**. Nach der Aktivierung erscheinen in der Menüleiste links die Punkte **Warteschlangen** und **Schnellaufruf**.
</Info>

## Wie funktioniert das Warteschlangensystem?

Das Warteschlangensystem verbindet drei Bausteine: Warteschlangen, Schalter und den Schnellaufruf.

**Warteschlange** = ein eigener Nummernkreislauf. Jede Warteschlange ist mit einer Ressource verbunden und verwaltet deren wartende Tickets. Hast du mehrere Abteilungen (z. B. Einwohnermeldeamt und Standesamt), legst du für jede eine eigene Warteschlange an. Die Warteschlangen arbeiten unabhängig voneinander.

**Schalter** = dein physischer Arbeitsplatz oder Raum. Du benennst Schalter frei (z. B. "Schalter 1", "Büro 5"). Der Schaltername wird auf der Aufrufanzeige angezeigt, damit Wartende wissen, wohin sie gehen müssen.

**Agenten** = Admin-Nutzer:innen mit der Rolle "Agent Warteschlange". Agenten werden einer Warteschlange zugewiesen und mit einem Schalter verbunden. Im Bereich **Schnellaufruf** rufen sie das nächste Ticket auf, pausieren oder stellen Tickets zurück.

Der typische Ablauf:

<Steps>
  <Step title="Ticket entsteht">
    Kund:innen checken sich am Check-in-Terminal ein (QR-Code oder Wartenummer wird gedruckt) oder haben vorab online einen Termin gebucht.
  </Step>

  <Step title="Ticket erscheint im Schnellaufruf">
    Agenten sehen alle wartenden Tickets ihrer Warteschlange unter **Schnellaufruf** → **Wartende Tickets**.
  </Step>

  <Step title="Agent ruft auf">
    Per Klick auf **Aufrufen** wird das nächste Ticket aufgerufen. Die Aufrufanzeige zeigt die Nummer und den zugehörigen Schalter.
  </Step>

  <Step title="Bearbeitung und Abschluss">
    Der Agent bearbeitet das Anliegen und schließt das Ticket ab. Das nächste Ticket kann aufgerufen werden.
  </Step>
</Steps>

<Tip>
  Terminbuchungen, bei denen sich Kund:innen nicht rechtzeitig einchecken, kannst du unter **Schnellaufruf** → **Buchungen** über die **drei Punkte** manuell in ein Ticket umwandeln.
</Tip>

## Wann nutze ich das?

* **Du betreibst ein Bürgerbüro, eine Behörde oder eine Praxis mit Laufkundschaft und Terminbuchungen**: Das Warteschlangensystem kombiniert beide Kanäle in einem Nummernaufruf.
* **Du hast mehrere Abteilungen oder Fachbereiche an einem Standort**: Jede Abteilung erhält eine eigene Warteschlange mit eigenem Nummernkreislauf.
* **Du möchtest Wartezeiten transparent machen**: Die Übersicht im Schnellaufruf zeigt wartende, überfällige und abgeschlossene Tickets inkl. durchschnittlicher Wartezeit.
* **Nicht geeignet für**: Reine Online-Terminbuchung ohne Vor-Ort-Wartebereich. Wenn du nur Termine vergeben willst und keine Laufkundschaft hast, genügt die normale Ressourcen-Konfiguration mit Check-in.

## Zusammenhang mit anderen Features

* **Check-In & Check-Out**: Das Check-in-Verfahren muss auf der Ressource aktiviert sein, damit Kund:innen sich am Terminal einchecken und ein Ticket erhalten können. Stelle Self-Check-in auf "Terminal" (nicht Selbst-Check-in), damit die Wartenummer gedruckt wird.
* **Anzeigetafeln & Raumdisplays**: Aufrufanzeigen sind ein eigener Display-Typ innerhalb des Warteschlangensystems (nicht zu verwechseln mit Standard-Anzeigetafeln). Der Link zur Aufrufanzeige kann auf jedem Smart TV im Browser geöffnet werden.

## Einstellungen & Optionen

Die Konfiguration findest du unter **Warteschlangen** in der Menüleiste links.

| Einstellung (Admin) | Beschreibung |
| - | - |
| Warteschlange erstellen | Name, Ressource zuordnen, alle Services einschließen |
| Schalter | Frei benennbare Arbeitsplätze (Tab **Schalter**) |
| Agenten hinzufügen | Admin-Nutzer:in + Schalter zuweisen (pro Warteschlange) |
| Regeln für die Zuweisung | Automatische Ticket-Verteilung konfigurieren |
| Einstellungen | Allgemeine Warteschlangen-Einstellungen (Tab **Einstellungen**) |
| Check-In Terminals | Terminal für den Vor-Ort-Check-in konfigurieren |
| Anrufanzeigen | Display-Link für die Nummern-Anzeige generieren |

Im Schnellaufruf selbst können Agenten:

| Aktion | Beschreibung |
| - | - |
| Aufrufen | Nächstes Ticket aus der Warteschlange aufrufen |
| Pausieren | Bearbeitung unterbrechen, Ticket bleibt aktiv |
| Zurückstellen | Ticket wieder in die Warteschlange einreihen |
| Bevorzugen | Ticket individuell vorziehen |
| Schalter wechseln | Eigenen Schalternamen im laufenden Betrieb ändern |

<Tip>
  Unter **Schnellaufruf** → **Buchungen** kannst du nach Ressource filtern und Buchungen, bei denen sich Kund:innen nicht eingecheckt haben, manuell in ein Ticket umwandeln (drei Punkte → in Ticket umwandeln).
</Tip>

### Rollenempfehlung

Damit Agenten den Schnellaufruf nutzen können, benötigen sie:

* Einen **Admin-Zugang** in anny (ohne Admin-Zugang ist kein Schalter zuweisbar)
* Die Rolle **Agent Warteschlange**
* Empfohlene Berechtigungen: Buchungen der zugeordneten Ressource bearbeiten, Check-in durchführen und Schnellaufruf nutzen. Alle anderen Bereiche auf "Ansehen" beschränken.

<Warning>
  Ein Agent kann nur dann einem Schalter zugewiesen werden, wenn er einen aktiven Admin-Zugang hat. Ohne Admin-Zugang ist die Zuweisung nicht möglich.
</Warning>

### Badge-Konfiguration

Am Check-in-Terminal wird ein Badge (Ausdruck) generiert. Konfiguriere darauf mindestens:

* Die **Wartenummer** (Ticket-Nummer)
* Den **Warteschlangennamen**

### Technische Voraussetzungen

* **Check-in-Terminal**: Hardware-Terminal für den QR-Code-Scan und Nummernausdruck
* **Drucker**: Für den Badge-Ausdruck (Wartenummer)
* **Smart TV oder Bildschirm**: Für die Aufrufanzeige (beliebiger Bildschirm mit Browser)

<Tip>
  Wenn du Kapazitäten für Laufkundschaft vor Ort freihalten möchtest, lege zwei separate Ressourcen an, die jeweils mehrfach verfügbar sind: eine für Ad-hoc-Buchungen vor Ort und eine für Online-Buchungen. So stellst du sicher, dass nicht alle Slots online vergeben werden.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Bürgerbüro mit Terminbuchung und Laufkundschaft">
    Ein Bürgerbüro bietet online Terminbuchungen für das Einwohnermeldeamt an. Zusätzlich kommen Kund:innen ohne Termin vorbei und sollen über ein Terminal eine Wartenummer ziehen.

    <Steps>
      <Step title="Ressource einrichten">
        Lege unter **Ressourcen** eine Ressource "Einwohnermeldeamt" an und konfiguriere die gewünschten Buchungsoptionen (z. B. Personalausweis abholen, Ummeldung).
      </Step>

      <Step title="Check-in-Verfahren aktivieren">
        Öffne die Ressource → **Verfügbarkeit** → aktiviere **Check-In & Check-Out**. Stelle das Check-in-Verfahren auf "Terminal" und erlaube die anonyme Registrierung, damit auch Laufkundschaft ohne Konto ein Ticket erhält.
      </Step>

      <Step title="Warteschlange erstellen">
        Gehe zu **Warteschlangen** → **Neu +**. Vergib den Namen "Einwohnermeldeamt", wähle die Ressource "Einwohnermeldeamt" und aktiviere **Alle Services einschließen**.
      </Step>

      <Step title="Schalter anlegen">
        Wechsle zum Tab **Schalter** → **Neu +**. Erstelle z. B. "Schalter 1" und "Schalter 2".
      </Step>

      <Step title="Agenten hinzufügen">
        Öffne die Warteschlange → **Agenten** → **+ Erstellen**. Wähle den Admin-Nutzer, weise einen Schalter zu und setze den Status auf **Aktiv**.
      </Step>

      <Step title="Aufrufanzeige verbinden">
        Öffne den Tab **Anrufanzeigen** und kopiere den Display-Link. Öffne diesen auf einem Smart TV im Wartebereich.
      </Step>

      <Step title="Badge konfigurieren">
        Stelle sicher, dass auf dem Terminal-Badge die Wartenummer und der Warteschlangenname angezeigt werden.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Standesamt mit separatem Nummernkreislauf">
    Neben dem Bürgerbüro gibt es ein Standesamt. Beide Bereiche sollen unabhängige Nummernkreisläufe haben und eigene Schalter nutzen.

    <Steps>
      <Step title="Zweite Ressource anlegen">
        Erstelle unter **Ressourcen** eine separate Ressource "Standesamt" mit den passenden Buchungsoptionen.
      </Step>

      <Step title="Check-in aktivieren">
        Aktiviere auch hier das Check-in-Verfahren auf "Terminal" mit anonymer Registrierung.
      </Step>

      <Step title="Zweite Warteschlange erstellen">
        Gehe zu **Warteschlangen** → **Neu +**. Name: "Standesamt", Ressource: "Standesamt".
      </Step>

      <Step title="Eigene Schalter zuweisen">
        Lege unter **Schalter** einen separaten Schalter an (z. B. "Standesamt Schalter 1") oder nutze einen bestehenden.
      </Step>

      <Step title="Agenten zuordnen">
        Füge dem Standesamt eigene Agenten hinzu und weise ihnen den entsprechenden Schalter zu.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Kann ein Agent mehrere Warteschlangen gleichzeitig bedienen?">
    Ja, ein Agent kann mehreren Warteschlangen zugewiesen werden. Im Schnellaufruf sieht er dann die Tickets aller zugewiesenen Warteschlangen.
  </Accordion>

  <Accordion title="Was passiert, wenn sich jemand mit Termin nicht rechtzeitig eincheckt?">
    Die Buchung bleibt bestehen. Du kannst sie unter **Schnellaufruf** → **Buchungen** über die drei Punkte manuell in ein Ticket umwandeln und so in die Warteschlange einreihen.
  </Accordion>

  <Accordion title="Kann ich Tickets individuell vorziehen?">
    Ja. Im Bereich **Wartende Tickets** kannst du einzelne Tickets bevorzugen und früher aufrufen.
  </Accordion>

  <Accordion title="Brauche ich für jede Abteilung ein eigenes Terminal?">
    Das hängt von deinem Setup ab. Du kannst ein Terminal für mehrere Warteschlangen nutzen oder pro Abteilung ein eigenes Terminal konfigurieren.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Warteschlange und Warteliste?">
    Die Warteliste ist eine Funktion auf Ressourcen-Ebene, die Kund:innen auf eine Liste setzt, wenn keine Termine mehr verfügbar sind. Das Warteschlangensystem organisiert dagegen den Vor-Ort-Aufruf mit Nummern, Schaltern und Agenten. Beide Features haben nichts miteinander zu tun.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich kann keinen Agenten hinzufügen">
    Die Person hat keinen Admin-Zugang. Agenten benötigen einen aktiven Admin-Zugang in anny, um einem Schalter zugewiesen werden zu können. Lege die Person unter **Avatar** → **Admin-Nutzer verwalten** als Admin an und weise ihr die Rolle "Agent Warteschlange" zu.
  </Accordion>

  <Accordion title="Tickets erscheinen nicht im Schnellaufruf">
    Das Check-in-Verfahren ist auf der Ressource nicht aktiv oder nicht auf "Terminal" gestellt. Prüfe unter der Ressource → **Verfügbarkeit**, ob Check-in aktiviert ist und das Verfahren korrekt konfiguriert wurde.
  </Accordion>

  <Accordion title="Die Aufrufanzeige zeigt keine Nummer an">
    Der Display-Link wurde nicht korrekt geöffnet oder der Browser hat den Zugriff blockiert. Öffne den Link erneut auf dem Smart TV und stelle sicher, dass der Browser keine Pop-ups blockiert. Prüfe außerdem, ob die Aufrufanzeige in den Warteschlangen-Einstellungen aktiv ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature: Warteschlangensystem. Plan: ab Business. Aktivierung: Account-Einstellungen → Features → Warteschlangensystem.
> * UI-Pfad Warteschlangen: Menüleiste links → Warteschlangen (Tabs: Warteschlangen, Schalter, Einstellungen, Terminals (legacy), Check-In Terminals, Anrufanzeigen).
> * UI-Pfad Schnellaufruf: Menüleiste links → Schnellaufruf (Tabs: Übersicht, Wartende Tickets, Buchungen, Terminals).
> * Warteschlange = ein Nummernkreislauf, gebunden an genau eine Ressource. Mehrere Warteschlangen = unabhängige Nummernkreisläufe.
> * Agent = Admin-Nutzer mit Rolle "Agent Warteschlange". Ohne Admin-Zugang keine Schalter-Zuweisung möglich.
> * Schalter = frei benennbarer Arbeitsplatz, wird auf Aufrufanzeige angezeigt.
> * Ticket-Entstehung: Check-in am Terminal ODER manuelle Umwandlung einer Buchung (Schnellaufruf → Buchungen → drei Punkte → in Ticket umwandeln).
> * Voraussetzung auf Ressourcen-Ebene: Check-In & Check-Out aktiviert, Verfahren "Terminal", anonyme Registrierung erlaubt.
> * Badge: Wartenummer + Warteschlangenname müssen konfiguriert sein.
> * Technische Voraussetzungen: Hardware-Terminal + Drucker + Smart TV/Bildschirm mit Browser für Aufrufanzeige.
> * ABGRENZUNG Warteliste: Die Warteliste (Ressource → Verfügbarkeit → Warteliste) ist ein völlig anderes Feature. Sie setzt Kund:innen auf eine Liste, wenn alle Termine ausgebucht sind. Kein Bezug zum Warteschlangensystem.
> * ABGRENZUNG Anzeigetafeln: Aufrufanzeigen sind ein eigener Display-Typ im Warteschlangensystem, nicht identisch mit Anzeigetafeln & Raumdisplays.


# Regpit mit anny verbinden
Source: https://docs.anny.co/regpit-integration

Automatisiere KYC- und GWG-Prüfungen bei Abo-Anfragen mit der Regpit-Integration.

[Regpit](https://regpit.com) ist eine Plattform für automatisierte Identitäts- und Risikoprüfungen (KYC/AML). Mit der Integration kann anny Abo-Anfragen automatisch an eine Verifizierung in Regpit knüpfen und die Freigabe vom Ergebnis abhängig machen.

Mit Regpit kannst du in anny:

* Abo-Anfragen automatisch an eine Identitätsprüfung koppeln
* Den Verifizierungsstatus direkt auf der Kunden- und Abo-Page einsehen
* Abo-Anfragen erst nach erfolgreicher Risikobewertung freigeben lassen

Besonders praktisch ist die Integration, wenn du abonnierbare Leistungen anbietest, die unter GWG-Vorgaben fallen, zum Beispiel virtuelle Briefkästen oder Geschäftsadressen.

<Info>
  Verfügbar ab dem Essential-Plan. Das Feature „Abos & Mitgliedschaften“ muss aktiviert sein.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Virtuelle Briefkästen vermieten | **Identität vor Freigabe prüfen.** Bevor eine Geschäftsadresse genutzt werden kann, verifiziert Regpit automatisch die Identität. Du sparst manuelle GWG-Prüfschritte. |
| Geschäftsadressen als Abo anbieten | **GWG-konforme Freigabe sicherstellen.** Abo-Anfragen werden erst bestätigt, wenn das Gesamtrisiko unter dem definierten Schwellenwert liegt. |
| KYC-Pflichten zentral nachhalten | **Verifizierungsstatus transparent machen.** Support- und Operations-Teams sehen auf einen Blick, ob Daten fehlen, die Prüfung läuft oder die Anfrage nicht freigegeben werden darf. |

## Wie die Regpit-Verbindung funktioniert

Die Authentifizierung erfolgt über ein technisches Regpit-Nutzerkonto. In anny trägst du **Tenant-ID**, **E-Mail** und **Passwort** ein und prüfst die Verbindung. Danach erzeugst du in anny eine **Webhook-Konfiguration** und leitest sie an deine Kontaktperson bei Regpit weiter. Über diese Konfiguration meldet Regpit seine Ergebnisse zurück an anny.

Bevor die Prüfung startet, wählst du eine **Verifizierungsstrategie**: **Verifizierung vor Abonnementstart** (das Abo bleibt eine Anfrage, bis die Prüfung erfolgreich ist) oder **Verifizierung nach Abonnementstart** (das Abo startet sofort, die Prüfung läuft nachgelagert innerhalb einer Frist).

Sobald die Verbindung steht, kommunizieren anny und Regpit per Webhook:

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Neue Cases (bei Abo-Anfrage) | anny → Regpit | Echtzeit |
| Kundendaten für die Prüfung (Name, E-Mail, Anschrift, Geburtsdaten) | anny → Regpit | Echtzeit |
| Verifizierungsergebnis & Risikobewertung | Regpit → anny | Echtzeit (per Webhook) |

Der Ablauf im Detail (Modus **Verifizierung vor Abonnementstart**):

1. Eine Kund:in stellt eine Abo-Anfrage für einen Plan mit aktiver Regpit-Verbindung.
2. anny erstellt automatisch einen Case in Regpit und fordert die Kund:in per E-Mail zur Verifizierung auf.
3. anny übermittelt die vorhandenen Kunden- und Unternehmensdaten an Regpit, dort läuft die Identitätsprüfung per Video-Verfahren.
4. Regpit bewertet das Gesamtrisiko und gibt das Ergebnis per Webhook an anny zurück.
5. Liegt das Risiko höchstens auf dem festgelegten **maximalen Risikolevel** und liegen alle Daten vor, wird die Abo-Anfrage bestätigt.
6. Ist das Risiko höher oder fehlen Informationen, bleibt die Anfrage unbestätigt.

Im Modus **Verifizierung nach Abonnementstart** startet das Abonnement sofort und die Prüfung läuft nachgelagert. Schließt die Kund:in die Verifizierung nicht innerhalb der **Verifizierungsfrist** ab oder schlägt die Prüfung fehl, wird das Abonnement gekündigt, sofern die entsprechende Option aktiv ist.

![Ablauf der Regpit-Verifizierung](https://downloads.intercomcdn.eu/i/o/niegcmk9/143173247/154546771add7134732febb4166f/regpit+4.png?expires=1785320100\&signature=09b0a26d4fb930d029dbd2f01323b51eb4c6076892f76631ead799c509fb8946\&req=0dFsxF%2F5rjMvlxv889ospxAiNBxnweuUhx7RUMh8eE2dbT9wej3fa%2BJNFiyl%0AWJLYLAtU9dnaobACIw%3D%3D%0A)

<Tip>
  Eine unbestätigte Abo-Anfrage ist kein Fehler. Sie kann ein erwartetes Ergebnis sein, wenn Daten fehlen oder das Gesamtrisiko zu hoch ist.
</Tip>

## Regpit verbinden

### Voraussetzungen

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

* Ein technisches Regpit-Nutzerkonto mit **Tenant-ID**, **E-Mail** und **Passwort**
* Eine Kontaktperson bei Regpit, die die Webhook-Konfiguration entgegennehmen kann
* Mindestens einen Abo-Plan in anny, für den eine Identitätsprüfung erforderlich ist
* Admin-Rechte in anny

### Verbindung einrichten

<Steps>
  <Step title="Authentifizieren">
    Öffne **Avatar** → **Account-Einstellungen** → **Integrationen** und gehe zu **Regpit**. Trage **Tenant-ID**, **E-Mail** und **Passwort** deines technischen Regpit-Kontos ein und klicke auf **Authentifizierung überprüfen**.

    ![Integration öffnen und Authentifizierung starten](https://downloads.intercomcdn.eu/i/o/niegcmk9/143173359/22c5ee520839b08fa19b1a9916ca/regpit1.png?expires=1785320100\&signature=be7632c7c64c92780fc0169cb0d57c9c02c0a3167eeec131b9a676db6b62bdcc\&req=0dFsxF%2F5rzIhlxv889osp4WSp4uDly5syVKXdP%2Flv%2BXGO9pojhMsGi06xZeb%0Akk0fMKobj0JqdyhF7w%3D%3D%0A)
  </Step>

  <Step title="Webhook-Konfiguration erstellen">
    Erstelle die Webhook-Konfiguration und teile die Werte mit Regpit:

    1. Klicke auf **Webhook-Konfiguration generieren**.
    2. Kopiere die erstellten Werte (**Webhook-URL**, **Tenant-ID**, **Webhook-Token** und **Benutzer-E-Mail**) über **Alle in die Zwischenablage kopieren**.
    3. Leite die Werte an deine Kontaktperson bei Regpit weiter, damit Regpit den Webhook auf seiner Seite einrichtet.
    4. Klicke auf **Webhook-Verbindung testen**. anny prüft, ob eine Testmeldung von Regpit ankommt. Ohne erfolgreichen Test lässt sich die Integration nicht aktivieren.

    ![Webhook-Konfiguration generieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/143173357/3788bbc62c36a4f03f3d5c5b72fe/regpit2.png?expires=1785320100\&signature=ca82f85f2cbe8e387173f7ab568d71ddfd064b7e4b7f655b4790b7c694f259aa\&req=0dFsxF%2F5rzIvlxv889osp82n032ZePBIAxQFO75QlvOOLYn%2FDLKZy8G0wfpC%0AzSafidkKqcvqvDIqXA%3D%3D%0A)
  </Step>

  <Step title="Verifizierungsstrategie wählen">
    Öffne die **Verifizierungseinstellungen** und wähle die **Verifizierungsstrategie**: **Verifizierung vor Abonnementstart** oder **Verifizierung nach Abonnementstart**. Für „nach Abonnementstart" legst du zusätzlich die **Verifizierungsfrist (Tage)** fest und entscheidest, ob das Abonnement bei unvollständiger Verifizierung nach Fristablauf gekündigt wird.
  </Step>

  <Step title="Abo-Plan verbinden">
    Klicke im Bereich **Regpit-Einstellungen** auf **Hinzufügen**. Wähle im Dialog **Regpit-Verbindung hinzufügen** den **Abo-Plan** und das **Maximale Risikolevel zum Bestätigen**. Optional aktivierst du **Natürliche Personen von der Verifizierung ausschließen**, damit Privatpersonen ohne Unternehmen nicht geprüft werden.

    ![Regpit-Verbindung zum Abo-Plan hinzufügen](https://downloads.intercomcdn.eu/i/o/niegcmk9/143173356/caa9eb25508f59aabef592f017a1/regpit+3.png?expires=1785320100\&signature=6ca37886ca14375d4c177b9fbef2172360f4c1171c2e1ad5ec5c38772a93b139\&req=0dFsxF%2F5rzIulxv889osp6lSBM%2FY7iE1UTONc6dh7xJHSUhccu%2F7kjYxTpi5%0A0fQZB3Gs1ibG5d8Q%2BQ%3D%3D%0A)
  </Step>

  <Step title="Integration aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. Danach werden neue Abo-Anfragen für die verbundenen Pläne automatisch an Regpit weitergeleitet. Erkennbar ist die aktive Prüfung an der Verifizierungskomponente auf der **Kunden-Page** und der **Abo-Page**.
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, werden neue Abo-Anfragen für den konfigurierten Plan automatisch an Regpit weitergeleitet.

## Einschränkungen

Die Regpit-Integration unterstützt nicht:

* Einzelne Buchungen oder Bestellungen: Die Prüfung ist ausschließlich an Abo-Anfragen gekoppelt.
* Automatische Ablehnung bei zu hohem Risiko: Im Modus **Verifizierung vor Abonnementstart** bleibt eine Anfrage unbestätigt statt automatisch abgelehnt zu werden. Im Modus **Verifizierung nach Abonnementstart** kündigt anny das Abonnement dagegen automatisch, wenn die Prüfung fehlschlägt oder die Verifizierungsfrist abläuft.
* Self-Service-Aktivierung: Die Webhook-Konfiguration muss manuell an Regpit weitergegeben werden.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, bleiben bestehende Cases und die Verifizierungsanzeige in anny erhalten, aber es werden keine Updates mehr von Regpit empfangen. Neue Abo-Anfragen werden dann nicht mehr automatisch bestätigt. Beim Löschen wird zusätzlich die Webhook-Konfiguration entfernt: Regpit kann anny danach nicht mehr erreichen. Zum erneuten Verbinden musst du eine neue Webhook-Konfiguration generieren und an Regpit übermitteln.
</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 jede Abo-Anfrage durch Regpit laufen?">
    Nein. Die Prüfung betrifft nur Abo-Pläne, denen du die Regpit-Verbindung explizit zugewiesen hast. Alle anderen Pläne bleiben davon unberührt.
  </Accordion>

  <Accordion title="Wo sehe ich den aktuellen Stand der Prüfung?">
    Auf der **Kunden-Page** und auf der **Abo-Page** zeigt eine eigene Komponente den Verifizierungsstatus an: ob die Prüfung läuft, abgeschlossen ist oder Daten fehlen.
  </Accordion>

  <Accordion title="Was passiert, wenn das Risiko zu hoch ist?">
    Im Modus **Verifizierung vor Abonnementstart** bleibt die Abo-Anfrage unbestätigt. Sie wird nicht automatisch abgelehnt oder gelöscht, dein Team kann den Fall in Regpit prüfen und manuell entscheiden. Im Modus **Verifizierung nach Abonnementstart** läuft das Abonnement bereits; eine fehlgeschlagene Prüfung oder eine versäumte Verifizierungsfrist kündigt es.
  </Accordion>

  <Accordion title="Was ist der Unterschied zwischen Verifizierung vor und nach Abonnementstart?">
    Bei **Verifizierung vor Abonnementstart** bleibt das Abo eine Anfrage und wird erst nach erfolgreicher Prüfung mit akzeptablem Risiko bestätigt. Bei **Verifizierung nach Abonnementstart** startet das Abo sofort und die Prüfung läuft nachgelagert innerhalb der **Verifizierungsfrist**. Du wählst die Strategie in den **Verifizierungseinstellungen**.
  </Accordion>

  <Accordion title="Werden auch Privatpersonen ohne Unternehmen geprüft?">
    Nur, wenn du es möchtest. Aktivierst du beim Verbinden eines Plans **Natürliche Personen von der Verifizierung ausschließen**, werden Kund:innen, die als natürliche Person erkannt werden, für diesen Plan nicht durch die Prüfung geschickt.
  </Accordion>

  <Accordion title="Müssen Admins zusätzlich noch manuell in Regpit arbeiten?">
    Der fachliche Prüfungs-Flow läuft über Regpit. Admins können dort Cases einsehen und bei Bedarf eingreifen. Die Freigabe in anny erfolgt automatisch, wenn die Bedingungen erfüllt sind.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Meine Kund:in hat keine Verifizierungs-E-Mail erhalten">
    Das Benachrichtigungssystem sendet die E-Mail automatisch, sobald der Case in Regpit erstellt wird. Prüfe den Spam-Ordner der Kund:in. Falls das Problem bestehen bleibt, kontaktiere den anny Support, da es sich um ein Webhook-Timing-Problem handeln kann.
  </Accordion>

  <Accordion title="Die Verifizierung ist abgeschlossen, aber die Abo-Anfrage bleibt unbestätigt">
    Prüfe in Regpit, ob der Case tatsächlich mit einem freigabefähigen Ergebnis abgeschlossen wurde. Liegt das Gesamtrisiko über dem definierten Schwellenwert, bleibt die Anfrage bewusst unbestätigt. Zusätzlich kann ein Webhook-Ausfall dazu führen, dass der Status in anny nicht aktualisiert wurde. Kontaktiere in dem Fall den anny Support.
  </Accordion>

  <Accordion title="Kund:innen erhalten weiterhin Verifizierungserinnerungen nach erfolgreicher Prüfung">
    Das kann auftreten, wenn der abschließende Webhook von Regpit nicht bei anny angekommen ist und der Status auf „ausstehend“ hängen geblieben ist. Löse die Prüfung über die Aktion **Identitätsverifizierungen erneut auslösen** in der Regel-Tabelle erneut aus, damit anny den aktuellen Stand von Regpit nachholt. Bleibt das Problem bestehen, kontaktiere den anny Support.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Regpit ist eine Identitäts-/Risikoprüfung (KYC/GWG) für Abonnements, KEINE Smart-Lock- oder Zutritts-Integration. Die Prüfung greift ausschließlich bei Abo-Anfragen (Plan-Subscriptions), nie bei Einzelbuchungen oder Bestellungen.
>
> **UI-Pfad:** **Avatar** → **Account-Einstellungen** → **Integrationen** → **Regpit**. Panels in dieser Reihenfolge: „Regpit Authentifizierung" (Felder Tenant-ID, E-Mail, Passwort; Hinweis „Technischer User Account"; Button „Authentifizierung überprüfen"), „Webhook-Konfiguration" (Button „Webhook-Konfiguration generieren" → Werte Webhook-URL, Tenant-ID, Webhook-Token, Benutzer-E-Mail; Button „Webhook-Verbindung testen"), „Verifizierungseinstellungen" (Verifizierungsstrategie; bei „nach Abonnementstart" zusätzlich „Verifizierungsfrist (Tage)" und Toggle „Abonnement kündigen … nach Ablauf der Frist"), „Regpit-Einstellungen" (Regel-Tabelle mit Spalten „Plan", „Maximales Risikolevel zum Bestätigen", „Natürliche Personen ausschließen"; Button „Hinzufügen" → Dialog „Regpit-Verbindung hinzufügen").
>
> **Authentifizierung:** technisches Regpit-Nutzerkonto (Tenant-ID + E-Mail + Passwort), NICHT die Webhook-Konfiguration. Die Webhook-Konfiguration ist ein separater zweiter Schritt für eingehende Meldungen (Regpit → anny). Aktivierung per Toggle ist erst möglich, wenn eine Webhook-Konfiguration existiert UND der Webhook-Test erfolgreich war.
>
> **Verifizierungsstrategien:** (1) „Verifizierung vor Abonnementstart" (Standard): Abo bleibt Anfrage; bei erfolgreicher Prüfung mit Risiko ≤ „Maximales Risikolevel zum Bestätigen" wird bestätigt, sonst bleibt es unbestätigt (keine automatische Ablehnung/Löschung). anny erzwingt für verbundene Pläne, dass sie eine Bestätigung erfordern. War die Kund:in bereits verifiziert, wird sofort bestätigt (kein neuer Case). (2) „Verifizierung nach Abonnementstart": Abo startet sofort; Prüfung nachgelagert innerhalb der „Verifizierungsfrist (Tage)" (Standard 28). Fehlgeschlagene Prüfung ODER Fristablauf (bei aktiver Kündigungs-Option) kündigt das Abonnement. Erinnerungen an die Kund:in etwa alle 3 Tage plus vor Fristablauf, nur in diesem Modus.
>
> **Risikolevel:** sechs Stufen (Niedrig, Mittel niedrig, Mittel, Mittel hoch, Hoch, Sehr hoch), pro Plan als Höchstwert wählbar. „Natürliche Personen ausschließen" pro Plan: überspringt die Prüfung für Kund:innen ohne erkanntes Unternehmen (Erkennung per Firmenname/Rechtsform).
>
> **Datenfluss an Regpit (Datenschutz):** Name/Firmenname, E-Mail, Anschrift, Geburtsdatum, Geburtsname, Geburtsort. Prüfung per Video-Verfahren bei Regpit.
>
> **Verifikationsstatus** sichtbar auf Kunden-Page UND Abo-Page (eigene Komponente).
>
> **Hängende Prüfungen:** Fällt ein Regpit-Webhook aus, bleibt der Status „ausstehend". Selbst-Lösung: Aktion „Identitätsverifizierungen erneut auslösen" in der Regel-Tabelle (pro Regel); alternativ anny Support.
>
> **Deaktivieren:** Cases/Verifizierungsanzeige bleiben, keine Updates mehr von Regpit, keine automatische Bestätigung neuer Anfragen. **Löschen:** entfernt zusätzlich die Webhook-Konfiguration (Token), Regpit erreicht anny danach nicht mehr; erneutes Verbinden erfordert eine neue Konfiguration.
>
> **Verwandte Artikel:** Einrichtung Abo-Management, Communities (Abo-basierte Zugangssteuerung).


# Roadmap
Source: https://docs.anny.co/roadmap





# SALTO KS mit anny verbinden
Source: https://docs.anny.co/salto-ks

Automatisiere zeitlich begrenzte Zutritte per SALTO-KS-App, PIN-Code oder Remote Open für Buchungen und Communities.

[SALTO KS](https://saltosystems.com/de-de/technologieplattformen/salto-ks/) ist ein cloudbasiertes Zutrittssystem für elektronische Türschlösser. Mit der Integration erstellt anny automatisch passende Zutrittsrechte für Buchungen und Community-Mitglieder.

Mit SALTO KS kannst du in anny:

* Zutritte automatisch anhand von Buchungen erstellen
* Community-Mitgliedern Zugang zu ausgewählten Schlössern geben
* zeitlich begrenzte Zugänge per SALTO-KS-App, PIN-Code oder Remote Open bereitstellen

Besonders praktisch ist die Integration für Räume, Arbeitsplätze und Coworking-Flächen, die ohne manuelle Schlüsselübergabe genutzt werden sollen.

<Info>
  Verfügbar ab dem **Professional-Plan**.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Räume nach Buchung öffnen | **Kund:innen erhalten automatisch zeitlich begrenzten Zutritt.** anny verknüpft die gebuchte Ressource mit den ausgewählten SALTO-KS-Schlössern. |
| Zutritt für Community-Mitglieder | **Mitglieder erhalten Zugang unabhängig von einzelnen Buchungen.** Du ordnest einer Community ein oder mehrere Schlösser zu. |
| Zugang ohne App ermöglichen | **Ein PIN-Code ersetzt die Anmeldung in der SALTO-KS-App.** Voraussetzung ist ein kompatibles Schloss mit Keypad. |

## Wie die SALTO-KS-Verbindung funktioniert

Du autorisierst anny mit einem SALTO-KS-Admin-Account. Danach kann anny die verfügbaren Schlösser laden und zeitlich begrenzte Zutrittsrechte anhand deiner Regeln erstellen.

Bei einer Buchungsregel verknüpfst du eine anny Ressource mit einem oder mehreren Schlössern. anny erstellt den Zugang für das festgelegte Zeitfenster vor, während und nach der Buchung. Wird eine Buchung storniert, entzieht anny auch das zugehörige Zutrittsrecht.

Bei Einzelbuchungen legt anny den Zugang sofort an. Bei Serienbuchungen bereitet anny jeden Zugang erst kurz vor dem Termin vor. Bis dahin trägt das Zutrittsrecht den Status **Geplant**.

Bei einer Community-Regel erhalten die Mitglieder der ausgewählten Community Zugang zu den zugeordneten Schlössern. Wenn die Autorisierung widerrufen wird oder nicht mehr gültig ist, kann anny keine neuen Zutrittsrechte erstellen. Autorisiere die Integration dann erneut.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Schlösser | SALTO KS → anny | Beim Laden und Aktualisieren der Integration |
| Buchungsbasierte Zutrittsrechte | anny → SALTO KS | Automatisch anhand der Buchung und Zutrittsregel |
| Community-basierte Zutrittsrechte | anny → SALTO KS | Automatisch anhand der Community-Regel |
| Status eines Zutrittsrechts | SALTO KS → anny | Nach Erstellung oder Änderung des Zutrittsrechts |

## SALTO KS verbinden

### Voraussetzungen

Bevor du SALTO KS verbindest, stelle sicher, dass du Folgendes hast:

* einen eingerichteten SALTO-KS-Admin-Account
* mindestens ein in SALTO KS eingerichtetes und getestetes Schloss
* den **Professional-Plan** oder höher in anny
* eine eingerichtete Ressource oder Community, die du mit einem Schloss verknüpfen möchtest

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **SALTO KS**. Klicke auf **Autorisieren** und melde dich mit deinem SALTO-KS-Admin-Account an.

    Die Ansicht zeigt, wo du die SALTO-KS-Integration öffnest und die Autorisierung startest:

    ![SALTO KS in den Integrationen öffnen und autorisieren](https://downloads.intercomcdn.eu/i/o/5781272/b5c7d0477181a1036f5a1fd6/Frame+3.png?expires=1785256200\&signature=8e01c8a85e1c95076dbcfd529a355b2aa8bb3237348907d2a34ca8e3c54114d7\&req=1dJnxFr9rnsp0xr0v9tnrl6Rm7yqGXy6kO7CgXIgWKHlA7bI9Vs2%2FElHBknX%0A9mc8UyZBWkJcKTQ%3D%0A)
  </Step>

  <Step title="Anlage wählen">
    Wähle nach der Autorisierung die **Anlage** aus, mit der die Integration arbeiten soll. Sie bestimmt, welche Schlösser in anny verfügbar sind. Du kannst nur eine Anlage je Integration nutzen.

    Wenn du die Anlage später wechselst, entfernt anny alle bestehenden Regeln. Verbundene IQs und die OTP-Einrichtung gehören zur alten Anlage. Behandle den Wechsel wie eine komplette Neueinrichtung.
  </Step>

  <Step title="Konfigurieren">
    Lege anschließend die Regeln für deine Zutritte fest:

    1. Klicke bei Buchungen oder Communities auf **Hinzufügen**.
    2. Wähle die Ressource oder Community aus.
    3. Ordne ein oder mehrere SALTO-KS-Schlösser zu.
    4. Lege bei Buchungsregeln **Zugang vor der Buchung** und **Zugang nach der Buchung** fest.
    5. Aktiviere bei einem kompatiblen Keypad bei Bedarf **Zugang über Keypad verwenden** für den PIN-Zutritt.
    6. Aktiviere bei Bedarf **Fernöffnung verwenden**, damit Kund:innen das Schloss direkt aus anny öffnen können. Der Schalter erscheint erst, wenn unter **Remote-Open** mindestens ein IQ bereit ist. Regeln, die Fernöffnung bereits nutzen, behalten den Schalter.
    7. Ist Fernöffnung aktiv, kannst du zusätzlich **Zusätzlich App-Zugang senden** einschalten. Dann erhalten Kund:innen neben der Fernöffnung den normalen Zugang über die SALTO-KS-App.

    Diese Ansicht zeigt die Regel für buchungsbasierte Zutritte:

    ![Buchungsregel für SALTO KS konfigurieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/34295080/861d6475dbb035954bbb6011accd/Frame-2B10-284-29.png?expires=1785256200\&signature=9d3e53330fee37698e1548b3e2b463308cf61b031228c6c9811b1c3168ed718b\&req=09FtzF36pDdk2hL085ZhoSrCd2IgowwhFs%2BJzxoBbn0Y%2BfXATb9JnDgDcwoN%0ASyHfIMYPukzZgVBb%0A)

    Die Detailansicht zeigt die Auswahl von Ressource, Schloss und Zutrittszeitraum:

    ![Details einer buchungsbasierten SALTO-KS-Regel](https://downloads.intercomcdn.eu/i/o/niegcmk9/34295079/5745074df0e7eaf17bb8d01073b8/Frame%2B10%2B-%2B2025-01-16T172911_733.png?expires=1785256200\&signature=d7a9a2466a7da4120babbbc3ff5f706abbea132021c7daf86881216ec5108e46\&req=09FtzF36qz5k2hL085ZhoUAx0nV2KGgDajiF7GT0qKU74aAstvkXUT%2BAeBdK%0Ap2qIrunVOousrlL9%0A)

    Diese Ansicht zeigt die Zuordnung einer Community zu SALTO-KS-Schlössern:

    ![Community-Regel für SALTO KS konfigurieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/34295082/4bcdf032d888818c6c2e3adcd924/Frame-2B10-285-29.png?expires=1785256200\&signature=19dac4e6ade33f515a7e7be85b8e19402267db4bccbe4bc8ec2dbe6d09244c64\&req=09FtzF36pDVk2hL085ZhoVOb4wp0lEFD%2BLFbRxyJKBk%2FA0kNnVe945xTTdnk%0A%2BzQnERO4I62YFfaU%0A)
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, erstellt anny Zutrittsrechte automatisch nach deinen Regeln.

<Tip>
  Über die **drei Punkte** neben einer Regel kannst du bestehende Zuordnungen bearbeiten oder löschen.
</Tip>

### Einstellungen & Optionen

| Einstellung | Funktion |
| - | - |
| Ressource | Bestimmt, welche Buchung ein Zutrittsrecht auslöst. |
| Community | Bestimmt, welche Community-Mitglieder Zugang erhalten. |
| Schlösser | Legt fest, welche Türen mit der Regel geöffnet werden können. |
| Zugang vor der Buchung | Erweitert den Zugang um einen festgelegten Zeitraum vor dem Buchungsbeginn. |
| Zugang nach der Buchung | Erweitert den Zugang um einen festgelegten Zeitraum nach dem Buchungsende. |
| Zugang über Keypad | Ermöglicht den Zutritt per PIN ohne SALTO-KS-App bei einem kompatiblen Schloss mit Keypad. |
| Fernöffnung verwenden | Erstellt Fernöffnungs-Zugänge, mit denen Kund:innen das Schloss aus anny öffnen. Ohne **Zusätzlich App-Zugang senden** ersetzt die Fernöffnung App- oder PIN-Zugang. |
| Zusätzlich App-Zugang senden | Nur bei aktiver Fernöffnung. Kund:innen erhalten zusätzlich zur Fernöffnung den normalen Zugang über die SALTO-KS-App. Keypad-PIN entfällt in dieser Kombination. |

### Remote Open

Mit Remote Open können Kund:innen Türschlösser per Knopfdruck über anny öffnen. Die Einrichtung liegt unter **Integrationen → SALTO KS** im Bereich **Remote-Open** und ist optional.

<Steps>
  <Step title="IQ verbinden">
    Klicke auf **IQ hinzufügen**, wähle den IQ und verbinde ihn. anny versucht, das **IQ-Secret** von SALTO KS abzurufen. Fehlt es, trägst du es über **Secret manuell eingeben** ein oder holst es später mit **Secret erneut von Salto abrufen**.

    Die Tabelle zeigt pro IQ die Spalten **IQ**, **Status** und **IQ-Secret**. Der Status ist **Remote-Open bereit**, **Secret fehlt** oder **OTP ausstehend**.
  </Step>

  <Step title="OTP aktivieren">
    Klicke auf **Remote-Open via OTP hinzufügen**. Die Aktivierung ist dauerhaft: Jede Fernöffnung braucht danach ein Einmalpasswort. Wähle, ob Salto den Aktivierungs-PIN **Per SMS** oder **Per E-Mail** schickt. Gib den PIN ein und klicke auf **OTP aktivieren**.

    Über **OTP & PINs anzeigen** siehst du die **Aktuelle OTP-PIN** und je IQ ein Einmalpasswort (ca. 3 Minuten gültig).
  </Step>

  <Step title="In der Buchungsregel einschalten">
    Aktiviere in der Buchungsregel **Fernöffnung verwenden**. Optional **Zusätzlich App-Zugang senden**. Nur Schlösser hinter einem bereiten IQ stehen für die Fernöffnung zur Verfügung.
  </Step>
</Steps>

| Ort | Wo öffnest du die Tür? |
| - | - |
| E-Mail | Der Button **Öffnen** in der Buchungs-E-Mail leitet in den Browser weiter. Dort öffnest du das Schloss. |
| anny App | Der Button **Schloss entsperren** erscheint auf der Home-Seite und in deiner Buchung. |
| Browser | Der Button **Schloss entsperren** erscheint auf der Home-Seite und in deiner Buchung. |

Die Fernöffnung steht nur für Buchungsregeln zur Verfügung. Community-Regeln bieten Zugang per App oder PIN, aber keine Fernöffnung.

### Zutrittsrechte prüfen

Öffne eine Buchung und wähle das zugehörige Zutrittsrecht aus. Dort siehst du den Status, den Zutrittszeitraum, das Türschloss, das Erstellungsdatum und gegebenenfalls den PIN-Code. Du kannst außerdem die Zugangs-URL kopieren.

Die Buchungsdetailansicht zeigt aktive und inaktive Zutrittsrechte:

![SALTO-KS-Zutrittsrechte in einer Buchung prüfen](https://downloads.intercomcdn.eu/i/o/niegcmk9/34295081/72020dae24cc69073a9729c23c8f/Frame-2B10-286-29.png?expires=1785256200\&signature=21c7bedc3b9c7dc8645ab333b7b8c010545dfcc8db0e7fda55847991ae9cb647\&req=09FtzF36pDZk2hL085ZhoRQIFMcum4Z2SXc7Ycys0YuzXXHP2M7NlbFlZvs8%0AdrNLgKG06W88aRPG%0A)

| Status | Bedeutung |
| - | - |
| Geplant | Der Zutritt wird kurz vor dem Termin erstellt. Dieser Status tritt vor allem bei Serienbuchungen auf. |
| In Bearbeitung | anny hat den Zutritt angefordert, SALTO KS hat ihn aber noch nicht vergeben. |
| Erfolgreich | Der Zutritt ist aktiv und kann im angezeigten Zeitraum verwendet werden. |
| Entfernt | Das System oder ein:e Admin hat den Zutritt entfernt. Die Person kann das Schloss nicht mehr öffnen. |

## Einschränkungen

Die SALTO-KS-Integration unterstützt nicht:

* PIN-Zutritt an Schlössern ohne kompatibles Keypad
* die Erstellung neuer Zutrittsrechte, wenn die Integration deaktiviert oder nicht mehr autorisiert ist
* die Nutzung von Smart-Lock-Integrationen in einem Plan unterhalb von Professional

Die Anzahl verfügbarer Zutrittsrechte kann zusätzlich von deinem SALTO-KS-Vertrag abhängen.

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Wie erhalten Kund:innen ihren SALTO-KS-Zugang?">
    Je nach Regel öffnen Kund:innen die Tür über die SALTO-KS-App, einen PIN-Code am Keypad oder Remote Open in anny.
  </Accordion>

  <Accordion title="Brauchen Kund:innen einen SALTO-KS-Account?">
    Für den Zugang über die SALTO-KS-App melden sie sich mit derselben E-Mail-Adresse an, die sie für die Buchung verwendet haben. Für PIN-Zutritt ist kein SALTO-KS-Account nötig.
  </Accordion>

  <Accordion title="Wann ist ein Zutrittsrecht gültig?">
    Das Zutrittsrecht gilt während der Buchung sowie für die in der Regel festgelegten Zeiträume vor und nach der Buchung.
  </Accordion>

  <Accordion title="Was passiert bei einer Stornierung?">
    Wenn eine Buchung in anny storniert wird, entfernt anny auch das zugehörige Zutrittsrecht.
  </Accordion>

  <Accordion title="Kann eine Ressource mehrere Schlösser öffnen?">
    Ja. Du kannst einer Ressource mehrere SALTO-KS-Schlösser zuordnen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Für meine Buchung wurde kein Zutritt erstellt">
    Prüfe in der Buchungsdetailansicht, ob ein Zutrittsrecht vorhanden ist. Kontrolliere anschließend unter **Integrationen → SALTO KS**, ob die Integration aktiv und autorisiert ist und ob die Ressource einer Regel zugeordnet wurde. Bei Serienbuchungen steht der Zutritt zunächst auf **Geplant** und wird erst kurz vor dem Termin erstellt.
  </Accordion>

  <Accordion title="Meine SALTO-KS-Schlösser werden nicht angezeigt">
    Prüfe zuerst, ob du unter **Integrationen → SALTO KS** eine **Anlage** ausgewählt hast, denn erst dann sind Schlösser verfügbar. Kontrolliere danach, ob die Schlösser im SALTO-KS-Adminbereich eingerichtet und funktionsfähig sind. Autorisiere die Integration bei Bedarf erneut, damit anny die verfügbaren Schlösser neu lädt.
  </Accordion>

  <Accordion title="Der PIN-Code öffnet die Tür nicht">
    Prüfe, ob das Schloss ein kompatibles Keypad besitzt und der Zutrittszeitraum bereits begonnen hat. Vergleiche anschließend den PIN-Code mit der Buchungsbestätigung und dem Zutrittsrecht in der Buchungsdetailansicht.
  </Accordion>

  <Accordion title="Die Fernöffnung funktioniert nicht">
    Fernöffnung setzt einen verbundenen IQ mit aktiver OTP-Einrichtung voraus. Prüfe in der IQ-Tabelle den **Status** und in der Regel-Übersicht die Spalte **Mögliche Fehler**: Steht dort „OTP inaktiv", verbinde den IQ, schließe OTP unter **Remote-Open** ab und aktiviere in der Regel **Fernöffnung verwenden**.
  </Accordion>

  <Accordion title="Die PIN-SMS oder PIN-E-Mail kommt nicht an">
    Salto sendet den Aktivierungs-PIN nur einmal pro Benutzer. Existiert bereits ein PIN, zeigt anny die Anleitung **IQ-PIN zurücksetzen**: Ein zweiter SALTO-KS-Administrator setzt den IQ-PIN zurück. Danach klickst du in anny erneut auf **OTP senden**.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Einordnung:** SALTO KS ist eine Smart-Lock-/Zutritts-Integration (Untergruppe „Zutritt & Smart-Locks"), technisch eine Access-Control-Integration wie Nuki, klever-key, Comydo, UniFi Access, Key-Cafe. Plan-Gating über das Feature INTEGRATIONS\_SMART\_LOCKS (laut Artikel ab Professional; genaue Plan-Grenze nicht aus dem Code verifizierbar).
>
> **Setup-Reihenfolge:** Menüleiste → **Integrationen** → **SALTO KS** → **Autorisieren** (OAuth, SALTO-KS-Admin-Account) → **Anlage** wählen (Pflicht; bestimmt verfügbare Schlösser; nur eine Anlage je Integration; Anlagenwechsel löscht alle Buchungsregeln und macht IQ/OTP der alten Anlage ungültig) → optional Bereich **Remote-Open**: **IQ hinzufügen** (Secret automatisch, manuell oder **Secret erneut von Salto abrufen**) + **Remote-Open via OTP hinzufügen** (Kanal **Per SMS** / **Per E-Mail**, Schalter **OTP aktivieren**, dauerhaft) → **OTP & PINs anzeigen** (aktuelle PIN + je-IQ-OTP, ca. 3 Min.) → Regeln unter „Zugang durch Buchungen" / „Zugang durch Communities" anlegen. Schalter **Fernöffnung verwenden** nur sichtbar, wenn `remote_open.otp_setup_complete` und mindestens ein IQ `remote_open_ready` (bestehende remote\_open-Regeln behalten den Schalter).
>
> **Regel-Felder (Buchung):** Ressource, Schlösser (Auswahl-Label „Zylinder auswählen", Spalte „Schlösser"), „Zugang vor der Buchung", „Zugang nach der Buchung", Schalter „Zugang über Keypad verwenden" (Spalte „Verwendet Tastatur-Pin"), Schalter „Fernöffnung verwenden" (Spalte „Fernöffnung"), Schalter „Zusätzlich App-Zugang senden" (`send_app_access`, nur wenn Fernöffnung an), Warnspalte „Mögliche Fehler" („OTP inaktiv:  ()"). Community-Regeln haben KEINEN Fernöffnungs-Schalter, nur Keypad/App.
>
> **Zugangsarten pro Regel:** Standard exklusiv Fernöffnung (REMOTE\_OPEN, Button „Schloss entsperren"; E-Mail-Button „Öffnen" führt auf die Buchungsseite) ODER Keypad-PIN (PIN + „#") ODER SMARTPHONE\_APP (Einladung an die Buchungs-E-Mail). Ausnahme: `remote_open` + `send_app_access` erzeugt Fernöffnung UND App-Zugang und überspringt Keypad.
>
> **Quirks:** (1) Nur angenommene Buchungen mit Kund:in lösen Zugänge aus; interne Blocker nicht. Blocker→Buchung erstellt Zugang, Buchung→Blocker entfernt ihn. (2) Buchungsregel auf einer übergeordneten Ressource greift auch für Unterressourcen. (3) Pro Ressource ist nur eine Buchungsregel erlaubt (doppelte Ressource wird beim Speichern abgelehnt). (4) Einzelbuchungen: Zugang sofort. Serien-/wiederkehrende Buchungen: Zugang „Geplant", Erstellung ca. 48 h vor Zutrittsbeginn. (5) Einzelbuchungen erhalten eine zusätzliche Zugangs-E-Mail, Serienbuchungen nicht. (6) Community-Zugänge sind unbefristet (kein Enddatum); fehlende Zugänge für Bestandsmitglieder über „Fehlende Zutrittsrechte … erstellen" nachziehbar. (7) Änderung von Schlössern/Ressource einer Regel bzw. Löschen einer Regel passt künftige Zugänge automatisch an/entfernt sie. (8) Deaktivieren: keine neuen Zugänge, bestehende bleiben. Löschen: interne Zutrittsrechte werden entfernt und Ressourcenverknüpfungen gelöst.
>
> **Statuswerte:** Geplant, In Bearbeitung, Erfolgreich, Entfernt, Unbestätigt, Fehlgeschlagen, Nicht autorisiert, Aufräumen.
>
> **Zutritts-Detailansicht** („Smartlock Zugänge" in der Buchung): Status, Zugang beginnt/endet am, Türschloss, Erstellt am, Zugangs-URL kopieren, „Zugang beim Anbieter anzeigen", bei Fernöffnung „Schloss entsperren".
>
> **Terminologie:** UI nutzt gemischt „Zylinder" (Auswahl), „Schlösser" (Spalte), „Türschloss" (Detail) sowie „Zugang"/„Smartlock Zugänge" (Detail) neben dem Artikelbegriff „Zutrittsrecht". Für Zutritt allgemein siehe Übersicht „Zutritt & Smart-Locks".


# Shelly mit anny verbinden
Source: https://docs.anny.co/shelly

Schalte Geräte wie Beleuchtung automatisch per Buchungsereignis ein und aus.

[Shelly](https://www.shelly.com) ist ein Hersteller kompakter, WLAN-fähiger Schaltrelais (Switches), die direkt in der Stromleitung vor einem Gerät oder hinter einem Lichtschalter verbaut werden. Mit der Integration steuert anny deine Shelly-Schalter automatisch basierend auf Buchungsereignissen.

Mit Shelly kannst du in anny:

* Geräte wie Beleuchtung oder Lüftung automatisch ein- und ausschalten, wenn eine Buchung beginnt oder endet
* Schaltbefehle an den Check-In oder Check-Out einer Buchung koppeln
* Jede Ressource mit einem eigenen Shelly-Schalter verknüpfen und über Regeln individuell steuern

Besonders praktisch ist die Integration, wenn du Räume oder Plätze betreibst, deren Ausstattung nur während aktiver Buchungen laufen soll, z. B. Sportplatz-Beleuchtung, Studio-Technik oder Meetingraum-Displays.

<Info>
  Verfügbar ab dem Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Platzbeleuchtung im Sportzentrum | **Licht geht automatisch an, sobald Spieler:innen einchecken.** Nach der Buchung schaltet es sich wieder aus. Kein manuelles Eingreifen und kein unnötiger Stromverbrauch zwischen Buchungen. |
| Meetingraum-Ausstattung | **Displays und Lüftung starten mit Buchungsbeginn.** Geräte laufen nur, wenn der Raum tatsächlich gebucht ist, und schalten sich am Ende automatisch ab. |
| Außenbereiche und Flutlicht | **Flutlicht für Padel-Courts oder Tennisplätze wird per Check-In aktiviert.** Betreiber:innen sparen Energiekosten, weil die Beleuchtung exakt an die Buchungszeit gekoppelt ist. |

## Wie die Shelly-Verbindung funktioniert

Die Verbindung wird über den API-Schlüssel deines Shelly-Kontos hergestellt. Du gibst in anny die Shelly URL und den API-Schlüssel ein. anny authentifiziert sich damit bei Shelly und kann anschließend Schaltbefehle an deine registrierten Geräte senden.

Der Ablauf einer Schaltaktion:

1. Ein Buchungsereignis tritt ein (z. B. Buchung ist eingecheckt). Nur **bestätigte** Buchungen lösen Schaltaktionen aus. Angefragte, abgelehnte oder stornierte Buchungen lösen keine Schaltaktionen aus.
2. anny prüft, ob eine Regel für die betroffene Ressource und das Ereignis existiert und ob die Regel laut ihrem aktiven Zeitplan gerade gilt.
3. Trifft eine Regel zu, sendet anny den Befehl (Ein- oder Ausschalten) an den zugeordneten Shelly-Schalter.
4. Die Aktion wird im Aktivitätsprotokoll der Buchung dokumentiert.

Schaltbefehle werden mit kurzem Abstand nacheinander gesendet. Wenn viele Regeln gleichzeitig feuern (z. B. mehrere Buchungen starten zur vollen Stunde), können sich einzelne Schaltungen um wenige Sekunden verzögern.

## Shelly verbinden

### Voraussetzungen

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

* Ein Shelly-Konto mit registrierten Geräten und Zugriff auf den API-Schlüssel
* WLAN-fähige Shelly-Schalter, die im Netzwerk erreichbar sind (Empfehlung: [Shelly 1 Gen3](https://www.shelly.com/products/shelly-1-gen3))
* Für jeden schaltbaren Bereich ist klar, welcher Shelly-Schalter zuständig ist (Empfehlung: 1 Ressource = 1 Schalter; mehrere Ressourcen können sich aber auch einen Schalter teilen)
* Admin-Rechte in deinem anny Account

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Shelly**. Trage die **Shelly URL** ein (mit `https://` am Anfang) und füge den **API-Schlüssel** aus deinem Shelly-Konto ein. Klicke auf **Authentifizierung überprüfen**, bis die Verbindung als erfolgreich angezeigt wird.
  </Step>

  <Step title="Konfigurieren">
    Lege Regeln an, um Buchungsereignisse mit Schaltaktionen zu verknüpfen:

    1. Klicke auf **Hinzufügen**.
    2. Wähle die **Ressource** (z. B. Court 6).
    3. Lege das **Buchungs-Ereignis** als Auslöser fest (z. B. „Buchung ist eingecheckt“).
    4. Wähle den **Shelly-Schalter**, der zu dieser Ressource gehört.
    5. Wähle unter **Zustand ändern zu** die Aktion (z. B. „Eingeschaltet“).
    6. Optional: Begrenze die Regel über den **Aktivitäts-Modus** auf ein tägliches Zeitfenster (z. B. Flutlicht nur außerhalb von 08:00–18:00 einschalten).
    7. Speichere die Regel.
    8. Erstelle für die Gegenaktion eine zweite Regel (z. B. „Buchung ist ausgecheckt“ → „Ausgeschaltet“).
    9. Aktiviere die gesamte Integration über den **Toggle**, damit die Regeln live ausgeführt werden.
  </Step>
</Steps>

Sobald die Integration aktiv ist, werden Schaltbefehle bei jedem passenden Buchungsereignis automatisch an deine Shelly-Geräte gesendet.

<Tip>
  Teste die Integration mit einer Testbuchung: Lege eine Buchung an, löse den Auslöser aus (z. B. Einchecken) und prüfe, ob der Schalter reagiert. Im Aktivitätsprotokoll der Buchung siehst du, welche Aktionen ausgeführt oder übersprungen wurden.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Buchungs-Ereignis | Bestimmt, welches Buchungsereignis die Regel auslöst: **Buchung beginnt**, **Buchung endet**, **Buchung ist eingecheckt**, **Buchung ist ausgecheckt**. |
| Zustand ändern zu | Der Befehl an den Shelly-Schalter: **Eingeschaltet** oder **Ausgeschaltet**. |
| Ressource | Die Ressource, für die die Regel gilt. Jede Regel ist an genau eine Ressource gebunden. Eine Regel auf einer übergeordneten Ressource greift auch bei Buchungen ihrer Unterressourcen. |
| Shelly-Schalter | Das Zielgerät, das den Befehl empfängt. Pro Regel wird ein Schalter zugeordnet. |
| Aktiver Zeitplan | Begrenzt die Regel auf ein tägliches Zeitfenster: **Immer aktiv**, **Innerhalb der Start- und Endzeit** oder **Außerhalb der Start- und Endzeit** (Zeiten in 5-Minuten-Schritten, maßgeblich ist die Zeitzone der Ressource). Beispiel: Flutlicht nur außerhalb von 08:00–18:00 einschalten, tagsüber bleibt die Regel wirkungslos. |
| Aufeinanderfolgende Buchungen | anny überspringt das Ausschalten automatisch, solange noch eine andere bestätigte Buchung läuft, die denselben Schalter nutzt: etwa wenn eine Buchung nahtlos an die vorherige anschließt oder wenn sich mehrere Ressourcen einen Schalter teilen. Das Gerät bleibt durchgehend eingeschaltet, bis keine laufende Buchung den Schalter mehr benötigt; übersprungene Aktionen stehen im Aktivitätsprotokoll. |

<Tip>
  Die Auslöser „Buchung ist eingecheckt“ und „Buchung ist ausgecheckt“ setzen voraus, dass für die Ressource ein QR-Code-Ticket aktiviert ist (Feature: Check-In & Check-Out).
</Tip>

## Einschränkungen

Die Shelly-Integration unterstützt nicht:

* **Statusabfrage:** anny kann den aktuellen Zustand eines Schalters (ein/aus) nicht abfragen, sondern nur Befehle senden.
* **Dimmen oder Zwischenstufen:** Es werden ausschließlich die Aktionen „Eingeschaltet“ und „Ausgeschaltet“ unterstützt.
* **Automatische Geräteerkennung:** Shelly-Geräte müssen im Shelly-Konto registriert und über die Shelly URL erreichbar sein, bevor sie in anny zugeordnet werden können.
* **Automatische Wiederholung:** Schlägt ein Schaltbefehl fehl (z. B. weil das Gerät gerade offline ist), wird er nicht automatisch erneut versucht. Der Schaltzustand bleibt dann unverändert.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, reagiert Shelly nicht mehr auf Buchungsereignisse. Das gilt auch für bereits bestehende Buchungen. Beim Löschen werden alle gespeicherten Regeln entfernt, weitere Schritte sind nicht erforderlich.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Brauche ich für jeden Shelly-Schalter eine eigene Regel?">
    Ja. Jede Regel verknüpft genau eine Ressource mit einem Schalter und einem Auslöser. Wenn du beim Einchecken einschalten und beim Auschecken ausschalten möchtest, brauchst du zwei Regeln pro Ressource.
  </Accordion>

  <Accordion title="Was passiert, wenn zwei Buchungen direkt hintereinander liegen?">
    anny überspringt das Ausschalten, solange noch eine andere bestätigte Buchung läuft, die denselben Schalter nutzt: z. B. eine nahtlos anschließende Buchung oder eine parallele Buchung auf einer Ressource, die sich den Schalter teilt. Das Gerät bleibt durchgehend eingeschaltet und wird erst am Ende der letzten Buchung ausgeschaltet.
  </Accordion>

  <Accordion title="Wie ändere ich die Zugangsdaten (Shelly URL / API-Schlüssel)?">
    Deaktiviere die Integration zuerst über den **Toggle**, denn solange sie aktiv ist, lassen sich die Zugangsdaten nicht ändern. Trage danach beide Felder neu ein und klicke auf **Authentifizierung überprüfen**. Schlägt die Prüfung fehl, verwirft anny die eingegebenen Daten; fülle in dem Fall beide Felder erneut aus.
  </Accordion>

  <Accordion title="Kann ich sehen, ob ein Schaltbefehl ausgeführt wurde?">
    Ja. Alle ausgeführten und übersprungenen Aktionen werden im Aktivitätsprotokoll der Buchung dokumentiert.
  </Accordion>

  <Accordion title="Welche Shelly-Geräte werden unterstützt?">
    Alle WLAN-fähigen Shelly-Schaltrelais, die über die Shelly Cloud API erreichbar sind. In der Schalter-Auswahl erscheinen nur Geräte der Kategorie Relais (keine Sensoren o. Ä.); Geräte mit mehreren Schaltkanälen können pro Kanal angesteuert werden. Empfohlen wird das Modell Shelly 1 Gen3.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Mein Schalter reagiert nicht auf Buchungsereignisse">
    Die Integration ist möglicherweise deaktiviert oder die Regel ist nicht korrekt gespeichert. Prüfe, ob der Toggle der Integration aktiv ist und ob die Regel der richtigen Ressource und dem richtigen Schalter zugeordnet ist. Kontrolliere außerdem, ob der Shelly-Schalter im WLAN erreichbar ist.
  </Accordion>

  <Accordion title="Die Authentifizierung schlägt fehl">
    Stelle sicher, dass die Shelly URL mit `https://` beginnt und der API-Schlüssel korrekt aus dem Shelly-Konto kopiert wurde. Prüfe, ob dein Shelly-Konto aktiv und die Geräte registriert sind. Beachte: Solange die Integration aktiv ist, lassen sich die Zugangsdaten nicht ändern. Deaktiviere sie zuerst über den **Toggle**.
  </Accordion>

  <Accordion title="Das Licht geht am Ende der Buchung nicht aus">
    Prüfe im Aktivitätsprotokoll, ob die Aktion übersprungen wurde. Häufigste Ursache: Es läuft noch eine andere bestätigte Buchung, die denselben Schalter nutzt (z. B. eine nahtlos anschließende Buchung), und anny überspringt das Ausschalten bewusst (Skip-Logik). Ist keine solche Buchung vorhanden, prüfe die Regel (inklusive aktivem Zeitplan) und die Erreichbarkeit des Schalters.
  </Accordion>

  <Accordion title="Ein neu registriertes Gerät erscheint nicht in der Auswahl">
    Die Geräteliste wird für einige Minuten zwischengespeichert. Warte bis zu 5 Minuten und lade die Seite neu. Prüfe außerdem, ob das Gerät im Shelly-Konto registriert und ein Schaltrelais ist, denn andere Gerätetypen erscheinen nicht in der Auswahl.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Shelly ist KEINE Smart-Lock-Integration (kein Zutritt, kein Remote Open). Es handelt sich um eine IoT-Lösung zur Gerätesteuerung (Schaltrelais ein/aus). Für Zutritt siehe die Smart-Lock-Integrationen (Übersicht Smart-Locks).
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **Shelly** → Felder „Shelly URL" + „API-Schlüssel" → Button „Authentifizierung überprüfen". Regeln: gleicher Ort, Panel „Regeln" → „Hinzufügen"; Felder: „Ressource", „Buchungs-Ereignis", „Shelly-Schalter", „Zustand ändern zu", „Aktivitäts-Modus" (+ Start-/Endzeit). Regel-Tabelle mit Spalte „Aktiver Zeitplan". Aktivieren/Deaktivieren: Toggle oben rechts; Löschen: drei Punkte → Löschen.
>
> **Quirks:** (1) Skip-Logik: Das Ausschalten wird übersprungen, solange noch eine andere bestätigte Buchung läuft, deren Ressource per Regel mit demselben Schalter verknüpft ist (nahtlose Folgebuchung oder geteilter Schalter über mehrere Ressourcen); der Schalter bleibt an, bis keine laufende Buchung ihn mehr benötigt. (2) Nur bestätigte Buchungen lösen Schaltaktionen aus. (3) Regeln auf einer übergeordneten Ressource greifen auch für deren Unterressourcen. (4) Geräteliste zeigt nur Relais-Geräte und ist ca. 5 Minuten zwischengespeichert; neue Geräte erscheinen verzögert. (5) Fehlgeschlagene Schaltbefehle werden nicht wiederholt. (6) Schaltbefehle sind gedrosselt (ca. 1 Befehl / 2 Sekunden); bei vielen gleichzeitigen Regeln kommt es zu Verzögerungen von Sekunden. (7) Zugangsdaten lassen sich nur bei deaktivierter Integration ändern; nach fehlgeschlagener Prüfung müssen beide Felder neu eingegeben werden. (8) Aktiver Zeitplan wird in der Zeitzone der Ressource ausgewertet.
>
> **Beziehungen:** Die Auslöser „Buchung ist eingecheckt"/„Buchung ist ausgecheckt" setzen das Check-In-Feature (QR-Code-Ticket der Ressource) voraus, siehe Artikel zu Check-In & Check-Out. Plan-Verfügbarkeit läuft über dasselbe Plan-Feature wie die Smart-Lock-Integrationen (ab Professional-Plan). Aktivitätsprotokoll-Einträge erscheinen in der Buchung („hat  eingeschaltet/ausgeschaltet", „hat das Ausschalten … wegen einer Folgebuchung … ausgesetzt").


# Smart-Lock-Integrationen
Source: https://docs.anny.co/smart-locks-overview

Vergleiche Smart-Lock-Integrationen und automatisiere zeitlich begrenzte Zutritte für Buchungen und Communities.

Smart-Lock-Integrationen verbinden anny mit digitalen Schließsystemen. So erhalten Kund:innen automatisch den passenden Zugang zu gebuchten Räumen oder dauerhaft freigegebenen Bereichen.

<Info>
  Smart-Lock-Integrationen sind ab dem **Professional-Plan** verfügbar.
</Info>

## Wie funktionieren Smart-Lock-Integrationen?

Du verbindest das Schließsystem unter **Integrationen** mit anny und legst Regeln für Ressourcen oder Communities an. anny erstellt daraus die benötigten Zutrittsrechte und berücksichtigt den festgelegten Zugangszeitraum.

Bei einer Buchungsregel verknüpfst du eine **Ressource** mit einem oder mehreren Schlössern. Du bestimmst außerdem, wie lange vor und nach der Buchung der Zugang gültig ist. Wird die Buchung geändert oder storniert, passt anny das Zutrittsrecht entsprechend an.

Bei einer Community-Regel erhalten die Mitglieder einer **Community** Zugang zu den ausgewählten Schlössern. Für Mitglieder, die schon vor dem Einrichten der Regel zur Community gehörten, kannst du fehlende Zutrittsrechte nachträglich erstellen.

### Unterstützte Integrationen

Wähle den Anbieter, um die Voraussetzungen, Einrichtung und Einschränkungen der jeweiligen Integration zu prüfen.

<Columns>
  <Card title="KleverKey" href="/klever-key">
    Zugang per individuellem Link und, je nach Konfiguration, über Remote Open.
  </Card>

  <Card title="SaltoKS" href="/salto-ks">
    Zugang über die SaltoKS App oder einen PIN-Code am Keypad.
  </Card>

  <Card title="Nuki" href="/nuki">
    Zugang über App, Keypad-PIN oder Remote Open.
  </Card>

  <Card title="Comydo" href="/comydo">
    Zugang per QR-Code aus der Buchungsbestätigung.
  </Card>

  <Card title="Dormakaba Exivo" href="/dormakaba-exivo">
    Digitaler Zutritt für angebundene Dormakaba Exivo Schließsysteme.
  </Card>

  <Card title="Dormakaba Resivo" href="/dormakaba-resivo">
    Digitaler Zutritt für angebundene Dormakaba Resivo Schließsysteme.
  </Card>

  <Card title="Dormakaba Exos 9300" href="/dormakaba-exos-9300">
    Digitaler Zutritt für angebundene Exos 9300 Systeme.
  </Card>

  <Card title="UniFi Access" href="/unifi">
    On-Premise-Zutritt für bestehende UniFi Access Umgebungen.
  </Card>

  <Card title="KeyCafe" href="/keycafe">
    Verwalte die Schlüsselübergabe passend zu anny Buchungen.
  </Card>

  <Card title="EVVA AirKey" href="/evva-airkey">
    Zugang über einen per SMS bereitgestellten Link zur EVVA App.
  </Card>

  <Card title="Tapkey" href="/tapkey">
    Zugang über die Tapkey App mit der Buchungs-E-Mail-Adresse.
  </Card>

  <Card title="Glutz eAccess" href="/glutz-eaccess">
    Zeitlich begrenzter Zugang per konfigurierbarem PIN-Code.
  </Card>
</Columns>

### Zugangsmethoden

Welche Zugangsmethode verfügbar ist, hängt vom Schließsystem und dessen Konfiguration ab.

| Zugangsmethode | Funktionsweise |
| - | - |
| Remote Open | Tür per Button in anny öffnen |
| PIN-Code | Code am Keypad vor Ort eingeben |
| Anbieter-App | Schloss mit der App des Anbieters öffnen |
| Link | Persönlichen Zugangslink aus E-Mail oder SMS öffnen |
| QR-Code | Code aus Buchungsbestätigung oder App scannen |
| Persönlicher Badge | Hinterlegten Badge an der Tür nutzen (Resivo) |
| Kennzeichen | Zufahrt per automatischer Kennzeichenerkennung |

### Remote Open

Mit **Remote Open** öffnen Kund:innen ein unterstütztes Türschloss per Knopfdruck. Der Button kann auf der anny Homepage und in der Buchungsansicht erscheinen. Bei Community-Zugängen muss Remote Open in den Community-Berechtigungen der Smart-Lock-Integration aktiviert sein.

Unterstützt wird Remote Open laut aktuellem Produktstand von KleverKey, Nuki, SaltoKS, Glutz eAccess, UniFi und Resivo. Bei Nuki musst du eine bereits eingerichtete Integration für diese Funktion neu autorisieren. Bei Resivo aktivierst du **Fernöffnung verwenden** in der jeweiligen Regel.

## Wann nutze ich das?

Smart-Lock-Integrationen eignen sich für:

* **Raumvermietung:** Kund:innen erhalten nur für ihre Buchungszeit Zutritt.
* **Coworking:** Mitglieder öffnen dauerhaft freigegebene Bereiche über ihre Community.
* **Büros:** Mitarbeitende betreten gebuchte Räume ohne Schlüsselübergabe.
* **Unbeaufsichtigte Standorte:** Zutritte funktionieren ohne Personal vor Ort.

Nicht geeignet für: rein mechanische Schlösser oder Systeme ohne unterstützte Schnittstelle zu anny.

## Zusammenhang mit anderen Features

**Communities** können dauerhafte Zutritte für ausgewählte Mitglieder auslösen. Die Community-Regel legt fest, welche Schlösser die Mitglieder öffnen dürfen. Bei Tapkey ist das nachträgliche Erstellen fehlender Zutrittsrechte für bestehende Community-Mitglieder nicht verfügbar.

## Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Ressource | Löst bei Buchung einen Zugang aus |
| Schloss oder Bereich | Bestimmt die freigegebenen Zugangspunkte |
| Zugang vor der Buchung | Öffnet den Zugang schon vor Buchungsbeginn |
| Zugang nach der Buchung | Verlängert den Zugang über das Buchungsende hinaus |
| Zugangsmethode | Aktiviert verfügbare App-, PIN- oder Link-Zugänge |
| Remote Open | Erlaubt das Öffnen direkt über anny |

Die verfügbaren Einstellungen unterscheiden sich je nach Anbieter. Prüfe deshalb immer den verlinkten Integrationsartikel.

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Zeitbegrenzten Zugang durch eine Buchung einrichten" />

  <Accordion title="Dauerhaften Zugang für Community-Mitglieder einrichten" />
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Ab welchem Plan kann ich Smart-Lock-Integrationen nutzen?">
    Smart-Lock-Integrationen sind ab dem Professional-Plan verfügbar.
  </Accordion>

  <Accordion title="Wann können Kund:innen ein Schloss öffnen?">
    Bei Buchungszugängen gilt der konfigurierte Buchungszeitraum inklusive der eingestellten Zeit für den Zugang vor und nach der Buchung.
  </Accordion>

  <Accordion title="Was passiert mit dem Zugang bei einer Stornierung?">
    anny entzieht den durch die Buchung erstellten Zugang automatisch.
  </Accordion>

  <Accordion title="Brauchen Kund:innen immer eine Anbieter-App?">
    Nein. Je nach Integration stehen PIN-Code, QR-Code, Link oder Remote Open ohne separates Anbieter-Konto zur Verfügung.
  </Accordion>

  <Accordion title="Wo sehe ich die Zutrittsrechte einer Buchung?">
    Öffne die Buchungsdetails. Dort siehst du aktive und inaktive Zutritte sowie verfügbare Angaben zu Status, Zeitraum, Schloss und Zugangsdaten.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Für meine Buchung wurde kein Zugang erstellt">
    Prüfe, ob die Integration aktiv ist und eine Regel die gebuchte Ressource mit dem richtigen Schloss verbindet. Kontrolliere danach den Status in den Buchungsdetails.
  </Accordion>

  <Accordion title="Der Zugang funktioniert noch nicht">
    Prüfe den Buchungsbeginn sowie die eingestellte Zeit für den Zugang vor der Buchung. Bei App-Zugängen muss die verwendete E-Mail-Adresse mit der Buchungsadresse übereinstimmen.
  </Accordion>

  <Accordion title="Ein Community-Mitglied hat keinen Zugang">
    Prüfe die Mitgliedschaft und die Community-Regel. Erstelle anschließend fehlende Zutrittsrechte für bestehende Mitglieder, sofern der Anbieter dies unterstützt.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> UI-Pfad: Menüleiste → Integrationen → jeweilige Smart-Lock-Integration; Regeln unter „Zugang durch Buchungen" und „Zugang durch Communities". Feldnamen: „Zugang vor der Buchung", „Zugang nach der Buchung", „Fernöffnung verwenden", „Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen". Buchungsänderung → Zugangszeitraum aktualisieren. Stornierung oder Löschung → buchungsbezogenen Zugang entziehen.
>
> Zugangsstatus (UI-Labels): „Geplant" = Zugang wird erst kurz vor Beginn beim Schließsystem angelegt, „In Bearbeitung" = vom Schließsystem noch nicht vergeben, „Erfolgreich" = im Zeitfenster nutzbar, „Entfernt" = kein Zugriff; weitere: „Aufräumen", „Fehlgeschlagen", „Nicht autorisiert", „Unbestätigt". Der Öffnen-Button für Kund:innen heißt „Schloss entsperren".
>
> Zugangsmethoden sind anbieterabhängig: Remote Open, PIN-Code, Anbieter-App, Link, QR-Code, persönlicher Badge (Resivo) oder Kennzeichenerkennung. Remote Open unterstützen KleverKey, Nuki, SaltoKS, Glutz eAccess, UniFi, Resivo und Custom Remote Open (NICHT EVVA AirKey, EVVA nutzt nur App-Zugang per SMS-Link). Resivo: Dropdown **Zugangsart** plus optional **Fernöffnung verwenden**. Kennzeichenerkennung ist Comydo-spezifisch. Bei Nuki erfordert Remote Open eine erneute Autorisierung bestehender Integrationen. Bei Tapkey ist Community-Zugang noch nicht implementiert (Community-Regeln speicherbar, es entstehen aber keine Zugänge). iLOQ ist eine weitere Zutritts-Integration im selben Feature, aktuell ohne eigenen Artikel. Custom Remote Open (Fernöffnung über eine eigene Endpunkt-URL, kein Hersteller-Produkt) hat einen eigenen Artikel „Custom Remote Open mit anny verbinden".


# Mit SSO bei anny anmelden
Source: https://docs.anny.co/sso-login

Warum die Anmeldung über den Login deiner Organisation läuft und wie du dich als Endnutzer:in per SSO anmeldest.

Wenn deine Organisation Single-Sign-On (SSO) nutzt, meldest du dich bei anny mit demselben Login an wie bei anderen Unternehmensdiensten, zum Beispiel Microsoft 365 oder Google Workspace. Du gibst dein Firmenpasswort nicht bei anny ein.

## Warum lande ich auf einer anderen Anmeldeseite?

anny speichert das Passwort deines Unternehmenskontos nicht. Die Anmeldung gehört dem **Identity Provider** (IdP) deiner Organisation, also dem System, das eure Benutzerkonten verwaltet.

Der Ablauf sieht so aus:

1. Du klickst auf der Buchungsseite auf **Einloggen**.
2. anny öffnet den Login deiner Organisation (zum Beispiel Microsoft, Google oder ein anderer IdP).
3. Du meldest dich dort mit deinem Unternehmenskonto an.
4. Der IdP bestätigt gegenüber anny, wer du bist. Danach landest du wieder auf der Buchungsseite, angemeldet.

Das ist beabsichtigt und kein Phishing: Die Adresse der Anmeldeseite gehört zu deiner Organisation bzw. zu deren IdP, nicht zu einem anny-Passwortformular.

<Info>
  Admins richten SSO unter **Account-Einstellungen** → **SSO & Sicherheit** ein. Die technische Übersicht steht unter [SSO Übersicht](/sso-overview).
</Info>

## So meldest du dich an

<Steps>
  <Step title="Einloggen öffnen">
    Öffne die Buchungsseite deiner Organisation und klicke auf **Einloggen**.
  </Step>

  <Step title="Anbieter wählen, falls mehrere Buttons erscheinen">
    Ist deine Community mit einem Identity Provider verknüpft, siehst du einen Button wie **Einloggen (Name der Community)**. Gibt es Communities ohne SSO, bleibt zusätzlich der normale anny-Login sichtbar.
  </Step>

  <Step title="Beim Unternehmenslogin anmelden">
    Melde dich auf der Seite deines Identity Providers mit deinem Unternehmenskonto an. Nach erfolgreicher Anmeldung kehrst du zu anny zurück.
  </Step>
</Steps>

Sobald du angemeldet bist, gelten deine Community-Zugänge, Buchungen und dein [Profil](/user-profile-settings) wie bei jedem anderen anny-Konto.

<Tip>
  Manche Organisationen hinterlegen einen **Standard-Identitätsanbieter**. Dann wirst du nach **Einloggen** direkt zum Unternehmenslogin weitergeleitet, ohne vorher eine Domain einzugeben.
</Tip>

## Was du in anny nicht selbst einrichtest

Als Endnutzer:in verbindest du keinen Identity Provider. Das macht deine Organisation. Du nutzt nur den Login, den sie freigeschaltet hat.

Typische Anbieter sind Microsoft Entra ID (Microsoft 365), Google Workspace oder ein anderer SAML- bzw. OAuth2-IdP. Details für Admins: [Microsoft SAML SSO](/microsoft-saml-sso), [Google Workspace SSO](/google-workspace-sso), [OAuth2 SSO](/oauth2-sso).

## Einschränkungen

* **Kein anny-Passwort für das Firmenkonto:** Dein Unternehmenspasswort bleibt beim IdP. In anny kannst du es nicht ändern.
* **E-Mail im Profil:** Bei SSO-Anmeldung ist die E-Mail-Adresse in den [persönlichen Informationen](/user-profile-settings) nicht änderbar.
* **Kein Zwang für alle:** anny hat keine Einstellung „nur SSO“. Existieren Communities ohne IdP, bleibt der normale anny-Login (E-Mail und Passwort, Passkey, Google oder Apple) verfügbar.

## FAQ

<AccordionGroup>
  <Accordion title="Ist die Weiterleitung zu Microsoft oder Google ein Fehler?">
    Nein. SSO bedeutet genau das: anny prüft nicht selbst dein Firmenpasswort, sondern vertraut der Bestätigung deines Identity Providers.
  </Accordion>

  <Accordion title="Warum sehe ich mehrere Einloggen-Buttons?">
    Jede Community mit eigenem Identity Provider bekommt einen eigenen Button, zum Beispiel **Einloggen (Name der Community)**. Der Button ohne Klammer ist der normale anny-Login, falls mindestens eine Community keinen IdP hat.
  </Accordion>

  <Accordion title="Kann ich mich trotzdem mit E-Mail und Passwort anmelden?">
    Ja, wenn deine Organisation das nicht über den Standard-Identitätsanbieter erzwingt und Communities ohne IdP existieren. Ob der normale Login sichtbar ist, entscheidet die Organisation.
  </Accordion>

  <Accordion title="Ich komme nach dem Login nicht zurück zu anny">
    Schließe den Vorgang vollständig im Fenster des Identity Providers ab. Pop-up-Blocker können die Rückkehr verhindern. Admins prüfen außerdem, ob der Identity Provider aktiviert ist. Siehe [SSO Übersicht](/sso-overview).
  </Accordion>

  <Accordion title="Die Anmeldeseite zeigt anny.co, meine Organisation liegt auf anny.eu">
    Unten auf der anny-Anmeldeseite öffnest du **Datenregion deines Kontos** und wechselst zu **anny.eu**. Danach meldest du dich wie gewohnt an. Die Regionen haben getrennte Konten. Wenn deine Organisation einen Standard-Identitätsanbieter setzt, wirst du oft direkt zum Unternehmenslogin weitergeleitet und siehst diesen Schalter nicht — dann muss die Buchungsseite bereits die richtige Region öffnen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Anmeldeseite sieht nicht nach anny aus">
    Das ist bei SSO normal. Du solltest die bekannte Login-Seite deiner Organisation sehen (Microsoft, Google oder euer IdP). Wenn die Adresse unbekannt wirkt, brich ab und wende dich an deine IT.
  </Accordion>

  <Accordion title="Ich werde nicht zum Unternehmenslogin weitergeleitet">
    Deine Community ist möglicherweise nicht mit einem Identity Provider verknüpft, oder es ist kein Standard-Identitätsanbieter gesetzt. Nutze den Button **Einloggen (Community)** oder bitte deine Admin-Nutzer:innen, SSO zu prüfen.
  </Accordion>

  <Accordion title="Nach dem Login fehlt der Zugang zur Community">
    Die Anmeldung hat geklappt, die Zuordnung zur Community aber nicht. Das steuert eure Organisation über Communities, SCIM oder [Attribute Mapping](/attribute-mapping), nicht über dein Passwort.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Endnutzer-Login läuft über Cognitor (`cognitorBaseUri`, typisch auth.anny.co) mit PKCE/OAuth authorization code. Redirect-URI der Buchungsseite: `{shopBaseUrl}/login/callback`. Extra-Params: `idpUuid`, `entityId`, `register`.
> * Warum „fremde“ Login-Seite: anny speichert kein IdP-Passwort. Der IdP authentifiziert, Cognitor stellt Tokens aus, die Shop-App tauscht den Code.
> * Community `idpUuid` / `idp_uuid`: erzeugt branded Button `Einloggen ({community.name})` via `useLoginMethods`. Communities ohne IdP → zusätzlicher nativer Button `Einloggen`.
> * Org-Setting **Standard-Identitätsanbieter für die Anmeldung** (`idpUuid` in Account-Einstellungen / Buchungsseite): Auto-Redirect zum IdP, ohne Domain-Eingabe auf der Cognitor-Login-Seite. Shop-Config `public.idpUuid`.
> * Datenregion-Schalter (Cognitor #9): Footer **Datenregion deines Kontos** auf /login und /register, nur wenn APP\_REGION gesetzt ist (Cloud). Wechsel ist Navigation auf den anderen Host; das laufende OAuth-Request bleibt zurück.
> * Kein `sso_only`-Flag im Code. Native Login (E-Mail/Passwort, Passkey, Google, Apple) bleibt möglich, solange nicht alle relevanten Communities einen IdP haben bzw. kein Default-IdP greift.
> * E-Mail im Profil nicht änderbar bei SSO (`user-profile-settings`).
> * Admin-Artikel: /sso-overview, /microsoft-saml-sso, /google-workspace-sso, /oauth2-sso, /scim-user-provisioning, /attribute-mapping. Dieser Artikel ist Endnutzer-Tab.


# Einführung Lernplatzbuchung
Source: https://docs.anny.co/study-space-booking-intro

Buche deinen Lernplatz an der Universität über die anny App oder im Browser: Liste, Karte und Check-In.

Mit anny buchst du deinen Lernplatz in der Universitätsbibliothek schnell und unkompliziert. Du kannst über die Listenansicht oder die interaktive Kartenansicht buchen und dich vor Ort selbst einchecken.

<Tip>
  Lade dir die anny App im [App Store](https://apps.apple.com/us/app/anny/id6448261664) oder [Play Store](https://play.google.com/store/apps/details?id=co.anny.app) herunter. Achte bei der Anmeldung darauf, dass du die richtige Datenregion ausgewählt hast (meistens EU+).
</Tip>

## Lernplatz buchen über die Listenansicht

<Steps>
  <Step title="Erkunden öffnen">
    Öffne die anny App oder die Buchungsseite im Browser und gehe zu **Entdecken**.
  </Step>

  <Step title="Datum und Zeit festlegen">
    Tippe oben in die **Datums- und Zeitangabe** und lege fest, wann du deinen Lernplatz brauchst. Du hast zwei Optionen:

    * **Dauer angeben:** Gib unter Dauer die gewünschte Stundenzahl ein (z. B. 3 Stunden). anny zeigt dir dann alle Plätze, die irgendwann am gewählten Tag für diese Dauer verfügbar sind.
    * **Exakten Zeitraum wählen:** Definiere eine feste Start- und Endzeit und stelle die Dauer auf **Vollständiger Zeitraum**. So siehst du nur Plätze, die exakt in diesem Fenster frei sind.
  </Step>

  <Step title="Lernplatz auswählen und buchen">
    Such dir einen freien Zeitslot deines favorisierten Lernplatzes aus und klicke auf **Abschließen**.
  </Step>
</Steps>

## Lernplatz buchen über die Kartenansicht

<Steps>
  <Step title="Erkunden öffnen">
    Öffne die anny App oder die Buchungsseite und gehe zu **Entdecken**.
  </Step>

  <Step title="Datums- und Zeitfilter setzen">
    Lege im Datums- und Zeitfilter fest, wann du lernen willst.
  </Step>

  <Step title="Platz auf der Karte auswählen">
    Scrolle über die interaktive Karte, tippe deinen Lieblingsplatz an und klicke auf **Jetzt buchen**.
  </Step>

  <Step title="Buchung bestätigen">
    Prüfe deine Buchung in der Übersicht und bestätige mit **Abschließen**.
  </Step>
</Steps>

## Check-In mit Standortvalidierung

Viele Universitäten nutzen den Self-Check-In mit Standortvalidierung. So checkst du dich vor Ort selbst ein:

<Steps>
  <Step title="Standort freigeben">
    Aktiviere in den Handy-Einstellungen für die anny App die Funktion **Genauen Standort anzeigen** (iOS) bzw. **Genauen Standort verwenden** (Android).
  </Step>

  <Step title="Einchecken">
    Öffne deine Buchung in der App und tippe auf **Einchecken**. anny prüft automatisch, ob du dich am richtigen Standort befindest.
  </Step>
</Steps>

<Warning>
  Ohne aktivierten genauen Standort kann der Check-In fehlschlagen. Stelle sicher, dass die Berechtigung vor dem Check-In erteilt ist.
</Warning>

## Wochenplaner nutzen

Favorisiere deine Lieblingsplätze unter **Entdecken** und plane deine Lernwoche im **Planer**. Dort siehst du alle favorisierten Ressourcen in der Wochenansicht und buchst mit wenigen Klicks.

## Dein Profil

Alle Einstellungen rund um dein Profil (Name, E-Mail, Passwort, Benachrichtigungen, Communities) findest du im Artikel [Nutzerprofil & Einstellungen](/user-profile-settings).

<AccordionGroup>
  <Accordion title="Ich finde keinen freien Lernplatz">
    Versuche, den Zeitfilter anzupassen: Wähle einen anderen Tag oder eine kürzere Dauer. In Stoßzeiten sind Plätze schnell vergeben.
  </Accordion>

  <Accordion title="Mein Check-In schlägt fehl">
    Prüfe, ob du den genauen Standort für die anny App aktiviert hast. Stelle außerdem sicher, dass du dich innerhalb des Gebäudes befindest und GPS-Empfang hast.
  </Accordion>

  <Accordion title="Welche Datenregion muss ich auswählen?">
    Die meisten deutschen Universitäten nutzen die Region **EU+**. Wenn du unsicher bist, frage bei deiner Bibliothek nach.
  </Accordion>

  <Accordion title="Kann ich meinen Lernplatz stornieren?">
    Ja, öffne unter **Buchungen** die entsprechende Reservierung und tippe auf **Stornieren**. Beachte eventuelle Stornierungsfristen deiner Universität.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Zielgruppe: Studierende an Universitäten mit anny Lernplatzbuchung
> * Datenregion bei Login: fast immer EU+ für DACH-Universitäten
> * Check-In mit Standortvalidierung: muss vom Admin pro Ressource aktiviert sein. Endnutzer:in muss "Genauen Standort" in den Geräteeinstellungen erlauben
> * Ganztag-Option: Abhängig von der Zeitplan-Konfiguration der Bibliothek (z. B. 6:00 bis 23:00 Uhr)
> * Communities: Studierende sind meist automatisch einer Uni-Community zugeordnet (SSO/Shibboleth)
> * Verwandter Artikel für Admins: Check-In Terminal > Universitätsbibliothek


# Support Policy
Source: https://docs.anny.co/support-policy



## Wer kann den Support kontaktieren?

Support ist für zahlende Organisationen verfügbar. Melde dich immer als **Organisation** (Admin-Account), nicht als Endkund:in.

<Warning>
  anny bietet keinen direkten Support für Endkund:innen deiner Organisation. Wenn deine Kund:innen Fragen zu einer Buchung haben, wende dich bitte selbst an unser Team und leite die Antwort weiter.
</Warning>

## Statusseite

Aktuelle Informationen zur Verfügbarkeit und zu Störungen unserer Systeme findest du auf unserer Statusseite:

co.-Datenbank: [https://status.anny.co/](https://status.anny.co/) <br />eu.-Datenbank: [https://status.anny.eu/](https://status.anny.eu/)

## Kanäle

| Kanal | Verfügbarkeit | Beschreibung |
| - | - | - |
| **Emma (KI-Assistenz)** | Alle Pläne, 24/7 | Unsere KI-Assistenz beantwortet Fragen rund ums Produkt sofort und jederzeit. Erreichbar über das Hilfe-Widget im Admin-Bereich. |
| **E-Mail** | Ab Essential | Schreibe an [support@anny.co](mailto:support@anny.co). Du erhältst zunächst eine automatische Antwort von Emma. Wenn das nicht reicht, wird dein Anliegen an das Support-Team weitergeleitet. |
| **Telefon** | Ab Business | Telefonischer Support für komplexe Anliegen. Verfügbar zu den Geschäftszeiten (Mo bis Fr, 9:00 bis 17:00 Uhr CET). |
| **Dedizierter Ansprechpartner** | Enterprise | Persönliche:r Account Manager:in mit direktem Draht. |

## Support pro Plan

| | Free/Trial | Essential | Professional | Business | Enterprise |
| - | - | - | - | - | - |
| Emma (KI-Assistenz) | ✓ | ✓ | ✓ | ✓ | ✓ |
| E-Mail-Support | | ✓ | ✓ | ✓ | ✓ |
| Reaktionszeit (Menschlicher Support) | | 48h | 24h | 12h | 8h |
| Telefon-Support | | | | ✓ | ✓ |
| Dedizierter Ansprechpartner | | | | | ✓ |
| Onboarding-Begleitung (kostenpflichtig) | | ✓ | ✓ | ✓ | inklusive |

## Was ist im Support enthalten?

Unser Support umfasst:

* Fragen zur Nutzung und Konfiguration von anny
* Hilfe bei Abrechnungs- und Zahlungsproblemen
* Fehlermeldungen und Plattform-Bugs
* Unterstützung bei Account- und Benutzerverwaltung
* Hilfe bei Integrationen (Kalender, SSO, Smart Locks, HR-Tools)
* Workarounds für bekannte Einschränkungen

## Was ist nicht im Support enthalten?

Folgendes liegt außerhalb unseres Support-Umfangs:

* **Einrichtung und Konfiguration**: Die initiale Einrichtung deines Accounts ist nicht im Support enthalten. Wir bieten kostenpflichtige Onboarding-Pakete an, die dich bei der Ersteinrichtung begleiten. Sprich uns bei Interesse an.
* **Individuelle Anpassungen**: Programmierung oder Konfiguration, die über die Standard-Features hinausgeht.
* **Drittanbieter-Probleme**: Fehler in externen Systemen (z. B. Identity Provider, Smart-Lock-Hardware).
* **Endkunden-Support**: Wir beantworten keine Anfragen von deinen Kund:innen direkt. Support läuft immer über den Admin-Account der Organisation.

<Tip>
  Du möchtest Hilfe bei der Ersteinrichtung? Unsere kostenpflichtigen Onboarding-Pakete beinhalten persönliche Begleitung, Setup-Review und Best-Practice-Beratung. Kontaktiere uns unter [support@anny.co](mailto:support@anny.co) für ein Angebot.
</Tip>

## Emma: Deine KI-Assistenz

Emma ist unsere KI-gestützte Support-Assistenz und dein erster Anlaufpunkt für alle Fragen rund um anny. Sie kennt das gesamte Help Center und beantwortet Produktfragen sofort, rund um die Uhr.

So erreichst du Emma:

* Über den **Support-Chat Button** im Admin-Bereich
* Per E-Mail an [support@anny.co](mailto:support@anny.co) (erste Antwort kommt automatisch von Emma)

Wenn Emma deine Frage nicht lösen kann, leitet sie dich automatisch an das menschliche Support-Team weiter.

## So meldest du ein Problem

Damit wir dir schnell helfen können, gib bitte folgende Infos an:

1. **Deine Organisation** (Account-Name oder URL deiner Buchungsseite)
2. **Beschreibung des Problems** (Was passiert? Was erwartest du stattdessen?)
3. **Schritte zur Reproduktion** (Welche Klicks führen zum Problem?)
4. **Screenshots oder Bildschirmaufnahmen** (falls vorhanden)
5. **Betroffene Ressource/Buchungsoption** (falls relevant)

<Info>
  Bei Systemstörungen informieren wir proaktiv über unsere [Status-Seite](https://status.anny.co).
</Info>


# tapirx mit anny verbinden
Source: https://docs.anny.co/tapirx-setup

Verbinde kabellose E-Ink Raumdisplays von tapirx direkt mit anny und zeige Buchungen automatisch an.

[tapirx](https://www.tapirx.com/) ist ein Anbieter für kabellose E-Ink Raumdisplays mit WLAN-Anbindung. anny ist direkt in tapirx integriert: Buchungen werden automatisch auf dem Display angezeigt, ohne Umweg über einen externen Kalender.

Mit tapirx kannst du in anny:

* Buchungen automatisch auf kabellosen E-Ink Displays vor dem Raum anzeigen
* Displays per 6-stelligem Code direkt mit anny-Ressourcen verbinden
* Einen QR-Code auf dem Display anzeigen, über den Kund:innen direkt zur Buchungsseite gelangen

Besonders praktisch ist die Integration für Unternehmen, die Displays ohne Stromversorgung oder Verkabelung an der Wand montieren möchten und eine direkte anny-Anbindung ohne Kalender-Brücke bevorzugen.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Meetingraum-Status ohne Verkabelung anzeigen | **Kabellose Montage in Minuten.** Das E-Ink Display zeigt den Belegungsstatus per WLAN an und hält je nach Aktualisierungsintervall bis zu 2 Jahre ohne Laden. |
| Buchungen direkt per QR-Code ermöglichen | **Schneller Zugang zur Buchungsseite.** Der auf dem Display angezeigte QR-Code führt direkt zur anny-Buchungsseite der Ressource. |
| Große Anzahl an Räumen ohne Infrastruktur ausstatten | **Skalierbar ohne PoE oder Steckdosen.** Ideal für Gebäude, in denen kein Stromanschluss an der Tür verfügbar ist. |

## Wie die tapirx-Verbindung funktioniert

Die Integration läuft direkt zwischen tapirx und anny: Das tapirx-Display kommuniziert über WLAN mit dem tapirx-Server, der die Buchungsdaten von anny abruft. Die Einrichtung erfolgt hauptsächlich im tapirx Client-Admin. In anny wird das Display über einen 6-stelligen Pairing-Code verbunden.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Buchungen | anny → tapirx Display | Konfigurierbar (5–30 Min) |

## tapirx verbinden

### Voraussetzungen

Bevor du tapirx mit anny verbindest, stelle sicher, dass du Folgendes hast:

* Ein tapirx-Konto mit Zugang zum [tapirx Client-Admin](https://www.tapirx.com/user/login)
* Mindestens ein tapirx E-Ink Display, das per WLAN verbunden ist
* Das Feature **Anzeigetafeln & Raumdisplays** in anny aktiviert
* Die Ressource, die angezeigt werden soll, muss in anny angelegt und online sein

### Verbindung einrichten

Sobald die Verbindung aktiv ist, zeigt das tapirx Display automatisch die Buchungen der verknüpften Ressource an.

<Tip>
  Alle Einstellungen wie Aktualisierungsintervall oder Display-Design werden im tapirx Client-Admin vorgenommen, nicht in anny.
</Tip>

### tapirx-Geräte mit WLAN verbinden

<Warning>
  Das Gerät funktioniert nur in 2,4-GHz-Netzen. Stelle sicher, dass dein WLAN auf dieser Frequenz sendet.
</Warning>

### Einstellungen & Optionen

| Einstellung | Wo | Beschreibung |
| - | - | - |
| anny Server (Hostregion) | tapirx Client-Admin → Settings | anny.co oder anny.eu |
| Aktualisierungsintervall | tapirx Client-Admin → Device Settings | 5 bis 30 Minuten |
| QR-Code-Link | tapirx Client-Admin → Device Settings | Buchungslink der anny-Ressource |
| Ressourcen-Zuweisung | tapirx Client-Admin → Devices | Welches Display zeigt welche Ressource |

## Einschränkungen

Die tapirx-Integration unterstützt nicht:

* Echtzeit-Aktualisierung: Daten werden je nach Einstellung alle 5 bis 30 Minuten abgerufen
* Buchung direkt am Display (kein Touchscreen): Buchung erfolgt über den QR-Code auf dem Smartphone
* Ad-hoc-Buchungen oder Gastmodus wie bei der anny Display App
* Sleep Mode oder Helligkeitssteuerung (E-Ink benötigt keinen Strom für die Anzeige)

## FAQ

<AccordionGroup>
  <Accordion title="Wie lange hält der Akku?">
    Die Akkulaufzeit hängt vom Aktualisierungsintervall und der WLAN-Entfernung ab. Bei 30 Minuten Intervall: geschätzt bis zu 2 Jahre. Bei 5 Minuten deutlich kürzer. Ein leerer Akku wird auf dem Display angezeigt und per E-Mail gemeldet.
  </Accordion>

  <Accordion title="Wie setze ich ein tapirx-Display zurück?">
    Neben dem USB-C Anschluss auf der Unterseite befindet sich ein kleines Loch. Führe eine Nadel ein und halte den Knopf 5 Sekunden gedrückt.
  </Accordion>

  <Accordion title="Brauche ich eine Kalender-Integration wie Outlook?">
    Nein. tapirx ist direkt in anny integriert. Es ist kein externer Kalender als Brücke nötig (Abgrenzung zu Joan oder Roomz).
  </Accordion>

  <Accordion title="Kann ich das Display auch ohne anny nutzen?">
    Ja, tapirx unterstützt auch Outlook und Google Kalender als Datenquelle. Für die direkte anny-Integration ist jedoch kein Kalender nötig.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Das Display zeigt nach dem Submit einen Fehler an">
    Die WLAN-Verbindung konnte nicht hergestellt werden. Prüfe, ob das Netzwerk auf 2,4 GHz sendet und ob Netzwerkname und Passwort korrekt sind. Versuche es erneut über [http://192.168.4.1](http://192.168.4.1).
  </Accordion>

  <Accordion title="Buchungen werden nicht auf dem Display angezeigt">
    Prüfe im tapirx Client-Admin, ob das Pairing mit anny erfolgreich war (Device → Status). Stelle sicher, dass die Ressource in anny online ist und das Feature "Anzeigetafeln & Raumdisplays" aktiviert ist. Beachte: Es kann bis zu 30 Minuten dauern, bis neue Buchungen erscheinen.
  </Accordion>

  <Accordion title="Der QR-Code führt auf eine falsche Seite">
    Der QR-Code-Link muss manuell im tapirx Client-Admin gepflegt werden. Prüfe unter **Device Settings**, ob der korrekte Buchungslink aus anny (**Ressource** → **Buchungsseite** → **Buchungslink**) hinterlegt ist.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * tapirx hat eine DIREKTE anny-Integration (kein Kalender als Brücke nötig)
> * Einrichtung passiert hauptsächlich im tapirx Client-Admin ([https://www.tapirx.com/user/login](https://www.tapirx.com/user/login))
> * Pairing: 6-stelliger Code, generiert im tapirx Portal unter Devices → Pair with anny.co, eingegeben in anny unter Displays → Display koppeln
> * Hostregion: Für anny.eu Kunden muss im tapirx Client-Admin unter Settings → Client Settings → anny server die Domain auf anny.eu geändert werden
> * Aktualisierung: NICHT Echtzeit, sondern alle 5–30 Minuten (konfigurierbar im tapirx Admin)
> * Kein Touchscreen: Buchung nur über QR-Code auf dem Smartphone
> * WLAN: Nur 2,4 GHz
> * Akku: Bis zu 2 Jahre bei 30 Min Intervall, abhängig von WLAN-Entfernung
> * Reset: Nadel in kleines Loch neben USB-C, 5 Sek halten
> * Abgrenzung Joan: Joan = über Outlook/Google als Brücke, Touch-Buchung am Display möglich
> * Abgrenzung anny Display App: Direkte anny-App auf Tablet, Echtzeit, Touch, Ad-hoc, anny Pass, NFC
> * Product Update Quelle: Task "Tapirx Displays - Product Update" (09/2024)


# Tapkey mit anny verbinden
Source: https://docs.anny.co/tapkey

Vergib bei jeder Buchung automatisch App-Zugänge für deine Tapkey-Schlösser und spare dir die Schlüsselübergabe.

[Tapkey](https://www.tapkey.com/) ist ein Smart-Lock-System, das Türschlösser über eine App per Smartphone steuert. Mit der Integration vergibt anny bei Buchungen automatisch Zugangsrechte in der Tapkey App, sodass Kund:innen das Schloss im gebuchten Zeitraum öffnen können.

Mit tapkey kannst du in anny:

* Buchungsbasierte Zugänge mit Zeit vor und nach der Buchung automatisch erstellen
* Mehrere Schlösser mit einer Ressource verknüpfen (oder umgekehrt)
* Den Zugangsstatus direkt in der Buchung einsehen

Besonders praktisch ist die Integration für kleine Coworking-Spaces und Büros, die ihren Kund:innen einen schlüssellosen Zugang per App ermöglichen möchten.

<Info>
  Verfügbar ab Professional-Plan.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Coworking-Räume per App öffnen | **Kund:innen erhalten nach der Buchung automatisch Zugangsrechte in der Tapkey App.** Kein Schlüssel, kein Code: Das Smartphone reicht. |
| Büroräume mit Zeitfenster absichern | **Der Zugang ist exakt auf den Buchungszeitraum begrenzt.** Nach Ablauf wird die Berechtigung automatisch entfernt, ohne dass du eingreifen musst. |
| Mehrere Türen pro Buchung freischalten | **Du kannst mehrere Schlösser mit einer Ressource verknüpfen.** So erhalten Kund:innen z. B. Zugang zum Haupteingang und zum gebuchten Raum in einem Schritt. |

## Wie die tapkey-Verbindung funktioniert

Die Integration nutzt OAuth: Du meldest dich mit deinem Tapkey-Besitzerkonto an und autorisierst anny, Zugangsrechte für deine Schlösser zu vergeben und zu entfernen. anny erstellt bei jeder Buchung eine Berechtigung in der Tapkey Cloud, die dem/der Kund:in über die E-Mail-Adresse zugewiesen wird.

Kund:innen öffnen das Schloss anschließend über die Tapkey App. Es wird kein separater Zugangslink und kein Pin versendet.

Wenn du die Autorisierung in deinem Tapkey-Konto widerrufst, verliert anny den Zugriff. Du musst die Integration in anny dann erneut autorisieren.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Zugangsrechte (erstellen/entfernen) | anny → Tapkey | Bei Buchung/Stornierung; Serientermine etwa 48 h vorher |
| Schlösser (Liste) | Tapkey → anny | Bei Regelkonfiguration |

Bei Einzelbuchungen wird der Zugang sofort erstellt. Bei Serien- und wiederkehrenden Buchungen plant anny den Zugang pro Termin etwa 48 Stunden vorher ein. Bis dahin steht er auf dem Status **Geplant**.

## tapkey verbinden

### Voraussetzungen

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

* Ein Tapkey-Besitzerkonto mit mindestens einem eingerichteten Schloss
* Das Schloss ist im [Tapkey Adminbereich](https://my.tapkey.com/) hinterlegt und online
* anny Professional-Plan oder höher

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Tapkey**. Klicke auf **Autorisieren** und melde dich mit deinem **Tapkey-Besitzerkonto** an. Damit gibst du anny die Berechtigung, Zugangsrechte für deine Schlösser zu verwalten.
  </Step>

  <Step title="Konfigurieren">
    Lege deine Besitzerkonten und Regeln fest:

    1. Wähle über **Besitzerkonto hinzufügen** das Tapkey-Besitzerkonto aus, für das du Regeln anlegen möchtest
    2. Prüfe unter **Zeitzone auswählen**, welche Zeitzone Tapkey für die Zugangszeiträume verwendet
    3. Klicke auf **Regel hinzufügen**, um eine neue Regel zu erstellen
    4. Wähle die **Ressource** aus, die bei Buchung Zugang geben soll
    5. Wähle unter **Zylinder auswählen** ein oder mehrere Schlösser aus
    6. Lege **Zugang vor der Buchung** und **Zugang nach der Buchung** fest (Minuten vor und nach der Buchung)
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, werden Zugangsrechte automatisch bei neuen Buchungen erstellt und bei Stornierungen entfernt.

<Tip>
  Du kannst mehrere Schlösser mit einer Ressource verknüpfen oder ein Schloss mit mehreren Ressourcen. Bestehende Regeln bearbeitest du direkt in der Liste. Zum Löschen nutzt du das Löschsymbol neben der Regel und bestätigst.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| Zugang vor der Buchung | Minuten, die der Zugang vor Buchungsbeginn aktiv ist |
| Zugang nach der Buchung | Minuten, die der Zugang nach Buchungsende aktiv bleibt |
| Zylinder auswählen | Ein oder mehrere Tapkey-Schlösser pro Regel |
| Zeitzone | Zeitzone, die Tapkey für die Zugangszeiträume verwendet |

## Buchungsprozess für Kund:innen

So erleben deine Kund:innen die Integration:

<Steps>
  <Step title="Raum buchen">
    Kund:innen buchen eine Ressource über anny.
  </Step>

  <Step title="Zugangsrechte erhalten">
    anny erstellt automatisch eine Berechtigung in der Tapkey Cloud. Kund:innen erhalten eine Buchungsbestätigung per E-Mail.
  </Step>

  <Step title="Schloss öffnen">
    Kund:innen melden sich in der **Tapkey App** mit ihrer E-Mail-Adresse an. Dort sehen sie, auf welche Schlösser sie Zugriff haben und für welche Zeitfenster. Per Tap auf das Schloss wird die Tür geöffnet.
  </Step>
</Steps>

<Tip>
  Kund:innen benötigen die Tapkey App (iOS/Android). Der Download-Link kann in der Buchungsbestätigung hinterlegt werden.
</Tip>

## Zugänge im Adminbereich einsehen

Im Bereich **Smartlock Zugänge** einer Buchung werden aktive und inaktive Zugänge angezeigt. Klicke auf einen Zugang, um Details wie **Zugang beginnt am**, **Zugang endet am**, **Türschloss** und **Erstellt am** einzusehen:

| Status | Bedeutung |
| - | - |
| In Bearbeitung | Der Zugang wurde von anny angefordert, aber noch nicht vom Schließsystem bestätigt |
| Geplant | Die Erstellung ist geplant (Serien- und zukünftige Termine); der Zugang wird kurz vor dem Termin erstellt |
| Erfolgreich | Der Zugang ist aktiv und Kund:innen können das Schloss im definierten Zeitraum öffnen |
| Fehlgeschlagen | Der Zugang konnte nicht erstellt werden, zum Beispiel weil ein Limit erreicht ist |
| Entfernt | Der Zugang wurde vom System oder einer Person entfernt |

<Tip>
  Über die **drei Punkte** in der Zugangsdetailansicht kannst du den Zugang über **Zugang beim Anbieter anzeigen** direkt in Tapkey öffnen oder über **Integrationseinstellungen** zu den Einstellungen in anny navigieren.
</Tip>

## Einschränkungen

Die tapkey-Integration unterstützt nicht:

* Remote Open (Türöffnung direkt aus anny heraus): Kund:innen öffnen das Schloss ausschließlich über die Tapkey App
* Community-Zugänge: Der Zugang wird ausschließlich buchungsbasiert vergeben, Community-Mitglieder erhalten keinen automatischen Zutritt
* Zugangslink per E-Mail: Der Zugang funktioniert ausschließlich über die Tapkey App, nicht über einen Browser-Link
* Mehr als zehn gleichzeitige Berechtigungen pro Schloss: Tapkey-Schlösser verwalten maximal zehn gleichzeitige Berechtigungen. Ist das Limit erreicht, kann anny keine weitere anlegen. Auch Berechtigungen, die du selbst in Tapkey erstellt hast, zählen mit.

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</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 Hardware ist mit Tapkey kompatibel?">
    Alle kompatiblen Schlösser findest du im [Tapkey Shop](https://shop.tapkey.com/de/products/tapkey-smart-lock). Tapkey bietet nachrüstbare Smart-Lock-Zylinder, die sich per DIY installieren lassen.
  </Accordion>

  <Accordion title="Müssen Kund:innen die Tapkey App installieren?">
    Ja. Der Zugang funktioniert ausschließlich über die Tapkey App (iOS und Android). Kund:innen melden sich dort mit der E-Mail-Adresse an, die sie bei der Buchung verwendet haben.
  </Accordion>

  <Accordion title="Was passiert bei einer Stornierung?">
    Bei Stornierung der Buchung wird das Zugangsrecht automatisch entfernt. Kund:innen sehen das Schloss dann nicht mehr in ihrer Tapkey App.
  </Accordion>

  <Accordion title="Wie viele gleichzeitige Zugänge sind pro Schloss möglich?">
    Tapkey-Schlösser verwalten maximal zehn gleichzeitige Berechtigungen. Dazu zählen auch Berechtigungen, die du selbst in Tapkey erstellt hast. Ist das Limit absehbar erreicht, kann ein kürzerer Vorausbuchungszeitraum helfen, die Anzahl gleichzeitiger Zugänge zu senken.
  </Accordion>

  <Accordion title="Entstehen Kosten auf Tapkey-Seite?">
    Ja. Tapkey arbeitet mit Abo-Modellen für Nutzer-Berechtigungen. Der kostenlose Tarif erlaubt nur fünf gleichzeitige Smartphone-Nutzer:innen. Informiere dich bei Tapkey über die Kosten für dein erwartetes Buchungsvolumen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kund:innen sehen kein Schloss in der Tapkey App">
    Die Berechtigung wurde möglicherweise nicht erstellt. Prüfe im Bereich **Smartlock Zugänge** der Buchung den Status. Stelle außerdem sicher, dass die E-Mail-Adresse in der Buchung mit der in der Tapkey App übereinstimmt.
  </Accordion>

  <Accordion title="anny kann keine neue Berechtigung anlegen">
    Wahrscheinlich ist ein Tapkey-Limit erreicht: entweder die maximal zehn gleichzeitigen Berechtigungen pro Schloss oder das Nutzerkontingent deines Tapkey-Tarifs. Entferne nicht mehr benötigte Berechtigungen in Tapkey oder erweitere deinen Tapkey-Tarif.
  </Accordion>

  <Accordion title="Zugang hat eine falsche Zeitzone">
    Prüfe die Einstellung **Zeitzone auswählen** in der Integration. Weicht sie von der in Tapkey hinterlegten Zeitzone ab, verschieben sich die Zeitfenster der Zugänge.
  </Accordion>

  <Accordion title="Autorisierung ist abgelaufen">
    Die OAuth-Verbindung zu Tapkey kann ablaufen. Gehe zu **Integrationen** → **Tapkey** und klicke erneut auf **Autorisieren**, um die Verbindung wiederherzustellen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> UI-Pfad: Menüleiste → Integrationen → Tapkey. Ablauf: erst **Besitzerkonto hinzufügen** (mehrere möglich), optional **Zeitzone auswählen**, dann je Besitzerkonto **Regel hinzufügen**. Regelfelder: **Ressource auswählen**, **Zylinder auswählen** (mehrere Schlösser möglich), **Zugang vor der Buchung**, **Zugang nach der Buchung**. Es gibt KEIN Pin- und KEIN App-Einladungs-Feld; der Zugang ist immer eine Smartphone-App-Berechtigung.
>
> Auth: OAuth über das Tapkey-Besitzerkonto (kein API-Key). Zuordnung des Zugangs über die E-Mail-Adresse der Buchung.
>
> Zeitpunkt der Erstellung: Einzelbuchungen sofort; Serien-/wiederkehrende Buchungen werden pro Termin etwa 48 h vorher erstellt (Status **Geplant**). Nur bestätigte Buchungen lösen Zugänge aus; Anfragen, Ablehnungen, Stornos und interne Blocker nicht. Änderungen an Zeit/Ressource/Status aktualisieren oder entfernen den Zugang automatisch. Regeln vererben auf Unterressourcen. Pro Ressource ist nur eine Regel möglich (Speichern blockiert bei Dublette).
>
> Status-Labels (Bereich **Smartlock Zugänge** einer Buchung): In Bearbeitung, Geplant, Unbestätigt, Erfolgreich, Fehlgeschlagen, Aufräumen, Entfernt, Nicht autorisiert. Detailfelder: Zugang beginnt am, Zugang endet am, Türschloss, Erstellt am, Zugang durch, Status. Aktionen: **Zugang beim Anbieter anzeigen** (öffnet my.tapkey.com), **Integrationseinstellungen**.
>
> Limits: max. zehn gleichzeitige Berechtigungen pro Schloss (inkl. selbst in Tapkey erstellter); kostenloser Tapkey-Tarif max. fünf gleichzeitige Smartphone-Nutzer:innen. Beide Hinweise erscheinen als Infobox in der Integration.
>
> Kein Remote Open (in anny nicht implementiert). Community-Zugänge werden für Tapkey NICHT unterstützt: kein Community-Regel-Editor, kein Backfill-Button „Fehlende Zutrittsrechte für bestehende Community-Mitglieder erstellen".
>
> Verbindung trennen: Deaktivieren behält bestehende Zugänge, erstellt keine neuen. Löschen entfernt die anny-Zugangsdatensätze und Ressourcen-Verknüpfungen, widerruft die Berechtigungen aber nicht aktiv bei Tapkey; bereits erstellte Berechtigungen können bis zu ihrem eigenen Ablauf am Schloss aktiv bleiben.
>
> Beziehung: Teil der anny Smart-Lock-Integrationen (Feature INTEGRATIONS\_SMART\_LOCKS), gemeinsames Access-Control-System mit u. a. Nuki, Salto, Iloq. Offizielle Schreibweise der Marke: „Tapkey".


# Nutzungsbedingungen
Source: https://docs.anny.co/terms-of-use

Die allgemeinen Nutzungsbedingungen für Endkund:innen der anny Plattform.

*Version vom 26.03.2021*

Diese Nutzungsbedingungen richten sich an Endkunden bzw. buchende Nutzer.

*If copies of these GTC have been made in languages other than German, only the German version is binding for anny and the provider.*

[anny GmbH](https://anny.co/imprint) bietet für Endkunden die Möglichkeit, auf der bereitgestellten Plattform die von Anbietern eingestellten Ressourcen zu buchen oder zu erwerben.

Diese Nutzungsbedingungen stellen eine bindende Vereinbarung zwischen anny und dem Endkunden dar. Durch die Verwendung der von anny bereitgestellten Plattform erklärt der Endkunde sein Einverständnis mit diesen Bestimmungen.

## § 1 Angebot, Verwaltung von Ressourcen

(1) anny bietet Endkunden eine einfache und schnelle Möglichkeit für die Buchung und den Erwerb der auf der Plattform von den Anbietern eingestellten Ressourcen. Bei diesen Ressourcen kann es sich insbesondere um Mitarbeiter, Gegenstände, Flächen, Räume, die Verwaltung von Tickets und Registrierungen sowie um das Angebot sonstiger Dienstleistungen handeln. Diese Ressourcen können kostenfrei oder zahlungspflichtig vom Anbieter zur Verfügung gestellt werden.

(2) anny ist weder Ersteller noch Veranstalter oder Eigentümer der von den Anbietern eingestellten Ressourcen. anny stellt lediglich die Plattform für die Vermittlung dieser Ressourcen bereit und ermöglicht es dem Endkunden, auf diese Weise die eingestellten Ressourcen zu buchen oder zu erwerben. anny unterstützt die Zusammenführung von Anbieter und Endkunden.

(3) Der Anbieter trägt die alleinige Verantwortung dafür, dass alle von ihm angebotenen Ressourcen die anwendbaren Regelungen, Verordnungen und Gesetze einhalten und im Rahmen der angebotenen Darstellung ordnungsgemäß bereitgestellt werden. Außerdem ist der Anbieter alleine dafür verantwortlich, dass die von ihm angebotenen Ressourcen tatsächlich zur Verfügung stehen.

## § 2 Registrierung, Kundenkonto

(1) Um Ressourcen auf anny einfacher buchen oder erwerben zu können, ist eine Registrierung (Kundenkonto) möglich. Die Registrierung ist im Regelfall optional. Ein Anbieter kann eine Registrierung für bestimmte Ressourcen voraussetzten.

(2) Die bei der Registrierung angegebenen Daten müssen wahrheitsgemäß, zutreffend, aktuell und vollständig sein, um den Service von anny verwenden zu können. Außerdem ist der Endkunde verpflichtet, seine Registrierungsdaten auf dem aktuellen Stand zu halten.

(3) Durch die Nutzung des Kundenkontos ist der Endkunde für die Sicherstellung der Vertraulichkeit seines Kontos und Passwortes sowie für die Beschränkung des Zuganges zu diesem Konto verantwortlich und, soweit unter anwendbarem Recht zulässig, erklärt sich der Endkunde damit einverstanden, für alle Aktivitäten verantwortlich zu sein, die über sein Konto oder Passwort vorgenommen werden.

(4) Endkunden dürfen anny nicht in einer Art und Weise verwenden, die dazu geeignet ist, den Service von anny oder den Zugang dazu zu unterbrechen, zu beschädigen oder in einer sonstigen Art und Weise zu beeinträchtigen. Weiterhin dürfen Endkunden ihr Konto nicht für betrügerische Zwecke oder in Verbindung mit einer Straftat oder rechtswidrigen Aktivität nutzen.

## § 3 Zugang zu anny/Lizenz

(1) Der Endkunde ist verpflichtet, die dem technischen Stand entsprechenden Sicherheitsanforderungen einzuhalten. Hierzu zählt insbesondere die Verwendung von sicheren Passwörtern. Neben der Geheimhaltung von Passwörtern ist die unberechtigte Nutzung von anny durch Dritte zu verhindern.

(2) Der Endkunde wird anny bei Kenntnis oder Verdacht eines Missbrauchs von Zugangsdaten oder Passwörtern unverzüglich unterrichten. anny ist in diesem Fall berechtigt, den Zugang zu anny solange zu sperren, bis die Umstände aufgeklärt sind und der Missbrauch abgestellt ist. Der Endkunde haftet für einen von ihm zu vertretenden Missbrauch des Zugangs zu anny.

(3) Kein von anny bereitgestellter Service darf ohne ausdrückliche schriftliche Zustimmung reproduziert, vervielfältigt, kopiert, verkauft, weiterverkauft oder anderweitig zu kommerziellen Zwecken genutzt werden.

(4) Der gesamte Inhalt der anny-Plattform ist Eigentum von anny oder von Dritten. Endkunden dürfen ohne ausdrückliche schriftliche Zustimmung durch anny oder des Anbieters keine Teile der Plattform extrahieren und/oder wiederverwenden. Insbesondere dürfen Endkunden ohne die ausdrückliche schriftliche Zustimmung von anny kein Data Mining, keine Robots oder ähnliche Datensammel- oder Extraktionsprogramme einsetzen, um irgendwelche wesentlichen Teile von anny zur Wiederverwendung zu extrahieren.

## § 4 Zahlungsabwicklung

(1) anny ermöglicht es Endkunden, die Abwicklung von zahlungspflichtigen Ressourcen unmittelbar über anny vorzunehmen.

(2) anny stellt hierfür gängige Zahlungsoptionen (u.a. „Kreditkarte") zur Verfügung. Eine Liste aller angebotenen Zahlungsoptionen findet sich auf der Plattform.

(3) Durch die Zahlungsabwicklung über anny wird anny nicht Vertragspartner des Endkunden bezüglich der gebuchten bzw. erworbenen Ressource vom Anbieter. anny übernimmt lediglich die Zahlungsabwicklung im Namen des jeweiligen Anbieters.

(4) Der Endkunde erklärt sein ausdrückliches Einverständnis, Rechnungen ausschließlich digital zu erhalten.

## § 5 Beendigung/Laufzeit

(1) Das bei anny angelegte Kundenkonto wird auf unbestimmte Zeit angelegt.

(2) Das bei anny angelegte Kundenkonto kann jederzeit vom Endkunden bei anny gelöscht werden.

(3) anny behält sich das Recht vor, Kundenkonten von Endkunden zu schließen, wenn diese gegen anwendbares Recht, gegen vertragliche Vereinbarungen oder gegen die Regelungen in diese Nutzungsbedingungen verstoßen.

## § 6 Datenschutz

anny ist sich der Bedeutung der persönlichen Informationen des Endkunden bewusst. Persönliche Informationen, die anny bereitgestellt werden, unterliegen der Datenschutzrichtlinie von anny.

## § 7 Haftung

(1) Zwischen anny und dem Endkunden bestehen keine vertraglichen Beziehungen hinsichtlich der Durchführung der Buchung oder des Erwerbs von Ressourcen. Ein Vertrag kommt ausschließlich zwischen den Endkunden und dem Anbieter zustande.

(2) anny ist nicht dafür verantwortlich, dass die vom Anbieter eingestellten Ressourcen tatsächlich zur Verfügung stehen oder dass sie genau so ausgestaltet sind, wie der Anbieter sie beschrieben hat. Der Anbieter ist verantwortlich für den Verkauf bzw. für die Bereitstellung der angebotenen Ressourcen. Jegliche Reklamation von Seiten des Endkunden sowie für alle anderen Angelegenheiten, die durch den Vertrag zwischen Endkunde und Anbieter entstehen, ist alleine der Anbieter verantwortlich.

(3) anny haftet nicht für Störungen oder Schäden gleich welcher Art, die durch Umstände außerhalb ihres Einflussbereichs verursacht werden und die sie auch bei Anwendung kaufmännischer Sorgfalt nicht vorhersehen und vermeiden konnte.

(4) Die Haftung von anny für Schäden des Endkunden sind ausgeschlossen. Von diesem Haftungsausschluss bleibt die Haftung für Schäden aus der Verletzung des Lebens, des Körpers oder der Gesundheit sowie sonstige Schäden, die auf einer vorsätzlichen oder grob fahrlässigen Pflichtverletzung von anny oder eines gesetzlichen Vertreters oder Erfüllungsgehilfen von anny beruhen.

(5) Soweit die Haftung von anny ausgeschlossen oder beschränkt ist, gilt dies auch für die Haftung von anny für ihre gesetzlichen Vertreter, Erfüllungs- und Verrichtungsgehilfen sowie deren persönliche Haftung.

(6) Die Plattform von anny kann Verlinkungen enthalten. Für sämtliche externen Verlinkungen und deren Inhalt ist anny nicht verantwortlich.

## § 8 Buchungsbestätigung

Über anny gebuchte Ressourcen werden dem Endkunden per E-Mail, direkt oder per Buchungsbestätigung durch den Anbieter bestätigt.

## § 9 Verbraucherrecht

(1) Dem Endkunden steht ein Widerrufsrecht gegenüber dem Anbieter zu.

### Widerrufsbelehrung und Widerrufsformular (Endverbraucher)

#### Widerrufsrecht

Sie haben das Recht, binnen 14 Tagen ohne Angabe von Gründen diesen Vertrag zu widerrufen. Die Widerrufsfrist beträgt 14 Tage ab dem Tag des Vertragsabschlusses. Um Ihr Widerrufsrecht auszuüben, müssen Sie den Anbieter mittels einer eindeutigen Erklärung (z. B. ein mit der Post versandter Brief, Telefax oder E-Mail) über Ihren Entschluss, den Vertrag zu widerrufen, informieren. Sie können das Muster-Widerrufsformular verwenden, das jedoch nicht vorgeschrieben ist. Zur Wahrung der Widerrufsfrist reicht es aus, dass Sie die Mitteilung über die Ausübung des Widerrufsrechts vor Ablauf der Widerrufsfrist absenden.

#### Folgen des Widerrufs

Wenn Sie diesen Vertrag widerrufen, werden alle geleisteten Zahlungen unverzüglich und spätestens binnen 14 Tagen ab dem Tag zurückgezahlt, an dem die Mitteilung über Ihren Widerruf dieses Vertrages beim Anbieter eingegangen ist. Für die Rückzahlung wird dasselbe Zahlungsmittel verwendet, das Sie bei der ursprünglichen Transaktion eingesetzt haben, es sei denn, mit Ihnen wurde ausdrücklich etwas anderes vereinbart. In keinem Fall werden Ihnen wegen dieser Rückzahlung Entgelte berechnet.

Sind die Dienstleistungen bereits während der Widerrufsfrist begonnen worden, ist von Ihnen ein angemessener Betrag zu zahlen, der dem Anteil der bis zu dem Zeitpunkt, zu dem Sie den Anbieter von der Ausübung des Widerrufsrechts hinsichtlich dieses Vertrages unterrichtet haben, bereits erbrachten Dienstleistungen im Vergleich zum Gesamtumfang der im Vertrag vorgesehenen Dienstleistung entspricht.

#### Ausschluss des Widerrufsrechts

Der Ausschluss des Widerrufsrechts erlischt bei einem Vertrag über die Lieferung von digitalen Inhalten oder die Erbringung von Dienstleistungen, sofern wir mit Ihrer ausdrücklichen Zustimmung mit der Erfüllung des Vertrages beginnen und Sie uns Ihre Kenntnis davon bestätigt haben, dass Sie durch Ihre Zustimmung zu dem Beginn der Ausführung des Vertrages Ihr Widerrufsrecht in Bezug auf die digitalen Inhalte und die Dienstleistungen verlieren.

#### Muster-Widerrufsformular

Wenn Sie den Vertrag widerrufen wollen, dann füllen Sie bitte dieses Formular aus und senden Sie es zurück:

An:<br />\[Anbieter]<br />\[Anschrift]<br />Telefon \[ • ]<br />E-Mail \[ • ]

„Hiermit widerrufe(n) ich/wir, \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_, den von mir/uns am \_\_\_\_\_\_\_\_ abgeschlossenen Vertrag über die \[ • ]

Bestellt am \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

Name des/der Verbrauchers: \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

Anschrift des/der Verbraucher: \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

Unterschrift des/der Verbraucher (nur auf Mitteilung auf Papier): \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_

Datum: \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_"

(2) Das Widerrufsrecht gilt gemäß § 312 g Abs. 2 Nr. 9 BGB nicht

* für Verträge über Dienstleistungen im Zusammenhang mit Freizeitbetätigungen, wenn der Vertrag für die Erbringung einen spezifischen Termin oder Zeitraum vorsieht (z. B. Konzertveranstaltungen)
* für die Lieferung von Waren, die aus Gründen des Gesundheitsschutzes oder aus Hygienegründen nicht zur Rückgabe geeignet sind und deren Versiegelung nach der Lieferung entfernt wurde oder die nach der Lieferung aufgrund ihrer Beschaffenheit untrennbar mit anderen Gütern vermischt wurden
* für Verträge zur Lieferung von Ton- oder Videoaufnahmen oder Computersoftware in einer versiegelten Packung, wenn die Versiegelung nach der Lieferung entfernt wurde
* für Verträge zur Lieferung von Waren, die nach Kundenspezifikation angefertigt werden oder eindeutig auf die persönlichen Bedürfnisse zugeschnitten sind
* für Verträge zur Lieferung von Waren, die schnell verderben können oder deren Verfallsdatum schnell überschritten wurde
* für Verträge zur Lieferung von Zeitungen, Zeitschriften oder Illustrierten, mit Ausnahme von Abonnementverträge über die Lieferung solcher Publikationen

(3) Alle weiteren Rechte, die dem Endkunden als Verbraucher zustehen, wie z. B. Nacherfüllung, Minderung, Rücktritt, Schadenersatz oder Kündigung, sind gegenüber dem jeweiligen Anbieter geltend zu machen.

## § 11 Alternative Streitbeilegung

(1) Die Europäische Kommission stellt eine Plattform zur Online-Streitbeilegung (OS-Plattform) verbraucherrechtlicher Streitigkeiten bereit. Mit folgendem Link gelangen Sie unmittelbar auf die Plattform der EU-Kommission zur Online-Streitbeilegung: [https://www.ec.europa.eu/consumers/odr](https://www.ec.europa.eu/consumers/odr)

(2) Bei etwaigen Beanstandungen strebt anny eine einvernehmliche und kundenorientierte Lösung mit dem Endkunden an. anny nimmt daher nicht am Streitbeilegungsverfahren vor einer Verbraucherschlichtungsstelle teil. anny ist im Übrigen hierzu auch gesetzlich nicht verpflichtet.

## § 12 Schlussbestimmungen

Sollten einzelne Bestimmungen dieser Nutzungsbedingungen ganz oder teilweise nichtig oder unwirksam sein oder werden, so wird dadurch die Wirksamkeit der übrigen Bestimmungen nicht berührt. An die Stelle von nicht einbezogenen oder unwirksamen Bestimmungen dieser Nutzungsbedingungen gelten die gesetzlichen Regelungen. Steht eine gesetzliche Regelung im jeweiligen Einzelfall nicht zur Verfügung, werden die Parteien in Verhandlungen darüber eintreten, anstelle der nicht einbezogenen oder unwirksamen Bestimmung eine wirksame Regelung zu treffen, die der unwirksamen Regelung wirtschaftlich möglichst nahekommt.


# TikTok Ads mit anny verbinden
Source: https://docs.anny.co/tiktok-ads-tracking

Miss mit dem TikTok-Pixel, welche Kampagnen zu Buchungen in anny führen.

[TikTok Ads](https://ads.tiktok.com) ist die Werbeplattform von TikTok. Mit dem TikTok-Pixel und der serverseitigen Conversion-Schnittstelle misst du, welche deiner Kampagnen tatsächlich zu Buchungen führen. anny lädt dazu das TikTok-Pixel auf deinen Buchungsseiten und meldet die passenden Ereignisse an TikTok.

Mit TikTok Ads kannst du in anny:

* Seitenaufrufe deiner Buchungsseiten und abgeschlossene Buchungen als Conversions an TikTok melden
* den Erfolg deiner TikTok-Kampagnen bis zur fertigen Buchung nachverfolgen
* Buchungen zusätzlich serverseitig melden, auch wenn Kund:innen keine Cookies zulassen

Praktisch ist die Integration, wenn du über TikTok wirbst und wissen willst, welche Anzeigen sich in echte Buchungen und Umsatz übersetzen.

<Info>
  Die TikTok-Ads-Integration gehört zum Feature **Conversion Tracking**. Ist es in deinem Plan nicht enthalten, erscheint TikTok Ads in der Integrationsübersicht als nicht verfügbar. Dasselbe Feature schaltet auch Google Ads, Meta Ads und LinkedIn Ads frei.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Kampagnen-Erfolg messen | **Du siehst im TikTok Events Manager, welche Anzeigen zu Buchungen führen.** anny meldet abgeschlossene Buchungen als Conversion samt Buchungswert, sodass du deine Werbeausgaben gezielt steuern kannst. |
| Conversions ohne Cookies erfassen | **Auch ohne Cookie-Einwilligung ordnest du Buchungen deinen Kampagnen zu.** Kommen Kund:innen über eine TikTok-Anzeige, meldet anny den Abschluss serverseitig, unabhängig vom Cookie-Banner. |
| Mehrere Plattformen parallel nutzen | **Du misst TikTok, Google, Meta und LinkedIn gleichzeitig.** anny bedient alle aktiven Plattformen über dieselben Ereignisse, ohne dass du deine Buchungsseiten anpassen musst. |

## Wie die TikTok-Ads-Verbindung funktioniert

Die Integration besteht aus zwei Wegen, die du getrennt nutzen kannst:

* **TikTok Pixel:** anny lädt das TikTok-Pixel-Skript im Browser deiner Kund:innen auf den von anny gehosteten Buchungsseiten und meldet dort Ereignisse. Dafür trägst du im Panel **TikTok Pixel** deine **Pixel ID** ein.
* **Offline conversion API:** anny meldet abgeschlossene Buchungen zusätzlich direkt vom Server an TikTok, ohne Browser und ohne Cookies. Dafür hinterlegst du im Panel **Offline conversion API** einen **Access token**.

Nur die **Pixel ID** ist Pflicht. Der **Access token** ist optional und schaltet den serverseitigen Weg zu. anny authentifiziert sich damit bei TikTok und sendet Ereignisse, empfängt aber keine Daten zurück. Es gibt in anny keine Zielgruppen-, Kampagnen- oder Budgetverwaltung.

Das Pixel lädt auf allen öffentlichen, von anny gehosteten Seiten: Buchungsseite, Ressourcen-, Service-, Abo- und Buchungspaket-Seite sowie Checkout und Bestätigung. Im Admin-Bereich lädt kein Pixel. anny meldet dabei vier Ereignisse:

| Ereignis | Wann es gemeldet wird | Mitgesendete Daten |
| :- | :- | :- |
| `ViewContent` | Kund:innen rufen eine Buchungsseite auf | – |
| `AddToCart` | Eine Buchung wird in den Warenkorb gelegt | Netto-Betrag, Währung, Buchungsnummer |
| `InitiateCheckout` | Der Checkout wird geöffnet | – |
| `CompletePayment` | Eine Buchung wird abgeschlossen | Netto-Betrag, Währung, Buchungsnummer |

anny überträgt keine Namen, E-Mail-Adressen, Telefonnummern oder Buchungsdetails. Das Pixel selbst erhebt zusätzlich die üblichen Browser-Daten wie IP-Adresse, Browser-Kennung, Seiten-URL und TikTok-Cookies.

Das Pixel lädt erst, wenn Kund:innen im Cookie-Banner der Buchungsseite **Marketing** akzeptieren. Vorher passiert nichts. Die Option **Marketing** erscheint nur, wenn eine Tracking-Integration aktiv ist. Nimmt eine Person ihre Einwilligung zurück, sendet anny für sie keine weiteren Ereignisse mehr.

Der serverseitige Weg funktioniert unabhängig von den Cookies: anny meldet eine Offline-Conversion, wenn eine Person über eine TikTok-Anzeige mit Klick-Parameter auf die Buchungsseite gekommen ist, und ordnet Abschlüsse innerhalb von 14 Tagen dieser Kampagne zu. Wenn du die Integration deaktivierst, entfernt anny die **Pixel ID** sofort von allen Buchungsseiten und meldet keine weiteren Ereignisse mehr.

## TikTok Ads verbinden

### Voraussetzungen

Bevor du TikTok Ads verbindest, stelle sicher, dass du Folgendes hast:

* Admin-Rechte in deinem anny Account und das Feature **Conversion Tracking** in deinem Plan
* Ein TikTok-Ads-Konto mit einem erstellten Pixel und dessen **Pixel ID** (TikTok Events Manager → Datenquellen → auswählen)
* Optional für serverseitige Conversions: einen **Access token** aus dem TikTok Events Manager (Datenquelle → Einstellungen → Zugangstoken generieren)

### Verbindung einrichten

<Steps>
  <Step title="Pixel ID eintragen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **TikTok Ads**. Trage im Panel **TikTok Pixel** deine **Pixel ID** ein.
  </Step>

  <Step title="Optional: Offline conversion API hinterlegen">
    Willst du Buchungen zusätzlich serverseitig melden, füge im Panel **Offline conversion API** deinen **Access token** ein und klicke auf **Autorisieren**. Diesen Schritt kannst du überspringen, wenn du nur das Pixel nutzt.
  </Step>

  <Step title="Aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. Erst dann übergibt anny die **Pixel ID** an deine Buchungsseiten.
  </Step>
</Steps>

Sobald die Integration aktiv ist, lädt anny das TikTok-Pixel nach Marketing-Einwilligung auf deinen Buchungsseiten und meldet die Ereignisse an TikTok. Die Ergebnisse siehst du im TikTok Events Manager.

<Tip>
  Die **Pixel ID** darf nur Buchstaben, Ziffern und die Zeichen `_ : / - + = .` enthalten. Leerzeichen am Anfang und Ende entfernt anny automatisch. Enthält die ID andere Zeichen, bricht das Aktivieren mit einer Fehlermeldung ab.
</Tip>

## Einschränkungen

Die TikTok-Ads-Integration unterstützt nicht:

* **Eingebettete Buchungsseite (Widget):** In einem eingebetteten Widget zeigt anny kein Cookie-Banner und lädt daher kein TikTok-Pixel. Stattdessen gibt anny die Ereignisse an die umgebende Website weiter, wo ein eigener Tag Manager sie verarbeiten kann. Der serverseitige Weg über die **Offline conversion API** funktioniert im Widget uneingeschränkt.
* **Mehrere Pixel pro Account:** anny speichert eine **Pixel ID** pro Account. Legst du eine weitere TikTok-Ads-Integration an, gilt die zuletzt aktivierte Konfiguration.
* **Rückkanal:** TikTok sendet keine Daten an anny. Zielgruppen, Kampagnen und Budgets verwaltest du weiterhin im TikTok Ads Manager.
* **Änderung im aktiven Zustand:** Die **Pixel ID** lässt sich nur bei deaktivierter Integration ändern.

## Verbindung trennen

<Warning>
  Wenn du die Integration über den **Toggle** deaktivierst, entfernt anny das TikTok-Pixel sofort von allen Buchungsseiten und meldet keine weiteren Ereignisse mehr, weder aus dem Browser noch vom Server. Beim Löschen entfernt anny zusätzlich die gespeicherte **Pixel ID** und den **Access token**. Bereits in TikTok erfasste Daten bleiben dort erhalten, deine Buchungen sind nicht betroffen.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Werden meine Buchungsseiten auch ohne Cookie-Einwilligung getrackt?">
    Das Pixel lädt erst, wenn Kund:innen im Cookie-Banner **Marketing** akzeptieren. Ohne Einwilligung feuert anny keine Pixel-Ereignisse. Der serverseitige Weg über die **Offline conversion API** funktioniert dagegen auch ohne Cookie-Einwilligung, sofern die Person über eine TikTok-Anzeige gekommen ist.
  </Accordion>

  <Accordion title="Muss ich einen Access token hinterlegen?">
    Nein. Für das Tracking im Browser reicht die **Pixel ID**. Der **Access token** ist nur nötig, wenn du Buchungen zusätzlich serverseitig melden willst, zum Beispiel für Kund:innen ohne Cookie-Einwilligung oder in einem eingebetteten Widget.
  </Accordion>

  <Accordion title="Kann ich TikTok Ads und andere Plattformen gleichzeitig nutzen?">
    Ja. Google Ads, Meta Ads, LinkedIn Ads und TikTok Ads können parallel aktiv sein und werden über dieselben Ereignisse bedient. Es gibt eine gemeinsame Marketing-Einwilligung im Cookie-Banner, nicht eine pro Plattform.
  </Accordion>

  <Accordion title="Wie ändere ich die Pixel ID?">
    Deaktiviere die Integration zuerst über den **Toggle**, denn solange sie aktiv ist, ist die **Pixel ID** gesperrt. Trage danach die neue **Pixel ID** ein und aktiviere die Integration wieder.
  </Accordion>

  <Accordion title="Wo sehe ich, ob das Tracking funktioniert?">
    Die gemeldeten Ereignisse und Conversions siehst du im TikTok Events Manager. In anny protokolliert der **Aktivierungsverlauf** unter der Integration nur, wann sie aktiviert oder deaktiviert wurde, nicht die einzelnen Ereignisse.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Ich kann die Pixel ID nicht ändern">
    Die Integration ist noch aktiv. Solange sie läuft, ist die **Pixel ID** gesperrt. Deaktiviere die Integration zuerst über den **Toggle**, ändere dann die ID und aktiviere sie wieder.
  </Accordion>

  <Accordion title="Das Aktivieren bricht mit einer Fehlermeldung ab">
    Die **Pixel ID** enthält vermutlich unerlaubte Zeichen. Erlaubt sind nur Buchstaben, Ziffern und die Zeichen `_ : / - + = .`. Entferne insbesondere Leerzeichen in der Mitte der ID und aktiviere erneut.
  </Accordion>

  <Accordion title="TikTok Ads erscheint nicht in der Integrationsübersicht">
    Die Integration ist an das Feature **Conversion Tracking** gebunden. Ist es in deinem Plan nicht enthalten, taucht TikTok Ads nicht auf. Prüfe deinen Plan oder wende dich an den anny Support.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** TikTok Ads ist eine Conversion-Tracking-Integration, KEIN Datensync und KEIN Smart-Lock. Es gibt keinen Rückkanal von TikTok zu anny und keine Zielgruppen-, Kampagnen- oder Budgetverwaltung in anny. Zwei getrennte Wege: TikTok-Pixel (browserseitig) und Offline conversion API (serverseitig); beide unabhängig nutzbar, nur die Pixel ID ist Pflicht.
>
> **UI-Pfade:** Menüleiste → **Integrationen** → **TikTok Ads**. Panel **TikTok Pixel** mit Feld **Pixel ID**; Panel **Offline conversion API** mit Feld **Access token** und Button **Autorisieren**. Aktion **Verbindung testen** und **Löschen** über die drei Punkte; Aktivieren/Deaktivieren über den Toggle oben rechts. **Aktivierungsverlauf** protokolliert nur Aktivierung/Deaktivierung, keine einzelnen Ereignisse. Labels sind in der deutschen Oberfläche englisch ("Pixel ID", "Access token", "Offline conversion API").
>
> **Events & Seiten:** Pixel lädt auf allen öffentlichen anny-Seiten (Buchungsseite, Ressource, Service, Abo, Buchungspaket, Checkout, Bestätigung), nicht im Admin. Ereignisse: `ViewContent` (Seitenaufruf), `AddToCart` (Warenkorb), `InitiateCheckout` (Checkout geöffnet), `CompletePayment` (Abschluss). `AddToCart` und `CompletePayment` tragen Netto-Betrag, Währung und Buchungsnummer; keine personenbezogenen Kundendaten. Das Pixel lädt erst nach Marketing-Einwilligung im Cookie-Banner; die Marketing-Option erscheint nur bei aktiver Tracking-Integration; Widerruf stoppt weitere anny-Events.
>
> **Serverseitige Offline-Conversions:** Nur, wenn die Person über einen TikTok-Klick-Parameter (`ttclid`) kam. Attributionsfenster 14 Tage, unabhängig von der Cookie-Einwilligung (nur technisch notwendiger Besuchs-Schlüssel). Klick-Parameter gewinnen gegen reine UTM-Parameter bei Wiederkehr. Gemeldet werden Bestellungen, Abos und Buchungspakete als `CompletePayment` mit Netto-Betrag und Währung. Übertragen werden Pixel ID, Ereignisname, Ereignis-Kennung, Zeitstempel, Klick-ID, Betrag, Währung; keine Kundendaten. Bei Serverfehler/Ratenlimit bis zu 3 Wiederholungen; bei inhaltlicher Ablehnung (z. B. ungültiger Access token) keine Wiederholung.
>
> **Beziehungen:** Feature-Gating über **Conversion Tracking**, gemeinsam mit Google Ads, Meta Ads und LinkedIn Ads. Eine gemeinsame Marketing-Einwilligung für alle Plattformen. Verwandter Artikel: utm-tracking. Im Widget lädt kein Pixel (kein Cookie-Banner); Ereignisse gehen an die umgebende Website (Tag Manager), Offline conversion API funktioniert dort. Pro Account wird nur eine Pixel-Konfiguration gespeichert; bei mehreren Integrationen gilt die zuletzt aktivierte. Auf Seiten mit mehreren Organisationen lädt anny jedes Pixel getrennt.


# Treatwell mit anny verbinden
Source: https://docs.anny.co/treatwell

Importiere Treatwell-Buchungen per E-Mail in anny und zeige anny-Termine per Kalenderlink in Treatwell.

[Treatwell](https://www.treatwell.de/) ist eine Buchungsplattform für Beauty- und Wellness-Anbieter, über die Endkund:innen Termine bei Salons und Studios buchen. Mit der Integration hält anny Buchungen aus beiden Systemen weitgehend synchron: Treatwell-Buchungen kommen per E-Mail-Weiterleitung in anny, anny-Buchungen werden per Kalenderlink in Treatwell sichtbar.

Mit Treatwell kannst du in anny:

* Treatwell-Buchungen automatisch per E-Mail-Weiterleitung importieren, inklusive Stornierungen und Verschiebungen
* Mehrere Behandlungen aus einer Mail als zusammenhängende Terminfolge anlegen
* Doppelte Einträge vermeiden und Prepaid-Zahlungen aus Treatwell berücksichtigen
* anny-Buchungen per Kalenderlink (ICS) in Treatwell als belegte Zeiten sichtbar machen

Besonders praktisch ist die Integration, wenn du Treatwell und anny parallel nutzt und deine Buchungen zentral in anny verwalten möchtest, ohne Termine doppelt zu pflegen.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Salon mit Treatwell-Buchungen | **Treatwell-Buchungen landen automatisch in anny.** Die Buchungs-E-Mail wird an die anny Inbox weitergeleitet, anny legt den Termin an. Eine weitergeleitete Storno-Mail storniert ihn. |
| Studio mit Direktbuchungen | **anny-Buchungen werden in Treatwell sichtbar.** Termine, die du direkt in anny anlegst, etwa per Telefon oder Walk-in, erscheinen über den Kalenderlink in Treatwell als belegte Zeiten. |
| Prepaid-Termine | **Vorauszahlungen werden übernommen.** Meldet Treatwell eine Vorauszahlung, berücksichtigt anny die Prepaid-Information bei der Buchung. |

## Wie die Treatwell-Verbindung funktioniert

Die Integration nutzt zwei getrennte Wege, je nach Synchronisationsrichtung:

* **Treatwell → anny** läuft über E-Mail-Weiterleitung. Du leitest die Treatwell-Mails deines Salons an eine dedizierte anny Inbox weiter. anny liest keine Kundenpostfächer. anny AI liest die Inhalte aus und legt Buchungen an, verschiebt sie oder storniert sie, auch wenn Treatwell das E-Mail-Layout ändert.
* **anny → Treatwell** läuft über einen Kalenderlink. anny stellt einen ICS-Kalenderfeed bereit (ICS ist ein standardisiertes Kalenderformat), den du in Treatwell importierst. Treatwell zeigt anny-Buchungen darüber als belegte Zeiten an.

Weil beide Richtungen über unterschiedliche Wege laufen, ist die Synchronisation nicht in Echtzeit. Rechne mit einer typischen Verzögerung von etwa 30 bis 60 Sekunden.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Neue Buchungen, Verschiebungen und Stornierungen | Treatwell → anny | Per E-Mail-Weiterleitung, ca. 30 bis 60 Sekunden Verzögerung |
| Buchungen als belegte Zeiten | anny → Treatwell | Per ICS-Kalenderlink, ca. 30 bis 60 Sekunden Verzögerung |

anny verarbeitet nur Mails, die in der Inbox ankommen. Leitest du neue Buchungen, Verschiebungen und Stornos weiter, legt anny den Termin an, verschiebt den bestehenden Termin oder storniert ihn. Enthält die Mail mehrere Behandlungen, legt anny sie als zusammenhängende Terminfolge auf derselben Ressource an. Nach jedem Import sendet anny eine Mail an den Salon: übernommen, übersprungen oder fehlgeschlagen. Im **Aktivierungsverlauf** der Integration siehst du dieselben Ereignisse.

Steht in der Mail eine Kund:innen-E-Mail, legt anny eine:n Kund:in an oder ordnet die Buchung einer bestehenden Person zu (per E-Mail oder Telefon). Ausgelesen werden Vorname, Nachname, E-Mail, Telefon, Termin, Service, Preis, Prepaid-Status und die Mitarbeiter:in unter „bei" bzw. „with". Ohne E-Mail entsteht keine neue Kundenakte. Kontakte unter Kundenbetreuung gehören zum Salon und werden nicht übernommen.

Der Termin erscheint im anny-Kalender als akzeptierte Buchung auf genau einer Ressource. Das ist in der Regel die Mitarbeiter:in aus der Mail. Ein in Treatwell hinterlegter Raum wird nicht automatisch als zweite Ressource gebucht. Anders als bei [Urban Sports Club](/urban-sports-club) bleiben Treatwell-Buchungen in anny bearbeitbar.

## Treatwell verbinden

### Voraussetzungen

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

* Ein aktives **Treatwell-Konto** mit Zugriff auf die Treatwell-Mails an deinen Salon (neue Buchungen und Stornos)
* Die Möglichkeit, in deinem E-Mail-Postfach eine **Weiterleitungsregel** für diese Treatwell-Mails einzurichten
* Zugriff auf den anny **Adminbereich**, um die Integration einzurichten

### Verbindung einrichten

<Steps>
  <Step title="Treatwell-Integration öffnen">
    Öffne im Adminbereich die **Integrationen** und wähle **Treatwell**.
  </Step>

  <Step title="Weiterleitung im Postfach einrichten">
    Unter **Postfach für Treatwell-Mails** zeigt anny dir eine dedizierte **E-Mail-Adresse** (z. B. `tw-…@calendar.anny.co`). Richte in deinem E-Mail-Postfach eine Weiterleitung ein, die Treatwell-Mails zu neuen Buchungen, Verschiebungen und Stornos automatisch an diese Adresse sendet.
  </Step>

  <Step title="Weitere Absender ergänzen (optional)">
    Mails von Treatwell werden immer angenommen. Kommen Buchungen unter einem anderen Namen an, etwa von einem Treatwell-Partner oder über deine eigene Weiterleitung, trage die Adresse oder Domain unter **Weitere Absender** als **Akzeptierte Absender** ein (z. B. `@partner.de`).
  </Step>

  <Step title="Abweichende Namen zuordnen (optional)">
    Heißt eine Ressource oder ein Service in Treatwell anders als in anny, lege unter **Abweichende Namen** über **Hinzufügen** eine Zuordnung an. Mappe vor allem Mitarbeiter:innen (z. B. „Mara E." auf die anny-Ressource). Ohne Regel wählt anny den Eintrag, dessen Name zur Mail passt.
  </Step>

  <Step title="Kalenderlink in Treatwell importieren">
    Importiere den von anny bereitgestellten **ICS-Kalenderlink** in Treatwell, damit anny-Buchungen dort als belegte Zeiten erscheinen.
  </Step>

  <Step title="Integration aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. Solange sie inaktiv ist, zeigt anny den Hinweis „Die Integration ist derzeit nicht aktiv.". Löse anschließend eine Testbuchung in Treatwell aus und prüfe, ob sie nach kurzer Zeit in anny erscheint.
  </Step>
</Steps>

Sobald die Integration aktiv ist, werden weitergeleitete Treatwell-Buchungen automatisch in anny angelegt, Verschiebungen nachgezogen und Stornos übernommen. anny-Buchungen werden in Treatwell sichtbar.

<Tip>
  Behandle die weitergeleitete E-Mail-Adresse wie ein Passwort: Wer sie kennt, kann Buchungen in deinen Kalender schreiben. Die Weiterleitungsregel muss neue Buchungen, Verschiebungen und Stornos erfassen und darf nicht durch Spam- oder Filterregeln blockiert werden.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| - | - |
| E-Mail-Adresse (Postfach für Treatwell-Mails) | Dedizierte anny Inbox, an die du Treatwell-Buchungsmails und Stornos weiterleitest |
| Akzeptierte Absender (Weitere Absender) | Zusätzliche Adressen oder Domains, deren weitergeleitete Mails anny ebenfalls akzeptiert |
| Abweichende Namen | Zuordnung, wenn eine Ressource oder ein Service in Treatwell anders heißt als in anny |
| Aktivierungsverlauf | Verlauf der Aktivierungen und Deaktivierungen sowie der Treatwell-Mail-Importe (angelegt, verschoben, storniert, übersprungen, fehlgeschlagen) |

## Einschränkungen

Die Treatwell-Integration unterstützt nicht:

* Echtzeit-Synchronisation: Buchungen werden mit einer typischen Verzögerung von etwa 30 bis 60 Sekunden übertragen
* Eine direkte API-Verbindung: Treatwell-Buchungen kommen per E-Mail, anny-Buchungen gehen per Kalenderlink
* Import ohne aktive Weiterleitung: Ohne korrekt eingerichtete Weiterleitungsregel werden keine Treatwell-Buchungen importiert
* Zwei Ressourcen aus einer Mail: Mitarbeiter:in und Raum werden nicht gleichzeitig als zwei anny-Ressourcen gebucht
* Kundenanlage ohne E-Mail: Fehlt die Kund:innen-E-Mail in der Mail, legt anny keine neue Kundenakte an

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst oder löschst, werden keine Termine mehr synchronisiert. Weitergeleitete Treatwell-Mails werden dann nicht mehr als Buchungen übernommen und anny-Buchungen nicht mehr nach Treatwell übertragen. Bereits importierte Buchungen bleiben in anny 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="Wie schnell erscheinen Treatwell-Buchungen in anny?">
    In der Regel innerhalb von etwa 30 bis 60 Sekunden. Die Synchronisation ist nicht in Echtzeit, da Buchungen per E-Mail-Weiterleitung übertragen werden.
  </Accordion>

  <Accordion title="Werden Stornierungen aus Treatwell automatisch übernommen?">
    Ja. Wird eine Buchung in Treatwell storniert, storniert anny die zugehörige Buchung, sofern die Storno-E-Mail an die anny Inbox weitergeleitet wird. anny schreibt dem:der Kund:in dazu keine eigene Mail.
  </Accordion>

  <Accordion title="Werden Verschiebungen aus Treatwell in anny übernommen?">
    Ja. Wird eine Buchung in Treatwell verschoben und die Update-Mail an die anny Inbox weitergeleitet, verschiebt anny den bestehenden Termin (und eine dazugehörige Terminfolge) auf die neue Uhrzeit. Bleibt die Startzeit gleich, ändert anny nichts.
  </Accordion>

  <Accordion title="Welche Kundendaten werden übernommen, und wird immer ein:e Kund:in angelegt?">
    anny kann Vorname, Nachname, E-Mail und Telefon aus der Treatwell-Mail übernehmen, wenn die Felder dort stehen. Eine neue Kundenakte entsteht nur, wenn eine E-Mail-Adresse enthalten ist. Bestehende Kund:innen werden per E-Mail oder Telefon zugeordnet. Ohne E-Mail entsteht keine neue Akte, anders als bei [Urban Sports Club](/urban-sports-club). Marker wie „Neu" am Namen werden entfernt.
  </Accordion>

  <Accordion title="Wie erscheint der Termin im anny-Kalender, wenn Treatwell Mitarbeiter:innen und Räume kennt?">
    Der Termin erscheint als akzeptierte Buchung auf genau einer Ressource, in der Regel der Mitarbeiter:in aus „bei" bzw. „with". Mappe diesen Namen unter **Abweichende Namen** auf die anny-Ressource. Ein Treatwell-Raum wird nicht automatisch als zweite Ressource gebucht. Treatwell-Buchungen bleiben in anny bearbeitbar, anders als Buchungen über [Urban Sports Club](/urban-sports-club).
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Treatwell-Buchungen erscheinen nicht in anny">
    Meist ist die E-Mail-Weiterleitung nicht korrekt eingerichtet. Prüfe der Reihe nach: 1. Ist die Integration aktiv (Toggle oben rechts)? 2. Ist die Weiterleitungsregel aktiv und erfasst neue Buchungen, Verschiebungen sowie Stornos? 3. Stimmt die Zieladresse mit der dedizierten anny Inbox überein? 4. Kommen die Mails unter einem anderen Absender an und müssen unter **Weitere Absender** ergänzt werden? 5. Landen die Treatwell-Mails eventuell im Spam oder in einem Filter? 6. Steht im **Aktivierungsverlauf** ein übersprungener oder fehlgeschlagener Import?
  </Accordion>

  <Accordion title="anny-Buchungen erscheinen nicht in Treatwell">
    Prüfe, ob der ICS-Kalenderlink korrekt in Treatwell importiert wurde. Beachte außerdem die typische Verzögerung von etwa 30 bis 60 Sekunden, bevor neue anny-Buchungen sichtbar werden.
  </Accordion>

  <Accordion title="Die Buchung wird der falschen Ressource oder dem falschen Service zugeordnet">
    Ohne Zuordnungsregel wählt anny den Eintrag, dessen Name zur Mail passt. Die Ressource kommt typischerweise aus dem Feld „bei" in der Treatwell-Mail. Heißt die Mitarbeiter:in oder der Service in Treatwell anders als in anny, lege unter **Abweichende Namen** eine passende Zuordnung an.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Treatwell ist ein Partner-/Buchungskanal, KEINE klassische Kalender-Integration (wie Google/Microsoft) und KEINE API-Integration. Treatwell → anny per E-Mail-Weiterleitung der Salon-Mails an `tw-…@calendar.anny.co` (kein Kundenpostfach). anny → Treatwell per generischem ICS-Kalenderfeed (`cal.ics`), der NICHT in der Treatwell-Settings-UI liegt. Deshalb keine Echtzeit, typische Verzögerung ca. 30 bis 60 Sekunden.
>
> **UI-Pfad:** Adminbereich → **Integrationen** → **Treatwell**. Sektionen: **Postfach für Treatwell-Mails** (Feld **E-Mail-Adresse**), **Weitere Absender** (Feld **Akzeptierte Absender**), **Abweichende Namen** (Button **Hinzufügen**, Felder **Name in Treatwell**, **Zuordnen auf** Ressource/Service, optional **Produktoption**), **Aktivierungsverlauf** auf der Integrations-Detailseite (Aktivierung/Deaktivierung plus Treatwell-Mail-Events; ActivityRow zeigt aufklappbare `properties`). Toggle oben rechts. Löschen: **drei Punkte** → **Löschen**. Prepaid-Strategie existiert im Backend, hat aber kein Panel in Treatwell.vue.
>
> **Kein Gating:** Kein Plan-Gating, nur Aktivierungs-Toggle, daher kein Info-Plan-Hinweis.
>
> **Quirks:** Storno (`event_type` cancelled) storniert alle Buchungen derselben Bestellreferenz, `notifyCustomer: false`. `event_type` updated verschiebt den bestehenden Model-Sync (gleiche Startzeit → skipped already\_imported; Kinder einer Sequenz rücken um dasselbe Delta). Mehrere Behandlungen in einer Mail → `createBookingSequence: true` auf derselben Ressource. Jedes Import-Ergebnis (created/updated/cancelled/skipped/failed/empty/senderRejected) erzeugt eine Venue-Mail und einen Activity-Log-Eintrag auf der Integration. Importierte Bestellungen erhalten `utm_source=treatwell`. CustomerMatcher: Anlage nur mit E-Mail; Match per E-Mail oder Telefon; nur Telefon ohne E-Mail erzeugt keinen neuen Kunden; anonym ohne Kontakt = Buchung ohne customer\_id. Genau eine Resource pro Import (`bei`/`with` = Mitarbeiter:in). `checkAvailability: false` hängt keine verbundenen Räume an. Kanal `treatwell` ist NICHT in `isViaProtectedChannel` (bearbeitbar, anders als USC/ClassPass/GYG). Katalog-Limit 150 Ressourcen/Services. Erinnerungen/Reviews: `is_booking_mail` false. Absender: Treatwell-Länderdomains plus **Akzeptierte Absender**, sonst Text muss „treatwell" erwähnen.
>
> **Beziehungen:** Urban Sports Club (immer Kunde mit Platzhalter-Mail, read-only, Anonymisierung bei Storno). ICS-Kalender-Artikel für den Export-Link nach Treatwell. ClassPass: anderer geschützter Kanal.


# Trust Center
Source: https://docs.anny.co/trust-center





# UniFi mit anny verbinden
Source: https://docs.anny.co/unifi

Automatisiere zeitlich begrenzte Türzugänge mit UniFi Access für Buchungen und Community-Mitglieder.

UniFi Access ([Website](https://ui.com/eu/de/physical-security/door-access)) ist eine On-Premise-Lösung für elektronische Türzugänge. Mit der Integration vergibt anny automatisch zeitlich begrenzte Zutrittsrechte für Buchungen und Community-Mitglieder.

Mit UniFi kannst du in anny:

* Ressourcen mit einer oder mehreren UniFi-Türen verknüpfen
* Community-Mitgliedern Zugang zu ausgewählten Türen gewähren
* den Zutritt über die UniFi App, einen PIN-Code oder **Remote Open** ermöglichen

Besonders praktisch ist die Integration, wenn du UniFi bereits als Netzwerk- und Zutrittssystem nutzt und Erfahrung mit Netzwerkverwaltung hast.

<Info>
  Die UniFi-Integration ist ab dem Professional-Plan verfügbar.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| - | - |
| Buchbare Räume | **Automatischer Zugang pro Buchung:** Kund:innen erhalten nur für den festgelegten Zeitraum Zugang zu den Türen der gebuchten Ressource. |
| Mitgliederbereiche | **Zugang für Community-Mitglieder:** Mitglieder einer Community können die zugeordneten Türen öffnen. |
| Zugang ohne Schlüssel | **Flexible Türöffnung:** Kund:innen öffnen Türen über die UniFi App, einen PIN-Code am Keypad oder Remote Open in anny. |

## Wie die UniFi-Verbindung funktioniert

anny authentifiziert sich mit der Host-URL deines UniFi-Netzwerks und einem API-Token. Die Host-URL muss von außen erreichbar sein. Über die Verbindung ruft anny die in UniFi Access eingerichteten Türen und Nutzer:innen ab und verwaltet passende Zutrittsrechte.

Standardmäßig erzeugt anny für jede Buchung einen Gastzugang mit PIN-Code. Aktivierst du in der Zutrittsregel die Option **Berechtigungen für bestehende Benutzer erweitern**, gleicht anny zuerst die Buchungs-E-Mail mit bestehenden UniFi-Accounts ab: Bei einer Übereinstimmung läuft der Zugang über die UniFi App, sonst wird ein PIN-Code erzeugt.

App-Zugänge über bestehende UniFi-Accounts erstellt anny kurz vor Buchungsbeginn (Just-in-Time). anny fügt den Account dafür einer selbst verwalteten Zutritts-Richtlinie (Policy mit dem Zusatz „anny“) hinzu und entfernt ihn am Ende des Zeitraums wieder. Bis zur Erstellung hat der Zugang den Status **Geplant**.

<Warning>
  Bearbeite oder lösche die von anny erstellten Zutritts-Richtlinien (Policies mit dem Zusatz „anny“) und den Zeitplan „always access“ nicht manuell in UniFi. anny verwaltet sie automatisch. Manuelle Änderungen können den zeitlich begrenzten Zugang stören.
</Warning>

Wenn du den API-Token widerrufst oder die Host-URL nicht mehr erreichbar ist, kann anny keine Türen abrufen und keine Zutrittsrechte über UniFi verwalten.

| Daten | Richtung | Häufigkeit |
| - | - | - |
| Türen und Nutzer:innen | UniFi → anny | Beim Laden und Konfigurieren der Integration |
| Zutrittsrechte | anny → UniFi | Bei Erstellung, Änderung oder Entfernung eines Zugangs |
| Türentriegelung | anny → UniFi | Bei Nutzung von Remote Open |

## UniFi verbinden

### Voraussetzungen

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

* ein eingerichtetes UniFi-Netzwerksystem mit UniFi Access und funktionsfähigen Türen
* eine von außen erreichbare Host-URL für dein UniFi-Netzwerk
* einen API-Token, den du in der UniFi Access App erstellst
* den Professional-Plan oder höher in anny
* mindestens eine Ressource oder Community für die Zutrittsregel

### Verbindung einrichten

<Steps>
  <Step title="Integration öffnen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **UniFi**.
  </Step>

  <Step title="Authentifizieren">
    Trage die Host-URL deines UniFi-Netzwerks und den API-Token ein. Hinweise zum externen Netzwerkzugang findest du in [dieser Anleitung](https://artofwifi.net/blog/how-to-access-the-unifi-controller-by-wan-ip-or-hostname-on-a-udm-pro).
  </Step>

  <Step title="Konfigurieren">
    Lege die benötigten Zutrittsregeln an:

    1. Klicke bei Buchungen oder Communities auf **Hinzufügen**.
    2. Wähle die Ressource oder Community aus.
    3. Ordne eine oder mehrere UniFi-Türen zu.
    4. Lege bei Buchungsregeln **Zugang vor der Buchung** und **Zugang nach der Buchung** fest.
    5. Aktiviere bei Bedarf **Fernöffnung verwenden** oder **Berechtigungen für bestehende Benutzer erweitern**.
  </Step>

  <Step title="Verbindung prüfen">
    Erstelle eine Testbuchung und öffne ihre Detailansicht. Prüfe dort den Status, den Zugangszeitraum, die Tür und bei Gastzugängen den PIN-Code.
  </Step>
</Steps>

Sobald die Verbindung aktiv ist, erstellt und entfernt anny Zutrittsrechte automatisch anhand deiner Regeln.

Das folgende Bild zeigt, wo du eine Zutrittsregel für Buchungen anlegst und eine Ressource mit UniFi-Türen verknüpfst.

![Zutrittsregel für Buchungen konfigurieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/88240436/82f4832243317df534a5ff72fbd4/Frame-2B10-284-29.png?expires=1785256200\&signature=5cabf6b407831d49edccaf16551595265408764bd8c72d24b4082ee22c2f7fce\&req=2N1twVj%2BrzFk2hL085Zhobi7pxl56CpAdW9AtamG7AAxmmpHpfK%2BPfJUepmI%0AdI%2FStIocQRnF3GuG%0A)

Die Detailansicht einer Buchungsregel zeigt die zugeordnete Ressource, die Türen sowie den zeitlichen Vor- und Nachlauf.

![Details einer Buchungsregel](https://downloads.intercomcdn.eu/i/o/niegcmk9/88240434/d7a709a789510c9355cef96960c1/Frame-2B10-2B--2B2025-01-16T172911_733.png?expires=1785256200\&signature=e87d0a22101f6cdb85eba4f7cfb3929547f600c6ede2299660808506bc792ef8\&req=2N1twVj%2BrzNk2hL085ZhobBGZIK%2Fic1k3buYVJzgiLaabHGo9sJrypdCxC5T%0AIu7VIjl%2F8TD46KOE%0A)

Für Communitys ordnest du einer Community eine oder mehrere Türen zu. So erhalten ihre Mitglieder die festgelegten Zutrittsrechte.

![Zutrittsregel für eine Community konfigurieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/88240433/4f74f702948bfe661651cf9d752e/Frame-2B10-285-29.png?expires=1785256200\&signature=cddffa706d53644b841b3cb2bf2239a70c208fa7b6bfbefa3372f575da08bb26\&req=2N1twVj%2BrzRk2hL085Zhoel5fVQBPkaKkGHPO9SC7zUopQBlRZ9HzcCHJ9gN%0ApWNAZ4UH9F%2FLAA4q%0A)

<Tip>
  Über die drei Punkte an einer Regel kannst du bestehende Zuordnungen bearbeiten oder löschen. Du kannst mehrere Türen einer Ressource zuordnen und umgekehrt.
</Tip>

### Einstellungen & Optionen

| Einstellung | Wirkung |
| - | - |
| Ressource | Erstellt ein Zutrittsrecht, wenn die Ressource gebucht wird. |
| Community | Gewährt Mitgliedern der ausgewählten Community Zugang zu den zugeordneten Türen. |
| Tür | Legt fest, welche UniFi-Tür geöffnet werden darf. |
| Zugang vor der Buchung / Zugang nach der Buchung | Erweitert den Zutrittszeitraum um die konfigurierte Zeit. |
| Berechtigungen für bestehende Benutzer erweitern | Findet anny einen UniFi-Account mit der Buchungs-E-Mail, läuft der Zugang über die UniFi App. Ohne Treffer und ohne diese Option erhält die Person einen Gastzugang per PIN-Code. |
| Fernöffnung verwenden | Ermöglicht die Türöffnung über die Buchungsansicht in der anny App oder im Browser (Remote Open). |

Du kannst aktive und inaktive Smart-Lock-Zugänge in der Buchungsdetailansicht prüfen. Dort siehst du den Status, den Zugangszeitraum, die Tür, das Erstellungsdatum und bei Gastzugängen den PIN-Code.

![Smart-Lock-Zugänge in der Buchungsdetailansicht](https://downloads.intercomcdn.eu/i/o/niegcmk9/88240435/0c37367712dd40ec1d33770da041/Frame-2B10-286-29.png?expires=1785256200\&signature=e49a356cdca0ffb0df886f7f3b13c77fb6d41947cf117e5653eb7f9e4e2216d4\&req=2N1twVj%2BrzJk2hL085ZhoVsGY5ga%2F36hA8Mey6iH%2BwBKjynDibj93djrto51%0AF93C%2BEpWkpy0fxQD%0A)

| Status | Bedeutung |
| - | - |
| In Bearbeitung | anny hat den Zugang angefordert, UniFi hat ihn aber noch nicht vergeben. |
| Geplant | Der App-Zugang für einen bestehenden UniFi-Account wird kurz vor Beginn automatisch erstellt. |
| Erfolgreich | Der Zugang ist aktiv und kann im angezeigten Zeitraum verwendet werden. |
| Entfernt | Das System oder ein:e Admin hat den Zugang entfernt. Die Person kann die Tür nicht mehr öffnen. |

### Remote Open

Mit der Remote-Open-Funktion können Kund:innen Türschlösser per Knopfdruck öffnen: direkt über die anny Homepage oder die Buchungsansicht.

| Ort | Wo öffnest du die Tür? |
| - | - |
| E-Mail | Der Link **Öffnen** leitet in den Browser weiter. Dort erscheint der Button **Tür entriegeln**. |
| anny App | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** sowie in der Buchung. |
| Browser | Der Button **Tür entriegeln** erscheint auf der Home-Seite unter **Heutige Zugänge** sowie in der Buchung. |

Die Buchungsansicht zeigt den Button nur während des gültigen Zugangszeitraums.

![Tür über Remote Open in der Buchungsansicht öffnen](https://downloads.intercomcdn.eu/i/o/niegcmk9/88291350/86561e643e8d2f57c7818bd3a446/Frame%2B49%2B-282-29.png?expires=1785256200\&signature=dac2e0392b1633682e6e7198c8305ea300cbc8d50bf31a40833207ffefe8d113\&req=2N1tzFn5qTdk2hL085ZhoV0BhxwCZUKUU9PP9%2FZhxR30NoOEYjrnpqKjD5%2Bt%0AiFhaPpJLq8ohYzb2%0A)

Für Remote Open über eine Community aktivierst du die Option **Fernöffnung verwenden** in der Community-Regel.

![Remote Open für eine Community aktivieren](https://downloads.intercomcdn.eu/i/o/niegcmk9/88291349/96a7273cfd5ca404984d5c55ca48/Frame%2B53%2B-286-29.png?expires=1785256200\&signature=9f1330239a730dccaa699f51ac04368fe831d7a3c1478978ec632c000119c503\&req=2N1tzFn5qD5k2hL085Zhobg0rpDfZ9CtwwDF1U6soRRYfzENvwo3AlbigqZe%0A8bhJqpn%2B3qE628Fl%0A)

## Einschränkungen

Die UniFi-Integration unterstützt nicht:

* die Einrichtung, Wartung oder Absicherung deines UniFi-Netzwerks und deiner Türhardware
* eine Verbindung ohne öffentlich erreichbare Host-URL
* den Zugang über die UniFi App ohne aktivierte Option **Berechtigungen für bestehende Benutzer erweitern** und ohne UniFi-Account mit der Buchungs-E-Mail
* einen Gastzugang per PIN ohne kompatible UniFi-Hardware mit Keypad
* Remote Open über eine Community ohne aktivierte Option **Fernöffnung verwenden** in der Community-Regel

## Verbindung trennen

<Warning>
  Wenn du die bestehenden Zugänge behalten möchtest, aber keine neuen Zugänge erstellt werden sollen, deaktiviere die Integration. Wenn alles zurückgesetzt und gelöscht werden soll, lösche die Integration.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Wie erhalten Kund:innen Zugang zur gebuchten Tür?">
    Standardmäßig erzeugt anny einen PIN-Code für den Gastzugang. Aktivierst du **Berechtigungen für bestehende Benutzer erweitern** und existiert ein UniFi-Account mit der Buchungs-E-Mail, läuft der Zugang über die UniFi App. Zusätzlich kann Remote Open verfügbar sein.
  </Accordion>

  <Accordion title="Wann ist der Zugang gültig?">
    Der Zugang gilt für den Buchungszeitraum einschließlich des Vor- und Nachlaufs, den du in der Zutrittsregel festgelegt hast.
  </Accordion>

  <Accordion title="Kann ich mehrere Türen mit einer Ressource verbinden?">
    Ja. Du kannst einer Ressource mehrere Türen zuordnen und eine Tür mit mehreren Ressourcen verknüpfen.
  </Accordion>

  <Accordion title="Was passiert bei einer Stornierung?">
    Wenn eine Buchung storniert und ihr Zugang entfernt wird, kann die gebuchte Tür nicht mehr über dieses Zutrittsrecht geöffnet werden.
  </Accordion>

  <Accordion title="Wo finde ich den API-Token in UniFi?">
    Erstelle den API-Token in der UniFi Access App. Trage ihn anschließend zusammen mit der Host-URL in anny ein.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Verbindung zu UniFi lässt sich nicht herstellen">
    Die Host-URL ist möglicherweise nicht von außen erreichbar oder der API-Token ist ungültig. Prüfe die Host-URL, den Token sowie die Netzwerk- und Firewall-Konfiguration.
  </Accordion>

  <Accordion title="Mein Zugang bleibt im Status „In Bearbeitung“">
    UniFi hat das angeforderte Zutrittsrecht noch nicht bestätigt. Prüfe die Verbindung und die zugeordnete Tür in UniFi. Teste die Regel anschließend mit einer neuen Buchung.
  </Accordion>

  <Accordion title="Remote Open wird nicht angezeigt">
    Prüfe den gültigen Zugangszeitraum und die Türzuordnung. Bei Community-Zugängen muss Remote Open zusätzlich in den Community-Berechtigungen aktiviert sein.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Einordnung:** UniFi (Ubiquiti UniFi Access) ist eine Smart-Lock-Integration (Zutritt/Türöffnung), gehört zur Feature-Gruppe der Smart-Locks (Feature INTEGRATIONS\_SMART\_LOCKS, laut Artikel ab Professional-Plan; Plan-Zuordnung liegt in der Datenbank und ist nicht aus dem Code verifizierbar). Bei Fragen zur Auswahl oder zum Vergleich anderer Schließsysteme auf den Artikel „Smart-Lock-Integrationen“ unter `/smart-locks-uebersicht` verweisen. Fragen zur Kompatibilität einzelner UniFi-Geräte anhand der offiziellen UniFi-Dokumentation klären, nicht aus der anny Integrationslogik ableiten.
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **UniFi** → Felder **Host-URL** + **API-Token** → Button **Authentifizierung überprüfen**. Regeln: gleiche Seite, Panels **Zugang durch Buchungen** und **Zugang durch Communities** → **Hinzufügen**. Felder im Regel-Editor: Ressource bzw. Community, Türauswahl (in der generischen UI **Zylinder auswählen** / Spalte **Schlösser**; für UniFi sind das Türen), **Zugang vor der Buchung**, **Zugang nach der Buchung**, Schalter **Fernöffnung verwenden** (Spalte **Fernöffnung**) und — nur bei Buchungsregeln — **Berechtigungen für bestehende Benutzer erweitern**. Deaktivieren/Aktivieren über den **Toggle** oben rechts; Löschen über die **drei Punkte** → **Löschen**.
>
> **Verbindung:** anny spricht die UniFi-Schnittstelle über die Host-URL auf Port 12445 an. Die Host-URL muss von außen erreichbar sein und sollte keinen eigenen Port enthalten. Zugangsdaten (Host-URL/API-Token) lassen sich nur bei deaktivierter Integration ändern; schlägt die Prüfung fehl, verwirft anny den Token.
>
> **Quirks:** (1) Standardweg ist der Gastzugang per PIN (UniFi-„Visitor“). App-Zugang (Zuordnung zum bestehenden UniFi-Account) erfolgt nur, wenn die Buchungsregel **Berechtigungen für bestehende Benutzer erweitern** aktiviert hat UND ein UniFi-Account mit der Buchungs-E-Mail existiert. (2) App-Zugänge werden Just-in-Time erstellt: rund 10 Minuten vor Beginn hinzugefügt, am Ende entfernt; bis dahin Status **Geplant**. anny nutzt dafür pro Tür eine Policy mit dem Namenszusatz „anny“ und den UniFi-Zeitplan „always access“; fehlende Policies werden automatisch neu erstellt. (3) Nur bestätigte Buchungen mit Kund:in lösen Zugänge aus; Blocker und angefragte/abgelehnte/stornierte Buchungen nicht. (4) Regeln auf einer übergeordneten Ressource greifen auch für Unterressourcen; die spezifischere Regel gewinnt. (5) Ändern der Türen/Ressource einer Regel bei aktiver Integration erstellt künftige Zugänge neu. (6) Es gibt keinen URL-Zugangstyp und keine externe Anzeige-URL („Zugang beim Anbieter anzeigen“ ist für UniFi leer). (7) Fehlgeschlagene Zugänge: bei 429/503 Wiederholung nach kurzer Zeit; endgültige Fehlschläge → Status **Fehlgeschlagen** und E-Mail an die hinterlegten Personen; liegt der Start > 48 h in der Zukunft, wird neu geplant.
>
> **Statuslabels (Buchungsdetail):** **In Bearbeitung** (pending), **Geplant** (scheduled), **Erfolgreich** (successful), **Entfernt**, **Fehlgeschlagen**, **Aufräumen**, **Nicht autorisiert**. Feldname der Tür in der Detailansicht: **Türschloss**.
>
> **Remote Open (Fernöffnung):** Kundenbutton heißt **Tür entriegeln** (Home-Seite unter **Heutige Zugänge** und in der Buchung), E-Mail-Link heißt **Öffnen** und führt in den Browser; Admin-Aktion in der Buchungsdetailansicht heißt **Schloss entsperren**. Button nur im gültigen Zugangszeitraum aktiv. Community-Remote-Open über die Option **Fernöffnung verwenden** in der Community-Regel.
>
> **Aktivitätsprotokoll:** „hat den Zugang zu  eingerichtet“ / „hat den Zugang zu  entfernt“.


# Urban Sports Club mit anny verbinden
Source: https://docs.anny.co/urban-sports-club

Ü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 |
| Standort | Der Standort bereits übertragener Termine wird nicht aktualisiert. Storniere den Termin und lege ihn mit dem richtigen Standort neu an. |
| 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
* Nachträgliche Standortänderung an bereits übertragenen Terminen: Der Standort wird nicht nachsynchronisiert. Termine müssen storniert und mit dem richtigen Standort neu angelegt 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="Wird eine nachträgliche Standortänderung am Termin an USC übertragen?">
    Nein. Der Standort eines bereits an Urban Sports Club übertragenen Termins wird nicht nachsynchronisiert. Das gilt auch, wenn du den Standort danach unter **Bereitgestellte Ressourcen** am verfügbaren Termin änderst.

    Storniere den Termin und lege ihn mit dem richtigen Standort neu an. Prüfe vorher im **Standort-Sync**, dass die Standort-Ressource der passenden USC Location zugeordnet ist.
  </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. `locationId` wird nur beim CreateEvent gesetzt, es gibt kein Location-PATCH. Änderungen unter **Bereitgestellte Ressourcen**, im Standort-Sync oder am Standort-Feld der Kursregel aktualisieren bestehende USC-Events nicht. Workaround: Termin stornieren (CancelEvent, UI: **Termin stornieren**) und neu anlegen (CreateEvent). `getLocationIdForResource` prüft `timeslot.resource_id` (Kursressource) in `location_map`, sonst `rule.locationId`; allocated/bereitgestellte Standort-Ressourcen wertet EventService aktuell nicht aus, obwohl der UI-Text („Wenn eine Ressource mit einem Kursevent verbunden ist, wird ihr Urban Sports-Standort als Veranstaltungsort verwendet") das nahelegt. (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).


# URL Anzeigetafeln
Source: https://docs.anny.co/url-display-boards

Zeige die Belegung deiner Ressourcen in Echtzeit auf jedem browserfähigen Gerät an, ohne App-Installation.

Mit URL Anzeigetafeln stellst du aktuelle und bevorstehende Buchungen als Live-Übersicht auf einem beliebigen Endgerät mit Browser dar. Ideal für Eingangsbereiche, Etagen-Wegweiser oder Infoscreens, auf denen Mitarbeitende und Besucher:innen die Raumbelegung auf einen Blick sehen.

<Info>
  Aktiviere vorab das Feature **Anzeigetafeln & Raumdisplays** unter **Account-Einstellungen** → **Features**.
</Info>

## Wie funktionieren URL Anzeigetafeln?

Eine URL Anzeigetafel ist eine browserbasierte Seite, die du im Admin-Bereich unter **Displays** anlegst. Du verknüpfst Ressourcen als Widgets, passt Farben und Datenschutz-Optionen an und erhältst einen Link. Diesen Link öffnest du auf einem Smart-TV, Tablet oder Monitor im Kiosk-Modus. Die Anzeige aktualisiert sich in Echtzeit und blättert bei mehreren Ressourcen automatisch alle 10 Sekunden weiter.

Der grundlegende Ablauf:

## Wann nutze ich das?

* **Du willst im Eingangsbereich eine Übersicht aller Räume anzeigen**: Besucher:innen und Mitarbeitende sehen sofort, welcher Raum frei oder belegt ist.
* **Du benötigst einen Wegweiser pro Etage oder Bereich**: Lege pro Etage eine eigene Anzeigetafel mit den jeweiligen Ressourcen an.
* **Dein Endgerät hat keinen App Store (z. B. Smart-TV, älteres Tablet)**: URL Anzeigetafeln laufen in jedem Browser, ohne Installation.
* **Nicht geeignet für**: Interaktive Raumdisplays mit Ad-hoc-Buchung, Sleep Mode oder anny Pass. Nutze dafür die [anny Display App](/display-app).

## Zusammenhang mit anderen Features

* **Check-In & Check-Out**: Auf Touch-fähigen Geräten können Nutzer:innen über den "book now" Button direkt buchen und einchecken.
* **Communities**: Die Anzeigetafel zeigt alle verknüpften Ressourcen unabhängig von Community-Berechtigungen. Die Buchung über den "book now" Button erfordert jedoch eine gültige Anmeldung.

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Name | Interner Name zur Organisation der Anzeigetafeln |
| Widgets (Ressourcen) | Ressourcen, die auf der Tafel angezeigt werden |
| Reihenfolge | Per Drag & Drop steuerbar |
| Farben | Anpassbare Farbgestaltung der Anzeigetafel |
| Anonymisierung | Buchungsbeschreibungen ausblenden |
| Touch-Funktion | "book now" Button bei Touch-fähigen Geräten |

Auf der Buchungsseite sehen Nutzer:innen den vollen Buchungsprozess, wenn sie über "book now" auf der Anzeigetafel buchen.

<Tip>
  Du kannst beliebig viele Anzeigetafeln anlegen und Ressourcen auf mehreren Tafeln gleichzeitig als Widget hinterlegen. So erstellst du z. B. eine Gesamtübersicht für den Eingang und separate Etagen-Anzeigen.
</Tip>

## Praxisbeispiele

<AccordionGroup>
  <Accordion title="Ein Unternehmen zeigt im Eingangsbereich eine Übersicht aller Meetingräume">
    Besucher:innen und Mitarbeitende sollen auf einen Blick sehen, welcher Raum belegt ist und welcher frei.
  </Accordion>

  <Accordion title="Ein Coworking-Space nutzt eine Anzeigetafel als Wegweiser pro Etage">
    Auf jeder Etage soll nur die Belegung der dortigen Räume angezeigt werden.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Auf welchen Geräten funktioniert die URL Anzeigetafel?">
    Auf jedem Gerät mit Internetzugang und Browser: Smart-TVs, iPads, Android-Tablets, Monitore mit angeschlossenem PC oder Raspberry Pi.
  </Accordion>

  <Accordion title="Wie aktiviere ich den Kiosk-Modus auf iOS?">
    Gehe zu **Einstellungen** → **Allgemein** → **Bedienungshilfen** → **Geführter Zugriff** und aktiviere die Funktion. Lege einen Zugangscode fest. Öffne dann die Anzeigetafel im Browser und starte den Geführten Zugriff per Dreifachklick auf die Seitentaste.
  </Accordion>

  <Accordion title="Können Nutzer:innen über die Anzeigetafel direkt buchen?">
    Ja, wenn das Endgerät eine Touch-Funktion hat. Über den "book now" Button gelangen Nutzer:innen zum Buchungsprozess. Für kostenpflichtige Buchungen oder Anmeldepflicht wird auf die Buchungsseite weitergeleitet.
  </Accordion>

  <Accordion title="Was ist der Unterschied zur Display App?">
    Die URL Anzeigetafel ist rein browserbasiert, ohne Installation. Die Display App bietet zusätzlich Sleep Mode, Ad-hoc-Buchungen, anny Pass, NFC und Gastmodus als native Features.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Die Anzeigetafel zeigt keine Ressourcen an">
    Prüfe, ob unter **Widgets** mindestens eine Ressource hinzugefügt ist. Stelle sicher, dass das Feature **Anzeigetafeln & Raumdisplays** aktiviert ist.
  </Accordion>

  <Accordion title="Die Anzeige blättert nicht automatisch weiter">
    Die automatische Paginierung greift erst ab mehr Ressourcen, als auf eine Seite passen. Prüfe die Bildschirmgröße: Auf größeren Displays passen mehr Widgets auf eine Seite.
  </Accordion>

  <Accordion title="Design-Änderungen werden nicht angezeigt">
    Änderungen an Farben und Einstellungen werden in Echtzeit übertragen. Lade die Seite im Browser einmal neu (Hard Refresh), falls das Gerät die Änderung nicht sofort anzeigt.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * Feature-Name in Account-Einstellungen: "Anzeigetafeln & Raumdisplays" (identisch mit Display App)
> * UI-Pfad: **Displays** → **+Neu** (nach Feature-Aktivierung sichtbar)
> * Kein Pairing nötig (Abgrenzung zur Display App)
> * Link funktioniert auf jedem browserfähigen Gerät
> * Paginierung: Blättert alle 10 Sekunden automatisch bei mehreren Seiten
> * Touch: "book now" Button nur bei Touch-Geräten relevant
> * Anonymisierung: Buchungsbeschreibungen können ausgeblendet werden
> * Reihenfolge: Steuerbar per Drag & Drop im Admin
> * Mehrfachnutzung: Ressourcen können auf beliebig vielen Anzeigetafeln gleichzeitig als Widget erscheinen
> * Abgrenzung Display App: Display App = native App mit Sleep Mode, Ad-hoc-Buchungen, anny Pass, NFC, Gastmodus. URL Anzeigetafeln = rein browserbasiert, keine Installation, keine nativen Features
> * Kiosk-Modus iOS: Geführter Zugriff (Einstellungen → Allgemein → Bedienungshilfen)
> * Video-Referenz: [https://www.youtube.com/watch?v=UeBk\_WPos\_0](https://www.youtube.com/watch?v=UeBk_WPos_0)


# Nutzerprofil & Einstellungen
Source: https://docs.anny.co/user-profile-settings

Richte dein anny Profil ein, passe persönliche Daten an und verwalte Benachrichtigungen, Zahlungsmethoden und Abonnements.

In deinem Profil verwaltest du alle persönlichen Daten, Zahlungsmethoden und Benachrichtigungen. Von hier aus steuerst du auch deine Sichtbarkeit in Communities und verbindest dich mit Kolleg:innen über Connected Persons.

## Account erstellen

Um anny als Endnutzer:in zu verwenden, erstellst du dir ein kostenloses Konto.

<Steps>
  <Step title="Registrierungsseite öffnen">
    Öffne die Buchungsseite deiner Organisation oder gehe direkt zu [anny.co](https://anny.co) und klicke auf **Registrieren**.
  </Step>

  <Step title="Buchung vornehmen auswählen">
    Wähle den Tab **Buchung vornehmen** aus. Klicke nicht auf "Ressourcen verwalten", da du sonst einen Admin-Account anlegst.
  </Step>

  <Step title="Daten eingeben">
    Gib Vorname, Nachname, E-Mail-Adresse und ein Passwort ein. Akzeptiere die Datenschutzerklärung und Nutzungsbedingungen und klicke auf **Registrieren**.
  </Step>
</Steps>

<Info>
  Unten auf der Anmelde- und Registrierungsseite wählst du unter **Datenregion deines Kontos** zwischen **anny.co** (**Standard**) und **anny.eu** (**Für öffentliche Einrichtungen**). Die beiden Regionen haben getrennte Konten. Nimm die Region, in der deine Organisation liegt.
</Info>

<Tip>
  Alternativ kannst du dich mit [SSO](/sso-login), Passkey, Google oder Apple anmelden, sofern dies von deiner Organisation unterstützt wird.
</Tip>

## Profil aufrufen

Du gelangst zu deinem Profil, indem du oben rechts auf deinen **Avatar** klickst und **Profil** auswählst.

Dein Profil zeigt oben deinen Namen, deine Bio und deine hinterlegten Kenntnisse, Rollen und Interessen. Darunter findest du die einzelnen Einstellungsbereiche.

## Avatar & Profilbild

Du hast zwei Möglichkeiten, dein Profilbild zu gestalten:

* **Foto hochladen:** Lade ein eigenes Profilbild hoch.
* **Avatar-Builder:** Erstelle ein personalisiertes "annymoji". Wähle Hautfarbe, Augen, Mund, Frisur, Bart, Kleidung und Accessoires. Der Avatar hilft Kolleg:innen, dich auf der Kartenansicht schnell zu finden.

Zusätzlich kannst du unter **Kenntnisse, Rollen und Interessen** Tags hinterlegen, die auf deinem Profil sichtbar sind (z. B. Sprachen, Skills, Hobbys).

## Einstellungen im Überblick

| Bereich | Was du hier findest |
| - | - |
| Persönliche Informationen | Name, E-Mail, Geburtsdatum, Telefon, Unternehmen, Job-Titel, Abteilung, Bio, Passwort ändern, Profil löschen |
| Adressen | Rechnungs- und Lieferadressen verwalten |
| Zahlungsmethoden | Kreditkarte und SEPA-Lastschrift hinterlegen (siehe [Zahlungs- & Abomanagement](/manage-subscriptions)) |
| Benachrichtigungen | E-Mail- und Push-Benachrichtigungen pro Kategorie ein-/ausschalten |
| Communities | Übersicht deiner Mitgliedschaften, Inkognito-Modus aktivieren |
| Connected Persons | Verbindungen zu Kolleg:innen verwalten, Berechtigungen vergeben |
| Firmenkonto | Verknüpfung mit deinem Unternehmensprofil |
| Abonnements | Aktive, inaktive und beantragte Abos (siehe [Zahlungs- & Abomanagement](/manage-subscriptions)) |
| Sprache | Anzeigesprache ändern |

## Persönliche Informationen

Unter **Persönliche Informationen** kannst du folgende Daten anpassen:

* Titel und Geschlecht
* Vorname und Nachname
* Geburtsdatum
* E-Mail-Adresse (nicht änderbar bei SSO-Anmeldung)
* Handynummer und Festnetznummer
* Unternehmen (mit Rechtsform), Job-Titel und Abteilung
* Bio

Ganz unten auf der Seite findest du die Optionen **Profil löschen** und **Passwort ändern**.

<Warning>
  Wenn du dein Profil löschst, werden alle deine Daten unwiderruflich entfernt. Bestehende Buchungen werden storniert.
</Warning>

## Benachrichtigungen

Du kannst Benachrichtigungen granular pro Kategorie steuern:

* **Buchungen:** Bestätigungen, Erinnerungen, Änderungen
* **Check-Ins:** Aufforderungen zum Einchecken
* **Einladungen:** Buchungseinladungen von Kolleg:innen
* **Abonnements:** Abo-Änderungen und Zahlungshinweise

Jede Kategorie lässt sich unabhängig per E-Mail und/oder als Push-Benachrichtigung (Desktop/App) aktivieren oder deaktivieren.

## Communities

Als Mitglied einer Community hast du Zugriff auf bestimmte Ressourcen mit entsprechenden Konditionen. Je nach Einstellung deiner Organisation bist du entweder sichtbar oder im Inkognito-Modus.

So setzt du dich auf Inkognito:

<Steps>
  <Step title="Communities öffnen">
    Gehe im Profil zu **Communities**.
  </Step>

  <Step title="Inkognito aktivieren">
    Klicke auf die drei Punkte neben der Community und wähle **Inkognito**.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Wie ändere ich mein Passwort?">
    Öffne im Profil die **Persönlichen Informationen** und klicke ganz unten auf **Passwort ändern**. Gib dein aktuelles und das neue Passwort ein.
  </Accordion>

  <Accordion title="Warum kann ich meine E-Mail-Adresse nicht ändern?">
    Bei einer Anmeldung über SSO (Single Sign-On) oder Shibboleth wird deine E-Mail vom Identity Provider gesteuert. Eine Änderung ist dann nur dort möglich.
  </Accordion>

  <Accordion title="Was passiert, wenn ich mein Profil lösche?">
    Alle personenbezogenen Daten werden unwiderruflich gelöscht und bestehende Buchungen storniert. Dieser Vorgang kann nicht rückgängig gemacht werden.
  </Accordion>

  <Accordion title="Wo finde ich meine Buchungskontingente?">
    Buchungskontingente werden auf der Home-Seite deiner Buchungsseite angezeigt, sofern dein Abo Kontingente beinhaltet.
  </Accordion>

  <Accordion title="Wie wechsle ich zwischen Communities?">
    Über den Bereich Entdecken kannst du oben links die Community wechseln. Alternativ siehst du deine Communities auf der Home-Seite.
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="Meine Änderungen werden nicht übernommen">
    Profiländerungen (z. B. Adresse) werden erst mit der nächsten Buchung in die Kundenkarte des Anbieters übertragen. Stelle sicher, dass du deine Daten vor der nächsten Buchung aktualisierst.
  </Accordion>

  <Accordion title="Ich sehe keine Benachrichtigungen in der App">
    Prüfe in den Handy-Einstellungen, ob Push-Benachrichtigungen für die anny App aktiviert sind. Stelle zusätzlich im Profil unter Benachrichtigungen sicher, dass die gewünschten Kategorien eingeschaltet sind.
  </Accordion>

  <Accordion title="Mein Inkognito-Modus funktioniert nicht">
    Stelle sicher, dass du den Inkognito-Modus pro Community einzeln aktiviert hast. Der Modus gilt nicht accountweit, sondern separat je Community.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> * UI-Pfad Profil: Avatar (oben rechts) → Profil
> * Registrierung: Tab "Buchung vornehmen" = Endnutzer-Account. Tab "Ressourcen verwalten" = Admin-Account.
> * Cloud-Login/Registrierung (Cognitor): Footer **Datenregion deines Kontos** wechselt zwischen auth.anny.co (anny.co / Standard) und auth.anny.eu (anny.eu / Für öffentliche Einrichtungen). Getrennte User-Bases. On-Prem ohne APP\_REGION zeigt den Schalter nicht.
> * E-Mail-Änderung nicht möglich bei SSO- oder Shibboleth-Login
> * Benachrichtigungen granular pro Kategorie: Buchungen, Check-Ins, Einladungen, Abonnements
> * Connected Persons: unabhängig von Communities, funktioniert auch per E-Mail-Einladung bei Personen außerhalb der eigenen Community
> * Profil löschen und Passwort ändern: befinden sich ganz unten auf der Seite "Persönliche Informationen"
> * Profiländerungen werden erst bei nächster Buchung in Anbieter-Kundenkarte synchronisiert
> * Zahlungsmethoden und Abonnements: eigener Artikel unter Zahlungs- & Abomanagement


# Zoom mit anny verbinden
Source: https://docs.anny.co/zoom

Erstelle für jede Buchung automatisch ein Zoom-Meeting und teile den Einladungslink mit deinen Kund:innen.

[Zoom](https://zoom.us) ist einer der bekanntesten Dienste für Videokonferenzen. Mit der Integration plant anny für deine Buchungen automatisch Zoom-Meetings und verteilt die Einladungslinks, ohne dass du manuell Termine in Zoom anlegen musst.

Mit Zoom kannst du in anny:

* Für jede Buchung einer Ressource automatisch ein Zoom-Meeting erstellen lassen
* Den Beitritts-Link samt Meeting-ID und Passwort automatisch an deine Kund:innen verteilen
* Pro Ressource festlegen, welche Zoom-Nutzer:in das Meeting als Organisator:in erhält

Die Integration lohnt sich für alle, die Termine online durchführen, zum Beispiel Beratungsgespräche, Coachings, Sprechstunden oder Online-Kurse.

## Typische Anwendungsfälle

| Anwendungsfall | Beschreibung |
| :- | :- |
| Online-Beratung | **Jede gebuchte Beratung bekommt automatisch ihr Zoom-Meeting.** Kund:innen erhalten den Beitritts-Link direkt mit der Buchungsbestätigung und die Berater:in startet das Meeting aus der Buchungsübersicht. |
| Kurse und Coachings | **Teilnehmer:innen eines Termins treten demselben Meeting bei.** Buchen mehrere Personen denselben Zeitraum einer Ressource mit freier Kapazität, teilen sie sich automatisch ein gemeinsames Zoom-Meeting. |
| Sprechstunden im Team | **Jede Ressource hat ihre eigene Organisator:in.** Du verknüpfst jede Sprechstunden-Ressource mit der passenden Zoom-Nutzer:in aus deinem Konto, damit Meetings immer bei der richtigen Person landen. |

## Wie die Zoom-Verbindung funktioniert

Die Verbindung wird über den Zoom-Login hergestellt: Du klickst in anny auf **Autorisieren**, meldest dich bei Zoom an und erlaubst anny den Zugriff auf dein Zoom-Konto. Ein API-Schlüssel ist nicht nötig. Mit **Verbindung testen** prüfst du jederzeit, ob die Verbindung steht.

anny greift nur auf zwei Dinge zu: die Nutzerliste deines Zoom-Kontos (für die Auswahl der Organisator:innen) und die Meetings, die anny selbst für Buchungen anlegt. Bestehende Meetings und Einstellungen deines Zoom-Kontos bleiben unangetastet.

So läuft es bei einer Buchung ab:

1. Eine Buchung geht für eine verknüpfte Ressource ein.
2. anny erstellt beim hinterlegten **Organisator des Meetings** ein geplantes Zoom-Meeting. Titel, Beginn und Dauer übernimmt anny aus der Buchung, die Zeitzone von der Ressource.
3. Kund:innen erhalten den Beitritts-Link automatisch: als Button **Zoom Meeting beitreten** in der Buchungs-E-Mail (samt Zoom ID und Passwort), im Kalendereintrag und in den Buchungsdetails. Eingeloggte Team-Mitglieder sehen dort stattdessen **Zoom Meeting starten**.
4. Wird die Buchung verschoben, aktualisiert anny das Meeting. Wird sie storniert, abgelehnt oder gelöscht, löscht anny auch das Zoom-Meeting.

Widerrufst du die Autorisierung oder läuft sie ab, kann anny keine Meetings mehr erstellen, aktualisieren oder löschen. Die Verantwortlichen deiner Organisation erhalten in dem Fall die E-Mail „Die Zoom Integration hat einen Fehler" und du musst dich über **Autorisieren** erneut anmelden.

## Zoom verbinden

### Voraussetzungen

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

* Ein aktives Zoom-Konto mit den Nutzer:innen, die Meetings als Organisator:innen erhalten sollen
* Die Berechtigung, in diesem Zoom-Konto Apps zu autorisieren
* Admin-Rechte in deinem anny Account

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen**, füge die Zoom-Integration hinzu und klicke im Bereich **Authentifizierung** auf **Autorisieren**. Melde dich bei Zoom an und bestätige den Zugriff für anny. Mit **Verbindung testen** prüfst du, ob die Anmeldung erfolgreich war.
  </Step>

  <Step title="Konfigurieren">
    Lege in den **Zoom-Einstellungen** fest, welche Ressourcen Meetings bekommen:

    1. Klicke auf **Hinzufügen**, um eine neue Zoom-Verbindung zu erstellen.
    2. Wähle unter **Wähle die Ressource** die Ressource aus (z. B. Beratungsraum 1).
    3. Optional: Begrenze die Verbindung über **Buchungsoptionen auswählen** auf bestimmte Buchungsoptionen. Ohne Auswahl gilt sie für **Alle Buchungsoptionen**.
    4. Wähle unter **Wähle den Organisator des Meetings** die Zoom-Nutzer:in, bei der die Meetings angelegt werden.
    5. Bestätige die Verbindung und wiederhole die Schritte für weitere Ressourcen.
  </Step>

  <Step title="Aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts.
  </Step>
</Steps>

Sobald die Integration aktiv ist, erstellt anny für jede neue Buchung einer verknüpften Ressource automatisch ein Zoom-Meeting und verteilt die Links.

<Tip>
  Teste die Integration mit einer Testbuchung: Buche eine verknüpfte Ressource und prüfe, ob die Buchungsbestätigung den Button **Zoom Meeting beitreten** enthält und das Meeting im Zoom-Konto der Organisator:in erscheint.
</Tip>

### Einstellungen & Optionen

| Einstellung | Beschreibung |
| :- | :- |
| Ressource | Die Ressource, für deren Buchungen Meetings erstellt werden. Jede Zoom-Verbindung gilt für genau eine Ressource; Unterressourcen verbindest du einzeln. |
| Buchungsoptionen | Begrenzt die Verbindung auf bestimmte Buchungsoptionen. Ohne Auswahl gilt **Alle Buchungsoptionen** und jede Buchung der Ressource erhält ein Meeting. |
| Organisator des Meetings | Die Zoom-Nutzer:in aus deinem Konto, bei der die Meetings angelegt werden. Diese Person kann die Meetings in Zoom starten und verwalten. |

<Tip>
  Die Zoom-Verbindungen lassen sich nur bearbeiten, solange die Integration deaktiviert ist. Schalte den **Toggle** vor Änderungen kurz aus und danach wieder ein.
</Tip>

## Einschränkungen

Die Zoom-Integration unterstützt nicht:

* **Vererbung auf Unterressourcen:** Eine Zoom-Verbindung gilt nur für die gewählte Ressource. Buchungen ihrer Unterressourcen erhalten kein Meeting; verbinde Unterressourcen einzeln.
* **Meetings für bestehende Buchungen:** Beim Aktivieren der Integration werden für bereits vorhandene Buchungen keine Meetings rückwirkend erstellt.
* **Meeting-Optionen aus anny:** anny setzt nur Titel, Zeit, Dauer und Zeitzone. Passwort, Warteraum und weitere Optionen bestimmen die Einstellungen deines Zoom-Kontos.
* **Meeting-Erinnerungen:** anny verschickt keine gesonderten Erinnerungs-E-Mails vor dem Meeting-Start.
* **Meetings für Blocker:** Interne Blocker-Buchungen erhalten nie ein Zoom-Meeting.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, erstellt anny keine neuen Meetings mehr. Bestehende Zoom-Meetings bleiben erhalten, werden aber nicht mehr aktualisiert oder gelöscht, auch wenn die zugehörige Buchung verschoben oder storniert wird. Beim Löschen öffnet sich ein Dialog mit einer Anleitung, wie du die anny App zusätzlich aus deinem Zoom-Konto entfernst (Zoom Marketplace), oder du wählst **Nur bei anny entfernen**. Bereits erstellte Meetings bleiben in deinem Zoom-Konto bestehen. Deinstallierst du anny direkt im Zoom Marketplace, wird die Integration auch in anny automatisch entfernt.
</Warning>

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

## FAQ

<AccordionGroup>
  <Accordion title="Woher bekommen meine Kund:innen den Zoom-Link?">
    Automatisch von anny: Die Buchungs-E-Mail enthält den Button **Zoom Meeting beitreten** samt Zoom ID und Passwort. Zusätzlich steht der Link im Kalendereintrag der Buchung und in den Buchungsdetails.
  </Accordion>

  <Accordion title="Wer ist Gastgeber:in des Meetings?">
    Die Zoom-Nutzer:in, die du in der Zoom-Verbindung als **Organisator des Meetings** hinterlegt hast. Sie startet das Meeting über den Link **Zoom Meeting starten** in der Buchung; Kund:innen treten über den Beitritts-Link bei.
  </Accordion>

  <Accordion title="Was passiert, wenn eine Buchung verschoben oder storniert wird?">
    Bei einer Verschiebung aktualisiert anny das Zoom-Meeting automatisch auf die neue Zeit. Wird die Buchung storniert, abgelehnt oder gelöscht, löscht anny auch das Zoom-Meeting.
  </Accordion>

  <Accordion title="Kann ich Meetings nur für bestimmte Buchungsoptionen erstellen lassen?">
    Ja. Wähle in der Zoom-Verbindung unter **Buchungsoptionen auswählen** die gewünschten Buchungsoptionen aus. Ohne Auswahl gilt die Verbindung für **Alle Buchungsoptionen**.
  </Accordion>

  <Accordion title="Warum kann ich die Zoom-Einstellungen nicht bearbeiten?">
    Die Zoom-Verbindungen sind gesperrt, solange die Integration aktiv ist. Deaktiviere sie kurz über den **Toggle**, nimm die Änderungen vor und aktiviere sie wieder.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Für eine Buchung wurde kein Zoom-Meeting erstellt">
    Meist fehlt eine passende Zoom-Verbindung oder die Integration war zum Buchungszeitpunkt deaktiviert. Prüfe, ob der **Toggle** aktiv ist, ob für die gebuchte Ressource eine Zoom-Verbindung existiert und ob die gebuchte Buchungsoption in der Verbindung ausgewählt ist. Beachte: Unterressourcen brauchen eine eigene Verbindung.
  </Accordion>

  <Accordion title="Der Meeting-Link zeigt „Meeting not ready yet“">
    Das Meeting wurde noch nicht fertig bei Zoom angelegt, zum Beispiel direkt nach der Buchung oder weil die Verbindung gestört war. Warte einen Moment und öffne den Link erneut. Bleibt die Meldung bestehen, prüfe die Integration mit **Verbindung testen**.
  </Accordion>

  <Accordion title="Ich habe die E-Mail „Die Zoom Integration hat einen Fehler“ erhalten">
    Die Autorisierung ist abgelaufen oder wurde widerrufen; anny kann keine Meetings mehr verwalten. Öffne die Integration unter **Integrationen** und melde dich über **Autorisieren** erneut bei Zoom an.
  </Accordion>

  <Accordion title="Eine neue Zoom-Nutzer:in erscheint nicht in der Auswahl">
    Die Nutzerliste wird einige Minuten zwischengespeichert. Warte kurz und lade die Seite neu. Prüfe außerdem, ob die Person im verbundenen Zoom-Konto angelegt ist; du kannst in der Auswahl auch nach der E-Mail-Adresse suchen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Zoom ist eine der Video-Meeting-Integrationen (Kategorie „Online Meeting-Integrationen") neben MS Teams, PurpleView und den in anny integrierten Video-Calls. Zoom erstellt ausschließlich geplante Einzel-Meetings pro Buchung: keine Webinare, keine Serien-Meetings, kein Kalender-Sync.
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → Zoom → Panel „Authentifizierung" → Button „Autorisieren" (OAuth-Login bei Zoom), Button „Verbindung testen". Regeln: Panel „Zoom-Einstellungen" → „Hinzufügen" → Modal „Zoom-Verbindung erstellen"/„Zoom-Verbindung bearbeiten" mit Feldern „Wähle die Ressource", „Buchungsoptionen auswählen" (Platzhalter „Alle Buchungsoptionen"), „Wähle den Organisator des Meetings" (Suche per E-Mail). Tabellen-Spalten: „Ressource", „Buchungsoptionen", „Organisator des Meetings". Lösch-Dialog: „So entfernst du anny von deinem Zoom Account" (Zoom Marketplace → Manage → Installed Apps → Uninstall) mit Option „Nur bei anny entfernen".
>
> **Quirks:** (1) Meetings entstehen bereits beim Eingang der Buchung, auch für noch unbestätigte Anfragen; bei Ablehnung, Storno, Ablauf oder Löschung wird das Meeting gelöscht. (2) Bei Ressourcen mit Kapazität > 1 (ohne Unterressourcen) teilen sich alle Buchungen mit identischem Start und Ende ein Meeting; es wird erst mit der letzten Buchung gelöscht. Wird eine dieser Buchungen zeitlich verschoben, bekommt sie ein neues eigenes Meeting und anny verschickt zusätzlich die E-Mails „Zoom Meeting zu deiner Buchung" (Kund:in) und „Zoom Meeting erstellt" (Team); im Normalfall gibt es keine eigene Meeting-E-Mail, der Link steckt in der Buchungsbestätigung. (3) Bei Ressourcenwechsel einer Buchung wird das alte Meeting gelöscht und nach der Verbindung der neuen Ressource neu erstellt. (4) Meeting-Titel = Standard-Buchungsbezeichnung (Ressource/Buchungsoption/Kund:in); Zeitzone der Ressource. (5) Beitritts- und Start-Link sind anny-Weiterleitungen (nicht die rohen Zoom-URLs); der rohe Link ist in den Buchungsdetails kopierbar. Solange das Meeting fehlt, liefern die Weiterleitungen den Fehler „Meeting not ready yet". (6) Fehlgeschlagene Meeting-Aktionen werden bis zu 3-mal wiederholt. (7) Nutzerliste ca. 10 Minuten gecacht, einzelne Nutzer:innen bis 1 Stunde. (8) Nach dem Aktivieren entstehen Meetings für ältere Buchungen erst, wenn diese Buchungen bearbeitet werden. (9) Während die Integration deaktiviert ist, werden Meetings auch bei Storno nicht gelöscht; das wird nach dem Reaktivieren nicht nachgeholt.
>
> **Beziehungen:** Freischaltung über dasselbe Plan-Feature wie alle Video-Meeting-Integrationen (MS Teams, PurpleView, anny Video-Calls); Plan-Zuordnung nicht im Artikel dokumentiert. Verwandte Artikel: anny Video-Calls, MS Teams, PurpleView. Die Zuordnung „Organisator des Meetings" nutzt die Nutzerliste des per OAuth verbundenen Zoom-Kontos; Autorisierungs-Verlust löst die E-Mail „Die Zoom Integration hat einen Fehler" an die Verantwortlichen aus. Wird die anny App im Zoom Marketplace deinstalliert, löscht anny die Integration automatisch (Deauthorisierungs-Webhook).


# Customer API
Source: https://docs.anny.co/developers/api-reference/customer



The Customer API is the **public booking surface** for end-user facing applications. It covers everything a customer can see and do — searching availability, placing bookings, managing their account, and more.

***

## When to use the Customer API

Use the Customer API when you are **building something your customers interact with directly**:

* **Custom booking flow** — embed a fully branded booking experience inside your own app or website instead of redirecting to anny
* **Headless checkout** — drive the cart, checkout, and payment steps entirely from your own frontend
* **Custom confirmation pages** — retrieve booking and order details after checkout to render a tailored confirmation
* **Opening hours and availability on public pages** — display live schedule data on your website with no authentication required
* **White-label experiences** — build lobby screens, kiosks, or mobile apps on top of the Customer API

Many endpoints work **without any authentication**. For a custom OAuth2 client to authenticate your own users, contact [support@anny.co](mailto:support@anny.co) with your use case.

***

## Authentication — Optional Auth

Most Customer API endpoints work without a token. Providing a customer bearer token unlocks personal data and additional actions:

| Auth state | What's accessible |
| - | - |
| Anonymous | Availability, public resource/service info, booking lookup by number, checkout |
| Customer token | Own bookings, account data, communities, passes, queue tickets |

```http theme={null}
Authorization: Bearer {customer_access_token}
```

To authenticate your own users, you need a custom OAuth2 client — contact [support@anny.co](mailto:support@anny.co). See the [Authentication guide](/developers/guides/authentication) for the full token flow.

***

## Customer API vs Admin API

| Feature | Customer API | Admin API |
| - | - | - |
| **Use case** | End-user apps, booking widgets | Server-side automation, backend tooling |
| **Auth** | Optional — many endpoints work without a token | Required — API token or OAuth2 |
| **Identifiers** | Slugs, booking numbers, order numbers | Immutable UUIDs and integer IDs |
| **Access** | Public and customer-owned data only | Full read/write |

→ [Go to the Admin API](/developers/api-reference/admin)

***

## Resource Identifiers

The Customer API uses **human-readable identifiers** that appear in booking URLs:

| Entity | Identifier | Example |
| - | - | - |
| Resources | Slug | `conference-room-berlin` |
| Services | Slug | `hourly-desk-booking` |
| Organizations | Slug | `acme-gmbh` |
| Bookings | Booking number | `BB123456789` |
| Orders | Order number | `BO123456789` |

Use the Admin API if you need immutable internal IDs for storage in external systems.

***

## Starting Points

| Guide | What it covers |
| - | - |
| [Getting Started](/developers) | First steps and quickstart |
| [JSON:API Conventions](/developers/guides/json-api-conventions) | Request and response format |
| [Authentication](/developers/guides/authentication) | Customer token flow, OAuth2, anonymous access |
| [Availability & Booking Search](/developers/guides/availability) | Search open slots, filter by service and resource |
| [Customer Booking Lifecycle](/developers/guides/customer/booking-lifecycle) | View, modify, and cancel bookings |
| [Order & Checkout Flow](/developers/guides/customer/checkout) | Cart, checkout steps, payment |
| [Plans & Subscriptions](/developers/guides/customer/plans-subscriptions) | Membership plans and recurring billing |
| [Communities & Access Control](/developers/guides/customer/communities) | Community membership and access gates |
| [Waitlist](/developers/guides/customer/waitlist) | Join and manage waitlists |

***

## Base URLs

| Environment | URL |
| - | - |
| Production | `https://b.anny.co` |
| Gov-Cloud | `https://b.anny.eu` |


# Create account pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/create-account-pass

/developers/openapi/customer.openapi.json post /api/v1/account-passes



# Delete account pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/delete-account-pass

/developers/openapi/customer.openapi.json delete /api/v1/account-passes/{account_pass_id}



# Get account pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/get-account-pass

/developers/openapi/customer.openapi.json get /api/v1/account-passes/{account_pass_id}



# List account-passes
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/list-account-passes

/developers/openapi/customer.openapi.json get /api/v1/account-passes



# Revoke an account pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/revoke-an-account-pass

/developers/openapi/customer.openapi.json get /api/v1/account-passes/{account_pass_id}/revoke



# Update account pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/account-passes/update-account-pass

/developers/openapi/customer.openapi.json patch /api/v1/account-passes/{account_pass_id}



# Create account-skill
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/account-skills/create-account-skill

/developers/openapi/customer.openapi.json post /api/v1/account-skills



# Delete account-skill
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/account-skills/delete-account-skill

/developers/openapi/customer.openapi.json delete /api/v1/account-skills/{account_skill_id}



# Update account-skill
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/account-skills/update-account-skill

/developers/openapi/customer.openapi.json patch /api/v1/account-skills/{account_skill_id}



# Get all addresses linked with a customer account
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/addresses/get-all-addresses-linked-with-a-customer-account

/developers/openapi/customer.openapi.json get /api/v1/customer-accounts/{customer_account_id}/addresses



# Check availability
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/check-availability

/developers/openapi/customer.openapi.json get /api/v1/intervals/availability
Check availability of a service and resource for a given period.



# Check availability for a date range
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/check-availability-for-a-date-range

/developers/openapi/customer.openapi.json get /api/v1/availability/check-period
Returns whether a given period is available for a service/resource combination.



# Get availability for a timeslot series
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-availability-for-a-timeslot-series

/developers/openapi/customer.openapi.json get /api/v1/availability/series



# Get availability for recurring bookings
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-availability-for-recurring-bookings

/developers/openapi/customer.openapi.json get /api/v1/availability/recurring



# Get availability periods
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-availability-periods

/developers/openapi/customer.openapi.json get /api/v1/availability/periods
Returns availability periods for the given service/resource, useful for calendar display.



# Get available end times for a start time
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-available-end-times-for-a-start-time

/developers/openapi/customer.openapi.json get /api/v1/availability/end
Given a start datetime, returns available end time intervals.



# Get available start dates for a period
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-available-start-dates-for-a-period

/developers/openapi/customer.openapi.json get /api/v1/availability/start-dates
Returns an array of dates that have available slots within the given range.



# Get available start times for a date
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-available-start-times-for-a-date

/developers/openapi/customer.openapi.json get /api/v1/availability/start
Returns available start time intervals for the given date and service/resource.



# Get end intervals for waitlist entries
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-end-intervals-for-waitlist-entries

/developers/openapi/customer.openapi.json get /api/v1/intervals/waitlist-end
Returns waitlist-eligible end intervals for a previously selected waitlist start datetime.



# Get end times for start date times for a resource
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-end-times-for-start-date-times-for-a-resource

/developers/openapi/customer.openapi.json get /api/v1/intervals/end
Get all interval end dates for a start datetime.



# Get intervals for a timeslot series
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-intervals-for-a-timeslot-series

/developers/openapi/customer.openapi.json get /api/v1/availability/series-intervals



# Get start intervals for waitlist entries
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-start-intervals-for-waitlist-entries

/developers/openapi/customer.openapi.json get /api/v1/intervals/waitlist-start
Returns waitlist-eligible start intervals for a service. Use this only after deciding the user should be offered waitlist for a booked out resource or period.



# Get start times for a start date for a resource
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-start-times-for-a-start-date-for-a-resource

/developers/openapi/customer.openapi.json get /api/v1/intervals/start
Get all interval start dates for a given date.



# Get the next available start date
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-the-next-available-start-date

/developers/openapi/customer.openapi.json get /api/v1/availability/next-date



# Get upcoming available intervals
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/availability/get-upcoming-available-intervals

/developers/openapi/customer.openapi.json get /api/v1/availability/upcoming-intervals



# Get booking-bundle
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/booking-bundles/get-booking-bundle

/developers/openapi/customer.openapi.json get /api/v1/booking-bundles/{booking_bundle_id}



# Create booking pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/create-booking-pass

/developers/openapi/customer.openapi.json post /api/v1/booking-passes



# Delete booking pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/delete-booking-pass

/developers/openapi/customer.openapi.json delete /api/v1/booking-passes/{booking_pass_id}



# Get booking pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/get-booking-pass

/developers/openapi/customer.openapi.json get /api/v1/booking-passes/{booking_pass_id}



# List booking-passes
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/list-booking-passes

/developers/openapi/customer.openapi.json get /api/v1/booking-passes



# Purchase a booking pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/purchase-a-booking-pass

/developers/openapi/customer.openapi.json post /api/v1/booking-passes/checkout



# Update booking pass
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/booking-passes/update-booking-pass

/developers/openapi/customer.openapi.json patch /api/v1/booking-passes/{booking_pass_id}



# Accept a booking invitation
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/accept-a-booking-invitation

/developers/openapi/customer.openapi.json post /api/v1/bookings/{booking_id}/accept-invite



# Cancel a booking
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/cancel-a-booking

/developers/openapi/customer.openapi.json get /api/v1/bookings/{booking_id}/cancel
Auth: optional. This endpoint allows a customer to cancel a booking either anonymously via the access token or via customer login.



# Cancel an in-progress booking edit
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/cancel-an-in-progress-booking-edit

/developers/openapi/customer.openapi.json get /api/v1/bookings/{booking_id}/cancel-edit-booking



# Create an instant booking
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/create-an-instant-booking

/developers/openapi/customer.openapi.json post /api/v1/bookings/instant
Auth: customer. Creates and completes a booking immediately without going through the cart flow. Used for authenticated customer and kiosk-like flows.



# Edit base data of a completed booking
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/edit-base-data-of-a-completed-booking

/developers/openapi/customer.openapi.json post /api/v1/bookings/{booking_id}/edit-booking-base-data
Allows editing the date/time of a completed booking (subject to availability). This endpoint applies the change immediately — there is no separate confirm step. If the edit causes a price difference, a new invoice is generated.

**Edit flow:**
1. Call `edit-booking-base-data` or `edit-service-options` to apply changes
2. If a price difference exists, the response includes an invoice to pay
3. To revert instead, call `cancel-edit-booking` (GET)



# Edit participants for a booking
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/edit-participants-for-a-booking

/developers/openapi/customer.openapi.json post /api/v1/bookings/{booking_id}/edit-participants



# Edit service options (add-ons) for a confirmed booking
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/edit-service-options-add-ons-for-a-confirmed-booking

/developers/openapi/customer.openapi.json post /api/v1/bookings/{booking_id}/edit-service-options



# Find a booking by a scan code
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/find-a-booking-by-a-scan-code

/developers/openapi/customer.openapi.json get /api/v1/bookings/by-code
Auth: optional. Lookup is authenticated with the terminal hash rather than customer bearer auth.



# Find a booking by its number
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/find-a-booking-by-its-number

/developers/openapi/customer.openapi.json get /api/v1/bookings/by-number
Auth: optional. Lookup is authenticated with the terminal hash rather than customer bearer auth.



# Get list of bookings
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/get-list-of-bookings

/developers/openapi/customer.openapi.json get /api/v1/bookings
Auth: customer. Get a list of all bookings for the authenticated customer account which apply to the given filter.



# Get the count of bookings for resources
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/get-the-count-of-bookings-for-resources

/developers/openapi/customer.openapi.json get /api/v1/bookings-count



# Get unified calendar events for resources
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/get-unified-calendar-events-for-resources

/developers/openapi/customer.openapi.json get /api/v1/calendar-events
Aggregates availability, bookings, and blockers into unified calendar events for display. In an organization/admin context, timeslot and single-booking `display_lines` include the timeslot title when one is set. Each display line is `{ key, icon, label, image, object }`; `key` is one of `time`, `timeslot`, `customer`, `service`, `resource`, `admin_note`, `customer_note`, `order_item`. Admin single-booking events also include `add_on_count` (sum of add-on quantities; `null` for non-admin and aggregated events). Send `filter[with_empty_booking_counts]=true` to include aggregated `booking_count` periods whose count is `0`.



# Personalize a booking
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/personalize-a-booking

/developers/openapi/customer.openapi.json post /api/v1/bookings/{booking_id}/personalization
Submit personalization data (custom form fields) for a booking.



# Preview cancellation terms for a booking
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/preview-cancellation-terms-for-a-booking

/developers/openapi/customer.openapi.json get /api/v1/bookings/{booking_id}/cancellation-preview
Returns potential refund amounts and cancellation policy terms based on current time.



# Reject a booking invitation
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/bookings/reject-a-booking-invitation

/developers/openapi/customer.openapi.json post /api/v1/bookings/{booking_id}/reject-invite



# Get community
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/communities/get-community

/developers/openapi/customer.openapi.json get /api/v1/communities/{community_id}
Auth: customer. Returns a community the authenticated customer can access.



# Leave a community
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/communities/leave-a-community

/developers/openapi/customer.openapi.json get /api/v1/communities/{community_id}/leave
Auth: customer. Removes the authenticated customer from the community.



# List communities
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/communities/list-communities

/developers/openapi/customer.openapi.json get /api/v1/communities
Auth: customer. Lists communities visible to the authenticated customer account.



# Delete community-account
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/community-accounts/delete-community-account

/developers/openapi/customer.openapi.json delete /api/v1/community-accounts/{community_account_id}



# Update community-account
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/community-accounts/update-community-account

/developers/openapi/customer.openapi.json patch /api/v1/community-accounts/{community_account_id}



# Accept community invite
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/community-invites/accept-community-invite

/developers/openapi/customer.openapi.json post /api/v1/community-invites/{community_invite_id}/accept
Auth: customer. Accepts a community invite for the authenticated customer account.



# Get community invite
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/community-invites/get-community-invite

/developers/openapi/customer.openapi.json get /api/v1/community-invites/{community_invite_id}
Auth: customer. Returns an invite for the authenticated customer account.



# Get a single booking preview
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-a-single-booking-preview

/developers/openapi/customer.openapi.json get /api/v1/customer-accounts/{customer_account_id}/booking-preview/{bookingId}



# Get booking previews for a customer account
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-booking-previews-for-a-customer-account

/developers/openapi/customer.openapi.json get /api/v1/customer-accounts/{customer_account_id}/booking-previews



# Get connections with accessible scope
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-connections-with-accessible-scope

/developers/openapi/customer.openapi.json get /api/v1/customer-account/connected-with-scope



# Get customer account information
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-customer-account-information-get-customer-accounts-record

/developers/openapi/customer.openapi.json get /api/v1/customer-accounts/{customer_account_id}



# Get customer account information
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/get-customer-account-information-list-customer-accounts

/developers/openapi/customer.openapi.json get /api/v1/customer-account
Fetch the logged in customer identified by Bearer Token.



# Remove a recently visited entity from history
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/remove-a-recently-visited-entity-from-history

/developers/openapi/customer.openapi.json get /api/v1/customer-accounts/{customer_account_id}/remove-recent-entity



# Request account deletion
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/request-account-deletion

/developers/openapi/customer.openapi.json get /api/v1/customer-accounts/{customer_account_id}/request-deletion



# Update customer account information
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/update-customer-account-information

/developers/openapi/customer.openapi.json patch /api/v1/customer-accounts/{customer_account_id}
Use this endpoint to update the addresses or the primary address of a customer account.
All attributes are managed by the authentication system.



# Validate email/mobile uniqueness for a customer account
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/customer-accounts/validate-email-mobile-uniqueness-for-a-customer-account

/developers/openapi/customer.openapi.json get /api/v1/customer-accounts/{customer_account_id}/validate-unique



# Add a favorite
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/favorites/add-a-favorite

/developers/openapi/customer.openapi.json post /api/v1/favorites
Create new favorite for model.



# Delete a favorite
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/favorites/delete-a-favorite

/developers/openapi/customer.openapi.json delete /api/v1/favorites/{favorite_uuid}
Remove a favorite.



# Get all favorites
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/favorites/get-all-favorites

/developers/openapi/customer.openapi.json get /api/v1/favorites
Get all favorite models of the logged in customer account.

Use filters to get either recently booked or liked models.



# Get all liked resources
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/favorites/get-all-liked-resources

/developers/openapi/customer.openapi.json get /api/v1/customer-accounts/{customer_account_uuid}/liked-resources
Get all liked resources for the logged in customer account.



# Add booking to order
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/add-booking-to-order

/developers/openapi/customer.openapi.json post /api/v1/order/bookings
This endpoint allows to add bookings to an order with status "draft". After the booking has changed the status, no more changes are possible from the customer side. There does not have to exist an order beforehand, because it is created as soon as the first booking is added.



# Apply voucher
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/apply-voucher

/developers/openapi/customer.openapi.json post /api/v1/order/voucher
This endpoint allows to apply a voucher code to an order. The server side will validate this voucher and return error messages if needed.



# Cancel an order
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/cancel-an-order-get-orders-record-cancel

/developers/openapi/customer.openapi.json get /api/v1/orders/{order_number}/cancel
Auth: optional. This endpoint allows a customer to cancel an order via the **order number**. This can be done either anonymously via the access token or via the customer login.
Canceling the order will also cancel all related bookings.



# Cancel an order
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/cancel-an-order-get-orders-record-resend-mail

/developers/openapi/customer.openapi.json get /api/v1/orders/{order_number}/resend-mail
Auth: optional. This endpoint allows a customer to resend the booking confirmation via the **order number**. This can be done either anonymously via the access token or via customer login.
This only re-sends the confirmation email and does not modify the order.



# Clear all bookings from the cart
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/clear-all-bookings-from-the-cart

/developers/openapi/customer.openapi.json get /api/v1/order/bookings/delete-all



# Delete a booking from an order
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/delete-a-booking-from-an-order

/developers/openapi/customer.openapi.json delete /api/v1/order/bookings/{booking_id}
This endpoint allows to delete the booking of an order that is still in status "draft". After the booking has changed the status, no more changes are possible from the customer side.  If there are no more bookings in the order, the entire order is deleted.



# Delete multiple bookings from the cart
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/delete-multiple-bookings-from-the-cart

/developers/openapi/customer.openapi.json delete /api/v1/order/bookings/delete-multiple



# Delete voucher
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/delete-voucher

/developers/openapi/customer.openapi.json delete /api/v1/order/voucher
This endpoint allows to delete a voucher code from an order.



# Edit add-ons for a booking in the cart
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/edit-add-ons-for-a-booking-in-the-cart

/developers/openapi/customer.openapi.json post /api/v1/order/bookings/{booking_id}/edit-addons



# Finish an order
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/finish-an-order

/developers/openapi/customer.openapi.json post /api/v1/order
This endpoint is necessary to complete an order. The response is an array of orders, one for each organization involved, since the booked resources may be offered by different organizations.

A booking is not always accepted automatically, depending on the settings of the resource it still has to be confirmed manually by the organization.



# Get an order after ordering
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/get-an-order-after-ordering

/developers/openapi/customer.openapi.json get /api/v1/orders/{order_number}
Auth: optional. This endpoint allows a customer to access an order via the **order number** after placing it. This can be authenticated either anonymously via the order `access_token` or via customer login.



# Get booking recommendations for the current order
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/get-booking-recommendations-for-the-current-order

/developers/openapi/customer.openapi.json get /api/v1/order/recommendations



# Get or create an active order
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/get-or-create-an-active-order

/developers/openapi/customer.openapi.json get /api/v1/order
Auth: optional. This endpoint will return the currently active order (indentified by a cookie). Otherwise, the response would be empty.

Note that orders expire automatically at `expires_at`. This date will be extended with each booking which is added to the order.
An order with `status=draft` represents a cart.



# Get recently completed orders
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/get-recently-completed-orders

/developers/openapi/customer.openapi.json get /api/v1/order/last-succeeded



# Precalculate a possible booking
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/orders/precalculate-a-possible-booking

/developers/openapi/customer.openapi.json post /api/v1/order/bookings/calculate
This endpoint allows to precalculate a booking without creating it.



# Cancel subscription
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/cancel-subscription

/developers/openapi/customer.openapi.json put /api/v1/plan-subscriptions/{plan_subscription_id}/cancel



# Create plan-subscription
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/create-plan-subscription

/developers/openapi/customer.openapi.json post /api/v1/plan-subscriptions



# Delete plan-subscription
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/delete-plan-subscription

/developers/openapi/customer.openapi.json delete /api/v1/plan-subscriptions/{plan_subscription_id}



# Get plan-subscription
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/get-plan-subscription

/developers/openapi/customer.openapi.json get /api/v1/plan-subscriptions/{plan_subscription_id}



# List plan-subscriptions
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/list-plan-subscriptions

/developers/openapi/customer.openapi.json get /api/v1/plan-subscriptions



# Update plan-subscription
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/update-plan-subscription

/developers/openapi/customer.openapi.json patch /api/v1/plan-subscriptions/{plan_subscription_id}



# Create waitlist-spot
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/waitlist/create-waitlist-spot

/developers/openapi/customer.openapi.json post /api/v1/waitlist-spots
Creates a waitlist entry for the authenticated customer. `account_id`, `organization_id`, and `uuid` are filled by the backend.



# Delete waitlist-spot
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/waitlist/delete-waitlist-spot

/developers/openapi/customer.openapi.json delete /api/v1/waitlist-spots/{waitlist_spot_id}



# List waitlist-spots
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/waitlist/list-waitlist-spots

/developers/openapi/customer.openapi.json get /api/v1/waitlist-spots
Returns active waitlist entries for the authenticated customer. Past entries and entries already converted to bookings are excluded.



# Offered booking bundle groups
Source: https://docs.anny.co/developers/api-reference/customer/offered-booking-bundle-groups

Public catalog of booking bundle groups that have at least one live bundle.

Public related resource: groups that currently have at least one **live** booking bundle. Use this for the shop / native package catalog instead of `GET /api/v1/booking-bundle-groups`.

```http theme={null}
GET /api/v1/organizations/{organization_slug}/offered-booking-bundle-groups?sort=order_index
```

Or include on the organization:

```http theme={null}
GET /api/v1/organizations/{organization_slug}?include=offered_booking_bundle_groups,available_booking_bundles.group
```

Then load packages per group:

```http theme={null}
GET /api/v1/organizations/{organization_slug}/available-booking-bundles?filter[group_id]={id}&include=group,cover_image,organization.logo_image&sort=order_index
GET /api/v1/organizations/{organization_slug}/available-booking-bundles?filter[without_group]=true&include=group,cover_image,organization.logo_image&sort=order_index
```

<ParamField type="string">
  Organization slug.
</ParamField>

<ParamField type="string">
  Allowed: `order_index`, `name`, `created_at`.
</ParamField>

See [Booking Bundle Groups](/developers/guides/booking-bundle-groups) for the native rendering contract.


# Admin Timeslot Management
Source: https://docs.anny.co/developers/guides/admin/timeslot-management



Create, update, repeat, and enrich fixed slots in the admin API. This guide is grounded in the current backend JSON:API contracts and the admin frontend workflows used by the timeslot detail editor.

For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For booking lifecycle effects after a timeslot change, see [Booking Lifecycle](/developers/guides/admin/booking-lifecycle).

***

## What a Timeslot Represents

A timeslot is a fixed start and end period attached to a resource or service. It can:

* exist as a one-off slot
* belong to one or more timeslot series
* expose cached `resource_info` for cards and customer-facing summaries
* use dynamic capacity based on resource allocations
* have regular bookings linked to it

Core schema references:

* `reference/timeslots.v1.yaml`
* `reference/timeslot-series.v1.yaml`
* `reference/timeslot-resource-allocations.v1.yaml`

Main endpoints:

* `GET /api/v1/timeslots`
* `POST /api/v1/timeslots`
* `GET /api/v1/timeslots/{timeslot_id}`
* `PATCH /api/v1/timeslots/{timeslot_id}`
* `DELETE /api/v1/timeslots/{timeslot_id}`
* `POST /api/v1/timeslots/preview`
* `POST /api/v1/timeslots/{timeslot_id}/extend`

***

## List and Filter Timeslots

Use the collection endpoint for admin calendar and editor views:

```http theme={null}
GET /api/v1/timeslots?filter[start_date]=2026-06-01T00:00:00Z&filter[end_date]=2026-06-30T23:59:59Z&filter[r]=12&include=resource,series,resource_allocations.resource,model_syncs
```

Confirmed query parameters:

| Parameter | Description |
| - | - |
| `include` | `resource`, `resource.parent`, `service`, `series`, `cover_image`, `resource_allocations`, `resource_allocations.resource`, `resource_allocations.resource.category`, `resource_allocations.resource.cover_image`, `model_syncs` |
| `sort` | `period`, `start_date`, `end_date`, `created_at` |
| `filter[start_date]` | Return slots ending after this timestamp |
| `filter[end_date]` | Return slots starting before this timestamp |
| `filter[upcoming_only]` | Restrict to future slots |
| `filter[past_only]` | Restrict to past slots |
| `filter[resources]` | Filter by resource IDs |
| `filter[r]` | Alias used by the admin calendar |
| `filter[resource_groups]` | Filter by resource groups |
| `filter[dynamic_capacity]` | Restrict to dynamic-capacity slots |

Resource-scoped reads are also available:

```http theme={null}
GET /api/v1/resources/{resource_id}/timeslots
GET /api/v1/resources/{resource_id}/timeslot-series
```

***

## Create a Single Timeslot

```http theme={null}
POST /api/v1/timeslots
Content-Type: application/vnd.api+json
```

```json theme={null}
{
  "data": {
    "type": "timeslots",
    "attributes": {
      "title": "Session 1",
      "title_i18n": {
        "en-us": "Session 1"
      },
      "start_date": "2026-06-08T10:00:00+02:00",
      "end_date": "2026-06-08T11:00:00+02:00",
      "dynamic_capacity": true,
      "base_quota": 0,
      "max_dynamic_quota": 5,
      "min_bookings_count": 2,
      "cancellation_offset_value": 24
    },
    "relationships": {
      "resource": {
        "data": {
          "id": "12",
          "type": "resources"
        }
      },
      "series": {
        "data": [
          {
            "id": "3",
            "type": "timeslot-series"
          }
        ]
      }
    }
  }
}
```

Common attributes used by the admin UI:

| Attribute | Notes |
| - | - |
| `title`, `title_i18n` | Short display labels |
| `description`, `description_i18n` | Optional content |
| `start_date`, `end_date`, `timezone` | Period and editing timezone |
| `quota` | Effective quota for non-dynamic slots |
| `dynamic_capacity` | Enables allocation-driven quota |
| `base_quota` | Static base capacity |
| `max_dynamic_quota` | Upper quota cap |
| `min_bookings_count` | Minimum accepted bookings before the slot is confirmed |
| `cancellation_offset_type`, `cancellation_offset_value` | Automatic cancellation rules |

***

## Preview and Create Recurring Slots

The admin frontend does not blindly create recurring slots. It first previews generated occurrences, then saves one seed timeslot, then extends from that seed.

Preview request:

```http theme={null}
POST /api/v1/timeslots/preview
Content-Type: application/json
```

```json theme={null}
{
  "start_date": "2026-06-08T10:00:00+02:00",
  "end_date": "2026-06-08T11:00:00+02:00",
  "resource_id": "12",
  "timezone": "Europe/Berlin",
  "recurring": {
    "frequency": "weekly",
    "interval": 1,
    "days": [1],
    "count": 4
  }
}
```

Extend request:

```http theme={null}
POST /api/v1/timeslots/{timeslot_id}/extend
Content-Type: application/json
```

Use the same `recurring` payload after the first timeslot has been created. The response returns the generated occurrences.

Use series when you need a named grouping for recurring slots. CRUD is available on:

* `GET /api/v1/timeslot-series`
* `POST /api/v1/timeslot-series`
* `GET /api/v1/timeslot-series/{timeslot_series_id}`
* `PATCH /api/v1/timeslot-series/{timeslot_series_id}`
* `DELETE /api/v1/timeslot-series/{timeslot_series_id}`

***

## Manage Resource Allocations

Dynamic-capacity timeslots can attach secondary resources through timeslot resource allocations.

Endpoints:

* `GET /api/v1/timeslot-resource-allocations`
* `POST /api/v1/timeslot-resource-allocations`
* `GET /api/v1/timeslot-resource-allocations/{timeslot_resource_allocation_id}`
* `PATCH /api/v1/timeslot-resource-allocations/{timeslot_resource_allocation_id}`
* `DELETE /api/v1/timeslot-resource-allocations/{timeslot_resource_allocation_id}`

Useful fields:

| Field | Notes |
| - | - |
| `status` | `provisioned` or `pending` |
| `capacity_multiplier` | Capacity contribution; `0` makes the allocation a required gate |
| `is_required` | Required resource gate for the slot |
| `is_externally_blocked` | Indicates external blockers during the slot period |
| `visible_to_customer` | Controls whether the resource appears in cached `resource_info` |
| `provisioned_at` | Timestamp when pending capacity became provisioned |
| `provisioned_by_booking_id` | Booking that triggered provisioning |

List filters include `filter[is_required]` in addition to status and visibility filters.

***

## Reschedule or Update a Timeslot With Bookings

Updating a slot can affect linked regular bookings. When the period changes, the admin frontend sends extra query parameters on `PATCH /api/v1/timeslots/{timeslot_id}`.

| Query parameter | Purpose |
| - | - |
| `sync_bookings=1` | Move exact-period regular bookings with the timeslot |
| `status_reason=...` | Human-readable reason for the change |
| `send_notification=1` | Notify affected customers |
| `lock_invoice=1` | Lock invoice state during the reschedule flow |

This is the flow used by the reschedule modal in the admin UI.

***

## Retrieve Bookings for a Timeslot

Use the relationship endpoint to populate the Bookings tab:

```http theme={null}
GET /api/v1/timeslots/{timeslot_id}/regular-bookings?include=customer&sort=-created_at&page[size]=10
```

This returns regular bookings currently linked to the slot.

***

## Calendar Events and `timeslot_id`

Calendar event payloads can be correlated back to timeslot CRUD flows through `timeslot_id`.

When a timeslot has a non-empty `title`, the admin calendar includes that title in `display_lines` (on `timeslot` events and on admin single-booking events). Untitled slots show only the time range.

Use this when you need to:

* open the matching timeslot editor from a calendar event
* fetch the canonical timeslot resource after a calendar query
* reconcile `resource_info` shown in calendar cards with allocation-backed timeslot data

For the aggregate calendar surface, see [Booking Calendars](/developers/guides/admin/calendar-events).


# Customer Booking Lifecycle
Source: https://docs.anny.co/developers/guides/customer/booking-lifecycle



Manage bookings from the customer's perspective — cancel, edit, personalize, and accept invitations.

For creating bookings, see [Order & Checkout Flow](/developers/guides/customer/checkout). For admin booking management, see [Admin Booking Lifecycle](/developers/guides/admin/booking-lifecycle). For admin edits of a confirmed booking (resource, dates, fields, add-ons, sub-bookings), see [Admin Booking Edit](/developers/guides/admin/booking-edit). For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions).

***

## Prerequisites

* A booking associated with the authenticated customer account, or
* A booking number/code for unauthenticated lookup

***

## Booking Statuses

| Status | Meaning |
| - | - |
| `reserved` | Temporary hold (in cart, not yet completed) |
| `requested` | Submitted by customer, awaiting admin approval |
| `accepted` | Accepted and active |
| `invited` | Participant invited, not yet accepted |
| `rejected` | Request denied by admin. If payment already exists, the rejection results in a full refund. |
| `canceled` | Canceled by customer or admin. Refunds follow the configured cancellation policy. |
| `expired` | Expired because the booking was not checked in within the configured check-in window. |

***

## Looking Up Bookings

Request path documentation:

* `paths/public/bookings.yaml` for `GET /api/v1/bookings/by-number`

### By Booking Number

```http theme={null}
GET /api/v1/bookings/by-number?number={booking_number}
```

Accepts an optional `hash` parameter for terminal/kiosk authentication.

***

## Cancelling a Booking

Request path documentation:

* `paths/public/bookings.yaml` for `GET /api/v1/bookings/{booking_id}/cancel`

### Step 1 — Preview Cancellation Terms

Before cancelling, check the cancellation policy:

```http theme={null}
GET /api/v1/bookings/{booking_id}/cancellation-preview
```

Returns the applicable cancellation fee based on how far in advance the cancellation is made. The response includes:

* The fee percentage or amount
* The refund amount
* The deadline for the current fee tier

### Step 2 — Cancel

```http theme={null}
GET /api/v1/bookings/{booking_id}/cancel
```

The cancellation can apply to a single booking or an entire recurring series, depending on the booking type. Refunds and invoice adjustments are handled automatically.

***

## Accepting or Rejecting Invitations

When a participant is invited to a booking (status: `invited`):

### Accept

```http theme={null}
POST /api/v1/bookings/{booking_id}/accept-invite
```

Updates the participant's status to `accepted`.

### Reject

```http theme={null}
POST /api/v1/bookings/{booking_id}/reject-invite
```

Removes the participant from the booking.

***

## Personalization

Submit custom form data for a booking (e.g. dietary preferences, t-shirt size):

```http theme={null}
POST /api/v1/bookings/{booking_id}/personalization

{
  "field_uuid_1": "Vegetarian",
  "field_uuid_2": "L",
  "email": "jane@example.com"
}
```

The required fields are dynamic — they depend on the service's **CustomForm** configuration. A `CustomForm` defines which fields are available and which are mandatory. Fetch the service's custom form to discover the expected field UUIDs and types before submitting personalization data.

***

## Editing an Accepted Booking

### Edit Participants

```http theme={null}
POST /api/v1/bookings/{booking_id}/edit-participants

{
  "participants": [
    {
      "email": "jane@example.com",
      "name": "Jane Doe",
      "attending_virtually": false
    }
  ]
}
```

| Field | Type | Description |
| - | - | - |
| `email` | string | Participant email (max 200 chars) |
| `name` | string | Participant display name |
| `can_edit` | boolean | Whether the participant can edit their own data |
| `attending_virtually` | boolean | Virtual attendance flag |

### Edit Service Options (Add-Ons)

Change add-on selections on an accepted booking:

```http theme={null}
POST /api/v1/bookings/{booking_id}/edit-service-options

{
  "addons": [
    { "add_on_id": "{add_on_uuid}", "quantity": 2 }
  ]
}
```

<Note>
  This endpoint is only available when the service has `canEditServiceOptions` enabled. Quantity follows the same `always_apply` / `min_quantity` rules as checkout: customer `0` or omit floors to min when `always_apply` is `true`. See [Add-On](/developers/models/add-ons).
</Note>

### Edit Booking Date/Time (Rebooking)

Change the date, time, or resource of an accepted booking:

```http theme={null}
POST /api/v1/bookings/{booking_id}/edit-booking-base-data

{
  "start_date": "2026-04-16T10:00:00+02:00",
  "end_date": "2026-04-16T11:00:00+02:00",
  "resource_id": "{new_resource_uuid}"
}
```

The new time is validated against availability. If the edit creates a price difference, the order is recalculated automatically.

Each edit endpoint (`edit-participants`, `edit-service-options`, `edit-booking-base-data`) is self-contained — a successful response means the edit is applied. There is no separate "finish edit" endpoint.

### Cancel an In-Progress Edit

If you started an edit but want to revert:

```http theme={null}
GET /api/v1/bookings/{booking_id}/cancel-edit-booking
```

Reverts the booking to its original state before the edit was initiated.

***

## Instant Booking

Request path documentation:

* `paths/public/bookings.yaml` for `POST /api/v1/bookings/instant`

Create and complete a booking immediately in a single request:

```http theme={null}
POST /api/v1/bookings/instant

{
  "start_date": "2026-04-15T09:00:00+02:00",
  "end_date": "2026-04-15T10:00:00+02:00",
  "resource_id": "{resource_uuid}",
  "service_id": "{service_uuid}"
}
```

This flow is documented in the customer API only. It requires an authenticated customer context and a service that supports instant bookings (controlled by the `can_instant_book` flag in the service's meta configuration).

***

## Common Errors

| Error | Cause | Solution |
| - | - | - |
| `403` — unauthorized | Not the booking owner or participant | Verify customer account matches |
| `400` — `service_and_resource_not_related` | The resource does not offer the chosen service | Send a linked resource/service pair. The API no longer swaps in another service. |
| `422` — booking not cancelable | Booking status doesn't allow cancellation | Check status — only `accepted` and `requested` bookings can be cancelled |
| `422` — slot unavailable | Rebooking to an occupied time slot | Check availability before editing base data |
| `404` — booking not found | Invalid number or code | Verify the booking number/code |


# Communities & Access Control
Source: https://docs.anny.co/developers/guides/customer/communities



Communities are membership groups that gate access to resources and services. Members can receive booking quotas, access control grants, and exclusive booking permissions.

For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For authentication, see [Authentication](/developers/guides/authentication).

***

## Prerequisites

* Admin API: Bearer token with admin access + `?o={organization_id}`
* Customer API: Authenticated customer account for membership and invite actions

***

## Concepts

| Entity | Description |
| - | - |
| **Community** | A named group with members, rules, and permissions |
| **Community Account** | A membership record linking a customer account to a community |
| **Community Invite** | An email invitation to join a community |
| **Booking Pass** | A quota voucher (e.g. "10x Yoga Class") granted to community members |
| **Account Pass** | A digital wallet pass (Apple/Google Wallet) for physical access |

### Member Roles

| Role | Permissions |
| - | - |
| `member` | Standard access according to community rules |
| `manager` | Can manage members and settings |
| `visitor` | Limited/temporary access |

### Member Statuses

| Status | Meaning |
| - | - |
| `accepted` | Active member |
| `pending` | Awaiting approval |

Memberships can be time-limited via `start_date` and `end_date` fields on the community account.

***

## Creating a Community (Admin)

```http theme={null}
POST /api/v1/communities?o={org_id}

{
  "data": {
    "type": "communities",
    "attributes": {
      "name": "Premium Members",
      "slug": "premium-members",
      "is_private": true,
      "allow_customer_requests": true,
      "auto_join_enabled": false,
      "include_all_services": false
    }
  }
}
```

### Key Attributes

| Attribute | Type | Description |
| - | - | - |
| `name` | string | Display name |
| `slug` | string | URL-friendly identifier |
| `is_private` | boolean | Hidden from public listing if `true` |
| `allow_customer_requests` | boolean | Customers can request to join |
| `auto_join_enabled` | boolean | Enable automatic membership rules |
| `include_all_services` | boolean | Members can access all services |
| `welcome_text` | string | Shown to members on join |

### Resource meta

Authenticated community resource objects (primary **and** [included](/developers/guides/json-api-conventions#including-related-resources)) expose:

| Meta | Type | Description |
| - | - | - |
| `members_count` | integer | Number of **active** members (memberships whose start/end window includes now). This is the stored `active_community_accounts_count` on the community. Expired or not-yet-started memberships are excluded. |

```http theme={null}
GET /api/v1/communities?o={org_id}
GET /api/v1/resources/{resource_id}?o={org_id}&include=communities
GET /api/v1/services/{service_id}?o={org_id}&include=communities
```

Listing membership rows (`community-accounts`) is a different endpoint and is not how this count is produced.

***

## Inviting Members (Admin)

Send email invitations to join:

```http theme={null}
POST /api/v1/communities/{community_id}/invites?o={org_id}

{
  "emails": ["jane@example.com", "john@example.com"],
  "role": "member",
  "body": "You've been invited to our Premium Members community!",
  "start_date": "2026-04-01",
  "end_date": "2026-12-31",
  "silent": false
}
```

| Field | Type | Required | Description |
| - | - | - | - |
| `emails` | string\[] | Yes | Email addresses to invite |
| `role` | string | No | Member role (default: `member`) |
| `body` | string | No | Custom invitation message |
| `start_date` | string | No | Membership start date |
| `end_date` | string | No | Membership expiration date |
| `silent` | boolean | No | `true` to skip sending invitation emails |

If an email matches an existing customer account, the membership is created immediately (no pending invite). A second invite to the same email widens the existing pending invite instead of creating another row.

Booking auto-join reuses an overlapping or covering membership and consumes leftover pending invites for that email, so the members page does not list the same person as both invite and member. Non-overlapping sequential windows (for example two separate week-long visits) still create separate memberships.

### List invitations

```http theme={null}
GET /api/v1/community-invites?o={org_id}&filter[search]=jane@&filter[open]=true
```

| Filter | Description |
| - | - |
| `filter[email]` | Exact invite email |
| `filter[search]` | Case-insensitive substring match on the invite email |
| `filter[open]` | Open (not yet accepted) invites |
| `filter[accepted_at]` | Accepted-at timestamp |
| `filter[expiry]` | Invite expiry |

Allowed sort: `email`, `created_at`, `accepted_at`. Allowed include: `community`, `user`, `organization`, `organization.logo_image`, `joined_through`.

### Resend an Invitation

```http theme={null}
GET /api/v1/community-invites/{invite_id}/resend?o={org_id}
```

***

## Auto-Join Rules

Communities can automatically add members based on:

| Trigger | Description |
| - | - |
| **Booking** | Customer books a service linked to the community |
| **Subscription** | Customer claims a plan subscription associated with the community |
| **Email Domain** | Customer's email domain matches a verified domain ownership |

Configure via the `auto_join_settings` attribute on the community resource. Use the sync endpoint to apply rules retroactively:

```http theme={null}
GET /api/v1/communities/{community_id}/sync-auto-join?o={org_id}
```

Returns the number of newly added members.

***

## Customer Membership Actions

Community membership actions are documented in the customer API, not the public API.

### Leave a Community

```http theme={null}
GET /api/v1/communities/{community_id}/leave
```

### Accept an Invite

```http theme={null}
POST /api/v1/community-invites/{invite_id}/accept
```

***

## Common Errors

| Error | Cause | Solution |
| - | - | - |
| `403` — not a member | Action requires community membership | Join the community first |
| `422` — community is private | Cannot join a private community directly | Request an invitation from an admin |
| `422` — already a member | Duplicate join attempt | Check membership status before joining |


# Plans & Subscriptions
Source: https://docs.anny.co/developers/guides/customer/plans-subscriptions



Manage plan subscriptions — lifecycle, claiming, listing, filtering, and admin operations.

For general conventions, see [JSON-API Conventions](/developers/guides/json-api-conventions). For authentication, see [Authentication](/developers/guides/authentication).

***

## Prerequisites

* Admin API: Bearer token with admin access + `?o={organization_id}`
* Customer API: Authenticated customer account for claiming subscriptions

***

## Public plan catalog (shop)

The shop subscription page loads **plan groups** from the public organization, then loads plans per group. Groups are morph-owned by the organization or its master. Empty groups and groups with only private plans are omitted.

```http theme={null}
GET /api/v1/organizations/{slug}?include=offered_plan_groups,offered_plan_groups.owner
GET /api/v1/organizations/{slug}/available-plans?filter[groups]={group_id_or_uuid}&include=group
GET /api/v1/organizations/{slug}/available-plans?filter[without_group]=true
```

| Include / filter | Description |
| - | - |
| `include=offered_plan_groups` | Public plan groups that currently have at least one public plan, ordered by `name`. JSON:API ids are group UUIDs. |
| `include=offered_plan_groups.owner` | Sideload the owning organization (this org or its master). |
| `filter[groups]` | Plans in any of the given group **numeric ids or UUIDs**. Shop clients send the UUID from `offered_plan_groups`. |
| `filter[without_group]` | Pass `true` (string) to return ungrouped public plans only. |

Match the web shop: one section per offered group, then an **Other** section for `filter[without_group]=true`. Hide Other when that collection is empty.

<Warning>
  Send `filter[without_group]=true` as a **string**. A JSON boolean query value is rejected by the JSON:API decoder.
</Warning>

***

## Subscription Lifecycle

```text theme={null}
Created → Claimed → Active → [Suspended] → Cancelled → Expired
```

### Key Date Fields

| Field | Description |
| - | - |
| `starts_at` | When the subscription begins |
| `ends_at` | When the subscription ends (null = indefinite) |
| `canceled_at` | Timestamp of cancellation request |
| `cancels_at` | When the cancellation takes effect (typically end of billing period) |
| `suspended_until` | Paused until this date |
| `auto_renewal` | Whether the subscription renews automatically |

### Status Lifecycle

| Status | Condition |
| - | - |
| `requested` | No `approved_at` or `rejected_at` set |
| `rejected` | `rejected_at` is set |
| `planned` | Approved, but `starts_at` is in the future |
| `trial` | Approved and within trial period |
| `active` | Approved, within date range, not suspended/canceled |
| `canceled` | `cancels_at` is set and in the future |
| `expired` | Past `ends_at` |
| `suspended` | Temporarily paused |

***

## Claiming a Subscription (Customer)

After a subscription is created (typically through an order), the customer claims it to activate:

```http theme={null}
GET /api/v1/plan-subscriptions/{subscription_id}/claim
```

Claiming transfers ownership from the customer record to the authenticated customer account. Subscriptions are initially attached to a customer (business record) and need to be linked to the customer account (login identity) for self-service management.

***

## Admin Operations

### Cancel

Sets `cancels_at` to the end of the current billing period. The subscription remains active until that date:

```http theme={null}
PUT /api/v1/plan-subscriptions/{subscription_id}/cancel?o={org_id}
```

### Revoke Cancellation

Un-cancels a subscription that hasn't yet reached `cancels_at`:

```http theme={null}
PUT /api/v1/plan-subscriptions/{subscription_id}/revoke?o={org_id}
```

### Suspend

Pauses the subscription until a specified date:

```http theme={null}
PUT /api/v1/plan-subscriptions/{subscription_id}/suspend?o={org_id}

{
  "data": {
    "type": "plan-subscriptions",
    "attributes": {
      "suspended_until": "2026-07-01"
    }
  }
}
```

Subscription exports are documented with the other admin export endpoints in [Exports](/developers/guides/admin/exports).

***

## Listing Subscriptions

Subscriptions are identified by `slug` (not numeric ID).

```http theme={null}
GET {BASE_URL}/plan-subscriptions?o={org_id}
```

### Get Subscriptions for a Customer

```http theme={null}
GET {BASE_URL}/customers/{customer_id}/subscriptions?o={org_id}&include=plan&sort=-starts_at&page[number]=1&page[size]=10
```

For customer accounts (end-user access):

```http theme={null}
GET {BASE_URL}/customer-accounts/{uuid}/subscriptions
```

Automatically scoped to the authenticated customer account — no `?o=` param needed.

### Search by Customer

```http theme={null}
GET {BASE_URL}/plan-subscriptions?o={org_id}&filter[search]=jane@example.com
```

### Filters

| Filter | Type | Description |
| - | - | - |
| `filter[status]` | string | `active`, `inactive`, `requested`, `planned`, `trial`, `canceled` |
| `filter[ids][]` | string\[] | Filter by subscription slugs |
| `filter[organization_id]` | string | Scope to a specific organization (morph ID) |
| `filter[start_date]` | date | Subscriptions starting after this date |
| `filter[end_date]` | date | Subscriptions ending before this date |
| `filter[start_date_range]` | string | Date range for `trial_starts_at` (format: `YYYY-MM-DD,YYYY-MM-DD`) |
| `filter[end_date_range]` | string | Date range for `ends_at` |
| `filter[plans]` | string | Filter by plan ID(s) |
| `filter[search]` | string | Fuzzy search across customer name/email/phone |
| `filter[utm_source]` | string | UTM source tracking |
| `filter[utm_medium]` | string | UTM medium tracking |
| `filter[utm_campaign]` | string | UTM campaign tracking |

### Sorting

| Sort parameter | Description |
| - | - |
| `name` | Subscription/plan name |
| `starts_at` | Start date |
| `ends_at` | End date |
| `created_at` | Creation date |
| `updated_at` | Last update |
| `charged_at` | Last charge date |

```http theme={null}
GET {BASE_URL}/plan-subscriptions?o={org_id}&filter[status]=active&sort=-starts_at
```

### Includes

| Include path | Description |
| - | - |
| `plan` | The subscription plan |
| `plan.features` | Plan features |
| `plan.quotas.feature` | Plan quota limits with feature |
| `usage` | Current usage records |
| `usage.feature` | Usage with feature context |
| `customer` | Linked customer (admin only) |
| `invoices.items` | Invoices with line items |
| `invoices.payment` | Invoices with payment details |
| `payment_setup` | Payment setup configuration |
| `payment_setup.payments` | Payment setup with payment history |
| `payment_setup.method` | Payment method details |
| `owner` | Organization that owns the plan |
| `document_acceptances.document` | Accepted legal documents |
| `document_acceptances.file` | Document files |
| `files` | Attached files |
| `sent_emails` | Email history |
| `custom_entries` | Custom field entries |
| `custom_entries.field` | Custom entries with field definitions |
| `utm_tracker` | UTM tracking data |

```http theme={null}
GET {BASE_URL}/plan-subscriptions?o={org_id}&include=plan,customer,invoices.items
```

***

## Get a Single Subscription

```http theme={null}
GET {BASE_URL}/plan-subscriptions/{slug}?o={org_id}&include=plan,customer,usage
```

Append `?include_summary=true` to include a `usage_summary` in the response `meta`.

***

## Response Schema

### Attributes

| Attribute | Type | Description |
| - | - | - |
| `name` | string | Plan name |
| `description` | string | Plan description |
| `status` | string | Computed: `active`, `requested`, `planned`, `trial`, `canceled`, `expired`, `suspended`, `rejected` |
| `price` | number | Base subscription price |
| `effective_price` | number | Price after discounts |
| `display_price` | string | Formatted display price |
| `currency` | string | e.g. `"EUR"` |
| `is_net_price` | boolean | Whether price is net |
| `starts_at` | datetime | Subscription start |
| `ends_at` | datetime | Subscription end |
| `trial_starts_at` | datetime | Trial period start |
| `trial_ends_at` | datetime | Trial period end |
| `cancels_at` | datetime | Scheduled cancellation date |
| `canceled_at` | datetime | Actual cancellation timestamp |
| `suspended_at` | datetime | Suspension start |
| `suspended_until` | datetime | Suspension end |
| `approved_at` | datetime | Approval timestamp |
| `rejected_at` | datetime | Rejection timestamp |
| `charged_at` | datetime | Last charge timestamp |
| `next_billed_at` | datetime | Next billing date |
| `next_action` | string | Next lifecycle action |
| `next_action_at` | datetime | When next action occurs |
| `auto_renewal` | boolean | Whether subscription auto-renews |
| `is_billed_offline` | boolean | Offline billing flag |
| `billing_email` | string | Override email for billing |
| `notice_period` | string | Cancellation notice period |
| `credited_amount` | number | Amount credited |
| `relative_discount` | number | Percentage discount |
| `absolute_discount` | number | Fixed discount amount |
| `signup_fee` | number | One-time signup fee |
| `created_at` | datetime | Record creation |

### Relationships

| Relationship | Type | Description |
| - | - | - |
| `plan` | `plans` | The subscription plan |
| `subscriber` | polymorphic | Subscribing entity (customer-account or organization) |
| `customer` | `customers` | Linked customer (admin only) |
| `owner` | polymorphic | Plan owner (organization) |
| `payment_setup` | `payment-setups` | Payment configuration |
| `invoices` | `invoices` | Generated invoices |
| `usage` | `plan-subscription-usages` | Feature usage records |
| `document_acceptances` | `document-acceptances` | Legal document acceptances |
| `files` | `files` | Attached files |
| `sent_emails` | `sent-emails` | Email history |
| `utm_tracker` | `utm-trackers` | UTM tracking data |

### Example Response

```json theme={null}
{
  "data": {
    "type": "plan-subscriptions",
    "id": "abc123-slug",
    "attributes": {
      "name": "Premium Monthly",
      "status": "active",
      "price": 29.99,
      "effective_price": 29.99,
      "currency": "EUR",
      "starts_at": "2026-01-01T00:00:00+00:00",
      "ends_at": "2027-01-01T00:00:00+00:00",
      "auto_renewal": true,
      "next_billed_at": "2026-04-01T00:00:00+00:00"
    },
    "relationships": {
      "plan": {
        "data": { "type": "plans", "id": "7" }
      },
      "customer": {
        "data": { "type": "customers", "id": "123" }
      }
    }
  }
}
```

***

## Common Errors

| Error | Cause | Solution |
| - | - | - |
| `403` — unauthorized | Missing permissions | Ensure admin token has the required abilities |
| `422` — subscription not claimable | Claim attempted on wrong status | Verify subscription status before claiming |


# Waitlist
Source: https://docs.anny.co/developers/guides/customer/waitlist



Use waitlist only when a resource allows waitlist entries and the requested period is unavailable because it is fully booked.

For general request conventions, see [JSON:API Conventions](/developers/guides/json-api-conventions). For slot search, see [Availability & Booking Search](/developers/guides/availability).

***

## When To Display Waitlist

Show waitlist only when both conditions are true:

1. The resource has waitlist enabled.
2. The requested period is unavailable because it is `booked_out`.

In the shop frontend this is the concrete gate:

* `resource.metaSettings.waitlist.enabled === true`
* the unavailable interval or series has `unavailability_type === BOOKED_OUT`

Do not show waitlist for other unavailability reasons like lead time conflicts, off-schedule dates, or duration conflicts.

<Tabs>
  <Tab title="Date picker flow">
    Show the generic waitlist CTA when:

    * the resource enables waitlist
    * at least one fetched start or end interval is `BOOKED_OUT`

    Booked out calendar days are also used as direct waitlist entry points:

    * the tooltip is shown only for booked out days
    * clicking an unavailable day opens waitlist only for booked out days
  </Tab>

  <Tab title="List flow">
    Show a per-slot “Join waitlist” action only for intervals where:

    * the resource enables waitlist
    * `interval.unavailability_type === BOOKED_OUT`

    If no valid period selection is available at all, the list view falls back to a generic waitlist CTA.
  </Tab>

  <Tab title="Series flow">
    Show the waitlist CTA only when:

    * the selected series is not available
    * the selected series has `unavailability_type === BOOKED_OUT`
    * the resource enables waitlist
  </Tab>
</Tabs>

***

## Auth Requirement

Creating, listing, and deleting waitlist spots requires an authenticated customer account.

* unauthenticated shop calls are skipped client-side
* backend create, list, and delete authorization rejects requests without an active customer

Public availability endpoints can still be used to decide whether waitlist should be offered.

***

## Waitlist Interval Requests

The waitlist step uses the same availability engine as booking search, but with the waitlist validation strategy.

<Steps>
  <Step title="Get waitlist start intervals">
    Use this to fetch possible waitlist start points:

    ```http theme={null}
    GET /api/v1/intervals/waitlist-start?service_id={service_id}&resource_id={resource_id}&date=2026-04-15&timezone=Europe/Berlin
    ```

    | Parameter | Required | Notes |
    | - | - | - |
    | `service_id` | yes | Service id or uuid used to build service configuration |
    | `resource_id` | no | Recommended when the waitlist belongs to a specific resource |
    | `date` | no | Use `YYYY-MM-DD` for a single-day request |
    | `start_date` | no | Optional pagination cursor in Atom format |
    | `timezone` | no | Defaults to resource timezone or organization timezone |
    | `duration` | no | Optional requested duration in the service unit |

    If `date` is omitted, the backend falls back to paginated interval lookup based on `start_date` and service configuration.
  </Step>

  <Step title="Get waitlist end intervals">
    Use this after the user picked a waitlist start:

    ```http theme={null}
    GET /api/v1/intervals/waitlist-end?service_id={service_id}&resource_id={resource_id}&date_time=2026-04-15T09:00:00%2B02:00&timezone=Europe/Berlin
    ```

    | Parameter | Required | Notes |
    | - | - | - |
    | `service_id` | yes | Service id or uuid |
    | `date_time` | yes | Start datetime in Atom / ISO 8601 format |
    | `resource_id` | no | Recommended for resource-specific waitlist flows |
    | `timezone` | no | Defaults to resource or organization timezone |
    | `adhoc` | no | Optional boolean |
  </Step>
</Steps>

***

## Create A Waitlist Spot

Create the actual waitlist entry with the authenticated customer API:

```http theme={null}
POST /api/v1/waitlist-spots
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Authorization: Bearer {customer_token}
```

```json theme={null}
{
  "data": {
    "type": "waitlist-spots",
    "attributes": {
      "start_date": "2026-04-15T09:00:00+02:00",
      "end_date": "2026-04-15T11:00:00+02:00"
    },
    "relationships": {
      "resource": {
        "data": {
          "type": "resources",
          "id": "123"
        }
      },
      "service": {
        "data": {
          "type": "services",
          "id": "456"
        }
      }
    }
  }
}
```

### Required fields

| Location | Field | Required | Notes |
| - | - | - | - |
| `data.type` | `waitlist-spots` | yes | Must match the JSON:API resource type |
| `data.attributes.start_date` | Atom datetime | yes | Preferred start |
| `data.attributes.end_date` | Atom datetime | yes | Preferred end |
| `data.relationships.resource.data` | resource identifier | yes | Required by validator and used to derive organization |

### Optional fields

| Location | Field | Required | Notes |
| - | - | - | - |
| `data.relationships.service.data` | service identifier or `null` | no | The sample backend request allows `null`, but the shop sends the main service |

### What the backend fills automatically

You do not send these values:

* `account_id` is taken from the authenticated customer
* `organization_id` is derived from the resource
* `uuid` is generated automatically

### Duplicate handling

If the same customer already has an active waitlist entry for the same resource, `start_date`, and `end_date`, the backend replaces the old row and keeps the same UUID.

***

## List And Remove Waitlist Spots

List current active waitlist entries for the authenticated customer:

```http theme={null}
GET /api/v1/waitlist-spots?with_position=true&filter[resource]=123
```

Notes:

* results include only active entries
* past entries are excluded
* entries already converted to bookings are excluded
* `with_position=true` adds `meta.position`

Delete an entry by waitlist UUID:

```http theme={null}
DELETE /api/v1/waitlist-spots/{waitlist_uuid}
```

Only the customer who owns the waitlist entry can delete it.


# Admin API
Source: https://docs.anny.co/developers/api-reference/admin



The Admin API gives you **full programmatic access** to your anny organization. It is built for **server-side integrations** — backend services, automation scripts, and custom tooling that act on behalf of your team.

***

## When to use the Admin API

Use the Admin API when you need to **drive workflows from your own systems**:

* **Sync membership data** — create or update customers, assign them to communities, reflect subscription status from an external CRM
* **Create bookings programmatically** — build back-office tools or automate repeat reservations without going through the customer checkout
* **Issue and forward invoices** — generate invoices, send them to customers, or push them to your accounting system
* **React to real-time events** — pair the API with [Webhooks](/developers/guides/admin/webhooks) to trigger side effects whenever a booking is created, cancelled, or checked in
* **Drive display panels** — push live occupancy and schedule data to digital signage or lobby displays

Combined with [webhook subscriptions](/developers/guides/admin/webhooks), you can build fully automated, event-driven workflows without polling.

***

## Authentication

Generate a long-lived API token directly in the admin dashboard under **Organization Settings → API**. All requests require it in the `Authorization` header:

```http theme={null}
Authorization: Bearer {access_token}
```

Every endpoint is **organization-scoped**. Pass your organization ID as a query parameter on every request:

```text theme={null}
?o={organization_id}
```

See the [Authentication guide](/developers/guides/authentication) for token scopes and the full OAuth2 flow.

***

## Admin API vs Customer API

| | Admin API | Customer API |
| - | - | - |
| **Use case** | Server-side automation, backend tooling | End-user apps, booking widgets |
| **Auth** | Required — API token or OAuth2 | Optional — many endpoints work without a token |
| **Identifiers** | Immutable UUIDs and integer IDs | Slugs, booking numbers, order numbers |
| **Access** | Full read/write | Public and customer-owned data only |

→ [Go to the Customer API](/developers/api-reference/customer)

***

## Resource Identifiers

The Admin API uses **immutable IDs** — UUIDs for most entities, integers for legacy ones. These are safe to store in external systems and never change, even if an organization renames a resource.

***

## Starting Points

| Guide | What it covers |
| - | - |
| [Getting Started](/developers) | First steps and quickstart |
| [JSON:API Conventions](/developers/guides/json-api-conventions) | Request and response format |
| [Authentication](/developers/guides/authentication) | API tokens, OAuth2, scopes |
| [Availability & Booking Search](/developers/guides/availability) | Search open slots and timeslots |
| [Admin Booking Creation](/developers/guides/admin/booking-creation) | Create bookings from the back office |
| [Admin Booking Edit](/developers/guides/admin/booking-edit) | Edit resource, dates, fields, add-ons, and sub-bookings |
| [Admin Booking Lifecycle](/developers/guides/admin/booking-lifecycle) | Status changes, check-in, cancellations |
| [Invoices](/developers/guides/admin/invoices) | Create, send, and manage invoices |
| [Customer Management](/developers/guides/admin/customer-management) | Create and manage customer records |
| [Booking Calendars](/developers/guides/admin/calendar-events) | Custom calendar events |
| [Timeslot Management](/developers/guides/admin/timeslot-management) | Manage timeslot CRUD, recurrence, allocations, and rescheduling |
| [Broadcast Campaigns](/developers/guides/admin/broadcasting) | Email and push campaigns |
| [Exports](/developers/guides/admin/exports) | Export bookings and customer data |
| [Webhooks & Events](/developers/guides/admin/webhooks) | Subscribe to real-time events |

***

## Base URLs

| Environment | URL |
| - | - |
| Production | `https://b.anny.co` |
| Gov-Cloud | `https://b.anny.eu` |


# Create a booking add on
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-add-ons/create-a-booking-add-on

/developers/openapi/admin.openapi.json post /api/v1/booking-add-ons



# Delete a booking add on
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-add-ons/delete-a-booking-add-on

/developers/openapi/admin.openapi.json delete /api/v1/booking-add-ons/{booking_add_on_id}



# Update a booking add on
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-add-ons/update-a-booking-add-on

/developers/openapi/admin.openapi.json patch /api/v1/booking-add-ons/{booking_add_on_id}



# Check booking in
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/check-booking-in

/developers/openapi/admin.openapi.json post /api/v1/bookings/{booking_id}/check-in



# Check booking out
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/check-booking-out

/developers/openapi/admin.openapi.json post /api/v1/bookings/{booking_id}/check-out



# Create simple booking or blocker
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/create-simple-booking-or-blocker

/developers/openapi/admin.openapi.json post /api/v1/bookings



# Delete a specific booking
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/delete-a-specific-booking

/developers/openapi/admin.openapi.json delete /api/v1/bookings/{booking_id}



# Edit booking add-ons and sub-bookings
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/edit-booking-add-ons-and-sub-bookings

/developers/openapi/admin.openapi.json post /api/v1/bookings/{booking_id}/edit/service-options
Replace the add-ons and sub-bookings of a confirmed booking. Applies immediately. Unlike the customer `edit-service-options` action, an admin may attach an organization add-on that is not wired to the booked service, and a sub-resource / sub-service pair that is not registered as a sub-resource of the booked service. Items from another organization are ignored.

Quantity `0` on an add-on removes it. Price corrections are parked as an unlocked draft invoice on the order.



# Edit booking resource, service, and dates
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/edit-booking-resource-service-and-dates

/developers/openapi/admin.openapi.json post /api/v1/bookings/{booking_id}/edit/base-data
Admin-only edit of a confirmed booking's resource, service configuration, dates, optional quota grant, and optional padding. Applies immediately — there is no preview or cancel-edit step. Customer edit gates (`canEditPeriod`, reschedule deadline) are ignored. Availability is not enforced.

`start_date` is required (Atom). `end_date` is required unless `duration` is set. Without `override_duration` / `duration`, the end is snapped to a validated interval of the (new) service — so changing `service_id` updates the booking duration when the old window is not valid for the new service. `charged_duration` follows the new service's pricing rules (fixed = one interval; flexible = ceil of the window).

`padding_before` / `padding_after` override the service defaults for this edit only (blocker window). Omit them to adopt the new service's padding.

`send_notification` is optional. When omitted it defaults to `true` (customer mail/push). Set `false` to skip the customer notification, for example for a silent admin calendar move.

`status_reason` is optional. When set, it is stored on the booking and included as the customer-facing message in the booking-updated email. It is distinct from the admin-only `note`.

Without `service_id`, a booking on a child resource may only move to a sibling of the same parent. With `service_id`, the booking may move to any organization resource, including one not wired to the service. A multi-service `service_id` map on a sequence-capable resource turns the booking into a sequence parent; dropping back to one service collapses it.

Price corrections are parked as an unlocked draft invoice on the order. See the Admin Booking Edit guide.



# Get a list of bookings
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/get-a-list-of-bookings

/developers/openapi/admin.openapi.json get /api/v1/bookings
List bookings for the current organization. Supports JSON:API includes, sparse fieldsets, filtering, sorting and pagination.

### Date range filters

The filters `filter[start_date_range]`, `filter[end_date_range]`, `filter[period_range]` and `filter[created_at_range]` accept either a **dynamic keyword** or a **static range** in the format `YYYY-MM-DD:YYYY-MM-DD` (colon-separated, both ends inclusive). `filter[created_at_range]` matches the booking row's creation time, not the appointment start.

Supported dynamic keywords:

| Keyword | Meaning |
|---------|---------|
| `today` | The current day (organization timezone) |
| `yesterday` | The previous day |
| `tomorrow` | The next day |
| `this_week` | Current ISO week (Mon–Sun) |
| `last_week` | Previous ISO week |
| `next_week` | Upcoming ISO week |
| `this_month` | Current calendar month |
| `last_month` | Previous calendar month |
| `next_month` | Upcoming calendar month |
| `last_3_months` | The three full calendar months before the current month (organization timezone) |
| `this_quarter` | Current calendar quarter (organization timezone) |
| `last_quarter` | Previous calendar quarter (organization timezone) |
| `next_7_days` | Today through 6 days later (7 calendar days, organization timezone) |
| `next_30_days` | Today through 29 days later (30 calendar days, organization timezone) |
| `this_year` | Current calendar year |
| `last_year` | Previous calendar year |
| `past` | Everything strictly before now |
| `future` | Everything strictly after now |

Examples:

```
filter[start_date_range]=today
filter[start_date_range]=this_week
filter[start_date_range]=2026-04-01:2026-04-30
```

### Filtering by resources

Use the array syntax to pass one or more resource IDs. The filter accepts either the repeated-bracket form (`filter[resources][]=155930`) or a comma-separated list (`filter[resources]=155930,155931`):

```
filter[resources][]=155930&filter[resources][]=155931
```

The same syntax applies to `filter[resource_groups]`, `filter[services]`, `filter[status]`, `filter[communities]`, `filter[add_ons]`, `filter[tests]` and `filter[test_results]`.



# Get a specific booking
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/get-a-specific-booking

/developers/openapi/admin.openapi.json get /api/v1/bookings/{booking_id}



# Get all custom entries associated with a specific booking
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/get-all-custom-entries-associated-with-a-specific-booking

/developers/openapi/admin.openapi.json get /api/v1/bookings/{booking_id}/custom-entries



# Get all model-identifiers associated with a specific booking
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/get-all-model-identifiers-associated-with-a-specific-booking

/developers/openapi/admin.openapi.json get /api/v1/bookings/{booking_id}/model-identifiers



# Get all scans associated with a specific booking
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/get-all-scans-associated-with-a-specific-booking

/developers/openapi/admin.openapi.json get /api/v1/bookings/{booking_id}/scans



# Get all test results associated with a specific booking
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/get-all-test-results-associated-with-a-specific-booking

/developers/openapi/admin.openapi.json get /api/v1/bookings/{booking_id}/test-results



# Reassign the booking customer
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/reassign-the-booking-customer

/developers/openapi/admin.openapi.json post /api/v1/bookings/{booking_id}/edit/customer
Reassign the customer of a confirmed booking. The customer must belong to the active organization.

When the booking is not personalized (its customer matches the order customer), the change also updates the order customer. When it is personalized, only this booking is reassigned. Sub-bookings and sequenced children adopt the new customer.



# Sync booking participants
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/sync-booking-participants

/developers/openapi/admin.openapi.json post /api/v1/bookings/{booking_id}/edit/participants
Sync the participants you send onto a confirmed booking. Matching emails are updated in place. Participants missing from the payload are kept — this action never deletes attendees.



# Update a specific booking
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/bookings/update-a-specific-booking

/developers/openapi/admin.openapi.json patch /api/v1/bookings/{booking_id}



# Create a calendar
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/calendars/create-a-calendar

/developers/openapi/admin.openapi.json post /api/v1/calendars



# Delete a calendar
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/calendars/delete-a-calendar

/developers/openapi/admin.openapi.json delete /api/v1/calendars/{calendar_id}



# Get a calendar
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/calendars/get-a-calendar

/developers/openapi/admin.openapi.json get /api/v1/calendars/{calendar_id}



# Get a list of ICS calendars
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/calendars/get-a-list-of-ics-calendars

/developers/openapi/admin.openapi.json get /api/v1/calendars



# Update a calendar
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/calendars/update-a-calendar

/developers/openapi/admin.openapi.json patch /api/v1/calendars/{calendar_id}



# Get a list of custom fields
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/custom-fields/get-a-list-of-custom-fields

/developers/openapi/admin.openapi.json get /api/v1/custom-fields



# Get a list of custom forms
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/custom-forms/get-a-list-of-custom-forms

/developers/openapi/admin.openapi.json get /api/v1/custom-forms



# Create a customer
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/create-a-customer

/developers/openapi/admin.openapi.json post /api/v1/customers



# Delete a customer
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/delete-a-customer

/developers/openapi/admin.openapi.json delete /api/v1/customers/{customer_id}



# Get a customer
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/get-a-customer

/developers/openapi/admin.openapi.json get /api/v1/customers/{customer_id}



# Get a list of customers
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/get-a-list-of-customers

/developers/openapi/admin.openapi.json get /api/v1/customers



# Get bookings linked to a customer
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/get-bookings-linked-to-a-customer

/developers/openapi/admin.openapi.json get /api/v1/customers/{customer_id}/bookings



# Get model identifiers linked to a customer
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/get-model-identifiers-linked-to-a-customer

/developers/openapi/admin.openapi.json get /api/v1/customers/{customer_id}/model-identifiers



# Get orders linked to a customer
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/get-orders-linked-to-a-customer

/developers/openapi/admin.openapi.json get /api/v1/customers/{customer_id}/orders



# Remove a customer from a community
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/remove-a-customer-from-a-community

/developers/openapi/admin.openapi.json get /api/v1/customers/{customer_id}/remove-from-community



# Update a customer
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/update-a-customer

/developers/openapi/admin.openapi.json patch /api/v1/customers/{customer_id}



# Delete a scan record
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/scans/delete-a-scan-record

/developers/openapi/admin.openapi.json delete /api/v1/scans/{scan_id}



# Get a scan record
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/scans/get-a-scan-record

/developers/openapi/admin.openapi.json get /api/v1/scans/{scan_id}
Retrieve details of a single check-in scan event.



# Scan an entity
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/scans/scan-an-entity

/developers/openapi/admin.openapi.json post /api/v1/scans
Record a check-in or check-out scan. The scannable entity is identified via query parameters
(`code` + optional `scannable_type`), not via JSON:API relationships.



# Update a scan record
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/scans/update-a-scan-record

/developers/openapi/admin.openapi.json patch /api/v1/scans/{scan_id}



# Create resource-schedule-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/create-resource-schedule-group

/developers/openapi/admin.openapi.json post /api/v1/resource-schedule-groups



# Create schedule-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/create-schedule-group

/developers/openapi/admin.openapi.json post /api/v1/schedule-groups



# Delete resource-schedule-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/delete-resource-schedule-group

/developers/openapi/admin.openapi.json delete /api/v1/resource-schedule-groups/{resource_schedule_group_id}



# Delete schedule-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/delete-schedule-group

/developers/openapi/admin.openapi.json delete /api/v1/schedule-groups/{schedule_group_id}



# Duplicate schedule group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/duplicate-schedule-group

/developers/openapi/admin.openapi.json get /api/v1/schedule-groups/{schedule_group_id}/duplicate



# Get resource-schedule-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/get-resource-schedule-group

/developers/openapi/admin.openapi.json get /api/v1/resource-schedule-groups/{resource_schedule_group_id}



# Get schedule-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/get-schedule-group

/developers/openapi/admin.openapi.json get /api/v1/schedule-groups/{schedule_group_id}



# List schedule-groups
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/list-schedule-groups

/developers/openapi/admin.openapi.json get /api/v1/schedule-groups



# Update resource-schedule-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/update-resource-schedule-group

/developers/openapi/admin.openapi.json patch /api/v1/resource-schedule-groups/{resource_schedule_group_id}



# Update schedule-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedule-groups/update-schedule-group

/developers/openapi/admin.openapi.json patch /api/v1/schedule-groups/{schedule_group_id}



# Create a new schedule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedules/create-a-new-schedule

/developers/openapi/admin.openapi.json post /api/v1/schedules



# Delete a schedule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedules/delete-a-schedule

/developers/openapi/admin.openapi.json delete /api/v1/schedules/{schedule_id}



# Get a schedule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedules/get-a-schedule

/developers/openapi/admin.openapi.json get /api/v1/schedules/{schedule_id}



# Update a schedule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/schedules/update-a-schedule

/developers/openapi/admin.openapi.json patch /api/v1/schedules/{schedule_id}



# Create a timeslot resource allocation
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-allocations/create-a-timeslot-resource-allocation

/developers/openapi/admin.openapi.json post /api/v1/timeslot-resource-allocations



# Delete a timeslot resource allocation
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-allocations/delete-a-timeslot-resource-allocation

/developers/openapi/admin.openapi.json delete /api/v1/timeslot-resource-allocations/{timeslot_resource_allocation_id}



# Get a timeslot resource allocation
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-allocations/get-a-timeslot-resource-allocation

/developers/openapi/admin.openapi.json get /api/v1/timeslot-resource-allocations/{timeslot_resource_allocation_id}



# List timeslot resource allocations
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-allocations/list-timeslot-resource-allocations

/developers/openapi/admin.openapi.json get /api/v1/timeslot-resource-allocations



# Update a timeslot resource allocation
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-allocations/update-a-timeslot-resource-allocation

/developers/openapi/admin.openapi.json patch /api/v1/timeslot-resource-allocations/{timeslot_resource_allocation_id}



# Create a timeslot series
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-series/create-a-timeslot-series

/developers/openapi/admin.openapi.json post /api/v1/timeslot-series



# Delete a timeslot series
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-series/delete-a-timeslot-series

/developers/openapi/admin.openapi.json delete /api/v1/timeslot-series/{timeslot_series_id}



# Get a timeslot series
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-series/get-a-timeslot-series

/developers/openapi/admin.openapi.json get /api/v1/timeslot-series/{timeslot_series_id}



# List timeslot series
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-series/list-timeslot-series

/developers/openapi/admin.openapi.json get /api/v1/timeslot-series



# Update a timeslot series
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslot-series/update-a-timeslot-series

/developers/openapi/admin.openapi.json patch /api/v1/timeslot-series/{timeslot_series_id}



# Create a timeslot
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslots/create-a-timeslot

/developers/openapi/admin.openapi.json post /api/v1/timeslots



# Create recurring timeslots from an existing timeslot
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslots/create-recurring-timeslots-from-an-existing-timeslot

/developers/openapi/admin.openapi.json post /api/v1/timeslots/{timeslot_id}/extend



# Delete a timeslot
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslots/delete-a-timeslot

/developers/openapi/admin.openapi.json delete /api/v1/timeslots/{timeslot_id}



# Get a timeslot
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslots/get-a-timeslot

/developers/openapi/admin.openapi.json get /api/v1/timeslots/{timeslot_id}



# Get regular bookings linked to a timeslot
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslots/get-regular-bookings-linked-to-a-timeslot

/developers/openapi/admin.openapi.json get /api/v1/timeslots/{timeslot_id}/regular-bookings



# List timeslots
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslots/list-timeslots

/developers/openapi/admin.openapi.json get /api/v1/timeslots



# Preview recurring timeslot occurrences
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslots/preview-recurring-timeslot-occurrences

/developers/openapi/admin.openapi.json post /api/v1/timeslots/preview



# Update a timeslot
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/timeslots/update-a-timeslot

/developers/openapi/admin.openapi.json patch /api/v1/timeslots/{timeslot_id}
Use the reschedule query parameters when changing the period of a timeslot with existing regular bookings.



# Get all quota grants
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/booking-quota-grants/get-all-quota-grants

/developers/openapi/customer.openapi.json post /api/v1/booking-quota-grants/all-grants



# Get booking-quota-grant
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/booking-quota-grants/get-booking-quota-grant

/developers/openapi/customer.openapi.json get /api/v1/booking-quota-grants/{booking_quota_grant_id}



# Get terms and conditions for an organization
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/legal-documents/get-terms-and-conditions-for-an-organization

/developers/openapi/customer.openapi.json get /api/v1/organizations/{organization_slug}/terms-and-conditions



# Get the privacy policy for an organization
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/legal-documents/get-the-privacy-policy-for-an-organization

/developers/openapi/customer.openapi.json get /api/v1/organizations/{organization_slug}/privacy-policy



# Get an organization
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/organizations/get-an-organization

/developers/openapi/customer.openapi.json get /api/v1/organizations/{organization_slug}



# Get resources of an organization
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/organizations/get-resources-of-an-organization

/developers/openapi/customer.openapi.json get /api/v1/organizations/{organization_slug}/resources



# Get services of an organization
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/organizations/get-services-of-an-organization

/developers/openapi/customer.openapi.json get /api/v1/organizations/{organization_slug}/services



# Get unique select options for property filter
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/organizations/get-unique-select-options-for-property-filter

/developers/openapi/customer.openapi.json get /api/v1/properties/{property_id}/options
When filtering properties of a resource, properties with value type string need to be filtered with one or more of these distsict options.

Get the all the relevant options to select for filtering, we need to request them dynamically using all active resource filters and a required organization_slug filter to set the context.

The endpoint will return all options for resources that apply to the given filters to let the user narrow down their search.



# Claim a plan subscription
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/claim-a-plan-subscription

/developers/openapi/customer.openapi.json get /api/v1/plan-subscriptions/{plan_subscription_id}/claim



# Revoke a plan subscription
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/revoke-a-plan-subscription

/developers/openapi/customer.openapi.json put /api/v1/plan-subscriptions/{plan_subscription_id}/revoke



# Suspend a plan subscription
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/plan-subscriptions/suspend-a-plan-subscription

/developers/openapi/customer.openapi.json put /api/v1/plan-subscriptions/{plan_subscription_id}/suspend



# Get a property
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/properties/get-a-property

/developers/openapi/customer.openapi.json get /api/v1/properties/{property_id}



# Get available properties
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/properties/get-available-properties

/developers/openapi/customer.openapi.json get /api/v1/organizations/{organization_slug}/properties
This endpoint allows listing all available properties (for a given resource category).
Properties can be used to filter resources by adding the following query params to any /resources endpoint:

Comparison operator: `filter[properties][{propertyId}][o]={operator}` // operator: >=, =, <=, in

Comparison value: `filter[properties][{propertyId}][v]={value}` // value: int|string|array



# Create a queue ticket from a booking
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/queue-tickets/create-a-queue-ticket-from-a-booking

/developers/openapi/customer.openapi.json post /api/v1/bookings/create-ticket



# Cancel queue ticket
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/queues/cancel-queue-ticket

/developers/openapi/customer.openapi.json post /api/v1/queue-tickets/{queue_ticket_id}/cancel



# Get queue-ticket
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/queues/get-queue-ticket

/developers/openapi/customer.openapi.json get /api/v1/queue-tickets/{queue_ticket_id}



# Update queue-ticket
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/queues/update-queue-ticket

/developers/openapi/customer.openapi.json patch /api/v1/queue-tickets/{queue_ticket_id}



# Get a resource
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-a-resource

/developers/openapi/customer.openapi.json get /api/v1/resources/{resource_slug}



# Get community access restrictions for a resource
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-community-access-restrictions-for-a-resource

/developers/openapi/customer.openapi.json get /api/v1/resources/{resource_slug}/community-restrictions



# Get gallery images for a given resource
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-gallery-images-for-a-given-resource

/developers/openapi/customer.openapi.json get /api/v1/resource/{resource_slug}/gallery-images



# Get resource childrens for a given resource
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-resource-childrens-for-a-given-resource

/developers/openapi/customer.openapi.json get /api/v1/resources/{resource_slug}/children
For a full list of query params, please see /organizations/{organization_slug}/resources.



# Get resource locations for map display
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-resource-locations-for-map-display

/developers/openapi/customer.openapi.json get /api/v1/resources/locations



# Get services of a resource
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/resources/get-services-of-a-resource

/developers/openapi/customer.openapi.json get /api/v1/resources/{resource_slug}/services
Request a list of services for a resource. Optionally include related `add_ons` and `sub_resources`.



# Get a list of services
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-a-list-of-services

/developers/openapi/customer.openapi.json get /api/v1/services
Only for sub-platforms.



# Get a service
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-a-service

/developers/openapi/customer.openapi.json get /api/v1/services/{service_slug}
Get a service by slug.



# Get available add-ons for a given service
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-available-add-ons-for-a-given-service

/developers/openapi/customer.openapi.json get /api/v1/services/{service_slug}/add-ons



# Get available resources for a given service
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-available-resources-for-a-given-service

/developers/openapi/customer.openapi.json get /api/v1/services/{service_slug}/resources



# Get booking panel configuration for a service
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-booking-panel-configuration-for-a-service

/developers/openapi/customer.openapi.json get /api/v1/service-configuration
Returns structured configuration including available options, next available date, and booking constraints for the service.



# Get sub resources for a given services
Source: https://docs.anny.co/developers/api-reference/customer/endpoints/services/get-sub-resources-for-a-given-services

/developers/openapi/customer.openapi.json get /api/v1/services/{service_slug}/sub-resources



# Create add-on-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-on-groups/create-add-on-group

/developers/openapi/admin.openapi.json post /add-on-groups



# Delete add-on-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-on-groups/delete-add-on-group

/developers/openapi/admin.openapi.json delete /add-on-groups/{add_on_group_id}



# Get add-on-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-on-groups/get-add-on-group

/developers/openapi/admin.openapi.json get /add-on-groups/{add_on_group_id}



# List add-on-groups
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-on-groups/list-add-on-groups

/developers/openapi/admin.openapi.json get /add-on-groups



# Update add-on-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-on-groups/update-add-on-group

/developers/openapi/admin.openapi.json patch /add-on-groups/{add_on_group_id}



# Create a new add on
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-ons/create-a-new-add-on

/developers/openapi/admin.openapi.json post /api/v1/add-ons



# Delete an add-on record
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-ons/delete-an-add-on-record

/developers/openapi/admin.openapi.json delete /api/v1/add-ons/{add_on_id}



# Get a list of add-ons
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-ons/get-a-list-of-add-ons

/developers/openapi/admin.openapi.json get /api/v1/add-ons



# Get an add-on record
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-ons/get-an-add-on-record

/developers/openapi/admin.openapi.json get /api/v1/add-ons/{add_on_id}



# Update an add-on record
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/add-ons/update-an-add-on-record

/developers/openapi/admin.openapi.json patch /api/v1/add-ons/{add_on_id}



# Auto-translate booking bundle content
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-bundles/auto-translate-booking-bundle-content

/developers/openapi/admin.openapi.json post /api/v1/booking-bundles/{booking_bundle_id}/translate-model



# Create booking-quota-grant
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-quota-grants/create-booking-quota-grant

/developers/openapi/admin.openapi.json post /api/v1/booking-quota-grants



# Create booking-quota
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-quotas/create-booking-quota

/developers/openapi/admin.openapi.json post /api/v1/booking-quotas



# Delete booking-quota
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-quotas/delete-booking-quota

/developers/openapi/admin.openapi.json delete /api/v1/booking-quotas/{booking_quota_id}



# Get booking-quota
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-quotas/get-booking-quota

/developers/openapi/admin.openapi.json get /api/v1/booking-quotas/{booking_quota_id}



# List booking-quotas
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-quotas/list-booking-quotas

/developers/openapi/admin.openapi.json get /api/v1/booking-quotas



# Update booking-quota
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-quotas/update-booking-quota

/developers/openapi/admin.openapi.json patch /api/v1/booking-quotas/{booking_quota_id}



# Create a business
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/businesses/create-a-business

/developers/openapi/admin.openapi.json post /api/v1/businesses
Create a new business in the organization.



# Delete a business
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/businesses/delete-a-business

/developers/openapi/admin.openapi.json delete /api/v1/businesses/{business_id}
Delete a business. Customers linked to this business will be unlinked.



# Get a business
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/businesses/get-a-business

/developers/openapi/admin.openapi.json get /api/v1/businesses/{business_id}
Get a single business by UUID.



# List businesses
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/businesses/list-businesses

/developers/openapi/admin.openapi.json get /api/v1/businesses
List all businesses in the organization.



# Update a business
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/businesses/update-a-business

/developers/openapi/admin.openapi.json patch /api/v1/businesses/{business_id}
Update an existing business.



# Create community
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/communities/create-community

/developers/openapi/admin.openapi.json post /api/v1/communities



# Delete community
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/communities/delete-community

/developers/openapi/admin.openapi.json delete /api/v1/communities/{community_id}



# Get community
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/communities/get-community

/developers/openapi/admin.openapi.json get /api/v1/communities/{community_id}



# List communities
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/communities/list-communities

/developers/openapi/admin.openapi.json get /api/v1/communities



# Send community invitations by email
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/communities/send-community-invitations-by-email

/developers/openapi/admin.openapi.json post /api/v1/communities/{community_id}/invites



# Sync auto-join members for a community
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/communities/sync-auto-join-members-for-a-community

/developers/openapi/admin.openapi.json get /api/v1/communities/{community_id}/sync-auto-join
Triggers sync of eligible members based on community auto-join rules. Returns count of newly added members.



# Sync booking quota grants for a community
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/communities/sync-booking-quota-grants-for-a-community

/developers/openapi/admin.openapi.json get /api/v1/communities/{community_id}/sync-quotas



# Update community
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/communities/update-community

/developers/openapi/admin.openapi.json patch /api/v1/communities/{community_id}



# Delete community-invite
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/community-invites/delete-community-invite

/developers/openapi/admin.openapi.json delete /api/v1/community-invites/{community_invite_id}



# List community-invites
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/community-invites/list-community-invites

/developers/openapi/admin.openapi.json get /api/v1/community-invites



# Resend a community invitation email
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/community-invites/resend-a-community-invitation-email

/developers/openapi/admin.openapi.json get /api/v1/community-invites/{community_invite_id}/resend



# Update community-invite
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/community-invites/update-community-invite

/developers/openapi/admin.openapi.json patch /api/v1/community-invites/{community_invite_id}



# Merge a customer into another customer record
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/merge-a-customer-into-another-customer-record

/developers/openapi/admin.openapi.json post /api/v1/customers/{customer_id}/merge
Moves all bookings, orders, and related data from this customer to the reference customer. The source customer is deleted.



# Resolve a customer from an account pass or identifier code
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customers/resolve-a-customer-from-an-account-pass-or-identifier-code

/developers/openapi/admin.openapi.json get /api/v1/customers/resolve-code



# Create an external calendar
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/external-calendars/create-an-external-calendar

/developers/openapi/admin.openapi.json post /api/v1/external-calendars



# Delete an external calendar
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/external-calendars/delete-an-external-calendar

/developers/openapi/admin.openapi.json delete /api/v1/external-calendars/{external_calendar_id}



# Get an external calendar
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/external-calendars/get-an-external-calendar

/developers/openapi/admin.openapi.json get /api/v1/external-calendars/{external_calendar_id}



# Update an external calendar
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/external-calendars/update-an-external-calendar

/developers/openapi/admin.openapi.json patch /api/v1/external-calendars/{external_calendar_id}



# Create external link
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/external-links/create-external-link

/developers/openapi/admin.openapi.json post /api/v1/external-links



# Delete external link
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/external-links/delete-external-link

/developers/openapi/admin.openapi.json delete /api/v1/external-links/{external_link_id}



# Update external link
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/external-links/update-external-link

/developers/openapi/admin.openapi.json patch /api/v1/external-links/{external_link_id}



# Create a plan subscription
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/plan-subscriptions/create-a-plan-subscription

/developers/openapi/admin.openapi.json post /api/v1/plan-subscriptions



# Delete a plan subscription
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/plan-subscriptions/delete-a-plan-subscription

/developers/openapi/admin.openapi.json delete /api/v1/plan-subscriptions/{plan_subscription_id}



# Get a plan subscription
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/plan-subscriptions/get-a-plan-subscription

/developers/openapi/admin.openapi.json get /api/v1/plan-subscriptions/{plan_subscription_id}



# Update a plan subscription
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/plan-subscriptions/update-a-plan-subscription

/developers/openapi/admin.openapi.json patch /api/v1/plan-subscriptions/{plan_subscription_id}



# Create price-modifier
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/price-modifiers/create-price-modifier

/developers/openapi/admin.openapi.json post /price-modifiers



# Delete price-modifier
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/price-modifiers/delete-price-modifier

/developers/openapi/admin.openapi.json delete /price-modifiers/{price_modifier_id}



# Get price-modifier
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/price-modifiers/get-price-modifier

/developers/openapi/admin.openapi.json get /price-modifiers/{price_modifier_id}



# List price-modifiers
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/price-modifiers/list-price-modifiers

/developers/openapi/admin.openapi.json get /price-modifiers



# Update price-modifier
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/price-modifiers/update-price-modifier

/developers/openapi/admin.openapi.json patch /price-modifiers/{price_modifier_id}



# Get a list of resource categories
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resource-categories/get-a-list-of-resource-categories

/developers/openapi/admin.openapi.json get /api/v1/resource-categories



# Create a resource group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resource-groups/create-a-resource-group

/developers/openapi/admin.openapi.json post /api/v1/resource-groups



# Delete a resource group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resource-groups/delete-a-resource-group

/developers/openapi/admin.openapi.json delete /api/v1/resource-groups/{resource_group_id}



# Get a list of resource groups
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resource-groups/get-a-list-of-resource-groups

/developers/openapi/admin.openapi.json get /api/v1/resource-groups



# Get a resource group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resource-groups/get-a-resource-group

/developers/openapi/admin.openapi.json get /api/v1/resource-groups/{resource_group_id}



# Update a resource group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resource-groups/update-a-resource-group

/developers/openapi/admin.openapi.json patch /api/v1/resource-groups/{resource_group_id}



# Create a resource property
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resource-properties/create-a-resource-property

/developers/openapi/admin.openapi.json post /api/v1/resource-properties



# Delete a resource property
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resource-properties/delete-a-resource-property

/developers/openapi/admin.openapi.json delete /api/v1/resource-properties/{resource_property_id}



# update a resource property
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resource-properties/update-a-resource-property

/developers/openapi/admin.openapi.json patch /api/v1/resource-properties/{resource_property_id}



# Auto-translate resource content
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/auto-translate-resource-content

/developers/openapi/admin.openapi.json post /api/v1/resources/{resource_id}/translate-model
Uses AI translation to translate the resource's translatable fields into the specified target languages.



# Create a new resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/create-a-new-resource

/developers/openapi/admin.openapi.json post /api/v1/resources



# Delete a resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/delete-a-resource

/developers/openapi/admin.openapi.json delete /api/v1/resources/{resource_id}



# Get a list of resources
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/get-a-list-of-resources

/developers/openapi/admin.openapi.json get /api/v1/resources



# Get a specific resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/get-a-specific-resource

/developers/openapi/admin.openapi.json get /api/v1/resources/{resource_id}



# Get all child resources of a specific resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/get-all-child-resources-of-a-specific-resource

/developers/openapi/admin.openapi.json get /api/v1/resources/{resource_id}/children



# Get all resource properties of a specific resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/get-all-resource-properties-of-a-specific-resource

/developers/openapi/admin.openapi.json get /api/v1/resources/{resource_id}/resource-properties



# Get timeslot series of a specific resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/get-timeslot-series-of-a-specific-resource

/developers/openapi/admin.openapi.json get /api/v1/resources/{resource_id}/timeslot-series



# Get timeslots of a specific resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/get-timeslots-of-a-specific-resource

/developers/openapi/admin.openapi.json get /api/v1/resources/{resource_id}/timeslots



# Update a specific resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/resources/update-a-specific-resource

/developers/openapi/admin.openapi.json patch /api/v1/resources/{resource_id}



# Create service-add-on
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/service-add-ons/create-service-add-on

/developers/openapi/admin.openapi.json post /service-add-ons



# Delete service-add-on
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/service-add-ons/delete-service-add-on

/developers/openapi/admin.openapi.json delete /service-add-ons/{service_add_on_id}



# Update service-add-on
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/service-add-ons/update-service-add-on

/developers/openapi/admin.openapi.json patch /service-add-ons/{service_add_on_id}



# Create service-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/service-groups/create-service-group

/developers/openapi/admin.openapi.json post /service-groups



# Delete service-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/service-groups/delete-service-group

/developers/openapi/admin.openapi.json delete /service-groups/{service_group_id}



# Get service-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/service-groups/get-service-group

/developers/openapi/admin.openapi.json get /service-groups/{service_group_id}



# List service-groups
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/service-groups/list-service-groups

/developers/openapi/admin.openapi.json get /service-groups



# Update service-group
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/service-groups/update-service-group

/developers/openapi/admin.openapi.json patch /service-groups/{service_group_id}



# Auto-translate service content
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/services/auto-translate-service-content

/developers/openapi/admin.openapi.json post /api/v1/services/{service_slug}/translate-model



# Create a new service
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/services/create-a-new-service

/developers/openapi/admin.openapi.json post /api/v1/services



# Delete a service
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/services/delete-a-service

/developers/openapi/admin.openapi.json delete /api/v1/services/{service_slug}



# Duplicate a service
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/services/duplicate-a-service

/developers/openapi/admin.openapi.json get /api/v1/services/{service_slug}/duplicate
Creates a copy of the service. Protected services (for example the hidden ClassPass or Urban Sports Club service) are rejected with `service_is_protected`. The replica never copies `is_protected`.



# Get a list of services
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/services/get-a-list-of-services

/developers/openapi/admin.openapi.json get /api/v1/services



# Get a specific service
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/services/get-a-specific-service

/developers/openapi/admin.openapi.json get /api/v1/services/{service_slug}



# Get tests associated with a service
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/services/get-tests-associated-with-a-service

/developers/openapi/admin.openapi.json get /api/v1/services/{service_slug}/tests



# Update a service
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/services/update-a-service

/developers/openapi/admin.openapi.json patch /api/v1/services/{service_slug}



# create a sub-resource state for a resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/sub-resources/create-a-sub-resource-state-for-a-resource

/developers/openapi/admin.openapi.json post /api/v1/service-sub-resources



# delete a sub resource state for a resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/sub-resources/delete-a-sub-resource-state-for-a-resource

/developers/openapi/admin.openapi.json delete /api/v1/service-sub-resources/{service_sub_resource_id}



# update a sub-resource state for a resource
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/sub-resources/update-a-sub-resource-state-for-a-resource

/developers/openapi/admin.openapi.json patch /api/v1/service-sub-resources/{service_sub_resource_id}



# Delete a test result
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/test-results/delete-a-test-result

/developers/openapi/admin.openapi.json delete /api/v1/test-results/{test-result-id}



# Get a test result
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/test-results/get-a-test-result

/developers/openapi/admin.openapi.json get /api/v1/test-results/{test-result-id}



# Regenerate certificate for a test result
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/test-results/regenerate-certificate-for-a-test-result

/developers/openapi/admin.openapi.json get /api/v1/test-results/{test_result_id}/regenerate-certificate



# Resend the result mail of a test-result
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/test-results/resend-the-result-mail-of-a-test-result

/developers/openapi/admin.openapi.json get /api/v1/test-results/{test_result_id}/resend-mail



# Update a test result
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/test-results/update-a-test-result

/developers/openapi/admin.openapi.json patch /api/v1/test-results/{test-result-id}



# Create a new test
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tests/create-a-new-test

/developers/openapi/admin.openapi.json post /api/v1/tests



# Delete a test
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tests/delete-a-test

/developers/openapi/admin.openapi.json delete /api/v1/tests/{test_id}



# Get a list of tests
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tests/get-a-list-of-tests

/developers/openapi/admin.openapi.json get /api/v1/tests



# Get a test
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tests/get-a-test

/developers/openapi/admin.openapi.json get /api/v1/tests/{test_id}



# Update a test
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tests/update-a-test

/developers/openapi/admin.openapi.json patch /api/v1/tests/{test_id}



# Create booking-bundle-group
Source: https://docs.anny.co/developers/api-reference/admin/booking-bundle-groups/create

Create a booking bundle group.

Create a booking bundle group. Requires `create` / `update` permission and `?o={organization_id}`.

```http theme={null}
POST /api/v1/booking-bundle-groups?o={organization_id}
```

```json theme={null}
{
  "data": {
    "type": "booking-bundle-groups",
    "attributes": {
      "name": "Gift cards",
      "description": "Vouchers and gift packages",
      "order_index": 1
    }
  }
}
```

<ParamField type="string">
  Group name (max 191).
</ParamField>

<ParamField type="string">
  Optional description.
</ParamField>

<ParamField type="number">
  Display order.
</ParamField>

<ParamField type="object">
  Name translations, keyed by locale.
</ParamField>

<ParamField type="object">
  Description translations, keyed by locale.
</ParamField>


# Delete booking-bundle-group
Source: https://docs.anny.co/developers/api-reference/admin/booking-bundle-groups/delete

Delete a booking bundle group. Bundles are detached, not deleted.

Delete a booking bundle group. Bundles in the group are **not** deleted: their `group` relationship is cleared (`group_id = null`). They then appear in `filter[without_group]=true` results.

```http theme={null}
DELETE /api/v1/booking-bundle-groups/{booking_bundle_group_id}?o={organization_id}
```

<ParamField type="string">
  Group id.
</ParamField>

Response: `204 No Content`.

<Warning>
  Do not assume cascade-delete of bundles. After delete, previously grouped packages belong in the ungrouped / Other section.
</Warning>


# Get booking-bundle-group
Source: https://docs.anny.co/developers/api-reference/admin/booking-bundle-groups/get

Get a booking bundle group by id.

Read a single booking bundle group.

```http theme={null}
GET /api/v1/booking-bundle-groups/{booking_bundle_group_id}?include=booking_bundles
```

<ParamField type="string">
  Group id.
</ParamField>

<ParamField type="string">
  Comma-separated. Allowed: `booking_bundles`.
</ParamField>


# List booking-bundle-groups
Source: https://docs.anny.co/developers/api-reference/admin/booking-bundle-groups/list

List booking bundle groups for the organization.

List booking bundle groups for the active organization. Index does not require write permission.

```http theme={null}
GET /api/v1/booking-bundle-groups?sort=order_index&include=booking_bundles
```

<ParamField type="string">
  Comma-separated. Allowed: `booking_bundles`.
</ParamField>

<ParamField type="string">
  Search group names.
</ParamField>

<ParamField type="string">
  Restrict to specific group ids.
</ParamField>

<ParamField type="string">
  Allowed: `order_index`, `name`, `created_at`. Prefix with `-` for descending.
</ParamField>

<ParamField type="integer" />

<ParamField type="integer" />

See [Booking Bundle Groups](/developers/guides/booking-bundle-groups) for assignment, public catalog includes, and delete behavior.


# Update booking-bundle-group
Source: https://docs.anny.co/developers/api-reference/admin/booking-bundle-groups/update

Update a booking bundle group.

Update a booking bundle group. Requires `create` / `update` permission and `?o={organization_id}`.

```http theme={null}
PATCH /api/v1/booking-bundle-groups/{booking_bundle_group_id}?o={organization_id}
```

Same attributes as create. Send only fields that change.

<ParamField type="string">
  Group id.
</ParamField>


# Create booking-bundle
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-bundles/create-booking-bundle

/developers/openapi/admin.openapi.json post /api/v1/booking-bundles



# Delete booking-bundle
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-bundles/delete-booking-bundle

/developers/openapi/admin.openapi.json delete /api/v1/booking-bundles/{booking_bundle_id}



# List booking-bundles
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-bundles/list-booking-bundles

/developers/openapi/admin.openapi.json get /api/v1/booking-bundles



# Update booking-bundle
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-bundles/update-booking-bundle

/developers/openapi/admin.openapi.json patch /api/v1/booking-bundles/{booking_bundle_id}



# Cancel booking pass
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-passes/cancel-booking-pass

/developers/openapi/admin.openapi.json get /api/v1/booking-passes/{booking_pass_id}/cancel



# Create booking pass
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-passes/create-booking-pass

/developers/openapi/admin.openapi.json post /api/v1/booking-passes



# Delete booking pass
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-passes/delete-booking-pass

/developers/openapi/admin.openapi.json delete /api/v1/booking-passes/{booking_pass_id}



# Generate a file from a document template for a booking pass
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-passes/generate-a-file-from-a-document-template-for-a-booking-pass

/developers/openapi/admin.openapi.json get /api/v1/booking-passes/{booking_pass_id}/generate-file/{template}



# Get booking pass
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-passes/get-booking-pass

/developers/openapi/admin.openapi.json get /api/v1/booking-passes/{booking_pass_id}



# List booking-passes
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-passes/list-booking-passes

/developers/openapi/admin.openapi.json get /api/v1/booking-passes



# Resend booking pass confirmation email
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-passes/resend-booking-pass-confirmation-email

/developers/openapi/admin.openapi.json get /api/v1/booking-passes/{booking_pass_id}/resend-mail



# Update booking pass
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-passes/update-booking-pass

/developers/openapi/admin.openapi.json patch /api/v1/booking-passes/{booking_pass_id}



# Delete booking-quota-grant
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-quota-grants/delete-booking-quota-grant

/developers/openapi/admin.openapi.json delete /api/v1/booking-quota-grants/{booking_quota_grant_id}



# Update booking-quota-grant
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-quota-grants/update-booking-quota-grant

/developers/openapi/admin.openapi.json patch /api/v1/booking-quota-grants/{booking_quota_grant_id}



# Create booking-rule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-rules/create-booking-rule

/developers/openapi/admin.openapi.json post /api/v1/booking-rules



# Delete booking-rule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-rules/delete-booking-rule

/developers/openapi/admin.openapi.json delete /api/v1/booking-rules/{booking_rule_id}



# Get booking-rule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-rules/get-booking-rule

/developers/openapi/admin.openapi.json get /api/v1/booking-rules/{booking_rule_id}



# List booking-rules
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-rules/list-booking-rules

/developers/openapi/admin.openapi.json get /api/v1/booking-rules



# Update booking-rule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/booking-rules/update-booking-rule

/developers/openapi/admin.openapi.json patch /api/v1/booking-rules/{booking_rule_id}



# Get draft messages for a broadcast campaign
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcast-campaigns/get-draft-messages-for-a-broadcast-campaign

/developers/openapi/admin.openapi.json get /api/v1/broadcast-campaigns/{broadcast_campaign_id}/draft-messages



# Create broadcast-campaign
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/create-broadcast-campaign

/developers/openapi/admin.openapi.json post /api/v1/broadcast-campaigns



# Create broadcast-template
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/create-broadcast-template

/developers/openapi/admin.openapi.json post /api/v1/broadcast-templates



# Delete broadcast-campaign
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/delete-broadcast-campaign

/developers/openapi/admin.openapi.json delete /api/v1/broadcast-campaigns/{broadcast_campaign_id}



# Delete broadcast-template
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/delete-broadcast-template

/developers/openapi/admin.openapi.json delete /api/v1/broadcast-templates/{broadcast_template_id}



# Get broadcast-campaign
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/get-broadcast-campaign

/developers/openapi/admin.openapi.json get /api/v1/broadcast-campaigns/{broadcast_campaign_id}



# Get broadcast-template
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/get-broadcast-template

/developers/openapi/admin.openapi.json get /api/v1/broadcast-templates/{broadcast_template_id}



# List broadcast-campaigns
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/list-broadcast-campaigns

/developers/openapi/admin.openapi.json get /api/v1/broadcast-campaigns



# List broadcast-templates
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/list-broadcast-templates

/developers/openapi/admin.openapi.json get /api/v1/broadcast-templates



# Start sending campaign
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/start-sending-campaign

/developers/openapi/admin.openapi.json get /api/v1/broadcast-campaigns/{broadcast_campaign_id}/start



# Stop campaign
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/stop-campaign

/developers/openapi/admin.openapi.json get /api/v1/broadcast-campaigns/{broadcast_campaign_id}/stop



# Update broadcast-campaign
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/update-broadcast-campaign

/developers/openapi/admin.openapi.json patch /api/v1/broadcast-campaigns/{broadcast_campaign_id}



# Update broadcast-template
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/broadcasts/update-broadcast-template

/developers/openapi/admin.openapi.json patch /api/v1/broadcast-templates/{broadcast_template_id}



# Delete a customer balance
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customer-balances/delete-a-customer-balance

/developers/openapi/admin.openapi.json delete /api/v1/customer-balances/{customer_balance_uuid}
Delete a customer balance. Admin-only operation.

Only balances in `open` status with no attached invoices should be deleted.




# Get a customer balance
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customer-balances/get-a-customer-balance

/developers/openapi/admin.openapi.json get /api/v1/customer-balances/{customer_balance_uuid}
Get a single customer balance by UUID.



# List customer balances
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customer-balances/list-customer-balances

/developers/openapi/admin.openapi.json get /api/v1/customer-balances
List customer balances in the current organization scope.

Balances consolidate draft invoices for a billing period. The `balanceable` is either a Customer or a Business (when the organization groups billing by business).




# Update a customer balance
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/customer-balances/update-a-customer-balance

/developers/openapi/admin.openapi.json patch /api/v1/customer-balances/{customer_balance_uuid}
Update mutable customer-balance fields.

Typical usage is status management. Allowed status transitions:
- `open` → `void` (cancel the balance)
- `issued` → `paid` (mark as paid after manual payment)
- `issued` → `void` (cancel after issuance)




# Create a display panel
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/display-panels/create-a-display-panel

/developers/openapi/admin.openapi.json post /api/v1/display-panels



# Delete a display panel
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/display-panels/delete-a-display-panel

/developers/openapi/admin.openapi.json delete /api/v1/display-panels/{display_panel_id}



# Get a display panel
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/display-panels/get-a-display-panel

/developers/openapi/admin.openapi.json get /api/v1/display-panels/{display_panel_id}
Retrieve a single display panel configuration.



# Get a list of display panels
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/display-panels/get-a-list-of-display-panels

/developers/openapi/admin.openapi.json get /api/v1/display-panels
List all display panels configured for the organization.



# Update a display panel
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/display-panels/update-a-display-panel

/developers/openapi/admin.openapi.json patch /api/v1/display-panels/{display_panel_id}



# Get a list of displays
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/displays/get-a-list-of-displays

/developers/openapi/admin.openapi.json get /api/v1/displays



# Pair a display
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/displays/pair-a-display

/developers/openapi/admin.openapi.json post /api/v1/displays/{display_id}/pair



# Unpair a display
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/displays/unpair-a-display

/developers/openapi/admin.openapi.json get /api/v1/displays/{display_id}/unpair



# Export booking passes
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/export-booking-passes

/developers/openapi/admin.openapi.json get /api/v1/booking-passes/export



# Export invoices as CSV/Excel
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/export-invoices-as-csv-excel

/developers/openapi/admin.openapi.json get /api/v1/invoices/export
Exports invoices matching the given filters. Accepts the same filter and sort parameters as the invoice list endpoint.



# Trigger an export of a set of bookings
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/trigger-an-export-of-a-set-of-bookings

/developers/openapi/admin.openapi.json get /api/v1/bookings/export



# Trigger an export of a set of customers
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/trigger-an-export-of-a-set-of-customers

/developers/openapi/admin.openapi.json get /api/v1/customers/export



# Trigger an export of a set of orders
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/trigger-an-export-of-a-set-of-orders

/developers/openapi/admin.openapi.json get /api/v1/orders/export



# Trigger an export of a set of vouchers
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/trigger-an-export-of-a-set-of-vouchers

/developers/openapi/admin.openapi.json get /api/v1/vouchers/export



# Cancel an invoice
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/cancel-an-invoice

/developers/openapi/admin.openapi.json get /api/v1/invoices/{invoice_id}/cancel
Creates a cancellation invoice and marks the original as cancelled.



# Change the recipient of an invoice
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/change-the-recipient-of-an-invoice

/developers/openapi/admin.openapi.json post /api/v1/invoices/{invoice_id}/change-recipient
If the invoice is locked, creates a new invoice with the updated recipient and cancels the original.



# Create an invoice
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/create-an-invoice

/developers/openapi/admin.openapi.json post /api/v1/invoices
Create a draft invoice manually.

Pass `?add_to_balance=1` to automatically attach the new invoice to the customer's open balance for the current billing period. If no open balance exists, one is created.




# Delete an invoice
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/delete-an-invoice

/developers/openapi/admin.openapi.json delete /api/v1/invoices/{invoice_id}



# Get a list of invoices
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/get-a-list-of-invoices

/developers/openapi/admin.openapi.json get /api/v1/invoices



# Get an invoice
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/get-an-invoice

/developers/openapi/admin.openapi.json get /api/v1/invoices/{invoice_id}



# Mark an invoice as paid
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/mark-an-invoice-as-paid

/developers/openapi/admin.openapi.json get /api/v1/invoices/{invoice_id}/set-paid



# Move invoice to a balance
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/move-invoice-to-a-balance

/developers/openapi/admin.openapi.json post /api/v1/invoices/{invoice_id}/move-to-balance
Move an existing draft invoice to a customer balance. If the invoice is already on a balance, it is detached from the old one and attached to the new target.

The target `balanceable` can be a Customer or a Business. The system resolves or creates the appropriate open balance for the current billing period.

Rejects locked invoices and consolidated child invoices (HTTP 400).




# Send an invoice
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/send-an-invoice

/developers/openapi/admin.openapi.json get /api/v1/invoices/{invoice_id}/send



# Update an invoice
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/invoices/update-an-invoice

/developers/openapi/admin.openapi.json patch /api/v1/invoices/{invoice_id}



# Create an invoice item
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/items/create-an-invoice-item

/developers/openapi/admin.openapi.json post /api/v1/items



# Delete an invoice item
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/items/delete-an-invoice-item

/developers/openapi/admin.openapi.json delete /api/v1/items/{item_id}



# Update an invoice item
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/items/update-an-invoice-item

/developers/openapi/admin.openapi.json patch /api/v1/items/{item_id}



# Cancel an order
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/cancel-an-order

/developers/openapi/admin.openapi.json get /api/v1/orders/{order_id}/cancel



# Create an order
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/create-an-order

/developers/openapi/admin.openapi.json post /api/v1/orders



# Create or update an order from admin configuration
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/create-an-order-from-admin-configuration

/developers/openapi/admin.openapi.json post /api/v1/orders/from-config
Creates a complete order with bookings directly from the admin panel without going through the public checkout flow, or **updates** an existing order when the body carries `order_id` (the complete desired state — see GET /api/v1/orders/{order_id}/config).

Supports mixed product orders — besides `bookings` the config accepts standalone `add_ons` (`[{add_on_id, quantity}]`) and `booking_passes` purchased from bundles (`[{booking_bundle_id, quantity}]`), billed centrally on the order invoice. `bookings` may be empty or omitted when other products are present.

To change one confirmed booking in place instead of rewriting the order, use POST /api/v1/bookings/{booking_id}/edit/*.



# Delete an order
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/delete-an-order

/developers/openapi/admin.openapi.json delete /api/v1/orders/{order_id}



# Get a list of orders
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/get-a-list-of-orders

/developers/openapi/admin.openapi.json get /api/v1/orders



# Get an order
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/get-an-order

/developers/openapi/admin.openapi.json get /api/v1/orders/{order_id}



# Get bookings linked to an order
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/get-bookings-linked-to-an-order

/developers/openapi/admin.openapi.json get /api/v1/orders/{order_id}/bookings



# Pre-calculate order pricing and resolve booking quota grants
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/pre-calculate-order-pricing-and-resolve-booking-quota-grants

/developers/openapi/admin.openapi.json post /api/v1/orders/calculate
Calculates prices, taxes, and totals for an order configuration without creating it.
Also resolves all available booking quota grants per booking based on the customer or booking code,
including which grant is preselected and the projected usage for each applicable grant.

This endpoint replaces the need to call `/orders/from-config/booking-quota-grants` separately.



# Re-send order notification to the customer
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/re-send-order-notification-to-the-customer

/developers/openapi/admin.openapi.json get /api/v1/orders/{order_id}/send-notification



# Read an order as an editable admin config
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/read-an-order-as-an-editable-admin-config

/developers/openapi/admin.openapi.json get /api/v1/orders/{order_id}/config
Returns the same document `POST /api/v1/orders/from-config` accepts, with the order's own `order_id` at the top level and a persisted `booking_id` on every booking entry. Removed and cancelled bookings are omitted. Sub-bookings and sequence members are nested inside their parent entry.

`check_availability` and `notify_customer` come back as `false`, so posting an unchanged config straight back is a no-op. The body is the complete desired state — posting only the bookings you changed soft-deletes every booking you left out.

Shop customer checkout drafts (`status=draft` and `manually_created=false`) are rejected with `cannot_modify_reserved_booking`. Admin-created drafts are editable. See Admin Booking Creation (Editing an Existing Order) and Admin Booking Edit.



# Resend the order confirmation email
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/resend-the-order-confirmation-email

/developers/openapi/admin.openapi.json get /api/v1/orders/{order_id}/resend-mail



# Update an order
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/orders/update-an-order

/developers/openapi/admin.openapi.json patch /api/v1/orders/{order_id}



# Create a new payment setup
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/payment-setups/create-a-new-payment-setup

/developers/openapi/admin.openapi.json post /api/v1/payment-setups



# Delete a payment setup
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/payment-setups/delete-a-payment-setup

/developers/openapi/admin.openapi.json delete /api/v1/payment-setups/{payment_setup_id}



# Get a list of payment setups
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/payment-setups/get-a-list-of-payment-setups

/developers/openapi/admin.openapi.json get /api/v1/payment-setups



# Get a payment setup
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/payment-setups/get-a-payment-setup

/developers/openapi/admin.openapi.json get /api/v1/payment-setups/{payment_setup_id}



# Update a payment setup
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/payment-setups/update-a-payment-setup

/developers/openapi/admin.openapi.json patch /api/v1/payment-setups/{payment_setup_id}



# Create payment
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/payments/create-payment

/developers/openapi/admin.openapi.json post /payments



# Get payment
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/payments/get-payment

/developers/openapi/admin.openapi.json get /payments/{payment_id}



# List queue-tickets
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/queues/list-queue-tickets

/developers/openapi/admin.openapi.json get /api/v1/queue-tickets



# Create a voucher
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/vouchers/create-a-voucher

/developers/openapi/admin.openapi.json post /api/v1/vouchers



# Delete a voucher
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/vouchers/delete-a-voucher

/developers/openapi/admin.openapi.json delete /api/v1/vouchers/{voucher_id}



# Get a list of vouchers
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/vouchers/get-a-list-of-vouchers

/developers/openapi/admin.openapi.json get /api/v1/vouchers



# Get a voucher
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/vouchers/get-a-voucher

/developers/openapi/admin.openapi.json get /api/v1/vouchers/{voucher_id}



# Get all orders where a voucher was used
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/vouchers/get-all-orders-where-a-voucher-was-used

/developers/openapi/admin.openapi.json get /api/v1/vouchers/{voucher_id}/orders



# Remove an order from a voucher
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/vouchers/remove-an-order-from-a-voucher

/developers/openapi/admin.openapi.json delete /api/v1/vouchers/{voucher_id}/orders



# Update a voucher
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/vouchers/update-a-voucher

/developers/openapi/admin.openapi.json patch /api/v1/vouchers/{voucher_id}



# Create webhook-subscription
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/webhooks/create-webhook-subscription

/developers/openapi/admin.openapi.json post /api/v1/webhook-subscriptions



# Delete webhook-subscription
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/webhooks/delete-webhook-subscription

/developers/openapi/admin.openapi.json delete /api/v1/webhook-subscriptions/{webhook_subscription_id}



# Get webhook-subscription
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/webhooks/get-webhook-subscription

/developers/openapi/admin.openapi.json get /api/v1/webhook-subscriptions/{webhook_subscription_id}



# List webhook-subscriptions
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/webhooks/list-webhook-subscriptions

/developers/openapi/admin.openapi.json get /api/v1/webhook-subscriptions



# Update webhook-subscription
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/webhooks/update-webhook-subscription

/developers/openapi/admin.openapi.json patch /api/v1/webhook-subscriptions/{webhook_subscription_id}



# add a cancellation policy
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/cancellation-policies/add-a-cancellation-policy

/developers/openapi/admin.openapi.json post /api/v1/cancellation-policies



# Delete a cancellation policy
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/cancellation-policies/delete-a-cancellation-policy

/developers/openapi/admin.openapi.json delete /api/v1/cancellation-policies/{cancellation_policy_id}



# Get a cancellation policy
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/cancellation-policies/get-a-cancellation-policy

/developers/openapi/admin.openapi.json get /api/v1/cancellation-policies/{cancellation_policy_id}



# Update a cancellation policy
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/cancellation-policies/update-a-cancellation-policy

/developers/openapi/admin.openapi.json patch /api/v1/cancellation-policies/{cancellation_policy_id}



# Create document-template
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/document-templates/create-document-template

/developers/openapi/admin.openapi.json post /api/v1/document-templates



# Delete document-template
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/document-templates/delete-document-template

/developers/openapi/admin.openapi.json delete /api/v1/document-templates/{document_template_id}



# Get document-template
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/document-templates/get-document-template

/developers/openapi/admin.openapi.json get /api/v1/document-templates/{document_template_id}



# List document-templates
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/document-templates/list-document-templates

/developers/openapi/admin.openapi.json get /api/v1/document-templates



# Update document-template
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/document-templates/update-document-template

/developers/openapi/admin.openapi.json patch /api/v1/document-templates/{document_template_id}



# Cancel export
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/cancel-export

/developers/openapi/admin.openapi.json get /api/v1/exports/{export_id}/cancel



# Create export-destination
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/create-export-destination

/developers/openapi/admin.openapi.json post /api/v1/export-destinations



# Create export-schedule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/create-export-schedule

/developers/openapi/admin.openapi.json post /api/v1/export-schedules



# Delete export
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/delete-export

/developers/openapi/admin.openapi.json delete /api/v1/exports/{export_id}



# Delete export-destination
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/delete-export-destination

/developers/openapi/admin.openapi.json delete /api/v1/export-destinations/{export_destination_id}



# Delete export-schedule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/delete-export-schedule

/developers/openapi/admin.openapi.json delete /api/v1/export-schedules/{export_schedule_id}



# Download export file
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/download-export-file

/developers/openapi/admin.openapi.json get /api/v1/exports/{export_id}/download



# Duplicate schedule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/duplicate-schedule

/developers/openapi/admin.openapi.json get /api/v1/export-schedules/{export_schedule_id}/duplicate



# Get export
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/get-export

/developers/openapi/admin.openapi.json get /api/v1/exports/{export_id}



# Get export-destination
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/get-export-destination

/developers/openapi/admin.openapi.json get /api/v1/export-destinations/{export_destination_id}



# Get export-schedule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/get-export-schedule

/developers/openapi/admin.openapi.json get /api/v1/export-schedules/{export_schedule_id}



# List export-destinations
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/list-export-destinations

/developers/openapi/admin.openapi.json get /api/v1/export-destinations



# List export-schedules
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/list-export-schedules

/developers/openapi/admin.openapi.json get /api/v1/export-schedules



# List exports
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/list-exports

/developers/openapi/admin.openapi.json get /api/v1/exports



# Retry export
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/retry-export

/developers/openapi/admin.openapi.json get /api/v1/exports/{export_id}/retry



# Run schedule now
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/run-schedule-now

/developers/openapi/admin.openapi.json get /api/v1/export-schedules/{export_schedule_id}/run



# Test destination connection
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/test-destination-connection

/developers/openapi/admin.openapi.json get /api/v1/export-destinations/{export_destination_id}/test-connection



# Update export-destination
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/update-export-destination

/developers/openapi/admin.openapi.json patch /api/v1/export-destinations/{export_destination_id}



# Update export-schedule
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/exports/update-export-schedule

/developers/openapi/admin.openapi.json patch /api/v1/export-schedules/{export_schedule_id}



# Delete file
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/files/delete-file

/developers/openapi/admin.openapi.json delete /api/v1/files/{file_id}



# List files
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/files/list-files

/developers/openapi/admin.openapi.json get /api/v1/files



# Update file
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/files/update-file

/developers/openapi/admin.openapi.json patch /api/v1/files/{file_id}



# Delete an image
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/images/delete-an-image

/developers/openapi/admin.openapi.json delete /api/v1/images/{image_id}



# Update an image
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/images/update-an-image

/developers/openapi/admin.openapi.json patch /api/v1/images/{image_id}



# Upload an image
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/images/upload-an-image

/developers/openapi/admin.openapi.json post /api/v1/images



# Create legal-document-link
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/legal-document-links/create-legal-document-link

/developers/openapi/admin.openapi.json post /api/v1/legal-document-links



# Delete legal-document-link
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/legal-document-links/delete-legal-document-link

/developers/openapi/admin.openapi.json delete /api/v1/legal-document-links/{legal_document_link_id}



# Update legal-document-link
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/legal-document-links/update-legal-document-link

/developers/openapi/admin.openapi.json patch /api/v1/legal-document-links/{legal_document_link_id}



# Create a legal document
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/legal-documents/create-a-legal-document

/developers/openapi/admin.openapi.json post /api/v1/legal-documents



# Delete a legal document
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/legal-documents/delete-a-legal-document

/developers/openapi/admin.openapi.json delete /api/v1/legal-documents/{legal_document_id}



# Update a legal document
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/legal-documents/update-a-legal-document

/developers/openapi/admin.openapi.json patch /api/v1/legal-documents/{legal_document_id}



# Create a model identifier
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/model-identifiers/create-a-model-identifier

/developers/openapi/admin.openapi.json post /api/v1/model-identifiers



# Delete a model identifier
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/model-identifiers/delete-a-model-identifier

/developers/openapi/admin.openapi.json delete /api/v1/model-identifiers/{model_identifier_id}



# Find a model by its identifier code
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/model-identifiers/find-a-model-by-its-identifier-code

/developers/openapi/admin.openapi.json get /api/v1/model-identifiers/find
Resolves a model identifier (e.g. QR code, barcode) to the associated booking or customer.



# Get a model identifier
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/model-identifiers/get-a-model-identifier

/developers/openapi/admin.openapi.json get /api/v1/model-identifiers/{model_identifier_id}



# update a model identifier
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/model-identifiers/update-a-model-identifier

/developers/openapi/admin.openapi.json patch /api/v1/model-identifiers/{model_identifier_id}



# Create a new organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/create-a-new-organization

/developers/openapi/admin.openapi.json post /api/v1/organizations



# Create a user invite for an organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/create-a-user-invite-for-an-organization

/developers/openapi/admin.openapi.json post /api/v1/organizations/{organization_id}/user-invites



# Delete a user linked to an organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/delete-a-user-linked-to-an-organization

/developers/openapi/admin.openapi.json delete /api/v1/organizations/{organization_id}/organization-users



# Get all categories linked to an organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/get-all-categories-linked-to-an-organization

/developers/openapi/admin.openapi.json get /api/v1/organizations/{organization_id}/categories



# Get all custom fields for the organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/get-all-custom-fields-for-the-organization

/developers/openapi/admin.openapi.json get /api/v1/organizations/{organization_id}/service-custom-fields
Returns all custom fields associated with any service forms in the organization.



# Get all custom fields linked to an organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/get-all-custom-fields-linked-to-an-organization

/developers/openapi/admin.openapi.json get /api/v1/organizations/{organization_id}/custom-fields



# Get all custom forms linked to an organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/get-all-custom-forms-linked-to-an-organization

/developers/openapi/admin.openapi.json get /api/v1/organizations/{organization_id}/custom-forms



# Get all subscription invoices for an organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/get-all-subscription-invoices-for-an-organization

/developers/openapi/admin.openapi.json get /api/v1/organizations/{organization_id}/subscription-invoices



# Get all user invites for an organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/get-all-user-invites-for-an-organization

/developers/openapi/admin.openapi.json get /api/v1/organizations/{organization_id}/user-invites



# Get all users linked to an organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/get-all-users-linked-to-an-organization

/developers/openapi/admin.openapi.json get /api/v1/organizations/{organization_id}/organization-users



# Get an organization's subscription plan
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/get-an-organization-s-subscription-plan

/developers/openapi/admin.openapi.json get /api/v1/organizations/{organization_id}/subscriptions



# Get the organization the user is currently logged into
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/get-the-organization-the-user-is-currently-logged-into

/developers/openapi/admin.openapi.json get /api/v1/organization



# Update an organization
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/organizations/update-an-organization

/developers/openapi/admin.openapi.json patch /api/v1/organizations/{organization_id}



# Create a new property
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/properties/create-a-new-property

/developers/openapi/admin.openapi.json post /api/v1/properties



# Delete a property
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/properties/delete-a-property

/developers/openapi/admin.openapi.json delete /api/v1/properties/{property_id}



# Get a list of properties
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/properties/get-a-list-of-properties

/developers/openapi/admin.openapi.json get /api/v1/properties



# Get a property
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/properties/get-a-property

/developers/openapi/admin.openapi.json get /api/v1/properties/{property_id}



# Update a property
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/properties/update-a-property

/developers/openapi/admin.openapi.json patch /api/v1/properties/{property_id}



# Create a tag
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tags/create-a-tag

/developers/openapi/admin.openapi.json post /api/v1/tags
Requires the `tags` ability. Names must be unique within the organization.



# Delete a tag
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tags/delete-a-tag

/developers/openapi/admin.openapi.json delete /api/v1/tags/{tag_id}
Requires the `tags` ability. Deleting a tag detaches it from every record.



# Get a list of tags
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tags/get-a-list-of-tags

/developers/openapi/admin.openapi.json get /api/v1/tags
Lists the tags of the active organization, ordered by `order_index` and name. Every organization member can read tags.

Tags are attached to a record through its JSON:API `tags` relationship, for example `PATCH /api/v1/bookings/{booking_id}/relationships/tags` (replace), `POST …/relationships/tags` (add) and `DELETE …/relationships/tags` (remove) with a `data` array of `{ "type": "tags", "id": "…" }` identifiers. This is available on bookings, orders, customers, resources and services.



# Get a tag
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tags/get-a-tag

/developers/openapi/admin.openapi.json get /api/v1/tags/{tag_id}



# Update a tag
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/tags/update-a-tag

/developers/openapi/admin.openapi.json patch /api/v1/tags/{tag_id}
Requires the `tags` ability.



# Accept a user invite
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/user-invites/accept-a-user-invite

/developers/openapi/admin.openapi.json get /api/v1/user-invites/{user_invite_id}/accept-invite



# Create a new user invite
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/user-invites/create-a-new-user-invite

/developers/openapi/admin.openapi.json post /api/v1/user-invites



# Delete a user invite
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/user-invites/delete-a-user-invite

/developers/openapi/admin.openapi.json delete /api/v1/user-invites/{user_invite_id}



# Update a user invite
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/user-invites/update-a-user-invite

/developers/openapi/admin.openapi.json patch /api/v1/user-invites/{user_invite_id}



# Get a user
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/users/get-a-user

/developers/openapi/admin.openapi.json get /api/v1/users/{user_id}



# Get all organizations a user is linked to
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/users/get-all-organizations-a-user-is-linked-to

/developers/openapi/admin.openapi.json get /api/v1/users/{user_id}/organizations
List all organizations where the user has team membership.



# Get the user currently logged in
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/users/get-the-user-currently-logged-in

/developers/openapi/admin.openapi.json get /api/v1/user



# Get whether a user is the owner of the organizations he is linked to
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/users/get-whether-a-user-is-the-owner-of-the-organizations-he-is-linked-to

/developers/openapi/admin.openapi.json get /api/v1/users/{user_id}/organization-users
Returns the user's membership records across organizations, including ownership status.



# Update a user
Source: https://docs.anny.co/developers/api-reference/admin/endpoints/users/update-a-user

/developers/openapi/admin.openapi.json patch /api/v1/users/{user_id}



# AccessControlGrant
Source: https://docs.anny.co/developers/models/access-control-grants





# AccountPass
Source: https://docs.anny.co/developers/models/account-passes





# AccountSkill
Source: https://docs.anny.co/developers/models/account-skills





# AddOnGroup
Source: https://docs.anny.co/developers/models/add-on-groups





# Add-On
Source: https://docs.anny.co/developers/models/add-ons





# Address
Source: https://docs.anny.co/developers/models/addresses





# BookingAddOn
Source: https://docs.anny.co/developers/models/booking-add-ons





# BookingBundleGroup
Source: https://docs.anny.co/developers/models/booking-bundle-groups

Logical grouping of booking bundles, analogous to service groups and add-on groups.

A logical grouping of [booking bundles](/developers/models/booking-bundles) (packages / codes). Same idea as [service groups](/developers/models/service-groups) and [add-on groups](/developers/models/add-on-groups): optional, ordered, i18n name and description. Deleting a group nulls `group_id` on its bundles.

JSON:API type: `booking-bundle-groups`.

Full request/response contract for native apps: [Booking Bundle Groups](/developers/guides/booking-bundle-groups).

### Attributes

<ResponseField name="name" type="string">
  Resolved group name for the request locale (`Accept-Language`).
</ResponseField>

<ResponseField name="description" type="string">
  Resolved group description for the request locale.
</ResponseField>

<ResponseField name="order_index" type="number">
  Display order among groups in admin lists and the public catalog.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO-8601 creation timestamp.
</ResponseField>

<ResponseField name="local_name_i18n" type="object">
  Full name translation map. Admin only.
</ResponseField>

<ResponseField name="description_i18n" type="object">
  Full description translation map. Admin only.
</ResponseField>

### Relationships

<ResponseField name="booking_bundles" type="booking-bundles[]">
  Bundles assigned to this group. Include with `include=booking_bundles`.
</ResponseField>

Bundles point back with a nullable `group` relationship (`include=group` on `booking-bundles` and `available-booking-bundles`).


# BookingBundle
Source: https://docs.anny.co/developers/models/booking-bundles





# BookingParticipant
Source: https://docs.anny.co/developers/models/booking-participants





# BookingPass
Source: https://docs.anny.co/developers/models/booking-passes





# BookingQuotaGrant
Source: https://docs.anny.co/developers/models/booking-quota-grants





# BookingQuota
Source: https://docs.anny.co/developers/models/booking-quotas





# BookingRule
Source: https://docs.anny.co/developers/models/booking-rules





# BookingSeries
Source: https://docs.anny.co/developers/models/booking-series





# Booking
Source: https://docs.anny.co/developers/models/bookings





# BroadcastAudience
Source: https://docs.anny.co/developers/models/broadcast-audiences





# BroadcastCampaign
Source: https://docs.anny.co/developers/models/broadcast-campaigns





# BroadcastMessage
Source: https://docs.anny.co/developers/models/broadcast-messages





# BroadcastTemplate
Source: https://docs.anny.co/developers/models/broadcast-templates





# Calendar Resource
Source: https://docs.anny.co/developers/models/calendar-resources





# Calendar
Source: https://docs.anny.co/developers/models/calendars





# CancellationPolicy
Source: https://docs.anny.co/developers/models/cancellation-policies





# Ability
Source: https://docs.anny.co/developers/models/abilities





# AccountConnection
Source: https://docs.anny.co/developers/models/account-connections





# Activity
Source: https://docs.anny.co/developers/models/activities





# AuthUser
Source: https://docs.anny.co/developers/models/auth-user





# BankAccount
Source: https://docs.anny.co/developers/models/bank-accounts





# BusinessAccountMember
Source: https://docs.anny.co/developers/models/business-account-members





# BusinessAccount
Source: https://docs.anny.co/developers/models/business-accounts





# Business
Source: https://docs.anny.co/developers/models/businesses





# Checkout Field
Source: https://docs.anny.co/developers/models/checkout-fields





# Community
Source: https://docs.anny.co/developers/models/communities





# CommunityAccount
Source: https://docs.anny.co/developers/models/community-accounts





# CommunityInvite
Source: https://docs.anny.co/developers/models/community-invites





# ContextRestriction
Source: https://docs.anny.co/developers/models/context-restrictions





# CustomField
Source: https://docs.anny.co/developers/models/custom-fields





# CustomForm
Source: https://docs.anny.co/developers/models/custom-forms





# CustomerAccount
Source: https://docs.anny.co/developers/models/customer-accounts





# Customer Balance
Source: https://docs.anny.co/developers/models/customer-balances





# Customer
Source: https://docs.anny.co/developers/models/customers





# DisplayPanel
Source: https://docs.anny.co/developers/models/display-panels





# DisplayType
Source: https://docs.anny.co/developers/models/display-types





# Display
Source: https://docs.anny.co/developers/models/displays





# DocumentAcceptance
Source: https://docs.anny.co/developers/models/document-acceptances





# DocumentTemplate
Source: https://docs.anny.co/developers/models/document-templates





# ExportDestination
Source: https://docs.anny.co/developers/models/export-destinations





# ExportSchedule
Source: https://docs.anny.co/developers/models/export-schedules





# Export
Source: https://docs.anny.co/developers/models/exports





# ExternalCalendar
Source: https://docs.anny.co/developers/models/external-calendars





# ExternalLink
Source: https://docs.anny.co/developers/models/external-links





# Favorite
Source: https://docs.anny.co/developers/models/favorites





# FcmToken
Source: https://docs.anny.co/developers/models/fcm-tokens





# File
Source: https://docs.anny.co/developers/models/files





# Image
Source: https://docs.anny.co/developers/models/images





# Industry
Source: https://docs.anny.co/developers/models/industries





# Integration
Source: https://docs.anny.co/developers/models/integrations





# Interval Availability
Source: https://docs.anny.co/developers/models/interval-availability





# Invoice
Source: https://docs.anny.co/developers/models/invoices





# Item
Source: https://docs.anny.co/developers/models/items





# has-many-relationship
Source: https://docs.anny.co/developers/models/json-api-has-many-relationship





# has-one-relationship
Source: https://docs.anny.co/developers/models/json-api-has-one-relationship





# identifier
Source: https://docs.anny.co/developers/models/json-api-identifier





# ResourceLinks
Source: https://docs.anny.co/developers/models/json-api-links





# relationship
Source: https://docs.anny.co/developers/models/json-api-relationship





# LegalDocumentLink
Source: https://docs.anny.co/developers/models/legal-document-links





# LegalDocument
Source: https://docs.anny.co/developers/models/legal-documents





# ModelIdentifier
Source: https://docs.anny.co/developers/models/model-identifiers





# Notification
Source: https://docs.anny.co/developers/models/notifications





# Order
Source: https://docs.anny.co/developers/models/orders





# Organization-User Settings
Source: https://docs.anny.co/developers/models/organization-user-settings





# OrganizationUser
Source: https://docs.anny.co/developers/models/organization-users





# Organization
Source: https://docs.anny.co/developers/models/organizations





# Pairing Code
Source: https://docs.anny.co/developers/models/pairing-codes





# PaymentAccount
Source: https://docs.anny.co/developers/models/payment-accounts





# PaymentMethod
Source: https://docs.anny.co/developers/models/payment-methods





# PaymentRefund
Source: https://docs.anny.co/developers/models/payment-refunds





# PaymentSetup
Source: https://docs.anny.co/developers/models/payment-setups





# Payment
Source: https://docs.anny.co/developers/models/payments





# PlanSubscription
Source: https://docs.anny.co/developers/models/plan-subscriptions





# Plan
Source: https://docs.anny.co/developers/models/plans





# PriceModifier
Source: https://docs.anny.co/developers/models/price-modifiers





# Property
Source: https://docs.anny.co/developers/models/properties





# QueueTicket
Source: https://docs.anny.co/developers/models/queue-tickets





# ResourceCategory
Source: https://docs.anny.co/developers/models/resource-categories





# ResourceGroup
Source: https://docs.anny.co/developers/models/resource-groups





# ResourceMap
Source: https://docs.anny.co/developers/models/resource-maps





# ResourceProperty
Source: https://docs.anny.co/developers/models/resource-properties





# ResourceScheduleGroup
Source: https://docs.anny.co/developers/models/resource-schedule-groups





# Resource
Source: https://docs.anny.co/developers/models/resources





# Role
Source: https://docs.anny.co/developers/models/roles





# Scan
Source: https://docs.anny.co/developers/models/scans



Create check-in and check-out scans for bookings (staff scanner, kiosk, or display). For the booking action endpoints, see [Admin Booking Lifecycle](/developers/guides/admin/booking-lifecycle).

***

## Create a scan

```http theme={null}
POST /api/v1/scans?o={org_id}&code={booking_code}&scannable_type=bookings
Authorization: Bearer {token}
X-Supports-Dynamic-Form: true

{
  "data": {
    "type": "scans",
    "attributes": {
      "scan_type": "check_in",
      "device_identifier": "front-desk-scanner",
      "latitude": null,
      "longitude": null
    }
  }
}
```

### Query parameters

| Parameter | Required | Description |
| - | - | - |
| `o` | Yes | Organization ID |
| `code` | Yes | Booking ticket / QR code |
| `scannable_type` | No | Defaults to `bookings` |
| `allowed_resources` | No | Restrict which base resources may be scanned |

### Attributes

| Attribute | Required | Description |
| - | - | - |
| `scan_type` | Yes | `check_in` or `check_out` |
| `device_identifier` | No | Optional device label |
| `latitude` / `longitude` | No | Geo coordinates when required by the resource |
| `meta.form_data` | No | Delayed check-in details. Also accepted as top-level `form_data` (same shape as the booking check-in action). |

On success the response is a `scans` resource. A successful check-in also updates the booking's `check_in_date` via the scan's presence-date sync.

***

## Statuses

| Status | Meaning |
| - | - |
| `valid` | Scan succeeded; for check-in the booking is checked in |
| `requires_details` | Check-in details (legal documents / custom fields) are still missing |
| `scanned` | Already checked in (previous successful check-in exists) |
| `too_early` / `too_late` | Outside the configured check-in window |
| `unpaid` | Booking order is not fully paid |
| `invalid` | Booking status does not allow check-in |
| `resource_not_allowed` | Booking resource is outside `allowed_resources` |

***

## Delayed check-in form data

When a booking still needs check-in-timed legal documents or custom fields, send `X-Supports-Dynamic-Form: true`. Full header behaviour (booking action vs `POST /scans`) is in [X-Supports-Dynamic-Form](/developers/guides/admin/booking-lifecycle#x-supports-dynamic-form).

Without form payload:

* supported client → scan is created with `data.attributes.status: "requires_details"` and `data.attributes.meta.form_url`
* unsupported client → HTTP 400, `scans.check_in_requires_details_unsupported`

Fetch the form from `data.attributes.meta.form_url`, then create another scan with the collected values as **either** top-level `form_data` **or** `data.attributes.meta.form_data`:

```http theme={null}
POST /api/v1/scans?o={org_id}&code={booking_code}&scannable_type=bookings
X-Supports-Dynamic-Form: true

{
  "data": {
    "type": "scans",
    "attributes": {
      "scan_type": "check_in",
      "meta": {
        "form_data": {
          "documents": {
            "{document_uuid}": { "accepted": true, "send_copy": false }
          },
          "service_custom_fields": {
            "{field_uuid}": "value"
          }
        }
      }
    }
  }
}
```

The `form_data` object uses the same shape as `POST /api/v1/bookings/{id}/check-in`. Invalid values return HTTP 422. Submitted `form_data` is processed and not persisted on the scan record.

***

## Related guides

* [Admin Booking Lifecycle](/developers/guides/admin/booking-lifecycle) — booking check-in/out actions, Presence fields/endpoints, and [X-Supports-Dynamic-Form](/developers/guides/admin/booking-lifecycle#x-supports-dynamic-form)
* [Display Integration](/developers/guides/internal/display-integration) — room displays that check bookings in/out


# ScheduleGroup
Source: https://docs.anny.co/developers/models/schedule-groups





# Schedule
Source: https://docs.anny.co/developers/models/schedules





# ServiceAddOn
Source: https://docs.anny.co/developers/models/service-add-ons





# ServiceConfiguration
Source: https://docs.anny.co/developers/models/service-configurations





# ServiceGroup
Source: https://docs.anny.co/developers/models/service-groups





# ServiceSubResource
Source: https://docs.anny.co/developers/models/service-sub-resources





# Service
Source: https://docs.anny.co/developers/models/services





# Setting
Source: https://docs.anny.co/developers/models/settings





# Subscription Invoice
Source: https://docs.anny.co/developers/models/subscription-invoices





# Subscription
Source: https://docs.anny.co/developers/models/subscriptions





# SyncSource
Source: https://docs.anny.co/developers/models/sync-sources





# Table Column
Source: https://docs.anny.co/developers/models/table-column





# Tag
Source: https://docs.anny.co/developers/models/tags





# Tally Counter Record
Source: https://docs.anny.co/developers/models/tally-counter-records





# Tally Counter
Source: https://docs.anny.co/developers/models/tally-counters





# TerminalLocation
Source: https://docs.anny.co/developers/models/terminal-locations





# TerminalReader
Source: https://docs.anny.co/developers/models/terminal-readers





# Test Result
Source: https://docs.anny.co/developers/models/test-results





# Test
Source: https://docs.anny.co/developers/models/tests





# TimeslotResourceAllocation
Source: https://docs.anny.co/developers/models/timeslot-resource-allocations





# TimeslotSeries
Source: https://docs.anny.co/developers/models/timeslot-series





# Timeslot
Source: https://docs.anny.co/developers/models/timeslots





# UserInvite
Source: https://docs.anny.co/developers/models/user-invites





# User
Source: https://docs.anny.co/developers/models/users





# Validated Interval
Source: https://docs.anny.co/developers/models/validated-interval





# View
Source: https://docs.anny.co/developers/models/views





# Voucher
Source: https://docs.anny.co/developers/models/vouchers





# WaitlistSpot
Source: https://docs.anny.co/developers/models/waitlist-spots





# WebhookSubscription
Source: https://docs.anny.co/developers/models/webhook-subscriptions





# 2024
Source: https://docs.anny.co/changelog/2024

Follow the updates and improvements made to the anny platform in 2024.

<Update label="Dec 31, 2024">
  ## New role and ability system

  The role and ability management is one of the most used features of anny. It allows you to granularly set the abilities that roles or individual admins have in the admin area. For example, you can set which admin can see, create, edit or delete a resource or service.

  Over the last few years, anny has gained many new functions and the requirements for the ability and role management have increased as a result. We have therefore fundamentally revised the role and ability system for admins.

  We have revised the user interface to manage the abilities of roles and admins. You can now see at a glance which rights have been assigned and which restrictions apply to them.<br />You can also assign abilities for services, maps, subscriptions, and communities.

  Furthermore, you can now also define individual abilities directly when inviting an admin. This means you don't have to create your own role before you can invite the admin.<br />You will also find the option to directly invite an admin for a resource on the resource overview and details page. This allows you to send even faster invitations for admins with restricted authorizations.

   You can find a detailed article on ability and role management in our Help Center: [https://docs.anny.co/en/articles/255697-user-and-role-administration](https://docs.anny.co/en/articles/255697-user-and-role-administration)
</Update>

<Update label="Dec 18, 2024">
  ## ✨ Community access for smart locks and new interface

  Until now, smart lock accesses could only be created automatically for individual bookings.  Now, however, you can also easily assign specific smart lock accesses to your communities. This means that you can link access to certain areas directly to membership of a community. This gives your members convenient and secure access that is managed automatically.<br />For example, a new community member can automatically gain access to the coworking space as soon as they register, and this access is revoked as soon as their membership ends.<br /> <br />In addition, there are some visual customizations that give you even more control over your smart locks: **Optimized interface:** A new, simplified design makes managing your smart lock integrations even more intuitive. **Smart locks in booking details:** On the booking details page in the admin area, you can now see exactly when, for how long and to which lock your user has access through the booking. In the help center, you will find everything that is new and the instructions for integrating the systems into anny: [https://docs.anny.co/en/articles/30481-smart-lock-integration](https://docs.anny.co/en/articles/30481-smart-lock-integration?utm_source=newsletter\&utm_medium=email\&utm_campaign=customers-eu-en-news-from-anny-new-smartlock-integrations-and-community-access)
</Update>

<Update label="Dec 18, 2024">
  ## iLOQ and Exivo

  Smart locks open up limitless possibilities for you to network locks with the digital world and thereby automate your processes. At anny, we already support a range of different smart lock systems. To offer you even more flexibility, we have now integrated additional smart locks from **dormakaba (Exivo)** and **iLOQ** into anny.
</Update>

<Update label="Dec 11, 2024">
  ## Global blockers

  This Christmas, we are giving you something very special - time! 🎄✨<br /> <br />Our team has developed a new feature that will save you a lot of time.<br />From now on, you can create organization-wide blockers for all or selected resources on certain days with just a few clicks.

  But that's not all! With the feature, you can create blockers for all public holidays in your region with just one click. This ensures that no bookings are possible on public holidays - quickly and easily.

  You can find the global blockers in [your account settings](https://app.anny.co/organization/settings/blockers), or you can easily create them via the calendar.
</Update>

<Update label="Dec 9, 2024">
  ## Major child resource management update

  In anny, child resources have an important task, as they allow you to manage multiple bookable units within a parent resource.

   A typical example: You have a room (the parent resource) in which several desks are available. Each individual desk can be configured as a child resource (desk 1, desk 2, desk 3, etc.). This allows your users to book specific workstations.

   We have improved the management of child resources in anny to make your work with them even easier:

  ### **🛠️ Individual properties per child resource**

  You can now customize the properties of your child resources so that they differ from the main resource. This is useful, for example, if one of your child resources is slightly different from the others, and you want to highlight this.

  ### **🔄 Move flexibly**

  You can now move a child resource with just one click and assign it to another resource.  This saves you having to delete and create it again.

  ### 🌎 Global translations

  Last but not least, you can now also translate all child resource names individually into all languages offered by anny.

  We hope you enjoy the latest update!
</Update>

<Update label="Oct 9, 2024">
  ## anny app 2.1.0

  We have released a new version of our anny app. With this release, booking quotas and dynamic pricing are now also included in the app. Moreover, we have added new languages. Have fun!
</Update>

<Update label="Sep 30, 2024">
  ## Notify Admins of failed or disputed payments

  Admins will now get notified if a payment fails or was disputed. You can change your notification settings inside the admin profile (“Payment reminder" notification).
</Update>

<Update label="Sep 18, 2024">
  ## Add data for attribute mapping via API

  Until now, the data used for attribute mapping could only be inserted into anny via attributes using SSO. Now, it is also possible to import additional data directly into anny via the API, meaning that this does not necessarily have to come via the IDP.

  This allows entirely new possibilities to work with our attribute mapping.
</Update>

<Update label="Sep 16, 2024">
  ## anny app 2.0.2

  We have released a new version of our anny mobile app. Users now have the possibly to change their timezone directly inside the profile. Furthermore, we smashed some bugs to make the user experience even better.
</Update>

<Update label="Jul 30, 2024">
  ## Introducing Flexible Booking Types!

  Your resource is now even more flexible - you now have the option to customize the booking type per service, so you can determine exactly how your resource is blocked by a booking.

  These are the different bookings types:

  * **Transparent:** The bookings will not block the resource for the period. Use this option to allow infinite bookings for the same time period.
  * **Default:** A booking blocks the resource for the respective period. With multiple available resources, one capacity unit is blocked with each booking.
  * **Multiple:** A booking blocks the capacity unit you have set with a single booking, e.g. for a group ticket. This setting is only available for resources that are available multiple times.
  * **Full:** Bookings block the full capacity of the resource for the relevant period, e.g. to book a resource as a whole that has child resources. This only works for resources with child resources.
</Update>

<Update label="Jul 30, 2024">
  ## Booking quotas and booking bundles

  <img alt="" />

  ### 📋 Booking quotas

  The new booking quotas provide you with three different quota types that you can set for your users:

  * Quantity quotas: A certain number of bookings that can be made
  * Time quotas: a defined total duration that can be used over several bookings
  * Budgets: a certain amount of money for which bookings can be made

  You can allocate these quotas on a one-off or recurring basis (daily, weekly, monthly or annually). This opens up a wide range of possibilities, such as creating multiple tickets, vouchers, or monthly recurring quotas for your subscription customers or community members such as work or learning spaces.

  Your customers can use their quotas over several bookings, whereby they can view their remaining quota balance at any time. In addition, the use of quotas can be restricted to groups, categories, resources, and services.<br />Alternatively, you can set a quota for the booking of a resource so that no further bookings can be made afterward. Alternatively, the booking is billed at regular conditions once the quota has been used up.

  ### 👥 Quotas in communities and subscriptions

  With booking quotas, you can create exclusive benefits for your subscribers and community members by linking them directly to your subscription plans or communities. You have the option of adding one-off quotas, for example as a welcome gift, or recurring quotas.

  You can find more in our help center: [https://docs.anny.co/en/articles/197826-booking-quotas](https://docs.anny.co/en/articles/197826-booking-quotas?q=booking+bu)

  <img alt="" />

  ### 📦 Booking bundles

  Booking quotas can also be combined into booking bundles and thus offered at a bundle price. Frequent applications are value vouchers or multiple tickets. An individual PDF (e.g. with a voucher design) can also be created and sent automatically for each package sold.

  You can find more in our helpcenter: [https://docs.anny.co/en/articles/197837-booking-bundles-booking-codes](https://docs.anny.co/en/articles/197837-booking-bundles-booking-codes)
</Update>

<Update label="Jul 25, 2024">
  ## Discover the new and improved anny App 2.0!

  We've been busy over the last few weeks reworking our anny app from the ground up and are proud to present version 2.0 to you today. Let me tell you this much: our beta testers already love the new version! Let's dive straight into what's changed:

  ### ✨ What’s new

  You'll notice it straight away: The design of our new version has been fundamentally revised to fulfil the principles of our app: fast, smart and intuitive.<br />We have collected a lot of feedback, corrected bugs and made improvements. Do you still have a suggestion for improvement or an idea? You can send us your comments [here](https://tally.so/r/npVZRb).

  **🗺️ Improved maps**<br />We have made the maps even clearer in the new version, and you can see more information at a glance. Intuitive filters allow you to see directly which resources are still available on the map.

  **🎛️ More filter options**<br />Filters are a good keyword: We have added some new filters. You can now filter resources by desired time and booking duration, properties and locations. In addition, you have direct access to the available slots of the resources and can book them with one tap.

  **🚦See capacity utilization at a glance**<br />Would you like to book a quiet workspace today that doesn't have many users? Do you need a full working environment around you to get carried away by the work motivation? With our utilization indicator, you can quickly see how many people are working at different times. So you know what to expect.

  **🛒 Familiar functions now also in the app**<br />In the mobile app, you will now find many familiar functions that you already know from the web app, such as booking series, recurring bookings, interests & roles and the avatar builder. However, we have also hidden some features in the app that you will find later in the web app. Have you found any yet?

  The new version of the app is already available in the Google Play and Apple App Store. Download the update now on [Android](https://play.google.com/store/apps/details?id=co.anny.app) and [iOS](https://apps.apple.com/en/app/anny/id6448261664) to benefit from the new features.
</Update>

<Update label="Jul 4, 2024">
  ## Subsequent adjustment of personalized bookings

  Your users have already booked but can’t attend and want to send another person - this isn’t a task for you anymore. Now, your customer has the possibility to change their personalization by himself and select, for example, another person. Your customer now has the possibility to change their personalization by themselves.
</Update>

<Update label="Jun 30, 2024">
  ## 📊The new utilization widget

  What is the key to optimal pricing? <br />Precise data on the utilization of your resources. A new widget is now available in the dashboard to show you the utilization of your resources.

  **📈Everything about the utilization of your resources at a glance**

  We have added more filter options so that you can now make even more precise settings to get exactly the data you need.

  **⚖️ Compare the utilization of your resources**

  Create multiple widgets to compare the utilization of your resources with each other, or to compare the same resource at different time periods.

  Learn more about the dashboard and widgets inside our help center: [https://docs.anny.co/en/articles/101578-dashboard](https://docs.anny.co/en/articles/101578-dashboard)
</Update>

<Update label="Jun 30, 2024">
  ## ✨ Dynamic prices for your services and booking options!

  Would you like to...

  * adjust your prices according to occupancy?
  * offer discounts for early bookers or last-minute customers?
  * grant discounts to a specific customer group?
  * give discounts from a certain booking duration?
  * increase or discount your prices depending on the season?
  * adjust your prices based on the day of the week, e.g., the weekend?
  * *or combine everything directly?*

  **We've developed the ideal solution for you! 🤝**

  With our new feature, you can now set dynamic prices for your services and booking options.

  You can adjust prices according to the following criteria:

  * **⏰ Time factors:** Offer special prices on certain days of the week, individual dates, at certain times or for a certain duration.
  * **👥 Customer groups:** Give certain customer groups discounted prices.
  * **📊 Utilization:** Adjust your prices based on the utilization of your resources.

  Take a look at our Help center article now and optimize your pricing: [https://docs.anny.co/en/articles/179792-dynamic-pricing](https://docs.anny.co/en/articles/179792-dynamic-pricing)
</Update>

<Update label="Jun 26, 2024">
  ## Seamless integration with Personio and HRworks

  HR systems are used in many companies to simplify processes. For example, employees can enter when they are ill and everyone else is notified. With our new integration of the HR systems Personio and HRworks, anny is now also notified and can easily cancel bookings. Let's take a look at what else these new integrations bring:

  ### 🏃 Automatic cancellation in the event of absence

  Are your employees absent but still have a seat booked in the office? You can now set that these bookings are automatically cancelled in the event of absence and the resources are released again.

  ### 🏡💻 Synchronization of home office and office days

  Synchronize your employees' home office and office days directly from anny into your HR system. This means you can also see and record where the person is in the HR system.

  Want to know how to set up these integrations? Then take a look at our help center articles for [Personio](https://docs.anny.co/en/articles/179056-personio-integration) and [HRworks](https://docs.anny.co/en/articles/179057-hrworks-integration).
</Update>

<Update label="Jun 13, 2024">
  ## The biggest invoice update we've ever published 🚀

  Today, we have something special for you: We have published our biggest update to date regarding invoices in anny. Curious to see what's in store for you? Let's dive right into it:

  <img alt="" />

  ### 🔔 Change manager (notifications & individual refunds)

  A new pop-up summarizes all changes and allows you to adjust them and activate or deactivate notifications. You can now also disable notifications for customers for all changes in bookings, orders, and invoices.

  For even more control, you can also create fully customized refunds or corrective invoices.

  <img alt="" />

  ### 🖌️ Invoice designer

  With anny, you can create new invoices for an order at any time. You retain full flexibility, as services can also be invoiced retrospectively, for example add-ons such as catering or equipment. You can now also create forms for customers or orders to display them on the invoices. For example, an order number or VAT ID number.

  For very special cases, you can also create invoices independently of bookings or subscriptions.

  <img alt="" />

  ### 📄 Quotation creation

  With the new quotation function in anny, you can save orders as a draft and create a quotation PDF. Once accepted, quotes can be converted into invoices and sent to your customers. With the practical payment link in the email, your customers can pay conveniently online.

  **Further improvements**

  * The order status has been simplified to "Draft" or "Completed". For more information, you can show the "Invoice status" column in the order list.
  * In addition to the PDF version, invoices are now also available as e-invoices in XML format.
</Update>

<Update label="Jun 13, 2024">
  ## 🇨🇭 TWINT Integration

  Anny now supports the popular Swiss payment service provider TWINT for payments in Swiss francs. With TWINT, we now support ever 13 different payment methods.
</Update>

<Update label="May 30, 2024">
  ## 2-way synchronization with Google Workspace

  Link your Google Workspace resources such as meeting rooms or equipment directly to resources in anny via two-way synchronization. This allows your bookings to be synchronized in real time. Take a look at our [instructions](https://docs.anny.co/en/articles/171687-google-workspace-integration).
</Update>

<Update label="May 26, 2024">
  ## Add-On Optimizations

  **🎨 Enhanced Add-Ons Customization**

  * **Image and Group Uploads**: Enhance the visual appeal of your add-ons by allowing the upload of images and creation of groups for better organization.
  * **Reorganized Settings and Price Simplification**: Streamline your add-on management with a redesigned settings interface and a simplified pricing structure that eliminates confusion by limiting price to one mode (quantity, interval, or percent).

  **📋 Multi-Booking Flexibility**

  **Individual Selection for Multiple Bookings**: Empower users with the flexibility to customize add-ons and sub-resources individually for each booking within a multiple booking schedule.

  **🔎 Discover and Group Add-Ons**

  **Enhanced Search and Grouping**: Navigate through extensive add-on options effortlessly with an optimized search system and a dedicated grouping feature that categorizes add-ons when more than 5 are available on the booking panel.
</Update>

<Update label="May 26, 2024">
  ## Optimization of the admin tables

  We have made it much easier for you to work with our data tables and added new filters and columns:

  * **Filter by Community 👥:** Filter customers based on their community affiliation for targeted data analysis.
  * **Community Column Revealed 🌍:** A new "Community" column in the customer table provides instant visibility into customer community membership.
  * **Custom Field Spotlight 💡:** Enhance table functionality by displaying user-defined fields in all tables, maximizing customization.
  * **Column Control Center 🛠️:** Take control of table organization with the new table column manager, allowing you to customize column order and selection to suit your analysis needs.
</Update>

<Update label="May 26, 2024">
  ## Upgrade for Custom Fields

  **🎯 Target-Oriented Forms**

  Custom fields can now be queried not only at booking level, but also at customer and order level. This setting defines when and how often the data is queried at checkout and where it is subsequently saved.

  Example: A bike rental company offers groups the option of renting bikes. At booking level, customers can specify the desired frame size. At the order level, the rental company can then query the planned route to optimally adjust the tire pressure to the route conditions.

  **🎭 Linguistic Enhancements**

  Translated Field Names and Descriptions: Custom field names and form descriptions can now be translated into multiple languages.

  **🛡️ Private Fields**

  Hide from Checkout: A new option enables you to disable "Show in Checkout" for custom fields. This creates admin-only fields that can be used exclusively for internal purposes.
</Update>

<Update label="Apr 15, 2024">
  ## Additional participants for bookings and booking confirmations per service

  ### 👫 Add additional participants to a booking

  <img alt="" />

  From now on, additional participants can be added to a booking using their name or e-mail address. The participants will automatically receive a booking confirmation and have the option to cancel the booking.

  You can activate this function as follows:

  1. Select the desired service and navigate to "Form".
  2. Activate the "Allow additional participants" function. Below this, you will find various setting options to configure this feature according to your wishes.

  ### ❓Did you know that you can activate a manual confirmation process for bookings?

  Previously, it was possible to control booking requests on a per-resource basis. With the new update, you can now also make this setting per service, which gives you more flexibility in handling your offers.<br /> <br />You can activate this function as follows:

  1. Open the desired service in anny.
  2. Navigate to the "Advanced settings".
  3. Deactivate the option "Accept all bookings automatically".

  A booking receives the status "requested" if either the booked service or the resource has deactivated the automatic acceptance of bookings.
</Update>

<Update label="Apr 9, 2024">
  ## Simply become multilingual

  We have great news for you - in multiple languages! Greet your users in their language and make it even easier for them to book your resources. Let's dive right in!

  ### 🗣️ Your resources can now speak multiple languages

  <img alt="" />

  Your booking page could already do it, and now your resources can too: they speak 16 languages fluently and speak to all your users. From now on, you can create all your content in different languages. This includes, for example, the name and description of each resource and service. We automatically display the content to your users in the correct language.

  Next to each supported input field, you will now find a language selection menu that you can use to add additional languages. Try it out directly for your resources.

  ### 🌍 Extended language support

  <img alt="" />

  We now support even more languages! Say hello to American English (en-US), Norwegian (nb-NO), Hungarian (hu-HU), Italian (it-IT) and Czech (cs-CZ) in our language palette!

  Do you have any feedback on the translations? Please write to [product@anny.co](mailto:product@anny.co).

  ### 📅 Date formats for specific regions

  No more confusion with dates! Users from the USA (en-US) now use the MM/DD/YYYY format, while users from the UK (en-GB) stick to the DD/MM/YYYY format.
</Update>

<Update label="Apr 1, 2024">
  ## Subscription and Invoice Management Supercharged!

  We have exciting news for you! With our latest update, we've taken subscription and invoice management to the next level to optimize your processes and offer your customers an even better experience. Let's dive right in:

  ### 💸 Your subscription management has never been this easy

  With our new subscription management features, you have more control over your subscriptions and the ability to customize them to your customers' needs.

  * **Shift the start date:** You can now flexibly adjust the start date of a subscription.
  * **Pause easily:** You can pause subscriptions with just one click.
  * **Decide when the subscription ends:** You now have the option to cancel subscriptions at different times: immediately, at the end of the current period or after the minimum term has been reached.
  * **Price changes and discounts:** You now have the option to flexibly adjust the prices and discounts in your customers' plans - even after the subscription has started.
  * **Cancellation and refund of individual invoices:** If something goes wrong, you can cancel and refund individual subscription invoices.

  Best of all, your customers will be informed directly of any changes.

  ### 📝 New features in invoice management

  We have also made adjustments to invoice management that will make your work much easier:

  You can now manually set invoices to "paid". As soon as this happens, we will automatically inform the customer that the payment has been received.

  If you also need to modify the billing address, you now have the option to change it. As part of this adjustment, we will automatically create a new invoice and cancel the old one. In addition, future invoices will also be use the new address.
</Update>

<Update label="Mar 24, 2024">
  ## anny Display App 1.0.5

  A new version of the anny app is available. This update allows you to hide the QR-Code from the display app. This offers the advantage of using the app only as display without any interaction.
</Update>

<Update label="Mar 14, 2024">
  ## anny App 1.0.9

  A new version of the anny app is available. This update provides two new features:

  ### Better Deep-Links

  We improved the support for deep links into the anny app:

  * If the link is leading to another data region, we are automatically switching to this region
  * If a login is required to view or book the resource, we are now forwarding the user to the login screen and redirect him back after the login to the resource

  ### Improved Maps

  We also improved the map that is used inside the app. The map is now loading even faster and doesn’t lead to app crashes.
</Update>

<Update label="Mar 12, 2024">
  ## Accept now payments via PayPal and 4 other providers

  Did you know that anny can process both internal and external bookings and automate payment processing for you?<br />Thousands of bookings are already paid online via anny every day. With our latest update, we have expanded both the payment options and the supported currencies.<br /> <br />**🌟 Let your customers pay via PayPal**<br />Your customers can now pay for their bookings easily with PayPal! PayPal Payments are automatically activated for you and are processed via Stripe Connect.<br /> <br />In addition to bookings, subscriptions in Swiss francs can also be paid via PayPal. This gives you a flexible alternative to credit card payments in Switzerland.<br /> <br />**💰 New payment methods and currencies for your customers**<br />In addition to PayPal, we are introducing further new payment methods:

  * **EPS** for customers in Austria
  * **blik** for customers in Poland (supports PLN)
  * **Przelewy24** for customers in Poland (supports PLN & EUR)
  * **Bancontact** for customers in Belgium

  You can now also process payments in the currencies DKK, SEK and NOK.
</Update>

<Update label="Feb 22, 2024">
  ## Expand your profile and find exactly the people you need

  At anny, we love the versatility of communities and teams. Our latest update is therefore specifically designed to strengthen collaboration, communication, and interaction.

  **👤 Extended user profiles**

  You can now fill your profile with even more information: from your job title and department to your skills, roles, and interests. Not only can you personalize your profile, but you can also get to know the community better and network and collaborate in a more personalized way.

  🔎 **Find exactly the person you need**

  Find people directly using keywords in their bio, job title or department. You can also filter directly by skills: for a targeted search. This means you always know where the nearest first-aider is located, or where you can be found as an anny expert.

  **🎯 See the top skill directly**

  You can also see a user's top skill highlighted on each profile picture. This allows you to see at a glance who has what expertise. For example, you want to know where a dog is in the office? Simply search for a dog emoji on the map.

  So, what are you waiting for? [Expand your profile](https://anny.co/b/account/profile) now and add your skills, roles, and interests.
</Update>

<Update label="Feb 20, 2024">
  ## Favourite your preferred Child-Resources in anny

  In anny you can already favor your preferred resources with just one click, such as your preferred meeting room or your favorite office. These are then displayed in your weekly planner, and you can book them quickly and easily. You can also manage your favorites on the [favorites page](https://anny.co/b/account/favorites?utm_source=newsletter\&utm_medium=email\&utm_campaign=new-in-anny-child-resources-save-position-more).<br /> <br />From now on, you can also favor child resources. Your favorite child resources are automatically selected in the weekly planner when you book, so you can book your favorite place with just one click per day.

  <img alt="" />
</Update>

<Update label="Feb 6, 2024">
  ## Save last Map Position, Mobile Reminders for Booking Reminders & New Booking Page Button

  ### 📍 Save the latest position on the map automatically

  **🗺️ Resume where you left off**: The week planner map now remembers your last viewed location automatically. This means that when you return to the map, it will automatically zoom in on the area and the layer you were previously exploring.

  <img alt="" />

  ### 🔔 Mobile notifications for booking reminders

  **📱 Stay in the Loop with your customers:** We're excited to introduce the option to enable WhatsApp and SMS notifications for booking reminders for your customers. Now, they can receive timely reminders about their upcoming bookings via their preferred communication channels and not only via mail.

  Ensure that your customers never miss an appointment again and provide them with a convenient and personalized experience. We have also enabled this feature for self-check-in notifications.

  <img alt="" />

  ### 🌐 New booking page button

  **🖱️ On-Click access to booking links:** Say goodbye to the hassle of searching for booking page links! With our new booking page button, you can now access all booking page and community page links in one convenient place.

  Simply click on the button to open a modal window that displays all the relevant links, making it easier than ever to manage your bookings and connect with your community.

  <img alt="" />
</Update>

<Update label="Jan 31, 2024">
  ## New Version of our Outlook Add-In

  We have just released version 1.1.0 of our Outlook Add-In for Microsoft. This version brings significant performance optimizations and is now also compatible with older versions of Outlook. The update will automatically rolled-out by Microsoft over the next days.
</Update>

<Update label="Jan 15, 2024">
  ## Introducing anny Display

  We recently launched the [anny mobile app](https://anny.co/features/mobile-app?utm_source=newsletter\&utm_medium=email\&utm_campaign=newsletter-display-app-release), and now we're excited to introduce our second app - **anny Display**! 🎉

  Visualize digital bookings in the real world and get insights into the availability of your resources at a glance.

  **How can I use the app?**

  * **As a Room Display**: Install any tablet at your meeting room and use the anny display app as a status indicator and for ad-hoc booking.
  * **As a Wayfinder**: Use a larger display in the entrance area to show an overview of various resources in real-time.
  * **As a Booking Terminal**: Whether at the entrance of your office or in the library - with anny Display, ad-hoc bookings of workspaces, as well as check-ins are faster than ever.

  **What does anny Display offer?**

  * **Visualization of Availability**: Avoid interrupting ongoing meetings with live updates on free and reserved rooms.
  * **Flexible Booking Options**: anny Display enables seamless ad-hoc bookings and planned reservations – anonymously, with a QR-code pass, or via NFC.
  * **Check-In & Check-Out**: Booked a room but not using it? Meeting ended earlier than planned? Automatically release capacities - for optimal utilization and use of your resources.

  With the anny Display app, we are setting new standards in resource management: It offers unparalleled transparency in availability and enables optimal utilization of your resources.

  Do you want to download anny Display now? You can find it directly inside the stores:

  * [iOS](https://s.anny.co/app-store-display)
  * [Android](https://s.anny.co/play-store-display)
</Update>


# 2025
Source: https://docs.anny.co/changelog/2025

Follow the updates and improvements made to the anny platform in 2025.

<Update label="Dec 23, 2025">
  ## TikTok Pixel & Conversion API Integration

  <img alt="" />

  Track and optimize your TikTok campaigns directly on your anny booking pages. anny now supports TikTok Pixel and Conversion API so you can better understand user behavior and improve ad performance.

  ❓**What it does**

  * Add your TikTok Pixel ID in the anny admin to connect your booking pages with TikTok.
  * anny automatically sends key events (e.g. page views, bookings) to TikTok whenever cookies are accepted.
  * Optionally add an Access Token to enable TikTok Conversion API and track conversions even if users do not accept cookies.
  * Use the event data in TikTok Ads Manager to analyze performance, build better audiences and let the algorithm optimize towards real bookings.
  * Close tracking gaps with server‑side events so your reporting stays accurate and your optimization signals reliable.

  💡 **Example**

  A yoga studio can promote its classes on TikTok, see which campaigns drive the most bookings and automatically optimize spend based on real conversions.

  This feature helps you measure the true impact of TikTok ads that link directly to your anny booking page and gives the TikTok algorithm better signals to find the right customers.

  Find out more in the help center article: [https://docs.anny.co/de/articles/508569-tiktok-ads-tracking](https://docs.anny.co/de/articles/508569-tiktok-ads-tracking)
</Update>

<Update label="Dec 23, 2025">
  ## Meta Pixel integration for precise conversion tracking

  <img alt="" />

  You can now connect your Meta Pixel directly in anny to track and optimize conversions from your booking pages.

  ❓**What it does**

  * Add your Meta Pixel ID in the anny admin to automatically send booking events to Meta
  * Tracks events when users accept cookies on your booking page
  * Optionally add a Meta Conversion API access token to capture conversions even when cookies are rejected
  * Sends relevant booking events to Meta so ad performance and attribution are more accurate
  * Enables Meta’s ad algorithm to optimize delivery toward people who are more likely to book

  💡 **Example**

  A wakepark promoting tickets on Meta can now see exactly which ads lead to bookings and let the algorithm automatically find similar guests.

  This feature helps you understand how well your Meta ads drive bookings and lets Meta optimize your campaigns based on real conversions, even with limited cookie data.

  Find out more in the help center article: [https://docs.anny.co/en/articles/508568-set-up-meta-ads-tracking](https://docs.anny.co/en/articles/508568-set-up-meta-ads-tracking)
</Update>

<Update label="Dec 22, 2025">
  ## Merge duplicate customers

  <img alt="" />

  You can now merge duplicate customers directly in anny. This keeps your customer database clean and ensures all bookings and subscriptions are collected under a single profile.

  ❓ **What it does**

  * Adds a new **Merge** action in the customer table and customer detail view
  * Lets admins select two customer records and merge them into one
  * Transfers all bookings, subscriptions and related data to the target customer
  * Updates missing data fields on the target customer with information from the other record
  * Helps resolve duplicates that occur when customers book with multiple email addresses

  💡 **Example**

  If a customer has made a booking using their private email address and another using their company email address, you can now merge both records into one complete customer entry.

  This feature reduces manual clean-up work and improves data quality in your admin area.
</Update>

<Update label="Dec 16, 2025">
  ## n8n integration for custom workflows

  <img alt="" />

  With the new n8n integration, you can use anny as a node in your n8n cloud workspace to automate complex, individual processes around bookings, customers and invoices. Authorization and webhook handling are managed directly in n8n, so you can focus on building smart workflows.

  ❓ **What it does**

  * Provides a dedicated **anny node** in n8n Cloud
  * Offers multiple **triggers**, such as:
    * Booking created
    * Booking checked in
    * Booking starts
    * Booking ends
    * Invoice created
    * Customer created
  * Includes **actions** to interact with anny data via API
  * Handles **authorization** and **webhook management** automatically
  * Enables automations across CRM, newsletter systems, IoT hardware, accounting tools, and AI-powered workflows
  * Supports connections to **1,269+ integrations** in n8n
</Update>

<Update label="Dec 16, 2025">
  ## Custom Forms for Subscriptios

  <img alt="" />

  You can now create custom forms and attach them to your subscription plans to collect exactly the information you need from your customers, including file uploads.

  **❓ What it does**

  * Allows admins to create custom forms and link them to specific subscription plans
  * Supports file uploads (e.g., PDFs, images) within subscription forms
  * Shows submitted form data on the subscription detail page and/or the customer record, depending on configuration
  * Ensures all required information for a subscription is collected during the first subscription purchase in the plan group

  💡 **Example**

  A coworking space offers a monthly membership that requires a brief KYC check.<br />When a new member subscribes for the first time, they are automatically asked to complete a custom form that includes identification details and a PDF upload field.<br />The admin team can view the submitted file and data directly on the subscription record, no emails, no manual tracking, no missing documents.
</Update>

<Update label="Dec 15, 2025">
  ## UniFi Smart Lock Integration: Automated Access Control per Booking

  <img alt="" />

  Automatically connect your UniFi Door Access smart locks with anny bookings to grant and revoke access just in time. No more manual key handovers, spreadsheets or permanent access that nobody remembers to clean up.

  ❓ **What it does**

  * Connects UniFi Door Access via host URL and API token directly with anny
  * Creates time-boxed access per booking so guests only enter during their reserved slot
  * Supports three types of access:

  → **Remote open**: one-click opening from anny as you are used to

  → **Visitor access**: PIN code that is valid between booking start and end time

  → **User access**: just-in-time access for existing UniFi users, adding the right access policy and locks for the booking duration and removing it afterward

  * Lets you disable user access in the settings if you always want PIN-based visitor access instead
  * Works only with UniFi Door Access devices (no WiFi management included)

  💡 **Example**

  A coworking space can automatically send a PIN code to meeting room guests for the exact booking time and revoke it afterward, without staff needing to be on site.
</Update>

<Update label="Dec 9, 2025">
  ## Confirm all requested bookings in an order with one click

  <img alt="" />

  You can now confirm all requested bookings within a single order in one action. This is ideal for workflows with many booking requests, such as equipment rental or bulk reservations.

  ❓ **What it does**

  * New action **“Confirm bookings”** available in the order detail view
  * Action appears when *all* bookings in the order have the status **requested**
  * Confirms all requested bookings in that order with one click
  * End customers receive **one consolidated email** instead of multiple notifications
  * Significant reduction of manual processing effort for large orders (e.g., 100+ bookings)

  💡 **Example**

  A customer submits a booking request for **30 pottery workshops** in one order. Instead of confirming each workshop individually, the admin opens the order and selects **“Confirm bookings”**. All 30 requested workshops are approved with a single click, and the customer receives just **one consolidated confirmation email**.

  Find out more in the helpcenter article: [https://docs.anny.co/en/articles/374769-booking-management-with-anny](https://docs.anny.co/en/articles/374769-booking-management-with-anny)
</Update>

<Update label="Nov 20, 2025">
  ## Updated Outlook add-in

  <img alt="" />

  We’ve released a major update to the anny Outlook Add-In, delivering a completely redesigned interface and several new features that make scheduling with anny inside Outlook faster and more intuitive.

  ❓**What it does**

  * **Full compatibility with both** [**anny.eu**](http://anny.eu) **and** [**anny.co**](http://anny.co)
  * **Automatic login** for all users who authenticate via Microsoft SSO
  * **Capacity-based filtering** when adding participants to a booking (provided that the capacity property is specified for the rooms)
  * **New map view** for easier spatial navigation
  * **Completely redesigned UI** for a cleaner and more modern experience
  * **Participant synchronization:** Outlook attendees are now synced directly into the anny booking
  * **Free-text search** in the add-in
  * **Manage bookings after scheduling:** View, cancel or add bookings to existing Outlook events
  * All directly available **inside the Outlook Add-In when creating or editing appointments**

  This update brings a faster, more intuitive workflow to everyday scheduling — especially for teams who regularly connect Outlook appointments with resource bookings in anny.

  See how to install it here: [https://docs.anny.co/en/articles/111817-how-do-i-add-the-outlook-add-in](https://docs.anny.co/en/articles/111817-how-do-i-add-the-outlook-add-in)
</Update>

<Update label="Nov 19, 2025">
  ## Advanced Service Setting: Allow Cross-Blocker Bookings

  <img alt="" />

  A new advanced service setting is now available: **Allow Cross-Blocker Bookings**. When enabled, bookings are permitted to start **before** a blocker and end **after** a blocker.

  ❓**What it does**

  * Allows bookings to extend across existing blockers
  * Bookings may begin before a blocker and finish after a blocker
  * Provides more flexibility for services with overlapping time needs

  💡 **Example**

  A meeting room has a 10-minute buffer blocker between two time slots for a quick room reset.<br />Another team wants to book the room for the entire morning:

  * 09:00–12:00<br />→ 10:50–11:00 blocker

  With the new setting, this booking can now still be made.

  Read on here: [https://docs.anny.co/en/articles/249541-global-blockers-and-holiday-blockers](https://docs.anny.co/en/articles/249541-global-blockers-and-holiday-blockers)
</Update>

<Update label="Nov 19, 2025">
  ## Improved Participant Management

  <img alt="" />

  We’ve introduced several enhancements to make managing participants in bookings more flexible and transparent across tools.

  **❓ What’s new**

  * **Define minimum and maximum participant numbers:** You can now set clear participation limits for each booking to ensure capacity requirements are met.
  * **Full compatibility with external calendars:** Participants are automatically added to Outlook, Google Calendar & other connected calendars, including invitation handling.
  * **Participants visible everywhere:** In the Planner, Calendar, and on Display, all assigned participants are now shown, providing a clearer overview of who is attending.
  * **Integrated RSVP management in anny:** When participants are added to a booking, they can respond to it. All responses are synced, giving you up-to-date attendance information at a glance.

  **💡 Example**

  A team books a **meeting room for a workshop**:

  * The service requires **at least 3 and max. 12 participants**, so the booking automatically checks the correct capacity.
  * When the organizer adds participants, they are **instantly added to the Outlook or Google Calendar event**, including the official invitation.
  * In the **Planner, Calendar, and Display views**, everyone can immediately see **who is attending** the workshop.
  * Each participant can **RSVP directly in anny** (accept or decline), and these responses are synced across anny and external calendars, giving the organizer a clear, up-to-date view of attendance.

  Learn more here: [https://docs.anny.co/en/articles/470645-participants-management](https://docs.anny.co/en/articles/470645-participants-management)
</Update>

<Update label="Nov 19, 2025">
  ## Designer 2.2: Performance & usability enhancements

  <img alt="" />

  The latest update to the anny Designer brings several enhancements that make creating and editing booking pages faster and more intuitive.

  ❓**What’s new**

  * **Improved performance:** Faster loading and smoother interactions when working with complex layouts or larger designs.
  * **Simplified element grouping:** Elements can now be grouped and managed more easily, making layouts clearer and reducing editing steps.
  * **Updated interface design:** Visual optimizations for a cleaner, more consistent design experience.

  These improvements make the Designer more responsive and user-friendly.
</Update>

<Update label="Nov 19, 2025">
  ## Simplified Selection on the Booking Page

  <img alt="" />

  We’ve introduced a streamlined way to **add resources to the cart directly from the booking flow**, especially helpful for customers who rent out resources for short periods.

  ❓**What it does**

  * Activates automatically when using the **date and time filter** on the Explore page.
  * Adds a **“+” button** to the available time slots (“time pills”), allowing you to add the selected resource with the chosen service directly to the cart.
  * The selected **service can be adjusted** using the arrow buttons before adding it to the cart.
  * **Add-ons** can be selected later during the checkout process.
  * The **booking title step is skipped**, even if it’s normally required, to speed up the flow.

  💡 **Example**

  If you rent out short-term resources like sports courts, meeting rooms, or equipment, users can now select a time slot on the booking page and add it to the cart instantly. making the booking process faster.
</Update>

<Update label="Nov 19, 2025">
  ## Remote-Open for Smart Locks

  <img alt="" />

  Your customers can now open booked rooms **directly from the anny app**, but only if they have a valid booking.<br />With the new **Remote-open** feature (available for **Nuki** and **Kleverkey**) and a new dedicated section on the anny homepage, access is now even smoother, while remaining secure and fully tied to valid booking rules or community access.

  ❓**What it does**

  * Enables **remote unlocking** of doors directly from the anny app (Tap to open)
  * Provides additional access options depending on the Smart Lock provider:
    * **QR code** displayed in the app
    * **PIN code** shown in the app
    * **Direct launch** of the provider’s Smart Lock app
  * Shows all available Smart Locks on the **anny homepage** in a dedicated section
  * Ensures access only works within a **valid booking timeframe** or for users with **community access**
  * Available in both the **anny mobile app** and the **web app**

  🔑 **Provider-specific setup**

  **Nuki**

  * Re-authorize the integration once in the anny admin area
  * You will be prompted to allow **Remote-access**
  * Afterwards, enable **Remote-open per rule**

  **KleverKey**

  * Remote-open is available immediately
  * Simply activate **Remote-open per rule**

  Find more information in our helpcenter article: [https://docs.anny.co/en/articles/30481-smart-lock-integrations](https://docs.anny.co/en/articles/30481-smart-lock-integrations)
</Update>

<Update label="Nov 19, 2025">
  ## Add Images, Videos & Files to Resource Descriptions

  <img alt="" />

  You can now enhance your resource descriptions by embedding **images, videos and files** directly within the text. This allows you to present resources more visually and provide important information right where users expect it.

  ❓ **What it does**

  * Allows you to insert images directly into the resource description for better visual presentation.
  * Supports embedding videos (via YouTube, Vimeo or Loom) inside the description.
  * Enables adding files such as PDFs directly into the text.
  * Helps structure content more clearly with visual elements placed exactly where they add the most context.

  💡 **Example**

  In the description of a **padel court**, you can now embed:

  * an **image of the court**
  * a **short introduction video** explaining how to use the court
  * a **PDF with game rules**

  This gives players all essential information at a glance, reduces follow-up questions, and provides a more complete and professional presentation of the resource.
</Update>

<Update label="Nov 19, 2025">
  ## Add Files to Your Resource Pages

  <img alt="" />

  You can now upload **attachments directly to your resource pages** in anny, this makes it easier to provide important documents, images or videos associated with each resource.

  ❓ **What it does**

  * Allows you to attach files, images, archives, and videos to any resource.
  * Files appear on the resource’s booking page, where they can be downloaded or viewed by users.
  * Typical use cases include:
    * Catering menu
    * Product data sheet for equipment
    * Seating plans or room layouts
    * Tutorial videos
  * Upload is simple: just open the resource, scroll to the “Files” section, drag & drop or select the file, then save.

  **💡 Example**

  For an event space that includes catering options, you can now upload the catering menu as a PDF. Visitors to the booking page will see the document ready for download or review, without you needing to send it separately.

  Learn more here about the file types: [https://docs.anny.co/en/articles/445803-how-can-i-attach-files-images-videos-documents-to-a-resource](https://docs.anny.co/en/articles/445803-how-can-i-attach-files-images-videos-documents-to-a-resource)
</Update>

<Update label="Nov 19, 2025">
  ## Link Resources, Plans & Booking Packages in Service Descriptions

  <img alt="" />

  You can now add direct links to **resources**, **subscription plans**, and **booking packages** within your service descriptions. This makes it easier to structure information and highlight relevant connections between your offerings.

  **❓ What it does**

  * Allows you to link relevant **resources** directly inside the service description.
  * Supports linking to **plans**, e.g., membership.
  * Enables linking **booking packages**, useful when a service can be combined with package-based bookings.
  * Lets users open linked elements immediately, without having to search for them elsewhere.

  **💡 Example**

  In the description of a **Coworking Open Space** resource, you can now directly link:<br />– a meeting room,<br />– a 5-session pass, and<br />– the corresponding membership plans.

  This gives users an immediate overview of all connected options without having to search elsewhere.
</Update>

<Update label="Nov 19, 2025">
  ## AI-Powered Automatic Translations

  <img alt="" />

  You can now manage translations for your content in a more structured and consistent way across anny. This includes not only **standard fields** but also your **custom fields**, ensuring a fully multilingual experience for your users.

  **❓ What it does**

  * Allows you to translate all relevant content fields directly in the admin interface.
  * Supports translations for custom fields, including labels, descriptions, and placeholder texts.
  * Provides a clear language-switching interface so you can edit multiple languages side by side.
  * Ensures your booking pages display the correct language based on user selection or browser settings.

  Learn more in our Helpcenter article: [https://docs.anny.co/en/articles/445372-how-can-i-translate-content-into-multiple-languages-and-translate-custom-fields](https://docs.anny.co/en/articles/445372-how-can-i-translate-content-into-multiple-languages-and-translate-custom-fields)
</Update>

<Update label="Nov 19, 2025">
  ## Integration with Shelly Switches

  <img alt="" />

  The new Shelly integration allows you to connect booking activities in anny with your Shelly smart switches. Shelly devices are compact, WiFi-enabled relays installed in the power line of a device (e.g., a lamp) or behind a light switch.

  **❓ What it does**

  * Links selected anny resources with your Shelly switches.
  * Triggers actions on your Shelly devices based on booking activity.
  * Supports the following booking-based triggers:
    * **Booking starts**
    * **Booking ends**
    * **Booking checked in**
    * **Booking checked out**

  **💬 Example**

  When a booking starts, a Shelly switch can automatically turn on the lights in the room; when the booking ends, the switch can turn them off, no manual interaction needed.

  Learn more here: [https://docs.anny.co/en/articles/410051-shelly-integration](https://docs.anny.co/en/articles/410051-shelly-integration)
</Update>

<Update label="Nov 19, 2025">
  ## Integration with Tapirx E-Paper Displays

  <img alt="" />

  anny now supports a direct integration with **Tapirx E-Paper Displays**, allowing you to link displays to your resources and keep availability information automatically up to date.

  **❓ What it does**

  * Connects Tapirx E-Paper Displays directly to selected resources in your anny account.
  * Automatically updates each linked display with the latest availability and scheduling information.
  * Supports the current Tapirx device lineup, including:
    * **Tapirx Mini 4.2"**
    * **Tapirx Touch 7.5"**
    * **Tapirx 7.5"**
  * Works with the Tapirx infrastructure for long-lasting, low-maintenance E-ink displays.

  **💬 Example**

  Link a room resource to a Tapirx display mounted outside the door, the device will show the current availability without any manual updates.

  **💡 Interested?**

  Fill out this form and we’ll create a non-binding offer for you together with Tapirx: [https://tally.so/r/mDXdkE](https://tally.so/r/mDXdkE)
</Update>

<Update label="Nov 19, 2025">
  ## Webhooks: Real-time Activity Notifications

  <img alt="" />

  With Webhooks, anny can now send real-time notifications to your systems whenever specific events occur.

  **❓ What it does**

  * Sends an HTTP request to a URL you define whenever selected events happen in anny.
  * Supports events across bookings, orders, invoices, and customers, including create, update, and delete actions.
  * Allows filtering booking-related events by resources, services, or categories.
  * Delivers structured JSON payloads containing event metadata and the affected object.
  * Signs each webhook request so you can verify authenticity.
  * Stores a delivery history and retries failed deliveries automatically.

  **💬 Example**

  When a new booking is created, anny immediately sends the booking data to your endpoint, where you can trigger further processing such as notifications or system updates.

  Learn more here: [https://docs.anny.co/en/articles/349740-webhooks](https://docs.anny.co/en/articles/349740-webhooks)
</Update>

<Update label="Nov 16, 2025">
  ## Manage schedules more easily with groups & temporary variants

  Managing your schedules is now **much easier**.<br />With the new features for **schedule groups and temporary schedules**, you can make changes centrally and respond flexibly to temporary differences.

  1. **Schedule groups: Central control for multiple resources**

  Previously, you had to create and adjust the same schedule for each resource individually.<br />Now you can **link a schedule to multiple resources** and manage changes centrally.

  💡 **Example**:<br />Your standard opening hours apply to all rooms. When you adjust them in a schedule, they are automatically updated for all linked resources.

  2. **Temporary schedules: Set different times for specific periods**

  Some periods require special opening hours, such as during the summer months or the holiday season.<br />With temporary schedules, you can **create additional variants of your standard schedule** that are only active during a specific period.

  💡 **Example**:

  Your regular opening hours apply throughout the year, but you want to be open longer in the summer. Simply create a seasonal variant for this period, and anny will automatically activate it and then revert back to the standard hours.
</Update>

<Update label="Nov 13, 2025">
  ## New community management options

  👬 Additional settings for communities

  Until now, the incognito mode setting was up to the users—now, as an admin, you can specify this. You can choose between:

  * All users are incognito
  * All users are visible
  * All users are incognito by default, but can adjust their settings
  * All users are visible by default, but can adjust their settings

  We have introduced a role system for communities. You can choose between the following roles:

  * Member (can view and book members)
  * Observer (can view members but not book them)
  * Visitor (can book but not view other members)

  These roles can now be set for automatic membership, so every member starts with this role. The role can be adjusted later.

  The invitation function has also been upgraded:

  * You can now customize the text for an invitation to a community.
  * You can now "silently invite" new members, meaning that members are added without receiving any information about it.

  If you want to add a member to a community for a specific period of time, simply set a start and end date before inviting the member.
</Update>

<Update label="Nov 13, 2025">
  ## Individual settings for child resources

  * Child resources can now be deactivated individually
  * Properties can now be selected for each child resource

    <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## Improved Resource Calendar Overview

  * **Optimized Child Resource Calendar View:** Now you can see more child resources at a glance without needing to scroll.
  * **Enhanced Visibility:** Improved layout provides a clearer overview of the availability of child resources.
  * **Week View for Resources:** Plan and organize with an expanded weekly perspective for each resource.
  * **Full Screen Calendar Display:** Dive into a comprehensive full screen view for detailed scheduling.
  * **Refined Color Coding:** Quickly discern the availability of resources with an optimized color scheme.
  * **Participant Display on Booking Slots:** Easily view all participants directly within each booking slot.
    <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## New Filters to find people in the office

  We've enhanced our search functionality with the introduction of additional filters to help you find people more effectively. You can now refine your searches by applying filters for Dates, Addresses, and Communities, making it easier and faster to locate the person you are searching for.

  <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## Filtered and column-based exports

  * The current view can now also be filtered, meaning that all currently selected columns and filters are taken into account during export.
  * Columns can now also be configured for automatic exports.

    <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## New Smart lock integrations: Comydo und Dormakaba Resivo

  We are pleased to announce an expansion of our smart lock integrations with the addition of a new provider, **Comydo**. This partnership is part of our ongoing effort to broaden the range of options available to our customers, ensuring greater flexibility and security in access solutions.

  Furthermore, we are excited to reveal that our Dormakaba family has grown. You now have the capability to integrate **Dormakaba Resivo** locks with your existing resources.

  <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## Map Designer 2.0 with enhanced features

  The Map Designer got some updates for an enhanced usability.

  What's new?

  🧑‍💻 Better UX: you can now design your maps in full screen, the allocation of resources has been significantly simplified, and you can now search for (child) resources

  ⛓️‍💥 There is now a snapping mode that makes designing the map much easier

  🚪You can now insert doors and windows

  📋 There are now many more templates, and you can save your own templates and use them organization-wide

  💬 You can now also add text elements

  🙂 We have significantly expanded the selection of icons
</Update>

<Update label="Sep 1, 2025">
  ## Innovative power features for your anny check-in app ✨

  With our check-in app, we have already set new standards for smooth entry this year. But we wouldn't be anny if we rested on our laurels! That's why we've added some new features to our check-in app, which we'd like to introduce to you today.

  ### 🚦New settings for check-ins and appointment bookings at the terminal

  You can choose not to link check-in, registration, and check-out to the opening hours of your resources. You can also decide whether users can check in only one or all of your organization's resources at the terminal and can specifically disable spontaneous booking for individual resources.

  ### 💳 Check-in and registration with customer pass

  Make it even easier for your loyal users! From now on, your users can check in not only with the booking QR code, but also directly with the QR code on their customer card or from the anny app.

  ### 🔒 No-Interaction Mode

  This mode is ideal for terminals without touch displays and offers additional security. When activated, interaction with the screen is completely disabled. Your users can then authenticate themselves only by scanning their QR code. This prevents unauthorized entries and ensures a clear, secure process.

  ### 😴 Sleep mode

  Reduce energy consumption and lower your operating expenses. Set fixed times when the display automatically dims—for example, at night or on weekends.

  <img alt="" />

  ### ⛔️ Out-of-order mode

  Want to temporarily close the terminal for bookings and check-ins? Manually set it to “Out of service” and leave a custom message for your users so everyone knows.

  The new features are already available for you! Take a look at the settings on your check-in displays and customize everything to your liking: [https://app.anny.co/displays?type=check-in](https://app.anny.co/displays?type=check-in)
</Update>

<Update label="Jul 9, 2025">
  ## The new Microsoft Teams app is there

  The new anny Teams app is available! In addition to a new look and feel, the Teams app now has a new user interface and an automatic login feature with your Microsoft 365 account.

  ### Automatic login

  For automatic login, the Teams app asks each user once for authorization to read out the active user. This is followed by a confirmation screen.

  **Tip:** As an admin, you can assign the authorization for all users of the organization so that this does not have to be done individually. If it is deactivated in Entra that users can independently assign an app consent, it is necessary for the new Teams app to be activated once by the administrator.

  The new update is available automatically. If you are not yet using the Teams app, you can find a short guide [here](https://docs.anny.co/en/articles/115390-how-do-i-add-the-anny-ms-teams-app).
</Update>

<Update label="Jun 21, 2025">
  ## 📤 Let your users upload documents

  Have you ever had to chase after important documents? From now on, your users can upload the necessary files directly when making a booking.

  Whether it's proof of identity, required images, or an application form, everything is stored directly and securely in the respective booking, saving you time. The advantage for you is that all the necessary documents are immediately where they belong, without the need for extra emails.

  Simply use the new “File” field in the forms. Here you also have various setting options, such as permitted file types, maximum size, and number of files to be uploaded.
</Update>

<Update label="May 21, 2025">
  ## The waiting list for your resources 📋

  Is the desired seminar already fully booked, or is your course already filled? The best dates often sell out quickly. With anny's newest feature—the **waiting list**—cancellation is no longer a hassle but rather an opportunity!

  With the new waiting list function, you enable your users to simply put themselves on a waiting list when resources are fully booked. As soon as a place becomes available again - for example, due to a cancellation - the interested parties on the waiting list are automatically notified by email. This way, no spots remain empty, and your users can look forward to one of the coveted spots.

  **Your advantages at a glance**

  * Maximum utilization: Automatically fill gaps caused by cancellations. This applies to both your paid resources and free offers.
  * Happier users: Reduce frustration when appointments are fully booked and offer your users a second chance.
  * Fully automatic: Once activated, anny takes care of everything. No manual effort for you.

  **How does this work for your users? It's very simple!**

  1. If a desired resource is fully booked at the desired time, your users will see the “Add to waiting list” button.
  2. They can register with one click.
  3. If the space becomes available again, the person will automatically receive a notification and can book the appointment directly.
</Update>

<Update label="May 17, 2025">
  ## ᝰ.ᐟ Have legal documents confirmed directly

  In addition to file uploads, you can now also have important documents such as consent forms or disclaimers confirmed directly during the booking process – via a simple checkbox or legally binding digital signature:

  1. Confirmation via checkbox: Perfect for simple consent. Your users simply tick a box to confirm that they have read and understood the document.
  2. Confirmation via digital signature: always the right choice when you need an explicit and legally binding signature. Your users can sign directly at checkout on their smartphone or computer.

  The confirmed document is automatically and securely stored in the respective booking and in the customer file. This means you always have everything in one place and at your fingertips.

  **Your advantage: less effort, more security**

  * **Efficient:** No more manual sending of documents.
  * **User-friendly:** A smooth and completely digital process for your customers in anny.
  * **Legally compliant:** Receive necessary confirmations in a verifiable and digitally documented form.

  You are welcome to check out our Help Center article: [https://docs.anny.co/en/articles/342201-confirming-legal-documents-during-booking](https://docs.anny.co/en/articles/342201-confirming-legal-documents-during-booking)
</Update>

<Update label="Apr 15, 2025">
  ## The new anny is live 🥳

  The wait is over: the new anny is here!

  We are very excited about this milestone and are looking forward to finally sharing all the new features with you. Even though some things have changed, our mission remains the same: We want to help you share and use all resources as easily and efficiently as possible - and that's exactly what we've improved even further with this update.

  We have summarized the most important questions and answers about the launch in [this help center article](https://docs.anny.co/en/articles/302455-faq-the-new-anny).

  <img alt="" />

  ### **New: Connected Persons & Book-on-behalf**

  Connected Persons allows you to connect directly with other people and assign individual authorizations:

  * **Read bookings -** View the bookings of others and thus reduce the coordination effort.
  * **Book-on-behalf -** Make bookings on behalf of other people. Perfect for teams, assistant roles, and shared resources.
  * **Edit bookings -** You can cancel the bookings of other users. This allows you to put your entire booking management in the hands of others.
  * \*\*Notify about bookings -\*\*Receive a notification as soon as a booking is made by a person connected to you. This way you can ensure that you don't miss any important changes and can react to them.

  All authorizations can be requested or released individually. To do this, a request is sent between the people (peer-to-peer) directly from the user bio or the profile settings. The connections cannot be controlled externally (e.g. by admins).

  <img alt="" />

  ### **Simplified navigation**

  We have restructured the navigation to give you a better overview of our platform so that you can find the functions you want even more easily.

  The most important changes at a glance:

  * **Navigation in the header -** The main navigation is now at the top of the header, providing a clearer structure and a better overview.
  * **Explore -** All resources from your communities can now be found centrally on the new Explore Page, whereby individual community pages and their navigation points have been removed. You can also set a filter for communities on the Explore page. You can find more information on this in the next section.
  * **Planner -** The weekly planner can be accessed as usual under the new menu item ‘Planner’. The separate favorites page is no longer available; instead, favorites can be managed directly in the planner and via the homepage (soon).
  * **Profile -** You can now access your profile settings and notifications via your avatar in the top right-hand corner.
  * **Homepage (soon) -** You can also look forward to a new homepage with a customized overview of your upcoming bookings.

    <img alt="" />

  ### **New: Explore page for a centralized overview**

  Another new feature is the Explore page - your central location for quick and easy bookings. Instead of switching between individual communities, you will now find all resources ( approved for you) bundled on one page for the first time.

  The most important facts at a glance:

  * **A central overview -** Search and filter all bookable resources from your communities.
  * **Existing community links remain** - they automatically redirect to the new Explore page. Resources can also be filtered by community here.
  * **Precise search with location & property filters -** Advanced property filters allow you to search better and faster. Locations and addresses can also be filtered in the search bar. The option to filter by individual groups has been removed.
  * **Smarter period search -** Find the right resource in no time at all, simply enter a desired duration (e.g. ‘30 minutes between 1 pm and 3 pm’) and the system will show you available slots.
  * \*\*Sharing made easy -\*\*Filter settings such as category, location, community, or properties are saved directly in the URL so that you can easily share a predefined search or call it up again later.
  * **Occupation indicator -** The new occupation indicator shows you directly which resources are available or heavily booked at which times - allowing you to better plan your bookings.

    <img alt="" />

  ### **Calendar**

  The new calendar view makes planning your booking times and resources even easier. With a clearer structure and more details, you can find free resources without any detours. The calendar is accessible via the Discover, Organization, and Resources pages.

  The most important changes at a glance:

  * **New calendar view -** you can see at a glance when which resources are free. The visual overview of availabilities allows you to quickly find a suitable time even if you don't yet know exactly when you want to book. This makes your planning flexible.
  * **Visible booking title -** See the details of the booking and the person making the booking in the calendar, provided you have the appropriate authorization. This gives you all the information you need immediately and helps you plan better.
  * **Full screen view -** The calendar can be expanded to full screen, giving you a clear overview of a larger number of resources and making it easier to navigate through the calendar.
  * **Child resources are directly visible -** On the resources page, all connected child resources are displayed in the calendar - for an improved overview of possible booking times.
  * **Interactivity (coming soon) -** Soon you will be able to make bookings interactively in the calendar.

    <img alt="" />

  ### **Resources page**

  The Resources page and the booking interface have been improved so that you can find what you're looking for even faster and make your bookings with ease.

  The most important changes at a glance:

  * **Optimized booking interface -** The selection of add-ons and the entire booking process are now even clearer.
  * **New image gallery -** See more images at a glance: Instead of one large image, 3 images are now displayed and you can view a full-screen gallery.
  * **New look for quotas -** The display of quotas has been optimized and is now more clearly structured.

    <img alt="" />

  ### **Organization page**

  The  organization page has also received an upgrade: New filter options and a revised design make your range of resources clearer and more dynamic.

  The most important new features at a glance:

  * \*\*New filter & search function -\*\*Find resources more easily - The function is similar to the new Explore page.
  * **All shared resources visible -** In addition to public resources, you can now also see all resources that you have access to via your communities.
  * **Modern design for services, subscriptions & packages -** All pages have been visually improved and are now more clearly structured for a more pleasant booking experience.
  * **Links to subscription & package pages -** Subscriptions and booking packages now have their own pages with direct links that can be redirected to ensure easy finding and quick booking.

    <img alt="" />

  ### **Shopping cart & check-out**

  The checkout and shopping cart process has been further developed so that bookings can be completed smoothly.

  The most important new features at a glance:

  * **New design & layout -** Modern and intuitive for a pleasant booking experience.
  * **Optimized booking summary**
    * \*\*Clear structure -\*\*See all bookings at a glance in a structured list.
    * **Batch view for event bookings -** Multiple bookings, e.g. for the same event, are now visually summarized as a batch for a better overview.
  * **Recommendations in the shopping cart & checkout -** During the booking process, recommendations you have set for other suitable resources now appear. Recommendations can be set via ‘additional options’ in the settings of the service/booking option.
  * \*\*Upload documents as custom field -\*\*Documents can now be uploaded directly in the checkout to save you further work steps.

    <img alt="" />

  ### **Planner**

  The week planner is now called Planner and has been comprehensively improved. It offers more intuitive navigation and more control over your bookings.

  The most important new features at a glance:

  * **Simplified onboarding & favorites management**
    * **Add or remove favorites directly in the Planner -** You don't have to open a separate page, which saves time and makes your booking process more efficient.
    * **Complete list of all accessible resources (incl. child resources) -** Select your favorites with just one click.
    * **Filter by community -** Show only your favorite resources within a selected community to book exactly what you need faster.
  * **Optimized booking creation & management**
    * \*\*No more ‘+ New Booking’ button -\*\*Bookings can now be completed in no time at all via the new Explore page.
    * **Multiple bookings possible -** Instead of booking the same resource only once a day, you can now book e.g. a meeting room several times a day in the planner.
    * **Book for other people**- If you have the authorization, you can book for someone else directly via the planner (book-on-behalf).
  * **New context menu for resources (three-dot menu)**
    * \*\*‘Book on behalf of...’ -\*\*Carry out bookings for others.
    * **‘Add/remove to favorites’ -** Quick and uncomplicated favorites management without detours.
    * **‘Show resource page’ -** Direct access to all important details.
  * **Visible booking title -** Titles are now displayed directly in the booking preview so that you can identify bookings more quickly and keep a better overview.
  * \*\*Search for members, sorted by distance -\*\*The button for searching for members has been moved to the top right of the Planner. If a filter by roles or properties is active, people are automatically sorted by distance.
  * \*\*Connect with team members (Connected Persons) -\*\*Connect with colleagues to manage bookings together and increase your visibility in the team.
  * \*\*Manage favorite resources -\*\*The new settings button at the top right of the Planner can be used to directly manage the displayed, favorite resources.

  ### **Profile page**

  Your profile gets a fresh, modern design that seamlessly adapts to the mobile app.

  The most important new features at a glance:

  * **New, modern design** - Clearer and based on the mobile app for a standardised user experience.
  * **Management of connections (Connected Persons) -** You can easily manage your connections from the new Connected Persons feature here.
</Update>

<Update label="Mar 19, 2025">
  ## Send messages to your users with the broadcasting feature 📣

  Until now, targeted communication to individual users has been difficult to implement. This changes with our new broadcasting feature.

  No matter whether you want to inform them about room changes, a course is canceled, or you want to remind them of the workplace bookings for the next week. From now on, you can communicate with your users quickly, easily, and in a targeted manner - directly from anny.

  ### What is the broadcasting feature?

  Broadcasting allows you to send messages to selected recipients. You can use various filters to determine the exact group of recipients and decide who receives the message, when, and via which channel.

  Your advantages at a glance:

  * **Targeted recipient lists:** Filter your users according to booking details (e.g. booked resource, time period) or customer data (e.g. community affiliation, birthday).
  * **Multi-channel dispatch:** Reach your users wherever they are. Choose between email, SMS and push notifications in the anny app.
  * **Personalized approach:** Use placeholders such as #firstname or #resource to make your messages more personal and relevant.
  * **Save templates:** Create a message once and use it again and again to save time.

  ### Use cases

  To show you how versatile the new feature is, we have collected a few examples for you here:

  **One-time messages for current events**

  * **Changed opening hours:** “Dear users, our coworking space will be closed on the upcoming public holiday.” Send this information to all members of your coworking community.
  * **Room closed:** “Attention: The ‘Kreativ’ meeting room is closed today for maintenance work.” Only inform users who have booked this room for today.
  * **Special events:** "Our summer party is taking place next week! Register now." Invite all your users with just one message.

  **Recurring messages that work for you automatically**

  * **Daily birthday greetings:** "Happy birthday, #firstname! We're giving you 10% off your next booking today." A small gesture with a big impact that automatically goes to the birthday children of the day.
  * **Reminder to return equipment:** “Please remember to return the #resource you borrowed.” Sends automatically to everyone whose loan is overdue.
  * **Weekly planning:** "Plan your week now! You've booked less than 3 days in the office so far." A friendly nudge to your team to plan the coming week in the office.

  ### Ready to get started

  Try out the broadcasting feature for yourself! You can find it in your anny account in the **Customers → Broadcasting** section. If you have any questions or are looking for detailed instructions, you can find all the information you need in our [Help Center article](https://docs.anny.co/en/articles/304524-broadcasting?utm_source=newsletter\&utm_medium=email\&utm_campaign=customers-eu-en-new-at-anny-send-messages-to-your-users-with-the-broadcasting-feature).
</Update>

<Update label="Mar 5, 2025">
  ## anny app 2.1.2

  We just released a new version of the anny app. This version provides, besides some bug fixes, some new improvements:

  * Manage community invitees directly inside the app
  * Tickets of the queuing system can be opened inside the anny app
  * Pay invoices later inside the app
  * Open community pages directly inside the anny app
</Update>

<Update label="Feb 28, 2025">
  ## All booking rules in one central location

  Booking rules in anny can be used to restrict how many bookings your users are allowed to make for a certain period of time. The settings for these rules were located in different places, depending on whether these rules should apply to a resource, a group or the entire organization. <br />For example, the rule that a resource may only be booked once a day by a user was defined in the resource settings.

  To ensure that you still have a perfect overview of your booking rules, you can now find all booking rules in one central place in the account settings. Here you can set the m**aximum number of bookings per user**, which **time window** is considered and whether this **rule should apply to all bookings or only to certain resources, resource groups or categories, services or service groups**.

  We have also enhanced the booking rules with useful functions to give you even more flexibility:

  **🚧 Restrict your rules to individual user groups**<br />You now also have the option of excluding individual users or entire domains from a rule, or specifying that the rule should only apply to a certain person or customer group.

  **⚠️ Individual error messages**<br />You can now also display individual error messages for your users if they want to make a booking but are not allowed to do so by a rule. This provides them with direct feedback, which saves you questions.

  **⛔️ Prevent certain users from being able to book (blacklist)**<br />You may want to exclude a certain group of users from being able to book. Whether it's customers who often don't show up for their appointments or students who have not behaved correctly. You can now exclude them from making bookings via the rules and thus keep a so-called blacklist.

  <img alt="" />
</Update>

<Update label="Feb 24, 2025">
  ## WAYFless directly with anny app

  With the latest improvements, a Login with a WAYFless-URL will be directly opened within the anny app. This allows your users to log in directly to the app and prevents unnecessary redirects.
</Update>


# 2026
Source: https://docs.anny.co/changelog/2026

Follow the updates and improvements made to the anny platform in 2026

<Update label="Aug 21, 2026">
  ## Register visitors directly in the Outlook Add-In

  <img alt="" />

  You can now register visitors directly in the Outlook Add-In, even when you are not booking a room. Matching visitor registrations are clearly marked per participant, so Visitor Management becomes faster and easier to manage where meetings are planned.

  **❓ What it does**

  * Lets you create a visitor registration for meeting participants directly in the Outlook Add-In
  * Works with or without a room booking, including participant-only visitor registration flows
  * Uses resources from the `visitor-registrations` category to control the visitor registration behavior
  * Shows a user badge icon next to participants when a matching `visitor-registrations` resource is used
  * Makes it clearer which participants are linked to a visitor registration

  This gives your team a faster way to capture external guests without switching to a separate booking flow. It also reduces setup errors because the correct visitor registration logic and visual marker are tied to the right resource setup.

  💡 **Example**

  A team member plans a meeting in Outlook and adds an external guest as a participant. Without booking a room, they select the right `visitor-registrations` resource in the Outlook Add-In, and the guest is registered immediately and clearly marked with the user badge icon.
</Update>

<Update label="Aug 20, 2026">
  ## Collect forms and documents later at check-in

  <Frame>
    <img alt="Formulare Landscape Small" />
  </Frame>

  You can now collect Custom Forms and Legal Documents later in the booking flow, not only during booking. This is especially useful for on-site scenarios where details or signatures make more sense at reception.

  **❓ What it does**

  * Lets you decide in anny Admin whether Custom Forms and Legal Documents are requested during booking or later in the flow
  * Shows missing forms, details, and signatures during Check-in when you choose the later collection point
  * Displays the same forms and documents at Check-out as well, although they are not mandatory there yet
  * Works across anny Admin, the booking flow, and the anny Check-In App
  * Requires the latest version of the anny Check-In App for this beta feature

  This reduces friction during booking while still letting you collect the information and signatures you need on site. Your team can keep compliance steps close to the actual arrival moment instead of forcing them too early.

  💡 **Example**

  A visitor books a meeting room visit without signing an NDA during booking. When they arrive, the receptionist starts Check-in and the NDA is shown there for signature, so the visit stays compliant without slowing down the booking flow.
</Update>

<Update label="Aug 19, 2026">
  ## Offer bookings directly on your WordPress site

  <Frame>
    <img alt="Word Press Landscape Small" />
  </Frame>

  The official anny bookings plugin is now live in the WordPress Plugin Directory. You can add booking experiences directly to your WordPress site, so visitors stay in your website layout instead of switching to a separate portal.

  **❓ What it does**

  * Lets you connect WordPress to anny with a login, choose the `anny.co` or `anny.eu` data region, and select your organization
  * Adds 20 Gutenberg blocks for full booking pages, calendars, maps, compact panels, buttons, My Bookings, login, and cart experiences
  * Lets you choose a Resource, Service, Subscription, or Package from a searchable list for each block
  * Shows a live preview of the real booking widget directly in the WordPress editor before you publish
  * Lets you import your brand from anny or adjust colors and shapes site-wide or per block
  * Keeps prices, opening hours, and availability managed in anny and updated on your website without republishing

  You can keep the full booking journey on your own website and reduce the need for copied HTML snippets, blocked iframes, and separate booking portals. Your team manages booking data in anny, while the WordPress pages stay current automatically.

  💡 **Example**

  A coworking space installs anny bookings, connects its organization, adds the organization booking page to a "Book a desk" page, and places a resource button on the homepage. Members complete their booking in the familiar website layout without being sent to another portal.

  Find more information here: [https://docs.anny.co/en/embed-wordpress](https://docs.anny.co/en/embed-wordpress)
</Update>

<Update label="Aug 17, 2026">
  ## Group booking bundles for a clearer catalog

  <Frame>
    <img alt="Generated Image F0cc206d 63db 402c 9abc 4528ebcd0a59" />
  </Frame>

  You can now organize booking bundles into groups in anny. This keeps large bundle and voucher catalogs easier to manage in the admin area and easier to browse on the booking page.

  **❓ What it does**

  * Lets you create booking bundle groups with a name, optional description, and display order
  * Lets you assign a bundle to a group directly in the bundle form, or create a new group from the same selection
  * Shows booking bundles in grouped panels in anny Admin, with a separate section for ungrouped bundles
  * Displays only groups with at least one live bundle in the public catalog, while ungrouped bundles stay visible in their own section
  * Keeps bundles intact if a group is deleted by moving them back to the ungrouped section

  This gives you more control over how bundles are structured and presented. Your team can manage larger catalogs more clearly, and customers can find the right offer faster.

  💡 **Example**

  A fitness studio creates groups such as "10-session passes", "Gift cards", and "Trial offers" and assigns each booking bundle to the right group. Customers then see these sections on the booking page instead of one long list, which makes the catalog easier to scan.
</Update>

<Update label="Aug 10, 2026">
  ## Discount codes redeemable once per customer

  <img alt="" />

  You can now limit discount codes to a single redemption per customer. This helps you run promotions more reliably and prevent repeated use by the same person.

  **❓ What it does**

  * Adds a new rule in the discount code setup: “Redeemable once per customer”
  * Checks at checkout whether the customer has already redeemed the code before
  * Blocks the code from being applied again if it was used previously by the same customer
  * Works for both newly created and edited discount codes

  This gives you tighter control over marketing campaigns, partner deals, and first-time offers, while keeping the checkout experience clear for customers. It reduces unintended discount leakage without changing how customers enter codes.

  💡 **Example**

  You run an “First class discount” campaign for activity bookings. A customer can use the code for their first course booking, but when they book another class later, the code won’t apply a second time.
</Update>

<Update label="Aug 10, 2026">
  ## Treatwell Sync: Email Import and Calendar Sync

  <img alt="" />

  Treatwell bookings can now flow into anny automatically via email forwarding, while anny bookings can be mirrored back to Treatwell via an ICS calendar link. This creates a reliable, near real-time bidirectional sync with a typical delay of about 30 to 60 seconds.

  **❓ What it does**

  * Imports Treatwell bookings into anny through forwarding booking emails to a dedicated anny inbox
  * Updates existing bookings when changes come in, and processes cancellations automatically
  * Prevents duplicates during repeated emails or resend scenarios
  * Matches prepaid information when Treatwell indicates prepayment
  * Handles Treatwell email layout changes more robustly via anny AI parsing
  * Exports anny bookings to Treatwell via an ICS calendar feed so availability stays aligned
  * Improves visibility and reduces manual work across anny Admin and the booking area

  Your team can manage bookings centrally in anny without constantly reconciling Treatwell manually. This reduces missed cancellations, double bookings, and time spent copying appointments between systems.

  💡 **Example**

  A salon receives a new appointment via Treatwell. The Treatwell confirmation email is automatically forwarded to the dedicated anny inbox, and anny creates or updates the booking including prepaid status. When the salon adds a walk-in or phone booking in anny, it appears in Treatwell via the ICS calendar feed, keeping both calendars aligned with only a short delay.
</Update>

<Update label="Jul 30, 2026">
  ## Edit booking form data after booking

  <img alt="" />

  Customers can now view and edit the information they submitted via Custom Booking Forms after they’ve made a booking, if you allow it for the Service. This reduces back-and-forth and saves admins time.

  **❓ What it does**

  * Adds a per-Service setting in anny Admin to allow or disallow post-booking edits of Custom Booking Form data
  * Shows submitted form answers in the booking overview in the booking area (web)
  * Enables customers to update those form answers directly from the booking overview (web)
  * mApplies to web only for now (mobile app not included in the first release)

  Fewer support requests and less manual correction work for admins, while customers can keep their booking details accurate on their own. This is especially helpful when participant details or additional information change after the initial booking.

  💡 **Example**

  Someone books a room for a workshop and later notices a wrong participant name or missing dietary info submitted in the form. Instead of contacting the admin, they open their booking overview on the web, edit the form details, and the booking stays up to date.
</Update>

<Update label="Jul 30, 2026">
  ## Flexible Price Modifiers per Resource and Child Resource

  <img alt="" />

  You can now price the same booking option or Service differently depending on the selected resource or child resource. This brings more accurate, transparent pricing without duplicating offers.

  **❓ What it does**

  * Lets you define resource-level price modifiers in the anny admin for an existing booking option or Service
  * Supports pricing on child resources (for example seats, zones, or sub-areas within a parent resource)
  * Automatically shows and calculates the correct price in the booking flow based on the selected resource or child resource
  * Keeps the core offer centrally managed while allowing granular pricing where it matters

  Teams can model real-world pricing differences (people, places, zones) within one offer, reduce admin overhead, and avoid confusing duplicates. End users see pricing that matches their exact selection, improving clarity and conversion.

  💡 **Example**

  A venue offers “Hall Booking” as one booking option, but seats in Zone A cost more than seats in Zone B. With resource and child-resource price modifiers, users pick their seat or zone and anny automatically applies the right price, while you maintain only one booking option.
</Update>

<Update label="Jul 30, 2026">
  ## Faster, Smarter anny AI Phone Assistant & Chat

  <img alt="" />

  We’ve improved the speed and response quality of the anny AI Phone Assistant and AI Chat. In many relevant cases, replies are now delivered with significantly lower waiting time and better contextual accuracy.

  **❓ What it does**

  * Reduces latency for AI responses in chat and phone by up to 50% in relevant cases
  * Improves intent detection and request classification for more accurate answers
  * Delivers more reliable, context-aware follow-ups across both channels
  * Applies to AI-powered touchpoints in the booking flow; related configuration and monitoring can also affect the anny admin area

  This makes conversations feel smoother and more dependable, cutting down on drop-offs caused by waiting and reducing the need for manual clarification by your team. Learn more in the help center article (Link will be inserted later).

  💡 **Example**

  A customer calls or writes in the chat to ask about an existing booking. Instead of waiting for a slow response or getting a vague answer, they receive a precise, helpful reply much faster, keeping the conversation moving and increasing the chance the booking gets completed.
</Update>

<Update label="Jul 23, 2026">
  ## Video Calls built into anny

  <img alt="" />

  You can now create and run video meetings directly inside anny. This reduces tool switching and eliminates the need for additional video conferencing licenses or external accounts.

  **❓ What it does**

  * Lets you create a video call for an appointment directly in anny
  * Enables starting and hosting the meeting within anny, end to end
  * Works across the key touchpoints where video meetings are managed: Admin area and booking flow
  * Removes the dependency on external video tools and separate user accounts for hosts or participants

  This streamlines the entire process from booking to meeting, especially for teams running many consultations, and helps organizations reduce costs and operational friction. For participants, it also means a simpler experience with fewer links, logins, and handoffs.

  💡 **Example**

  A university study counseling team offers consultation slots via anny. Students book their appointment in anny and then join the session as a video call directly within anny, without switching to a separate video tool.

  Find all information in the helpcenter article: [https://docs.anny.co/de/articles/754785-anny-videoanrufe](https://docs.anny.co/de/articles/754785-anny-videoanrufe)
</Update>

<Update label="Jul 23, 2026">
  ## Configure invoice language for organizations

  <img alt="" />

  You can now control which language invoices are generated in for your organization. This removes manual rework for international billing and keeps invoice PDFs consistent.

  **❓ What it does**

  * Adds a new “Invoice language” setting in anny Admin under Organization settings
  * Lets admins choose one of three options:
  * Always use the organization language
  * Always use the customer language
  * Use the organization language with an English fallback (when a translation isn’t available)
  * Applies the selected language consistently across invoice creation logic, including initial file generation and invoice locking

  This makes invoicing predictable for multilingual organizations and reduces back-and-forth and manual adjustments for admins managing international customers.

  💡 **Example**

  A German-speaking company uses anny for Room Booking and bills English-speaking customers. With “Customer language” selected, invoices are automatically generated in English for those customers, while German customers still receive German invoices, without any manual editing.
</Update>

<Update label="Jul 23, 2026">
  ## Transfer subscriptions between customers

  <img alt="" />

  Admins can now transfer an existing subscription from one customer to another within the same organization, without recreating the subscription. This helps keep customer and subscription management clean when responsibilities change.

  **❓ What it does**

  * Adds a new “Transfer” action to the subscription detail view in the anny Admin area
  * Lets admins select the target customer within the same organization
  * Enables creating a new customer or editing an existing one during the transfer flow
  * Moves the subscription to the selected customer via a regular update
  * Transfers related entitlements, including quota/contingents, subscriber assignment, and Community memberships
  * Does not automatically transfer payment method and billing email; these remain managed separately

  This removes unnecessary manual work and prevents errors that typically occur when admins have to rebuild subscriptions or rewire assignments by hand. It also ensures booking-related access and membership logic continues seamlessly under the new customer.

  💡 **Example**

  If a subscription was initially assigned to Customer A but should now be managed and used by Customer B within the same organization, an admin can transfer it in the subscription details. Quotas, subscriber assignment, and Community memberships move with it, so Customer B can continue booking right away.
</Update>

<Update label="Jul 23, 2026">
  ## Start and End Time Filters for Bookings

  <img alt="" />

  You can now narrow booking lists by a specific time window, not just by date or other attributes. This makes it much faster to review and evaluate only the bookings that matter for a given operational timeframe.

  **❓ What it does**

  * Adds support for filtering bookings by `start_time` and `end_time` in booking lists
  * Applies in the anny Admin area and booking area, especially within booking management views
  * Improves the underlying filter logic (and related API mechanisms) so time-based filtering is consistent across lists and integrations
  * Enables more precise operational checks, reporting, and reviews when only a subset of a day is relevant

  Admins and operational teams can find relevant bookings faster, reduce manual scanning, and run more accurate checks and evaluations for time-critical workflows. More details are available in the help center article (link to be added).

  💡 **Example**

  An office management team needs to review all room bookings for a specific day between 09:00 and 12:00. With `start_time` and `end_time`, they filter the booking list to that window and immediately see only the relevant bookings instead of searching through the entire day.

  More information can be found in the helpcenter article: [https://docs.anny.co/de/articles/454923-adminbenachrichtigungen-in-anny](https://docs.anny.co/de/articles/454923-adminbenachrichtigungen-in-anny)
</Update>

<Update label="Jul 23, 2026">
  ## Glutz eAccess Integration for automatic PIN access

  <img alt="" />

  With the new Glutz eAccess integration, anny can automatically create and manage time-limited door access for room bookings. This eliminates manual access administration and ensures bookers get the right access at the right time.

  **❓ What it does**

  * Connects anny to your Glutz eAccess server via server address, username, and password in the anny Admin area
  * Lets admins create rules that map anny resources to one or more Glutz access points (doors)
  * Supports configurable buffer times (before and after the booking) per rule
  * Optionally enables remote opening (if configured)
  * Automatically creates a separate access for each booking in Glutz with a unique 8-digit PIN code
  * Updates the access time window automatically when a booking time changes
  * Removes the access and PIN automatically when a booking is canceled or deleted
  * Stores no personal data in Glutz, only a booking reference for traceability

  This reduces operational workload for operators and makes access more reliable and secure for customers and employees. The result is fewer access mistakes, less back-and-forth, and smoother arrivals.

  💡 **Example**

  A user books a meeting room in anny from 10:00 to 11:00. anny automatically generates an 8-digit PIN that works only for the correct door and only from 09:50 to 11:10 (including buffers), then deletes the access if the booking is canceled.
</Update>

<Update label="Jul 6, 2026">
  ## Recurring bookings 2.0: series preview and accurate billing

  <img alt="" />

  Recurring bookings are now represented as a clear series with an anchor booking and individual follow-up appointments, including a richer per-appointment preview and rules for availability and billing. This makes it easier for admins and customers to understand what gets copied, checked, and charged for every occurrence.

  **❓ What it does**

  * Models recurring bookings as a series with one anchor booking plus individual occurrences
  * Supports both predefined fixed date series and customer-configured recurrence rules
  * Lets customers define frequency, interval, weekdays or monthly patterns, duration, and an end condition (end date or unlimited)
  * Applies payment logic: unlimited series are only possible with pay-later; end date is required for immediate or prepaid bookings
  * Checks availability for every single occurrence before booking and shows a per-date preview (including a summary like “12 of 15 available”)
  * Books available occurrences even if some dates are unavailable; unavailable dates are skipped
  * Carries the full booking content per occurrence: resource, time range, customer, pricing, add-ons, additional resources, quota consumption, discounts and price adjustments
  * Copies notes, description, and customer instructions from the anchor booking to the occurrences
  * Supports managing existing series: edit after creation, extend automatically, cancel partially or fully
  * Handles billing per offer: either one combined invoice for the series or per-appointment billing (only the next occurrence is charged)

  Admins and customers get predictable recurring bookings with fewer surprises: every occurrence is validated, the right add-ons and resources carry over, quotas are consumed correctly, and pricing and billing follow the offer’s rules. Customer Success can also explain recurring behavior more consistently because the series logic is now fully visible.

  💡 **Example**

  A customer books a room every second Tuesday until December 31. anny creates the series automatically, checks each Tuesday for availability, skips dates that are blocked, and still books the available ones. Add-ons (like equipment) and extra resources are applied to each booked date, and billing happens either once for all appointments or step-by-step per appointment, depending on the offer.

  More information can be found in the helpcenter article: [https://docs.anny.co/de/articles/108497-wiederkehrende-buchungen](https://docs.anny.co/de/articles/108497-wiederkehrende-buchungen)
</Update>

<Update label="Jun 25, 2026">
  ## Shipping options and fees for packages and value vouchers

  <img alt="" />

  You can now sell booking packages and value vouchers with proper physical shipping support, including configurable shipping modes, shipping fees, and an operational shipping status in the admin. This makes postal delivery easy to offer, charge correctly, and track end to end.

  **❓ What it does**

  * Adds a shipping mode setting per booking package and per value voucher: disabled, optional, always
  * Lets you set a shipping fee amount per package/voucher that is charged in addition to the voucher/package value
  * Adds an optional shipping selection in checkout when shipping mode is set to optional
  * Automatically includes the configured shipping fee in the checkout total when shipping is selected (or required)
  * Provides visibility in the anny admin so teams can see which purchases require shipping
  * Enables marking an item as shipped to support operational fulfillment and tracking

  This update removes manual workarounds for physical delivery and ensures the total price is always calculated correctly. It also gives your team a clear process to handle outgoing mail without losing track.

  💡 **Example**

  A customer buys a 100€ value voucher and selects postal delivery in checkout (optional shipping). anny adds the configured 2,90€ shipping fee to the total, and your team can later mark the voucher as shipped in the admin once the letter is sent.
</Update>

<Update label="Jun 18, 2026">
  ## Subscribe without an account

  <img alt="" />

  You can now let customers complete subscriptions without logging in first. This reduces friction in the subscription checkout and helps convert new customers faster.

  **❓ What it does**

  * Adds a per-plan setting in the anny admin area to decide whether login is required before subscription purchase
  * Enables a guest subscription checkout flow where customers enter the required details directly in the checkout
  * Supports completing the payment setup without a pre-existing account
  * Updates the success page to guide customers to register after purchase
  * Introduces a post-purchase registration and claim process so the subscription can be assigned to an account and managed later

  By allowing guest checkout for subscriptions, you remove a major barrier for first-time customers while still keeping full control per plan. Teams can keep login required where needed and open it up where speed matters most.

  💡 **Example**

  A new coworking prospect buys a monthly desk sharing subscription as a guest in your shop, completes payment immediately, and only registers afterward to claim the subscription and manage it going forward.
</Update>

<Update label="Jun 18, 2026">
  ## Start subscriptions in the future

  <img alt="" />

  You can now let customers choose a future start date when purchasing a subscription. This makes subscription checkouts more flexible and easier to plan ahead.

  **❓ What it does**

  * Adds a per-plan setting in the anny admin area to allow or disallow future subscription start dates
  * If enabled, customers can select a start date in the future during subscription checkout
  * If disabled, the existing behavior remains: subscriptions start immediately after purchase
  * Ensures the selected start date is clearly selectable in checkout and is correctly applied when the subscription is created so access starts on the planned date

  Teams can offer subscriptions that match real-world timelines like move-ins, project starts, or month-to-month planning, without forcing customers to start and pay for access earlier than needed. This reduces friction at checkout and increases booking confidence. Learn more in the help center article: \[Link will be inserted later].

  💡 **Example**

  A desk sharing customer books a subscription today, selects “start on July 1”, and completes the purchase now. The subscription is created with the chosen start date, so usage begins exactly on July 1 instead of immediately.
</Update>

<Update label="Jun 18, 2026">
  ## AI-Powered Cancellation Reasons Analytics

  <img alt="" />

  You can now capture cancellation reasons in the Shop and automatically categorize them with AI, so your team finally sees why subscriptions are being canceled. The results are available directly in an overview dashboard and in the cancellation list and detail view.

  **❓ What it does**

  * Adds a free-text field for customers to state their cancellation reason during the cancellation flow in the Shop
  * Automatically assigns the free-text reason to an AI category (e.g., “Too expensive”, “Missing features”, “No longer needed”)
  * Shows the distribution of categories in a dashboard pie chart for fast insight
  * Displays the category in the cancellations list for quick scanning
  * Shows the full original cancellation reason in the cancellation detail view for context

  This turns cancellations into structured feedback you can act on, helping you spot trends earlier and prioritize improvements across pricing, communication, and product scope. It also reduces manual tagging and keeps your analysis consistent over time.

  💡 **Example**

  If the dashboard shows a growing share of cancellations categorized as “Too expensive”, your team can review pricing and packaging and adjust onboarding or value communication before churn increases further.
</Update>

<Update label="Jun 18, 2026">
  ## Apple Pay and Google Pay in embedded anny Widget

  <img alt="" />

  Apple Pay and Google Pay are now available directly inside an embedded anny widget on your own website. This creates a faster checkout experience and helps reduce drop-offs during payment.

  **❓ What it does**

  * Enables Apple Pay and Google Pay inside embedded anny widgets (no redirect or interruption in the flow).
  * Adds a new required setting in anny Admin: save your website domain in Organization settings under General information.
  * Uses dynamic domain verification so the saved domain is automatically enabled by anny.
  * Works for bookings, packages, and subscriptions, including use cases like room booking checkouts in the widget.

  With a smoother, familiar payment step, customers can complete purchases faster, which can improve conversion especially for organizations that rely on embedded widgets. Learn more in the Help Center article (Link will be inserted later).

  💡 **Example**

  A user books a meeting room via the embedded anny widget on your company website and pays immediately with Apple Pay or Google Pay, completing the checkout in seconds without leaving the widget.
</Update>

<Update label="Jun 18, 2026">
  ## License plate field and COMYDO barriers for parking bookings

  <img alt="" />

  We’ve added a dedicated license plate form field with proper validation and extended our COMYDO barrier logic for smoother, automated parking access. This enables reliable plate-based entry and optional automated check-out on exit.

  **❓ What it does**

  * Adds a new custom form field type: “License plate” with input validation tailored for license plate entries
  * Makes the license plate available in the booking flow for parking resources
  * Passes the captured license plate into the COMYDO integration
  * Automatically opens the barrier when COMYDO recognizes a matching license plate on entry
  * Optionally triggers an automatic booking check-out on exit to capture actual usage time

  This removes manual friction at the gate and makes automated access flows dependable, while also improving reporting accuracy when you want to track real parking duration.

  💡 **Example**

  An employee books a parking spot in advance and enters their license plate during checkout. On arrival, the COMYDO barrier recognizes the plate and opens automatically. When leaving, an optional auto check-out is triggered so the booking reflects the real parking time.
</Update>

<Update label="Jun 12, 2026">
  ## Custom Withdrawal Period for Subscription Plans

  <img alt="" />

  You can now configure a withdrawal period for subscription plans to properly support B2C cancellation rights in online subscriptions. Customers get a clear choice between an immediate withdrawal and a cancellation at the end of the current term, including automatic pro rata refunds when applicable.

  **❓ What it does**

  * Adds a new “Withdrawal period” setting to subscription plans in the anny admin area (configurable per plan).
  * Updates the customer cancellation dialog in the booking area when a withdrawal period is active.
  * If a customer cancels within the configured withdrawal period, they can choose between:
  * Immediate withdrawal (with automatic pro rata refund for the unused portion), or
  * Cancellation at the end of the current term.
  * Allows customers to schedule a cancellation several months in advance.

  This closes an important gap for B2C subscriptions by making withdrawal rights transparent, reducing support effort, and ensuring refunds are handled correctly and consistently. It also gives customers more control by allowing future-dated cancellations. For more details, see the help center article: \[Link will be inserted].

  💡 **Example**

  A private customer books a monthly coworking desk-sharing subscription online. Within the withdrawal period, they open the cancellation dialog and choose “Immediate withdrawal”. anny automatically refunds the unused part of the month, while the subscription ends right away.
</Update>

<Update label="Jun 8, 2026">
  ## Automatic EVVA AirKey Access for Bookings

  <img alt="" />

  You can now connect EVVA AirKey with anny to automatically provide digital access for booked resources. Access is created just in time before the booking so EVVA AirKey constraints are always respected.

  **❓ What it does**

  * Adds EVVA AirKey as a new smart lock integration in anny
  * Automatically creates a digital access right for a booking shortly before the booking starts (just in time)
  * Ensures compliance with EVVA AirKey’s limitation that only one active access can exist per lock at a time
  * Matches the booking person to EVVA access via phone number
  * Triggers EVVA to send setup instructions 30 minutes before the booking start via email and SMS
  * Supports app-based access only (no PIN access)

  This removes manual door handovers and last-minute coordination for EVVA-secured spaces, while keeping access creation safe and conflict-free for each lock.

  💡 **Example**

  A visitor books a locked meeting room secured with EVVA AirKey in anny. 30 minutes before the booking starts, EVVA automatically sends an email and SMS so the visitor can set up access in the EVVA app and open the room right on time, without any admin involvement.
</Update>

<Update label="May 28, 2026">
  ## External links for communities on the anny Home Site

  <img alt="" />

  Community members can now access important external destinations directly from their Community home in anny. Community admins can maintain up to three links per Community, so members find the right place faster without searching.

  **❓ What it does**

  * Adds a new admin option to store up to three external links per Community in the anny Adminbereich (Web)
  * Each link includes a label (name), a URL, and an icon
  * Displays these links on the Community home page in the Buchungsbereich (Web) for members
  * Members can click and open the external destinations instantly
  * Web only for now

  This reduces friction for members and makes Community communication more effective, because the most relevant external resources are always one click away on the Community start page.

  💡 **Example**

  A company runs a Community for its members and adds links to the customer portal, a profile page, and a “More information” page. Members open these destinations directly from the Community home instead of having to search or ask for the right URL.
</Update>

<Update label="May 28, 2026">
  ## Daily Role Quotas Dashboard Widget

  <img alt="" />

  You can now track daily booking counts by role directly in the anny admin Dashboard and instantly see whether defined role quotas are met. This makes it easier to validate staffing and safety requirements at a glance.

  **❓ What it does**

  * Adds a new Dashboard widget that evaluates bookings per day by a selected role (for example, First Aider)
  * Visualizes target vs actual for a defined quota so you can quickly spot if the quota is met or undercut
  * Helps admins and responsible teams monitor day-by-day presence based on real bookings and assigned roles

  With this widget, compliance checks that used to require manual digging are now visible immediately, so teams can react earlier when coverage is at risk. Especially for safety-critical roles, it reduces uncertainty and speeds up operational decisions.

  💡 **Example**

  In a desk sharing setup, you define a quota of 2 First Aiders per day. On Tuesday, the widget shows only 1 booking by a First Aider, so you can proactively arrange coverage before people arrive.
</Update>

<Update label="May 28, 2026">
  ## Apple Pay and Google Pay for subscriptions

  <img alt="" />

  You can now pay for subscription products with Apple Pay and Google Pay, in addition to SEPA and credit card. This makes checkout on mobile faster and reduces friction for new and returning customers.

  **❓ What it does**

  * Adds Apple Pay and Google Pay as payment options for subscription products in the booking checkout
  * Keeps SEPA and credit card available as before, with a clear selection flow for subscriptions
  * Supports recurring subscription payments with the new payment methods
  * Applies across anny Booking area and anny Admin where subscription payment method selection and processing is reflected

  Customers can complete subscription checkout in seconds, especially on mobile, which helps reduce drop-offs and increases successful subscription sign-ups. More details are available in the help center (link to be inserted).

  💡 **Example**

  A customer buys a room-booking subscription on their phone, selects Apple Pay, and confirms with Face ID. Instead of typing card details, they finish instantly, making an abandoned checkout far less likely.
</Update>

<Update label="May 28, 2026">
  ## Revenue by Product in Dashboard and PDF

  <img alt="" />

  You can now break down revenue by product category directly in the dashboard and in the revenue overview PDF export. This makes it easier to understand which product types drive revenue and what online transaction fees are associated with them.

  **❓What it does**

  * Adds a dashboard widget that shows revenue by product category (e.g., Resource, Service, Subscription Plan, Add-On, Booking Package).
  * Displays the related online transaction fees per product or product group in the dashboard, so you can compare revenue and fees side by side.
  * Extends the revenue overview PDF export with a revenue breakdown per product category for reporting and sharing.

  This update helps Finance, Operations, and Management teams quickly assess product performance and fee impact without manual spreadsheets. It also improves comparability across modules, especially when multiple product types contribute to the same monthly revenue.

  💡 **Example**

  At month end, an admin opens the dashboard and instantly sees how much revenue came from Resources vs. Services vs. Subscription Plans, plus the online transaction fees tied to each category, and exports the same breakdown as a PDF for internal reporting.
</Update>

<Update label="May 18, 2026">
  ## Company Profiles for Business Customers

  <img alt="" />

  You can now manage companies as first-class records in anny instead of storing company names as plain text on individual customers. This creates a clean structure for shared company data, members, and future invoicing workflows.

  **❓ What it does**

  * Creates dedicated company records that customers can be assigned to
  * Stores central company data in one place, including company name, domain, billing address, and VAT ID
  * Shows a consistent company context across customer management and profile data
  * Lets registered anny customers manage their company data and members themselves
  * Optionally enables “different business address” capture in checkout flows for Subscription Plans, Services, and Booking Packages (when the corresponding form setting is activated)
  * Supports automatic member assignment based on company name and the domain of the business email address (if enabled)

  Admins get a reliable, reportable company structure instead of fragmented free-text entries, and business customers benefit from centralized member and billing data management. It also lays the groundwork for upcoming improvements such as consolidated invoices.

  💡 **Example**

  A company has 12 employees using anny. With Company Profiles, all employees are linked to the same company record, so the billing address and VAT ID are maintained once and stay consistent across bookings and subscriptions, making future consolidated invoicing much easier to prepare.

  More information can be found in the helpcenter aritcle: [https://docs.anny.co/en/articles/679185-company-profiles-for-business-customers](https://docs.anny.co/en/articles/679185-company-profiles-for-business-customers)
</Update>

<Update label="May 18, 2026">
  ## Collect a Separate Shipping Address

  <img alt="" />

  You can now ask bookers for a separate shipping address when delivery does not match their default address. This makes bookings for physical shipments and postal services more accurate and flexible.

  **❓ What it does**

  * Lets you enable an optional “shipping/delivery address” field set per subscription plan, Service, or booking package
  * Shows an additional address section in the booking form only when the option is turned on
  * Keeps the booking form unchanged when the option is turned off
  * Supports common delivery scenarios like equipment shipping or mailbox rentals where delivery address and regular address differ

  This reduces back-and-forth and prevents misdeliveries by capturing the correct address at the moment of booking. Teams can ship faster with fewer manual clarifications.

  💡 **Example**

  An employee books home office hardware via anny using the company address as their standard address, but enters their private address as the shipping address so the package arrives at home.
</Update>

<Update label="May 18, 2026">
  ## Customer balances and consolidated invoices for B2B bookings

  <img alt="" />

  You can now collect multiple B2B bookings and subscriptions on a customer balance and invoice them later as one consolidated invoice. This reduces manual billing work and keeps accounting clean when customers book repeatedly within a billing period.

  **❓ What it does**

  * Adds new Admin settings under “Invoicing” to enable customer balances and define how consolidated billing works (billing period, invoicing delay after period end, grouping by company, limits and thresholds).
  * Lets Admins add a booking to a customer balance (“Add to customer balance”) and keep it as a draft invoice until consolidation.
  * Shows eligible customers in checkout an option to book on customer balance instead of paying immediately (only if Service payment is enabled and permission criteria match Admin settings).
  * Links each booking’s draft invoice to the balance month of the booking date (not the checkout date), while keeping draft invoices individually visible for traceability.
  * Updates the draft invoice and balance automatically when bookings change, without triggering immediate payment.
  * Consolidates all connected draft invoices at the balance due date into one posted invoice; all drafts remain visible and are linked to the final invoice.
  * Adds a “Home” widget for customers that shows an overview of open balances.
  * Automatically charges consolidated balance invoices via the stored payment method if the customer has a subscription with a saved payment method.

  Finance and operations teams spend less time reconciling dozens of individual invoices, while B2B customers get a single invoice per period that’s easier to approve and pay. At the same time, detailed draft invoices remain available for internal review and auditability.

  💡 **Example**

  A company books desks and meeting rooms throughout May. Instead of receiving a separate invoice for each booking, all eligible bookings are added to the May customer balance as draft invoices. On the defined cutoff date, anny consolidates them into one posted invoice, and the company pays just that one invoice.
</Update>

<Update label="May 8, 2026">
  ## purpleview integration for online appointments

  <img alt="" />

  You can now connect purpleview to resources in anny to automatically create a meeting link for each booking. This makes it easy to offer official appointments as secure online meetings.

  **❓ What it does**

  * When a resource is linked to purpleview, anny automatically generates a unique meeting URL for every relevant booking
  * The meeting URL is available for customers so they can join the online meeting at the time of their appointment
  * Works seamlessly for appointment-based services, especially in public administration contexts (e.g. citizen services)

  Teams in cities and municipalities can offer digital appointments without manual link creation and without extra coordination steps. Citizens get a smooth experience: book, receive the link, join on time.

  💡 **Example**

  A Bürgeramt offers online appointments for driver’s license renewals. A citizen books a slot in anny and receives an automatically generated purpleview meeting URL, so they can join the appointment from home instead of coming on-site.
</Update>

<Update label="May 8, 2026">
  ## Website Widgets v2: More components, buttons, and cart

  <img alt="" />

  Website Widgets v2 gives you far more control over what you embed on your own website, without changing any existing widgets. Choose from new embed components, modal buttons, and a cart button that stays in sync across your pages.

  **What it does**

  * Adds new embed components you can place directly on your website:

  → Organization Calendar and Organization Map (calendar or map view across all resources in an organization)

  → Resource Booking Panel (compact booking flow without header or navigation)

  → Resource Calendar and Resource Map (calendar or map view for a single resource)

  → Subscription Page (plans, signup, and checkout embedded)

  → Package Page (vouchers and multi-passes with purchase flow embedded)

  → My Bookings (booking overview for logged-in users)

  → Login Button (central login entry point for all components)

  * Adds new modal button components (open as dialog, drawer, or fullscreen overlay):

  → Resource Button, Service Button, Organization Button, Subscription Button, Package Button

  → Supports custom button text or a fully custom HTML element as the trigger

  * Adds a Cart Button:

  → Cart icon with a live badge showing item count

  → Opens checkout in an overlay

  → Automatically syncs with booking panels on the same page

  * Introduces relative date parameters for start and end dates (e.g., “today”, “next\_week”, “this\_month”)
  * Moves theming to the admin configurator so colors, backgrounds, and spacing are managed centrally and applied automatically
  * Adds layout controls:

  → Fullscreen mode (100% height) via fullscreen

  → Fixed height options (e.g., 600px or 80vh), making the widget scroll instead of auto-growing

  → Default remains auto-resize to content height

  * Adds display options:

  → Organization components can start as list, grid, or calendar

  → Custom logo for the loading animation

  → Preselection for services, categories, and content tabs

  → Ability to hide filter bar and map independently on the organization page

  You can now embed exactly the booking experience you want, where you want it, and keep your website design fully in your control. It also unlocks website-native sales flows for subscriptions and packages, plus a smoother multi-slot checkout with a dedicated cart button.

  **Example**

  A coworking space embeds the Resource Booking Panel directly on each custom room detail page to show only the booking form, without any extra header or navigation. They place the Cart Button in the site navigation, so guests can add multiple rooms or time slots and then check out together, without ever leaving the website.

  Additional information can be found in the Help Center article: [https://docs.anny.co/en/articles/1606-embed-the-anny-booking-page-on-your-own-website-in-your-design](https://docs.anny.co/en/articles/1606-embed-the-anny-booking-page-on-your-own-website-in-your-design)
</Update>

<Update label="May 5, 2026">
  ## New Board and Month Views in the Booking Calendar

  <img alt="" />

  We’ve upgraded the calendar on organization booking pages and the Discover page with new viewing options and clearer scheduling behavior. This makes it much easier to stay on top of busy schedules, especially when many resources are shown at once.

  **❓ What it does**

  * Adds a Board view that lists all bookings/appointments chronologically, without a time axis
  * Shows every booking as a full-size card, independent of duration, ideal for course and event overviews
  * Adds a Month view for quick, high-level planning
  * Improves Week view: bookings with a duration of 7+ hours are now displayed as all-day items at the top of the calendar
  * Limits parallel display to max. 2 simultaneous bookings, with additional overlaps accessible via a “+X” indicator
  * Supports displaying up to 30 resources at once
  * Lets users filter and adjust the calendar view, with filters saved per user for the next visit

  These improvements reduce visual clutter and make it easier to spot availability and conflicts at a glance, even in complex setups with many resources. For course providers, the Board view creates a clean, scannable program overview that’s easy to share.

  💡 **Example**

  A yoga studio uses the Board view as a course calendar overview, then embeds it on its own website so visitors can scroll through upcoming classes in order, without struggling with a packed time grid.

  More information are provided in the Help Center article: [https://docs.anny.co/en/articles/7603-the-layout-of-your-booking-page](https://docs.anny.co/en/articles/7603-the-layout-of-your-booking-page)
</Update>

<Update label="May 4, 2026">
  ## Regpit integration for automated identity verification

  <img alt="" />

  With the new Regpit integration, you can automate KYC and AML checks for subscription requests that fall under the German Anti Money Laundering Act (GWG). Identity verification and risk assessment now happen seamlessly during the subscription request flow.

  **❓ What it does**

  * Creates a Regpit case automatically as soon as a customer requests a relevant subscription plan in anny
  * Notifies the customer from anny that identity verification is required and routes them to Regpit
  * Collects additional customer and business details in Regpit and supports verification methods like video identification
  * Confirms the subscription request in anny once Regpit has all required data and the overall risk is below your defined threshold
  * Declines or prevents confirmation if the overall risk is too high
  * Adds a new verification status component on the customer page and the subscription page so admins can see the current verification state at a glance

  This reduces manual compliance work, keeps your subscription process GWG compliant, and speeds up approvals for low risk customers. It also makes outcomes transparent for your team, directly where you manage customers and subscriptions in anny.

  💡 **Example**

  A company rents business mailboxes via anny. When Max Mustermann requests a mailbox subscription, anny automatically creates a Regpit case and asks him to complete verification. If Regpit confirms his identity and the risk score is below the threshold, the subscription request is confirmed automatically, otherwise it is not confirmed.

  All details in the Help Center article: [https://docs.anny.co/de/articles/661546-regpit-integration](https://docs.anny.co/de/articles/661546-regpit-integration)
</Update>

<Update label="Apr 13, 2026">
  ## Refunds as Store Credit Vouchers

  <img alt="" />

  You can now refund cancelled, online-paid bookings as a voucher instead of sending money back. This keeps revenue in your business and makes rebooking frictionless for customers.

  **❓ What it does**

  * Lets admins choose “refund as voucher” via a dropdown when finalizing a cancellation invoice (only if the original invoice was paid online).
  * Adds a setting in Admin Service settings > Cancellation to define which voucher type is used for “Cancel as voucher”.
  * Supports multiple voucher types with different applicability restrictions, so you can map the right voucher to the right Service.
  * Shows customers in the cancellation details on the booking page that the refund will be issued as a voucher.

  You reduce payment back-and-forth and help customers rebook faster, because their refund turns into immediate credit for a new booking instead of a bank transaction.

  💡 **Example**

  A customer cancels a course they paid online. Instead of refunding the money, you finalize the cancellation invoice as a voucher, and the customer receives store credit they can use to book a new course right away.
</Update>

<Update label="Mar 30, 2026">
  ## Self-serve booking rescheduling

  <img alt="" />

  Your customers can now reschedule their own bookings, including changing the date and the assigned child resource, when you enable it in settings. Any resulting price differences are handled automatically, including additional charges and refunds.

  **❓What it does**

  * Lets admins enable or disable end-user booking edits (default: disabled)
  * Adds an editable deadline (change window) that defines how short-notice a change can be made
  * Allows admins to decide whether child resources can be changed (e.g., switching desks within the same room/area)
  * Shows an edit option in “My bookings” for end users when enabled
  * Supports rescheduling beyond add-ons and additional bookings: end users can now also adjust date/time and child resource
  * Automatically calculates and applies price changes (refund or additional payment)
  * Respects lead times for Add-Ons and Service
  * Enforces the earliest possible new date based on: earliest new date = MIN(old date, today + lead time)

  This reduces support effort for admins and removes friction for customers who need to adjust plans, which can significantly reduce cancellations and no-shows. It also keeps revenue and billing correct without manual intervention through automated recalculation and payment handling.

  💡 **Example**

  Someone has booked a desk for next week but would prefer to sit in a different area. Instead of canceling and rebooking, they simply switch seats.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/617455-editing-bookings](https://docs.anny.co/en/articles/617455-editing-bookings)
</Update>

<Update label="Mar 30, 2026">
  ## Open-Amount Gift Vouchers

  <img alt="" />

  You can now offer gift vouchers with an open amount, so customers choose the value that fits their needs. Admins can switch between booking packages and multi-purpose gift vouchers depending on how vouchers should affect pricing, tax, and checkout.

  **❓ What it does**

  * Adds a new admin setting to select the voucher mode in Booking packages > Edit package
  * Supports two modes:

  A) Booking package (purpose-bound): Includes defined contingents (for example credits for specific bookings/resources). VAT is shown at purchase, and redeeming reduces the booking price. Packages can also be used as purpose-bound vouchers.

  B) Gift voucher (multi-purpose): Can be offered with a fixed or open amount. You can set a minimum amount and a default value. VAT is shown as 0% at voucher purchase, and redemption is applied as a (partial) payment, so the booking VAT is shown correctly.

  * On the organization page under Packages, customers can select a voucher/package
  * If the amount is open, customers can pick from suggestions or enter their own value

  This makes vouchers significantly more flexible and increases conversion, because customers can match the voucher to their budget while you keep the correct tax handling for your business model. It also reduces support requests caused by “wrong voucher value” purchases.

  💡 **Example**

  A massage studio offers a “Gift voucher (open amount)” with a minimum of 25€ and a default of 50€. A customer wants to gift exactly 70€, enters 70€ at purchase, and later redeems it as partial payment for a 79€ massage.
</Update>

<Update label="Mar 30, 2026">
  ## Smart Availability Groups for Complex Resource Dependencies

  <img alt="" />

  Smart Availability Groups let you bundle resources into groups and ensure each booking reserves at least one available resource per group. This makes complex setups like “two staff + one room” bookable without manual coordination.

  **❓ What it does**

  * Create resource groups under Service > Booking options > Resources > Dependencies and assign multiple resources to each group.
  * During availability checks, anny ensures that at least one resource from each group is available for the selected time slot.
  * At booking time, anny automatically reserves exactly what’s needed: one resource per group, plus any connected resources, without double-booking the same resource.
  * A single resource can be used as a connected resource and also be referenced again inside a Smart Availability Group.
  * Limitation: using the same resource across more than two groups at the same time is not supported.
  * Important: if an admin creates a booking with “Check availability” disabled, dependent resources are not booked, because they would restrict availability.

  You can offer services that require multiple parallel resources and keep scheduling reliable, even with many possible combinations. This reduces back-and-forth, avoids conflicts, and makes more complex services sellable online.

  💡 **Example**

  For a couples massage, you connect all qualified employees to the Service, then create two Smart Availability Groups: one group for the second employee (with the same qualified team) and one group for eligible rooms. When a customer books, anny ensures two different employees and one room are available at the same time and automatically reserves them via sub-bookings. Learn more in our Help Center: \[Link will be inserted].

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/36096-smart-availability](https://docs.anny.co/en/articles/36096-smart-availability)
</Update>

<Update label="Mar 30, 2026">
  ## Exclusive Slots per Order

  <img alt="" />

  We’ve added an option to make multi-capacity slots exclusive to a single order. Once a slot is partially booked, it will be treated as unavailable for any other customer’s order, while admins can still see the remaining capacity.

  **❓ What it does**

  * Adds an admin toggle in resource availability for resources with multiple availability (and for child resources that have multiple availability).
  * When enabled, a slot becomes “exclusive” as soon as the first booking is made in that slot.
  * Prevents other customers from booking the remaining capacity in that same slot via separate orders.
  * Keeps capacity transparency for admins: you can still see the real utilization (e.g., 2 of 4 spots used).
  * Ensures groups are not mixed within the same slot even when the resource technically has remaining capacity.

  This helps providers offer group-exclusive experiences without manual blocking or complicated workarounds. It reduces operational friction and avoids customer frustration caused by mixed groups in shared time slots.

  💡 **Example**

  You run axe throwing with lanes that fit up to 4 people. With Exclusive Slots enabled, if one customer books 2 people for the 6:00 PM lane, the 6:00 PM lane will be shown as booked out for everyone else, while you still see internally that 2/4 spots are used.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/618707-exclusive-time-slots](https://docs.anny.co/en/articles/618707-exclusive-time-slots)
</Update>

<Update label="Mar 30, 2026">
  ## Min and Max Quantity per Booking Option

  <img alt="" />

  You can now define minimum and maximum quantities for each booking option. This ensures multi-bookings match your real pricing and capacity rules before customers can proceed.

  **❓ What it does**

  * Lets you set a minimum and a maximum quantity per Service/booking option in the advanced settings
  * Applies the limits directly when a customer adds a booking
  * Prevents checkouts that don’t meet your defined minimum (and blocks quantities above your maximum)
  * Works especially well for services where multiple units are booked in one go, like tickets, seats, or participants

  This helps you enforce group rules automatically, reduce manual back-and-forth, and keep bookings aligned with how you sell and staff your offering. For customers, it makes the booking flow clearer because valid quantities are guided from the start.

  💡 **Example**

  You offer a group tour that can only be booked for 6 to 20 people. With min/max quantities set on the booking option, a customer can’t complete the booking with 1 person and is guided to book at least 6 participants instead.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/622089-define-minimum-and-maximum-selection-per-order](https://docs.anny.co/en/articles/622089-define-minimum-and-maximum-selection-per-order)
</Update>

<Update label="Mar 30, 2026">
  ## Urban Sports Club Integration

  <img alt="" />

  You can now connect anny with Urban Sports Club (USC) to sync your classes and keep bookings and capacities aligned in real time across channels. This helps studios expand reach via USC without risking overbookings or losing control of inventory.

  **❓What it does**

  * Lets you select which anny courses are exported to USC (based on the course planner model).
  * Automatically transfers all sessions for the next 3 weeks and keeps them synchronized.
  * Makes only sessions within the next 2 weeks bookable for USC users.
  * Supports trainer and room recognition by mapping resource categories for trainers and linking rooms 1:1 to USC locations.
  * Allows setting a default trainer and default room if you do not want to define them on every session.
  * Prevents moving sessions after they have been exported to USC (USC does not allow rescheduling). Exported sessions can only be canceled.
  * Cancels the session in USC when you cancel it in anny, including all USC bookings.
  * Validates USC bookings in real time in anny to prevent double bookings and overbooking.
  * Updates capacity in USC in real time when bookings come in via anny or other channels.
  * Marks USC bookings in anny via a dedicated booking option “Urban Sports Club” (not editable).
  * Optionally lets you store a USC settlement price to track revenue from USC bookings.
  * Imports USC check-ins into anny so attendance is visible in your operations.
  * Anonymizes canceled USC bookings and USC no-shows in anny according to USC requirements.
  * Imports USC no-shows one day after the session ends, since USC provides them on the following day.
  * Offers optional capacity controls: reserve a contingent of seats for direct bookings (anny and other channels) and automatically release remaining reserved seats to USC at a defined time (for example 24 hours before start).

  You can grow distribution through USC while keeping your schedule, capacities, and attendance in sync, even when you sell the same sessions through multiple channels. At the same time, you keep control over how many spots USC can take and when.

  💡 **Example**

  A Reformer Pilates studio exports its classes to USC, reserves 10 spots per class for direct bookings in anny, and automatically releases unused reserved spots to USC 24 hours before the class. This maximizes fill rate without sacrificing availability for loyal direct customers.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/618687-connect-urban-sports-club-with-anny](https://docs.anny.co/en/articles/618687-connect-urban-sports-club-with-anny)
</Update>

<Update label="Mar 17, 2026">
  ## Series bookings v2: Book series from resource availability

  <img alt="" />

  Series bookings are now managed centrally via a resource’s available time slots, not inside the booking option. This makes series selectable at checkout and keeps changes to individual dates automatically in sync with existing bookings.

  **❓ What it does**

  * Moves series date definitions from the booking option into the resource’s availability (available time slots).
  * Lets you optionally assign each available time slot to a specific series.
  * Allows connecting additional provided resources per slot (e.g., trainers, coaches, rooms) from the same central place.
  * Enables customers to choose a series via a dropdown during booking.
  * Books all dates of the chosen series at once as a package.
  * Supports mixing series and drop-in bookings to fill remaining capacity.
  * Centralizes update management: single dates can be cancelled or rescheduled in the resource availability and affected bookings stay synchronized.

  You no longer need a separate booking option for every new course cycle. Series become dynamic, easier to maintain, and changes to dates are handled once centrally instead of across multiple configurations.

  💡 **Example**

  You offer a 6-week language course with 12 sessions and also allow drop-ins for individual remaining spots. With Series bookings v2, you create the time slots once in the resource availability, assign them to “6-week course March”, and customers simply pick that series in the dropdown and book the full package. If one session is moved, you update that single slot centrally and the bookings remain in sync.
</Update>

<Update label="Mar 2, 2026">
  ## Let customers edit add-ons after booking

  <img alt="" />

  Customers can now update add-ons after they’ve already booked, as long as you allow it in your settings. This reduces back-and-forth and keeps bookings accurate even when plans change.

  **❓ What it does**

  * Adds a new admin setting on the booking option/service add-on configuration: “Allow editing add-ons after booking”.
  * When enabled, customers can edit selected add-ons directly in their booking details (customer view).
  * Respects each add-on’s lead time, so customers can’t request last-minute changes that you can’t fulfill.
  * Supports changes to limited add-on resources (for example equipment with restricted availability).
  * Automatically handles payment differences: the system triggers the required top-up or refund when add-ons are paid and/or online payment is used.
  * Keeps the booking updated without requiring a manual admin change for typical add-on adjustments.

  This gives customers more flexibility while you stay in control through lead times and availability rules. Your team spends less time on small change requests, and revenue stays correct through automatic payment adjustments.

  💡**Example**

  A customer books a meeting room and later realizes they also need catering. Instead of contacting your team, they open their booking details, add the catering add-on (only if the lead time allows it), and the system automatically charges the difference.
</Update>

<Update label="Feb 27, 2026">
  ## Multi-Tenant Check-In Displays

  <img alt="" />

  You can now connect one Check-In Display to multiple anny organizations. This makes it easy to run visitor check-ins in multi-tenant buildings without mixing data or workflows.

  **❓ What it does**

  * Lets the first organization perform the initial pairing of the Check-In App with the device
  * Enables adding additional anny organizations from within the Check-In App settings
  * Shows the paired Check-In Display in each connected organization’s account settings
  * Allows each organization to customize its own terminal experience, including design, check-in forms, and NDAs
  * Adds an organization selection screen on the Check-In App start screen when multiple organizations are connected
  * Uses the selected organization’s branding, forms, and NDA for the full check-in flow
  * Allows selecting hosts from the chosen organization so notifications and visitor context stay tenant-specific
  * Keeps data strictly separated: visitor data is captured directly and exclusively inside the correct anny organization to support GDPR requirements
  * Requires licensing per company (one license per organization)

  Multi-tenant buildings can share a single physical check-in terminal while keeping visitor data, hosts, and compliance boundaries cleanly separated per company. This reduces hardware overhead and prevents accidental data sharing between tenants.

  💡 **Example**

  A multi-tenant office lobby has one shared iPad for visitor registration. A visitor arrives, selects “Company B” on the first screen, signs Company B’s NDA, and completes Company B’s form. The visit is stored only in Company B’s anny organization and the host notified is a Company B employee.
</Update>

<Update label="Feb 24, 2026">
  ## Shared dashboards and new widgets

  <img alt="" />

  You can now create and share multiple dashboards across your team, with fine-grained permissions for both dashboards and widget categories. Dashboards also got a modern refresh and powerful new widgets for utilization and revenue reporting.

  **❓ What it does**

  * Shows a clear overview in Dashboards with separate sections for private and shared dashboards
  * Lets you create unlimited private and shared dashboards
  * Adds role-based permissions per shared dashboard and per widget category in the role settings
  * Opens any widget in fullscreen for easier analysis and presentation
  * Adds custom date ranges per widget in addition to dynamic presets (for example “This week”); custom ranges can cover up to 365 days
  * Lets you fine-tune widget display options (for example legend visibility, averages, and more)
  * Ensures consistent resource colors across all widgets for faster recognition
  * Enhances the utilization widget with new filters for Community and address (in addition to resource, Service, category, and group)
  * Introduces new widgets: Peak hours & days, Top resources, Top services, Category distribution, Total revenue, MRR, Top customers, Customer growth, New customers
  * Adds reporting options to group bookings by date and by UTM source for more precise performance tracking

  Teams can standardize reporting, reduce duplicated dashboard work, and make faster decisions with shared, permissioned views. Marketing and sales can also connect demand to acquisition campaigns by analyzing bookings grouped by UTM source.

  💡 **Example**

  A workspace operator shares a dashboard “Operations” with the team that includes occupancy by Community and address plus peak times and days. Finance gets a separate “Revenue” dashboard with Total revenue and MRR, while marketing uses a widget view that groups bookings by date and UTM source to see which campaigns are driving the most conversions.
</Update>

<Update label="Jan 27, 2026">
  ## keycafe integration for automated key handover

  <img alt="" />

  You can now connect anny resources with physical keys stored in keycafe and automatically assign the right key to the right customer for the booked time slot.

  **❓ What it does**

  * Lets admins authenticate keycafe in the anny admin area, consistent with other integrations
  * Pulls keys from keycafe and allows you to map them to anny resources (for example, resource “Audi RS” to key “Audi RS key”)
  * Automatically transfers each booking to keycafe so the mapped key is assigned to the booking customer for the exact booking period
  * Triggers keycafe to email the customer a booking code, which they use at the keycafe SmartBox to pick up and return the key

  This reduces manual handovers and helps you run key based operations at scale, with fewer errors and less coordination effort for your team.

  💡 **Example**

  A customer books your “Audi RS” in anny for 10:00 to 14:00. The keycafe integration assigns the “Audi RS key” to that customer for that time window and keycafe sends a booking code. The customer picks up the key at the SmartBox at 10:00 and returns it after 14:00, without your team needing to coordinate pickup times.
</Update>

<Update label="Jan 27, 2026">
  ## Self Check-Out: Cancel after Check-In & smarter Check-Out rules

  <img alt="" />

  We’ve improved Self Check-Out to better match real-world behavior in universities and libraries. From now on, checked-in bookings can be canceled, and check-out is prevented before a booking actually starts.

  **❓ What it does**

  * Allows cancellation even after a user has checked in.
  * Applies the booking option’s cancellation window as the single source of truth, regardless of check-in status.
  * Prevents check-out before the booking start time.
  * Adds a minimum usage duration before check-out is allowed, so extremely short “sessions” don’t fragment capacity.
  * Keeps check-out focused on its real purpose: freeing remaining capacity only when there was genuine partial use.

  This reduces blocked seats and avoids “capacity gaps” caused by immediate check-out actions. At the same time, users can make quick changes without creating operational overhead for admins.

  💡 **Example**

  A student checks in for a library seat and then decides to move to a better free spot. They can now cancel even after check-in (as long as the cancellation window allows it) and immediately book the new seat, without leaving capacity or contingents unnecessarily blocked.
</Update>

<Update label="Jan 22, 2026">
  ## Dynamic Capacity Planning with On-Demand Resources

  <img alt="" />

  You can now connect On-Demand resources to your available time slots, so capacity is allocated only when bookings actually happen. As demand increases, resources are automatically assigned and blocked in real time.

  **❓ What it does**

  * Lets you link On-Demand resources (e.g., guides, trainers, rooms, equipment) in the settings of available time slots, alongside fixed resources.
  * Assigns the first matching On-Demand resource only when capacity is claimed by a booking.
  * Automatically creates a blocker in the resource’s calendar the moment it gets assigned.
  * Removes the assigned resource from the On-Demand pool for overlapping offers, preventing double allocation.
  * Updates slot capacity in real time based on booking demand and the resources that get assigned.

  This gives you flexible operations without overcommitting your team or inventory upfront. You can offer multiple experiences in parallel, let customers choose freely, and still ensure resources are assigned reliably, automatically, and transparently.

  💡 **Example**

  A tourism agency offers 5 tours. Each guide can host up to 10 guests. Guides are connected as On-Demand resources to the tours they can lead, and each guide maintains their individual working hours in anny. When the 1st booking for a tour comes in, the first available matching guide is assigned and blocked. Bookings 2 to 10 fill that guide’s capacity. The 11th booking triggers a second guide assignment, who is then blocked and no longer available for other tours at the same time.
</Update>

<Update label="Jan 22, 2026">
  ## New resource status: separate view and booking

  <img alt="" />

  We’ve introduced a new resource status system that cleanly separates whether a resource is visible, bookable, and billable. This makes it easy to create “info-only” resources without accidentally increasing your costs.

  **❓ What it does**

  * Adds a new status dropdown on each resource with 5 options.
  * Renames existing statuses: Active is now Live, Inactive is now Internal.
  * Adds a new setting in the resource’s Service settings: Enable booking.
  * Combines Live/Internal with booking enabled/disabled to determine the overall behavior of the resource.
  * Introduces free, non-billable states so resources can exist for visibility or setup without impacting billing.

  This update gives you more control over what customers can do, while keeping your resource list complete and accurate without unnecessary billing. It also supports clearer setups where only the “real” sellable item should be counted.

  💡 **Example**

  If you offer courses and want to show the trainer and room details, set the trainer and room to Live for viewing (free) and keep the course Live for booking. Customers can see the trainer/room info, but only the course is bookable and counted for billing.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Per-session resource dependencies

  <img alt="" />

  You can now link fixed resources (like a room or trainer) to a specific session of another resource (like a course or event). When you create or move a session, anny automatically creates and syncs blockers for all linked resources.

  **❓ What it does**

  * Lets you create sessions (previously called irregular availabilities) under Resource settings > Availability.
  * Allows you to link additional resources directly inside the session settings (for example: “Trainer” and “Room”).
  * Automatically creates a blocker for each linked resource as soon as the session is created, even if the course has no bookings yet or isn’t live.
  * Keeps everything in sync: when a session is moved or updated, the linked blockers update accordingly.
  * Optionally shows the linked resources in the booking calendar, email communication, and booking details so customers can use that info when deciding.

  This reduces coordination effort and prevents double-booking across trainers, rooms, and sessions. It also makes course and event planning more reliable because dependencies are handled automatically.

  💡 **Example**

  You set up a “Yoga Class” session for Tuesday 6pm and link “Room A” and “Trainer Kim”. anny immediately blocks Room A and Kim for that time and updates those blocks if you move the class, so neither can be booked elsewhere.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Time Slot Series and Custom Titles for Appointments

  <img alt="" />

  You can now manage bookable time slots more flexibly, especially for irregular schedules and recurring sessions. “Irregular availabilities” have been renamed to “Time slots”, and time slots can carry their own titles and be created in series.

  **❓ What it does**

  * Renames “Irregular availabilities” to **Time slots** (Resource > Availability > Appointments).
  * Lets you set an **individual title per time slot** (for example “Beginner session” or “Advanced training”).
  * Shows the **time slot title in the booking calendar**, so end users immediately understand what they are booking.
  * Adds the option to **create a time slot series** in a recurring pattern (for example every 2 weeks).
  * After creation, **each time slot remains independent**: you can edit, move, cancel, or adjust dependencies per slot without affecting the others.
  * Supports future-friendly setup for **extended per-slot options** (for example auto-blocking related resources like rooms or trainers).

  This update removes the manual work of creating every appointment one by one and makes recurring but non-standard schedules much easier to maintain, without losing control per individual session.

  💡 **Example**

  A course takes place every two weeks, alternating between “Beginner session” and “Advanced training”. You create a bi-weekly time slot series, set the right title per slot, and if one date needs to be moved or canceled, you update only that single time slot.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Custom message on booking status changes

  <img alt="" />

  You can now add an optional custom note whenever you change a booking’s status. This note is included in the automatic status update email sent to the customer.

  **❓ What it does**

  * Shows a pop-up after every booking status change where you can optionally enter a short message.
  * Inserts your message into the status change email that is automatically sent to the customer.
  * Helps you add context for the status change without rewriting the full email.
  * Encourages concise notes (no greetings or formal sign-offs), focused only on the reason or helpful next steps.

  This makes customer communication clearer and more human, especially in sensitive moments like cancellations or rejections. It also reduces follow-up questions because customers immediately understand the “why”.

  💡 **Example**

  A customer’s appointment is declined due to illness. When you change the status, you add: “I’m sick today and can’t make it. Please rebook for next week.” The customer receives the usual status email plus your context.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Bulk reschedule or cancel bookings for a session

  <img alt="" />

  You can now reschedule or cancel an entire session and automatically apply the change to all matching bookings, including customer communication. This removes manual effort when managing irregular, bookable sessions like semester courses.

  **❓ What it does**

  * When you change a session time (reschedule) in the Admin Calendar (Planner mode), all bookings that exactly match that session’s time are moved accordingly.
  * When you manually cancel a session in the Admin Calendar (Planner mode), all bookings that exactly match that session’s time are declined accordingly.
  * When you change sessions via Resource settings > Availability > Sessions, the same automation applies.
  * If a session’s blocked resources change (for example a different room or a different trainer gets assigned), affected bookers are automatically informed.
  * Only bookings with the exact same start and end time as the session are included (no overlapping bookings and no bookings fully inside the time window).

  Session changes that used to take many manual steps per booking now happen in one action, with consistent updates and communication. This is especially valuable for resources with irregular schedules where each session is booked as an exact time slot.

  💡 **Example**

  A university runs a semester course with weekly sessions that are booked per session. If the instructor needs to move next Tuesday’s session from 10:00 to 11:00, you change the session once and all bookings for that exact 10:00 to 11:00 slot are automatically shifted and communicated.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Show available slots in the calendar

  <img alt="" />

  Your booking calendar now shows available timeslots for multi-bookable offers even when no one has booked yet. Customers can also add these slots straight to the cart from the calendar.

  **❓ What it does**

  * Displays available timeslots across **all calendar views in the booking area** (no changes in admin).
  * Works for resources with **available quantity > 1**, such as courses, events, desks, and study places.
  * Shows upcoming sessions **even with 0 bookings**, so your calendar is complete from day one.
  * Adds a **“+” button** on eligible slots so customers can add a date to their cart in one click.
  * Makes it easy to plan multiple bookings and complete them in a single checkout.

  This removes the “empty calendar” problem for courses and events and helps customers understand what’s coming up without needing an existing booking first. It also shortens the path from discovery to checkout.

  💡 **Example**

  A studio schedules courses for the next few weeks and hasn’t received any bookings yet. Customers can still see every upcoming session highlighted in the calendar and add each session with one click via “+”, then book everything together in one checkout.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Minimum bookings per session with auto-cancellation

  <img alt="" />

  You can now set a minimum number of bookings per session and automatically cancel the session if the threshold isn’t met by a defined cutoff time. This removes manual checks, cancellations, and refund handling.

  **❓ What it does**

  * Set a **minimum booking count** per session (e.g., 10 participants).
  * Define a **cutoff window** before the session starts (e.g., 24 hours).
  * If the minimum isn’t reached by the cutoff, the session is **automatically cancelled** and all existing bookings are **declined**.
  * If customers already paid, payments are **automatically refunded**.
  * **Admins get notified 1 hour before** the automatic cancellation so they can still run the session by lowering the minimum.
  * **Admins also get notified when the minimum is reached**.
  * Customers receive **automated messages** about cancellations and refunds.

  This keeps your schedule reliable and profitable without constant monitoring. It also creates a consistent, transparent experience for customers through automated communication and refunds.

  💡 **Example**

  You offer a Reformer Pilates class with a minimum of 10 participants. 24 hours before the class, only 9 spots are booked. anny automatically cancels that class, notifies all booked customers, and triggers refunds if payments were made. If you still want to run it, you can lower the minimum after the admin pre-notification and the class stays active.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Weekly view in the booking calendar

  <img alt="" />

  You can now switch your booking calendar from a day view to a week view on the booking page. Calendar entries also inherit each resource’s color, making schedules easier to scan at a glance.

  **❓ What it does**

  * Adds a **Week view** toggle next to the existing Day view on the **Explore booking page calendar**
  * Displays bookings and blockers using the **resource color** (configured per resource in the admin)
  * Helps you see **availability across multiple days** without jumping between dates
  * Keeps the **admin area unchanged** (only the booking page calendar experience is updated)

  This update makes it significantly faster to understand what’s available, when, and where, especially for businesses running schedules across an entire week. It also reduces confusion by visually differentiating resources instead of showing everything in one default color. Learn more in the help center article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)

  💡 **Example**

  A Pilates studio offers classes spread across the week. With Week view, customers can instantly spot which classes fit their schedule, and the studio team can quickly check room availability for the whole week because each room’s bookings show in its own color.
</Update>

<Update label="Jan 15, 2026">
  ## Require legal documents confirmation on every booking

  <img alt="" />

  You can now decide whether a legal document must be confirmed just once or at every booking. This gives you more control over compliance requirements that depend on the specific booking context.

  **❓ What it does**

  * Adds a new toggle option “Ask every time” when creating or editing a legal document in the admin area (default: off).
  * When enabled, end customers must confirm/sign this document again with each new booking checkout.
  * When disabled (default), the existing behavior remains: one-time confirmation is enough.

  This helps you meet stricter legal or operational requirements without manual follow-ups or chasing missing signatures. It also reduces risk by ensuring customers actively acknowledge the document for every relevant transaction.

  💡 **Example**

  If you have a liability waiver that must be signed for each appointment, enable “Ask every time”. From then on, the waiver is requested at every checkout, even for returning customers.
</Update>

<Update label="Jan 7, 2026">
  ## Enhanced subscription management

  <img alt="" />

  We’ve expanded subscription management in anny to give admins more flexibility and a smoother recurring experience. Alongside new controls for cancellations, pricing, and pauses, we’ve also strengthened the reliability of recurring subscriptions.

  ❓ **What it does**

  * Admins can cancel subscriptions up to **6 months in advance**.
  * Dates for **new subscriptions** are displayed in a clearer, more human-friendly format (e.g. **01 - 31** instead of **01-01**).
  * Admins can view and change the **price mode (net/gross)** per individual subscription.
  * Admins can **schedule a subscription pause in advance**.
  * Improved overall stability of the recurring logic, including:
  * Subscriptions now continue renewing reliably even when a minimum term is involved.
  * Planned subscriptions start more consistently at their scheduled time.
  * Subscribers are removed from the Community more consistently after a subscription ends.

  💡 **Example**

  If a member requests a cancellation for the end of the season, you can schedule it months ahead and keep everything predictable for both your team and the subscriber.

  This update reduces manual follow-ups and helps you manage long-running memberships with confidence.
</Update>

<Update label="Jan 6, 2026">
  ## ISO 27001 certification for anny

  <img alt="" />

  anny has long operated **GDPR-compliant** and on an **ISO 27001-certified infrastructure**.<br />Now, anny as a company is also **ISO 27001 certified**, confirming that our Information Security Management System (ISMS) meets an internationally recognized standard.<br />In addition, anny is now **ISO 27017 certified**, covering cloud-specific security controls.

  ❓**What it does**

  * Confirms that anny operates an **audited, company-wide Information Security Management System (ISMS)** based on ISO 27001
  * Confirms that **cloud-specific security controls are audited and certified** in line with ISO 27017
  * Builds on existing **GDPR-compliant processes** and an already ISO 27001-certified infrastructure
  * Ensures that confidentiality, integrity and availability of your data are managed through standardized controls
  * Demonstrates that technical and organizational measures (TOMs) are systematically implemented and reviewed on a regular basis
  * Simplifies internal security and privacy approval processes, especially for CISOs, IT security teams and Data Protection Officers
  * Reduces procurement friction where an ISO 27001 certified SaaS provider is a mandatory requirement (e.g. KRITIS, large enterprises)
  * Supports the implementation of Clean Desk & Clear Screen policies through secure, shared workplace scenarios (for example via check-ins and automatic logout)
  * Strengthens your compliance posture in view of upcoming regulations such as NIS2 and associated national laws from 2026 onward

  This certification makes it easier and faster for enterprise organizations to adopt anny while meeting strict security and compliance requirements.<br />With anny’s **ISO 27001 and ISO 27017 certifications**, security and data protection teams can rely on an audited framework that formally confirms established security practices instead of conducting lengthy ad hoc reviews.
</Update>

<Update label="Jan 5, 2026">
  ## UTM Link Tracking

  <img alt="" />

  You can now track where bookings, subscriptions, and booking packages come from using UTM parameters on your anny booking page. Create trackable links and see attribution directly in the relevant records and exports.

  ❓**What it does**

  * Lets admins generate trackable booking page links with **utm\_source**, **utm\_medium**, and **utm\_campaign**
  * Provides an integrated link builder, with the option to add parameters manually
  * Stores attribution when a customer completes a **booking**, **subscription**, or **booking package** within **14 days** after clicking a UTM link
  * Shows a new **“Attribution”** panel in: Booking details, subscription details & booking package details
  * Adds attribution fields to tables and exports: Bookings table and export, subscriptions table and export & booking packages table and export

  💡 **Example**

  Compare bookings coming from your newsletter vs. Instagram posts by using separate UTM links for each channel.

  This makes it easier to understand which channels and campaigns drive revenue, without guessing or manual tagging.

  Learn more in the helpcenter article here: [https://docs.anny.co/en/articles/520588-utm-tracking](https://docs.anny.co/en/articles/520588-utm-tracking)
</Update>

<Update label="Jan 5, 2026">
  ## VAT rates for price modifiers

  <img alt="" />

  You can now assign a dedicated VAT rate to each price modifier. If no VAT rate is selected, the price modifier automatically uses the VAT rate of the Service or booking option.

  ❓ **What it does**

  * Adds a new field **“VAT rate”** in the price modifier detail view.
  * Lets you set a **different VAT rate per price modifier**, independent from the Service/booking option.
  * Defaults to the **Service/booking option VAT rate** when the field is left empty.
  * Helps you **separate fixed price components** (e.g., fees, packages, cleaning) for clearer invoicing and tax reporting.

  💡 **Example**

  A ticket includes a drink flat rate with a different VAT rate, which can now be shown as its own line item with the correct VAT.

  This makes invoices more accurate when one booking contains multiple taxable components.
</Update>


# Identity API
Source: https://docs.anny.co/developers/api-reference/identity



The **Identity API** handles user identity on the anny platform. It runs on a dedicated auth service (`auth.anny.co`) separate from the booking API.

Use the Identity API to:

* **Detect login method** for a domain — determine whether a user should log in with a password, SSO redirect, or another protocol before starting the auth flow
* **Update user profiles** — change name, contact details, locale, and timezone for authenticated users
* **Request account deletion** — initiate GDPR-compliant deletion for a user

***

## Authentication

All protected endpoints require a Bearer token in the `Authorization` header:

```http theme={null}
Authorization: Bearer {access_token}
```

Tokens are issued via OAuth2 or as Personal Access Tokens (PATs) from the admin dashboard.

## Related Guide

[Authentication](/developers/guides/authentication) — full guide to tokens, OAuth2 flows, and client registration.

***

## Base URLs

| Environment | URL |
| - | - |
| Production | `https://auth.anny.co` |
| Gov-Cloud | `https://auth.anny.eu` |
| Staging | `https://auth.staging.anny.co` |


# Get login method for a domain
Source: https://docs.anny.co/developers/api-reference/identity/endpoints/auth/get-login-method-for-a-domain

/developers/openapi/identity.openapi.json get /api/v1/domains/login-method
Returns the login configuration for a given email domain. Use this to determine which authentication method (password, SSO, etc.) a user should use before initiating the login flow.

This endpoint does not require authentication.



# Request account deletion
Source: https://docs.anny.co/developers/api-reference/identity/endpoints/auth/request-account-deletion

/developers/openapi/identity.openapi.json get /api/v1/users/{user_uuid}/request-deletion
Initiates the account deletion process for the authenticated user. Sends a confirmation to the user and queues the deletion request for processing.

The account is not deleted immediately — a confirmation step may be required depending on configuration.



# Update user profile
Source: https://docs.anny.co/developers/api-reference/identity/endpoints/auth/update-user-profile

/developers/openapi/identity.openapi.json patch /api/v1/users/{user_uuid}
Update profile attributes for the authenticated user.



# 2024
Source: https://docs.anny.co/changelog/2024

Follow the updates and improvements made to the anny platform in 2024.

<Update label="Dec 31, 2024">
  ## New role and ability system

  The role and ability management is one of the most used features of anny. It allows you to granularly set the abilities that roles or individual admins have in the admin area. For example, you can set which admin can see, create, edit or delete a resource or service.

  Over the last few years, anny has gained many new functions and the requirements for the ability and role management have increased as a result. We have therefore fundamentally revised the role and ability system for admins.

  We have revised the user interface to manage the abilities of roles and admins. You can now see at a glance which rights have been assigned and which restrictions apply to them.<br />You can also assign abilities for services, maps, subscriptions, and communities.

  Furthermore, you can now also define individual abilities directly when inviting an admin. This means you don't have to create your own role before you can invite the admin.<br />You will also find the option to directly invite an admin for a resource on the resource overview and details page. This allows you to send even faster invitations for admins with restricted authorizations.

   You can find a detailed article on ability and role management in our Help Center: [https://docs.anny.co/en/articles/255697-user-and-role-administration](https://docs.anny.co/en/articles/255697-user-and-role-administration)
</Update>

<Update label="Dec 18, 2024">
  ## ✨ Community access for smart locks and new interface

  Until now, smart lock accesses could only be created automatically for individual bookings.  Now, however, you can also easily assign specific smart lock accesses to your communities. This means that you can link access to certain areas directly to membership of a community. This gives your members convenient and secure access that is managed automatically.<br />For example, a new community member can automatically gain access to the coworking space as soon as they register, and this access is revoked as soon as their membership ends.<br /> <br />In addition, there are some visual customizations that give you even more control over your smart locks: **Optimized interface:** A new, simplified design makes managing your smart lock integrations even more intuitive. **Smart locks in booking details:** On the booking details page in the admin area, you can now see exactly when, for how long and to which lock your user has access through the booking. In the help center, you will find everything that is new and the instructions for integrating the systems into anny: [https://docs.anny.co/en/articles/30481-smart-lock-integration](https://docs.anny.co/en/articles/30481-smart-lock-integration?utm_source=newsletter\&utm_medium=email\&utm_campaign=customers-eu-en-news-from-anny-new-smartlock-integrations-and-community-access)
</Update>

<Update label="Dec 18, 2024">
  ## iLOQ and Exivo

  Smart locks open up limitless possibilities for you to network locks with the digital world and thereby automate your processes. At anny, we already support a range of different smart lock systems. To offer you even more flexibility, we have now integrated additional smart locks from **dormakaba (Exivo)** and **iLOQ** into anny.
</Update>

<Update label="Dec 11, 2024">
  ## Global blockers

  This Christmas, we are giving you something very special - time! 🎄✨<br /> <br />Our team has developed a new feature that will save you a lot of time.<br />From now on, you can create organization-wide blockers for all or selected resources on certain days with just a few clicks.

  But that's not all! With the feature, you can create blockers for all public holidays in your region with just one click. This ensures that no bookings are possible on public holidays - quickly and easily.

  You can find the global blockers in [your account settings](https://app.anny.co/organization/settings/blockers), or you can easily create them via the calendar.
</Update>

<Update label="Dec 9, 2024">
  ## Major child resource management update

  In anny, child resources have an important task, as they allow you to manage multiple bookable units within a parent resource.

   A typical example: You have a room (the parent resource) in which several desks are available. Each individual desk can be configured as a child resource (desk 1, desk 2, desk 3, etc.). This allows your users to book specific workstations.

   We have improved the management of child resources in anny to make your work with them even easier:

  ### **🛠️ Individual properties per child resource**

  You can now customize the properties of your child resources so that they differ from the main resource. This is useful, for example, if one of your child resources is slightly different from the others, and you want to highlight this.

  ### **🔄 Move flexibly**

  You can now move a child resource with just one click and assign it to another resource.  This saves you having to delete and create it again.

  ### 🌎 Global translations

  Last but not least, you can now also translate all child resource names individually into all languages offered by anny.

  We hope you enjoy the latest update!
</Update>

<Update label="Oct 9, 2024">
  ## anny app 2.1.0

  We have released a new version of our anny app. With this release, booking quotas and dynamic pricing are now also included in the app. Moreover, we have added new languages. Have fun!
</Update>

<Update label="Sep 30, 2024">
  ## Notify Admins of failed or disputed payments

  Admins will now get notified if a payment fails or was disputed. You can change your notification settings inside the admin profile (“Payment reminder" notification).
</Update>

<Update label="Sep 18, 2024">
  ## Add data for attribute mapping via API

  Until now, the data used for attribute mapping could only be inserted into anny via attributes using SSO. Now, it is also possible to import additional data directly into anny via the API, meaning that this does not necessarily have to come via the IDP.

  This allows entirely new possibilities to work with our attribute mapping.
</Update>

<Update label="Sep 16, 2024">
  ## anny app 2.0.2

  We have released a new version of our anny mobile app. Users now have the possibly to change their timezone directly inside the profile. Furthermore, we smashed some bugs to make the user experience even better.
</Update>

<Update label="Jul 30, 2024">
  ## Introducing Flexible Booking Types!

  Your resource is now even more flexible - you now have the option to customize the booking type per service, so you can determine exactly how your resource is blocked by a booking.

  These are the different bookings types:

  * **Transparent:** The bookings will not block the resource for the period. Use this option to allow infinite bookings for the same time period.
  * **Default:** A booking blocks the resource for the respective period. With multiple available resources, one capacity unit is blocked with each booking.
  * **Multiple:** A booking blocks the capacity unit you have set with a single booking, e.g. for a group ticket. This setting is only available for resources that are available multiple times.
  * **Full:** Bookings block the full capacity of the resource for the relevant period, e.g. to book a resource as a whole that has child resources. This only works for resources with child resources.
</Update>

<Update label="Jul 30, 2024">
  ## Booking quotas and booking bundles

  <img alt="" />

  ### 📋 Booking quotas

  The new booking quotas provide you with three different quota types that you can set for your users:

  * Quantity quotas: A certain number of bookings that can be made
  * Time quotas: a defined total duration that can be used over several bookings
  * Budgets: a certain amount of money for which bookings can be made

  You can allocate these quotas on a one-off or recurring basis (daily, weekly, monthly or annually). This opens up a wide range of possibilities, such as creating multiple tickets, vouchers, or monthly recurring quotas for your subscription customers or community members such as work or learning spaces.

  Your customers can use their quotas over several bookings, whereby they can view their remaining quota balance at any time. In addition, the use of quotas can be restricted to groups, categories, resources, and services.<br />Alternatively, you can set a quota for the booking of a resource so that no further bookings can be made afterward. Alternatively, the booking is billed at regular conditions once the quota has been used up.

  ### 👥 Quotas in communities and subscriptions

  With booking quotas, you can create exclusive benefits for your subscribers and community members by linking them directly to your subscription plans or communities. You have the option of adding one-off quotas, for example as a welcome gift, or recurring quotas.

  You can find more in our help center: [https://docs.anny.co/en/articles/197826-booking-quotas](https://docs.anny.co/en/articles/197826-booking-quotas?q=booking+bu)

  <img alt="" />

  ### 📦 Booking bundles

  Booking quotas can also be combined into booking bundles and thus offered at a bundle price. Frequent applications are value vouchers or multiple tickets. An individual PDF (e.g. with a voucher design) can also be created and sent automatically for each package sold.

  You can find more in our helpcenter: [https://docs.anny.co/en/articles/197837-booking-bundles-booking-codes](https://docs.anny.co/en/articles/197837-booking-bundles-booking-codes)
</Update>

<Update label="Jul 25, 2024">
  ## Discover the new and improved anny App 2.0!

  We've been busy over the last few weeks reworking our anny app from the ground up and are proud to present version 2.0 to you today. Let me tell you this much: our beta testers already love the new version! Let's dive straight into what's changed:

  ### ✨ What’s new

  You'll notice it straight away: The design of our new version has been fundamentally revised to fulfil the principles of our app: fast, smart and intuitive.<br />We have collected a lot of feedback, corrected bugs and made improvements. Do you still have a suggestion for improvement or an idea? You can send us your comments [here](https://tally.so/r/npVZRb).

  **🗺️ Improved maps**<br />We have made the maps even clearer in the new version, and you can see more information at a glance. Intuitive filters allow you to see directly which resources are still available on the map.

  **🎛️ More filter options**<br />Filters are a good keyword: We have added some new filters. You can now filter resources by desired time and booking duration, properties and locations. In addition, you have direct access to the available slots of the resources and can book them with one tap.

  **🚦See capacity utilization at a glance**<br />Would you like to book a quiet workspace today that doesn't have many users? Do you need a full working environment around you to get carried away by the work motivation? With our utilization indicator, you can quickly see how many people are working at different times. So you know what to expect.

  **🛒 Familiar functions now also in the app**<br />In the mobile app, you will now find many familiar functions that you already know from the web app, such as booking series, recurring bookings, interests & roles and the avatar builder. However, we have also hidden some features in the app that you will find later in the web app. Have you found any yet?

  The new version of the app is already available in the Google Play and Apple App Store. Download the update now on [Android](https://play.google.com/store/apps/details?id=co.anny.app) and [iOS](https://apps.apple.com/en/app/anny/id6448261664) to benefit from the new features.
</Update>

<Update label="Jul 4, 2024">
  ## Subsequent adjustment of personalized bookings

  Your users have already booked but can’t attend and want to send another person - this isn’t a task for you anymore. Now, your customer has the possibility to change their personalization by himself and select, for example, another person. Your customer now has the possibility to change their personalization by themselves.
</Update>

<Update label="Jun 30, 2024">
  ## 📊The new utilization widget

  What is the key to optimal pricing? <br />Precise data on the utilization of your resources. A new widget is now available in the dashboard to show you the utilization of your resources.

  **📈Everything about the utilization of your resources at a glance**

  We have added more filter options so that you can now make even more precise settings to get exactly the data you need.

  **⚖️ Compare the utilization of your resources**

  Create multiple widgets to compare the utilization of your resources with each other, or to compare the same resource at different time periods.

  Learn more about the dashboard and widgets inside our help center: [https://docs.anny.co/en/articles/101578-dashboard](https://docs.anny.co/en/articles/101578-dashboard)
</Update>

<Update label="Jun 30, 2024">
  ## ✨ Dynamic prices for your services and booking options!

  Would you like to...

  * adjust your prices according to occupancy?
  * offer discounts for early bookers or last-minute customers?
  * grant discounts to a specific customer group?
  * give discounts from a certain booking duration?
  * increase or discount your prices depending on the season?
  * adjust your prices based on the day of the week, e.g., the weekend?
  * *or combine everything directly?*

  **We've developed the ideal solution for you! 🤝**

  With our new feature, you can now set dynamic prices for your services and booking options.

  You can adjust prices according to the following criteria:

  * **⏰ Time factors:** Offer special prices on certain days of the week, individual dates, at certain times or for a certain duration.
  * **👥 Customer groups:** Give certain customer groups discounted prices.
  * **📊 Utilization:** Adjust your prices based on the utilization of your resources.

  Take a look at our Help center article now and optimize your pricing: [https://docs.anny.co/en/articles/179792-dynamic-pricing](https://docs.anny.co/en/articles/179792-dynamic-pricing)
</Update>

<Update label="Jun 26, 2024">
  ## Seamless integration with Personio and HRworks

  HR systems are used in many companies to simplify processes. For example, employees can enter when they are ill and everyone else is notified. With our new integration of the HR systems Personio and HRworks, anny is now also notified and can easily cancel bookings. Let's take a look at what else these new integrations bring:

  ### 🏃 Automatic cancellation in the event of absence

  Are your employees absent but still have a seat booked in the office? You can now set that these bookings are automatically cancelled in the event of absence and the resources are released again.

  ### 🏡💻 Synchronization of home office and office days

  Synchronize your employees' home office and office days directly from anny into your HR system. This means you can also see and record where the person is in the HR system.

  Want to know how to set up these integrations? Then take a look at our help center articles for [Personio](https://docs.anny.co/en/articles/179056-personio-integration) and [HRworks](https://docs.anny.co/en/articles/179057-hrworks-integration).
</Update>

<Update label="Jun 13, 2024">
  ## The biggest invoice update we've ever published 🚀

  Today, we have something special for you: We have published our biggest update to date regarding invoices in anny. Curious to see what's in store for you? Let's dive right into it:

  <img alt="" />

  ### 🔔 Change manager (notifications & individual refunds)

  A new pop-up summarizes all changes and allows you to adjust them and activate or deactivate notifications. You can now also disable notifications for customers for all changes in bookings, orders, and invoices.

  For even more control, you can also create fully customized refunds or corrective invoices.

  <img alt="" />

  ### 🖌️ Invoice designer

  With anny, you can create new invoices for an order at any time. You retain full flexibility, as services can also be invoiced retrospectively, for example add-ons such as catering or equipment. You can now also create forms for customers or orders to display them on the invoices. For example, an order number or VAT ID number.

  For very special cases, you can also create invoices independently of bookings or subscriptions.

  <img alt="" />

  ### 📄 Quotation creation

  With the new quotation function in anny, you can save orders as a draft and create a quotation PDF. Once accepted, quotes can be converted into invoices and sent to your customers. With the practical payment link in the email, your customers can pay conveniently online.

  **Further improvements**

  * The order status has been simplified to "Draft" or "Completed". For more information, you can show the "Invoice status" column in the order list.
  * In addition to the PDF version, invoices are now also available as e-invoices in XML format.
</Update>

<Update label="Jun 13, 2024">
  ## 🇨🇭 TWINT Integration

  Anny now supports the popular Swiss payment service provider TWINT for payments in Swiss francs. With TWINT, we now support ever 13 different payment methods.
</Update>

<Update label="May 30, 2024">
  ## 2-way synchronization with Google Workspace

  Link your Google Workspace resources such as meeting rooms or equipment directly to resources in anny via two-way synchronization. This allows your bookings to be synchronized in real time. Take a look at our [instructions](https://docs.anny.co/en/articles/171687-google-workspace-integration).
</Update>

<Update label="May 26, 2024">
  ## Add-On Optimizations

  **🎨 Enhanced Add-Ons Customization**

  * **Image and Group Uploads**: Enhance the visual appeal of your add-ons by allowing the upload of images and creation of groups for better organization.
  * **Reorganized Settings and Price Simplification**: Streamline your add-on management with a redesigned settings interface and a simplified pricing structure that eliminates confusion by limiting price to one mode (quantity, interval, or percent).

  **📋 Multi-Booking Flexibility**

  **Individual Selection for Multiple Bookings**: Empower users with the flexibility to customize add-ons and sub-resources individually for each booking within a multiple booking schedule.

  **🔎 Discover and Group Add-Ons**

  **Enhanced Search and Grouping**: Navigate through extensive add-on options effortlessly with an optimized search system and a dedicated grouping feature that categorizes add-ons when more than 5 are available on the booking panel.
</Update>

<Update label="May 26, 2024">
  ## Optimization of the admin tables

  We have made it much easier for you to work with our data tables and added new filters and columns:

  * **Filter by Community 👥:** Filter customers based on their community affiliation for targeted data analysis.
  * **Community Column Revealed 🌍:** A new "Community" column in the customer table provides instant visibility into customer community membership.
  * **Custom Field Spotlight 💡:** Enhance table functionality by displaying user-defined fields in all tables, maximizing customization.
  * **Column Control Center 🛠️:** Take control of table organization with the new table column manager, allowing you to customize column order and selection to suit your analysis needs.
</Update>

<Update label="May 26, 2024">
  ## Upgrade for Custom Fields

  **🎯 Target-Oriented Forms**

  Custom fields can now be queried not only at booking level, but also at customer and order level. This setting defines when and how often the data is queried at checkout and where it is subsequently saved.

  Example: A bike rental company offers groups the option of renting bikes. At booking level, customers can specify the desired frame size. At the order level, the rental company can then query the planned route to optimally adjust the tire pressure to the route conditions.

  **🎭 Linguistic Enhancements**

  Translated Field Names and Descriptions: Custom field names and form descriptions can now be translated into multiple languages.

  **🛡️ Private Fields**

  Hide from Checkout: A new option enables you to disable "Show in Checkout" for custom fields. This creates admin-only fields that can be used exclusively for internal purposes.
</Update>

<Update label="Apr 15, 2024">
  ## Additional participants for bookings and booking confirmations per service

  ### 👫 Add additional participants to a booking

  <img alt="" />

  From now on, additional participants can be added to a booking using their name or e-mail address. The participants will automatically receive a booking confirmation and have the option to cancel the booking.

  You can activate this function as follows:

  1. Select the desired service and navigate to "Form".
  2. Activate the "Allow additional participants" function. Below this, you will find various setting options to configure this feature according to your wishes.

  ### ❓Did you know that you can activate a manual confirmation process for bookings?

  Previously, it was possible to control booking requests on a per-resource basis. With the new update, you can now also make this setting per service, which gives you more flexibility in handling your offers.<br /> <br />You can activate this function as follows:

  1. Open the desired service in anny.
  2. Navigate to the "Advanced settings".
  3. Deactivate the option "Accept all bookings automatically".

  A booking receives the status "requested" if either the booked service or the resource has deactivated the automatic acceptance of bookings.
</Update>

<Update label="Apr 9, 2024">
  ## Simply become multilingual

  We have great news for you - in multiple languages! Greet your users in their language and make it even easier for them to book your resources. Let's dive right in!

  ### 🗣️ Your resources can now speak multiple languages

  <img alt="" />

  Your booking page could already do it, and now your resources can too: they speak 16 languages fluently and speak to all your users. From now on, you can create all your content in different languages. This includes, for example, the name and description of each resource and service. We automatically display the content to your users in the correct language.

  Next to each supported input field, you will now find a language selection menu that you can use to add additional languages. Try it out directly for your resources.

  ### 🌍 Extended language support

  <img alt="" />

  We now support even more languages! Say hello to American English (en-US), Norwegian (nb-NO), Hungarian (hu-HU), Italian (it-IT) and Czech (cs-CZ) in our language palette!

  Do you have any feedback on the translations? Please write to [product@anny.co](mailto:product@anny.co).

  ### 📅 Date formats for specific regions

  No more confusion with dates! Users from the USA (en-US) now use the MM/DD/YYYY format, while users from the UK (en-GB) stick to the DD/MM/YYYY format.
</Update>

<Update label="Apr 1, 2024">
  ## Subscription and Invoice Management Supercharged!

  We have exciting news for you! With our latest update, we've taken subscription and invoice management to the next level to optimize your processes and offer your customers an even better experience. Let's dive right in:

  ### 💸 Your subscription management has never been this easy

  With our new subscription management features, you have more control over your subscriptions and the ability to customize them to your customers' needs.

  * **Shift the start date:** You can now flexibly adjust the start date of a subscription.
  * **Pause easily:** You can pause subscriptions with just one click.
  * **Decide when the subscription ends:** You now have the option to cancel subscriptions at different times: immediately, at the end of the current period or after the minimum term has been reached.
  * **Price changes and discounts:** You now have the option to flexibly adjust the prices and discounts in your customers' plans - even after the subscription has started.
  * **Cancellation and refund of individual invoices:** If something goes wrong, you can cancel and refund individual subscription invoices.

  Best of all, your customers will be informed directly of any changes.

  ### 📝 New features in invoice management

  We have also made adjustments to invoice management that will make your work much easier:

  You can now manually set invoices to "paid". As soon as this happens, we will automatically inform the customer that the payment has been received.

  If you also need to modify the billing address, you now have the option to change it. As part of this adjustment, we will automatically create a new invoice and cancel the old one. In addition, future invoices will also be use the new address.
</Update>

<Update label="Mar 24, 2024">
  ## anny Display App 1.0.5

  A new version of the anny app is available. This update allows you to hide the QR-Code from the display app. This offers the advantage of using the app only as display without any interaction.
</Update>

<Update label="Mar 14, 2024">
  ## anny App 1.0.9

  A new version of the anny app is available. This update provides two new features:

  ### Better Deep-Links

  We improved the support for deep links into the anny app:

  * If the link is leading to another data region, we are automatically switching to this region
  * If a login is required to view or book the resource, we are now forwarding the user to the login screen and redirect him back after the login to the resource

  ### Improved Maps

  We also improved the map that is used inside the app. The map is now loading even faster and doesn’t lead to app crashes.
</Update>

<Update label="Mar 12, 2024">
  ## Accept now payments via PayPal and 4 other providers

  Did you know that anny can process both internal and external bookings and automate payment processing for you?<br />Thousands of bookings are already paid online via anny every day. With our latest update, we have expanded both the payment options and the supported currencies.<br /> <br />**🌟 Let your customers pay via PayPal**<br />Your customers can now pay for their bookings easily with PayPal! PayPal Payments are automatically activated for you and are processed via Stripe Connect.<br /> <br />In addition to bookings, subscriptions in Swiss francs can also be paid via PayPal. This gives you a flexible alternative to credit card payments in Switzerland.<br /> <br />**💰 New payment methods and currencies for your customers**<br />In addition to PayPal, we are introducing further new payment methods:

  * **EPS** for customers in Austria
  * **blik** for customers in Poland (supports PLN)
  * **Przelewy24** for customers in Poland (supports PLN & EUR)
  * **Bancontact** for customers in Belgium

  You can now also process payments in the currencies DKK, SEK and NOK.
</Update>

<Update label="Feb 22, 2024">
  ## Expand your profile and find exactly the people you need

  At anny, we love the versatility of communities and teams. Our latest update is therefore specifically designed to strengthen collaboration, communication, and interaction.

  **👤 Extended user profiles**

  You can now fill your profile with even more information: from your job title and department to your skills, roles, and interests. Not only can you personalize your profile, but you can also get to know the community better and network and collaborate in a more personalized way.

  🔎 **Find exactly the person you need**

  Find people directly using keywords in their bio, job title or department. You can also filter directly by skills: for a targeted search. This means you always know where the nearest first-aider is located, or where you can be found as an anny expert.

  **🎯 See the top skill directly**

  You can also see a user's top skill highlighted on each profile picture. This allows you to see at a glance who has what expertise. For example, you want to know where a dog is in the office? Simply search for a dog emoji on the map.

  So, what are you waiting for? [Expand your profile](https://anny.co/b/account/profile) now and add your skills, roles, and interests.
</Update>

<Update label="Feb 20, 2024">
  ## Favourite your preferred Child-Resources in anny

  In anny you can already favor your preferred resources with just one click, such as your preferred meeting room or your favorite office. These are then displayed in your weekly planner, and you can book them quickly and easily. You can also manage your favorites on the [favorites page](https://anny.co/b/account/favorites?utm_source=newsletter\&utm_medium=email\&utm_campaign=new-in-anny-child-resources-save-position-more).<br /> <br />From now on, you can also favor child resources. Your favorite child resources are automatically selected in the weekly planner when you book, so you can book your favorite place with just one click per day.

  <img alt="" />
</Update>

<Update label="Feb 6, 2024">
  ## Save last Map Position, Mobile Reminders for Booking Reminders & New Booking Page Button

  ### 📍 Save the latest position on the map automatically

  **🗺️ Resume where you left off**: The week planner map now remembers your last viewed location automatically. This means that when you return to the map, it will automatically zoom in on the area and the layer you were previously exploring.

  <img alt="" />

  ### 🔔 Mobile notifications for booking reminders

  **📱 Stay in the Loop with your customers:** We're excited to introduce the option to enable WhatsApp and SMS notifications for booking reminders for your customers. Now, they can receive timely reminders about their upcoming bookings via their preferred communication channels and not only via mail.

  Ensure that your customers never miss an appointment again and provide them with a convenient and personalized experience. We have also enabled this feature for self-check-in notifications.

  <img alt="" />

  ### 🌐 New booking page button

  **🖱️ On-Click access to booking links:** Say goodbye to the hassle of searching for booking page links! With our new booking page button, you can now access all booking page and community page links in one convenient place.

  Simply click on the button to open a modal window that displays all the relevant links, making it easier than ever to manage your bookings and connect with your community.

  <img alt="" />
</Update>

<Update label="Jan 31, 2024">
  ## New Version of our Outlook Add-In

  We have just released version 1.1.0 of our Outlook Add-In for Microsoft. This version brings significant performance optimizations and is now also compatible with older versions of Outlook. The update will automatically rolled-out by Microsoft over the next days.
</Update>

<Update label="Jan 15, 2024">
  ## Introducing anny Display

  We recently launched the [anny mobile app](https://anny.co/features/mobile-app?utm_source=newsletter\&utm_medium=email\&utm_campaign=newsletter-display-app-release), and now we're excited to introduce our second app - **anny Display**! 🎉

  Visualize digital bookings in the real world and get insights into the availability of your resources at a glance.

  **How can I use the app?**

  * **As a Room Display**: Install any tablet at your meeting room and use the anny display app as a status indicator and for ad-hoc booking.
  * **As a Wayfinder**: Use a larger display in the entrance area to show an overview of various resources in real-time.
  * **As a Booking Terminal**: Whether at the entrance of your office or in the library - with anny Display, ad-hoc bookings of workspaces, as well as check-ins are faster than ever.

  **What does anny Display offer?**

  * **Visualization of Availability**: Avoid interrupting ongoing meetings with live updates on free and reserved rooms.
  * **Flexible Booking Options**: anny Display enables seamless ad-hoc bookings and planned reservations – anonymously, with a QR-code pass, or via NFC.
  * **Check-In & Check-Out**: Booked a room but not using it? Meeting ended earlier than planned? Automatically release capacities - for optimal utilization and use of your resources.

  With the anny Display app, we are setting new standards in resource management: It offers unparalleled transparency in availability and enables optimal utilization of your resources.

  Do you want to download anny Display now? You can find it directly inside the stores:

  * [iOS](https://s.anny.co/app-store-display)
  * [Android](https://s.anny.co/play-store-display)
</Update>


# 2025
Source: https://docs.anny.co/changelog/2025

Follow the updates and improvements made to the anny platform in 2025.

<Update label="Dec 23, 2025">
  ## TikTok Pixel & Conversion API Integration

  <img alt="" />

  Track and optimize your TikTok campaigns directly on your anny booking pages. anny now supports TikTok Pixel and Conversion API so you can better understand user behavior and improve ad performance.

  ❓**What it does**

  * Add your TikTok Pixel ID in the anny admin to connect your booking pages with TikTok.
  * anny automatically sends key events (e.g. page views, bookings) to TikTok whenever cookies are accepted.
  * Optionally add an Access Token to enable TikTok Conversion API and track conversions even if users do not accept cookies.
  * Use the event data in TikTok Ads Manager to analyze performance, build better audiences and let the algorithm optimize towards real bookings.
  * Close tracking gaps with server‑side events so your reporting stays accurate and your optimization signals reliable.

  💡 **Example**

  A yoga studio can promote its classes on TikTok, see which campaigns drive the most bookings and automatically optimize spend based on real conversions.

  This feature helps you measure the true impact of TikTok ads that link directly to your anny booking page and gives the TikTok algorithm better signals to find the right customers.

  Find out more in the help center article: [https://docs.anny.co/de/articles/508569-tiktok-ads-tracking](https://docs.anny.co/de/articles/508569-tiktok-ads-tracking)
</Update>

<Update label="Dec 23, 2025">
  ## Meta Pixel integration for precise conversion tracking

  <img alt="" />

  You can now connect your Meta Pixel directly in anny to track and optimize conversions from your booking pages.

  ❓**What it does**

  * Add your Meta Pixel ID in the anny admin to automatically send booking events to Meta
  * Tracks events when users accept cookies on your booking page
  * Optionally add a Meta Conversion API access token to capture conversions even when cookies are rejected
  * Sends relevant booking events to Meta so ad performance and attribution are more accurate
  * Enables Meta’s ad algorithm to optimize delivery toward people who are more likely to book

  💡 **Example**

  A wakepark promoting tickets on Meta can now see exactly which ads lead to bookings and let the algorithm automatically find similar guests.

  This feature helps you understand how well your Meta ads drive bookings and lets Meta optimize your campaigns based on real conversions, even with limited cookie data.

  Find out more in the help center article: [https://docs.anny.co/en/articles/508568-set-up-meta-ads-tracking](https://docs.anny.co/en/articles/508568-set-up-meta-ads-tracking)
</Update>

<Update label="Dec 22, 2025">
  ## Merge duplicate customers

  <img alt="" />

  You can now merge duplicate customers directly in anny. This keeps your customer database clean and ensures all bookings and subscriptions are collected under a single profile.

  ❓ **What it does**

  * Adds a new **Merge** action in the customer table and customer detail view
  * Lets admins select two customer records and merge them into one
  * Transfers all bookings, subscriptions and related data to the target customer
  * Updates missing data fields on the target customer with information from the other record
  * Helps resolve duplicates that occur when customers book with multiple email addresses

  💡 **Example**

  If a customer has made a booking using their private email address and another using their company email address, you can now merge both records into one complete customer entry.

  This feature reduces manual clean-up work and improves data quality in your admin area.
</Update>

<Update label="Dec 16, 2025">
  ## n8n integration for custom workflows

  <img alt="" />

  With the new n8n integration, you can use anny as a node in your n8n cloud workspace to automate complex, individual processes around bookings, customers and invoices. Authorization and webhook handling are managed directly in n8n, so you can focus on building smart workflows.

  ❓ **What it does**

  * Provides a dedicated **anny node** in n8n Cloud
  * Offers multiple **triggers**, such as:
    * Booking created
    * Booking checked in
    * Booking starts
    * Booking ends
    * Invoice created
    * Customer created
  * Includes **actions** to interact with anny data via API
  * Handles **authorization** and **webhook management** automatically
  * Enables automations across CRM, newsletter systems, IoT hardware, accounting tools, and AI-powered workflows
  * Supports connections to **1,269+ integrations** in n8n
</Update>

<Update label="Dec 16, 2025">
  ## Custom Forms for Subscriptios

  <img alt="" />

  You can now create custom forms and attach them to your subscription plans to collect exactly the information you need from your customers, including file uploads.

  **❓ What it does**

  * Allows admins to create custom forms and link them to specific subscription plans
  * Supports file uploads (e.g., PDFs, images) within subscription forms
  * Shows submitted form data on the subscription detail page and/or the customer record, depending on configuration
  * Ensures all required information for a subscription is collected during the first subscription purchase in the plan group

  💡 **Example**

  A coworking space offers a monthly membership that requires a brief KYC check.<br />When a new member subscribes for the first time, they are automatically asked to complete a custom form that includes identification details and a PDF upload field.<br />The admin team can view the submitted file and data directly on the subscription record, no emails, no manual tracking, no missing documents.
</Update>

<Update label="Dec 15, 2025">
  ## UniFi Smart Lock Integration: Automated Access Control per Booking

  <img alt="" />

  Automatically connect your UniFi Door Access smart locks with anny bookings to grant and revoke access just in time. No more manual key handovers, spreadsheets or permanent access that nobody remembers to clean up.

  ❓ **What it does**

  * Connects UniFi Door Access via host URL and API token directly with anny
  * Creates time-boxed access per booking so guests only enter during their reserved slot
  * Supports three types of access:

  → **Remote open**: one-click opening from anny as you are used to

  → **Visitor access**: PIN code that is valid between booking start and end time

  → **User access**: just-in-time access for existing UniFi users, adding the right access policy and locks for the booking duration and removing it afterward

  * Lets you disable user access in the settings if you always want PIN-based visitor access instead
  * Works only with UniFi Door Access devices (no WiFi management included)

  💡 **Example**

  A coworking space can automatically send a PIN code to meeting room guests for the exact booking time and revoke it afterward, without staff needing to be on site.
</Update>

<Update label="Dec 9, 2025">
  ## Confirm all requested bookings in an order with one click

  <img alt="" />

  You can now confirm all requested bookings within a single order in one action. This is ideal for workflows with many booking requests, such as equipment rental or bulk reservations.

  ❓ **What it does**

  * New action **“Confirm bookings”** available in the order detail view
  * Action appears when *all* bookings in the order have the status **requested**
  * Confirms all requested bookings in that order with one click
  * End customers receive **one consolidated email** instead of multiple notifications
  * Significant reduction of manual processing effort for large orders (e.g., 100+ bookings)

  💡 **Example**

  A customer submits a booking request for **30 pottery workshops** in one order. Instead of confirming each workshop individually, the admin opens the order and selects **“Confirm bookings”**. All 30 requested workshops are approved with a single click, and the customer receives just **one consolidated confirmation email**.

  Find out more in the helpcenter article: [https://docs.anny.co/en/articles/374769-booking-management-with-anny](https://docs.anny.co/en/articles/374769-booking-management-with-anny)
</Update>

<Update label="Nov 20, 2025">
  ## Updated Outlook add-in

  <img alt="" />

  We’ve released a major update to the anny Outlook Add-In, delivering a completely redesigned interface and several new features that make scheduling with anny inside Outlook faster and more intuitive.

  ❓**What it does**

  * **Full compatibility with both** [**anny.eu**](http://anny.eu) **and** [**anny.co**](http://anny.co)
  * **Automatic login** for all users who authenticate via Microsoft SSO
  * **Capacity-based filtering** when adding participants to a booking (provided that the capacity property is specified for the rooms)
  * **New map view** for easier spatial navigation
  * **Completely redesigned UI** for a cleaner and more modern experience
  * **Participant synchronization:** Outlook attendees are now synced directly into the anny booking
  * **Free-text search** in the add-in
  * **Manage bookings after scheduling:** View, cancel or add bookings to existing Outlook events
  * All directly available **inside the Outlook Add-In when creating or editing appointments**

  This update brings a faster, more intuitive workflow to everyday scheduling — especially for teams who regularly connect Outlook appointments with resource bookings in anny.

  See how to install it here: [https://docs.anny.co/en/articles/111817-how-do-i-add-the-outlook-add-in](https://docs.anny.co/en/articles/111817-how-do-i-add-the-outlook-add-in)
</Update>

<Update label="Nov 19, 2025">
  ## Advanced Service Setting: Allow Cross-Blocker Bookings

  <img alt="" />

  A new advanced service setting is now available: **Allow Cross-Blocker Bookings**. When enabled, bookings are permitted to start **before** a blocker and end **after** a blocker.

  ❓**What it does**

  * Allows bookings to extend across existing blockers
  * Bookings may begin before a blocker and finish after a blocker
  * Provides more flexibility for services with overlapping time needs

  💡 **Example**

  A meeting room has a 10-minute buffer blocker between two time slots for a quick room reset.<br />Another team wants to book the room for the entire morning:

  * 09:00–12:00<br />→ 10:50–11:00 blocker

  With the new setting, this booking can now still be made.

  Read on here: [https://docs.anny.co/en/articles/249541-global-blockers-and-holiday-blockers](https://docs.anny.co/en/articles/249541-global-blockers-and-holiday-blockers)
</Update>

<Update label="Nov 19, 2025">
  ## Improved Participant Management

  <img alt="" />

  We’ve introduced several enhancements to make managing participants in bookings more flexible and transparent across tools.

  **❓ What’s new**

  * **Define minimum and maximum participant numbers:** You can now set clear participation limits for each booking to ensure capacity requirements are met.
  * **Full compatibility with external calendars:** Participants are automatically added to Outlook, Google Calendar & other connected calendars, including invitation handling.
  * **Participants visible everywhere:** In the Planner, Calendar, and on Display, all assigned participants are now shown, providing a clearer overview of who is attending.
  * **Integrated RSVP management in anny:** When participants are added to a booking, they can respond to it. All responses are synced, giving you up-to-date attendance information at a glance.

  **💡 Example**

  A team books a **meeting room for a workshop**:

  * The service requires **at least 3 and max. 12 participants**, so the booking automatically checks the correct capacity.
  * When the organizer adds participants, they are **instantly added to the Outlook or Google Calendar event**, including the official invitation.
  * In the **Planner, Calendar, and Display views**, everyone can immediately see **who is attending** the workshop.
  * Each participant can **RSVP directly in anny** (accept or decline), and these responses are synced across anny and external calendars, giving the organizer a clear, up-to-date view of attendance.

  Learn more here: [https://docs.anny.co/en/articles/470645-participants-management](https://docs.anny.co/en/articles/470645-participants-management)
</Update>

<Update label="Nov 19, 2025">
  ## Designer 2.2: Performance & usability enhancements

  <img alt="" />

  The latest update to the anny Designer brings several enhancements that make creating and editing booking pages faster and more intuitive.

  ❓**What’s new**

  * **Improved performance:** Faster loading and smoother interactions when working with complex layouts or larger designs.
  * **Simplified element grouping:** Elements can now be grouped and managed more easily, making layouts clearer and reducing editing steps.
  * **Updated interface design:** Visual optimizations for a cleaner, more consistent design experience.

  These improvements make the Designer more responsive and user-friendly.
</Update>

<Update label="Nov 19, 2025">
  ## Simplified Selection on the Booking Page

  <img alt="" />

  We’ve introduced a streamlined way to **add resources to the cart directly from the booking flow**, especially helpful for customers who rent out resources for short periods.

  ❓**What it does**

  * Activates automatically when using the **date and time filter** on the Explore page.
  * Adds a **“+” button** to the available time slots (“time pills”), allowing you to add the selected resource with the chosen service directly to the cart.
  * The selected **service can be adjusted** using the arrow buttons before adding it to the cart.
  * **Add-ons** can be selected later during the checkout process.
  * The **booking title step is skipped**, even if it’s normally required, to speed up the flow.

  💡 **Example**

  If you rent out short-term resources like sports courts, meeting rooms, or equipment, users can now select a time slot on the booking page and add it to the cart instantly. making the booking process faster.
</Update>

<Update label="Nov 19, 2025">
  ## Remote-Open for Smart Locks

  <img alt="" />

  Your customers can now open booked rooms **directly from the anny app**, but only if they have a valid booking.<br />With the new **Remote-open** feature (available for **Nuki** and **Kleverkey**) and a new dedicated section on the anny homepage, access is now even smoother, while remaining secure and fully tied to valid booking rules or community access.

  ❓**What it does**

  * Enables **remote unlocking** of doors directly from the anny app (Tap to open)
  * Provides additional access options depending on the Smart Lock provider:
    * **QR code** displayed in the app
    * **PIN code** shown in the app
    * **Direct launch** of the provider’s Smart Lock app
  * Shows all available Smart Locks on the **anny homepage** in a dedicated section
  * Ensures access only works within a **valid booking timeframe** or for users with **community access**
  * Available in both the **anny mobile app** and the **web app**

  🔑 **Provider-specific setup**

  **Nuki**

  * Re-authorize the integration once in the anny admin area
  * You will be prompted to allow **Remote-access**
  * Afterwards, enable **Remote-open per rule**

  **KleverKey**

  * Remote-open is available immediately
  * Simply activate **Remote-open per rule**

  Find more information in our helpcenter article: [https://docs.anny.co/en/articles/30481-smart-lock-integrations](https://docs.anny.co/en/articles/30481-smart-lock-integrations)
</Update>

<Update label="Nov 19, 2025">
  ## Add Images, Videos & Files to Resource Descriptions

  <img alt="" />

  You can now enhance your resource descriptions by embedding **images, videos and files** directly within the text. This allows you to present resources more visually and provide important information right where users expect it.

  ❓ **What it does**

  * Allows you to insert images directly into the resource description for better visual presentation.
  * Supports embedding videos (via YouTube, Vimeo or Loom) inside the description.
  * Enables adding files such as PDFs directly into the text.
  * Helps structure content more clearly with visual elements placed exactly where they add the most context.

  💡 **Example**

  In the description of a **padel court**, you can now embed:

  * an **image of the court**
  * a **short introduction video** explaining how to use the court
  * a **PDF with game rules**

  This gives players all essential information at a glance, reduces follow-up questions, and provides a more complete and professional presentation of the resource.
</Update>

<Update label="Nov 19, 2025">
  ## Add Files to Your Resource Pages

  <img alt="" />

  You can now upload **attachments directly to your resource pages** in anny, this makes it easier to provide important documents, images or videos associated with each resource.

  ❓ **What it does**

  * Allows you to attach files, images, archives, and videos to any resource.
  * Files appear on the resource’s booking page, where they can be downloaded or viewed by users.
  * Typical use cases include:
    * Catering menu
    * Product data sheet for equipment
    * Seating plans or room layouts
    * Tutorial videos
  * Upload is simple: just open the resource, scroll to the “Files” section, drag & drop or select the file, then save.

  **💡 Example**

  For an event space that includes catering options, you can now upload the catering menu as a PDF. Visitors to the booking page will see the document ready for download or review, without you needing to send it separately.

  Learn more here about the file types: [https://docs.anny.co/en/articles/445803-how-can-i-attach-files-images-videos-documents-to-a-resource](https://docs.anny.co/en/articles/445803-how-can-i-attach-files-images-videos-documents-to-a-resource)
</Update>

<Update label="Nov 19, 2025">
  ## Link Resources, Plans & Booking Packages in Service Descriptions

  <img alt="" />

  You can now add direct links to **resources**, **subscription plans**, and **booking packages** within your service descriptions. This makes it easier to structure information and highlight relevant connections between your offerings.

  **❓ What it does**

  * Allows you to link relevant **resources** directly inside the service description.
  * Supports linking to **plans**, e.g., membership.
  * Enables linking **booking packages**, useful when a service can be combined with package-based bookings.
  * Lets users open linked elements immediately, without having to search for them elsewhere.

  **💡 Example**

  In the description of a **Coworking Open Space** resource, you can now directly link:<br />– a meeting room,<br />– a 5-session pass, and<br />– the corresponding membership plans.

  This gives users an immediate overview of all connected options without having to search elsewhere.
</Update>

<Update label="Nov 19, 2025">
  ## AI-Powered Automatic Translations

  <img alt="" />

  You can now manage translations for your content in a more structured and consistent way across anny. This includes not only **standard fields** but also your **custom fields**, ensuring a fully multilingual experience for your users.

  **❓ What it does**

  * Allows you to translate all relevant content fields directly in the admin interface.
  * Supports translations for custom fields, including labels, descriptions, and placeholder texts.
  * Provides a clear language-switching interface so you can edit multiple languages side by side.
  * Ensures your booking pages display the correct language based on user selection or browser settings.

  Learn more in our Helpcenter article: [https://docs.anny.co/en/articles/445372-how-can-i-translate-content-into-multiple-languages-and-translate-custom-fields](https://docs.anny.co/en/articles/445372-how-can-i-translate-content-into-multiple-languages-and-translate-custom-fields)
</Update>

<Update label="Nov 19, 2025">
  ## Integration with Shelly Switches

  <img alt="" />

  The new Shelly integration allows you to connect booking activities in anny with your Shelly smart switches. Shelly devices are compact, WiFi-enabled relays installed in the power line of a device (e.g., a lamp) or behind a light switch.

  **❓ What it does**

  * Links selected anny resources with your Shelly switches.
  * Triggers actions on your Shelly devices based on booking activity.
  * Supports the following booking-based triggers:
    * **Booking starts**
    * **Booking ends**
    * **Booking checked in**
    * **Booking checked out**

  **💬 Example**

  When a booking starts, a Shelly switch can automatically turn on the lights in the room; when the booking ends, the switch can turn them off, no manual interaction needed.

  Learn more here: [https://docs.anny.co/en/articles/410051-shelly-integration](https://docs.anny.co/en/articles/410051-shelly-integration)
</Update>

<Update label="Nov 19, 2025">
  ## Integration with Tapirx E-Paper Displays

  <img alt="" />

  anny now supports a direct integration with **Tapirx E-Paper Displays**, allowing you to link displays to your resources and keep availability information automatically up to date.

  **❓ What it does**

  * Connects Tapirx E-Paper Displays directly to selected resources in your anny account.
  * Automatically updates each linked display with the latest availability and scheduling information.
  * Supports the current Tapirx device lineup, including:
    * **Tapirx Mini 4.2"**
    * **Tapirx Touch 7.5"**
    * **Tapirx 7.5"**
  * Works with the Tapirx infrastructure for long-lasting, low-maintenance E-ink displays.

  **💬 Example**

  Link a room resource to a Tapirx display mounted outside the door, the device will show the current availability without any manual updates.

  **💡 Interested?**

  Fill out this form and we’ll create a non-binding offer for you together with Tapirx: [https://tally.so/r/mDXdkE](https://tally.so/r/mDXdkE)
</Update>

<Update label="Nov 19, 2025">
  ## Webhooks: Real-time Activity Notifications

  <img alt="" />

  With Webhooks, anny can now send real-time notifications to your systems whenever specific events occur.

  **❓ What it does**

  * Sends an HTTP request to a URL you define whenever selected events happen in anny.
  * Supports events across bookings, orders, invoices, and customers, including create, update, and delete actions.
  * Allows filtering booking-related events by resources, services, or categories.
  * Delivers structured JSON payloads containing event metadata and the affected object.
  * Signs each webhook request so you can verify authenticity.
  * Stores a delivery history and retries failed deliveries automatically.

  **💬 Example**

  When a new booking is created, anny immediately sends the booking data to your endpoint, where you can trigger further processing such as notifications or system updates.

  Learn more here: [https://docs.anny.co/en/articles/349740-webhooks](https://docs.anny.co/en/articles/349740-webhooks)
</Update>

<Update label="Nov 16, 2025">
  ## Manage schedules more easily with groups & temporary variants

  Managing your schedules is now **much easier**.<br />With the new features for **schedule groups and temporary schedules**, you can make changes centrally and respond flexibly to temporary differences.

  1. **Schedule groups: Central control for multiple resources**

  Previously, you had to create and adjust the same schedule for each resource individually.<br />Now you can **link a schedule to multiple resources** and manage changes centrally.

  💡 **Example**:<br />Your standard opening hours apply to all rooms. When you adjust them in a schedule, they are automatically updated for all linked resources.

  2. **Temporary schedules: Set different times for specific periods**

  Some periods require special opening hours, such as during the summer months or the holiday season.<br />With temporary schedules, you can **create additional variants of your standard schedule** that are only active during a specific period.

  💡 **Example**:

  Your regular opening hours apply throughout the year, but you want to be open longer in the summer. Simply create a seasonal variant for this period, and anny will automatically activate it and then revert back to the standard hours.
</Update>

<Update label="Nov 13, 2025">
  ## New community management options

  👬 Additional settings for communities

  Until now, the incognito mode setting was up to the users—now, as an admin, you can specify this. You can choose between:

  * All users are incognito
  * All users are visible
  * All users are incognito by default, but can adjust their settings
  * All users are visible by default, but can adjust their settings

  We have introduced a role system for communities. You can choose between the following roles:

  * Member (can view and book members)
  * Observer (can view members but not book them)
  * Visitor (can book but not view other members)

  These roles can now be set for automatic membership, so every member starts with this role. The role can be adjusted later.

  The invitation function has also been upgraded:

  * You can now customize the text for an invitation to a community.
  * You can now "silently invite" new members, meaning that members are added without receiving any information about it.

  If you want to add a member to a community for a specific period of time, simply set a start and end date before inviting the member.
</Update>

<Update label="Nov 13, 2025">
  ## Individual settings for child resources

  * Child resources can now be deactivated individually
  * Properties can now be selected for each child resource

    <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## Improved Resource Calendar Overview

  * **Optimized Child Resource Calendar View:** Now you can see more child resources at a glance without needing to scroll.
  * **Enhanced Visibility:** Improved layout provides a clearer overview of the availability of child resources.
  * **Week View for Resources:** Plan and organize with an expanded weekly perspective for each resource.
  * **Full Screen Calendar Display:** Dive into a comprehensive full screen view for detailed scheduling.
  * **Refined Color Coding:** Quickly discern the availability of resources with an optimized color scheme.
  * **Participant Display on Booking Slots:** Easily view all participants directly within each booking slot.
    <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## New Filters to find people in the office

  We've enhanced our search functionality with the introduction of additional filters to help you find people more effectively. You can now refine your searches by applying filters for Dates, Addresses, and Communities, making it easier and faster to locate the person you are searching for.

  <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## Filtered and column-based exports

  * The current view can now also be filtered, meaning that all currently selected columns and filters are taken into account during export.
  * Columns can now also be configured for automatic exports.

    <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## New Smart lock integrations: Comydo und Dormakaba Resivo

  We are pleased to announce an expansion of our smart lock integrations with the addition of a new provider, **Comydo**. This partnership is part of our ongoing effort to broaden the range of options available to our customers, ensuring greater flexibility and security in access solutions.

  Furthermore, we are excited to reveal that our Dormakaba family has grown. You now have the capability to integrate **Dormakaba Resivo** locks with your existing resources.

  <img alt="" />
</Update>

<Update label="Nov 13, 2025">
  ## Map Designer 2.0 with enhanced features

  The Map Designer got some updates for an enhanced usability.

  What's new?

  🧑‍💻 Better UX: you can now design your maps in full screen, the allocation of resources has been significantly simplified, and you can now search for (child) resources

  ⛓️‍💥 There is now a snapping mode that makes designing the map much easier

  🚪You can now insert doors and windows

  📋 There are now many more templates, and you can save your own templates and use them organization-wide

  💬 You can now also add text elements

  🙂 We have significantly expanded the selection of icons
</Update>

<Update label="Sep 1, 2025">
  ## Innovative power features for your anny check-in app ✨

  With our check-in app, we have already set new standards for smooth entry this year. But we wouldn't be anny if we rested on our laurels! That's why we've added some new features to our check-in app, which we'd like to introduce to you today.

  ### 🚦New settings for check-ins and appointment bookings at the terminal

  You can choose not to link check-in, registration, and check-out to the opening hours of your resources. You can also decide whether users can check in only one or all of your organization's resources at the terminal and can specifically disable spontaneous booking for individual resources.

  ### 💳 Check-in and registration with customer pass

  Make it even easier for your loyal users! From now on, your users can check in not only with the booking QR code, but also directly with the QR code on their customer card or from the anny app.

  ### 🔒 No-Interaction Mode

  This mode is ideal for terminals without touch displays and offers additional security. When activated, interaction with the screen is completely disabled. Your users can then authenticate themselves only by scanning their QR code. This prevents unauthorized entries and ensures a clear, secure process.

  ### 😴 Sleep mode

  Reduce energy consumption and lower your operating expenses. Set fixed times when the display automatically dims—for example, at night or on weekends.

  <img alt="" />

  ### ⛔️ Out-of-order mode

  Want to temporarily close the terminal for bookings and check-ins? Manually set it to “Out of service” and leave a custom message for your users so everyone knows.

  The new features are already available for you! Take a look at the settings on your check-in displays and customize everything to your liking: [https://app.anny.co/displays?type=check-in](https://app.anny.co/displays?type=check-in)
</Update>

<Update label="Jul 9, 2025">
  ## The new Microsoft Teams app is there

  The new anny Teams app is available! In addition to a new look and feel, the Teams app now has a new user interface and an automatic login feature with your Microsoft 365 account.

  ### Automatic login

  For automatic login, the Teams app asks each user once for authorization to read out the active user. This is followed by a confirmation screen.

  **Tip:** As an admin, you can assign the authorization for all users of the organization so that this does not have to be done individually. If it is deactivated in Entra that users can independently assign an app consent, it is necessary for the new Teams app to be activated once by the administrator.

  The new update is available automatically. If you are not yet using the Teams app, you can find a short guide [here](https://docs.anny.co/en/articles/115390-how-do-i-add-the-anny-ms-teams-app).
</Update>

<Update label="Jun 21, 2025">
  ## 📤 Let your users upload documents

  Have you ever had to chase after important documents? From now on, your users can upload the necessary files directly when making a booking.

  Whether it's proof of identity, required images, or an application form, everything is stored directly and securely in the respective booking, saving you time. The advantage for you is that all the necessary documents are immediately where they belong, without the need for extra emails.

  Simply use the new “File” field in the forms. Here you also have various setting options, such as permitted file types, maximum size, and number of files to be uploaded.
</Update>

<Update label="May 21, 2025">
  ## The waiting list for your resources 📋

  Is the desired seminar already fully booked, or is your course already filled? The best dates often sell out quickly. With anny's newest feature—the **waiting list**—cancellation is no longer a hassle but rather an opportunity!

  With the new waiting list function, you enable your users to simply put themselves on a waiting list when resources are fully booked. As soon as a place becomes available again - for example, due to a cancellation - the interested parties on the waiting list are automatically notified by email. This way, no spots remain empty, and your users can look forward to one of the coveted spots.

  **Your advantages at a glance**

  * Maximum utilization: Automatically fill gaps caused by cancellations. This applies to both your paid resources and free offers.
  * Happier users: Reduce frustration when appointments are fully booked and offer your users a second chance.
  * Fully automatic: Once activated, anny takes care of everything. No manual effort for you.

  **How does this work for your users? It's very simple!**

  1. If a desired resource is fully booked at the desired time, your users will see the “Add to waiting list” button.
  2. They can register with one click.
  3. If the space becomes available again, the person will automatically receive a notification and can book the appointment directly.
</Update>

<Update label="May 17, 2025">
  ## ᝰ.ᐟ Have legal documents confirmed directly

  In addition to file uploads, you can now also have important documents such as consent forms or disclaimers confirmed directly during the booking process – via a simple checkbox or legally binding digital signature:

  1. Confirmation via checkbox: Perfect for simple consent. Your users simply tick a box to confirm that they have read and understood the document.
  2. Confirmation via digital signature: always the right choice when you need an explicit and legally binding signature. Your users can sign directly at checkout on their smartphone or computer.

  The confirmed document is automatically and securely stored in the respective booking and in the customer file. This means you always have everything in one place and at your fingertips.

  **Your advantage: less effort, more security**

  * **Efficient:** No more manual sending of documents.
  * **User-friendly:** A smooth and completely digital process for your customers in anny.
  * **Legally compliant:** Receive necessary confirmations in a verifiable and digitally documented form.

  You are welcome to check out our Help Center article: [https://docs.anny.co/en/articles/342201-confirming-legal-documents-during-booking](https://docs.anny.co/en/articles/342201-confirming-legal-documents-during-booking)
</Update>

<Update label="Apr 15, 2025">
  ## The new anny is live 🥳

  The wait is over: the new anny is here!

  We are very excited about this milestone and are looking forward to finally sharing all the new features with you. Even though some things have changed, our mission remains the same: We want to help you share and use all resources as easily and efficiently as possible - and that's exactly what we've improved even further with this update.

  We have summarized the most important questions and answers about the launch in [this help center article](https://docs.anny.co/en/articles/302455-faq-the-new-anny).

  <img alt="" />

  ### **New: Connected Persons & Book-on-behalf**

  Connected Persons allows you to connect directly with other people and assign individual authorizations:

  * **Read bookings -** View the bookings of others and thus reduce the coordination effort.
  * **Book-on-behalf -** Make bookings on behalf of other people. Perfect for teams, assistant roles, and shared resources.
  * **Edit bookings -** You can cancel the bookings of other users. This allows you to put your entire booking management in the hands of others.
  * \*\*Notify about bookings -\*\*Receive a notification as soon as a booking is made by a person connected to you. This way you can ensure that you don't miss any important changes and can react to them.

  All authorizations can be requested or released individually. To do this, a request is sent between the people (peer-to-peer) directly from the user bio or the profile settings. The connections cannot be controlled externally (e.g. by admins).

  <img alt="" />

  ### **Simplified navigation**

  We have restructured the navigation to give you a better overview of our platform so that you can find the functions you want even more easily.

  The most important changes at a glance:

  * **Navigation in the header -** The main navigation is now at the top of the header, providing a clearer structure and a better overview.
  * **Explore -** All resources from your communities can now be found centrally on the new Explore Page, whereby individual community pages and their navigation points have been removed. You can also set a filter for communities on the Explore page. You can find more information on this in the next section.
  * **Planner -** The weekly planner can be accessed as usual under the new menu item ‘Planner’. The separate favorites page is no longer available; instead, favorites can be managed directly in the planner and via the homepage (soon).
  * **Profile -** You can now access your profile settings and notifications via your avatar in the top right-hand corner.
  * **Homepage (soon) -** You can also look forward to a new homepage with a customized overview of your upcoming bookings.

    <img alt="" />

  ### **New: Explore page for a centralized overview**

  Another new feature is the Explore page - your central location for quick and easy bookings. Instead of switching between individual communities, you will now find all resources ( approved for you) bundled on one page for the first time.

  The most important facts at a glance:

  * **A central overview -** Search and filter all bookable resources from your communities.
  * **Existing community links remain** - they automatically redirect to the new Explore page. Resources can also be filtered by community here.
  * **Precise search with location & property filters -** Advanced property filters allow you to search better and faster. Locations and addresses can also be filtered in the search bar. The option to filter by individual groups has been removed.
  * **Smarter period search -** Find the right resource in no time at all, simply enter a desired duration (e.g. ‘30 minutes between 1 pm and 3 pm’) and the system will show you available slots.
  * \*\*Sharing made easy -\*\*Filter settings such as category, location, community, or properties are saved directly in the URL so that you can easily share a predefined search or call it up again later.
  * **Occupation indicator -** The new occupation indicator shows you directly which resources are available or heavily booked at which times - allowing you to better plan your bookings.

    <img alt="" />

  ### **Calendar**

  The new calendar view makes planning your booking times and resources even easier. With a clearer structure and more details, you can find free resources without any detours. The calendar is accessible via the Discover, Organization, and Resources pages.

  The most important changes at a glance:

  * **New calendar view -** you can see at a glance when which resources are free. The visual overview of availabilities allows you to quickly find a suitable time even if you don't yet know exactly when you want to book. This makes your planning flexible.
  * **Visible booking title -** See the details of the booking and the person making the booking in the calendar, provided you have the appropriate authorization. This gives you all the information you need immediately and helps you plan better.
  * **Full screen view -** The calendar can be expanded to full screen, giving you a clear overview of a larger number of resources and making it easier to navigate through the calendar.
  * **Child resources are directly visible -** On the resources page, all connected child resources are displayed in the calendar - for an improved overview of possible booking times.
  * **Interactivity (coming soon) -** Soon you will be able to make bookings interactively in the calendar.

    <img alt="" />

  ### **Resources page**

  The Resources page and the booking interface have been improved so that you can find what you're looking for even faster and make your bookings with ease.

  The most important changes at a glance:

  * **Optimized booking interface -** The selection of add-ons and the entire booking process are now even clearer.
  * **New image gallery -** See more images at a glance: Instead of one large image, 3 images are now displayed and you can view a full-screen gallery.
  * **New look for quotas -** The display of quotas has been optimized and is now more clearly structured.

    <img alt="" />

  ### **Organization page**

  The  organization page has also received an upgrade: New filter options and a revised design make your range of resources clearer and more dynamic.

  The most important new features at a glance:

  * \*\*New filter & search function -\*\*Find resources more easily - The function is similar to the new Explore page.
  * **All shared resources visible -** In addition to public resources, you can now also see all resources that you have access to via your communities.
  * **Modern design for services, subscriptions & packages -** All pages have been visually improved and are now more clearly structured for a more pleasant booking experience.
  * **Links to subscription & package pages -** Subscriptions and booking packages now have their own pages with direct links that can be redirected to ensure easy finding and quick booking.

    <img alt="" />

  ### **Shopping cart & check-out**

  The checkout and shopping cart process has been further developed so that bookings can be completed smoothly.

  The most important new features at a glance:

  * **New design & layout -** Modern and intuitive for a pleasant booking experience.
  * **Optimized booking summary**
    * \*\*Clear structure -\*\*See all bookings at a glance in a structured list.
    * **Batch view for event bookings -** Multiple bookings, e.g. for the same event, are now visually summarized as a batch for a better overview.
  * **Recommendations in the shopping cart & checkout -** During the booking process, recommendations you have set for other suitable resources now appear. Recommendations can be set via ‘additional options’ in the settings of the service/booking option.
  * \*\*Upload documents as custom field -\*\*Documents can now be uploaded directly in the checkout to save you further work steps.

    <img alt="" />

  ### **Planner**

  The week planner is now called Planner and has been comprehensively improved. It offers more intuitive navigation and more control over your bookings.

  The most important new features at a glance:

  * **Simplified onboarding & favorites management**
    * **Add or remove favorites directly in the Planner -** You don't have to open a separate page, which saves time and makes your booking process more efficient.
    * **Complete list of all accessible resources (incl. child resources) -** Select your favorites with just one click.
    * **Filter by community -** Show only your favorite resources within a selected community to book exactly what you need faster.
  * **Optimized booking creation & management**
    * \*\*No more ‘+ New Booking’ button -\*\*Bookings can now be completed in no time at all via the new Explore page.
    * **Multiple bookings possible -** Instead of booking the same resource only once a day, you can now book e.g. a meeting room several times a day in the planner.
    * **Book for other people**- If you have the authorization, you can book for someone else directly via the planner (book-on-behalf).
  * **New context menu for resources (three-dot menu)**
    * \*\*‘Book on behalf of...’ -\*\*Carry out bookings for others.
    * **‘Add/remove to favorites’ -** Quick and uncomplicated favorites management without detours.
    * **‘Show resource page’ -** Direct access to all important details.
  * **Visible booking title -** Titles are now displayed directly in the booking preview so that you can identify bookings more quickly and keep a better overview.
  * \*\*Search for members, sorted by distance -\*\*The button for searching for members has been moved to the top right of the Planner. If a filter by roles or properties is active, people are automatically sorted by distance.
  * \*\*Connect with team members (Connected Persons) -\*\*Connect with colleagues to manage bookings together and increase your visibility in the team.
  * \*\*Manage favorite resources -\*\*The new settings button at the top right of the Planner can be used to directly manage the displayed, favorite resources.

  ### **Profile page**

  Your profile gets a fresh, modern design that seamlessly adapts to the mobile app.

  The most important new features at a glance:

  * **New, modern design** - Clearer and based on the mobile app for a standardised user experience.
  * **Management of connections (Connected Persons) -** You can easily manage your connections from the new Connected Persons feature here.
</Update>

<Update label="Mar 19, 2025">
  ## Send messages to your users with the broadcasting feature 📣

  Until now, targeted communication to individual users has been difficult to implement. This changes with our new broadcasting feature.

  No matter whether you want to inform them about room changes, a course is canceled, or you want to remind them of the workplace bookings for the next week. From now on, you can communicate with your users quickly, easily, and in a targeted manner - directly from anny.

  ### What is the broadcasting feature?

  Broadcasting allows you to send messages to selected recipients. You can use various filters to determine the exact group of recipients and decide who receives the message, when, and via which channel.

  Your advantages at a glance:

  * **Targeted recipient lists:** Filter your users according to booking details (e.g. booked resource, time period) or customer data (e.g. community affiliation, birthday).
  * **Multi-channel dispatch:** Reach your users wherever they are. Choose between email, SMS and push notifications in the anny app.
  * **Personalized approach:** Use placeholders such as #firstname or #resource to make your messages more personal and relevant.
  * **Save templates:** Create a message once and use it again and again to save time.

  ### Use cases

  To show you how versatile the new feature is, we have collected a few examples for you here:

  **One-time messages for current events**

  * **Changed opening hours:** “Dear users, our coworking space will be closed on the upcoming public holiday.” Send this information to all members of your coworking community.
  * **Room closed:** “Attention: The ‘Kreativ’ meeting room is closed today for maintenance work.” Only inform users who have booked this room for today.
  * **Special events:** "Our summer party is taking place next week! Register now." Invite all your users with just one message.

  **Recurring messages that work for you automatically**

  * **Daily birthday greetings:** "Happy birthday, #firstname! We're giving you 10% off your next booking today." A small gesture with a big impact that automatically goes to the birthday children of the day.
  * **Reminder to return equipment:** “Please remember to return the #resource you borrowed.” Sends automatically to everyone whose loan is overdue.
  * **Weekly planning:** "Plan your week now! You've booked less than 3 days in the office so far." A friendly nudge to your team to plan the coming week in the office.

  ### Ready to get started

  Try out the broadcasting feature for yourself! You can find it in your anny account in the **Customers → Broadcasting** section. If you have any questions or are looking for detailed instructions, you can find all the information you need in our [Help Center article](https://docs.anny.co/en/articles/304524-broadcasting?utm_source=newsletter\&utm_medium=email\&utm_campaign=customers-eu-en-new-at-anny-send-messages-to-your-users-with-the-broadcasting-feature).
</Update>

<Update label="Mar 5, 2025">
  ## anny app 2.1.2

  We just released a new version of the anny app. This version provides, besides some bug fixes, some new improvements:

  * Manage community invitees directly inside the app
  * Tickets of the queuing system can be opened inside the anny app
  * Pay invoices later inside the app
  * Open community pages directly inside the anny app
</Update>

<Update label="Feb 28, 2025">
  ## All booking rules in one central location

  Booking rules in anny can be used to restrict how many bookings your users are allowed to make for a certain period of time. The settings for these rules were located in different places, depending on whether these rules should apply to a resource, a group or the entire organization. <br />For example, the rule that a resource may only be booked once a day by a user was defined in the resource settings.

  To ensure that you still have a perfect overview of your booking rules, you can now find all booking rules in one central place in the account settings. Here you can set the m**aximum number of bookings per user**, which **time window** is considered and whether this **rule should apply to all bookings or only to certain resources, resource groups or categories, services or service groups**.

  We have also enhanced the booking rules with useful functions to give you even more flexibility:

  **🚧 Restrict your rules to individual user groups**<br />You now also have the option of excluding individual users or entire domains from a rule, or specifying that the rule should only apply to a certain person or customer group.

  **⚠️ Individual error messages**<br />You can now also display individual error messages for your users if they want to make a booking but are not allowed to do so by a rule. This provides them with direct feedback, which saves you questions.

  **⛔️ Prevent certain users from being able to book (blacklist)**<br />You may want to exclude a certain group of users from being able to book. Whether it's customers who often don't show up for their appointments or students who have not behaved correctly. You can now exclude them from making bookings via the rules and thus keep a so-called blacklist.

  <img alt="" />
</Update>

<Update label="Feb 24, 2025">
  ## WAYFless directly with anny app

  With the latest improvements, a Login with a WAYFless-URL will be directly opened within the anny app. This allows your users to log in directly to the app and prevents unnecessary redirects.
</Update>


# 2026
Source: https://docs.anny.co/changelog/2026

Follow the updates and improvements made to the anny platform in 2026

<Update label="Aug 21, 2026">
  ## Register visitors directly in the Outlook Add-In

  <img alt="" />

  You can now register visitors directly in the Outlook Add-In, even when you are not booking a room. Matching visitor registrations are clearly marked per participant, so Visitor Management becomes faster and easier to manage where meetings are planned.

  **❓ What it does**

  * Lets you create a visitor registration for meeting participants directly in the Outlook Add-In
  * Works with or without a room booking, including participant-only visitor registration flows
  * Uses resources from the `visitor-registrations` category to control the visitor registration behavior
  * Shows a user badge icon next to participants when a matching `visitor-registrations` resource is used
  * Makes it clearer which participants are linked to a visitor registration

  This gives your team a faster way to capture external guests without switching to a separate booking flow. It also reduces setup errors because the correct visitor registration logic and visual marker are tied to the right resource setup.

  💡 **Example**

  A team member plans a meeting in Outlook and adds an external guest as a participant. Without booking a room, they select the right `visitor-registrations` resource in the Outlook Add-In, and the guest is registered immediately and clearly marked with the user badge icon.
</Update>

<Update label="Aug 20, 2026">
  ## Collect forms and documents later at check-in

  <Frame>
    <img alt="Formulare Landscape Small" />
  </Frame>

  You can now collect Custom Forms and Legal Documents later in the booking flow, not only during booking. This is especially useful for on-site scenarios where details or signatures make more sense at reception.

  **❓ What it does**

  * Lets you decide in anny Admin whether Custom Forms and Legal Documents are requested during booking or later in the flow
  * Shows missing forms, details, and signatures during Check-in when you choose the later collection point
  * Displays the same forms and documents at Check-out as well, although they are not mandatory there yet
  * Works across anny Admin, the booking flow, and the anny Check-In App
  * Requires the latest version of the anny Check-In App for this beta feature

  This reduces friction during booking while still letting you collect the information and signatures you need on site. Your team can keep compliance steps close to the actual arrival moment instead of forcing them too early.

  💡 **Example**

  A visitor books a meeting room visit without signing an NDA during booking. When they arrive, the receptionist starts Check-in and the NDA is shown there for signature, so the visit stays compliant without slowing down the booking flow.
</Update>

<Update label="Aug 19, 2026">
  ## Offer bookings directly on your WordPress site

  <Frame>
    <img alt="Word Press Landscape Small" />
  </Frame>

  The official anny bookings plugin is now live in the WordPress Plugin Directory. You can add booking experiences directly to your WordPress site, so visitors stay in your website layout instead of switching to a separate portal.

  **❓ What it does**

  * Lets you connect WordPress to anny with a login, choose the `anny.co` or `anny.eu` data region, and select your organization
  * Adds 20 Gutenberg blocks for full booking pages, calendars, maps, compact panels, buttons, My Bookings, login, and cart experiences
  * Lets you choose a Resource, Service, Subscription, or Package from a searchable list for each block
  * Shows a live preview of the real booking widget directly in the WordPress editor before you publish
  * Lets you import your brand from anny or adjust colors and shapes site-wide or per block
  * Keeps prices, opening hours, and availability managed in anny and updated on your website without republishing

  You can keep the full booking journey on your own website and reduce the need for copied HTML snippets, blocked iframes, and separate booking portals. Your team manages booking data in anny, while the WordPress pages stay current automatically.

  💡 **Example**

  A coworking space installs anny bookings, connects its organization, adds the organization booking page to a "Book a desk" page, and places a resource button on the homepage. Members complete their booking in the familiar website layout without being sent to another portal.

  Find more information here: [https://docs.anny.co/en/embed-wordpress](https://docs.anny.co/en/embed-wordpress)
</Update>

<Update label="Aug 17, 2026">
  ## Group booking bundles for a clearer catalog

  <Frame>
    <img alt="Generated Image F0cc206d 63db 402c 9abc 4528ebcd0a59" />
  </Frame>

  You can now organize booking bundles into groups in anny. This keeps large bundle and voucher catalogs easier to manage in the admin area and easier to browse on the booking page.

  **❓ What it does**

  * Lets you create booking bundle groups with a name, optional description, and display order
  * Lets you assign a bundle to a group directly in the bundle form, or create a new group from the same selection
  * Shows booking bundles in grouped panels in anny Admin, with a separate section for ungrouped bundles
  * Displays only groups with at least one live bundle in the public catalog, while ungrouped bundles stay visible in their own section
  * Keeps bundles intact if a group is deleted by moving them back to the ungrouped section

  This gives you more control over how bundles are structured and presented. Your team can manage larger catalogs more clearly, and customers can find the right offer faster.

  💡 **Example**

  A fitness studio creates groups such as "10-session passes", "Gift cards", and "Trial offers" and assigns each booking bundle to the right group. Customers then see these sections on the booking page instead of one long list, which makes the catalog easier to scan.
</Update>

<Update label="Aug 10, 2026">
  ## Discount codes redeemable once per customer

  <img alt="" />

  You can now limit discount codes to a single redemption per customer. This helps you run promotions more reliably and prevent repeated use by the same person.

  **❓ What it does**

  * Adds a new rule in the discount code setup: “Redeemable once per customer”
  * Checks at checkout whether the customer has already redeemed the code before
  * Blocks the code from being applied again if it was used previously by the same customer
  * Works for both newly created and edited discount codes

  This gives you tighter control over marketing campaigns, partner deals, and first-time offers, while keeping the checkout experience clear for customers. It reduces unintended discount leakage without changing how customers enter codes.

  💡 **Example**

  You run an “First class discount” campaign for activity bookings. A customer can use the code for their first course booking, but when they book another class later, the code won’t apply a second time.
</Update>

<Update label="Aug 10, 2026">
  ## Treatwell Sync: Email Import and Calendar Sync

  <img alt="" />

  Treatwell bookings can now flow into anny automatically via email forwarding, while anny bookings can be mirrored back to Treatwell via an ICS calendar link. This creates a reliable, near real-time bidirectional sync with a typical delay of about 30 to 60 seconds.

  **❓ What it does**

  * Imports Treatwell bookings into anny through forwarding booking emails to a dedicated anny inbox
  * Updates existing bookings when changes come in, and processes cancellations automatically
  * Prevents duplicates during repeated emails or resend scenarios
  * Matches prepaid information when Treatwell indicates prepayment
  * Handles Treatwell email layout changes more robustly via anny AI parsing
  * Exports anny bookings to Treatwell via an ICS calendar feed so availability stays aligned
  * Improves visibility and reduces manual work across anny Admin and the booking area

  Your team can manage bookings centrally in anny without constantly reconciling Treatwell manually. This reduces missed cancellations, double bookings, and time spent copying appointments between systems.

  💡 **Example**

  A salon receives a new appointment via Treatwell. The Treatwell confirmation email is automatically forwarded to the dedicated anny inbox, and anny creates or updates the booking including prepaid status. When the salon adds a walk-in or phone booking in anny, it appears in Treatwell via the ICS calendar feed, keeping both calendars aligned with only a short delay.
</Update>

<Update label="Jul 30, 2026">
  ## Edit booking form data after booking

  <img alt="" />

  Customers can now view and edit the information they submitted via Custom Booking Forms after they’ve made a booking, if you allow it for the Service. This reduces back-and-forth and saves admins time.

  **❓ What it does**

  * Adds a per-Service setting in anny Admin to allow or disallow post-booking edits of Custom Booking Form data
  * Shows submitted form answers in the booking overview in the booking area (web)
  * Enables customers to update those form answers directly from the booking overview (web)
  * mApplies to web only for now (mobile app not included in the first release)

  Fewer support requests and less manual correction work for admins, while customers can keep their booking details accurate on their own. This is especially helpful when participant details or additional information change after the initial booking.

  💡 **Example**

  Someone books a room for a workshop and later notices a wrong participant name or missing dietary info submitted in the form. Instead of contacting the admin, they open their booking overview on the web, edit the form details, and the booking stays up to date.
</Update>

<Update label="Jul 30, 2026">
  ## Flexible Price Modifiers per Resource and Child Resource

  <img alt="" />

  You can now price the same booking option or Service differently depending on the selected resource or child resource. This brings more accurate, transparent pricing without duplicating offers.

  **❓ What it does**

  * Lets you define resource-level price modifiers in the anny admin for an existing booking option or Service
  * Supports pricing on child resources (for example seats, zones, or sub-areas within a parent resource)
  * Automatically shows and calculates the correct price in the booking flow based on the selected resource or child resource
  * Keeps the core offer centrally managed while allowing granular pricing where it matters

  Teams can model real-world pricing differences (people, places, zones) within one offer, reduce admin overhead, and avoid confusing duplicates. End users see pricing that matches their exact selection, improving clarity and conversion.

  💡 **Example**

  A venue offers “Hall Booking” as one booking option, but seats in Zone A cost more than seats in Zone B. With resource and child-resource price modifiers, users pick their seat or zone and anny automatically applies the right price, while you maintain only one booking option.
</Update>

<Update label="Jul 30, 2026">
  ## Faster, Smarter anny AI Phone Assistant & Chat

  <img alt="" />

  We’ve improved the speed and response quality of the anny AI Phone Assistant and AI Chat. In many relevant cases, replies are now delivered with significantly lower waiting time and better contextual accuracy.

  **❓ What it does**

  * Reduces latency for AI responses in chat and phone by up to 50% in relevant cases
  * Improves intent detection and request classification for more accurate answers
  * Delivers more reliable, context-aware follow-ups across both channels
  * Applies to AI-powered touchpoints in the booking flow; related configuration and monitoring can also affect the anny admin area

  This makes conversations feel smoother and more dependable, cutting down on drop-offs caused by waiting and reducing the need for manual clarification by your team. Learn more in the help center article (Link will be inserted later).

  💡 **Example**

  A customer calls or writes in the chat to ask about an existing booking. Instead of waiting for a slow response or getting a vague answer, they receive a precise, helpful reply much faster, keeping the conversation moving and increasing the chance the booking gets completed.
</Update>

<Update label="Jul 23, 2026">
  ## Video Calls built into anny

  <img alt="" />

  You can now create and run video meetings directly inside anny. This reduces tool switching and eliminates the need for additional video conferencing licenses or external accounts.

  **❓ What it does**

  * Lets you create a video call for an appointment directly in anny
  * Enables starting and hosting the meeting within anny, end to end
  * Works across the key touchpoints where video meetings are managed: Admin area and booking flow
  * Removes the dependency on external video tools and separate user accounts for hosts or participants

  This streamlines the entire process from booking to meeting, especially for teams running many consultations, and helps organizations reduce costs and operational friction. For participants, it also means a simpler experience with fewer links, logins, and handoffs.

  💡 **Example**

  A university study counseling team offers consultation slots via anny. Students book their appointment in anny and then join the session as a video call directly within anny, without switching to a separate video tool.

  Find all information in the helpcenter article: [https://docs.anny.co/de/articles/754785-anny-videoanrufe](https://docs.anny.co/de/articles/754785-anny-videoanrufe)
</Update>

<Update label="Jul 23, 2026">
  ## Configure invoice language for organizations

  <img alt="" />

  You can now control which language invoices are generated in for your organization. This removes manual rework for international billing and keeps invoice PDFs consistent.

  **❓ What it does**

  * Adds a new “Invoice language” setting in anny Admin under Organization settings
  * Lets admins choose one of three options:
  * Always use the organization language
  * Always use the customer language
  * Use the organization language with an English fallback (when a translation isn’t available)
  * Applies the selected language consistently across invoice creation logic, including initial file generation and invoice locking

  This makes invoicing predictable for multilingual organizations and reduces back-and-forth and manual adjustments for admins managing international customers.

  💡 **Example**

  A German-speaking company uses anny for Room Booking and bills English-speaking customers. With “Customer language” selected, invoices are automatically generated in English for those customers, while German customers still receive German invoices, without any manual editing.
</Update>

<Update label="Jul 23, 2026">
  ## Transfer subscriptions between customers

  <img alt="" />

  Admins can now transfer an existing subscription from one customer to another within the same organization, without recreating the subscription. This helps keep customer and subscription management clean when responsibilities change.

  **❓ What it does**

  * Adds a new “Transfer” action to the subscription detail view in the anny Admin area
  * Lets admins select the target customer within the same organization
  * Enables creating a new customer or editing an existing one during the transfer flow
  * Moves the subscription to the selected customer via a regular update
  * Transfers related entitlements, including quota/contingents, subscriber assignment, and Community memberships
  * Does not automatically transfer payment method and billing email; these remain managed separately

  This removes unnecessary manual work and prevents errors that typically occur when admins have to rebuild subscriptions or rewire assignments by hand. It also ensures booking-related access and membership logic continues seamlessly under the new customer.

  💡 **Example**

  If a subscription was initially assigned to Customer A but should now be managed and used by Customer B within the same organization, an admin can transfer it in the subscription details. Quotas, subscriber assignment, and Community memberships move with it, so Customer B can continue booking right away.
</Update>

<Update label="Jul 23, 2026">
  ## Start and End Time Filters for Bookings

  <img alt="" />

  You can now narrow booking lists by a specific time window, not just by date or other attributes. This makes it much faster to review and evaluate only the bookings that matter for a given operational timeframe.

  **❓ What it does**

  * Adds support for filtering bookings by `start_time` and `end_time` in booking lists
  * Applies in the anny Admin area and booking area, especially within booking management views
  * Improves the underlying filter logic (and related API mechanisms) so time-based filtering is consistent across lists and integrations
  * Enables more precise operational checks, reporting, and reviews when only a subset of a day is relevant

  Admins and operational teams can find relevant bookings faster, reduce manual scanning, and run more accurate checks and evaluations for time-critical workflows. More details are available in the help center article (link to be added).

  💡 **Example**

  An office management team needs to review all room bookings for a specific day between 09:00 and 12:00. With `start_time` and `end_time`, they filter the booking list to that window and immediately see only the relevant bookings instead of searching through the entire day.

  More information can be found in the helpcenter article: [https://docs.anny.co/de/articles/454923-adminbenachrichtigungen-in-anny](https://docs.anny.co/de/articles/454923-adminbenachrichtigungen-in-anny)
</Update>

<Update label="Jul 23, 2026">
  ## Glutz eAccess Integration for automatic PIN access

  <img alt="" />

  With the new Glutz eAccess integration, anny can automatically create and manage time-limited door access for room bookings. This eliminates manual access administration and ensures bookers get the right access at the right time.

  **❓ What it does**

  * Connects anny to your Glutz eAccess server via server address, username, and password in the anny Admin area
  * Lets admins create rules that map anny resources to one or more Glutz access points (doors)
  * Supports configurable buffer times (before and after the booking) per rule
  * Optionally enables remote opening (if configured)
  * Automatically creates a separate access for each booking in Glutz with a unique 8-digit PIN code
  * Updates the access time window automatically when a booking time changes
  * Removes the access and PIN automatically when a booking is canceled or deleted
  * Stores no personal data in Glutz, only a booking reference for traceability

  This reduces operational workload for operators and makes access more reliable and secure for customers and employees. The result is fewer access mistakes, less back-and-forth, and smoother arrivals.

  💡 **Example**

  A user books a meeting room in anny from 10:00 to 11:00. anny automatically generates an 8-digit PIN that works only for the correct door and only from 09:50 to 11:10 (including buffers), then deletes the access if the booking is canceled.
</Update>

<Update label="Jul 6, 2026">
  ## Recurring bookings 2.0: series preview and accurate billing

  <img alt="" />

  Recurring bookings are now represented as a clear series with an anchor booking and individual follow-up appointments, including a richer per-appointment preview and rules for availability and billing. This makes it easier for admins and customers to understand what gets copied, checked, and charged for every occurrence.

  **❓ What it does**

  * Models recurring bookings as a series with one anchor booking plus individual occurrences
  * Supports both predefined fixed date series and customer-configured recurrence rules
  * Lets customers define frequency, interval, weekdays or monthly patterns, duration, and an end condition (end date or unlimited)
  * Applies payment logic: unlimited series are only possible with pay-later; end date is required for immediate or prepaid bookings
  * Checks availability for every single occurrence before booking and shows a per-date preview (including a summary like “12 of 15 available”)
  * Books available occurrences even if some dates are unavailable; unavailable dates are skipped
  * Carries the full booking content per occurrence: resource, time range, customer, pricing, add-ons, additional resources, quota consumption, discounts and price adjustments
  * Copies notes, description, and customer instructions from the anchor booking to the occurrences
  * Supports managing existing series: edit after creation, extend automatically, cancel partially or fully
  * Handles billing per offer: either one combined invoice for the series or per-appointment billing (only the next occurrence is charged)

  Admins and customers get predictable recurring bookings with fewer surprises: every occurrence is validated, the right add-ons and resources carry over, quotas are consumed correctly, and pricing and billing follow the offer’s rules. Customer Success can also explain recurring behavior more consistently because the series logic is now fully visible.

  💡 **Example**

  A customer books a room every second Tuesday until December 31. anny creates the series automatically, checks each Tuesday for availability, skips dates that are blocked, and still books the available ones. Add-ons (like equipment) and extra resources are applied to each booked date, and billing happens either once for all appointments or step-by-step per appointment, depending on the offer.

  More information can be found in the helpcenter article: [https://docs.anny.co/de/articles/108497-wiederkehrende-buchungen](https://docs.anny.co/de/articles/108497-wiederkehrende-buchungen)
</Update>

<Update label="Jun 25, 2026">
  ## Shipping options and fees for packages and value vouchers

  <img alt="" />

  You can now sell booking packages and value vouchers with proper physical shipping support, including configurable shipping modes, shipping fees, and an operational shipping status in the admin. This makes postal delivery easy to offer, charge correctly, and track end to end.

  **❓ What it does**

  * Adds a shipping mode setting per booking package and per value voucher: disabled, optional, always
  * Lets you set a shipping fee amount per package/voucher that is charged in addition to the voucher/package value
  * Adds an optional shipping selection in checkout when shipping mode is set to optional
  * Automatically includes the configured shipping fee in the checkout total when shipping is selected (or required)
  * Provides visibility in the anny admin so teams can see which purchases require shipping
  * Enables marking an item as shipped to support operational fulfillment and tracking

  This update removes manual workarounds for physical delivery and ensures the total price is always calculated correctly. It also gives your team a clear process to handle outgoing mail without losing track.

  💡 **Example**

  A customer buys a 100€ value voucher and selects postal delivery in checkout (optional shipping). anny adds the configured 2,90€ shipping fee to the total, and your team can later mark the voucher as shipped in the admin once the letter is sent.
</Update>

<Update label="Jun 18, 2026">
  ## Subscribe without an account

  <img alt="" />

  You can now let customers complete subscriptions without logging in first. This reduces friction in the subscription checkout and helps convert new customers faster.

  **❓ What it does**

  * Adds a per-plan setting in the anny admin area to decide whether login is required before subscription purchase
  * Enables a guest subscription checkout flow where customers enter the required details directly in the checkout
  * Supports completing the payment setup without a pre-existing account
  * Updates the success page to guide customers to register after purchase
  * Introduces a post-purchase registration and claim process so the subscription can be assigned to an account and managed later

  By allowing guest checkout for subscriptions, you remove a major barrier for first-time customers while still keeping full control per plan. Teams can keep login required where needed and open it up where speed matters most.

  💡 **Example**

  A new coworking prospect buys a monthly desk sharing subscription as a guest in your shop, completes payment immediately, and only registers afterward to claim the subscription and manage it going forward.
</Update>

<Update label="Jun 18, 2026">
  ## Start subscriptions in the future

  <img alt="" />

  You can now let customers choose a future start date when purchasing a subscription. This makes subscription checkouts more flexible and easier to plan ahead.

  **❓ What it does**

  * Adds a per-plan setting in the anny admin area to allow or disallow future subscription start dates
  * If enabled, customers can select a start date in the future during subscription checkout
  * If disabled, the existing behavior remains: subscriptions start immediately after purchase
  * Ensures the selected start date is clearly selectable in checkout and is correctly applied when the subscription is created so access starts on the planned date

  Teams can offer subscriptions that match real-world timelines like move-ins, project starts, or month-to-month planning, without forcing customers to start and pay for access earlier than needed. This reduces friction at checkout and increases booking confidence. Learn more in the help center article: \[Link will be inserted later].

  💡 **Example**

  A desk sharing customer books a subscription today, selects “start on July 1”, and completes the purchase now. The subscription is created with the chosen start date, so usage begins exactly on July 1 instead of immediately.
</Update>

<Update label="Jun 18, 2026">
  ## AI-Powered Cancellation Reasons Analytics

  <img alt="" />

  You can now capture cancellation reasons in the Shop and automatically categorize them with AI, so your team finally sees why subscriptions are being canceled. The results are available directly in an overview dashboard and in the cancellation list and detail view.

  **❓ What it does**

  * Adds a free-text field for customers to state their cancellation reason during the cancellation flow in the Shop
  * Automatically assigns the free-text reason to an AI category (e.g., “Too expensive”, “Missing features”, “No longer needed”)
  * Shows the distribution of categories in a dashboard pie chart for fast insight
  * Displays the category in the cancellations list for quick scanning
  * Shows the full original cancellation reason in the cancellation detail view for context

  This turns cancellations into structured feedback you can act on, helping you spot trends earlier and prioritize improvements across pricing, communication, and product scope. It also reduces manual tagging and keeps your analysis consistent over time.

  💡 **Example**

  If the dashboard shows a growing share of cancellations categorized as “Too expensive”, your team can review pricing and packaging and adjust onboarding or value communication before churn increases further.
</Update>

<Update label="Jun 18, 2026">
  ## Apple Pay and Google Pay in embedded anny Widget

  <img alt="" />

  Apple Pay and Google Pay are now available directly inside an embedded anny widget on your own website. This creates a faster checkout experience and helps reduce drop-offs during payment.

  **❓ What it does**

  * Enables Apple Pay and Google Pay inside embedded anny widgets (no redirect or interruption in the flow).
  * Adds a new required setting in anny Admin: save your website domain in Organization settings under General information.
  * Uses dynamic domain verification so the saved domain is automatically enabled by anny.
  * Works for bookings, packages, and subscriptions, including use cases like room booking checkouts in the widget.

  With a smoother, familiar payment step, customers can complete purchases faster, which can improve conversion especially for organizations that rely on embedded widgets. Learn more in the Help Center article (Link will be inserted later).

  💡 **Example**

  A user books a meeting room via the embedded anny widget on your company website and pays immediately with Apple Pay or Google Pay, completing the checkout in seconds without leaving the widget.
</Update>

<Update label="Jun 18, 2026">
  ## License plate field and COMYDO barriers for parking bookings

  <img alt="" />

  We’ve added a dedicated license plate form field with proper validation and extended our COMYDO barrier logic for smoother, automated parking access. This enables reliable plate-based entry and optional automated check-out on exit.

  **❓ What it does**

  * Adds a new custom form field type: “License plate” with input validation tailored for license plate entries
  * Makes the license plate available in the booking flow for parking resources
  * Passes the captured license plate into the COMYDO integration
  * Automatically opens the barrier when COMYDO recognizes a matching license plate on entry
  * Optionally triggers an automatic booking check-out on exit to capture actual usage time

  This removes manual friction at the gate and makes automated access flows dependable, while also improving reporting accuracy when you want to track real parking duration.

  💡 **Example**

  An employee books a parking spot in advance and enters their license plate during checkout. On arrival, the COMYDO barrier recognizes the plate and opens automatically. When leaving, an optional auto check-out is triggered so the booking reflects the real parking time.
</Update>

<Update label="Jun 12, 2026">
  ## Custom Withdrawal Period for Subscription Plans

  <img alt="" />

  You can now configure a withdrawal period for subscription plans to properly support B2C cancellation rights in online subscriptions. Customers get a clear choice between an immediate withdrawal and a cancellation at the end of the current term, including automatic pro rata refunds when applicable.

  **❓ What it does**

  * Adds a new “Withdrawal period” setting to subscription plans in the anny admin area (configurable per plan).
  * Updates the customer cancellation dialog in the booking area when a withdrawal period is active.
  * If a customer cancels within the configured withdrawal period, they can choose between:
  * Immediate withdrawal (with automatic pro rata refund for the unused portion), or
  * Cancellation at the end of the current term.
  * Allows customers to schedule a cancellation several months in advance.

  This closes an important gap for B2C subscriptions by making withdrawal rights transparent, reducing support effort, and ensuring refunds are handled correctly and consistently. It also gives customers more control by allowing future-dated cancellations. For more details, see the help center article: \[Link will be inserted].

  💡 **Example**

  A private customer books a monthly coworking desk-sharing subscription online. Within the withdrawal period, they open the cancellation dialog and choose “Immediate withdrawal”. anny automatically refunds the unused part of the month, while the subscription ends right away.
</Update>

<Update label="Jun 8, 2026">
  ## Automatic EVVA AirKey Access for Bookings

  <img alt="" />

  You can now connect EVVA AirKey with anny to automatically provide digital access for booked resources. Access is created just in time before the booking so EVVA AirKey constraints are always respected.

  **❓ What it does**

  * Adds EVVA AirKey as a new smart lock integration in anny
  * Automatically creates a digital access right for a booking shortly before the booking starts (just in time)
  * Ensures compliance with EVVA AirKey’s limitation that only one active access can exist per lock at a time
  * Matches the booking person to EVVA access via phone number
  * Triggers EVVA to send setup instructions 30 minutes before the booking start via email and SMS
  * Supports app-based access only (no PIN access)

  This removes manual door handovers and last-minute coordination for EVVA-secured spaces, while keeping access creation safe and conflict-free for each lock.

  💡 **Example**

  A visitor books a locked meeting room secured with EVVA AirKey in anny. 30 minutes before the booking starts, EVVA automatically sends an email and SMS so the visitor can set up access in the EVVA app and open the room right on time, without any admin involvement.
</Update>

<Update label="May 28, 2026">
  ## External links for communities on the anny Home Site

  <img alt="" />

  Community members can now access important external destinations directly from their Community home in anny. Community admins can maintain up to three links per Community, so members find the right place faster without searching.

  **❓ What it does**

  * Adds a new admin option to store up to three external links per Community in the anny Adminbereich (Web)
  * Each link includes a label (name), a URL, and an icon
  * Displays these links on the Community home page in the Buchungsbereich (Web) for members
  * Members can click and open the external destinations instantly
  * Web only for now

  This reduces friction for members and makes Community communication more effective, because the most relevant external resources are always one click away on the Community start page.

  💡 **Example**

  A company runs a Community for its members and adds links to the customer portal, a profile page, and a “More information” page. Members open these destinations directly from the Community home instead of having to search or ask for the right URL.
</Update>

<Update label="May 28, 2026">
  ## Daily Role Quotas Dashboard Widget

  <img alt="" />

  You can now track daily booking counts by role directly in the anny admin Dashboard and instantly see whether defined role quotas are met. This makes it easier to validate staffing and safety requirements at a glance.

  **❓ What it does**

  * Adds a new Dashboard widget that evaluates bookings per day by a selected role (for example, First Aider)
  * Visualizes target vs actual for a defined quota so you can quickly spot if the quota is met or undercut
  * Helps admins and responsible teams monitor day-by-day presence based on real bookings and assigned roles

  With this widget, compliance checks that used to require manual digging are now visible immediately, so teams can react earlier when coverage is at risk. Especially for safety-critical roles, it reduces uncertainty and speeds up operational decisions.

  💡 **Example**

  In a desk sharing setup, you define a quota of 2 First Aiders per day. On Tuesday, the widget shows only 1 booking by a First Aider, so you can proactively arrange coverage before people arrive.
</Update>

<Update label="May 28, 2026">
  ## Apple Pay and Google Pay for subscriptions

  <img alt="" />

  You can now pay for subscription products with Apple Pay and Google Pay, in addition to SEPA and credit card. This makes checkout on mobile faster and reduces friction for new and returning customers.

  **❓ What it does**

  * Adds Apple Pay and Google Pay as payment options for subscription products in the booking checkout
  * Keeps SEPA and credit card available as before, with a clear selection flow for subscriptions
  * Supports recurring subscription payments with the new payment methods
  * Applies across anny Booking area and anny Admin where subscription payment method selection and processing is reflected

  Customers can complete subscription checkout in seconds, especially on mobile, which helps reduce drop-offs and increases successful subscription sign-ups. More details are available in the help center (link to be inserted).

  💡 **Example**

  A customer buys a room-booking subscription on their phone, selects Apple Pay, and confirms with Face ID. Instead of typing card details, they finish instantly, making an abandoned checkout far less likely.
</Update>

<Update label="May 28, 2026">
  ## Revenue by Product in Dashboard and PDF

  <img alt="" />

  You can now break down revenue by product category directly in the dashboard and in the revenue overview PDF export. This makes it easier to understand which product types drive revenue and what online transaction fees are associated with them.

  **❓What it does**

  * Adds a dashboard widget that shows revenue by product category (e.g., Resource, Service, Subscription Plan, Add-On, Booking Package).
  * Displays the related online transaction fees per product or product group in the dashboard, so you can compare revenue and fees side by side.
  * Extends the revenue overview PDF export with a revenue breakdown per product category for reporting and sharing.

  This update helps Finance, Operations, and Management teams quickly assess product performance and fee impact without manual spreadsheets. It also improves comparability across modules, especially when multiple product types contribute to the same monthly revenue.

  💡 **Example**

  At month end, an admin opens the dashboard and instantly sees how much revenue came from Resources vs. Services vs. Subscription Plans, plus the online transaction fees tied to each category, and exports the same breakdown as a PDF for internal reporting.
</Update>

<Update label="May 18, 2026">
  ## Company Profiles for Business Customers

  <img alt="" />

  You can now manage companies as first-class records in anny instead of storing company names as plain text on individual customers. This creates a clean structure for shared company data, members, and future invoicing workflows.

  **❓ What it does**

  * Creates dedicated company records that customers can be assigned to
  * Stores central company data in one place, including company name, domain, billing address, and VAT ID
  * Shows a consistent company context across customer management and profile data
  * Lets registered anny customers manage their company data and members themselves
  * Optionally enables “different business address” capture in checkout flows for Subscription Plans, Services, and Booking Packages (when the corresponding form setting is activated)
  * Supports automatic member assignment based on company name and the domain of the business email address (if enabled)

  Admins get a reliable, reportable company structure instead of fragmented free-text entries, and business customers benefit from centralized member and billing data management. It also lays the groundwork for upcoming improvements such as consolidated invoices.

  💡 **Example**

  A company has 12 employees using anny. With Company Profiles, all employees are linked to the same company record, so the billing address and VAT ID are maintained once and stay consistent across bookings and subscriptions, making future consolidated invoicing much easier to prepare.

  More information can be found in the helpcenter aritcle: [https://docs.anny.co/en/articles/679185-company-profiles-for-business-customers](https://docs.anny.co/en/articles/679185-company-profiles-for-business-customers)
</Update>

<Update label="May 18, 2026">
  ## Collect a Separate Shipping Address

  <img alt="" />

  You can now ask bookers for a separate shipping address when delivery does not match their default address. This makes bookings for physical shipments and postal services more accurate and flexible.

  **❓ What it does**

  * Lets you enable an optional “shipping/delivery address” field set per subscription plan, Service, or booking package
  * Shows an additional address section in the booking form only when the option is turned on
  * Keeps the booking form unchanged when the option is turned off
  * Supports common delivery scenarios like equipment shipping or mailbox rentals where delivery address and regular address differ

  This reduces back-and-forth and prevents misdeliveries by capturing the correct address at the moment of booking. Teams can ship faster with fewer manual clarifications.

  💡 **Example**

  An employee books home office hardware via anny using the company address as their standard address, but enters their private address as the shipping address so the package arrives at home.
</Update>

<Update label="May 18, 2026">
  ## Customer balances and consolidated invoices for B2B bookings

  <img alt="" />

  You can now collect multiple B2B bookings and subscriptions on a customer balance and invoice them later as one consolidated invoice. This reduces manual billing work and keeps accounting clean when customers book repeatedly within a billing period.

  **❓ What it does**

  * Adds new Admin settings under “Invoicing” to enable customer balances and define how consolidated billing works (billing period, invoicing delay after period end, grouping by company, limits and thresholds).
  * Lets Admins add a booking to a customer balance (“Add to customer balance”) and keep it as a draft invoice until consolidation.
  * Shows eligible customers in checkout an option to book on customer balance instead of paying immediately (only if Service payment is enabled and permission criteria match Admin settings).
  * Links each booking’s draft invoice to the balance month of the booking date (not the checkout date), while keeping draft invoices individually visible for traceability.
  * Updates the draft invoice and balance automatically when bookings change, without triggering immediate payment.
  * Consolidates all connected draft invoices at the balance due date into one posted invoice; all drafts remain visible and are linked to the final invoice.
  * Adds a “Home” widget for customers that shows an overview of open balances.
  * Automatically charges consolidated balance invoices via the stored payment method if the customer has a subscription with a saved payment method.

  Finance and operations teams spend less time reconciling dozens of individual invoices, while B2B customers get a single invoice per period that’s easier to approve and pay. At the same time, detailed draft invoices remain available for internal review and auditability.

  💡 **Example**

  A company books desks and meeting rooms throughout May. Instead of receiving a separate invoice for each booking, all eligible bookings are added to the May customer balance as draft invoices. On the defined cutoff date, anny consolidates them into one posted invoice, and the company pays just that one invoice.
</Update>

<Update label="May 8, 2026">
  ## purpleview integration for online appointments

  <img alt="" />

  You can now connect purpleview to resources in anny to automatically create a meeting link for each booking. This makes it easy to offer official appointments as secure online meetings.

  **❓ What it does**

  * When a resource is linked to purpleview, anny automatically generates a unique meeting URL for every relevant booking
  * The meeting URL is available for customers so they can join the online meeting at the time of their appointment
  * Works seamlessly for appointment-based services, especially in public administration contexts (e.g. citizen services)

  Teams in cities and municipalities can offer digital appointments without manual link creation and without extra coordination steps. Citizens get a smooth experience: book, receive the link, join on time.

  💡 **Example**

  A Bürgeramt offers online appointments for driver’s license renewals. A citizen books a slot in anny and receives an automatically generated purpleview meeting URL, so they can join the appointment from home instead of coming on-site.
</Update>

<Update label="May 8, 2026">
  ## Website Widgets v2: More components, buttons, and cart

  <img alt="" />

  Website Widgets v2 gives you far more control over what you embed on your own website, without changing any existing widgets. Choose from new embed components, modal buttons, and a cart button that stays in sync across your pages.

  **What it does**

  * Adds new embed components you can place directly on your website:

  → Organization Calendar and Organization Map (calendar or map view across all resources in an organization)

  → Resource Booking Panel (compact booking flow without header or navigation)

  → Resource Calendar and Resource Map (calendar or map view for a single resource)

  → Subscription Page (plans, signup, and checkout embedded)

  → Package Page (vouchers and multi-passes with purchase flow embedded)

  → My Bookings (booking overview for logged-in users)

  → Login Button (central login entry point for all components)

  * Adds new modal button components (open as dialog, drawer, or fullscreen overlay):

  → Resource Button, Service Button, Organization Button, Subscription Button, Package Button

  → Supports custom button text or a fully custom HTML element as the trigger

  * Adds a Cart Button:

  → Cart icon with a live badge showing item count

  → Opens checkout in an overlay

  → Automatically syncs with booking panels on the same page

  * Introduces relative date parameters for start and end dates (e.g., “today”, “next\_week”, “this\_month”)
  * Moves theming to the admin configurator so colors, backgrounds, and spacing are managed centrally and applied automatically
  * Adds layout controls:

  → Fullscreen mode (100% height) via fullscreen

  → Fixed height options (e.g., 600px or 80vh), making the widget scroll instead of auto-growing

  → Default remains auto-resize to content height

  * Adds display options:

  → Organization components can start as list, grid, or calendar

  → Custom logo for the loading animation

  → Preselection for services, categories, and content tabs

  → Ability to hide filter bar and map independently on the organization page

  You can now embed exactly the booking experience you want, where you want it, and keep your website design fully in your control. It also unlocks website-native sales flows for subscriptions and packages, plus a smoother multi-slot checkout with a dedicated cart button.

  **Example**

  A coworking space embeds the Resource Booking Panel directly on each custom room detail page to show only the booking form, without any extra header or navigation. They place the Cart Button in the site navigation, so guests can add multiple rooms or time slots and then check out together, without ever leaving the website.

  Additional information can be found in the Help Center article: [https://docs.anny.co/en/articles/1606-embed-the-anny-booking-page-on-your-own-website-in-your-design](https://docs.anny.co/en/articles/1606-embed-the-anny-booking-page-on-your-own-website-in-your-design)
</Update>

<Update label="May 5, 2026">
  ## New Board and Month Views in the Booking Calendar

  <img alt="" />

  We’ve upgraded the calendar on organization booking pages and the Discover page with new viewing options and clearer scheduling behavior. This makes it much easier to stay on top of busy schedules, especially when many resources are shown at once.

  **❓ What it does**

  * Adds a Board view that lists all bookings/appointments chronologically, without a time axis
  * Shows every booking as a full-size card, independent of duration, ideal for course and event overviews
  * Adds a Month view for quick, high-level planning
  * Improves Week view: bookings with a duration of 7+ hours are now displayed as all-day items at the top of the calendar
  * Limits parallel display to max. 2 simultaneous bookings, with additional overlaps accessible via a “+X” indicator
  * Supports displaying up to 30 resources at once
  * Lets users filter and adjust the calendar view, with filters saved per user for the next visit

  These improvements reduce visual clutter and make it easier to spot availability and conflicts at a glance, even in complex setups with many resources. For course providers, the Board view creates a clean, scannable program overview that’s easy to share.

  💡 **Example**

  A yoga studio uses the Board view as a course calendar overview, then embeds it on its own website so visitors can scroll through upcoming classes in order, without struggling with a packed time grid.

  More information are provided in the Help Center article: [https://docs.anny.co/en/articles/7603-the-layout-of-your-booking-page](https://docs.anny.co/en/articles/7603-the-layout-of-your-booking-page)
</Update>

<Update label="May 4, 2026">
  ## Regpit integration for automated identity verification

  <img alt="" />

  With the new Regpit integration, you can automate KYC and AML checks for subscription requests that fall under the German Anti Money Laundering Act (GWG). Identity verification and risk assessment now happen seamlessly during the subscription request flow.

  **❓ What it does**

  * Creates a Regpit case automatically as soon as a customer requests a relevant subscription plan in anny
  * Notifies the customer from anny that identity verification is required and routes them to Regpit
  * Collects additional customer and business details in Regpit and supports verification methods like video identification
  * Confirms the subscription request in anny once Regpit has all required data and the overall risk is below your defined threshold
  * Declines or prevents confirmation if the overall risk is too high
  * Adds a new verification status component on the customer page and the subscription page so admins can see the current verification state at a glance

  This reduces manual compliance work, keeps your subscription process GWG compliant, and speeds up approvals for low risk customers. It also makes outcomes transparent for your team, directly where you manage customers and subscriptions in anny.

  💡 **Example**

  A company rents business mailboxes via anny. When Max Mustermann requests a mailbox subscription, anny automatically creates a Regpit case and asks him to complete verification. If Regpit confirms his identity and the risk score is below the threshold, the subscription request is confirmed automatically, otherwise it is not confirmed.

  All details in the Help Center article: [https://docs.anny.co/de/articles/661546-regpit-integration](https://docs.anny.co/de/articles/661546-regpit-integration)
</Update>

<Update label="Apr 13, 2026">
  ## Refunds as Store Credit Vouchers

  <img alt="" />

  You can now refund cancelled, online-paid bookings as a voucher instead of sending money back. This keeps revenue in your business and makes rebooking frictionless for customers.

  **❓ What it does**

  * Lets admins choose “refund as voucher” via a dropdown when finalizing a cancellation invoice (only if the original invoice was paid online).
  * Adds a setting in Admin Service settings > Cancellation to define which voucher type is used for “Cancel as voucher”.
  * Supports multiple voucher types with different applicability restrictions, so you can map the right voucher to the right Service.
  * Shows customers in the cancellation details on the booking page that the refund will be issued as a voucher.

  You reduce payment back-and-forth and help customers rebook faster, because their refund turns into immediate credit for a new booking instead of a bank transaction.

  💡 **Example**

  A customer cancels a course they paid online. Instead of refunding the money, you finalize the cancellation invoice as a voucher, and the customer receives store credit they can use to book a new course right away.
</Update>

<Update label="Mar 30, 2026">
  ## Self-serve booking rescheduling

  <img alt="" />

  Your customers can now reschedule their own bookings, including changing the date and the assigned child resource, when you enable it in settings. Any resulting price differences are handled automatically, including additional charges and refunds.

  **❓What it does**

  * Lets admins enable or disable end-user booking edits (default: disabled)
  * Adds an editable deadline (change window) that defines how short-notice a change can be made
  * Allows admins to decide whether child resources can be changed (e.g., switching desks within the same room/area)
  * Shows an edit option in “My bookings” for end users when enabled
  * Supports rescheduling beyond add-ons and additional bookings: end users can now also adjust date/time and child resource
  * Automatically calculates and applies price changes (refund or additional payment)
  * Respects lead times for Add-Ons and Service
  * Enforces the earliest possible new date based on: earliest new date = MIN(old date, today + lead time)

  This reduces support effort for admins and removes friction for customers who need to adjust plans, which can significantly reduce cancellations and no-shows. It also keeps revenue and billing correct without manual intervention through automated recalculation and payment handling.

  💡 **Example**

  Someone has booked a desk for next week but would prefer to sit in a different area. Instead of canceling and rebooking, they simply switch seats.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/617455-editing-bookings](https://docs.anny.co/en/articles/617455-editing-bookings)
</Update>

<Update label="Mar 30, 2026">
  ## Open-Amount Gift Vouchers

  <img alt="" />

  You can now offer gift vouchers with an open amount, so customers choose the value that fits their needs. Admins can switch between booking packages and multi-purpose gift vouchers depending on how vouchers should affect pricing, tax, and checkout.

  **❓ What it does**

  * Adds a new admin setting to select the voucher mode in Booking packages > Edit package
  * Supports two modes:

  A) Booking package (purpose-bound): Includes defined contingents (for example credits for specific bookings/resources). VAT is shown at purchase, and redeeming reduces the booking price. Packages can also be used as purpose-bound vouchers.

  B) Gift voucher (multi-purpose): Can be offered with a fixed or open amount. You can set a minimum amount and a default value. VAT is shown as 0% at voucher purchase, and redemption is applied as a (partial) payment, so the booking VAT is shown correctly.

  * On the organization page under Packages, customers can select a voucher/package
  * If the amount is open, customers can pick from suggestions or enter their own value

  This makes vouchers significantly more flexible and increases conversion, because customers can match the voucher to their budget while you keep the correct tax handling for your business model. It also reduces support requests caused by “wrong voucher value” purchases.

  💡 **Example**

  A massage studio offers a “Gift voucher (open amount)” with a minimum of 25€ and a default of 50€. A customer wants to gift exactly 70€, enters 70€ at purchase, and later redeems it as partial payment for a 79€ massage.
</Update>

<Update label="Mar 30, 2026">
  ## Smart Availability Groups for Complex Resource Dependencies

  <img alt="" />

  Smart Availability Groups let you bundle resources into groups and ensure each booking reserves at least one available resource per group. This makes complex setups like “two staff + one room” bookable without manual coordination.

  **❓ What it does**

  * Create resource groups under Service > Booking options > Resources > Dependencies and assign multiple resources to each group.
  * During availability checks, anny ensures that at least one resource from each group is available for the selected time slot.
  * At booking time, anny automatically reserves exactly what’s needed: one resource per group, plus any connected resources, without double-booking the same resource.
  * A single resource can be used as a connected resource and also be referenced again inside a Smart Availability Group.
  * Limitation: using the same resource across more than two groups at the same time is not supported.
  * Important: if an admin creates a booking with “Check availability” disabled, dependent resources are not booked, because they would restrict availability.

  You can offer services that require multiple parallel resources and keep scheduling reliable, even with many possible combinations. This reduces back-and-forth, avoids conflicts, and makes more complex services sellable online.

  💡 **Example**

  For a couples massage, you connect all qualified employees to the Service, then create two Smart Availability Groups: one group for the second employee (with the same qualified team) and one group for eligible rooms. When a customer books, anny ensures two different employees and one room are available at the same time and automatically reserves them via sub-bookings. Learn more in our Help Center: \[Link will be inserted].

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/36096-smart-availability](https://docs.anny.co/en/articles/36096-smart-availability)
</Update>

<Update label="Mar 30, 2026">
  ## Exclusive Slots per Order

  <img alt="" />

  We’ve added an option to make multi-capacity slots exclusive to a single order. Once a slot is partially booked, it will be treated as unavailable for any other customer’s order, while admins can still see the remaining capacity.

  **❓ What it does**

  * Adds an admin toggle in resource availability for resources with multiple availability (and for child resources that have multiple availability).
  * When enabled, a slot becomes “exclusive” as soon as the first booking is made in that slot.
  * Prevents other customers from booking the remaining capacity in that same slot via separate orders.
  * Keeps capacity transparency for admins: you can still see the real utilization (e.g., 2 of 4 spots used).
  * Ensures groups are not mixed within the same slot even when the resource technically has remaining capacity.

  This helps providers offer group-exclusive experiences without manual blocking or complicated workarounds. It reduces operational friction and avoids customer frustration caused by mixed groups in shared time slots.

  💡 **Example**

  You run axe throwing with lanes that fit up to 4 people. With Exclusive Slots enabled, if one customer books 2 people for the 6:00 PM lane, the 6:00 PM lane will be shown as booked out for everyone else, while you still see internally that 2/4 spots are used.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/618707-exclusive-time-slots](https://docs.anny.co/en/articles/618707-exclusive-time-slots)
</Update>

<Update label="Mar 30, 2026">
  ## Min and Max Quantity per Booking Option

  <img alt="" />

  You can now define minimum and maximum quantities for each booking option. This ensures multi-bookings match your real pricing and capacity rules before customers can proceed.

  **❓ What it does**

  * Lets you set a minimum and a maximum quantity per Service/booking option in the advanced settings
  * Applies the limits directly when a customer adds a booking
  * Prevents checkouts that don’t meet your defined minimum (and blocks quantities above your maximum)
  * Works especially well for services where multiple units are booked in one go, like tickets, seats, or participants

  This helps you enforce group rules automatically, reduce manual back-and-forth, and keep bookings aligned with how you sell and staff your offering. For customers, it makes the booking flow clearer because valid quantities are guided from the start.

  💡 **Example**

  You offer a group tour that can only be booked for 6 to 20 people. With min/max quantities set on the booking option, a customer can’t complete the booking with 1 person and is guided to book at least 6 participants instead.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/622089-define-minimum-and-maximum-selection-per-order](https://docs.anny.co/en/articles/622089-define-minimum-and-maximum-selection-per-order)
</Update>

<Update label="Mar 30, 2026">
  ## Urban Sports Club Integration

  <img alt="" />

  You can now connect anny with Urban Sports Club (USC) to sync your classes and keep bookings and capacities aligned in real time across channels. This helps studios expand reach via USC without risking overbookings or losing control of inventory.

  **❓What it does**

  * Lets you select which anny courses are exported to USC (based on the course planner model).
  * Automatically transfers all sessions for the next 3 weeks and keeps them synchronized.
  * Makes only sessions within the next 2 weeks bookable for USC users.
  * Supports trainer and room recognition by mapping resource categories for trainers and linking rooms 1:1 to USC locations.
  * Allows setting a default trainer and default room if you do not want to define them on every session.
  * Prevents moving sessions after they have been exported to USC (USC does not allow rescheduling). Exported sessions can only be canceled.
  * Cancels the session in USC when you cancel it in anny, including all USC bookings.
  * Validates USC bookings in real time in anny to prevent double bookings and overbooking.
  * Updates capacity in USC in real time when bookings come in via anny or other channels.
  * Marks USC bookings in anny via a dedicated booking option “Urban Sports Club” (not editable).
  * Optionally lets you store a USC settlement price to track revenue from USC bookings.
  * Imports USC check-ins into anny so attendance is visible in your operations.
  * Anonymizes canceled USC bookings and USC no-shows in anny according to USC requirements.
  * Imports USC no-shows one day after the session ends, since USC provides them on the following day.
  * Offers optional capacity controls: reserve a contingent of seats for direct bookings (anny and other channels) and automatically release remaining reserved seats to USC at a defined time (for example 24 hours before start).

  You can grow distribution through USC while keeping your schedule, capacities, and attendance in sync, even when you sell the same sessions through multiple channels. At the same time, you keep control over how many spots USC can take and when.

  💡 **Example**

  A Reformer Pilates studio exports its classes to USC, reserves 10 spots per class for direct bookings in anny, and automatically releases unused reserved spots to USC 24 hours before the class. This maximizes fill rate without sacrificing availability for loyal direct customers.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/618687-connect-urban-sports-club-with-anny](https://docs.anny.co/en/articles/618687-connect-urban-sports-club-with-anny)
</Update>

<Update label="Mar 17, 2026">
  ## Series bookings v2: Book series from resource availability

  <img alt="" />

  Series bookings are now managed centrally via a resource’s available time slots, not inside the booking option. This makes series selectable at checkout and keeps changes to individual dates automatically in sync with existing bookings.

  **❓ What it does**

  * Moves series date definitions from the booking option into the resource’s availability (available time slots).
  * Lets you optionally assign each available time slot to a specific series.
  * Allows connecting additional provided resources per slot (e.g., trainers, coaches, rooms) from the same central place.
  * Enables customers to choose a series via a dropdown during booking.
  * Books all dates of the chosen series at once as a package.
  * Supports mixing series and drop-in bookings to fill remaining capacity.
  * Centralizes update management: single dates can be cancelled or rescheduled in the resource availability and affected bookings stay synchronized.

  You no longer need a separate booking option for every new course cycle. Series become dynamic, easier to maintain, and changes to dates are handled once centrally instead of across multiple configurations.

  💡 **Example**

  You offer a 6-week language course with 12 sessions and also allow drop-ins for individual remaining spots. With Series bookings v2, you create the time slots once in the resource availability, assign them to “6-week course March”, and customers simply pick that series in the dropdown and book the full package. If one session is moved, you update that single slot centrally and the bookings remain in sync.
</Update>

<Update label="Mar 2, 2026">
  ## Let customers edit add-ons after booking

  <img alt="" />

  Customers can now update add-ons after they’ve already booked, as long as you allow it in your settings. This reduces back-and-forth and keeps bookings accurate even when plans change.

  **❓ What it does**

  * Adds a new admin setting on the booking option/service add-on configuration: “Allow editing add-ons after booking”.
  * When enabled, customers can edit selected add-ons directly in their booking details (customer view).
  * Respects each add-on’s lead time, so customers can’t request last-minute changes that you can’t fulfill.
  * Supports changes to limited add-on resources (for example equipment with restricted availability).
  * Automatically handles payment differences: the system triggers the required top-up or refund when add-ons are paid and/or online payment is used.
  * Keeps the booking updated without requiring a manual admin change for typical add-on adjustments.

  This gives customers more flexibility while you stay in control through lead times and availability rules. Your team spends less time on small change requests, and revenue stays correct through automatic payment adjustments.

  💡**Example**

  A customer books a meeting room and later realizes they also need catering. Instead of contacting your team, they open their booking details, add the catering add-on (only if the lead time allows it), and the system automatically charges the difference.
</Update>

<Update label="Feb 27, 2026">
  ## Multi-Tenant Check-In Displays

  <img alt="" />

  You can now connect one Check-In Display to multiple anny organizations. This makes it easy to run visitor check-ins in multi-tenant buildings without mixing data or workflows.

  **❓ What it does**

  * Lets the first organization perform the initial pairing of the Check-In App with the device
  * Enables adding additional anny organizations from within the Check-In App settings
  * Shows the paired Check-In Display in each connected organization’s account settings
  * Allows each organization to customize its own terminal experience, including design, check-in forms, and NDAs
  * Adds an organization selection screen on the Check-In App start screen when multiple organizations are connected
  * Uses the selected organization’s branding, forms, and NDA for the full check-in flow
  * Allows selecting hosts from the chosen organization so notifications and visitor context stay tenant-specific
  * Keeps data strictly separated: visitor data is captured directly and exclusively inside the correct anny organization to support GDPR requirements
  * Requires licensing per company (one license per organization)

  Multi-tenant buildings can share a single physical check-in terminal while keeping visitor data, hosts, and compliance boundaries cleanly separated per company. This reduces hardware overhead and prevents accidental data sharing between tenants.

  💡 **Example**

  A multi-tenant office lobby has one shared iPad for visitor registration. A visitor arrives, selects “Company B” on the first screen, signs Company B’s NDA, and completes Company B’s form. The visit is stored only in Company B’s anny organization and the host notified is a Company B employee.
</Update>

<Update label="Feb 24, 2026">
  ## Shared dashboards and new widgets

  <img alt="" />

  You can now create and share multiple dashboards across your team, with fine-grained permissions for both dashboards and widget categories. Dashboards also got a modern refresh and powerful new widgets for utilization and revenue reporting.

  **❓ What it does**

  * Shows a clear overview in Dashboards with separate sections for private and shared dashboards
  * Lets you create unlimited private and shared dashboards
  * Adds role-based permissions per shared dashboard and per widget category in the role settings
  * Opens any widget in fullscreen for easier analysis and presentation
  * Adds custom date ranges per widget in addition to dynamic presets (for example “This week”); custom ranges can cover up to 365 days
  * Lets you fine-tune widget display options (for example legend visibility, averages, and more)
  * Ensures consistent resource colors across all widgets for faster recognition
  * Enhances the utilization widget with new filters for Community and address (in addition to resource, Service, category, and group)
  * Introduces new widgets: Peak hours & days, Top resources, Top services, Category distribution, Total revenue, MRR, Top customers, Customer growth, New customers
  * Adds reporting options to group bookings by date and by UTM source for more precise performance tracking

  Teams can standardize reporting, reduce duplicated dashboard work, and make faster decisions with shared, permissioned views. Marketing and sales can also connect demand to acquisition campaigns by analyzing bookings grouped by UTM source.

  💡 **Example**

  A workspace operator shares a dashboard “Operations” with the team that includes occupancy by Community and address plus peak times and days. Finance gets a separate “Revenue” dashboard with Total revenue and MRR, while marketing uses a widget view that groups bookings by date and UTM source to see which campaigns are driving the most conversions.
</Update>

<Update label="Jan 27, 2026">
  ## keycafe integration for automated key handover

  <img alt="" />

  You can now connect anny resources with physical keys stored in keycafe and automatically assign the right key to the right customer for the booked time slot.

  **❓ What it does**

  * Lets admins authenticate keycafe in the anny admin area, consistent with other integrations
  * Pulls keys from keycafe and allows you to map them to anny resources (for example, resource “Audi RS” to key “Audi RS key”)
  * Automatically transfers each booking to keycafe so the mapped key is assigned to the booking customer for the exact booking period
  * Triggers keycafe to email the customer a booking code, which they use at the keycafe SmartBox to pick up and return the key

  This reduces manual handovers and helps you run key based operations at scale, with fewer errors and less coordination effort for your team.

  💡 **Example**

  A customer books your “Audi RS” in anny for 10:00 to 14:00. The keycafe integration assigns the “Audi RS key” to that customer for that time window and keycafe sends a booking code. The customer picks up the key at the SmartBox at 10:00 and returns it after 14:00, without your team needing to coordinate pickup times.
</Update>

<Update label="Jan 27, 2026">
  ## Self Check-Out: Cancel after Check-In & smarter Check-Out rules

  <img alt="" />

  We’ve improved Self Check-Out to better match real-world behavior in universities and libraries. From now on, checked-in bookings can be canceled, and check-out is prevented before a booking actually starts.

  **❓ What it does**

  * Allows cancellation even after a user has checked in.
  * Applies the booking option’s cancellation window as the single source of truth, regardless of check-in status.
  * Prevents check-out before the booking start time.
  * Adds a minimum usage duration before check-out is allowed, so extremely short “sessions” don’t fragment capacity.
  * Keeps check-out focused on its real purpose: freeing remaining capacity only when there was genuine partial use.

  This reduces blocked seats and avoids “capacity gaps” caused by immediate check-out actions. At the same time, users can make quick changes without creating operational overhead for admins.

  💡 **Example**

  A student checks in for a library seat and then decides to move to a better free spot. They can now cancel even after check-in (as long as the cancellation window allows it) and immediately book the new seat, without leaving capacity or contingents unnecessarily blocked.
</Update>

<Update label="Jan 22, 2026">
  ## Dynamic Capacity Planning with On-Demand Resources

  <img alt="" />

  You can now connect On-Demand resources to your available time slots, so capacity is allocated only when bookings actually happen. As demand increases, resources are automatically assigned and blocked in real time.

  **❓ What it does**

  * Lets you link On-Demand resources (e.g., guides, trainers, rooms, equipment) in the settings of available time slots, alongside fixed resources.
  * Assigns the first matching On-Demand resource only when capacity is claimed by a booking.
  * Automatically creates a blocker in the resource’s calendar the moment it gets assigned.
  * Removes the assigned resource from the On-Demand pool for overlapping offers, preventing double allocation.
  * Updates slot capacity in real time based on booking demand and the resources that get assigned.

  This gives you flexible operations without overcommitting your team or inventory upfront. You can offer multiple experiences in parallel, let customers choose freely, and still ensure resources are assigned reliably, automatically, and transparently.

  💡 **Example**

  A tourism agency offers 5 tours. Each guide can host up to 10 guests. Guides are connected as On-Demand resources to the tours they can lead, and each guide maintains their individual working hours in anny. When the 1st booking for a tour comes in, the first available matching guide is assigned and blocked. Bookings 2 to 10 fill that guide’s capacity. The 11th booking triggers a second guide assignment, who is then blocked and no longer available for other tours at the same time.
</Update>

<Update label="Jan 22, 2026">
  ## New resource status: separate view and booking

  <img alt="" />

  We’ve introduced a new resource status system that cleanly separates whether a resource is visible, bookable, and billable. This makes it easy to create “info-only” resources without accidentally increasing your costs.

  **❓ What it does**

  * Adds a new status dropdown on each resource with 5 options.
  * Renames existing statuses: Active is now Live, Inactive is now Internal.
  * Adds a new setting in the resource’s Service settings: Enable booking.
  * Combines Live/Internal with booking enabled/disabled to determine the overall behavior of the resource.
  * Introduces free, non-billable states so resources can exist for visibility or setup without impacting billing.

  This update gives you more control over what customers can do, while keeping your resource list complete and accurate without unnecessary billing. It also supports clearer setups where only the “real” sellable item should be counted.

  💡 **Example**

  If you offer courses and want to show the trainer and room details, set the trainer and room to Live for viewing (free) and keep the course Live for booking. Customers can see the trainer/room info, but only the course is bookable and counted for billing.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Per-session resource dependencies

  <img alt="" />

  You can now link fixed resources (like a room or trainer) to a specific session of another resource (like a course or event). When you create or move a session, anny automatically creates and syncs blockers for all linked resources.

  **❓ What it does**

  * Lets you create sessions (previously called irregular availabilities) under Resource settings > Availability.
  * Allows you to link additional resources directly inside the session settings (for example: “Trainer” and “Room”).
  * Automatically creates a blocker for each linked resource as soon as the session is created, even if the course has no bookings yet or isn’t live.
  * Keeps everything in sync: when a session is moved or updated, the linked blockers update accordingly.
  * Optionally shows the linked resources in the booking calendar, email communication, and booking details so customers can use that info when deciding.

  This reduces coordination effort and prevents double-booking across trainers, rooms, and sessions. It also makes course and event planning more reliable because dependencies are handled automatically.

  💡 **Example**

  You set up a “Yoga Class” session for Tuesday 6pm and link “Room A” and “Trainer Kim”. anny immediately blocks Room A and Kim for that time and updates those blocks if you move the class, so neither can be booked elsewhere.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Time Slot Series and Custom Titles for Appointments

  <img alt="" />

  You can now manage bookable time slots more flexibly, especially for irregular schedules and recurring sessions. “Irregular availabilities” have been renamed to “Time slots”, and time slots can carry their own titles and be created in series.

  **❓ What it does**

  * Renames “Irregular availabilities” to **Time slots** (Resource > Availability > Appointments).
  * Lets you set an **individual title per time slot** (for example “Beginner session” or “Advanced training”).
  * Shows the **time slot title in the booking calendar**, so end users immediately understand what they are booking.
  * Adds the option to **create a time slot series** in a recurring pattern (for example every 2 weeks).
  * After creation, **each time slot remains independent**: you can edit, move, cancel, or adjust dependencies per slot without affecting the others.
  * Supports future-friendly setup for **extended per-slot options** (for example auto-blocking related resources like rooms or trainers).

  This update removes the manual work of creating every appointment one by one and makes recurring but non-standard schedules much easier to maintain, without losing control per individual session.

  💡 **Example**

  A course takes place every two weeks, alternating between “Beginner session” and “Advanced training”. You create a bi-weekly time slot series, set the right title per slot, and if one date needs to be moved or canceled, you update only that single time slot.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Custom message on booking status changes

  <img alt="" />

  You can now add an optional custom note whenever you change a booking’s status. This note is included in the automatic status update email sent to the customer.

  **❓ What it does**

  * Shows a pop-up after every booking status change where you can optionally enter a short message.
  * Inserts your message into the status change email that is automatically sent to the customer.
  * Helps you add context for the status change without rewriting the full email.
  * Encourages concise notes (no greetings or formal sign-offs), focused only on the reason or helpful next steps.

  This makes customer communication clearer and more human, especially in sensitive moments like cancellations or rejections. It also reduces follow-up questions because customers immediately understand the “why”.

  💡 **Example**

  A customer’s appointment is declined due to illness. When you change the status, you add: “I’m sick today and can’t make it. Please rebook for next week.” The customer receives the usual status email plus your context.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Bulk reschedule or cancel bookings for a session

  <img alt="" />

  You can now reschedule or cancel an entire session and automatically apply the change to all matching bookings, including customer communication. This removes manual effort when managing irregular, bookable sessions like semester courses.

  **❓ What it does**

  * When you change a session time (reschedule) in the Admin Calendar (Planner mode), all bookings that exactly match that session’s time are moved accordingly.
  * When you manually cancel a session in the Admin Calendar (Planner mode), all bookings that exactly match that session’s time are declined accordingly.
  * When you change sessions via Resource settings > Availability > Sessions, the same automation applies.
  * If a session’s blocked resources change (for example a different room or a different trainer gets assigned), affected bookers are automatically informed.
  * Only bookings with the exact same start and end time as the session are included (no overlapping bookings and no bookings fully inside the time window).

  Session changes that used to take many manual steps per booking now happen in one action, with consistent updates and communication. This is especially valuable for resources with irregular schedules where each session is booked as an exact time slot.

  💡 **Example**

  A university runs a semester course with weekly sessions that are booked per session. If the instructor needs to move next Tuesday’s session from 10:00 to 11:00, you change the session once and all bookings for that exact 10:00 to 11:00 slot are automatically shifted and communicated.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Show available slots in the calendar

  <img alt="" />

  Your booking calendar now shows available timeslots for multi-bookable offers even when no one has booked yet. Customers can also add these slots straight to the cart from the calendar.

  **❓ What it does**

  * Displays available timeslots across **all calendar views in the booking area** (no changes in admin).
  * Works for resources with **available quantity > 1**, such as courses, events, desks, and study places.
  * Shows upcoming sessions **even with 0 bookings**, so your calendar is complete from day one.
  * Adds a **“+” button** on eligible slots so customers can add a date to their cart in one click.
  * Makes it easy to plan multiple bookings and complete them in a single checkout.

  This removes the “empty calendar” problem for courses and events and helps customers understand what’s coming up without needing an existing booking first. It also shortens the path from discovery to checkout.

  💡 **Example**

  A studio schedules courses for the next few weeks and hasn’t received any bookings yet. Customers can still see every upcoming session highlighted in the calendar and add each session with one click via “+”, then book everything together in one checkout.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Minimum bookings per session with auto-cancellation

  <img alt="" />

  You can now set a minimum number of bookings per session and automatically cancel the session if the threshold isn’t met by a defined cutoff time. This removes manual checks, cancellations, and refund handling.

  **❓ What it does**

  * Set a **minimum booking count** per session (e.g., 10 participants).
  * Define a **cutoff window** before the session starts (e.g., 24 hours).
  * If the minimum isn’t reached by the cutoff, the session is **automatically cancelled** and all existing bookings are **declined**.
  * If customers already paid, payments are **automatically refunded**.
  * **Admins get notified 1 hour before** the automatic cancellation so they can still run the session by lowering the minimum.
  * **Admins also get notified when the minimum is reached**.
  * Customers receive **automated messages** about cancellations and refunds.

  This keeps your schedule reliable and profitable without constant monitoring. It also creates a consistent, transparent experience for customers through automated communication and refunds.

  💡 **Example**

  You offer a Reformer Pilates class with a minimum of 10 participants. 24 hours before the class, only 9 spots are booked. anny automatically cancels that class, notifies all booked customers, and triggers refunds if payments were made. If you still want to run it, you can lower the minimum after the admin pre-notification and the class stays active.

  More information can be found in the helpcenter article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)
</Update>

<Update label="Jan 22, 2026">
  ## Weekly view in the booking calendar

  <img alt="" />

  You can now switch your booking calendar from a day view to a week view on the booking page. Calendar entries also inherit each resource’s color, making schedules easier to scan at a glance.

  **❓ What it does**

  * Adds a **Week view** toggle next to the existing Day view on the **Explore booking page calendar**
  * Displays bookings and blockers using the **resource color** (configured per resource in the admin)
  * Helps you see **availability across multiple days** without jumping between dates
  * Keeps the **admin area unchanged** (only the booking page calendar experience is updated)

  This update makes it significantly faster to understand what’s available, when, and where, especially for businesses running schedules across an entire week. It also reduces confusion by visually differentiating resources instead of showing everything in one default color. Learn more in the help center article: [https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events](https://docs.anny.co/en/articles/530149-let-s-get-started-courses-workshops-events)

  💡 **Example**

  A Pilates studio offers classes spread across the week. With Week view, customers can instantly spot which classes fit their schedule, and the studio team can quickly check room availability for the whole week because each room’s bookings show in its own color.
</Update>

<Update label="Jan 15, 2026">
  ## Require legal documents confirmation on every booking

  <img alt="" />

  You can now decide whether a legal document must be confirmed just once or at every booking. This gives you more control over compliance requirements that depend on the specific booking context.

  **❓ What it does**

  * Adds a new toggle option “Ask every time” when creating or editing a legal document in the admin area (default: off).
  * When enabled, end customers must confirm/sign this document again with each new booking checkout.
  * When disabled (default), the existing behavior remains: one-time confirmation is enough.

  This helps you meet stricter legal or operational requirements without manual follow-ups or chasing missing signatures. It also reduces risk by ensuring customers actively acknowledge the document for every relevant transaction.

  💡 **Example**

  If you have a liability waiver that must be signed for each appointment, enable “Ask every time”. From then on, the waiver is requested at every checkout, even for returning customers.
</Update>

<Update label="Jan 7, 2026">
  ## Enhanced subscription management

  <img alt="" />

  We’ve expanded subscription management in anny to give admins more flexibility and a smoother recurring experience. Alongside new controls for cancellations, pricing, and pauses, we’ve also strengthened the reliability of recurring subscriptions.

  ❓ **What it does**

  * Admins can cancel subscriptions up to **6 months in advance**.
  * Dates for **new subscriptions** are displayed in a clearer, more human-friendly format (e.g. **01 - 31** instead of **01-01**).
  * Admins can view and change the **price mode (net/gross)** per individual subscription.
  * Admins can **schedule a subscription pause in advance**.
  * Improved overall stability of the recurring logic, including:
  * Subscriptions now continue renewing reliably even when a minimum term is involved.
  * Planned subscriptions start more consistently at their scheduled time.
  * Subscribers are removed from the Community more consistently after a subscription ends.

  💡 **Example**

  If a member requests a cancellation for the end of the season, you can schedule it months ahead and keep everything predictable for both your team and the subscriber.

  This update reduces manual follow-ups and helps you manage long-running memberships with confidence.
</Update>

<Update label="Jan 6, 2026">
  ## ISO 27001 certification for anny

  <img alt="" />

  anny has long operated **GDPR-compliant** and on an **ISO 27001-certified infrastructure**.<br />Now, anny as a company is also **ISO 27001 certified**, confirming that our Information Security Management System (ISMS) meets an internationally recognized standard.<br />In addition, anny is now **ISO 27017 certified**, covering cloud-specific security controls.

  ❓**What it does**

  * Confirms that anny operates an **audited, company-wide Information Security Management System (ISMS)** based on ISO 27001
  * Confirms that **cloud-specific security controls are audited and certified** in line with ISO 27017
  * Builds on existing **GDPR-compliant processes** and an already ISO 27001-certified infrastructure
  * Ensures that confidentiality, integrity and availability of your data are managed through standardized controls
  * Demonstrates that technical and organizational measures (TOMs) are systematically implemented and reviewed on a regular basis
  * Simplifies internal security and privacy approval processes, especially for CISOs, IT security teams and Data Protection Officers
  * Reduces procurement friction where an ISO 27001 certified SaaS provider is a mandatory requirement (e.g. KRITIS, large enterprises)
  * Supports the implementation of Clean Desk & Clear Screen policies through secure, shared workplace scenarios (for example via check-ins and automatic logout)
  * Strengthens your compliance posture in view of upcoming regulations such as NIS2 and associated national laws from 2026 onward

  This certification makes it easier and faster for enterprise organizations to adopt anny while meeting strict security and compliance requirements.<br />With anny’s **ISO 27001 and ISO 27017 certifications**, security and data protection teams can rely on an audited framework that formally confirms established security practices instead of conducting lengthy ad hoc reviews.
</Update>

<Update label="Jan 5, 2026">
  ## UTM Link Tracking

  <img alt="" />

  You can now track where bookings, subscriptions, and booking packages come from using UTM parameters on your anny booking page. Create trackable links and see attribution directly in the relevant records and exports.

  ❓**What it does**

  * Lets admins generate trackable booking page links with **utm\_source**, **utm\_medium**, and **utm\_campaign**
  * Provides an integrated link builder, with the option to add parameters manually
  * Stores attribution when a customer completes a **booking**, **subscription**, or **booking package** within **14 days** after clicking a UTM link
  * Shows a new **“Attribution”** panel in: Booking details, subscription details & booking package details
  * Adds attribution fields to tables and exports: Bookings table and export, subscriptions table and export & booking packages table and export

  💡 **Example**

  Compare bookings coming from your newsletter vs. Instagram posts by using separate UTM links for each channel.

  This makes it easier to understand which channels and campaigns drive revenue, without guessing or manual tagging.

  Learn more in the helpcenter article here: [https://docs.anny.co/en/articles/520588-utm-tracking](https://docs.anny.co/en/articles/520588-utm-tracking)
</Update>

<Update label="Jan 5, 2026">
  ## VAT rates for price modifiers

  <img alt="" />

  You can now assign a dedicated VAT rate to each price modifier. If no VAT rate is selected, the price modifier automatically uses the VAT rate of the Service or booking option.

  ❓ **What it does**

  * Adds a new field **“VAT rate”** in the price modifier detail view.
  * Lets you set a **different VAT rate per price modifier**, independent from the Service/booking option.
  * Defaults to the **Service/booking option VAT rate** when the field is left empty.
  * Helps you **separate fixed price components** (e.g., fees, packages, cleaning) for clearer invoicing and tax reporting.

  💡 **Example**

  A ticket includes a drink flat rate with a different VAT rate, which can now be shown as its own line item with the correct VAT.

  This makes invoices more accurate when one booking contains multiple taxable components.
</Update>