Zum Hauptinhalt springen
POST
Melde, dass der Patient seine Probe genommen hat. Dies ist das Heimtest-Kit-Gegenstück zu Blutabnahme bestätigen – ohne Barcode, da der Code des Kits beim Packen angebracht wird. Du übergibst nur den Zeitpunkt der Probenahme. Der Zeitstempel ist klinisch wichtig: Er ist der Zeitpunkt der Probenahme, der im Laborbericht steht. Sende den tatsächlichen Zeitpunkt der Probenahme des Patienten, nicht den Zeitpunkt, zu dem dein System dies verarbeitet hat. Erneutes Senden desselben activated_at gibt 200 mit der aktivierten Bestellung zurück; ein anderer Wert gibt 409 zurück. Siehe Idempotenz. Die Aktivierung setzt die Bestellung auf activated – ein Endstatus. Eine aktivierte Bestellung kann nicht mehr storniert werden, und ihre Zusammensetzung sowie Lieferadresse sind gesperrt. Eine Aktivierung wird akzeptiert, solange die Bestellung pending oder dispatched ist und einen lab_code hat – der Patient kann ein Kit schon in den Händen halten, bevor unsere Daten es als versendet führen, und sein tatsächlicher Zeitpunkt der Probenahme hat immer Vorrang vor unserer Buchführung. Eine Bestellung ohne lab_code gibt 409 zurück: Ohne den Code lässt sich die Probe im Labor nicht dem Patienten zuordnen. Die Aktivierung gibt außerdem den Laborauftrag für das Panel des Kits unter dem lab_code der Bestellung auf, sodass die Probe im Labor erwartet wird und Ergebnisse sofort zugeordnet werden können, sobald sie gemeldet werden. Das passiert asynchron nach der Antwort – ein Laborproblem lässt deine Anfrage nie fehlschlagen. Ab diesem Zeitpunkt zeigt Ergebnisse abrufen Marker als planned an, bis das Labor sie meldet. Ein home_kit_order.results.updated-Webhook benachrichtigt dich, wenn sie sich ändern. Wenn die Probe das Labor erreicht, bevor du das Kit aktivierst, aktiviert Aniva es. activated_at ist der Morgen des ersten Tracking-Ereignisses des Rücksendepakets oder der Morgen, an dem die Probe im Labor eingetroffen ist, falls es kein Tracking gibt. Ein späterer Aufruf mit einem anderen activated_at gibt dann 409 zurück. Erfordert den Scope home_kit_orders_manage oder den engeren Scope home_kit_orders_activate.

Anfrage

Pfadparameter

string
erforderlich
Eindeutige Kennung (UUID) der Heimtest-Kit-Bestellung, die aktiviert werden soll.

Body-Parameter

string
erforderlich
Wann der Patient die Probe genommen hat, als UTC-Zeitpunkt (ISO 8601 mit Z-Suffix, z. B. 2026-08-28T07:30:00Z). Darf nicht in der Zukunft und nicht mehr als 30 Tage in der Vergangenheit liegen.

Antwort

Bei Erfolg gibt die API 200 OK mit der aktualisierten Heimtest-Kit-Bestellung zurück – status ist activated und activated_at enthält den Zeitstempel, den du gesendet hast.

Fehlerantworten