Sovellusrajapintojen käyttöönotto

Johdanto

Tälle sivustolle kootaan aineistoa Kiinteistövaihdannan palvelun (KVP) rajapintaratkaisujen käyttöönoton vaatiman sovelluskehityksen, koekäytön ja lopullisen käyttöönoton tueksi. Sivustolla tapahtuvista muutoksista pidetään muutoshistoriaa muutosten seurannan helpottamiseksi. Tuotekohtaisilla alasivuilla ylläpidetään myös tuotekohtaiset tarkemmat muutoshistoriat.

Järjestelmä tarjoaa selainpohjaisen sovelluksen yksityishenkilöiden ja organisaatiokäyttäjien käytettäväksi. Kaikki järjestelmää käyttävät henkilöt tunnistetaan joko palveluun kirjauduttaessa tapahtuvan vahvan tunnistautumisen perusteella tai organisaatioiden tapauksessa tunnistautumispolun perusteella. Organisaatioiden käyttöä helpottamaan tarjotaan mahdollisuus rakentaa tunnistautumisintegraatio, jonka avulla organisaatio voi mahdollistaa käyttäjilleen kerta-kirjautumisperiaatteella (single sign-on) tapahtuvan käytön. Ohjeistus liittymisestä selainpohjaisen sovelluksen käyttäjäksi löytyy KVP tunnistautumisrajapinta kuvauksesta.

Selainpohjaisen käyttöliittymän lisäksi tarjotaan rajapintapalveluna asiakirjarajapintoja. Asiakirjarajapintoja on kahden tyyppisiä:

1. Sähköisten asiakirjojen luonnostelun (KVP:n ulkopuolella) mahdollistavat rajapinnat
2. Kirjallisesti allekirjoitettujen hakemusasiakirjojen sähköisen toimituksen mahdollistava asiakirjarajapinta

Kaikkien KVP:n rajapintojen käyttö edellyttää sopimusta Maanmittauslaitoksen kanssa sekä integraation rakentamista palveluun.

Kuva 1: Asiakirjarajapinnat mahdollistavat Maanmittauslaitoksen ulkopuolella tapahtuvan asiakirjojen luonnostelun. Asiakirjat voi lähettää palveluun luonnoksena jolloin muokkaus on mahdollista tai lukittuina jolloin asianomaisilla on ainoastaan mahdollisuus vahvistaa tai hylätä asiakirja. Lisäksi on mahdollisuus toimittaa kirjallisesti allekirjoitettu lainhuutohakemus joka menee suoraan vireille. Versiosta 7 lähtien voi lähettää uuden asiakirjatyypin Asiointipaketti. Kuva on uusimman rajapintaversion mukainen.

Sähköisten asiakirjojen luonnostelun (KVP:n ulkopuolella) mahdollistavat rajapinnat

Sähköisten asiakirjojen osalta periaatteena on, että rajapintojen avulla organisaatio voi lähettää asiakirja- tai valtakirjaluonnoksia yksityishenkilöille tai yrityksille. Saapuvan asiakirjan vastaanottajan tulee hyväksyä saapuva asiakirja, jonka jälkeen asiakirja siirtyy järjestelmään. Lähetettävän asiakirjan voi myös merkitä lukituksi, jolloin asiakirjaan ei voi tehdä palvelussa muutoksia vaan se on mahdollista ainoastaan hyväksyä tai hylätä. Asiakirjaluonnoksien osalta rajapintojen käyttö vaatii, että palvelun käyttäjä yksilöi mihin kiinteistöön ja kenelle henkilölle asiakirja lähetetään (sekä muut asiakirjakohtaiset tiedot).

Kuva 2: Asiakirjan käsittelyn eteneminen, tähdellä merkityt merkityt vain luovutuskirjalle. 03/2016 alkaen tilakysely ja valmiiden asiakirjojen lataus on saatavilla kaikille asiakirjatyypeille.

Kun toimihenkilö lähettää asiakirjan, niin vastaanottaja saa saapuvasta asiakirjasta viestin. Kun vastaanottaja kirjautuu järjestelmän selainpohjaiseen käyttöliittymään, niin saapuva asiakirja näkyy käyttäjän meneillä olevissa asioissa. Vastaanottaja pääsee näkemään saapuvan asiakirjan sisällön, jonka jälkeen hän voi tuoda asiakirjan järjestelmään. Toimihenkilö voi myös itse vastaanottaa asiakirjan KVP:ssa, mikäli asiakas on antanut toimihenkilölle valtuudet toimia puolestaan. Vastaanottajalle tarjotaan luovutuskirjan vastaanoton yhteydessä mahdollisuus antaa katseluoikeudet lähettäjälle.

Vastaanottamisen jälkeen asiakirjan käsittely etenee normaalien vaiheiden mukaisesti. Rajapinnan kautta on mahdollista seurata allekirjoitustilannetta sekä hakea valmiit asiakirjat kun kaikki osapuolet ovat allekirjoittaneet.

Lähettäjä voi myös muokata luonnosta ja lähettää uusia versioita samasta asiakirjasta KVP:uun. Uuden version lähettäminen on mahdollista kunnes asiakirja on vastaanotettu.

Mikäli lähetettyä asiakirjaa ei ole otettu vastaan 90 päivän sisällä lähetyksestä, se poistetaan (huom. ei koske asiointipakettiin lähetettyjä asiakirjoja). Luovutuskirjojen ja maanvuokraoikeuden asiakirjojen tapauksessa luonnokset tulee ottaa vastaan 30 päivän sisällä lähetyksestä.

Asiakirjaluonnostelupalvelun käyttö on valinnaista, koska kaikki toimet voidaan hoitaa myös selainpohjaisessa sovelluksessa.

Tässä dokumentissa esitellään asiakirjanluonnostelupalvelun rajapinnat. Ulkoisen luonnostelupalvelun rakentamisessa voi lisäksi hyödyntää Uuden kirjaamisosan tietopalveluja rekisteriotteiden noutamiseksi rakenteellisessa muodossa.

Varsinainen allekirjoittaminen tapahtuu aina KVP:ssa. Asiakas voi valtuuttaa asiakirjan lähettäjän (tai muun henkilön / yrityksen) allekirjoittaman puolestaan. Lisäksi asiakirjarajapinta tarjoaa tiedon asiakirjan allekirjoitusten tilasta, sekä valmiin allekirjoitetun asiakirjan liitteineen yrityksen omaa arkistointia varten. Asiakirjarajapinnan kautta voi järjestelmään tuoda kaikki pakolliset ja valinnaiset tiedot, jotta asiakirjan voi ainoastaan käydä allekirjoittamassa järjestelmässä. Lisäksi käyttäjän tulee käydä sovelluksen kautta lisäämässä mahdolliset jälkikäteen toimitettavat liitteet kuten maksukuitit.

Kirjallisesti allekirjoitettujen hakemusasiakirjojen sähköisen toimituksen mahdollistava asiakirjarajapinta

Kirjallisesti vahvistettujen asiakirjojen toimittaminen tulee mahdolliseksi 10/2016 alkaen (jolloin lainhuutohakemuksen lähettäminen tulee mahdolliseksi). Rajapinta tarjoaa mahdollisuuden välittää kaikki tiedot myös rakenteellisessa muodossa käsittelyn nopeuttamiseksi.

Kirjallisesti vahvistetut asiakirjat menevät suoraan vireille. Hakemusten tilaa on mahdollista kysyä tilarajapinnan avulla.

Rajapintojen jatkokehitys

Katso asiakirjarajapinnan uudet versiot sivulta tarkemmin asiakirjarajapinnan muutoksista.

Käytön kustannukset

Itse rajapintojen käytöstä ei peritä maksuja, vaan palvelua rahoitetaan asiointi- ja hakemusmaksuilla joita peritään tehtyjen toimien perusteella (luonnostelu on ilmaista).

Sovelluksen käytön hinnoittelumalli ja euromääräiset kustannukset on kuvattu hinnastossa.

Maksut ja laskutus

Asiakirjan hakemus/asiointimaksu ja asiakirjaan kuuluvien kiinteistöjen rekisteriotemaksut otetaan joko lähettäjän laskulle tai maksetaan käyttöliittymässä. Lasku lähetetään vasta kun asiakirja on lopullinen KVP:ssä (allekirjoitettu valmiiksi ja hakemus vireillä).

1.1.2019 alkaen KVP:n asiakirjarajapintojen kautta lähetetyillä asiakirjoilla asiamieheltä ei voi laskuttaa enää mitään maksuja. Mikäli jotain otetaan laskulle, lasku lähetetään aina lähettäjälle. Ne asiakirjat jotka on ennenkin voinut maksaa käyttöliittymässä, voi edelleen maksaa myös käyttöliittymässä.Tämä koskee siis luovutuskirjoja, kiinnityshakemuksia ja panttikirjan siirtohakemuksia.

19.2.2020 alkaen (v11) mahdollisuus valita haluaako ottaa hakemusmaksun laskulle vai maksetaanko se käyttöliittymässä myös yhteiskiinnityksen purkamiselle, kiinnityshakemukselle (valmistelu ennakkoon) sekä maanvuokrasopimuksille.

Kirjallisen lainhuuto- tai erityisen oikeuden siirtohakemuksen maksut laskutetaan edelleen asiamieheltä.

Luovutuskirja

Luovutuskirjalta tulee maksaa Asiointi- ja lainhuutohakemusmaksu tai maksu erityisen oikeuden luovutuksesta. Lisäksi voi ostaa luovutettavan kohteen rekisteriotteita.

Maksun voi ottaa joko lähettäjän laskulle tai sen voi maksaa käyttöliittymässä. Mikäli maksu halutaan lähettäjän laskulle, tulee rajapinnasta lähettää elementti <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>

Kiinnityshakemus

Kiinnityshakemuksen laatimisesta tulee maksaa kiinnityshakemusmaksu. Lisäksi voi ostaa kiinnitettävän kohteen rekisteriotteita.

Maksun voi ottaa joko lähettäjän laskulle tai sen voi maksaa käyttöliittymässä. Mikäli maksu halutaan lähettäjän laskulle, tulee rajapinnasta lähettää elementti <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>

Panttikirjan siirtohakemus

Panttikirjan siirtohakemuksen laatimisesta tulee maksaa panttikirjan siirtohakemusmaksu. Rekisteriotteita ei ole mahdollista ostaa.

Maksun voi ottaa joko lähettäjän laskulle tai sen voi maksaa käyttöliittymässä. Mikäli maksu halutaan lähettäjän laskulle, tulee rajapinnasta lähettää elementti <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>

Kiinnityshakemus (valmistelu ennakkoon)

Kiinnityshakemuksen (valmistelu ennakkoon) laatimisesta laskutetaan kiinnityshakemusmaksu. Rekisteriotteita ei ole mahdollista ostaa.

19.2.2020 (v11) alkaen hakemusmaksun voi ottaa joko lähettäjän laskulle tai sen voi maksaa käyttöliittymässä. Mikäli maksu halutaan lähettäjän laskulle, tulee rajapinnasta lähettää elementti <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>. Vanhemmilla rajapintaversioilla maksu kirjautuu aina lähettäjän laskulle eikä sitä ei ole mahdollista maksaa käyttöliittymässä.

Yhteiskiinnityksen purkaminen

Yhteiskiinnityksen purkamisen laatimisesta laskutetaan kiinnityshakemusmaksu. Rekisteriotteita ei ole mahdollista ostaa.

19.2.2020 (v11) alkaen hakemusmaksun voi ottaa joko lähettäjän laskulle tai sen voi maksaa käyttöliittymässä. Mikäli maksu halutaan lähettäjän laskulle, tulee rajapinnasta lähettää elementti <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>. Vanhemmilla rajapintaversioilla maksu kirjautuu aina lähettäjän laskulle eikä sitä ei ole mahdollista maksaa käyttöliittymässä.

Kiinnityksen kuolettaminen

Kiinnityksen kuolettamista koskeva hakemus on ilmainen. Rekisteriotteita ei ole mahdollista ostaa.

Maanvuokraoikeuden perustaminen

Maanvuokraoikeuden perustamisesta laskutetaan maksu erityisen oikeuden kirjaamisesta. Rekisteriotteita ei ole mahdollista ostaa.

19.2.2020 (v11) alkaen maksun erityisen oikeuden kirjaamisesta voi ottaa joko lähettäjän laskulle tai sen voi maksaa käyttöliittymässä. Mikäli maksu halutaan lähettäjän laskulle, tulee rajapinnasta lähettää elementti <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>. Vanhemmilla rajapintaversioilla maksu kirjautuu aina lähettäjän laskulle eikä sitä ei ole mahdollista maksaa käyttöliittymässä.

Maanvuokraoikeuden muuttaminen

Maanvuokraoikeuden muuttamisesta laskutetaan maksu erityisen oikeuden muuttamisesta. Rekisteriotteita ei ole mahdollista ostaa.

19.2.2020 (v11) alkaen maksun erityisen oikeuden muuttamisesta voi ottaa joko lähettäjän laskulle tai sen voi maksaa käyttöliittymässä. Mikäli maksu halutaan lähettäjän laskulle, tulee rajapinnasta lähettää elementti <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>. Vanhemmilla rajapintaversioilla maksu kirjautuu aina lähettäjän laskulle eikä sitä ei ole mahdollista maksaa käyttöliittymässä.

Lainhuutohakemus

Kirjallisen lainhuuto- tai erityisen oikeuden siirtohakemuksen maksut laskutetaan asiamieheltä. Laskutusosoite lähetetään XML-sanomassa.

Organisaatiokäytön vaihtoehdot

• Selainkäyttö - valmiit tunnistautumistavat
  • Tunnistautumistavat
    • Organisaation edustajan tunnistaminen Suomi.fi-tunnisteella. Vaatii, että käyttäjillä on nimenkirjoitusoikeus rekisteröitynä PRH:ssa. Mahdollistaa organisaation kiinteistöjen myymisen.
  • Soveltuu tilanteisiin, jolloin käyttö on satunnaista ja käyttäjiä on vähän
  • Käyttö on mahdollista heti
  • Kustannustehokas
    • ei vaadi investointeja
  • Vaatii aina vahvan tunnistautumisen KVP:n - usein käytettynä työlästä
  • Voidaan käyttää ristiin kohdan 2 ja 3 kanssa
• Selainkäyttö - organisaatiokohtainen tunnistatumisrajapinnan käyttöönotto
  • Tunnistautuminen
  • Tunnistautuminen KVP-käyttöliittymään tapahtuu integroitavan rajapinnan avulla. Käyttäjä saa toimivaltuutusroolin kirjautuessaan sisään järjestelmään rajapinnan avulla.
  • Soveltuu tilanteeseen, jolloin käyttö on säännöllistä ja käyttäjiä on paljon
  • Käyttöönotto vaatii tunnistautumisintegraation toteuttamisen
  • Kustannustehokas
    • Investoinnit kohtuullisen pieniä saavutettuun hyötyyn verrattuna
  • Mahdollistaa Single sign-on kertakirjautumisen organisaation työasemilta
  • Käyttäjähallinta tapahtuu organisaation oman käyttäjähallinnan avulla
  • Organisaatiolla on velvollisuus säilyttää käyttäjätietoja ks. käyttäjän vastuut käyttöönoton jälkeen
• Rajapintakäyttö - asiakirjojen luonnostelurajapintojen käyttöönotto
  • Soveltuu tilanteeseen, jossa halutaan mahdollistaa joustava ja tehokas toiminta KVP:ssa
  • Käyttöönotto vaatii tunnistautumis- sekä asiakirjarajapintojen toteuttamisen
  • Edellyttää investointeja organisaation sisäisiin järjestelmiin sekä rajapintojen implementointiin asiakirjojen vapaamman luonnostelun mahdollistamiseksi
    • Saavutetaan suurin hyöty mahdollistamalla asiakirjojen luonnostelu organisaation omassa järjestelmässä ilman asiakkaan antamaa valtuutusta
  • Mahdollistaa Single sign-on kertakirjautumisen organiaation työasemilta
  • Mahdollistaa asiakirjaluonnostelun asiakkaan ympäristössä ja luonnosten viennin KVP:uun
  • Käyttäjähallinta tapahtuu organisaation oman käyttäjähallinnan avulla
  • Organisaatiolla on velvollisuus säilyttää käyttäjätietoja ks. käyttäjän vastuut käyttöönoton jälkeen
  • Edellyttää myös tunnistautumisrajapinnan toteuttamisen

Vaihtoehdot eivät ole toisiaan poissulkevia.

Käyttöönoton aikataulu

Järjestelmä otettiin käyttöön 1.11.2013. Järjestelmän käytön voi aloittaa koska tahansa. Ole yhteydessä Maanmittauslaitokseen, jos suunnittelet rajapintakäytön aloittamista.

Käyttäjähallinta

Tunnistautumisrajapinnan intekrointi mahdollistaa organisaatiolle Single Sign-on kirjautumisen Kiinteistövaihdannan palveluun. Organisaatio määrittää oman käyttäjähallintansa kautta siitä, kenellä organisaatiossa on oikeus käyttää Kiinteistövaihdannan palvelua.

Tunnistautumisirajapinnan kautta tulevien käyttäjien toimivaltuudet määräytyvät yrityskohtaisesti. Yritykset jaetaan toimialansa ja käyttötarkoituksen perusteella kolmeen eri rooliryhmään. Rooliryhmät ovat rahoituslaitos, kiinteistön välittäjä, yrityksen kiinteistövastaava.

Oikeudet rahoituslaitoksien toimivaltuutetuille, jotka tunnistautuvat tunnistusrajapinnan avulla:

• Voi toimia katselijana/asiamiehenä yrityksen edustajana
• Valtuuden käyttää KVP:ssä organisaatiolle annettuja valtakirjoja
• Luonnostella ja allekirjoittaa valtakirjan turvin valtuuttajan puolesta
• Katsella organisaation nimissä olevia panttikirjoja (sähköinen tai kirjallinen)
• Laatia ja hyväksyä organisaation nimissä oleville panttikirjoille siirtohakemuksia sekä tehdä niihin liittyviä sitoumuksia

Oikeudet kiinteistönvälittäjien toimivaltuutetuille, jotka tunnistautuvat tunnistusrajapinnan avulla:

• Voi toimia katselijana/asiamiehenä yrityksen edustajana
• Valtuuden käyttää KVP:ssä organisaatiolle annettuja valtakirjoja
• Luonnostella valtakirjan turvin valtuuttajan puolesta

Oikeudet yrityksen kiinteistövastaaville, jotka tunnistautuvat tunnistusrajapinnan avulla:

• Voi toimia katselijana/asiamiehenä yrityksen edustajana
• Valtuuden käyttää KVP:ssä organisaatiolle annettuja valtakirjoja
• Luonnostella valtakirjan turvin valtuuttajan puolesta
• Näkee yrityksen omistamat kiinteistöt ja panttikirjat
• Voi luonnostella yrityksen kiinteistöomaisuuteen kohdistuvia toimia (allekirjoitus tulee tehdä Suomi.fi-tunnistautumisella)

Tunnistautumisrajapinnan kautta tulevat saman yrityksen käyttäjät toimivat kaikki samalla käyttäjäroolitasolla.

Koekäyttö

KVP:n koekäyttö edellyttää käyttönottavalta organisaatiolta koekäyttösopimuksen solmimista maanmittauslaitoksen kanssa. Sopimuksen solmimisen yhteydessä organisaatiolle toimitetaan tarvittavat tiedostot ja sertifikaatit koekäytön aloittamiseksi. Koekäyttö varten on olemassa erillinen ympäristö, jossa yritys voi testata järjestelmän toimintaa vapaasti. Integraatioiden rakentamista varten tarjotaan käyttöön myös kehitysympäristö.

Tuotantokäyttö

KVP:n tuotantokäyttö edellyttää käyttönottavalta organisaatiolta sopimuksen solmimista maanmittauslaitoksen kanssa. Sopimuksen solmimisen yhteydessä organisaatiolle toimitetaan tarvittavat sertifikaatit koekäytön aloittamiseksi.

Sopimuksen solmimiseen liittyviä asioita täydennetään myöhemmin.

Organisaation velvollisuudet

Luonnostelurajapintojen käyttöönoton yhteydessä organisaatio vastaa oman käyttäjähallinnan ja -tunnistautumisen turvallisuudesta ja luotettavuudesta sekä sitoutuu säilyttämään käyttäjätiedot viranomaisselvityksiä varten määräajan.

Mahdollisten väärinkäytösten selvittämiseksi organisaation on pystyttävä selvittämään organisaation työntekijän oikea henkilöllisyys määräajan puitteissa, jos viranomainen tietoa pyytää. Rajapintakäyttäjän identiteetti selvitetään tunnistuspolun avulla.

Kuva 3: Tunnistuspolku kuvaa käyttäjän identiteetin selvittämisen tarvittaessa

Muutoshistoria

Kiinteistövaihdannan palvelun tunnistautumisrajapinta

Johdanto

Tämän dokumentin tarkoituksena on toimia ohjeistuksena organisaatioille tunnistautumisen toteuttamisesta KVP:n selainpohjaiseen käyttöön. Dokumentissa kuvataan liittymisprosessi, kirjautumisprosessi, tekniset vaatimukset tunnistautumisratkaisulle sekä paluusanoman attribuutit.

KVP tarjoaa tunnistautumisrajapinnan organisaatioille, jotta organisaation työntekijät voivat kirjautua järjestelmään hyödyntäen organisaation omaa kirjautumisratkaisua. Tunnusten hallinta säilyy tällöin yhdessä paikassa. Vastuunäkökulmasta Maanmittauslaitos tunnistaa teknisesti vain organisaation, joka muodostaa yhteyden MML:een ja organisaation vastuulle jää tunnistaa varsinainen käyttäjä. Tieto käyttäjän identiteetistä välitetään MML:lle käyttäjän nimen sekä yksilöivän, mutta sinänsä anonyymin tunnisteen muodossa. Organisaation vastuulla on ilmoittaa pyydettäessä viranomaisille tiettyä tunnistetta vastaavan käyttäjän nimi ja henkilötunnus. Tunnisteiden tulee säilyä pysyvästi yksilöivinä, eikä yksittäistä tunnistetta saa siksi antaa toiselle käyttäjälle sen jälkeen kun sen alkuperäinen omistaja lopettaa tunnisteen käytön. Rajapinnan käyttäminen edellyttää sopimussuhdetta MML:een.

Sanasto

Selainpohjaisen tunnistautumisen käyttöönotto

Aloittaakseen tunnistautumisrajapinnan käytön, tulee organisaation tehdä sopimus MML:n kanssa rajapinnan käytöstä ja toteuttaa SAML 2.0 -standardin mukainen IdP. Ratkaisussa ei ota kantaa siihen, mitä toteutusta organisaatiot käyttävät IdP-ratkaisussaan, ainoana teknisenä vaatimuksena on SAML 2.0 -standardin toteutus. Liikennöinti tapahtuu SSL-yhteyden sisällä, jossa tunnistetaan palvelin, mutta ei clientia.

Mikäli organisaatio ei halua toteuttaa omaa Idp:tä, voi tämä käyttää integraattorin palvelua. Integraattorin on mahdollista päättää viestissä lähetettävä y-tunnus. Y-tunnus määrää sen yrityksen, jossa sisäänkirjautunut käyttäjä toimii. Jotta integraattori voi käyttää tiettyä y-tunnusta, tulee y-tunnuksen omaavalle organisaatiolle tehdä alisopimus ko. integraattorin alle.

Sopimuksessa ilmoitetaan yhteyshenkilö, joka on vastuussa sopimuksen mahdollisesta jatkamisesta, tekninen yhteyshenkilö, sopimuskausi sekä halutaanko asemavaltuutetulle antaa valtuudet siirtää organisaation nimissä olevia panttikirjoja. Tyypillisesti valtuudet annetaan ainoastaan rahoituslaitosten henkilöstölle. Tekninen yhteys automaattisesti lakkaa toimimasta sopimuskauden umpeutuessa, mikäli sopimusta ei ole uusittu.

Avoimen lähdekoodin ratkaisuja on listattu esimerkiksi SAML XML.org -sivustolla. Myös kaupallisia tuotteita on saatavilla.

Esimerkki avoimen lähdekoodin Shibboleth IdP -sovelluksen konfiguroinnista alustavaan testikäyttöön liitteessä 1.

Testausympäristöön integroituminen

Esivaatimukset

• Sopimus MML:n kanssa testausvaiheesta allekirjoitettu
• SAML 2.0:n mukainen, sopimuksen vaatimukset täyttävä IdP -testiympäristö

Vaiheet

• MML toimittaa organisaatiolle SP:n SAML 2.0:n mukaisen XML-muotoisen metadatan
• Organisaatio toimittaa MML:lle IdP:n SAML 2.0:n mukaisen XML-muotoisen metadatan
• Organisaatio konfiguroi SP:n IdP:hen
• MML ilmoittaa organisaatiolle, milloin tämä voi alkaa testata integraatiota

Tuotantoympäristöön integroituminen

Esivaatimukset

• Sopimus MML:n kanssa tuotantovaiheesta allekirjoitettu
• SAML 2.0:n mukainen, sopimuksen vaatimukset täyttävä IdP -tuotantoympäristö
• Integraation toteutus on verifioitu kehitys tai testiympäristössä

Vaiheet

Kts. "KVP-testausympäristöön integroituminen"

Kirjautumisprosessi

Tunnistautumistransaktio

1. Käyttäjä pyrkii kirjautumaan palveluun organisaation sivuilla olevan linkin kautta (esim. www.kiinteistoasiat.fi/auth/saml/organisaatioabc/v1). Käytettävä IdP määräytyy tämän osoitteen perusteella.
2. KVP rakentaa SAML tunnistautumispyyntösanoman.
3. KVP lähettää uudelleenohjauksen IdP:hen käyttäjän selaimelle, sisällyttäen SAML pyyntösanoman URL:iin.
4. IdP parsii tunnistaumispyyntösanoman ja tunnistaa käyttäjän valitsemallaan menetelmällä.
5. IdP rakentaa SAML vastaussanoman, joka sisältää KVP:n tarvitsemat käyttäjän tiedot. Sanoma on salattu KVP:n julkisella avaimella ja allekirjoitettu IdP:n julkisella avaimella.
6. IdP palauttaa sanoman käyttäjän selaimelle, josta se välitetään KVP:lle POST -metodilla (esim. piilolomakkeen avulla).
7. KVP verifioi sanoman, ottaa sen sisältämät attribuutit talteen ja kirjaa käyttäjän sisään palveluun.

XML-esimerkit

• Esimerkki SP:n pyyntösanomasta
• Esimerkki IdP:n vastaussanomasta

Tunnistautuminen ja attribuutit

Tunnistautumisintegraatiota käytettäessä autentikoimispyyntö tulee ohjata osoitteeseen: https://<ympäristön osoite>/auth/saml/<MML:n antama integraattorin tunniste>/v<tunnisterajapinnan versionumero> Esimerkiksi https://www.kiinteistoasiat.fi/auth/saml/organisaatiotunnisteabc/v1

Tunnistautumisen yhteydessä tulee välittää kaikki pakolliset attribuutit, muuten tunnistautuminen hylätään.

Käyttäjän yksilöinti tapahtuu tunnistautumispalvelun välittämällä yksilöivällä käyttäjätunnisteella, joka tulee olla jäljitettävissä pyydettäessä. MML ei ota kantaa tämän muotoon tai sisältöön, mutta organisaation tulee voida viranomaisen pyynnöstä toimittaa tieto siitä, kuka henkilö kyseisellä tunnisteella on palvelussa tehnyt toimia.

Palvelussa näytettävät tiedot muille käyttäjille ovat käyttäjän nimi, sähköpostiosoite (jos lupa annettu erikseen palvelussa) sekä yrityksen Y-tunnus. Yrityksen nimi noudetaan YTJ:stä automaattisesti Y-tunnuksen perusteella.

Attribuutit

Versio 1

XML-esimerkki IdP:n vastaussanoman attribuuteista

<saml2:AttributeStatement>
  <saml2:Attribute FriendlyName="skv.userid" Name="skv.userid" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
    <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">org_matti_437612555</saml2:AttributeValue>
  </saml2:Attribute>
  <saml2:Attribute FriendlyName="skv.firstname" Name="skv.firstname" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
    <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">Matti</saml2:AttributeValue>
  </saml2:Attribute>
  <saml2:Attribute FriendlyName="skv.lastname" Name="skv.lastname" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
    <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">Meikäläinen</saml2:AttributeValue>
  </saml2:Attribute>
  <saml2:Attribute FriendlyName="skv.businessid" Name="skv.businessid" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
    <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">1234567-8</saml2:AttributeValue>
  </saml2:Attribute>
  <saml2:Attribute FriendlyName="skv.language" Name="skv.language" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
    <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">fi</saml2:AttributeValue>
  </saml2:Attribute>
  <saml2:Attribute FriendlyName="skv.email" Name="skv.email" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
    <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">matti@organisaatio.com</saml2:AttributeValue>
  </saml2:Attribute>
  <saml2:Attribute FriendlyName="skv.authorization" Name="skv.authorization" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
    <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">asemavaltuutus</saml2:AttributeValue>
    <saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">toinenrooli</saml2:AttributeValue>
  </saml2:Attribute>
</saml2:AttributeStatement>

Rajapinnan versiointi

Palvelun vaatimat attribuutit versioidaan, jolla pyritään välttämään tilannetta, jossa kaikkien IdP:iden tulisi samalla hetkellä ottaa päivitetty rajapinta käyttöönsä. Uusi ja vanha rajapinta pyritään pitämään toiminnassa rinnakkain sovitun siirtymäjakson ajan, jonka aikana IdP:n tulisi ottaa uusi rajapinta käyttöönsä. Käytettävä rajapinta määritellään osoitteessa, jonka kautta organisaation työntekijät KVP-järjestelmään tulevat (esim. www.kiinteistoasiat.fi/auth/saml/organisaatioabc/v1 tai www.kiinteistoasiat.fi/auth/saml/organisaatioabc/v2).

Tällä hetkellä rajapinnasta on olemassa vain versio 1 (v1).

Käyttöoikeusroolit

Alustavasti KVP:ssä organisaatiokäyttäjillä on vain yksi käyttöoikeusrooli. Jos perusteita muille käyttöoikeuksille löytyy, voidaan näiden toteuttamista tarpeen mukaan harkita.

Asemavaltuutus

Käyttäjä voi toimia asiakkaansa nimissä (asiakirjojen luonnostelu ja/tai allekirjoitus) KVP-järjestelmässä niiden valtakirjojen puitteissa, jotka asiakas on organisaatiolle (Y-tunnus rajoittimena) antanut. Lisäksi jos organisaation toimialaan kuuluu luotonanto, voi käyttäjä tehdä panttikirjojen siirtohakemuksia niille sähköisille panttikirjoille, jossa organisaatio on saajana. Tämä toiminto aktivoidaan silloin kun sopimus MML:n kanssa niin määrittelee.

Mahdolliset virhetilanteet

