Hoppa till huvudinnehåll
POST
Rapportera att patienten har tagit sitt prov. Det här är motsvarigheten för hemtestkit till Bekräfta blodprovstagning – utan streckkod, eftersom kitets kod sätts på när kitet packas. Du skickar bara tidpunkten för provtagningen. Tidpunkten har klinisk betydelse: det är den provtagningstid som labbrapporten kommer att visa. Skicka patientens faktiska provtagningstillfälle, inte tidpunkten då ditt system behandlade det. Att skicka samma activated_at igen returnerar 200 med den aktiverade beställningen; en annan returnerar 409. Se Idempotens. Aktivering flyttar beställningen till activated – en slutstatus. En aktiverad beställning kan inte längre avbrytas, och dess innehåll och leveransadress är låsta. Aktivering godtas medan beställningen har status pending eller dispatched, så länge den har en lab_code – patienten kan ha kitet i handen innan vårt system visar att det skickats, och den faktiska provtagningstiden vinner alltid över vår bokföring. En beställning utan lab_code returnerar 409: utan koden kan provet inte kopplas till patienten på labbet. Aktivering skickar även laboratoriebeställningen för kitets panel under beställningens lab_code, så att provet väntas på labbet och resultat kan kopplas så fort de rapporteras. Det sker asynkront efter svaret – ett problem hos laboratoriet gör aldrig att ditt anrop misslyckas. Härifrån visar Hämta resultat markörer som planned tills labbet rapporterar dem. En home_kit_order.results.updated-webhook meddelar dig när de ändras. Om provet når laboratoriet innan du aktiverar kitet aktiverar Aniva det. activated_at blir morgonen för returpaketets första spårningshändelse, eller morgonen då provet kom fram till laboratoriet om spårning saknas. Ett senare anrop med en annan activated_at returnerar då 409. Kräver scopet home_kit_orders_manage eller det snävare scopet home_kit_orders_activate.

Förfrågan

Sökvägsparametrar

string
obligatorisk
Unik identifierare (UUID) för hemtestkit-beställningen som ska aktiveras.

Body-parametrar

string
obligatorisk
När patienten tog provet, som en UTC-tidpunkt (ISO 8601 med Z-suffix, t.ex. 2026-08-28T07:30:00Z). Får inte ligga i framtiden eller mer än 30 dagar bakåt i tiden.

Svar

När anropet lyckas returnerar API:et 200 OK med den uppdaterade beställningen av hemtestkit – status är activated och activated_at innehåller tidsstämpeln du skickade.

Felsvar