BBR OIOXML. Vejledning til OIOXML snitflade for Bygninger og boliger BuildingDwelling.wsdl

Transkript

1 OIOXML Vejledning til OIOXML snitflade for Bygninger og boliger BuildingDwelling.wsdl En vejledning rettet mod 3. part.

2 Ændringer i forhold til forrige versioner Version Første version, 01. maj 2010 Version Version juni 2010 Version Mange to be written steder er blevet skrevet. Implementering og beskrivelse af teknisk anlæg afventer (på grund af DIADEM felter) Nogle steder er markeret med to be written. Disse afsnit skrives snarest. Andre steder er markeret med gul farve. Disse skrives når implementringen af snitfladerne er afsluttet idet disse steder kræver afklaring. metoderne er blevet beskrevet nærmere oprettelse og sletning af geometripunkter er beskrevet teknisk anlæg er blevet opdateret 29. juni produktionsversion (svarende til BuildingDwellingServiceV1.svc) Tegning vedr. repræsentative adresser tilknyttet Ændring af navn til BuildingDwelling.wsdl Alle strukturer og metoder er beskrevet færdigt Webservice version 2, BuildingDwellingServiceV2.svc 15. december 2010 ( Kommune version 1.2. lægges i produktion) Søgningen er begrænst til 100 resultater (tilføjet til vejledningen) Beskrivelse af hvordan man sletter et ejerskab tilføjet Opdatering af links i kapitel 1 Ny kapitel 4.13 Datatyper Ny kapitel 4.14 Udviklingsværktøjer Afsnit 16.2 (Kodeeksempel for kald af certifikat) tilføjet Opdatering af strukturer på grund af nye felter i Nyt version 1.2 eller andre ændringer/fejlrettelser o Pålæg fra stormområdet ny kodeliste o Gyldighedsdato på 7 entiteter (flyttet fra update/create metoder til selve entitetsstrukturerne) o Afløbsforhold nye kodeværdier og nye kodeoversættelser Snitfladebeskrivelse Side 2 af 273

3 o Nyt felt Omfattet af byggeskadeforsikring o Forsikringsselskab ny kodeliste (kode 3 slettet, kode 8 tilføjet) o En byggesag o Et teknisk anlæg kan oprettes på en grund uden vandforsyning og afløbsforhold. o Beskrivelsen vedr. midlertidig afslutning er udvidet med beskrivelse for afslutning af byggesager med teknisk anlæg o Felt FloorDeviationStatusIndicator hedder nu FloorDeviationStatusCode på grund af fejl i version 1. o Felt DrainagePermissionCode er blevet opdateret på grund af fejl i version 1. o Felt PublicSubsidyCode er blevet opdateret på grund af fejl i version 1. o Felt WaterSupplyCode er blevet opdateret på grund af fejl i version 1 (kode 7 manglede). Kode 1 har fået ny kodeoversættelse. o Felt LegalUseCode er blevet opdateret på grund af fejl i version 1 (kode I manglede og kode blank er blevet fjernet) o Felt TechnicalInstallationContentCode: Tekst oliebekendtgørelsens 6, stk. 1 nr. 11 rettet til oliebekendtgørelsens 6, stk. 1 nr. 13 Snitfladebeskrivelse Side 3 af 273

4 Indholdsfortegnelse 1. Introduktion Formål og målgrupper Forretningsviden De forskellige entiteter i og deres sammenhæng Adressers tilknytning til niveauer i Bygninger og boliger Stamentiteter Sagsentiteter Byggesager Mulige byggesagskoder Afslutning af en byggesag Overførsel af data fra sag til stam Midlertidig afslutning af en byggesag Delvis afslutning af en byggesag Indflytning Henlæggelse Sletning af sagsentitet i en byggesag Sletning af byggesag Koordinater til bygning og teknisk anlæg Foreløbige koordinater Kontrol af koordinater Overblik over webservices og metoderne Sandsynlighedskontroller (IgnoreWarningIndicator) Udskrivning af Meddelelser (printenableindicator) Gyldighedsdato (AssessmentChangedDate) Den implementerede opdateringsmekanisme Rettigheder Styring af opdateringer (RecordChangeDateTime) Sagstype (BuildingCaseFileTypeCode og updatereasoncode) Resultat for metodekald (ReturnMessage) Skemavalidering UniversalIdentifier og Reference Placeholder-problematik <Entity>GetById og <Entity>GetByIds metoder <Entity>GetByParentId metoder <Entity1>GetBy<Entity2>Id metoder BuildingCaseGetByEntityId metode Delete og update metoder Namespaces Datatyper Udviklingsværktøjer Rettigheder Strukturer til entiteter - <Entity>Structure SiteStructure Mulighed for identændringer SiteKeys SiteInformation AddressComplete WaterDrainage EntityBuildingCaseInformation Snitfladebeskrivelse Side 4 af 273

5 ExternalReferences MunicipalityFields NoteStructure BuildingStructure Mulighed for identændringer BuildingKeys BuildingInformation AddressComplete CondominiumStructure ConstructionPoint BuildingHeating BuildingArea BuildingArrangement BuildingMaterial WaterDrainage EntityBuildingCaseInformation BuildingInsurance ExternalReferences MunicipalityFields NoteStructure EntranceStructure Mulighed for identændringer EntranceKeys EntranceInformation AddressComplete EntityBuildingCaseInformation ExternalReferences MunicipalityFields NoteStructure FloorStructure Mulighed for identændringer FloorKeys FloorInformation FloorArea EntityBuildingCaseInformation ExternalReferences MunicipalityFields NoteStructure BuildingUnitStructure Mulighed for identændringer BuildingUnitKeys BuildingUnitInformation AddressComplete EntityBuildingCaseInformation CondominiumStructure BuildingUnitHeating BuildingUnitArea BuildingUnitInterior ExternalReferences MunicipalityFields NoteStructure TechnicalInstallationStructure Mulighed for identændringer TechnicalInstallationKeys TechnicalInstallationInformation Snitfladebeskrivelse Side 5 af 273