1. Teknisen yhteyden virhetilanteessa näytetään virhesivu.
2. Puutteellisista/virheellisistä tunnistautumistiedoista tulee ilmoitus sisäänkirjautumisen epäonnistumisesta.
3. Mikäli yritykselle tai integraattorille ei ole järjestelmässä voimassa olevaa sopimusta tai käyttöoikeutta, niin tekninen autentikoituminen onnistuu mutta sovellus ilmoittaa että "Ei käyttöoikeutta järjestelmään". Huomioi että integraattorilla itsellään ei välttämättä ole käyttöoikeutta vaan käyttöoikeus voi olla ainoastaan integraattorin välittämien yrityksien käyttäjillä.

Ole tarvittaessa yhteydessä tukeen ongelmien tarkempaa selvitystä varten. Liitä tukipyyntöön mukaan KVP:lle välitettävät tunnistautumistiedot.

Lisätietoja ja linkkejä

Muutoshistoria

Johdanto

Tämän dokumentin tarkoituksena on toimia ohjeistuksena organisaatioille asiakirjarajapintojen käyttöönottoon. Dokumenteissa kuvataan liittymisprosessi, tekniset vaatimukset sekä rajapintamääritykset luonnostelurajapintojen käyttöönottoon.

Asiakirjarajapintapalvelu

Asiakirjarajapintapalvelussa asiakkaan sovellus lähettää asiakirjoja Maanmittauslaitokselle. Asiakirjat voivat olla joko luonnoksia sähköisistä asiakirjoista tai valmiita kirjallisia hakemuksia. Valmiina kirjallisena hakemuksena voi toimittaa lainhuutohakemuksen tai erityisen oikeuden kirjaamishakemuksen. Sähköiset luonnosasiakirjat allekirjoitetaan aina KVP-järjestelmässä. Valmiit kirjalliset hakemukset puolestaan laitetaan suoraan vireille.

Valmiiden kirjallisten hakemusten osalta edellytetään että liitteenä toimitetaan alkuperäisestä, allekirjoitetusta asiakirjasta tehty sähköinen jäljennös (pdf tai kuva) sekä sähköisesti eroteltuna vähintään hakemuksen minimitiedot.

Sähköisen luonnosasiakirjan vastaanottajan (tai hänen valtuutettunsa) tulee ottaa hakemus vastaan KVP:n käyttöliittymässä. Ennen vastaanottoa hänelle näytetään pdf-muotoinen asiakirjaluonnos tietojen esikatselua varten. Esikatselu-PDF:ssä näytetään kaikki saapuvaan asiakirjaan tulevat tiedot kuten ne on XML:ssä ilmoitettu. Esikatselu-PDF on ladattavissa myös rajapinnan kautta. Asiakirjan tiedot täydentyvät rekisteristä vastaanoton jälkeen. Rekisteritietojen tietosuojan vuoksi tiedot tuodaan vain allekirjoitettavaan asiakirjaan.

Kyselypalvelun tekninen kuvaus

Rajapintaa käytetään HTTP/REST-tekniikkaan perustuvilla kutsuilla. Sanoma välitetään XML-muodossa ja vastaus saadaan vastaavasti XML-muodossa. Palveluun lähetettävän XML:n version tulee olla 1.0 ja sisältö välitetään aina Unicode-merkistössä UTF-8 koodattuna. Liitetiedostot välitetään zip-pakettina.

XML:n otsikkona tulee siis käytännössä olla: <?xml version="1.0" encoding="UTF-8"?>

Lisäksi pyynnön header-tiedoissa täytyy olla: Content-type: application/xml; charset=utf-8

Rajapintatunnistus ja tiedonsiirtoyhteys

Kaikkien rajapintojen käyttöä varten organisaatiokäyttäjän täytyy tunnistautua.

Asiakirjan lähettäjä tunnistetaan käyttäen sertifikaattipohjaista tunnistautumista. Kaikkien pyyntöjen tulee käyttää MML:n asiakkaalle toimittamaa asiakassertifikaattia. Sertifikaatti ja sen voimassaoloaika on sidottu MML:n kanssa tehtyyn sopimukseen.

Integraattori voi välittää asiakirjaluonnostelupalvelua edelleen omille asiakkailleen (eli toimia integraattorina). Loppukäyttäjien tulee tehdä sopimus MML:n kanssa ja lisäksi käytetty integraattori pitää ilmoittaa MML:lle.

Teknisesti tällöin integraattori välittää loppukäyttäjien sanomat käyttäen omaa sertifikaattiansa. Lisäksi lähetettävässä xml:ssä tulee käyttää integraattorin sopimustunnusta. Loppuorganisaatio puolestaan tunnistetaan lähettäjän perusteella. Rajapinnasta lähetettävissä asiakirjoissa tulee lähettäjän yTunnus-elementissä olla loppukäyttäjäorganisaation y-tunnus.

Yhteys asiakkaan ja palvelun välillä on suojattu käyttäen SSL-yhteyskäytäntöä. Suojaamatonta HTTP-yhteyttä ei tueta.

Asiakirjarajapinnan uudet versiot

Tällä sivulla yhteenvedetään uusien versioiden sisältö pääpiirteittäin. Asiakirjakohtaisilta sivuilta löytyy yksityiskohtaiset skeemat uusista versiosta.

Uudet versiot

Järjestelmän tarjoamat rajapinnat on versioitu. Skeemojen tiedostonimet, niissä esiintyvä versionumero ja rajapinnan osoitteen versionumero tulee täsmätä. Uusista versioista tiedotetaan erikseen. Uuden version julkaisun jälkeen pidetään vanhempaa versiota tietyn siirtymäkauden ajan voimassa uuden version rinnalla.

Uuden version tunnistaa skeemojen nimissä ja nimiavaruuksissa käytetystä versionumerosta (esim v2). Kun asiakirjarajapinnasta tulee uusi versio, niin kaikkien skeemojen versionumeroa kasvatetaan samanaikaisesti, versionumeron kasvattaminen ei siis tarkoita automaattisesti että tietyssä yksittäisessä rajapinnassa olisi tapahtunut varsinaisia toiminnallisia muutoksia.

Yleistä

2.3.2022 julkaisun yhteydessä tapahtuu muutoksia AsiamiesTaiYhteyshenkilo-elementin käsittelyyn. Muutokset eivät koske Lainhuutohakemus- ja Erityisen oikeuden kirjaushakemus -rajapintoja. Muutos koskee kaikkia tuettuja rajapintaversioita.

Osoitetiedoissa vastaanottajaksi merkitään automaattisesti annetun asiamiehen etu- ja sukunimi tai yrityksen nimi. Vastaanottaja-elementissä annettua tekstiä ei näin ollen enää käytetä. Jos yrityksen osoitetietoihin tarvitsee tarkennusta (esim. osasto tai yksikkö), tulee käyttää VastaanottajanTarkenne-elementtiä. Yritys-Yhteyshenkilö -elementissä lähetettyä tekstiä ei enää käytetä.

Versio 14 yhteenveto

Uudet toiminnallisuudet

• Luovutuskirja

  • Kiinteistönluovutusilmoituksessa annetaan jatkossa vain yksi käyttötarkoitus.

  • Sitoumuksia on mahdollista esikatsella.

• Kiinnityshakemus (valmistelu ennakkoon)
  • Kohteeksi sallitaan määräosat
• Yleistä
  • Vastaussanoman virheisiin on lisätty ennakko kiinnitykseen liittyvä virhekoodi

12.12.2022 julkaistava päivitys

v14 skeemamuutokset sisältyvät pakettiin 2022-10-28-1. Katso ohjeet skeemojen versioinnista.

• Tilarajapinnasta on poistettu käyttämätön vapaaehtoinen elementti TaydennysOsoite.

7.6.2023 julkaistava päivitys

v14 skeemamuutokset sisältyvät pakettiin 2023-04-24-1. Katso ohjeet skeemojen versioinnista.

• Lainhuutohakemus- ja erityisen oikeuden kirjaushakemus -rajapinnat käyttävät jatkossa vapaaehtoista elementtiä AsiakirjanLuontiPvm.
• Lainhuutohakemus-rajapinnan liitetiedostolajeihin on tullut päivityksiä.

4.10.2023 julkaistava päivitys

v14 skeemamuutokset sisältyvät pakettiin 2023-06-20_2. Katso ohjeet skeemojen versioinnista.

• Tilarajapintaan AsiaTila-elementille lisätään uusi tila POISTETTU.
• Luovutuskirja-rajapintaan on lisätty uusi aetoinen elementti Katselijat.
• Vastaussanoman virheisiin on lisätty luovutuskirjan katselijaan liittyvä virhekoodi.

Versio 13 yhteenveto

Uudet toiminnallisuudet

• Erityinenoikeushakemus-rajapinta julkaistaan

• Lainhuutohakemus

  • Selvennyslainhuutoon ei käytetä Saanto -elementtiä
  • SaantoPvm on muuttunut pakolliseksi
  • AsiaKieli-elementti siirtyy LainhuutohakemuksenPerusTiedot-elementin alle

5.5.2022 julkaistava päivitys

v13 skeemamuutokset sisältyvät pakettiin 2022-05-04-1. Katso ohjeet skeemojen versioinnista.

• Tilarajapinnan sitoumuksen ehtojen Automaatinen-elementti tyyppi muuttuu siten, että elementtiin voidaan jatkossa antaa sekä true että false arvoja.

2.3.2022 julkaistava päivitys

v13 skeemamuutokset sisältyvät pakettiin 2022-01-28_3. Katso ohjeet skeemojen versioinnista.

• Asiamiehen osoitetiedot muuttuvat vapaaehtoisiksi.

• Lainhuutohakemus- ja erityinenoikeushakemus -rajapinnat
  • Laskutustiedot-elementti on lisätty Maanmittauslaitoksen sisäiseen käyttöön.
• Tilarajapinta
  • Seurantatila-elementti on lisätty.

4.10.2023 julkaistava päivitys

v13 skeemamuutokset sisältyvät pakettiin 2023-06-20_2. Katso ohjeet skeemojen versioinnista.

• Tilarajapintaan AsiaTila-elementille lisätään uusi tila POISTETTU.

Versio 12 yhteenveto

Uudet toiminnallisuudet

• Lainhuutohakemus
  • Saantolaji-koodit 20 ja 21 poistettu
  • AsiaKieli on muuttunut pakolliseksi
  • Yleinen LaskutuksenViiteTiedot-elementti otetaan käyttöön
• Luovutus
  • Kaavatiedot on lisätty Kiinteistonluovutusilmoitus-elementtiin
• Luontitiedot
  • Lähdeasiakirjatunnus annetaan URL-parametrina eikä enää osana polkua
• Yleistä
  • Vastaussanoman virheisiin on lisätty uusia kiinnityksiin liittyviä virhekoodeja

Versio 11 yhteenveto

Uudet toiminnallisuudet

• Yleistä
  • YleinenHenkilotunniste ja YleinenYritysTunniste poistettu
  • Kotimaakoodia ei enää kysytä yksityishenkilölle
  • Vastausanoman virheissä VapaaVirheViesti-elementtiä on muutettu tukemaan virheviestejä usealla kielellä
• Lainhuutohakemus
  • Henkilotunniste ja Yritystunniste poistettu
  • Kotimaakoodi on poistettu ja tilalla on Kansalaisuuskoodi, joka kysytään ulkomaalaisille henkilöille ja yrityksille
  • Kuolinpesä voi toimia hakijana ja luovuttajana
  • Luovuttajan osuus on vapaaehtoinen
• Valtakirja
  • Saajat-elementti on korvattu LuovutuksenSaajat-elementillä
• Tilarajapinta
  • HavaittuVirhe-elementtiä on muutettu tukemaan virheviestejä usealla kielellä

Poistuneet toiminnallisuudet

• Mitään ei poistettu

Skeemat

Katso myös siirtyminen käyttämään versiota 11

Versio 10 yhteenveto

Uudet toiminnallisuudet

• Maanvuokraoikeuden laajentaminen
  • Mahdollista ilmoittaa useita kohteita maanvuokraoikeuden perustamiselle.
  • Mahdollista hakea maanvuokrasopimuksen korvaamista tai vuokra-ajan jatkamista.

Poistuneet toiminnallisuudet

• Mitään ei poistettu

Skeemat

Katso myös siirtyminen käyttämään versiota 10

Versio 9 yhteenveto

Uudet toiminnallisuudet

• Usean kiinteistön luovutus samalla luovutuskirjalla
• Kuolinpesät saaja- ja hakijatietoihin

Poistuneet toiminnallisuudet

• Mitään ei poistettu

Muutetut toiminnallisuudet

• LuovutusRequest muuttunut tukemaan useaa kohdetta
• VirheTyyppi muuttunut (uusia ja poistuneita virhetyyppejä sekä lisätty rajoitus mahdollisille arvoille)
• Muutoksia peruskomponentteihin, muutokset vaikuttavat lähes kaikkiin rajapintoihin:
  • LuonnoksenVastaanottaja-elementtiä ei anneta enää osapuoli-kohtaisesti. True/false arvonsijaan elementissä ilmoitetaan vastaanottavan osapuolen henkilö- tai y-tunnus.
  • Laskutusosoite-elementti on poistettu AsiamiesTaiYhteyshenkilo-elementiltä ja siirretty lainhuutohakemusrajapinnan skeemaan. Laskutustiedot voi antaa jatkossa vain lainhuutohakemusrajapinnassa.
  • AsiamiesTaiYhteyshenkilo-elementin Puhelinnumero-elementti on siirretty Postiosoite-elementin yläpuolelle.
  • Osapuolien Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään.
  • UlkomainenHenkilotunniste ja UlkomainenYritysTunniste -elementit on siirretty lainhuutohakemusrajapinnan skeemaan. Ulkomaalainen osapuoli voi toimia ainoastaan lainhuutohakemusrajapinnassa.

Skeemat

Katso myös siirtyminen käyttämään versiota 9

Versio 8 yhteenveto

Uudet toiminnallisuudet

• Vuokraoikeuden voi lisätä asiointipakettiin

Poistuneet toiminnallisuudet

• Mitään ei poistettu

Muutetut toiminnallisuudet

• Tilarajapinnassa vanhenemispäivämääriä
• Vuokraoikeuden skeemaan asiointipaketin tunnus

Skeemat

Katso myös siirtyminen käyttämään versiota 8

Versio 7 yhteenveto

Versiosta 7 alkaen on mahdollista lähettää yhteiskiinnitysten purkamishakemuksia sekä asiointipaketteja.

• Kiinnitysmuutosrajapinnan kautta voi hakea yhteiskiinnityksen purkamista.
• Maanvuokraoikeuden perustamisrajapinnasta on poistettu elementit Tontinvuokrasopimus ja Tontinvuokraoikeus.
• Lainhuutohakemukselle voidaan antaa VainEsikatselu-elementti, jolloin lähetettyä hakemusta ei laiteta vireille, mutta sen esikatselu-pdf:n voi ladata rajapinnan palauttamasta esikatseluosoitteesta.
• Asiointipaketti-rajapinnan kautta voi luoda asiointipaketteja. Asiointipakettiin voi ensimmäisessä versiossa lähettää uuden määräalan luovutuskirjan sekä siihen liittyvän kiinnityshakemuksen (valmistelu ennakkoon).

Skeemat

Uusien palveluiden kuvaukset löytyvät:

• Asiointipaketti-rajapinnan kuvaus

Katso myös siirtyminen käyttämään versiota 7

Versio 6 yhteenveto

Versiosta 6 alkaen on mahdollista lähettää kiinnityksen kuolettamishakemuksia.

• Uusi Kiinnitysmuutosrajapinta. Rajapinnan kautta voi hakea kiinnityksen kuolettamista.
• Kiinnityshakemusrajapinnan kautta on mahdollista lähettää yhteiskiinnityshakemus.
• Lainhuutohakemusrajapinnan HakemusPDFLiite -elementti muutettu vapaaehtoiseksi.
• Lainhuutorajapinnan kautta lähetetyille hakemuksille uudet vapaaehtoiset elementit LuovutuksenSaaja -elementille: EtuostolainMukainenVakuutus ja EnsiasunnonOstajanVakuutus.
• Maanvuokraoikeuden perustamisrajapinnasta poistettu mahdollisuus ilmoittaa yksityishenkilö vuokranantajaksi.
• Muutoksia peruskomponenteissa: AsiamiesTaiYhteyshenkilo kooste-elementistä on poistettu elementit YhteyshenkilonaHakija ja NimettyAsiamies.
• Muutoksia peruskomponenteissa: Hakijan Henkilotunnus ja Ytunnus elementit on korvattu elementeillä Henkilo ja Yritys.
• Poistettu käyttämättömiä elementtejä ja tietotyyppejä.

Skeemat

Uusien palveluiden kuvaukset löytyvät:

• Kiinnitysmuutos-rajapinnan kuvaus

Katso myös [siirtyminen käyttämään versiota 6][sovellusrajapintojen_päivitysohjeet_versiosta_5_versioon_6]

Versio 5 yhteenveto

Versiosta 5 alkaen on mahdollista lähettää maanvuokrasopimuksia. Laskutukseen liittyvissä elementeissä on myös lisätty mahdollisuus asiakkaan omien viitetietojen lähettämiseen.

• Uusi Maanvuokraoikeuden perustaminen -rajapinta
• Uusi yleinen LaskutuksenViiteTiedot -elementti, jossa on uusi AsiakkaanViite -elementti ja vanha LaskutusKoontiavain -elementti.
• Luovutuskirja -rajapinnan kautta asiamiehelle voi tuoda jatkossa myös AsiakkaanViite -elementin mukana viitetietoja lainhuutohakemuksen laskutukseen liittyen.
• Kaikille asiakirjoille lainhuutohakemusta lukuunottamatta voidaan antaa VainEsikatselu-elementti, jolloin lähetettyä asiakirjaa ei näytetä asiakkaalle, mutta sen esikatselu-pdf:n voi ladata rajapinnan palauttamasta esikatseluosoitteesta

[Skeemat][v5_20171004.zip]

Uusien palveluiden kuvaukset löytyvät:

• Maanvuokraoikeuden perustaminen-rajapinnan kuvaus

Versio 4 yhteenveto

Asiakirjarajapintapalvelun versiossa 4 on mahdollista lähettää kiinnityshakemus (valmistelu ennakkoon). Muut merkittävimmät muutokset ovat toistuvien elementtien sijoittaminen kokoavan elementin sisään ja joidenkin elementtien pakollisuuksien muuttaminen.

Uusia kirjallisia panttikirjoja ei voi enää pyytää.

Yksityiskohtaiset muutokset

[Skeemat][v4_20170531.tar.gz]

Uusien palveluiden kuvaukset löytyvät:

• Kiinnityshakemus (valmistelu ennakkoon)-rajapinnan kuvaus

Versio 3 yhteenveto

Asiakirjarajapintapalvelun versiossa 3 merkittävimmät uudistukset ovat uusi lainhuutohakemusrajapinta sekä mahdollisuus tuoda lukittu luovutuskirja. Uudistuksessa on myös skeemojen yhtenäistämistä ja yleisiä laajennuksia, jotka vaikuttavat osittain kaikkiin asiakirjoihin.

• Lahettaja-elementti sisällytetään jatkossa sopimustietoihin, elementti poistuu perustiedoista.
• Henkilö- ja yritystyyppeihin on lisätty mahdollisuus määrittää ulkomaalaisia toimijoita. Skeemamuutos vaikuttaa kuitenkin kaikkiin asiakirjoihin, mutta käytössä tässä vaiheessa ainoastaan lainhuutohakemuksessa.
• pk:SaajaTyyppi on nimetty uudelleen: pk:OsapuoliTyyppi, muutos vaikuttaa kaikkiin asiakirjoihin.
• Response skeemaan lisätty lähdehakemustunnus (Lahdehakemustunnus elementti), käytössä tässä vaiheessa ainoastaan lainhuutohakemuksessa.

Uusien palveluiden kuvaukset löytyvät:

• Lainhuutohakemus-rajapinnan kuvaus

Uuden version käyttöönotolle annetaan siirtymäaika, jonka aikana rajapinnan versio 2 on käytössä normaalisti. Rajapinnan versio 1 poistuu käytöstä. Selkeyden vuoksi uuden rajapinnan skeemoissa on siirtty v3 nimiavaruuteen.

Versio 2 yhteenveto

Asiakirjarajapintapalvelun versiossa 2 merkittävimmät uudistukset ovat asiakirjojen tilakyselyn ja valmiiden asiakirjojen lataamisen laajeneminen kaikille asiakirjarajapinnasta lähetettäville asiakirjoille. Lisäksi luovutuksen peruskomponentit poistuu ja elementit on siirretty kaikkien asioiden yhteiseen peruskomponentit-skeemaan.

Uusien palveluiden kuvaukset löytyvät:

• Asiakirjan tila-rajapinnan kuvaus
• Valmiiden asiakirjojen latausrajapinnan kuvaus

Uuden version käyttöönotolle annetaan siirtymäaika, jonka aikana rajapinnan versio 1 on käytössä normaalisti. Selkeyden vuoksi uuden rajapinnan skeemoissa on siirtty v2 nimiavaruuteen.Toiminnallisia muutoksia on kuitenkin vähän, pääasiassa kyseessä on palveluiden laajentaminen. Alustavat versiot uusista skeemoista on saatavilla tällä sivustolla.

Asiakirjaluonnostelurajapinta - Kiinnityshakemus

Tuotekuvaus

1. Yleiskuvaus

Rajapinnan kautta palveluun voidaan tuoda uusi kiinnityshakemusluonnos hyväksyntää varten.

Hakemus voidaan ilmoittaa lukituksi, jolloin KVP:ssä ei sallita muutoksia hakemukseen, ainoastaan sen hyväksyminen tai poistaminen. Lukituksi merkityltä luonnokselta edellytetään kaikkien (myös vapaaehtoisten) tietojen toimittamista rajapinnasta.

Asiakirjan lähettäjä voi myös ilmoittaa ottavansa maksettavakseen kiinnityshakemusmaksun sekä rekisteriotteita. Maksut veloitetaan lähettäjältä seuraavan laskutuksen yhteydessä voimassa olevan hinnaston mukaisesti. Veloitus tapahtuu kun hakemus allekirjoitetaan valmiiksi.

Rajapinnan kautta lähetettyä kiinnityshakemusluonnosta voidaan päivittää lähettämällä uusi versio siitä niin kauan, kunnes asiakirjan vastaanottaja on sen KVP:ssä vastaanottanut. Tämän jälkeen on mahdollista lähettää ainoastaan uusi asiakirjaluonnos.

Kiinnityshakemuksille voi tehdä tilakyselyitä ja ladata valmiit asiakirjat.

21.2.2018 alkaen mahdollista lähettää yhteiskiinnityshakemus (v6).

20.3.2019 alkaen (v9) kuolinpesä voi toimia kiinnityksen hakijana. Kuolinpesällä tulee olla lainhuuto tai selvennyslainhuuto kohteeseen joka halutaan kiinnittää. Kaikki kuolinpesän osakkaat tulee ilmoittaa rajapinnassa. Kuolinpesän osakkaiden tulee olla elossa ja täysi-ikäisiä, eivätkä he voi olla holhouksessa. Yksi kuolinpesän osakkaista ilmoitetaan luonnoksen vastaanottajaksi.

2. Sanoma

Kiinnityshakemuksen tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Päivitys tehdään HTTP PUT-metodilla. Kiinnityshakemuksen päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

3. Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • KVPn antama tunnus kiinnityshakemukselle.
• AsiakirjaOsoite
  • URL, johon päivitetty kiinnityshakemus lähetetään.
• AsiakirjaTilaOsoite
  • URL, joka palauttaa kiinnityshakemuksen tilaan liittyviä tietoja.
• EsikatseluOsoite
  • URL, josta voi ladata esikatselu-PDF:n lähetetystä hakemuksesta.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Skeema v14

Käsitemalli

Skeemat kansio kiinnityshakemusrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemusesimerkki

Vastaus

Esimerkki kiinnityshakemusluonnoksen vastauksesta

Skeema v13

v13 skeemaan tulee päivitys 2.3.2022, jolloin julkaistaan seuraavat muutokset:

• Asiamiehen osoitetiedot, Postiosoite- elementti, on muutettu vapaaehtoiseksi.

+    <!--Optional:-->
       <yle:Postiosoite>

Käsitemalli

Skeemat kansio kiinnityshakemusrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemusesimerkki

Vastaus

Esimerkki kiinnityshakemusluonnoksen vastauksesta

Skeema v12 17.2.2021

Kiinnityshakemusrajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

Käsitemalli

Skeemat kansio kiinnityshakemusrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemusesimerkki

Vastaus

Esimerkki kiinnityshakemusluonnoksen vastauksesta

Skeema v11 19.2.2020

Kiinnityshakemusrajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

Käsitemalli

Skeemat kansio kiinnityshakemusrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemusesimerkki

Vastaus

Esimerkki kiinnityshakemusluonnoksen vastauksesta

Skeema v10 12.6.2019

Kiinnityshakemusrajapinnan skeemaversio 10, joka viedään tuotantoon 12.6.2019.

Versiomuutoksen lisäksi ei muita muutoksia v9 ja v10 välillä.

Skeemat kansio kiinnityshakemusrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemusesimerkki

Vastaus

Esimerkki kiinnityshakemusluonnoksen vastauksesta

Skeema v9 20.3.2019

Kiinnityshakemusrajapinnan skeemaversio 9, joka viedään tuotantoon 20.3.2019.

• Mahdollisuus ilmoittaa kuolinpesä kiinnityksen hakijaksi.
• LuonnoksenVastaanottaja-elementti on poistettu Hakija-elementin sisältä. Sen sijaan elementti annetaan vain kerran ja siinä ilmoitetaan vastaanottavan osapuolen henkilö- tai y-tunnus.
• Hakijan Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään.
• Asiamiehen Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään. Puhelinnumero-elementti on siirretty Postiosoite-elementin yläpuolelle.
• Asiamiehen laskutusosoitetta on poistettu. Hakemusmaksu ja mahdolliset rekisteriotemaksut laskutetaan asiakirjan lähettäjältä mikäli HakemusTaiAsiointimaksuLaskulle-elementin arvo on true.

Muutokset Hakijat-elementtiin:

<yle:Hakijat>
  <!--1 or more repetitions:-->
  <yle:Hakija>
-   <!--You have a CHOICE of the next 2 items at this level-->
+   <!--You have a CHOICE of the next 3 items at this level-->
    <yle:Henkilo>
      <yle:Etunimi>string</yle:Etunimi>
      <yle:Sukunimi>string</yle:Sukunimi>
      <yle:YleinenHenkilotunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-       <yle:UlkomainenHenkilotunniste>
-         <yle:SyntymaAika>2008-09-29</yle:SyntymaAika>
-         <!--Optional:-->
-         <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-       </yle:UlkomainenHenkilotunniste>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
      </yle:YleinenHenkilotunniste>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Henkilo>
    <yle:Yritys>
      <yle:Nimi>string</yle:Nimi>
      <yle:YleinenYritysTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Ytunnus>stringstr</yle:Ytunnus>
-       <yle:UlkomainenYritysTunniste>
-         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-         <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-       </yle:UlkomainenYritysTunniste>
-     </yle:YleinenYritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Yritys>
+   <yle:Kuolinpesa>
+     <yle:Vainaja>
+       <yle:Etunimi>string</yle:Etunimi>
+       <yle:Sukunimi>string</yle:Sukunimi>
+       <yle:YleinenHenkilotunniste>
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+       </yle:YleinenHenkilotunniste>
+     </yle:Vainaja>
+     <yle:Osakkaat>
+       <!--1 or more repetitions:-->
+       <yle:Osakas>
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <yle:Henkilo>
+           <yle:Etunimi>string</yle:Etunimi>
+           <yle:Sukunimi>string</yle:Sukunimi>
+           <yle:YleinenHenkilotunniste>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+           </yle:YleinenHenkilotunniste>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Henkilo>
+         <yle:Yritys>
+           <yle:Nimi>string</yle:Nimi>
+           <yle:YleinenYritysTunniste>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Ytunnus>stringstr</yle:Ytunnus>
+           </yle:YleinenYritysTunniste>
+           <!--Optional:-->
+           <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Yritys>
+       </yle:Osakas>
+     </yle:Osakkaat>
+   </yle:Kuolinpesa>
-   <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-   <yle:LuonnoksenVastaanottaja>true</yle:LuonnoksenVastaanottaja>
  </yle:Hakija>
</yle:Hakijat>
+ <yle:LuonnoksenVastaanottaja>
+   <!--You have a CHOICE of the next 2 items at this level-->
+   <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+   <yle:Ytunnus>stringstr</yle:Ytunnus>
+ </yle:LuonnoksenVastaanottaja>

Skeemat kansio kiinnityshakemusrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemusesimerkki: kuolinpesä hakijana

Vastaus

Esimerkki kiinnityshakemusluonnoksen vastauksesta

Skeema v8 12.12.2018

Kiinnityshakemusrajapinnan skeemaversio 8, joka viedään tuotantoon 12.12.2018.

Ei versiomuutoksen lisäksi muita muutoksia v7 ja v8 välillä.

Skeemat kansio kiinnityshakemusrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemusesimerkki

Vastaus

Esimerkki kiinnityshakemusluonnoksen vastauksesta

Skeema v7 6.6.2018

Kiinnityshakemusrajapinnan skeemaversio 7, joka viedään tuotantoon 6.6.2018.

• Skeemaan lisätty vapaaehtoinen elementti Asiointipakettitunnus. Kiinnityshakemusta ei kuitenkaan vielä versiossa 7 voi lisätä asiointipakettiin.
• KiinnitettavatKohteet -elementti on muuttunut, Kiinteistotunnus-elementtien sijaan sisältää KiinnitettavaKohde-elementtejä (1-n). KiinnitettavaKohde-elementti sisältää Kiinteistotunnus-elementin sekä vapaaehtoisen elementin UuteenMaaraalaan, joka voidaan antaa mikäli kohteesta ollaan kiinnittämässä uutta määräalaa ja hakemus kuuluu asiointipakettiin. UuteenMaaraalaan elementtiä ei kuitenkaan voi vielä versiossa 7 kiinnityshakemuksella käyttää.

Skeemat kansio kiinnityshakemusrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemusesimerkki

Vastaus

Esimerkki kiinnityshakemusluonnoksen vastauksesta

Skeema v6 21.2.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 6, joka viedään tuotantoon 21.2.2018.

Skeemat kansio kiinnityshakemusrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemusesimerkki

Vastaus

Esimerkki kiinnityshakemusluonnoksen vastauksesta

Muutoshistoria

Asiakirjaluonnostelurajapinta - Kiinnityshakemus (valmistelu ennakkoon)

Tuotekuvaus

1. Yleiskuvaus

Kiinnityshakemus (valmistelu ennakkoon) on tarkoitettu niihin tilanteisiin, joissa uusien vakuuksien hakeminen on varmistettava ennen kiinteistökaupan syntymistä. Toisin sanoen Lainhuuto- ja kiinnitysrekisteriin ei kiinnityshakemuksen valmisteluhetkellä ole ostajan nimissä merkittynä vireillä olevaa tai vahvistettua lainhuutoa.

Kiinnityshakemus (valmistelu ennakkoon) voidaan lähettää Kiinteistövaihdannan palvelun asiakirjarajapintaan ostajan allekirjoitettavaksi. Ostaja voi allekirjoittaa hakemuksen ennen kaupan syntymistä. Kiinnityshakemus tulee vireille kuitenkin vasta silloin, kun ostajan lainhuuto on vireillä. Kiinnityksen vireilletulo tapahtuu automaattisesti lainhuudon vireilletulon jälkeen ja sille tehdään automaattisesti Maakaaren edellyttämät tarkistukset.

