Siirry pääsisältöön
POST
Kirjaa verinäytteenotto tehdyksi ja käynnistä laboratoriotilausputki. Lähetä verinäytteenottopakkauksen laboratoriokoodit (putkien viivakoodit) fyysisten näytteiden linkittämiseksi ajanvaraukseen. Verinäytteenoton koodit annetaan jommallakummalla kahdesta tavasta:
  • Yksi koodi koko verinäytteenotolle — laskimonäytteenotto, jossa sama viivakoodi on painettu jokaiseen putkeen. Lähetä se kentässä lab_code.
  • Yksi koodi mikroputkea kohti — kapillaarinäytteenotto, jossa jokaisella mikroputkella on oma viivakoodinsa. Lähetä ne kentässä lab_codes, yksi merkintä koodia kohti sekä panel_ids-arvot, jotka kyseinen mikroputki sisältää. Jokaisesta koodista tulee oma laboratoriolähetteensä — putken viivakoodi on laboratorion tilausnumero. Merkintä ilman panel_ids-kenttää toimii yleismerkintänä kaikille paneeleille, joita ei ole nimetty muualla. Laskimonäytteenotossa niitä on enintään yksi.
Lähetä täsmälleen toinen näistä kahdesta. Jokaisen liitetyn paneelin on päädyttävä täsmälleen yhden koodin alle (oman merkintänsä tai yleismerkinnän). Laskimonäytteenotossa yksittäiset biomarkkerit tarvitsevat yleismerkinnän. Kapillaarinäytteenotossa nimeä jokainen paneeli sen mikroputken koodin kohdalla. Yksittäiset biomarkkerit täyttävät paneelimikroputkien vapaan tilan, ja uusia mikroputkia otetaan käyttöön vain tarvittaessa. Jaamme ne tasaisesti. Kuhunkin mikroputkeen mahtuu niitä enintään 150 µl. Lähetä yksi merkintä ilman panel_ids-kenttää kutakin niiden yksin tarvitsemaa mikroputkea kohti, älä enempää. Koodi, jolle ei päädy yhtään paneelia eikä biomarkkeria, hylätään vastauksella 409 ja reason: "panel_coverage". Jokainen koodi tarkistetaan ennen kuin mitään kirjoitetaan; jos jotakin koodia ei voi käyttää tai paneeli jää kattamatta, mitään ei kirjata ja vastaus kertoo ongelman. Vaatii appointments_schedule-, appointments_manage- tai appointments_operate-käyttöoikeuden.
Tätä toimintoa ei voi perua. Kun vahvistat verinäytteenoton, ajanvaraus lukitaan — siihen ei voi enää tehdä muutoksia, ei myöskään lisätä paneeleita.

Pyyntö

Polkuparametrit

string
vaadittu
Vahvistettavan ajanvarauksen yksilöllinen tunniste (UUID).

Runkoparametrit

string
Verinäytteenottopakkaukseen painettu numeerinen laboratoriokoodi, kun yksi koodi kattaa kaikki putket. Toisensa poissulkeva kentän lab_codes kanssa.
object[]
Kaikki verinäytteenoton laboratoriokoodit skannausjärjestyksessä (vähintään yksi merkintä). Toisensa poissulkeva kentän lab_code kanssa. Koodi saa esiintyä vain kerran, ja paneelin saa nimetä vain yhdessä merkinnässä.

Vastaus

Onnistuessaan API palauttaa 200 OK vahvistuksena siitä, että laboratoriotilausputki on käynnistetty.
boolean
true, kun verinäytteenotto on kirjattu ja laboratoriotilausprosessi on käynnistetty.
string
Mukana vain, kun verinäytteenotto kirjattiin muuna kuin ajanvarauspäivänä. Tavalliset avaimet eivät voi tehdä tätä — ne saavat vastauksen 409, jossa on reason: "appointment_not_today". Siirrä ajanvaraus verinäytteenottopäivälle ja vahvista se sitten.
Kirjatut koodit palautetaan kentässä lab_codes kutsussa Hae ajanvaraus, ja jokaisessa kutsun Hae tulokset tuloksessa ja asiakirjassa on se lab_code, jolla se on kirjattu.

Virhevastaukset