Verschillen

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

--- openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten [2024/04/05 12:15] – [Koppelbericht zaakcode bevoegd gezag aan dso-verzoeknummer] Ton Pullens
+++ openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten [2025/05/26 12:28] (huidige) – Externe bewerking 127.0.0.1
@@ Regel 33: / Regel 33: @@
-===== Koppelbericht zaakcode bevoegd gezag aan dso-verzoeknummer =====
+===== Koppelbericht zaakcode bevoegd gezag aan DSO-verzoeknummer =====
-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.\\
+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 om Open Wave 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.30:applicatiebeheer:probleemoplossing:programmablokken:export_documenten_bij_dso_zaak_van_map_naar_dms_bevoegd_gezxag|]]
+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.30:applicatiebeheer:probleemoplossing:programmablokken:export_documenten_bij_dso_zaak_van_map_naar_dms_bevoegd_gezxag|]]
 <code JSON>
 {
@@ Regel 59: / Regel 59: @@
 </code>
-OpenWave zal het dso-vezoeknummer uit het JSON bericht opzoeken in tbomgvergunning.dvlvoaanvraagnummer. Indien er één kandidaat wordt gevonden zal de externe zaakidentifier (de reference) worden geplaatst in de kolom dvzaaknrbevgezag.
+OpenWave zal het DSO-vezoeknummer uit het JSON bericht opzoeken in tbomgvergunning.dvlvoaanvraagnummer. Indien er één kandidaat wordt gevonden zal de externe zaakidentifier (de reference) worden geplaatst in de kolom dvzaaknrbevgezag.
 **LET OP**: OpenWave heeft niet in de hand wanneer dit bericht verzonden wordt: dat kan dus theoretisch gebeuren voordat OpenWave zelf het betreffende DSO-verzoekbericht heeft verwerkt en in dat geval wordt de externe zaakidentifcatie niet gevuld in de kolom dvzaaknrbevgezag. Wel is altijd het bericht terug te lezen in de messagelog: daar kan dan alsnog de reference geknipt en geplakt worden.
 ===== Trigger- of Verzoeknotificatiebericht =====
   Met Stam 4.0 is het begrip trigger veranderd in verzoeknotificatie. Waar u leest triggerbericht kan u hieronder ook verzoeknotificatiebericht lezen.
-Het triggerbericht is vanaf versie 2.0 van de STAM qua inhoud zo beperkt dat OpenWave alleen nog het DSO verzoeknummer uit het triggerbericht opslaat in de tabel tbDSOtrigger (geen userinterface). Vroeger werd het triggerbericht gebruikt om BSN-nummer en KvK- en Vestigingsnummer van de aanvrager en gemachtigde op te slaan in afwachting van het verzoekbericht (in tbDSOtrigger). Bij de verwerking van het verzoekbericht werd vervolgens de tabel geraadpleegd bij het (over)schrijven van de aanvrager en gemachtigde. Dit laatste is dus komen te vervallen per STAM 2.0 versie.
+Het triggerbericht is vanaf versie 2.0 van de STAM qua inhoud zo beperkt dat OpenWave alleen nog het DSO-verzoeknummer uit het triggerbericht opslaat in de tabel tbDSOtrigger (geen userinterface). Vroeger werd het triggerbericht gebruikt om BSN-nummer en KvK- en Vestigingsnummer van de aanvrager en gemachtigde op te slaan in afwachting van het verzoekbericht (in tbDSOtrigger). Bij de verwerking van het verzoekbericht werd vervolgens de tabel geraadpleegd bij het (over)schrijven van de aanvrager en gemachtigde. Dit laatste is dus komen te vervallen per STAM 2.0 versie.
-De registratie van het DSO verzoeknummer in tbDSOtrigger blijft behouden zodat er toch voor ieder nieuw DSO aanvraag een registratie is van het binnengekomen triggerbericht bij OpenWave.
+De registratie van het DSO-verzoeknummer in tbDSOtrigger blijft behouden zodat er toch voor ieder nieuw DSO aanvraag een registratie is van het binnengekomen triggerbericht bij OpenWave.
 De gegevens in deze tabel tbDSOtrigger worden opgeschoond na 31 dagen tenzij anders aangegeven in kolom //Getal1// van de instelling //Sectie: DSO en Item: BewaardagenTabelDsoTrigger//.
@@ Regel 123: / Regel 124: @@
 Het is raadzaam hier zaaktypes voor te definiëren (of bestaande te hergebruiken) in de beheertabel //Zaaktypes omgeving// (tbsoortomgverg). Daartoe is de kolom //Verzoektype// (dvdsotype) in het blok //DSO-type//. OpenWave zal eerst proberen vast te stellen of het DSO verzoekbericht voor een compartiment is bedoeld op grond van de locatie, uitvoerende instantie en bevoegd gezag.
-{{:openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:dsointierenbepalingzaaktypedummyadres.png?900|}}
+{{:openwave:applicatiebeheer:probleemoplossing:programmablokken:dsointierenbepalingzaaktypedummyadres.png?900|}}
 Indien de uitvoerende instantie (behandeldienst) in het verzoekbericht is gevuld dan is het verzoekbericht sowieso niet voor een compartiment, tenzij het gaat om een kopiebericht of tenzij de behandeldienstdienst gelijk is aan bevoegd gezag. Zie hieronder onder kopje //Negeren van binnenkomende kopieberichten in kader afhandelen complexe verzoeken in samenwerkingsverband//.
@@ Regel 218: / Regel 219: @@
 Een BSN-nummer bestaande uit 9 nullen beschouwd OpenWave als leeg.\\
-De gegevens uit blok ''<initiatiefnemer>'' (in OpenWave is dit de aanvrager) 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 = AVR (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. OpenWave kijkt 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. Indien het een natuurlijk persoon betreft (BSN is gevuld), dan wordt op BSN gezocht (indien meer dan 1 gevonden dan diegene met de hoogste dnkey). Geen (unieke kaart) gevonden, dan wordt er een nieuw contactadres aangemaakt. Indien het om een bedrijf gaat dan wordt op vestigingsnummer en/of KvK nummer gezocht waarbij eerst op vestigingsnummer indien gevuld: ook hier geldt indien meer dan 1 gevonden dan diegene met de hoogste dnkey EN waarvoor geldt dat de achternaam LEEG is (achternaam komt namelijk niet mee in het STAM-bericht, er dient dus een leeg contact te zijn voor het bedrijf). Is er geen vestigingsnummer maar wel een KvK-nummer dan wordt op KvK gezocht (ook hier geldt indien meer dan 1 gevonden dan diegene met de hoogste dnkey EN waarvoor geldt dat de achternaam LEEG is).
+Een KvK-nummer bestaande uit 8 nullen beschouwd OpenWave als leeg.\\
+De gegevens uit blok ''<initiatiefnemer>'' (in OpenWave is dit de aanvrager) 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 = AVR (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. OpenWave kijkt 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. Indien het een natuurlijk persoon betreft (BSN is gevuld), dan wordt op BSN gezocht (indien meer dan 1 gevonden dan diegene met de hoogste dnkey). Geen (unieke kaart) gevonden, dan wordt er een nieuw contactadres aangemaakt. Indien het om een bedrijf gaat dan wordt op vestigingsnummer en/of KvK-nummer gezocht waarbij eerst op vestigingsnummer indien gevuld: ook hier geldt indien meer dan 1 gevonden dan diegene met de hoogste dnkey EN waarvoor geldt dat de achternaam LEEG is (achternaam komt namelijk niet mee in het STAM-bericht, er dient dus een leeg contact te zijn voor het bedrijf). Is er geen vestigingsnummer maar wel een KvK-nummer dan wordt op KvK gezocht (ook hier geldt indien meer dan 1 gevonden dan diegene met de hoogste dnkey EN waarvoor geldt dat de achternaam LEEG is).
 Indien geen unieke kaart gevonden wordt, of het gaat om een bedrijf en de achternaam is niet leeg van het contactadres in OpenWave, dan wordt een nieuwe kaart aangemaakt in tbcontactadressen.
+<adm>
+Vanaf versie 1.30.3 geldt dat indien de instelling //Sectie: DSO en Item: AltijdNieuwNNP// is aangevinkt en de initiatiefnemer 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.
+</adm>
 Wat betreft het overnemen/overschrijven van persoonsgegevens (natuurlijk persoon) redeneert OpenWave als volgt:
@@ Regel 271: / Regel 276: @@
 Een BSN-nummer bestaande uit 9 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 vervalln (unieke) kaart in tbcontactadressen. Deze logica is gelijk voor zowel de aanvrager als de gemachtigde.
+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>
+Vanaf versie 1.30.3 geldt dat 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.
+</adm>
 Wat betreft het overnemen/overschrijven van persoons- dan wel bedrijfsgegevens en de adresgegevens redeneert OpenWave hetzelfde als hierboven beschreven bij de initiatiefnemer.
 ==== Activiteiten ====
@@ Regel 386: / Regel 394: @@
   * EN dat OIN-nummer is ongelijk aan de kolom //Tekst// van instelling //Sectie: SWF en Item: OINvanZender// (dit is de OIN van de host: de hoofdorganisatie die OpenWave gebruikt)
   * EN -
-     * indien oin van bevoegdgezag voorkomt in niet-vervallen rij van tboin waarbij tboin.dvgemeenteid verwijst naar een gemeente van een compartiment EN de kolom //dldsoKopieberichtenOpslaan// van dat compartiment heeft **waarde F**
+     * indien OIN van bevoegd gezag voorkomt in niet-vervallen rij van tboin waarbij tboin.dvgemeenteid verwijst naar een gemeente van een compartiment EN de kolom //dldsoKopieberichtenOpslaan// van dat compartiment heeft **waarde F**
      * anders (gaat niet om compartimentszaak) EN de instelling //Sectie: DSO en Item: KopieberichtenOpslaan// is **NIET** aangevinkt is (of bestaat niet)
@@ Regel 392: / Regel 400: @@
 Indien het kopiebericht toch moet worden opgeslagen (Indien geen compartiment en de instelling //Sectie: DSO en Item: KopieberichtenOpslaan// is **WEL** aangevinkt of wel compartiment en //dldsoKopieberichtenOpslaan// heeft **waarde T**), dan krijgt het verzoeknummer de postfix '_KCV'.
-{{:openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:dsozwartegatenenkopieberichten.png?900|}}
+{{:openwave:applicatiebeheer:probleemoplossing:programmablokken:dsozwartegatenenkopieberichten.png?900|}}
@@ Regel 450: / Regel 458: @@
 De verzoek.pdf staat niet in tbomgoloberichten, maar ook deze (altijd de laatste versie) wordt zo nodig opgehaald en geregistreerd.
+Indien de instelling //Sectie: OWB en Item: OphalenDSODocsViaApi// is aangevinkt EN de instelling //Sectie: DocumentRegistreren en Item: AlleOLODSOUploads// is aangevinkt EN de instelling //Sectie: DSO en Item: VerzoekXMLOpslaan// is ook aangevinkt dan wordt het DSOverzoekbericht in diens originele staat bij de desbetreffende zaak opgeslagen, in XML-formaat. Het verzoekbericht zal onder de naam dvdsovolgnr + '-verzoekbericht.xml' opgeslagen worden.
+Dit bestand komt niet voor in tbomgoloberichten maar wordt wel weergegeven in tbbadextupload in het geval dat het niet geplaatst kan worden.
 Voor het kunnen aanroepen van de DSO-verzoekafhandelen-API gelden de volgende voorwaarden:
-  * De OIN van de zender moet bekend zijn: deze wordt eerst opgezocht op basis van uitvoerende instantie: indien deze gevuld wordt de kolom //Tekst// van de instelling //Sectie: SWF en Item: OINvanZender// gebruikt. Anders, indien behandeldienst leeg en bevoegd gezag wel gevuld, dan wordt het OIN-nummer uit tboin van het bevoegd gezag gebruikt. Anders, indien bevoegd gezag en behandeldienst leeg zijn dan wordt het OIN van de zender ook uit tboin gehaald, maar dan op grond van de gemeente waar de zaak speelt.
+  * De OIN van de zender moet bekend zijn: deze wordt eerst opgezocht op basis van behandeldienst/uitvoerende instantie: indien deze gevuld dan wordt het OIN-nummer uit tboin van de uitvoerende instantie gebruikt. Anders, indien behandeldienst leeg en bevoegd gezag wel gevuld, dan wordt het OIN-nummer uit tboin van het bevoegd gezag gebruikt. Anders, indien bevoegd gezag en behandeldienst leeg zijn dan wordt het OIN van de zender ook uit tboin gehaald, maar dan op grond van de gemeente waar de zaak speelt.
   * VarAlgemeenEndpoint moet gedefinieerd zijn in kolom //Tekst// van //Sectie: DSO-Verzoekafhandelen en Item: AlgemeenEndpoint//.
 Indien er toch nog documenten ontbreken dan kan handmatig de functie //Haal ontbrekende documenten// aangeroepen worden vanuit de lijst met OLO/DSO berichten (tbomgoloberichten). Zie kopje //Haal ontbrekende documenten// bij [[openwave:1.30:applicatiebeheer:probleemoplossing:module_overstijgende_schermen:olo-aim_bijlage_verwijzingen]].
-Met welke attributen een DSO-document wordt geregisteerd in tbcorrespondentie staat onder kopje: //Automatische registratie van document// van [[openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:upload_dso-document_vanuit_digi-koppelaar|]].
+Met welke attributen een DSO-document wordt geregistreerd in tbcorrespondentie staat onder kopje: //Automatische registratie van document// van [[openwave:1.30:applicatiebeheer:probleemoplossing:programmablokken:upload_dso-document_vanuit_digi-koppelaar|]].
 {{tag>openwave:1.29:applicatiebeheer:functionaliteiten:dso}}