Testsystem & Go-live

Sie entwickeln gegen eine eigene Testpraxis auf der Petla-Staging-Umgebung, und Sie gehen gegen eine Checkliste live.

Ihre eigene Testpraxis

Jeder Partner bekommt eine eigene Testpraxis mit angelegten Kunden, Tieren und Terminen, jederzeit auf Anforderung zurücksetzbar.

Hinweis

Es ist ein echtes System, kein Mock. Es schreibt echte Datensätze, liefert echte Konflikte und echte Fehler. Ein Mock würde genau die Fälle nicht zeigen, die Sie testen müssen — den vergebenen Slot, die uneindeutige Kundenzuordnung, den abgelaufenen Cursor.

Checkliste vor dem Go-live

GET /capabilities liefert genau die vorgesehenen Fähigkeiten.
Verfügbarkeit wird im vereinbarten Intervall veröffentlicht — einschließlich eines geschlossenen Tages.
Der geschlossene Tag ist der Test, den fast alle auslassen: Er unterscheidet ein leeres Array von einer ausgebliebenen Veröffentlichung.
Ein Termin wird empfangen, geschrieben und binnen 60 Sekunden bestätigt.
Eine Ablehnung wird durchgespielt, mit Grund.
Ein Cursor wird nach einem absichtlichen Ausfall fortgesetzt.
Ein abgelaufener Cursor wird behandelt: 410 führt zur vollständigen Neusynchronisierung.
Ein doppelt zugestelltes Ereignis wird ignoriert.
Verschieben und Absagen funktionieren in beide Richtungen.
Eine Kundenzuordnung liefert mindestens je einmal matched, created und ambiguous.
Die Praxis kann trennen, und Aufrufe danach scheitern sauber.
Der Auftragsverarbeitungsvertrag ist unterzeichnet.

Versionierung und was wir zusichern

Die Hauptversion steht im Pfad: /partner/v1/….

Ohne neue Version darf Petla

einen Endpunkt ergänzen,
ein optionales Feld in einer Anfrage ergänzen,
ein Feld in einer Antwort ergänzen,
einen Wert zu einer offenen Aufzählung hinzufügen,
einen Ereignistyp ergänzen,
eine Prüfregel lockern.

Ohne neue Version darf Petla nicht

irgendetwas entfernen oder umbenennen,
den Typ eines Feldes ändern,
ein optionales Feld verpflichtend machen,
einen Wert zu einer eingefrorenen Aufzählung hinzufügen,
einen Standardwert ändern,
aufhören, ein Feld zu befüllen.

Achtung

Eine abgekündigte Version wird ab der Ankündigung noch 12 Monate unterstützt, signalisiert über die Kopfzeilen Deprecation und Sunset. Keine Version wird abgeschaltet ohne schriftliches Einverständnis jedes Partners, der sie noch aufruft.

Rechtlicher Rahmen

Grundlage der Zusammenarbeit ist eine Schnittstellenvereinbarung zwischen Ihnen und Petla, begleitet von einem Auftragsverarbeitungsvertrag nach Art. 28 DSGVO.

Weil in der Tiermedizin § 203 StGB berührt sein kann, stellt Petla auf Anfrage ein vollständiges Unterlagenpaket bereit: AVV, Verpflichtungserklärung auf das Datengeheimnis, technische und organisatorische Maßnahmen, Liste der Unterauftragsverarbeiter und eine verständliche Beschreibung, welche Daten der Konnektor überhaupt bewegt.

Hinweis

Diese Unterlagen richten sich ausdrücklich auch an Ihre Kunden: Die Praxis wählt den Auftragsverarbeiter aus und trägt dafür Verantwortung. Das Paket ist so gebaut, dass Sie es weiterreichen können.

Support

Je eine benannte Ansprechperson auf beiden Seiten, bei Vertragsschluss vereinbart. Nennen Sie die requestId in jeder Meldung — damit finden wir den Aufruf in unseren Protokollen.

Petla veröffentlicht ein Änderungsprotokoll zu dieser Spezifikation. Brechende Änderungen werden dort zuerst angekündigt und treten nie in kürzerer Frist in Kraft als oben zugesichert.