Tekninen dokumentti. Metsäkeskusten sähköisten viestien (siirtotiedostojen) rakenne ja sisältö

23.4.2012 1 (36) Tekninen dokumentti Metsäkeskusten sähköisten viestien (siirtotiedostojen) rakenne ja sisältö

23.4.2012 2 (36) Muutoshistoria Versio ja pvm Laatija Muutoksen kuvaus [0.1K / 8.11.2002] Juha Malinen Metsäkeskusten sähköisten viestien yleisen rakenteen kuvaus ja Kemera-järjestelmän tie- ja ojitushankkeiden toteutusilmoitusten siirtotiedoston kuvaus. Ensimmäinen käsiteltävä versio. [0.2K / 12.11.2002] Juha Malinen Kommenttien perusteella parannuksia dokumenttiin. [0.3K / 28.11.2002] Pertti Syrjälä Metsänkäyttöilmoituksen siirtotiedoston kuvauksen luonnos. [0.4K / 12.2.2003] Pertti Syrjälä Tarkennuksia metsänkäyttöilmoitus kuvaukseen [0.5K / 25.2.2003] Eeva Reittu Tarkennuksia metsänkäyttöilmoitus kuvaukseen, palaverissa sovittua (Syrjälä, Kainulainen, Valanne, Greis, Reittu) [0.6K / 25.02.2003] Kristiina Honkanen Tarkennuksia kuvauksiin sekä dokumenttien v0.5, v0.51 ja v0.52 tietojen yhdistäminen. [0.7K / 25.02.2003] Eeva Reittu ja Pertti Syrjälä Dokumenttien v0.5, v0.51 ja v0.52 ja v0.6 tietojen yhdistäminen [1.0 V / 14.03.2003] Markku Leinonen, Kristiina Päivitetty palaverien (3.3 ja 5.3) päätösten mukaisesti. Honkanen [1.1 V / 8.9.2003] Eeva Reittu, Pertti Syrjälä, Pauli Tehty täsmennyksiä koskien selitteitä ja kuvauksia. Kainulainen [1.2 V / 17.12.2003] Markku Leinonen Päivitetty metsänkäyttöilmoituksen sisällön kuvausta; lisätty kuvion lisätiedoille <lisatieto 500> -tagi [1.3 V / 28.1.2004] Eeva Reittu Korjattu Muu perustamistoimenpide 1 ja 2 -tagit [1.4 V / 29.6.2004] Juha Malinen Tarkennus ilmoitus- ja kuvioviitteen muodostamiseen. [2.0 V / 23.2.2007] Seppo Sokkanen Lisätty taimikon perustamisilmoitus ja postinumerot FI- 99999 [3.0 V / 15.10.2010] Seppo Sokkanen Lisätty Kemeran ilmoitukset [3.1 V / 7.6.2011] Seppo Sokkanen EUREF-FIN koordinaatistojärjestelmän vaatimat muutokset [3.2 V / 23.4.2012] Seppo Sokkanen Lisätty tuhon laatu tagi metsänkäyttöilmoituksille. BIC pakollinen Kemera-viesteissä. Versioluettelo Osa Versio ja pvm Tila Tiedosto Metsäkeskusten sähköisten viestien (siirtotiedostojen) rakenne ja sisältö. [3.2 V / 23.4.2012] Valmis Metsäkeskusviestit_v3.2.doc Liite 1. Esimerkki - metsänkäyttöilmoitus [1.0V / 3.9.2003] Valmis Mkilmoitus.xml Liite 2. Esimerkki - tie- ja ojitushankkeen toteutusilmoitus [1.1V / 13.3.2003] Valmis Toteutusilmoitus.xml Liite 3. Esimerkki taimikon perustamisilmoitus [1.0V / 5.10.2006] Valmis Tpilmoitus_2.xml Liite 4. Esimerkki Kemeran yhden osuuden jälkirahoitteinen hanke [1.0V / 26.3.2010] Valmis Jälkirah10.xml

23.4.2012 3 (36) Sisällysluettelo 1 Dokumentin tarkoitus... 4 2 Noudatettavat standardit ja versiot... 4 3 Sähköisten viestien rakenteen ja niiden sisältämien tietojen tietotyyppien kuvaus... 5 3.1 mkeskus.xsd... 6 3.2 masto.xsd... 8 3.3 kemera.xsd... 10 4 Metsäkeskusviestien rakenne... 11 4.1 Osoitetiedot... 11 4.2 Viestityyppikohtaiset tiedot... 12 4.2.1 Masto-viestit... 12 4.2.1.1 Metsänkäyttöilmoitus (viestityyppi K)... 12 4.2.1.2 Taimikon perustamisilmoitus (viestityyppi P)... 17 4.2.2 Kemera-viestit... 21 4.2.2.1 Jälkirahoitteisen metsänhoitohankkeen rahoitushakemus- ja toteutusasiakirjat 21 4.2.2.2 Suunnitelmallisen metsänhoitohankkeen rahoitushakemus... 22 4.2.2.3 Suunnitelmallisen metsänhoitohankkeen toteutusilmoitus... 29 4.2.2.4 Korvaavat viestit... 34 4.2.2.5 Tie- ja ojitushankkeen toteutusilmoitus (viestityyppi T)... 35 LIITTEET Liite 1. Esimerkki - metsänkäyttöilmoitus... 36 Liite 2. Esimerkki - tie- ja ojitushankkeen toteutusilmoitus, ei julkaistu www-sivuilla36 Liite 3. Esimerkki - taimikon perustamisilmoitus... 36 Liite 4. Esimerkki Kemeran yhden osuuden jälkirahoitteinen hanke... 36

