Hopp til hovedinnhold
POST
Rapporter at pasienten har tatt prøven. Dette er motstykket for hjemmetestsett til Bekreft blodprøvetaking – uten strekkode, fordi settets kode påføres når settet pakkes. Du sender bare tidspunktet for prøvetakingen. Tidspunktet har klinisk betydning: det er prøvetakingstidspunktet som vil stå i labrapporten. Send pasientens faktiske prøvetakingstidspunkt, ikke tidspunktet da systemet ditt behandlet det. Å sende den samme activated_at på nytt returnerer 200 med den aktiverte bestillingen; en annen returnerer 409. Se Idempotens. Aktivering setter bestillingen til activated – en endelig status. En aktivert bestilling kan ikke lenger kanselleres, og sammensetningen og leveringsadressen er låst. Aktivering godtas mens bestillingen er pending eller dispatched, så lenge den har en lab_code – pasienten kan allerede ha et sett i hånden før vår registrering viser utsendt, og det faktiske prøvetakingstidspunktet vinner alltid over vår bokføring. En bestilling uten lab_code returnerer 409: uten koden kan prøven ikke kobles til pasienten på laboratoriet. Aktivering legger også inn laboratoriebestillingen for settets panel under bestillingens lab_code, slik at prøven er ventet på laboratoriet og resultatene kan kobles på i det øyeblikket de rapporteres. Dette skjer asynkront etter svaret – et problem hos laboratoriet får aldri forespørselen din til å feile. Fra nå av viser Hent resultater markørene som planned til laboratoriet rapporterer dem. En home_kit_order.results.updated-webhook gir deg beskjed når de endres. Hvis prøven når laboratoriet før du aktiverer settet, aktiverer Aniva det. activated_at er morgenen for den første sporingshendelsen til returpakken, eller morgenen da prøven ankom laboratoriet hvis det ikke finnes sporing. Et senere kall med en annen activated_at returnerer da 409. Krever scopet home_kit_orders_manage eller det snevrere scopet home_kit_orders_activate.

Forespørsel

Stiparametere

string
påkrevd
Unik identifikator (UUID) for bestillingen av hjemmetestsett som skal aktiveres.

Body-parametere

string
påkrevd
Når pasienten tok prøven, som et UTC-tidspunkt (ISO 8601 med Z-suffiks, f.eks. 2026-08-28T07:30:00Z). Må ikke være i fremtiden eller mer enn 30 dager tilbake i tid.

Respons

Ved suksess returnerer API-et 200 OK med den oppdaterte bestillingen av hjemmetestsett – status er activated, og activated_at inneholder tidsstempelet du sendte.

Feilresponser