> ## 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.

# Admin-Nutzer und Rollen verwalten

> 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 in der Seitenleiste über **Account** → **Admin-Nutzer**. Die Seite **Admin Nutzerverwaltung** hat drei Abschnitte: **Aktive Nutzer**, **Offene Einladungen** und **Rollen**. Unter **Aktive Nutzer** siehst du alle Admin-Nutzer mit Name, E-Mail-Adresse, Rolle und Beitrittsdatum.

## Nutzer einladen

> [!TIP]
>
> Offene Einladungen werden auf derselben Seite im Abschnitt **Offene Einladungen** angezeigt. Du siehst dort auch, wann die Einladung versendet wurde und wie lange sie gültig ist. Bei Bedarf ziehst du die Einladung über die drei Punkte in der Zeile mit **Einladung zurückziehen** zurück.

**1. Admin-Nutzer Verwaltung öffnen**

Öffne in der Seitenleiste **Account** → **Admin-Nutzer**.

**2. Admin einladen**

Klicke im Abschnitt **Aktive Nutzer** auf **Einladen**, um jemanden einzuladen. Trage den Namen ein, wähle unter **Einladung senden per** **Per E-Mail** oder **Per Mobilnummer** und gib die E-Mail-Adresse bzw. Mobilnummer sowie unter **Rollen** die Rolle für die Person ein. Optional kannst du über **Berechtigungen verwalten** noch Anpassungen vornehmen, indem du die Häkchen bei den Berechtigungen entfernst oder hinzufügst. Klicke anschließend auf **Senden**.

## 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.

Rollen verwaltest du im Abschnitt **Rollen** unter **Account** → **Admin-Nutzer**. Über **Neue Rolle** legst du eine Rolle an. Ein Klick auf eine Rolle öffnet sie zum Bearbeiten; über die drei Punkte kannst du sie auch duplizieren oder löschen.

### 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 **Account** → **Admin-Nutzer** im Abschnitt **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).

## Berechtigung eines Nutzers anpassen

Du kannst die Berechtigungen eines einzelnen Nutzers individuell anpassen, ohne die zugewiesene Rolle global zu verändern. Klicke dazu unter **Aktive Nutzer** auf die Zeile des Nutzers oder wähle über die drei Punkte **Berechtigungen verwalten**.

> [!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.

## 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 Abschnitt **Rollen** und können bei Einladungen ausgewählt werden.

## FAQ

> **Kann ich einem Nutzer Rechte geben, ohne die Rolle zu ändern?**
>
> Ja. Über die drei Punkte in der Zeile des Nutzers (**Berechtigungen verwalten**) kannst du individuelle Berechtigungen setzen, die unabhängig von der globalen Rolle gelten.

> **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.

> **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.

> **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.

> **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.

> **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](https://docs.anny.co/admin-notifications.md).

## Troubleshooting

> **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.

> **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.

> **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.

> Wichtige Informationen für Agenten:
>
> * UI-Pfad zur Nutzerverwaltung: Seitenleiste Account → Admin-Nutzer (Route `/user-management`, Seitentitel „Admin Nutzerverwaltung“). Eine Seite mit den Abschnitten Aktive Nutzer, Offene Einladungen und Rollen (kein eigener Reiter mehr; die alte Route `/user-management/roles` leitet auf `#roles` um). Drei-Punkte-Menü einer Nutzerzeile: Berechtigungen verwalten, Benachrichtigungen verwalten, Nutzer entfernen (bzw. Team verlassen für sich selbst). Das Avatar-Menü enthält „Admin-Nutzer verwalten“ nicht mehr.
> * Alternativer Einladungsweg: In der Ressourcenübersicht (Katalog → Ressourcen) oder auf der Ressourcen-Detailseite ü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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.