23.4.2012 4 (36) 1 Dokumentin tarkoitus 2 Noudatettavat standardit ja versiot Tässä dokumentissa kuvataan metsäkeskusten tiedonsiirtopalvelun sähköisten viestien rakenne ja sisältö. Dokumentissa kuvataan siirtotiedostot, joiden mukaisia viestejä metsäkeskukset voivat ottaa sähköisessä muodossa vastaan ja joista jokainen muodostaa oman viestityypin. Dokumenttia päivitetään, kun uusia viestityyppejä otetaan käyttöön. Dokumentti sisältää tällä hetkellä seuraavien viestityyppien kuvauksen - Masto-järjestelmän metsänkäyttöilmoitus - Masto-järjestelmän taimikon perustamisilmoitus - Kemera-järjestelmän yhden osuuden jälkirahoitteinen hanke - Kemera-järjestelmän tie- ja ojitushankkeiden toteutusilmoitus (vain metsäkeskusten sisäisessä käytössä) Sähköiset viestit siirretään metsäkeskuksiin tiedonsiirtopalvelun kautta (http://www.metsakeskus.fi/asiointi-ja-lomakkeet/sahkoinentiedonsiirtopalvelu). Metsäkeskusten sähköiset viestit ovat XML-dokumentteja (extensible Markup Language). Koska viestit voivat sisältää sijaintitietoa, niiden sisältämät tiedot esitetään GML-muodossa (Geography Markup Language), joka on paikkatiedon siirtämiseen ja varastointiin tarkoitettu XML:n muoto. Viestien rakenteen ja tietotyyppien kuvauksessa noudatetaan seuraavia versioita - Extensible Markup Language (XML), version 1.0 - Geography Markup Language (GML) Implementation Specification, version 2.1.2 - XML Schema, version 1.0

23.4.2012 5 (36) 3 Sähköisten viestien rakenteen ja niiden sisältämien tietojen tietotyyppien kuvaus XML-dokumenttien rakenne ja niiden sisältämien tietojen tietotyypit kuvataan XML Schemojen avulla, jotka ovat ladattavissa osoitteesta http://www.metsakeskus.fi/siirtotiedostojen-tuottamiseen-tarvittavat-schemat-ja-esimerkit. Metsäkeskusten sähköisiin viesteihin liittyviä XML Schemoja ovat: - Mkeskus.xsd, joka sisältää kaikille viestityypeille yhteisten rakenteiden ja tietojen tietotyyppien määrittelyn (käytössä). - Kemera.xsd, joka sisältää Kemera-järjestelmälle tyypillisten rakenteiden ja tietojen tietotyyppien määrittelyn (käytössä). - Masto.xsd, joka sisältää Masto-järjestelmälle tyypillisten rakenteiden ja tietotyyppien määrittelyn (käytössä). - Aste.xsd, joka sisältää Aste-järjestelmälle tyypillisten rakenteiden ja tietotyyppien määrittelyn (ei toistaiseksi käytössä). - Virta.xsd, joka sisältää Virta-järjestelmälle tyypillisten rakenteiden ja tietotyyppien määrittelyn (ei toistaiseksi käytössä). - Feature.xsd, jossa määritellään GML:ään liittyviä rakenteita. - Geometry.xsd, jossa määritellään GML:ään liittyviä rakenteita. - Xlinks.xsd, jossa määritellään GML:ään liittyviä rakenteita.

23.4.2012 6 (36) 3.1 mkeskus.xsd Schemaan viitataan XML-dokumenteissa ja XML-Schemoissa nimiavaruusnimellä y (esim. y:vastuuorganisaatiotype). Schema sisältää tällä hetkellä seuraavien rakenteiden kuvauksen: - YhteystietoType, Yhteystieto-elementti - OmistajaType, Omistaja-elementti - PankkitiliType, Pankkitili-elementti - KiinteistoType, Kiinteisto-elementti - IlmoittajaType, Ilmoittaja-elementti - kemilmoittajatype, kemilmoittaja-elementti - MetsasuunnitelmaType, Metsasuunnitelma-elementti - MetsakeskusviestiType, Metsakeskusviesti-elementti Schema sisältää tällä hetkellä seuraavien tietojen tietotyyppien kuvauksen - ViestityyppiType, viestityyppi-elementti - VastaanottajaType, vastaanottaja-elementti - VastuuorganisaatioType, vastuuorganisaatio-elementti - VastuuhenkiloType, vastuuhenkilo-elementti - Lisatieto50Type, lisatieto50-elementti - Lisatieto100Type, lisatieto100-elementti - Lisatieto500Type, lisatieto500-elementti - KyllaEiType, esim. hankepaattynyt-elementti - NimiType, nimi-elementti, esim. Maanomistajan nimi - OsoiteType, osoite-elementti, esim. Maanomistajan osoite - PostinroType, postinumero-elementti - PostitoimipaikkaType, postitoimipaikka-elementti - PuhFaxType, puhelin/fax-numero-elementti - SahkopostiType, sahkoposti-elementti - IBANType, - BICType, - Nro1Type, nro1-elementti, kokonaisluku, 0-9 - Nro2Type, nro2-elementti, enintään kaksinumeroinen kokonaisluku, 0-99 - Nro3Type, nro3-elementti, enintään kolminumeroinen kokonaisluku 0-999 - Nro4Type, nro4-elementti, enintään neljänumeroinen kokonaisluku, 0-9999 - PositNro3Type, positnro3-elementti, positiivinen kokonaisluku 1-999 esim. kuntanumero. - TilannimiType, tilan nimi -elementti - LaatijaorganisaatioType, laatijaorganisaatio-elementti - PalaType, pinta-ala-elementti

23.4.2012 7 (36) - KohdistusviiteType, kohdistusviite-elementtti, ilmoituksen/kuvion yksilöivä viite - AlaNroType, kuvion alanumero elementti - KorvaavaviestiType, korvaavaviesti-elementti - VuosilukuType

23.4.2012 8 (36) 3.2 masto.xsd Schemaan viitataan XML-dokumenteissa ja XML Schemoissa nimiavaruusnimellä m (esim. m:mastoviestitype). Schema sisältää tällä hetkellä seuraavien rakenteiden kuvauksen: - OmistajaPropertyType, omistaatilan-elementti - TilaPropertyType, kuuluutilaan-elementti - HakOikHaltijaPropertyType, omistaahakkuuoikeudenelementti - IlmoittajaPropertyType, laatinutilmoituksen-elementti - MetsasuunnitelmaPropertyType, sisaltyysuunnitelmaanelementti - MkiKuvioPropertyType, mkikuviomember-elementti - MkiKuvioType, Mki-kuvio-elementti - MkiIlmoitusType, Metsänkäyttöilmoitus-elementti - MastoviestiType, Maston sähköisesti siirrettävät viestit - TpiToteutusPropertyType, sisaltaatoteutuksen -elementti - TpiToteutusType, - TpiKuvioType, - TpiIlmoitusType, Taimikon perustamisilmoitus -elementti Schema sisältää tällä hetkellä seuraavien tietojen tietotyyppien kuvauksen - MastoviestityyppiType, mastoviestityyppi-elementti - PoikkeusLupaType, poikkeuslupa-elementti - HakTapaType, haktapa-elementti - ElinympType, elinymp-elementtihaktapatype, Hakkuutapa - elementti - ElinympToimPideType, elinymptoimpide-elementti - MuuLkohdetype, muulkohde-elementtielinymptoimpidetype Elinympäristp, muu toimenpide elementti. - PaaryhmaType, paaryhma-elementtimuulkohdetype Muu luontokohde -elementti - AlaryhmaType, alaryhma-elementti - KasvuplkType, kasvuplk-elementti - MaalajiType, maalaji-elementtikasvuplktype, Kasvupaikkaluokka-elementti - PuulajiType, puulaji-elementti - KehlkType, kehlk-elementti Kehlktype, Kehitysluokkaelementti - KlpmType, klpm-elementtiklpmtype, Keskiläpimittaelementti - UudTapaPuulajiType, uudtapapuulajielementtiuudtapapuulajitype, Uudistamisen puulaji - elementti

23.4.2012 9 (36) - MaanMuokType, maanmuok-elementtimaanmuoktype, Maanpinnan käsittelytapa -elementti - PerustToimPideType, perusttoimpideelementtiperusttoimpidetype, Perustamistoimenpideelementti

23.4.2012 10 (36) 3.3 kemera.xsd Schemaan viitataan XML-dokumenteissa ja XML Schemoissa nimiavaruusnimellä k (esim. k:kemeraviestitype). Schema sisältää tällä hetkellä seuraavien rakenteiden kuvauksen: - KuittiType, Kuitti-elementti - KuittiPropertyType, tosite-elementti - TieJaOjaToteutusriviType, TieJaOjaToteutusrivi-elementti - TieJaOjaToteutusriviPropertyType, tiejaojatotmemberelementti - TieJaOjaTotilmoitusType, TieJaOjaTotilmoitus-elementti - MhRahhakTyoOsuudetType - MhTotilmTyoOsuudetType - kemkuviopropertytype - kemkuviotype - kemsuunntype - kemtottype - MhRahhakType - MhTotilmType - KemeraviestiType, kemeraviesti-elementti Schema sisältää tällä hetkellä seuraavien tietojen tietotyyppien kuvauksen: - KemeraviestityyppiType, kemeraviestityyppi-elementti - TotilmoitustunnusType, totilmoitustunnus-elementti - KemeranroType, kemeranro-elementti - RahoitusType - TukiType - TyoosuusType, tyoosuus-elementti - TyolajiType - TltarkenneType - tuhonlaatutype - KlType, kl-elementti - kltarkennetype - TotmaaraType, totmaara-elementti - TotkustType, totkust-elementti - YkshintaType - stotaikatype - polapimtype - porunkolukutype

23.4.2012 11 (36) 4 Metsäkeskusviestien rakenne 4.1 Osoitetiedot Metsäkeskuksen sähköiset viestit sisältävät aina osoitetiedot (luku 4.1) ja jonkun viestityypin viestityyppikohtaiset tiedot (luku 4.2). Viestin osoitetiedot ovat yhteiset ja rakenteeltaan samanlaiset kaikilla tiedonsiirtopalvelun kautta siirrettävillä viesteillä. Viestityyppikohtaisen tiedon rakenne vaihtelee sen sijaan viestityypeittäin. Osoitetietojen avulla voidaan selvittää vastaanottava metsäkeskus ja siirrettävä tieto ts. onko kyseessä toteutusilmoitus, metsänkäyttöilmoitus tms. Siirrettävän tiedon avulla voidaan päätellä myös tiedot vastaanottava järjestelmä. Huom! Mikäli jotain tietoa ei ole, tyhjää tietoa ei toimiteta. Tyhjiä tageja ei tuoteta siirtotiedostoon. Esim: Määräalan tyypiksi on määritelty NUMBER(4). Jos määräalaa ei ole, niin kentässä pitää olla 0. Schema hyväksyy kenttään "nollaksi" 0, 00, 000 tai 0000. Tagi ei voi olla tyhjä. Tieto <tagi> Osoitetiedot Viestityyppi <viestityyppi> Vastaanottaja <vastaanottaja> Sähköpostiosoite <sahkoposti> Tyyppi ja Pakollisuus Yksikkö Selite CHAR(2) X Lähettävä ilmoitus, tapahtuma tai tieto. Käytössä olevat tunnisteet: K = metsänkäyttöilmoitus P = taimikon perustamisilmoitus, metsälaki R = rahoitushakemus tai toteutusilmoitus, Kemera T = metsäkeskuksen sisäinen toteutusilmoitus, Kemera CHAR(2) X Metsäkeskuksen numero. Käytössä olevat tunnisteet: 01 = Metsäkeskus Rannikko 02 = Metsäkeskus Lounais-Suomi 03 = Metsäkeskus Häme-Uusimaa 04 = Metsäkeskus Kaakkois-Suomi 05 = Metsäkeskus Pirkanmaa 06 = Metsäkeskus Etelä-Savo 07 = Metsäkeskus Etelä-Pohjanmaa 08 = Metsäkeskus Keski-Suomi 09 = Metsäkeskus Pohjois-Savo 10 = Metsäkeskus Pohjois-Karjala 11 = Metsäkeskus Kainuu 12 = Metsäkeskus Pohjois-Pohjanmaa 13 = Lapin metsäkeskus CHAR(50) Ilmoituksen laatijan sähköpostiosoite. Tietoa voidaan hyödyntää mm. tiedonsiirtopalvelun palauteviestien lähettämisessä. Palauteviesti voidaan lähettää tässä ilmoitettuun sähköpostiosoitteeseen.

23.4.2012 12 (36) 4.2 Viestityyppikohtaiset tiedot 4.2.1 Masto-viestit 4.2.1.1 Metsänkäyttöilmoitus (viestityyppi K) Esimerkki metsänkäyttöilmoituksen siirtotiedostosta on liitteessä 1. Tieto Tyyppi ja Pakollisuus Selitteet taulukon alla Yksikkö Selite Ilmoituskohtainen tieto <MkIlmoitus> Mastoviestityyppi <mastoviestityyppi> Korvaava viesti <korvaavaviesti> Ilmoitusviite <ilmoitusviite> Ilmoituksen lisätiedot: Lisätiedot <lisatieto500> Poikkeuslupa <poikkeuslupa> Maanomistajan tiedot: <m:omistaatilan> + <m:omistaja> Nimi <nimi> Lähiosoite <osoite> Postinumero <postinro> Postitoimipaikka <postitoimipaikka> Puhelin <puhelin> CHAR(2) X Lähetettävän tiedon tunniste. Käytössä olevat tunnisteet: MK = metsänkäyttöilmoitus (ML14 ) CHAR(1) Ilmoitetaan, mikäli ilmoituksen lähettäjä korvaa aikaisemman ilmoituksensa lähettämällä uuden korvaavan ilmoituksen. Korvaavan ilmoituksen tulee sisältää kaikki tiedot. Käytössä olevat tunnisteet: 1 = Korvaava metsänkäyttöilmoitus CHAR(30) X Ilmoituksen lähettäjän antama ilmoituskohtainen, valtakunnallisesti yksilöivä viite. Viitettä voidaan käyttää myöhemmin toimitettavien taimikon perustamistietojen kohdentamisessa oikealle käyttöilmoituskuviolle. Ilmoitusviite tallennetaan metsäkeskuksen Masto-järjestelmään. Muodostamissääntö: vastaanottavan metsäkeskuksen numero, lähettäjän organisaatiotunnus, vuosi, lähettäjän antama ilmoituksen yksilöivä tunnus Lähettävän organisaation tunnukset: Metsähallitus=M-H, Foria=FOR, Metsämannut=M-M, Metsänhoitoyhdistys=MHY, Stora Enso=S-E, Tornator=TOR, UPM-Kymmene=UPM, Metsäliitto=M-L, Muu organisaatio=muu. Esim. 01MHY2003999999999999999999999 Jos siirtotiedostossa käytetään MUU-organisaatiotunnusta, on siitä oltava yhteydessä tiedonsiirtopalvelun ylläpitäjään. CHAR(500) CHAR(1) Ilmoituksen laatijan antamat ilmoituskohtaiset vapaamuotoiset lisätiedot. Lisätietoja annettaessa tulee merkitä sen kuvion numero, johon tieto liittyy. Kuviokohtaisen tiedon osalta käytetään ensisijaisesti kuviokohtaista lisätietokenttää. Ilmoitetaan mikäli käyttöilmoitukseen liittyy poikkeuslupahakemus. Hakemus poikkeusluvasta toimitetaan metsäkeskukselle erikseen. Käytössä olevat tunnisteet: 1 = poikkeuslupahakemus määräajasta (ML 14.1 ) CHAR(80) X Kiinteistön omistajan nimi. Omistajalla tarkoitetaan maanomistajaa tai hallintaoikeuden tai muun erityisen oikeuden haltijaa. Henkilönimi ilmoitetaan muodossa: Sukunimi[välilyönti]Etunimi. CHAR(50) X Omistajan lähiosoite. CHAR(9) X Omistajan postinumero. Suomalaiset muotoa: FI-99999 tai FIN-99999. Ulkomaiset postinumerot muotoa: SE-99999 (maatunnus - postinumero). Maatunnukset: www.posti.fi, lähetykset ulkomaille. CHAR(25) X Omistajan postitoimipaikka. CHAR(18) Omistajan puhelinnumero. Muotoa (09)999999999 tai 99999999999

23.4.2012 13 (36) Tieto Tyyppi ja Pakollisuus Yksikkö Selite Selitteet taulukon alla Telefax <telefax> CHAR(18) Omistajan telefax-numero. Muotoa (09)999999999 tai 99999999999 Sähköposti CHAR(50) Omistajan sähköpostiosoite. <sahkoposti> Kiinteistötiedot: <m:kuuluutilaan> + <m:tila> Kunta NUMBER(3) X Kiinteistötunnuksen mukainen sijaintikunnan tunnus. <kunta> Kylä NUMBER(3) X Kiinteistötunnuksen mukainen kylän tunnus. <kyla> Talo NUMBER(4) X Kiinteistötunnuksen mukainen talon tunnus. <talo> Tila NUMBER(4) X Kiinteistötunnuksen mukainen tilatunnus. <tila> Määräala NUMBER(4) X Kiinteistötunnuksen mukainen määräalan numero. <maaraala> Tilan nimi CHAR(30) X Tilan kiinteistörekisterin mukainen nimi. <tilannimi> Hakkuuoikeuden haltijan (puunostajan) tiedot (Pakollinen, jos metsänhakkuuoikeus on luovutettu pystykaupalla ennen ilmoituksen tekoa): <omistaahakoikeuden> + <HakOikHaltija> Nimi CHAR(80) Hakkuuoikeuden haltijan nimi. Useimmiten organisaatio. <nimi> Lähiosoite CHAR(50) Hakkuuoikeuden haltijan lähiosoite. <osoite> Postinumero <postinro> CHAR(9) Hakkuuoikeuden haltijan postinumero. Muotoa FI-99999 tai FIN-99999. Postitoimipaikka CHAR(25) Hakkuuoikeuden haltijan postitoimipaikka. <postitoimipaikka> Puhelin <puhelin> CHAR(18) Hakkuuoikeuden haltijan puhelinnumero. Muotoa (09)999999999 tai 99999999999 Telefax <telefax> CHAR(18) Hakkuuoikeuden haltijan telefax-numero. Muotoa (09)999999999 tai 99999999999 Sähköposti CHAR(50) Hakkuuoikeuden haltijan sähköpostiosoite. <sahkoposti> Ilmoituksen laatijan tiedot (Ilmoituksen laatijana ilmoitetaan henkilö, johon metsäkeskus voi tarvittaessa olla yhteydessä metsänkäyttöilmoituksen tarkastukseen liittyen): <laatinutilmoituksen> + <Ilmoittaja> Nimi <nimi> CHAR(80) X Ilmoituksen laatijan (henkilön) nimi. Ilmoitetaan muodossa: Sukunimi[välilyönti]Etunimi Lähiosoite CHAR(50) X Ilmoituksen laatijan lähiosoite. <osoite> Postinumero <postinro> CHAR(9) X Ilmoituksen laatijan postinumero. Muotoa FI-99999 tai FIN- 99999. Postitoimipaikka CHAR(25) X Ilmoituksen laatijan postitoimipaikka. <postitoimipaikka> Puhelin <puhelin> CHAR(18) Ilmoituksen laatijan puhelinnumero, josta tavoitettavuus paras. Muotoa (09)999999999 tai 99999999999 Telefax <telefax> CHAR(18) Ilmoituksen laatijan telefax-numero. Muotoa (09)999999999 tai 99999999999 Ilmoittajaorganisaatio <organisaationimi> CHAR(80) Ilmoituksen laatijan organisaatio. Valtakirja <valtakirja> CHAR(1) X Ilmoituksen laatijalla on maanomistajan antama valtakirja metsänkäyttöilmoituksen antamisesta maanomistajan puolesta. Käytössä olevat tunnisteet: K = Kyllä E = Ei. Metsäsuunnitelman tiedot (Metsäsuunnitelma on metsäkeskuksen käytössä.) : <sisaltyysuunnitelmaan> + <Metsasuunnitelma> Suunnittelualue NUMBER(3) Suunnittelualueen tunnus. <suunalue> Lohko <lohko> NUMBER(3) Suunnittelulohkon tunnus.

23.4.2012 14 (36) Tieto Ms numero <msnro> Laatijaorganisaatio <laatijaorganisaatio> Tyyppi ja NUMBER(4) CHAR(80) Pakollisuus Selitteet taulukon alla Yksikkö Selite Metsäsuunnitelman numero. Metsäsuunnitelman laatijaorganisaation nimi. Kuviokohtainen tieto Ominaisuustieto (Metsäkeskuksen Masto järjestelmään tallennettava tieto): <mkikuviomember> + <MkiKuvio> Jarjestysnumero NUMBER(3) X Ilmoituskuvion järjestysnumero. Yksilöivä ilmoituksen sisällä. <jarjnro> Kuvionumero NUMBER(4) X Kuvion numero. <kuvionro> Kuvion alanumero CHAR(2) Kuvion numeroon liittyvä alanumero <alanro> Kuvion viite <kuvioviite> CHAR(30) Ilmoituksen laatijan antama kuviokohtainen, yksilöivä viite. Kuvion viite tallennetaan metsäkeskuksen Mastojärjestelmään. Kuviokohtainen yksilöivä viite on tarkin tapa kohdentaa taimikon perustamistiedot automaattisesti oikeille käyttöilmoituskuvioille. Muodostamissääntö: vastaanottavan metsäkeskuksen numero, lähettäjän organisaatiotunnus, vuosi, lähettäjän antama kuvion yksilöivä tunnus Lähettävän organisaation tunnukset: Metsähallitus=M-H, Foria=FOR, Metsämannut=M-M, Metsänhoitoyhdistys=MHY, Stora Enso=S-E, Tornator=TOR, UPM-Kymmene=UPM, Metsäliitto=M-L, Muu organisaatio=muu. Esim. 01MHY2003999999999999999999999 Jos siirtotiedostossa käytetään MUU-organisaatiotunnusta, on siitä oltava yhteydessä tiedonsiirtopalvelun ylläpitäjään. Pinta-ala NUMBER(6,2) X ha Kuvion pinta-ala. Muotoa: 9999.99 (erottimena piste) <pala> Hakkuutapa <haktapa> Tuhon laatu <tuhonlaatu> Erityisen tärkeä elinympäristö, metsälaki 10 <elinymp> Erityisen tärkeä elinympäristö, muu toimenpide 1 <elinymptp1> Erityisen tärkeä elinympäristö, muu toimenpide 2 <elinymptp2> Muu luontokohde <muulkohde> Pääryhmä <paaryhma> Alaryhmä <alaryhma> Kasvupaikka <kasvuplk> Maalaji <maalaji> Pääpuulaji <paapuulaji> CHAR(1) X Käytetään Metsäkeskuskoodeja. Lisätiedot pakollisia, kun hakkuutapa on E (erityishakkuu, ML 6 ) tai hakkuussa on kyse maankäyttömuodon muuttamisesta, tunnus 9 (maankäyttömuodon muutokseen johtava erityishakkuu) tai M (muu hakkuu tai toimenpide). Maankäyttömuodon muutoksen osalta on myös ilmoitettava, onko käyttömuodon muutokselle myönnetty mahdollisesti tarvittava viranomaisen lupa. NUMBER(4) Kuvion tuhon laatu. Luokiteltu muuttuja, ks. metsäkeskuskoodit. NUMBER(4) X Käytetään Metsäkeskuskoodeja. Jos muu kuin 0 (ei elinympäristöä), niin lisätiedot pakollisia. NUMBER(3) NUMBER(3) NUMBER(4) NUMBER(1) NUMBER(1) NUMBER(1) NUMBER(2) Metsälain 10 :n elinympäristöjen aiotusta käsittelystä, myös muista kuin hakkuista, tulee tehdä metsänkäyttöilmoitus (ML 14.1 ). Käytetään Metsäkeskuskoodeja. Lisätiedoissa tulee ilmoittaa, miten hakkuissa tai muissa toimenpiteissä otetaan huomioon elinympäristön ominaispiirteiden käsittely. Käytetään Metsäkeskuskoodeja. Käytetään Metsäkeskuskoodeja. Käytetään Metsäkeskuskoodeja. Käytetään Metsäkeskuskoodeja. Käytetään Metsäkeskuskoodeja. Pakollinen, kun hakkuutapa on uudistushakkuu ( koodit: 4, 5, 6, 7, 8). Käytetään Metsäkeskuskoodeja. NUMBER(2) Puulaji, jonka osuus uudistettavan metsikön runkoluvusta on suurin. Käytetään Metsäkeskuskoodeja. Kehitysluokka CHAR(2) Uudistettavan metsikön kehitysluokka, joka määräytyy vallit-

23.4.2012 15 (36) Tieto <kehlk> Keski-ikä <ika> Keskiläpimitta <klpm> Uudistamistapa ja puulaji <uudtapapuulaji> Maanpinnan käsittelytapa <maanmuok> Muu perustamistoimenpide 1 <perusttp1> Muu perustamistoimenpide 2 <perusttp2> Kuvion lisätiedot <lisatieto100> Kuvion lisätiedot <lisatieto500> Tyyppi ja Pakollisuus Yksikkö Selite Selitteet taulukon alla sevan puuston (vallitsevan puujakson) perusteella. Käytetään Metsäkeskuskoodeja. Pakollinen, kun hakkuutapa on uudistushakkuu ( koodit: 4, 5, 6, 7, 8). NUMBER(3) vuotta Vaihtoehtoinen kehitysluokalle. Masto järjestelmään voidaan tallentaa vain kehitysluokka. Keski-iällä tarkoitetaan metsikön vallitsevan puuston (vallitsevan puujakson) puiden keskimääräistä ikää viiden vuoden tarkkuudella (biologinen ikä). NUMBER(3) cm Vaihtoehtoinen kehitysluokalle. Masto järjestelmään voidaan tallentaa vain kehitysluokka. Keskiläpimitalla tarkoitetaan metsikön 1,3 m korkeudelta maanpinnasta mitattua pohjapinta-alalla painotettua keskiläpimittaa. NUMBER(3) Uudistamispuulaji on se puulaji, johon luontaisessa uudistamisessa pääasiallisesti pyritään tai jolla kylvö tai istutus tehdään. Jos samalla kuviolla tehdään rinnakkaisia toimenpiteitä (esim. sekä kylvöä että istutusta), merkitään kunkin toimenpiteen pinta-ala lisätietoihin. Jos kuivahkoa kangasta rehevämmällä kasvupaikalla aiotaan uudistaa metsää luontaisesti, tulee ilmoituksen lisätiedoissa esittää edellytykset valitulle menetelmälle. Käytetään Metsäkeskuskoodeja. Pakollinen, kun hakkuutapa on uudistushakkuu ( koodit: 4, 5, 6, 7, 8). NUMBER(3) Käytetään Metsäkeskuskoodeja. Pakollinen, kun hakkuutapa on uudistushakkuu ( koodit: 4, 5, 6, 7, 8). NUMBER(3) Uudistamiseen liittyvät muut perustamistoimenpiteet. Jos turvemaan vesitalous on uudistushakkuun vuoksi siinä määrin muuttunut, että se vaarantaa taimikon aikaansaamista, kuuluu taimikon aikaansaamisvelvoitteeseen myös vesitalouden järjestely. Käytetään Metsäkeskuskoodeja. NUMBER(3) Käytetään Metsäkeskuskoodeja. CHAR(100) CHAR(500) Ilmoituksen laatijan antamat vapaamuotoiset lisätiedot. Lisätiedot ovat pakollisia esimerkiksi, kun - toimenpiteet kohdistuvat erityisen tärkeään elinympäristöön (ML10 ) - hakkuun tarkoitus on erityishakkuu (ML 6 ) - hakkuussa on kyse maankäyttömuodon muuttamisesta - luontaista uudistamista käytetään kuivahkoa kangasta rehevämmällä kasvupaikalla. Ilmoituksen laatijan antamat vapaamuotoiset lisätiedot. Lisätiedot ovat pakollisia esimerkiksi, kun - toimenpiteet kohdistuvat erityisen tärkeään elinympäristöön (ML10 ) - hakkuun tarkoitus on erityishakkuu (ML 6 ) - hakkuussa on kyse maankäyttömuodon muuttamisesta - luontaista uudistamista käytetään kuivahkoa kangasta rehevämmällä kasvupaikalla. Sijaintitieto (Metsäkeskuksen Masto järjestelmään tallennettava tieto): Tunnuspiste X Kuvion tunnuspiste. GML:n Point-tyyppinen kohde. <gml:pointproperty> Alue X Kuvion monikulmio. GML:n Polygon-tyyppinen kohde. <gml:polygonproperty> Kullakin siirtotiedoston kuviolla (m:mkikuvio) tulee olla attribuutti jarjnro, joka määrittelee ilmoituskuvion järjestysnumeron metsänkäyttöilmoituksen (m:mkilmoitus) sisällä. Sijaintitieto kuvataan GML 2.1.2 mukaisessa muodossa. Sijaintitiedon esitykselle asetetaan lisäksi seuraavat ehdot: 1) Sijaintiedon tallennuksessa käytetty koordinaatistojärjestelmä ilmoitetaan geometriaelementteihin liitettävän srsname-attribuutin (SRS = Spatial Reference System) avulla. Attribuutin arvot ovat "ETRS-TM35FIN", KKJ1, KKJ2, KKJ3, KKJ4 ja YKJ. Ts. sallitut koordinaatistot ovat ETRS-TM35FIN, KKJ (kaistat 1-4) ja YKJ (=KKJ3). Huom! Suomessa on myös KKJ0 ja KKJ5, joita ei tueta. 2) Koordinaattiluvut ilmoitetaan aina GML:n oletusmuotoa käyttäen. Ts. desimaalierotin (=decimal) =., koordinaattilukujen erotin (=cs) =, ja koordinaattiparien erotin (=ts) =. Koordinaattiluvut ilmoitetaan aina järjestyksessä p-koordinaatti ja i-koordinaatti paitsi ETRS-TM35FIN yhteydessä järjestyksessä i-koordinaatti ja p-koordinaatti. 3) Tunnuspiste ilmoittaa kuvion referenssipisteen sijainnin ja se on pakollinen. 4) Kuvio tulee muodostua yhdestä alueesta. Alue kuvataan Polygon-tyyppisenä rakenteena, joka edelleen muodostuu yhdestä ou-

