Zum Hauptinhalt springen
POST
Plane einen Termin zur Blutabnahme für ein Patientenprofil an einem bestimmten Teststandort. Nach dem Erstellen erhält der Termin standardmäßig den Status confirmed (bei manchen Standorten kann der Standard stattdessen pending sein – das ist eine Standorteinstellung). Füge mit Panels hinzufügen Bluttest-Panels hinzu, bevor du die Blutabnahme bestätigst.
Ein Profil kann pro Standort und Zeitpunkt höchstens einen Termin haben. Wenn du einen Termin für einen Zeitslot erstellst, den das Profil bereits belegt, gibt die API 409 mit der vorhandenen appointment_id zurück statt eines zweiten Termins – so kann eine wiederholte oder versehentlich doppelt gesendete Anfrage niemals eine Buchung verdoppeln. Siehe Doppelte Termine.
Sende einen optionalen Idempotency-Key-Header, damit sich das Erstellen sicher wiederholen lässt – bei Wiederholung mit demselben Schlüssel kommt die ursprüngliche Antwort zurück, statt einen zweiten Termin zu erstellen. Siehe Idempotenz. Erfordert den Scope appointments_schedule.

Anfrage

Body-Parameter

string
erforderlich
UUID des Patientenprofils, für das der Termin erstellt werden soll.
string
erforderlich
UUID des Teststandorts, an dem die Blutabnahme stattfindet. Nutze Standorte auflisten, um verfügbare Standort-IDs zu finden.
string
erforderlich
Datum und Uhrzeit des Termins im ISO-8601-Format (z. B. 2026-05-15T10:30:00Z oder 2026-05-15T12:30: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 genau dem Start eines Zeitslots im Raster des Standorts entsprechen, und der Slot muss noch Kapazität haben – lies zuerst Verfügbarkeit abrufen. Zeiten außerhalb des Rasters geben 400 zurück; ein ausgebuchter Slot gibt 409 zurück. An von Aniva betriebenen Standorten muss der Termin außerdem mindestens 12 Stunden in der Zukunft liegen – siehe Mindestvorlaufzeit.
string[]
Bis zu 5 Adressen, die jeweils eine E-Mail erhalten, sobald alle Laborergebnisse final sind. Die E-Mail verlinkt auf die Ergebnisseite im Aniva-Admin-Panel. Dein Schlüssel braucht results_view-Zugriff auf den Patienten, sonst 403. Lass das Feld weg, um die Standardadressen der Gruppe des Patienten zu verwenden. Eine leere Liste schaltet die E-Mails aus. Siehe E-Mails bei fertigen Ergebnissen.
string
Art der Blutabnahme: capillary oder venous. Lass das Feld weg, um die default_draw_method des Standorts zu verwenden. Der Standort muss die Methode in draw_methods aufführen, sonst 400.

Antwort

Bei Erfolg gibt die API 201 Created mit dem neuen Termin 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 in UTC (ISO 8601 mit Z-Suffix, z. B. 2026-05-15T10:30: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.
object
erforderlich
Das mit diesem Termin verknüpfte Patientenprofil.
AppointmentPanel[]
erforderlich
Aktuell diesem Termin zugeordnete Panels. Bei neu erstellten Terminen leer – füge sie über Panels hinzufügen hinzu. Panel-Details (Name, Biomarker) findest du über Panels auflisten.
AppointmentIndividualBiomarker[]
erforderlich
Einzeln gewählte Biomarker, die diesem Termin außerhalb eines Panels zugeordnet sind. Bei neu erstellten Terminen leer – füge sie über Einzelne Biomarker hinzufügen hinzu. Gleiche jede biomarker_id mit Biomarker auflisten ab, um Anzeigedaten zu erhalten.
AppointmentShipmentLink[]
erforderlich
Mit diesem Termin verknüpfte Sendungen, älteste Verknüpfung zuerst. Bei neu erstellten Terminen leer – verknüpfe sie über Sendung erstellen (mit appointment_id) oder Termine einer Sendung zuordnen.
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.

Mindestvorlaufzeit

Termine an von Aniva betriebenen Standorten müssen mindestens 12 Stunden im Voraus gebucht werden; eine Buchung innerhalb dieses Zeitfensters gibt 400 zurück. Verfügbarkeit abrufen blendet diese Slots bereits aus, daher ist alles, was du aus diesem Raster liest, buchbar. Standorte, die du selbst betreibst, haben keine Mindestvorlaufzeit – Buchungen am selben Tag und Walk-ins bleiben unverändert.

Doppelte Termine

Ein Profil kann pro Standort und Zeitpunkt höchstens einen nicht stornierten Termin haben – bei einer Person kann nicht zweimal gleichzeitig am selben Ort Blut abgenommen werden, egal wie viele Stühle der Standort hat. Wenn du einen Termin für einen Slot erstellst, den das Profil bereits belegt, kommt 409 mit einer appointment_id zurück, die den bereits bestehenden Termin nennt:
Behandle die Anfrage in dem Fall als bereits ausgeführt: Ruf den Termin mit Termin abrufen ab, verschiebe ihn mit Termin aktualisieren oder storniere ihn mit Termin stornieren. Wiederhole das Erstellen nicht – es gibt weiter 409 zurück. Das macht wiederholtes Erstellen sicher: Eine Anfrage, die du nach einem Timeout erneut sendest, oder ein doppelt abgeschicktes Formular kann nicht zwei Termine zur selben Zeit für denselben Patienten erzeugen.
appointment_id ist nur beim 409 wegen eines doppelten Termins enthalten. Das 409 wegen fehlender Kapazität – der Slot ist voll, weil andere Patienten ihn belegen – gibt nur error zurück; die richtige Lösung ist dann, einen anderen Slot aus Verfügbarkeit abrufen zu wählen.

Fehlerantworten