6 AddressComplete ConstructionPoint EntityBuildingCaseInformation CondominiumStructure ExternalReferences MunicipalityFields NoteStructure RoomStructure Mulighed for identændringer RoomKeys RoomInformation AddressComplete EntityBuildingCaseInformation ExternalReferences MunicipalityFields NoteStructure UseUnitStructure Mulighed for identændringer UseUnitKeys UseUnitInformation UseUnitArea AddressComplete EntityBuildingCaseInformation ExternalReferences MunicipalityFields NoteStructure BuildingCaseStructure BuildingCaseKeys BuildingCaseInformation BuildingCaseDates BuildingCaseInformationDates BuildingCaseCompletionDates Fælles strukturer landparcelidentitystructure AddressComplete ConstructionPoint WaterDrainage EntityBuildingCaseInformation ExternalReferences MunicipalityFields CondominiumStructure NoteStructure Metoder til entitet grund SiteGetById SiteGetByIdRequestStructure SiteGetByIdResponseStructure SiteGetByIds SiteGetByIdsRequestStructure SiteGetByIdsResponseStructure SiteGet SiteGetRequestStructure SiteGetResponseStructure SiteGetByMunicipalRealPropertyId SiteGetByMunicipalRealPropertyIdRequestStructure Snitfladebeskrivelse Side 6 af 273

7 SiteGetByMunicipalRealPropertyIdResponseStructure SiteGetByParentId SiteGetByParentIdRequestStructure SiteGetByParentIdResponseStructure SiteGetSubStructuresById SiteGetSubStructuresByIdRequestStructure SiteGetSubStructuresByIdResponseStructure SiteCreate SiteCreateRequestStructure SiteCreateResponseStructure SiteUpdate SiteUpdateRequestStructure SiteUpdateResponseStructure SiteDelete SiteDeleteRequestStructure SiteDeleteResponseStructure Metoder til entitet bygning BuildingGetById BuildingGetByIdRequestStructure BuildingGetByIdResponseStructure BuildingGetByIds BuildingGetByIdsRequestStructure BuildingGetByIdsResponseStructure BuildingGet BuildingGetRequestStructure BuildingGetResponseStructure BuildingGetBySiteId BuildingGetBySiteIdRequestStructure BuildingGetBySiteIdResponseStructure BuildingGetByParentId BuildingGetByParentIdRequestStructure BuildingGetByParentIdResponseStructure BuildingCreate BuildingCreateRequestStructure BuildingCreateResponseStructure BuildingUpdate BuidlingUpdateRequestStructure BuildingUpdateResponseStructure BuildingDelete BuildingDeleteRequestStructure BuildingDeleteResponseStructure Metoder til entitet opgang/indgang EntranceGetById EntranceGetByIdRequestStructure EntranceGetByIdResponseStructure EntranceGetByIds EntranceGetByIdsRequestStructure EntranceGetByIdsResponseStructure EntranceGet EntranceGetRequestStructure EntranceGetResponseStructure EntranceGetByBuildingId EntranceGetByBuildingIdRequestStructure Snitfladebeskrivelse Side 7 af 273

8 EntranceGetByBuildingIdResponseStructure EntranceGetByParentId EntranceGetByParentIdRequestStructure EntranceGetByParentIdResponseStructure EntranceCreate EntranceCreateRequestStructure EntranceCreateResponseStructure EntranceUpdate EntranceUpdateRequestStructure EntranceUpdateResponseStructure EntranceDelete EntranceDeleteRequestStructure EntranceDeleteResponseStructure Metoder til entitet etage FloorGetById FloorGetByIdRequestStructure FloorGetByIdResponseStructure FloorGetByIds FloorGetByIdsRequestStructure FloorGetByIdsResponseStructure FloorGet FloorGetRequestStructure FloorGetResponseStructure FloorGetByBuildingId FloorGetByBuildingIdRequestStructure FloorGetByBuildingIdResponseStructure FloorGetByParentId FloorGetByParentIdRequestStructure FloorGetByParentIdResponseStructure FloorCreate FloorCreateRequestStructure FloorCreateResponseStructure FloorUpdate FloorUpdateRequestStructure FloorUpdateResponseStructure FloorDelete FloorDeleteRequestStructure FloorDeleteResponseStructure Metoder til entitet enhed BuildingUnitGetById BuildingUnitGetByIdRequestStructure BuildingUnitGetByIdResponseStructure BuildingUnitGetByIds BuildingUnitGetByIdsRequestStructure BuildingUnitGetByIdsResponseStructure BuildingUnitGet BuildingUnitGetRequestStructure BuildingUnitGetResponseStructure BuildingUnitGetByEntranceId BuildingUnitGetByEntranceIdRequestStructure BuildingUnitGetByEntranceIdResponseStructure BuildingUnitGetByFloorId BuildingUnitGetByFloorIdRequestStructure Snitfladebeskrivelse Side 8 af 273

9 BuildingUnitGetByFloorIdResponseStructure BuildingUnitGetByParentId BuildingUnitGetByParentIdRequestStructure BuildingUnitGetByParentIdResponseStructure BuildingUnitCreate BuildingUnitCreateRequestStructure BuildingUnitCreateResponseStructure BuildingUnitUpdate BuildingUnitUpdateRequestStructure BuildingUnitUpdateResponseStructure BuildingUnitDelete BuildingUnitDeleteRequestStructure BuildingUnitDeleteResponseStructure Metoder til entitet teknisk anlæg TechnicalInstallationGetById TechnicalInstallationGetByIdRequestStructure TechnicalInstallationGetByIdResponseStructure TechnicalInstallationGetByIds TechnicalInstallationGetByIdsRequestStructure TechnicalInstallationGetByIdsResponseStructure TechnicalInstallationGet TechnicalInstallationGetRequestStructure TechnicalInstallationGetResponseStructure TechnicalInstallationGetBySiteId TechnicalInstallationGetBySiteIdRequestStructure TechnicalInstallationGetBySiteIdResponseStructure TechnicalInstallationGetByBuildingId TechnicalInstallationGetByBuildingIdRequestStructure TechnicalInstallationGetByBuildingIdResponseStructure TechnicalInstallationGetByParentId TechnicalInstallationGetByParentIdRequestStructure TechnicalInstallationGetByParentIdResponseStructure TechnicalInstallationCreate TechnicalInstallationCreateRequestStructure TechnicalInstallationCreateResponseStructure TechnicalInstallationUpdate TechnicalInstallationUpdateRequestStructure TechnicalInstallationUpdateResponseStructure TechnicalInstallationDelete TechnicalInstallationDeleteRequestStructure TechnicalInstallationDeleteResponseStructure Metoder til entitet rum RoomGetById RoomGetByIdRequestStructure RoomGetByIdResponseStructure RoomGetByIds RoomGetByIdsRequestStructure RoomGetByIdsResponseStructure RoomGet RoomGetRequestStructure RoomGetResponseStructure RoomGetByFloorId RoomGetByFloorIdRequestStructure Snitfladebeskrivelse Side 9 af 273

