openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:dso_gemiste_verzoeken

Verschillen

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

Link naar deze vergelijking

Beide kanten vorige revisie Vorige revisie
Volgende revisie		 Vorige revisie
openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:dso_gemiste_verzoeken [2025/07/01 10:55] – verwijderd - Externe bewerking (Ongeldige datum) 127.0.0.1openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:dso_gemiste_verzoeken [2025/08/11 13:48] (huidige) – Marc Pullens
Regel 1: Regel 1:
 +====== DSO Gemiste Verzoeken ======
 +
 +De lijst met DSO gemiste verzoeken is zichtbaar via de tegel //DSO gemiste verzoeken// in de kolom Notificaties van het servicecentrum-portaal. De lijst wordt getoond op basis van de tabel //tbgemisteverzoeken//. De lijst bevat DSO-zaken (STAM-berichten) die, op grond van bevoegd gezag of behandeldienst, aanwezig zouden moeten zijn in de OpenWave-implementatie, maar nog niet zijn opgehaald of verwerkt.
 +
 +De tabel wordt periodiek aangevuld (indien zo ingesteld via de Taskscheduler in het beheerportaal-nieuw: kolom: //Dieper beheer//) door de aanroep van de callable //importDSOGemisteVerzoeken//.
 + 
 +Voor het ophalen van gerelateerde verzoeken bij een omgevingzaak (verzoeken die door een ander bevoegd gezag of behandeldienst worden behandeld, maar wel spelen op dezelfde locatie): Zie: [[openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:dso_gerelateerde_zaken]].
 +
 +===== Ophalen en verwerken gemiste verzoeken =====
 +
 +==== Noodzakelijke instellingen: ====
 +  * Algemeen endpoint van de DSO-API verzoekafhandelen. Gedefinieerd in de instelling kolom //Tekst// van //Sectie: DSO-VerzoekRaadplegen en Item: AlgemeenEndpoint// bijvoorbeeld: ''https://pkio.service.pre.omgevingswet.overheid.nl/overheid/verzoekenoverzicht/api/raadplegen/v1/'' 
 +  * OIN-nummer(s). De callable werkt op basis van OIN-nummers waarvoor de implementatie bevoegd is. Deze worden samengesteld uit:
 +    * De kolom //Tekst// van instelling //Sectie: SWF en Item: OINvanZender// of
 +    * Eventuele extra OIN-nummers in kolom //Info// van instelling //OINvanZender// (bijv. situatie WDW of BEL-gemeenten), gescheiden door **;** (puntkomma)
 +    * In geval van een compartiment het veld //OIN-nummer van compartiment t.b.v. aanmaken SWF-ruimte? (tbcompartiment.dvswfoinzender)// in detailscherm van de compartimentsinstellingen. Er zijn meerdere mogelijk, ook gescheiden door een **;**.
 +  * Datumrange. Alleen verzoeken worden opgehaald die jonger zijn dan de systeemdatum minus het //Aantal dagen terug// in de kolom //Getal1// van de instelling //Sectie: DSO-Verzoekafhandelen en Item: AantalDagenTerugGemisteVerzoeken//. 
 + 
 +==== Proces ophalen gemiste verzoeken ====
 +
 +De callable importDSOGemisteVerzoeken doorloopt de lijst met OIN-nummers. Voor ieder OIN-nummer wordt een GET-aanroep gedaan op het algemene endpoint. De DSO-API retourneert alle zaakverwijzingen binnen de opgegeven datumrange waarvoor het bevoegd gezag of de behandeldienst overeenkomt met het opgevraagde OIN.
 +
 +De afhandeling door OpenWave per geretourneerde zaakverwijzing is als volgt:
 +  *  Bestaat het verzoeknummer van de geretourneerde zaakverwijzing als zaak in tbomgvergunning
 +      * Zo ja, dan: Gaat het om intrekken of aanvullen?
 +          * Zo ja, Is de omgevingzaak in OpenWave al aangevuld of ingetrokken?
 +              * Zo ja, dan wordt een eventueel voorkomen van de zaakverwijzing in tbgemisteverzoeken verwijderd.
 +              * Zo nee, dan wordt een nieuwe rij aangemaakt in tbgemisteverzoeken mits deze nog niet bestaat.
 +          * Zo nee (wel gevonden en het gaat niet om intrekken of aanvullen), dan wordt een eventueel voorkomen van de zaakverwijzing in tbgemisteverzoeken verwijderd.
 +      * Zo nee, (de zaak bestaat niet in OpenWave), dan\\ Is de behandeldienst van de zaakverwijzing gevuld?
 +          * Zo ja, Komt deze overeen met de kolom //Tekst// van instelling //Sectie: SWF en Item: OINvanZender// (dit is de OIN van de host: de hoofdorganisatie die OpenWave gebruikt)?
 +              * Zo ja, dan wordt een nieuwe rij aangemaakt in tbgemisteverzoeken mits deze nog niet bestaat.
 +              * Zo nee, dan: Is bevoegd gezag gelijk aan behandeldienst ?
 +                 * Zo ja: komt bevoegd gezag dan voor in een van de rijen van tbcompartiment in de kolom tbcompartiment.dvswfoinzender
 +                   * Zo ja, dan wordt een nieuwe rij aangemaakt in tbgemisteverzoeken mits deze nog niet bestaat.
 +                   * Zo nee, dan wordt de geretourneerde zaak genegeerd
 +                 * Zo nee, dan wordt de geretourneerde zaak genegeerd.
 +          * Zo nee (behandeldienst niet gevuld).\\ Komt bevoegd gezag overeen met de kolom //Tekst// van instelling //Sectie: SWF en Item: OINvanZender// (situatie bijv. gemeente Tiel of PNH)?
 +              * Zo ja, dan wordt een nieuwe rij aangemaakt in tbgemisteverzoeken mits deze nog niet bestaat.
 +              * Zo nee, komt bevoegd gezag dan voor in kolom //Info// van instelling //Sectie: SWF en Item: OINvanZender// (situatie bijv. samenwerkingsverband BEL-gemeentes)?
 +                  * Zo ja, dan wordt een nieuwe rij aangemaakt in tbgemisteverzoeken mits deze nog niet bestaat.
 +                  * Zo nee, komt bevoegd gezag dan voor in een van de rijen van tbcompartiment in de kolom tbcompartiment.dvswfoinzender (situatie bijv. compartiment Over-gemeente)?
 +                      * Zo ja, dan wordt een nieuwe rij aangemaakt in tbgemisteverzoeken mits deze nog niet bestaat.
 +                      * Zo nee, dan wordt de geretourneerde zaak genegeerd.
 +
 +Om dubbele uitvoering van de callable te vermijden wordt bij het starten de //Datum// van de instelling //Sectie: Operations Item: importDSOGemisteVerzoeken// gevuld met timestamp. De kolom //Tekst// met medewerkerscode en //Getal1// met 1. Indien klaar dan wordt //Getal1// weer op null gezet.
 +In de operationslog (servicecentrum-portaal) wordt voortgang en resultaat bijgehouden onder de code: //importDSOGemisteVerzoeken//. De vraag-en antwoordberichten naar en van het DSO worden gelogd indien zowel //Sectie: OWB en Item: MessageLog// aangevinkt is als de instelling //Sectie: DSO-Verzoekafhandelen en Item: MessageLog//. 
 +
 +===== Ophalen en verwerken STAM-bericht van gemist verzoek =====
 +
 +Onderaan de lijst met opgehaalde gemiste verzoeken bestaat de knop //Maak zaak van gemist verzoek//. De actie slaat op de actieve regel. OpenWave vraagt het STAM-bericht van het gemiste verzoek op en verwerkt deze tot een omgevingzaak in OpenWave (in de OpenWave API: //VerwerkDSOstambericht//). 
 +
 +**Noodzakelijke instellingen**
 +  * Algemeen endpoint van de DSO-API verzoekafhandelen. Gedefinieerd in de instelling kolom //Tekst// van //Sectie: DSO en Item: DSO-Verzoekafhandelen// bijvoorbeeld: ''https://pkio.service.pre.omgevingswet.overheid.nl/overheid/verzoeken/api/afhandelen/v3''
 +  * OIN-nummer dat hoort bij de OpenWave implementatie dat gewhitelist is op het REM-certificaat waarmee de DSO API-aanroep wordt geautoriseerd. De kolom //Tekst// van instelling //Sectie: SWF en Item: OINvanZender// of, in geval van compartiment het veld //OIN-nummer van compartiment t.b.v. aanmaken SWF-ruimte?
 +// in detailscherm van compartimentsinstellingen. 
 +    * Let op: het kan zijn dat er een andere OINvanZender van toepassing is, dit indien er met meer dan 1 organisatie wordt gewerkt in OpenWave;
 +        * kolom //Info// van instelling //Sectie: SWF en Item: OINvanZender// bevat 1 of meer OIN-nummers gescheiden door ; 
 +        * en/of er bij het compartiment meer dan 1 OIN nummer bestaat: veld //OIN-nummer van compartiment t.b.v. aanmaken SWF-ruimte?// bevat meer dan 1 OIN-nummer gescheiden door ;
 +    *  Indien er meer dan 1 OIN is waarvoor men Gemiste verzoeken wilt ophalen zal er bij het starten van de wizard gevraagd worden namens welke organisatie het gemiste verzoek opgehaald moet worden.
 +  * Gewenste STAM versie van het op te halen Gemiste verzoek (vanaf 1.31). Gedefinieerd in de instelling kolom //Tekst// van //Sectie: DSO-VerzoekAfandelen en Item: STAMVersie//. Wordt bij de update naar 1.31 aangemaakt met //Tekst// = **4**. Dat betekent dat STAM 4 wordt gevraagd. Als men over is naar STAM 5 dan kan daarna deze instelling gewijzigd worden naar //Tekst// = **5**. Indien deze instelling niet bestaat dan wordt door DSO het gemiste verzoek in de oudst geldende versie van STAM meegegeven. Huidig is dat STAM 4. 
 +
 +==== Ophalen STAM-bericht ====
 +
 +Op het algemene endpoint wordt de API //verzoeken/’ + Verzoeknummer + ’/samenvatting’// aangeroepen waarbij //verzoeknummer// wordt gevuld door het DSO-verzoeknummer van het betreffende gemiste verzoek. Indien het OIN-nummer gerechtigd is, dan retourneert het DSO het originele STAM-bericht. Hierbij gelden de bestaande instellingen voor STAM-versie en OIN-nummer.
 +
 +Indien zowel de instelling //Sectie: OWB, Item: MessageLog// als de instelling //Sectie: DSO en Item: messagelog_importgerelateerdezaken// aangevinkt is, dan worden de vraag en het antwoord gelogd.
 +
 +Bij succes wordt de betreffende regel in tbgemisteverzoeken weggehaald en wordt het STAM-bericht in de eigen OpenWave API
 + //VerwerkDSOstambericht// geschoten. Daar vindt de verwerking plaats conform de beschrijving [[openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten]].