Tama skeema kuvaa vtj:n kiinteistotiedoissa esiintyvat xml-tietotyypit Paivitetty viimeksi 6.9.2019 Lisatty PrakennustunnusTyyppi Paivitetty viimeksi 4.9.2019 Lisatty RakennusluokkakoodiTyyppi Paivitetty viimeksi 20.4.2016 Paivitetty PaluukoodiTekstiTyyppia Paivitetty viimeksi 11.3.2016 Paivitetty PaluukoodiTekstiTyyppia Paivitetty viimeksi 18.11.2015 Paivitetty KatunumeroTyyppi, KiinteistoyksikkotunnusTyyppi, KiinteistotunnusTyyppi Tieto kiinteistöllä sijaitsevista aktiiveista rakennuksista. Mahdolliset arvot: tyhjä, 1=kyllä Sisaltaa tietoa asiakkaille vtj:n toiminnasta, mm. paivamaaran, kellonajan ja viestin, muoto: pp.kk.vvvv klo tt:mm teksti. Muoto 0-480 merkkia. Muoto 1-2 merkkia. Hakuperusteen paluukoodin arvot 0 = ei loytynyt, 1 = loytyi, 2 = mahdollinen tunnushakuperuste passiivi, 3 = tunnistuksen hakuperusteilla loytyi liikaa henkiloita. HakuperustePaluukoodin arvot selvakielisena suomeksi, ruotsiksi tai englanniksi. Muoto 0-100 merkkia. Kertoo onko kyseessä kiinteistoyksikon omistus vai vuokraus. Mahdolliset arvot: tyhja, 1=omistus, 2=vuokraus. Asiakirjan tietyn allekirjoittajan hallintaan tullut osuus koko kiinteistoyksikosta. Osoittaja 13 merkkia, /, nimittaja 13 merkkia. Ilman etunollia. Muoto 0-27 merkkia. 0-100 merkkia, sen kadun nimi, jonka varrella rakennus sijaitsee 0-13 merkkia, rakennuksen osoitteen katunumero mahdollisine tarkenteineen Rakennuksen paaasiallinen kayttotarkoitus Tilastokeskuksen vahvistaman luokituksen mukaisesti. Muoto 0-3 numeroa. Kiinteistotunnus on 14 numeroa pitka merkkijono. Muoto KKKSSSRRRRYYYY Kiinteistoyksikkotunnus on max. 19 merkkia pitka merkkijono. Kiinteistoyksikkotunnus voi olla muodoltaan kiinteistotunnus (KKKSSSRRRRYYYY) tai maaraalatunnus KKKSSSRRRRYYYYXnnnn, X on tyyppikirjain ja nnnn on maaraalanumero. Voi olla myos tyhja. SoSo-sanomissa kaytetty vakinaisen ja tilapaisen kotimaisen osoitteen esitystapa. Kadun nimi, katunumero ja huoneistotunniste (porraskirjain, huoneistonumero, jakokirjain) esitetaan yhdessa merkkijonossa. Muoto 0-100 merkkia. Hakuperusteena kaytetty kuntanumero tai kunnan nimi. Muoto 1-30 merkkia. Kunnan nimi. Muoto 0-30 merkkia. Kuntanumero on Vaestorekisterikeskuksen antama 3-numeroinen juoksevasti numeroitu koodi, joka kattaa nykyiset kunnat, lakkautetut kunnat ja luovutetulle alueelle jaaneet kunnat. Kuntanumeron esitysmuotona kaytetaan aina 3-numeroista muotoa, mista johtuen koodit 001-099 ilmoitetaan etunollineen. Muoto 3 numeroa tai voi olla tyhja. Nimen esittaminen muodossa 0-100 merkkia. Paivamaara esitetaan kahdeksalla numerolla muodossa vvvvkkpp tai se voi myos olla tyhja. Jarjestelman virhetilanteissa kaytettavaa paluukoodia vastaava teksti selvakielisena suomeksi. Muoto 0-200 merkkia. 0000 Haku onnistui 0001 Hakuperusteella (henkilotunnus, sahkoinen asiointitunnus, .. ) ei loydy tietoja vtj:sta. 0002 Hakuperusteena kaytetty (tai sovelluksen sahkoisella asiointitunnuksella etsima) henkilotunnus on passivoitu. 0003 Kysyvan sovelluksen lahettama tunnussana puuttuu, on virheellinen tai vanhentunut. 0004 Kysyvan sovelluksen lahettama kayttajatunnus puuttuu, on virheellinen tai vanhentunut. 0005 ILMOITUS -tiedossa oleva selvakielinen teksti ilmoittaa virheen tai muun ilmoitettavan asian. Selvakielisia teksteja ovat: Sovellus tulostaa seuraavat paluukoodilla 0005 Seuranta ei onnistu / Uppfoljningen misslyckades Sukunimi on pakollinen annettava / Slaktnamn ar obligatoriskt Etunimet on pakollinen annettava / Fornamn ar obligatoriskt Syntymaaika on pakollinen annettava / Fodelsetid ar obligatoriskt 1. etunimi tuntematon nimihakemistolle / 1. fornamn okant for registret 2. etunimi tuntematon nimihakemistolle / 2. fornamn okant for registret 3. etunimi tuntematon nimihakemistolle / 3. fornamn okant for registret Loytyi useampi kuin 1. / Hittades flera an 1. 0006 Hakuperusteella (henkilotunnus, sahkoinen asiointitunnus, .. ) ei loydy tietoja vtj:sta. 0007 Haettava henkilo on kuollut, joten tietoja ei voida palauttaa, ellei muuta ole sovittu. 0008 Kyselysanomassa on pyynto varmenteen sulkulistatarkistuksesta (SULKULISTATARKISTUS="YES"), mutta sita ei toistaiseksi suoriteta. 0009 Kyselysanomassa on pyynto varmenteen voimassaolotarkistuksesta (VOIMASSAOLOTARKISTUS="YES"), mutta sita ei toistaiseksi suoriteta. 0010 Kysyvan sovelluksen on sovittu kayttavan tunnistukseen sahkoista asiointitunnusta (Finuid, Satu). Sahkoisen asiointitunnuksen sisaltava varmenne kuitenkin puuttuu. 0011 Kysyvan sovelluksen on sovittu kayttavan tunnistukseen 'perinteista' kayttajatunnusta. Kayttajatunnusta ei kuitenkaan laheteta, vaan sen tilalla tule sahkoisen asiointitunnuksen (Finuid, Satu) sisaltama varmenne. 0012 Varmenteelle suoritetussa voimassaolotarkistuksessa on todettu varmenteen voimassaolon paattyneen. 0013 Varmenteelle suoritetussa sulkulistatarkistuksessa on todettu varmenteen olevan sulkulistalla. 0014 Varmenne ei ole varmenne ollenkaan tai se ei ole vrk:n hyvaksyma. 0015 Varmenne ei ole vrk:n hyvaksyma. 0016 Kysely- ja vastaussanomien vertailussa on todettu niiden tunnistetietojen eroavan. Tama vertailu on toistaiseksi kaytossa vain muuttoilmoituksen yhteydessa. 1901 Tuotetta ei loydy 1902 Sanoma ei ole validi (merkit) 1903 Sanoma ei ole validi (tunnistuksen hakuxml merkit) 1904 Sanoma ei ole validi (loppukayttaja puuttuu) Muoto 1-5 numeroa. Katso koodia vastaavat arvot seka ilmoitusteksti kohdasta PaluukoodiTekstiTyyppi. Muoto on 5 numeroa tai voi olla myos tyhja. Postinumeron kaksi ensimmaista merkkia maarittelee, milla alueella postinumeron mukainen paikkakunta sijaitsee. Postinumeron kolme viimeista numeroa maarittelee, mihin postinumeroalueen sisalla olevaan osoitetoimipaikkaan lahetys lajitellaan. Postinumerot maarittelee Suomen Posti. Muoto 0-50 merkkia. Postitoimipaikan nimi. Muoto 0-50 merkkia. Pysyva rakennustunnus - VTJ-PRT on 10-merkkinen, 1-alkuinen numerosarja, jonka viimeinen merkki on aakkosnumeerinen tarkistemerkki. Kayttoonotto 2014. Voi olla myos tyhja Rakennuksen paaasiallinen rakennusluokka Tilastokeskuksen vahvistaman luokituksen mukaisesti. Muoto 0-4 numeroa. Rakennustunnus on kiinteistotunnus+tarkistusmerkki+rakennusnumero. Rakennustunnus on 18 merkkia pitka merkkijono, joka saa sisaltaa numeroita (merkit 1-18) ja isoja kirjaimia A-Z (merkki 15). Voi olla myos tyhja Muoto 0-50 merkkia. Muoto 0-100 merkkia. Tietojen poiminta-aika on aika, jolloin tiedot on poimittu vtj:sta. Tietojen poiminta-ajan muoto on vvvvkkpphhmmss, jossa vvvv = vuosi neljalla numerolla, kk = kuukausi, pp = paiva, hh = tunnit kahdella numerolla, mm = minuutit, ss = sekunnit. Mahdolliset arvot: tyhja tai 14 numeroa. Vakinaisen ja tilapaisen ulkomaisen osoitteen seka ulkomaisen postiosoitteen lahiosoitteen esittamiseen kaytetty tietotyyppi. Muoto 0-80 merkkia. Vakinaisen ja tilapaisen ulkomaisen osoitteen paikkakunta ja ulkomaisen postiosoitteen paikkakunta. Muoto 0-80 merkkia. SoSo-sanomissa kaytetty vakinaisen ja tilapaisen ulkomaisen osoitteen paikkakunta/postitoimipaikka-tieto. Tahan kenttaan viedaan tietokannassa oleva ulkomaisen paikkakunnan/postitoimipaikan nimi ja valtion nimi pilkulla toisistaan erotettuna. Muoto 0-100 merkkia. ISO 3166-1-koodiston mukainen kolminumeroinen valtionimeen liittyva tunnus. Muoto 3 numeroa tai voi olla tyhja. Valtion nimi selvakielisena (lyhyt muoto) 0-20 merkkia. Valtion nimi selvakielisena 0-30 merkkia. Muoto 0-10 merkkia Vtj:n tietojen (esim. henkilotunnuksen/sahkoisen asiointitunnuksen/kiinteistotunnuksen/avioliiton/rekisteroidyn parisuhteen) voimassaolo. Mahdolliset arvot: tyhja, 1=aktiivi, voimassa oleva, 2=passiivi, ei voimassa oleva, paattynyt. Edunvalvojana toimivan yrityksen nimi. Muoto 0-80 merkkia. Yrityksen tai yhteison postiosoite. Muoto 0-40 merkkia. Yrityksen tai yhteison postinumero. Muoto 0-7 merkkia. Voi olla esim. 01120 tai GE tai SE12569 tai XX99999. Yrityksen tai yhteison Y-tunnus. Muoto: 7 numeroa, valiviiva, numero tarkistusmerkkina tai voi olla tyhja