Petla Partner API
Die Buchungs-Schnittstelle zwischen Petla und Ihrem Praxisverwaltungssystem. Ein Tierhalter bucht auf Petla, der Termin landet im Kalender der Praxis — in Ihrem System, in dem die Praxis ohnehin arbeitet.
Petla besitzt den Kalender der Praxis nicht — und will das auch nicht. Ihr System veröffentlicht, wann die Praxis buchbar ist. Petla bietet diese Zeiten Tierhaltern an und schickt gebuchte Termine zurück. Jede Entwurfsentscheidung in dieser Dokumentation folgt daraus.
Was die Integration leistet
Sie bringt Nachfrage. Petla betreibt den Tierarztfinder und die App für Tierhalter. Die Termine, die dabei entstehen, kommen zu einem erheblichen Teil von Haltern, die noch nicht zum Kundenstamm der Praxis gehören.
Konkret:
- Ein Tierhalter bucht auf Petla, der Termin erscheint in Ihrem Kalender.
- Petla bietet keine Zeit an, die die Praxis bereits vergeben hat.
- Halter, Tier und Anliegen werden in Ihr System übertragen.
- Verschiebungen und Absagen werden in beide Richtungen gemeldet.
Und was sie ausdrücklich nicht tut
- Sie ersetzt weder Kalender noch Patientenakte, Abrechnung oder Apotheke.
- Sie zwingt die Praxis nicht, ein Petla-Dashboard zu benutzen.
- Sie gibt Petla keinen Lesezugriff auf klinische Daten. In Version 1 fließen ausschließlich Termine zurück.
- Sie verschickt nichts an Tierhalter, dem die Praxis nicht zugestimmt hat.
Die zwei Flüsse
Es sind zwei, beide sind nötig, und sie laufen in entgegengesetzte Richtungen. Wer macht den Aufruf, ist eine getrennte Frage — siehe unten.
Ihr System muss keine eingehenden HTTPS-Anfragen entgegennehmen können. Alles Verpflichtende in dieser Schnittstelle ist ein Aufruf, den Ihr System an Petla richtet — auch das Abholen neuer Termine, das über Polling läuft. Ein Praxisrechner hinter einem Router kann die vollständige Integration betreiben. Wer eingehende Anfragen annehmen kann, bekommt zusätzlich die Slot-Reservierung (siehe Termine empfangen).
Was Sie mindestens implementieren müssen
Jede Funktion trägt eine Konformitätsstufe. Sie erklären mit PUT /capabilities, was Ihr System kann; Petla schaltet pro Praxis genau so viel frei. Was Ihre Verbindung nicht unterstützt, wird der Praxis als „Ihre Praxissoftware unterstützt das nicht“ angezeigt — nie als leeres Ergebnis.
| Stufe | Bedeutung |
|---|---|
| Core | Muss implementiert werden. Ohne diese Funktionen gibt es keine Integration. |
| Extended | Sollte implementiert werden. Petla hat für jede dieser Funktionen ein definiertes Verhalten, wenn sie fehlt. |
| Implementierungsspezifisch | Kann implementiert werden. Wird pro Partner abgestimmt. |
Core sind vier Dinge: die Fähigkeiten erklären, Verfügbarkeit veröffentlichen, den Ereignis-Strom abrufen und jeden empfangenen Termin bestätigen.
Wo Sie weiterlesen
Diese Dokumentation ist ein Entwurf und wird gegen die Antworten der ersten beiden Partner finalisiert — nicht gegen die eines einzigen. Wenn Ihr System eine der Annahmen hier nicht erfüllt, ist das genau die Rückmeldung, die wir jetzt brauchen: partner@petla.app.