Kiinnityshakemus (valmistelu ennakkoon) odottaa allekirjoittamisen jälkeen lainhuudon vireilletuloa palvelussamme kolmen kuukauden ajan.

Versiosta v14 alkaen on ollut mahdollista laatia kiinnityshakemus (valmistelu ennakkoon) myös määräosiin.

Kiinnityshakemuksesta (valmistelu ennakkoon) toimitetaan lasku asiakirjan lähettäjälle. Lasku muodostuu vasta kun hakemus tulee vireille.

21.2.2018 (v6) alkaen mahdollista lähettää yhteiskiinnityshakemus (valmistelu ennakkoon).

6.6.2018 alkaen (v7) mahdollista ilmoittaa hakemus asiointipakettiin kuuluvaksi. Asiointipakettiin kuuluvassa kiinnityshakemuksessa (valmistelu ennakkoon) mahdollista kiinnittää uusi määräala.

12.12.2018 alkaen (v8) asiointipakettiin kuuluvassa kiinnityshakemuksessa (valmistelu ennakkoon) mahdollista kiinnittää uusi laitos.

19.2.2020 alkaen (v11) mahdollisuus valita haluaako ottaa hakemusmaksun laskulle vai maksetaanko se käyttöliittymässä.

8.6.2022 alkaen (v14) mahdollisuus tehdä kiinnityshakemys (valmistelu ennakkoon) määräosiin.

2. Sanoma

Kiinnityshakemuksen (valmistelu ennakkoon) tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Asiakirjan päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

3. Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • KVPn antama tunnus kiinnityshakemukselle (valmistelu ennakkoon).
• AsiakirjaOsoite
  • URL, johon päivitetty kiinnityshakemus (valmistelu ennakkoon) lähetetään.
• AsiakirjaTilaOsoite
  • URL, joka palauttaa kiinnityshakemuksen (valmistelu ennakkoon) tilaan liittyviä tietoja.
• EsikatseluOsoite
  • URL, josta voi ladata esikatselu-PDF:n lähetetystä hakemuksesta.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Skeema v14

v14 skeemaan tulee päivitys 8.6.2022, jolloin julkaistaan seuraavat muutokset:

• KiinnitettavatKohteet -elementti korvataan uudella KiinnitettavatKohteetJaOsuudet -elementillä. KiinnitettavaOsuus -elementtiin tulee merkitä koko kiinnitettävä osuus kohteesta mikä pitää sisällään jo olemassa olevat osuudet + voimaan tulevat uudet osuudet.

+  <kiin:KiinnitettavatKohteetJaOsuudet>
+    <!--1 or more repetitions:-->
+    <kiin:KiinnitettavaKohdeJaOsuus>
+      <yle:Kiinteistotunnus>stringstringstrings</yle:Kiinteistotunnus>
+      <!--You have a CHOICE of the next 2 items at this level-->
+      <!--Optional:-->
+      <kiin1:UuteenMaaraalaan>false</kiin1:UuteenMaaraalaan>
+      <!--Optional:-->
+      <kiin1:UuteenLaitokseen>true</kiin1:UuteenLaitokseen>
+      <kiin:KiinnitettavaOsuus>string</kiin:KiinnitettavaOsuus>
+    </kiin:KiinnitettavaKohdeJaOsuus>
+  </kiin:KiinnitettavatKohteetJaOsuudet>

-  <kiin1:KiinnitettavatKohteet>
-    <!--1 or more repetitions:-->
-    <kiin1:KiinnitettavaKohde>
-      <yle:Kiinteistotunnus>stringstringstrings</yle:Kiinteistotunnus>
-      <!--You have a CHOICE of the next 2 items at this level-->
-      <!--Optional:-->
-      <kiin1:UuteenMaaraalaan>false</kiin1:UuteenMaaraalaan>
-      <!--Optional:-->
-      <kiin1:UuteenLaitokseen>true</kiin1:UuteenLaitokseen>
-    </kiin1:KiinnitettavaKohde>
-  </kiin1:KiinnitettavatKohteet>

Käsitemalli

Skeemat kansio kiinnityshakemus_valmistelu_ennakkoon_rajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemus (valmistelu ennakkoon) esimerkki

Vastaus

Esimerkki kiinnityshakemus (valmistelu ennakkoon) vastauksesta

Skeema v13

v13 skeemaan tulee päivitys 2.3.2022, jolloin julkaistaan seuraavat muutokset:

• Asiamiehen osoitetiedot, Postiosoite- elementti, on muutettu vapaaehtoiseksi.

+    <!--Optional:-->
       <yle:Postiosoite>

Käsitemalli

Skeemat kansio kiinnityshakemus_valmistelu_ennakkoon_rajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemus (valmistelu ennakkoon) esimerkki

Vastaus

Esimerkki kiinnityshakemus (valmistelu ennakkoon) vastauksesta

Skeema v12 17.2.2021

Rajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

Skeemat kansio kiinnityshakemus_valmistelu_ennakkoon_rajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemus (valmistelu ennakkoon) esimerkki

Vastaus

Esimerkki kiinnityshakemus (valmistelu ennakkoon) vastauksesta

Skeema v11 19.2.2020

Rajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

Lisätty mahdollisuus valita haluaako ottaa hakemusmaksun laskulle

• Mikäli HakemusTaiAsiointimaksuLaskulle -elementtiä ei anneta tai sen arvo on false, hakemusmaksua ei enää laskuteta lähettäjältä, vaan hakijan tulee maksaa se käyttöliittymässä
• Rekisteriotteita ei ole mahdollista ostaa, vaikka elementti RekisteriotteetLaskulle on skeemassa määritelty
• LaskutuksenViiteTiedot -elementti on LaskulleOtettavatPalvelut -elementin sisällä

-  <!--Optional:-->
-  <yle:LaskutuksenViiteTiedot>
-    <!--Optional:-->
-    <yle:LaskutusKoontiavain>string</yle:LaskutusKoontiavain>
-    <!--Optional:-->
-    <yle:AsiakkaanViite>
-      <!--Optional:-->
-      <yle:Viitteenne>string</yle:Viitteenne>
-      <!--Optional:-->
-      <yle:Tiliointiviite>string</yle:Tiliointiviite>
-      <!--Optional:-->
-      <yle:Tilausnumero>string</yle:Tilausnumero>
-      <!--Optional:-->
-      <yle:Sopimusnumero>string</yle:Sopimusnumero>
-      <!--Optional:-->
-      <yle:TyomaaAvain>string</yle:TyomaaAvain>
-    </yle:AsiakkaanViite>
-  </yle:LaskutuksenViiteTiedot>
+  <!--Optional:-->
+  <yle:_>
+    <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>
+    <!--Optional:-->
+    <yle:RekisteriotteetLaskulle>
+      <!--1 or more repetitions:-->
+      <yle:RekisterioteLaskulle>
+        <yle:KohdeKiinteisto>stringstringstrings</yle:KohdeKiinteisto>
+        <yle:Rekisteriotteet>
+          <!--1 to 4 repetitions:-->
+          <yle:Rekisteriote>LH</yle:Rekisteriote>
+        </yle:Rekisteriotteet>
+      </yle:RekisterioteLaskulle>
+    </yle:RekisteriotteetLaskulle>
+    <!--Optional:-->
+    <yle:LaskutuksenViiteTiedot>
+      <!--Optional:-->
+      <yle:LaskutusKoontiavain>string</yle:LaskutusKoontiavain>
+      <!--Optional:-->
+      <yle:AsiakkaanViite>
+        <!--Optional:-->
+        <yle:Viitteenne>string</yle:Viitteenne>
+        <!--Optional:-->
+        <yle:Tiliointiviite>string</yle:Tiliointiviite>
+        <!--Optional:-->
+        <yle:Tilausnumero>string</yle:Tilausnumero>
+        <!--Optional:-->
+        <yle:Sopimusnumero>string</yle:Sopimusnumero>
+        <!--Optional:-->
+        <yle:TyomaaAvain>string</yle:TyomaaAvain>
+      </yle:AsiakkaanViite>
+    </yle:LaskutuksenViiteTiedot>
+  </yle:LaskulleOtettavatPalvelut>

Käsitemalli

Skeemat kansio kiinnityshakemus_valmistelu_ennakkoon_rajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemus (valmistelu ennakkoon) esimerkki

Vastaus

Esimerkki kiinnityshakemus (valmistelu ennakkoon) vastauksesta

Skeema v10 12.6.2019

Rajapinnan skeemaversio 10, joka viedään tuotantoon 12.6.2019.

Versiomuutoksen lisäksi ei muita muutoksia v9 ja v10 välillä.

Skeemat kansio kiinnityshakemus_valmistelu_ennakkoon_rajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemus (valmistelu ennakkoon) esimerkki

Vastaus

Esimerkki kiinnityshakemus (valmistelu ennakkoon) vastauksesta

Skeema v9 20.3.2019

Rajapinnan skeemaversio 9, joka viedään tuotantoon 20.3.2019. Kiinnityshakemus- ja peruskomponentteihin on tehty muutoksia, jotka vaikuttavat skeemaan.

• Huom. Kuolinpesä ei voi toimia hakijana kiinnityshakemuksella (valmistelu ennakkoon)!
• LuonnoksenVastaanottaja-elementti on poistettu Hakija-elementin sisältä. Sen sijaan elementti annetaan vain kerran ja siinä ilmoitetaan vastaanottavan osapuolen henkilö- tai y-tunnus.
• Hakijan Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään.
• Asiamiehen Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään. Puhelinnumero-elementti on siirretty Postiosoite-elementin yläpuolelle.
• Asiamiehen laskutusosoitetta on poistettu. Hakemusmaksu laskutetaan asiakirjan lähettäjältä.

Skeemat kansio kiinnityshakemus_valmistelu_ennakkoon_rajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemus (valmistelu ennakkoon) esimerkki

Vastaus

Esimerkki kiinnityshakemus (valmistelu ennakkoon) vastauksesta

Skeema v8 12.12.2018

Rajapinnan skeemaversio 8, joka viedään tuotantoon 12.12.2018.

• KiinnitettavaKohde-elementtiin on mahdollista lisätä uusi vapaaehtoinen elementti UuteenLaitokseen, joka voidaan antaa mikäli kohteesta ollaan kiinnittämässä uutta laitosta ja hakemus kuuluu asiointipakettiin.

Skeemat kansio kiinnityshakemus_valmistelu_ennakkoon_rajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemus (valmistelu ennakkoon) esimerkki

Vastaus

Esimerkki kiinnityshakemus (valmistelu ennakkoon) vastauksesta

Skeema v7 6.6.2018

Rajapinnan skeemaversio 7, joka viedään tuotantoon 6.6.2018.

• Skeemaan lisätty vapaaehtoinen elementti Asiointipakettitunnus. Asiointipaketin tunnuksen voi antaa mikäli halutaan kiinnittää uusi määräala tai pidättää määräala. Samassa asiointipaketissa tulee olla vastaava luovutuskirja.
• KiinnitettavatKohteet -elementti on muuttunut, Kiinteistotunnus-elementtien sijaan sisältää KiinnitettavaKohde-elementtejä (1-n). KiinnitettavaKohde-elementti sisältää Kiinteistotunnus-elementin sekä vapaaehtoisen elementin UuteenMaaraalaan, joka voidaan antaa mikäli kohteesta ollaan kiinnittämässä uutta määräalaa ja hakemus kuuluu asiointipakettiin.

Skeemat kansio kiinnityshakemus_valmistelu_ennakkoon_rajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemus (valmistelu ennakkoon) esimerkki

Vastaus

Esimerkki kiinnityshakemus (valmistelu ennakkoon) vastauksesta

Skeema v6 21.2.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 6, joka viedään tuotantoon 21.2.2018.

Skeemat kansio kiinnityshakemus_valmistelu_ennakkoon_rajapinta

Esimerkkitiedostot

Sanoma

Kiinnityshakemus (valmistelu ennakkoon) esimerkki

Vastaus

Esimerkki kiinnityshakemus (valmistelu ennakkoon) vastauksesta

Muutoshistoria

Asiakirjaluonnostelurajapinta - Kiinnitysmuutos

Yleiskuvaus

Kiinnitysmuutosrajapinta mahdollistaa hakemusten lähettämisen Kiinteistövaihdannan palveluun kiinnityksen kuolettamiseksi tai yhteiskiinnityksen purkamiseksi. Tämän rajapinnan kautta voi tehdä hakemuksia silloin, kun niitä koskevat panttikirjat ovat sähköisiä. Hakemukset ovat aina lukittuja eikä niitä voi muokata käyttöliittymässä.

Kiinnityksen muuttamista koskevan hakemuksen yhteydessä on mahdollista antaa pantinhaltijan suostumus kiinnityksen purkamiseksi tai kuolettamiseksi. Suostumus on allekirjoitettava ennen hakemusta. Allekirjoitus voidaan tehdä tunnistusrajapinnan kautta tai käyttöliittymässä.

Hakemuksien tilaa voi tarkastella KVP:n tilarajapinnan kautta.

20.3.2019 alkaen (v9) kuolinpesä voidaan ilmoittaa hakijaksi tai panttikirjan saajaksi kiinnityksen muuttamista koskevissa hakemuksissa. Kaikki kuolinpesän osakkaat tulee ilmoittaa rajapinnassa. Kuolinpesän osakkaiden tulee olla elossa ja täysi-ikäisiä, eivätkä he voi olla holhouksessa. Mikäli kuolinpesä toimii hakijana, yksi kuolinpesän osakkaista ilmoitetaan luonnoksen vastaanottajaksi. Mikäli kuolinpesä on panttikirjan saajana, mutta ei hakijana, kuolinpesälle luodaan automaattisesti suostumus allekirjoitettavaksi asiakirjan lähettämisen yhteydessä.

19.2.2020 alkaen (v11) mahdollisuus valita haluaako ottaa yhteiskiinnityksen purkamisen hakemusmaksun lähettäjän laskulle vai maksetaanko hakemusmaksu käyttöliittymässä (kiinnityksen kuolettamishakemus on ilmainen).

Hakemus kiinnityksen kuolettamisesta

Kiinnityksen kuolettamista haetaan mm. silloin kun kiinnitys ei ole enää lainan vakuutena. Kiinnityksen kuolettamista haetaan myös esimerkiksi silloin, kun lainan määrä on suurempi ja aikaisemmat vahvistetut kiinnitykset ovat rahamäärältään niin pieniä, että ne kannattaa kuolettaa ja vahvistaa uusi kiinnitys. Kiinnityksen kuolettamista voi hakea omistaja. Silloin kun kyseessä on yhteiskiinnitys tai kohteella on useampi osaomistaja, kaikkien omistajien tulee toimia hakijoina. Pantinhaltijan sen sijaan on annettava suostumus kiinnityksen kuolettamiseksi. Toiminto käsittää nykyisellään ainoastaan kiinnityksen kuolettamisen kokonaan. Kiinnityksen kuolettamishakemus on ilmainen.

Käyttötapaus

1. Pankkitoimihenkilö toimittaa lukitun kiinnityksen kuolettamishakemuksen asiakirjarajapinnan kautta vastaanottajaksi merkitylle hakijalle.
2. Sähköisen panttikirjan saajaksi merkitty antaa suostumuksen allekirjoittamalla tunnistusrajapinnan kautta. (Suostumusta ei tarvita, mikäli panttikirjan saajaksi on merkitty kiinteistön omistaja).
3. Jokaisen saajaksi merkityn tahon on annettava suostumus.
4. Hakija (kiinteistön omistaja) voi allekirjoittaa hakemuksen.
5. Hakemus tulee vireille Lainhuuto- ja kiinnitysrekisteriin.

Yhteiskiinnityksen purkaminen

Yhteiskiinnityksen purkamista voi hakea kiinteistön omistaja tai pantin saaja. (Huom.: mikäli kiinnityksiä puretaan useamman panttikirjan osalta, tulee niiden keskinäiset kohteet olla samat. Muutoin tulee jokaisen tapauksen osalta tehdä oma hakemuksensa). Hakemuksesta toimitetaan lasku hakemuksen lähettäjälle.

Yhteiskiinnityksen purkamishakemuksia on mahdollista lähettää kesäkuusta 2018 alkaen (v7).

Sanoma

Hakemuksen tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Päivitys tehdään HTTP PUT-metodilla. Hakemuksen päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • KVPn antama tunnus kiinnitysmuutoshakemukselle.
• AsiakirjaOsoite
  • URL, johon päivitetty kiinnitysmuutoshakemus lähetetään.
• AsiakirjaTilaOsoite
  • URL, joka palauttaa kiinnitysmuutoshakemuksen tilaan liittyviä tietoja.
• EsikatseluOsoite
  • URL, josta voi ladata esikatselu-PDF:n lähetetystä hakemuksesta.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Skeema v14

Käsitemalli

Skeemat kansio Kiinnitysmuutosrajapinta

Esimerkkitiedostot

Sanoma

Yhteiskiinnityksen purkaminen

Kiinnityksen kuolettaminen

Vastaus

Esimerkkivastaus

Skeema v13

v13 skeemaan tulee päivitys 2.3.2022, jolloin julkaistaan seuraavat muutokset:

• Asiamiehen osoitetiedot, Postiosoite- elementti, on muutettu vapaaehtoiseksi.

+    <!--Optional:-->
       <yle:Postiosoite>

Käsitemalli

Skeemat kansio Kiinnitysmuutosrajapinta

Esimerkkitiedostot

Sanoma

Yhteiskiinnityksen purkaminen

Kiinnityksen kuolettaminen

Vastaus

Esimerkkivastaus

Skeema v12 17.2.2021

Kiinnitysmuutosrajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

Käsitemalli

Skeemat kansio Kiinnitysmuutosrajapinta

Esimerkkitiedostot

Sanoma

Yhteiskiinnityksen purkaminen

Kiinnityksen kuolettaminen

Vastaus

Esimerkkivastaus

Skeema v11 19.2.2020

Kiinnitysmuutosrajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

Lisätty mahdollisuus valita haluaako ottaa yhteiskiinnityksen purkamisen hakemusmaksun laskulle.

• Mikäli HakemusTaiAsiointimaksuLaskulle -elementtiä ei anneta tai sen arvo on false, hakemusmaksua ei enää laskuteta lähettäjältä, vaan hakijan tulee maksaa se käyttöliittymässä
• Rekisteriotteita ei ole mahdollista ostaa, vaikka elementti RekisteriotteetLaskulle on skeemassa määritelty
• LaskutuksenViiteTiedot -elementti on LaskulleOtettavatPalvelut -elementin sisällä

-  <!--Optional:-->
-  <yle:LaskutuksenViiteTiedot>
-    <!--Optional:-->
-    <yle:LaskutusKoontiavain>string</yle:LaskutusKoontiavain>
-    <!--Optional:-->
-    <yle:AsiakkaanViite>
-      <!--Optional:-->
-      <yle:Viitteenne>string</yle:Viitteenne>
-      <!--Optional:-->
-      <yle:Tiliointiviite>string</yle:Tiliointiviite>
-      <!--Optional:-->
-      <yle:Tilausnumero>string</yle:Tilausnumero>
-      <!--Optional:-->
-      <yle:Sopimusnumero>string</yle:Sopimusnumero>
-      <!--Optional:-->
-      <yle:TyomaaAvain>string</yle:TyomaaAvain>
-    </yle:AsiakkaanViite>
-  </yle:LaskutuksenViiteTiedot>
+  <!--Optional:-->
+  <yle:_>
+    <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>
+    <!--Optional:-->
+    <yle:RekisteriotteetLaskulle>
+      <!--1 or more repetitions:-->
+      <yle:RekisterioteLaskulle>
+        <yle:KohdeKiinteisto>stringstringstrings</yle:KohdeKiinteisto>
+        <yle:Rekisteriotteet>
+          <!--1 to 4 repetitions:-->
+          <yle:Rekisteriote>LH</yle:Rekisteriote>
+        </yle:Rekisteriotteet>
+      </yle:RekisterioteLaskulle>
+    </yle:RekisteriotteetLaskulle>
+    <!--Optional:-->
+    <yle:LaskutuksenViiteTiedot>
+      <!--Optional:-->
+      <yle:LaskutusKoontiavain>string</yle:LaskutusKoontiavain>
+      <!--Optional:-->
+      <yle:AsiakkaanViite>
+        <!--Optional:-->
+        <yle:Viitteenne>string</yle:Viitteenne>
+        <!--Optional:-->
+        <yle:Tiliointiviite>string</yle:Tiliointiviite>
+        <!--Optional:-->
+        <yle:Tilausnumero>string</yle:Tilausnumero>
+        <!--Optional:-->
+        <yle:Sopimusnumero>string</yle:Sopimusnumero>
+        <!--Optional:-->
+        <yle:TyomaaAvain>string</yle:TyomaaAvain>
+      </yle:AsiakkaanViite>
+    </yle:LaskutuksenViiteTiedot>
+  </yle:LaskulleOtettavatPalvelut>

Käsitemalli

Skeemat kansio Kiinnitysmuutosrajapinta

Esimerkkitiedostot

Sanoma

Yhteiskiinnityksen purkaminen

Kiinnityksen kuolettaminen

Vastaus

Esimerkkivastaus

Skeema v10 12.6.2019

Skeeman mukautus asiakirjarajapinnan skeemaversioon 10, joka viedään tuotantoon 12.6.2019.

• Suostujat ja Suostuja -elementit on siirretty peruskomponentteihin.

<!--Optional:-->
-<kiin:Suostujat>
+<yle:Suostujat>
  <!--1 or more repetitions:-->
- <kiin:Suostuja>
+ <yle:Suostuja>
    <!--You have a CHOICE of the next 2 items at this level-->
    <yle:Henkilo>
      <yle:Etunimi>string</yle:Etunimi>
      <yle:Sukunimi>string</yle:Sukunimi>
      <yle:YleinenHenkilotunniste>
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
      </yle:YleinenHenkilotunniste>
      <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Henkilo>
    <yle:Yritys>
      <yle:Nimi>string</yle:Nimi>
      <yle:YleinenYritysTunniste>
        <yle:Ytunnus>stringstr</yle:Ytunnus>
      </yle:YleinenYritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
      <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Yritys>
- </kiin:Suostuja>
+ </yle:Suostuja>
-</kiin:Suostujat>
+</yle:Suostujat>

Skeemat kansio Kiinnitysmuutosrajapinta

Esimerkkitiedostot

Sanoma

Yhteiskiinnityksen purkaminen

Kiinnityksen kuolettaminen

Vastaus

Esimerkkivastaus

Skeema v9 20.3.2019

• Mahdollisuus ilmoittaa kuolinpesä kiinnitysmuutoksen hakijaksi tai panttikirjan saajaksi.
• LuonnoksenVastaanottaja-elementti on poistettu Hakija-elementin sisältä. Sen sijaan elementti annetaan vain kerran ja siinä ilmoitetaan vastaanottavan osapuolen henkilö- tai y-tunnus.
• Hakijan Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään.
• Asiamiehen Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään. Puhelinnumero-elementti on siirretty Postiosoite-elementin yläpuolelle.
• Asiamiehen laskutusosoitetta on poistettu. Hakemusmaksu laskutetaan asiakirjan lähettäjältä.

<yle:Hakijat>
  <!--1 or more repetitions:-->
  <yle:Hakija>
-   <!--You have a CHOICE of the next 2 items at this level-->
+   <!--You have a CHOICE of the next 3 items at this level-->
    <yle:Henkilo>
      <yle:Etunimi>string</yle:Etunimi>
      <yle:Sukunimi>string</yle:Sukunimi>
      <yle:YleinenHenkilotunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-       <yle:UlkomainenHenkilotunniste>
-         <yle:SyntymaAika>2008-09-29</yle:SyntymaAika>
-         <!--Optional:-->
-         <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-       </yle:UlkomainenHenkilotunniste>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
      </yle:YleinenHenkilotunniste>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Henkilo>
    <yle:Yritys>
      <yle:Nimi>string</yle:Nimi>
      <yle:YleinenYritysTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Ytunnus>stringstr</yle:Ytunnus>
-       <yle:UlkomainenYritysTunniste>
-         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-         <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-       </yle:UlkomainenYritysTunniste>
-     </yle:YleinenYritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Yritys>
+   <yle:Kuolinpesa>
+     <yle:Vainaja>
+       <yle:Etunimi>string</yle:Etunimi>
+       <yle:Sukunimi>string</yle:Sukunimi>
+       <yle:YleinenHenkilotunniste>
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+       </yle:YleinenHenkilotunniste>
+     </yle:Vainaja>
+     <yle:Osakkaat>
+       <!--1 or more repetitions:-->
+       <yle:Osakas>
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <yle:Henkilo>
+           <yle:Etunimi>string</yle:Etunimi>
+           <yle:Sukunimi>string</yle:Sukunimi>
+           <yle:YleinenHenkilotunniste>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+           </yle:YleinenHenkilotunniste>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Henkilo>
+         <yle:Yritys>
+           <yle:Nimi>string</yle:Nimi>
+           <yle:YleinenYritysTunniste>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Ytunnus>stringstr</yle:Ytunnus>
+           </yle:YleinenYritysTunniste>
+           <!--Optional:-->
+           <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Yritys>
+       </yle:Osakas>
+     </yle:Osakkaat>
+   </yle:Kuolinpesa>
-   <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-   <yle:LuonnoksenVastaanottaja>true</yle:LuonnoksenVastaanottaja>
  </yle:Hakija>
</yle:Hakijat>
+ <yle:LuonnoksenVastaanottaja>
+   <!--You have a CHOICE of the next 2 items at this level-->
+   <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+   <yle:Ytunnus>stringstr</yle:Ytunnus>
+ </yle:LuonnoksenVastaanottaja>

Skeemat kansio Kiinnitysmuutosrajapinta

Esimerkkitiedostot

Sanoma

Yhteiskiinnityksen purkaminen (kuolinpesä panttikirjan saajana)

Kiinnityksen kuolettaminen (kuolinpesä panttikirjan saajana)

Vastaus

Esimerkkivastaus

Skeema v8 12.12.2018

• Skeemaan lisätty vapaaehtoinen elementti LaskutuksenViiteTiedot.
  • Yhteiskiinnityksen purkamishakemuksen mennessä vireille muodostuu siitä 1.1.2019 alkaen lähettäjälle hakemusmaksun sisältävä lasku. Lähettäjä voi halutessaan kertoa tällä elementillä tarkempia laskutukseen liittyviä tietoja.

Skeemat kansio Kiinnitysmuutosrajapinta

Esimerkkitiedostot

Sanoma

Yhteiskiinnityksen purkaminen

Kiinnityksen kuolettaminen

Vastaus

Esimerkkivastaus

Skeema v7 6.6.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 7, joka viedään tuotantoon 6.6.2018.

Skeemat kansio Kiinnitysmuutosrajapinta

Esimerkkitiedostot

Sanoma

Yhteiskiinnityksen purkaminen

Kiinnityksen kuolettaminen

Vastaus

Esimerkkivastaus

Skeema v6 21.02.2018

Tämä on skeeman ensimmäinen versio, joka viedään tuotantoon 21.02.2018.

Skeemat kansio Kiinnitysmuutosrajapinta

Esimerkkitiedostot

Sanoma

Kiinnityksen kuolettaminen

Vastaus

Esimerkkivastaus

Muutoshistoria

Asiakirjarajapinta - Lainhuutohakemus

1. Yleiskuvaus

Rajapinnan kautta voidaan toimittaa Maanmittauslaitokselle valmis kirjallinen lainhuuto- tai erityisen oikeuden siirtohakemus. Myös selvennyslainhuuto on mahdollista toimittaa. Rajapinnan kautta toimitetaan hakemuksen kaikki tiedot rakenteellisena käsittelyn nopeuttamiseksi.

Hakemus menee suoraan vireille liitetiedostojen toimittamisen jälkeen jos tiedoissa ei havaita ongelmia. Liitetiedostojen sallitut tiedostomuodot ovat pdf ja jpg.

Versiossa 6 elementti HakemusPDFLiite on muutettu vapaaehtoiseksi. Jos HakemusPDFLiite-elementtiä eikä muitakaan Liitetiedosto-elementtejä ole, hakemus menee suoraan vireille ilman liitetiedostojen toimittamista.

Versiosta 7 lähtien hakemukselle voidaan antaa VainEsikatselu-elementti, jolloin lähetettyä hakemusta ei laiteta vireille, mutta sen esikatselu-pdf:n voi ladata rajapinnan palauttamasta esikatseluosoitteesta.

Versiossa 11 (02/2020) uusina ominaisuuksina:

• Kuolinpesä voi olla luovuttajana tai saajana
• Mahdollisuus ilmoittaa lisätietoja hakemukselle.

06/2020 Saantolajit 20 ja 21 estetty (luovutuksen purkautuminen ja esisopimus). Eivät sovellu käytettäväksi tässä rajapinnassa. Muutos koskee kaikkia rajapintaversioita.

06/2020 alkaen on mahdollista lähettää vapaaehtoinen elementti LaskutusKoontiavain. Muutos koskee kaikkia tuettuja rajapintaversioita.

Valmiin hakemuksen liitteineen voi ladata zip-tiedostona.

2. Sanoma

Hakemuksen tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Päivitys tehdään HTTP PUT-metodilla. Hakemuksen päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

Lainhuutohakemussanomaan merkityt liitetiedostot tulee lähettää vastaussanomassa välitettyyn URL-osoitteeseen pakattuna yhteen ZIP-tiedostoon HTTP POST-metodia käyttäen. Content-type "application/zip".

3. Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • Asiakirjarajapintapalvelun antama tunnus lainhuutohakemukselle.
• AsiakirjaOsoite
  • URL, johon päivitetty asiakirjaluonnos tulee lähettää (alkaen v7). Päivitys on mahdollista vain mikäli ensin on lähetty hakemus jossa VainEsikatselu-elementti (arvona true).
• AsiakirjaTilaOsoite
  • URL, joka palauttaa lainhuutohakemuksen tilaan liittyviä tietoja.
• LiitetiedostoOsoite
  • URL, johon lainhuutohakemukseen liittyvät liitetiedostot lähetetään ZIP-paketissa. URL-osoitteen loppuun tulee lisätä parametri ytunnus (arvoksi tulee lähettäjän y-tunnus).
• EsikatseluOsoite
  • URL, josta voi ladata esikatselu-PDF:n lähetetystä hakemuksesta.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Skeema v14 (päivityksiä 7.6.2023)

7.6.2023 julkaistavassa päivityksestä hakemuksen liitetiedostoille on lisätty vapaaehtoinen elementti AsiakirjanLuontiPvm. Lisäksi LiitetiedostoLajit ovat päivittyneet: koodi 11 (Perinnönjakokirja) on poistunut, koodi 51 (Ositus- ja perinnönjakosopimus) on tullut uutena. Lisäksi muutaman liitetiedostolajin nimeäminen on muuttunut (koodit 07, ja 27).

  <yle:MaaraalanKuva>
    <yle:Nimi>string</yle:Nimi>
    <!--Optional:-->
    <yle:Kuvaus>string</yle:Kuvaus>
    <yle:InternetMediaType>string</yle:InternetMediaType>
    <yle:LiitetiedostoLaji>string</yle:LiitetiedostoLaji>
