Geo-BAG berichtenverkeer 1.1

2.1.2.1 Objecttypen

De volgende BAG-objecttypen worden ondersteund in het Geo-BAG berichtenverkeer: * Pand * Verblijfsobject * Stand-/ligplaats * Woonplaats * Nummeraanduiding[^10] * OpenbareRuimte[^11]

Dit berichtschema’s van van het Geo-BAG koppelvlak zijn daarnaast uitgebreid met de optionele objecttypen OverigGebouwdObject en OverigTerrein voor aansluiting met RSGB. Overig optionele BAG+-objecttypen worden in het Geo-BAG berichtenverkeer niet ondersteund. In de StUF-Geo BAG berichten worden alleen de gegevens opgenomen die noodzakelijk zijn voor een goede verwerking van dit bericht door de ontvanger (zie gegevensmodel in Bijlage 3.).

[^10] Alleen in BAG-kennisgeving, niet in geometrieVerzoek of geometrieLevering.

[^11] Alleen in BAG-kennisgeving, niet in geometrieVerzoek of geometrieLevering.

2.1.2.2 Geometrie

Voor dit koppelvlak geldt dat de geometrie conform de inwinningsregels ten aanzien van nauwkeurigheid en inwinningswijze van de BAG wordt opgenomen. Een BAG-object kan een vlak- of puntgeometrie hebben.

De verplichte geometrie voor een Pand in de BAG is een vlakgeometrie in bovenaanzicht. In het kader van de BGT is Geo ook verantwoordelijk voor de geometrische inwinning van grootschalige topografie. Voor de BGT is de keuze gemaakt om van een pand de geometrie op maaiveldniveau op te nemen. Door modernere bouwvormen komt het daarbij steeds vaker voor dat de geometrie van een pand op maaiveldniveau aanzienlijk kan afwijken van de geometrie van een pand op een ander niveau. De geometrie op maaiveld van een Pand kan in de StUF-BG kennisgevingsberichten als optionele geometrie bij dit object worden opgenomen naast de verplichte geometrie van bovenaanzicht.

• In dit koppelvlak wordt in de StUF-Geo BAG dienstberichten[^12] de geometrie van objecten als volgt opgenomen: objecttype Verblijfsobject wordt uitgewisseld met puntgeometrie, en optioneel met vlakgeometrie.

• objecttype Pand wordt uitgewisseld met geometrie van het bovenaanzicht, en optioneel met geometrie op het maaiveld.

• alle overige objecttypen[^13] in §2.3.1. met vlakgeometrie.

[^12] Dus niet van toepassing voor de StUF-BG kennisgevingsberichten.

[^13] M.u.v. Nummeraanduiding en OpenbareRuimte, deze objecttypen hebben geen geometrie.

2.1.2.3 Samengesteld uitwisselen en alleen actuele stand

In de StUF-Geo BAG berichten worden de gegevens van objecten samengesteld uitgewisseld, d.w.z. een geometrieVerzoek of geometrieLevering bevat de gegevens van één of meerdere BAG-objecten welke tot één bepaalde transactie of gebeurtenis behoren. Bijvoorbeeld, indien een door Geo uitgevoerde mutatiesignalering uit luchtfoto’s mutaties oplevert op meerdere objecten, worden een of meer mutaties van deze objecten in een bericht (geometrieLevering) door Geo aan BAG verstuurd.

In dit Geo-BAG berichtenverkeer wordt in een StUF-Geo BAG dienstbericht[^14] alleen de actuele stand (WORDT) van een BAG-object uitgewisseld, en niet in combinatie met de vorige stand (WAS) van het BAG-object[^15]. Zowel BAG als Geo hebben de gegevens van een vorige stand van een object niet nodig voor het overnemen van de gegevens uit een bericht. In het bijzonder geval dat op enig moment de gegevens van een bepaald object bij Geo en BAG verschillen (asynchroniteit), zijn de gegevens van de actuele stand in de applicatie van BAG leidend voor dit object.

[^14] Dus niet van toepassing voor de StUF-BG kennisgevingsberichten.

