> ## 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.
# Comydo mit anny verbinden
> 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.
Verfügbar ab dem Professional-Plan.
## 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
Ö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.
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.
Das Bild zeigt den Bereich der Comydo-Integration, in dem du die Webhook-Verbindung einrichtest.
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.
Sobald die Verbindung aktiv ist und eine Regel greift, erstellt anny automatisch den passenden Zutritt für neue Buchungen oder Community-Mitglieder.
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.
### 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.
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.
Ö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.
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.
Erstelle eine Testbuchung mit Kennzeichen. Prüfe die Einfahrt und bei aktiviertem Check-out auch die Ausfahrt.
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
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.
Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.
## FAQ
Bei Buchungszugängen erhalten Kund:innen einen QR-Code in der anny App oder Buchungsbestätigung. Diesen scannen sie am Comydo-Gerät.
Ja. Eine Regel kann eine Ressource mit mehreren Geräte-IDs verknüpfen. Pro Ressource ist aber nur eine Buchungsregel möglich.
Ja. Erstelle eine Community-Regel und ordne ihr einen oder mehrere Comydo-Zugänge zu.
Ja. Verwende ein benutzerdefiniertes Kennzeichenfeld, markiere es als **Pflichtfeld** und ordne es über die **Kennzeichenerkennung** in der Comydo-Regel zu.
**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.
## Troubleshooting
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.
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.
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.
> 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).