23.4.2012 16 (36) Tieto Tyyppi ja Pakollisuus Yksikkö Selite Selitteet taulukon alla terboundary-tyyppisestä rakenteesta (pääkuvio) ja nollasta, yhdestä tai useammasta innerboundaryis-tyyppisestä rakenteesta (saarikuvio). Pääkuvion ja mahdolliset saarikuviot kuvataan LinearRing-tyyppisinä rakenteina, jotka vastaavat sulkeutuvia monikulmioita. Alueiden tulee olla sulkeutuvia. Kuvion alkupisteen ja loppupisteen koordinaattien tulee olla samat. 5) Monikulmiot eivät saa leikata toisiaan. Monikulmioiden kulkusuunnalla (myötäpäivään/vastapäivään) ei ole merkitystä. X = Pakollinen tieto. Ilmoituksen lisätiedoissa voidaan vaadittavien tietojen lisäksi antaa tietoja siitä, miten suunnitellussa toimenpiteessä on tarkoitus turvata yleiset edellytykset metsän biologiselle monimuotoisuudelle ominaisten elinympäristöjen säilymiselle myös muualla kuin metsälain 10 :ssä tarkoitetuilla alueilla (MA 9.2 ). Kuvion lisätietojen lähettämiseen voi käyttää joko <lisatieto100> tai <lisatieto500> tagia. XML- Schema hyväksyy myös viestit, joissa esiintyy molemmat tagit. Mikäli molemmissa tageissa tulee tietoa, tällöin vain <lisatieto500> tagissa tullut tieto tallentuu metsäkeskuksen tietokantaan. XML-Schema tarkistaa kaikkien annettujen tietojen koodiarvot ja pakollisten tietojen olemassaolon.