+   <!--Optional:-->
+   <yle:AsiakirjanLuontiPvm>2008-11-15</yle:AsiakirjanLuontiPvm>
  </yle:MaaraalanKuva>

  <lain:HakemusPDFLiite>
    <lain:Hakemustiedosto>
      <lain:Nimi>string</lain:Nimi>
      <lain:InternetMediaType>string</lain:InternetMediaType>
+     <!--Optional:-->
+     <lain:AsiakirjanLuontiPvm>2015-11-05</lain:AsiakirjanLuontiPvm>
    </lain:Hakemustiedosto>
  </lain:HakemusPDFLiite>

  <lain:Liitetiedosto>
    <lain:Nimi>string</lain:Nimi>
    <lain:InternetMediaType>string</lain:InternetMediaType>
+   <!--Optional:-->
+   <lain:AsiakirjanLuontiPvm>2000-07-29</lain:AsiakirjanLuontiPvm>
    <lain:LiitetiedostoLaji>string</lain:LiitetiedostoLaji>
  </lain:Liitetiedosto>

- 07 Jakautumissuunnitelma
+ 07 Sopimus yhtiömuodon muutoksesta
  08 Perinnönjakosopimus
  09 Perinnöstä luopumisilmoitus
  10 Ositus
- 11 Perinnönjakokirja

- 27 Kauppahinnan maksukuitti
+ 27 Maksukuitti
  28 Maaoikeuden päätös
  29 KKO:n päätös
+ 51 Ositus- ja perinnönjakosopimus

Käsitemalli

Skeemat kansio lainhuutohakemusrajapinta

Esimerkkitiedostot

Sanoma

Lainhuutohakemusesimerkki

Vastaus

Esimerkki lainhuutohakemuksen vastauksesta

Skeema v13 (julkaisu 13.12.2021, päivityksiä 2.3.2022)

Lainhuutohakemusrajapinnan skeemaversio 13, joka viedään tuotantoon 13.12.2021.

• Selvennyslainhuudon kanssa ei käytetä enää Saanto -elementtiä, vaan sen sijaan uutta SelvennyslainhuudonPeruste -elementtiä.
• Saanto -elementin SaantoPvm -elementti on tästedes taas pakollinen.
• AsiaKieli -elementti ei ole enää LainhuutohakemuksenTiedot-elementin alla vaan LainhuutohakemuksenPerusTiedot-elementin alla

-                        <xs:element name="Saanto" minOccurs="1" >
+                        <xs:element name="SelvennyslainhuudonPeruste" minOccurs="0">
+                                <xs:annotation>
+                                        <xs:documentation xml:lang="fi">
+                                                Selvennyslainhuudon peruste:
+                                                2 Sulautuminen
+                                                3 Yhtiön jakautuminen
+                                                4 Nimen muutos1
+                                                5 Ehdollisen luovutuksen purkaminen
+                                                6 Muu peruste
+                                                7 Omalle varalle lohkominen
+                                                8 Aikaisempi omistus
+                                                10 Kiinteistötoimitus
+                                                12 Yhtiömuodon muutos
+                                        </xs:documentation>
+                                        <xs:documentation xml:lang="x-example">LA</xs:documentation>
+                                </xs:annotation>
+                                <xs:simpleType>
+                                        <xs:union>
+                                                <xs:simpleType>
+                                                        <xs:restriction base="pk:PositiivinenNumeroTyyppi">
+                                                                <xs:minInclusive value="2" />
+                                                                <xs:maxInclusive value="8" />
+                                                        </xs:restriction>
+                                                </xs:simpleType>
+                                                <xs:simpleType>
+                                                        <xs:restriction base="pk:PositiivinenNumeroTyyppi">
+                                                                <xs:enumeration value="10" />
+                                                                <xs:enumeration value="12" />
+                                                        </xs:restriction>
+                                                </xs:simpleType>
+                                        </xs:union>
+                                </xs:simpleType>
+                        </xs:element>
+
+                        <xs:element name="Saanto" minOccurs="0" >

-                                                <xs:element name="SaantoPvm" type="xs:date" minOccurs="0" maxOccurs="1"/>
+                                                <xs:element name="SaantoPvm" type="xs:date" minOccurs="1" maxOccurs="1"/>

v13 skeemaan tulee päivitys 2.3.2022, jolloin julkaistaan seuraavat muutokset:

• Uusi vapaaehtonen elementti Laskutustiedot, tämä elementti on tarkoitettu vain Maanmittauslaitoksen sisäiseen käyttöön.
• Asiamiehen osoitetiedot, Postiosoite- ja Laskutusosoite, on muutettu vapaaehtoiseksi.

+    <!--Optional:-->
+      <yle:Laskutustiedot>
+        <yle:Maksu>VERKKOMAKSU</yle:Maksu>
+        <yle:Tilausnumero>string</yle:Tilausnumero>
+        <yle:TuoteTunnus>string</yle:TuoteTunnus>
+        <yle:MaksettuSumma>1000.00</yle:MaksettuSumma>
+    </yle:Laskutustiedot>

+    <!--Optional:-->
       <yle:Postiosoite>

+    <!--Optional:-->
       <lain:Laskutusosoite>

Käsitemalli

Skeemat kansio lainhuutohakemusrajapinta

Esimerkkitiedostot

Sanoma

Lainhuutohakemusesimerkki

Vastaus

Esimerkki lainhuutohakemuksen vastauksesta

Skeema v12 17.2.2021

Päivitys skeemaversioon 12, joka viedään tuotantoon kesäkuussa 2021.

• SaantoPvm -elementti on tästedes vapaaehtoinen. Elementtiä ei vaadita selvennyslainhuudolle, jossa saannon tyyppi on 27 (aikaisempi omistus).

-      <xs:element name="SaantoPvm" type="xs:date" />
+      <xs:element name="SaantoPvm" type="xs:date" minOccurs="0" maxOccurs="1"/>

• Kuolinpesän Vainaja -elementtiin on mahdollista antaa KuolinPvm -elementti, jos vainaja on ulkomaalainen henkilö ilman suomalaista henkilötunnusta.

+    <xs:complexType name="VainajaTyyppi">
+      <xs:complexContent>
+        <xs:extension base="HenkiloTyyppi">
+          <xs:sequence>
+            <xs:element name="KuolinPvm" type="xs:date" minOccurs="0" maxOccurs="1" />
+          </xs:sequence>
+        </xs:extension>
+      </xs:complexContent>
+    </xs:complexType>

-           <xs:element name="Vainaja" type="HenkiloTyyppi" minOccurs="1" maxOccurs="1" />
+           <xs:element name="Vainaja" type="VainajaTyyppi" minOccurs="1" maxOccurs="1" />

Lainhuutohakemusrajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

• SaantoLaji -elementiltä on poistettu koodit 20 (Luovutuksen purkautuminen) ja 21 (Esisopimus).
• LainhuutohakemuksenTiedot ja sen sisältämä elementti AsiaKieli ovat muuttuneet pakollisiksi.
• Yleinen LaskutuksenViiteTiedot -elementti korvaa LaskutusKoontiavain - ja AsiakkaanViite -elementit.

- <!--Optional:-->
  <lain:LainhuutohakemuksenTiedot>
    <!--Optional:-->
    <yle:VainEsikatselu>false</yle:VainEsikatselu>
-   <!--Optional:-->
    <yle:AsiaKieli>sv</yle:AsiaKieli>
    <!--Optional:-->
    <lain:HakemuksessaTurvakiellonAlaisiaYhteystietoja>true</lain:HakemuksessaTurvakiellonAlaisiaYhteystietoja>
    <!--Optional:-->
    <lain:Liitteet>
      <!--1 or more repetitions:-->
      <lain:Liitetiedosto>
        <lain:Nimi>string</lain:Nimi>
        <lain:InternetMediaType>string</lain:InternetMediaType>
        <lain:LiitetiedostoLaji>string</lain:LiitetiedostoLaji>
      </lain:Liitetiedosto>
    </lain:Liitteet>
    <!--Optional:-->
    <lain:HakemuksenLisatiedot>string</lain:HakemuksenLisatiedot>
  </lain:LainhuutohakemuksenTiedot>

-<!--Optional:-->
-<lain:LaskutusKoontiavain>string</lain:LaskutusKoontiavain>
-<!--Optional:-->
-<yle:AsiakkaanViite>
-  <!--Optional:-->
-  <yle:Viitteenne>string</yle:Viitteenne>
-  <!--Optional:-->
-  <yle:Tiliointiviite>string</yle:Tiliointiviite>
-  <!--Optional:-->
-  <yle:Tilausnumero>string</yle:Tilausnumero>
-  <!--Optional:-->
-  <yle:Sopimusnumero>string</yle:Sopimusnumero>
-  <!--Optional:-->
-  <yle:TyomaaAvain>string</yle:TyomaaAvain>
-</yle:AsiakkaanViite>
+<!--Optional:-->
+<yle:LaskutuksenViiteTiedot>
+  <!--Optional:-->
+  <yle:LaskutusKoontiavain>string</yle:LaskutusKoontiavain>
+  <!--Optional:-->
+  <yle:AsiakkaanViite>
+    <!--Optional:-->
+    <yle:Viitteenne>string</yle:Viitteenne>
+    <!--Optional:-->
+    <yle:Tiliointiviite>string</yle:Tiliointiviite>
+    <!--Optional:-->
+    <yle:Tilausnumero>string</yle:Tilausnumero>
+    <!--Optional:-->
+    <yle:Sopimusnumero>string</yle:Sopimusnumero>
+    <!--Optional:-->
+    <yle:TyomaaAvain>string</yle:TyomaaAvain>
+  </yle:AsiakkaanViite>
+</yle:LaskutuksenViiteTiedot>

Käsitemalli

Skeemat kansio lainhuutohakemusrajapinta

Esimerkkitiedostot

Sanoma

Lainhuutohakemusesimerkki

Vastaus

Esimerkki lainhuutohakemuksen vastauksesta

Skeema v11 19.2.2020

Lainhuutohakemusrajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

• Kotimaakoodi on korvattu Kansalaisuuskoodi-elementillä ja se vaaditaan ulkomaalaisilta henkilöiltä ja yrityksiltä
• Henkilotunniste- ja Yritystunniste-elementit on poistettu Henkilotunnus/UlkomainenHenkilotunniste ja Ytunnus/UlkomainenYritysTunniste-elementtien ympäriltä
• Luovuttajan osuus on vapaaehtoinen
• Kuolinpesä voi toimia hakijana ja luovuttajana. LuovutuksenSaaja- ja Osapuoli-elementeissä on vaihtoehtoina Henkilö ja Yritys sekä uutena Kuolinpesa-elementti.

+<lain:Kuolinpesa>
+  <lain:Vainaja>
+    <yle:Etunimi>string</yle:Etunimi>
+    <yle:Sukunimi>string</yle:Sukunimi>
+    <!--You have a CHOICE of the next 2 items at this level-->
+    <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+    <lain:UlkomainenHenkilotunniste>
+      <lain:SyntymaAika>2013-05-22+03:00</lain:SyntymaAika>
+      <yle:Kansalaisuuskoodi>se</yle:Kansalaisuuskoodi>
+      <!--Optional:-->
+      <lain:UlkomainenHenkilotunnus>string</lain:UlkomainenHenkilotunnus>
+    </lain:UlkomainenHenkilotunniste>
+  </lain:Vainaja>
+  <lain:Osakkaat>
+    <!--1 or more repetitions:-->
+    <lain:Osakas>
+      <!--You have a CHOICE of the next 2 items at this level-->
+      <lain:Henkilo>
+        <yle:Etunimi>string</yle:Etunimi>
+        <yle:Sukunimi>string</yle:Sukunimi>
+        <!--You have a CHOICE of the next 2 items at this level-->
+        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+        <lain:UlkomainenHenkilotunniste>
+          <lain:SyntymaAika>2002-11-05+02:00</lain:SyntymaAika>
+          <yle:Kansalaisuuskoodi>se</yle:Kansalaisuuskoodi>
+          <!--Optional:-->
+          <lain:UlkomainenHenkilotunnus>string</lain:UlkomainenHenkilotunnus>
+        </lain:UlkomainenHenkilotunniste>
+      </lain:Henkilo>
+      <lain:Yritys>
+        <yle:Nimi>string</yle:Nimi>
+        <!--You have a CHOICE of the next 2 items at this level-->
+        <yle:Ytunnus>stringstr</yle:Ytunnus>
+        <lain:UlkomainenYritysTunniste>
+          <yle:Kansalaisuuskoodi>st</yle:Kansalaisuuskoodi>
+          <lain:UlkomainenYtunnus>string</lain:UlkomainenYtunnus>
+        </lain:UlkomainenYritysTunniste>
+        <!--Optional:-->
+        <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+      </lain:Yritys>
+    </lain:Osakas>
+  </lain:Osakkaat>
+</lain:Kuolinpesa>

• Lisätty uusi elementti HakemuksenLisatiedot, jolla voi ilmoittaa lisätietoja hakemuksen käsittelyyn liittyen.
  • Annetut lisätiedot näkyvät järjestelmän generoimassa hakemuksen PDF-tiedostossa.
  • Mikäli hakija lähettää oman hakemus-PDF:n, lisätietoja ei näytetä missään eivätkä ne välity kirjaamisrekisteriin.

+ <!--Optional:-->
+ <lain:HakemuksenLisatiedot>string</lain:HakemuksenLisatiedot>

Käsitemalli

Skeemat kansio lainhuutohakemusrajapinta

Esimerkkitiedostot

Sanoma

Lainhuutohakemusesimerkki

Vastaus

Esimerkki lainhuutohakemuksen vastauksesta

Skeema v10 12.6.2019

Skeeman mukautus asiakirjarajapinnan skeemaversioon 10, joka viedään tuotantoon 12.6.2019.

• LainhuudonHaku ja LainhuudonHakuSelite -elementit on uudelleennimetty.

- <!--Optional:-->
- <yle:LainhuudonHaku>AL</yle:LainhuudonHaku>
- <!--Optional:-->
- <yle:LainhuudonHakuSelite>string</yle:LainhuudonHakuSelite>
+ <!--Optional:-->
+ <yle:KenenLukuun>
+   <yle:KenenLukuunValinta>AL</yle:KenenLukuunValinta>
+   <!--Optional:-->
+   <yle:MuunLukuunSelite>string</yle:MuunLukuunSelite>
+ </yle:KenenLukuun>

Skeemat kansio lainhuutohakemusrajapinta

Esimerkkitiedostot

Sanoma

Lainhuutohakemusesimerkki

Vastaus

Esimerkki lainhuutohakemuksen vastauksesta

Skeema v9 20.3.2019

Rajapinnan skeemaversio 9, joka viedään tuotantoon 20.3.2019.

• Henkilo- ja Yritys-elementit käyttävät lainhuutohakemuksen nimiavaruutta
  • luovuttajan sähköpostiosoite ei ole pakollinen tieto
  • ulkomaalainen osapuoli voi toimia vain lainhuutohakemusrajapinnassa
• Laskutukseen liittyvät elementit on siirretty lainhuutohakemuksen skeemaan peruskomponenteista.
• EtuostolainMukainenVakuutus ja EnsiasunnonOstajanVakuutus elementit on siirretty lainhuutohakemuksen skeemaan peruskomponenteista.

Muutokset LuovutuksenSaaja-elementtiin:

-<yle:LuovutuksenSaaja>
+<lain:LuovutuksenSaaja>
  <!--You have a CHOICE of the next 2 items at this level-->
- <yle:Henkilo>
+ <lain:Henkilo>
    <yle:Etunimi>string</yle:Etunimi>
    <yle:Sukunimi>string</yle:Sukunimi>
-   <yle:YleinenHenkilotunniste>
+   <lain:HenkiloTunniste>
      <!--You have a CHOICE of the next 2 items at this level-->
      <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-     <yle:UlkomainenHenkilotunniste>
-       <yle:SyntymaAika>2006-08-19+03:00</yle:SyntymaAika>
-       <!--Optional:-->
-       <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-     </yle:UlkomainenHenkilotunniste>
+     <lain:UlkomainenHenkilotunniste>
+       <lain:SyntymaAika>2006-08-19+03:00</lain:SyntymaAika>
+       <!--Optional:-->
+       <lain:UlkomainenHenkilotunnus>string</lain:UlkomainenHenkilotunnus>
+     </lain:UlkomainenHenkilotunniste>
      <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-   </yle:YleinenHenkilotunniste>
+   </lain:HenkiloTunniste>
- </yle:Henkilo>
+ </lain:Henkilo>
- <yle:Yritys>
+ <lain:Yritys>
    <yle:Nimi>string</yle:Nimi>
-   <yle:YleinenYritysTunniste>
+   <lain:YritysTunniste>
      <!--You have a CHOICE of the next 2 items at this level-->
      <yle:Ytunnus>stringstr</yle:Ytunnus>
-     <yle:UlkomainenYritysTunniste>
+     <lain:UlkomainenYritysTunniste>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-       <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
+       <lain:UlkomainenYtunnus>string</lain:UlkomainenYtunnus>
-      </yle:UlkomainenYritysTunniste>
+     </lain:UlkomainenYritysTunniste>
-   </yle:YleinenYritysTunniste>
+   </lain:YritysTunniste>
    <!--Optional:-->
    <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
- </yle:Yritys>
+ </lain:Yritys>
  <!--Optional:-->
  <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
  <yle:Osuus>string</yle:Osuus>
  <!--Optional:-->
  <yle:LainhuudonHaku>AL</yle:LainhuudonHaku>
  <!--Optional:-->
  <yle:LainhuudonHakuSelite>string</yle:LainhuudonHakuSelite>
  <!--Optional:-->
- <yle:EtuostolainMukainenVakuutus>true</yle:EtuostolainMukainenVakuutus>
+ <lain:EtuostolainMukainenVakuutus>true</lain:EtuostolainMukainenVakuutus>
  <!--Optional:-->
- <yle:EnsiasunnonOstajanVakuutus>true</yle:EnsiasunnonOstajanVakuutus>
+ <lain:EnsiasunnonOstajanVakuutus>true</lain:EnsiasunnonOstajanVakuutus>
-</yle:LuovutuksenSaaja>
+</lain:LuovutuksenSaaja>

Muutokset LuovutettavaOsuus-elementtiin:

<lain:LuovutettavaOsuus>
  <yle:Osuus>string</yle:Osuus>
  <!--1 or more repetitions:-->
  <lain:Osapuoli>
    <!--You have a CHOICE of the next 2 items at this level-->
-   <yle:Henkilo>
+   <lain:Henkilo>
      <yle:Etunimi>string</yle:Etunimi>
      <yle:Sukunimi>string</yle:Sukunimi>
-     <yle:YleinenHenkilotunniste>
+     <lain:HenkiloTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-       <yle:UlkomainenHenkilotunniste>
-         <yle:SyntymaAika>2006-08-19+03:00</yle:SyntymaAika>
-         <!--Optional:-->
-         <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-       </yle:UlkomainenHenkilotunniste>
+       <lain:UlkomainenHenkilotunniste>
+         <lain:SyntymaAika>2006-08-19+03:00</lain:SyntymaAika>
+         <!--Optional:-->
+         <lain:UlkomainenHenkilotunnus>string</lain:UlkomainenHenkilotunnus>
+       </lain:UlkomainenHenkilotunniste>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-     </yle:YleinenHenkilotunniste>
+     </lain:HenkiloTunniste>
-   </yle:Henkilo>
+   </lain:Henkilo>
-   <yle:Yritys>
+   <lain:Yritys>
      <yle:Nimi>string</yle:Nimi>
-     <yle:YleinenYritysTunniste>
+     <lain:YritysTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Ytunnus>stringstr</yle:Ytunnus>
-       <yle:UlkomainenYritysTunniste>
+       <lain:UlkomainenYritysTunniste>
          <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-         <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
+         <lain:UlkomainenYtunnus>string</lain:UlkomainenYtunnus>
-        </yle:UlkomainenYritysTunniste>
+       </lain:UlkomainenYritysTunniste>
-     </yle:YleinenYritysTunniste>
+     </lain:YritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
-   </yle:Yritys>
+   </lain:Yritys>
    <!--Optional:-->
    <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
  </lain:Osapuoli>
</lain:LuovutettavaOsuus>

Muutokset AsiamiesTaiYhteyshenkilo-elementtiin:

- <yle:AsiamiesTaiYhteyshenkilo>
+ <lain:AsiamiesTaiYhteyshenkilo>
    <!--You have a CHOICE of the next 2 items at this level-->
-   <yle:Henkilo>
+   <lain:Henkilo>
      <yle:Etunimi>string</yle:Etunimi>
      <yle:Sukunimi>string</yle:Sukunimi>
-     <yle:YleinenHenkilotunniste>
+     <lain:HenkiloTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-       <yle:UlkomainenHenkilotunniste>
-         <yle:SyntymaAika>2006-08-19+03:00</yle:SyntymaAika>
-         <!--Optional:-->
-         <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-       </yle:UlkomainenHenkilotunniste>
+       <lain:UlkomainenHenkilotunniste>
+         <lain:SyntymaAika>2006-08-19+03:00</lain:SyntymaAika>
+         <!--Optional:-->
+         <lain:UlkomainenHenkilotunnus>string</lain:UlkomainenHenkilotunnus>
+       </lain:UlkomainenHenkilotunniste>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-     </yle:YleinenHenkilotunniste>
+     </lain:HenkiloTunniste>
-   </yle:Henkilo>
+   </lain:Henkilo>
-   <yle:Yritys>
+   <lain:Yritys>
      <yle:Nimi>string</yle:Nimi>
-     <yle:YleinenYritysTunniste>
+     <lain:YritysTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Ytunnus>stringstr</yle:Ytunnus>
-       <yle:UlkomainenYritysTunniste>
+       <lain:UlkomainenYritysTunniste>
          <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-         <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
+         <lain:UlkomainenYtunnus>string</lain:UlkomainenYtunnus>
-        </yle:UlkomainenYritysTunniste>
+       </lain:UlkomainenYritysTunniste>
-     </yle:YleinenYritysTunniste>
+     </lain:YritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
-   </yle:Yritys>
+   </lain:Yritys>
    <!--Optional:-->
-   <yle:Postiosoite>
-     <!--Optional:-->
-     <yle:Vastaanottaja>string</yle:Vastaanottaja>
-     <!--Optional:-->
-     <yle:VastaanottajanTarkenne>string</yle:VastaanottajanTarkenne>
-     <yle:Katuosoite>string</yle:Katuosoite>
-     <yle:Postinumero>string</yle:Postinumero>
-     <yle:Postitoimipaikka>string</yle:Postitoimipaikka>
-     <yle:Maatunnus>st</yle:Maatunnus>
-   </yle:Postiosoite>
-   <!--Optional:-->
-   <yle:Puhelinnumero>string</yle:Puhelinnumero>
    <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+   <!--Optional:-->
+   <yle:Puhelinnumero>string</yle:Puhelinnumero>
+   <yle:Postiosoite>
+     <!--Optional:-->
+     <yle:Vastaanottaja>string</yle:Vastaanottaja>
+     <!--Optional:-->
+     <yle:VastaanottajanTarkenne>string</yle:VastaanottajanTarkenne>
+     <yle:Katuosoite>string</yle:Katuosoite>
+     <yle:Postinumero>string</yle:Postinumero>
+     <yle:Postitoimipaikka>string</yle:Postitoimipaikka>
+     <yle:Maatunnus>st</yle:Maatunnus>
+   </yle:Postiosoite>
    <!--Optional:-->
-   <yle:Laskutusosoite>
+   <lain:Laskutusosoite>
      <!--You have a CHOICE of the next 2 items at this level-->
      <yle:Postiosoite>
        <!--Optional:-->
        <yle:Vastaanottaja>string</yle:Vastaanottaja>
        <!--Optional:-->
        <yle:VastaanottajanTarkenne>string</yle:VastaanottajanTarkenne>
        <yle:Katuosoite>string</yle:Katuosoite>
        <yle:Postinumero>string</yle:Postinumero>
        <yle:Postitoimipaikka>string</yle:Postitoimipaikka>
        <yle:Maatunnus>st</yle:Maatunnus>
      </yle:Postiosoite>
-      <yle:Verkkolaskutustiedot>
-         <yle:Operaattoritunnus>string</yle:Operaattoritunnus>
-         <!--Optional:-->
-         <yle:OvtTunnuksenTarkenne>strin</yle:OvtTunnuksenTarkenne>
-         <!--Optional:-->
-         <yle:Verkkolaskuosoite>string</yle:Verkkolaskuosoite>
-       </yle:Verkkolaskutustiedot>
-     </yle:Laskutusosoite>
+     <lain:Verkkolaskutustiedot>
+       <lain:Operaattoritunnus>string</lain:Operaattoritunnus>
+       <!--Optional:-->
+       <lain:OvtTunnuksenTarkenne>strin</lain:OvtTunnuksenTarkenne>
+       <!--Optional:-->
+       <lain:Verkkolaskuosoite>string</lain:Verkkolaskuosoite>
+     </lain:Verkkolaskutustiedot>
+   </lain:Laskutusosoite>
    <!--Optional:-->
    <yle:AsiakkaanViite>
      <!--Optional:-->
      <yle:Viitteenne>string</yle:Viitteenne>
      <!--Optional:-->
      <yle:Tiliointiviite>string</yle:Tiliointiviite>
      <!--Optional:-->
      <yle:Tilausnumero>string</yle:Tilausnumero>
      <!--Optional:-->
      <yle:Sopimusnumero>string</yle:Sopimusnumero>
      <!--Optional:-->
      <yle:TyomaaAvain>string</yle:TyomaaAvain>
    </yle:AsiakkaanViite>
- </yle:AsiamiesTaiYhteyshenkilo>
+ </lain:AsiamiesTaiYhteyshenkilo>

Skeemat kansio lainhuutohakemusrajapinta

Esimerkkitiedostot

Sanoma

Lainhuutohakemusesimerkki

Vastaus

Esimerkki lainhuutohakemuksen vastauksesta

Skeema v8 12.12.2018

Ei versiomuutoksen lisäksi muita muutoksia v7 ja v8 välillä.

Skeemat kansio lainhuutohakemusrajapinta

Esimerkkitiedostot

Sanoma

Lainhuutohakemusesimerkki

Vastaus

Esimerkki lainhuutohakemuksen vastauksesta

Skeema v7 6.6.2018

Lainhuutohakemusrajapinnan skeemaversio 7, joka viedään tuotantoon 6.6.2018.

• Skeemaan lisätty vapaaehtoinen elementti VainEsikatselu. Mikäli tämä elementti lähetetään, lainhuutohakemusta ei laiteta vireille, ainoastaan esikatselu-pdf:n lataaminen rajapinnasta on mahdollista. Jos elementtiä ei lähetetä, tämä tulkitaan falseksi. Kun hakemus halutaan vireille, siihen lähetetään päivitys ilman VainEsikatselu-elementtiä.

Skeemat kansio lainhuutohakemusrajapinta

Esimerkkitiedostot

Sanoma

Lainhuutohakemusesimerkki

Vastaus

Esimerkki lainhuutohakemuksen vastauksesta

Skeema v6 21.2.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 6, joka viedään tuotantoon 21.2.2018.

Skeemat kansio lainhuutohakemusrajapinta

Esimerkkitiedostot

Sanoma

Lainhuutohakemusesimerkki

Vastaus

Esimerkki lainhuutohakemuksen vastauksesta

Muutoshistoria

Asiakirjaluonnostelurajapinta - Luovutuskirja

Luovutuskirjaluonnoksen luonti

1. Yleiskuvaus

Rajapinnan kautta voidaan KVP:hen tuoda uusia luovutuskirjaluonnoksia allekirjoittamista varten. Liitetiedostojen sallitut tiedostomuodot ovat pdf ja jpg.

Asiakirjan lähettäjä voi ilmoittaa ottavansa maksettavakseen asiointimaksun sekä rekisteriotteita. Maksut veloitetaan lähettäjältä seuraavan laskutuksen yhteydessä voimassa olevan hinnaston mukaisesti.

Asiakirjan lähettäjä voi:

• Toimittaa myös KiinteistönLuovutusIlmoituksen tiedot (kauppahintarekisteriä varten)
• Indikoida että luovutuskirja on valmis jaettavaksi kaikille osapuolille heti vastaanotosta. Tällöin vastaanoton jälkeen myös muut kuin myyjäosapuolet saavat suoraan tiedon asiakirjasta ja pääsevät sitä katsomaan.
• Määrittää luovutuskirja lukituksi. Kun luovutuskirja määritetään lukituksi, niin kaikki tiedot on pakko toimittaa rajapinnan kautta ja luovutuskirjaa ei voi muokata tai täydentää KVP:ssä.

06/2018 alkaen (v7) mahdollista ilmoittaa luovutuskirja asiointipakettiin kuuluvaksi.

03/2019 alkaen (v9) usean kiinteistön luovutus (kauppa tai lahja) mahdollista samalla luovutuskirjalla.

Uusi maksuasetus tulee voimaan 1.1.2019. Uuden maksuasetuksen voimaantulon jälkeen asiointimaksu, joka on suoritettu sähköisessä kaupankäyntijärjestelmässä tehdystä luovutuksesta, sisältää maksun lainhuudon käsittelystä. Erillistä laskua lainhuudon käsittelystä ei enää lähetetä.

Versiossa 9 (03/2019) uusina ominaisuuksina:

• Usean kohteen kauppa- ja lahjakirja
• Kuolinpesä voi olla luovuttajana
  • Kuolinpesällä tulee olla lainhuuto tai selvennyslainhuuto kohteeseen joka halutaan luovuttaa. Kaikki kuolinpesän osakkaat tulee ilmoittaa rajapinnassa. Kuolinpesän osakkaiden tulee olla elossa ja täysi-ikäisiä, eivätkä he voi olla holhouksessa. Yksi kuolinpesän osakkaista ilmoitetaan luonnoksen vastaanottajaksi.

Versiossa 14 uusi ominaisuus:

• Sitoumukset voi ladata sitoumusten esikatselu polusta.
  • Sitoumukset palautetaan zip tiedostona
  • Jokainen tiedosto on nimetty kohteella ja järjestysnumerolla
  • Sitoumukset ovat nimetty samassa järjestyksessä kuin ne esiintyvät XML-viestissä

2. Sanoma

Luovutuskirjan tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Päivitys tehdään HTTP PUT-metodilla. Luovutuskirjan päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

Jos luovutuskirjasanomaan on merkitty liitetiedostoja, tulee nämä tiedostot lähettää vastaussanomassa välitettyyn URL-osoitteeseen pakattuna yhteen ZIP-tiedostoon HTTP POST-metodia käyttäen. Content-type "application/zip".

3. Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • KVPn antama tunnus luovutuskirjalle.
• AsiakirjaOsoite
  • URL, johon päivitetty luovutuskirja lähetetään.
• AsiakirjaTilaOsoite
  • URL, joka palauttaa luovutuskirjan tilaan liittyviä tietoja.
