BBR OIOXML. Vejledning til snitfladen: Address.wsdl

Transkript

1 OIOXML Vejledning til snitfladen: En vejledning rettet mod 3. part.

2 Ændringer i forhold til forrige versioner Version 1.0 Første version, Version : Opdateret med de tilbagemeldinger som blev modtaget efter udsendelse af version 1.0. Version AddressAccessIdentifier optionel i AddressSpecificUserKeys RecordChangeDateTime tilføjet til AddressPoint- DeleteResponseStructure. RecordChangeDateTime tilføjet til AddressPoint- CreateRequestStructure. Præcisering vedr. brug af vejkoder, som ikke er valid i CPR. (afsnit 3.5.1) Diverse præciseringer vedrørende brug af metoderne. Nyt afsnit 4.6 skemavalidering Fejlrettelser/Opdateringer i vejledningen: Nye billeder af strukturer, som afspejler at snitfladen benytter NDR 3.0 versionen af vejnavn Søgning returnerer max 100 resultater Beskrivelse af at søgningen både returnerer sagsog gældende adresser Vejdistrikt præciseret Nye afsnit 4.7, 4.8, 4.9, 4.10 Ny afsnit 11.2 (Kodeeksempel for kald af certifikat) Henvisning til andre OIO snitflader Snitfladebeskrivelse Side 2 af 89

3 Indholdsfortegnelse 1. Introduktion Formål og målgrupper Formål Målgrupper Datasammenhæng Adgangsadresser og enhedsadresser Gældende adresser Foreløbige adresser og sagsadresser Adressesager Adressers entydighed Adgangsadresser uden husnummer Adresseforekomstens liv Adressepunkt Adressers tilknytning til matrikler Status for adresser webservice IgnoreWarningIndicator printenableindicator Opdateringsmekanisme RecordChangeDateTime Foreløbige koordinater Skemavalidering Namespaces Datatyper Udviklingsværktøjer Rettigheder Metoder til adgangsadresser AddressAccessGetById AddressAccessGetByIdRequestStructure AddressAccessGetByIdResponseStructure AddressAccessGet AddressAccessGetRequestStructure AddressAccessGetResponseStructure AddressAccessCreate AddressAccessCreateRequestStructure AddressAccessCreateResponseStructure AddressAccessUpdate AddressAccessUpdateRequestStructure AddressAccessUpdateResponseStructure AddressAccessDelete AddressAccessDeleteRequestStructure AddressAccessDeleteResponseStructure Metoder til enhedsadresser AddressSpecificGetById AddressSpecificGetByIdRequestStructure AddressSpecificGetByIdResponseStructure AddressSpecificGet Snitfladebeskrivelse Side 3 af 89

4 AddressSpecificGetRequestStructure AddressSpecificGetResponseStructure AddressSpecificCreate AddressSpecificCreateRequestStructure AddressSpecificCreateResponseStructure AddressSpecificUpdate AddressSpecificUpdateRequestStructure AddressSpecificUpdateResponseStructure AddressSpecificDelete AddressSpecificDeleteRequestStructure AddressSpecificDeleteResponseStructure Metoder til adressesager AddressCaseGetById AddressCaseGetByIdRequestStructure AddressCaseGetByIdResponseStructure AddressCaseGet AddressCaseGetRequestStructure AddressCaseGetResponseStructure AddressCaseCreate AddressCaseCreateRequestStructure AddressCaseCreateResponseStructure AddressCaseUpdate AddressCaseUpdateRequestStructure AddressCaseUpdateResponseStructure AddressCaseDelete AddressCaseDeleteRequestStructure AddressCaseDeleteResponseStructure Metoder til adressegeometri AddressPointCreate AddressPointCreateRequestStructure AddressPointCreateResponseStructure AddressPointUpdate AddressPointUpdateRequestStructure AddressPointUpdateResponseStructure AddressPointDelete AddressPointDeleteRequestStructure AddressPointDeleteResponseStructure Metoder til søgningerne AddressSearch AddressSearchRequestStructure AddressSearchResponseStructure AddressCaseSearch AddressCaseSearchRequestStructure AddressCaseSearchResponseStructure Fælles strukturer AddressAccessRequestStructure AddressAccessResponseStructure AddressAccessUserKeys AddressAccessInformation AddressAccessRequestDates AddressAccessResponseDates Snitfladebeskrivelse Side 4 af 89

5 10.7. AddressAccessCaseResponse AddressSpecificRequestStructure AddressSpecificResponseStructure AddressSpecificUserKeys AddressSpecificInformation AddressSpecificRequestDates AddressSpecificResponseDates AddressSpecificCaseResponse AddressCaseRequestStructure AddressCaseResponseStructure AddressCaseAddressAccessRequestKeys AddressCaseAddressSpecificRequestKeys AddressCaseAddressAccessResponseKeys AddressCaseAddressSpecificResponseKeys ExternalReferences BBBlandParcelIdentityStructure addresspoint MunicipalityFields ReturnMessage Adgang til snitfladen Sikkerhed Kodeeksempel for kald af certifikat Autorisation Testmiljø Snitfladebeskrivelse Side 5 af 89

6 1. Introduktion Denne snitfladebeskrivelse beskriver en af de OIOXML snitflader, som systemet stiller til rådighed. Baggrunden for snitfladen er, at man ønsker at registrere og opdatere adresser i ved webservicebaseret overførsel fra et ekstern system i OIOXML format. Snitfladen findes på Kommune under Selve dokumentationen findes i biblioteket documents : Selve servicen/wsdl en i biblioteket servicegateway : Snitfladebeskrivelsen giver kort sagt mulighed for fremsøgning samt opdatering af adressedata i, herunder adgangsadresser og deres geometri, enhedsadresser, samt adressesager. Kapitel 2 giver en mere detaljeret beskrivelse af snitfladens formål samt dens målgruppe. Kapitel 3 beskriver de grundlæggende begreber og definitioner for adresser, herunder adgangsadresser, adressepunkter, enhedsadresser og adressesager. Kapitel 4 giver et overblik over den webservice og dens metoder, som udgør snitfladen. Det tilhørende WSDL-dokument, som kan betegnes som kontrakten på snitfladens interface/struktur, bliver beskrevet. Snitfladens metoder kan deles op i 5 områder. Disse 5 områder og de tilhørende metoder beskrives i detaljer i kapitel 5 til 9. kapitel 5 beskriver metoderne til entiteten adgangsadresse kapitel 6 beskriver metoderne til entiteten enhedsadresse kapitel 7 beskriver metoderne til entiteten adressessag kapitel 8 beskriver metoderne til entiteten adressepunkt kapitel 9 beskriver metoderne til søgninger på adresser og adressesager Beskrivelsen af metoderne indeholder også en beskrivelse af de anvendte strukturer. Kapitel 10 beskriver nogle fælles strukturer, som benyttes i mere end en metode. Kapitel 11 beskriver de betingelser, som skal være opfyldt for at få adgang til snitfladen, deriblandt sikkerheden omkring snitfladen. Der gøres opmærksom på, at denne snitflade alene dækker data i 's Adresse del. Ud over denne snitflade findes 4 andre snitflader, som er relevante, hvis man ønsker at udvikle applikationer til systemet. Snitfladebeskrivelse Side 6 af 89