10 RoomGetByFloorIdResponseStructure RoomGetByBuildingUnitId RoomGetByBuildingUnitIdRequestStructure RoomGetByBuildingUnitIdResponseStructure RoomGetByParentId RoomGetByParentIdRequestStructure RoomGetByParentIdResponseStructure RoomCreate RoomCreateRequestStructure RoomCreateResponseStructure RoomUpdate RoomUpdateRequestStructure RoomUpdateResponseStructure RoomDelete RoomDeleteRequestStructure RoomDeleteResponseStructure Metoder til entitet brugsenhed UseUnitGetById UseUnitGetByIdRequestStructure UseUnitGetByIdResponseStructure UseUnitGetByIds UseUnitGetByIdsRequestStructure UseUnitGetByIdsResponseStructure UseUnitGet UseUnitGetRequestStructure UseUnitGetResponseStructure UseUnitGetByBuildingId UseUnitGetByBuildingIdRequestStructure UseUnitGetByBuildingIdResponseStructure UseUnitGetByParentId UseUnitGetByParentIdRequestStructure UseUnitGetByParentIdResponseStructure UseUnitCreate UseUnitCreateRequestStructure UseUnitCreateResponseStructure UseUnitUpdate UseUnitUpdateRequestStructure UseUnitUpdateResponseStructure UseUnitDelete UseUnitDeleteRequestStructure UseUnitDeleteResponseStructure Metoder til entitet byggesag BuildingCaseGetById BuildingCaseGetByIdRequestStructure BuildingCaseGetByIdResponseStructure BuildingCaseGetByIds BuildingCaseGetByIdsRequestStructure BuildingCaseGetByIdsResponseStructure BuildingCaseGet BuildingCaseGetRequestStructure BuildingCaseGetResponseStructure BuildingCaseGetBySiteId BuildingCaseGetBySiteIdRequestStructure Snitfladebeskrivelse Side 10 af 273

11 BuildingCaseGetBySiteIdResponseStructure BuildingCaseGetByEntityId BuildingCaseGetByEntityIdRequestStructure BuildingCaseGetByEntityIdResponseStructure BuildingCaseGetAllEntities BuildingCaseGetAllEntitiesRequestStructure BuildingGetAllEntitiesResponseStructure BuildingCaseCreate BuildingCaseCreateRequestStructure BuildingCaseCreateResponseStructure BuildingCaseUpdate BuidlingCaseUpdateRequestStructure BuildingCaseUpdateResponseStructure BuildingCaseDelete BuildingCaseDeleteRequestStructure BuildingCaseDeleteResponseStructure Metoder til søgninger Søgekriterier AddressSearchRequestSubStructure SiteSearchRequestSubStructure BuildingSearchRequestSubStructure FloorSearchRequestSubStructure BuildingUnitSearchRequestSubStructure CondominiumSearchRequestSubStructure TechnicalInstallationSearchRequestSubStructure RoomSearchRequestSubStructure UseUnitSearchRequestSubStructure BuildingCaseSearchRequestSubStructure Søgemetoder og søgeresultat Søgning på grunde SiteSearchRequestStructure SiteSearchResponseStructure Søgning på bygninger BuildingSearchRequestStructure BuildingSearchResponseStructure Søgning på opgange/indgange EntranceSearchRequestStructure EntranceSearchResponseStructure Søgning på etager FloorSearchRequestStructure FloorSearchResponseStructure Søgning på enheder BuildingUnitSearchRequestStructure BuildingUnitSearchResponseStructure Søgning på tekniske anlæg TechnicalInstallationSearchRequestStructure TechnicalInstallationSearchResponseStructure Søgning på rum RoomSearchRequestStructure RoomSearchResponseStructure Søgning på brugsenheder UseUnitSearchRequestStructure UseUnitSearchResponseStructure Søgning på byggesager Snitfladebeskrivelse Side 11 af 273

12 BuildingCaseSearchRequestStructure BuildingCaseSearchResponseStructure Adgang til snitfladen Sikkerhed Kodeeksempel for kald af certifikat Autorisation Testmiljø Snitfladebeskrivelse Side 12 af 273

13 1. Introduktion Denne snitfladebeskrivelse beskriver en af de OIOXML snitflader BuildingDwelling, som systemet stiller til rådighed. Baggrunden for snitfladen er, at man ønsker at registrere og opdatere Bygninger og boliger -data i ved webservicebaseret overførsel fra et eksternt system i OIOXML format. Denne snitfladebeskrivelse svarer til følgende version af webservicen: BuildingDwellingServiceV2.svc. I produktionsmiljø findes snitfladens endpoint her: Snitfladens dokumentation, snitfladens wsdl dokumenter for både produktions- og demoversionen vil man kunne finde på s demoserver, hvor den kan tilgåes uden certifikater. Wsdl'en er ikke eksponeret i produktion. Man skal bruge den fra demomiljøet og erstatte endpointet når man vil køre op mod produktion. Snitfladebeskrivelsen giver kort sagt mulighed for fremsøgning samt opdatering af Bygninger og boliger -data i, herunder grunde, bygninger, opgange/indgange, etager, enheder, tekniske anlæg, rum, brugsenheder og ikke mindst byggesager. 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 s bygnings- og boligoplysninger, herunder datasammenhængen. Kapitel 4 giver et overblik over webservicen BuildingDwelling og dens metoder, som udgør snitfladen. Kapitlet beskriver også nogle generelle forhold som gælder for alle metoder og strukturer hørende til webservicen. Kapitel 5 beskriver strukturerne, som benyttes til at beskrive de enkelte entiteter. Det er en og den samme struktur som benyttes for hver entitet, uafhængig af hvor den benyttes, dvs. i alle metoder som henter og opdaterer entiteterne samt i søgningerne. Kapitel 5 beskriver også nogle fælles strukturer, som benyttes på tværs af entiteterne. Kapitel 6 til 14 beskriver metoderne for hver entitet i detaljer. kapitel 6 beskriver metoderne hørende til entiteten grund kapitel 7 beskriver metoderne hørende til entiteten bygning kapitel 8 beskriver metoderne hørende til entiteten opgang/indgang kapitel 9 beskriver metoderne hørende til entiteten etage kapitel 10 beskriver metoderne hørende til entiteten enhed kapitel 11 beskriver metoderne hørende til entiteten teknisk anlæg kapitel 12 beskriver metoderne hørende til entiteten rum kapitel 13 beskriver metoderne hørende til entiteten brugsenhed kapitel 14 beskriver metoderne hørende til entiteten byggesag Kapitel 15 beskriver søgningerne. Snitfladebeskrivelse Side 13 af 273

