🤝 Ketenafspraak

...

...

Gezien de complexiteit van dit issue is het wellicht verstandig hier nog de scenario’s toe te voegen die 2023-10-20 Notulen overleg Requestversion in vervolgberichten besproken zijn. Goed idee?

Vereisten voor rol 1 Softwarepakketten (voorkant)

1. Een requestVersion gaat over de versie van de gehele aanvraag in 1 een dossier op het platform. Het groepeert daarbij meerdere typen berichten.
   Dit betekent dat bij bijvoorbeeld het opnieuw opsturen van een document via een DocumentBericht

   Status
   colour Blue title Document (DX)

   er geen nieuwe requestVersion wordt geïntroduceerd.

2. Het is niet toegestaan binnen een dossier 2x twee maal een HDN-bericht van hetzelfde messageType, receiver, sender enrequestVersion op het platform te plaatsen.

   1. Dit geldt alleen voor de volgende messageType

      Status
      colour Blue title

   2. AX OfferteAanvraag

   3. KX KredietAanvraag

   4. LX LevenAanvraag

   WX WaarborgBericht

   OfferTeaanvraag (AX)

   /

   Status
   colour Blue title KredietAanvraag (KX)

   Status
   colour Blue title Levenaanvraag (lx)

   /

   Status
   colour Blue title WaarborgBERICHT (wx)

3. Het is verplicht in het eerste bericht in een dossier het veld requestVersion in de JSON met 1 te vullen

4. Het is alleen toegestaan een nieuwe requestVersion te introduceren bij het plaatsen van een bericht met 1 één van de volgende messageType Het is verplicht de SX 40 Gewijzigde aanvraag ingestuurd met daarin het veld NieuweAanvraagVersie te kunnen verwerken.

   Status
   colour Blue

   1. AX OfferteAanvraag

   2. KX KredietAanvraag

   3. LX LevenAanvraag

   4. WX WaarborgBericht

   title OfferTeaanvraag (AX)

   /

   Status
   colour Blue title KredietAanvraag (KX)

   /

   Status
   colour Blue title Levenaanvraag (lx)

   /

   Status
   colour Blue title WaarborgBERICHT (wx)

5. Wanneer er wordt gekozen om requestVersion te wijzigen moet de nieuwe waarde bepaald worden door de volgende informatie op te halen:

6. De verzenddatum en tijd van de laatste SX 40 Gewijzigde aanvraag ingestuurd die is binnen gekomen.

De verzenddatum en tijd van het laatst verstuurde bericht van dezelfde messageType in het dossier.
Van a en b moet het nieuwste bericht gekozen worden. De nieuwe requestVersion moet dan als volgt worden berekend:

7. In het geval de SX 40 Gewijzigde aanvraag ingestuurd het laatste bericht is, moet de waarde in het veld NieuweAanvraagVersie uit deze SX worden opgehaald en worden verhoogd met 1.

In het geval het laatst verstuurde bericht van dezelfde messageType de laatste is, moet de requestVersion van dat bericht worden verhoogd met 1.

het laatste bericht in het dossier te pakken en de requestVersion van dat bericht te verhogen met 1.
Ter verduidelijking: dit kan een bericht zijn van elk messageType, dus ook

Status
colour Blue title Documentaanvraag (DA)

,

Status
colour Blue title Offerte (OX)

en

Status
colour Blue title StatusMelding (SX)

. Zodoende kan de situatie worden ondersteund dat een HDN-bericht verderop in de keten wordt verhoogd en er daardoor meerdere keren dezelfde requestVersion wordt gemaakt.
Voorbeeld: Een adviespakket (rol 1) stuurt requestVersion=1 naar een serviceprovider (rol 3). Deze maakt een wijziging en introduceert requestVersion=2. De aanbieder stuurt daarop een

Status
colour Blue title StatusMelding (SX)

met requestVersion=2terug. De serviceprovider stuurt deze weer terug naar het adviespakket. Wanneer je in het adviespakket een nieuwe requestVersion wilt introduceren moet dit de waarde 3 hebben. Deze moet gebaseerd zijn het op het laatste bericht dat het adviespakket heeft ontvangen, de

Status
colour Blue title StatusMelding (SX)

(2) + 1=3

