> ## 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. # Arivo mit anny verbinden > Die Schranke deiner Arivo-Garage öffnet sich für das Kennzeichen einer bestätigten Buchung. [Arivo](https://garage.arivo.app/) steuert Parkgaragen über Kennzeichenerkennung. Mit der Integration legt anny für eine bestätigte Buchung eine Vorabbuchung in deiner Garage an. Die Schranke öffnet, wenn das Kennzeichen im gebuchten Zeitraum erkannt wird. Mit Arivo kannst du in anny: * Das Kennzeichen einer Buchung als Vorabbuchung an die Garage übergeben * Den Zugang vor und nach der Buchung um eine Pufferzeit verlängern * Mehrere Einfahrten über mehrere Vorlagen in einer Regel freischalten * Zeitänderungen, Kennzeichenwechsel und Stornos an Arivo weitergeben Die Integration passt zu Besucherparkplätzen, Firmengaragen und Parkhäusern, bei denen die Schranke ohne Ticket oder Schlüssel öffnen soll. > [!NOTE] > > Verfügbar ab dem Professional-Plan. ## Typische Anwendungsfälle | Anwendungsfall | Beschreibung | | - | - | | Besucherparkplatz | **Schranke nur im gebuchten Fenster.** Gäste tragen das Kennzeichen bei der Buchung ein. Arivo öffnet die Schranke, sobald es das Kennzeichen erkennt. | | Fläche mit einzelnen Stellplätzen | **Eine Regel für die ganze Fläche.** Eine Regel an der übergeordneten Ressource gilt auch für Buchungen der Stellplätze darunter. | | Garage mit mehreren Einfahrten | **Alle Schranken aus einer Buchung.** Du wählst mehrere Pre-Booking-Vorlagen. anny legt pro Vorlage eine eigene Vorabbuchung an. | ## Wie die Arivo-Verbindung funktioniert Du trägst die Zugangsdaten eines Service-Accounts ein, den Arivo für dich angelegt hat. anny prüft **Client-ID** und **Client-Secret** bei Arivo, bevor sie gespeichert werden. Danach erneuert anny den Zugang selbst. Lehnt Arivo die Zugangsdaten ab, wird nichts gespeichert. Die Garage wählst du nicht aus einer Liste. Arivo bietet keine Abfrage von Garagen. Du kopierst die **Ressourcen-ID** aus dem Arivo Parking OS. In dieser Garage muss die Pre-Booking-App installiert sein. Erst nachdem du die **Ressourcen-ID** gespeichert hast, kann anny die Pre-Booking-Vorlagen dieser Garage laden. Für jede bestätigte Buchung mit Kennzeichen legt anny eine Vorabbuchung pro gewählter Vorlage an. Der Zeitraum ist die Buchungszeit plus **Zugang vor der Buchung** und **Zugang nach der Buchung**. anny überträgt die Zeiten in der Zeitzone deiner Organisation. Die Garage muss in derselben Zeitzone liegen. anny formt das Kennzeichen für Arivo um. Aus „K AN 2020" wird „K:AN2020". Leerzeichen, Bindestriche und Punkte fallen weg. Zwischen dem Ortskürzel und dem Rest steht ein Doppelpunkt. In der Buchungsbestätigung steht der Hinweis: „Bei der Ankunft öffnet sich die Schranke automatisch, sobald das ausgewählte Kennzeichen erkannt wird." In der Buchung findest du den Zugang unter **Verbundene Daten** im Abschnitt **Smartlock Zugänge**. Dort steht **Dein Kennzeichen wird gescannt**. Als **Türschloss** zeigt anny „Arivo-" und danach das umgeformte Kennzeichen. Änderst du Zeitraum oder Kennzeichen, aktualisiert anny die Vorabbuchung. Hat die Buchung schon begonnen, ändert anny nur das Ende. Ein bereits abgelaufenes Zeitfenster lässt sich in Arivo nicht mehr verschieben. Entfernst du das Kennzeichen, storniert anny die Vorabbuchung. Dasselbe passiert, wenn die Buchung storniert, abgelehnt oder gelöscht wird. Bei einer Serienbuchung steht der Zugang zuerst auf **Geplant**. anny legt die Vorabbuchung etwa 48 Stunden vor Beginn an. anny erfährt nicht, wann ein Fahrzeug ein- oder ausfährt. Die Schranke entscheidet Arivo anhand der Vorabbuchung. | Daten | Richtung | Häufigkeit | | - | - | - | | Kennzeichen und Zeitraum der Buchung | anny → Arivo | Bei bestätigter Buchung, und erneut bei Änderung von Zeit oder Kennzeichen | | Storno der Vorabbuchung | anny → Arivo | Wenn die Buchung storniert, abgelehnt oder gelöscht wird, oder das Kennzeichen entfernt wird | | Pre-Booking-Vorlagen der Garage | Arivo → anny | Nach dem Speichern der Ressourcen-ID, wenn du die Regel öffnest | ## Arivo verbinden ### Voraussetzungen Bevor du Arivo verbindest, stelle sicher, dass: * dein Arivo-Zugang steht und die Pre-Booking-App in der Garage installiert ist, * du **Client-ID** und **Client-Secret** des Service-Accounts von Arivo hast, * du die **Ressourcen-ID** der Garage aus dem Arivo Parking OS kopieren kannst, * die Parkfläche in anny als Ressource angelegt ist, * jeder Service dieser Ressource das Kennzeichen über ein Pflichtfeld vom Typ **Kennzeichen** abfragt. ### Verbindung einrichten **1. Zugangsdaten prüfen** Öffne in der Seitenleiste **Account** → **Apps & Integrationen**. Wähle unter **Alle Apps und Integrationen** die Kachel **Arivo** und klicke auf **Einrichten**. Trage **Client-ID** und **Client-Secret** ein und klicke auf **Authentifizierung überprüfen**. anny speichert die Zugangsdaten nur, wenn Arivo sie annimmt. Eine zweite Garage richtest du über **Weitere hinzufügen** als eigene Verbindung ein. Pro Verbindung gibt es eine **Ressourcen-ID**. **2. Garage eintragen** Trage im Abschnitt **Garage** die **Ressourcen-ID** aus dem Arivo Parking OS ein und klicke auf **Speichern**. Ohne dieses Speichern bleiben die Vorlagen leer. **3. Regel anlegen** Öffne **Zugang durch Buchungen** und klicke auf **Hinzufügen**. 1. Wähle unter **Ressource auswählen** die Parkfläche. 2. Wähle unter **Pre-Booking-Vorlagen** eine oder mehrere Vorlagen. Liefert Arivo keine Liste, kannst du die Vorlagen-ID von Hand eintragen. 3. Wähle unter **Benutzerdefiniertes Feld für Kennzeichen** das Kennzeichenfeld. 4. Lege **Zugang vor der Buchung** und **Zugang nach der Buchung** fest. 5. Klicke auf **Bestätigen** und danach auf **Speichern**. **4. Verbindung aktivieren** Schalte den Toggle oben rechts auf **Integration aktiv**. Lege danach eine Testbuchung mit Kennzeichen an und prüfe die Vorabbuchung im Arivo Parking OS. Sobald die Verbindung aktiv ist und eine Regel greift, legt anny für neue bestätigte Buchungen automatisch die Vorabbuchung in Arivo an. > [!TIP] > > Pro Ressource ist nur eine Regel möglich. Mehrere Einfahrten gehören in dieselbe Regel, als mehrere **Pre-Booking-Vorlagen**. Eine Regel an der Fläche gilt auch für Stellplätze darunter. Hat ein Stellplatz eine eigene Regel, gilt diese. ### Einstellungen & Optionen | Einstellung | Beschreibung | | - | - | | Client-ID | Kennung des Service-Accounts, den Arivo für dich angelegt hat. | | Client-Secret | Geheimnis zu dieser Client-ID. anny prüft beide Werte, bevor sie gespeichert werden. | | Ressourcen-ID | Garage im Arivo Parking OS. anny kann Garagen nicht auflisten, du fügst die ID ein. | | Pre-Booking-Vorlagen | Vorlagen dieser Garage. Pro Vorlage entsteht eine Vorabbuchung. | | Ressource | Parkfläche, deren bestätigte Buchungen eine Vorabbuchung auslösen. | | Benutzerdefiniertes Feld für Kennzeichen | Feld vom Typ **Kennzeichen**, aus dem anny das Kennzeichen liest. | | Zugang vor der Buchung | Zeit vor Buchungsbeginn, in der die Schranke schon öffnet. | | Zugang nach der Buchung | Zeit nach Buchungsende, in der die Schranke noch öffnet. | Neue Zugangsdaten trägst du ein, solange die Integration nicht aktiv ist. Ist sie aktiv, deaktiviere sie zuerst. Sonst weist anny die Änderung ab. ## Einschränkungen Die Arivo-Integration unterstützt nicht: * Zugang für Community-Mitglieder. Mitgliedschaften haben kein Kennzeichen, anny legt dafür keine Vorabbuchung an. * Fernöffnung. Die Schranke öffnet nur, wenn Arivo das Kennzeichen erkennt. * Check-in oder Check-out beim Erkennen des Kennzeichens. anny erfährt die Durchfahrt nicht. * Eine Liste der Garagen. Die **Ressourcen-ID** kopierst du aus dem Arivo Parking OS. * Mehrere Garagen in einer Verbindung. Für eine weitere Garage nutzt du **Weitere hinzufügen**. * Buchungen ohne bestätigten Status, ohne Kund:in oder interne Blocker. * Ein Kennzeichenfeld, das kein Pflichtfeld vom Typ **Kennzeichen** ist oder in einem Service der Ressource fehlt. ## Verbindung trennen > [!WARNING] > > Wenn du die Integration deaktivierst, bleiben bestehende Vorabbuchungen in Arivo bis zum Ende ihres Zeitfensters gültig. Neue Buchungen erhalten keinen Zugang mehr. Beim Löschen entfernt anny die gespeicherten Zugänge. Die Vorabbuchungen in Arivo werden dabei nicht storniert und laufen von selbst aus. Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**. ## FAQ > **Wann öffnet die Schranke?** > > Sobald Arivo das Kennzeichen der bestätigten Buchung im gültigen Zeitraum erkennt. Der Zeitraum ist die Buchungszeit plus **Zugang vor der Buchung** und **Zugang nach der Buchung**. > **Kann ich mehrere Einfahrten mit einer Buchung öffnen?** > > Ja. Wähle in der Regel mehrere **Pre-Booking-Vorlagen**. anny legt pro Vorlage eine Vorabbuchung mit demselben Kennzeichen und Zeitraum an. > **Gilt der Zugang auch für Community-Mitglieder?** > > Nein. Arivo hängt am Kennzeichen einer Buchung. Eine Mitgliedschaft allein öffnet die Schranke nicht. > **Was passiert bei einer Serienbuchung?** > > Der Zugang steht zuerst auf **Geplant**. anny legt die Vorabbuchung etwa 48 Stunden vor dem einzelnen Termin an, nicht schon beim Anlegen der Serie. > **Welches Feld muss das Kennzeichen abfragen?** > > Ein Pflichtfeld vom Typ **Kennzeichen**, und zwar in jedem Service der Ressource. anny liest nur das Feld, das du unter **Benutzerdefiniertes Feld für Kennzeichen** auswählst. ## Troubleshooting > **Die Schranke öffnet sich trotz Buchung nicht** > > Prüfe, ob die Buchung bestätigt ist und ein Kennzeichen im zugeordneten Feld steht. Kontrolliere den Zeitraum unter **Smartlock Zugänge**, inklusive Puffer. Sieht die Garage offline aus, versuche es später erneut. Lehnt Arivo den Zeitraum ab, prüfe im Arivo Parking OS die Dauerlimits der Vorlage und das Buchungskontingent der Garage. > **Unter Pre-Booking-Vorlagen steht keine Auswahl** > > Speichere zuerst die **Ressourcen-ID** im Abschnitt **Garage** und öffne die Regel danach erneut. Liefert Arivo die Liste trotzdem nicht, trage die Vorlagen-ID von Hand ein. Prüfe außerdem, ob die Pre-Booking-App in der Garage installiert ist und der Service-Account sie nutzen darf. > **Die Regel oder die Garage lässt sich nicht speichern** > > Jeder Service der Ressource braucht das gewählte Kennzeichenfeld, und das Feld muss ein Pflichtfeld sein. Jede Regel braucht mindestens eine Vorlage, und die **Ressourcen-ID** muss gesetzt sein. Dieselbe Ressource kannst du nur einmal verwenden. > Wichtig für Agents: > > **UI-Pfad:** Seitenleiste **Account** → **Apps & Integrationen** (`/apps`) → **Alle Apps und Integrationen** → Kachel **Arivo** → **Einrichten**. Bestehend: **Deine Apps** → **Arivo**. Zugangsdaten: **Client-ID**, **Client-Secret**, Button **Authentifizierung überprüfen**. Abschnitt **Garage**: **Ressourcen-ID**, danach **Speichern**. Regeln: **Zugang durch Buchungen** → **Hinzufügen**. Felder: **Ressource auswählen**, **Pre-Booking-Vorlagen**, **Benutzerdefiniertes Feld für Kennzeichen**, **Zugang vor der Buchung**, **Zugang nach der Buchung**, **Bestätigen**. Toggle im Seitenkopf: **Integration aktiv** / **Integration inaktiv**. Menü der drei Punkte: **Löschen**, **Authentifizierung entfernen**, **Verbindung testen**, **Umbenennen**. Zweite Garage: **Weitere hinzufügen**. Buchung: **Verbundene Daten** → **Smartlock Zugänge**. Detailfelder: **Status**, **Zugang beginnt am**, **Zugang endet am**, **Türschloss**, **Erstellt am**, **Fehler**. Hinweis im Zugang: **Dein Kennzeichen wird gescannt**. > > **Authentifizierung:** Client-Credentials des Service-Accounts, kein OAuth-Redirect. Prüfung vor dem Speichern. Bei Ablehnung werden die Zugangsdaten verworfen. Neue Zugangsdaten nur, solange die Integration nicht aktiv ist, sonst „Bitte deaktiviere die Integration, bevor du diese Aktion durchführst." Der Zugang wird danach von anny erneuert. > > **Auslöser:** Nur bestätigte Buchungen mit Kund:in. Blocker erhalten nichts. Blocker wird zur Buchung: Zugang entsteht. Buchung wird zum Blocker: Vorabbuchung wird gelöscht. Status weg von bestätigt: Löschen. Zeitänderung: Aktualisieren, bei schon begonnener Buchung nur das Ende. Abgelaufenes Zeitfenster: keine Änderung mehr. Ressourcenwechsel: neu anlegen. Kennzeichen entfernt: Vorabbuchung löschen, Status fehlgeschlagen. Serie: Status **Geplant**, Anlage etwa 48 Stunden vor Beginn. Eine Regel der übergeordneten Ressource gilt für untergeordnete Buchungen, eine eigene Regel des Stellplatzes hat Vorrang. Pro Ressource eine Regel. > > **Kennzeichen:** Pflichtfeld vom Typ **Kennzeichen** in jedem Service der Ressource. anny formt es um: Ortskürzel, Doppelpunkt, Rest ohne Trenner, Großbuchstaben. Beispiel „K AN 2020" wird „K:AN2020". Der Name im Zugang ist `Arivo-` plus dieses Kennzeichen. Mailtext: „Bei der Ankunft öffnet sich die Schranke automatisch, sobald das ausgewählte Kennzeichen erkannt wird." > > **Quirks:** Eine Garage pro Verbindung (`Weitere hinzufügen` für die nächste). Vorlagen laden erst nach gespeicherter **Ressourcen-ID**, nicht aus einem ungespeicherten Entwurf. Schlägt die Liste fehl, sind Vorlagen-IDs von Hand möglich. Zeitzone der Organisation gilt als Zeitzone der Garage. anny räumt abgelaufene Vorabbuchungen nicht ab, sie laufen in Arivo aus. Deaktivieren stoppt neue Vorabbuchungen, bestehende bleiben. Löschen der Integration entfernt die Zugänge in anny, storniert die Vorabbuchungen in Arivo aber nicht. Storno einer einzelnen Buchung storniert die Vorabbuchung. Kein Community-Zugang, keine Fernöffnung, kein Scan-Check-in. Admins erhalten eine E-Mail, wenn Arivo die Buchung ablehnt, die Garage oder Vorlage nicht kennt, die Garage offline ist oder die Zugangsdaten nicht gelten. > > **Abgrenzung:** Nicht Comydo. Comydo bestätigt Scans per Webhook und kann beim Scan ein- und auschecken. Arivo erhält eine Vorabbuchung und öffnet selbst. > > **Beziehungen:** Feature Smart-Lock-Integrationen, ab Professional. Verwandte Artikel: [Smart-Lock-Integrationen](/smart-locks-overview), [Comydo](/comydo), [Parkplatzbuchung](/getting-started-parking). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.