23.4.2012 17 (36) 4.2.1.2 Taimikon perustamisilmoitus (viestityyppi P) Esimerkki taimikon perustamisilmoituksen siirtotiedostosta on liitteessä 3. Tieto Tyyppi ja Pakollisuus Selitteet taulukon alla Yksikkö Selite Ilmoituskohtainen tieto <TpIlmoitus> Kullakin siirtotiedoston ilmoituksella (m:tpilmoitus) tulee olla attribuutti jarjnro, joka määrittelee ilmoituksen järjestysnumeron xmldokumentin sisällä. Jarjestysnumero <jarjnro> NUMBER(3) X Ilmoituksen järjestysnumero. Maksimiarvo 20. Yksilöivä xmldokumentin sisällä. Mastoviestityyppi <mastoviestityyppi> CHAR(2) X Lähetettävän tiedon tunniste. Käytössä olevat tunnisteet: TP = taimikon perustamisilmoitus (ML14a ) Ilmoitusviite <ilmoitusviite> Ilmoituksen lisätiedot: Lisätiedot <lisatieto500> CHAR(30) X Taimikon perustamisilmoituksen viite. Ilmoituksen lähettäjän antama ilmoituskohtainen, valtakunnallisesti yksilöivä viite. Ilmoitusviite tallennetaan metsäkeskuksen Masto-järjestelmään. Muodostamissääntö: vastaanottavan metsäkeskuksen numero, lähettäjän organisaatiotunnus, vuosi, lähettäjän antama ilmoituksen yksilöivä tunnus Lähettävän organisaation tunnukset: Metsähallitus=M-H, Foria=FOR,Metsämannut=M-M, Metsänhoitoyhdistys=MHY, Stora Enso=S-E, Tornator=TOR, UPM-Kymmene=UPM Metsäliitto=M-L, Muu organisaatio=muu. Esim. 01MHY2003999999999999999999999 Jos siirtotiedostossa käytetään MUU-organisaatiotunnusta, on siitä oltava yhteydessä tiedonsiirtopalvelun ylläpitäjään. Viitettä muodostettaessa on mahdollisuus käyttää eri osioiden välillä väliviivoja tai tyhjiä välejä. CHAR(500) Ilmoituksen laatijan antamat ilmoituskohtaiset vapaamuotoiset lisätiedot. Lisätietoja annettaessa tulee merkitä sen kuvion numero, johon tieto liittyy. Kuviokohtaisen tiedon osalta käytetään ensisijaisesti kuviokohtaista lisätietokenttää.

