====== 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]].