• LiitetiedostoOsoite
  • URL, johon luovutuskirjaan liittyvät liitetiedostot lähetetään ZIP-paketissa. URL-osoitteen loppuun tulee lisätä parametri ytunnus (arvoksi tulee lähettäjän y-tunnus).
• EsikatseluOsoite
  • URL, josta voi ladata esikatselu-PDF:n lähetetystä luovutuskirjasta.
• SitoumusEsikatseluOsoite v14 alkaen
  • URL, josta voi ladata sitoumuksien esikatselu-PDF:t ZIP-paketissa.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Luovutuskirjaluonnoksen päivitys

1. Yleiskuvaus

Rajapinnan kautta lähetettyä luovutuskirjaluonnosta voidaan päivittää lähettämällä uusi versio siitä niin kauan, kunnes asiakirjan vastaanottaja on sen KVP:ssä vastaanottanut. Tämän jälkeen on mahdollista lähettää ainoastaan uusi asiakirjaluonnos, joka laskutetaan uudelleen. Laskutus tapahtuu vasta asiakirjan valmistuttua.

2. Sanoma

HTTP-metodi: PUT

Content-type: text/xml

Päivitys tapahtuu samalla tavalla kuin asiakirjan luonti, mutta XML-muotoinen sanoma tulee lähettää luontivastauksessa välitettyyn URL-osoitteeseen HTTP PUT-metodia käyttäen.

Jokaiselle päivitetylle asiakirjalle tulee antaa juokseva versionumero, saman tai pienemmän version asiakirjoja ei oteta vastaan.

3. Vastaus

Kuten luovutuksen luonnissa

Luovutuskirjan tilan kysely

Katso tila-rajapinnan kuvaus.

Allekirjoitetun luovutuskirjan lataus

Katso asiakirjojen latausrajapinnan kuvaus

Skeema v14 (päivityksiä 4.10.2023)

4.10.2023 julkaistavassa päivityksestä mahdollistetaan katselijoiden lisääminen luovuskirjaan rajapinnan kautta. Skeemaan on lisätty uusi vapaaehtoinen elementti Katselijat. Katselija liittyy joko myyjään tai ostajaan eli KatselijanEdustamaOsapuoli tulee olla joku myyjistä tai ostajista.

+  <!--Optional:-->
+  <luov:Katselijat>
+    <!--1 or more repetitions:-->
+    <luov:Katselija>
+      <!--You have a CHOICE of the next 2 items at this level-->
+      <yle:Henkilo>
+        <yle:Etunimi>string</yle:Etunimi>
+        <yle:Sukunimi>string</yle:Sukunimi>
+        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+        <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+      </yle:Henkilo>
+      <yle:Yritys>
+        <yle:Nimi>string</yle:Nimi>
+        <yle:Ytunnus>stringstr</yle:Ytunnus>
+        <!--Optional:-->
+        <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+        <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+      </yle:Yritys>
+      <luov:KatselijanEdustamaOsapuoli>
+        <!--You have a CHOICE of the next 2 items at this level-->
+        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+        <yle:Ytunnus>stringstr</yle:Ytunnus>
+      </luov:KatselijanEdustamaOsapuoli>
+    </luov:Katselija>
+  </luov:Katselijat>

Kiinteistonluovutusilmoitus-elementistä poistuu Kayttotarkoitukset-elementti. Jatkossa Kiinteistonluovutusilmoitus-elementiin annetaan yksi Kayttotarkoitus-elementti sekä vapaaehtoinen MuuKayttotarkoitusSelite-elementti.

  <luov:Kiinteistonluovutusilmoitus>
-   <luov:Kayttotarkoitukset>
-     <!--1 to 6 repetitions:-->
      <luov:Kayttotarkoitus>RM</luov:Kayttotarkoitus>
      <!--Optional:-->
      <luov:MuuKayttotarkoitusSelite>string</luov:MuuKayttotarkoitusSelite>
-   </luov:Kayttotarkoitukset>
    <luov:Sukulaisluovutus>true</luov:Sukulaisluovutus>
    <luov:Rantatontti>true</luov:Rantatontti>
    <luov:Rakennustiedot>OL</luov:Rakennustiedot>
    <luov:Kaavatiedot>AK</luov:Kaavatiedot>
  </luov:Kiinteistonluovutusilmoitus>

Käsitemalli

Skeemat kansio luovutuskirjarajapinta

Esimerkkitiedostot

Sanoma

Koko kiinteistön kauppakirja

Vastaus

Luovutuskirjan lähetyksen esimerkkivastaus

Skeema v13

v13 skeemaan tulee päivitys 2.3.2022, jolloin julkaistaan seuraavat muutokset:

• Asiamiehen osoitetiedot, Postiosoite- elementti, on muutettu vapaaehtoiseksi.

+    <!--Optional:-->
       <yle:Postiosoite>

Käsitemalli

Skeemat kansio luovutuskirjarajapinta

Esimerkkitiedostot

Sanoma

Koko kiinteistön kauppakirja

Vastaus

Luovutuskirjan lähetyksen esimerkkivastaus

Skeema v12 17.2.2021

Luovutuskirjarajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

• Kaavatiedot on tullut osaksi Kiinteistonluovutusilmoitus -elementtiä. Mahdolliset arvot ovat: asemakaava (AK), ranta-asemakaava (RK), yleiskaava (YK) tai ei kaavaa (EK).

  <luov:Kiinteistonluovutusilmoitus>
    <luov:Kayttotarkoitukset>
      <!--1 to 6 repetitions:-->
        <luov:Kayttotarkoitus>RM</luov:Kayttotarkoitus>
        <!--Optional:-->
        <luov:MuuKayttotarkoitusSelite>string</luov:MuuKayttotarkoitusSelite>
    </luov:Kayttotarkoitukset>
    <luov:Sukulaisluovutus>true</luov:Sukulaisluovutus>
    <luov:Rantatontti>true</luov:Rantatontti>
    <luov:Rakennustiedot>OL</luov:Rakennustiedot>
+   <luov:Kaavatiedot>AK</luov:Kaavatiedot>
  </luov:Kiinteistonluovutusilmoitus>

Käsitemalli

Skeemat kansio luovutuskirjarajapinta

Esimerkkitiedostot

Sanoma

Koko kiinteistön kauppakirja

Vastaus

Luovutuskirjan lähetyksen esimerkkivastaus

Skeema v11 19.2.2020

Luovutuskirjarajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

• MuuKayttotarkoitusSelite-elementin maksimipituutta on muutettu vastaamaan järjestelmän hyväksymää arvoa

<xs:element name="MuuKayttotarkoitusSelite" minOccurs="0" maxOccurs="1">
  <xs:annotation>
    <xs:documentation xml:lang="fi">
      Jos Kayttotarkoitus -elementin arvona on MK (Muu käyttötarkoitus), selvennetään tarkemmin mikä.
    </xs:documentation>
  </xs:annotation>
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:minLength value="1" />
-     <xs:maxLength value="255" />
+     <xs:maxLength value="50" />
    </xs:restriction>
  </xs:simpleType>
</xs:element>

Käsitemalli

Skeemat kansio luovutuskirjarajapinta

Esimerkkitiedostot

Sanoma

Koko kiinteistön kauppakirja

Vastaus

Luovutuskirjan lähetyksen esimerkkivastaus

Skeema v10 12.6.2019

Skeeman mukautus asiakirjarajapinnan skeemaversioon 10, joka viedään tuotantoon 12.6.2019.

• MaaraalanPintaala-elementille ilmoitetaan myös yksikko

  <!--Optional:-->
  <yle:Maaraala>
    <yle:MaaraalanKuva>
      <yle:Nimi>string</yle:Nimi>
      <!--Optional:-->
      <yle:Kuvaus>string</yle:Kuvaus>
      <yle:InternetMediaType>string</yle:InternetMediaType>
      <yle:LiitetiedostoLaji>string</yle:LiitetiedostoLaji>
    </yle:MaaraalanKuva>
    <yle:Kuvaus>string</yle:Kuvaus>
-   <yle:MaaraalanPintaala>201</yle:MaaraalanPintaala>
+   <yle:MaaraalanPintaala yksikko="M2">201</yle:MaaraalanPintaala>
  </yle:Maaraala>

• LainhuudonHaku ja LainhuudonHakuSelite -elementit on uudelleennimetty.
• KenenLukuun-elementti on pakollinen

- <!--Optional:-->
- <yle:LainhuudonHaku>AL</yle:LainhuudonHaku>
- <!--Optional:-->
- <yle:LainhuudonHakuSelite>string</yle:LainhuudonHakuSelite>
+ <yle:KenenLukuun>
+   <yle:KenenLukuunValinta>AL</yle:KenenLukuunValinta>
+   <!--Optional:-->
+   <yle:MuunLukuunSelite>string</yle:MuunLukuunSelite>
+ </yle:KenenLukuun>

• Elementtien pakollisuuksia on muutettu. Elementeille LuovuttajienSuostujat, Sitoumukset, LuovutuksenEhdot ja EsisopimuksenEhdot on annettava ainakin yksi lapsielementti.

Käsitemalli

Skeemat kansio luovutuskirjarajapinta

Esimerkkitiedostot

Sanoma

Koko kiinteistön kauppakirja

Vastaus

Luovutuskirjan lähetyksen esimerkkivastaus

Skeema v9 20.3.2019

Muutokset LuovutuksenPerusTiedot-elementtiin:

• Luovutettavia kohteita voi olla useita. LuovutettavaKohde-elementin alle on siirretty aiemmin luovutuskirjakohtaisia tietoja:
  • Kiinteistotunnus
  • LuovutuksenKohde
  • Maaraala
  • LuovutuksenSaajat
  • LuovuttajienSuostujat
  • Sitoumukset
  • Kiinteistonluovutusilmoitus

<luov:LuovutuksenPerusTiedot>
- <yle:Kiinteistotunnus>stringstringstrings</yle:Kiinteistotunnus>
  <yle:Versio>201</yle:Versio>
- <luov:LuovutettavatOsuudet>
-   <!--1 or more repetitions:-->
-   <luov:LuovutettavaOsuus>
-     <!--Optional:-->
-     <yle:Osuus>string</yle:Osuus>
-     <luov:Luovuttajat>
-       <!--1 or more repetitions:-->
-       <luov:Luovuttaja>
-         <!--You have a CHOICE of the next 2 items at this level-->
-         <yle:Henkilo>
-           <yle:Etunimi>string</yle:Etunimi>
-           <yle:Sukunimi>string</yle:Sukunimi>
-           <yle:YleinenHenkilotunniste>
-             <!--You have a CHOICE of the next 2 items at this level-->
-             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-             <yle:UlkomainenHenkilotunniste>
-               <yle:SyntymaAika>2008-09-29</yle:SyntymaAika>
-               <!--Optional:-->
-               <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-             </yle:UlkomainenHenkilotunniste>
-             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-           </yle:YleinenHenkilotunniste>
-         </yle:Henkilo>
-         <yle:Ytunnus>stringstr</yle:Ytunnus>
-         <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-         <luov:LuonnoksenVastaanottaja>true</luov:LuonnoksenVastaanottaja>
-       </luov:Luovuttaja>
-     </luov:Luovuttajat>
-   </luov:LuovutettavaOsuus>
- </luov:LuovutettavatOsuudet>
  <yle:AsiaKieli>sv</yle:AsiaKieli>
  <yle:LuovutuskirjanTyyppi>ES</yle:LuovutuskirjanTyyppi>
+ <luov:LuovutettavatKohteet>
+   <!--1 or more repetitions:-->
+   <luov:LuovutettavaKohde>
+     <yle:Kiinteistotunnus>stringstringstrings</yle:Kiinteistotunnus>
+     <luov:LuovutettavatOsuudet>
+       <!--1 or more repetitions:-->
+       <luov:LuovutettavaOsuus>
+         <!--Optional:-->
+         <yle:Osuus>string</yle:Osuus>
+         <luov:Luovuttajat>
+           <!--1 or more repetitions:-->
+           <luov:Luovuttaja>
+             <!--You have a CHOICE of the next 3 items at this level-->
+             <yle:Henkilo>
+               <yle:Etunimi>string</yle:Etunimi>
+               <yle:Sukunimi>string</yle:Sukunimi>
+               <yle:YleinenHenkilotunniste>
+                 <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                 <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+               </yle:YleinenHenkilotunniste>
+               <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+             </yle:Henkilo>
+             <yle:Yritys>
+               <yle:Nimi>string</yle:Nimi>
+               <yle:YleinenYritysTunniste>
+                 <yle:Ytunnus>stringstr</yle:Ytunnus>
+               </yle:YleinenYritysTunniste>
+               <!--Optional:-->
+               <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+               <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+             </yle:Yritys>
+             <yle:Kuolinpesa>
+               <yle:Vainaja>
+                 <yle:Etunimi>string</yle:Etunimi>
+                 <yle:Sukunimi>string</yle:Sukunimi>
+                 <yle:YleinenHenkilotunniste>
+                   <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                   <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+                 </yle:YleinenHenkilotunniste>
+               </yle:Vainaja>
+               <yle:Osakkaat>
+                 <!--1 or more repetitions:-->
+                 <yle:Osakas>
+                   <!--You have a CHOICE of the next 2 items at this level-->
+                   <yle:Henkilo>
+                     <yle:Etunimi>string</yle:Etunimi>
+                     <yle:Sukunimi>string</yle:Sukunimi>
+                     <yle:YleinenHenkilotunniste>
+                       <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                       <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+                     </yle:YleinenHenkilotunniste>
+                     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+                   </yle:Henkilo>
+                   <yle:Yritys>
+                     <yle:Nimi>string</yle:Nimi>
+                     <yle:YleinenYritysTunniste>
+                       <yle:Ytunnus>stringstr</yle:Ytunnus>
+                     </yle:YleinenYritysTunniste>
+                     <!--Optional:-->
+                     <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+                     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+                   </yle:Yritys>
+                 </yle:Osakas>
+               </yle:Osakkaat>
+             </yle:Kuolinpesa>
+           </luov:Luovuttaja>
+         </luov:Luovuttajat>
+       </luov:LuovutettavaOsuus>
+     </luov:LuovutettavatOsuudet>
+     <yle:LuovutuksenKohde>MO</yle:LuovutuksenKohde>
+     <!--Optional:-->
+     <yle:Maaraala>
+       <yle:MaaraalanKuva>
+         <yle:Nimi>string</yle:Nimi>
+         <!--Optional:-->
+         <yle:Kuvaus>string</yle:Kuvaus>
+         <yle:InternetMediaType>string</yle:InternetMediaType>
+         <yle:LiitetiedostoLaji>string</yle:LiitetiedostoLaji>
+       </yle:MaaraalanKuva>
+       <yle:Kuvaus>string</yle:Kuvaus>
+       <yle:MaaraalanPintaala>201</yle:MaaraalanPintaala>
+     </yle:Maaraala>
+     <!--Optional:-->
+     <yle:LuovutuksenSaajat>
+       <!--1 or more repetitions:-->
+       <yle:LuovutuksenSaaja>
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <yle:Henkilo>
+           <yle:Etunimi>string</yle:Etunimi>
+           <yle:Sukunimi>string</yle:Sukunimi>
+           <yle:YleinenHenkilotunniste>
+             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+           </yle:YleinenHenkilotunniste>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Henkilo>
+         <yle:Yritys>
+           <yle:Nimi>string</yle:Nimi>
+           <yle:YleinenYritysTunniste>
+             <yle:Ytunnus>stringstr</yle:Ytunnus>
+           </yle:YleinenYritysTunniste>
+           <!--Optional:-->
+           <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Yritys>
+         <yle:Osuus>string</yle:Osuus>
+         <!--Optional:-->
+         <yle:LainhuudonHaku>YL</yle:LainhuudonHaku>
+         <!--Optional:-->
+         <yle:LainhuudonHakuSelite>string</yle:LainhuudonHakuSelite>
+       </yle:LuovutuksenSaaja>
+     </yle:LuovutuksenSaajat>
+     <!--Optional:-->
+     <luov:LuovuttajienSuostujat>
+       <!--Zero or more repetitions:-->
+       <luov:LuovuttajanSuostuja>
+         <yle:Henkilo>
+           <yle:Etunimi>string</yle:Etunimi>
+           <yle:Sukunimi>string</yle:Sukunimi>
+           <yle:YleinenHenkilotunniste>
+             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+           </yle:YleinenHenkilotunniste>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Henkilo>
+         <luov:SuostujanTyyppi>KH</luov:SuostujanTyyppi>
+         <luov:LuovuttajanHenkilotunnus>stringstrin</luov:LuovuttajanHenkilotunnus>
+       </luov:LuovuttajanSuostuja>
+     </luov:LuovuttajienSuostujat>
+     <!--Optional:-->
+     <luov:Sitoumukset>
+       <!--Zero or more repetitions:-->
+       <luov:Sitoumus>
+         <yle:Panttikirjat>
+           <!--1 or more repetitions:-->
+           <yle:Panttikirja>
+             <yle:PanttikirjanNumero>string</yle:PanttikirjanNumero>
+             <yle:PanttikirjamuotoKoodi>KI</yle:PanttikirjamuotoKoodi>
+           </yle:Panttikirja>
+         </yle:Panttikirjat>
+         <luov:SitoumuksenEhdot>
+           <!--You have a CHOICE of the next 2 items at this level-->
+           <luov:AutomaattinenSiirto>true</luov:AutomaattinenSiirto>
+           <luov:SitoumusTeksti>string</luov:SitoumusTeksti>
+         </luov:SitoumuksenEhdot>
+         <luov:SitoumuksenSaajat>
+           <!--You have a CHOICE of the next 2 items at this level-->
+           <luov:OstajatSaajina>false</luov:OstajatSaajina>
+           <!--1 or more repetitions:-->
+           <luov:SitoumuksenSaaja>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Henkilo>
+               <yle:Etunimi>string</yle:Etunimi>
+               <yle:Sukunimi>string</yle:Sukunimi>
+               <yle:YleinenHenkilotunniste>
+                 <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                 <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+               </yle:YleinenHenkilotunniste>
+               <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+             </yle:Henkilo>
+             <yle:Yritys>
+               <yle:Nimi>string</yle:Nimi>
+               <yle:YleinenYritysTunniste>
+                 <yle:Ytunnus>stringstr</yle:Ytunnus>
+               </yle:YleinenYritysTunniste>
+               <!--Optional:-->
+               <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+               <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+             </yle:Yritys>
+           </luov:SitoumuksenSaaja>
+         </luov:SitoumuksenSaajat>
+         <luov:SitoumuksenAntajat>
+           <!--1 or more repetitions:-->
+           <luov:SitoumuksenAntaja>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Henkilo>
+               <yle:Etunimi>string</yle:Etunimi>
+               <yle:Sukunimi>string</yle:Sukunimi>
+               <yle:YleinenHenkilotunniste>
+                 <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                 <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+               </yle:YleinenHenkilotunniste>
+               <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+             </yle:Henkilo>
+             <yle:Yritys>
+               <yle:Nimi>string</yle:Nimi>
+               <yle:YleinenYritysTunniste>
+                 <yle:Ytunnus>stringstr</yle:Ytunnus>
+               </yle:YleinenYritysTunniste>
+               <!--Optional:-->
+               <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+               <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+             </yle:Yritys>
+           </luov:SitoumuksenAntaja>
+         </luov:SitoumuksenAntajat>
+       </luov:Sitoumus>
+     </luov:Sitoumukset>
+     <!--Optional:-->
+     <luov:Kiinteistonluovutusilmoitus>
+       <luov:Kayttotarkoitukset>
+         <!--1 to 6 repetitions:-->
+         <luov:Kayttotarkoitus>RM</luov:Kayttotarkoitus>
+         <!--Optional:-->
+         <luov:MuuKayttotarkoitusSelite>string</luov:MuuKayttotarkoitusSelite>
+       </luov:Kayttotarkoitukset>
+       <luov:Sukulaisluovutus>false</luov:Sukulaisluovutus>
+       <luov:Rantatontti>true</luov:Rantatontti>
+       <luov:Rakennustiedot>AR</luov:Rakennustiedot>
+     </luov:Kiinteistonluovutusilmoitus>
+   </luov:LuovutettavaKohde>
+ </luov:LuovutettavatKohteet>
+  <yle:LuonnoksenVastaanottaja>
+   <!--You have a CHOICE of the next 2 items at this level-->
+   <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+   <yle:Ytunnus>stringstr</yle:Ytunnus>
+ </yle:LuonnoksenVastaanottaja>
</luov:LuovutuksenPerusTiedot>

Muutokset LuovutuksenTiedot-elementtiin:

• AsiamiesTaiYhteyshenkilo_-elementin muutokset:
  • Laskutusosoite-elementti on poistettu AsiamiesTaiYhteyshenkilo-elementiltä.
  • AsiamiesTaiYhteyshenkilo-elementin Puhelinnumero-elementti on siirretty Postiosoite-elementin yläpuolelle.
  • Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään.
  • UlkomainenHenkilotunniste ja UlkomainenYritysTunniste -elementit on poistettu.
• Kohdekohtaiset elementit siirretty LuovutettavaKohde-elementin alle:
  • Maaraala
  • LuovutuksenSaajat
  • LuovuttajienSuostujat
  • Sitoumukset
  • Kiinteistonluovutusilmoitus

<luov:LuovutuksenTiedot>
  <!--Optional:-->
  <yle:AsiamiesTaiYhteyshenkilo>
    <!--You have a CHOICE of the next 2 items at this level-->
    <yle:Yritys>
      <yle:Nimi>string</yle:Nimi>
      <yle:YleinenYritysTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Ytunnus>stringstr</yle:Ytunnus>
-       <yle:UlkomainenYritysTunniste>
-         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-         <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-       </yle:UlkomainenYritysTunniste>
+       <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
      </yle:YleinenYritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
    </yle:Yritys>
    <yle:Henkilo>
      <yle:Etunimi>string</yle:Etunimi>
      <yle:Sukunimi>string</yle:Sukunimi>
      <yle:YleinenHenkilotunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-       <yle:UlkomainenHenkilotunniste>
-         <yle:SyntymaAika>2018-11-01+02:00</yle:SyntymaAika>
-         <!--Optional:-->
-         <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-       </yle:UlkomainenHenkilotunniste>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
      </yle:YleinenHenkilotunniste>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Henkilo>
+   <yle:Puhelinnumero>string</yle:Puhelinnumero>
    <yle:Postiosoite>
      <!--Optional:-->
      <yle:Vastaanottaja>string</yle:Vastaanottaja>
      <!--Optional:-->
      <yle:VastaanottajanTarkenne>string</yle:VastaanottajanTarkenne>
      <yle:Katuosoite>string</yle:Katuosoite>
      <yle:Postinumero>string</yle:Postinumero>
      <yle:Postitoimipaikka>string</yle:Postitoimipaikka>
      <yle:Maatunnus>st</yle:Maatunnus>
    </yle:Postiosoite>
    <!--Optional:-->
-   <yle:Puhelinnumero>string</yle:Puhelinnumero>
-   <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-   <!--Optional:-->
-   <yle:Laskutusosoite>
-     <!--You have a CHOICE of the next 2 items at this level-->
-     <yle:Postiosoite>
-       <!--Optional:-->
-       <yle:Vastaanottaja>string</yle:Vastaanottaja>
-       <!--Optional:-->
-       <yle:VastaanottajanTarkenne>string</yle:VastaanottajanTarkenne>
-       <yle:Katuosoite>string</yle:Katuosoite>
-       <yle:Postinumero>string</yle:Postinumero>
-       <yle:Postitoimipaikka>string</yle:Postitoimipaikka>
-       <yle:Maatunnus>st</yle:Maatunnus>
-     </yle:Postiosoite>
-     <yle:Verkkolaskutustiedot>
-       <yle:Operaattoritunnus>string</yle:Operaattoritunnus>
-       <!--Optional:-->
-       <yle:OvtTunnuksenTarkenne>strin</yle:OvtTunnuksenTarkenne>
-       <!--Optional:-->
-       <yle:Verkkolaskuosoite>string</yle:Verkkolaskuosoite>
-     </yle:Verkkolaskutustiedot>
-   </yle:Laskutusosoite>
-   <!--Optional:-->
-   <yle:AsiakkaanViite>
-     <!--Optional:-->
-     <yle:Viitteenne>string</yle:Viitteenne>
-     <!--Optional:-->
-     <yle:Tiliointiviite>string</yle:Tiliointiviite>
-     <!--Optional:-->
-     <yle:Tilausnumero>string</yle:Tilausnumero>
-     <!--Optional:-->
-     <yle:Sopimusnumero>string</yle:Sopimusnumero>
-     <!--Optional:-->
-     <yle:TyomaaAvain>string</yle:TyomaaAvain>
-   </yle:AsiakkaanViite>
  </yle:AsiamiesTaiYhteyshenkilo>
- <!--Optional:-->
- <yle:Maaraala>
-   <yle:MaaraalanKuva>
-     <yle:Nimi>string</yle:Nimi>
-     <!--Optional:-->
-     <yle:Kuvaus>string</yle:Kuvaus>
-     <yle:InternetMediaType>string</yle:InternetMediaType>
-     <yle:LiitetiedostoLaji>string</yle:LiitetiedostoLaji>
-   </yle:MaaraalanKuva>
-   <yle:Kuvaus>string</yle:Kuvaus>
-   <yle:MaaraalanPintaala>201</yle:MaaraalanPintaala>
- </yle:Maaraala>
- <!--Optional:-->
- <yle:LuovutuksenSaajat>
-   <!--1 or more repetitions:-->
-   <yle:LuovutuksenSaaja>
-     <!--You have a CHOICE of the next 2 items at this level-->
-     <yle:Henkilo>
-       <yle:Etunimi>string</yle:Etunimi>
-       <yle:Sukunimi>string</yle:Sukunimi>
-       <yle:YleinenHenkilotunniste>
-         <!--You have a CHOICE of the next 2 items at this level-->
-         <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-         <yle:UlkomainenHenkilotunniste>
-           <yle:SyntymaAika>2013-05-22+03:00</yle:SyntymaAika>
-           <!--Optional:-->
-           <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-         </yle:UlkomainenHenkilotunniste>
-         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-       </yle:YleinenHenkilotunniste>
-     </yle:Henkilo>
-     <yle:Yritys>
-       <yle:Nimi>string</yle:Nimi>
-       <yle:YleinenYritysTunniste>
-         <!--You have a CHOICE of the next 2 items at this level-->
-         <yle:Ytunnus>stringstr</yle:Ytunnus>
-         <yle:UlkomainenYritysTunniste>
-           <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-           <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-         </yle:UlkomainenYritysTunniste>
-       </yle:YleinenYritysTunniste>
-       <!--Optional:-->
-       <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
-     </yle:Yritys>
-     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-     <yle:Osuus>string</yle:Osuus>
-     <!--Optional:-->
-     <yle:LainhuudonHaku>OL</yle:LainhuudonHaku>
-     <!--Optional:-->
-     <yle:LainhuudonHakuSelite>string</yle:LainhuudonHakuSelite>
-     <!--Optional:-->
-     <yle:EtuostolainMukainenVakuutus>false</yle:EtuostolainMukainenVakuutus>
-     <!--Optional:-->
-     <yle:EnsiasunnonOstajanVakuutus>false</yle:EnsiasunnonOstajanVakuutus>
-   </yle:LuovutuksenSaaja>
- </yle:LuovutuksenSaajat>
- <!--Optional:-->
- <luov:LuovuttajienSuostujat>
-   <!--Zero or more repetitions:-->
-   <luov:LuovuttajanSuostuja>
-     <yle:Henkilo>
-       <yle:Etunimi>string</yle:Etunimi>
-       <yle:Sukunimi>string</yle:Sukunimi>
-       <yle:YleinenHenkilotunniste>
-         <!--You have a CHOICE of the next 2 items at this level-->
-         <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-         <yle:UlkomainenHenkilotunniste>
-           <yle:SyntymaAika>2002-06-24+03:00</yle:SyntymaAika>
-           <!--Optional:-->
-           <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-         </yle:UlkomainenHenkilotunniste>
-         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-       </yle:YleinenHenkilotunniste>
-     </yle:Henkilo>
-     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-     <luov:SuostujanTyyppi>KH</luov:SuostujanTyyppi>
-     <luov:LuovuttajanHenkilotunnus>stringstrin</luov:LuovuttajanHenkilotunnus>
-   </luov:LuovuttajanSuostuja>
- </luov:LuovuttajienSuostujat>
  <!--Optional:-->
  <luov:Hinta>
    <luov:Kauppahinta>1000.00</luov:Kauppahinta>
    <!--Optional:-->
    <luov:Kasiraha>1000.00</luov:Kasiraha>
    <!--Optional:-->
    <luov:KaupanAjankohta>2012-01-07</luov:KaupanAjankohta>
  </luov:Hinta>
  <!--Optional:-->
  <luov:LuovutuksenEhdot>
    <!--Zero or more repetitions:-->
    <yle:Ehto>
      <yle:Otsikko>string</yle:Otsikko>
      <!--Optional:-->
      <yle:Sisalto>string</yle:Sisalto>
    </yle:Ehto>
  </luov:LuovutuksenEhdot>
  <!--Optional:-->
  <luov:EsisopimuksenEhdot>
    <!--Zero or more repetitions:-->
    <yle:Ehto>
      <yle:Otsikko>string</yle:Otsikko>
      <!--Optional:-->
      <yle:Sisalto>string</yle:Sisalto>
    </yle:Ehto>
  </luov:EsisopimuksenEhdot>
  <!--Optional:-->
  <yle:Liitteet>
    <!--1 or more repetitions:-->
    <yle:Liitetiedosto>
      <yle:Nimi>string</yle:Nimi>
      <!--Optional:-->
      <yle:Kuvaus>string</yle:Kuvaus>
      <yle:InternetMediaType>string</yle:InternetMediaType>
      <yle:LiitetiedostoLaji>string</yle:LiitetiedostoLaji>
    </yle:Liitetiedosto>
  </yle:Liitteet>