7 Snitfladen BuildingDwelling dækker over systemets Bygninger og boliger del og stiller metoder til hentning og opdatering af grunde/ bygninger/enheder/brugsenheder/teknisk anlæg/opgange/etager/rum/byggesager til rådighed. Snitfladen Permission stiller funktionalitet til rådighed, som er relevant både når man benytter Address eller BuildingDwelling. Denne service tilbyder metoder til at få oplysninger om feltrettigheder i Nyt. Afhængig af hvilke roller man er tildelt i Nyt vil man have adgang til at læse, skrive eller læse/skrive til de enkelte felter. Snitfladen CodeList stiller funktionalitet til rådighed, som er relevant både når man benytter Address eller BuildingDwelling. Denne service tilbyder tre metoder til at få oplysninger om kodelister i Nyt. Snitfladen StreetName stiller funktionalitet til rådighed, som er relevant både når man benytter Address eller BuildingDwelling. Denne service tilbyder 2 metoder til at hente veje og adgangsadresser i. Vejledninger til snitfladerne kan finde her: Snitfladebeskrivelse Side 7 af 89

8 2. Formål og målgrupper 2.1. Formål Snitfladen har til formål at gøre det muligt for kommunerne at fremsøge og ajourføre adressedata i. Snitfladen er en tovejskommunikation mellem en leverandør/kommune og systemet. Den gør det muligt at hente adressedata fra systemet og den gør det muligt at sende adressedata til opdatering af. Når der skrives adressedata dækker det over følgende entiteter: adgangsadresser enhedsadresser adressesager adressepunkter hørende til adgangsadresser 2.2. Målgrupper Snitfladens funktioner henvender sig hovedsaglig til private eller offentlige itvirksomheder som ønsker udvikle it- eller GIS-løsninger eller andre komponenter, der ved hjælp af webservicebaseret overførsel kan anvendes til at registrere eller opdatere s adresseoplysninger inkl. adressepunkter (dvs. adressekoordinater). Snitfladebeskrivelse Side 8 af 89

9 3. Datasammenhæng Snitfladen indeholder metoder hørende til følgende 4 entiteter Adgangsadresse Enhedsadresse Adressesag Adressepunkt For at kunne forstå den efterfølgende vejledning er det vigtigt at kende de følgende begreber og definitioner, samt begrebernes sammenhæng Adgangsadresser og enhedsadresser Ved en adgangsadresse forstås en betegnelse, som ved hjælp af vejnavn, husnummer og postnummer, angiver beliggenheden af en bestemt adgang til en bygning, et teknisk anlæg, samt til et bebygget eller ubebygget areal. Ved en enhedsadresse forstås en betegnelse, som supplerer adgangsadressen med en evt. etage- og en evt. dørbetegnelse (side- eller dørnummer) således at den angiver beliggenheden af en bestemt indgangsdør eller lignende, inden for den pågældende bygning. For enfamiliehuse, rækkehuse o.l. hvor den udvendige indgangsdør samtidig udgør indgangen til en enkelt bolig-, erhvervs- eller brugsenhed, er enhedsadressen sammenfaldende med adgangsadressen, hvorfor der ikke fastsættes etage- eller dørbetegnelse. En enhedsadresse er knyttet til en og kun én adgangsadresse. En adgangsadresse kan have 0 eller flere enhedsadresser. Adgangsadresse hedder på engelsk access address og i servicen AddressAccess. Enhedsadresse hedder på engelsk specific address og i servicen Address- Specific Gældende adresser Der skelnes mellem gældende adresser med status 1 og sagsadresser med status 3. Gældende adresser er godkendte adresser, sagsadresser er nye (ikke godkendte) adresser eller rettelser til gældende adresser under sagsbehandling. En adresse kan kun være en gældende adresse, hvis den ligger på en CPR vejkode og i et CPR vejdistrikt for postnummer. Hvis du vil rette, oprette eller slette en gældende adresse, kan dette gøres direkte via de respektive metode kald. Alternativt kan adresser rettes og opret- Snitfladebeskrivelse Side 9 af 89

10 tes via en adressesag, hvor ændringer først bliver gældende ved godkendelse af sagen. Dette er nærmere forklaret i næste afsnit Foreløbige adresser og sagsadresser Ved at rette en adresse gennem en adressesag sikres det, at en adresseforekomst kan oprettes foreløbigt og sagsbehandles (som udkast, sendes i høring, gives som indstilling, eller indberettes af en ekstern part mv.) forud for den egentlige fastsættelse eller godkendelse af adressen. Oprettes en ny adresse via en adressesag eller rettes en eksisterende adresse via en adressesag, skal der oprettes enten En ny foreløbig adresse eller En sagsadresse En ny foreløbig adresse er en helt ny adresse, som endnu ikke er godkendt. En ny foreløbig adresse har IKKE nogen relation til en gældende adresse. En sagsadresse er en ændring af en eksisterende, dvs. gældende adresse. En sagsadresse har en relation til en anden gældende adresse nemlig den adresse, som ændres. Nye foreløbige adresser og sagsadresser har status 3. En adgangsadresse og de underliggende enhedsadresser vil altid have samme status, som illustreret nedenfor. AAD (N) AAD EAD EAD (N) EAD (N) EAD 3.4. Adressesager En foreløbig adresse eller en sagsadresse er altid knyttet til en adressesag. En adressesag kan samle en eller flere foreløbige adresser/sagsadresser, som hører sammen. En adressesag identificeres ved et sagsnummer. På selve adressesagen ligger feltet godkendelsesdato. Når godkendelsesdatoen udfyldes, afsluttes de tilhørende adresser og overføres til stamdata. Der må ikke være to sagsadresser hørende til samme gældende adresse i den samme adressesag. Adressesag hedder på engelsk address case og i servicen AddressCase Adressers entydighed Vedrørende adressernes entydighed er der formuleret følgende regler i : Gældende adgangsadresser (status 1) skal være entydig på kommunekode, vejkode og husnummer. Gældende enhedsadresser skal være entydig på adgangsadressen, etage og side/dørnummer. Dvs. der må ikke være to gældende adgangsadresser med samme vejkode og husnummer eller to Snitfladebeskrivelse Side 10 af 89

