Aleksi Yrttiaho 3.0.206 Määrittely (9) Tiedostomuoto Tavoitteet Tämä dokumetti kuvaa Avohilmo tietosisällö versio 3.0: tekisestä äkökulmasta. Tietosisältökuvaus o voimassa vuodesta 207 ja korvaa aikaisemmat versiot. Avohilmo tietosisältö koostuu kokoelmasta seuratatietueita. Seuratatietue o raketeie kuvaus yhdestä ja vai yhdestä palvelutapahtumasta. Palvelutapahtuma muodostuu viidestä eri seuratapisteestä: yhteydeotosta, hoido tarpee arvioiista, ajavarauksesta, itse palvelutapahtumasta ja peruutuksesta. Palvelutapahtumaa kuvaava seuratatietue toimitetaa THL:lle, jos vähitää yksi seuratapisteistä o toteutuut. Tietodostomuoto tuistetaa tyypillä http://thl.fi/avohilmo/3.0 Periaatteet Avohilmo tietosisällö versio 3.0 esitetää JSON-olioia (JavaScript Object Notatio). Poimitatiedosto muodostuu JSON-taulukosta, jossa jokaie poimittu seuratatietue o oma oliosa. Rakee Yhteisötapahtuma rakeetta oudatetaa jos ja vai jos palvelutapahtuma kävijäryhmä o 6. Muissa tapauksissa oudatetaa yksilötapahtuma rakeetta. Yhteisötapahtuma rakee o aito osajoukko yksilötapahtumassa ja raketeet erotetaa vai ja aioastaa sillä, että yhteisötapahtumassa o vähemmä kettiä. Yksilötapahtuma Huom. Kuki luokka esitetää omaa seuratatietueesee kuuluvaa kettäää. Kuki luokka muodostaa oma imiavaruutesa, joka sisällä voidaa uudelleekäyttää ketä imiä esimerkiksi ajakohta. Kettie yksilöivä imi muodostuu siitä polusta, josta kettä löytyy suhteessa seuratatietuee alkuu. Esimerkiksi seuratatietue.hta.ajakohta tai seuratatietue.palvelutapahtuma.laakitys[4].atc. Yhteisötapahtuma Yhteisötapahtumassa ei tarvitse kirjata asiakasta yksilöiviä tietoja. JSON-esimerkkirakee Huom. Seuraavassa esityksessä o käytetty välilyötejä ja rivivaihtoja havaiollisuude vuoksi. Näitä merkkejä ei kaata käyttää varsiaisessa poimitatiedossa.
Aleksi Yrttiaho 3.0.206 Määrittely 2(9) [ { "tuus": "" "tuottaja": 0234 "yksikko": "", "paivitetty": "", "asiakas": { "hetu": "", "kuta": "02", "postiumero": "0234", "valitapvm": "" "yhteydeotto": "", "hta": { "ajakohta": "", "ammattiluokka": "23", "kiireellisyys": "", "luoe": "", "esikayti": "K", "tulos": "" "ajavaraus": { "ajakohta": "", "varattu": "", "ammattiluokka": "", "palvelumuoto": "", "yhteystapa": "" "kayti": { "alkaa": "", "paattyy": "", "ammattiluokka": "23", "toteuttaja": "", "palvelumuoto": "", "yhteystapa": "", "kavijaryhma":, "kiireellisyys": "", "luoe": "", "esikayti": "K", "ulkoiesyy": "", "tapaturmatyyppi": "", "icd0": ["icd0 ","icd0 2",...,"icd0 "], // ICD0 käytisyitä voidaa määrittää ii paljo ku iitä o kirjattu "icpc2": ["icpc2 ","icpc2 2",...,"icpc2 m"], // ICPC2 käytisyitä voidaa määrittää ii paljo ku iitä o kirjattu "toimepide": ["spat ", "spat 2",...,"spat l"], // Toimepiteitä voidaa määrittää ii paljo ku iitä o tehty "suutoimepide": ["toimepide ", "toimepide 2",... "toimepide k"], // Toimepiteitä voidaa määrittää ii paljo ku iitä o tehty
Aleksi Yrttiaho 3.0.206 Määrittely 3(9) "laakitys": [ { "rokotus": "K", "rokote": "", "rokotussuoja": [, 2], "atc": "", "atcselite": "", "kauppaimi": "", "vr": "", "eraumero": "", "jarjestysluku": "", "rokotustapa": "", "pistoskohta": "" { "rokotus": "E", "atc": "", "atcselite": "", "vr": "", "kauppaimi": "", "maaratty": ""... // Käytettyjä lääkkeitä ja rokotteita voidaa määrittää ii paljo kui o käytetty ], "karioitueet": "", "puuttuvat": "", "paikatut": "", "karioitueet2": "", "puuttuvat2": "", "paikatut2": "", "iekudos": "", "DMFS": 2345, "dmfs": 2345, "paio": 2345, "paioyksikko": "G", "pituus": 2345, "epds": 2345, "tupakoiti": "", "pariteetti": "GP", "laskettuaika": "", "raskausviikot": "00+0", "jatkohoito": ["spat ", "spat 2",..., "spat j"] // Jatkohoitoja voidaa määrittää ii paljo ku iitä o kirjattu
Määrittely 4(9) Aleksi Yrttiaho 3.0.206 } ] "kotihoito": { "palvelusuuitelma": "K", "ajakohta": "", "voimassa": "", "ateriapalvelu": "", "hygieiapalvelu": "", "kuljetuspalvelu": "", "siivouspalvelu": "", "saattajapalvelu": "", "turvapalvelu": "", "kauppapalvelu": "", "omaishoidotuki": "" "peruutus": { "ajakohta": "", "syy": "" } Ketät AvoHILMO tietosisällö versiossa 2.0 o määritelty seuraavat ketät. Kustaki ketästä määritellää tuiste, joka perusteella tiedetää, mistä ketästä o kyse muoto, joka kuvaa ketä sisällö sääölliseä lausekkeea selitys, jolla selitetää tarvittaessa sääöllise lausekkee osat kardialiteetti (#), joka kertoo, kuika mota kertaa kettä saa esiityä seuratatietueessa Kettä Tuiste Muoto Selitys # Huomiot Asiakkaa hekilötuus Asiakkaa kotikuta 9] [+-A]\\d{3} hetu [023][0-9][0][0-9][0-9][0- [0-9ABCDEFHJKLMNPRSTU VWXY]? \d{6} - Sytymäpäivä [+-A] - Vuosisata \d{3} - Yksilötuiste. Väliaikaisilla hekilötuisteilla 00 jos mies ja 002 jos aie [0-9ABCDEFHJKLMNPRSTUV WXY]? - Tarkistusmerkki. Tarkistusmerkkiä ei tarvitse olla mukaa, jos kyseessä o väliaikaie hekilötuus kuta \d{,3} kuta esitetää kokoaislukua, jossa
Aleksi Yrttiaho 3.0.206 Määrittely 5(9) Asiakkaa asuipaika postiumero Valiavapaude päivämäärä etuollat ovat vapaaehtoisia esim. Vataa voi olla joko 92 tai 092 postiumero \d{,5} postiumero esitetää valitapvm ks. #Seuratatietuee kokoaislukua, jossa etuollat ovat vapaaehtoisia esim. 0000 ja 00 ovat samaarvoisia Kertoo päivämäärä, jolloi asiakkaa valiavapaus astuu voimaa. Valiavapaude päivämäärällä tarkoitetaa ajakohtaa, jolloi asiakkaa käyttämä oikeus valitsemasa palvelutuottaja palveluihi astuu voimaa Palvelutuottaja tuottaja \d{5} Palvelutuottaja Topi- Palvelutuottaja palveluyksikkö Seuratatietuee tuus Seuratatietuee Yhteydeottopäivä ja kelloaika Hoido tarpee arvioimispäivä ja kelloaika Hoido tarpee arvioiti - ammatti Hoido tarpee arvioiti - ammattiluokka Hoido tarpee arvioiti - kiireellisyys esitetää kokoaislukua yksikko \d+(.\d+)* Palveluyksikö esitetää OID-a. OID koostuu pisteillä erotetuista umeroista tuus.\* Seuratatietuee tuus o paivitetty ajakohta ajakohta [2]\d{3} [02][0-9][023][0-9] [02][0-9][0-5][0-9] ks. #Seuratatietuee ks. #Seuratatietuee palvelutuottaja määrittelemä. Sille ei aseteta muodollisia rajoitteita. Tuukse tulee olla yksilöivä palvelutuottaja tasolla. yyyymmddhhmm jossa y o h tuti ja m miuutti yyyymmddhhmm jossa y o h tuti ja m miuutti yyyymmddhhmm jossa y o h tuti ja m miuutti ammatti \d+ ammatti esitetää kokoaislukua ammattiluokka \d{3} Hoido tarpee arvioija ammatti tuistetaa Valvira Ammattioikeudet -luokituksella. Huom. Koodisto sisältää kolme merkkiä - kaikki merkit ovat merkitseviä. kiireellisyys [E2] E, jos ei kiireellie hoido tarve, jos potilaa hoido tulee alkaa vuorokaude kuluessa 2, jos potilaa hoido tulee alkaa -7 vuorokaude versiosta 2. Poistuut Koodistomuut os versiossa 2.
Aleksi Yrttiaho 3.0.206 Määrittely 6(9) Hoido tarpee arvioiti - käyi luoe Hoido tarpee arvioiti - esikäyti Hoido tarpee arvioii tulos Ajavaraukse tekopäivä ja kelloaika Käyille varattu ajakohta Käyille varattu ammatti ja luokitus Käyille varattu ammattiluokka Käyille varattu palvelumuoto kuluessa luoe (TH) (SH) TH, jos terveydehoito SH jos sairaahoito esikayti [KE] K, jos esikäyti E, jos ei esikäyti tulos Y\d{2} Y alkuie kaksiumeroie ajakohta varattu ks. #Seuratatietuee ks. #Seuratatietuee yyyymmddhhmm jossa y o h tuti ja m miuutti yyyymmddhhmm jossa y o h tuti ja m miuutti ammatti \d+ Ammatti esitetää kokoaislukua ammattiluokka \d{3} Hoido tarpee arvioija ammatti tuistetaa Valvira Ammattioikeudet -luokituksella. Huom. Koodisto sisältää kolme merkkiä - kaikki merkit ovat merkitseviä. palvelumuoto T\d{2} T-alkuie kaksiumeroie Poistuut versiosta 2. Käyille varattu yhteystapa R\d{2} R-alkuie kaksiumeroie yhteystapa Käytipäivä ja alkaa ks. #Seuratatietuee yyyymmddhhmm jossa y o kelloaika, aloitusaika h tuti ja m miuutti Käytipäivä ja paattyy ks. #Seuratatietuee yyyymmddhhmm jossa y o kelloaika, lopetusaika h tuti ja m miuutti Ammatti ja ammatti \d+ ammatti esitetää luokitus kokoaislukua Ammattioikeus ammattiluokka \d{3} Palvelutoteuttaja ammatti tuistetaa Valvira Ammattioikeudet -luokituksella Huom. Koodisto sisältää kolme merkkiä - kaikki merkit ovat merkitseviä. Palvelu toteuttaja toteuttaja \d{} Valvira rekisteröitiumero Palvelumuoto palvelumuoto T\d{2} T-alkuie kaksiumeroie Yhteystapa yhteystapa R\d{2} R-alkuie kaksiumeroie Kävijäryhmä kavijaryhma [2356] kävijäryhmä versiosta 2. Poistuut Koodistomuut os versiossa 2.
Aleksi Yrttiaho 3.0.206 Määrittely 7(9) Hoido kiireellisyys kiireellisyys [EKV] E, jos ei kiireellie hoido tarve, jos potilaa hoido tulee alkaa vuorokaude kuluessa 2, jos potilaa hoido tulee alkaa -7 vuorokaude kuluessa Käyi luoe luoe (TH) (SH) TH, jos terveydehoito SH jos sairaahoito Esikäyti esikayti [KE] K, jos esikäyti E, jos ei esikäyti Käytisyy ICD0 icd0 (([A-Z]\d{2}) ICD0- (Z[AB]\d))(\.\d+)? ([*&#+]([A-Z]\d{2} (\.\d+)?[*&#+]?)?)? Ulkoie syy ICD0 ulkoiesyy ks. #Käytisyy ICD0 ICD0- Tapaturmatyyppi ICD0 tapaturmatyyppi ks. #Käytisyy ICD0 ICD0- Käytisyy ICPC2 icpc2 [-A-Z]\d{2} ICPC2- Avohoido toimepide, SPAT toimepide SPAT\d{4} SPAT Suu th toimepide suutoimepide [E-Y][A-Z] [A-Z0-9 A-Z0-9]{3} suu terveydehuollo toimepideluokitus Rokotus rokotus [KE] K, jos kyseessa rokotus. E, Lääkeaie atc [A-Z]\d{2}( [A-Z]([A-Z](\d{2})?)?)? jos kyseessä muu lääkitys Rokottee tai lääkeaiee ATC- Lääkeaiee selite atcselite.+ Vapaa merkkijoo Tämä kettä o tarkoitettu Lääkeaiee pakkausumero Lääkeaiee kauppaimi Määräämispäivämä ärä siltä varalta, että lääkeaiee ATC- ei ole saatavilla tai ATC- ei ole pysyvä. Jos ATC o saatavilla, se riittää. vr \d+ VNR-umero kauppaimi.+ Vapaa merkkijoo Tämä kettä o määritelty maaratty ks. #Seuratatietuee siltä varalta, että pakkausumero ei ole saatavilla. Jos pakkausumero o saatavilla, se riittää kuvaamaa lääkkee tai rokottee kauppaime. yyyymmddhhmm Määrämispäivämäärä liittyy Koodistomuut os versiossa 2.
Aleksi Yrttiaho 3.0.206 Määrittely 8(9) vai ja aioastaa lääkityksee. Rokotteide osalta määrämispäivämäärää ei tarvita Rokottee eraumero.+ Vapaa merkkijoo eräumero Aokse jarjestys.+ Vapaa merkkijoo järjestysluku Rokotustapa rokotustapa (ID) (IM) Rokotustapa (MUU) (PO) (SC) Pistoskohta pistoskohta ([OV][OPR]) (MUU) Pistoskohta Rokote rokote + Rokottee geeerie imi kuvattua luokitukse.2.246.537.6.60.2050 lyheteeä Rokotussuoja rokotussuoja \d+ Taulukko koodeilla (.2.246.537.6.609.2050 ) ilmaistuja tietoja taudeista tai ifektioista, jota rokotuksella pyritää ealtaehkäisemää Suu th ideksi D karioitueet \d{,2} Hampaide lukumäärä Suu th ideksi M puuttuvat \d{,2} Hampaide lukumäärä Suu th ideksi F paikatut \d{,2} Hampaide lukumäärä Suu th ideksi d karioitueet2 \d{,2} Hampaide lukumäärä Suu th ideksi m puuttuvat2 \d{,2} Hampaide lukumäärä Suu th ideksi f paikatut2 \d{,2} Hampaide lukumäärä DMFS DMFS \d+ Hampaistossa esiityvie reikiityeide, poistettuje ja paikattuje hammaspitoje yhteelaskettu lukumäärä dmfs dmfs \d+ Hampaistossa esiityvie reikiityeide, poistettuje ja paikattuje hammaspitoje yhteelaskettu lukumäärä, maitohampaat Suu iekudokse iekudos \d{6} Suu iekudokse tila tila esitetää kokoaislukua Paio paio \d+ paio kilogrammoia tai grammoia esitetää kokoaislukua Paioyksikkö paioyksikko ((KG) (G)) Paioyksikko, jota käytetty paioketässä, joko G tai KG Yksikkö muuttuut sallimaa kilogrammat
Aleksi Yrttiaho 3.0.206 Määrittely 9(9) Pituus pituus \d+ pituus settimetreiä Maseusseula (EPDS) esitetää kokoaislukua epds \d+ Mielialalomake syytykse jälkeise maseukse tuistamiseksi (EPDS), kokoaispistemäärä Tupakoiti tupakoiti \d tupakoitistatus sto Pariteetti pariteetti G\d+P\d+ Luokitus kuvaa raskaaa oleva Raskaude laskettu aika laskettuaika ks #Seuratatietuee aise raskauksie lukumäärää (G=Graviditeetti) ja syytyste lukumäärää (P = Partus) yyyymmddhhmm jossa y o vuosi, M kuukausi, d päivä, h tuti ja m miuutti Raskausviikot raskausviikot \d{2}\+\d Raskausviikkoje määrä ilmaistua Jatkohoito jatkohoito ks. #Avohoido Peruutumise ajakohta Palvelutapahtuma peruutumise syy Kotihoido palvelusuuitelma Kotihoido palvelut Kotihoido palvelusuuitelma tarkastamise ajakohta Kotihoido palvelusuuitelma voimassaoloaika ajakohta toimepide, SPAT ks. #Seuratatietuee viikkoia ja päiviä ww+d esim 39+4 SPAT yyyymmddhhmm jossa y o h tuti ja m miuutti syy Y\d{2} Y-alkuie kaksiumeroie palvelusuuitel ma ateriapalvelu hygieiapalvelu kuljetuspalvelu siivouspalvelu saattajapalvelu turvapalvelu kauppapalvelu omaishoidotuki ajakohta voimassa tuus [KE] K jos palvelusuuitelma [KE] ks. #Seuratatietuee ks. #Seuratatietuee tehty E jos palvelusuuitelmaa ei ole tehty Palvelut, joita hekilö saa käyttää ilmaistaa kuki omaa kettäää yyyymmddhhmm jossa y o vuosi, M kuukausi, d päivä, h tuti ja m miuutti yyyymmddhhmm jossa y o vuosi, M kuukausi, d päivä, h tuti ja m miuutti Yksikkö muuttuut millimetreistä settimetreiks i