[^15] Dit in afwijking van het StUF-BG en StUF-Geo IMGeo berichtenverkeer waar in een bericht WAS én WORDT van een object wordt uitgewisseld.

2.1.4.1 Logistieke en functionele identificatie

In het Geo-BAG berichtenverkeer wordt onderscheid gemaakt tussen logistieke identificaties en functionele (of logische) identificaties in berichten.

Logistieke identificatie is de unieke identificatie van een bericht. De logistieke identificatie wordt opgenomen in het element ‘referentienummer’ in de ‘stuurgegevens’ van vrije berichten, en in het element ‘crossRefNummer’ van responsberichten.

Een functionele identificatie is een identificerend kenmerk dat hoort bij meerdere berichten behorende bij één mutatie/transactie bundelt. De functionele identificatie wordt opgenomen het element ‘idLevering’, ‘idVerzoek’ of ‘identificatie’ van de ‘parameters’.

De functionele identificatie wordt gebruikt om berichten die bij een zelfde gebeurtenis (vergunning of signalering) horen te bundelen. Bijvoorbeeld, bij het verlenen van een bouwvergunning door BAG zijn er meerdere berichten voor het opvoeren van een pand en verblijfsobject. Of na mutatiesignalering door Geo worden meerdere berichten met constateringen van panden verstuurd. Deze berichten hebben een eigen unieke logistieke identificatie, maar worden gebundeld door eenzelfde functionele identificatie.

2.1.4.2 Invullen van logistieke en functionele identificaties

Voor het invullen van identificaties in de Geo-BAG berichten gelden de volgende uitgangspunten.

Logistieke identificatie:

• Een afkeuringsbericht of goedkeuringsbericht (=responsbericht Du01) heeft in het crossRefNummer de logistieke identificatie van het geometrieverzoek of de geometrielevering.

Functioneel:

• De identificatie van een geometrieverzoek wordt in de geometrielevering opgenomen in het element ‘idGerelateerdVerzoek’, als de levering is aangemaakt naar aanleiding van een verzoek door BAG.

• Het element ‘idGerelateerdVerzoek’ blijft leeg als de geometrielevering wordt geïnitieerd door Geo, bijvoorbeeld naar aanleiding van een constatering/signalering uit een luchtfoto.

Onderstaande figuur geeft weer hoe de identificaties in Geo-BAG berichten worden doorgegeven.

Voorbeeld logistieke en functionele identificatie in Geo-BAG berichten.

[^19] identificatie is bij geometrieverzoek het element ‘idVerzoek’, bij een geometrielevering het element ‘idLevering’ en bij goed/afkeuringsberichten het element ‘identificatie’ in de parameters.

2.1.4.3 Intrekken en corrigeren van berichten

In het StUF-Geo BAG berichtenverkeer kan het voorkomen dat BAG of Geo een eerder verstuurd StUF-Geo BAG bericht wil corrigeren of intrekken. Een bericht kan door zender worden gecorrigeerd of ingetrokken indien deze nog niet door ontvanger is afgehandeld, d.w.z.

• Als BAG nog geen goed- of afkeuringsbericht op het geometrieverzoek van Geo heeft ontvangen.

• Als Geo nog geen goed- of afkeuringsbericht op de geometrielevering van BAG heeft ontvangen.

Voor het intrekken van een StUF-Geo BAG bericht wordt een nieuw bericht gestuurd met daarin opgenomen een eigen unieke logistieke identificatie en een functionele identificatie gelijk aan de functionele identificatie van het in-te-trekken bericht.

Voor het corrigeren van een StUF-Geo BAG bericht wordt eerst het vorige bericht ingetrokken en vervolgens een nieuw bericht met een nieuwe functionele identificatie verstuurd.

Voorbeeld intrekken en corrigeren geometrielevering[^20]

In onderstaand voorbeeld wordt de eerste geometrielevering door BAG goedgekeurd en wordt de intrekking van de geometrielevering door BAG afgekeurd. BAG heeft daarmee de gegevens uit de geometrielevering geaccepteerd en zal deze gegevens verder gaan verwerken.

