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: DSO Gerelateerde Zaken.

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

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.

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.

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 Verwerking DSO STAM berichten.