8. Wanneer een nieuwe requestVersion bekend is bij de partij mag er niet meer gereageerd worden op berichten van de oude requestVersion.
   

   Bekend zijn kan betekenen: via SX 40 Gewijzigde aanvraag ingestuurd ontvangen of door zelf een nieuw bericht met nieuwe requestVersion op het platform geplaatst te hebben.
   

   Ter verduidelijking:

   de verplichting geldt pas als het bericht op het platform geplaatst is, enkel het aanmaken maar nog niet op het platform gezet telt hierin niet mee.

   Het is niet toegestaan nog een

   DocumentBericht DX

   Status
   colour Blue title Document (DX)

   te versturen op een

   Status
   colour Blue title Documentaanvraag (DA)

   met een verouderde requestVersion. Om documenten te versturen moet gewacht worden op een

   Status
   colour Blue title Documentaanvraag (DA)

   met de nieuwe requestVersion.

   1. Uitzondering: Dit geldt niet indien de nieuwe requestVersion niet geaccepteerd is bij de aanbieder, zie daarvoor punt 3 bij Aanbieder. In dat geval mogen berichten met de oude versie worden blijven uitgewisseld.

9. Het is verplicht een bericht dat ontvangen wordt met een requestVersion die niet bekend is te verwerken.
   Achtergrond: Deze regel is noodzakelijk omdat het mogelijk is dat ook rol 3 een nieuwe requestVersion kan introduceren. Daarmee kan in Rol 1 dus ook retourberichten ontvangen op een requestVersion die nog niet bekend is.

Vereisten voor Rol 2: Tussenstations zonder aanpassingen

1. Een requestVersion gaat over de versie van de gehele aanvraag in 1 dossier op het platform. Het groepeert daarbij meerdere typen berichten.
   Dit betekent dat bij bijvoorbeeld het opnieuw opsturen van een document via een DocumentBericht

   Status
   colour Blue title Document (DX)

   er geen nieuwe requestVersion wordt geïntroduceerd.

2. Het is verplicht een aanvraag met een requestversion > 1 te kunnen herkennen en verwerken.

3. Het is niet toegestaan binnen een dossier 2x een HDN-bericht van hetzelfde messageType, receiver, sender enrequestVersion op het platform te plaatsen.

   1. Dit geldt alleen voor de volgende messageType

      Status
      colour Blue title

   2. AX OfferteAanvraag

   3. KX KredietAanvraag

   4. LX LevenAanvraag

   WX WaarborgBericht
   Dit betekent ook dat als een bericht ontvangen wordt dat hier niet aan voldoet, deze niet mag worden verwerkt.

   OfferTeaanvraag (AX)

   /

   Status
   colour Blue title KredietAanvraag (KX)

   /

   Status
   colour Blue title WaarborgBERICHT (wx)

   /

   Status
   colour Blue title LevenAanvraag (LX)

4. Het is niet toegestaan een nieuwe requestVersion in het dossier te introduceren.

5. Wanneer een nieuwe requestVersion bekend is bij de partij mag er niet meer gereageerd worden op berichten van de oude requestVersion.
   Bekend zijn

   kan betekenen:

6. via SX 40 Gewijzigde aanvraag ingestuurd ontvangen of

door zelf een nieuw

betekent er is een bericht met nieuwe requestVersion

op het platform geplaatst te hebben

opgehaald door deze partij.


Ter verduidelijking: de verplichting geldt pas als het bericht op het platform geplaatst is, enkel het aanmaken maar nog niet op het platform gezet telt hierin niet mee.



Voorbeeld: Het is niet toegestaan nog een

DocumentBericht DX

Status
colour Blue title Document (DX)

te versturen op een

Status
colour Blue title Documentaanvraag (DA)

met een verouderde requestVersion. Om documenten te versturen moet gewacht worden op een

Status
colour Blue title Documentaanvraag (DA)

met de nieuwe requestVersion.

1. Uitzondering: Dit geldt niet indien de nieuwe requestVersion niet geaccepteerd is bij de aanbieder, zie daarvoor punt 3 bij Aanbieder. In dat geval mogen berichten met de oude versie worden blijven uitgewisseld.

7. Het is verplicht een bericht dat ontvangen wordt met een requestVersion die niet bekend is te verwerken.
   Achtergrond: Deze regel is noodzakelijk omdat het mogelijk is dat ook rol 3 een nieuwe requestVersion kan introduceren. Daarmee kan in Rol 2 dus ook retourberichten ontvangen op een requestVersion die nog niet bekend is.

Vereisten voor Rol 3: Tussenstations met aanpassingen

1. Een requestVersion gaat over de versie van de gehele aanvraag in 1 dossier op het platform. Het groepeert daarbij meerdere typen berichten.
   Dit betekent dat bij bijvoorbeeld het opnieuw opsturen van een document via een DocumentBericht

   Status
   colour Blue title Document (DX)

   er geen nieuwe requestVersion wordt geïntroduceerd.