Voorbeeld goedkeuring op geometrielevering, afkeuring op intrekken geometrielevering door BAG[^20]

In onderstaand voorbeeld wordt de eerste geometrielevering door BAG afgekeurd en wordt de intrekking van de geometrielevering door BAG goedgekeurd. BAG heeft daarmee de gegevens uit de geometrielevering niet geaccepteerd en zal dus geen gegevens van Geo gaan verwerken.

Voorbeeld afkeuring op geometrielevering, goedkeuring op intrekken geometrielevering door BAG[^20]

[^20] Op vergelijkbare wijze worden de identificaties ingevuld voor intrekken en corrigeren van geometrieverzoeken door BAG, en het goedkeuren/afkeuren hiervan door Geo.

2.1.5.1 BAG-objectnummer en versie

Elk object in de BAG heeft een unieke aanduiding bestaande uit een identificatie (ookwel: objectnummer) en versie. Met deze unieke aanduiding is (deze versie van) het object ook bekend in de Landelijke Voorziening BAG zodra het authentiek is verklaard.

2.1.5.2 Technische sleutels

In het Geo-BAG berichtenverkeer worden ook in bepaalde gevallen de technische (system of database)sleutels van Geo en BAG uitgewisseld. De technische sleutels van de zender en ontvanger worden uitgewisseld in de attributen sleutelVerzendend en sleutelOntvangend.

2.1.5.3 Invullen van BAG-objectnummer en technische sleutels

Het opnemen van het BAG-objectnummer (en versie) bij een object is verplicht, tenzij voor het object nog geen BAG-objectnummer is uitgedeeld. Dit treedt op in de volgende twee situaties:

• Bij het versturen van een geometrieVerzoek na gebeurtenis ‘BGR-OBA Ontvangst bouwaanvraag’, waarbij het object nog niet is opgenomen in de applicatie van BAG.

• Bij het versturen van een geometrieLevering na gebeurtenis ‘GEO-COG Constatering nieuw object’ (bijvoorbeeld bij vergunningsvrije bouw) waarbij het object ontstaat in de applicatie van Geo. Geo deelt namelijk geen BAG-identificaties uit.

Voor het invullen van BAG-objectnummer en technische sleutels in Geo-BAG berichten gelden de volgende uitgangspunten:

• Als het BAG-objectnummer bij BAG bekend is, stuurt BAG deze mee én de technische systeemsleutel van BAG.

• Als het BAG-objectnummer bij Geo bekend is, dan stuurt Geo de BAG identificatie én de technische systeemsleutel van Geo mee.

Voorbeeld BAG-objectnummer bij BAG of Geo bekend.

• Als het BAG-objectnummer bij BAG niet bekend is, stuurt BAG alleen de technische systeemsleutel van BAG.

• Als het BAG-objectnummer bij Geo niet bekend en het object is opgenomen in een geometrielevering op een geometrieverzoek van BAG, stuurt Geo de technische sleutel van BAG en Geo mee.

Voorbeeld geometrieverzoek zonder BAG-objectnummer en geometrielevering door Geo met technische sleutels.

• Als het BAG-objectnummer bij Geo niet bekend en het object is opgenomen in een goedkeuring of afkeuring op een geometrieverzoek van BAG, stuurt Geo alleen de technische sleutel van BAG mee.

Voorbeeld BAG-objectnummer bij BAG niet bekend, en goed-/afkeuring door Geo

• Als het BAG-objectnummer bij BAG niet bekend en het object is opgenomen in een afkeuring op een geometrielevering van Geo, stuurt BAG alleen de technische sleutel van Geo mee.

Voorbeeld BAG-objectnummer niet bekend, en afkeuring van geometrielevering door BAG

• Als het BAG-objectnummer bij BAG niet bekend en het object is opgenomen in een goedkeuring op een geometrielevering van Geo, stuurt BAG het nieuwe BAG-objectnummer en de technische sleutel van Geo mee.

Voorbeeld BAG-objectnummer niet bekend, en goedkeuring van geometrielevering door BAG

2.1.6.1 Transacties en bundeling van berichten

