Versies vergeleken

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)
/
Status
colourBlue
titleKredietAanvraag (KX)
Status
colourBlue
titleLevenaanvraag (lx)
/
Status
colourBlue
titleWaarborgBERICHT (wx)

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 AanvraagVersie/ requestVersion (JSON veld)

Van toepassing op de entiteiten

-

...

  1. 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
    colourBlue
    titleDocument (DX)
    er geen nieuwe requestVersion wordt geïntroduceerd.

  2. 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
      colourBlue
      titleOfferTeaanvraag (AX)
      /
      Status
      colourBlue
      titleKredietAanvraag (KX)
      Status
      colourBlue
      titleLevenaanvraag (lx)
      /
      Status
      colourBlue
      titleWaarborg 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 één van de volgende messageType

    Status
    colourBlue
    titleOfferTeaanvraag (AX)
    /
    Status
    colourBlue
    titleKredietAanvraag (KX)
    /
    Status
    Waarborg
    colourBlue
    titleLevenaanvraag (lx)
    /
    Status
    colourBlue
    titleWaarborgBERICHT (wx)

  5. Wanneer er wordt gekozen om requestVersion te wijzigen moet de nieuwe waarde bepaald worden door 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
    colourBlue
    titleDocumentaanvraag (DA)
    ,
    Status
    colourBlue
    titleOfferte (OX)
    en
    Status
    colourBlue
    titleStatusMelding (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
    colourBlue
    titleStatusMelding (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
    colourBlue
    titleStatusMelding (SX)
    (2) + 1=3

  6. Wanneer een nieuwe requestVersion bekend is bij de partij mag er niet meer gereageerd worden op berichten van de oude requestVersion.
    Ter verduidelijking: Het is niet toegestaan nog een

    Status
    colourBlue
    titleDocument (DX)
    te versturen op een
    Status
    colourBlue
    titleDocumentaanvraag (DA)
    met een verouderde requestVersion. Om documenten te versturen moet gewacht worden op een
    Status
    colourBlue
    titleDocumentaanvraag (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 1 dus ook retourberichten ontvangen op een requestVersion die nog niet bekend is.

...