2. Het is niet toegestaan binnen een dossier 2x een HDN-bericht van hetzelfde messageType, receiver, sender enrequestVersion op het platform te plaatsen.

   1. Dit geldt alleen voor de volgende messageType

      Status
      colour Blue title

   2. AX OfferteAanvraag

   3. KX KredietAanvraag

   4. LX LevenAanvraag

   WX WaarborgBericht
   Dit betekent ook dat als een bericht ontvangen wordt dat hier niet aan voldoet, deze niet mag worden verwerkt.

   OfferTeaanvraag (AX)

   /

   Status
   colour Blue title KredietAanvraag (KX)

   /

   Status
   colour Blue title WaarborGBERICHT (wx)

   /

   Status
   colour Blue title LevenAanvraag (LX)

3. Het is verplicht een aanvraag met een requestversion > 1 te kunnen herkennen en verwerken.

4. De partij is verplicht de requestVersion te wijzigen in het bericht wat wordt doorgestuurd wanneer er aanpassingen worden gedaan in het ontvangen HDN-bericht en deze niet tot de uitzonderingen behoren zoals gedefinieerd https://hdnstandaarddocumentatie.wikipage.io/c/2267021563/tussenpersoon+en+serviceprovidergegevens .

5. Wanneer een aanvraagbericht ontvangen wordt met een requestVersion welke al bekend is, is het verplicht dit bericht door te sturen met een ge-update requestVersion, welke 1 hoger is dan de requestVersion die bekend is.
   Voorbeeld: rol 3 verhoogt de requestVersion van een ontvangen aanvraag naar 2 en stuurt deze door. Als op een later moment ook een partij in rol 1 de requestVersion verhoogt en hierbij ook 2 gebruikt, moet de partij in rol 3 deze requestVersion verhogen naar 3.

6. Wanneer er wordt gekozen om requestVersion te wijzigen moet de nieuwe waarde bepaald worden door de volgende informatie op te halen:

   1. De verzenddatum en tijd van de laatste SX 40 Gewijzigde aanvraag ingestuurd die is binnen gekomen.De verzenddatum en tijd van het laatst verstuurde bericht van dezelfde messageType in het dossier.

   2. De verzenddatum en tijd van het laatst ontvangen bericht van dezelfde messageType in het dossier.

      
      Van a en b en c moet het nieuwste bericht gekozen worden. De nieuwe requestVersion moet dan als volgt worden berekend:

      In het geval de SX 40 Gewijzigde aanvraag ingestuurd het laatste bericht is, moet de waarde in het veld NieuweAanvraagVersie uit deze SX worden opgehaald en worden verhoogd met 1.

      1. In het geval het laatst verstuurde bericht van dezelfde messageType de laatste is, moet de requestVersion van dat bericht worden verhoogd met 1.

      2. In het geval het laatst ontvangen bericht van dezelfde messageType de laatste is, moet de requestVersion van dat bericht worden verhoogd met 1.

7. Wanneer er een nieuwe requestVersion wordt geïntroduceerd door deze partij is het verplicht dit aan rol 1 en rol 2 te laten weten. Dit moet gedaan worden door een SX 40 Gewijzigde aanvraag ingestuurd te versturen naar deze partij met daarin in het veld NieuweAanvraagVersie de waarde van de nieuwe requestVersion.

   1. De requestVersion die opgevoerd wordt bij deze SX is de oude requestVersion

   Wanneer een nieuwe requestVersion bekend is bij de partij mag er niet meer gereageerd worden op berichten van de oude requestVersion. Bekend zijn kan betekenen:

8. via SX 40 Gewijzigde aanvraag ingestuurd ontvangen of

betekent: een bericht met daarin de nieuwe requestVersion ontvangen te hebben of door zelf een nieuw bericht met nieuwe requestVersion op het platform geplaatst te hebben.

...

1. 
   Voorbeeld: Het is dus niet toegestaan nog een

...

1. Status
   colour Blue title Document (DX)

   te versturen op een

   Status
   colour Blue title Documentaanvraag (DA)

   met een verouderde requestVersion. Om documenten te versturen moet gewacht worden op een

   Status
   colour Blue title Documentaanvraag (DA)

   met de nieuwe requestVersion.
   
   Ter verduidelijking Dit betekent ook dat zodra een nieuwe requestVersion door partij in Rol 1 of Rol 2 wordt aangeleverd de communicatie met een partij in Rol 4 komt stil te liggen. Het bericht met deze requestVersion zal eerst moeten worden doorgestuurd alvorens het weer toegestaan is berichten (bijvoorbeeld

...

1. Status
   colour Blue title Document (DX)

   ) naar Rol 4 te versturen.

a. Uitzondering: Dit geldt niet indien de nieuwe requestVersion niet geaccepteerd is bij de aanbieder, zie daarvoor punt 3 bij Aanbieder. In dat geval mogen berichten met de oude versie worden blijven uitgewisseld.

Vereisten voor

...

