AvoHILMO 1(17) Sisältö Sisältö... 1 Tavoitteet... 1 Muutokset edelliseen ohjeeseen... 2 Periaatteet... 2 Rakenne... 3 Yksilötapahtuma... 3 Yhteisötapahtuma... 4 Rakenne-esimerkki... 4 Kentät... 6 Kenttien käyttö- ja täyttöehdot... 10 Tunnistetiedot... 10 Yksilötapahtuma... 11 Yhteydenotto... 11 Hoidon tarpeen arviointi... 11 Ajanvaraus... 12 Peruutus... 12 Palvelutapahtuma... 12 Suun terveydenhoidon palvelutapahtuma... 13 Suutoimenpide... 14 Perusterveydenhuollon palvelutapahtuma... 14 ICD10... 14 ICPC2... 14 Toimenpide... 15 Rokotus... 15 Lääke... 16 Jatkohoitotoimenpide... 16 Yhteisötapahtuma... 16 Dokumentin versiot Versio Päivitetty Muutokset 2.1.1 Korjattu JSON-rakenne esimerkissä ollut virhe, jossa kaynti -objekti oli nimetty palvelutapahtuma 2.1 10.10.2014 Muutokset AvoHILMO-tiedostomuotoon 2.1 Tavoitteet Tämä dokumentti kuvaa AvoHILMOn tietosisältöversion 2.1 teknisestä näkökulmasta. Tietosisältökuvaus on voimassa vuodesta 2015 ja korvaa aikaisemman version 2.0, joka on ollut voimassa vuosina 2011 2014.
AvoHILMO 2(17) Seurantatietue on rakenteinen kuvaus palvelutapahtumasta. Palvelutapahtuma muodostuu viidestä eri seurantapisteestä: yhteydenotosta, hoidon tarpeen arvioinnista, ajanvarauksesta, itse palvelutapahtumasta ja peruutuksesta. Palvelutapahtumaa kuvaava seurantatietue toimitetaan THL:lle, jos vähintään yksi seurantapisteistä on toteutunut. Poimintatiedosto muodostuu joukosta seurantatietueita. Muutokset edelliseen ohjeeseen Lisätty kenttä seurantatietue.asiakas.valintapvm Poistettu kenttä seurantatietue.hta.ensikaynti Lisätty kenttä seurantatietue.ajanvaraus.ammatti Lisätty kenttä seurantatietue.ajanvaraus.palvelumuoto Lisätty kenttä seurantatietue.ajanvaraus.yhteystapa Lisätty kenttä seurantatietue.laakitys.maaratty myös rokotustietoon Korjattu yhteisötapahtuman sääntö vastaamaan koodistomuutosta, jonka mukaan yhteisökäynnin koodi on 6. Muutos on astunut voimaan 1.1.2013 alkaen. Korjattu kiireellisyysluokituksen sääntö vastaamaan koodistomuutosta, jonka mukaan sallittuja koodeja ovat myös merkit 1 - päivystys ja 2-1 7 päivää. Muutos astuu voimaan 1.1.2015 alkaen. Periaatteet AvoHILMO tietosisältö 2.1 esitetään JSON-olioina (JavaScript Object Notation). Poimintatiedosto muodostuu JSON-taulukosta, jossa jokainen poimittu seurantatietue on oma olionsa.
AvoHILMO 3(17) Rakenne Yksilötapahtuma Kuva 1: AvoHILMO 2.1 yksilötapahtuma Huom. Kukin luokka esitetään omana seurantatietueeseen kuuluvana kenttänään. Kukin luokka muodostaa oman nimiavaruutensa, jonka sisällä voidaan uudelleenkäyttää kentän nimiä esimerkiksi ajankohta. Kenttien yksilöivä nimi muodostuu siitä polusta, josta kenttä löytyy suhteessa seurantatietueen alkuun. Esimerkiksi seurantatietue.hta.ajankohta tai seurantatietue.palvelutapahtuma.laakitys[4].atc. Huom. Lääkityksen kohdalla perintähierarkia esitetään Rokotus-kentän avulla, joka saa arvokseen 'K', jos kyseessä on rokotus ja 'E', jos kyseessä on jokin muu lääkeaine.
AvoHILMO 4(17) Yhteisötapahtuma Yhteisötapahtuman rakennetta noudatetaan jos ja vain jos palvelutapahtuman kävijäryhmäkoodi on 6 (kuusi) - yhteisötilaisuus. Muissa tapauksissa noudatetaan yksilötapahtuman rakennetta. Yhteisötapahtuman rakenne on aito osajoukko yksilötapahtumassa ja rakenteet erotetaan vain ja ainoastaan sillä, että yhteisötapahtumassa on vähemmän kenttiä. Kuva 2: AvoHILMO 2.1. Yhteisötapahtuma Rakenne-esimerkki Huom. Seuraavassa esimerkissä on käytetty välilyöntejä ja rivinvaihtoja havainnollisuuden vuoksi. Näitä merkkejä ei tarvitse eikä kannata käyttää varsinaisessa poimintatiedostossa. [ { "tunnus": "" "tuottaja": 01234 "yksikko": "", "paivitetty": "", "asiakas": { "hetu": "", "kunta": 012, "postinumero": 01234, "valintapvm": "" }, "yhteydenotto": "", "hta": { "ajankohta": "", "ammatti": 123, "kiireellisyys": "", "luonne": "", "tulos": "" },
AvoHILMO 5(17) "ajanvaraus": { "ajankohta": "", "varattu": "", "ammatti": 123, "palvelumuoto": "", "yhteystapa": "", }, "palvelutapahtuma": { "alkaa": "", "paattyy": "", "ammatti": 123, "toteuttaja": "", "palvelumuoto": "", "yhteystapa": "", "kavijaryhma": 1, "kiireellisyys": "", "luonne": "", "ensikaynti": "K", "ulkoinensyy": "", "tapaturmatyyppi": "", "icd10": ["icd10 1","icd10 2",...,"icd10 n"], // ICD10 käyntisyitä voidaan määrittää niin paljon kun niitä on kirjattu "icpc2": ["icpc2 1","icpc2 2",...,"icpc2 m"], // ICPC2 käyntisyitä voidaan määrittää niin paljon kun niitä on kirjattu "toimenpide": ["spat 1", "spat 2",...,"spat l"], // Toimenpiteitä voidaan määrittää niin paljon kun niitä on tehty "suutoimenpide": ["toimenpide 1", "toimenpide 2",... "toimenpide k"], // Toimenpiteitä voidaan määrittää niin paljon kun niitä on tehty "laakitys": [ { "rokotus": "K", "atc": "", "atcselite": "", "kauppanimi": "", "vnr": "", "eranumero": "", "jarjestysluku": "", "rokotustapa": "", "pistoskohta": "", "maaratty": "" }, { "rokotus": "E", "atc": "", "atcselite": "", "vnr": "", "kauppanimi": "", "maaratty": "" },
AvoHILMO 6(17)... // Käytettyjä lääkkeitä ja rokotteita voidaan määrittää niin paljon kuin on käytetty ], "karioituneet1": "", "puuttuvat1": "", "paikatut1": "", "karioituneet2": "", "puuttuvat2": "", "paikatut2": "", "ienkudos": "", "paino": 12345, "pituus": 1234, "tupakointi": "", "jatkohoito": ["spat 1", "spat 2",..., "spat j"] // Jatkohoitoja voidaan määrittää niin paljon kun niitä on kirjattu }, "peruutus": { "ajankohta": "", "syy": "" } } ] Kentät AvoHILMOn tietosisällön versiossa 2.1 on määritelty seuraavat kentät. Kustakin kentästä määritellään tunniste, jonka perusteella tiedetään, mistä kentästä on kyse muoto, joka kuvaa kentän sisällön säännöllisenä lausekkeena selitys, jolla selitetään tarvittaessa säännöllisen lausekkeen osat kardinaliteetti (#), joka kertoo, kuinka monta kertaa kenttä saa esiintyä seurantatietueessa Kenttä Tunniste Muoto Selitys # Asiakkaan 1 henkilötunnus hetu [0123][0-9][01][0-9][0-9][0-9] [+-A]\\d{3} [0-9ABCDEFHJKLMNPRSTUVW \d{6} - Syntymäpäivä [+-A] - Vuosisata \d{3} - Yksilötunniste. Väliaikaisilla henkilötunnisteilla 001 jos
AvoHILMO 7(17) Asiakkaan kotikunta Asiakkaan asuinpaikan postinumero Asiakkaan valinnanvapauden päivämäärä XY]? mies ja 002 jos nainen [0-9ABCDEFHJKLMNPRSTUV WXY]? - Tarkistusmerkki. Tarkistusmerkkiä ei tarvitse olla mukana, jos kyseessä on väliaikainen henkilötunnus kunta \d{1,3} kuntakoodi esitetään kokonaislukuna, jossa etunollat ovat vapaaehtoisia esim. Vantaa voi olla joko 92 tai 092 postinumero \d{1,5} postinumero esitetään kokonaislukuna, jossa etunollat ovat vapaaehtoisia esim. 00100 ja 100 ovat valintapvm [12]\d{3} [012][0-9][0123][0-9] [012][0-9][0-5][0-9] samanarvoisia yyyymmddhhmm jossa y on Palveluntuottaja tuottaja \d{5} Palveluntuottajan Topi-koodi esitetään kokonaislukuna Palveluntuottaja yksikko \d+(.\d+)* Palveluyksikön koodi palveluyksikkö esitetään OID-koodina. OIDkoodi koostuu pisteillä erotetuista numeroista Seurantatietueen tunnus Seurantatietueen päivitysaika Yhteydenottopäivä ja kellonaika Hoidon tarpeen arvioimispäivä ja kellonaika Hoidon tarpeen arviointi - ammatti Hoidon tarpeen arviointi - kiireellisyys tunnus.\* Seurantatietueen tunnus on palveluntuottajan määrittelemä. Sille ei aseteta muodollisia rajoitteita. Tunnuksen tulee olla yksilöivä palveluntuottajan tasolla. paivitetty ks. valintapvm yyyymmddhhmm jossa y on ajankohta ks. valintapvm yyyymmddhhmm jossa y on ajankohta ks. valintapvm yyyymmddhhmm jossa y on ammatti \d+ ammatti esitetään kokonaislukuna kiireellisyys E, jos ei kiireellinen hoidon [EKV12] tarve K, jos kiireellinen hoidon tarve V, jos välitön hoidon tarve 1, jos kyseessä päivystys 2, jos hoidon tarve 1 7 päivän 1 1 1 1 1
AvoHILMO 8(17) Hoidon tarpeen arviointi - käynnin luonne Hoidon tarpeen arvioinnin tulos Ajanvarauksen tekopäivä ja kellonaika Käynnille varattu ajankohta kuluessa luonne (TH) (SH) TH, jos terveydenhoito *, SH jos sairaanhoito tulos Y\d{2} Y alkuinen kaksinumeroinen koodi ajankohta ks. valintapvm yyyymmddhhmm jossa y on varattu ks. valintapvm yyyymmddhhmm jossa y on Varatun ajan ammatti \d+ ammatti esitetään ammattikoodi ja merkkijonona, joka koostuu luokitus numeroista Varatun ajan palvelumuoto T\d{2} T-alkuinen kaksinumeroinen palvelumuoto koodi Varatun ajan yhteystapa R\d{2} R-alkuinen kaksinumeroinen yhteystapa koodi Käyntipäivä ja ajankohta ks. valintapvm yyyymmddhhmm jossa y on kellonaika, aloitusaika Käyntipäivä ja ajankohta ks. valintapvm yyyymmddhhmm jossa y on kellonaika, lopetusaika Ammattikoodi ja ammatti \d+ ammatti esitetään luokitus kokonaislukuna Palvelun toteuttaja toteuttaja \d{11} Valviran rekisteröintinumero Palvelumuoto palvelumuoto T\d{2} T-alkuinen kaksinumeroinen koodi Yhteystapa yhteystapa R\d{2} R-alkuinen kaksinumeroinen koodi Kävijäryhmä kavijaryhma [12356] kävijäryhmäkoodi Hoidon kiireellisyys kiireellisyys [EKV12] E, jos ei kiireellinen hoidon tarve K, jos kiireellinen hoidon tarve V, jos välitön hoidon tarve 1, jos kyseessä päivystys 2, jos hoidon tarve 1 7 päivän kuluessa Käynnin luonne luonne (TH) (SH) TH, jos terveydenhoito SH jos sairaanhoito Ensikäynti ensikaynti [KE] K, jos ensikäynti E, jos ei ensikäynti Käyntisyy ICD10 icd10 (([A-Z]\d{2}) ICD10-koodi (Z[AB]\d))(\.\d+)? ([*&#+]([A-Z]\d{2} (\.\d+)?[*&#+]?)?)? 0..n
AvoHILMO 9(17) Lääkeaineen kauppanimi kauppanimi.+ Vapaa merkkijono Tämä kenttä on määritelty siltä varalta, että pakkausnumero ei ole saatavilla. Jos pakkausnumero on saatavilla, se riittää kuvaamaan lääkkeen tai rokotteen kauppanimen. 0..n maaratty ks. valintapvm yyyymmddhhmm 0..n Ulkoinen syy ulkoinensyy ks. Käyntisyy ICD10 ICD10-koodi ICD10 Tapaturmatyyppi tapaturmatyy ks. Käyntisyy ICD10 ICD10-koodi ICD10 ppi Käyntisyy ICPC2 icpc2 [-A-Z]\d{2} ICPC2-koodi 0..n Avohoidon toimenpide SPAT\d{4} SPAT koodi 0..n toimenpide, SPAT Suun th suutoimenpi [E-Y][A-Z] suun terveydenhuollon 0..n toimenpide de [A-Z0-9 A-Z0-9]{3} toimenpideluokitus Rokotus rokotus [KE] K, jos kyseessa rokotus. E, 0..n jos kyseessä muu lääkitys Lääkeaine atc [A-Z]\d{2}( Rokotteen tai lääkeaineen 0..n [A-Z]([A- Z](\d{2})?)?)? ATC-koodi Lääkeaineen selite atcselite.+ Vapaa merkkijono 0..n Tämä kenttä on tarkoitettu siltä varalta, että lääkeaineen ATC-koodi ei ole saatavilla tai ATC-koodi ei ole pysyvä. Jos ATC-koodi on saatavilla, se riittää. Lääkeaineen pakkausnumero vnr \d+ VNR-numero 0..n Määräämispäivämäärä Rokotteen eranumero.+ Vapaa merkkijono 0..n eränumero Annoksen jarjestys.+ Vapaa merkkijono 0..n järjestysluku Rokotustapa rokotustapa (ID) (IM) Rokotustapakoodi 0..n (MUU) (PO) (SC) Pistoskohta pistoskohta ([OV][OPR]) (MUU) Pistoskohtakoodi 0..n Suun th indeksi D karioituneet1 \d{1,2} Hampaiden lukumäärä Suun th indeksi M puuttuvat1 \d{1,2} Hampaiden lukumäärä Suun th indeksi F paikatut1 \d{1,2} Hampaiden lukumäärä Suun th indeksi d karioituneet2 \d{1,2} Hampaiden lukumäärä Suun th indeksi m puuttuvat2 \d{1,2} Hampaiden lukumäärä Suun th indeksi f paikatut2 \d{1,2} Hampaiden lukumäärä Suun ienkudoksen tila ienkudos [x0-4]{6} Suun ienkudoksen tila esitetään merkkijonona, jossa
AvoHILMO 10(17) kunkin alueen tila kuvataan kokonaisluku 0-4. Jos mittaa ei voida ottaa, alue merkitään merkillä x Paino paino \d+ paino grammoina esitetään kokonaislukuna Pituus pituus \d+ pituus millimetreinä esitetään kokonaislukuna Tupakointi tupakointi \d tupakointistatus koodisto Jatkohoito jatkohoito ks. Avohoidon toimenpide, SPAT SPAT koodi 0..n Peruuntumisen ajankohta Palvelutapahtuma n peruuntumisen syy ajankohta ks. Seurantatietueen päivitysaika yyyymmddhhmm jossa y on syy Y\d{2} Y-alkuinen kaksinumeroinen tunnus Kenttien käyttö- ja täyttöehdot Kenttien käytössä ja täytössä ovat voimassa seuraavat ehdot Tunnistetiedot Jokaisella tietueella on oltava määritelty Palveluntuottaja Seurantatietueen tunnus Seurantatietueen päivitysaika Jokaisella tietueella voi olla määritelty Palveluntuottaja palveluyksikkö Päätöshaara 1 Päätöshaarassa 1 määritellään, onko kyseessä yksilö- vai yhteisötapahtuma. Kyseessä on Yhteisötapahtuma jos ja vain jos Palvelutapahtuma on toteutunut ts. Käyntipäivä ja kellonaika, aloitusaika on määritelty
AvoHILMO 11(17) JA Kävijäryhmä kentän arvo on 6 (Huom. yhteisökäynnin koodi on ollut vuoteen 2013 asti 4) Kyseessä on Yksilötapahtuma jos Palvelutapahtuma ei ole toteutunut ts. Käyntipäivä ja kellonaika, aloitusaika on määrittelemättä TAI Kävijäryhmä kentän arvo on erisuuri kuin 6 (Huom. yhteisökäynnin koodi on ollut vuoteen 2013 asti 4) Yksilötapahtuma Jokaisella yksilötapahtumalla on oltava määritelty Asiakkaan henkilötunnus Asiakkaan kotikunta Asiakkaan asuinpaikan postinumero Lisäksi, jokaiseen yksilötapahtuman on kuvatta vähintään yksi seurantapiste (Yhteydenotto, Hoidon tarpeen arviointi, Ajanvaraus, Palveluntapahtuma, Peruutus) Päätöshaara 2 Jos palvelutapahtumaan kuuluu Yhteydenotto, lisätään siihen kuuluvat kentät seurantatietueeseen. Muutoin jätetään kentät kirjaamatta Yhteydenotto Jokaisella yhteydenotolla on oltava määritelty Yhteydenottopäivä ja kellonaika Päätöshaara 3 Jos palvelutapahtumaan kuuluu Hoidon tarpeen arviointi, lisätään siihen kuuluvat kentät seurantatietueeseen. Muutoin jätetään kentät kirjaamatta Hoidon tarpeen arviointi Jokaisella hoidon tarpeen arvioinnilla on oltava määritelty Hoidon tarpeen arvioimispäivä ja kellonaika Hoidon tarpeen arviointi - ammatti
AvoHILMO 12(17) Hoidon tarpeen arviointi - kiireellisyys Hoidon tarpeen arviointi - käynnin luonne Hoidon tarpeen arvioinnin tulos Päätöshaara 4 Jos palvelutapahtumaan kuuluu Ajanvaraus, lisätään siihen kuuluvat kentät seurantatietueeseen. Muutoin jätetään kentät kirjaamatta Ajanvaraus Jokaisella ajanvarauksella on oltava määritelty Ajanvarauksen tekopäivä ja kellonaika Käynnille varattu ajankohta Käynnin toteuttavan ammattihenkilön ammattiluokitus Käynnin palvelumuoto Käynnin yhteystapa Päätöshaara 5 Jos palvelutapahtumaan kuuluu Palvelutapahtuma, lisätään siihen kuuluvat kentät seurantatietueeseen. Muutoin jätetään kentät kirjaamatta Päätöshaara 6 Jos palvelutapahtumaan kuuluu Peruutus, lisätään siihen kuuluvat kentät seurantatietueeseen. Muutoin jätetään kentät kirjaamatta Peruutus Jokaisella peruutuksella on oltava määritelty Peruuntumisen ajankohta Palvelutapahtuman peruuntumisen syy Palvelutapahtuma Jokaisella palvelutapahtumalla on oltava määritelty
AvoHILMO 13(17) Käyntipäivä ja kellonaika, aloitusaika Ammattikoodi ja luokitus Palvelun toteuttaja Palvelumuoto Yhteystapa Kävijäryhmä ja sen arvon tulee olla 1, 2, 3 tai 5 Hoidon kiireellisyys Käynnin luonne Ensikäynti Lisäksi palvelutapahtumalle voidaan määritellä Käyntipäivä ja kellonaika, lopetusaika Tupakointi Päätöshaara 7 Jos seurantatietue koskee Suun terveydenhoitoa, niin noudatetaan siihen määriteltyjä sääntöjä, muuten noudatetaan avoterveydenhoidon sääntöjä. Suun terveydenhoidon palvelutapahtuma Jokaisella suun terveydenhoidon palvelutapahtumalla on oltava määritelty Suun th indeksi D Suun th indeksi M Suun th indeksi F Suun th indeksi d Suun th indeksi m Suun th indeksi f Suun ienkudoksen tila
AvoHILMO 14(17) Päätöshaara 8 Jos palvelutapahtumaan on kirjattu yksi tai useampi suun terveydenhoidon toimenpide niin ne kirjataan seurantatietueeseen. Muutoin hypätään näiden ohitse Suutoimenpide Jokaisella suutoimenpiteellä on oltava kirjattu Suun th toimenpide Perusterveydenhuollon palvelutapahtuma Jokaisella perusterveydenhuollon palvelutapahtumalla voi olla määritelty Ulkoinen syy ICD-10 Tapaturmatyyppi ICD-10 Paino Pituus Päätöshaara 9 Jos palvelutapahtumalle on määritelty käyntisyitä, ne kirjataan. Muuten niiden yli voi hypätä Päätöshaara 10 Jokaisella käyntisyylle on päätettävä, onko kyseessä ICD-10- vai ICPC2-luokiteltu käyntisyy. Huom. Seurantatietueessa voi olla molempia ICD10 Jokaiselle ICD10-käyntisyylle on oltava määritelty Käyntisyy ICD10 ICPC2 Jokaiselle ICPC2-käyntisyylle on oltava määritelty Käyntisyy ICPC2 Päätöshaara 11
AvoHILMO 15(17) Jos palvelutapahtumalle on määritelty toimenpiteitä, ne kirjataan. Muuten niiden yli voi hypätä Toimenpide Jokaiselle toimenpiteelle on oltava määritelty Avohoidon toimenpide, SPAT Päätöshaara 12 Jos palvelutapahtumalle on määritelty lääkkeitä tai rokotteita, ne kirjataan. Muuten niiden yli voi hypätä Päätöshaara 13 Jokaisen lääkityksen suhteen on päättävä onko kyseessä rokote vai lääke Rokotus Jokaisella rokotteella on oltava määritelty Rokotus ja sen arvon tulee olla 'K' Rokotteen määräämispäivämäärä Jokaisella rokotteella on oltava määritelty vähintään yksi seuraavista Lääkeaine Lääkeaineen selite Lääkeaineen kauppanimi Lääkeaineen pakkausnumero Lisäksi rokotteella voi olla määritelty Rokotteen eränumero Annoksen järjestysluku Rokotustapa Pistoskohta
AvoHILMO 16(17) Lääke Jokaisella lääkkeellä on oltava määritelty Rokotus ja sen arvon tulee olla 'E' Lääkeaine Lääkeaineen pakkausnumero Määräämispäivämäärä Lisäksi lääkkeellä voi olla määritelty Lääkeaineen selite Lääkeaineen kauppanimi Päätöshaara 14 Jos palvelutapahtumalle on määritelty jatkohoitotoimenpiteitä ne kirjataan. Muuten niiden yli voi hypätä Jatkohoitotoimenpide Jokaisella jatkohoitotoimenpiteellä on määriteltävä Jatkohoito Yhteisötapahtuma Jokaisella yhteisötapahtumalla on määriteltävä Käyntipäivä ja kellonaika, aloitusaika Ammattikoodi ja luokitus Palvelun toteuttaja Palvelumuoto Yhteystapa Kävijäryhmä ja sen arvon on oltava 6 Lisäksi yhteisötapahtumalla voi olla määritelty
AvoHILMO 17(17) Käyntipäivä ja kellonaika, lopetusaika