ULOSOTON HAKIJOIDEN LÄHETTÄMÄT SÄHKÖISET HAKEMUS- JA MUUTOSTIEDOT XML-TIEDOSTOMUODOSSA

ULOSOTON HAKIJOIDEN LÄHETTÄMÄT SÄHKÖISET HAKEMUS- JA MUUTOSTIEDOT XML-TIEDOSTOMUODOSSA OIKEUSMINISTERIÖ OIKEUSHALLINNON TIETOTEKNIIKKAKESKUS

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 2(24) VERSIOHISTORIA Versio Aihe Tekijä Pvm 1.0 Päivitetty seuraavia tietoja: Muutokset voimaan aikaisintaan 6.10.2004 Tuomion sisältötiedot ja koron määräytymistapa eli Tekopvm:n selite Haastekielto Koron määräytymistapa Lisätty muuntorangaistus tuomion sisältöön OIKEUSMINISTERIÖ: T A-F 21.09.2004 1.1 Asiamiehen sähköisen hakemisen aiheuttamat muutokset. WM-data 16.6.2006 Asialta poistettu HakijaIdref: Asiakirjatilityksen saaja on aina hakemuksen läh. sähköinen hakija/asiamies. Hakijalta poistettu valtakirja-elementti ja lisätty valtakirjantunnus-elementti. Lisäksi lisätty tili elementti.(voidaan käyttää hakijan tunnistamiseen jos hetu/y-tunnus puuttuu) Muokattu saatavan hakija- Idref selitettä. 1.2 Ulosottoperusteen määräaikaisuuden aiheuttamat muutokset. WM-data 27.3.2007 Täytäntöönpanoperusteellelisätty elementit:selite, vanhentumispvm, maaraaika, maaraajanselite

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 3(24) 1 Sähköisestä hakemisesta... 4 2 Sähköinen hakemus(erä)... 4 Sähköinen hakija ja hakemuserän tiedot...4 Hakemus...5 2.2.1 Asian tiedot...5 Täytäntöönpanoperuste...5 2.2.3 Tuomion sisältö...6 Asian lisätieto...6 Asian liitetieto...7 Saatava...7 Saatavan osuus...7 Viivästyskorko...8 Velallinen...8 Henkilön nimi (hennimi)...9 Henkilön osoite (osoite)...9 Velallisen lisätieto...10 Hakija...10 Tili...11 Valtakirja... 11 3 Sähköinen muutos(erä)...11 Muutoserä...11 Muutos (muutoshakemus)...12 Peruutus...12 Maksumuutos...13 Maksumuutoksen saatavat (maksumuutoksensaatava)...13 Saatavamuutos...14 Asian saatavatiedot (saatava)...14 Viivästyskorko...14 Asian muu muutos...15 Täytäntöönpanon keskeytys...15 Hakija...15 4 Yleistä XML:stä...16 5 Hakemuserätiedoston DTD-kuvaus...16 6 Muutoserätiedoston DTD-kuvaus...18 7 Esimerkki hakemuserän xml-tiedostosta... 20 8 Esimerkki asimiehen hakemuserän xml-tiedostosta... 21 9 Esimerkki muutoserän xml-tiedostosta... 24

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 4(24) 1Sähköisestä hakemisesta Sähköisellä hakijalla (tai asiamiehellä) pitää olla oikeusministeriön ulosottotoimiston myöntämä voimassaoleva lupa lähettää ao. ulosotto-hakemuksia sähköisesti (tiedostomuodossa) ulosottoon. Hakija on tällöin rekisteröity uuteen ulosoton tietojärjestelmään, Uljakseen, sähköiseksi hakijaksi (valtakunnallinen) ja hänet tunnistetaan sähköisen hakijan tunnuksen perusteella. OM:n oikeushallinnon tietotekniikkakeskus antaa sähköisen hakijan tunnukset. Hakemuserä koostuu yhdestä sähköisestä hakijasta hakemuserätietoineen ja yhdestä tai useammasta hakemuksesta taikka muutoksesta. Hakemukset ja niiden muutokset toimitetaan eri tiedostoissa (omina erinään). Tiedostot toimitetaan xml-tiedostomuodossa noudattaen ao. dtd-kuvauksia, jotka määrittelevät tiedoston rakenteen ja tietosisällön. Hakijoiden tulee validoida xml-hakemus/muutostiedostonsa ennen niiden ulosottoon lähettämistä käyttäen ao. dtd-tiedostoja. Tiedostot ovat saatavissa (sähköisessä muodossa) oikeusministeriön ulosoton www-sivuilta. Seuraavassa on käyty läpi sähköisen hakemuksen ja muutoksen tiedostorakenne sekä xml-dokumenttien rakenne. 2Sähköinen hakemus(erä) Hakemuserätiedosto nimetään siten, että se muodostuu hakijan sähköisen hakijan tunnuksesta ja kyseisen hakemuserän tunnisteesta. Tiedostonimessä käytetään vain pieniä kirjaimia. Esim. 102h00103.xml, jossa hakijatunnus on 102 ja h00103 kertoo kyseessä olevan hakijan ensimmäinen hakemustiedosto vuonna 2003. Muutoserätiedosto nimetään vastaavasti (mutta käyttäen vakiota m ). Sähköinen hakija ja hakemuserän tiedot Hakemustiedoston alussa on kertaalleen hakijan tunniste- ja mahdolliset yhteystiedot (henkilö johon voi ottaa yhteyttä, jos tiedoston vastaanotossa tai teknisessä sisällössä on ongelmia) sekä erän tunnistetiedot. tunnus 5 attribuutti Sähköisen hakijan tunnus, esim. 101 era 6 attribuutti Tiedoston tunnus, muoto H999VV lahetyspvm 10 elementti Lähetyspäivä (pp.kk.vvvv) hakemuslaji 4 elementti Sähköisen hakijan ulosoton hakemis -luvassa todettu asialajikoodi yhteyshlonimi 40 elementti Yhteyshenkilön nimi yhteyshlopuhnro 18 elementti Yhteyshenkilön puhelinnumero yhteyshlosposti 80 elementti Yhteyshenkilön sähköpos-

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 5(24) tiosoite Täytäntöönpanoperuste Hakemus Yhteen tiedostoerään voi kuulua 1 99 999 (hakemus)asiaa. 2.2.1Asian tiedot Yksittäinen hakemus koostuu seuraavista tietoista: nimi pituus tyyppi Selitys nro 5 attribuutti Hakemuksen numero; juoksee hakemuserän sisällä, esim. 00001. HakijaIdref 9 attribuutti (idref) Asiakirjatilityksen saaja, viittaus asian hakijaan. Jos puuttuu = hakemuksen läh. sähköinen hakija/asiamies. asianimi 4 elementti Asianimi, koodiarvo (vanha asialaji) viite1 20 elementti Hakijan viitetieto 1, pakollinen tietyillä hakijoilla viite2 20 elementti Hakijan viitetieto 2 viitenro 20 elementti Hakijan viitenumero selite 20 elementti Hakijan selite maksuunpanovuosi 4 elementti Maksuunpanovuosi (eri kuin alkuperäinen eräpvm) alkuperainenerapvm 10 elementti Alkuperäinen eräpvm (pp.kk.vvvv) vanhentumisenkatkeamispvm 10 elementti Vanhentumisen katkeamispvm (pp.kk.vvvv) passiiviperintapyynto 4 elementti Passiiviperintäpyyntö, koodiarvo Lisäksi: 0-n täytäntöönpanoperustetta, 0-n tuomion sisältöä, 0-n lisätietoa, 0-n liitetietoa, 1-n saatavaa, 1-n velallista, 0-n hakijaa. paatospvm 10 elementti Päätöspvm (pp.kk.vvvv); pakollinen, kun asialuokka on muu kuin Julkisoikeudelliset asiat vahvistuspvm 10 elementti Vahvistuspvm

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 6(24) (pp.kk.vvvv); pakollinen, kun asialuokka on muu kuin Julkisoikeudelliset asiat, jos puuttuu, on sama kuin päätöspvm diaarinro 15 elementti Diaarinumero; tämä tai ratkaisunro pakollinen, kun asialuokka on muu kuin Julkisoikeudelliset asiat ratkaisunro 15 elementti Ratkaisunumero toimivaltasaados 80 elementti Toimivaltasäädös (tekstiä) tuomioistuin 4 elementti Tuomioistuin, koodiarvo; tämä tai muu viranomainen pakollinen, kun asialuokka on muu kuin Julkisoikeudelliset asiat muuviranomainen 60 elementti Muu viranomainen (nimi tekstinä) paatosliitteena 4 elementti Päätös liitteenä, koodiarvo; jos 'paperilla', asia menee Uljaksessa selvitettäväksi selite 480 elementti Täytäntöönpanoperusteen selite vanhentumispvm 10 elementti Täytäntöönpanoperusteen vanhentumispvm maaraaika 4 elementti Täytäntöönpanoperusteen määräaika-koodiston koodiarvo. maaraajanselite 240 elementti Määräajan selite 2.2.3Tuomion sisältö rikosnimike 40 elementti Rikosnimike tekopvm 10 elementti Tekopvm (pp.kk.vvvv) tekopvmselite 40 elementti Tekopvm:n selite tekopaikka 40 elementti Tekopaikka paivasakkojenlkm 5 elementti Päiväsakkojen lkm paivasakkojenrahamaara 14,2 elementti Päiväsakon rahamäärä vanhentumispvm 10 elementti Vanhentumispvm (pp.kk.vvvv) haastekielto 4 elementti Haastekielto, koodiarvo muuntorangaistus 4 elementti Muuntorangaistus selite 240 elementti Selite, mm. muuntorangaistuksen aika

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 7(24) Asian lisätieto laji 4 elementti Laji, koodiarvo lisatietoteksti 240 elementti Lisätietoa tekstinä Asian liitetieto laji 4 elementti Laji, koodiarvo saapumistapa 4 elementti Saapumistapa, koodiarvo Saatava Vähintään yksi saatava / hakemus on pakollinen, jos asiaryhmä = perintäasia. id 9 attribuutti (id) Saatavan juokseva järjestysnumero hakemusasian sisällä. Muotoa s + hakemusnro + järj.nro, esim. hakijaidref 9 attribuutti (idref) s00001001. Viittaus saatavan hakijaan. Jos puuttuu =hakemuserän lähettäneen hakijan saatava Jos puuttuu asiamiehen lähettämältä hakemukselta, hakemus hylätään. saatavanimi 4 elementti Saatavanimi, koodiarvo valuutta 4 elementti Valuutta, koodiarvo jos puuttuu: euro rahamaara 14,2 elementti Hakijan ilmoittama rahamäärä alkupvm 10 elementti Saatavan voimassaolon alkupvm (pp.kk.vvvv) loppupvm 10 elementti Saatavan voimassaolon loppupvm (pp.kk.vvvv) Saatavan osuus 1-n osuutta 0.1 viivästyskorko velallinenidref 9 attribuutti (idref) Viittaus osuuden velalliseen. Pakollinen. laji 4 elementti Saatavan osuuden laji,

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 8(24) koodiarvo. Sallitut vaihtoehdot = täysimääräinen (1), rahamääräinen (2) ja rahamääräinen osuus vain pääomaan (4) rajoitetturahamaara 14,2 elementti Saatavan osuuden rajoitettu rahamäärä pakollinen, kun osuuden laji=2 tai 4 Viivästyskorko laji 4 elementti Korkolaji, koodiarvo. Tämä tai korko-% on pakollinen. marginaali 5,3 elementti Korkomarginaali prosentti 5,3 elementti Korkoprosentti valvonta 4 elementti KorkoL:n muk. valvonta, koodiarvo maaraytymistapa 4 elementti Koron määräytymistapa, koodiarvo tarkastuspvm 10 elementti Tarkastuspvm (pp.kk.vvvv) pakollinen, kun korkolaji = euribor koronalkupvm 10 elementti Alkupvm (pp.kk.vvvv) koronloppupvm 10 elementti Loppupvm (pp.kk.vvvv) Velallinen id 9 attribuutti (id) (Asian)velallisen juokseva numero hakemuksen sisällä (tarvitaan osuuksien ja lisätietojen kohdistukseen). Pakollinen. Muotoa v + hakemusnro + järj.nro, esim. v00001001 laji 4 elementti Henkilölaji, koodiarvo tyyppi 4 elementti Tyyppi, koodiarvo hetu 11 elementti Henkilötunnus ytunnus 9 elementti Y-tunnus syntymapvm 10 elementti Syntymäaika (pp.kk.vvvv) (Uljas päättelee tarvittaessa hetusta) sukupuoli 4 elementti Sukupuoli, koodiarvo kieli 4 elementti Kieli, koodiarvo

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 9(24) jos puuttuu: suomi (paitsi Ahvenanmaa ruotsi) kuolinpvm 10 elementti Kuolinpäivä (pp.kk.vvvv) kansallisuus 40 elementti Kansallisuus jos puuttuu: suomi taytantoonpanotapa 4 elementti Täytäntöönpanotapa, koodiarvo. Jos puuttuu: normaali täytäntöönpano eilainvoimainen 4 elementti Ei-lainvoimainen, koodiarvo (Jos kyllä: Uljaksessa asia selvitettäväksi, käyttäjä tekee varojen tilityskiellon) tiedoksiantopyynto 4 elementti Tiedoksiantopyyntö, koodiarvo. (Jos kyllä: Uljaksessa asia selvitettäväksi, käyttäjä tekee toimenpiteen) 1 henkilön nimi 1 henkilön osoite 0-n lisätietoa Henkilön nimi (hennimi) nimi 100 elementti Nimi. Jurid. hlön nimi, luonn. henkilön sukunimi etunimi 100 elementti Etunimet yritysnimi 100 elementti Yrityksen nimi, kun luonnollinen henkilö velallisena. Esim. toiminimi tietolahde 4 elementti Nimen tietolähde, koodiarvo Jos puuttuu: hakija Henkilön osoite (osoite) Velallisella/hakijalla on hakemuksessa täsmälleen yksi osoite. lahiosoite 112 elementti Lähiosoite. Joko (lähiosoite + postinro) tai kuntanro pakollinen postinumero 5 elementti Postinumero kunta 4 elementti Kunta, koodiarvo (vain velallisella) paikkakunta 50 elementti Paikkakunta pakollinen, jos maa <> suomi maa 4 elementti Maa, koodiarvo jos puuttuu: suomi osoitteentietolahde 4 elementti Osoitteen tietolähde, koodiar-

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 10(24) vo. jos puuttuu: hakija luovutuskielto 4 elementti Osoitteen luovutuskielto, koodiarvo. jos puuttuu: ei Velallisen lisätieto Hakija laji 4 elementti Laji, koodiarvo lisatietoteksti 240 elementti Lisätietoa tekstinä Jos hakemuserän hakija on asiamies, pitää hakemuskohtaisesti kertoa varsinainen hakijan. Rahatilitys on aina hakemuserän sähköiselle hakijalle/asiamielelle. id 9 attribuutti (id) (Asian)hakijan juokseva järj.numero hakemuksen sisällä (tarvitaan saatavien kohdistukseen sekä mahd. asiakirjatilityksen saajan päättelyyn). Muotoa h + hakemusnro + järj.nro, esim. h00001001. laji 4 elementti Henkilölaji, koodiarvo (vanha tyyppi) tyyppi 4 elementti Tyyppi, koodiarvo hetu 11 elementti Henkilötunnus ytunnus 9 elementti Y-tunnus syntymapvm 10 elementti Syntymäaika (pp.kk.vvvv) sukupuoli 4 elementti Sukupuoli, koodiarvo kieli 4 elementti Kieli, koodiarvo Jos puuttuu: suomi, paitsi Ahvenanmaan = ruotsi kuolinpvm 10 elementti Kuolinpvm (pp.kk.vvvv) kansallisuus 40 elementti Kansallisuus jos puuttuu: Suomi valtakirjantunnus 20 elementti Hakijakohtaisen valtakirjan tunnus. Jos puuttuu: oletetaan, että on asiakohtainen valtakirja, joka tulee toimittaa paperilla. Ennen tätä asia ei mene täytän-

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 11(24) töönpanoon. 1 henkilön nimi 1 henkilön osoite 0.1 valtakirjaatiliä Tili Tulevaisuudessa mahdollista antaa ulkomainen tili (Swift ja Iban). sekä pankin nimi. Nimi pituus tyyppi Selitys tilinro 14 elementti Suomalainen tilinumero konekielisessä muodossa. Valtakirja Tarvitaan, jos asiamies toimii sähköisenä hakijana. Valtakirja kertoo, mihin asiamiehen valtuutus perustuu. Jokaiseen (hakemuskohtaiseen) hakijaan liittyy täsmälleen yksi valtakirja. laajuus 4 elementti Valtuutuksen laajuus, koodiarvo. Asiakohtainen tai hakijakohtainen (sähk. asiamiehellä, valtakunn.). laji 4 elementti Laji, koodiarvo. antaja 80 elementti Antaja alkupvm 10 elementti Voimassaolon alkupvm (pp.kk.vvvv). Tilitysvaltakirjalla (laji) pakollinen loppupvm 10 elementti Voimassaolon loppupvm (pp.kk.vvvv) 3Sähköinen muutos(erä) Muutoserä Muutoserä koostuu sähköisestä hakijasta ja erätiedoista sekä yhdestä tai useammasta muutoksesta (vastaavasti kuten hakemustiedosto). Muutostiedostoerän tiedot ovat samat kuin edellä hakemustiedostoerässä, paitsi erän tunnisteen osalta (ks. alla) nimi pituus tyyppi Selitys era 6 attribuutti Tiedoston tunnus, muoto M999VV

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 12(24) ja hakemuslajin, joka ei ole pakollinen muutosilmoituksissa. Muutos (muutoshakemus) Muutos (vastaa hakemusta) voi olla peruutus, maksumuutos, saatavamuutos, tai muu muutos. Yksittäinen muutos koostuu asian tunnistetiedoista ja itse muutostapahtuman tiedoista seuraavasti: Nimi pituus tyyppi selitys nro 5 attribuutti (hakemuksen)muutos-numero. Muutoserän sisällä juokseva numero, esim. 00001. asianro 9 elementti Ulosoton antama tunniste: asianumero viite1 20 elementti Hakijan viitetieto 1 viite2 20 elementti Hakijan viitetieto 2 viitenro 20 elementti Hakijan viitenumero selite 20 elementti Hakijan selite velallisentunnus 11 elementti Velallisen tunnus, henkilötai y-tunnus. (Pakollinen vain veroissa. Jos puuttuu, mutta nimi on, muutoskirjaus menee selvitettäväksi. Jos nimikin puuttuu, muutos hylätään.) velallisennimi 200 elementti Velallisen nimi (yhdessä kentässä). Pakollinen, jos ei em. tunnusta ja asiassa useita velallisia. tapahtumapvm 10 elementti Tapahtuma päivä muutoksenselite 240 elementti Muutoskirjauksen selite 1 peruutus/maksumuutos/saatavamuutos/muu muutos 0.1 hakija (ei pakollinen, jos sähköinen hakija on hakija) Peruutus Hakijan ilmoittaman peruutustapahtuman tiedot. Nimi pituus tyyppi selitys Laatu 4 elementti Muutoskirjauksen laatu, koodiarvo (vanhassa tapahtumalaji) maksetturahamaara 14,2 elementti Rahamäärä

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 13(24) Maksumuutos Hakijan vastaanottaman maksun tai siihen rinnastettavan suorituksen (esim. kuittaus) johdosta ilmoitettavat tiedot. Nimi pituus tyyppi selitys Laatu 4 elementti Muutoskirjauksen laatu, koodiarvo (ent. tapahtumalaji) SaldoPvm 10 elementti Saldopvm Jos puuttuu, tulkitaan Uljaksessa samaksi kuin erän lähetyspäivä (lahetyspvm) maksetturahamaara 14,2 elementti Maksettu rahamäärä UusiSaldo 14,2 elementti Velallisen nettosaldo asiassa maksun jälkeen viimtilityspvm 10 elementti Päivä, jolloin hakija on viimeksi saanut asiassa tilityksen 1-n maksumuutoksen saatava Maksumuutoksen saatavat (maksumuutoksensaatava) Nimi pituus tyyppi selitys saatavanimi 4 elementti Saatavanimi, koodiarvo maksetturahamaara 14,2 elementti Maksettu rahamäärä Saatavan lyhennys ko. velallisen osalta uusipaaomanrahamaara 14,2 elementti Saatavan pääoman (osuuden) perittävä rahamäärä maksun jälkeen ko. velallisen osalta uusikorkojrahamaara 14,2 elementti Korkojäämän rahamäärä Velallisen osuuden korkojäämä maksun jälkeen. viivkoronalkupvm 10 elementti Viivästyskoron alkupvm Pakollinen, jos korollinen saatava (vain maksumuutoksella) Saatavamuutos Hakijan muusta kuin maksutapahtumasta (esim. korjaus) aiheutuva muutos asian saatavatietoihin.

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 14(24) Nimi pituus tyyppi Selitys Laatu 4 elementti Muutoskirjauksen laatu, koodiarvo (vanhassa tapahtumalaji) saldopvm 10 elementti Saldopvm Jos puuttuu, muodostetaan Uljaksessa: sama kuin erän lähetyspäivä (lpvm) viimtilityspvm 10 elementti Päivä, jolloin hakija on viimeksi saanut asiassa tilityksen 1-n saatava Asian saatavatiedot (saatava) Nimi pituus tyyppi selitys saatavanimi 4 elementti Saatavanimi, koodiarvo vanhasaldo 14,2 elementti Saatavan saldo ennen muutosta eli perittävä rahamäärä (korot mukana) ko. velallisen osalta uusisaldo 14,2 elementti Velallisen saatavan uusi (netto)saldo muutoksen jälkeen osuudenlaji 4 elementti Osuuden laji, koodiarvo Sallitut vaihtoehdot: täysimääräinen (1), rahamääräinen (2) ja rahamääräinen osuus vain pääomaan (4) Viivästyskorko 0 1 viivästys korko laji 4 elementti Korkolaji, koodiarvo Korko tai korko-% on pakollinen. Jos ristiriita asianimen lisätietojen korkotietoon, kirjataan selvitettävä ilmoitus. prosentti 5,3 elementti Korkoprosentti alkupvm 10 elementti Alkupvm loppupvm 10 elementti Loppupvm

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 15(24) Asian muu muutos Laatu 4 elementti Muutoskirjauksen laatu, koodiarvo (vanhassa tapahtumalaji) uusiviite2 20 elementti Hakijan uusi viitetieto 2 passiiviperintapyynto 4 elementti Passiiviperintäpyyntö, koodiarvo taytantoonpanotapa 4 elementti Täytäntöönpanotapa, koodiarvo 0-1 Täytäntöönpanon keskeytys Täytäntöönpanon keskeytys alkupvm 10 elementti Kiellon voimaantulopvm loppupvm 10 elementti Kiellon päättymispvm Hakija Jos muutoserän hakija on asiamies, voi tietyissä muutoksissa muutos(asia)kohtaisesti kertoa varsinaisen hakijan, muuten ei. Muutoskohtainen hakija voi liittyä peruutukseen, maksumuutokseen ja saatavamuutokseen. Nimi pituus tyyppi selitys Tunnus 11 elementti Hakijan tunnus, henkilötai y-tunnus Nimi 200 elementti Nimi on kokonaan yhdessä kentässä.

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 16(24) 4Yleistä XML:stä XML (extensible Markup Language) on kehittyvä standardi, joka on tarkoitettu tiedon tallennukseen ja jakeluun verkossa. XML on tarkoitettu helppoon ja yhdenmukaiseen rakenteeltaan määriteltävissä olevan tiedon jakeluun verkkoympäristössä. W3C:n (World Wide Web Consortium) työryhmä aloitti toukokuussa 1996 kolmivaiheisen XML-kehittämisprojektin. XML-standardoinnin taustalla on kaksi aikaisemmin määriteltyä merkkauskieltä: yleinen dokumenttirakenteiden määrittelyyn ja rakenteisten dokumenttien merkkaamiseen tarkoitettu SGML (Standard Generalized Markup Language) ja verkkodokumenttien esittämiseen tarkoitettu, SGML-kielellä määritetty HTML (Hypertext Markup Language). Perusmäärittely: <!ELEMENT A (B?,C,D*,E+)> tarkoittaa, että tagi A (eli pari <A> </A>) voi sisältää 0 1 tagia B, 1 tagia C, 0 n tagia D ja 1 n tagia E. Lisäksi voidaan määritellä ryhmiä ja tai-ehtoja: <!ELEMENT A (B (C,D)+)> tarkoittaa, että tagi A (eli pari <A> </A>) voi sisältää 1 tagia B tai 1 n tagia C ja D Document Type Definition (DTD) periytyy SGML-kielestä ja mahdollistaa dokumentin formaalin rakennemäärittelyn. DTD luo siis säännöstön XMLtiedon rakenteelle. Seuraavassa on DTD-määritykset sekä hakemuserätiedostolle että muutoserätiedostolle sekä niitä vastaavat xml-esimerkkitiedostot. Huomioitavaa xml-tiedoston laatimisessa: - jos jotain dtd-määrityksessä kuvattua tietoa ei kyseessä olevalla asialla tmv. ole, niin vastaavaa elementtiä ei kirjoiteta tyhjänä tiedostoon. Ts. vain ne elementit tallennetaan, joissa on tietoa. 5Hakemuserätiedoston DTD-kuvaus <?xml version="1.0" encoding="utf-8"?> <!-- edited with XMLSPY v5 rel. 2 U (http://www.xmlspy.com) by Ministry Of Justice --> <!ELEMENT hakemusera (sahkoinenhakija, hakemus+)>

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 17(24) <!-- Hakemuserän sähköisen hakijan ja erän tunnistetiedot --> <!ELEMENT sahkoinenhakija (lahetyspvm, hakemuslaji, yhteyshlonimi?, yhteyshlopuhnro?, yhteyshlosposti?)> <!ATTLIST sahkoinenhakija tunnus CDATA #REQUIRED era CDATA #REQUIRED > <!ELEMENT lahetyspvm (#PCDATA)> <!ELEMENT hakemuslaji (#PCDATA)> <!ELEMENT yhteyshlonimi (#PCDATA)> <!ELEMENT yhteyshlopuhnro (#PCDATA)> <!ELEMENT yhteyshlosposti (#PCDATA)> <!--ulosottohakemuksen asian tiedot--> <!ELEMENT hakemus (asia)> <!ATTLIST hakemus nro CDATA #REQUIRED > <!ELEMENT asia (asianimi, viite1?, viite2?, viitenro?, selite?, maksuunpanovuosi?, alkuperainenerapvm?, vanhentumisenkatkeamispvm?, passiiviperintapyynto?, taytantoonpanonperuste*, tuomionsisalto*, asianlisatieto*, liitetieto*, saatava+, velallinen+, hakija*)> <!--Asiakirjatilityksen saaja; jos viittausta ei ole saaja on sähköinen hakija--> <!ATTLIST asia hakijaidref IDREF #IMPLIED > <!ELEMENT asianimi (#PCDATA)> <!ELEMENT viite1 (#PCDATA)> <!ELEMENT viite2 (#PCDATA)> <!ELEMENT viitenro (#PCDATA)> <!ELEMENT selite (#PCDATA)> <!ELEMENT maksuunpanovuosi (#PCDATA)> <!ELEMENT alkuperainenerapvm (#PCDATA)> <!ELEMENT vanhentumisenkatkeamispvm (#PCDATA)> <!ELEMENT passiiviperintapyynto (#PCDATA)> <!--asian täytäntöönpanoperusteen tiedot--> <!ELEMENT taytantoonpanonperuste (paatospvm?, vahvistuspvm?, diaarinro?, ratkaisunro?, toimivaltasaados?, tuomioistuin?, muuviranomainen?, paatosliitteena?, selite?, vanhentumis- Pvm?, maaraaika?, maaraajanselite?)> <!ELEMENT paatospvm (#PCDATA)> <!ELEMENT vahvistuspvm (#PCDATA)> <!ELEMENT diaarinro (#PCDATA)> <!ELEMENT ratkaisunro (#PCDATA)> <!ELEMENT toimivaltasaados (#PCDATA)> <!ELEMENT tuomioistuin (#PCDATA)> <!ELEMENT muuviranomainen (#PCDATA)> <!ELEMENT paatosliitteena (#PCDATA)> <!ELEMENT maaraaika (#PCDATA)> <!ELEMENT maaraajanselite (#PCDATA)> <!--tuomionsisältötiedot vain sakkoasioissa--> <!ELEMENT tuomionsisalto (rikosnimike?, tekopvm?, tekopaikka?, paivasakkojenlkm?, paivasakkojenrahamaara?, vanhentumispvm?, selite?)> <!ELEMENT rikosnimike (#PCDATA)> <!ELEMENT tekopvm (#PCDATA)> <!ELEMENT tekopaikka (#PCDATA)> <!ELEMENT paivasakkojenlkm (#PCDATA)> <!ELEMENT paivasakkojenrahamaara (#PCDATA)> <!ELEMENT vanhentumispvm (#PCDATA)> <!--asian mahdolliset lisätiedot--> <!ELEMENT asianlisatieto (laji, lisatietoteksti)> <!ELEMENT laji (#PCDATA)> <!ELEMENT lisatietoteksti (#PCDATA)> <!--liittyykö hakemukseen liitteitä?--> <!ELEMENT liitetieto (laji?, saapumistapa?)> <!ELEMENT saapumistapa (#PCDATA)> <!--asian saatavatiedot--> <!ELEMENT saatava (saatavanimi, valuutta?, rahamaara, alkupvm?, loppupvm?, osuus+, viivastyskorko?)> <!--hakijaviittaus (hakijaidref) vain silloin, kun saatavaan liittyy muukin hakija kuin sähköinen hakija--> <!ATTLIST saatava id ID #REQUIRED hakijaidref IDREF #IMPLIED > <!ELEMENT saatavanimi (#PCDATA)>

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 18(24) <!ELEMENT valuutta (#PCDATA)> <!ELEMENT rahamaara (#PCDATA)> <!ELEMENT alkupvm (#PCDATA)> <!ELEMENT loppupvm (#PCDATA)> <!ELEMENT osuus (laji?, rajoitetturahamaara?)> <!--viittaus saatavaosuuden velalliseen--> <!ATTLIST osuus velallinenidref IDREF #REQUIRED > <!ELEMENT rajoitetturahamaara (#PCDATA)> <!--saatavan korkotiedot--> <!ELEMENT viivastyskorko (laji?, marginaali?, prosentti?, valvonta?, tarkastuspvm?, koronalku- Pvm, koronloppupvm?)> <!ELEMENT marginaali (#PCDATA)> <!ELEMENT prosentti (#PCDATA)> <!ELEMENT valvonta (#PCDATA)> <!ELEMENT tarkastuspvm (#PCDATA)> <!ELEMENT koronalkupvm (#PCDATA)> <!ELEMENT koronloppupvm (#PCDATA)> <!--asian velallistiedot--> <!ELEMENT velallinen (laji, tyyppi?, hetu?, ytunnus?, syntymapvm?, sukupuoli?, kieli?, kuolin- Pvm?, kansallisuus?, taytantoonpanotapa?, eilainvoimainen?, tiedoksiantopyynto?, hennimi, osoite, lisatieto*)> <!--viittaus asian ao. velalliseen--> <!ATTLIST velallinen id ID #REQUIRED > <!ELEMENT tyyppi (#PCDATA)> <!ELEMENT hetu (#PCDATA)> <!ELEMENT ytunnus (#PCDATA)> <!ELEMENT syntymapvm (#PCDATA)> <!ELEMENT sukupuoli (#PCDATA)> <!ELEMENT kieli (#PCDATA)> <!ELEMENT kuolinpvm (#PCDATA)> <!ELEMENT kansallisuus (#PCDATA)> <!ELEMENT taytantoonpanotapa (#PCDATA)> <!ELEMENT eilainvoimainen (#PCDATA)> <!ELEMENT tiedoksiantopyynto (#PCDATA)> <!ELEMENT hennimi (nimi, etunimi?, yritysnimi?, tietolahde?)> <!ELEMENT nimi (#PCDATA)> <!ELEMENT etunimi (#PCDATA)> <!ELEMENT yritysnimi (#PCDATA)> <!ELEMENT tietolahde (#PCDATA)> <!ELEMENT osoite (lahiosoite?, postinro?, paikkakunta?, kunta?, maa?, osoitteentietolahde?, luovutuskielto?)> <!ELEMENT lahiosoite (#PCDATA)> <!ELEMENT postinro (#PCDATA)> <!ELEMENT paikkakunta (#PCDATA)> <!ELEMENT kunta (#PCDATA)> <!ELEMENT maa (#PCDATA)> <!ELEMENT osoitteentietolahde (#PCDATA)> <!ELEMENT luovutuskielto (#PCDATA)> <!ELEMENT lisatieto (laji, lisatietoteksti)> <!--asian hakijatiedot, jos lisäksi muita hakijoita kuin sähköinen hakija--> <!ELEMENT hakija (laji, tyyppi?, hetu?, ytunnus?, syntymapvm?, sukupuoli?, kieli?, kuolinpvm?, kansallisuus?, hennimi, osoite, valtakirja tili?, valtakirjantunnus?)> <!--viittaus asian hakijaan; ks. kommenttiteksti edellä--> <!ATTLIST hakija id ID #REQUIRED > <!ELEMENT valtakirja (laajuus, laji, antaja, alkupvm?, loppupvm?)> <!ELEMENT laajuus (#PCDATA)> <!ELEMENT antaja (#PCDATA)> <!ELEMENT valtakirjantunnus (#PCDATA)> <!ELEMENT tili (tilinro)> <!ELEMENT tilinro (#PCDATA)> 6Muutoserätiedoston DTD-kuvaus <?xml version="1.0" encoding="utf-8"?> <!-- edited with XMLSPY v5 rel. 2 U (http://www.xmlspy.com) by Ministry Of Justice -->

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 19(24) <!ELEMENT muutosera (sahkoinenhakija, muutoshakemus+)> <!-- Muutoserän sähköisen hakijan ja erän tunnistetiedot --> <!ELEMENT sahkoinenhakija (lahetyspvm, hakemuslaji?, yhteyshlonimi?, yhteyshlopuhnro?, yhteyshlosposti?)> <!ATTLIST sahkoinenhakija tunnus CDATA #REQUIRED era CDATA #REQUIRED > <!ELEMENT lahetyspvm (#PCDATA)> <!ELEMENT hakemuslaji (#PCDATA)> <!ELEMENT yhteyshlonimi (#PCDATA)> <!ELEMENT yhteyshlopuhnro (#PCDATA)> <!ELEMENT yhteyshlosposti (#PCDATA)> <!ELEMENT muutoshakemus (asiantunniste, (peruutus maksumuutos saatavamuutos muu- Muutos), hakija?)> <!ATTLIST muutoshakemus nro CDATA #REQUIRED > <!--muutettavan hakemusasian tunnistetiedot--> <!ELEMENT asiantunniste (asianro?, viite1?, viite2?, viitenro?, selite?, velallisentunnus?, velallisennimi?, tapahtumapvm?, muutoksenselite?)> <!ELEMENT asianro (#PCDATA)> <!ELEMENT viite1 (#PCDATA)> <!ELEMENT viite2 (#PCDATA)> <!ELEMENT viitenro (#PCDATA)> <!ELEMENT selite (#PCDATA)> <!ELEMENT velallisentunnus (#PCDATA)> <!ELEMENT velallisennimi (#PCDATA)> <!ELEMENT tapahtumapvm (#PCDATA)> <!ELEMENT muutoksenselite (#PCDATA)> <!--peruutuksen tiedot--> <!ELEMENT peruutus (laatu, maksetturahamaara)> <!ELEMENT laatu (#PCDATA)> <!ELEMENT maksetturahamaara (#PCDATA)> <!--maksumuutoksen tiedot--> <!ELEMENT maksumuutos (laatu, saldopvm?, maksetturahamaara, uusisaldo?, viimtilityspvm?, maksumuutoksensaatava+)> <!ELEMENT saldopvm (#PCDATA)> <!ELEMENT uusisaldo (#PCDATA)> <!ELEMENT viimtilityspvm (#PCDATA)> <!ELEMENT maksumuutoksensaatava (saatavanimi, maksetturahamaara?, uusipaaomanrahamaara?, uusikorkojrahamaara?, viivkoronalkupvm?)> <!ELEMENT saatavanimi (#PCDATA)> <!ELEMENT uusipaaomanrahamaara (#PCDATA)> <!ELEMENT uusikorkojrahamaara (#PCDATA)> <!ELEMENT viivkoronalkupvm (#PCDATA)> <!--saatavamuutoksen tiedot--> <!ELEMENT saatavamuutos (laatu, saldopvm?, viimtilityspvm?, saatava+)> <!ELEMENT saatava (saatavanimi, vanhasaldo?, uusisaldo, osuudenlaji?, viivastyskorko?)> <!ELEMENT vanhasaldo (#PCDATA)> <!ELEMENT osuudenlaji (#PCDATA)> <!ELEMENT viivastyskorko (laji?, prosentti?, alkupvm?, loppupvm?)> <!ELEMENT laji (#PCDATA)> <!ELEMENT prosentti (#PCDATA)> <!ELEMENT alkupvm (#PCDATA)> <!ELEMENT loppupvm (#PCDATA)> <!--asian muiden tietojen muutostiedot--> <!ELEMENT muumuutos (laatu, (uusiviite2? passiiviperintapyynto? taytantoonpanotapa? taytantoonpanonkeskeytys?))> <!ELEMENT uusiviite2 (#PCDATA)> <!ELEMENT passiiviperintapyynto (#PCDATA)> <!ELEMENT taytantoonpanotapa (#PCDATA)> <!ELEMENT taytantoonpanonkeskeytys (alkupvm?, loppupvm?)> <!--hakijan, jonka saatavia tmv. muutos koskee, tunnistetiedot (vain jos muu kuin sähköinen hakija)--> <!ELEMENT hakija (tunnus?, nimi?)> <!ELEMENT tunnus (#PCDATA)> <!ELEMENT nimi (#PCDATA)>

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 20(24) 7Esimerkki hakemuserän xml-tiedostosta sisältäen kaksi ulosottohakemusta. <?xml version="1.0" encoding="utf-8"?> <!--Sample XML file generated by XMLSPY v5 U (http://www.xmlspy.com)--> <!DOCTYPE hakemusera SYSTEM "C:\ulosoton dtd\hakemusera.dtd"> <!--malli vakuutushakemusaineistosta--> <hakemusera> <sahkoinenhakija tunnus="104" era="h00103"> <lahetyspvm>07.01.2003</lahetyspvm> <hakemuslaji>2</hakemuslaji> <yhteyshlonimi>varma Vakuuttaja</yhteysHloNimi> <yhteyshlopuhnro>09-7654321</yhteyshlopuhnro> <yhteyshlosposti>varma.vakuuttaja@vakuutus.fi</yhteyshlosposti> </sahkoinenhakija> <hakemus nro="00001"> <asia> <asianimi>36</asianimi> <viite1>371-2397276</viite1> <viite2>70221603879410000</viite2> <selite>01022002-30042002</selite> <maksuunpanovuosi>2002</maksuunpanovuosi> <alkuperainenerapvm>07.03.2002</alkuperainenerapvm> <passiiviperintapyynto>1</passiiviperintapyynto> <taytantoonpanonperuste> <toimivaltasaados>vero UA</toimivaltasaados> </taytantoonpanonperuste> <saatava id="s00001001"> <saatavanimi>1</saatavanimi> <valuutta>11</valuutta> <rahamaara>652.00</rahamaara> <alkupvm>08.03.2002</alkupvm> <osuus velallinenidref="v00001001"> <laji>1</laji> </osuus> <viivastyskorko> <laji>16</laji> <koronalkupvm>08.03.2002</koronalkupvm> </viivastyskorko> </saatava> <velallinen id="v00001001"> <laji>1</laji> <tyyppi>1</tyyppi> <hetu>010101-0101</hetu> <syntymapvm>01.01.1901</syntymapvm> <sukupuoli>2</sukupuoli> <kieli>1</kieli> <taytantoonpanotapa>1</taytantoonpanotapa> <hennimi> <nimi>vahinko</nimi> <etunimi>jussi</etunimi> </hennimi> <osoite> <lahiosoite>kesäkatu 4</lahiosoite> <postinro>13100</postinro> <paikkakunta>hämeenlinna</paikkakunta> <kunta>109</kunta> <maa>1</maa> <osoitteentietolahde>1</osoitteentietolahde> <luovutuskielto>2</luovutuskielto> </osoite> </velallinen> </asia> </hakemus> <hakemus nro="00002"> <asia> <asianimi>36</asianimi> <viite1>968532-p-0007</viite1>

OIKEUSMINISTERIÖ ULOSOTON XML-TIEDOSTOT 21(24) <viite2>99900</viite2> <selite>20.3.2001-19.3.2002</selite> <maksuunpanovuosi>2001</maksuunpanovuosi> <alkuperainenerapvm>12.11.2001</alkuperainenerapvm> <passiiviperintapyynto>1</passiiviperintapyynto> <taytantoonpanonperuste> <toimivaltasaados>vero UA</toimivaltasaados> </taytantoonpanonperuste> <saatava id="s00002001"> <saatavanimi>1</saatavanimi> <valuutta>11</valuutta> <rahamaara>750.00</rahamaara> <osuus velallinenidref="v00002001"> <laji>1</laji> </osuus> <viivastyskorko> <laji>16</laji> <koronalkupvm>15.12.2001</koronalkupvm> </viivastyskorko> </saatava> <saatava id="s00002002"> <saatavanimi>4</saatavanimi> <valuutta>11</valuutta> <rahamaara>15.00</rahamaara> <osuus velallinenidref="v00002001"> <laji>1</laji> </osuus> <viivastyskorko> <laji>16</laji> <koronalkupvm>01.02.2002</koronalkupvm> </viivastyskorko> </saatava> <velallinen id="v00002001"> <laji>1</laji> <tyyppi>3</tyyppi> <ytunnus>9996543-4</ytunnus> <kieli>1</kieli> <taytantoonpanotapa>1</taytantoonpanotapa> <hennimi> <nimi>oy Takuumiehet ab</nimi> <tietolahde>1</tietolahde> </hennimi> <osoite> <lahiosoite>raatikatu 7</lahiosoite> <postinro>13100</postinro> <osoitteentietolahde>1</osoitteentietolahde> <luovutuskielto>2</luovutuskielto> </osoite> </velallinen> </asia> </hakemus> </hakemusera> 8Esimerkki asimiehen hakemuserän xml-tiedostosta sisältäen kaksi ulosottohakemusta. <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE hakemusera SYSTEM "hakemusera.dtd"> <!--malli asiamiehen hakemusaineistosta--> <hakemusera> <sahkoinenhakija tunnus="403" era="h00103"> <lahetyspvm>01.09.2006</lahetyspvm> <hakemuslaji>2</hakemuslaji> <yhteyshlonimi>arvo Asiamies</yhteysHloNimi> <yhteyshlopuhnro>09-1234567</yhteyshlopuhnro> <yhteyshlosposti>arvo.asiamies@asiamies.fi</yhteyshlosposti> </sahkoinenhakija> <hakemus nro="00001">