Zugriffsaufträge und API-Anbindung

Zweck und Voraussetzungen

Ein Zugriffsauftrag gibt Personen oder Teams zeitlich begrenzte Rechte, auch ohne Reservierung. Personen, Einheiten und passende Steuerungen müssen vorhanden sein. Du benötigst die entsprechenden Verwaltungsrechte im gewählten Arbeitsbereich.

In der App planen

Öffne Zugriffsaufträge. Lege einen Auftrag mit verständlichem Namen, Personen oder Teams, Einheiten und Gültigkeitszeiten an. Wähle die benötigten Aktionen und prüfe die Zusammenfassung vor dem Speichern. Kontrolliere anschließend Status und Zuordnungen. Ein Auftrag ist keine Teammitgliedschaft und keine Belegungssperre.

Aus einem Verwaltungssystem übernehmen

Eine freigeschaltete Integration kann Personen, Serviceteams und Zugriffsaufträge über die REST-API pflegen. Die beteiligten Personen und Einheiten müssen zuvor über ihre externen Kennungen verknüpft sein. Die Integration benötigt die freigegebenen Funktionen für Reservierungen und Automatisierung. Zugangsschlüssel gehören ausschließlich in das angebundene System, nicht in die Benutzeranleitung oder einen Auftragsnamen.

Technischer Vertrag für die Anbindung

Unter /api/integrations/v1/tenants/{externalTenantId}/access-orders/{externalOrderId} liest die Integration mit GET und erstellt oder ersetzt mit PUT. PUT auf /lifecycle storniert ausdrücklich. Änderungen benötigen den aktuellen ETag in If-Match; ein veralteter Stand liefert 412. PUT ersetzt den Auftrag vollständig: entfernte Einträge verlieren ihre Wirkung. Das Weglassen eines ganzen Auftrags bei einer Synchronisierung ist dagegen keine Stornierung. Extern verwaltete Aufträge werden im Quellsystem geändert; die API übernimmt keine Benutzeranmeldung und erstellt keine technischen Gerätezuordnungen.

Verwandt: Reservierungen, Personen, Teamverwaltung, Geräte und Steuerungen.