From cbdb3b0b1f4c7497ebc035129a15340d9226a3e9 Mon Sep 17 00:00:00 2001
From: Martin van der Plas <martinvanderplas@gmail.com>
Date: Wed, 31 May 2023 17:53:19 +0200
Subject: [PATCH 1/3] update upmaak en details

---
 02_documentbeheer.md                         |  15 +-
 03_colofon.md                                |   1 +
 ch01_Inleiding.md                            |  20 +--
 ch02_WerkwijzeAanbevelingenBest Practices.md |  30 ++--
 ch03_CPA Gebruik en Kenmerken.md             | 141 ++++++++++---------
 ch05_Message Ordering in ebXML.md            |  15 +-
 js/config.js                                 |  18 ++-
 7 files changed, 127 insertions(+), 113 deletions(-)

diff --git a/02_documentbeheer.md b/02_documentbeheer.md
index b6aca8a..db82f37 100644
--- a/02_documentbeheer.md
+++ b/02_documentbeheer.md
@@ -1,10 +1,11 @@
 # Documentbeheer
 
-| Datum      | Versie | Auteur | Opmerkingen |
-|------------|--------|--------|-------------|
-| 22-11-2011 | 1.5    | Logius | - |
-| 09-06-2014 | 1.6    | Logius | Redactioneel bijwerken |
-| 13-01-2015 | 3.0    | Logius | Redactioneel  |
+| Datum      | Versie | Auteur | Opmerkingen                                                                 |
+|------------|--------|--------|-----------------------------------------------------------------------------|
+| 22-11-2011 | 1.5    | Logius | -                                                                           |
+| 09-06-2014 | 1.6    | Logius | Redactioneel bijwerken                                                      |
+| 13-01-2015 | 3.0    | Logius | Redactioneel                                                                |
 | 01-10-2017 | 3.1    | Logius | Herzien nav:  - Compliance Voorziening  - Begrippen ebMS2 en CPA   Register |
-| 16-05-2019 | 3.2    | Logius | EB015 SyncReply toegevoegd  |
-| 11/04/2022 | 3.2.1  | Logius | Vermelding REST-API koppelvlak  |
+| 16-05-2019 | 3.2    | Logius | EB015 SyncReply toegevoegd                                                  |
+| 11-04-2022 | 3.2.1  | Logius | Vermelding REST-API koppelvlak                                              |
+| 31-05-2023 | 3.2.2  | Logius | Update 2023 conform Roadmap Digikoppeling                                   |
diff --git a/03_colofon.md b/03_colofon.md
index fc7050f..47620fe 100644
--- a/03_colofon.md
+++ b/03_colofon.md
@@ -3,3 +3,4 @@
 | | |
 |---|---|
 | Logius Servicecentrum: | Postbus 96810 <br>2509 JE Den Haag<br>tel. 0900 555 4555 (10 ct p/m)<br>email servicecentrum@logius.nl |
+| Logius Afdeling Standaarden: | email. digikoppeling@logiuis.nl<br>                                                              |
diff --git a/ch01_Inleiding.md b/ch01_Inleiding.md
index 9253ec0..ea876c0 100644
--- a/ch01_Inleiding.md
+++ b/ch01_Inleiding.md
@@ -1,4 +1,5 @@
 # Inleiding
+
 ## Doel en doelgroep
 
 Alle Digikoppeling profielen die op ebMS2 gebaseerd zijn, moeten zich conformeren aan de Koppelvlakstandaard ebMS2. Dit document is een aanvulling hierop. Het heeft als doel ontwikkelaars te adviseren en te informeren over de huidige werkwijze bij het toepassen van Digikoppeling Koppelvlakstandaard ebMS2 – deze informatie geldt dus alleen voor de ebMS2-variant.
@@ -16,10 +17,8 @@ Het document is bestemd voor Architecten, integratie specialisten en ontwikkelaa
 
 Digikoppeling is beschreven in een set van documenten. Deze set is als volgt opgebouwd:
 
-
 ![Overzicht van de onderdelen van de Digikoppeling Standaard, de standaard is onderverdeeld in normatieve en ondersteunende onderdelen](media/DK_Specificatie_structuur.svg "Opbouw documentatie Digikoppeling")
 
-
 <details>
     <summary> Tekstalternatief </summary>
 <ul>
@@ -86,14 +85,14 @@ Digikoppeling biedt de mogelijkheid om op deze gestandaardiseerde wijze berichte
 
 De uitwisseling tussen partijen is in drie lagen opgedeeld:
 
-- Inhoud (gegevens): deze laag bevat afspraken over de inhoud van het uit te wisselen bericht, dus de structuur, semantiek en waardebereiken   
-    Digikoppeling houdt zich niet met de inhoud bezig, ' heeft geen boodschap aan de boodschap'.
+1. Inhoud (gegevens): deze laag bevat afspraken over de inhoud van het uit te wisselen bericht, dus de structuur, semantiek en waardebereiken <BR>
+Digikoppeling houdt zich niet met de inhoud bezig, **'heeft geen boodschap aan de boodschap'**.
 
-- Logistiek (processen): op deze laag bevinden zich de afspraken betreffende transportprotocollen (HTTP/TLS), messaging (SOAP), adressering, beveiliging (authenticatie en encryptie) en betrouwbaarheid. Dit is laag van Digikoppeling.
+2. Logistiek (processen): op deze laag bevinden zich de afspraken betreffende transportprotocollen (HTTP/TLS), messaging (SOAP), adressering, beveiliging (authenticatie en encryptie) en betrouwbaarheid. Dit is laag van Digikoppeling.
 