- <!--Optional:-->
- <luov:Sitoumukset>
-   <!--Zero or more repetitions:-->
-   <luov:Sitoumus>
-     <yle:Panttikirjat>
-       <!--1 or more repetitions:-->
-       <yle:Panttikirja>
-         <yle:PanttikirjanNumero>string</yle:PanttikirjanNumero>
-         <yle:PanttikirjamuotoKoodi>KI</yle:PanttikirjamuotoKoodi>
-       </yle:Panttikirja>
-     </yle:Panttikirjat>
-     <luov:SitoumuksenEhdot>
-       <!--You have a CHOICE of the next 2 items at this level-->
-       <luov:AutomaattinenSiirto>true</luov:AutomaattinenSiirto>
-       <luov:SitoumusTeksti>string</luov:SitoumusTeksti>
-     </luov:SitoumuksenEhdot>
-     <luov:SitoumuksenSaajat>
-       <!--You have a CHOICE of the next 2 items at this level-->
-       <luov:OstajatSaajina>true</luov:OstajatSaajina>
-       <!--1 or more repetitions:-->
-       <luov:SitoumuksenSaaja>
-         <!--You have a CHOICE of the next 2 items at this level-->
-         <yle:Henkilo>
-           <yle:Etunimi>string</yle:Etunimi>
-           <yle:Sukunimi>string</yle:Sukunimi>
-           <yle:YleinenHenkilotunniste>
-             <!--You have a CHOICE of the next 2 items at this level-->
-             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-             <yle:UlkomainenHenkilotunniste>
-               <yle:SyntymaAika>2013-06-17</yle:SyntymaAika>
-               <!--Optional:-->
-               <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-             </yle:UlkomainenHenkilotunniste>
-             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-           </yle:YleinenHenkilotunniste>
-         </yle:Henkilo>
-         <yle:Yritys>
-           <yle:Nimi>string</yle:Nimi>
-           <yle:YleinenYritysTunniste>
-             <!--You have a CHOICE of the next 2 items at this level-->
-             <yle:Ytunnus>stringstr</yle:Ytunnus>
-             <yle:UlkomainenYritysTunniste>
-               <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-               <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-             </yle:UlkomainenYritysTunniste>
-           </yle:YleinenYritysTunniste>
-           <!--Optional:-->
-           <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
-         </yle:Yritys>
-         <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-       </luov:SitoumuksenSaaja>
-     </luov:SitoumuksenSaajat>
-     <luov:SitoumuksenAntajat>
-       <!--1 or more repetitions:-->
-       <luov:SitoumuksenAntaja>
-         <!--You have a CHOICE of the next 2 items at this level-->
-         <yle:Henkilo>
-           <yle:Etunimi>string</yle:Etunimi>
-           <yle:Sukunimi>string</yle:Sukunimi>
-           <yle:YleinenHenkilotunniste>
-             <!--You have a CHOICE of the next 2 items at this level-->
-             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-             <yle:UlkomainenHenkilotunniste>
-               <yle:SyntymaAika>2005-09-12+03:00</yle:SyntymaAika>
-               <!--Optional:-->
-               <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-             </yle:UlkomainenHenkilotunniste>
-             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-           </yle:YleinenHenkilotunniste>
-         </yle:Henkilo>
-         <yle:Yritys>
-           <yle:Nimi>string</yle:Nimi>
-           <yle:YleinenYritysTunniste>
-             <!--You have a CHOICE of the next 2 items at this level-->
-             <yle:Ytunnus>stringstr</yle:Ytunnus>
-             <yle:UlkomainenYritysTunniste>
-               <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-               <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-             </yle:UlkomainenYritysTunniste>
-           </yle:YleinenYritysTunniste>
-           <!--Optional:-->
-           <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
-         </yle:Yritys>
-         <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-       </luov:SitoumuksenAntaja>
-     </luov:SitoumuksenAntajat>
-   </luov:Sitoumus>
- </luov:Sitoumukset>
- <!--Optional:-->
- <luov:Kiinteistonluovutusilmoitus>
-   <luov:Kayttotarkoitukset>
-     <!--1 to 6 repetitions:-->
-     <luov:Kayttotarkoitus>MM</luov:Kayttotarkoitus>
-     <!--Optional:-->
-     <luov:MuuKayttotarkoitusSelite>string</luov:MuuKayttotarkoitusSelite>
-   </luov:Kayttotarkoitukset>
-   <luov:Sukulaisluovutus>true</luov:Sukulaisluovutus>
-   <luov:Rantatontti>true</luov:Rantatontti>
-   <luov:Rakennustiedot>ER</luov:Rakennustiedot>
- </luov:Kiinteistonluovutusilmoitus>
  <!--Optional:-->
  <yle:AsiakirjaLukittu>true</yle:AsiakirjaLukittu>
  <!--Optional:-->
  <yle:VainEsikatselu>false</yle:VainEsikatselu>
  <!--Optional:-->
  <yle:LaskulleOtettavatPalvelut>
    <yle:HakemusTaiAsiointimaksuLaskulle>false</yle:HakemusTaiAsiointimaksuLaskulle>
    <!--Optional:-->
    <yle:RekisteriotteetLaskulle>
      <!--1 or more repetitions:-->
      <yle:RekisterioteLaskulle>
        <yle:KohdeKiinteisto>stringstringstrings</yle:KohdeKiinteisto>
        <yle:Rekisteriotteet>
          <!--1 to 4 repetitions:-->
          <yle:Rekisteriote>KR</yle:Rekisteriote>
        </yle:Rekisteriotteet>
      </yle:RekisterioteLaskulle>
    </yle:RekisteriotteetLaskulle>
    <!--Optional:-->
    <yle:LaskutuksenViiteTiedot>
      <!--Optional:-->
      <yle:LaskutusKoontiavain>string</yle:LaskutusKoontiavain>
      <!--Optional:-->
      <yle:AsiakkaanViite>
        <!--Optional:-->
        <yle:Viitteenne>string</yle:Viitteenne>
        <!--Optional:-->
        <yle:Tiliointiviite>string</yle:Tiliointiviite>
        <!--Optional:-->
        <yle:Tilausnumero>string</yle:Tilausnumero>
        <!--Optional:-->
        <yle:Sopimusnumero>string</yle:Sopimusnumero>
        <!--Optional:-->
        <yle:TyomaaAvain>string</yle:TyomaaAvain>
      </yle:AsiakkaanViite>
    </yle:LaskutuksenViiteTiedot>
  </yle:LaskulleOtettavatPalvelut>
  <!--Optional:-->
  <luov:AsiakirjaJaettu>true</luov:AsiakirjaJaettu>
</luov:LuovutuksenTiedot>

Skeemat kansio luovutuskirjarajapinta

Ohjeita useamman kohteen luovutuskirjaan:

• luovutuskirjan tyyppi voi olla joko kauppa tai lahja
• luovutuskirjaa ei voida liittää osaksi asiointipakettia
• jokaisella kohteella tulee olla sama omistajajoukko, omistusosuuksilla ei ole väliä
• jokaisella kohteella tulee olla sama saajajoukko, omistusosuuksilla ei ole väliä

Esimerkkitiedostot

Sanoma

Koko kiinteistön kauppakirja, usean kohteen luovutuskirja

Vastaus

Luovutuskirjan lähetyksen esimerkkivastaus

Skeema v8 12.12.2018

Ei versiomuutoksen lisäksi muita muutoksia v7 ja v8 välillä.

Skeemat kansio luovutuskirjarajapinta

Esimerkkitiedostot

Sanoma

Koko kiinteistön kauppakirja

Vastaus

Luovutuskirjan lähetyksen esimerkkivastaus

Skeema v7 6.6.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 7, joka viedään tuotantoon 6.6.2018.

Skeemat kansio luovutuskirjarajapinta

Esimerkkitiedostot

Sanoma

Koko kiinteistön kauppakirja

Vastaus

Luovutuskirjan lähetyksen esimerkkivastaus

Skeema v6 21.2.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 6, joka viedään tuotantoon 21.2.2018.

Skeemat kansio luovutuskirjarajapinta

Esimerkkitiedostot

Sanoma

Koko kiinteistön kauppakirja

Vastaus

Luovutuskirjan lähetyksen esimerkkivastaus

Muutoshistoria

Asiakirjaluonnostelurajapinta - Panttikirjan siirtohakemus

1. Yleiskuvaus

Rajapinnan kautta voidaan palveluun tuoda uusi sähköisen panttikirjan siirtohakemusluonnos. Yhdellä siirtohakemuksella voidaan siirtää useita sähköisiä panttikirjoja, jotka ovat rekisterissä merkitty siirtäjien nimiin.

Panttikirjan siirtohakemus voidaan ilmoittaa lukituksi, jolloin KVP:ssä ei sallita muutoksia hakemukseen, ainoastaan sen hyväksyminen tai poistaminen. Lukituksi merkityltä luonnokselta edellytetään kaikkien (myös vapaaehtoisten) tietojen toimittamista rajapinnasta.

Asiakirjan lähettäjä voi myös ilmoittaa ottavansa maksettavakseen siirtohakemusmaksun. Maksu veloitetaan lähettäjältä seuraavan laskutuksen yhteydessä voimassa olevan hinnaston mukaisesti. Veloitus tapahtuu kun siirtohakemus allekirjoitetaan valmiiksi.

Rajapinnan kautta lähetettyä siirtohakemusluonnosta voidaan päivittää lähettämällä uusi versio siitä niin kauan, kunnes asiakirjan vastaanottaja on sen KVP:ssä vastaanottanut. Tämän jälkeen on mahdollista lähettää ainoastaan uusi asiakirjaluonnos, joka laskutetaan uudelleen.

Panttikirjan siirtohakemuksille voi tehdä tilakyselyitä ja ladata valmiit asiakirjat.

20.3.2019 alkaen (v9) mahdollista ilmoittaa kuolinpesä hakijaksi. Kaikki kuolinpesän osakkaat tulee ilmoittaa rajapinnassa. Kuolinpesän osakkaiden tulee olla elossa ja täysi-ikäisiä, eivätkä he voi olla holhouksessa. Mikäli kuolinpesä toimii hakijana, yksi kuolinpesän osakkaista ilmoitetaan luonnoksen vastaanottajaksi.

2. Sanoma

Hakemuksen tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Päivitys tehdään HTTP PUT-metodilla. Hakemuksen päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

3. Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • KVPn antama tunnus panttikirjan siirtohakemukselle.
• AsiakirjaOsoite
  • URL, johon päivitetty panttikirjan siirtohakemus lähetetään.
• AsiakirjaTilaOsoite
  • URL, joka palauttaa panttikirjan siirtohakemuksen tilaan liittyviä tietoja.
• EsikatseluOsoite
  • URL, josta voi ladata esikatselu-PDF:n lähetetystä hakemuksesta.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Skeema v14

Käsitemalli

Skeemat kansio panttikirjansiirtohakemusrajapinta

Esimerkkitiedostot

Sanoma

Panttikirjan siirtohakemusesimerkki

Vastaus

Esimerkki panttikirjan siirtohakemusluonnoksen vastauksesta

Skeema v13

v13 skeemaan tulee päivitys 2.3.2022, jolloin julkaistaan seuraavat muutokset:

• Asiamiehen osoitetiedot, Postiosoite- elementti, on muutettu vapaaehtoiseksi.

+    <!--Optional:-->
       <yle:Postiosoite>

Käsitemalli

Skeemat kansio panttikirjansiirtohakemusrajapinta

Esimerkkitiedostot

Sanoma

Panttikirjan siirtohakemusesimerkki

Vastaus

Esimerkki panttikirjan siirtohakemusluonnoksen vastauksesta

Skeema v12 17.2.2021

Siirtohakemusrajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

Käsitemalli

Skeemat kansio panttikirjansiirtohakemusrajapinta

Esimerkkitiedostot

Sanoma

Panttikirjan siirtohakemusesimerkki

Vastaus

Esimerkki panttikirjan siirtohakemusluonnoksen vastauksesta

Skeema v11 19.2.2020

Siirtohakemusrajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

Käsitemalli

Skeemat kansio panttikirjansiirtohakemusrajapinta

Esimerkkitiedostot

Sanoma

Panttikirjan siirtohakemusesimerkki

Vastaus

Esimerkki panttikirjan siirtohakemusluonnoksen vastauksesta

Skeema v10 12.6.2019

Rajapinnan skeemaversio 10, joka viedään tuotantoon 12.6.2019.

Versiomuutoksen lisäksi ei muita muutoksia v9 ja v10 välillä.

Käsitemalli

Skeemat kansio panttikirjansiirtohakemusrajapinta

Esimerkkitiedostot

Sanoma

Panttikirjan siirtohakemusesimerkki

Vastaus

Esimerkki panttikirjan siirtohakemusluonnoksen vastauksesta

Skeema v9 20.3.2019

Rajapinnan skeemaversio 9, joka viedään tuotantoon 20.3.2019.

• Mahdollisuus ilmoittaa kuolinpesä hakijaksi.
• LuonnoksenVastaanottaja-elementti on poistettu Hakija-elementin sisältä. Sen sijaan elementti annetaan vain kerran ja siinä ilmoitetaan vastaanottavan osapuolen henkilö- tai y-tunnus.
• Hakijan Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään.
• Asiamiehen Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään. Puhelinnumero-elementti on siirretty Postiosoite-elementin yläpuolelle.
• Asiamiehen laskutusosoitetta on poistettu. Hakemusmaksu ja mahdolliset rekisteriotemaksut laskutetaan asiakirjan lähettäjältä mikäli HakemusTaiAsiointimaksuLaskulle-elementin arvo on true.

Muutokset Hakijat-elementtiin:

<yle:Hakijat>
  <!--1 or more repetitions:-->
  <yle:Hakija>
-   <!--You have a CHOICE of the next 2 items at this level-->
+   <!--You have a CHOICE of the next 3 items at this level-->
    <yle:Henkilo>
      <yle:Etunimi>string</yle:Etunimi>
      <yle:Sukunimi>string</yle:Sukunimi>
      <yle:YleinenHenkilotunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-       <yle:UlkomainenHenkilotunniste>
-         <yle:SyntymaAika>2008-09-29</yle:SyntymaAika>
-         <!--Optional:-->
-         <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-       </yle:UlkomainenHenkilotunniste>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
      </yle:YleinenHenkilotunniste>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Henkilo>
    <yle:Yritys>
      <yle:Nimi>string</yle:Nimi>
      <yle:YleinenYritysTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Ytunnus>stringstr</yle:Ytunnus>
-       <yle:UlkomainenYritysTunniste>
-         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-         <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-       </yle:UlkomainenYritysTunniste>
-     </yle:YleinenYritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Yritys>
+   <yle:Kuolinpesa>
+     <yle:Vainaja>
+       <yle:Etunimi>string</yle:Etunimi>
+       <yle:Sukunimi>string</yle:Sukunimi>
+       <yle:YleinenHenkilotunniste>
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+       </yle:YleinenHenkilotunniste>
+     </yle:Vainaja>
+     <yle:Osakkaat>
+       <!--1 or more repetitions:-->
+       <yle:Osakas>
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <yle:Henkilo>
+           <yle:Etunimi>string</yle:Etunimi>
+           <yle:Sukunimi>string</yle:Sukunimi>
+           <yle:YleinenHenkilotunniste>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+           </yle:YleinenHenkilotunniste>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Henkilo>
+         <yle:Yritys>
+           <yle:Nimi>string</yle:Nimi>
+           <yle:YleinenYritysTunniste>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Ytunnus>stringstr</yle:Ytunnus>
+           </yle:YleinenYritysTunniste>
+           <!--Optional:-->
+           <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Yritys>
+       </yle:Osakas>
+     </yle:Osakkaat>
+   </yle:Kuolinpesa>
-   <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-   <yle:LuonnoksenVastaanottaja>true</yle:LuonnoksenVastaanottaja>
  </yle:Hakija>
</yle:Hakijat>
+ <yle:LuonnoksenVastaanottaja>
+   <!--You have a CHOICE of the next 2 items at this level-->
+   <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+   <yle:Ytunnus>stringstr</yle:Ytunnus>
+ </yle:LuonnoksenVastaanottaja>

Skeemat kansio panttikirjansiirtohakemusrajapinta

Esimerkkitiedostot

Sanoma

Panttikirjan siirtohakemusesimerkki, kuolinpesä hakijana

Vastaus

Esimerkki Panttikirjan siirtohakemusluonnoksen vastauksesta

Skeema v8 12.12.2018

Ei versiomuutoksen lisäksi muita muutoksia v7 ja v8 välillä.

Skeemat kansio panttikirjansiirtohakemusrajapinta

Esimerkkitiedostot

Sanoma

Panttikirjan siirtohakemusesimerkki

Vastaus

Esimerkki Panttikirjan siirtohakemusluonnoksen vastauksesta

Skeema v7 6.6.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 7, joka viedään tuotantoon 6.6.2018.

Skeemat kansio panttikirjansiirtohakemusrajapinta

Esimerkkitiedostot

Sanoma

Panttikirjan siirtohakemusesimerkki

Vastaus

Esimerkki Panttikirjan siirtohakemusluonnoksen vastauksesta

Skeema v6 21.2.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 6, joka viedään tuotantoon 21.2.2018.

Skeemat kansio panttikirjansiirtohakemusrajapinta

Esimerkkitiedostot

Sanoma

Panttikirjan siirtohakemusesimerkki

Vastaus

Esimerkki Panttikirjan siirtohakemusluonnoksen vastauksesta

Muutoshistoria

Asiakirjaluonnostelurajapinta - Valtakirja

1. Yleiskuvaus

Rajapinnan kautta voidaan tuoda uusi valtakirjaluonnos allekirjoittamista varten. Valtakirjan tuonnissa valtakirjaluonnoksen tulee sisältää valtuuttaja, valtakirjan kieli, valtuutuksen tyyppi sekä valtuutuksen tyyppikohtaiset minimitiedot kuten kohde.

Mahdolliset valtakirjatyypit ovat:

• Yleisvaltakirja kiinteistövaihdannan palvelussa toimimiseen
  • Yksi valtuuttaja voi valtuuttaa yhden henkilön hoitamaan kiinteistövaihdannan palvelun toimia puolestaan.
• Yksilöity valtakirja kiinteistön myymiseen
  • Luonnos kiinteistönkauppavaltuutuksesta. Vain yksi valtuuttaja on tässä vaiheessa tuettu rajapinnan kautta.
• Yksilöity valtakirja kiinteistön lahjoittamiseen
  • Luonnos kiinteistönlahjoitusvaltuutuksesta. Vain yksi valtuuttaja on tässä vaiheessa tuettu rajapinnan kautta.
• Yksilöity valtakirja kiinteistön ostamiseen tai lahjan vastaanottamiseen
  • Luonnos kiinteistönosto- tai lahjoituksen vastaanottovaltuutuksesta. Vain yksi valtuuttaja on tässä vaiheessa tuettu rajapinnan kautta.
• Valtakirja kiinteistön kiinnittämiseen
  • Luonnos kohteen kiinnityshakemusvaltuutuksesta. Rajapinnan kautta voi tuoda useamman valtuuttajan kiinnityshakemusluonnoksen.
• Yksilöity valtakirja sähköisen panttikirjan siirron hakemiseen
  • Luonnos sähköisen panttikirjan siirtohakemusvaltuutuksesta. Rajapinnan kautta voi tuoda useamman valtuuttajan kiinnityshakemusluonnoksen.

Yksityiskohtaiset kuvaukset eri valtakirjojen osalta löytyvät skeemoista.

Valtakirjat on mahdollista lukita siten, että valtuuttaja voin vain vahvistaa valtuutuksen tai poistaa saapuvan valtakirjan.

Rajapinnan kautta lähetettyä luovutuskirjaluonnosta voidaan päivittää lähettämällä uusi versio siitä niin kauan, kunnes asiakirjan vastaanottaja on sen KVP:ssä vastaanottanut. Tämän jälkeen on mahdollista lähettää ainoastaan uusi asiakirjaluonnos, joka laskutetaan uudelleen.

Valtakirjoille voi tehdä tilakyselyitä ja ladata valmiit asiakirjat.

1. Sanoma

Valtakirjan tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Päivitys tehdään HTTP PUT-metodilla. Valtakirjan päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

2. Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • KVPn antama tunnus valtakirjalle.
• AsiakirjaOsoite
  • URL, johon päivitetty valtakirja lähetetään.
• AsiakirjaTilaOsoite
  • URL, joka palauttaa valtakirjan tilaan liittyviä tietoja.
• LiitetiedostoOsoite
  • URL, johon valtakirjaan liittyvät liitetiedostot lähetetään ZIP-paketissa. URL-osoitteen loppuun tulee lisätä parametri ytunnus (arvoksi tulee lähettäjän y-tunnus).
• EsikatseluOsoite
  • URL, josta voi ladata esikatselu-PDF:n lähetetystä valtakirjasta.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Skeema v14

Käsitemalli

Skeemat kansio valtakirjarajapinta

Esimerkkitiedostot

Sanoma

Valtakirja kiinteistön määräosan myymiseen -esimerkki

Vastaus

Esimerkkivastaus

Skeema v13

Käsitemalli

Skeemat kansio valtakirjarajapinta

Esimerkkitiedostot

Sanoma

Valtakirja kiinteistön määräosan myymiseen -esimerkki

Vastaus

Esimerkkivastaus

Skeema v12 17.2.2021

Valtakirjarajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

Käsitemalli

Skeemat kansio valtakirjarajapinta

Esimerkkitiedostot

Sanoma

Valtakirja kiinteistön määräosan myymiseen -esimerkki

Vastaus

Esimerkkivastaus

Skeema v11 19.2.2020

Valtakirjarajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

• Saajat ja Saaja on korvattu LuovutuksenSaajat- ja LuovutuksenSaaja- elementeillä

+ <yle:LuovutuksenSaajat>
    <!--1 or more repetitions:-->
+   <yle:LuovutuksenSaaja>
      <!--You have a CHOICE of the next 2 items at this level-->
      <yle:Henkilo>
        <yle:Etunimi>string</yle:Etunimi>
        <yle:Sukunimi>string</yle:Sukunimi>
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
        <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
      </yle:Henkilo>
      <yle:Yritys>
        <yle:Nimi>string</yle:Nimi>
        <yle:Ytunnus>stringstr</yle:Ytunnus>
        <!--Optional:-->
        <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
        <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
      </yle:Yritys>
      <yle:Osuus>string</yle:Osuus>
      <yle:KenenLukuun>
        <yle:KenenLukuunValinta>OL</yle:KenenLukuunValinta>
        <!--Optional:-->
        <yle:MuunLukuunSelite>string</yle:MuunLukuunSelite>
      </yle:KenenLukuun>
+   </yle:LuovutuksenSaaja>
+ </yle:LuovutuksenSaajat>

Käsitemalli

Skeemat kansio valtakirjarajapinta

Esimerkkitiedostot

Sanoma

Valtakirja kiinteistön määräosan myymiseen -esimerkki

Vastaus

Esimerkkivastaus

Skeema v10 12.6.2019

Skeeman mukautus asiakirjarajapinnan skeemaversioon 10, joka viedään tuotantoon 12.6.2019.

• LainhuudonHaku ja LainhuudonHakuSelite -elementit on uudelleennimetty.
• KenenLukuun-elementti on pakollinen

- <!--Optional:-->
- <yle:LainhuudonHaku>AL</yle:LainhuudonHaku>
- <!--Optional:-->
- <yle:LainhuudonHakuSelite>string</yle:LainhuudonHakuSelite>
+ <yle:KenenLukuun>
+   <yle:KenenLukuunValinta>AL</yle:KenenLukuunValinta>
+   <!--Optional:-->
+   <yle:MuunLukuunSelite>string</yle:MuunLukuunSelite>
+ </yle:KenenLukuun>

Käsitemalli

Skeemat kansio valtakirjarajapinta

Esimerkkitiedostot

Sanoma

Valtakirja kiinteistön määräosan myymiseen -esimerkki

Vastaus

Esimerkkivastaus

Skeema v9 20.3.2019

Rajapinnan skeemaversio 9, joka viedään tuotantoon 20.3.2019.

Peruskomponentteihin on tehty muutoksia, jotka vaikuttavat valtakirjarajapinnan skeemaan.

• Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään. Vaikuttaa elementteihin Valtuuttaja, Valtuutettu, Saaja, ja UusiSaaja.
• LuonnoksenVastaanottaja-elementti on poistettu Valtuuttaja-elementin sisältä. Sen sijaan elementti annetaan vain kerran ja siinä ilmoitetaan vastaanottavan osapuolen henkilö- tai y-tunnus.

Muutokset Valtuuttajat-elementtiin:

<val:Valtuuttajat>
  <!--1 or more repetitions:-->
  <val:Valtuuttaja>
    <!--You have a CHOICE of the next 2 items at this level-->
    <yle:Henkilo>
      <yle:Etunimi>string</yle:Etunimi>
      <yle:Sukunimi>string</yle:Sukunimi>
      <yle:YleinenHenkilotunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-       <yle:UlkomainenHenkilotunniste>
-         <yle:SyntymaAika>2007-10-26</yle:SyntymaAika>
-         <!--Optional:-->
-         <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-       </yle:UlkomainenHenkilotunniste>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
      </yle:YleinenHenkilotunniste>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Henkilo>
    <yle:Yritys>
      <yle:Nimi>string</yle:Nimi>
      <yle:YleinenYritysTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Ytunnus>stringstr</yle:Ytunnus>
-       <yle:UlkomainenYritysTunniste>
-         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-         <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-       </yle:UlkomainenYritysTunniste>
      </yle:YleinenYritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Yritys>
-   <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-   <yle:LuonnoksenVastaanottaja>true</yle:LuonnoksenVastaanottaja>
  </val:Valtuuttaja>
</val:Valtuuttajat>
+ <yle:LuonnoksenVastaanottaja>
+   <!--You have a CHOICE of the next 2 items at this level-->
+   <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+   <yle:Ytunnus>stringstr</yle:Ytunnus>
+ </yle:LuonnoksenVastaanottaja>

Skeemat kansio valtakirjarajapinta

Esimerkkitiedostot

Sanoma

Valtakirja sähköisen panttikirjan siirtämiseen -esimerkki

Vastaus

Esimerkkivastaus

Skeema v8 12.12.2018

Ei versiomuutoksen lisäksi muita muutoksia v7 ja v8 välillä.

Skeemat kansio valtakirjarajapinta

Esimerkkitiedostot

Sanoma

Valtakirja sähköisen panttikirjan siirtämiseen -esimerkki

Vastaus

Esimerkkivastaus

Skeema v7 6.6.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 7, joka viedään tuotantoon 6.6.2018. Ei merkittäviä toiminnallisia muutoksia.

Skeemat kansio valtakirjarajapinta

Esimerkkitiedostot

Sanoma

Valtakirja sähköisen panttikirjan siirtämiseen -esimerkki

Vastaus

Esimerkkivastaus

Skeema v6 21.2.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 6, joka viedään tuotantoon 21.2.2018. Ei merkittäviä toiminnallisia muutoksia.

Skeemat kansio valtakirjarajapinta

Esimerkkitiedostot

Sanoma

Valtakirja sähköisen panttikirjan siirtämiseen -esimerkki

Vastaus

Esimerkkivastaus

Muutoshistoria

Asiakirjan tila -rajapinta

Yleiskuvaus

Rajapinnan kautta voidaan kysellä lähetetyn asiakirjan tilaa. Tämä mahdollistaa KVP:n asioiden seurannan kytkemisen tietojärjestelmiin. Rajapintaa ei ole tarkoitettu muiden kuin KVP:ssä ja Lainhuutohakemusrajapinnassa tehtyjen asioiden seurantaan.

Rajapinta kertoo asiakirjan tilan lisäksi myös muuta tietoa (silloin kun tieto saatavilla) kuten viimeisen muokkaajan ja muokkausajankohdan sekä allekirjoitukset ja puuttuvat allekirjoitukset. Asiakirjan tilaa voi kysellä kaikille asiakirjarajapinnan asiakirjoille.

Asiakirjan tilat ja mahdolliset tilasiirtymät tilarajapinnassa (alkaen v8)

* tilat Jakamaton ja Odottaa myyjien allekirjoituksia mahdollisia vain luovutuksille. ** tila Odottaa suostujien allekirjoituksia mahdollinen vain kiinnityksen kuolettamiselle ja yhteiskiinnityksen purkamiselle.

Kiinnityshakemuksen (valmistelu ennakkoon) tilasiirtymät tilarajapinnassa

• Kiinnityshakemuksen (valmistelu ennakkoon) tilat eroavat lähinnä sikäli, että asiakirjan ollessa lopullinen se voi olla kolmessa eri alatilassa.

Asiointipaketin tilasiirtymät tilarajapinnassa

1. Asioita lisätään pakettiin lähettämällä niitä eri rajapintojen kautta. Lopulta paketti suljetaan uusilta asioilta ja lähetetyt asiat ovat valmiita vastaanotettaviksi.
2. Asiat otetaan yksitellen vastaan. Osa voi olla allekirjoitettuna.
3. Mikäli pakettiin kuuluva asiakirja poistetaan, paketin teko keskeytyy.
4. Kaikki asiat on allekirjoitettu.
5. Allekirjoitetut hakemukset laitetaan vireille onnistuneesti.
6. Allekirjoitetut hakemukset laitetaan vireille, osan vireillelaitto epäonnistuu.

Hakemuksien tilat ja mahdolliset tilasiirtymät tilarajapinnassa

Rajapinta kertoo myös asiakirjaan liittyvän hakemuksen perustilan. Määräalan pidätyksenä lähetetystä asiakirjasta syntyy 2 lainhuutohakemusta kun asiakirjassa on kaikkien osapuolien allekirjoitukset. Välittömästi allekirjoituksien jälkeen rajapinta kertoo asiakirjan tilaksi valmis ja ostajan lainhuutohakemuksen olevan vireillä. Rajapinnasta ei ole mahdollista saada pidätetyn määräalan lainhuutohakemuksen tilaa.

Asioiden tilat

v13 alkaen

Toimii päällisin puolin samalla tavalla kuin hakemus. Asiasta syntyy tila rekisteriin kuten hakemuksestakin. Asioiden tilaa tutkimalla saa tietää että onko esimerkiksi lainhuuto ratkaistu hyväksytysti.

Sitoumuksien tilat

v13 alkaen

Toimii päällisin puolin kuin mikä tahansa allekirjoitettava muu asia. Sisältää siis samoin allekirjoitukset, tietoa sitoumuksesta ja sisältää myös uuden Asiat elementin.

Rajoitukset ja huomiot

• Rajapinta kertoo asiakirjojen tilat ainoastaan mikäli pyytäjä on asiakirjan lähettänyt yritys. Luovutuskirjan tapauksessa pyytäjälle tulee lisäksi olla annettu järjestelmässä katseluoikeus kyseiseen asiakirjaan.
• Kaikki tilat eivät ole käytössä kaikilla hakemustyypeillä.
• Kun asiakirja on poistunut, niin myöskään hakemuksien tila ei ole saatavilla.
• Tilarajapinnan pollaus tulee pysyä kohtuullisena, useat samaan hakemukseen kohdistuvat kyselyt lyhyen ajan sisään tullaan blokkaamaan.

Sanoma

Kysely tehdään GET pyyntönä luonnin yhteydessä palautettuun URL:iin, johon tulee lisätä parametrinä kysyvän yrityksen y-tunnus. URL:ssa on mukana valmiiksi asiakirjan id, jonka perusteella kyselyt kohdennetaan oikeaan asiakirjaan.

Virhetilanteessa kysely palauttaa yleisen virhe-skeeman mukaisen virhevastauksen.

Täydennyskehotustiedoston lataus

Jos lopullisesta asiakirjasta syntyneeseen hakemukseen liittyy täydennyskehotus, siihen liittyvän PDF-tiedoston voi ladata käyttämällä LatausURL-elementissä palautettavaa osoitetta (GET pyyntönä). URL:ssa on mukana valmiiksi asiakirjan id, jonka perusteella kyselyt kohdennetaan oikeaan asiakirjaan. Lisäksi pyynnössä tulee välittää parametrinä kysyvän yrityksen y-tunnus sekä hakemuksen hakemustunnus. Täydennyskehotukseen liittyvä hakemustunnus palautetaan tilakyselyn vastauksessa hakemuksen tiedoissa Hakemustunnus-elementissä.

Esimerkki täydennyskehotustiedoston pyynnöstä: https://palvelu.nls.fi/v2/taydennyskehotus/181/123/liite?ytunnus=1234567-8&hakemustunnus=MML/123456/2016

