VÄESTÖREKISTERIKESKUS Väestötietojärjestelmä Julkishallinnon poimintapalvelut Kiinteistön omistajien tiedot kunnille Kuvaus 11.5.2015 1. Dokumentin hallinta Versionumero Version päiväys Tarkistettu Muutokset edelliseen versioon / Huomautukset 0.1A 17.3.2015 ei tarkistettu Kuvauksen ensimmäinen asiakasversio. 1.0A 11.5.2015 ei tarkistettu Tuotantoon siirretyn poiminnan kuvaus. Korjaus muutostietojen poimintaehtoon: kiinteistöyksikön muodostuksen muutospäivää ei tutkita. Päivämäärä tietotyyppien korjauksia osatiedostoon K2, sarakkeet 15 ja 24: muutettu muotoon = vvvvkkpp. Osatiedostossa K2 sarakkeessa 23 annetaan valtion nimi aina. Muutettu sarakkeen tietotyypiksi varchar2. 2. Tulostiedostojen tietuekuvaukset ja osatiedostokohtaiset poimintasäännöt 2.1 Yleistä Tietotuotteella luovutetaan kunnille ja muille viranomaisasiakkaille kiinteistön omistajien tietoja. Toimitettava aineisto koostuu kahdesta osatiedostosta: 1. kiinteistöyksikön tiedot KOM1 2. kiinteistöyksikön haltijoiden tiedot KOM2 Kiinteistöyksikön saantoon liittyviä ns. asiakirjatietoja ei enää rekisteröidä väestötietojärjestelmään. Väestörekisterikeskukselle osoitetun kirjallisen hakemuksen / tilauksen perusteella asiakkaalle voidaan toimittaa joko A. perustiedot kiinteistön omistajista (täydelliset poikkileikkaustilanteen mukaiset tiedot) tai B. muutostiedot (tiedot referenssiajankohdan eli yleensä asiakkaalle viimeksi tehdyn toimituksen poiminnan ajankohdan jälkeen tapahtuneista muutoksista). 2.2 Poiminnan käsittelysäännöt Poimittavat kiinteistöyksiköt määritellään kuntarajauksella (yksi tai useampia kuntia; ilman kuntarajausta tuloksena on koko maan kiinteistöjen omistajatiedot). 1
Osatiedostoon 1 valitaan kiinteistöyksiköiden tiedot seuraavien sääntöjen mukaan: A. Perustiedot Poimintaehdot - kiinteistöyksikkö (tyyppi 1=kiinteistö tai tyyppi 2 = määräala) sijaitsee kunnassa x; ja - kiinteistöyksikkö on voimassa (voimassaolo 1) B. Muutostiedot Poimintaehdot - kiinteistöyksikkö (tyyppi 1=kiinteistö tai tyyppi 2 = määräala) sijaitsee kunnassa x; ja - kiinteistöyksikkö on voimassa (voimassaolo 1) tai kiinteistöyksikkö on lakkautettu (voimassaolo 2) Voimassa olevien kiinteistöyksiköiden (voimassaolo 1) osalta kiinteistöyksikkö valitaan poimintaan, jos jokin seuraavista tiedoista on sama tai uudempi kuin muutosten rajapäivä: - kiinteistöyksikön rekisteröimispäivä - kiinteistöyksikön muutospäivä - kiinteistöyksikön hallinnan muutospäivä - henkilötunnuksellisen haltijan vakinaisen asumisen muutospäivä - henkilötunnuksellisen haltijan vakinaisen muutospäivä - henkilötunnuksellisen haltijan turvakiellon muutospäivä Lakanneiden kiinteistöyksiköiden (voimassaolo 2) osalta kiinteistöyksikkö valitaan poimintaan, jos sen muutospäivä on sama tai uudempi kuin muutosten rajapäivä. Osatiedostoon 2 valitaan kiinteistöyksiköiden haltijoiden tiedot seuraavien sääntöjen mukaan: Perustiedot ja muutostiedot - luovutetaan haltijatiedot vain niistä kiinteistöyksiköistä (tyyppi 1 tai 2), jotka ovat voimassa (voimassaolo 1) - luovutetaan tiedot vain niistä haltijoista, joiden omistukset (hallinnan laji 1) tai vuokraukset (hallinnan laji 2) ovat poimintahetkellä voimassa (ei päättymispäivää) Turvakieltojen käsittely Jos kiinteistön haltijalla (omistaja tai vuokraaja) on turvakielto, ei häntä eikä mitään hänen tietojaan poimita osatiedostoon 2. Täten: jos turvakiellon omaava henkilö on kiinteistön ainoa omistaja, jää kiinteistö vaille omistajatietoja. Jos kiinteistöllä on useampia omistajia, turvakiellon omaavan henkilön / henkilöiden tietoja ei poimita tulostiedostoon, mutta muiden omistajien (niiden, joilla ei ole turvakieltoa) tiedot poimitaan tulostiedostoon. Em. sääntöä sovelletaan sekä perustietojen, että muuttuneiden tietojen poimintaam. Turvakiellon päättymistä ei tutkita (eikä voida tutkia) millään tavalla muuttuneiden tietojen poiminnassa, mistä voi aiheutua se, että omistajasta, jonka turvakielto on päättynyt, ei toimiteta muuttuneiden tietojen poiminnan yhteydessä mitään tietoja (sillä edellytyksellä, että mikään tutkittavista tiedoista ei ole muuttunut). 2
2.3 Tulostiedostojen kuvaukset Kaikki tulostiedostot ovat vaihtuvamittaisia tekstitiedostoja. Tietokenttien erotinmerkki on puolipiste (;). Väestötietojärjestelmässä ja näissä tulostiedostoissa käytettävä merkistö on ISO 8859-1. Tietotyypit: tulostiedostokuvauksissa on kerrottu kunkin tietokentän sarakkeen sisältämän datan tietotyyppi seuraavasti: - char: vakiopituinen tekstikenttä (pituus mainittu sulkumerkkien sisällä). Jos kentässä oleva arvo on vakiopituutta lyhyempi, täyttö määriteltyyn vakiopituuteen ns. jälkiblankoilla. - varchar2: vaihtelevapituinen tekstikenttä (maksimipituus mainittu sulkumerkkien sisällä) - number: luku (maksimipituus ja mahdollisten desimaalien lukumäärä mainittu sulkumerkkien sisällä) - date: päivämäärä ja aika muodossa yyyy-mm-dd hh:mm (esim. 1992-05-25 00:00) - timestamp: päivämäärä ja aika muodossa yyyy-mm-dd hh:mm:ss:f (sekunnin desimaalien f lukumäärä mainittu sulkumerkkien sisällä) Väestötietojärjestelmässä on historiallisisista syistä / järjestelmän kokonaiskehittämisen vaiheistuksesta johtuen sekä number- että date-tyyppisiä päivämääriä sisältäviä tietokenttiä. Number-tyyppiset päivämäärät ovat muotoa vvvvkkpp ja ne voivat sisältää epätäydellisiä (esim. 19710000) sekä muulla tavoin virheellisiä, jopa kalenterin vastaisia päivämääriä (esim. 19700231). 2.3.1 Kiinteistöyksikön tiedot (KOM1) Tulostiedosto sisältää kiinteistö- ja määräalatyyppisten kiinteistöyksiköiden tiedot, 1 yksikön tiedot = 1 tulostiedoston rivi. Kiinteistöyksikön tiedot kirjoitetaan tähän osatiedostoon, vaikka sillä ei olisi yhtään haltijaa. Tiedoston lajittelu: 1. Kiinteistöyksikön (nouseva) Kentän nimi (01) Kiinteistöyksikön (02) Kiinteistöyksikön sijaintikunta (03) Kiinteistöyksikön tyyppi (04) Sijaintiyksikön (05) Kiinteistöyksikön voimassaolo (06) Kiinteistöyksikön nimi (07) Kiinteistöyksikön muu tunniste (08) Kiinteistöyksikön rekisteröintipäivä Tyyppi ja pituus varchar2(3) char(1) char(1) char(100) varchar2(50) Selitys / huomautuksia KKKKKKKKKKKKKKXnnnn KKKKKKKKKKKKKK = kiintelstö, X = tarkistusmerkki nnnn = määräalanumero Huom. kiinteistön tunnuksen pituus on 14 merkkiä. Määräalan tunnuksen pituus on 19 merkkiä. Missä kunnassa kiinteistöyksikkö sijaitsee. Tieto sijaintikunnasta ei enää käy ilmi kiinteistöyksikkötunnuksen kolmesta ensimmäisestä merkistä. Mahdolliset arvot: 1 = kiinteistö 2 = määräala (Ks. edellä tunnuksen muoto kummassakin tapauksessa.) Määräalan sijaintikiinteistö. Kiinteistöyksikön (kiinteistötunnuksen) voimassaolo. Mahdolliset arvot: 1=voimassa 2=lakannut Sijaintikiinteistön nimi; tilannimi tmv. Tunnuksen ja nimen lisäksi mahdollisesti annettava tunniste, esim. kaava määräalalle. Päivä, jolloin kiinteistöyksikkö on merkitty kiinteistörekisteriin. 3
(09) Kiinteistöyksikön Päivä, jolloin kiinteistöyksikkö on lakannut olemasta. lakkautuspäivä (10) Muutoslaji varchar2(30) Kiinteistöyksikön muutoksen laji. Mahdolliset arvot: 1=kiinteistöyksikön tunnuksen korjaus 2=kiinteistöyksikön nimen korjaus 3=muun tunnisteen korjaus 4=muodostuspäivän (rekisteröintipäivän) korjaus 5=lakkautuspäivän korjaus 6=voimassaolon korjaus 7=huomautuksen korjaus 99=kannan luonti (11) Yksikkö- ja haltijatietojen viimeisin muutospäivä Kiinteistöyksikön ja sen haltijan tietojen viimeisin muutospäivä VTJ:ssä. Tässä huomioidaan edellä kohdassa 2.2 Poiminnan käsittelysäännöt määritellyt muuttujat. (Useiden muuttujien perusteella poimintaohjelmassa pääteltävä tieto.) (12) Kiinteistöyksikön haltijoiden lukumäärä number (4) Haltijoiden lukumäärä, voimassa olevat hallinnat, sekä omistajat että vuokraajat yhteensä. (Poimintaohjelmassa laskettava tieto.) 2.3.2 Kiinteistöyksiköiden haltijoiden tiedot (KOM2) Poimintaehdot: - kiinteistöyksikkö sisältyy tulostiedostoon KOM1 ja se on voimassa oleva kiinteistöyksikkö (voimassa olo=1) - kiinteistöyksikön hallinta (joko omistus, hallintalaji =1 tai vuokraus, hallintalaji =2) on voimassa (hallinnalla ei loppupäivää) Yhdellä kiinteistöyksiköllä voi olla ei yhtään, yksi tai useita haltijoita. Tässä tiedostossa: 1 haltijan tiedot = 1 tulostiedoston rivi. Tiedoston lajittelu: 1. Kiinteistöyksikön (nouseva) 2. Haltijan henkilö (nouseva) 3. Haltijan Y- (nouseva) 4. Haltijan nimi (nouseva) Kentän nimi (01) Kiinteistöyksikön Tyyppi ja pituus Selitys / huomautuksia KKKKKKKKKKKKKKXnnnn KKKKKKKKKKKKKK = kiintelstö, X = tarkistusmerkki nnnn = määräalanumero (02) Sijantikunta varchar2(3) Kiinteistöyksikön sijaintikunta. Kuntanumero (03) Henkilö char(11) Haltijan henkilö (04) Y- char(9) Haltijan Y- (05) Ulkohenkilö char(2) Jos omistajaa ei ole yksilöity VTJ:ssä henkilötunnuksella tai Y-tunnuksella, eli kysymyksessä on ns. ulkohenkilö, niin tässä kentässä on vakioteksti uh (06) Hallintalaji char(1) Onko kysymyksessä omistus vai vuokraus. Mahdolliset arvot: 1 = omistus 2 = vuokraus (07) Omistajalaji char(2) Omistajan laji 01=yksityinen maatalousyrittäjä 02=muu yksityinen henkilö tai perikunta 03=asunto oy tai asunto-osuuskunta 04=kiinteistö oy 05=yksityinen yritys 06=valtio- tai kuntaenemmistöinen yritys 07=kunnan liikelaitos 4
08=valtion liikelaitos 09=pankki- tai vakuutuslaitos 10=kunta tai kuntainliitto 11=valtio 12=sosiaaliturvarahasto 13=uskonnollinen yhteisö, säätiö, puolue tai yhdistys 14=muu tyhjä=tieto puuttuu (08) Haltijan nimi varchar2(201) Henkilötunnuksellisen omistajan koko nimi muodossa Sukunimi Etunimet, tai Y-tunnuksellisen tai tunnuksettoman omistajan nimi siinä muodossa, kun se on tietokantaan tallennettu. (09) Haltijan kotikunta varchar2(3) Henkilötunnuksellisen haltijan kotikunta. Kuntakoodi (10) Haltijan äidinkieli char(2) Henkilötunnuksellisen haltijan äidinkieli. ISO-639 Kielikoodi, kaksikirjaiminen kielelle annettu esim. fi=suomi. (11) Haltijan Henkilötunnuksellisen haltijankuolinpäivä. Muoto vvvvkkpp. kuolinpäivä (12) Haltijan vakinainen osoite varchar2(124) Henkilötunnuksellisen omistajan vakinainen kotimainen asuinosoite, sisältäen tapauskohtaisesti kadunnimen, katunumeron ja huoneistotunnisteen. Osoitteen kielisyys on päätelty henkilön äidinkielen ja kotikunnan kielisuhteen mukaan. (13) Haltijan vakinaisen osoitteen (14) Haltijan vakinaisen osoitteen postitoimipaikka (15) Haltijan vakinaisen kotimaisen asumisen viimeinen muutosaikaleima (16) Haltijan postiosoite varchar2(5) varchar2(124) Henkilötunnuksellisen omistajan vakinaisen kotimaisen asuinosoitteen Henkilötunnuksellisen omistajan vakinaisen kotimaisen asuinosoitteen postitoimipaikan nimi. Nimen kielisyys on päätelty henkilön äidinkielen ja kotikunnan kielisuhteen mukaan. Y-tunnuksellisen ja ulkohenkilön postiosoite. HUOM. Henkilötunnuksellisen henkilön kohdalla tämä kenttä jätetään tyhjäksi (kannassa oleva tieto ohitetaan) (17) Haltijan postiosoitteen (18) Haltijan postiosoitteen postitoimipaikka (19) Haltijan ulkomainen lähiosoite (20) Haltijan paikkakunta (21) Haltijan valtion postinimi (22) Haltijan valtiokoodi (23) Valtion nimi selväkielisenä (24) Haltijan vakinaisen ulkomaisen osoitteen muutosaikaleima./. varchar2(80) varchar2(80) number(3) varchar2(30) Y-tunnuksellisen ja ulkohenkilön postiosoitteen. HUOM. Henkilötunnuksellisen henkilön kohdalla tämä kenttä jätetään tyhjäksi (kannassa oleva tieto ohitetaan) Y-tunnuksellisen ja ulkohenkilön postiosoitteen postitoimipaikan nimi. HUOM. Henkilötunnuksellisen henkilön kohdalla tämä kenttä jätetään tyhjäksi (kannassa oleva tieto ohitetaan) Henkilötunnuksellisen omistajan vakinaisen lähiosoite-osa, johon tyypillisesti sisältyy osoitteen kadunnimeä sekä talo- ja huoneistonumeroa koskeva osuus Henkilötunnuksellisen omistajan vakinaisen paikkakuntaosa, johon tyypillisesti sisältyy osoitteen a ja paikkakuntaa koskeva osuus Valtion postinimi (valtion nimi kansainvälisten postilähetysten pintaan kirjoitettavassa muodossa), esim. FRANCE (ei: Ranska) ISO 3166 valtiokoodi, kolminumeroinen valtiolle annettu. 5