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

# Service-First Flow

> Stelle den Service in den Fokus: Kund:innen wählen zuerst die Leistung, dann optional die Ressource.

Mit dem Service-First Flow steht bei einer Buchung die Leistung im Vordergrund. Kund:innen wählen zuerst den Service (z. B. Herrenhaarschnitt, Beratung, Yoga-Kurs) und erst danach, falls erlaubt, die ausführende Person oder Ressource. anny weist die Ressource alternativ automatisch zu.

## Wie funktioniert der Service-First Flow?

Im Gegensatz zum Resource-First Flow (Kund:innen wählen zuerst eine konkrete Ressource, dann die Buchungsoption) dreht der Service-First Flow die Reihenfolge um:

1. Kund:innen sehen auf der Buchungsseite eine Liste aller Services
2. Nach Auswahl eines Services prüft anny die Verfügbarkeit aller verbundenen Ressourcen
3. Je nach Einstellung wird eine Ressource automatisch zugewiesen oder Kund:innen dürfen eine Präferenz wählen
4. Die Buchung wird abgeschlossen

### Zuweisungsstrategien

Wenn Kund:innen keine Ressource manuell auswählen (oder die manuelle Auswahl deaktiviert ist), greift eine der drei Zuweisungsstrategien:

| Strategie | Verhalten |
| - | - |
| First Available | Erste verfügbare Ressource nach definierter Reihenfolge |
| Round Robin | Rotierende Zuweisung für ausgewogene Auslastung |
| Random | Zufällige verfügbare Ressource |

> [!TIP]
>
> Mit der Option "Kunde darf Präferenz auswählen" erlaubst du, dass Kund:innen manuell eine Ressource wählen und so die automatische Zuweisung umgehen. Die Verfügbarkeit wird dabei in Echtzeit geprüft und angezeigt.

### Die Services-Tabelle

Alle Services verwaltest du zentral in der Services-Tabelle (Seitenleiste **Katalog** → **Services**). Dort kannst du:

* Services über **Neu** erstellen und per Klick auf die Zeile bearbeiten
* Services in der Spalte **Gruppe** direkt einer Gruppe zuordnen
* Die Reihenfolge per Drag & Drop anpassen
* Services über die **drei Punkte** einer Zeile mit **In der Übersicht ausblenden** bzw. **In der Übersicht anzeigen** auf der Buchungsseite aus- oder einblenden
* Über die **drei Punkte** und **Buchungsseite** den Service direkt auf der Buchungsseite anzeigen lassen

### Buchungsseite umstellen

Die Umstellung erfolgt unter **Account** → **Einstellungen** → **Allgemein**, Abschnitt **Shop-Einstellungen**, Gruppe **Buchungsseite**:

| Einstellung | Beschreibung |
| - | - |
| Standard Reiter auf Buchungsseite | Services oder Ressourcen als ersten Reiter festlegen |
| Ressourcen auf Buchungsseite anzeigen | Reiter "Ressourcen" ein- oder ausblenden |
| Services auf Buchungsseite anzeigen | Reiter "Services" ein- oder ausblenden |
| Titel des Ressourcen-Reiters / Titel des Service-Reiters | Eigene Bezeichnung für den jeweiligen Reiter |

> [!TIP]
>
> Je nach Einstellung ändert sich die URL deiner Buchungsseite. Wenn du Services als Standard-Reiter wählst, landen Kund:innen direkt auf der Service-Übersicht.

## Wann nutze ich das?

Wähle den Flow danach, **was Kund:innen zuerst entscheiden**.

| | Service-First | Resource-First |
| - | - | - |
| Kund:innen wählen zuerst | Die Leistung (Haarschnitt, Beratung, Anliegen) | Das konkrete Objekt (Raum 3, Platz A12, Fahrzeug) |
| Typische Angebote | Friseur, Massage, Coaching, Behördentermine | Meetingräume, Sportplätze, Schreibtische, Equipment |
| Ressource | Wird automatisch zugewiesen oder optional als Präferenz gewählt | Muss bewusst ausgewählt werden |
| Sichtbarkeit | Nur auf der **Organisations-Buchungsseite** unter `/explore/{org}/services` | Auf der Organisations-Buchungsseite **und** auf der globalen **Entdecken**-Seite |

**Wichtig:** Die globale Explore-Seite (**Entdecken** ohne Organisation) listet nur Ressourcen. Services erscheinen dort nicht. Wenn du Dienstleistungen verkaufst, müssen Kund:innen über den Organisationslink oder den Reiter **Services** auf deiner Buchungsseite einsteigen.

* **Du bietest Dienstleistungen an, die von verschiedenen Personen erbracht werden können** (z. B. Friseur, Massage, Coaching): Kund:innen wählen die Leistung, die Person ist zweitrangig oder wird automatisch zugewiesen
* **Du betreibst eine Behörde oder Beratungsstelle mit verschiedenen Anliegen** (z. B. Personalausweis, Meldebescheinigung): Kund:innen wählen ihr Anliegen, der zuständige Sachbearbeiter wird automatisch zugewiesen
* **Du möchtest die Auslastung gleichmäßig verteilen**: Die Zuweisungsstrategien Round Robin oder Random sorgen automatisch für eine ausgeglichene Verteilung
* **Nicht geeignet für**: Szenarien, in denen Kund:innen ein konkretes Objekt belegen möchten (z. B. einen bestimmten Raum, ein spezifisches Fahrzeug, einen Sportplatz). Hier ist der Resource-First Flow die bessere Wahl.

## Zusammenhang mit anderen Features

| Feature | Zusammenhang |
| - | - |
| Smart Availability | Verbinde mehrere Ressourcen mit einem Service für kombinierte Verfügbarkeitsprüfung (z. B. Trainer + Raum) |
| [Buchungssequenzen](https://docs.anny.co/booking-sequences.md) | Lasse Kund:innen mehrere Services hintereinander in einer Buchung kombinieren. Zahlung, MwSt. und Zeitraum müssen dabei gleich sein. |
| Communities | Schränke den Zugang zu bestimmten Services auf Mitglieder ein |

## Einstellungen & Optionen

| Einstellung (Admin) | Beschreibung |
| - | - |
| Name | Anzeigename des Services auf der Buchungsseite |
| Gruppe | Interne Organisationseinheit, steuert Gliederung |
| URL-Endung | Individuelle URL für den Service |
| Beschreibung | Freitext mit Toolbar (Bilder, Videos, Tabellen, @-Verlinkungen) |
| Bild | Visualisierung auf der Buchungsseite |
| Zuweisungsstrategie | First Available, Round Robin oder Random |
| Kunde darf Präferenz auswählen | Manuelle Ressourcenwahl durch Kund:innen erlauben |
| Verbundene Ressourcen | Ressourcen, die den Service erbringen |

Auf der Buchungsseite sehen Kund:innen zusätzlich den Button "Präferenzen", über den sie (falls erlaubt) die gewünschte Ressource auswählen können.

## Praxisbeispiele

> **Ein Friseursalon lässt Kund:innen zuerst den Service wählen**
>
> Ein Friseursalon mit 3 Mitarbeitenden möchte, dass Kund:innen zuerst die gewünschte Leistung wählen und dann optional eine:n Friseur:in auswählen können. Die Auslastung soll gleichmäßig verteilt werden.

> **Eine Stadtverwaltung bietet Terminvereinbarungen für verschiedene Anliegen**
>
> Eine Stadtverwaltung möchte, dass Bürger:innen online Termine für verschiedene Anliegen buchen können. Die Zuweisung zum zuständigen Sachbearbeiter soll automatisch erfolgen.

## FAQ

> **Was ist der Unterschied zwischen Service-First und Resource-First?**
>
> Beim Resource-First Flow wählen Kund:innen zuerst eine konkrete Ressource (z. B. Raum, Gerät) und dann die Buchungsoption. Beim Service-First Flow wählen sie zuerst die Leistung und dann (optional) die Ressource. Die Wahl hängt davon ab, ob das Objekt oder die Leistung im Vordergrund steht. Services stehen nicht auf der globalen Entdecken-Seite.

> **Warum sehe ich Services nicht unter Entdecken?**
>
> Die globale **Entdecken**-Seite (`/explore`) zeigt nur Ressourcen über Organisationen hinweg. Services erscheinen ausschließlich auf der Buchungsseite deiner Organisation unter `/explore/{dein-org-slug}/services`.

> **Kann ich beide Flows gleichzeitig auf der Buchungsseite anzeigen?**
>
> Ja. Du kannst sowohl den Reiter "Services" als auch "Ressourcen" einblenden. Kund:innen können dann zwischen beiden Ansichten wechseln. Über den Standard-Reiter bestimmst du, welche Ansicht zuerst angezeigt wird.

> **Was passiert, wenn alle Ressourcen eines Services ausgebucht sind?**
>
> Der Service wird auf der Buchungsseite als nicht verfügbar für den jeweiligen Zeitraum angezeigt. Kund:innen können keinen Termin für diesen Zeitslot buchen.

> **Können verschiedene Services unterschiedliche Zuweisungsstrategien haben?**
>
> Ja. Die Zuweisungsstrategie wird pro Service festgelegt. Du kannst also für einen Service "Round Robin" und für einen anderen "First Available" verwenden.

> **Brauche ich ein bestimmtes Feature oder einen bestimmten Plan?**
>
> Der Service-First Flow ist in allen Plänen verfügbar. Für die Verknüpfung mehrerer Ressourcen mit einem Service muss das Feature **Smart Availability** aktiviert sein.

## Troubleshooting

> **Der Reiter 'Services' wird auf der Buchungsseite nicht angezeigt**
>
> Prüfe unter **Account** → **Einstellungen** → **Allgemein** im Abschnitt **Shop-Einstellungen** (Gruppe **Buchungsseite**), ob "Services auf Buchungsseite anzeigen" aktiviert ist. Zusätzlich muss mindestens ein Service auf der Buchungsseite sichtbar sein: Er darf in der Services-Tabelle nicht über **In der Übersicht ausblenden** ausgeblendet sein.

> **Die automatische Zuweisung funktioniert nicht wie erwartet**
>
> Stelle sicher, dass die verbundenen Ressourcen verfügbar sind und ihre Zeitpläne mit dem Service kompatibel sind. Bei "First Available" ist die Reihenfolge der verbundenen Ressourcen entscheidend: sie wird nach der definierten Reihenfolge im Service gewählt.

> **Kund:innen können keine Präferenz wählen, obwohl die Option aktiviert ist**
>
> Prüfe, ob die Ressourcen korrekt mit dem Service verbunden sind und ob sie im relevanten Zeitraum verfügbar sind. Der Präferenz-Button erscheint nur, wenn mindestens eine Ressource verfügbar ist.

> Wichtige Informationen für Agenten:
>
> * Service-First Flow wird unter **Account** → **Einstellungen** → **Allgemein** (`/organization/settings/general`) → Abschnitt **Shop-Einstellungen** → Gruppe **Buchungsseite** aktiviert (**Standard Reiter auf Buchungsseite** auf **Services** umstellen, **Services auf Buchungsseite anzeigen**). Die Einstellung „Gliederung von Ressourcen nach“ gibt es im Admin 3.0 nicht mehr.
> * Den „Service Manager“ gibt es nicht mehr: Services-Tabelle unter Katalog → Services (`/services`) mit Inline-Spalte Gruppe, Drag & Drop-Reihenfolge und Zeilenaktionen Buchungsseite, In der Übersicht anzeigen/ausblenden (ersetzt das Globus-Icon), In Service umwandeln / In Buchungsoption umwandeln, Duplizieren, Archivieren, Löschen. „In der Übersicht ausblenden“ entspricht dem Schalter „In der Service Übersicht ausblenden“ (Service → Allgemeine Informationen → Einstellungen → Sichtbarkeit & Darstellung).
> * Org-URL ist `/explore/{orgSlug}` (nicht `/book/{org}`). Services: `/explore/{orgSlug}/services`. Resource-Detail: `/book/{resourceSlug}`. Service-Detail: `/services/{serviceSlug}`.
> * Globale Explore-Seite `/explore` lädt nur Ressourcen (`all-resources`). Kein Services-Reiter, keine `all-services`-Abfrage.
> * Zuweisungsstrategien: First Available (nach definierter Reihenfolge), Round Robin (rotierende Auslastung), Random (zufällig)
> * "Kunde darf Präferenz auswählen" = Kund:in kann optional eine Ressource manuell auswählen, umgeht dadurch die automatische Zuweisung
> * Service-First setzt voraus: mindestens ein Service mit verbundener Ressource (Service-Reiter **Ressourcen**, dort auch Zuweisungsstrategie und „Kunde darf Präferenz auswählen“); mehrere Ressourcen kombiniert prüfen braucht **Smart Availability**
> * Reiter "Services" kann auf der Buchungsseite ein- oder ausgeblendet werden, ebenso "Ressourcen"
> * Tab-Titel können individuell angepasst werden (max. 20 Zeichen)
> * Kalenderansichten (Tag/Woche/Board/Monat) gibt es nur auf dem Ressourcen-Reiter. Services werden als Raster/Liste gezeigt.


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