11 gældende enhedsadresser med samme adgangsadresse, etage og side/dørnummer. Foreløbige nye adgangsadresser (status 3) med husnummer skal være entydig på kommunekode, vejkode og husnummer. Foreløbige nye adgangsadresser (status 3) uden husnummer behøver ikke at være entydig, dvs. der må eksistere flere foreløbige adgangsadresser med samme kommunekode og vejkode. Foreløbige nye enhedsadresser (status 3) skal være entydige på adgangsadressen, etage og side/dørnummer. Dette gælder også hvis den tilhørende adgangsadresse ikke har et husnummer. Der må godt være en gældende adresse (status 1) og en ny foreløbig adresse (status 3) som har samme kommunekode, husnummer og vejkode. Disse kan skelnes ved deres status. Der findes ingen begrænsninger for sagsadresser Adgangsadresser uden husnummer Alle adgangsadresser (gældende adresser, nye foreløbige adresser og sagsadresser) skal have en vejkode. Man kan undgå den nuværende regel om, at ikke gældende adresser skal have en vejkode, ved at tilknytte en dummyvejkode til nye foreløbige adresser eller sagsadresser. Med dummy-vejkode menes en vejkode, som ikke er en valid vejkode i CPR, f.eks Når en ny adgangsadresse optræder som sagsdata, skal der dog ikke nødvendigvis være registeret et husnummer. Herved sikre det, at en sags adgangsadresse kan oprettes, selv om der endnu ikke er fastsat et husnummer. Adresser uden husnummer må kun findes med status 3 (altså som helt nye foreløbige adresser eller sagsadresser). En adressesag, som indeholder adresser uden husnummer kan altså ikke godkendes før husnummeret er angivet. Der må gerne eksistere flere foreløbige nye adgangsadresser uden husnummer Adresseforekomstens liv En adresse bibeholder altid sin entydige adresse-id. Dette gælder også når en adgangsadresse ændrer vejkode eller husnummer og når en enhedsadresse ændrer etage og side/dørnummer. En enhedsadresse kan ikke flyttes til en anden adgangsadresse, men vil altid være tilknyttet den samme adgangsadresse i sin levetid. Ændringer af adressernes vejkode eller husnummer kan fx være nødvendige ved omnummerering af en række husnumre eller ved ændring af en adresses tilknytning til et vejnavn. Det afgørende er, om der er tale om den samme adgangsadresse, dvs. som refererer til den samme bygning, opgang, grundstykke e.l. Tilsvarende principper gælder for enhedsadresser mht. etage- og dørbetegnelse Adressepunkt Ved et adressepunkt forstås et punkt, der beskriver beliggenheden af en bestemt adgangsadresse ved hjælp af geografiske koordinater (X,Y). Snitfladebeskrivelse Side 11 af 89

12 En adgangsadresse kan have tilknyttet geometri, som angiver adgangsadressens beliggenhed på et digitalt kort. Geometrien består af et sæt koordinater samt nogle supplerende oplysninger. Den logiske datamodel i knytter et geometriobjekt et adressepunkt - til en adgangsadresse og vice versa. Hvert geometri-objekt er tilknyttet én adgangsadresse og en adgangsadresse har tilknyttet ingen eller ét geometriobjekt. Dette er en forskel i forhold til den i dokumentationsguiden for adressepunktet beskrevne relation, hvor en adgangsadresse kan have flere adressepunkter. Hvis en adgangsadresse ændrer sin beliggenhed, vil adgangsadressen bibeholde samme geometri/adressepunkt. Adressepunktet vil blive opdateret med de ændrede koordinater og/eller ændrede oplysninger om adressepunktets status eller metadata. Der kan oprettes et adressepunkt for gældende adgangsadresser og nye foreløbige adgangsadresser, dog ikke for sagsadresser. For at rette adressegeometrien for en gældende adgangsadresse skal man således opdatere stamadgangsadressen og ikke oprette en sagsadresse. Koordinater i har UTM Euref 89 format, zone 32 og bliver således leveret og skal leveres til opdatering i det nævnte format. Adgangsadressens geometri går også tit under navnet adressekoordinater, og når der i det følgende skrives adressekoordinater, så menes der helt nøjagtig geometrien (adressepunktet) knyttet til en adgangsadresse i. Adressepunkt hedder på engelsk address point og i servicen AddressPoint Adressers tilknytning til matrikler Adgangsadresser kan være knyttet til 0 eller et matrikelnummer. For adgangsadressen skal det angives hvilket jordstykke adressen faktisk er beliggende på. Dette sker ved hjælp af ejerlav og matrikelnummer fra KMS' matrikel og tilhørende matrikelkort; for Københavns og Frederiksberg dog fra den kommunale matrikel. Disse matrikelbetegnelser svarer til en ESR matrikeloplysning og ejendomsnummer med artskode 00 eller 01. Der findes dog også tilfælde, hvor du ikke kan registrere en adresse på et KMS matrikelnummer. Som eksempel kan nævnes de tilfælde, hvor adressen er placeret på et umatrikuleret areal. I dette tilfælde kan der i stedet tilknyttes en ESR- Snitfladebeskrivelse Side 12 af 89

