Zum Hauptinhalt springen
POST
Erfasse eine abgeschlossene Blutabnahme und starte die Laborauftrags-Pipeline. Übermittle die Laborcodes (Röhrchen-Barcodes) vom Blutabnahme-Kit, um die physischen Proben mit dem Termin zu verknüpfen. Bei einer Blutabnahme werden die Codes auf eine von zwei Arten angegeben:
  • Ein Code für die gesamte Blutabnahme – eine venöse Blutabnahme, bei der derselbe Barcode auf jedem Röhrchen aufgedruckt ist. Sende ihn als lab_code.
  • Ein Code pro Microtainer – eine kapillare Blutabnahme, bei der jeder Microtainer seinen eigenen Barcode hat. Sende sie als lab_codes, ein Eintrag pro Code mit den panel_ids, die der jeweilige Microtainer enthält. Jeder Code wird zu einem eigenen Laborauftrag – der Barcode auf dem Röhrchen ist die Auftragsnummer des Labors. Ein Eintrag ohne panel_ids ist ein Sammeleintrag für jedes Panel, das nirgendwo sonst genannt wird. Eine venöse Blutabnahme hat höchstens einen.
Sende genau eines von beiden. Jedes verknüpfte Panel muss unter genau einem Code landen (im eigenen Eintrag oder im Sammeleintrag). Bei einer venösen Blutabnahme benötigen Einzel-Biomarker den Sammeleintrag. Gib bei einer kapillaren Blutabnahme jedes Panel beim Code seines Microtainers an. Einzel-Biomarker füllen den freien Platz der Panel-Microtainer und öffnen nur bei Bedarf neue Microtainer. Wir verteilen sie gleichmäßig. Jeder Microtainer fasst höchstens 150 µl davon. Sende einen Eintrag ohne panel_ids für jeden Microtainer, den sie für sich allein benötigen, und nicht mehr. Ein Code, dem am Ende weder ein Panel noch ein Biomarker zugeordnet ist, wird mit 409 und reason: "panel_coverage" abgelehnt. Jeder Code wird geprüft, bevor etwas geschrieben wird; wenn ein Code nicht verwendet werden kann oder ein Panel nicht abgedeckt ist, wird nichts erfasst und die Antwort nennt das Problem. Erfordert den Scope appointments_schedule, appointments_manage oder appointments_operate.
Diese Aktion ist unwiderruflich. Sobald du die Blutabnahme bestätigst, ist der Termin gesperrt – es sind keine weiteren Änderungen möglich, auch kein Hinzufügen von Panels.

Anfrage

Pfadparameter

string
erforderlich
Eindeutige Kennung (UUID) des zu bestätigenden Termins.

Body-Parameter

string
Numerischer Laborcode auf dem Blutabnahme-Kit, wenn ein Code alle Röhrchen abdeckt. Schließt sich gegenseitig mit lab_codes aus.
object[]
Alle Laborcodes der Blutabnahme in Scan-Reihenfolge (mindestens ein Eintrag). Schließt sich gegenseitig mit lab_code aus. Ein Code darf nur einmal vorkommen; ein Panel darf nur in einem Eintrag genannt werden.

Antwort

Bei Erfolg gibt die API 200 OK zurück und bestätigt, dass die Laborauftrags-Pipeline gestartet wurde.
boolean
true, wenn die Blutabnahme erfasst und die Laborauftrags-Pipeline ausgelöst wurde.
string
Nur vorhanden, wenn die Blutabnahme an einem anderen Tag als dem Termintag erfasst wurde. Normale Schlüssel können das nicht – sie erhalten 409 mit reason: "appointment_not_today". Verschiebe den Termin auf den Tag der Blutabnahme und bestätige dann.
Die erfassten Codes werden unter Termin abrufen als lab_codes zurückgegeben, und jedes Ergebnis und Dokument unter Ergebnisse abrufen trägt den lab_code, unter dem es abgelegt wurde.

Fehlerantworten