23.4.2012 18 (36) Tieto Tyyppi ja Pakollisuus Yksikkö Selite Selitteet taulukon alla Maanomistajan tiedot: <m:omistaatilan> + <m:omistaja> Nimi <nimi> CHAR(80) X Kiinteistön omistajan nimi. Omistajalla tarkoitetaan maanomistajaa tai hallintaoikeuden tai muun erityisen oikeuden haltijaa. Henkilönimi ilmoitetaan muodossa: Sukunimi[välilyönti]Etunimi. Lähiosoite CHAR(50) X Omistajan lähiosoite. <osoite> Postinumero <postinro> CHAR(9) X Omistajan postinumero. Suomalaiset muotoa: FI-99999 tai FIN-99999. Ulkomaiset postinumerot muotoa: SE-99999 (maatunnus - postinumero). Maatunnukset: www.posti.fi, lähetykset ulkomaille. CHAR(25) X Omistajan postitoimipaikka. Postitoimipaikka <postitoimipaikka> Puhelin CHAR(18) Omistajan puhelinnumero. Muotoa (09)999999999 tai <puhelin> 99999999999 Telefax CHAR(18) Omistajan telefax-numero. Muotoa (09)999999999 tai <telefax> 99999999999 Sähköposti CHAR(50) Omistajan sähköpostiosoite. <sahkoposti> Kiinteistötiedot: <m:kuuluutilaan> + <m:tila> Kunta NUMBER(3) X Kiinteistötunnuksen mukainen sijaintikunnan tunnus. <kunta> Kylä NUMBER(3) X Kiinteistötunnuksen mukainen kylän tunnus. <kyla> Talo NUMBER(4) X Kiinteistötunnuksen mukainen talon tunnus. <talo> Tila NUMBER(4) X Kiinteistötunnuksen mukainen tilatunnus. <tila> Määräala NUMBER(4) X Kiinteistötunnuksen mukainen määräalan numero. <maaraala> Tilan nimi CHAR(30) X Tilan kiinteistörekisterin mukainen nimi. <tilannimi> Ilmoituksen laatijan tiedot (Ilmoituksen laatijana ilmoitetaan henkilö, johon metsäkeskus voi tarvittaessa olla yhteydessä ilmoituksen tarkastukseen liittyen): <laatinutilmoituksen> + <Ilmoittaja> Ilmoittajaorganisaatio <organisaationimi> Nimi <nimi> Lähiosoite <osoite> Postinumero <postinro> Postitoimipaikka <postitoimipaikka> Puhelin <puhelin> Telefax <telefax> CHAR(80) Ilmoituksen laatijan organisaatio. CHAR(80) X Ilmoituksen laatijan (henkilön) nimi. Ilmoitetaan muodossa: Sukunimi[välilyönti]Etunimi CHAR(50) X Ilmoituksen laatijan lähiosoite. CHAR(9) X Ilmoituksen laatijan postinumero. Muotoa FIN-99999. CHAR(25) X Ilmoituksen laatijan postitoimipaikka. CHAR(18) Ilmoituksen laatijan puhelinnumero, josta tavoitettavuus paras. Muotoa (09)999999999 tai 99999999999 CHAR(18) Ilmoituksen laatijan telefax-numero. Muotoa (09)999999999 tai 99999999999 Valtakirja <valtakirja> CHAR(1) X Ilmoituksen laatijalla on maanomistajan antama valtakirja taimikon perustamisilmoituksen antamisesta maanomistajan puolesta. Käytössä olevat tunnisteet: K = Kyllä E = Ei.