13 matrikeloplysning om det umatrikulerede areal ved hjælp af artskoderne 5, 6, 7, 8, 9 eller 10. Et andet eksempel er brug af foreløbige ESR-matrikeloplysninger i forbindelse med udstykninger. Her kan registreringen af det gældende matrikelnummer (som der udstykkes fra) suppleres af en oplysning om det foreløbige ESR deleller parcelnummer og det nye ejendomsnummer med artskode 30 til 40." Når en adresse knyttes til et niveau i Bygninger og boliger behøver der ikke være overensstemmelse mellem det matrikelnummer som adressen har tilknyttet og det matrikelnummer som niveauet ligger på. Sagt på en anden måde: En adresse kan ligge på et andet matrikelnummer end den grund/bygning/teknisk anlæg, som du knytter adressen til. Dette vil fx være tilfælde ved bygninger på lejet grund. Der findes en undtagelse til ovenstående regel: Når en adgangsadresse er tilknyttet til en opgang skal der gælde følgende regel: Adgangsadressens matrikel skal være lig med den matrikel, som opgangens bygning ligger på eller adgangsadressens matrikel skal være lig med modermatriklen til den matrikel, som opgangens bygning ligger på. Hvis man knytter en adresse til en opgang og denne regel ikke er opfyldt, vil systemet automatisk flytte adgangsadressen til den rigtige matrikel. Hvis opgangens bygning ligger på en matrikel med artskode forskellig med 00 eller 01, prøver system i første omgang at flytte adressen til modermatriklen. Hvis denne ikke findes, flyttes adressen til bygningens matrikel. Systemet vil give besked om denne automatiske flytning. For brugsenheder gælder det, at de skal have enhedsadresser, som ligger under adgangsadresser, som ligger på en matrikel, som hører til samme ejendom som brugsenheden. Hvis en adgangsadresse er tilknyttet til flere opgange med forskellige matrikler, kan du i Adresser vælge hvilken af disse forskellige matrikler du ønsker at knytte adgangsadressen til. På en adgangsadresse kan du se ejendomsnummeret for den grund, som adressens matrikelnummer indgår i. For nogle ESR matrikeloplysninger er ejendomsnummer med til at identificere ESR matrikeloplysningen entydigt Status for adresser En gældende adresse har status 1. En foreløbig adresse og en sagsadresse har status 3. Nedlæggelse af gældende adresse En gældende adresse kan nedlægges på tre forskellige måder. Det er muligt at benytte Delete metoden for en gældende adresse. Det er muligt at benytte Update metoden for en gældende adresse og angive nedlæggelsesdatoen. Når en sagsadresse godkendes og sagsadressen har en nedlæggelsesdato angivet, nedlægges den gældende adresse. I først nævnte tilfælde udfyldes nedlæggelsesdatoen af systemet, i de to andre tilfælde benyttes det angivne nedlæggelsesdato. Snitfladebeskrivelse Side 13 af 89

14 Når en gældende adresse bliver slettes (nedlagt), får den status 2. Godkendelse af adressesag Man godkender en adressesag ved at benytte Update metoden og udfylde godkendelsesdatoen. De underliggende sager vil så blive overført fra at være sager til at være gældende. Når en foreløbig adresse bliver godkendt via en adressesag får den status 1, idet den nu er gældende. Ikrafttrædelsesdato udfyldes med adressesagens godkendelsesdato. Når en sagsadresse bliver godkendt overføres data til den gældende adresse. Henlæggelse af adressesag Man nedlægger en adressesag ved at benytte Delete metoden for adressesagen. Når en adressesag henlægges, henlægges også de underliggende sager. Snitfladebeskrivelse Side 14 af 89

15 4. webservice Metoderne i servicen (WSDL en) kan inddeles i 5 grupper: o o o o o metoder til adgangsadresser metoder til enhedsadresser metoder til adressesager metoder til adgangsadressernes geometri metoder til fremsøgning af adgangsadresser, enhedsadresser og adressesager Servicen indeholder følgende 5 metoder til at hente, opdatere, oprette og slette adgangsadresser: AddressAccessGetById AddressAccessGet AddressAccessCreate AddressAccessUpdate AddressAccessDelete Servicen indeholder følgende 5 metoder til at hente, opdatere, oprette og slette enhedsadresser: AddressSpecificGetById AddressSpecificGet AddressSpecificCreate AddressSpecificUpdate AddressSpecificDelete Servicen indeholder følgende 5 metoder til at hente, opdatere, oprette og slette adressesager: AddressCaseGetById AddressCaseGet AddressCaseCreate AddressCaseUpdate AddressCaseDelete Servicen indeholder følgende 3 metoder til at opdatere, oprette og slette adressepunkter: AddressPointCreate AddressPointUpdate AddressPointDelete Servicen indeholder følgende 2 metoder til at fremsøge adresser og adressesager: AddressSearch AddressCaseSearch Alle metoder har en inputstruktur, som hedder <metodenavn>requeststructure og en outputstruktur, som hedder <metodenavn>responsestructure. Fx hedder strukturerne til AddressAccessGetById AddressAccessGetByIdRequestStructure og AddressAccess- GetByIdResponseStructure. Snitfladebeskrivelse Side 15 af 89

