openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak

Verschillen

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

Link naar deze vergelijking

openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak [2025/08/13 14:40] – Ton Pullensopenwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak [2025/10/03 10:29] (huidige) – Externe bewerking 127.0.0.1
Regel 2: Regel 2:
 {{tag>openwave:1.33:applicatiebeheer:functionaliteiten:stuf_zaak_dms}} {{tag>openwave:1.33:applicatiebeheer:functionaliteiten:stuf_zaak_dms}}
  
-Vanuit een DMS kan een verzoek gedaan worden aan OpenWave om een zaak aan te maken. Hieronder een beschrijving van welke berichten daartoe uitgewisseld moeten worden, welke instellingen aan OpenWave-kant noodzakelijk zijn en welke onderdelen van het antwoord op geefZaakDetails door OpenWave verwerkt worden.+Vanuit een DMS kan een verzoek gedaan worden aan OpenWave om een zaak aan te maken. Hieronder een beschrijving van welke berichten daartoe uitgewisseld moeten worden, welke instellingen aan OpenWave-kant noodzakelijk zijn en welke onderdelen van het antwoord op geefZaakDetails door OpenWave verwerkt worden.\\ 
 +Naast de noodzakelijke instellingen geldt: 
 +  * het externe zaaktype van de overgedragen zaak moet gemapt zijn in openwave (tbsoortomgverg of tbsoortovverg) 
 +  * er moet een intiator (aanvrager) overgedragen worden  
 +  * de zaak moet nog niet bestaan
  
-=====Endpoint en beveiliging via certificaten===== +=====Endpoint en beveiliging via certificaten, whitelist===== 
-Het externe zaaksysteem/dms roept het SOAP-endpoint //**base-url/**api/stuf/ontvangasynchroon// van OpenWave aan met het verzoekbericht //overdragenZaak_Di01//.\\ +Het externe zaaksysteem/dms roept het SOAP-endpoint //**base-url/**api/stuf/ontvangAsynchroonOverdragen// van OpenWave aan met het verzoekbericht //overdragenZaak_Di01//.\\ 
-Een base-URL is een implementatie van OpenWave zoals bijvoorbeeld <nowiki>https://acceptatie.rommeldam.open-wave.nl</nowiki>.+Een base-URL is een implementatie van OpenWave zoals bijvoorbeeld <nowiki>https://acceptatie.rommeldam.open-wave.nl</nowiki>.\\ 
 +De wsdl van het endpoint is bereikbaar op //**base-url**/api/stuf/ontvangAsynchroonOverdragen.wsdl//
  
-De OpenWave StUF webservice op dat SOAP-endpoint  maakt gebruik van 2-way SSL. Dus de eerste authenticatie gebeurt volledig op serverniveau door middel van uitwisseling van certificaten onder het TLS1.2 encryptieprotocol en is geen onderdeel van deze handleiding.+De OpenWave StUF webservice op dat SOAP-endpoint  maakt gebruik van 2-way SSL onder het TLS1.2 encryptieprotocol.\\ 
 +De authenticatie gebeurt op endpoint-niveau door controle op IP-adres en aangeleverd client-certificaat: het IP-adres en de fingerprint van het client-certificaat van het externe zaaksysteem/dms wordt door OpenWave gecontroleerd in de tabel tbendpointlist (beheerportaal: zie Endpoints whitelist):  
 +  * In tbendpointlist moet een rij worden gedefinieerd met als endpoint //api/stuf/ontvangasynchroonoverdragen//  (dus zonder base-url). 
 +  * En vervolgens dienen de IP-adressen die toestemming moeten krijgen om de StUF overdragenZaak berichten te posten op dit soap-endpoint te worden toegevoegd (dochtertabel tbipauthorisationlist), waar de fingerprint een onderdeel van de omschrijving kan zijn.
  
 +Indien het bericht van het externe zaak/dms systeem NIET door deze firewall heen komt, wordt de HTTP-code 401 geretourneerd.
 =====Berichtenverkeer===== =====Berichtenverkeer=====
 {{:openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:stufzaakdms_overdagenzaak.png?800|}} {{:openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:stufzaakdms_overdagenzaak.png?800|}}
  
 ====Stap 1A en 1B: overdragenZaak_Di01==== ====Stap 1A en 1B: overdragenZaak_Di01====