23.4.2012 19 (36) Tieto Kuviokohtainen tieto Tyyppi ja Pakollisuus Selitteet taulukon alla Yksikkö Ominaisuustieto (Metsäkeskuksen Masto järjestelmään tallennettava tieto): <tpikuviomember> + <TpiKuvio> Selite Kullakin siirtotiedoston kuviolla (m:tpikuvio) tulee olla attribuutti jarjnro, joka määrittelee ilmoituskuvion järjestysnumeron perustamisilmoituksen (m:tpilmoitus) sisällä. Jarjestysnumero NUMBER(3) X Ilmoituskuvion järjestysnumero. Yksilöivä ilmoituksen sisällä. <jarjnro> Kuvionumero <kuvionro> NUMBER(4) X Kuvion numero. Käytetään ensisijaisesti sitä kuvionumeroa, joka kuviolla oli metsänkäyttöilmoituksessa. Jos mk-ilmoituksen kuvionroa ei ole, käytetään lähettäjän järjestelmässä voimassa olevaa kuvionroa. Tätä tietoa käytetään metsänkäyttöilmoitusvaiheen kuvion tunnistamiseen, jos mk-ilmoituksen ja mki-kuvion viitteitä ei Kuvion alanumero <alanro> Mki-kuvion viite <mkikuvioviite> Mk-ilmoituksen viite <mkilmoitusviite> Kuvion uudistamistyöt loppuun toteutettu <toteutettu> CHAR(2) CHAR(30) CHAR(30) ole käytettävissä. Kuvion numeroon liittyvä alanumero Käytetään ensisijaisesti sitä kuvionumeroa, joka kuviolla oli metsänkäyttöilmoituksessa. Jos mk-ilmoituksen kuvionroa ei ole, käytetään lähettäjän järjestelmässä voimassa olevaa kuvionroa. Tätä tietoa käytetään metsänkäyttöilmoitusvaiheen kuvion tunnistamiseen, jos mk-ilmoituksen ja mki-kuvion viitteitä ei ole käytettävissä. Ilmoituksen laatijan metsänkäyttöilmoituksessa antama kuvioviite sellaisenaan. Kuviokohtainen viite on tarkin tapa kohdentaa taimikon perustamistiedot automaattisesti oikealle käyttöilmoituskuviolle. Ilmoituksen laatijan metsänkäyttöilmoituksessa antama ilmoituksen viitenumero, jos sellainen on käytettävissä omassa järjestelmässä tai saatuna toiselta organisaatiolta (esim. mhy:ltä puunmyyntitarjouksen yhteydessä). Perustamistiedon vastaanotossa keskeinen tieto tunnistettaessa kuviota, johon toteutus liitetään. CHAR (1) X K = Kyllä. Kuviosta ei jatkossa ole tulossa enää toteutustietoa E = Ei. Uudistamistyöt ovat vielä kesken ja jatkossa kuviolle ilmoitetaan lisää toteutustietoa. Sijaintitieto (Metsäkeskuksen Masto järjestelmään tallennettava tieto): Tunnuspiste <gml:pointproperty> Kuvion tunnuspiste. GML:n Point-tyyppinen kohde. Alue X Kuvion monikulmio. GML:n Polygon-tyyppinen kohde. <gml:polygonproperty> Sijaintitieto kuvataan GML 2.1.2 mukaisessa muodossa. Sijaintitiedon esitykselle asetetaan lisäksi seuraavat ehdot: 6) Sijaintiedon tallennuksessa käytetty koordinaatistojärjestelmä ilmoitetaan geometriaelementteihin liitettävän srsname-attribuutin (SRS = Spatial Reference System) avulla. Attribuutin arvot ovat "ETRS-TM35FIN", KKJ1, KKJ2, KKJ3, KKJ4 ja YKJ. Ts. sallitut koordinaatistot ovat ETRS-TM35FIN, KKJ (kaistat 1-4) ja YKJ (=KKJ3). Huom! Suomessa on myös KKJ0 ja KKJ5, joita ei tueta. 7) Koordinaattiluvut ilmoitetaan aina GML:n oletusmuotoa käyttäen. Ts. desimaalierotin (=decimal) =., koordinaattilukujen erotin (=cs) =, ja koordinaattiparien erotin (=ts) =. Koordinaattiluvut ilmoitetaan aina järjestyksessä p-koordinaatti ja i-koordinaatti paitsi ETRS-TM35FIN yhteydessä järjestyksessä i-koordinaatti ja p-koordinaatti. 8) Tunnuspiste ilmoittaa kuvion referenssipisteen sijainnin. 9) Kuvio tulee muodostua yhdestä alueesta. Alue kuvataan Polygon-tyyppisenä rakenteena, joka edelleen muodostuu yhdestä outerboundary-tyyppisestä rakenteesta (pääkuvio) ja nollasta, yhdestä tai useammasta innerboundaryis-tyyppisestä rakenteesta (saarikuvio). Pääkuvion ja mahdolliset saarikuviot kuvataan LinearRing-tyyppisinä rakenteina, jotka vastaavat sulkeutuvia monikulmioita. Alueiden tulee olla sulkeutuvia. Kuvion alkupisteen ja loppupisteen koordinaattien tulee olla samat. 10) Monikulmiot eivät saa leikata toisiaan. Monikulmioiden kulkusuunnalla (myötäpäivään/vastapäivään) ei ole merkitystä.

23.4.2012 20 (36) Tieto Tyyppi ja Pakollisuus Yksikkö Selitteet taulukon alla Toteutustieto (Metsäkeskuksen Masto järjestelmään tallennettava tieto): <sisaltaatoteutuksen> + <TpiToteutus> Selite Kullakin siirtotiedoston toteutustiedolla (m:tpitoteutus) tulee olla attribuutti jarjnro, joka määrittelee toteutustiedon järjestysnumeron kuvion (m:tpikuvio) sisällä. Jarjestysnumero <jarjnro> NUMBER(3) X Toteutustiedon järjestysnumero. Yksilöivä kuviotiedon sisällä. Toteuspinta-ala NUMBER(6,2) X ha Kuvion toteutuspinta-ala. Muotoa: 9999.99 (erottimena piste) <toteutuspala> Uudistamistapa ja puulaji <uudtapapuulaji> NUMBER(3) X Puulaji ja uudistamistapa, jolla uudistaminen on toteutettu. Käytetään Metsäkeskuskoodeja Maanpinnan käsittelytapa <maanmuok> NUMBER(3) X Ilmoitetaan, jos kuviolla on toteutettu maanpinnan käsittely Käytetään Metsäkeskuskoodeja. Muu perustamistoimenpide 1 <perusttp1> Kuvion toteutuksen lisätiedot <lisatieto500> NUMBER(3) CHAR(500) Ilmoitetaan, jos kuviolla on toteutettu muu perustamistoimenpide. Käytetään Metsäkeskuskoodeja. Ilmoituksen laatijan antamat kuvion uudistamisen toteutukseen liittyvät vapaamuotoiset lisätiedot. X = Pakollinen tieto. XML-Schema tarkistaa kaikkien annettujen tietojen koodiarvot ja pakollisten tietojen olemassaolon.

23.4.2012 21 (36) 4.2.2 Kemera-viestit Ensimmäisessä vaiheessa on toteutettu rahoitustyyppi 10 mukaisten jälkirahoitteisten hankkeiden (työlajit 30, 31, 40, 41) sähköinen siirto. Toisessa vaiheessa toteutetaan suunnitelmallisten hankkeiden (työlajit 10, 11, 15 ja 50) siirto. Toisen vaiheen suunnittelussa tarkennetaan mukaan tulevat työlajit. 4.2.2.1 Jälkirahoitteisen metsänhoitohankkeen rahoitushakemus- ja toteutusasiakirjat Jälkirahoitteisista metsänhoitohankkeista siirretään rahoituspäätöksen tekoa ja maksatusta varten rahoitushakemus- ja toteutusasiakirjat. Jälkirahoitteisen hankkeen rahoitushakemus- ja toteutusasiakirjat (toteutusselvitys) siirretään aina samassa XML-tiedostossa niin, että rahoitushakemus on viestissä ennen toteutusselvitystä. Jälkirahoitteisen hankkeen sisältävän siirtotiedoston tiedot ovat: 1) Osoitetiedot. Kohdassa 4.1 kuvatut tiedot. Viestityyppi on R. 2) Rahoitushakemusasiakirjan viestityyppikohtaiset tiedot, jotka sisältävät suunnitelmallista metsänhoitohanketta (kohta 4.2.2.2) vastaavat tiedot. Kemeraviestityyppi on RT. 3) Toteutusasiakirjan viestityyppikohtaiset tiedot, jotka sisältävät suunnitelmallista metsänhoitohanketta (kohta 4.2.2.3) vastaavat tiedot. Kemeraviestityyppi on TK. Huom! Rahoitushakemus- ja toteutustiedot sisältävät osin samoja tietoja. Mm. sijaintitieto toimitetaan aina sekä rahoitushakemuksen että toteutusselvityksen yhteydessä. Esimerkki Kemeran yhden osuuden jälkirahoitteisen hankkeen sisältävästä viestistä on liitteessä 4.