16 Webservicens mange metoder er beskrevet i detaljer i de næste kapitler. Hver struktur er vist på et billede, som på en god måde anskueliggør hvilke felter der er obligatoriske, dvs. skal udfyldes, når metoderne bliver kaldt. Derudover kan man se for mange forekomster af de forskellige strukturer der er mulige IgnoreWarningIndicator De fleste opdateringer i systemet (opdater, opret og slet metoder) har en indikator, som angiver, om man ønsker at ignorere advarsler. Med advarsler menes der i systemet implementerede sandsynlighedskontroller. Hvis indikatoren er true, ignoreres advarsler og opdateringen udføres hvis der ikke er fejl. Hvis indikatoren er false, udføres opdateringen kun hvis der ikke findes advarsler. Man vil typisk først kalde metoden med indikatoren sæt til false. De leverede advarsler tjekkes og hvis man ønsker at opdatere på trods af disse advarsler kaldes metoden med indikatoren sæt til true. Advarslerne leveres tilbage i samme struktur som fejl og andre returbeskeder. Læs mere om dette i afsnit printenableindicator Man kan benytte en indikator for at angive, om der skal udskrives en Meddelelse i forbindelse med den adresse rettelse man foretager. Hvis man sætter indikatoren til at være true, resulterer nedenstående ændringer af adresser i en bestilling af en automatisk - Meddelelse med årsagskode 60 ( Denne -Meddelelse er udskrevet på grund af adresseændringer. ) for relevante niveauer i Bygninger og boliger. Relevante niveauer er ejendomme/ejerlejligheder, som har den pågældende adresse tilknyttet. Vejkode eller husnummer for en gældende adgangsadresse AAD eller en ny foreløbig adgangsadresse (N)AAD ænders. Herved ændres også de enhedsadresser, som ligger under den ændrede adgangsadresse, idet adgangsadressen er en del af enhedsadressens identifikation Etage eller sidedør nummer ændres for en gældende enhedsadresse EAD eller en ny foreløbig enhedsadresse (N)EAD. Der bestilles ingen -Meddelelser ved ændringer af sagsniveauerne (S)AAD og (S)EAD, som er ændringer til gældende adresser. Dette sker først når sagen godkendes og de tilhørende gældende adresser bliver opdateret. Der udskrives ikke -Meddelelser når en (N)AAD eller en (N)EAD bliver til gældende adresser idet adresserne ved denne handling ikke ændrer deres identifikation. Indikatoren findes kun i de metoder hvor den giver mening. I Delete og Create metoderne giver indikatoren ikke mening, idet man kun kan slette adresser, som ikke har entiteter tilknyttet og fordi en ny oprettet adresse endnu ikke har entiteter tilknyttet Opdateringsmekanisme Det gælder generelt, at der kun opdateres de felter i Update metoderne, som sendes med. Et felt som ikke sendes med, berøres således ikke af opdateringen. Denne mekanisme betyder, at man ikke kan slette et felt Snitfladebeskrivelse Side 16 af 89

17 ved ikke at sende det med. Der er blevet defineret null værdier, som skal indikere, at man vil slette et felt. Disse felter er beskrevet under de enkelte Update funktioner RecordChangeDateTime Feltet RecordChangeTime er et felt som benyttes til at styre opdateringer. Når man henter en entitet, får man en RecordChangeDateTime med retur. Når man foretager en opdatering, skal denne sendes med tilbage. Servicen benytter dette felt til at kontrollere, om andre har opdateret entiteten i forvejen Foreløbige koordinater I forbindelse med opdatering og oprettelse af adresser hentes foreløbige koordinater via KMS i følgende situationer: Ved oprettelse af en gældende adgangsadresse (status 1) eller en ny foreløbig adgangsadresse (status 3) Ved opdatering af en eksisterende gældende adgangsadresse (enten ved direkte opdatering eller ved afslutning af en adressesag) Ved opdatering af en ny foreløbig adgangsadresse Det er kun muligt at hente foreløbige koordinater når adressen har tilknyttet et KMS matrikelnummer (se afsnit 3.8). Derudover hentes der kun koordinater når nøjagtighedsklassen er U (uden koordinater) eller når adgangsadressens koordinater har en kilde til geometri lig med 2 og nøjagtighedsklasse ikke er lig med A, dvs. koordinaterne ikke er blevet opdateret igennem OIOXML snitfladen af en bedre kilde end fra KMS. Når en gældende eller en ny foreløbig adgangsadresse har en geometri, som er bedre en KMS (dvs. forskelligt fra kilde 2), bliver der kontrolleret, om koordinaterne ligger på samme matrikel som adgangsadressens (hvis denne har tilknyttet en matrikel). Denne kontrol gennemføres i følgende situationer: Ved opdatering af en eksisterende gældende adgangsadresse enten ved direkte opdatering i stam-data eller ved afslutning af en adressesag (S)AAD. Ved opdatering af en ny foreløbig adgangsadresse (N)AAD Hvis dette ikke er tilfælde returneres sandsynlighedsbeskeden Matriklen er ikke i overensstemmelse med adgangsadressepunktets matrikel fra KMS (<KMS matrikel>). Ligesom ovenfor gennemføres denne kontrol kun hvis adgangsadressen er knyttet til et KMS matrikelnummer. For København og Frederiksberg gennemføres disse kald til KMS ikke Skemavalidering Der foretages skemavalidering af de indsendte data. Hvis requested ikke overholder skemaerne returneres en SOAP fejl med en beskrivelse af problemet. Et eksempel for sådan en fejlbesked kunne være: <?xml version="1.0" encoding="utf-16"?> <s:envelope xmlns:s=" <s:body> Snitfladebeskrivelse Side 17 af 89

18 <s:fault> <faultcode xmlns:a="urn:oio:bbr:1.0.0">a:schemavalidationfault</faultcode> <faultstring xml:lang="en-us">the ' element is invalid - The value '461' is invalid according to its datatype ' - The Pattern constraint failed.</faultstring> </s:fault> </s:body> </s:envelope> Her har man sendt en 3-cifret kommunekode 461 i stedet for den 4-cifrede Namespaces Der benyttes felter og strukturer fra andre namespaces i forbindelse med denne OIOXML snitflade. Nedenstående oversigt viser hvilke forkortelser der på tegningerne bliver brugt for hvilke namespaces. bbr bbr1 bbr3 kmd cpr dkcc1 esr bbr1 xkom svur dkcc2 urn:oio:bbr: Datatyper Webservicen benytter de datatyper, som er defineret på digitaliser.dk. Det er xsd filerne, som beskriver hvilket format de enkelte typer skal overholde Udviklingsværktøjer Mange udviklingsværktøjer kan generere et interface/proxy til webservicen. I.NET skal man i denne sammenhæng f.eks. være opmærksom på følgende: Optionelle felter resulterer i to felter i koden:et felt hvor man angiver en værdi og et felt (feltnavn efterfulgt af Specified ), som angiver om feltet er angivet eller ej. Specified feltet skal sættes til true hvis værdien angives. Sættes Specified feltet til false, ignoreres en evnetuel værdi som angives. En Integer bliver til typen string. Det betyder, at felterne skal angives med omkring værdien Rettigheder Der kan være to årsag til, at et felt ikke er udfyldt når det leveres som del af et svar: Du har ikke rettigheder til at læse feltet. Feltet er ikke udfyldt i databasen. Du kan benytte den i kapitel 1 nævnte webservice Permission til at hente oplysninger om de rettigheder du har. Snitfladebeskrivelse Side 18 af 89