-Indien het bericht van het externe zaak/dms systeem door de firewall heen is, antwoord Openwave ongezien op het overdragenZaak_Di01- bericht met een Bv03 (bevestigings-)bericht. \\+Indien het bericht van het externe zaak/dms systeem NIET door de firewall heen komt, wordt de HTTP-code 401 geretourneerd.\\ 
 +Indien het bericht van het externe zaak/dms systeem WEL door de firewall heen is, antwoord Openwave ongezien op het overdragenZaak_Di01- bericht met een Bv03 (bevestigings-)bericht. \\
 Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: //DMS overdragenZaak// mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staan.  Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: //DMS overdragenZaak// mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staan. 
 +
 +<adm example voorbeeld overdragenZaak_Di01>
 +  <?xml version="1.0" encoding="utf-16"?>
 +  <overdragenZaak_Di01 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 +    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 +    xmlns="http://www.stufstandaarden.nl/koppelvlak/zds0120">
 +    <stuurgegevens xmlns="http://www.egem.nl/StUF/sector/zkn/0310">
 +        <berichtcode xmlns="http://www.egem.nl/StUF/StUF0301">Di01</berichtcode>
 +        <zender xmlns="http://www.egem.nl/StUF/StUF0301">
 +            <organisatie>Rommeldam</organisatie>
 +            <applicatie>RDApp</applicatie>
 +            <gebruiker/>
 +        </zender>
 +        <ontvanger xmlns="http://www.egem.nl/StUF/StUF0301">
 +            <organisatie>ODRommeldam</organisatie>
 +            <applicatie>Openwave</applicatie>
 +        </ontvanger>
 +        <referentienummer xmlns="http://www.egem.nl/StUF/StUF0301"
 +            >93b81f42-f8ca-4221-97a3-7297f77f7544</referentienummer>
 +        <tijdstipBericht xmlns="http://www.egem.nl/StUF/StUF0301"
 +            >20250725104913460</tijdstipBericht>
 +        <functie xmlns="http://www.egem.nl/StUF/StUF0301">overdragenZaak</functie>
 +    </stuurgegevens>
 +    <object xmlns:d4p1="http://www.egem.nl/StUF/StUF0301"
 +        xmlns="http://www.egem.nl/StUF/sector/zkn/0310" d4p1:entiteittype="ZAK"
 +        d4p1:functie="entiteit">
 +        <identificatie>ROM123456</identificatie>
 +        <isVan d4p1:entiteittype="ZAKZKT">
 +            <gerelateerde d4p1:entiteittype="ZKT">
 +                <omschrijving>Aanvraag straatfeest</omschrijving>
 +                <code>24026</code>
 +            </gerelateerde>
 +        </isVan>
 +    </object>
 +  </overdragenZaak_Di01>
 +</adm>
 +
  
 ====Stap 2A en 2B geefZaakDetails_ZakLv01==== ====Stap 2A en 2B geefZaakDetails_ZakLv01====
 OpenWave vraagt aan het externe Zaak/DMS systeem de zaakgegevens op. Uit het ontvangen //overdragenZaak_diO1// bericht worden twee gegevens gebruikt: de //Zender//: <stuurgegevens><zender><organisatie> en de //Dmszaakidentificatie//: <object><identificatie>.\\ OpenWave vraagt aan het externe Zaak/DMS systeem de zaakgegevens op. Uit het ontvangen //overdragenZaak_diO1// bericht worden twee gegevens gebruikt: de //Zender//: <stuurgegevens><zender><organisatie> en de //Dmszaakidentificatie//: <object><identificatie>.\\
-De //Zender// wordt opgezocht in de medewekerstabel in de kolom dvloginnaam: deze robot-medewerker:+//ROM123456// in bovenstaand voorbeeld is de identificatie waaronder de zaak in het externe zaak/dms bekend is.\\ 
 +//Rommeldam// is daarin de naam van de zender-organisatie.  
 + 
 +De //Zender// wordt opgezocht in de medewerkerstabel in de kolom dvloginnaam. Op grond van bovenstaand voorbeeld zou de zender-organisatie //Rommeldam// dus moeten voorkomen in de dvloginnaam van de medewerkerstabel (en maar één keer). Deze robot-medewerker:
   * heeft geen wachtwoord,    * heeft geen wachtwoord, 
   * heeft geen 2-factor authenticatie    * heeft geen 2-factor authenticatie 
