Verfügbarkeit veröffentlichen Core

Ihr System veröffentlicht, wann die Praxis buchbar ist. Ohne diesen Fluss kann Petla nur Zeiten anbieten, die es sich ausgedacht hat.

Zwei Formate. Sie wählen genau eines.

Beide sind gleichwertig zulässig. Sie implementieren eines und erklären in PUT /capabilities, welches.

`busy` — was belegt ist

Das günstigere Format und der empfohlene Einstieg. Sie veröffentlichen die Intervalle, in denen eine Ressource nicht verfügbar ist. Petla zieht sie von den Öffnungszeiten ab, welche die Praxis bei Petla hinterlegt hat.

{
  "resourceId": "kal-1",
  "from": "2026-09-07",
  "to": "2026-11-02",
  "busy": [
    { "start": "2026-09-07T09:00:00+02:00", "end": "2026-09-07T09:30:00+02:00" },
    { "start": "2026-09-07T14:00:00+02:00", "end": "2026-09-07T18:00:00+02:00" }
  ]
}

Hinweis

Dieses Format trägt überhaupt keine Patientendaten — nur Zeitintervalle. Deshalb ist es der empfohlene erste Schritt: Es verhindert Doppelbuchungen und wirft datenschutzrechtlich keine einzige Frage auf.

`windows` — wann geöffnet ist

Sie veröffentlichen die buchbaren Fenster selbst, abgeleitet aus Ihrem eigenen Dienstplan. Petla benutzt dann diese statt der eigenen Konfiguration.

{
  "resourceId": "kal-1",
  "date": "2026-09-07",
  "windows": [
    { "start": "08:00", "end": "12:00", "modalities": ["PRAXIS"] },
    { "start": "14:00", "end": "18:00", "modalities": ["PRAXIS", "HOME_VISIT"] }
  ]
}

Regeln, die für beide Formate gelten

Eine Veröffentlichung ERSETZT, sie ergänzt nicht

Was Sie senden, ersetzt den genannten Zeitraum für die genannte Ressource vollständig. Es ist kein Delta. Ein Zeitraum mit leerem Array bedeutet geschlossen — nicht unverändert.

Der Horizont sollte mindestens 8 Wochen betragen.
Veröffentlichen Sie möglichst innerhalb von 5 Minuten nach einer Änderung. Wenn Ihr System das nicht kann, veröffentlichen Sie mindestens einmal pro Öffnungstag und geben Sie Ihr Intervall an — Petla bemisst danach, wie lange eine Reservierung gehalten wird und mit welcher Ablehnungsquote zu rechnen ist.
resourceId ist Ihre eigene Kennung und muss stabil sein. Petla ordnet sie bei der Einrichtung einem Petla-Kalender zu.

Zeiten: lokale Uhrzeit plus Zeitzone

Nicht tun

Immer lokale Wanduhrzeit plus IANA-Zeitzone. Nie ein blanker Zeitpunkt, nie ein fester Offset.

Ein Termin ist etwas, das ein Mensch plant, und er übersteht die Zeitumstellung nur als lokale Zeit in einer benannten Zone. Europe/Berlin ist nicht +02:00 — es ist +02:00 im August und +01:00 im Januar. Ein im September gebuchter Dezember-Termin darf sich nicht verschieben.

Jede Nutzlast, die eine Zeit trägt, trägt deshalb auch timeZone.

Veralten und Schweigen

Petla verfolgt das Alter der letzten Veröffentlichung je Ressource. Ab einer pro Partner vereinbarten Schwelle hört Petla auf, Zeiten dieser Ressource anzubieten, und teilt der Praxis den Grund mit.

Nicht tun

Eine leere Veröffentlichung und eine ausgebliebene Veröffentlichung sind verschiedene Zustände und dürfen nie zusammengeworfen werden. „Heute wurde nichts veröffentlicht“ ist eine Störung. „Heute ist nichts frei“ ist eine Tatsache. Wenn die Praxis heute geschlossen hat, senden Sie ein leeres Array — senden Sie nicht einfach nichts.

Modalität

Petla unterscheidet PRAXIS, HOME_VISIT und VIDEO.

Achtung

Die meisten Praxissysteme haben dafür kein Feld. Wenn Ihres die Modalität nicht abbilden kann, bilden Sie sie auf das ab, was Sie haben — eine Terminart, eine Farbe, eine Notiz — aber lassen Sie sie nicht fallen. Ein Hausbesuch, der als gewöhnliche Sprechstunde im Kalender steht, schickt eine Tierärztin an die falsche Adresse.