14 Kapitel 16 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 Bygninger og boliger del. Ud over denne snitflade findes 4 andre snitflader, som er relevante, hvis man ønsker at udvikle applikationer til systemet. Snitfladen Address dækker over systemets adressedel og stiller metoder til hentning og opdatering af adgangs- og enhedsadresser 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 14 af 273

15 2. Formål og målgrupper Snitfladen har til formål at gøre det muligt for kommunerne at fremsøge og ajourføre Bygninger og boliger -data i. Snitfladen er en tovejskommunikation mellem en leverandør/kommune og systemet. Den gør det muligt at hente data fra systemet og den gør det muligt at sende data til opdatering af. Når der skrives "Bygninger og boliger"-data dækker det over de allerede nævnte 9 entiteter: Grund Bygning Opgang/indgang Etage Enhed Teknisk anlæg Rum Brugsenhed Byggesag Snitfladens funktioner henvender sig hovedsaglig til private eller offentlige itvirksomheder som ønsker at udvikle it-løsninger eller andre komponenter, der ved hjælp af webservicebaseret overførsel kan anvendes til at registrere eller opdatere 's bygnings- og boligoplysninger. Snitfladebeskrivelse Side 15 af 273

16 3. Forretningsviden For at kunne forstå den efterfølgende vejledning og snitfladens metoder er det vigtigt at kende de enkelte entiteter samt deres datasammenhæng. Snitfladen indeholder metoder hørende til de i kapitel 2 nævnte 9 entiteter. De første 8 entiteter og deres sammenhæng er beskrevet i afsnit 3.1. Entiteten byggesag adskiller sig fra de andre 8 entiteter og bliver beskrevet i afsnit 3.5. Afsnit 3.2. beskriver sammenhængen mellem adresser og entiter i Bygninger- og Boliger. Afsnit 3.3 og 3.4 beskriver forskellen mellem stamentiteter og sagsentiteter, som er vigtig at kende for at kunne forstå forretningslogikken omkring de 8 entiteter og entiteten byggesag. Afsnit 3.6 beskriver geometripunkter til tekniske anlæg og bygninger De forskellige entiteter i og deres sammenhæng Billedet på næste side viser sammenhængen mellem de 8 nævnte entiteter. Selv om matriklen vises som entitet på figuren, betragtes den ikke som en -entitet, idet matrikeloplysninger stammer fra KMS og ESR-systemerne og de kan således ikke oprettes, rettes eller slettes i. I snitfladen vil matrikeloplysninger altid blive leveret som en undertsruktur til de respektive entiteter. Entiteten byggesag er ikke med på tegningen idet den som nævnt adskiller sig fra de andre 8 entiteter. Som man kan se, er entiteterne knyttet til hinanden. En grund består altid af 1 til flere matrikler. Omvendt er en matrikel altid knyttet til præcis en grund. På en matrikel kan der være registeret 0 til flere bygninger og 0 til flere tekniske anlæg. Omvendt er en bygning altid knyttet til en matrikel og et teknisk anlæg er enten knyttet til en bygning eller direkte til en matrikel. Som noget nyt kan man oprette tekniske anlæg på ubebyggede grunde uden at der er indberettet kloak- og vandforhold på grunden. En bygning kan have tilknyttet 0 til flere opgange/indgange, 0 til flere etager, 0 til flere tekniske anlæg og 0 til flere brugsenheder. Omvendt er en opgang/indgang, en etage og en brugsenhed altid knyttet til en bygning. Et teknisk anlæg kan være knyttet til en bygning eller direkte til en matrikel. En opgang/indgang og en etage kan have 0 til flere tilknyttede enheder. Omvendt er en enhed altid knyttet til en opgang/indgang og til en etage i samme bygning. En etage eller en enhed kan have underliggende rum. Omvendt er et rum altid knyttet til en etage og et rum kan yderligere være knyttet til en enhed. Snitfladebeskrivelse Side 16 af 273

17 Brugsenheder, rum og tekniske anlæg har ikke nogen underliggende entiteter. I forbindelse med de enkelte metoder vil relationerne mellem entiteterne blive beskrevet endnu engang. Grund hedder på engelsk site og i servicen Site. Bygning hedder på engelsk building og i servicen Building. Opgang/indgang hedder på engelsk entrance og i servicen Entrance. Etage hedder på engelsk floor og i servicen Floor. Enhed hedder på engelsk unit og i servicen BuildingUnit for at markere at en enhed altid hører til en bygning. Teknisk anlæg hedder på engelsk technical installation og i servicen TechnicalInstallation. Snitfladebeskrivelse Side 17 af 273