19 5. Metoder til adgangsadresser De 5 metoder til at hente, opdatere, oprette og slette adgangsadresser er følgende: AddressAccessGetById AddressAccessGet AddressAccessCreate AddressAccessUpdate AddressAccessDelete Metoderne er beskrevet i de 5 næste afsnit. Vær opmærksom på, at adressepunktet leveres sammen med adgangsadressen når systemet leverer adgangsadressen som en del af et svar. Ønsker man dog at oprette, opdatere eller slette et adressepunkt, skal metoderne for adressepunkt entiteten benyttes (se kapitel 8) AddressAccessGetById Metoden AddressAccessGetById henter en adgangsadresse ved angivelse af adressens id. De i afsnit og viste tegninger viser metodens input og output struktur. Metoden har en adgangsadresse id og et kommunekode som input og får leveret den ønskede adgangsadresse samt et resultat for metode kaldet tilbage. Strukturen angiver også, at begge input felter er obligatoriske, dvs. skal udfyldes, når operationen AddressAccessGetById kaldes. Adgangsadressen leveres i en struktur kaldt AddressAccessResponseStructure, som beskriver en adgangsadresse i det tilfælde den bliver leveret som en del af et svar. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Resultatet for metode kaldet leveres i en struktur kaldt ReturnMessage, som også genbruges i de andre strukturer. Derfor er den beskrevet som en fælles struktur i kapitel AddressAccessGetByIdRequestStructure AddressAccessGetByIdRequestStructure Feltnavn i OIOXML navn Kommentar Snitfladebeskrivelse Side 19 af 89

20 AddressAccessGetByIdRequestStructure Feltnavn i OIOXML navn Kommentar AdgangsadresseID AddressAccessIdentifier Feltet skal udfyldes med adgangsadressens id. Kommunekode MunicipalityCode Feltet skal udfyldes med kommunekode AddressAccessGetByIdResponseStructure AddressAccessGetByIdResponseStructure Feltnavn i OIOXML navn Kommentar AddressAccessResponseStructure Den hentede adgangsadressen, se afsnit ReturnMessage Resultatet for metode kaldet, se afsnit AddressAccessGet Metoden AddressAccessGet henter en adgangsadresse ved angivelse af en brugervendt nøgle. De i afsnit og viste tegninger viser metodens input og output struktur. Snitfladebeskrivelse Side 20 af 89

21 Metoden har en brugervendt nøgle til en adgangsadresse som input og får leveret den eller de ønskede adgangsadresser samt et resultat for metode kaldet tilbage. Hvis husnummeret ikke sendes med, ledes efter en adresse uden husnummer. Metoden kan returnere en eller flere adgangsadresser. Dette skyldes at der kan findes flere adgangsadresser med den samme brugervendte nøgle. Som beskrevet i kapitel 2, kan en ny foreløbig adgangsadresse og en gældende adgangsadresse have den samme brugervendt nøgle, dvs. den samme kombination af kommunekode, vejkode og husnummer. De adskiller sig kun på deres status. Derudover kan flere sagsadresser med status 3 have de samme brugervendte nøgler og flere foreløbige adgangsadresser uden husnummer kan have samme kommunekode og vejkode. Hver adgangsadresse leveres i en struktur kaldt AddressAccessResponseStructure, som beskriver en adgangsadresse i det tilfælde den bliver leveret som en del af et svar. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Resultatet for metode kaldet leveres i en struktur kaldt ReturnMessage, som også genbruges i de andre strukturer. Derfor er den beskrevet som en fælles struktur i kapitel 10. Hvis der ikke findes en adresse med de angivne parametre returneres returnidentifier 0 og reasonidentifier AddressAccessGetRequestStructure AddressAccessGetRequestStructure Snitfladebeskrivelse Side 21 af 89

22 Feltnavn i OIOXML navn Kommentar Kommunekode MunicipalityCode Feltet skal udfyldes med kommunekode. Vejkode StreetCode Feltet skal udfyldes med adressens vejkode, hvis adressen har en vejkode. I nuværende version af har alle adresser, også dem med sagskode 3 en vejkode AddressAccessGetResponseStructure AddressAccessGetResponseStructure Feltnavn i OIOXML navn Kommentar Husnummer og husbogstav StreetBuidlingIdentifier Feltet skal udfyldes med husnummer/husbogstav, hvis adressen har et husnummer/husbogstav. Der findes adresser med sagstype 3, som ikke har et husnummer/husbogstav. AddressAccessResponseStructure En eller flere adgangsadresser, som har den ønskede brugervendte nøgle, se afsnit ReturnMessage Resultatet for metode kaldet, se afsnit Snitfladebeskrivelse Side 22 af 89

23 5.3. AddressAccessCreate Metoden AddressAccessCreate opretter en adgangsadresse ved angivelse af adgangsadressens attributter. De i afsnit og viste tegninger viser metodens input og output struktur. Adgangsadresse sendes som input til metoden i en struktur kaldt AddressAccessRequestStructure, som beskriver en adgangsadresse i det tilfælde den er et input til en metode. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Som en anden input parameter findes der en indikator, som angiver om advarsler skal ignoreres ved oprettelse af adressen eller om oprettelsen skal afvises i det tilfælde der gives advarsler. Som resultat for metoden returneres den oprettede adgangsadresse (hvis det lykkedes) i en struktur kaldt "AddressAccessResponseStructure. "AddressAccessResponseStructure beskriver en adgangsadresse i det tilfælde den bliver leveret som en del af et svar. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Resultatet for metode kaldet leveres i en struktur kaldt ReturnMessage, som også genbruges i de andre strukturer. Derfor er den beskrevet som en fælles struktur i kapitel 10. For at kunne oprette en adgangsadresse skal der som minimum angives følgende felter: Status (1 for gældende og 3 for sagsadresser og nye foreløbige adresser) Kommunenummer Vejkode Husnummer (kan være null for sagsadresser) Kilde til adresse (for gældende adresser med status 1) Adressesag id (hvis status 3) Adgangsadresse id (hvis sagsadresse) AddressAccessCreateRequestStructure AddressAccessCreateRequestStructure Snitfladebeskrivelse Side 23 af 89

