Verschillen

Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.

--- openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten [2025/08/25 14:07] – Ton Pullens
+++ openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten [2025/09/21 13:05] (huidige) – Kars Gottschal
@@ Regel 37: / Regel 37: @@
 Via de digi-koppelaar (Jnet/EnableU) kan een bericht doorgegeven worden in eigen JSON-formaat waarin een externe zaakidentifier (requestor-reference) en een DSO-verzoeknummer is opgenomen.\\
 Het doel van dit bericht is om OpenWave te laten weten onder welke zaakcodering het DSO-verzoek bij het bevoegd gezag is aangemaakt, zodat OpenWave na de behandeling van datzelfde DSO-verzoek door de omgevingsdienst, de van belang zijnde documenten kan exporteren naar dat bevoegd gezag. Zie: [[openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:export_documenten_bij_dso_zaak_van_map_naar_dms_bevoegd_gezxag]]
-<code JSON>
+<code json>
 {
     "casetype_id": "f8285eb3-6fd2-4b9a-8663-dfd0df9767af",
@@ Regel 76: / Regel 77: @@
 ===== Verplichte instellingen =====
-  * In de beheertabel //Adressoorten/rollen// dient exact één kaart te bestaan waarbij het vakje //Is rol voor contactpersoon uit verzoekbericht DSO// (tbadressoort.dldsorolcontactpers) aangevinkt is. Deze rol is bedoeld voor de contactpersoon uit het DSO-verzoekbericht.
+  * In de beheertabel //Adressoorten/rollen// dient exact één kaart te bestaan waarbij het vakje //Is rol voor contactpersoon uit verzoekbericht DSO// (tbadressoort.dldsorolcontactpers) aangevinkt is. Deze rol is bedoeld voor de contactpersoon uit het DSO-verzoekbericht. Geldt niet meer voor STAM 6.
   * In de beheertabel //Adressoorten/rollen// dient exact één kaart te bestaan met code //AVR// die gebruikt wordt als aanvrager (initiatiefnemer).
   * In de beheertabel //Adressoorten/rollen// dient exact één kaart te bestaan met code //GEM// die gebruikt wordt als gemachtigde.
@@ Regel 91: / Regel 92: @@
 <adm STAM 5 versus STAM 4>
-Met STAM 5.0 is het een en ander veranderd qua inhoud van tag <doel>, is tag <type> hergebruikt voor een nieuwe toevoeging en is er een tag bijgekomen: <plicht>. In tag <plicht> staan de waardes die in STAM 4 nog bij tag <type> werden gebruikt. \\
+Met STAM 5.0 is het een en ander veranderd qua inhoud van tag ''<doel>'', is tag ''<type>'' hergebruikt voor een nieuwe toevoeging en is er een tag bijgekomen: ''<plicht>''. In tag ''<plicht>'' staan de waardes die in STAM 4 nog bij tag ''<type>'' werden gebruikt.
 Onderstaand wordt de verwerking uitgelegd voor zowel STAM 4 als 5. In de praktijk zal er qua instellingen en verwerking niets veranderen voor STAM 5 en hoeft men alleen voor VerkenUwIdee een nieuw zaaktype aan te wijzen.
 </adm>
-Uit de tag <doel> wordt bepaald of het bericht gaat over Initiëren (STAM 4)/Indienen (STAM 5), Conceptverzoek (alleen STAM 4), Aanvullen of Intrekken. In STAM 5 is er nieuwe tag <type> aanwezig met mogelijke waardes: Concept, Definitief, Idee. Het type geeft aan of het om een Conceptverzoek, Definitieve aanvraag of een VerkenUwIdee gaat.
+Uit de tag ''<doel>'' wordt bepaald of het bericht gaat over Initiëren (STAM 4)/Indienen (STAM 5), Conceptverzoek (alleen STAM 4), Aanvullen of Intrekken. In STAM 5 is er nieuwe tag ''<type>'' aanwezig met mogelijke waardes: Concept, Definitief, Idee. Het type geeft aan of het om een Conceptverzoek, Definitieve aanvraag of een VerkenUwIdee gaat.
   * Indien **Aanvullen** dan wordt de kaart gezocht in tbomgvergunning met dvlvoaanvraagnr = verzoeknummer. Indien niet gevonden of er zijn meerdere kaarten gevonden met hetzelfde verzoeknummer dan wordt de verwerking gestopt (zie kolom //Error// in messagelog). Indien wel gevonden dan wordt een kaartje aangemaakt in tbomgdsoaanvulintrek bij de betreffende omgevingszaak (deze tabel is zichtbaar als lijstje in detailscherm omgevingszaak in blok **DSO-aanvullingen**) met het volgnummer en doel.
       * Uitzondering: indien niet gevonden maar instelling //Sectie: DSO, Item: AanvullingTotNieuweZaak// is aangevinkt (default false) dan wordt er wel een nieuwe zaak aangemaakt. Dit kan men zo instellen om de DSO verzoeken tot een nieuwe zaak te verwerken in OpenWave waarop al 1 of meer aanvullingen zijn, die pas na het wijzigen van bevoegd gezag bij de organisatie binnenkomen. In dit geval stuurt het DSO alleen de laatste Aanvulling naar de organisatie. Als de instelling aan staat zal er een nieuwe zaak worden aangemaakt conform werking zoals beschreven op deze pagina (doel blijft //Aanvullen//). Daarnaast wordt een record in tbomgdsoaanvulintrek bij de nieuwe omgevingszaak aangemaakt. Mocht er ingesteld staan dat er automatisch een DSO ontvangstbevestigingsmail verstuurd moet worden dan zal deze van sjabloon Aanvulling zijn.
@@ Regel 203: / Regel 204: @@
-==== Contactpersoon (ALLEEn STAM 4/5 OF OUDER)====
+==== Contactpersoon ====
 <adm warning>
-Niet te verwarren met Initiatiefnemer of Gemachtigde: het gaat hier om hoe OpenWave de gegevens verwerkt uit het blok **Contactpersoon** indien aanwezig in het STAM-bericht. Halverwege de verschijningsperiode van STAM 5 is dit blok contactpersoon uit de verzoek.xml gehaald.
+Niet te verwarren met Initiatiefnemer of Gemachtigde: het gaat hier om hoe OpenWave de gegevens verwerkt uit het blok **Contactpersoon** indien aanwezig in het STAM-bericht. Halverwege de verschijningsperiode van STAM 5 is dit blok contactpersoon uit de verzoek.xml gehaald.\\
+Dus zit niet meer in verzsoek.xml van STAM 6.
 </adm>
@@ Regel 224: / Regel 226: @@
   * als blok ''<buitenlandsAdres>'' bestaat EN de waarde van tbcontactadressen.dvbuitenladresregel1 is leeg dan worden de buitenlandadresgegevens overschreven met de gegevens uit dit blok.
-==== Initiatiefnemer (ALLEEN STAM 5 of ouder)====
+==== Initiatiefnemer ====
+<adm warning>
+Alleen STAM 5 of ouder. Is in STAM 6 vervangen door blok <betrokkene>
+</adm>
 //Bij Initiëren/Indienen en Conceptverzoek en Aanvullen//
@@ Regel 280: / Regel 284: @@
-==== Gemachtigde (ALLEEN STAM 5 of ouder) ====
+==== Gemachtigde ====
+<adm warning>
+Alleen STAM 5 of ouder. Is in STAM 6 vervangen door blok <betrokkene>
+</adm>
 //Bij Initiëren, Indienen en Conceptverzoek en Aanvullen//
-Een BSN-nummer bestaande uit 9 nullen beschouwd OpenWave als leeg.\\
+Een BSN-nummer bestaande uit 9 nullen beschouwd OpenWave als leeg.
-Een KvK-nummer bestaande uit 8 nullen beschouwd OpenWave als leeg.\\
+Een KvK-nummer bestaande uit 8 nullen beschouwd OpenWave als leeg.
 De gegevens uit blok ''<gemachtigde>'' worden aangevuld of nieuw aangemaakt in de tabel tbcontactadressen (omgevingstegel //Contactadressen//). De relatie tussen het contactadres en de omgevingszaak ligt in de dochtertabel tbomgvergcontactennn op de kaart met dvcodeadressoort = GEM (zie hierboven bij verplichte instellingen). Bij **Aanvullen** kijkt OpenWave of deze relatie in tbomgvergcontactennn reeds bestaat. Zo ja dan worden de contactgegevens zo mogelijk aangepast in de betrokken adreskaart van tbcontactadressen. Zo nee, - of het gaat om **Initiëren of Vooroverleg** - , dan zal een nieuwe relatie gelegd moeten worden naar een nieuw aan te maken of reeds bestaande adreskaart in OpenWave. Net als bij de Aanvrager kijkt OpenWave in het STAM-bericht naar de aanwezigheid van BSN, KvK-nummer of vestigingsnummer en zoekt daarmee naar een bestaande, niet vervallen (unieke) kaart in tbcontactadressen. Deze logica is gelijk voor zowel de aanvrager als de gemachtigde.
 Dus alleen indien er geen unieke kaart gevonden wordt, of het gaat om een bedrijf en de achternaam is niet leeg van de contact in OpenWave, dan wordt een nieuwe kaart aangemaakt in tbcontactadressen.
 <adm Altijd nieuw Niet Natuurlijk Contact aanmaken?>
 Indien de instelling //Sectie: DSO en Item: AltijdNieuwNNP// is aangevinkt en de gemachtigde is een niet natuurlijk persoon (KvK- dan wel vestigingsnummer is gevuld) dan zal er altijd een nieuw contactadres aangemaakt worden in OpenWave. Deze instelling kan gebruikt worden ter voorkoming van overschrijven van niet natuurlijk contactpersonen in OpenWave.
@@ Regel 294: / Regel 306: @@
 Wat betreft het overnemen/overschrijven van persoons- dan wel bedrijfsgegevens en de adresgegevens redeneert OpenWave hetzelfde als hierboven beschreven bij de initiatiefnemer.
-==== Betrokkene (ALLEEN VANAF STAM 6er)====
+==== Betrokkene ====
 //Bij Initiëren/Indienen en Conceptverzoek en Aanvullen//
+Het blok <betrokkene> is voorzien van het atribuut //rol//
+De betrokkene kan de rol initiatiefnemer hebben en de rol gemachtigde.
+Voor beide rollen is onderstaande proceslogica gelijk.
+<adm warning LET OP >
+Veel tags onder het blok <betrokkene> kunnen twee keer voorkomen (hoeft dus niet). Als een tag twee keer voorkomt dat is daar het attribuut bron bijgevoegd, namelijk bron = “DSO-LV” wil zeggen: zo staat het in de basisregistratie OF  bron = “gebruiker” wil zeggen dat de aanvrager het gegeven heeft overschreven\\
+In het geval dat een tag 2 x voorkomt dan redeneert Openwave vanuit de tag met attribuut bron = “gebruiker”.
+</adm>
+De betrokkene kan een natuurlijk persoon zijn:  het blok <betrokkeneNP>
+  * achternaam
+  * voorvoegesel
+  * tussenviegesl
+  * bsn
+  * geboortedatum
+Of een NIET natuurlijk persoon : het blok <betrokkeneNNP>
+  * handelsnaam
+  * kvknummer
+  * vestigingsnummer
+  * rsin
+De betrokkene kan één of meer adreskanalen hebben in het blok <kanaal>
+  * ''<binnenlandsAdres>''
+     * huisletter
+     * huisnummer
+     * huislnummertoevoeging
+     * postcode
+     * straatnaam
+     * woonplaatsnaam
+  * buitenlandsAdres
+     * adresBuitenland1
+     * adresBuitenland2
+     * adresBuitenland3
+     * land
+  * postbusnummer
+    * nummer
+    * postcode
+    * woonplaatsnaam
+  * antwoordnummer
+    * nummer
+    * postcode
+    * woonplaatsnaam
+Daarnaast kunnen bij de betrokkene drie extra contacgegevens worden opgegeven in het blok <kanaal> met het atribuut doel="vragen'
+  * emailadres
+  * telefoonnummer
+  * contact
+Een BSN-nummer bestaande uit 9 nullen beschouwt OpenWave als leeg.
+Een KvK-nummer bestaande uit 8 nullen beschouwt OpenWave als leeg.
+Een vestigingsnummer bestaande uit 12 nullen beschouwt OpenWave als leeg.
+Een rsin bestaande uit 9 nullen beschouwt OpenWave als leeg.
+Bovenstaande gegevens uit blok <betrokkene> worden aangevuld of nieuw aangemaakt in de tabel tbcontactadressen (omgevingstegel //Contactadressen//).\\
+De relatie tussen het contactadres en de omgevingszaak ligt in de dochtertabel tbomgvergcontactennn op de kaart met dvcodeadressoort = //GEM// (indien rol = gemachtigde) of //'AVR// (indien rol = initiatiefnemer).
+Bij **Aanvullen** kijkt OpenWave of deze relatie in tbomgvergcontactennn reeds bestaat. Zo ja dan worden de contactgegevens zo mogelijk aangepast in de betrokken adreskaart van tbcontactadressen. Zo nee, - of het gaat om **Initiëren of Vooroverleg** - , dan zal een nieuwe relatie gelegd moeten worden naar een nieuw aan te maken of reeds bestaande adreskaart in OpenWave. \\
+OpenWave zoekt naar de aanwezigheid van respectievelijk BSN, vestigingsnummer, RSIN en KvK-nummer in de bestaande niet vervallen kaarten van tbcontactadressen. Voor controle bij de NNP-nummers geldt ook nog dat de achternaam leeg moet zijn: dus geen persoon gekoppeld aan dat contactadres. Deze logica is gelijk voor zowel de aanvrager als de gemachtigde.
+Indien geen gegadigde wordt gevonden dan wordt een nieuwe kaart aangemaakt in tbcontactadressen.
+<adm Altijd nieuw Niet Natuurlijk Contact aanmaken?>
+Indien de instelling //Sectie: DSO en Item: AltijdNieuwNNP// is aangevinkt en de betrokkene is een niet natuurlijk persoon (KvK- dan wel vestigingsnummer dan wel rsin is gevuld) dan zal er altijd een nieuw contactadres aangemaakt worden in OpenWave. Deze instelling kan gebruikt worden ter voorkoming van overschrijven van niet natuurlijk contactpersonen in OpenWave.
+</adm>
+Bij de bestaande of nieuwe relatie in tbomgvergcontactennn worden de drie extra vraag-contactgegevens opgenomen onder de kolommen dvvraagcontact, dvvraagemail en dvvraagtelefoon.
+In de view vwfromgcontacten tbv de contactenlijst op het scherm MDLC_geefOmgContactenOverzicht.xml zijn deze drie kolommen dvvraagcontactmet, dvvraagemail en dvvraagtelefoon opgenomen waarbij geldt dat  de schermkolom
+  * voor vragen wordt gevuld met  dvvraagcontactmet en dus ook leeg kan zijn
+  * email wordt gevuld met  dvvraagemail, maar als deze leeg is met de email van het contactadres
+  * telefoon wordt gevuld met dvvraagtelefoon, maar als deze leeg is met de telefoon cq mobiel van het contactadres.
+De binnenlandse adresgegevens komen in OpenWave in tbcontactadressen onder het blok verblijfs/bezoekadres.\\
+De buitenlandse adresgegevens komen in OpenWave in tbcontactadressen onder het blok adres buitenland.\\
+De postbus en antwoordnummers komen in OpenWave in tbcontactadressen onder het blok posadres, waarbij
+  * Indien instelling //Sectie = koppelingnhr en Item = postbusnrinhuisnr// bestaat EN aangevinkt is dan wordt de straatnaam: //postbus cq antwoordnummer// en komt het nummer zelf in de huisnummer, en anders komt in de straatnaam //postbus cq antwoordnummer// direct gevolgd door het nummer zelf (en blijft huisnummer leeg)
+  * het antwoordnummer prioriteit krijgt boven het postbusnummer indien beiden zijn gevuld.
+Indien
+  * de instelling //Sectie: DSO-Verzoekafhandelen Item: Ontbrekendpostadresvullenmetvestiging// aangevinkt is.
+  * EN de straatnaam van het postadres in OpenWave is leeg (dvstraatnaam)
+dan worden de postadresgegevens overschreven met die van het vestigingsadres.
 ==== Activiteiten ====
@@ Regel 314: / Regel 407: @@
   * Meldingplicht dan met 'M'
   * Aanvraag vergunning dan met 'V'
 === Specificaties (vragen en antwoorden per activiteit)===
@@ Regel 354: / Regel 446: @@
   dnkeytoestemmingen from tbdsospecificaties where dnkey = %keypointer%)) limit 1
 </code>
   * //Kolomnaam1// moet gevuld worden met de kolomnaam waar het wegnummer in moet komen: //dvwegnummer//
   * //Waarde1// moet gevuld worden met het antwoord uit het DSO-bericht: //%dvdsoantwoord%//