Pagina-vergelijking

Pagina-eigenschappen

id

Samenvatting Geïntroduceerd in HDN-versie Geldig vanaf datum Impact op / // / / / / / / / / / / /// / / / / / / / / / Relevant voor rollen Rol 1: Softwarepaketten (voorkant) Rol 2: Tussenstations zonder aanpassingen Rol 3: Tussenstations met aanpassingen Rol 4: Aanbieder: Hypotheken Rol 4: Aanbieder: Verzekeren Rol 4: Aanbieder: Kredieten Rol 4: Aanbieder: Externe bron Rol 5: Intermediar Type ketenafspraak Inrichting schema’s Vulling berichten Procesafspraak Verduidelijking omgaan met vulling van velden Gerelateerde velden Veldnaam Gerelateerde entiteiten Entiteitnaam

Samenvatting

Deze ketenafspraak regelt hoe het veld requestVersion in de HDN-API moet worden gevuld bij het plaatsen van HDN-berichten op het platform. De requestVersion wordt gebruikt om een gewijzigde aanvraag door te geven. Ook wordt er per rol ingegaan op wat er moet gebeuren indien een nieuwe requestVersion wordt geïntroduceerd en wat er moet gebeuren als deze binnen komt.

Geïntroduceerd in HDN-versie

Status

colour	Green
title	HDN-24

Geldig vanaf datum

25 mei 2024

Impact op

Status

colour	Blue
title	OfferTeaanvraag (AX)

Relevant voor rollen

Rol 1: Softwarepakketten (voorkant)
Rol 2: Tussenstations zonder aanpassingen
Rol 3: Tussenstations met aanpassingen
Rol 4a: Aanbieder: Hypotheken
Rol 4b: Aanbieder: Verzekeren
Rol 4c: Aanbieder: Kredieten
Rol 4e: Aanbieder: Waarborgen

Type ketenafspraak

Procesafspraak

Van toepassing op de velden

RequestVersion (JSON veld)

Van toepassing op de entiteiten

-

...

Een requestVersion gaat over de versie van de gehele aanvraag in een dossier op het platform. Het groepeert daarbij meerdere typen berichten.
Dit betekent dat bij bijvoorbeeld het opnieuw opsturen van een document via een
Status
colour Blue
title Document (DX)
er geen nieuwe requestVersion wordt geïntroduceerd.
Het is niet toegestaan binnen een dossier 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 OfferTeaanvraag (AX)
  /
  Status
  colour Blue
  title KredietAanvraag (KX)
  Status
  colour Blue
  title Levenaanvraag (lx)
  /
  Status
  colour Blue
  title Waarborg (wx)
Het is verplicht in het eerste bericht in een dossier het veld requestVersion in de JSON met 1 te vullen
Het is alleen toegestaan een nieuwe requestVersion te introduceren bij het plaatsen van een bericht met één van de volgende messageType
Status
colour Blue
title OfferTeaanvraag (AX)
/
Status
colour Blue
title KredietAanvraag (KX)
/
Status
colour Blue
title Waarborg (wx)
Het is verplicht de
Status
colour Blue
title Statusmelding (Sx)
40 Gewijzigde aanvraag ingestuurd met daarin het veld NieuweAanvraagVersie te kunnen verwerken.
Wanneer er wordt gekozen om requestVersion te wijzigen moet de nieuwe waarde bepaald worden door de volgende informatie op te halen:
De verzenddatum en tijd van de laatste
het laatste bericht in het dossier te pakken en de requestVersion van dat bericht te verhogen met 1.
1. In het geval de
  Ter verduidelijking: dit kan een bericht zijn van elk messageType, dus ook
  Status
  colour Blue
  title Statusmelding Documentaanvraag (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:
  DA)
  ,
  Status
  colour Blue
  title Offerte (OX)
  en
  Status
  colour Blue
  title
  Statusmelding
  StatusMelding (
  Sx)40 Gewijzigde aanvraag ingestuurd het laatste bericht is, moet de waarde in het veld NieuweAanvraagVersie uit deze worden opgehaald.In het geval het laatst verstuurde bericht van dezelfde messageType de laatste is, moet de requestVersion van dat bericht worden verhoogd met 1
  SX)
  .
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
Status
colour Blue
title Statusmelding (Sx)
40 Gewijzigde aanvraag ingestuurd ontvangen of door zelf een nieuw bericht met nieuwe
requestVersion
op het platform geplaatst te hebben
.
1. 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
  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.
Het is verplicht een bericht dat ontvangen wordt met een requestVersion die niet bekend is te verwerken
Achtergrond: Bovenstaande regels sluiten niet uit dat meerdere partijen in de keten dezelfde requestVersion introduceren in een dossier, bijvoorbeeld in het geval van een serviceprovider die een versie verhoogd. Het is dus van belang dat ook berichten die ontvangen worden met een requestversiondie niet bekend is, ook verwerkt kunnen worden. Een voorbeeld is een
Status
colour Blue
title Offerte (OX)
met een requestversion die niet bekend is omdat een Rol 3 een wijziging gedaan heeft.