-- Transport (techniek): deze laag verzorgt het daadwerkelijke transport van het bericht (TCP/IP).
+3. Transport (techniek): deze laag verzorgt het daadwerkelijke transport van het bericht (TCP/IP).
 
-Digikoppeling richt zich uitsluitend op de logistieke laag.
+> Digikoppeling richt zich uitsluitend op de logistieke laag.
 
 ## Opbouw van dit document
 
@@ -105,7 +104,8 @@ Hoofdstuk 3 gaat in op de kenmerken van een CPA.
 
 Hoofdstuk 4 gaat over bericht volgordelijkheid.
 
-Begrippen en afkortingen worden toegelicht in het document “DigikoppelingArchitectuur”. Deze zit in de Digikoppeling standaard.
-
-Dit document en andere documentatie is beschikbaar op [www.logius.nl/digikoppeling](http://www.logius.nl/digikoppeling).
+> Begrippen en afkortingen worden toegelicht in het document “DigikoppelingArchitectuur”.  
+> Dit document is onderdeel van de Digikoppeling standaard.
 
+<div class="note">Dit document en alle andere Digikoppeling documentatie is beschikbaar op <a href="http://www.logius.nl/digikoppeling">Logius.nl/digikoppeling</a>.
+</div>
diff --git a/ch02_WerkwijzeAanbevelingenBest Practices.md b/ch02_WerkwijzeAanbevelingenBest Practices.md
index 75b8cef..0c96861 100644
--- a/ch02_WerkwijzeAanbevelingenBest Practices.md	
+++ b/ch02_WerkwijzeAanbevelingenBest Practices.md	
@@ -2,7 +2,7 @@
 
 ## EB001 ebMS2 Producten
 
-Gebruik een ebMS2 product met aantoonbare ervaring binnen het Digikoppeling domein. Op de website van Logius is een overzicht van Digikoppeling leveranciers te vinden en ook in de marktscan van KING en Logius is een overzicht te vinden van het aanbod van Digikoppeling adapters dat voldoet aan de eisen die KING stelt aan een Digikoppeling Adapter voor de gemeentelijke markt.
+Gebruik een ebMS2 product met aantoonbare ervaring binnen het Digikoppeling domein. Op de website van Logius is een overzicht van Digikoppeling leveranciers te vinden en ook in de marktscan van VNG Realisatie en Logius is een overzicht te vinden van het aanbod van Digikoppeling adapters dat voldoet aan de eisen die VNG Realisatie stelt aan een Digikoppeling Adapter voor de gemeentelijke markt.
 
 ## EB002 CPA Gebruik
 
@@ -12,7 +12,7 @@ Voor het definiëren van een CPA geldt het volgende advies:
 
 1. Maak gebruik van het online CPA Register<sup>1</sup>, zie document 'Digikoppeling CPA Creatie Handleiding'.
 
-<sup>1</sup>: Het online CPA Register wordt gehost door Justid en is beschikbaar op [https://cparegister.minvenj.nl/logius](https://cparegister.minvenj.nl/logius)
+> <sup>1</sup>. Het online CPA Register wordt gehost door Justid en is beschikbaar op [https://cparegister.minvenj.nl/logius](https://cparegister.minvenj.nl/logius)
 
 ## EB003 Productie- en ontwikkelomgevingen
 
@@ -32,7 +32,7 @@ Voorzie de PartyId van een postfix voor het onderscheid tussen test- en producti
 
 Samenstellingen zijn ook mogelijk, bijvoorbeeld de postfix ‘_OTA’ als er één specifiek adres gebruikt wordt voor de ontwikkel-, test-, en acceptatieomgeving. Aangezien Digikoppeling een strikte scheiding tussen test en productie nastreeft zou een combinatie van productie met andere omgevingen nooit moeten voorkomen<sup>2</sup>.
 
-<sup>2</sup>: De scheiding komt ook. tot uitdrukking in het gebruik van een andere certificaat-root voor productie en andere omgevingen. Zie hiervoor het document “Gebruik en achtergrond Digikoppeling-certificaten”.
+> <sup>2</sup>. De scheiding komt ook. tot uitdrukking in het gebruik van een andere certificaat-root voor productie en andere omgevingen. Zie hiervoor het document “Gebruik en achtergrond Digikoppeling-certificaten”.
 
 ## EB005 Certificaten
 
@@ -116,6 +116,8 @@ Laat de start- en einddatum van de CPA mede afhangen van de geldigheid van de ge
 
 Een CPA voor testdoeleinden kan een korte geldigheidsperiode krijgen, afgestemd op de test periode.
 
+Een geldigheidsperiode langer dan 10 jaar is niet gebruikelijk.
+
 ## EB011 MessageOrder en ConversationId
 
 Als de MessageOrder functionaliteit gebruikt wordt, moeten alle betreffende (samenhangende) berichten dezelfde ConversationId krijgen.
@@ -128,7 +130,7 @@ Als MessageOrder gebruikt wordt is dit van invloed op de overdrachtskarakteristi
 
 ## EB013 MessageId
 
-De Koppelvlakstandaard ebMS2 schrijft het gebruik van een MessageId voor conform RFC2822, in de vorm van “[UUID@URI](mailto:UUID@URI)”.
+De Koppelvlakstandaard ebMS2 schrijft het gebruik van een MessageId voor conform [[RFC2822]], in de vorm van “[UUID@URI](mailto:UUID@URI)”.
 
 De URI in de MessageId kan ook het domein kan zijn van Digikoppeling messagehandler.
 
@@ -142,7 +144,7 @@ Het is toegestaan om op transport niveau het cliënt certificaat te gebruiken vo
 
 Het Digikoppeling ebMS2 Reliable Messaging (RM) profiel vereist dat berichten bevestigd worden met een *acknowledgement* bericht. Binnen het Digikoppeling ebMS2 RM-profiel moet deze acknowledgement *asynchroon* worden verzonden. Een Digikoppeling oplossing houdt hiervoor een administratie bij zodat de acknowledgement aan het initiële *MessageId* van het bericht kan worden kan worden gerefereerd
 
-Bij het gebruik van het uitwisselen van zeer hoge volumes van berichten in beperkte tijd via het Digikoppeling ebMS RM-profiel *kan* de overhead van het asynchroon bevestigen van het bericht via asynchrone acknowledgement (te) groot worden. Vandaar dat sinds versie 3.3 van dit profiel het gebruik van SyncReply Profile in de Digikoppeling ebMS2 Specificatie wordt toegestaan voor een aantal uitzonderingsgevallen. Vanaf deze versie is het in bepaalde gevallen mogelijk om een bericht synchroon – dus in dezelfde http-sessie- te bevestigen met een acknowledgement (of een foutsituatie synchroon te beantwoorden met een *errormessage*)
+Bij het gebruik van het uitwisselen van zeer hoge volumes van berichten in beperkte tijd via het Digikoppeling ebMS RM-profiel *kan* de overhead van het asynchroon bevestigen van het bericht via asynchrone acknowledgement (te) groot worden. Vandaar dat sinds versie 3.3 van dit profiel het gebruik van SyncReply Profile in de Digikoppeling ebMS2 specificatie wordt toegestaan voor een aantal uitzonderingsgevallen. Vanaf deze versie is het in bepaalde gevallen mogelijk om een bericht synchroon – dus in dezelfde http-sessie- te bevestigen met een acknowledgement (of een foutsituatie synchroon te beantwoorden met een *errormessage*)
 
 **Toepassen van Synchrone acknowledgement is uitzondering**
 
@@ -150,19 +152,22 @@ Het gebruik van Syncreply wordt in de regel afgeraden. Tot aan versie 3.3 van Di
 
 In de praktijk blijkt dat er toch situaties bestaan waarin het synchroon bevestigen van een bericht voordeel biedt:
 
-Casusbeschrijving
+<aside class="example">
+**Casusbeschrijving**
 
 Bij uitwisseling tussen een GDI-voorziening en een grote afnemer worden door de verzendende partij aan de ontvangende partij in korte tijd zeer hoge volumes berichten aangeboden. Vanwege de eis op betrouwbaarheid is voor de uitwisseling gekozen voor het ebMS2 RM-profiel. Deze ebMS berichten bevatten per zending 1 functioneel bericht. Hierdoor is de overhead van het ebMS protocol voor de ontvangende partij relatief hoog.
 
 De berichtuitwisseling in de keten was oorspronkelijk opgezet volgens asynchrone bevestiging. Bij de ketenintegratietest tussen beide partijen kwamen verwerkingsproblemen aan de ontvangende kant aan het licht. In onderling overleg tussen de ketenpartners is afgesproken om de ebMS2 uitwisseling zo in te stellen dat acknowledgements synchroon verstuurd worden. Hierna verliep de uitwisseling volgens de afgesproken eisen aan capaciteit, performance en betrouwbaarheid.
+</aside>
 
 ### Voorwaarden voor toepassen van het synchrone bevestiging
 
-- Scope: Dit profiel is alleen geldig voor de Digikoppeling ebMS2 RM-profielen
-
-- Aanleiding: Door omvang van het volume van uitwisseling van berichten in beperkte tijd bestaan verwerkingsproblemen bij (een van beide) providers. Asynchrone uitwisseling van berichten binnen het ebMS profiel blijft de defaultmodus. Dus als de verwerking probleemloos verloopt is er geen reden om over te gaan op synchrone uitwisseling.
-
-- Voorwaarde: De Digikoppeling oplossing van beide partijen ondersteunen het instellen van SyncReplymode op mshSignalsOnly. Het instellen van deze mode kan dus niet eenzijdig worden opgelegd.
+- Scope:
+  - Dit profiel is alleen geldig voor de Digikoppeling ebMS2 RM-profielen
+- Aanleiding:
+  - Door omvang van het volume van uitwisseling van berichten in beperkte tijd bestaan verwerkingsproblemen bij (een van beide) providers. Asynchrone uitwisseling van berichten binnen het ebMS profiel blijft de defaultmodus. Dus als de verwerking probleemloos verloopt is er geen reden om over te gaan op synchrone uitwisseling.
+- Voorwaarde:
+  - De Digikoppeling oplossing van beide partijen ondersteunen het instellen van SyncReplymode op mshSignalsOnly. Het instellen van deze mode kan dus niet eenzijdig worden opgelegd.
 
 <aside class="note">
     Indien de berichtuitwisseling via een intermediary verloopt dient deze ook de SyncReplymode te ondersteunen om de synchrone communicatie tussen partijen mogelijk te maken.
@@ -170,13 +175,12 @@ De berichtuitwisseling in de keten was oorspronkelijk opgezet volgens asynchrone
 
 ## EB016 Correlatie van berichten
 
-Voor het correleren van berichten in ebMS2 spelen de elementen *Messageid*, *ConversationId* en *RefToMessageId* een rol. Het gebruik van de combinatie *MessageId* en *RefToMessageId* en het *ConversationId* dienen verschillende doelen.
+Voor het correleren van berichten in ebMS2 spelen de elementen *Messageid*, *ConversationId* en *RefToMessageId* een rol. Het gebruik van de combinatie *MessageId* en *RefToMessageId* en het *ConversationId* dienen verschillende doelen. Deze 2 doelen zijn hieronder uitgewerkt:
 
 ### Response op een specifiek request
 
 *Messageid* en *RefToMessageId* worden gebruikt om heel specifiek aan te geven op welke request een response wordt gegeven. *RefToMessageId* wordt dus gebruikt om de relatie tussen een ebMS bericht en het daarop volgende ACK of NACK bericht aan te geven, een protocol gerelateerde relatie.
 
-
 <aside class="example">
 Voor een terugmelding  op de GBA met MessageId 1234 moet de GBA in het antwoord op deze terugmelding het RefToMessageId 1234 gebruiken. Zo zijn request en response onlosmakelijk met elkaar verbonden. Normaal gesproken worden geen verdere antwoorden op een dergelijke melding terugverwacht waardoor het bericht met het RefToMessageId ook vaak de transactie beëindigt.
 </aside>
diff --git a/ch03_CPA Gebruik en Kenmerken.md b/ch03_CPA Gebruik en Kenmerken.md
index 8b543bc..33d71c7 100644
--- a/ch03_CPA Gebruik en Kenmerken.md	
+++ b/ch03_CPA Gebruik en Kenmerken.md	
@@ -10,9 +10,8 @@ Een CPA is een formeel xml document om de gebruikte functionele en technische ei
 
 De CPA is gestandaardiseerd in [ISO 15000-1: ebXML Collaborative Partner Profile Agreement (afgekort tot ebCPP<sup>3</sup>). Het ebMS2 protocol is gestandaardiseerd in ebXML Messaging Service Specification (afgekort tot ebMS2<sup>4</sup>).
 
-<sup>3</sup>: [[ebCPP]] Collaboration-Protocol Profile and Agreement Specification Version 2.0, September 23, 2002. Url: http://www.oasis-open.org/committees/ebxml-cppa/documents/ebcpp-2.0c.pdf
-
-<sup>4</sup>: Message Service Specification, Version 2.0, 1 April 2002. Url: http://www.oasis-open.org/committees/ebxml-msg/documents/ebMS_v2_0.pdf [[EBXML-MSG]]
+> <sup>3</sup>. [[ebCPP]] Collaboration-Protocol Profile and Agreement Specification Version 2.0, September 23, 2002. Url: http://www.oasis-open.org/committees/ebxml-cppa/documents/ebcpp-2.0c.pdf
+> <sup>4</sup>. Message Service Specification, Version 2.0, 1 April 2002. Url: http://www.oasis-open.org/committees/ebxml-msg/documents/ebMS_v2_0.pdf [[EBXML-MSG]]
 
 De eigenschappen van de gegevensoverdracht geven onder andere aan:
 
@@ -48,6 +47,8 @@ De kenmerken van het ebMS2 verkeer op Digikoppeling zijn beschreven in het docum
 
 De kenmerken zijn vertaald naar relevante onderdelen van een CPA. Deze CPA onderdelen worden hieronder beschreven in termen zoals benoemd in [[ebCPP]].
 
+### Service
+
 - Service
 
     Een Service is een unieke aanduiding voor een set van samenhangende operaties.
@@ -64,15 +65,15 @@ De kenmerken zijn vertaald naar relevante onderdelen van een CPA. Deze CPA onder
     <tns:Service tns:type="urn:osb:services">OSB:Service:1:0</tns:Service>
     ```
 
-- CPAId
+### CPAId
 
-    Een CPAId is een unieke aanduiding voor een overeenkomst voor een bepaalde service. De CPAId moet uniek zijn voor die bepaalde service. Denk hierbij aan het feit dat er één service wordt gespecificeerd door een service provider en dat meerdere service requesters een samenwerking aangaan. Elke samenwerking tussen twee partijen moet een ander CPAId krijgen. Een CPAId moet uniek zijn. Advies voor de naamgeving is als volgt:
+Een CPAId is een unieke aanduiding voor een overeenkomst voor een bepaalde service. De CPAId moet uniek zijn voor die bepaalde service. Denk hierbij aan het feit dat er één service wordt gespecificeerd door een service provider en dat meerdere service requesters een samenwerking aangaan. Elke samenwerking tussen twee partijen moet een ander CPAId krijgen. Een CPAId moet uniek zijn. Advies voor de naamgeving is als volgt:
 
-    `[ServiceID]_[PartyId-A]_[PartyId-B]_[versie]`
+`[ServiceID]_[PartyId-A]_[PartyId-B]_[versie]`
 
-    NB. Gebruik geen punten of andere vreemde tekens, want sommige ebMS-adapters zouden de CPAId wel eens als filenaam kunnen gebruiken...
+NB. Gebruik geen punten of andere vreemde tekens, want sommige ebMS-adapters zouden de CPAId wel eens als filenaam kunnen gebruiken...
 
-    Hierbij zijn:
+Hierbij zijn:
 
   - `[ServiceID]` de unieke Service ID
 
@@ -82,12 +83,13 @@ De kenmerken zijn vertaald naar relevante onderdelen van een CPA. Deze CPA onder
 
   - `[versie]` een UUID (of een versie nummer mits de uitgever van de CPA kan garanderen dat de CPAId uniek blijft)
 
-- Start- en einddatum
+### Start- en einddatum
 
-    Elke CPA heeft een start en einddatum. Dit moet afgestemd worden tussen de twee partijen die een samenwerking aangaan. Merk op dat er een afhankelijkheid is met de geldigheidsperiode van de gebruikte client- en servercertificaten.
+Elke CPA heeft een start en einddatum. Dit moet afgestemd worden tussen de twee partijen die een samenwerking aangaan. Merk op dat er een afhankelijkheid is met de geldigheidsperiode van de gebruikte client- en servercertificaten.
 
-- Default Message Channel  
-    Een CPA bevat twee PartyInfo elementen: voor elke deelnemer in de samenwerking één. Elk PartyInfo element kent precies één 'default channel' dat gebruikt wordt voor de verzending van onderliggende protocol berichten (zoals de acknowledgments). In de CPA wordt deze 'default channel' aangegeven met het defaultMshChannelId attribuut. De eigenschappen van dit channel worden bepaald op basis van het Digikoppeling ebMS2 profiel met de hoogste beveiliging. Als een CPA verschillende Actions bevat waarvoor de acknowledgements verschillende profiel eigenschappen hebben, zullen de Actions verdeeld moeten worden over meerdere CPA's: in elke CPA komen die Actions die dezelfde profiel eigenschappen hebben. Als er gebruik gemaakt wordt van de CPA Creatievoorziening zullen er verschillende Digikoppeling-ebMS2 Servicespecificaties gemaakt moeten worden.
+### Default Message Channel
+
+Een CPA bevat twee PartyInfo elementen: voor elke deelnemer in de samenwerking één. Elk PartyInfo element kent precies één 'default channel' dat gebruikt wordt voor de verzending van onderliggende protocol berichten (zoals de acknowledgments). In de CPA wordt deze 'default channel' aangegeven met het defaultMshChannelId attribuut. De eigenschappen van dit channel worden bepaald op basis van het Digikoppeling ebMS2 profiel met de hoogste beveiliging. Als een CPA verschillende Actions bevat waarvoor de acknowledgements verschillende profiel eigenschappen hebben, zullen de Actions verdeeld moeten worden over meerdere CPA's: in elke CPA komen die Actions die dezelfde profiel eigenschappen hebben. Als er gebruik gemaakt wordt van de CPA Creatievoorziening zullen er verschillende Digikoppeling-ebMS2 Servicespecificaties gemaakt moeten worden.
 
    <aside class="example">
     Er zijn twee Actions:  
@@ -96,29 +98,29 @@ De kenmerken zijn vertaald naar relevante onderdelen van een CPA. Deze CPA onder
     De default channel zal de eigenschappen overnemen van het profiel osb-rm-e. Als dit NIET wenselijk is, zullen de twee actions in twee verschillende CPA's geplaatst moeten worden.
     </aside>
 
-- PartyName
+### PartyName
 
-    De naam van de partij zoals die opgegeven moet worden in de CPA. Dit zal voor elke organisatie anders zijn, maar blijft wel hetzelfde voor alle CPA’s die gemaakt zullen worden.
+De naam van de partij zoals die opgegeven moet worden in de CPA. Dit zal voor elke organisatie anders zijn, maar blijft wel hetzelfde voor alle CPA’s die gemaakt zullen worden.
 
-- PartyId
+### PartyId
 
-    Het Organisatie Identificatie nummer (OIN) van de organisatie. De PartyId is de (logische) aanduiding waarmee de organisatie geïdentificeerd wordt. Als de organisatie nog geen OIN heeft moet een nummer aangevraagd worden bij Logius. De COR (De Centrale OIN Raadpleegvoorziening) wordt gebruikt om informatie vast te leggen over de organisatie en het OIN. Het nummer zal ook gebruikt worden in het cliënt certificaat voor het subject.Serialnumber veld. Zie ook EB014 in hoofdstuk 2. Organisaties die op basis van standaarden met andere overheden communiceren wordt sterk aangeraden om een OIN aan te vragen.
+Het Organisatie Identificatie nummer (OIN) van de organisatie. De PartyId is de (logische) aanduiding waarmee de organisatie geïdentificeerd wordt. Als de organisatie nog geen OIN heeft moet een nummer aangevraagd worden bij Logius. De COR (De Centrale OIN Raadpleegvoorziening) wordt gebruikt om informatie vast te leggen over de organisatie en het OIN. Het nummer zal ook gebruikt worden in het cliënt certificaat voor het subject.Serialnumber veld. Zie ook EB014 in hoofdstuk 2. Organisaties die op basis van standaarden met andere overheden communiceren wordt sterk aangeraden om een OIN aan te vragen.
 
-- PartyId Type
+### PartyId Type
 
-    Deze heeft de waarde urn:osb:oin voor PartyId's met een OIN.(Dit is ook de default waarde voor de CPA's zoals die door het CPA register wordt gehanteerd.)
+Deze heeft de waarde urn:osb:oin voor PartyId's met een OIN.(Dit is ook de default waarde voor de CPA's zoals die door het CPA register wordt gehanteerd.)
 
-    De PartyId type wordt als volgt opgenomen in het ebMS2 contract (met een voorbeeld van de PartyId waarde “0123456789”):  
+De PartyId type wordt als volgt opgenomen in het ebMS2 contract (met een voorbeeld van de PartyId waarde “0123456789”):  
 
-    ```XML
-    <tns:PartyId tns:type="urn:osb:oin">123456789</tns:PartyId>
-    ```
+```XML
+<tns:PartyId tns:type="urn:osb:oin">123456789</tns:PartyId>
+```
 
-    Het is toegestaan om een andere PartyId type te hanteren als de organisatie reeds andersoortige (geen OIN's) PartyId’s heeft voor de organisatie identificatie. Het moge duidelijk zijn dat het in overleg met de samenwerkende organisaties vastgesteld moet worden. Zie ook EB014 in hoofdstuk 2.
+Het is toegestaan om een andere PartyId type te hanteren als de organisatie reeds andersoortige (geen OIN's) PartyId’s heeft voor de organisatie identificatie. Het moge duidelijk zijn dat het in overleg met de samenwerkende organisaties vastgesteld moet worden. Zie ook EB014 in hoofdstuk 2.
 
-- BusinessCharacteristics
+### BusinessCharacteristics
 
-    Deze heeft de volgende verplichte waarde, waarbij alleen de timeToPerform een andere waarde kan krijgen (afhankelijk van de timing karakteristieken van de RequestingBusinessActivity en de RespondingBusinessActivity):
+Deze heeft de volgende verplichte waarde, waarbij alleen de timeToPerform een andere waarde kan krijgen (afhankelijk van de timing karakteristieken van de RequestingBusinessActivity en de RespondingBusinessActivity):
 
 ```XML
 <tns:BusinessTransactionCharacteristics
@@ -132,8 +134,7 @@ De kenmerken zijn vertaald naar relevante onderdelen van een CPA. Deze CPA onder
     tns:timeToPerform="P2D"/>
 ```
 
-
-TransportProtocol over HTTP met TLS met server certificaat.  
+### TransportProtocol over HTTP met TLS met server certificaat
 Deze hebben de verplichte waardes:
 
 ```XML
@@ -150,78 +151,82 @@ en voor bijvoorbeeld versie 1 van TLS
 voor de actuele versies van het te gebruiken protocol bij de uitwisseling zie [[Digikoppeling Beveiligingsdocument]]
 </aside>
 
-- Client Authentication over HTTP met client certificaat. Dit is verplicht. In het client certificaat staat in het subject.Serialnumber de PartyId van de ‘client’ organisatie.
+### Client Authentication over HTTP met client certificaat. 
 
-- Endpoint
+Dit is verplicht. In het client certificaat staat in het subject.Serialnumber de PartyId van de ‘client’ organisatie.
 
-    Deze heeft de waarde van de URL (FQDN, met pad namen) van de ebMS-adapter waarmee over Digikoppeling gegevens uitgewisseld worden. De FQDN van de URL moet overeenkomen met de FQDN die in het server certificaat vermeld staat.
+### Endpoint
 
-- MessageOrder
+Deze heeft de waarde van de URL (FQDN, met pad namen) van de ebMS-adapter waarmee over Digikoppeling gegevens uitgewisseld worden. De FQDN van de URL moet overeenkomen met de FQDN die in het server certificaat vermeld staat.
 
-    De MessageOrder geeft aan of er wel of geen gebruik gemaakt wordt van ordening van berichten. De default waarde voor MessageOrder is “NotGuaranteed” en wordt als volgt opgenomen in het ebMS2 contract:
+### MessageOrder
 
-    ```XML
-        <tns:MessageOrderSemantics>NotGuaranteed</tns:MessageOrderSemantics>
-    ```
+De MessageOrder geeft aan of er wel of geen gebruik gemaakt wordt van ordening van berichten. De default waarde voor MessageOrder is “NotGuaranteed” en wordt als volgt opgenomen in het ebMS2 contract:
+
+```XML
+    <tns:MessageOrderSemantics>NotGuaranteed</tns:MessageOrderSemantics>
+```
 
-    Indien er wel gebruik gemaakt wordt van MessageOrder is de waarde:
+Indien er wel gebruik gemaakt wordt van MessageOrder is de waarde:
 
-    ```XML
-        <tns:MessageOrderSemantics>Guaranteed</tns:MessageOrderSemantics>
-    ```
+```XML
+    <tns:MessageOrderSemantics>Guaranteed</tns:MessageOrderSemantics>
+```
 
 <aside class="note"> MessageOrder wordt niet door alle ebMS-adapters implementaties ondersteund. Als het wel het geval is zal de interoperabiliteit goed getest moeten worden. Zie hoofdstuk “Het gebruik van bericht volgordelijkheid”.
 </aside>
 
-- ReliableMessaging
+### ReliableMessaging
 
-    Deze heeft default een retryCount van 8 en een retryInterval van 3 uur, zonder MessageOrder:
+Deze heeft default een retryCount van 8 en een retryInterval van 3 uur, zonder MessageOrder:
 
-    ```XML
-    <tns:MessagingCharacteristics tns:syncReplyMode="none"
-    tns:ackRequested="always" tns:actor="urn:oasis:names:tc:ebxml-msg:actor:toPartyMSH"
-    tns:ackSignatureRequested="never"    tns:duplicateElimination="always"/>
-    ```
+```XML
+<tns:MessagingCharacteristics tns:syncReplyMode="none"
+tns:ackRequested="always" tns:actor="urn:oasis:names:tc:ebxml-msg:actor:toPartyMSH"
+tns:ackSignatureRequested="never"    tns:duplicateElimination="always"/>
+```
 
-    De waardes kunnen per CPA bepaald worden, en liggen dus niet bij voorbaat vast.
+De waardes kunnen per CPA bepaald worden, en liggen dus niet bij voorbaat vast.
 
-    In het geval dat MessageOrder wel gebruikt wordt, komt in de CPA:
+In het geval dat MessageOrder wel gebruikt wordt, komt in de CPA:
 
-    <tns:MessageOrderSemantics>Guaranteed</tns:MessageOrderSemantics>
+<tns:MessageOrderSemantics>Guaranteed</tns:MessageOrderSemantics>
 
-    Conform de ebMS2 specificatie zal de applicatie dezelfde ConversationId moeten gebruiken voor de opeenvolgende berichten<sup>5</sup>.
+Conform de ebMS2 specificatie zal de applicatie dezelfde ConversationId moeten gebruiken voor de opeenvolgende berichten<sup>5</sup>.
 
-    <sup>5</sup>: [[EBXML-MSG]] H9.1.1 “The REQUIRED SequenceNumber element indicates the sequence a Receiving MSH MUST process messages. The SequenceNumber **is unique within** the ConversationId and MSH.”
+> <sup>5</sup>. [[EBXML-MSG]] H9.1.1 “The REQUIRED SequenceNumber element indicates the sequence a Receiving MSH MUST process messages. The SequenceNumber **is unique within** the ConversationId and MSH.”
 
-- PersistDuration
+### PersistDuration
 
-    Deze heeft default de waarde van 1 dag, maar zal anders zijn als er andere waardes voor ReliableMessaging gebruikt worden:
+Deze heeft default de waarde van 1 dag, maar zal anders zijn als er andere waardes voor ReliableMessaging gebruikt worden:
 
-    ```XML
-    <tns:PersistDuration>P1D</tns:PersistDuration>
-    ```
+```XML
+<tns:PersistDuration>P1D</tns:PersistDuration>
+```
 
-- MessagingCharacteristic
+### MessagingCharacteristic
 
-    Deze heeft de waarde:
+Deze heeft de waarde:
 
-    ```XML
-    <tns:MessagingCharacteristics
+```XML
+<tns:MessagingCharacteristics
 
-    tns:syncReplyMode="none"
+tns:syncReplyMode="none"
 
-    tns:ackRequested="always"
+tns:ackRequested="always"
 
-    tns:actor="urn:oasis:names:tc:ebxml-msg:actor:toPartyMSH"
+tns:actor="urn:oasis:names:tc:ebxml-msg:actor:toPartyMSH"
 
-    tns:ackSignatureRequested="never"
+tns:ackSignatureRequested="never"
 
-    tns:duplicateElimination="always"/>
-    ```
+tns:duplicateElimination="always"/>
+```
+
+Geen gebruik van Signing of (payload) Encryption. (Alleen op HTTP nivo wordt informatie beveiligd)
 
-    Geen gebruik van Signing of (payload) Encryption. (Alleen op HTTP nivo wordt informatie beveiligd)
+### Certificaten
 
-    Er moet gebruik gemaakt worden van certificaten die voldoen aan de eisen van de PKI Overheid.
+Er moet gebruik gemaakt worden van certificaten die voldoen aan de eisen van de PKI Overheid.
 
 ## Hoe wordt een CPA gemaakt?
 
diff --git a/ch05_Message Ordering in ebXML.md b/ch05_Message Ordering in ebXML.md
index 7d505d5..23c8a77 100644
--- a/ch05_Message Ordering in ebXML.md	
+++ b/ch05_Message Ordering in ebXML.md	
@@ -4,19 +4,18 @@ Een onderdeel van de ebMS 2.0 specificatie is de volgordelijkheid van berichten,
 
 ## MessageOrder Module**
 
-The MessageOrder module allows messages to be presented to the To Party in a particular order. This is accomplished through the use of the MessageOrder element. Reliable Messaging MUST be used when a MessageOrder element is present.
-
-MessageOrder module MUST only be used in conjunction with the ebXML Reliable Messaging Module (section 6) with a scheme of Once-And-Only-Once (sections 6.6). If a sequence is sent and one message fails to arrive at the To Party MSH, all subsequent messages will also fail to be presented to the To Party Application (see status attribute section 9.1.1).
+> The MessageOrder module allows messages to be presented to the To Party in a particular order. This is accomplished through the use of the MessageOrder element. Reliable Messaging MUST be used when a MessageOrder element is present.
+> MessageOrder module MUST only be used in conjunction with the ebXML Reliable Messaging Module (section 6) with a scheme of Once-And-Only-Once (sections 6.6). If a sequence is sent and one message fails to arrive at the To Party MSH, all subsequent messages will also fail to be presented to the To Party Application (see status attribute section 9.1.1).
 
 ## MessageOrder Element**
 
-The MessageOrder element is an OPTIONAL extension to the SOAP Header requesting the preservation of message order in this conversation.
+> The MessageOrder element is an OPTIONAL extension to the SOAP Header requesting the preservation of message order in this conversation.
 
 De ebMS standaard biedt daarmee de mogelijkheid om de volgordelijkheid van berichten te garanderen.
 
-Maar het is wel een OPTIONAL<sup>7</sup> element, dus bekijk per product of het ook daadwerkelijk ondersteund wordt.
+Maar het is wel een OPTIONAL<sup>6</sup> element, dus bekijk per product of het ook daadwerkelijk ondersteund wordt.
 
-<sup>7</sup>: OPTIONAL, uit [[EBXML-MSG]]: “This word means that an item is truly optional. One vendor may choose to include the item because a particular marketplace requires it or because the vendor feels that it enhances the product while another vendor may omit the same item.”
+> <sup>6</sup>. OPTIONAL, uit [[EBXML-MSG]]: “This word means that an item is truly optional. One vendor may choose to include the item because a particular marketplace requires it or because the vendor feels that it enhances the product while another vendor may omit the same item.”
 
 ## Productondersteuning
 
@@ -52,7 +51,7 @@ Als het niet mogelijk is om de MessageOrder functionaliteit te gebruiken, kan ze
 
 Als uitgangspunt voor de realisatie van de volgordelijkheid kan het Resequencer patroon gebruikt worden: [http://www.enterpriseintegrationpatterns.com/Resequencer.html](http://www.enterpriseintegrationpatterns.com/Resequencer.html)
 
----
+<aside class="example">
 
 A [Message Router](http://www.enterpriseintegrationpatterns.com/MessageRouter.html) can route messages from one channel to different channels based on message content or other criteria. Because individual messages may follow different routes, some messages are likely to pass through the processing steps sooner than others, resulting in the messages getting out of order. However, some subsequent processing steps do require in-sequence processing of messages, for example to maintain referential integrity.
 
@@ -64,7 +63,7 @@ A [Message Router](http://www.enterpriseintegrationpatterns.com/MessageRouter.ht
 
 The Resequencer can receive a stream of messages that may not arrive in order. The Resequencer contains in internal buffer to store out-of-sequence messages until a complete sequence is obtained. The in-sequence messages are then published to the output channel. It is important that the output channel is order-preserving so messages are guaranteed to arrive in order at the next component. Like most other routers, a Resequencer usually does not modify the message contents.  
 
----
+</aside>
 
 De oplossingsrichtingen voor berichten waarvoor een volgnummer van belang is wordt hieronder globaal beschreven. Er wordt uitgegaan van een 'push' mechanisme: de ontvangende applicatie wordt dus actief doordat de ebMS adapter een functie van de applicatie aanroept voor het afleveren van een bericht (bijvoorbeeld met behulp van een web service of JMS queue). Dit in tegenstelling tot een 'pull' mechanisme waarbij het initiatief bij de applicatie ligt om te bepalen of er een nieuw bericht is ontvangen.
 
diff --git a/js/config.js b/js/config.js
index e92b235..808ccd2 100644
--- a/js/config.js
+++ b/js/config.js
@@ -5,8 +5,7 @@ var respecConfig = {
       } ],
   authors: [ { 
         "mailto" : "digikoppeling@logius.nl",
-        "name" : "Logius",
-        "url" : "https://logius.nl/standaarden"
+        "name" : "Logius"
       } ],
   editors: [ 
       { 
@@ -18,16 +17,21 @@ var respecConfig = {
         "company" : "Logius",
         "name" : "Pieter Hering",
         "url" : "https://logius.nl/standaarden"
+      },
+      { 
+        "company" : "Logius",
+        "name" : "Martin van der Plas",
+        "url" : "https://logius.nl/standaarden"
       }
     ],
   github: "https://github.com/Logius-standaarden/Digikoppeling-Best-Practices-ebMS2",
   previousMaturity: "DEF",
-  previousPublishDate: "2019-05-16",
-  previousPublishVersion: "3.2",
+  previousPublishDate: "2022-04-11",
+  previousPublishVersion: "3.2.1",
   pubDomain: "dk",
-  publishDate: "2022-04-11",
-  publishVersion: "3.2.1",
+  publishDate: "2023-05-31",
+  publishVersion: "3.2.2",
   shortName: "bpebms",
-  specStatus: "DEF",
+  specStatus: "WV",
   specType: "BP"
 };

From b0036934e85f6adb9d4c2a97f61772a2c8f71f19 Mon Sep 17 00:00:00 2001
From: Martin van der Plas <martinvanderplas@gmail.com>
Date: Thu, 1 Jun 2023 11:04:56 +0200
Subject: [PATCH 2/3] Update ch01_Inleiding.md

Co-authored-by: Alexander Green <alexander.green@logius.nl>
---
 ch01_Inleiding.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ch01_Inleiding.md b/ch01_Inleiding.md
index ea876c0..9e863c3 100644
--- a/ch01_Inleiding.md
+++ b/ch01_Inleiding.md
@@ -104,7 +104,7 @@ Hoofdstuk 3 gaat in op de kenmerken van een CPA.
 
 Hoofdstuk 4 gaat over bericht volgordelijkheid.
 
-> Begrippen en afkortingen worden toegelicht in het document “DigikoppelingArchitectuur”.  
+> Begrippen en afkortingen worden toegelicht in het document [[Digikoppeling-Architectuur]].  
 > Dit document is onderdeel van de Digikoppeling standaard.
 
 <div class="note">Dit document en alle andere Digikoppeling documentatie is beschikbaar op <a href="http://www.logius.nl/digikoppeling">Logius.nl/digikoppeling</a>.

From 6ea8133f6bbcb5560a44f58c6ce40f1f5f8154da Mon Sep 17 00:00:00 2001
From: Martin van der Plas <martinvanderplas@gmail.com>
Date: Thu, 1 Jun 2023 11:05:17 +0200
Subject: [PATCH 3/3] Update ch03_CPA Gebruik en Kenmerken.md

Co-authored-by: Alexander Green <alexander.green@logius.nl>
---
 ch03_CPA Gebruik en Kenmerken.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/ch03_CPA Gebruik en Kenmerken.md b/ch03_CPA Gebruik en Kenmerken.md
index 33d71c7..f28cdd4 100644
--- a/ch03_CPA Gebruik en Kenmerken.md	
+++ b/ch03_CPA Gebruik en Kenmerken.md	
@@ -49,8 +49,6 @@ De kenmerken zijn vertaald naar relevante onderdelen van een CPA. Deze CPA onder
 
 ### Service
 
-- Service
-
     Een Service is een unieke aanduiding voor een set van samenhangende operaties.
 
     De service moet uniek zijn. Advies voor de naamgeving is als volgt: