Zum Hauptinhalt springen
PATCH
Aktualisiere Termindetails wie die geplante Uhrzeit oder den Teststandort. Nur Termine, deren Blutabnahme noch nicht bestätigt wurde, können geändert werden.
Termine können nicht mehr geändert werden, nachdem die Blutabnahme bestätigt wurde oder wenn sie bereits storniert wurden. Der Versuch, einen solchen Termin zu aktualisieren, gibt 409 Conflict zurück. Die einzige Ausnahme ist results_ready_emails, das du auch nach der Blutabnahme noch ändern kannst.
Erfordert den Scope appointments_schedule oder appointments_manage.

Anfrage

Pfadparameter

string
erforderlich
Eindeutige Kennung (UUID) des Termins, der aktualisiert werden soll.

Body-Parameter

Alle Body-Parameter sind optional – gib nur die Felder an, die du ändern möchtest.
string
Neuer Terminzeitpunkt im ISO-8601-Format (z. B. 2026-05-20T14:00:00Z oder 2026-05-20T16:00:00+02:00). Muss eine Zeitzonenangabe enthalten – entweder Z oder einen expliziten Offset wie +02:00; Zeitangaben ohne Zeitzone werden abgelehnt. Muss in der Zukunft liegen.Muss ein exakter Slot-Beginn mit freier Kapazität sein – siehe Verfügbarkeit abrufen. Der Termin, der verschoben wird, zählt niemals gegen seinen eigenen Ziel-Slot, aber das Verschieben auf einen Slot, in dem dasselbe Profil bereits einen anderen Termin hat, gibt 409 mit der appointment_id dieses Termins zurück.Wenn der Zielstandort von Aniva betrieben wird, muss die neue Zeit außerdem mindestens 12 Stunden in der Zukunft liegen – siehe Mindestvorlaufzeit.
string
UUID des neuen Teststandorts. Der Standort muss existieren und aktiv sein. Nutze Standorte auflisten, um verfügbare Standort-IDs zu finden.
string[]
Ersetzt die Liste mit bis zu 5 Adressen, die jeweils eine E-Mail erhalten, sobald alle Laborergebnisse endgültig vorliegen. Sende [], um die E-Mails zu deaktivieren. Dieses Feld bleibt nach der Blutabnahme bearbeitbar; nur ein stornierter Termin lehnt es ab. Sende es nach der Blutabnahme allein: Zusammen mit scheduled_at oder location_id im selben Body gibt die Anfrage 409 zurück. Dein Schlüssel benötigt results_view-Zugriff auf den Patienten, sonst wird 403 zurückgegeben. Siehe E-Mails bei fertigen Ergebnissen.
string | null
Neue Abnahmemethode: capillary oder venous, oder null, um wieder die default_draw_method des Standorts zu verwenden. Der Standort muss die Methode in draw_methods aufführen und die gebuchten Tests müssen damit möglich sein, sonst wird 400 zurückgegeben. Wenn du einen Termin an einen anderen Standort verschiebst, läuft dort dieselbe Prüfung: für seine eigene draw_method, sonst für die default_draw_method des neuen Standorts.

Antwort

Bei Erfolg gibt die API 200 OK mit dem aktualisierten Termin und dem eingebetteten Profil zurück.
string
erforderlich
Eindeutige Terminkennung (UUID).
string
erforderlich
UUID des Profils, zu dem dieser Termin gehört.
string
UUID des Teststandorts, an dem die Blutabnahme stattfindet.
string
Geplanter Terminzeitpunkt als UTC-Zeitpunkt (ISO 8601 mit Z-Suffix, z. B. 2026-05-20T14:00:00Z). Kann null sein.
string
erforderlich
Aktueller Terminstatus. Einer von pending, confirmed, blood_drawn oder cancelled. Wie vollständig die Laborergebnisse sind, ergibt sich aus Ergebnisse abrufen; den genaueren Versandverlauf siehst du über jeden Eintrag im eingebetteten shipments-Array (siehe unten) in Kombination mit Sendung abrufen.
string
Freitextgrund, der bei der Stornierung des Termins erfasst wurde (z. B. Nichterscheinen, späte Stornierung, ‘Fehlgeschlagen. Wiederholung erforderlich’). null, sofern status nicht cancelled ist.
string[]
erforderlich
Adressen in Kleinbuchstaben, die jeweils eine E-Mail erhalten, sobald alle Laborergebnisse final sind. Leer, wenn deaktiviert. Siehe E-Mails bei fertigen Ergebnissen.
string
erforderlich
Art der Blutabnahme: capillary (aus der Fingerkuppe oder dem Oberarm, in Microtainer) oder venous (aus der Vene, in Röhrchen). Entspricht der im Termin festgelegten Methode, sonst der default_draw_method des Standorts. Nach der Blutabnahme ist es die verwendete Methode.
string
erforderlich
ISO-8601-Zeitstempel der Erstellung des Termins.
string
ISO-8601-Zeitstempel der letzten Aktualisierung. Kann null sein.
object
erforderlich
Das mit diesem Termin verknüpfte Patientenprofil.
AppointmentPanel[]
erforderlich
Panels, die derzeit diesem Termin zugeordnet sind. Stornierte Zuordnungen sind ausgeschlossen. Panel-Details (Name, Biomarker) findest du über Panels auflisten.
AppointmentIndividualBiomarker[]
erforderlich
Einzel-Biomarker, die außerhalb eines Panels mit diesem Termin verknüpft sind (siehe Eigene Biomarker hinzufügen). Gleiche jede biomarker_id für Anzeigedaten mit Biomarker auflisten ab.
AppointmentShipmentLink[]
erforderlich
Sendungen, die mit diesem Termin verknüpft sind, älteste Verknüpfung zuerst. Leeres Array, wenn keine Sendungen verknüpft sind. Gleiche jede id mit Sendung abrufen ab, um die vollständige Sendungs-Payload zu erhalten.
string[]
erforderlich
Laborcodes (Röhrchen-Barcodes), die für diesen Termin erfasst wurden, in Scan-Reihenfolge. Leer, bis die Blutabnahme bestätigt wird. Eine venöse Blutabnahme hat einen Code, der auf jedem Röhrchen steht; eine kapillare Blutabnahme hat einen Code pro Microtainer. Ergebnisse und Dokumente unter Ergebnisse abrufen verweisen über lab_code auf diese Codes.

Fehlerantworten