Zum Hauptinhalt springen
Mit dieser Anleitung bestätigst du, dass eine Blutabnahme stattgefunden hat. Die Bestätigung erfasst die Laborcodes (Röhrchen-Barcodes) des physischen Kits und startet die Laborauftrags-Pipeline; den Fortschritt der Ergebnisse liest du anschließend über Ergebnisse abrufen aus.
Die Bestätigung ist unumkehrbar. Sobald du eine Blutabnahme bestätigt hast, kannst du am Termin keine weiteren Änderungen mehr vornehmen – auch keine Panels mehr hinzufügen. Stelle sicher, dass alle Panels hinterlegt und alle Angaben korrekt sind, bevor du fortfährst.
1

Sicherstellen, dass Panels hinzugefügt wurden

Prüfe vor der Bestätigung, ob alle erforderlichen Test-Panels zum Termin hinzugefügt wurden. Nach der Bestätigung kannst du keine Panels mehr hinzufügen.In der Anleitung Termin planen erfährst du, wie du Panels hinzufügst.Stelle Folgendes sicher, bevor du fortfährst:
  • Alle erforderlichen Panels sind zum Termin hinzugefügt.
  • Die profile_id und location_id des Termins sind korrekt.
  • Der Patient hat die Blutabnahme abgeschlossen und der Barcode jedes Röhrchens liegt vor.
2

Blutabnahme bestätigen

Sende eine POST-Anfrage an /api/v1/appointments/{id}/confirm mit den Laborcodes des physischen Blutabnahme-Kits. Bei einer venösen Blutabnahme ist ein Code auf jedem Röhrchen aufgedruckt – sende ihn als lab_code. Bei einer Blutabnahme in der Apotheke gibt es einen Code pro Microtainer – sende sie als lab_codes, mit einem Eintrag pro Code und den panel_ids, die der jeweilige Microtainer enthält (aus panels des Termins); jeder Code wird zu einer eigenen Laboranforderung. Einzelne Biomarker in einer Apotheke füllen zuerst den freien Platz der Panel-Microtainer. Sende für jeden Microtainer, den sie für sich allein benötigen, einen Eintrag ohne panel_ids.
Jeder Code muss die Ziffernfolge sein, die auf dem physischen Röhrchen aufgedruckt ist, das dem Patienten übergeben wurde. Ersetze ihn nicht durch eine andere Kennung – ein falscher Code führt dazu, dass der Laborauftrag fehlschlägt. Jeder Code wird validiert, bevor etwas geschrieben wird; wird einer abgelehnt, wird nichts gespeichert.
Eine erfolgreiche Anfrage liefert 200 OK zurück:
3

Terminstatus prüfen

Rufe nach der Bestätigung den Termin ab, um zu prüfen, ob sich der Status auf blood_drawn geändert hat.
Sobald der Termin status: "blood_drawn" zeigt, wurde die Laborauftrags-Pipeline gestartet. Der Terminstatus selbst bleibt ab hier auf blood_drawn; den genaueren weiteren Verlauf liefern eigene Endpunkte: Folge jedem Eintrag im eingebetteten shipments-Array zu Sendung abrufen für Kurier-Events (unterwegs / zugestellt) und nutze Ergebnisse abrufen für den Abschluss der Laborergebnisse (status: "in_progress" → "completed").

Was als Nächstes passiert

Nach der Bestätigung übernimmt die Laborauftrags-Pipeline von Aniva:
  1. Jeder Laborcode wird im Labor seinen physischen Röhrchen zugeordnet – die Laboranforderung jedes Panels trägt den Code der zugehörigen Röhrchen.
  2. Die zum Termin hinzugefügten Panels bestimmen, welche Tests durchgeführt werden.
  3. Sobald Ergebnisse vorliegen, werden sie dem Patientenprofil zugeordnet und erscheinen unter Ergebnisse abrufen – das status-Feld auf oberster Ebene der Antwort wechselt von in_progress zu completed, sobald jede Einsendung abgeschlossen ist und eine Ergebnisse geliefert hat.
Nach der Bestätigung muss deine Integration nichts weiter tun.

Fehlerbehandlung