Verschillen

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

--- openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak [2025/08/14 13:57] – [Endpoint en beveiliging via certificatenm, whitelist] Ton Pullens
+++ openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:verwerking_stuf_overdragenzaak [2025/08/21 15:04] (huidige) – [Verwerking StUF Zaak/dms 1.2 Overdragen Zaak] Cecilio do Rosario
@@ Regel 2: / Regel 2: @@
 {{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, 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. Het IP-adres en de fingerprint van het client-certificaat van het externe zaaksysteem/dms wordt door OpenWave gecontoleerd in de tabel tbendpointlist (beheerportaal: zie Endpoints whitelist):
+De OpenWave StUF webservice op dat SOAP-endpoint  maakt gebruik van 2-way SSL onder het TLS1.2 encryptieprotocol.\\
-  * Hier moet een rij worden gedefinieerd met als endpoint //api/stuf/ontvangasynchroon//  (dus zonder base-url).
+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):
-  * En vervolgens dienen de IP-adressen die toestemming moeten krijgen om de StUF overdragenZaak berichten te posten op dit soap-endpoint te worden toegevoegd, waarbij in de omschrijving de fingerprint is opgenomen.
+  * 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=====
 {{:openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:stufzaakdms_overdagenzaak.png?800|}}
 ====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.
@@ Regel 180: / Regel 188: @@
 **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. \\
-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.