Vereisten voor Rol 2: Tussenstations zonder aanpassingen

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
Status
colour Blue
title Document (DX)
er geen nieuwe requestVersion wordt geïntroduceerd.
Het is verplicht een aanvraag met een requestversion > 1 te kunnen herkennen en verwerken.
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 OfferTeaanvraag (AX)
  /
  Status
  colour Blue
  title KredietAanvraag (KX)
  /
  Status
  colour Blue
  title Waarborg (wx)
  /
  Status
  colour Blue
  title LevenAanvraag (LX)
  
  Dit betekent ook dat als een bericht ontvangen wordt dat hier niet aan voldoet, deze niet mag worden verwerkt.
Het is niet toegestaan een nieuwe requestVersion in het dossier te introduceren.
Wanneer een nieuwe requestVersion bekend is bij de partij mag er niet meer gereageerd worden op berichten van de oude requestVersion.
1. Bekend zijn kan betekenen:
2. via
  Status
  colour Blue
  title Statusmelding (Sx)
  40 Gewijzigde aanvraag ingestuurd ontvangen of
Het is verplicht een bericht dat ontvangen wordt met een requestVersion die niet bekend is te verwerken.
Achtergrond: Bovenstaande regels sluiten niet uit dat meerdere partijen in de keten dezelfde requestVersion introduceren in een dossier, bijvoorbeeld in het geval van een serviceprovider die een versie verhoogd. Het is dus van belang dat ook berichten die ontvangen worden met een requestversiondie niet bekend is, ook verwerkt kunnen worden. Een voorbeeld is een
Status
colour Blue
title Offerte (OX)
met een requestversion die niet bekend is omdat een Rol 3 een wijziging gedaan heeft.

Vereisten voor Rol 3: Tussenstations met aanpassingen

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
Status
colour Blue
title Document (DX)
er geen nieuwe requestVersion wordt geïntroduceerd.
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 OfferTeaanvraag (AX)
  /
  Status
  colour Blue
  title KredietAanvraag (KX)
  /
  Status
  colour Blue
  title Waarborg (wx)
  Dit betekent ook dat als een bericht ontvangen wordt dat hier niet aan voldoet, deze niet mag worden verwerkt.
  /
  Status
  colour Blue
  title LevenAanvraag (LX)
Het is verplicht een aanvraag met een requestversion > 1 te kunnen herkennen en verwerken.
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 .
Wanneer een aanvraagbericht ontvangen wordt met een requestVersion welke al bekend is bij deze rol, is het verplicht dit bericht door te sturen met een geupdate 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.
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
  Status
  colour Blue
  title Statusmelding (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 StatuscolourBluetitle
  Statusmelding (Sx) 40 Gewijzigde aanvraag ingestuurd het laatste bericht is, moet de waarde in het veld NieuweAanvraagVersie uit deze
  Status
  colour Blue
  title Statusmelding (Sx)
  worden opgehaald.In het geval het laatst verstuurde bericht van dezelfde messageType de laatste is, moet de requestVersion van dat bericht worden verhoogd met 1.
  In het geval het laatst ontvangen bericht van dezelfde messageType de laatste is, moet de requestVersion van dat bericht worden verhoogd met 1.
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
Status
colour Blue
title Statusmelding (Sx)
40 Gewijzigde aanvraag ingestuurd te versturen naar deze partij
met
daarin in het veld NieuweAanvraagVersie = huidige requestVersion +
1
en requestVersion in de JSON = huidige requestVersion.
Optioneel kan met de entiteit TekstRegels opgegeven worden wat de inhoudelijke wijzigingen zijn
.
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
Status
colour Blue
title Statusmelding (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.

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 dus niet toegestaan nog een

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.

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
Status
colour Blue
title Document (DX)
) naar Rol 4 te versturen.
...
Het is niet toegestaan een nieuwe requestVersion in het dossier te introduceren.
Het is verplicht een aanvraag met een requestversion > 1 op te kunnen halen.
Indien er niet omgaan kan worden met een verhoogde requestVersion moet er een
Status
colour Blue
title Statusmelding (Sx)
verstuurd worden. De melding hierin is afhankelijk van de procesflow van het berichttype Procesbeschrijvingen
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.
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). Hoe willen we hier mee omgaan?
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:
een bericht met daarin de nieuwe requestVersion ontvangen te hebben
Het is dus niet toegestaan nog een
Status
colour Blue
title Statusmelding (Sx)
te versturen waarin bijvoorbeeld de vorige requestVersion wordt beëindigd.
Dit betekent ook dat de rest van de keten bijvoorbeeld geen documenten meer mag insturen. Dit kan pas weer als er een nieuw
Status
colour Blue
title Documentaanvraag (DA)
bericht is opgestuurd, waarin de nieuwe requestVersion staat.
...
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
Status
colour Blue
title 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. 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.
...

Versies vergeleken

Oude versie 11

Nieuwe versie 12

Sleutel

Vereisten voor Rol 2: Tussenstations zonder aanpassingen

Vereisten voor Rol 3: Tussenstations met aanpassingen

Out of scope