Regel 28: Regel 78:
 Indien GEEN robot-medewerker gevonden dan: Indien GEEN robot-medewerker gevonden dan:
   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.    * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//. 
-  * wordt het proces afgesloten zonder dan de externe partij dit weet: geen stuurgegevesn en certificaatgegevens bekend. +  * wordt het proces afgesloten zonder dan de externe partij dit weet: geen stuurgegevens en certificaatgegevens bekend. 
  
 Openwave zoekt in de betreffende kaart van tb33gemeente naar de noodzakelijke StUf stuurgegevens-instellingen en certificaat-gegevens om een bericht aan het externe zaak/dms te kunnen sturen.\\ Openwave zoekt in de betreffende kaart van tb33gemeente naar de noodzakelijke StUf stuurgegevens-instellingen en certificaat-gegevens om een bericht aan het externe zaak/dms te kunnen sturen.\\
Regel 40: Regel 90:
   * //Zender applicatie// (dvstufzknzenderapp) bijv OpenWave   * //Zender applicatie// (dvstufzknzenderapp) bijv OpenWave
   * //Zender organisatie// (dvstufzknzenderorg) bijv ODRommeldam   * //Zender organisatie// (dvstufzknzenderorg) bijv ODRommeldam
-  * //Ontvanger applicatie// (dvstufzknontvapp) bijv Djuma12 +  * //Ontvanger applicatie// (dvstufzknontvapp) bijv RDApp  (gelijk aan de zender-applicatie uit het binnengekomen overdragenZaak_Di01) 
-  * //Ontvanger organisatie// (dvstufzknontvorg) bijv ODRommeldam+  * //Ontvanger organisatie// (dvstufzknontvorg) bijv Rommeldam  (gelijk aan de zender-organisatie uit het binnengekomen overdragenZaak_Di01)
 En indien het externe zaak/dms dat verlangt kunnen ook de kolommen administratie en gebruiker worden gevuld.\\ En indien het externe zaak/dms dat verlangt kunnen ook de kolommen administratie en gebruiker worden gevuld.\\
 Bovenstaande waarden moeten afgestemd zijn met het externe zaak/dms.\\ Bovenstaande waarden moeten afgestemd zijn met het externe zaak/dms.\\
Regel 58: Regel 108:
 Het antwoordbericht kan wel een //geefZaakDetails_ZakLa01// bericht zijn, maar het blok <antwoord> ontbreekt daarin.\\ Het antwoordbericht kan wel een //geefZaakDetails_ZakLa01// bericht zijn, maar het blok <antwoord> ontbreekt daarin.\\
 In beide gevallen verzendt Openwave het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.\\ In beide gevallen verzendt Openwave het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.\\
-Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen sectie Koppeling ZAAK en item: Messagelog EN de instelling Sectie: OWB en Item: MessageLog aangevinkt staan.+Beide berichten worden opgeslagen in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling// Sectie: OWB en Item: MessageLog// aangevinkt staan.
    
 **Zoek mapping zaaktype**\\ **Zoek mapping zaaktype**\\
Regel 67: Regel 117:
   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.
   * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.   * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.
-  * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen sectie Koppeling ZAAK en item: Messagelog EN de instelling Sectie: OWB en Item: MessageLog aangevinkt staan.+  * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staan. 
 + 
 +**Bestaat de zaak al?**\\ 
 +De <identificatie> van het antwoordbericht wordt opgezocht in tbomgvergunning.dvintzaakcode en/of in tbovvergunningen.dvintzaakcode. Indien gevonden dan bestaat de zaak reeds en 
 +  * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//. 
 +  * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht. 
 +  * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staan.
  
 **Controle overige noodzakelijke instellingen ** \\ **Controle overige noodzakelijke instellingen ** \\