18 Rum hedder på engelsk room og i servicen Room. Brugsenhed hedder på engelsk use unit og i servicen UseUnit. En byggesag er altid knyttet til en grund og de sagsentiteter som hører til byggesagen skal ligge under selv samme grund. Byggesag hedder på engelsk building case og i servicen BuildingCase. Ud over at entiteterne har deres indbyrdes sammenhæng, kan de have tilknyttet adresser. I denne webservice er denne tilknytning udtrykt via en reference til en adresse ident, hørende til en adgangs- eller enhedsadresse. Denne webservice giver mulighed for at oprette, ændre og slette referencer til adresser, men vil man oprette nye adresser, ændre eller slette adresser i s adressedel, skal man benytte sig af webservicen Address.wsdl Adressers tilknytning til niveauer i Bygninger og boliger En adresse kan bruges på flere niveauer i Bygninger og Boliger. I Bygninger og Boliger fungerer adressen som en simpel attribut, der beskriver beliggenheden af den pågældende entitet. Man kan også sige at Bygninger og Boliger anvender de adresser der er oprettet i Adresser. En adgangsadresse kan tilknyttes til følgende niveauer: Grund Bygning Teknisk anlæg Opgang En enhedsadresse kan tilknyttes til følgende niveauer: Enhed Brugsenhed Følgende niveauer har ingen adresse tilknyttet: Rum Etage Adressen er krævet for alle niveauer, som har en adresse, undtagen ubebyggede grunde, som ikke behøver at have en adresse. Der kan forekomme grunde uden adresse når grunde oprettes automatisk efter besked fra ESR/KMS. Når adresser tilknyttes til niveauer i Bygninger og Boliger kan følgende adresser benyttes: Gældende adgangsadresser og gældende enhedsadresser Nye foreløbige adgangsadresser med husnummer og tilhørende enhedsadresser Den samme adresse må gerne benyttes på flere niveauer i Bygninger og boliger. I tidligere versioner af Nyt har det ikke været muligt for to ejendomme at have den samme adresse. Denne begrænsning er fjernet. En adgangsadresse, som er knyttet til en bygning direkte kaldes også repræsentativ adgangsadresse. For de repræsentative bygningsadresser gælder det, at samme adgangsadresse kan benyttes for flere bygninger. På en Snitfladebeskrivelse Side 18 af 273

19 landbrugsejendom vil alle bygninger typisk have samme repræsentative adgangsadresse. For et enfamiliehus vil garagen typisk have samme repræsentative adgangsadresse som villaen. Adgangsadresser kan også knyttes til en bygning indirekte via bygningens opgang/indgange. Bygninger hvori der findes en eller flere opgange/indgange har tilknyttet en adgangsadresse for hver opgang eller indgang. En adgangsadresse kan i en bygning kun være tilknyttet til højst én opgang/indgang i bygningen. Hvis en bygning har mere end en opgang/indgang vil den have lige så mange adgangsadresser tilknyttet via opgangene/indgangene. Opgangsadresser skal være entydige i én bygning. To opgange i to forskellige bygninger på samme ejendom kan dog have den samme adresse. Dette imødekommer anneksproblematikken. Systemet vil dog give en advarsel i dette tilfælde. To opgange i forskellige ejendomme må ikke have den samme adresse. Disse regler skal også opretholdes, når man flytter en bygning til en anden matrikel. Der er sammenhæng mellem en opgangs adgangsadresse og de tilhørende enheders enhedsadresser. Enheder i en opgang har enhedsadresser, som ligger under den adgangsadresse, som opgangen har. Der gælder, at enhedsadresser og brugsenhedsadresser i to forskellige ejendomme ikke må være ens. Snitfladebeskrivelse Side 19 af 273

20 3.3. Stamentiteter Der skelnes mellem stamentiteter med status 1 og sagsentiteter med status 3. Sagsentiteter er nybyggerier (N) eller rettelser til stamentiteter (S). Hvis du vil rette, oprette eller slette en stamentitet, kan dette gøres direkte i stamdelen eller via en byggesag, hvor ændringer først bliver gældende ved afslutning af byggesagen. Sidstnævnte mulighed er nærmere forklaret i afsnit 3.5. Når entiteter slettes i stamdelen får de et ophørstimestamp og deres status ændres til 2. Stamentiteter vil altid ligge under andre stamentiteter i det i afsnit 3.1 beskrevne hierarki. Dvs. man kan fx ikke have en stam-brugsenhed som ligger under en bygning, som er et nybyggeri. Eller en stam-enhed som ligger under en etage eller opgang, der er nybyggerier Sagsentiteter Der findes 3 slags sagsentiteter: Nybyggerier (N) Til/ombygninger (S) Nedrivninger (S) Nedrivninger og til-/ombygninger refererer til den stamentitet de hører til, dvs. den de er en ændring til. I nedenstående eksempel peger sagsentiteten 14 på stamentiteten 13. Nybyggerier peger også på en stamentitet, men her drejer det sig om en slags placeholder for den senere stamentitet. Placeholderen har den id, som entiteten får, når sagen afsluttes og nybyggeriet overføres til stam. I nedenstående eksempel peger nybyggeriet 12 på en placeholder 11 i stamdelen. Id: 11 Placeholder for nybyggeri (status 1) Id: 13 Stamentitet (status 1) <Entity>ParentReference <Entity>ParentReference Id: 12 Nybyggeri (status 3) Id: 14 Ændring til stamentitet (nedrivning eller til/ombygning) (status 3) I nogle sjældne tilfælde kan man godt have en sag på et nybyggeri. I givet fald vil (S) entiteten pege på samme placeholder som (N) entiteten. Placeholdere er nærmere beskrevet i afsnit Når man opretter en sagsentitet (S), dvs. en ændring til en stamentitet, gøres det ved at angive stamentitetens id. Snitfladebeskrivelse Side 20 af 273

