Naar hoofdinhoud gaan
POST
Meld dat de patiënt het monster heeft afgenomen. Dit is de tegenhanger voor thuistestkits van Bloedafname bevestigen — zonder barcode, omdat de code van de kit bij het inpakken wordt aangebracht. Je geeft alleen het tijdstip van afname door. Het tijdstip is klinisch van belang: het is het afnametijdstip dat op het labrapport komt te staan. Stuur het daadwerkelijke afnamemoment van de patiënt, niet het moment waarop je systeem dit heeft verwerkt. Opnieuw dezelfde activated_at sturen geeft 200 terug met de geactiveerde bestelling; een andere geeft 409 terug. Zie Idempotentie. Activering zet de bestelling op activated — een eindstatus. Een geactiveerde bestelling kan niet meer worden geannuleerd en de samenstelling en het bezorgadres staan vast. Activering wordt geaccepteerd zolang de bestelling pending of dispatched is en een lab_code heeft — de patiënt kan al een kit in handen hebben voordat onze registratie verzonden aangeeft, en het echte afnametijdstip gaat altijd voor op onze administratie. Een bestelling zonder lab_code geeft 409 terug: zonder de code kan het monster in het laboratorium niet aan de patiënt worden gekoppeld. Activering plaatst ook de laboratoriumaanvraag voor het panel van de kit onder de lab_code van de bestelling, zodat het monster bij het laboratorium wordt verwacht en resultaten direct gekoppeld kunnen worden zodra ze worden gemeld. Dit gebeurt asynchroon na het antwoord — een probleem bij het laboratorium laat je verzoek nooit mislukken. Vanaf dat moment toont Resultaten ophalen markers als planned totdat het laboratorium ze rapporteert. Een home_kit_order.results.updated-webhook meldt je wanneer ze veranderen. Als het monster het laboratorium bereikt voordat je de kit activeert, activeert Aniva de kit. activated_at is de ochtend van de eerste trackinggebeurtenis van het retourpakket, of de ochtend waarop het monster bij het laboratorium aankwam als er geen tracking is. Een latere aanroep met een andere activated_at geeft dan 409 terug. Vereist de scope home_kit_orders_manage of de beperktere scope home_kit_orders_activate.

Verzoek

Padparameters

string
vereist
Unieke identificatie (UUID) van de te activeren thuistestkitbestelling.

Bodyparameters

string
vereist
Wanneer de patiënt het monster heeft afgenomen, als UTC-tijdstip (ISO 8601 met Z-achtervoegsel, bijv. 2026-08-28T07:30:00Z). Mag niet in de toekomst liggen en niet meer dan 30 dagen in het verleden.

Respons

Bij succes retourneert de API 200 OK met de bijgewerkte thuistestkitbestelling — status is activated en activated_at bevat het tijdstempel dat je hebt verstuurd.

Foutresponsen