Skeema v14

4.10.2023 päivityksessä lisätään Asiatila-elementtiin uusi tila POISTETTU.

  <xs:element name="Asiatila">
    <xs:simpleType>
      <xs:restriction base="xs:string">
        <xs:enumeration value="VIREILLA" />
        <xs:enumeration value="HYVAKSYTTY" />
        <xs:enumeration value="HYLATTY" />
        <xs:enumeration value="JATETTY_TUTKIMATTA" />
        <xs:enumeration value="JATETTY_LEPAAMAAN" />
        <xs:enumeration value="RAUENNUT" />
        <xs:enumeration value="PAATOS_PURETTU" />
+       <xs:enumeration value="POISTETTU" />
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

12/2022 päivityksessä poistettu käyttämätön vapaaehtoinen elementti TaydennysOsoite.

- <xs:element name="TaydennysOsoite" type="xs:string" minOccurs="0" maxOccurs="1" >
-   <xs:annotation>
-     <xs:documentation xml:lang="fi">
-       URL, johon hakemuksen täydennyspyyntöihin tai täydennyskehotuksiin liittyvät liitetiedostot tulee lähettää.
-       Liitetiedostot tulee pakata ZIP-tiedostoksi, joka sisältää liitteet sen nimisinä kuin ne on pyynnössä esitetty.
-     </xs:documentation>
-   </xs:annotation>
- </xs:element>

Käsitemalli

Skeemat kansio tila

Esimerkkitiedostot

Sanoma

Esimerkki tilakysely URL:stä: https://palvelu.nls.fi/v14/maanvuokraoikeuden_perustaminen/159/tila?ytunnus=1971814-3

Vastaus

Luovutuskirja tilakyselyn vastaus - asiakirja lopullinen, lainhuutohakemus odottaa täydennystä, sitoumus panttikirjan siirtämiseen vireillä

Kiinnityshakemus (valmistelu ennakkoon) tilakyselyn vastaus - asiakirja lopullinen ja odottaa, hakemusta ei saada vireille virheen takia

Skeema v13

4.10.2023 päivityksessä lisätään Asiatila-elementtiin uusi tila POISTETTU.

  <xs:element name="Asiatila">
    <xs:simpleType>
      <xs:restriction base="xs:string">
        <xs:enumeration value="VIREILLA" />
        <xs:enumeration value="HYVAKSYTTY" />
        <xs:enumeration value="HYLATTY" />
        <xs:enumeration value="JATETTY_TUTKIMATTA" />
        <xs:enumeration value="JATETTY_LEPAAMAAN" />
        <xs:enumeration value="RAUENNUT" />
        <xs:enumeration value="PAATOS_PURETTU" />
+       <xs:enumeration value="POISTETTU" />
      </xs:restriction>
    </xs:simpleType>
  </xs:element>

Uutena asioina Asiat ja Sitoumukset

Skeemaan julkaistaan korjaus 5.5.2022. Sitoumuksien ehtojen Automaattinen-tyyppi muuttuu pk:TotuusTyyppi. Eli jatkossa elementtiin voi tulla true/false arvoja.

- <xs:element name="Automaattinen" type="pk:TosiTotuusTyyppi"/> 
+ <xs:element name="Automaattinen" type="pk:TotuusTyyppi" />

Käsitemalli

Skeemat kansio tila

Esimerkkitiedostot

Sanoma

Esimerkki tilakysely URL:stä: https://palvelu.nls.fi/v13/maanvuokraoikeuden_perustaminen/159/tila?ytunnus=1971814-3

Vastaus

Luovutuskirja tilakyselyn vastaus - asiakirja lopullinen, lainhuutohakemus odottaa täydennystä, sitoumus panttikirjan siirtämiseen vireillä

Kiinnityshakemus (valmistelu ennakkoon) tilakyselyn vastaus - asiakirja lopullinen ja odottaa, hakemusta ei saada vireille virheen takia

Skeema v12 17.2.2021

Tilarajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

Käsitemalli

Skeemat kansio tila

Esimerkkitiedostot

Sanoma

Esimerkki tilakysely URL:stä: https://palvelu.nls.fi/v12/maanvuokraoikeuden_perustaminen/159/tila?ytunnus=1971814-3

Vastaus

Maanvuokraoikeuden perustaminen tilakyselyn vastaus - asiakirja kesken

Kiinnityshakemus (valmistelu ennakkoon) tilakyselyn vastaus - asiakirja lopullinen ja odottaa, hakemusta ei saada vireille virheen takia

Skeema v11 19.2.2020

Tilarajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

HavaittuVirhe-elementtiä on muutettu tukemaan virheviestejä usealla kielellä:

• kieli-attribuutin arvo voi olla joko fi tai sv

 <tila:HavaittuVirhe>
-  <tila:HavaittuVirheTeksti>string</tila:HavaittuVirheTeksti>
+  <tila:HavaittuVirheTeksti>
+    <!--1 or more repetitions:-->
+    <yle:VirheTeksti kieli="string">string</yle:VirheTeksti>
+   </tila:HavaittuVirheTeksti>
   <!--Optional:-->
   <tila:HavaittuVirheLyhenne>string</tila:HavaittuVirheLyhenne>
 </tila:HavaittuVirhe>

Käsitemalli

Skeemat kansio tila

Esimerkkitiedostot

Sanoma

Esimerkki tilakysely URL:stä: https://palvelu.nls.fi/v11/maanvuokraoikeuden_perustaminen/159/tila?ytunnus=1971814-3

Vastaus

Maanvuokraoikeuden perustaminen tilakyselyn vastaus - asiakirja kesken

Kiinnityshakemus (valmistelu ennakkoon) tilakyselyn vastaus - asiakirja lopullinen ja odottaa, hakemusta ei saada vireille virheen takia

Skeema v10 12.6.2019

Tilarajapinnan skeemaversio 10, joka viedään tuotantoon 12.6.2019.

Skeemaversiossa 8 lisätty HavaittuVirhe-elementti otettu käyttöön kiinnityshakemus (valmistelu ennakkoon) osalta. HavaittuVirhe sisältää tiedon miksi kiinnityshakemusta (valmistelu ennakkoon) ei saada vireille. Elementti näytetään ainoastaan silloin, kun hakemuksen vireillelaitossa on tapahtunut jokin virhe.

Skeemat kansio tila

Esimerkkitiedostot

Sanoma

Esimerkki tilakysely URL:stä: https://palvelu.nls.fi/v10/maanvuokraoikeuden_perustaminen/159/tila?ytunnus=1971814-3

Vastaus

Maanvuokraoikeuden perustaminen tilakyselynvastaus - asiakirja kesken

Skeema v9 20.3.2019

Tilarajapinnan skeemaversio 9, joka viedään tuotantoon 20.3.2019.

• Kuolinpesä voi olla osapuolena
• YritykseltaPuuttuvaAllekirjoitus-elementtiin on lisätty yrityksen Y-tunnus
• AllekirjoittanutYritysEdustaja-elementtiin on lisätty yrityksen Y-tunnus
• ValtuutettuAllekirjoittaja-elementtiin on lisätty Valtuuttaja-elementti

Muutokset PuuttuvaAllekirjoitus-elementtiin:

       <tila:PuuttuvaAllekirjoitus>
-        <!--You have a CHOICE of the next 2 items at this level-->
+        <!--You have a CHOICE of the next 3 items at this level-->
         <yle:Henkilo>
           <yle:Etunimi>string</yle:Etunimi>
           <yle:Sukunimi>string</yle:Sukunimi>
           <yle:YleinenHenkilotunniste>
-            <!--You have a CHOICE of the next 2 items at this level-->
             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-            <yle:UlkomainenHenkilotunniste>
-              <yle:SyntymaAika>2014-06-09+03:00</yle:SyntymaAika>
-              <!--Optional:-->
-              <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-            </yle:UlkomainenHenkilotunniste>
             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
           </yle:YleinenHenkilotunniste>
+          <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
         </yle:Henkilo>
         <yle:Yritys>
           <yle:Nimi>string</yle:Nimi>
           <yle:YleinenYritysTunniste>
-            <!--You have a CHOICE of the next 2 items at this level-->
             <yle:Ytunnus>stringstr</yle:Ytunnus>
-            <yle:UlkomainenYritysTunniste>
-              <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-              <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-            </yle:UlkomainenYritysTunniste>
           </yle:YleinenYritysTunniste>
           <!--Optional:-->
           <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+          <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
         </yle:Yritys>
+        <yle:Kuolinpesa>
+          <yle:Vainaja>
+            <yle:Etunimi>string</yle:Etunimi>
+            <yle:Sukunimi>string</yle:Sukunimi>
+            <yle:YleinenHenkilotunniste>
+              <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+              <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+            </yle:YleinenHenkilotunniste>
+          </yle:Vainaja>
+          <yle:Osakkaat>
+            <!--1 or more repetitions:-->
+            <yle:Osakas>
+              <!--You have a CHOICE of the next 2 items at this level-->
+              <yle:Henkilo>
+                <yle:Etunimi>string</yle:Etunimi>
+                <yle:Sukunimi>string</yle:Sukunimi>
+                <yle:YleinenHenkilotunniste>
+                  <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                  <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+                </yle:YleinenHenkilotunniste>
+                <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+              </yle:Henkilo>
+              <yle:Yritys>
+                <yle:Nimi>string</yle:Nimi>
+                <yle:YleinenYritysTunniste>
+                  <yle:Ytunnus>stringstr</yle:Ytunnus>
+                </yle:YleinenYritysTunniste>
+                <!--Optional:-->
+                <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+                <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+              </yle:Yritys>
+            </yle:Osakas>
+          </yle:Osakkaat>
+        </yle:Kuolinpesa>
         <tila:Tyyppi>Hakija</tila:Tyyppi>
         <!--Optional:-->
         <tila:YritykseltaPuuttuvatAllekirjoitukset>
           <!--You have a CHOICE of the next 2 items at this level-->
           <!--1 or more repetitions:-->
           <tila:YritykseltaPuuttuvaAllekirjoitus>
+            <yle:Ytunnus>stringstr</yle:Ytunnus>
             <!--Optional:-->
             <tila:Roolit>
               <!--1 or more repetitions:-->
               <tila:Rooli>string</tila:Rooli>
             </tila:Roolit>
             <!--Optional:-->
             <tila:Nimi>string</tila:Nimi>
             <!--Optional:-->
             <tila:Allekirjoitusaika>2006-08-19T20:27:14+03:00</tila:Allekirjoitusaika>
           </tila:YritykseltaPuuttuvaAllekirjoitus>
           <tila:TietoEiSaatavilla>false</tila:TietoEiSaatavilla>
         </tila:YritykseltaPuuttuvatAllekirjoitukset>
       </tila:PuuttuvaAllekirjoitus>

Muutokset Allekirjoittanut-elementtiin:

      <tila:Allekirjoittanut>
-        <!--You have a CHOICE of the next 2 items at this level-->
+        <!--You have a CHOICE of the next 3 items at this level-->
         <yle:Henkilo>
           <yle:Etunimi>string</yle:Etunimi>
           <yle:Sukunimi>string</yle:Sukunimi>
           <yle:YleinenHenkilotunniste>
-            <!--You have a CHOICE of the next 2 items at this level-->
             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-            <yle:UlkomainenHenkilotunniste>
-              <yle:SyntymaAika>2002-11-05+02:00</yle:SyntymaAika>
-              <!--Optional:-->
-              <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-            </yle:UlkomainenHenkilotunniste>
             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
           </yle:YleinenHenkilotunniste>
+          <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
         </yle:Henkilo>
         <yle:Yritys>
           <yle:Nimi>string</yle:Nimi>
           <yle:YleinenYritysTunniste>
-            <!--You have a CHOICE of the next 2 items at this level-->
             <yle:Ytunnus>stringstr</yle:Ytunnus>
-            <yle:UlkomainenYritysTunniste>
-              <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-              <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-            </yle:UlkomainenYritysTunniste>
           </yle:YleinenYritysTunniste>
           <!--Optional:-->
           <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+          <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
         </yle:Yritys>
+        <yle:Kuolinpesa>
+          <yle:Vainaja>
+            <yle:Etunimi>string</yle:Etunimi>
+            <yle:Sukunimi>string</yle:Sukunimi>
+            <yle:YleinenHenkilotunniste>
+              <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+              <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+            </yle:YleinenHenkilotunniste>
+          </yle:Vainaja>
+          <yle:Osakkaat>
+            <!--1 or more repetitions:-->
+            <yle:Osakas>
+              <!--You have a CHOICE of the next 2 items at this level-->
+              <yle:Henkilo>
+                <yle:Etunimi>string</yle:Etunimi>
+                <yle:Sukunimi>string</yle:Sukunimi>
+                <yle:YleinenHenkilotunniste>
+                  <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                  <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+                </yle:YleinenHenkilotunniste>
+                <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+              </yle:Henkilo>
+              <yle:Yritys>
+                <yle:Nimi>string</yle:Nimi>
+                <yle:YleinenYritysTunniste>
+                  <yle:Ytunnus>stringstr</yle:Ytunnus>
+                </yle:YleinenYritysTunniste>
+                <!--Optional:-->
+                <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+                <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+              </yle:Yritys>
+            </yle:Osakas>
+          </yle:Osakkaat>
+        </yle:Kuolinpesa>
         <tila:Tyyppi>Hakija</tila:Tyyppi>
         <!--Optional:-->
         <tila:AllekirjoittaneetYritysEdustajat>
           <!--1 or more repetitions:-->
           <tila:AllekirjoittanutYritysEdustaja>
+            <yle:Ytunnus>stringstr</yle:Ytunnus>
             <!--Optional:-->
             <tila:Roolit>
               <!--1 or more repetitions:-->
               <tila:Rooli>string</tila:Rooli>
             </tila:Roolit>
             <!--Optional:-->
             <tila:Nimi>string</tila:Nimi>
             <!--Optional:-->
             <tila:Allekirjoitusaika>2016-01-01T21:07:42</tila:Allekirjoitusaika>
           </tila:AllekirjoittanutYritysEdustaja>
         </tila:AllekirjoittaneetYritysEdustajat>
         <!--Optional:-->
         <tila:AllekirjoituksenValmistumisaika>2012-01-07T21:42:56</tila:AllekirjoituksenValmistumisaika>
         <!--Optional:-->
         <tila:ValtuutetutAllekirjoittajat>
           <!--1 or more repetitions:-->
           <tila:ValtuutettuAllekirjoittaja>
             <!--You have a CHOICE of the next 2 items at this level-->
             <yle:Henkilo>
               <yle:Etunimi>string</yle:Etunimi>
               <yle:Sukunimi>string</yle:Sukunimi>
               <yle:YleinenHenkilotunniste>
-                <!--You have a CHOICE of the next 2 items at this level-->
                 <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-                <yle:UlkomainenHenkilotunniste>
-                  <yle:SyntymaAika>2014-10-27</yle:SyntymaAika>
-                  <!--Optional:-->
-                  <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-                </yle:UlkomainenHenkilotunniste>
                 <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
               </yle:YleinenHenkilotunniste>
+              <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
             </yle:Henkilo>
             <yle:Yritys>
               <yle:Nimi>string</yle:Nimi>
               <yle:YleinenYritysTunniste>
-                <!--You have a CHOICE of the next 2 items at this level-->
                 <yle:Ytunnus>stringstr</yle:Ytunnus>
-                <yle:UlkomainenYritysTunniste>
-                  <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-                  <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-                </yle:UlkomainenYritysTunniste>
               </yle:YleinenYritysTunniste>
               <!--Optional:-->
               <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+              <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
             </yle:Yritys>
+            <tila:Valtuuttaja>
+              <!--You have a CHOICE of the next 2 items at this level-->
+              <yle:Henkilo>
+                <yle:Etunimi>string</yle:Etunimi>
+                <yle:Sukunimi>string</yle:Sukunimi>
+                <yle:YleinenHenkilotunniste>
+                  <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                  <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+                </yle:YleinenHenkilotunniste>
+                <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+              </yle:Henkilo>
+              <yle:Yritys>
+                <yle:Nimi>string</yle:Nimi>
+                <yle:YleinenYritysTunniste>
+                  <yle:Ytunnus>stringstr</yle:Ytunnus>
+                </yle:YleinenYritysTunniste>
+                <!--Optional:-->
+                <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+                <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+              </yle:Yritys>
+            </tila:Valtuuttaja>
             <!--Optional:-->
             <tila:AllekirjoittaneetYritysEdustajat>
               <!--1 or more repetitions:-->
               <tila:AllekirjoittanutYritysEdustaja>
+                <yle:Ytunnus>stringstr</yle:Ytunnus>
                 <!--Optional:-->
                 <tila:Roolit>
                   <!--1 or more repetitions:-->
                   <tila:Rooli>string</tila:Rooli>
                 </tila:Roolit>
                 <!--Optional:-->
                 <tila:Nimi>string</tila:Nimi>
                 <!--Optional:-->
                 <tila:Allekirjoitusaika>2013-06-17T20:14:58</tila:Allekirjoitusaika>
               </tila:AllekirjoittanutYritysEdustaja>
             </tila:AllekirjoittaneetYritysEdustajat>
           </tila:ValtuutettuAllekirjoittaja>
         </tila:ValtuutetutAllekirjoittajat>
         <tila:AllekirjoitusValmis>false</tila:AllekirjoitusValmis>
       </tila:Allekirjoittanut>

Muutokset Hakija-elementtiin:

          <tila:Hakija>
-            <!--You have a CHOICE of the next 2 items at this level-->
+            <!--You have a CHOICE of the next 3 items at this level-->
             <yle:Henkilo>
               <yle:Etunimi>string</yle:Etunimi>
               <yle:Sukunimi>string</yle:Sukunimi>
               <yle:YleinenHenkilotunniste>
-                <!--You have a CHOICE of the next 2 items at this level-->
                 <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-                <yle:UlkomainenHenkilotunniste>
-                  <yle:SyntymaAika>2006-11-29</yle:SyntymaAika>
-                  <!--Optional:-->
-                  <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-                </yle:UlkomainenHenkilotunniste>
                 <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
               </yle:YleinenHenkilotunniste>
+              <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
             </yle:Henkilo>
             <yle:Yritys>
               <yle:Nimi>string</yle:Nimi>
               <yle:YleinenYritysTunniste>
-                <!--You have a CHOICE of the next 2 items at this level-->
                 <yle:Ytunnus>stringstr</yle:Ytunnus>
-                <yle:UlkomainenYritysTunniste>
-                  <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-                  <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-                </yle:UlkomainenYritysTunniste>
               </yle:YleinenYritysTunniste>
               <!--Optional:-->
               <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+              <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
             </yle:Yritys>
+            <yle:Kuolinpesa>
+              <yle:Vainaja>
+                <yle:Etunimi>string</yle:Etunimi>
+                <yle:Sukunimi>string</yle:Sukunimi>
+                <yle:YleinenHenkilotunniste>
+                  <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                  <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+                </yle:YleinenHenkilotunniste>
+              </yle:Vainaja>
+              <yle:Osakkaat>
+                <!--1 or more repetitions:-->
+                <yle:Osakas>
+                  <!--You have a CHOICE of the next 2 items at this level-->
+                  <yle:Henkilo>
+                    <yle:Etunimi>string</yle:Etunimi>
+                    <yle:Sukunimi>string</yle:Sukunimi>
+                    <yle:YleinenHenkilotunniste>
+                      <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+                      <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+                    </yle:YleinenHenkilotunniste>
+                    <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+                  </yle:Henkilo>
+                  <yle:Yritys>
+                    <yle:Nimi>string</yle:Nimi>
+                    <yle:YleinenYritysTunniste>
+                      <yle:Ytunnus>stringstr</yle:Ytunnus>
+                    </yle:YleinenYritysTunniste>
+                    <!--Optional:-->
+                    <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+                    <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+                  </yle:Yritys>
+                </yle:Osakas>
+              </yle:Osakkaat>
+            </yle:Kuolinpesa>
           </tila:Hakija>

Muutokset Asiamies-elementtiin:

             <tila:Asiamies>
               <!--You have a CHOICE of the next 2 items at this level-->
               <yle:Henkilo>
                 <yle:Etunimi>string</yle:Etunimi>
                 <yle:Sukunimi>string</yle:Sukunimi>
                 <yle:YleinenHenkilotunniste>
-                  <!--You have a CHOICE of the next 2 items at this level-->
                   <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-                  <yle:UlkomainenHenkilotunniste>
-                    <yle:SyntymaAika>2014-06-27+03:00</yle:SyntymaAika>
-                    <!--Optional:-->
-                    <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-                  </yle:UlkomainenHenkilotunniste>
                   <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
                 </yle:YleinenHenkilotunniste>
+                <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
               </yle:Henkilo>
               <yle:Yritys>
                 <yle:Nimi>string</yle:Nimi>
                 <yle:YleinenYritysTunniste>
-                  <!--You have a CHOICE of the next 2 items at this level-->
                   <yle:Ytunnus>stringstr</yle:Ytunnus>
-                  <yle:UlkomainenYritysTunniste>
-                    <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-                    <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-                  </yle:UlkomainenYritysTunniste>
                 </yle:YleinenYritysTunniste>
                 <!--Optional:-->
                 <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+                <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
               </yle:Yritys>
-              <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
               <!--Optional:-->
               <yle:Puhelinnumero>string</yle:Puhelinnumero>
             </tila:Asiamies>

Muutokset Virheet-elementtiin:

   <yle:Virheet>
     <!--1 or more repetitions:-->
     <yle:Virhe>
       <!--Optional:-->
       <yle:Elementti>string</yle:Elementti>
-      <yle:VirheTunnus>string</yle:VirheTunnus>
-      <yle:VirheViesti>string</yle:VirheViesti>
+      <yle:VirheTunnus>36</yle:VirheTunnus>
+      <yle:VirheViesti>VIRHEELLINEN POSTINUMERO</yle:VirheViesti>
+      <!--Optional:-->
+      <yle:VapaaVirheViesti>string</yle:VapaaVirheViesti>
+      <!--Optional:-->
+      <yle:Kiinteistotunnus>stringstringstrings</yle:Kiinteistotunnus>
     </yle:Virhe>
   </yle:Virheet>

Skeemat kansio tila

Esimerkkitiedostot

Sanoma

Esimerkki tilakysely URL:stä: https://palvelu.nls.fi/v9/maanvuokraoikeuden_perustaminen/159/tila?ytunnus=1971814-3

Vastaus

Maanvuokraoikeuden perustaminen tilakyselynvastaus - asiakirja kesken

Skeema v8 12.12.2018

Tilarajapinnan skeemaversio 8, joka viedään tuotantoon 12.12.2018.

• Uusia tiloja asioille ja asiointipaketille
• Uusi asiakirjatyyppi maanvuokraoikeuden perustamiselle
• Uusia valinnaisia vanhenemispäivämäärä kenttiä
• Lisätty HavaittuVirhe-elementti, jonka avulla on mahdollista kertoa tapahtuneessa virheestä.
  • Esimerkiksi kiinnityshakemuksella (valmistelu ennakkoon) HavaittuVirhe voi sisältää tiedon miksi hakemusta ei saada vireille tai asiointipaketilla HavaittuVirhe voi sisältää tiedon miksi asiointipaketin eteneminen ei onnistu.
  • HavaittuVirhe-elementti ei kuitenkaan ole vielä toistaiseksi käytössä. Toteutus tulee vasta version 9 myötä.

Katso siirtyminen versiosta 7 versioon 8

Skeemat kansio tila

Esimerkkitiedostot

Sanoma

Esimerkki tilakysely URL:stä: https://palvelu.nls.fi/v8/maanvuokraoikeuden_perustaminen/15/tila?ytunnus=1971814-3

Vastaus

Maanvuokraoikeuden perustaminen tilakyselynvastaus - asiakirja kesken

Skeema v7 6.6.2018

Tilarajapinnan skeemaversio 7, joka viedään tuotantoon 6.6.2018.

Skeemaan lisätty elementti Asiointipaketti, joka palautetaan kun kysytään asiointipaketin tilaa. Tilarajapinta palauttaa asiointipaketin tilan, version sekä siihen lisättyjen yksittäisten asiakirjojen tilatietoja. Asiointipakettiin kuuluville yksittäisille asiakirjoille palautetaan seuraavat tiedot:

• Asiakirjan tilarajapinnan osoite
• Asiakirjan tunnus
• Asiakirjan tila
• Asiakirjan tyyppi
• Lähettäjän tiedot

Skeemat kansio tila

Skeema v6 21.2.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 6, joka viedään tuotantoon 21.2.2018.

YritykseltaPuuttuvatAllekirjoitukset kooste-elementtiin on isätty elementti TietoEiSaatavilla, joka tulee YritykseltaPuuttuvaAllekirjoitus elementin sijaan jos yrityksen nimenkirjoitusoikeuksia ei ole saatavilla.

Skeemat kansio tila

Muutoshistoria

Valmiiden asiakirjojen lataus -rajapinta

Yleiskuvaus

Rajapinnan kautta voidaan ladata asiakirjarajapinnan kautta lähetetyn asiakirjan lopullinen versio liitteineen.

Asiakirjat voi ladata kun asiakirja on tilassa lopullinen (tila voidaan tarkistaa tilarajapinnasta).

Rajoitukset ja huomiot

• Valmiit asiakirjat voi ladata ainoastaan mikäli pyytäjä on asiakirjan lähettänyt yritys. Luovutuskirjan tapauksessa pyytäjälle tulee lisäksi olla annettu järjestelmässä katseluoikeus kyseiseen asiakirjaan.
• Valmiita asiakirjoja tarjotaan 6kk asiakirjan valmistumisen jälkeen

Sanoma

Asiakirjat voidaan ladata HTTP GET-kutsulla kyseisen asiakirjan luonti/päivitys -rajapintakutsun vastauksessa palautettusta päivitys-osoitteesta.

Vastaus

Vastauksena annetaan suoraan asiakirjan tiedostot zip-pakattuna.

Virhetilanteissa palautetaan yleisen virheskeeman mukainen XML-virhesanoma.

Esimerkkikutsut

• https://palvelu.nls.fi/v11/kiinnityshakemukset/181?ytunnus=1234567-8
• https://palvelu.nls.fi/v11/luovutuskirjat/181123?ytunnus=1234567-8
• https://palvelu.nls.fi/v11/valtakirjat/1042165006?ytunnus=1234567-8
• https://palvelu.nls.fi/v11/siirtohakemukset/1042165007?ytunnus=1234567-8
• https://palvelu.nls.fi/v11/maanvuokraoikeuden_perustaminen/10421650456?ytunnus=1234567-8
• https://palvelu.nls.fi/v11/kiinnitysmuutos/1042165098?ytunnus=1234567-8
• https://palvelu.nls.fi/v11/lainhuutohakemukset/1042165076?ytunnus=1234567-8

Muutoshistoria

Asiakirjaluonnostelurajapinta - Maanvuokraoikeuden perustaminen

Yleiskuvaus

Maanvuokrasopimuksella sovitaan muun asuntoalueen vuokraamisesta asuintarkoitukseen tai rakentamista varten. Vuokrasopimuksella määrätään vuokraoikeuden pinta-ala. Kiinteistö voidaan vuokrata asuintarkoitukseen ja rakentamista varten. Vuokrasopimuksen osapuolien tulee sopia siitä, milloin vuokrasopimus tulee voimaan ja mikä on sen kestoaika. Vuokrasopimuksessa sovitaan myös siitä, onko vuokraoikeus siirrettävissä kolmannelle osapuolelle ilman vuokranantajan lupaa. Mikäli maanvuokrasopimus on määräaikainen, sillä on vuokralaisen omistama rakennus tai sille voi rakentaa ja vuokraoikeus on ilman vuokranantajan lupaa siirrettävissä, sille annetaan laitostunnus. Laitostunnuksellisen vuokraoikeuden voi kiinnittää. Mikäli vuokraoikeus ei täytä edellytyksiä määräaikaisuudesta, siirtämisestä ja rakentamisesta, se ei saa laitostunnusta. Tontinvuokrasopimusta ei ole mahdollista tehdä KVP:n kautta.

Mikäli päätös vuokraamisesta pitää vuokranantajan sääntöjen mukaan olla lainvoimainen, merkitään tieto lainvoimaisuudesta lähetettäessä vuokrasopimus allekirjoitettavaksi.

Vuokranantajana voi toimia vain kunta tai muu yhteisö.

12.12.2018 alkaen (v8) mahdollista ilmoittaa maanvuokraoikeuden perustaminen asiointipakettiin kuuluvaksi. Asiointipakettiin kuuluvassa kiinnityshakemuksessa (valmistelu ennakkoon) mahdollista kiinnittää uusi laitos.

Uusi maksuasetus tulee voimaan 1.1.2019. Uuden maksuasetuksen voimaantulon jälkeen asiakirjan lähettäjältä laskutetaan hakemusmaksu erityisen oikeuden kirjaamisesta.

20.3.2019 alkaen (v9) mahdollista ilmoittaa yksityishenkilö tai kuolinpesä vuokranantajaksi. Kaikki kuolinpesän osakkaat tulee ilmoittaa rajapinnassa. Kuolinpesän osakkaiden tulee olla elossa ja täysi-ikäisiä, eivätkä he voi olla holhouksessa. Yksi vuokralaisista ilmoitetaan luonnoksen vastaanottajaksi.

12.6.2019 alkaen (v10) mahdollista ilmoittaa useita kohteita maanvuokraoikeuden perustamiselle. Versiossa 10 on myös mahdollista hakea maanvuokrasopimuksen korvaamista tai vuokra-ajan jatkamista. Vuokraoikeus yksilöidään laitostunnuksella (L-tunnus).

Voimassaoloajan jatkaminen tarkoittaa esimerkiksi maanvuokraoikeuden osalta vuokrasuhteen jatkamista saman vuokrasopimuksen nojalla ja ehdoilla. Vuokra-aikaa voidaan pidentää enintään lain salliman maksimiajan mittaiseksi, esim. MVL 3 luvun mukaista muun asuntoalueen vuokraa yhteensä sataan vuoteen.

Vuokrasopimuksen muutoksella voidaan muuttaa myös ehtoja, jolloin vuokrasopimuksen muutos korvaa aiemman vuokrasopimuksen. Jatkamisen tai korvaamisen yhteydessä vuokralaisia ei voi muuttaaa.

Vuokrasopimuksen muuttaminen on allekirjoitettava ennen vanhan sopimuksen voimassaoloajan päättymistä.

19.2.2020 alkaen (v11) mahdollisuus valita haluaako ottaa hakemusmaksun laskulle vai maksetaanko se käyttöliittymässä.

Sanoma

tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Päivitys tehdään HTTP PUT-metodilla. Asiakirjan päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • KVPn antama tunnus maanvuokraoikeuden perustamiselle.
• AsiakirjaOsoite
  • URL, johon päivitetty maanvuokraoikeuden perustaminen lähetetään.
• AsiakirjaTilaOsoite
  • URL, joka palauttaa maanvuokraoikeuden perustamisen tilaan liittyviä tietoja.
