OIOXML Vejledning til OIOXML snitflade for Bygninger og boliger BuildingDwelling.wsdl En vejledning rettet mod 3. part.
Indholdsfortegnelse 1. Introduktion... 3 2. Ændringer i BuildingDwelling... 4 2.1. Ændret kodeliste for felt Pålæg fra stormråd... 4 2.2. Nyt felt Omfattet af byggeskadeforsikring... 4 2.3. Ændret kodeliste for felt Afløbsforhold... 4 2.4. Ændret kodeliste til felt Byggeskadeforsikringsselskab... 6 2.5. Ændret placering af feltet Gyldighedsdato... 7 2.6. Ændret kodeliste til felt Afvigende etager... 7 2.7. Ændret kodeliste til felt Afløbsforholdtilladelse... 7 2.8. Ændret kodeliste til felt Offentlig støtte... 8 2.9. Ændret kodeliste til felt Vandforsyning... 8 2.10. Ændret kodeliste til felt Kode for lovlig anvendelse af sommerhus til helårsbeboelse... 8 Snitfladebeskrivelse Side 2 af 9
1. Introduktion Dette tillæg henvender sig til brugere af den første version af OIO XML snitfladen BuildingDwelling, som hedder BuildingDwellingServiceV1.svc. Snitfladen eksisterer i en version 2 (BuildingDwellingServiceV2.svc) fra 15.12.2010. Vi anbefaler at man skifter til version 2 af snitfladen, men hvis dette ikke er muligt, skal man være opmærksom på de i dette tillæg beskrevne forhold for at sikre bagudkompatibiliteten. I produktionsmiljø findes snitfladernes endpoint her: https://bbr-kommune.dk/services/servicegateway/buildingdwellingservicev1.svc https://bbr-kommune.dk/services/servicegateway/buildingdwellingservicev2.svc Snitfladernes dokumentation, snitfladernes wsdl dokumenter for både produktions- og demoversionen vil man kunne finde på s demoserver: http://demo.bbr-kommune.dk/services/ Snitfladebeskrivelse Side 3 af 9
2. Ændringer i BuildingDwelling 2.1. Ændret kodeliste for felt Pålæg fra stormråd Feltet Pålæg fra stormråd (StormCouncilInstructionCode) har ændret kodeliste fra version 1 til version 2. Kodeliste i BuildingDwellingV1: 00: Ejer har ikke modtaget pålæg fra Stormrådet 01: Ejer har modtaget pålæg fra Stormrådet Kodeliste i BuildingDwellingV2: 00: Ingen udbetalt erstatning fra Stormrådet 01: Bygningens selvrisiko er forhøjet til Trin 1 02: Bygningens selvrisiko er forhøjet til Trin 2 Da betydningen af koderne er ændret, returneres feltet IKKE gennem BuildingDwellingV1 snitfladen. som advarer om, at feltet har fået ny betydning, og at der er kommet en ny version af snitfladen men man IKKE til null (som det ellers er konventionen). Feltet opdateres ikke. 2.2. Nyt felt Omfattet af byggeskadeforsikring Feltet Omfattet af byggeskadeforsikring (BuildingDamageInsuranceCode) er nyt i version 2 af snitfladen. Kodeliste i BuildingDwellingV2: 00: Bygningen er ikke omfattet af byggeskadeforsikring 01: Bygningen er omfattet af byggeskadeforsikring 02: Bygningen er opført som selvbyg Ændringen behøves ikke at blive håndteret. Man skal bare være opmærksom på, at feltet ikke leveres som en del af bygningsstrukturen i version 1. 2.3. Ændret kodeliste for felt Afløbsforhold Feltet Afløbsforhold (DrainageCode) har ændret kodeliste fra version 1 til version 2. Der er kommet nye kodeværdier og kodeoversættelsen af nogle felter har ændret sig. Kodeliste i BuildingDwellingV1: 10 - Afløb til offentligt spildevandsanlæg 11 - Afløb til fælles privat spildevandsanlæg 12 - Afløb til fællesprivat kloakledning med tilslutning til offentligt spildevandsanlæg 20 - Afløb til samletank Snitfladebeskrivelse Side 4 af 9
21 - Afløb til samletank for toiletvand og mekanisk rensning af øvrigt spildevand 29 - Mekanisk rensning med nedsivningsanlæg (med tilladelse) 30 - Mekanisk rensning med nedsivningsanlæg 31 - Mekanisk rensning med privat udledning dir. til vandløb 32 - Mekanisk og biologisk rensning 70 - Udledning direkte uden rensning til vandløb, søer eller havet 75 - Blandet afløbsforhold på ejendom (er specificeret på bygninger) 80 - Anden type afløb 90 - Ingen udledning 101 - SOP: Minirenseanlæg med direkte udledning 102 - SOP: Minirenseanlæg med udledning til markdræn 103 - SOP: Minirenseanlæg med nedsivning i faskine 104 - SOP: Nedsivning 105 - SOP: Samletank 106 - SOP: Pileanlæg med nedsivning (uden membran) 107 - SOP: Pileanlæg uden udledning (med membran) 201 - SO: Biologisk sandfilter med direkte udledning 202 - SO: Biologisk sandfilter med udledning til markdræn 203 - SO: Minirenseanlæg med direkte udledning 204 - SO: Minirenseanlæg med udledning til markdræn 205 - SO: Beplantede filteranlæg med direkte udledning 206 - SO: Beplantede filteranlæg med udledning til markdræn 301 - OP: Minirenseanlæg med direkte udledning 302 - OP: Minirenseanlæg med udledning til markdræn 401 - O: Rodzoneanlæg med direkte udledning 402 - O: Rodzoneanlæg med udledning til markdræn 403 - O: Minirenseanlæg med direkte udledning 404 - O: Minirenseanlæg med udledning til markdræn 501 - Øvrige: Mekanisk med direkte udledning 502 - Øvrige: Mekanisk med udledning til markdræn 503 - Øvrige: Nedsivning i sivebrønd 504 - Øvrige: Udledning til jordoverfladen 505 - Øvrige: Urenset 601 - Anden type anlæg (>=30 PE med egen udledning) 701 - Intet afløb Kodeliste i BuildingDwellingV2: 1 - Fælleskloakeret: spildevand + tag- og overfladevand 2 - Fælleskloakeret: spildevand + delvis tag- og overfladevand 3 - Fælleskloakeret: spildevand 4 - Fælleskloakeret: tag- og overfladevand 5 - Separatkloakeret: spildevand + tag- og overfladevand 6 - Separatkloakeret: spildevand + delvis tag- og overfladevand; 7 - Separatkloakeret: spildevand 8 - Separatkloakeret: tag- og overfladevand 9 - Spildevandskloakeret: Spildevand 10 - Afløb til spildevandsforsyningens renseanlæg; 11 - Afløb til fællesprivat spildevandsanlæg; 12 - Afløb til fællesprivat kloakledning med tilslutning til spildevandsforsyningens renseanlæg 20 - Afløb til samletank 21 - Afløb til samletank for toiletvand og mekanisk rensning af øvrigt spildevand 29 - Mekanisk rensning med nedsivningsanlæg med tilladelse 30 - Mekanisk rensning med nedsivningsanlæg uden tilladelse 31 - Mekanisk rensning med privat udledn. dir. til vandløb, sø eller hav 32 - Mekanisk og biologisk rensning (ældre anlæg uden renseklasse) 70 - Udledning uden rensning direkte til vandløb, søer eller havet Snitfladebeskrivelse Side 5 af 9
75 - Blandet afløbsforhold på ejendom (er specificeret på bygninger) 80 - Anden type afløb 90 - Ingen udledning 101 - SOP: Minirenseanlæg med direkte udledning 102 - SOP: Minirenseanlæg med udledning til markdræn 103 - SOP: Minirenseanlæg med nedsivning i faskine 104 - SOP: Nedsivning (med tilladelse) 105 - SOP: Samletank 106 - SOP: Pileanlæg med nedsivning (uden membran) 107 - SOP: Pileanlæg uden udledning (med membran) 201 - SO: Biologisk sandfilter med direkte udledning 202 - SO: Biologisk sandfilter med udledning til markdræn 203 - SO: Minirenseanlæg med direkte udledning 204 - SO: Minirenseanlæg med udledning til markdræn 205 - SO: Beplantede filteranlæg med direkte udledning 206 - SO: Beplantede filteranlæg med udledning til markdræn 301 - OP: Minirenseanlæg med direkte udledning 302 - OP: Minirenseanlæg med udledning til markdræn 401 - O: Rodzoneanlæg med direkte udledning 402 - O: Rodzoneanlæg med udledning til markdræn 403 - O: Minirenseanlæg med direkte udledning 404 - O: Minirenseanlæg med udledning til markdræn 501 - Øvrige: Mekanisk med direkte udledning 502 - Øvrige: Mekanisk med udledning til markdræn 503 - Øvrige: Nedsivning (uden tilladelse) 504 - Øvrige: Udledning til jordoverfladen 505 - Øvrige: Urenset 601 - Anden type afløb (større end 30 PE med egen udledning) 701 - Intet afløb Gennem BuildingDwellingV1 snitfladen kan kun de gamle koder returneres. Hvis en bygning/grund har en af de nye koder, returneres feltet ikke. IKKE til null (som det ellers er konventionen). Feltet opdateres ikke. 2.4. Ændret kodeliste til felt Byggeskadeforsikringsselskab Feltet Byggeskadeforsikringsselskab (BuildingDamageInsuranceCompanyCode) har ændret kodeliste fra version 1 til version 2. Kodeliste i BuildingDwellingV1: 00 - Ingen byggeskadeforsikring 01 - Tryg 02 - Topdanmark 03 - Thisted Forsikring 04 - Codan 05 - If forsikring 06 - Alm. Brand 07 - Danske Forsikring Kodeliste i BuildingDwellingV2: 00 - Ingen byggeskadeforsikring 01 - Tryg 02 - Topdanmark 04 - Codan 05 - If forsikring Snitfladebeskrivelse Side 6 af 9
06 - Alm. Brand 07 - Danske Forsikring 08 - AmTrust International Underwrites Limited Gennem BuildingDwellingV1 snitfladen kan kun de gamle koder returneres. Hvis en bygning har en af de nye koder, returneres feltet ikke. Hvis man prøver at opdatere BuildingDamageInsuranceCompanyCode med kode 3, får man fejl 3381: Kode 3 for Byggeskadeforsikringsselskab/BuildingDamageInsuranceCompanyCode må ikke længere anvendes. IKKE til null (som det ellers er konventionen). Feltet opdateres ikke. 2.5. Ændret placering af feltet Gyldighedsdato Feltet Gyldighedsdato (Assessment ChangedDate) har ændret placering fra version 1 til version 2. Feltet er nu et felt på selve entiteten for følgende entiteter: Grund Bygning Opgang/indgang Etage Enhed Teknisk anlæg Byggesag For de nævnte entiteter er feltet flyttet fra Create/Update inputstrukturerne til entitet strukturerne. Ændringen behøves ikke at blive håndteret. Man skal bare være opmærksom på ændringen når man skifter til version 2 af snitfladen. 2.6. Ændret kodeliste til felt Afvigende etager Feltet Afvigende etager (FloorDeviationStatusIndicator) har en forkert kodeliste i version 1. Feltet er defineret som idikator (bool), men det burde være en kodeliste. Get metoderne leverer true hvis værdien er forskelligt fra 0. Værdien kan ikke indberettes. 2.7. Ændret kodeliste til felt Afløbsforholdtilladelse Feltet Afløbsforholdtilladelse (DrainagePermissionCode) har en forkert kodeliste i version 1. Den har ved en fejl fået samme kodetabel som DrainageCode (afløbsforhold) Get metoderne leverer ikke feltet og værdien kan ikke indberettes. Snitfladebeskrivelse Side 7 af 9
2.8. Ændret kodeliste til felt Offentlig støtte Feltet Offentlig støtte på enhed (PublicSubsideyCode) har en forkert kodeliste i version 1. Der mangler nogle kodeværdier. De rigtige kodeværdier er: 0 Ingen offentlig støtte Boligenheder opført med offentlig støtte: 10 - Almen familiebolig 15 - Støttet privat udlejningsbolig 20 - Støttet privat andelsbolig: 25 - Almen ungdomsbolig 30 - Støttet privat ungdomsbolig 40 - Almen ældrebolig 42 - Almen plejebolig Erhvervsenheder opført med offentlig støtte: 80 Serviceareal De koder som fejlagtig ikke var med i kodelisten returnes ikke for at undgå fejl. Der returneres null istedet for. IKKE til null (som det ellers er konventionen), men feltet opdateres ikke. 2.9. Ændret kodeliste til felt Vandforsyning Feltet Vandforsyning (WaterSupplyCode) har en forkert kodeliste i version 1. Kode 7 (Blandet vandforsyning) mangler. Hvis værdien er 7 i databasen gives der ikke fejl, men der returneres null. IKKE til null (som det ellers er konventionen), men feltet opdateres ikke. 2.10. Ændret kodeliste til felt Kode for lovlig anvendelse af sommerhus til helårsbeboelse Feltet Kode for lovlig anvendelse af sommerhus til helårsbeboelse (LegalUse- Code) har en forkert kodeliste i version 1. Kode I (Ikke relevant for denne enhed) mangler og kode findes ikke i Nyt. Snitfladebeskrivelse Side 8 af 9
Hvis værdien er I i databasen gives der ikke fejl, men der returneres null. IKKE til null (som det ellers er konventionen), men feltet opdateres ikke. Snitfladebeskrivelse Side 9 af 9