Siirry pääsisältöön
POST
Ilmoita, että potilas otti näytteensä. Tämä on kotitestipakkauksen vastine päätepisteelle Vahvista verinäytteenotto — ilman viivakoodia, koska pakkauksen koodi lisätään pakkaamisen yhteydessä. Välität vain näytteenoton aikaleiman. Aikaleimalla on kliinistä merkitystä: se on näytteenottoaika, joka tulee laboratorioraporttiin. Lähetä potilaan todellinen näytteenottohetki, älä hetkeä jolloin järjestelmäsi käsitteli sen. Saman activated_at-arvon lähettäminen uudelleen palauttaa 200 ja aktivoidun tilauksen; eri arvo palauttaa 409. Katso Idempotenssi. Aktivointi siirtää tilauksen activated-tilaan, joka on lopullinen tila. Aktivoitua tilausta ei voi enää peruuttaa, ja sen sisältö sekä toimitusosoite lukitaan. Aktivointi hyväksytään tilauksen ollessa pending- tai dispatched-tilassa, kunhan sillä on lab_code — potilaalla voi olla pakkaus kädessään jo ennen kuin kirjauksemme näyttää sen lähetetyksi, ja hänen todellinen näytteenottoaikansa voittaa aina meidän kirjanpitomme. Tilaus ilman lab_code-koodia palauttaa 409: ilman koodia näytettä ei voida yhdistää potilaaseen laboratoriossa. Aktivointi tekee myös laboratoriotilauksen pakkauksen paneelille tilauksen lab_code-koodilla, jotta laboratorio osaa odottaa näytettä ja tulokset voidaan liittää heti, kun ne raportoidaan. Tämä tapahtuu asynkronisesti vastauksen jälkeen — laboratorion ongelma ei koskaan aiheuta pyyntösi epäonnistumista. Tästä eteenpäin Hae tulokset näyttää merkkiaineet tilassa planned, kunnes laboratorio raportoi ne. home_kit_order.results.updated-webhook ilmoittaa sinulle, kun ne muuttuvat. Jos näyte saapuu laboratorioon ennen kuin aktivoit pakkauksen, Aniva aktivoi sen. activated_at on palautuspaketin ensimmäisen seurantatapahtuman aamu tai näytteen laboratorioon saapumispäivän aamu, jos seurantaa ei ole. Myöhempi kutsu eri activated_at-arvolla palauttaa silloin 409. Vaatii home_kit_orders_manage-scopen tai rajatumman home_kit_orders_activate-scopen.

Pyyntö

Polkuparametrit

string
vaadittu
Aktivoitavan kotitestipakkaustilauksen yksilöllinen tunnus (UUID).

Runkoparametrit

string
vaadittu
Ajankohta, jolloin potilas otti näytteen, UTC-aikaleimana (ISO 8601 Z-päätteellä, esim. 2026-08-28T07:30:00Z). Ei saa olla tulevaisuudessa eikä yli 30 päivää menneisyydessä.

Vastaus

Onnistuessaan API palauttaa tilakoodin 200 OK sekä päivitetyn kotitestipakkauksen tilauksen — status on activated ja activated_at sisältää lähettämäsi aikaleiman.

Virhevastaukset