Versies vergeleken

Oude versie 4

changes.mady.by.user Remco Beverdam

Opgeslagen op

in vergelijking met

Nieuwe versie 5

changes.mady.by.user Remco Beverdam

Opgeslagen op

Sleutel

  • Deze regel is toegevoegd.
  • Deze regel is verwijderd.
  • Formattering is gewijzigd.
Pagina-eigenschappen
idSamenvatting 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
colourGreen
titleHDN-24

Geldig vanaf datum

Impact op

Status
colourBlue
titleOfferTeaanvraag (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 4d: Aanbieder: Externe bron

  • Rol 4e: Aanbieder: Waarborgen

Type ketenafspraak

  • Procesafspraak

Van toepassing op de velden

RequestVersion (JSON veld)

Van toepassing op de entiteiten

-

...

  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 (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

      1. AX OfferteAanvraag

      2. KX KredietAanvraag

      3. LX LevenAanvraag

      4. WX WaarborgBericht

  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 van de volgende messageType

    1. AX OfferteAanvraag

    2. KX KredietAanvraag

    3. LX LevenAanvraag

    4. WX WaarborgBericht

  5. Het is verplicht de SX 40 Gewijzigde aanvraag ingestuurd met daarin het veld NieuweAanvraagVersie te kunnen verwerken.

  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 (JSON naam) verzenddatum en tijd van de laatste SX 40 Gewijzigde aanvraag ingestuurd die is binnen gekomen.

    2. De Verzenddatum (JSON naam) 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:

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

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

  7. 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: 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.

    2. Het is niet toegestaan nog een DocumentBericht DX te versturen op een DA met een verouderde requestVersion. Om documenten te versturen moet gewacht worden op een DA met de nieuwe requestVersion.

...

  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 (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

      1. AX OfferteAanvraag

      2. KX KredietAanvraag

      3. LX LevenAanvraag

      4. WX WaarborgBericht

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

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

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

    1. De Verzenddatum (JSON naam) verzenddatum en tijd van de laatste SX 40 Gewijzigde aanvraag ingestuurd die is binnen gekomen.

    2. De Verzenddatum (JSON naam) verzenddatum en tijd van het laatst verstuurde bericht van dezelfde messageType in het dossier.

    3. De Verzenddatum (JSON naam) 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:

      1. 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.

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

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

  5. 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 requestVersionHet geldt dus niet als Rol 1 of Rol 2 deze requestVersion heeft geïntroduceerd.

  6. 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:

    1. via SX 40 Gewijzigde aanvraag ingestuurd ontvangen of

    2. 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 DocumentBericht DX te versturen op een DA met een verouderde requestVersion. Om documenten te versturen moet gewacht worden op een 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 DocumentBericht (DX)) naar Rol 4 te versturen.

Vereisten voor Rol 4: Aanbieder

  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) verstuurt worden:

    1. In geval van een binnenkomende OfferteAanvraag (AX)

      1. StatusAXBerichtType moet gevuld zijn met 14 Offerteaanvraag niet te verwerken, zie toelichting

      2. In de tekstregels moet zijn opgenomen dat de genoemde requestVersion niet wordt ondersteund.

      3. De requestVersion van dit bericht moet de requestVersion bevatten van het binnenkomende bericht.

    2. In geval van een een binnenkomende LevenAanvraag (LX):

      1. StatusLXBerichtType moet gevuld zijn met 13 Levenaanvraag niet te verwerken, zie toelichting

      2. In de tekstregels moet zijn opgenomen dat de ingestuurde requestVersion niet wordt ondersteund.

      3. De requestVersion van dit bericht moet de requestVersion bevatten van het binnenkomende bericht.

    3. In geval van een binnenkomende KredietAanvraag (KX):

      1. StatusKXBerichtType moet gevuld zijn met 03 Kredietaanvraag niet te verwerken, zie toelichting

      2. In de tekstregels moet zijn opgenomen dat de ingestuurde requestVersion niet wordt ondersteund.

      3. De requestVersion van dit bericht moet de requestVersion bevatten van het binnenkomende bericht.

    4. In geval van een binnenkomende WaarborgBericht (WX):

      1. StatusWXBerichtType moet gevuld zijn met 14 Bankgarantieaanvraag niet te verwerken, zie toelichting

      2. In de tekstregels moet zijn opgenomen dat de ingestuurde requestVersion niet wordt ondersteund.

      3. De requestVersion van dit bericht moet de requestVersion bevatten van het binnenkomende bericht.

    5. 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).

  4. 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:

      1. een bericht met daarin de nieuwe requestVersion ontvangen te hebben

    2. Het is dus niet toegestaan nog een StatusMelding (SX) te versturen waarin bijvoorbeeld de vorige requestVersion wordt beëindigd.

    3. Dit betekent ook dat de rest van de keten bijvoorbeeld geen documenten meer mag insturen. Dit kan pas weer als er een nieuw DocumentAanvraag (DA) bericht is opgestuurd, waarin de nieuwe requestVersion staat.

...