Forklaring av datafeltene
Datafelt
Byggeåret er det året bruksenheten var ferdigstilt og kunne tas i bruk første gang. Rehabilitering, oppussing og påbygning i ettertid endrer ikke byggeåret. Byggeåret kan ikke være frem i tid.
Byggeår er et nytt datafelt i matrikkelen, og er per nå kun egenregistrert.
Bruksareal er alt innvendig areal innenfor ytterveggene til bruksenheten. Arealet oppgis som totalt for hele bruksenheten.
Vannforsyning sier om og hvordan bruksenheten får tilgang til rent vann. Det kan være en av følgende verdier:
- Offentlig vannverk
- Privat vannverk
- Annen privat innlagt vann
- Ikke innlagt vann
Avløp beskriver systemet for håndtering av brukt vann fra bruksenheten. Det kan være en av følgende verdier:
- Offentlig kloakk
- Privat kloakk
- Ingen kloakk
Dette er den eller de kildene som gir energi til belysning, apparater eller oppvarming. Det er en liste med en eller fler av følgende verdier:
- Biobrensel
- Elektrisitet
- Fjernvarme
- Gass
- Flytende brensel
- Solenergi
- Varmepumpe
- Annen energikilde
- Ingen energikilde
Dette er måtene varme leveres på i bruksenheten. Det er en liste med en eller flere av følgende verdier:
- Elektrisk
- Sentralvarme
- Annen oppvarming
- Ingen oppvarming
Metadata
Beskriver når, av hvem, og hvordan en registrering har blitt gjennomført.
Prosess
Prosessen beskriver hvordan registreringen har blitt gjort. For data hentet via dette API-et vil, per nå, prosess alltid være "Egenregistrering".
Denne metadataen ligger på alle de egenregistrerte feltene, fordi det er viktig å skille mellom hvilken data som er registrert av eier/fester og hvike data som er registrert av saksbehandler.
Registreringstidspunkt (kun for rettighetspakkene: utvidet uten pii og utvidet )
Dato og klokkeslett registreringen ble sendt inn. Dersom en eier endrer noe av metadataen på et datafelt, for eksempel i ettertid gjør en endring på årstallet noe er gyldig fra, vil registreringstidspunktet også oppdateres til tidspunktet siste endring ble sendt inn.
RegistrertAv (kun for rettighetspakke: utvidet)
Fødselsnummeret til den som har registrert. Dersom en eier endrer noe av metadataen på et datafelt, for eksempel i ettertid gjør en endring på årstallet noe er gyldig fra, vil registrertAv være fødselsnummerert til den som sist har endret på feltet.
Beskriver kildematerialet som dataen i registreringen baserer seg på. Kildemateriale kan være en av følgende:
- Selvrapportert
- Salgsoppgave
- Byggesaksdokumenter
- AnnenDokumentasjon
- IkkeAktuelt (settes automatisk der valg av kildemateriale ikke har vært tilgjengelig for eier)
Angir om objektet er gjeldende for bruksenheten på tidspunktet informasjonen hentes ut.
Hvis verdien er true, er objektet gjeldende nå. Hvis verdien er false,
har objektet tidligere vært gjeldende, men gjelder ikke lenger. Objektet vil da også ha et gyldigTil-årstall.
Alle datafelter, unntatt byggeår, har metadataen erGjeldende. Dette skyldes at byggeår ikke har en reell historikk eller gyldighetsperiode som de andre feltene. Hvis det finnes et byggeår regnes det som gyldig.
Gyldighetsperioden oppgir tidsperioden det registrerte dataobjektet har vært gyldig. Gyldighetsperioden består av et gyldigFra: året noe begynte å gjelde, og gyldigTil: året noe sluttet å gjelde.
GyldigFra
Det kalenderåret objektet oppstod i den virkelige verden. Ikke alle objekter har gyldigFra-årstall, fordi det ved første registrering av et objekt er frivillig for eier å oppgi gyldigFra.
Dersom det finnes en registrert verdi fra før, og eier skal registrere noe nytt, må eier ta stilling til både når eksisterende verdi opphørte, og når ny verdi oppstod. For de opplysningene som kan ha flere gyldige datafelter samtidig (energikilde og oppvarming) er gyldigFra frivillig for den første registreringen av hvert unike datafelt.
GyldigTil
Det kalenderåret objektet sluttet å eksistere i den virkelige verden.
GyldigTil vil være null frem til et dataobjekt opphøres. Ved opphøring av et
objekt er det påkrevd for eier å registrere gyldigTil-årstall.
Eksempel
En eier registrerer vannforsyning. Ved første registrering oppgir eier at den
har "offentlig vannforsyning", men vet ikke fra hvilket årstall dette gjelder.
I dette eksempelet er null eksplisitt satt,
men i den faktiske responsen er den utelatt dersom verdien er null.
Bruksenhetens vannforsyning ser da slik ut:
{
"data": "OffentligVannforsyning",
"erGjeldende": true,
"gyldighetsperiode": {
"gyldigFra": null,
"gyldigTil": null
}
}
Noen år senere har eier fått innlagt privat vann og ønsker å registrere dette. Fordi det allerede finnes en registrering av vannforsyning må eier først opphøre den eksisterende registreringen (og setter gyldigTil-årstall), før eier kan registrere nytt objekt (med gyldigFra-årstall).
Da ser bruksenhetens vannforsyning (med historikk) slik ut:
{
"data": "OffentligVannforsyning",
"erGjeldende": false,
"gyldighetsperiode": {
"gyldigFra": null,
"gyldigTil": 2025
}
}
{
"data": "PrivatVannforsyning",
"erGjeldende": true,
"gyldighetsperiode": {
"gyldigFra": 2025,
"gyldigTil": null
}
}