Rol 4a: Aanbieder: Hypotheken, Rol 4b: Aanbieder: Verzekeren, Rol 4c: Aanbieder: Kredieten, Rol 4e: Aanbieder: Waarborgen

1. Het is niet toegestaan een nieuwe requestVersion in het dossier te introduceren.

2. Het is verplicht een aanvraag met een requestversion > 1 op te kunnen halen.

3. Indien er niet omgaan kan worden met een verhoogde requestVersion moet er een StatusMelding (SX) verstuurd worden. De melding hierin is afhankelijk van de procesflow van het berichttype Procesbeschrijvingen

   Status
   colour Blue title Statusmelding (Sx)

   verstuurd worden.

   1. Deze

      Status
      colour Blue title Statusmelding (Sx)

      moet gevuld worden met de volgende informatie:

      1. In geval van

         Status
         colour Blue title OfferTeaanvraag (AX)

         : StatusAXBericht: 25 Offerte aanvraag technisch niet te verwerken

      2. In geval van

         Status
         colour Blue title KredietAanvraag (KX)

         : StatusKXBericht: 25 Kredietaanvraag technisch niet te verwerken

      3. In geval van

         Status
         colour Blue title WaarborgBERICHT (wx)

         : StatusWXBericht: 03 Bankgarantieaanvraag niet te verwerken, zie toelichting

      4. In geval van

         Status
         colour Blue title LevenAanvraag (LX)

         : StatusLXBericht: 13 Levenaanvraag niet te verwerken, zie toelichting
         Ter verduidelijking: Dit scenario kan optreden wanneer een aanbieder geen gewijzigde aanvraag meer mag ontvangen (bijvoorbeeld de scenario’s uit Wijziging op lopende aanvragen ) of wanneer de aanbieder in het geheel geen gewijzigde aanvragen ondersteunt.

   2. Uitzoekpunt: bij rol 1, 2, 3 is dan de oude requestVersion niet meer geldig. Deze kunnen dan dus ook geen Documenten hier meer op versturen. De aanvraag kan in dat geval dus alleen nog door de aanbieder verwerkt worden (SX en OX kunnen verstuurd blijven worden)In de StatusTekstRegels entiteit van deze

      Status
      colour Blue title Statusmelding (Sx)

      moet minimaal een tekst opgenomen worden met de volgende strekking: “Aanvraagversie wordt niet ondersteund”.

4. Wanneer een nieuwe requestVersion bekend is bij de partij mag er niet meer gereageerd worden op berichten van de oude requestVersion.
   Bekend zijn

   kan betekenen

   betekent:

   een bericht met daarin de nieuwe requestVersion ontvangen te hebben
   Voorbeeld: Het is dus niet toegestaan nog een

   StatusMelding (SX)

   Status
   colour Blue title Statusmelding (Sx)

   te versturen waarin bijvoorbeeld de vorige requestVersion wordt beëindigd.
   Ter verduidelijking: Dit betekent ook dat de rest van de keten bijvoorbeeld geen documenten meer mag insturen. Dit kan pas weer als er een nieuw
   DocumentAanvraag

   Status
   colour Blue title Documentaanvraag (DA)

   bericht is opgestuurd, waarin de nieuwe requestVersion staat.

   1. Uitzondering: Deze regel geldt niet indien de nieuwe requestVersion niet geaccepteerd wordt, zie daarvoor punt 3. In dat geval mogen berichten met de oude versie worden blijven uitgewisseld.

Aanleiding en achtergrond

Deze ketenafspraak is ontstaan naar aanleiding van onduidelijkheden over hoe partijen om moeten gaan met een gewijzigde aanvraag. Het was niet duidelijk met welke berichten je een wijziging mocht introduceren: zo konden niet alle partijen omgaan met het binnenkomen van DocumentBerichten

Ook was er onduidelijkheid over wie in het proces de een nieuwe requestVersion mogen maken wijzigen. Door expliciet dit aan Rol 1 en Rol 3 toe te wijzen wordt hier duidelijkheid in gegeven.Tot slot was er geen manier om als tussenstation door te geven aan de aanleverende partij dat de aanvraag is aangepast. Hierdoor kon een partij in Rol 1 niet meer een aanvraag wijzigen, omdat het een tussenstation dit al gedaan had. Met het introduceren van een nieuwe status in de StatusMelding (SX) is dit verholpen.

Out of scope

Deze ketenafspraak bepaalt niet in welke gevallen een gewijzigde requestVersion wel of niet mag worden aangeboden, zie daarvoor Wijziging op lopende aanvragen. Deze afspraak De ketenafspraak “Gebruik van requestVersion in HDN-berichten” is gemaakt om te bepalen hoe met een gewijzigde requestVersion moet worden omgegaan en welke waarde requestVersion moet hebben.

...