21 Der vil automatisk blive kopieret nogle får oplysninger fra stamentiteten over til sagsentiteten Byggesager En sagsentitet er altid knyttet til en byggesag. En byggesag kan samle en eller flere sagentiteter. Når en byggesag afsluttes ved angivelse af en eller flere nødvendige datoer afsluttes de tilhørende sagsentiteter og overføres til stamdata. Der må ikke være to sagsentiteter hørende til samme stamentitet i den samme byggesag. I enhver byggesag skal der normalt være en bygning (en (S)BYG eller (N)BYG)). Undtaget er byggesager som alene indeholder entiteter som ikke ligger under en bygning, dvs. ændringer til grunde ((S)GRU entiteter) eller ændringer eller nyopførelser af tekniske anlæg som ikke knytter sig til en bygning ((N)TEK hhv. (S)TEK entiteter). Opretter man fx en ny enhed, (N)ENH, og byggesagen ikke indeholder en bygning, vil der blive oprettet en (S)BYG entitet i byggesagen. Denne sagsentitet er en ændring til den bygning, som den nye enhed ligger under. Baggrunden for denne implementering er, at synkronisering af Nyt til KMD, i mange tilfælde kræver, at der forefindes en bygning i byggesagen. Der må kun være én bygning i en byggesag. En byggesag er altid knyttet til en grund og de sagsentiteter som hører til byggesagen skal ligge under selv samme grund Mulige byggesagskoder En byggesag skal have en af de nedenstående byggesagskoder: 1 BR Tilladelsessag uden ibrugtagningstilladelse (enfamiliehuse mv.) 2 BR Anmeldelsessag (garager, carporte og udhuse m.m.) 3 BR Tilladelsessag med ibrugtagningstilladelse 4 BR Tilladelsessag uden landbrugsbygning 5 BR Anmeldelsessag (øvrige.) Afslutning af en byggesag Når en byggesag afsluttes overføres data fra de tilhørende sagsentiteter ((N) hhv. (S) entiteter) til data i stam. En byggesag afsluttes ved at der angives en eller flere relevante datoer: For sagstype 1,2,4,5: Fuldførelsesdato udfyldes og sagen gemmes. For sagstype 3: Ibrugtagningsdato udfyldes og sagen gemmes (udfyldes der fuldførelsesdato uden indtastning af ibrugtagningsdato afsluttes sagen midlertidig, se afsnit 3.5.4). Ibrugtagningsdato indberettes kun ved sagstype 3. Mere nøjagtig sker der følgende ved afslutning af en byggesag: Data overføres fra sag til stam. Sagsentiteterne får status 4 og et ophørstimestamp. Byggesagen får et ophørstimestamp. Hvis byggesagen indeholder en nybyggeri bygning sættes opførelsesår. Hvis byggesagen indeholder et nybyggeri teknisk anlæg sættes etableringsår. Snitfladebeskrivelse Side 21 af 273

22 For nedrivninger gælder det, at stamentiteten slettes i stamdelen, dvs. får et ophørstimestamp og status 2. Dette gælder naturligvis kun ved nedrivning af hele entiteten. For tilladelsessager med byggesagskode 3 kan man afslutte byggesagen midlertidig eller delvis. Disse to typer er beskrevet i det følgende Overførsel af data fra sag til stam Når en byggesag afsluttes overføres data fra de tilhørende sagsentiteter ((N) hhv. (S) entiteter) til data i stam. For nybyggerier overføres alle data, men for sagsentiteter (S) overføres ikke alle felter. Følgende felter opfattes som hørende til sagsniveauet og overføres ikke til stamentiteter ved afslutning af en (S) entitet: ESDH reference Journalnummer Oprettelsesdato (RecordCreatedDateTime) Seneste ændringsdato (RecordChangeDateTime) Ved til- og ombygninger samt nedrivininger kan der forekomme negative værdier i f.eks. arelafelter, som trækkes fra det i stamdelen registrerede areal Midlertidig afslutning af en byggesag En byggesag med byggesagskode 3 og anvendelseskode forskellig fra 210 kan afsluttes midlertidigt. Dette sker når en byggesag fuldføres, men ikke ibrugtages (fuldførelsesdato forskellig fra null, ibrugtagningstilladelse = null). Tidligere har der været et krav om en bygning i byggesagen for at kunne afslutte denne midlertidig, men dette krav er nu fjernet hvis byggesagen indeholder alene et teknisk anlæg. En midlertidig afslutning betyder, at data overføres fra sag til stam for alle sagsentiteter, men at byggesagen ikke afsluttes endeligt. Byggesagen venter på, at der angives en ibrugtagningsdato. Alle entiteter undtagen bygninger og tekniske anlæg fjernes fra byggesagen, men bygninger og tekniske anlæg vil som sagsentiteter forblive i byggesagen indtil den afsluttes helt. De kan dog ikke længere rettes. Et forsøg på at opdatere de forblivne sagsentiteter i byggesagen eller et forsøg på at rette selve byggesagen vil blive afvist. Det eneste der kan inddateres i byggesagen er ibrugtagningstilladelse. Alle andre data skal rettes i stam. Mere teknisk udtrykt sker der følgende ved en midlertidig afslutning af en byggesag: Data overføres fra sag til stam for alle sagsentiteter. Sagsentiteterne - undtagen bygningener og tekniske anlæg - får status 4 og et ophørstimestamp. Hvis det er nybyggerier, sættes deres opførelsestimstamp. Data for bygninger/tekniske anlæg overføres fra sag til stam men sagsentiteterne forbliver i byggesagen med status 3 og får ingen ophørstimestamp. Byggesagen får ikke et ophørstimestamp. Sagentiterne i byggesagen må ikke rettes, men der kan foretages rettelser i stamentiteterne. Snitfladebeskrivelse Side 22 af 273