Regel 73: Regel 129:
   * In de tabel tbadressoort dient zowel een niet vervallen rij te bestaan voor de dvcode //AVR// (aanvrager) als voor de dvcode: //GEM// (gemachtigde).   * In de tabel tbadressoort dient zowel een niet vervallen rij te bestaan voor de dvcode //AVR// (aanvrager) als voor de dvcode: //GEM// (gemachtigde).
   * Indien de zaaktype mapping is uitgekomen op rij uit tbsoortovverg (apv/overige zaaktypes) dan moet ook //Getal2// van de instelling //sectie Koppeling ZAAK en item: DummyMeldingAPVOVWerzKey// bestaan en verwijzen naar een valide dnkey van de tabel tbovwerkz.   * Indien de zaaktype mapping is uitgekomen op rij uit tbsoortovverg (apv/overige zaaktypes) dan moet ook //Getal2// van de instelling //sectie Koppeling ZAAK en item: DummyMeldingAPVOVWerzKey// bestaan en verwijzen naar een valide dnkey van de tabel tbovwerkz.
-  * Indien er geen defaultbehandelaar is gevonden bij de gevodnen rij in tbsoortomgverg of tbsoortovverg met de zaaktype mapping, dan valt OpenWave terug op de  kolom// Tekst// van de instelling //Sectie: Koppeling OLO en Item: dossierbehandelaar//.+  * Indien er geen defaultbehandelaar is gevonden bij de gevonden rij in tbsoortomgverg of tbsoortovverg met de zaaktype mapping, dan valt OpenWave terug op de  kolom //Tekst// van de instelling //Sectie: Koppeling OLO en Item: dossierbehandelaar//.
 Indien aan deze voorwaarden niet is voldaan dan: Indien aan deze voorwaarden niet is voldaan dan:
   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.
   * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.   * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.
-  * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen sectie Koppeling ZAAK en item: Messagelog EN de instelling Sectie: OWB en Item: MessageLog aangevinkt staan.+  * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staan.
  
 **Bepaling perceeladres** \\ **Bepaling perceeladres** \\
Regel 106: Regel 162:
   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.   * wordt een kaart in tbmissingconfiguration aangemaakt onder de apinaam: //creeerStufOverdrachtZaak: geefZaakDetails//.
   * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.   * wordt het slotbericht //overdragenZaak_Du01// naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geweigerd.. Het externe zaak/dms antwoord hierop met een Bv03-bericht.
-  * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen sectie Koppeling ZAAK en item: Messagelog EN de instelling Sectie: OWB en Item: MessageLog aangevinkt staan.+  * worden beide berichten gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog// aangevinkt staan.
  
 **Bepaling gemachtigde**\\ **Bepaling gemachtigde**\\
Regel 132: Regel 188:
  
 **Verzenden slotbericht overdragenZaak_Du01 met succesmelding**\\ **Verzenden slotbericht overdragenZaak_Du01 met succesmelding**\\
-Tot slot wordt het bericht overdragenZaak_Du01 naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geaccepteerd en in de tag <melding> de wavezaakcode waaronder de zaak is aangemaakt in OpenWave.\\+Tot slot wordt het bericht overdragenZaak_Du01 naar het ontvangasynchroon endpoint van het externe zaak/dms gestuurd. In dat bericht in de tag <antwoord> de boodschap: overdracht geaccepteerd en in de tag <melding> de wavezaakcode waaronder de zaak is aangemaakt in OpenWave en in de tag <identificatie> het oorspronkelijke identificatienummer van het externe zaaksysteem.\\
 Het externe zaak/dms antwoord hierop met een Bv03-bericht. \\ Het externe zaak/dms antwoord hierop met een Bv03-bericht. \\
-Beide berichten worden gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen sectie Koppeling ZAAK en item: Messagelog EN de instelling Sectie: OWB en Item: MessageLog aangevinkt staan.+Beide berichten worden gelogd in de messagelog-tabel onder de rubriek: DMS overdragenZaak mits de instellingen //sectie Koppeling ZAAK en item: Messagelog// EN de instelling //Sectie: OWB en Item: MessageLog aangevinkt// staan.\\ 
 +Indien //overdracht geaccepteerd// dan komt in de kolom dvmessage_casid de wavezaakcode van de net aangemaakte zaak.
  • openwave/1.33/applicatiebeheer/probleemoplossing/programmablokken/verwerking_stuf_overdragenzaak.1755088858.txt.gz
  • Laatst gewijzigd: 2025/10/03 10:31
  • (Externe bewerking)