Handleiding-Decentrale-Validatie-Service.md

@@ -90,6 +90,13 @@ docker run -itp 8080:8080 registry.istandaarden.nl/modules/dvs:latest
 Dit zal de container starten waarna de applicatie bereikt kan worden op poort 8080
 Bij het opstarten worden automatisch de meest recente versie van de standaarden gedownload als er een internetverbinding beschikbaar is. Daarnaast wordt in een continu draaiende container elke dag om 03:00 de laatste versie van de standaarden opgehaald. 
 
+Alle verzoeken moeten een ``Content-Type`` header bevatten met de waarde ``application/x-www-form-urlencoded`` en een correcte ``Content-Length`` header.
+
+## Vanaf versie 1.1: ## ondersteunen aanroepen een ``X-Version-Override header waarmee het patchniveau van de standaard kan worden overschreven. Als deze waarde niet in het verzoek aanwezig is, wordt de standaard patch versie gebruikt (welke overeen komt met de validatiedatum, niet met de dagtekening). Als het gevraagde patchniveau niet of niet langer wordt ondersteund, wordt een foutcode 400 geretourneerd. 
+
+## Let op: ## Automatische updates kunnen patchniveaus introduceren en verwijderen, dus de software die de aanroep doet zou een zinvolle standaard behandeling moeten hebben voor niet-ondersteunde patchniveaus.
+
+
 ### Controleren van de status van de applicatie ###
 
 Ten behoeve van het beheer van de DVS en integratie met systemen die ervoor zorgen dat deze ten alle tijden beschikbaar is kan de status van de applicatie opgevraagd worden via de /status resource.
@@ -131,6 +138,12 @@ Een voorbeeld voor als de DVS op een lokale machine draait is:
 ```
 curl -X POST –i –v --data-binary @bericht.xml localhost:8080/validatie
 ```
+
+Voorbeeld voor validatie met iWmo/iJw 3.0.3 voor DVS 1.1.0 en nieuwer:
+```
+curl -X POST -H "X-Version-Override: 3.0.3" --data-binary @bericht.xml localhost:8080/validatie
+```
+
 De respons is een rapport.
 
 ![valideren_van_een_bericht](uploads/ba902c6fec4814f0752b61bfaf49a360/valideren_van_een_bericht.png) 
@@ -157,6 +170,10 @@ Een voorbeeld voor als de DVS op een lokale machine draait is:
 ```
 curl -X POST --data-binary @heenbericht.xml localhost:8080/retour
 ```
+Voorbeeld voor validatie met iWmo/iJw 3.0.3 voor DVS 1.1.0 en nieuwer:
+```
+curl -X POST -H "X-Version-Override: 3.0.3" --data-binary @heenbericht.xml localhost:8080/retour
+```
 De response is het complete retourbericht
 
 ![Het_genereren_van_een_retourbericht](uploads/c055af6786647a92670853ae1bb7bf02/Het_genereren_van_een_retourbericht.png) 
@@ -180,9 +197,33 @@ Mocht er bij het aanroepen van de DVS wat fout gaan, of als de DVS het bericht n
 | Foutcode  | Betekenis |
 | ------ | ------ |
 |  200   | Het heenbericht is technisch in orde, zie de respons voor functionele fouten |
+|  400   | Ongeldig verzoek, de gebruiker heeft een patch versie opgegeven die niet of niet meer in gebruik is. |
 |  404   | Ongeldig verzoek, verzoek gebruikt de verkeerde HTTP methode of wordt gedaan op de verkeerde resource | 
 |  406   | Ongeldig verzoek, het verzonden bericht kom niet overeen met een bekend schema. (Dit kan komen door een niet ondersteund type bericht of door een technische fout in het bericht) | 
 |  411   | Ongeldig verzoek, de Content-Length header ontbreekt | 
 |  415   | Ongeldig verzoek, het Content-Type moet ‘application/x-www-form-urlencoded’ zijn |
 |  500   | Er is een fout opgestreden in de DVS |
 
+### Bijlage iWmo en iJw ###
+
+Voor de iWmo en iJw resulteert dit in de volgende services:
+De reactie van de DVS is afhankelijk van het verzoek aan de DVS en het bericht. Voor ieder bericht kan een validatie worden uitgevoerd. Afhankelijk van het soort bericht is dit tegen de XSD of zowel XSD als XSLT. Indien er in de iStandaard een retourbericht is gedefinieerd op een heenbericht, kan de DVS ook een retourbericht genereren. In onderstaande tabel kunt u zien wat de reactie van de DVS is afhankelijk van het verzoek.
+
+| Soort Bericht | Valideer bericht    | Genereer Retourbericht |
+|---------------|---------------------|------------------------|
+| 301           | Validatie XSD/XSLT  | 302 Retourbericht      |
+| 302           | Validatie XSD       |                        |
+| 303           | Validatie XSD/XSLT  |                        |
+| 304           | Validatie XSD/XSLT  |                        |
+| 305           | Validatie XSD/XSLT  | 306 Retourbericht      |
+| 306           | Validatie XSD       |                        |
+| 307           | Validatie XSD/XSLT  | 308 Retourbericht      |
+| 308           | Validatie XSD       |                        |
+| 315           | Validatie XSD/XSLT  | 316 Retourbericht      |
+| 316           | Validatie XSD       |                        |
+| 317           | Validatie XSD/XSLT  | 318 Retourbericht      |
+| 318           | Validatie XSD       |                        |
+| 319           | Validatie XSD/XSLT  | 320 Retourbericht      |
+| 320           | Validatie XSD       |                        |
+| 323           | Validatie XSD/XSLT  |                        |
+| 325           | Validatie XSD/XSLT  |                        |
\ No newline at end of file