> ## 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. # Zeitfenster und Pufferzeiten pro Ressource festlegen > Lege für jede mitgebuchte Ressource fest, wann sie belegt ist und wie viel Vor- und Nachbereitungszeit sie braucht. Wenn mit einem Service mehrere Ressourcen gebucht werden, blockiert anny standardmäßig jede davon für die gesamte Buchung. Mit **Zeitfenstern** legst du für jede mitgebuchte Ressource einzeln fest, wann sie tatsächlich gebraucht wird, z. B. nur in den ersten 30 Minuten. Mit **Pufferzeiten pro Ressource** gibst du einer einzelnen Ressource eine eigene Vorbereitungs- oder Nachbereitungszeit, ohne den Service für alle anderen Ressourcen zu ändern. Mit Zeitfenstern und Pufferzeiten pro Ressource kannst du in anny: * Personal nur für einen Teil der Buchung blockieren * Vorbereitung oder Reinigung vor bzw. nach der Buchung einplanen * einer einzelnen Ressource eine eigene Pufferzeit geben So bleiben deine Mitarbeitenden und Geräte für weitere Buchungen frei, sobald sie nicht mehr gebraucht werden. > [!NOTE] > > Ohne eigene Einstellung ändert sich nichts: Jede Ressource ist wie bisher für die ganze Buchung belegt und übernimmt die Pufferzeiten des Services. ## Typische Anwendungsfälle | Szenario | Beschreibung | | :- | :- | | **Personal nur teilweise blockieren:** Probefahrt mit Verkäufer | Ein Verkäufer begleitet nur die ersten 30 Minuten einer 90-minütigen Probefahrt. Danach ist er wieder für andere Termine buchbar. | | **Vor- und Nachbereitung einplanen:** Reinigung nach einer Bootsvermietung | Eine Reinigungskraft wird erst in den 30 Minuten nach der Rückgabe gebraucht. Das Boot ist nur während der Miete belegt. | | **Puffer nur für eine Ressource:** Elektroauto lädt nach jeder Fahrt | Ein Elektroauto braucht nach jeder Fahrt 30 Minuten zum Laden, die anderen Autos nicht. Du gibst die Nachbereitungszeit nur diesem einen Auto. | Nicht geeignet ist das für Leistungen, die Kund:innen zu einer anderen Uhrzeit separat buchen sollen. Dafür nutzt du **Empfohlene Ressourcen** unter [Zusatzoptionen](https://docs.anny.co/add-ons.md). ## Wie funktionieren Zeitfenster und Pufferzeiten? Auf dem Reiter **Ressourcen** eines Services hat jede verknüpfte Ressource eine Schaltfläche mit Uhr-Symbol. Sie zeigt, was für diese Ressource gilt, und öffnet den Editor: | Anzeige auf der Schaltfläche | Bedeutung | | :- | :- | | **Ganze Buchung** | Die Ressource ist für den gesamten Buchungszeitraum belegt (Standard). | | **Pufferzeiten wie Service** | Die Ressource übernimmt Vor- und Nachbereitungszeit des Services (Standard bei Ressourcen, die nur Pufferzeiten haben können, z. B. unter **Verbundene Ressourcen**). | | **Eigene Pufferzeiten** | Die Ressource hat eine eigene Vor- und/oder Nachbereitungszeit. | | z. B. **Buchungsbeginn → 30 Minuten nach Buchungsbeginn** | Die Ressource hat ein eigenes Zeitfenster. Mit eigenen Pufferzeiten folgt **· eigene Pufferzeiten**. | ### Welche Ressource kann was? Welche Einstellungen du bearbeiten kannst, hängt davon ab, wie die Ressource mit dem Service verknüpft ist: | Verknüpfung | Eigenes Zeitfenster | Eigene Pufferzeiten | | :- | :- | :- | | **Verbundene Ressourcen** (die Ressource, die Kund:innen buchen, z. B. das Auto) | Nein, ihr Zeitraum ist die Buchung selbst | Ja | | **Abhängigkeiten - Alle müssen verfügbar sein** | Ja | Ja | | **Gruppe {n} - Eine muss verfügbar sein** | Ja, ein gemeinsames Zeitfenster für die ganze Gruppe | Ja, gemeinsam für die Gruppe | | Ältere Abhängigkeiten mit **Buchen, wenn verfügbar** | Nein | Ja | | **Zusätzliche Ressourcen** (Reiter **Zusatzoptionen**) | Ja | Ja | | **Empfohlene Ressourcen** (Reiter **Zusatzoptionen**) | Nein, sie werden als eigene Buchung gebucht | Nein | ### Was ein Zeitfenster ändert und was nicht Ein Zeitfenster verschiebt nie die Buchung selbst: Uhrzeit, Dauer und Preis der Buchung bleiben gleich, ebenso Vorlaufzeit und Vorausbuchungszeitraum. Die mitgebuchte Ressource muss nur während ihres eigenen Zeitfensters plus ihrer Pufferzeiten frei und laut Zeitplan verfügbar sein. Endet die Schicht eines Verkäufers z. B. um 17:00, ist eine Probefahrt um 16:30 buchbar, wenn er nur die ersten 30 Minuten gebraucht wird. ### Wie Pufferzeiten zusammenspielen * Die Pufferzeit einer Ressource **ersetzt** die Pufferzeit des Services für diese eine Ressource. Vorbereitungs- und Nachbereitungszeit gelten dabei getrennt: Setzt du nur eine Nachbereitungszeit, bleibt die Vorbereitungszeit des Services erhalten. * Bei der Ressource, die Kund:innen buchen (**Verbundene Ressourcen**), liegt die Pufferzeit um die Buchung. Sie zählt für die freien Startzeiten auf der Buchungsseite, für den geblockten Zeitraum und für den Kalender. * Bei Abhängigkeiten und zusätzlichen Ressourcen liegt die Pufferzeit um das **Zeitfenster der Ressource**, nicht um die Buchung. * Hat eine Abhängigkeit keine eigenen Pufferzeiten, gilt für sie die Pufferzeit des Services, auch wenn die gebuchte Ressource eigene Pufferzeiten hat. * Änderst du die Pufferzeit einer einzelnen Buchung im Admin-Bereich, hat dieser Wert Vorrang vor Service und Ressource. ## Zeitfenster einrichten ### Voraussetzungen * Ein Service, bei dem die gebuchte Ressource unter **Verbundene Ressourcen** und die mitgebuchte Ressource (z. B. das Personal) unter **Abhängigkeiten - Alle müssen verfügbar sein** oder in einer **Abhängigkeitsgruppe** verknüpft ist. Wie du Abhängigkeiten anlegst, erklärt [Smart Availability](https://docs.anny.co/smart-availability.md). ### Zeitfenster für eine Abhängigkeit festlegen **1. Reiter Ressourcen öffnen** Öffne unter **Services** den gewünschten Service und wechsle auf den Reiter **Ressourcen**. **2. Editor öffnen** Klicke bei der Abhängigkeit auf die Schaltfläche mit dem Uhr-Symbol (**Ganze Buchung**). Der Editor **Zeitfenster** öffnet sich. **3. Beginn und Ende festlegen** Lege unter **Belegt ab** und **Belegt bis** jeweils eine Zeitspanne und den Bezugspunkt fest: **vor Buchungsbeginn**, **nach Buchungsbeginn**, **vor Buchungsende** oder **nach Buchungsende**. Bei Services in Minuten kannst du die Einheit zwischen Minuten und Stunden umschalten. Für „die ersten 30 Minuten“ setzt du **Belegt ab** auf 0 Minuten **nach Buchungsbeginn** und **Belegt bis** auf 30 Minuten **nach Buchungsbeginn**. Unten im Editor siehst du die Zusammenfassung, hier **Buchungsbeginn → 30 Minuten nach Buchungsbeginn**. **4. Optional: Pufferzeiten für diese Ressource** Trage unter **Vorbereitungszeit** und **Nachbereitungszeit** eigene Werte ein, wenn die Ressource vor oder nach ihrem Zeitfenster zusätzlich geblockt sein soll. Lässt du ein Feld leer (**Wie Service**), gilt die Pufferzeit des Services. **5. Speichern** Schließe den Editor und klicke oben rechts auf **Speichern**. Sobald das Zeitfenster gespeichert ist, prüft anny die Abhängigkeit nur noch für ihr eigenes Zeitfenster, und Kund:innen sehen mehr freie Startzeiten. ![Editor Zeitfenster bei Jonas Weber (Sales) unter Abhängigkeiten: Belegt ab 0 Minuten nach Buchungsbeginn, Belegt bis 30 Minuten nach Buchungsbeginn, Vorbereitungs- und Nachbereitungszeit leer (Wie Service)](https://mintcdn.com/anny-85c98540/Gkb0Duo_eFOIuCLx/images/resource-time-windows/01-time-window-editor-de.png?fit=max\&auto=format\&n=Gkb0Duo_eFOIuCLx\&q=85\&s=8c8b3eb4c5a07ae4a6740322410138b6) ### Pufferzeiten für eine einzelne Ressource festlegen **1. Editor der Ressource öffnen** Klicke auf dem Reiter **Ressourcen** bei der gewünschten Ressource, z. B. unter **Verbundene Ressourcen**, auf **Pufferzeiten wie Service**. Der Editor **Pufferzeiten** öffnet sich. **2. Vorbereitungs- oder Nachbereitungszeit eintragen** Trage die gewünschte **Vorbereitungszeit** und/oder **Nachbereitungszeit** ein. Ein leeres Feld übernimmt die Pufferzeit des Services, **0** blockiert keine Pufferzeit. **3. Speichern** Schließe den Editor und klicke oben rechts auf **Speichern**. Die Schaltfläche zeigt danach **Eigene Pufferzeiten**. Sobald die Pufferzeit gespeichert ist, blockiert anny sie nur bei Buchungen dieser einen Ressource. Alle anderen Ressourcen behalten die Pufferzeiten des Services. ![Editor Pufferzeiten beim Tesla Model 3 unter Verbundene Ressourcen: Vorbereitungszeit leer (Wie Service), Nachbereitungszeit 30 Minuten, Zusammenfassung Eigene Pufferzeiten](https://mintcdn.com/anny-85c98540/Gkb0Duo_eFOIuCLx/images/resource-time-windows/02-buffer-times-editor-de.png?fit=max\&auto=format\&n=Gkb0Duo_eFOIuCLx\&q=85\&s=8512d583c22bba2c0a14aa51b41e5586) ![Reiter Ressourcen nach dem Einrichten: Tesla Model 3 mit Eigene Pufferzeiten, BMW i4 mit Pufferzeiten wie Service, Jonas Weber (Sales) mit Buchungsbeginn → 30 Minuten nach Buchungsbeginn](https://mintcdn.com/anny-85c98540/Gkb0Duo_eFOIuCLx/images/resource-time-windows/03-resources-tab-configured-de.png?fit=max\&auto=format\&n=Gkb0Duo_eFOIuCLx\&q=85\&s=996c832f0a545dbb58b74e21d41a11eb) Mit **Zurücksetzen** im Editor stellst du die Ressource wieder auf die ganze Buchung und die Pufferzeiten des Services zurück. > [!TIP] > > Für zusätzliche Ressourcen findest du denselben Editor auf dem Reiter **Zusatzoptionen** unter **Zusätzliche Ressourcen**. Hat eine zusätzliche Ressource ein eigenes Zeitfenster, steht in ihrer Karte **Eigenes Zeitfenster** statt **Gleicher Zeitraum**. ## Einstellungen & Optionen | Einstellung | Beschreibung | | :- | :- | | **Belegt ab** | Beginn des Zeitfensters: Zeitspanne plus **vor/nach Buchungsbeginn** oder **vor/nach Buchungsende** | | **Belegt bis** | Ende des Zeitfensters, aufgebaut wie **Belegt ab** | | **Vorbereitungszeit** | Zusätzlich geblockte Zeit vor dem Zeitfenster dieser Ressource. Leer = **Wie Service**, 0 = keine. | | **Nachbereitungszeit** | Zusätzlich geblockte Zeit nach dem Zeitfenster dieser Ressource. Leer = **Wie Service**, 0 = keine. | | **Zurücksetzen** | Setzt Zeitfenster und Pufferzeiten auf den Standard zurück (ganze Buchung, Pufferzeiten des Services) | ### Welcher Bezugspunkt passt? Wähle den Bezugspunkt danach, was bei längeren Buchungen passieren soll. Ein Ende „30 Minuten nach Buchungsbeginn“ bleibt immer 30 Minuten lang, ein Ende „60 Minuten vor Buchungsende“ wächst mit der Buchungsdauer. | Gewünscht | Belegt ab | Belegt bis | | :- | :- | :- | | Ganze Buchung (Standard) | 0 nach Buchungsbeginn | 0 nach Buchungsende | | Die ersten 30 Minuten, egal wie lang die Buchung ist | 0 nach Buchungsbeginn | 30 Minuten nach Buchungsbeginn | | Alles außer den letzten 60 Minuten | 0 nach Buchungsbeginn | 60 Minuten vor Buchungsende | | Die letzten 15 Minuten | 15 Minuten vor Buchungsende | 0 nach Buchungsende | | 30 Minuten nach der Buchung (z. B. Reinigung) | 0 nach Buchungsende | 30 Minuten nach Buchungsende | | 15 Minuten vor der Buchung (z. B. Vorbereitung) | 15 Minuten vor Buchungsbeginn | 0 nach Buchungsbeginn | > [!WARNING] > > Ein Zeitfenster muss für jede mögliche Dauer des Services nach seinem Beginn enden. Bei flexibler Dauer prüft anny die minimale und die maximale Dauer. Ist das Zeitfenster null oder kürzer, zeigt der Editor einen roten Hinweis, und das Speichern wird abgelehnt. ![Editor Zeitfenster mit Belegt bis 30 Minuten vor Buchungsbeginn und rotem Hinweis, dass das Zeitfenster null oder kürzer wäre und das Speichern abgelehnt wird](https://mintcdn.com/anny-85c98540/Gkb0Duo_eFOIuCLx/images/resource-time-windows/04-time-window-too-short-de.png?fit=max\&auto=format\&n=Gkb0Duo_eFOIuCLx\&q=85\&s=322ccdf363ee6452f2cc7597e0b28af6) ## Einschränkungen * Die Ressource, die Kund:innen buchen (**Verbundene Ressourcen**), hat kein eigenes Zeitfenster, nur eigene Pufferzeiten. * Ältere Abhängigkeiten mit **Buchen, wenn verfügbar** haben nur eigene Pufferzeiten. * **Empfohlene Ressourcen** haben weder Zeitfenster noch eigene Pufferzeiten, weil sie als eigene Buchung entstehen. * Innerhalb einer **Gruppe {n} - Eine muss verfügbar sein** gilt ein gemeinsames Zeitfenster. Du stellst es bei einem Mitglied ein, alle anderen und neue Mitglieder übernehmen es. * Ein geändertes Zeitfenster gilt nicht rückwirkend. Bestehende Buchungen übernehmen es erst, wenn du sie verschiebst oder ihre Zeit bearbeitest. ## Praxisbeispiel: Probefahrt mit Verkäufer Ein Autohaus bietet eine **Probefahrt** von 90 Minuten an. Kund:innen wählen ein Auto (Tesla Model 3 oder BMW i4). Ein Verkäufer, Jonas Weber, begleitet nur die ersten 30 Minuten. Der Tesla muss nach jeder Fahrt 30 Minuten laden, der BMW nicht. Der Service selbst hat keine Vor- oder Nachbereitungszeit. | Ressource | Verknüpfung | Einstellung | | :- | :- | :- | | Tesla Model 3 | **Verbundene Ressourcen** | **Nachbereitungszeit** 30 Minuten | | BMW i4 | **Verbundene Ressourcen** | keine (**Pufferzeiten wie Service**) | | Jonas Weber (Verkauf) | **Abhängigkeiten - Alle müssen verfügbar sein** | **Belegt ab** 0 Minuten nach Buchungsbeginn, **Belegt bis** 30 Minuten nach Buchungsbeginn | **Ergebnis:** Jonas hat am Donnerstag von 10:45 bis 11:30 einen Kundentermin. Ohne Zeitfenster wäre er bei jeder Probefahrt 90 Minuten belegt. Auf der Buchungsseite blieben dann nur 09:00, 09:15 und Startzeiten ab 11:30 übrig. Mit Zeitfenster braucht ihn eine Probefahrt um 10:00 nur bis 10:30. Deshalb bietet anny die Startzeiten von 09:00 bis 10:15 und ab 11:30 an. Es entfallen nur die Startzeiten, bei denen seine 30 Minuten in den Kundentermin fallen würden. Nach einer Buchung um 10:00 ist Jonas von 10:00 bis 10:30 belegt. Der Tesla ist von 10:00 bis 11:30 gebucht und danach bis 12:00 durch seine Nachbereitungszeit geblockt. Der BMW wäre wieder ab 11:30 buchbar, der Tesla erst ab 12:00. In den Buchungsdetails siehst du unter **Zusätzliche Ressourcen** in der Spalte **Zeit**, wann Jonas belegt ist. ## FAQ > [accordion] Ändert sich etwas an meinen bestehenden Services? > > Nein. Ohne eigene Einstellung ist jede Ressource weiterhin für die ganze Buchung belegt und übernimmt die Pufferzeiten des Services. > [accordion] Was ist der Unterschied zwischen einem leeren Feld und 0? > > Ein leeres Feld übernimmt die Pufferzeit des Services (**Wie Service**). **0** bedeutet: für diese Ressource keine Pufferzeit, auch wenn der Service eine hat. > [accordion] Ich möchte, dass nur ein Auto eine Nachbereitungszeit hat. Ändere ich den Service? > > Nein. Die **Nachbereitungszeit** des Services gilt für alle Autos. Gib die Nachbereitungszeit stattdessen nur dem einen Auto über seine Schaltfläche **Pufferzeiten wie Service** auf dem Reiter **Ressourcen**. > [accordion] Ändert ein Zeitfenster den Preis der Buchung? > > Nein. Preis, Uhrzeit und Dauer der Buchung bleiben unverändert. Das Zeitfenster bestimmt nur, wann die mitgebuchte Ressource belegt ist. > [accordion] Sehen Kund:innen das Zeitfenster? > > Abhängigkeiten bleiben im Buchungsprozess ausgeblendet, solange du sie nicht sichtbar schaltest. Ist eine mitgebuchte Ressource sichtbar und hat sie eine andere Zeit als die Buchung, zeigt anny ihre eigene Zeit in der Bestätigungsmail, im Buchungs-PDF und im Wallet-Pass. ## Troubleshooting > [accordion] Das Speichern wird mit einem Hinweis zum Zeitfenster abgelehnt > > Das Zeitfenster wäre für mindestens eine Dauer des Services null oder kürzer, z. B. **Belegt bis** 60 Minuten **vor Buchungsende** bei einem Service mit 60 Minuten. Beziehe das Ende auf den Buchungsbeginn (z. B. 30 Minuten **nach Buchungsbeginn**) oder verkürze die Zeitspanne. Das gilt auch, wenn du später die Dauer des Services änderst: Passt ein bestehendes Zeitfenster nicht mehr, wird die Änderung abgelehnt, und die Meldung nennt die betroffene Ressource. > [accordion] Ich sehe bei einer Ressource nur Pufferzeiten, aber kein Zeitfenster > > Die Ressource ist unter **Verbundene Ressourcen** oder als ältere Abhängigkeit mit **Buchen, wenn verfügbar** verknüpft. Zeitfenster gibt es nur für **Abhängigkeiten - Alle müssen verfügbar sein**, Abhängigkeitsgruppen und zusätzliche Ressourcen. > [accordion] Eine Startzeit fehlt, obwohl die Abhängigkeit zu Beginn frei ist > > Eine eigene Vor- oder Nachbereitungszeit verlängert die Zeit, in der die Abhängigkeit frei sein muss. Ohne eigene Pufferzeiten gilt die Pufferzeit des Services auch für die Abhängigkeit. Prüfe Zeitfenster und Pufferzeiten der Abhängigkeit und setze bei Bedarf **0**. > [accordion] Ich finde den Reiter Zusatzoptionen nicht > > Der Reiter **Zusatzoptionen** erscheint nur, wenn die Zusatzoptionen für deinen Account aktiviert sind. Zeitfenster für Abhängigkeiten auf dem Reiter **Ressourcen** funktionieren unabhängig davon. > Wichtige Informationen für Agenten: > > * Felder pro Verknüpfung (`resource-services` und `service-sub-resources`): `start_anchor`/`start_offset`, `end_anchor`/`end_offset` (Anker `start` | `end`, Offset vorzeichenbehaftet in der Einheit des Services, Standard `start`+0 / `end`+0), `padding_before`/`padding_after` (`null` = Service, `0` = keine). > * UI-Mapping: **Belegt ab** = start, **Belegt bis** = end; „X vor Buchungsbeginn“ = Anker `start`, Offset −X; „X nach Buchungsende“ = Anker `end`, Offset +X. > * Offsets nur bei `availability_type: all_of_strong` (auch mit `group_key`) und `service-sub-resources` mit `booking_type: sub_booking`. `one_of` und `all_of_weak`: nur Padding. Empfehlungen (`recommended_*`): weder noch. Verstöße: Validierungsfehler `resource_time_window_booked_resource` bzw. `resource_time_window_recommendation`. > * Leeres Fenster (Ende ≤ Beginn für `min_duration` bzw. bei flexibler/Auto-Dauer `max_duration`): Fehler `resource_time_window_too_short`, nennt Ressource und Dauer. Wird auch bei Änderung von Dauer, Einheit, flexibler oder Auto-Dauer des Services geprüft. > * Gruppen (`group_key`) teilen Fenster und Padding: Schreiben auf ein Mitglied schreibt alle, neue Mitglieder übernehmen es. > * Padding-Auflösung: Link-Padding ersetzt Service-Padding pro Kante (`link ?? service`). One-of-Padding gilt für Startzeiten, Validierung und Kalender. Admin-Override pro Buchung gewinnt. > * Abhängigkeiten mit Fenster werden nur für ihr Fenster (+Padding) gegen Zeitplan, Blocker und Buchungen geprüft. Vorlaufzeit, Vorausbuchungszeitraum, Dauern, Buchungsintervall und Kontingente gelten nur für die Hauptbuchung; ein Vorbereitungsfenster darf vor „jetzt“ beginnen. > * Preis: Abhängigkeiten sind kostenlos; eine zusätzliche Ressource wird über ihren eigenen Service für ihr eigenes Fenster bepreist. > * UI-Pfade: Services → Service → Reiter **Ressourcen** → Uhr-Schaltfläche pro Ressourcenkarte (Popover **Zeitfenster** bzw. **Pufferzeiten**). Zusätzliche Ressourcen: Reiter **Zusatzoptionen** (Feature `additional-service-options`) → **Zusätzliche Ressourcen**, Badge **Eigenes Zeitfenster** / **Gleicher Zeitraum**. Buchungsdetails: **Zusätzliche Ressourcen** → Spalte **Zeit**. > * Verifiziert lokal (bookings-api main, anny-ui admin-next/head, 2026-11-02): 90-min-Probefahrt, Verkäufer `start`+0…`start`+30, Termin 10:45–11:30 → Starts 09:00–10:15 und ab 11:30 buchbar; ohne Fenster nur 09:00, 09:15 und ab 11:30. Tesla `padding_after` 30 → nach 10:00-Fahrt erst wieder ab 12:00, BMW ab 11:30. > * Abgrenzung: Empfohlene Ressourcen (separate Buchung zu relativer Zeit) sind ein anderes Feature, siehe Zusatzoptionen. Verwandt: Smart Availability (Abhängigkeiten, Gruppen), Buchungsoption (Service-Pufferzeiten), Zusatzoptionen. > * Admin-MCP-Skill: `resource-time-windows`. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.