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

# Glutz eAccess mit anny verbinden

> 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 {Buchungsnummer}") 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.
