Teknisk beskrivning Datatjänsten för fastighetsregistret
Schema
Koder
Kodgrupperna för fastighetsregister, föreskrift samt tilläggen (på finska)
Tekniska koder (på finska)
Datahämtning
Material levereras till dataförmedlingskatalogen, varifrån uppgifter kan hämtas antingen manuellt eller automatiskt. För katalogen behövs användar-id och lösenord. Adressen till dataförmedlingskatalogen och identifierarna skickas i samband med den första beställningen.
- Material finns tillgängligt på morgonen efter avskiljningen.
- Uppgifterna motsvarar alltid de uppdaterade registeruppgifterna vid avskiljningstidpunkten.
- I dataförmedlingsindexet grupperas material enligt materialtyper.
- Material ska laddas ned i kronologisk ordning för avskiljningstidpunkten.
- Filerna förvaras i katalogen 60 dygn efter att de framställts.
Material kan hämtas antingen över https eller med hjälp av webdav-tekniken tillsammans med https.
De ändringar som gjorts i Registerföringen (registrering av underhållshändelser) syns i datatjänsten följande dag. De ändringar som gjorts på fredag syns först på måndag. Ifall avskiljning av material ska ske t.ex. på en onsdag, sker avskiljningen under onsdagens första timmar efter att tisdagens ändringar i registerföringen har förts in i registret.
Datamaterial och produkter
Fastighetsregistrets omfattande uppgifter
Vad gäller registerenheter skrivs ut de uppgifter som motsvarar fastighetsregisterutdragets uppgifter samt registerenhetens lägesuppgifter: objektets basuppgifter, bildningsuppgifter, outbrutna områden, andelar i samfällda områden som överlåtits separat, uppgifter om markanvändningsbeslut, servitut, nyttjanderätter, nyttjandebegränsningar, andelar i samfällda områden och särskilda förmåner, fastighetsförrättningar, beslut av myndighet, skiften, fastighetsgränser och råmärken.
Objekt kan hämtas på tre olika sätt:
- med en objektbeteckning, varvid uppgifterna för enskilda objekt skrivs ut
- genom kommunavgränsning, varvid uppgifterna för de objekt som befinner sig inom de valda kommunernas område skrivs ut
- enligt förändrade objekt, varvid uppgifterna för de objekt som ändrats i registret under en angiven tidsperiod skrivs ut
Om varje valt objekt skrivs ut dess fullständiga uppgifter. Om inga objekt hittas, skrivs ut under rotelementet <TietoaKiinteistorekisterista/> (information om Fastighetsregistret) endast metadata.
När objekt hämtas med hjälp av objektbeteckningar eller som avskiljning av förändrade objekt är resultatfilen en komprimerad fil vars namn är i enlighet med 'namn på beställning'_'avskiljningsdatum'0000.zip, till exempel Kuusamo_toisten_ominaisuus_muutokset_201311250000.zip. Den komprimerade filen innehåller två xml-filer: den egentliga resultatfilen vars namn är i enlighet med ATP_(7 siffror)_(13 siffror).xml samt en fil som innehåller avskiljningens metadata och vars namn är i enlighet med ATP_(7 siffror)_(13 siffror).META.xml. Siffrorna i resultatfilens och metafilens namn är sinsemellan lika men förändras vid varje avskiljning.
När objekt hämtas genom kommunavgränsning, uppdelas materialet i mindre filer enligt fastighetsbeteckningens sex första tecken. Till en och samma delfil hämtas sådana registerenheter vars fastighetsbeteckningar vad gäller de sex första tecknen motsvarar varandra. Varje delfil bildas till en separat komprimerad fil vars namn är i enlighet med ’fastighetsbeteckningens sex första tecken'_ATP_(7 siffror)_(13 siffror).zip, till exempel 740001_ATP_1820146_1386200211074.zip. Den komprimerade filen innehåller två xml-filer: den egentliga resultatfilen med ett namn i enlighet med ’fastighetsbeteckningens sex första tecken’ _ATP_(7 siffror)_(13 siffror).xml samt en fil som innehåller avskiljningens metadata och vars namn är i enlighet med ’fastighetsbeteckningens sex första tecken'_ATP_(7 siffror)_(13 siffror).META.xml. Siffrorna i den komprimerade filens, resultatfilens och metafilens namn är sinsemellan lika men förändras vid varje avskiljning
I produktschemat finns delar som används i flera informationstjänstprodukter. Av detta skäl innehåller schemat även sådana uppgifter som aldrig skrivs ut i produkten ifråga.
En allmän beskrivning av informationsinnehållet (på finska)
1) Avhämtning av uppgifter med objektbeteckning
Till resultatfilen hämtas de registerenheter som är i enlighet med de objektbeteckningar som använts som sökparametrar. Angående varje avhämtad registerenhet skrivs ut fullständiga produktenliga uppgifter.
Sökparametrar
| Namn | Antal | Värde | Kommentar |
| objektbeteckning | 1..n | fastighetsbeteckning | Obligatorisk |
Utskrivningsparametrar
| Namn | Antal | Värden | Kommentar |
| koordinatsystem | 1 |
Möjliga värden:
|
Koordinaterna för alla lägesobjekt skrivs ut i det valda koordinatsystemet. |
2) Avhämtning av uppgifter med kommunavgränsning
Till resultatfilen hämtas alla giltiga och upphörda registerenheter inom den kommuns område som använts som sökparameter. Angående varje avhämtad registerenhet skrivs ut fullständiga produktenliga uppgifter.
Sökparametrar
| Namn | Antal | Värden | Kommentar |
| kommun | 1 | kommunbeteckning | Obligatorisk |
Utskrivningsparametrar
| Namn | Antal | Värden | Kommentar |
| koordinatsystem | 1 |
Möjliga värden:
|
Koordinaterna för alla lägesobjekt skrivs ut i det valda koordinatsystemet. |
3) Avhämtning av uppgifter om förändrade objekt
Till resultatfilen hämtas alla giltiga och upphörda registerenheter som har förändrats enligt de angivna parametrarna. Angående varje avhämtad registerenhet skrivs ut fullständiga produktenliga uppgifter.
Sökparametrar
| Namn | Antal | Värden | Kommentar |
| kommun | 1 | kommunbeteckning | |
| typ av händelse | 1 |
Kodlistans Fds datamaterialöverlåtelse
|
|
| typ av ändring | 1..n |
Kodlistans Fds datamaterialöverlåtelse
|
|
| begynnelsevärdet vid ändringsdatum | 1 | datum | |
| slutvärdet vid ändringsdatum | 1 | datum |
Utskrivningsparametrar
| Namn | Antal | Värden | Kommentar |
| koordinatsystem | 1 |
Möjliga värden:
|
Koordinaterna för alla lägesobjekt skrivs ut i det valda koordinatsystemet. |
Fastighetsregistrets egenskapsuppgifter
Om registerenheter skrivs ut objektets basuppgifter, bildningsuppgifter, outbrutna områden, andelar i samfällda områden som överlåtits separat, uppgifter om markanvändningsbeslut. Vag gäller outbrutna områden och andelar i samfällda områden som överlåtits separat skrivs ut endast objektets basuppgifter. I produkten ingår inga lägesuppgifter.
Objekt kan hämtas på tre olika sätt:
- med en objektbeteckning, varvid uppgifterna för enskilda objekt skrivs ut
- genom kommunavgränsning, varvid uppgifterna för de objekt som befinner sig inom de valda kommunernas område skrivs ut
- enligt förändrade objekt, varvid uppgifterna för de objekt som ändrats i registret under en angiven tidsperiod skrivs ut
Om varje avhämtat objekt skrivs ut dess fullständiga uppgifter. Om inga objekt hittas, skrivs ut under rotelementet <TietoaKiinteistorekisterita/> (information om Fastighetsregistret) endast metadata.
Resultatfilen är en komprimerad fil vars namn är i enlighet med 'namn på beställningen'_'avskiljningsdatum'0000.zip, till exempel Kuusamo_kr_ominaisuus_muutokset_rek_201311250000.zip. Den komprimerade filen innehåller två xml-filer: den egentliga resultatfilen vars namn är i enlighet med 'namn på beställningen'_'avskiljningsdatum'0000.xml samt en fil som innehåller avskiljningens metadata och vars namn är i enlighet med 'namn på beställningen'_'avskiljningsdatum'0000.META.xml.
Produktscheman innehåller delar som används i flera informationstjänstprodukter. Av detta skäl innehåller scheman även sådana uppgifter som inte någonsin skrivs ut i samband med denna produkt.
Beskrivning av informationsinnehållet
- registerenhet (på finska)
- outbrutet område (publiceras senare)
1) Avhämtning av uppgifter med objektbeteckning
Till resultatfilen hämtas de objekt (registerenheter och/eller outbrutna områden) som är i enlighet med de objektbeteckningar som använts som sökparametrar. De objekt som ska hämtas kan avgränsas med hjälp av filtreringsparametrar. Angående varje avhämtad registerenhet skrivs ut fullständiga produktenliga uppgifter.
Sökparametrar
| Namn | Antal | Värde | Kommentar |
| objektbeteckning | 1..n | fastighetsbeteckning, beteckning för outbrutet område | Obligatorisk |
Filtreringsparametrar
| Namn | Antal | Värden | Kommentar |
| tillstånd | 0..2 |
Kodlistans Tillstånd värden:
|
2) Avhämtning av uppgifter med kommunavgränsning
Till resultatfilen hämtas alla objekt (registerenheter och/eller outbrutna områden) som är i enlighet med den kommun och den objekttyp som använts som sökparametrar. De objekt som ska hämtas kan avgränsas med hjälp av filtreringsparametrar. Angående varje avhämtad registerenhet skrivs ut fullständiga produktenliga uppgifter.
Sökparametrar
| Namn | Antal | Värden | Kommnetar |
| kommun | 1 | kommunbeteckning | Obligatorisk |
| typ av objekt | 0..2 | registerenhet eller outbrutet område | Om inget val gjorts, hämtas både registerenheterna och de outbrutna områdena. |
Filtreringsparametrar
| Namn | Antal | Värden | Kommentar |
| tillstånd | 0..2 |
Kodlistans värden för Tillstånd:
|
|
| typ av registerenhet | 0..n |
värden för Typ av registerenhet:
|
Filtrerar registerenheter |
| jordarealens minimistorlek | 0..1 | Totalantal i kvadratmeter | Filtrerar registerenheter |
| jordarealens maximistorlek | 0..1 | Totalantal i kvadratmeter | Filtrerar registerenheter |
3) Avhämtning av uppgifter om förändrade objekt
Till resultatfilen hämtas de objekt (registerenheter och/eller outbrutna områden) som har förändrats enligt det i sökparametrarna angivna sättet. De objekt som ska hämtas kan avgränsas med hjälp av filtreringsparametrar. Angående varje avhämtad registerenhet skrivs ut fullständiga produktenliga uppgifter.
Sökparametrar
| Namn | Antal | Värden | Kommentar |
| kommun | 0..n | kommunbeteckning | Om inte angiven, omfattar avhämtningen hela Finland. |
| typ av objekt | 1 | registerenhet eller outbrutet område | Till samma fil kan hämtas endast antingen förändrade registerenheter eller endast förändrade outbrutna områden. Om kunden vill ha uppgifterna både om förändrade registerenheter och om förändrade outbrutna områden, ska kunden göra två separata beställningar. |
| typ av ändringshändelse | 1..n |
Kodlistans värden för Typ av ändringshändelse:
|
Obligatorisk Med kodvärdena 207, 208, 209 och 211 hämtas endast registerenheter. Med kodvärdet 210 hämtas endast outbrutna områden. Kodvärdet 201 innehåller alla kodvärdenas 202-211 förändringar. Kodvärdet 201 kan användas då man inte vill avgränsa sin sökning av ändringshänselser eller utskrivning av uppgifter med de noggrannare kodvärdena 202–211. |
| begynnelsevärdet vid ändringsdatum |
1 | datum | Obligatorisk |
| slutvärdet vid ändringsdatum |
1 | datum | Obligatorisk |
Filtreringsparametrar
| Namn | Antal | Värden | Kommentar |
| tillstånd | 0..2 |
Kodlistans värden för Tillstånd:
|
Filtrerar både registerenheter och outbrutna områden. |
| typ av registerenhet | 0..n |
Kodlistans värden för Typ av registerenhet:
|
Filtrerar registerenheter. |
| jordarealens minimistorlek | 0..1 | Totalantal i kvadratmeter | Filtrerar registerenheter |
| jordarealens maximistorlek | 0..1 | Totalantal i kvadratmeter | Filtrerar registerenheter |
Exempelfiler
Felhantering
Ifall problem uppstår i Datatjänsten (fastighetsregistret), meddelar kundstödet för webbtjänster om detta till de kontaktpersoner vilka angetts i samband med beställningen. Returmeddelandet eller den tidsinställda hela kommunens avskiljning, den s.k. tidsbundna avskiljningen, har eventuellt innehållit materialfel eller har inte alls bildats av tekniska skäl.
Materialfelet i returmeddelandet eller i den tidsbundna avskiljningen korrigeras antingen i den kommun som registrerat uppgiften eller vid Lantmäteriverket. Lantmäteriverket sörjer för att korrigeringsbegäran skickas till rätta parter.
Trots materialfel kan filerna laddas ned i kommunsystemet eftersom det felaktiga objektet lämnas bort. Filen innehåller endast en anteckning om att fel uppstått. Materialfel korrigeras och ifrågavarande uppgifter tas med i nästa lyckade returmeddelande. När det gäller tidsbunden avskiljning är det möjligt att efter korrigeringen av materialfelet framställa en särskild korrigeringsfil som skickas till dataförmedlingskatalogen. Korrigeringsfilen ska laddas ned i kronologisk ordning enligt avskiljningstidpunkten jämfört med andra returmeddelandefiler.
Ifall returmeddelanden eller de tidsbundna avskiljningarna av tekniska skäl inte alls har bildats, finns uppgifterna med i nästa lyckade materialavskiljning från och med den föregående lyckade avskiljningen. Om uppgifterna i returmeddelandet eller den tidsbundna avskiljningen behövs före den följande tidsinställda avskiljningen kan kundstödet för webbtjänster på begäran skicka ifrågavarande uppgifter. Begäran ska lämnas per e-post.
Om man märker att det finns felaktigheter i vissa fastighetsuppgifter i kommunsystemet jämfört med fastighetsregisteruppgifterna, kan en separat korrigering göras. Korrigeringen kan begäras per e-post hos kundstödet webbtjänster. För korrigeringarna behövs en förteckning över de fastighetsbeteckningar vilkas uppgifter behövs.