23.4.2012 22 (36) 4.2.2.2 Suunnitelmallisen metsänhoitohankkeen rahoitushakemus Suunnitelmallisista metsänhoitohankkeista siirretään rahoituspäätöksen tekoa varten rahoitushakemus- ja suunnitelmatietoja sekä kartta. Viestin viestityyppi on R ja kemeraviestityyppi on RS. XML-viesti voi sisältää yhteensä enintään 20 ilmoitusta, jotka voivat olla rahoitushakemuksia, toteutusilmoituksia tai molempia. Siirtotiedoston sisältämät tiedot ovat: Tieto (MhRahhak) <tagi> Tyyppi ja Pakollisuus Yksikkö Selite Ilmoituskohtaiset tiedot, metsänhoitohankkeen rahoitushakemus- ja suunnitelmatiedot <MhRahhak> Kullakin siirtotiedoston ilmoituksella (k:mhrahhak) tulee olla attribuutti jarjnro, joka määrittelee ilmoituksen järjestysnumeron xmldokumentin sisällä. Tunnistetiedot Jarjestysnumero <jarjnro> Kemeraviestityyppi <kemeraviestityyppi> Korvaava viesti <korvaavaviesti> Asiakkaan hankeviite <ilmoitusviite> NUMBER(3) X Ilmoituksen järjestysnumero. Maksimiarvo 20. Yksilöivä xmldokumentin sisällä. CHAR(2) X Lähetettävän tiedon tunniste. Käytössä olevat tunnisteet: RS = suunnitelmallisen metsänhoitohankkeen rahoitushakemustiedot. RT = jälkirahoitteisen metsänhoitohankkeen rahoitushakemustiedot. CHAR(1) Ilmoitetaan, mikäli viestin lähettäjä korvaa aikaisemman viestinsä lähettämällä uuden korvaavan viestin. Korvaavan viestin tulee sisältää kaikki tiedot, eikä pelkästään muuttuneet tiedot. Korvaava viesti tulee lähettää samoilla viitetiedoilla (esim. asiakkaan hanke- ja toteutusilmoitusviite) kuin alkuperäinen. Käytössä olevat tunnisteet: 1 = Korvaava rahoitushakemus CHAR(30) X Lähettäjän hankkeen yksilöivä viite, joka yksilöi hankkeen valtakunnallisesti koko organisaatiossa. Viitettä käytetään esim. kun myöhemmin hankkeelle tulevia toteutusilmoituksia kohdennetaan hankkeelle. Muodostamissääntö: vastaanottavan metsäkeskuksen numero, lähettäjän organisaatiotunnus, vuosi, lähettäjän antama hankkeen yksilöivä tunnus. Lähettävän organisaation tunnukset: Metsähallitus=M-H, Foria=FOR, Metsämannut=M-M, Metsänhoitoyhdistys=MHY, Stora Enso=S-E, Tornator=TOR, UPM-Kymmene=UPM, Metsäliitto=M-L, Muu organisaatio=muu. Esim. 01MHY2003999999999999999999999 Jos siirtotiedostossa käytetään MUU-organisaatiotunnusta, on siitä oltava yhteydessä tiedonsiirtopalvelun ylläpitäjään. Paperilomake: Kemera rahoitushakemus, asiakasviite. Lisätietoja <lisatieto500> CHAR(500) Rahoitushakemukseen liittyvät lisätiedot. Korvaavan rahoitushakemuksen tapauksessa lisätiedoissa kuvataan rahoitushakemukseen tulleet muutokset. Paperilomake: Kemera-rahoitushakemus, Lisätietoja.

23.4.2012 23 (36) Tieto (MhRahhak) <tagi> Rahoitushakemuksen tiedot Tyyppi ja Pakollisuus Yksikkö Selite Maanomistajan tiedot: <k:omistaatilan> + <m:omistaja> Hakija <nimi> CHAR(80) X Rahoitusta hakevan maanomistajan tai muun hakijan nimi. Muoto: Sukunimi[välilyönti]Etunimi Paperilomake: Kemera-rahoitushakemus: maanomistaja tai Hakijan lähiosoite <osoite> Hakijan postinumero <postinro> Hakijan postitoimipaikka <postitoimipaikka> Hakijan puhelin <puhelin> Telefax <telefax> Sähköposti <sahkoposti> Kiinteistötiedot: <k:kuuluutilaan> + <m:tila> Kunta <kunta> Kylä <kyla> Talo <talo> Tila <tila> Määräala <maaraala> Tilan nimi <tilannimi> muu hakija. CHAR(50) X Rahoitusta hakevan maanomistajan tai muun hakijan lähiosoite. Paperilomake: Kemera-rahoitushakemus, Lähiosoite CHAR(9) X Rahoitusta hakevan maanomistajan tai muun hakijan postinumero. Muoto: FI-99999 tai FIN-99999 Paperilomake: Kemera-rahoitushakemus, Postinumero CHAR(25) X Rahoitusta hakevan maanomistajan tai muun hakijan postitoimipaikka. Paperilomake: Kemera-rahoitushakemus, Postitoimipaikka CHAR(18) CHAR(18) CHAR(50) Metsäsuunnitelman tiedot <sisaltyysuunnitelmaan> + <Metsasuunnitelma> Suunnittelualue NUMBER(3) <suunalue> Lohko <lohko> Ms-numero <msnro> Laatijaorganisaatio <laatijaorganisaatio> Ms voimassaoloaika, alkuvuosi Rahoitusta hakevan maanomistajan tai muun hakijan puhelinnumero. Muoto: (09)999999999 tai 99999999999 Paperilomake: Kemera-rahoitushakemus, Puhelin Rahoitusta hakevan maanomistajan tai muun hakijan telefax-numero. Muotoa (09)999999999 tai 99999999999 Rahoitusta hakevan maanomistajan tai muun hakijan sähköpostiosoite. NUMBER(3) X Hankkeen kiinteistön kiinteistötunnuksen mukainen kunnan tunnus, ks. Metsäkeskukset ja kunnat. Paperilomake: Kemera-rahoitushakemus, kiinteistötunnus. NUMBER(3) X Hankkeen kiinteistön kiinteistötunnuksen mukainen kylän tunnus. Paperilomake: Kemera-rahoitushakemus, kiinteistötunnus. NUMBER(4) X Hankkeen kiinteistön kiinteistötunnuksen mukainen talon tunnus. Paperilomake: Kemera-rahoitushakemus, kiinteistötunnus. NUMBER(4) X Hankkeen kiinteistön kiinteistötunnuksen mukainen tilan tunnus. Paperilomake: Kemera-rahoitushakemus, kiinteistötunnus. NUMBER(4) X Hankkeen kiinteistön kiinteistötunnuksen mukainen määräalan numero. Paperilomake: Kemera-rahoitushakemus, kiinteistötunnus. CHAR(30) X Hankkeen tilan kiinteistörekisterin mukainen nimi. Nimettömän tilan nimenä ilmoitetaan (NIMETÖN). Paperilomake: Kemera-rahoitushakemus, kiinteistötunnus. NUMBER(3) NUMBER(4) CHAR(80) NUMBER(4) Suunnittelualueen tunnus. Paperilomake: Kemera-rahoitushakemus, metsäsuunnitelman alue. Suunnittelulohkon tunnus. Paperilomake: Kemera-rahoitushakemus, metsäsuunnitelman lohko. Metsäsuunnitelman numero. Ms-numero on annettava, jos metsäsuunnitelma on olemassa, muussa tapauksessa tulkitaan, että metsäsuunnitelmaa ei ole. Paperilomake: Kemera-rahoitushakemus, metsäsuunnitelman no. Metsäsuunnitelman laatijaorganisaation nimi. Paperilomake: Kemera-rahoitushakemus, metsäsuunnitelman laatija. Metsäsuunnitelman voimassaolon alkuvuosi. Jos ms-numero on annettu, on annettava myös metsäsuunn-