23 Midlertidigstatus på stambygning sættes til 2 hvis nybyggeri og 4 hvis om/tilbygning. Først når der efterfølgende indtastes en ibrugtagningsdato på byggesagen vil sagsentiterne få status 4 og et ophørstimestamp, men der sker ingen overførsel af data fra sagsdata til stam. Stambygningens felt Midlertidig status resettes. (Dvs. det undersøges, om der er andre midlertidig afsluttede byggesager på samme bygning. I dette tilfælde sættes midlertidig status til 2 eller 4 alt efter nybyggeri eller ej. Hvis der ikke er andre midlertidigt afsluttede byggesager på bygningen sættes feltet til 0.) Delvis afslutning af en byggesag Byggesager med byggesagskode 3 og som indeholder enheder kan delvis afsluttes. Dette sker normalt når nogle enheder ibrugtages, mens andre endnu ikke er færdiggjort. Som det første skridt opdateres den (eller de) enhed(er) der skal afsluttes, med en dato i feltet Delvis ibrugtagning. Som det andet skridt indtastes dato for Delvis ibrugtagningstilladelse på byggesagen. I feltet Foreløbig færdiggjort bygningsareal indtastes et areal. Grunden til at det ikke bare kan beregnes ud fra enheden(erne) er, at der godt kan være noget fællesareal der også er færdiggjort. Når byggesagen gemmes sker følgende: Foreløbig færdiggjort bygningsareal vil blive adderet til feltet Færdiggjort bygningsareal i alt. Felterne Foreløbig færdiggjort antal lejligheder og Foreløbig færdiggjort antal lejligheder uden køkken beregnes. De enheder der har en dato i feltet Delvis ibrugtagning afsluttes. Hvis der er tale om nybyggeri afsluttes enhedens opgang og etage ligeledes. Hvis bygningen i byggesagen er et nybyggeri opdateres placeholderen med et opførelsesår. Stambygningen må stadig ikke opdateres. Midlertidstatus på bygningen i stam sættes til 1 hvis nybyggeri og til 3 hvis om-/tilbygning. Bygningens sagsdata overføres ikke til stamdata. Det er sagsbygningen som opdateres og ikke stambygningen. Der er muligt efter en delvis afslutning af byggesagen at foretage en fuldførelse af byggeriet før ibrugtagningstilladelse. Sker dette følges beskrivelsen i ovenstående afsnit Midlertidig afslutning af byggesag. En delvis afsluttet byggesag ibrugtages/afsluttes ved at indtaste dato for ibrugtagningstilladelse. Alle entiteter i byggesagen (inkl. bygningen) afsluttes og sagsdata overføres til stam på almindeligvis. Bygningens felt Midlertidig status resettes. (Dvs. det undersøges, om der er andre midlertidig afsluttede byggesager på samme bygning. I dette til sættes midlertidig status til 2 eller 4 alt efter nybyggeri eller ej. Hvis der ikke er andre midlertidigt afsluttede byggesager på bygningen sættes feltet til 0.) Snitfladebeskrivelse Side 23 af 273

24 Indflytning På en byggesag med byggesagskode 1 eller 3 kan man på en sagsenhed indtaste en indflytningsdato. Det vil afslutte denne enhed og overføre den til stam. Hvis det er en byggesagskode 1 foretages der en midlertidig afslutning af byggesagen. (KMD kan ikke håndtere en delvis afslutning af byggesagskode 1), dvs. alle sagsdata (ikke kun den ene enhed) flyttes til stam og byggesagen venter kun på ibrugtagningstilladelse. Følg beskrivelsen under afsnittet Midlertidig afslutning af byggesag. Det er ikke specielt hensigtsmæssigt at lave en midlertidig afslutning af byggesagen ved byggesagskode 1. Det giver kun mening for parcelhuse med én enhed, men hvis der er flere enheder i bygningen vil de alle blive afsluttet, selvom kun den ene har fået en indflytningsdato. Denne implementering skyldes, at synkroniseringen til KMD ellers ville fejle. Hvis det er en byggesagskode 3 simuleres en delvis ibrugtagningstilladelse. Enheden opdateres med Delvis ibrugtagning sat lig indflytningsdato. Byggesagen opdateres med Delvis ibrugtagningstilladelse sat til dags dato og byggesagens FærdigtBygningsareal sat lig med enhedens areal. Følg herefter beskrivelsen i Delvis afslutning af byggesag Henlæggelse Man henlægger en byggesag ved at udfylde henlæggelsesdatoen og gemme byggesagen. Byggesagen får et ophørstimestamp. Når en byggesag henlægges, henlægges også de underliggende sagentiteter, dvs. ophørstimestampet sættes og status ændres til Sletning af sagsentitet i en byggesag Man sletter en sagsentitet ved at benytte Slet entitet (Delete) metoden. Når en sagsentitet slettes, bliver ophørstimestampet sat, og status forbliver 3. En sletning af en sagsentitet tolkes som om entiteten aldrig burde have været oprettet Sletning af byggesag Man sletter en byggesag ved at benytte Slet byggesag (Delete) delete metoden på byggesagen. Byggesagen får et ophørstimestamp. Når en byggesag slettes, slettes også de underliggende sagsentiteter Koordinater til bygning og teknisk anlæg Bygninger og tekniske anlæg har i Nyt mulighed for at få tilknyttet geometripunkter. Geometripunkter knyttes til bygninger hhv. tekniske anlæg i forbindelse med oprettelse eller opdatering af entiteten. Dette gøres ved at man udfylder strukturen ConstructionPoint (se afsnit ). Hvilke felter denne struktur har og hvilke af disse felter der er krævede ved indberetning er beskrevet i afsnit Koordinater kan kun tilknyttes til stamentiteter eller nybyggerier, men ikke til sager, som er ændringer til stamentiteter ((S) entiteter). Når man indberetter koordinater skal man tage højde for følgende valideringsregler: Snitfladebeskrivelse Side 24 af 273

25 Ved indberetning må nøjagtighedsklassen ikke være U. Nøjagtighedsklasse B må ikke overskrive nøjagtighedsklasse A. Felterne x-koordinat, y-koordinat, kilde til geometri og nøjagtighedsklasse er krævede felter Revisionsdato skal være større eller lig med den eksisterende revisionsdato, og den skal være mindre eller lig med dagsdato. x- og y koordinaten skal være i det geografiske rektangel, som hører til landsdelen. Der skelnes mellem 4 landsdele: Jylland (incl. Læsø og Anholt) (kommunenumre større end 500) Fyn (incl Sprogø) (kommunenumre 410, og ellers større end 411 og mindre end 500) Sjælland (kommunenumre større end 100 og mindre end 400) Bornholm og Christiansø (kommunenumre 400 og 411) Foreløbige koordinater Geometripunkter til bygninger og teknisk anlæg kan indberettes af kommunen eller eksterne parter, men i de tilfælde hvor de ikke indberettes, hentes foreløbige koordinater fra KMS. Det bliver gjort i forbindelse med opdatering og oprettelse af bygninger og tekniske anlæg i følgende situationer: Ved oprettelse af en bygning eller et teknisk anlæg i stamdelen eller ved oprettelse af et nybyggeri, hvor der ikke sendes geometripunkter med. Ved opdatering af en bygning eller teknisk anlæg i stamdelen (enten ved direkte opdatering eller ved afslutning af en byggesag) eller ved opdatering af et nybyggeri. Det er kun muligt at hente foreløbige koordinater når bygningen hhv. det teknisk anlæg har tilknyttet et KMS matrikelnummer. Med KMS matrikelnummer menes 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. Derudover hentes der kun koordinater når geometripunktet ikke findes, dvs. nøjagtighedsklassen er U (uden koordinater) eller når koordinater har en kilde til geometri lig med 1, dvs. koordinaterne ikke er blevet opdateret igennem OIOXML snitfladen af en bedre kilde end fra KMS. For København og Frederiksberg gennemføres disse kald til KMS ikke Kontrol af koordinater Når en stamentitet (bygning hhv. teknisk anlæg) eller et nybyggeri har en geometri, som er bedre en KMS (dvs. kilde er forskelligt fra 1), bliver der kontrolleret, om koordinaterne ligger på samme matrikel som bygningen hhv. det tekniske anlæg. Ligesom ovenfor gennemføres denne kontrol kun hvis entiteten er knyttet til et KMS matrikelnummer Denne kontrol bliver gennemført i følgende situationer: Snitfladebeskrivelse Side 25 af 273

