Verschillen

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


Vorige revisie
—stable:applicatiebeheer:probleemoplossing:programmablokken:dso_gemiste_verzoeken [2026/07/15 11:07] (huidige) – aangemaakt - Externe bewerking 127.0.0.1
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: [[stable: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 bij de NIET complex verspreidde zaken?
 +      * 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//. Indien de //Tekst// gevuld is met **5** betekent dit dat STAM 5 wordt gevraagd. Als men over is naar STAM 6 dan kan daarna deze instelling gewijzigd worden naar //Tekst// = **6**. Indien deze instelling niet bestaat dan wordt door DSO het gemiste verzoek in de oudst geldende versie van STAM meegegeven. Huidig is dat STAM 5. 
 +
 +==== 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 [[stable:applicatiebeheer:probleemoplossing:programmablokken:verwerking_dso_stam_berichten]].