Spring til hovedindhold
POST
Indberet, at patienten har taget sin prøve. Dette er modstykket for hjemmetestkit til Bekræft blodprøvetagning — uden en stregkode, fordi kittets kode påsættes, når kittet pakkes. Du sender kun tidspunktet for prøvetagningen. Tidspunktet har klinisk betydning: Det er det prøvetagningstidspunkt, som laboratorierapporten vil indeholde. Send det tidspunkt, hvor patienten faktisk tog prøven, ikke det tidspunkt, hvor dit system behandlede den. Hvis du sender den samme activated_at igen, returneres 200 med den aktiverede ordre; en anden returnerer 409. Se Idempotens. Aktivering flytter ordren til activated — en endelig status. En aktiveret ordre kan ikke længere annulleres, og dens sammensætning og leveringsadresse er låst. Aktivering accepteres, mens ordren er pending eller dispatched, så længe den har en lab_code — patienten kan stå med et kit, før vores registrering siger afsendt, og det faktiske prøvetagningstidspunkt vinder altid over vores bogføring. En ordre uden lab_code returnerer 409: Uden koden kan prøven ikke matches med patienten på laboratoriet. Aktivering opretter også laboratorieordren for kittets panel under ordrens lab_code, så prøven forventes på laboratoriet, og resultater kan tilknyttes, så snart de indberettes. Dette sker asynkront efter svaret — et problem på laboratoriet får aldrig din anmodning til at fejle. Herfra viser Hent resultater markører som planned, indtil laboratoriet indberetter dem. En home_kit_order.results.updated-webhook giver dig besked, når de ændrer sig. Hvis prøven når frem til laboratoriet, før du aktiverer kittet, aktiverer Aniva det. activated_at er morgenen for den første sporingshændelse for returpakken eller den morgen, prøven ankom til laboratoriet, hvis der ikke er nogen sporing. Et senere kald med en anden activated_at returnerer derefter 409. Kræver scopet home_kit_orders_manage eller det snævrere scope home_kit_orders_activate.

Forespørgsel

Stiparametre

string
påkrævet
Unik identifikator (UUID) for den hjemmetestkitordre, der skal aktiveres.

Body-parametre

string
påkrævet
Hvornår patienten tog prøven, angivet som et UTC-tidspunkt (ISO 8601 med Z-suffiks, f.eks. 2026-08-28T07:30:00Z). Må ikke ligge i fremtiden eller mere end 30 dage tilbage i tiden.

Svar

Ved succes returnerer API’et 200 OK med den opdaterede hjemmetestkitordre — status er activated, og activated_at indeholder det tidsstempel, du sendte.

Fejlsvar