26 Ved oprettelse af en bygning eller et teknisk anlæg i stamdelen eller ved oprettelse af et nybyggeri, hvor der sendes et geometripunkt med. Ved opdatering af en bygning eller teknisk anlæg i stamdelen (enten ved direkte opdatering eller ved afslutning af en byggesag) eller ved opdatering af et nybyggeri. Hvis dette ikke er tilfælde returneres sandsynlighedsbeskeden Matriklen er ikke i overensstemmelse med entitetens matrikel fra KMS (<KMS matrikel>). For København og Frederiksberg gennemføres disse kald til KMS ikke. Snitfladebeskrivelse Side 26 af 273

27 4. Overblik over webservices og metoderne Metoderne i servicen (WSDL en) kan inddeles i 10 grupper: metoderne hørende til entiteten grund metoderne hørende til entiteten bygning metoderne hørende til entiteten opgang/indgang metoderne hørende til entiteten etage metoderne hørende til entiteten enhed metoderne hørende til entiteten teknisk anlæg metoderne hørende til entiteten rum metoderne hørende til entiteten brugsenhed metoderne hørende til entiteten byggesag søgemetoderne For hver entitet findes der metoder til at hente, opdatere, oprette og slette entiteten: <Entitet>GetById/GetByIds <Entitet>Get <Entitet>Create <Entitet>Update <Entitet>Delete Derudover findes der for hver af de 8 førstnævnte entiteter en metode til at hente sagsentiteter hørende til en stamentitet: <Entitet>GetByParentId Hver entitet leveres med referencer til overliggende entiteter. For at hente underliggende entiteter stilles yderligere metoder til rådighed. Der findes for hver entitet med underliggende entiteter en metode til at hente disse underliggende entiteter: <Entitet1>GetBy<Entitet2>Id Derudover findes der for hver entitet en søgemetode: <Entitet>Search Til sidst kan der nævnes at metoden SiteGetSubStructuresById henter alle underliggende entiteter til en grund. Denne metode kan benyttes på alle niveauer til at hente alle underliggende entiteter. Ønsker man fx at hente alle underliggende entiteter til en bygning, kalder man metoden med id en for den grund som bygningen hører til. Alle metoder har en inputstruktur, som hedder <metodenavn>requeststructure og en outputstruktur, som hedder <metodenavn>responsestructure. Fx hedder strukturerne til GetById metoden for bygningen BuildingGetByIdRequestStructure og BuildingGet- ByIdResponseStructure. For hver entitet findes der en struktur, som beskriver entiteten både når den benyttes som input og som output til en metode. Dette gælder også for søgemetoderne, som returnerer en entitet i samme struktur som en hent metode til entiteten. Strukturen hedder: Snitfladebeskrivelse Side 27 af 273

28 <Entitet>Structure Fordelen ved denne implementering er, at man kan genbruge strukturen fra en søgning eller et læsekald, når man skal opdatere entiteten efterfølgende. Ulempen kan være, at man ikke altid ud fra strukturen kan se, hvilke felter der er krævede eller optionelle i hvilke situationer. Vejledningen vil dog tage hensyn til dette og de fleste steder er der beskrevet i hvilke situationer et felt er krævet og i hvilke det ikke er. De forskellige entitetsstrukturer er beskrevet i kapitel 5 idet de danner grundlag for stort set alle metoder i webservicen. Metoderne er beskrevet i kapitel 6 til 15, hvor hvert kapitel svarer til en af de ovenstående 10 grupper af metoder. Beskrivelsen er underbygget med billeder af strukturerne for at anskueliggøre beskrivelsen. Bl.a. kan man se, hvilke felter der er obligatoriske, dvs. skal udfyldes, når metoderne bliver kaldt. Derudover kan man se alle felter/understrukturer som hører til en struktur og deres kardinalitet. Før entitetsstrukturerne og metoderne beskrives, vil afsnit 4.1 til 4.12 beskrive nogle generelle forhold, som er fælles for de fleste metoder og som med fordel kan beskrives samlet Sandsynlighedskontroller (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 de 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 Udskrivning af Meddelelser (printenableindicator) Man kan benytte en indikator for at angive, om der skal udskrives en Meddelelse i forbindelse med den rettelse man foretager. Indikatoren findes kun i de metoder hvor den giver mening, dvs. fx ikke i hent eller søgemetoderne, men i opret, ret og slet metoder. Hvis man sætter indikatoren til at være true, resulterer den respektive opdatering i en bestilling af en automatisk Meddelelse for en ejendom/ejerlejlighed vel at mærke hvis det giver mening. Der bestilles fx ingen Meddelelser ved ændringer af sagsentiteter. Kun en afslutning af en byggesag kan resultere i en Meddelelse for den involverede ejendom (de involverede ejendomme). Årsagskoden afhænger af den respektive ændring. For en beskrivelse af mulige årsagskoder henvises til brugervejledning for systemets Meddelelse funktionalitet. Snitfladebeskrivelse Side 28 af 273