23.4.2012 24 (36) Tieto (MhRahhak) <tagi> <msalkuv> Ms suunnitelmakauden <mspituus> Tyyppi ja NUMBER(2) Pakollisuus Yksikkö Selite telman voimassaolon alkuvuosi. Paperilomake: Kemera-rahoitushakemus, metsäsuunnitelman voimassaoloaika. Metsäsuunnitelman suunnitelmakauden. Jos ms-numero on annettu, on annettava myös metsäsuunntelmakauden. Paperilomake: Kemera-rahoitushakemus, metsäsuunnitelman voimassaoloaika. Ilmoituksen laatijan tiedot (Ilmoituksen laatijana ilmoitetaan henkilö, johon metsäkeskus voi tarvittaessa olla yhteydessä ilmoituksen tarkastukseen liittyen): <k:laatinutilmoituksen> + <k:ilmoittaja> Vastuuorganisaatio <organisaationimi> Vastuuhenkilö <nimi> Lähiosoite <osoite> Postinumero <postinro> Postitoimipaikka <postitoimipaikka> Puhelin <puhelin> Telefax <telefax> Valtakirja <valtakirja> Hankkeen perustiedot CHAR(80) X Hankkeen vastuuorganisaation nimi. Paperilomake: Kemera-rahoitushakemus, toteutusselvityksen laatijan/suunnittelijan yhteystiedot tai Kemerasuunnitelma, Vastuuorganisaatio. Huom! Mastossa tieto ei ole pakollinen. CHAR(80) X Hankkeen vastuuhenkilön nimi. Hankkeen vastuuhenkilön tulee aina olla valtuutettu allekirjoittamaan rahoitushakemusasiakirjat. Muoto: Sukunimi[välilyönti]Etunimi Paperilomake: Kamera-rahoitushakemus, toteutusselvityksen laatijan/suunnittelijan yhteystiedot tai Kemerasuunnitelma, Vastuuhenkilö. CHAR(50) X Ilmoituksen laatijan lähiosoite. CHAR(9) X Ilmoituksen laatijan postinumero. Muotoa FI-99999 tai FIN- 99999. CHAR(25) X Ilmoituksen laatijan postitoimipaikka. CHAR(18) Ilmoituksen laatijan puhelinnumero, josta tavoitettavuus paras. Muotoa (09)999999999 tai 99999999999 CHAR(18) Ilmoituksen laatijan telefax-numero. Muotoa (09)999999999 tai 99999999999 CHAR(1) X Ilmoituksen laatijalla on maanomistajan antama valtakirja ilmoituksen antamisesta maanomistajan puolesta. Käytössä olevat tunnisteet: K = Kyllä E = Ei. Laadintapäivämäärä <laadintapvm> Rahoitustyyppi <rahoitustyyppi> Haettava tuki <tukityyppi> Suometsän hoidon Kemeranumero <suokemeranro> Suojametsäalue <suojametsaalue> DATE X Hankkeen laadintapäivämäärä. Muoto: vvvv-kk-pp Paperilomake: Kemera-rahoitushakemus, allekirjoitusaika. NUMBER(2) X Hankkeen rahoitustyyppi. Ensimmäisessä vaiheessa aina 10. CHAR(2) X Haettava tuki. Luokiteltu muuttuja, mahdolliset arvot: A = tehdyn työn kustannuksiin AB = tehdyn työn kustannuksiin ja toteutusselvityksen laadintakustannuksiin C = suunnitelman toteuttamiskustannuksiin D = suunnittelukustannuksiin CD = suunnitelman toteuttamiskustannuksiin ja suunnittelukustannuksiin Paperilomake: Kemera rahoitushakemus, Haen kestävän metsätalouden rahoituslain mukaista tukea. Ensimmäisessa vaiheessa käytössä vain AB NUMBER(14) Suometsän hoidon Kemera-numero. Ilmoitetaan sen suometsänhoitohankkeen Kemera-numero, jonka yhteydessä tehtävälle nuoren metsän hoidolle haetaan korotettua tukea. Ei käytössä ensimmäisessä vaiheessa. Poistettu. CHAR(1) Suojametsäalue. Käytetään osoittamaan, että kyseessä suojametsäalue, jolla voi tehdä luontaista uudistamista.

23.4.2012 25 (36) Tieto (MhRahhak) <tagi> Työosuustiedot <k:mhrahhaktyoosuudet> Tyyppi ja Pakollisuus Yksikkö Selite Käytössä olevat tunnisteet: K = Kyllä E = Ei. Ei käytössä ensimmäisessä vaiheessa. Poistettu. Kullakin siirtotiedoston työosuudella (k:mhrahhaktyoosuudet) tulee olla attribuutti jarjnro, joka määrittelee työosuuden järjestysnumeron ilmoituksen (k:mhrahhak) sisällä. RT 10 työlajeille 30 ja 40 perustetaan oma työosuus. Kustannuslaji 997 ilmoitetaan erikseen työlajin 30 ja 40 työosuuksille työosuuden yhdellä kuviolla. Kustannuslaji 400 ilmoitetaan kuvioittain työosuudella, jonka työlaji on 40. Pystykarsinta aina omana hankkeena Järjestysnumero <jarjnro> Työosuuden numero <tyoosuus> Työosuuden selite <toselite> Työlaji <tyolaji> Työlajin tarkenne <tltarkenne> Tuensaaja <tuensaaja> <k:pankkitili> Tuensaajan pankkitili <IBAN> Pankin BIC-koodi <BIC> Kuvio- ja suunnitelmatiedot NUMBER(3) X Osuuden järjestysnumero. Numero yksilöi osuuden viestin sisällä. Paperilomake: tietoa ei ole paperilomakkeella. NUMBER(3) X Hankkeen työosuuden numero. Jos hankkeella on sekä nuoren kasvatusmetsän hoitoa että energiapuun korjuuta, niin niille perustetaan oma työosuus. Työosuudet voi numeroida vapaasti Paperilomake: Kemera-rahoitushakemus, työosuus no. CHAR(30) Kuvio- ja sijaintitiedot <k:kemkuviomember>+<k:kemkuvio> Kuvio- ja sijaintitieto toimitetaan rahoitushakemuksessa aina. Hankkeen työosuuden selite. Työosuuden selite muodostetaan Kemerarahoitushakemuslomakkeen täyttöohjeen mukaisesti, ks. Kemera-rahoitushakemuslomakkeen täyttöohje. Paperilomake: Kemera-rahoitushakemus, selite. NUMBER(2) X Hankkeen työosuuden työlaji. Luokiteltu muuttuja, ks. metsäkeskuskoodit. Paperilomake: Kemera-rahoitushakemus, työlaji no. NUMBER(1) X Hankkeen työosuuden työlajin tarkenne. Luokiteltu muuttuja, ks. metsäkeskuskoodit. Paperilomake: tietoa ei ole Kemera-rahoitushakemuksella. CHAR(80) X Työosuuden tuensaajan nimi. Muoto: Sukunimi[välilyönti]Etunimi Ks. Kemera-rahoitushakemuslomakkeen täyttöohje. Paperilomake: Kemera-rahoitushakemus, Tuen saaja. CHAR(40) X Työosuuden tuensaajan IBAN-pankkitilin numero konekielisessä muodossa ilman tyhjeitä. Paperilomake: Kemera-rahoitushakemus, Pankkitili. CHAR(11) X Pankin BIC-koodi. Kullakin siirtotiedoston kuviolla (k:kemkuvio) tulee olla attribuutti jarjnro, joka määrittelee ilmoituskuvion järjestysnumeron ilmoituksen (k:mhrahhak) sisällä. Järjestysnumero <jarjnro> NUMBER(3) X Kuvion järjestysnumero. Numero yksilöi kuvion viestin sisällä. Kuvionumero <kuvionro> Kuvion alanumero <alanro> Paperilomake: tietoa ei ole paperilomakkeella. NUMBER(4) X Kuvion numero. Käytetään ensisijaisesti sitä kuvionumeroa, joka kuviolla oli metsänkäyttöilmoituksessa. Jos mk-ilmoituksen kuvionroa ei ole, käytetään lähettäjän järjestelmässä voimassa olevaa kuvionroa. Paperilomake: Kemera-suunnitelma, Kuvio. NUMBER(2) Kuvion alanumero. Kuvion alanumero voi olla vain numero. Käytetään ensisijaisesti sitä kuvionumeroa, joka kuviolla oli metsänkäyttöilmoituksessa. Jos mk-ilmoituksen kuvionroa ei ole, käytetään lähettäjän järjestelmässä voimassa olevaa kuvionroa. Paperilomake: Kemera-suunnitelma, Kuvio.