Bij bepaalde gebeurtenissen (bijv. bij het verlenen van een bouwvergunning voor een pand met meerdere verblijfsobjecten en nummeraanduidingen) komt het voor dat gegevens van meerdere objecten uitgewisseld gaan worden. Per transactie[^23] wordt een StUF-Geo BAG bericht met een eigen logistieke identificatie en een gemeenschappelijke functionele identificatie (betreffende de gebeurtenis ‘bouwvergunning verleend’) voor deze transactie samengesteld en in willekeurige volgorde verstuurd. Het is niet de bedoeling om bijvoorbeeld in één geometrieverzoek voor alle objecten die op die dag zijn opgevoerd in het hele gebied van een gemeente de geometrie te vragen. De eenheid van werk dient zo klein mogelijk gehouden te worden aan de ontvangende kant, om snelle afhandeling van een verzoek of levering mogelijk te maken.

[^23] Een transactie is een samenstelling / bundeling van (gewijzigde) gegevens van één of meer objecten wat tot een bepaalde gebeurtenis of eenheid van werk toebehoord.

2.1.6.2 Verplichte of niet-verplichte overname

De gegevens van een object in het StUF-Geo BAG berichtenverkeer welke worden uitgewisseld met asynchrone kennisgevingsberichten kunnen verplicht zijn om te verwerken in de ontvangende applicatie of informatief bedoeld zijn. Of een BAG-kennisgeving in een bericht verplicht of informatief is, wordt opgenomen in de parameter met resp. “V” (Verplicht) of “I” (Informatief).

Voor het Geo-BAG berichtenverkeer heeft een BAG-kennisgeving een indicatorOvername “V” (Verplicht), omdat BAG eindverantwoordelijk is voor de (kwaliteit van) gegevens van de BAG-objecten. Geo neemt de gegevens van BAG verplicht over in de eigen registratie.

In een StUF-Geo BAG bericht komt het element indicatorOvername niet voor, omdat geen gebruik wordt gemaakt van kennisgevingen24 maar van elementen met een StUF:functie:”entiteit” (hierna: entiteit. De objectgegevens in een geometrieLevering of geometrieVerzoek zijn niet verplicht om over te nemen, en dienen enkel ter identificatie van het object waarvoor geometrie wordt gevraagd of geleverd.

[^24] Dit omdat alleen de actuele stand van een object wordt uitgewisseld en geen WAS/WORDT structuur.

2.1.6.3 Volgorde van verzenden en verwerken

Het verzenden van een bericht wordt geïnitieerd door zender en is eenrichtingsverkeer (push-mechanisme). De zendende applicatie kan meerdere berichten achter elkaar versturen, waarbij een volgend bericht niet per sé verzonden wordt na bevestiging van ontvangst van het vorige bericht.

De ontvanger bevestigt te allen tijde de ontvangst van een bericht met een technisch synchrone respons t.b.v. de logistiek (Bv03/Bv04 of Fo03). Als op een bericht binnen een bepaalde termijn geen bevestiging van ontvangst is teruggekomen, mag de zender veronderstellen dat het bericht niet is aangekomen. Omdat het de verantwoordelijkheid van zender is dat berichten ‘aankomen’, dient de zender opnieuw het bericht te versturen aan ontvanger.

De afhandeling van het bericht door ontvanger is asynchroon, d.w.z. dat het ontvangen bericht op later moment (dus niet gelijk = synchroon) verwerkt wordt. De berichten in de wachtrij van de ontvangende applicatie worden conform StUF verwerkt, ofwel: op volgorde van tijdstipBericht.

2.1.6.4 Synchroniteit

Op bepaalde momenten kunnen de gegevens van BAG-objecten in de applicaties van BAG en Geo tijdelijk uit elkaar lopen (bijv. na afwijzing van een nieuw geconstateerd Pand in een levering van Geo welke na beoordeling door BAG een niet-relevant BAG-object blijkt te zijn, dus geen BAG-Pand). Geo is verantwoordelijk voor de synchronisatie van de eigen applicatie met BAG voor o.a. overname van gegevens bij het BGT-object Pand.