24 Feltnavn i OIOXML navn Kommentar AddressAccessRequestStructure Adgangsadressen, som man ønsker at oprette, se afsnit Status (objekttype) for adgangsadressen statuscode Statuskoden er 1 for gældende adresser og 3 for nye foreløbige adresser og sagsadresser. Se også afsnit 3.9. IgnoreWarningIndicator Information om advarsler skal eller ikke skal ignoreres. Når indikatoren er true, bliver advarsler ignoreret AddressAccessCreateResponseStructure AddressAccessCreateResponseStructure Feltnavn i OIOXML navn Kommentar AddressAccessResponseStructure Den oprettede adgangsadresse, se afsnit ReturnMessage Resultatet for metode kaldet, se afsnit AddressAccessUpdate Metoden AddressAccessUpdate opdaterer en adgangsadresse ved angivelse af adgangsadressens attributter. Snitfladebeskrivelse Side 24 af 89

25 De i afsnit og viste tegninger viser metodens input og output struktur. For at opdatere en adgangsadresse, skal der sendes adgangsadressens id for at identificere den adgangsadresse man ønsker at opdatere. Adgangsadresse sendes som input til metoden i en struktur kaldt AddressAccessRequestStructure, som beskriver en adgangsadresse i det tilfælde den er et input til en metode. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Ud over selve adgangsadressen findes to andre input parameter. Der findes en indikator, som angiver om advarsler skal ignoreres ved opdatering af adressen eller om opdateringen skal afvises i det tilfælde der gives advarsler. Derudover findes der en indikator for, om man ønsker at opdateringen resulterer i udskrivning af Meddelelser for de berørte ejendomme. Som resultat for metoden returneres den opdaterede adgangsadresse i en struktur kaldt "AddressAccessResponseStructure. "AddressAccessResponseStructure beskriver en adgangsadresse i det tilfælde den bliver leveret som en del af et svar. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Resultatet for metode kaldet leveres i en struktur kaldt ReturnMessage, som også genbruges i de andre strukturer. Derfor er den beskrevet som en fælles struktur i kapitel 10. For at kunne opdatere en adgangsadresse skal der som minimum angives følgende felter: Adgangsadresse id Kommunenummer RecordChangeDateTime Alle andre felter angives kun hvis man ønsker at rette dem AddressAccessUpdateRequestStructure AddressAccessUpdateRequestStructure Snitfladebeskrivelse Side 25 af 89

26 Feltnavn i OIOXML navn Kommentar AdgangsadresseID AddressAccessIdentifier Feltet skal altid udfyldes med adgangsadressens id. AddressAccessRequestStructure Adgangsadressen, som man ønsker at opdatere, se afsnit RecordChangeDateTime Se afsnit 4.4. printenableindicator IgnoreWarningIndicator Feltet angiver om der skal udskrives en Meddelelse for relevante ejendomme og sendes til de respektive ejere. Når indikatoren er true, bliver der udskrevet Meddelelser. Information om advarsler skal eller ikke skal ignoreres. Når indikatoren er true, bliver advarsler ignoreret. For at kunne slette/nulstille et felt for adgangsadressen, skal der benyttes følgende værdier (kun angivet for relevante felter): Null-værdier for adgangsadressen Feltnavn i OIOXML navn Null-værdi Husnummer og husbogstav StreetBuidlingIdentifier Det er muligt at oprette en adgangsadresse uden husnummer (dvs. husnummer 0) ved ikke at angive husnummeret ved oprettelse. Det er dog ikke muligt at slette et husnummer for en adgangsadresse når det en gang er angivet. Årsagen er, at kernekomponenten for husnummeret ikke tillader værdien 0. Undlader man at sende husnummeret med opfattes dette som om man ikke vil opdatere husnummeret. Kilde til adgangsadresse AddressAccessSourceCode Kilde til adgangsadressen er et krævet felt og kan derfor ikke nulstilles/slettes. landparcelidentitystructure landparcelidentitystructure.matrlandparcelidentifi cationstructure.landparcelidentifier skal være blank og landparcelidentitystructure.matrlandparcelidentifi Snitfladebeskrivelse Side 26 af 89

27 Null-værdier for adgangsadressen Feltnavn i OIOXML navn Null-værdi cationstructure.cadastraldistrictidentifi er skal være 0. AddressAccessRequestDates MunicipalityFields Null værdien for en dato er DateTime.MinValue, dvs :00: To be defined Journalnummer FileNumberIdentifier Journalnummer kan slettes/nulstilles ved at sende en tom string. ESDH reference ESDHreferenceIdentifier ESDH refernce kan slettes/nulstilles ved at sende en tom string på 200 tegn (OIO definitionen på digitaliser prøves rettet) AddressAccessUpdateResponseStructure AddressAccessUpdateResponseStructure Feltnavn i OIOXML navn Kommentar AddressAccessResponseStructure Den opdaterede adgangsadresse, se afsnit ReturnMessage Resultatet for metode kaldet, se afsnit Snitfladebeskrivelse Side 27 af 89

28 5.5. AddressAccessDelete Metoden AddressAccessDelete sletter en adgangsadresse. De i afsnit og viste tegninger viser metodens input og output struktur. Adgangsadressen slettes ved angivelse af adgangsadressens id og det kommunekode, som adgangsadressen hører til. Ud over adressens id findes en indikator, som angiver om advarsler skal ignoreres eller om sletningen skal afvises i det tilfælde der gives advarsler. Når adgangsadressen slettes, slettes også de underliggende enhedsadresser. Du skal være opmærksom på, at adgangsadresser, som er knyttet til et niveauer i Bygninger og boliger ikke kan slettes. Dette gælder også, hvis de underliggende enhedsadresser er knyttet til niveauer i Bygninger og boliger. Resultatet for metode kaldet leveres i en struktur kaldt ReturnMessage, som også genbruges i de andre strukturer. Derfor er den beskrevet som en fælles struktur i kapitel AddressAccessDeleteRequestStructure AddressAccessDeleteRequestStructure Feltnavn i OIOXML navn Kommentar AdgangsadresseID AddressAccessIdentifier Feltet skal altid udfyldes med adgangsadressens id. Kommunekode MunicipalityCode Feltet skal altid udfyldes med 4 cifret kommunekode, f.eks RecordChangeDateTime Se afsnit 4.4. IgnoreWarningIndicator Information om advarsler skal eller ikke skal ignoreres. Når indikatoren er true, bliver advarsler ignoreret. Snitfladebeskrivelse Side 28 af 89

