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 bestaat uit DSO-zaken (STAM-berichten) die opgenomen zouden moeten zijn in de OpenWave implementatie (op grond van bevoegd gezag of behandeldienst), maar dat niet zijn.

De tabel wordt periodiek aangevuld indien zo ingesteld via de taskscheduler (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: DSO Gerelateerde Zaken

• 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:443/overheid/verzoeken/api/afhandelen/v2
• Datumrange. Alleen verzoeken worden opgehaald die jonger zijn dan de systeemdatum minus Aantal dagen terug in de kolom Getal1 van de instelling Sectie: DSO-Verzoekafhandelen en Item: AantalDagenTerugGemisteVerzoeken.
• Geografisch gebied. Het geografisch gebied wordt gedefinieerd door de kolom Tekst van instelling Sectie: DSO-Verzoekafhandelen en Item: PolygoonGemisteVerzoeken. Dit moet een polygoon zijn in rijksdriehoek van x- en y-coördinaten:, waarbij het eerste paar gelijk is aan het laatste paar. X en y gescheiden door een komma en de paren gescheiden door een spatie. Bijvoorbeeld: 75000,550000 125000,550000 125000,515000 75000,515000 75000,550000.

Het polygoon moet grosso modo het grondgebied bevatten van de OpenWave implementatie: dus bijvoorbeeld dat van een gemeente, of een provincie of een omgevingsdienst.

• 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.

De callable importDSOGemisteVerzoeken roept de DSO-API verzoeken_zoek aan op het algemene endpoint met in het POST-bericht (in de body) het geografische gebied en de ingestelde datumrange.
Gezien de mogelijk grote geretourneerde resultset uit het DSO wordt de aanvraag gedaan in pages van 50 stuks. De DSO-API retourneert alle zaakverwijzingen binnen de opgeven datumrange waarvan de coördinaten van de project locatie vallen binnen het opgegeven grondgebied. Alles wat niet voor de OpenWave implementatie is moet er nog uitgefilterd worden. 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 wordt de geretourneerde zaakverwijzing 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.

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:443/overheid/verzoeken/api/afhandelen/v2
• 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.

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.

Indien zowel de instelling Sectie: OWB, Item: MessageLog als de instelling Sectie: DSO-Verzoekafhandelen en Item: MessageLog aangevinkt is, dan wordt deze vraag en 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 Verwerking DSO STAM berichten.