• LiitetiedostoOsoite
  • URL, johon maanvuokraoikeuden perustamiseen liittyvät liitetiedostot lähetetään ZIP-paketissa. URL-osoitteen loppuun tulee lisätä parametri ytunnus (arvoksi tulee lähettäjän y-tunnus).
• EsikatseluOsoite
  • URL, josta voi ladata esikatselu-PDF:n lähetetystä maanvuokraoikeuden perustamisesta.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Skeema v14

Käsitemalli

Skeemat kansio kansio maanvuokraoikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Maanvuokraoikeuden korvaaminen esimerkki

Maanvuokraoikeuden jatkaminen esimerkki

Vastaus

Esimerkki maanvuokraoikeuden korvaaminen vastauksesta

Skeema v13

v13 skeemaan tulee päivitys 2.3.2022, jolloin julkaistaan seuraavat muutokset:

• Asiamiehen osoitetiedot, Postiosoite- elementti, on muutettu vapaaehtoiseksi.

+    <!--Optional:-->
       <yle:Postiosoite>

Käsitemalli

Skeemat kansio kansio maanvuokraoikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Maanvuokraoikeuden korvaaminen esimerkki

Maanvuokraoikeuden jatkaminen esimerkki

Vastaus

Esimerkki maanvuokraoikeuden korvaaminen vastauksesta

Skeema v12 17.2.2021

Rajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

Käsitemalli

Skeemat kansio kansio maanvuokraoikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Maanvuokraoikeuden korvaaminen esimerkki

Maanvuokraoikeuden jatkaminen esimerkki

Vastaus

Esimerkki maanvuokraoikeuden korvaaminen vastauksesta

Skeema v11 19.2.2020

Rajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

Lisätty mahdollisuus valita haluaako ottaa hakemusmaksun laskulle.

• Mikäli HakemusTaiAsiointimaksuLaskulle -elementtiä ei anneta tai sen arvo on false, hakemusmaksua ei enää laskuteta lähettäjältä, vaan vuokralaisen tulee maksaa se käyttöliittymässä
• Rekisteriotteita ei ole mahdollista ostaa, vaikka elementti RekisteriotteetLaskulle on skeemassa määritelty
• LaskutuksenViiteTiedot -elementti on LaskulleOtettavatPalvelut -elementin sisällä

-  <!--Optional:-->
-  <yle:LaskutuksenViiteTiedot>
-    <!--Optional:-->
-    <yle:LaskutusKoontiavain>string</yle:LaskutusKoontiavain>
-    <!--Optional:-->
-    <yle:AsiakkaanViite>
-      <!--Optional:-->
-      <yle:Viitteenne>string</yle:Viitteenne>
-      <!--Optional:-->
-      <yle:Tiliointiviite>string</yle:Tiliointiviite>
-      <!--Optional:-->
-      <yle:Tilausnumero>string</yle:Tilausnumero>
-      <!--Optional:-->
-      <yle:Sopimusnumero>string</yle:Sopimusnumero>
-      <!--Optional:-->
-      <yle:TyomaaAvain>string</yle:TyomaaAvain>
-    </yle:AsiakkaanViite>
-  </yle:LaskutuksenViiteTiedot>
+  <!--Optional:-->
+  <yle:_>
+    <yle:HakemusTaiAsiointimaksuLaskulle>true</yle:HakemusTaiAsiointimaksuLaskulle>
+    <!--Optional:-->
+    <yle:RekisteriotteetLaskulle>
+      <!--1 or more repetitions:-->
+      <yle:RekisterioteLaskulle>
+        <yle:KohdeKiinteisto>stringstringstrings</yle:KohdeKiinteisto>
+        <yle:Rekisteriotteet>
+          <!--1 to 4 repetitions:-->
+          <yle:Rekisteriote>LH</yle:Rekisteriote>
+        </yle:Rekisteriotteet>
+      </yle:RekisterioteLaskulle>
+    </yle:RekisteriotteetLaskulle>
+    <!--Optional:-->
+    <yle:LaskutuksenViiteTiedot>
+      <!--Optional:-->
+      <yle:LaskutusKoontiavain>string</yle:LaskutusKoontiavain>
+      <!--Optional:-->
+      <yle:AsiakkaanViite>
+        <!--Optional:-->
+        <yle:Viitteenne>string</yle:Viitteenne>
+        <!--Optional:-->
+        <yle:Tiliointiviite>string</yle:Tiliointiviite>
+        <!--Optional:-->
+        <yle:Tilausnumero>string</yle:Tilausnumero>
+        <!--Optional:-->
+        <yle:Sopimusnumero>string</yle:Sopimusnumero>
+        <!--Optional:-->
+        <yle:TyomaaAvain>string</yle:TyomaaAvain>
+      </yle:AsiakkaanViite>
+    </yle:LaskutuksenViiteTiedot>
+  </yle:LaskulleOtettavatPalvelut>

Käsitemalli

Skeemat kansio kansio maanvuokraoikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Maanvuokraoikeuden korvaaminen esimerkki

Maanvuokraoikeuden jatkaminen esimerkki

Vastaus

Esimerkki maanvuokraoikeuden korvaaminen vastauksesta

Skeema v10 12.6.2019

Rajapinnan skeemaversio 10, joka viedään tuotantoon 12.6.2019.

Lisätty MuutettavaMaanvuokraoikeus-elementti, jonka avulla ilmoitetaan

• Onko kyseessä korvaava vai jatkava sopimus
• Vuokraoikeuden tunnus johon muutokset kohdistuvat
• Vuokraoikeuden pinta-ala ennen jatkavaa/korvaavaa sopimusta. Pinta-ala imoitetaan kokonaislukuna neliömetreissä (m²).

<maan:MaanvuokraoikeudenPerustaminenPerusTiedot>
  <yle:Versio>201</yle:Versio>
  <!--Optional:-->
  <yle:VainEsikatselu>false</yle:VainEsikatselu>
  <yle:AsiaKieli>fi</yle:AsiaKieli>
  <!--Optional:-->
+ <maan:MuutettavaMaanvuokraoikeus>
+   <!--You have a CHOICE of the next 2 items at this level-->
+   <maan:JatkavaVuokrasopimus>true</maan:JatkavaVuokrasopimus>
+   <maan:KorvaavaVuokrasopimus>true</maan:KorvaavaVuokrasopimus>
+   <maan:VuokraoikeudenTunnus>stringstringstrings</maan:VuokraoikeudenTunnus>
+   <maan:NykyinenPintaAla yksikko="M2">201</maan:NykyinenPintaAla>
+ </maan:MuutettavaMaanvuokraoikeus>

Vuokrakohteita voi olla useita:

• Lisätty uusi MaanvuokraoikeudenKohteet-elementti, jonka sisälle Kiinteistotunnus on siirretty

- <yle:Kiinteistotunnus>stringstringstrings</yle:Kiinteistotunnus>
+ <maan:MaanvuokraoikeudenKohteet>
+   <!--1 or more repetitions:-->
+   <yle:Kiinteistotunnus>stringstringstrings</yle:Kiinteistotunnus>
+ </maan:MaanvuokraoikeudenKohteet>

PintaAla-elementin yksikkö ilmoitetaan jatkossa aina neliömetreissä. Vaihtoehdot aari (a) ja hehtaari (ha) on poistettu skeemasta. Tällä elementillä ilmoitetaan vuokraoikeuden pinta-ala perustamisen/jatkamisen/korvaamisen jälkeen. Pinta-ala voi korvaamisen/jatkamisen yhteydessä kasvaa tai pienentyä.

  <yle:PintaAla yksikko="M2">201</yle:PintaAla>

Muutokset Voimassaolo-elementtiin:

• Voimassaoloaika -elementti on poistettu

• Lisätty uusia elementtejä:

  • VoimassaToistaiseksi: toistaiseksi voimassa oleva sopimus
  • Paattymispvm: vuokrasopimuksen päättymispäivämäärä
  • VoimassaoloJatkuuVuosittain: vuokrasopimus jatkuu vuosittain yhteensä X vuoden ajan
  • VoimassaoloJatkuuVuosiaKerrallaan: vuokrasopimus jatkuu X vuotta kerrallaan

Vuokrasopimuksen keston osalta on siis käytettävissä kolme vaihtoehtoista elementtiä: VuokrasopimuksenKesto, VoimassaToistaiseksi tai Paattymispvm.

VoimassaoloJatkuuVuosittain tai VoimassaoloJatkuuVuosiaKerrallaan -elementit ovat käytettävissä vain kun vuokrasopimuksen kesto on jotain muuta kuin VoimassaToistaiseksi.

  <maan:Voimassaolo>
-   <maan:Voimassaoloaika>MA</maan:Voimassaoloaika>
    <maan:Alkupvm>2006-08-19+03:00</maan:Alkupvm>
+   <!--You have a CHOICE of the next 3 items at this level-->
    <maan:VuokrasopimuksenKesto>100</maan:VuokrasopimuksenKesto>
+   <maan:VoimassaToistaiseksi>false</maan:VoimassaToistaiseksi>
+   <maan:Paattymispvm>2013-05-22+03:00</maan:Paattymispvm>
+   <!--You have a CHOICE of the next 2 items at this level-->
+   <maan:VoimassaoloJatkuuVuosittain>201</maan:VoimassaoloJatkuuVuosittain>
+   <maan:VoimassaoloJatkuuVuosiaKerrallaan>201</maan:VoimassaoloJatkuuVuosiaKerrallaan>
  </maan:Voimassaolo>

• Vuokralainen-elementtiin lisätty uusi elementti KenenLukuun, jolla ilmoitetaan kenen lukuun vuokralainen toimii. Vaihtoehdot ovat:
  • OL: Omaan lukuun
  • YL: Perustettavan yhtiön lukuun
  • AL: Perustettavan asunto-osakeyhtiön lukuun
  • ML: Muun lukuun
• Mikäli KenenLukuunValinta vaihtoehdoksi valitaan ML, tulee antaa myös elementti MuunLukuunSelite.

<maan:Vuokralainen>
  <!--You have a CHOICE of the next 2 items at this level-->
  <yle:Henkilo>
    <yle:Etunimi>string</yle:Etunimi>
    <yle:Sukunimi>string</yle:Sukunimi>
    <yle:YleinenHenkilotunniste>
      <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
      <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
    </yle:YleinenHenkilotunniste>
    <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
  </yle:Henkilo>
  <yle:Yritys>
    <yle:Nimi>string</yle:Nimi>
    <yle:YleinenYritysTunniste>
      <yle:Ytunnus>stringstr</yle:Ytunnus>
    </yle:YleinenYritysTunniste>
    <!--Optional:-->
    <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
    <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
  </yle:Yritys>
  <!--Optional:-->
  <yle:Osuus>string</yle:Osuus>
+ <yle:KenenLukuun>
+   <yle:KenenLukuunValinta>OL</yle:KenenLukuunValinta>
+   <!--Optional:-->
+   <yle:MuunLukuunSelite>string</yle:MuunLukuunSelite>
+ </yle:KenenLukuun>
</maan:Vuokralainen>

Skeemaan on lisätty mahdollisuus ilmoittaa Suostujat.

+<!--Optional:-->
+<yle:Suostujat>
+  <!--1 or more repetitions:-->
+  <yle:Suostuja>
+    <!--You have a CHOICE of the next 2 items at this level-->
+    <yle:Henkilo>
+      <yle:Etunimi>string</yle:Etunimi>
+      <yle:Sukunimi>string</yle:Sukunimi>
+      <yle:YleinenHenkilotunniste>
+        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+      </yle:YleinenHenkilotunniste>
+      <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+    </yle:Henkilo>
+    <yle:Yritys>
+      <yle:Nimi>string</yle:Nimi>
+      <yle:YleinenYritysTunniste>
+        <yle:Ytunnus>stringstr</yle:Ytunnus>
+      </yle:YleinenYritysTunniste>
+      <!--Optional:-->
+      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+      <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+    </yle:Yritys>
+  </yle:Suostuja>
+</yle:Suostujat>

Kayttotarkoitus-elementti on siirretty VuokrasopimuksenEhdot-elementin sisään. Sallitut vaihtoehdot ovat myös muuttuneet seuraaviksi:

• AS = Asuntoalueen vuokrasopimus
• MA = Maatalousmaan vuokrasopimus
• MU = Muu maanvuokrasopimus

AsuntoalueenVuokrasopimus-elementti on poistettu.

- <maan:Kayttotarkoitus>RA</maan:Kayttotarkoitus>
  <maan:VuokrasopimuksenEhdot>
-   <maan:AsuntoalueenVuokrasopimus>false</maan:AsuntoalueenVuokrasopimus>
+   <maan:Kayttotarkoitus>AS</maan:Kayttotarkoitus>
    <maan:Siirtooikeus>false</maan:Siirtooikeus>
    <maan:Rakennusoikeus>true</maan:Rakennusoikeus>

Skeemat kansio kansio maanvuokraoikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Maanvuokraoikeuden korvaaminen esimerkki

Maanvuokraoikeuden jatkaminen esimerkki

Vastaus

Esimerkki maanvuokraoikeuden korvaaminen vastauksesta

Skeema v9 20.3.2019

Rajapinnan skeemaversio 9, joka viedään tuotantoon 20.3.2019.

• Mahdollisuus ilmoittaa yksityishenkilö tai kuolinpesä vuokranantajaksi.
• LuonnoksenVastaanottaja-elementti on poistettu Vuokralainen-elementin sisältä. Sen sijaan elementti annetaan vain kerran ja siinä ilmoitetaan vastaanottavan osapuolen henkilö- tai y-tunnus.
• Vuokralaisen ja Vuokranantajan Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään.
• Asiamiehen Sahkopostiosoite-elementti on siirretty Henkilo- ja Yritys-elementtien sisään. Puhelinnumero-elementti on siirretty Postiosoite-elementin yläpuolelle.
  • Asiamiehen laskutusosoitetta ei tule antaa. Hakemusmaksu erityisen oikeuden kirjaamisesta laskutetaan asiakirjan lähettäjältä.

Muutokset Vuokralaiset-elementtiin:

<maan:Vuokralaiset>
  <!--1 or more repetitions:-->
  <maan:Vuokralainen>
    <!--You have a CHOICE of the next 2 items at this level-->
    <yle:Henkilo>
      <yle:Etunimi>string</yle:Etunimi>
      <yle:Sukunimi>string</yle:Sukunimi>
      <yle:YleinenHenkilotunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
-        <yle:UlkomainenHenkilotunniste>
-          <yle:SyntymaAika>2018-11-01+02:00</yle:SyntymaAika>
-          <!--Optional:-->
-          <yle:UlkomainenHenkilotunnus>string</yle:UlkomainenHenkilotunnus>
-        </yle:UlkomainenHenkilotunniste>
        <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
      </yle:YleinenHenkilotunniste>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Henkilo>
    <yle:Yritys>
      <yle:Nimi>string</yle:Nimi>
      <yle:YleinenYritysTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Ytunnus>stringstr</yle:Ytunnus>
-        <yle:UlkomainenYritysTunniste>
-          <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-          <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-        </yle:UlkomainenYritysTunniste>
      </yle:YleinenYritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Yritys>
-   <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
-   <yle:LuonnoksenVastaanottaja>true</yle:LuonnoksenVastaanottaja>
+   <!--Optional:-->
    <yle:Osuus>string</yle:Osuus>
  </maan:Vuokralainen>
</maan:Vuokralaiset>
+ <yle:LuonnoksenVastaanottaja>
+   <!--You have a CHOICE of the next 2 items at this level-->
+   <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+   <yle:Ytunnus>stringstr</yle:Ytunnus>
+ </yle:LuonnoksenVastaanottaja>

Muutokset Vuokranantajat-elementtiin:

<maan:Vuokranantajat>
  <!--1 or more repetitions:-->
  <maan:Vuokranantaja>
+   <!--You have a CHOICE of the next 3 items at this level-->
+   <yle:Henkilo>
+     <yle:Etunimi>string</yle:Etunimi>
+     <yle:Sukunimi>string</yle:Sukunimi>
+     <yle:YleinenHenkilotunniste>
+       <!--You have a CHOICE of the next 2 items at this level-->
+       <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+       <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+     </yle:YleinenHenkilotunniste>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+   </yle:Henkilo>
    <yle:Yritys>
      <yle:Nimi>string</yle:Nimi>
      <yle:YleinenYritysTunniste>
        <!--You have a CHOICE of the next 2 items at this level-->
        <yle:Ytunnus>stringstr</yle:Ytunnus>
-       <yle:UlkomainenYritysTunniste>
-         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
-         <yle:UlkomainenYtunnus>string</yle:UlkomainenYtunnus>
-       </yle:UlkomainenYritysTunniste>
-     </yle:YleinenYritysTunniste>
      <!--Optional:-->
      <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+     <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
    </yle:Yritys>
+   <yle:Kuolinpesa>
+     <yle:Vainaja>
+       <yle:Etunimi>string</yle:Etunimi>
+       <yle:Sukunimi>string</yle:Sukunimi>
+       <yle:YleinenHenkilotunniste>
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+         <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+       </yle:YleinenHenkilotunniste>
+     </yle:Vainaja>
+     <yle:Osakkaat>
+       <!--1 or more repetitions:-->
+       <yle:Osakas>
+         <!--You have a CHOICE of the next 2 items at this level-->
+         <yle:Henkilo>
+           <yle:Etunimi>string</yle:Etunimi>
+           <yle:Sukunimi>string</yle:Sukunimi>
+           <yle:YleinenHenkilotunniste>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Henkilotunnus>stringstrin</yle:Henkilotunnus>
+             <yle:Kotimaakoodi>st</yle:Kotimaakoodi>
+           </yle:YleinenHenkilotunniste>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Henkilo>
+         <yle:Yritys>
+           <yle:Nimi>string</yle:Nimi>
+           <yle:YleinenYritysTunniste>
+             <!--You have a CHOICE of the next 2 items at this level-->
+             <yle:Ytunnus>stringstr</yle:Ytunnus>
+           </yle:YleinenYritysTunniste>
+           <!--Optional:-->
+           <yle:Yhteyshenkilo>string</yle:Yhteyshenkilo>
+           <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
+         </yle:Yritys>
+       </yle:Osakas>
+     </yle:Osakkaat>
+   </yle:Kuolinpesa>
-   <yle:Sahkopostiosoite>string</yle:Sahkopostiosoite>
  </maan:Vuokranantaja>
</maan:Vuokranantajat>

Skeemat kansio kansio maanvuokraoikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Maanvuokraoikeuden perustaminen esimerkki, kuolinpesä vuokranantajana

Vastaus

Esimerkki maanvuokraoikeuden perustaminen vastauksesta

Skeema v8 12.12.2018

• Skeemaan lisätty vapaaehtoinen elementti Asiointipakettitunnus.
• Skeemaan lisätty vapaaehtoinen elementti LaskutuksenViiteTiedot.
  • Maanvuokraoikeuden perustamishakemuksen mennessä vireille muodostuu siitä 1.1.2019 alkaen lähettäjälle hakemusmaksun sisältävä lasku. Lähettäjä voi halutessaan kertoa tällä elementillä tarkempia laskutukseen liittyviä tietoja.

Skeemat kansio maanvuokraoikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Maanvuokraoikeuden perustaminen esimerkki

Vastaus

Esimerkki maanvuokraoikeuden perustaminen vastauksesta

Skeema v7 6.6.2018

Rajapinnan skeemaversio 7, joka viedään tuotantoon 6.6.2018.

• Skeemasta on poistettu elementit Tontinvuokrasopimus ja Tontinvuokraoikeus. Tontinvuokrasopimusta ei ole mahdollista tehdä KVP:n kautta.

Skeemat kansio maanvuokraoikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Maanvuokraoikeuden perustaminen esimerkki

Vastaus

Esimerkki maanvuokraoikeuden perustaminen vastauksesta

Skeema v6 21.2.2018

Skeeman mukautus asiakirjarajapinnan skeemaversioon 6, joka viedään tuotantoon 21.2.2018.

Skeemat kansio maanvuokraoikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Maanvuokraoikeuden perustaminen esimerkki

Vastaus

Esimerkki maanvuokraoikeuden perustaminen vastauksesta

Muutoshistoria

Asiakirjaluonnostelurajapinta - Asiointipaketti

Yleiskuvaus

Asiointipaketti on Kiinteistövaihdannan palvelun prosessi jolla hallinnoidaan kiinteistön asiakokonaisuuteen liittyviä sähköisiä hakemuksia. Asiakkaat voivat lähettää samaa kiinteistöä koskevia hakemuksia asiointipakettiin Kiinteistövaihdannan palveluun käsiteltäväksi ja allekirjoitettavaksi. Asiointipaketti-prosessi valvoo hakemusten allekirjoitusjärjestystä ja hakemusten lähetystä Kirre-kirjaamisjärjestelmään.

Kesäkuun 2018 versiossa luodaan asiointipaketin käsittelyprosessi sekä julkaistaan ensimmäinen toiminto, uuden määräalan kiinnityshakemus (valmistelu ennakkoon). Uuden määräalan kiinnitystä ennakkoon ei aiemmin ole pystynyt lähettämään Kiinteistövaihdannan palveluun.

Asiointipaketti valmistuu useammassa osassa, eri julkaisuissa. Ensimmäisessä versiossa (v7) asiointipakettiin voi lähettää määräalan luovutuskirjan sekä kiinnityshakemuksen (valmistelu ennakkoon) luovutuksen kohteena olevalle uudelle määräalalle.

Versiossa 8 voi pakettiin lisätä vuokraoikeuden ja kiinnityksen perustettavaan vuokraoikeuteen.

Asiointipaketin vaiheet

Alla olevassa kuvassa näytetään asiointipaketin käytön vaiheet kun halutaan perustaa maanvuokraoikeus ja kiinnittää uusi laitos:

Sanoma

tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Päivitys tehdään HTTP PUT-metodilla. Asiakirjan päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • KVPn antama tunnus asiointipaketille.
• AsiakirjaOsoite
  • URL, johon päivitetty asiointipaketti lähetetään.
• AsiakirjaTilaOsoite
  • URL, joka palauttaa asiakirjan tilaan liittyviä tietoja.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Skeema v14

Käsitemalli

Skeemat kansio asiointipakettirajapinta

Esimerkkitiedostot

Sanoma

Esimerkki asiointipaketin luonnista

Vastaus

Esimerkki asiointipakettirajapinnan vastauksesta

Skeema v13

Käsitemalli

Skeemat kansio asiointipakettirajapinta

Esimerkkitiedostot

Sanoma

Esimerkki asiointipaketin luonnista

Vastaus

Esimerkki asiointipakettirajapinnan vastauksesta

Skeema v12 17.2.2021

Asiointipakettirajapinnan skeemaversio 12, joka viedään tuotantoon 17.2.2021.

Käsitemalli

Skeemat kansio asiointipakettirajapinta

Esimerkkitiedostot

Sanoma

Esimerkki asiointipaketin luonnista

Vastaus

Esimerkki asiointipakettirajapinnan vastauksesta

Skeema v11 19.2.2020

Asiointipakettirajapinnan skeemaversio 11, joka viedään tuotantoon 19.2.2020.

Käsitemalli

Skeemat kansio asiointipakettirajapinta

Esimerkkitiedostot

Sanoma

Esimerkki asiointipaketin luonnista

Vastaus

Esimerkki asiointipakettirajapinnan vastauksesta

Skeema v10 12.6.2019

Asiointipakettirajapinnan skeemaversio 10, joka viedään tuotantoon 12.6.2019.

Versiomuutoksen lisäksi ei muita muutoksia v9 ja v10 välillä.

Skeemat kansio asiointipakettirajapinta

Esimerkkitiedostot

Sanoma

Esimerkki asiointipaketin luonnista

Vastaus

Esimerkki asiointipakettirajapinnan vastauksesta

Skeema v9 20.3.2019

Asiointipakettirajapinnan skeemaversio 9, joka viedään tuotantoon 20.3.2019.

Versiomuutoksen lisäksi ei muita muutoksia v8 ja v9 välillä.

Skeemat kansio asiointipakettirajapinta

Esimerkkitiedostot

Sanoma

Esimerkki asiointipaketin luonnista

Vastaus

Esimerkki asiointipakettirajapinnan vastauksesta

Skeema v8 12.12.2018

Ei skeemamuutoksia (muutos vuokraoikeuden skeemassa).

Skeemat kansio asiointipakettirajapinta

Esimerkkitiedostot

Sanoma

Esimerkki asiointipaketin luonnista

Vastaus

Esimerkki asiointipakettirajapinnan vastauksesta

Skeema v7 6.6.2018

Tämä on skeeman ensimmäinen versio, joka viedään tuotantoon 6.6.2018.

Skeemat kansio asiointipakettirajapinta

Esimerkkitiedostot

Sanoma

Esimerkki asiointipaketin luonnista

Vastaus

Esimerkki asiointipakettirajapinnan vastauksesta

Muutoshistoria

Luontitiedot

Yleiskuvaus

Luontitiedot-rajapinnasta voidaan hakea lähdeasiakirjatunnuksella samat tiedot kuin mitä saadaan rajapinnasta asiakirjan luonnin yhteydessä. Lähdeasiakirjatunnus ei ole käytössä lainhuutohakemus- ja asiointipaketti-rajapinnoissa, joten näiden kahden asiatyypin tietoja ei voida hakea Luontitiedot-rajapinnasta.

Sanoma

Esimerkki pyynnöstä: https://palvelu.nls.fi/v12/luontitiedot?lahdeasiakirjatunnus=AB34CD8&ytunnus=1234567-8

Rajapinnan versiossa 11 ja sitä vanhemmissa lähdeasiakirjatunnus parametrin sijasta polkuun: https://palvelu.nls.fi/v11/luontitiedot/AB34CD8&ytunnus=1234567-8

Muutoshistoria

Asiakirjarajapinta - Erityisen oikeuden kirjaushakemus

1. Yleiskuvaus

Rajapinnan kautta voidaan toimittaa Maanmittauslaitokselle valmis kirjallinen erityisen oikeuden kirjaushakemus. Rajapinnan kautta toimitetaan hakemuksen kaikki tiedot rakenteellisena käsittelyn nopeuttamiseksi.

Hakemus menee suoraan vireille liitetiedostojen toimittamisen jälkeen jos tiedoissa ei havaita ongelmia. Liitetiedostojen sallitut tiedostomuodot ovat pdf ja jpg. Jos liitetiedostoja ei ole, hakemus menee suoraan vireille.

Hakemukselle voidaan antaa VainEsikatselu-elementti, jolloin lähetettyä hakemusta ei laiteta vireille, mutta sen esikatselu-pdf:n voi ladata rajapinnan palauttamasta esikatseluosoitteesta.

Valmiin hakemuksen liitteineen voi ladata zip-tiedostona.

2. Sanoma

Hakemuksen tiedot välitetään rajapintaan XML-muotoisena, käyttäen HTTP POST-metodia. Päivitys tehdään HTTP PUT-metodilla. Hakemuksen päivitysosoite saadaan ensimmäisen POST-viestin vastauksesta.

Lainhuutohakemussanomaan merkityt liitetiedostot tulee lähettää vastaussanomassa välitettyyn URL-osoitteeseen pakattuna yhteen ZIP-tiedostoon HTTP POST-metodia käyttäen. Content-type "application/zip".

3. Vastaus

Tuloksena rajapinta palauttaa kutsuvalle sovellukselle XML-muotoisen vastauksen.

Vastauksen tietosisällön yleiskuvaus:

AsiakirjaTiedot

• AsiakirjaTunnus
  • Asiakirjarajapintapalvelun antama tunnus hakemukselle.
• AsiakirjaOsoite
  • URL, johon päivitetty asiakirjaluonnos tulee lähettää. Päivitys on mahdollista vain mikäli ensin on lähetty hakemus jossa VainEsikatselu-elementti (arvona true).
• AsiakirjaTilaOsoite
  • URL, joka palauttaa hakemuksen tilaan liittyviä tietoja.
• LiitetiedostoOsoite
  • URL, johon lainhuutohakemukseen liittyvät liitetiedostot lähetetään ZIP-paketissa. URL-osoitteen loppuun tulee lisätä parametri ytunnus (arvoksi tulee lähettäjän y-tunnus).
• EsikatseluOsoite
  • URL, josta voi ladata esikatselu-PDF:n lähetetystä hakemuksesta.
• Virheet 0..n
  • Virhe
    • Sanomaan tai sen käsittelyyn liittyvä virhe.

Skeema v14 (päivityksiä 7.6.2023)

7.6.2023 julkaistavassa päivityksestä liitetiedostoille on lisätty vapaaehtoinen elementti AsiakirjanLuontiPvm.

  <yle:Liitetiedosto>
    <yle:Nimi>string</yle:Nimi>
    <!--Optional:-->
    <yle:Kuvaus>string</yle:Kuvaus>
    <yle:InternetMediaType>string</yle:InternetMediaType>
    <yle:LiitetiedostoLaji>string</yle:LiitetiedostoLaji>
+   <!--Optional:-->
+   <yle:AsiakirjanLuontiPvm>2000-01-06</yle:AsiakirjanLuontiPvm>
  </yle:Liitetiedosto>

Käsitemalli

Skeemat kansio erityisen_oikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Erityisenoikeudenhakemusesimerkki

Vastaus

Esimerkki erityisenoikeudenhakemuksen vastauksesta

Skeema v13 (julkaisu 13.12.2021, päivityksiä 2.3.2022)

Tämä on skeeman ensimmäinen versio, joka viedään tuotantoon 13.12.2021.

v13 skeemaan tulee päivitys 2.3.2022, jolloin julkaistaan seuraavat muutokset:

• Uusi vapaaehtonen elementti Laskutustiedot, tämä elementti on tarkoitettu vain Maanmittauslaitoksen sisäiseen käyttöön.
• Asiamiehen osoitetiedot, Postiosoite- ja Laskutusosoite, on muutettu vapaaehtoiseksi.

+    <!--Optional:-->
+      <yle:Laskutustiedot>
+        <yle:Maksu>VERKKOMAKSU</yle:Maksu>
+        <yle:Tilausnumero>string</yle:Tilausnumero>
+        <yle:TuoteTunnus>string</yle:TuoteTunnus>
+        <yle:MaksettuSumma>1000.00</yle:MaksettuSumma>
+    </yle:Laskutustiedot>

+    <!--Optional:-->
       <yle:Postiosoite>

+    <!--Optional:-->
       <lain:Laskutusosoite>

Käsitemalli

Skeemat kansio erityisen_oikeuden_perustaminen_rajapinta

Esimerkkitiedostot

Sanoma

Erityisenoikeudenhakemusesimerkki

Vastaus

Esimerkki erityisenoikeudenhakemuksen vastauksesta

Muutoshistoria

Asiakirjaluonnostelurajapinta - Yleiset Virheet

Yleiskuvaus

Asiakirjarajapintojen mahdolliset virhevastaukset. Osa virhekoodeista on rajapinta- ja operaatiokohtaisia, esim. virhekoodi "46 Yhteiskiinnityksen purkaminen annetuilla tiedoilla ei ole sallittua", voi tulla vain yhteiskiinnityksen purkamishakemukselle. Kaikki virhekoodit ja -viestit noudattavat kuitenkin samaa skeemaa.

Sanoma

Virheviesti voi tulla vastauksena mihin tahansa sanomaan

Vastaus

Seuraavassa on esimerkkejä vastauksista