29 AddressAccessDeleteResponseStructure AddressAccessDeleteResponseStructure Feltnavn i OIOXML navn Kommentar ReturnMessage Resultatet for metode kaldet, se afsnit Snitfladebeskrivelse Side 29 af 89

30 6. Metoder til enhedsadresser De 5 metoder til at hente, opdatere, oprette og slette enhedsadresser er følgende: AddressSpecificGetById AddressSpecificGet AddressSpecificCreate AddressSpecificUpdate AddressSpecificDelete Metoderne er beskrevet i de 5 næste afsnit AddressSpecificGetById Metoden AddressSpecificGetById henter en enhedsadresse ved angivelse af adressens id. De i afsnit og viste tegninger viser metodens input og output struktur. Metoden har en enhedsadresse id og et kommunekode som input og får leveret den ønskede enhedsadresse samt et resultat for metode kaldet tilbage. Enhedsadressen leveres i en struktur kaldt AddressSpecificResponseStructure, som beskriver en enhedsadresse i det tilfælde den bliver leveret som en del af et svar. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Resultatet for metode kaldet leveres i en struktur kaldt ReturnMessage, som også genbruges i de andre strukturer. Derfor er den beskrevet som en fælles struktur i kapitel AddressSpecificGetByIdRequestStructure AddressSpecificGetByIdRequestStructure Feltnavn i OIOXML navn Kommentar EnhedsadresseID AddressSpecificIdentifier Feltet skal udfyldes med enhedsadressens id. Kommunekode MunicipalityCode Feltet skal udfyldes med 4 cifret kommunekode, f.eks Snitfladebeskrivelse Side 30 af 89

31 AddressSpecificGetByIdResponseStructure AddressSpecificGetByIdResponseStructure Feltnavn i OIOXML navn Kommentar AddressSpecificResponseStructure Den hentede enhedsadresse, se afsnit ReturnMessage Resultatet for metode kaldet, se afsnit AddressSpecificGet Metoden AddressSpecificGet henter en enhedsadresse ved angivelse af en brugervendt nøgle. De i afsnit og viste tegninger viser metodens input og output struktur. Metoden har en brugervendt nøgle til en enhedsadresse som input og får leveret den eller de ønskede enhedsadresser samt et resultat for metode kaldet tilbage. Metoden kan returnere en eller flere enhedsadresser. Dette skyldes at der kan findes flere enhedsadresser med den samme brugervendte nøgle. Som beskrevet i kapitel 5.2, kan 2 adgangsadresser have samme kombination af kommunekode, vejkode og husnummer. Idet adgangsadressen er en del af enhedsadressens identifikation, betyder det også, at de enhedsadresser, som ligger under to adgangsadresser med samme kombination af kommunekode, vejkode og husnummer også kan have den samme etage og side/dørnummer. Enhedsadresser under en og den samme adgangsadresse er dog altid entydig på deres etage og side/dørnummer. Hver enhedsadresse leveres i en struktur kaldt AddressSpecificResponseStructure, som beskriver en enhedsadresse i det tilfælde den bliver leveret som en del af et svar. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Snitfladebeskrivelse Side 31 af 89

32 Resultatet for metode kaldet leveres i en struktur kaldt ReturnMessage, som også genbruges i de andre strukturer. Derfor er den beskrevet som en fælles struktur i kapitel 10. Hvis der ikke findes en adresse med de angivne parametre returneres returnidentifier 0 og reasonidentifier AddressSpecificGetRequestStructure AddressSpecificGetRequestStructure Feltnavn i OIOXML navn Kommentar Kommunekode MunicipalityCode Feltet skal udfyldes med 4 cifret kommunekode, f.eks Vejkode StreetCode Feltet skal udfyldes med vejkoden for den tilhørende adgangsadresse. Husnummer og husbogstav StreetBuidlingIdentifier Feltet skal udfyldes med husnummer/husbogstav for adgangsadressen, hvis Snitfladebeskrivelse Side 32 af 89

33 AddressSpecificGetRequestStructure Feltnavn i OIOXML navn Kommentar Etage FloorIdentifier Feltet skal udfyldes med enhedsadressens etage, hvis adressen har en etagebetegnelse. Side/dørnummer SuiteIdentifier Feltet skal udfyldes med enhedsadressens side/dør nummer, hvis adressen har et side/dørnummer AddressSpecificGetResponseStructure AddressSpecificGetResponseStructure Feltnavn i OIOXML navn Kommentar adressen har et husnummer/husbogstav. AddressSpecificResponseStructure En eller flere enhedsadresser, som har den ønskede brugervendte nøgle, se afsnit ReturnMessage Resultatet for metode kaldet, se afsnit AddressSpecificCreate Metoden AddressSpecificCreate opretter en enhedsadresse ved angivelse af enhedsadressens attributter. De i afsnit og viste tegninger viser metodens input og output struktur. Enhedsadressen sendes som input til metoden i en struktur kaldt Address- SpecificRequestStructure, som beskriver en enhedsadresse i det tilfælde den Snitfladebeskrivelse Side 33 af 89

34 er et input til en metode. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Som en anden input parameter findes der en indikator, som angiver om advarsler skal ignoreres ved oprettelse af adressen eller om oprettelsen skal afvises i det tilfælde der gives advarsler. Som resultat for metoden returneres den oprettede enhedsadresse (hvis det lykkedes) i en struktur kaldt "AddressSpecificResponseStructure. "Address- SpecificResponseStrcuture beskriver en enhedsadresse i det tilfælde den bliver leveret som en del af et svar. Denne struktur genbruges i nogle af de andre metoder og er derfor beskrevet som en fælles struktur i kapitel 10. Resultatet for metode kaldet leveres i en struktur kaldt ReturnMessage, som også genbruges i de andre strukturer. Derfor er den beskrevet som en fælles struktur i kapitel 10. For at kunne oprette en enhedsadresse skal der som minimum angives følgende felter: Status (1 for gældende og 3 for sagsadresser og nye foreløbige adresser) Kommunenummer Adgangsadresse id Adressesag id (hvis status 3) Enhedsadresse id (hvis sagsadresse) Kilde til adresse (for gældende adresser med status 1) AddressSpecificCreateRequestStructure Snitfladebeskrivelse Side 34 af 89