HDN Standaard 25

HDN Standaard 25

HDN versie

25

Release datum

May 24, 2025

Geraakte domeinen

Hypotheken, Verzekeren, Waarborgen, Actief klantbeheer, Bronnen

Geraakte berichten

OfferteAanvraag (AX) / Beheerverzoek (MX)/Informatieaanvraag (iA)/InformatieBericht (iX)/ Levenaanvraag (lx) / Offerte (Ox) / Statusmelding (Sx)/WaarborgBERICHT (wx)/ Doc.aanvraagBericht (DA)/ DocumentBERICHT (DX)/ BRONAAnvraagBERICHT/ BAsisreg.personenBERICHT/ DIgitaleidentificatiebericht/ loonDIENSTinkomstenBericht / objectBericht/ pensioenOverichtBericht /studieleningBericht / Voorafingev.aangiftebericht

Releasecontent

Hieronder staan de verschillende backlogitems genoteerd die door de daarvoor verantwoordelijke werkgroep zijn geprioriteerd voor deze release, en de daarbij behorende actuele status.

#

Bericht(en)

Naam

#

Bericht(en)

Naam

STAN-408

Voorstel akkoord

Generiek

Ketenafspraak over requestVersion via platform afdwingen

STAN-23

Voorstel akkoord

Generiek

Verwijderen XML-Header

STAN-63

Voorstel akkoord

OFFERTEAANVRAAGBEHEERVERZOEKLEVENAANVRAAG WAARBORGBERICHT

Aanscherping patroon Email

STAN-1101

Voorstel akkoord

OFFERTEAANVRAAGBEHEERVERZOEKStatusMelding OfferteDoc.AAnvraagBericht

Wijziging omschrijving van veldnaam LeningLopendJN

STAN-2230

Voorstel akkoord

OFFERTEAANVRAAGBEHEERVERZOEKLEVENAANVRAAG WAARBORGBERICHTOfferteDoc.AAnvraagBericht

LandType updaten

STAN-293

Voorstel akkoord

OFFERTEAANVRAAG WAARBORGBERICHTOfferteDoc.AAnvraagBericht

Naamsverbetering nieuwbouw

STAN-2068

Voorstel akkoord

Offerte

Minder verplichte velden voor OfferteBericht Verzekeren

STAN-958

Voorstel akkoord

Offerte

Opschonen niet gebruikte velden OfferteBericht

STAN-88

Voorstel akkoord

Offerte Doc.aanvraagBerichtDocumentBericht

Klantbeeld en dubbele woonlastenformulier ondersteunen in Offerte en Documentberichten

STAN-1308

Voorstel akkoord

Doc.aanvraagBericht Documentbericht

Uitbreiding Documenten “Verklaring van gemoedsbezwaren”

STAN-923

Voorstel akkoord

Doc.aanvraagBericht Documentbericht

Verwijderen Document Soort ‘024 Kopie identiteitsbewijs’

STAN-1036

Vervallen

Doc.aanvraagBericht Documentbericht

Herinrichting DocumentBericht t.b.v. meegeven brondatasleutel

STAN-162

Voorstel akkoord

OfferteAanvraag

Herindeling entiteit Object

STAN-647

Voorstel akkoord

OfferteAanvraag

ArrangementNr vervangen voor Arrangement

STAN-510

Voorstel akkoord

OfferteAanvraag

Verwijderen niet gebruikte velden OfferteAanvraag HDN25

STAN-93

Voorstel akkoord

OfferteAanvraag

Veld AanvullendeVerzendwijze verwijderen

STAN-94

Voorstel akkoord

OfferteAanvraag

Toevoegen velden t.b.v. Klantbeeld in OfferteAanvraag

STAN-2058

Voorstel akkoord

OfferteAanvraag

NHG termen kortingsconstructie en kortingsdeel wijzigen naar koperssteun en ondersteuningsdeel

STAN-1035

Voorstel akkoord

OfferteAanvraag

Herinrichting meegeven sleutel dataleverancier in OfferteAanvraag

STAN-1390

Voorstel akkoord

OfferteAanvraag

Optimalisatie CodeLeningdeelType

STAN-1060

Voorstel akkoord

OfferteAanvraag

Verankeren KET-022: Belastingbox en Renteaftrek in schema

STAN-59

Vervallen

OfferteAanvraag

Doc.aanvraagBericht

Ondersteuning digitale ondertekening

STAN-2361

Voorstel akkoord

OfferteAanvraag

Voorkomen regel LegitimatieGeslacht

STAN-2360

Voorstel akkoord

OfferteAanvraag

Ondersteunen BAG-ID

STAN-716

Vervallen

OfferteAanvraag

Uitbreiding financieringsopzet

STAN-791

Voorstel akkoord

OfferteAanvraag

LevenAanvraag

Beperking op ”Verplicht maken toestaan” voor velden in PartijNAWData voor schemabeheerders

STAN-1402

Voorstel akkoord

LevenAanvraag

Serviceprovider toevoegen aan generiek schema

STAN-915

Voorstel akkoord

LevenAanvraag

Verplaatsen IdentificatieVerificatieJN

STAN-920

Voorstel akkoord

LevenAanvraag

DoelVerzekering verplicht bij ORV

STAN-1604

Voorstel akkoord

LevenAanvraag

Verwijderen niet gebruikte velden LevenAanvraag HDN25

STAN-719

Voorstel akkoord

LevenAanvraag

GeweigerdRedenOmschr en UitsluitingRedenOmschr in LevenAanvraag organisatiespecifiek maken

STAN-2095

Voorstel akkoord

LevenAanvraag

Nieuwe verplichte velden in LevenAanvraag

STAN-2094

Voorstel akkoord

LevenAanvraag

Optimalisatie van velden in de LevenAanvraag

STAN-57

Voorstel akkoord

Statusmelding

Beëindigingsbrief bij afwijzing meesturen via StatusMelding

STAN-1216

Voorstel akkoord

Statusmelding

Kenmerk verplichten bij statusmelding Polis Verzonden

STAN-567

Voorstel akkoord

Waarborgbericht

LegitimatieGeslacht 'X' Waarborgbericht toevoegen

STAN-1025

Voorstel akkoord

Waarborgbericht

Bedrijfsnaam verplichten bij rechtspersonen

STAN-988

Voorstel akkoord

InformatieAanvraagbericht

Informatiebericht

Dataminimalisatie en optimalisatie InformatieAanvraag en InformatieBericht

STAN-2045

Voorstel akkoord

Informatiebericht

Informatiebericht uitbreiden met beheersignaal

STAN-1160

Voorstel akkoord

Informatiebericht

Tariefklasse wordt conditioneel verplichte entiteit

STAN-1179

Voorstel akkoord

Beheerverzoek

Uitbreiding t.b.v. Bouwdepot Declaraties

STAN-1037

Voorstel akkoord

ValidatieMelding en BrondataBerichten

Toevoegen nieuw bericht ValidatieMelding ten behoeve van doorgeven van een foutstatus in de bron

STAN-1346

Voorstel akkoord

BrondataBerichten

Dataminimalisatie doormiddel van beperking op entiteiten Hypotheekgever & PartijNAWData

STAN-1040

Voorstel akkoord

Brondataberichten

DocSoort en SoortDocument scheiden in bronberichten

STAN-2320

Voorstel akkoord

Voorafingev.aangiftebericht

Herinrichten schema VoorafIngevuldeAangiftebericht (VIA)

STAN-1349

Voorstel akkoord

BAsisreg.personenBERICHT

Uitbreiden met ontbrekende velden

STAN-2393

Voorstel akkoord

BRonaanvraagberiCHT

Verwijderen van Gebruikersnaam en wachtwoord Kadaster in BronAanvraagBericht

* Status geeft de status aan van de wijziging weer.

Planning

De planning is vastgesteld in overeenstemming met de werkgroepen en is in lijn met het releasebeleid.

Fase

Resultaat

Gebruikelijke termijn

Van

Tot

Fase

Resultaat

Gebruikelijke termijn

Van

Tot

Scopebepaling

Releasespecificaties HDN 25 worden in concept gepubliceerd

Tot +/- 6 maanden voor go-live

Dec 12, 2024

Jan 30, 2025

Consultatieperiode

Definitieve scope

5 weken

Dec 12, 2024

Jan 16, 2025

Consultatieperiode

Definitieve releasenotes

2 weken

 

Jan 30, 2025

Opbouwen schema’s

Basisberichtschema’s worden door HDN opgebouwd en gepubliceerd

2 weken

Jan 16, 2025

Jan 30, 2025

Opbouwen schema’s

Organisatieschema’s zijn ter review aangeboden

6 weken

Jan 30, 2025

Mar 13, 2025

Review door HDN

Organisatieschema’s worden gepubliceerd en naar de testomgeving gedistribueerd

4 weken

Mar 13, 2025

Apr 10, 2025

Test

Schema’s gedistribueerd naar productie

6 weken

Apr 10, 2025

May 24, 2025

Freezeperiode

Periode waarin geen nieuwe berichtschema’s naar productie kunnen worden gebracht anders dan HDN 24.0 release gerelateerd.

6 weken

Apr 24, 2025

Jun 5, 2025

Go-live

Afronding release

-

00:30 May 24, 2025

 

Scope van de release

Generiek

#

Bericht(en)

Naam

Beschrijving

 

#

Bericht(en)

Naam

Beschrijving

 

STAN-408

Generiek

Ketenafspraak over requestVersion via platform afdwingen

Wijziging:

De validatie van de requestVersion vindt plaats op het platform. Op het moment dat de meegegeven requestVersion meegegeven wordt, leeg of 0 is, wordt er geen record gemaakt in het dossier en wordt deze beantwoordt met, HTTP foutcode ‘400’, met de foutmelding ‘Invalid request body.header.requestVersion does not match allowed format of 1 to 3 digits and must be greater than 0”’

Samenvatting:

We zijn op een punt aangekomen dat we de mogelijkheden van het platform echt willen gaan benutten. ​Door ketenafspraken op het platform af te dwingen, waarborgen we een hogere kwaliteit van het berichtenverkeer. Het afdwingen van een gedeelte van de ketenafspraak over requestVersion geeft eenieder de mogelijkheid om te wennen aan deze manier van valideren.

 

STAN-23

Generiek

Verwijderen XML-Header

Wijziging:

De //Header met onderliggende velden wordt verwijderd uit alle berichtschema’s waarin deze nog is opgenomen.

Geraakte ketenafspraken:

KET-008-1: Verplichte statusmeldingen bij een hypotheekaanvraagarchived

KET-009-1: Verplichte statusmeldingen bij een verzekeringsaanvraagarchived

KET-027-1: Niet toegestane wijzigingen op een lopende aanvraagarchived

KET-035-1: Verplichte statusmeldingen bij een bankgarantieaanvraagarchived

KET-036-1: Verplichte statusmeldingen bij een informatieaanvraagarchived

KET-034-1: Verplichte statusmeldingen bij een kredietaanvraagarchived

KET-001-1: Het doorgeven van intermediair en serviceprovider informatie en wijzigingen door tussenstationsarchived

Nieuwe ketenafspraak:

https://hdn.atlassian.net/wiki/spaces/HDNStandaard/pages/3254812673/KET-044+Het+gebruik+van+receiverCode+en+messageType+bij+het+versturen+van+berichten+op+het+platform?atlOrigin=eyJpIjoiNWY5ZjY2NGMxNTVkNDdmZWIxMzg3YzU4YjcxY2UxZGUiLCJwIjoiYyJ9

In verband met het verwijderen van de Header is een ketenafspraak opgesteld waarin de waardelijsten messageType en receiverCode zijn opgenomen.

Samenvatting:

In 2023 is de APIv2 versie neergezet waarin de Header in de XML, die stuurinformatie bevat, overbodig is geworden. Stuurinformatie is sindsdien onderdeel van de JSON en daarom niet meer nodig in de XML berichtenstructuur.

Na uitvraag bij onze leden en gebruikers, over het gebruik van de Header op XML niveau, konden we concluderen dat niemand de Header nog nodig heeft met de HDN25 versie. Daarom wordt de Header dan ook verwijderd uit alle berichtschema’s waar deze nog onderdeel van uitmaakt.

 

STAN-63

OFFERTEAANVRAAGBEHEERVERZOEKLEVENAANVRAAG WAARBORGBERICHT

Aanscherping patroon Email

Wijziging:

Het patroon voor het datatype EmailType wordt gewijzigd naar: [a-zA-Z0-9._%+-]{1,64}@[A-Za-z0-9.-]{0,255}[A-Za-z0-9]{1}\.[A-Za-z]{1,63}

Samenvatting:

Door het patroon aan te passen, wordt het emailadres wat verzonden wordt via de XML berichten betrouwbaarder.

 

STAN-1101

OFFERTEAANVRAAGBEHEERVERZOEKStatusMelding OfferteDoc.AAnvraagBericht

Wijziging omschrijving veldnaam LeningLopendJN

Wijziging:

De omschrijving van het veld LeninglopendJN wordt gewijzigd naar: ‘Betreft het een lening waar een actieve of toekomstige betaalverplichting voor geldt?’

Samenvatting:

Er wordt een wijziging in de omschrijving doorgevoerd zodat het duidelijker is waarvoor dit veld dient.

 

STAN-2230

OFFERTEAANVRAAGBEHEERVERZOEKLEVENAANVRAAG WAARBORGBERICHTOfferteDoc.AAnvraagBericht

LandType updaten

Wijziging:

Aan de waardelijst LandType wordt de waarde XK Kosovo toegevoegd.

Samenvatting:

Met HDN24 is de waardelijst aangepast aan de ISO landenlijst, daarbij was Kosovo verwijderd omdat deze niet op de ISO landenlijst voorkomt als geaccepteerd land. Nederland heeft Kosovo echter wel geaccepteerd.

Bij de jaarlijkse analyse zal voortaan naast de ISO landenlijst ook gekeken worden naar de door Nederland geaccepteerde landen.

 

STAN-293

OFFERTEAANVRAAG WAARBORGBERICHTOfferteDoc.AAnvraagBericht

Naamsverbetering nieuwbouw

Wijziging:

Het veld BouwPlanNr wordt vervangen voor Bouwplan, omschrijving: Geeft de naam van het bouwplan aan.

Het veld SituatieNr wordt vervangen door Bouwnummer, omschrijving: Geeft het nummer binnen het bouwplan aan.

Samenvatting:

Het is onduidelijkheid wat precies onder het BouwPlanNr en SituatieNr wordt verstaan. Om deze reden vervangen we een aantal velden. Hiermee zou het doel van deze velden duidelijker moeten zijn.

 

STAN-2068

Offerte

Minder verplichte velden voor OfferteBericht Verzekeren

Wijziging:

//OfferteData/VerleningingMogelijkJN is verplicht als //OfferteData/ResponsOpBerichtSoort heeft waarde (AX OfferteAanvraag, MX BeheerVerzoek of WX WaarborgBericht heeft. Dit veld was nu altijd verplicht.

/OfferteData/FinancieleDekking/Fiscaal​Geruisloze​Voortzetting​J​N wordt optioneel.

Samenvatting:

De werkgroep verzekeren heeft aangegeven dat bij het versturen van de Offerte teveel verplichte velden moesten worden gevuld terwijl de informatie niet altijd beschikbaar is. Daarom is gekeken welke velden optioneel gemaakt kunnen worden in geval van een LevenAanvraag.

 

STAN-958

Offerte

Opschonen niet gebruikte velden OfferteBericht

Wijziging:

De entiteit Hypotheekgever wordt verwijderd, inclusief alle onderliggende velden en entiteiten. Dit betreft het veld Hypotheekgever/RefPartijNAWData en de sub entiteiten Verplichtingen, GeregistreerdeLening, OverigeLening en alle velden in deze entiteiten.

Samenvatting:

Jaarlijks wordt gekeken naar velden die niet gebruikt worden. De te verwijderen entiteiten en onderliggende velden werden niet gebruikt. In samenspraak met de werkgroep is besloten deze te verwijderen.

 

STAN-88

Offerte Doc.aanvraagBerichtDocumentBericht

Klantbeeld en dubbele woonlastenformulier ondersteunen in Offerte en Documentberichten

Wijziging:

  • Uitbreiding waardelijst, binnen documentberichten, SoortDocumentType met de waarde ‘(code) Klantbeeldformulier’ en ‘(code) Dubbele woonlastenformulier’. Ook wordt de entiteit Hypotheekgever verplicht wanneer SoortDocument heeft de waarde ‘(code) Klantbeeldformulier’

  • Uitbreiding waardelijst, binnen Offerte, DocSoortType met de waarde ‘(code) Klantbeeldformulier ’ en ‘(code) Dubbele woonlastenformulier’.

Samenvatting:

Gebruikers hebben aangegeven bij de Offerte ook een klantbeeldformulier en/of dubbele woonlastenformulier mee te sturen. Er is gevraagd om de waardelijst DocSoortType uit te breiden zodat deze documenten gestandaardiseerd meegestuurd kunnen worden. Ook is het nodig om deze documenten ingevuld en/of ondertekend te retourneren. Daarom worden ook de documentberichten uitgebreid met deze waarde.

 

STAN-1308

Doc.aanvraagBericht Documentbericht

Uitbreiding Documenten “Verklaring van gemoedsbezwaren”

Wijziging:

Uitbreiding waardelijst SoortDocumentType met de waarde ‘(code) Verklaring van gemoedsbezwaren’. De uitbreiding geldt voor het DocumentBericht en het DocumentAanvraagBericht.

Samenvatting:

Met een ‘Verklaring van gemoedsbezwaar’, van het SVB, heeft een consument de mogelijkheid om aantoonbaar te maken dat deze zich vanuit levensovertuiging niet hoeft te verzekeren. Meer informatie hierover is te vinden op:

 

STAN-923

Doc.aanvraagBericht Documentbericht Beheerverzoek

Verwijderen Document Soort ‘024 Kopie identiteitsbewijs’

Wijziging:

Waarde ‘024 Kopie identiteitsbewijs’ wordt verwijderd uit de waardelijst SoortDocument.

Samenvatting:

Met de HDN23 zijn er twee documenten geïntroduceerd ‘267 Kopie identiteitsbewijs zonder BSN’ en '268 Kopie identiteitsbewijs met BSN'. Het doel hiervan is om duidelijker onderscheid te kunnen maken in het aan te leveren document. Na een overgangsperiode van twee jaar wordt het oude document verwijderd.

 

 

Domein Hypotheken

#

Bericht(en)

Naam

Beschrijving

#

Bericht(en)

Naam

Beschrijving

STAN-162

OfferteAanvraag

Herindeling entiteit Object

Wijziging:

De entiteit //Objectwordt heringericht. Een deel van de bestaande velden zijn in nieuwe subentiteiten geplaatst: BestaandeBouw, Nieuwbouw, Adres, Verbouwing, Meerwerk en Erfpacht.

Het veld VerduurzamingBesprokenJN is in de eerste instantie komen te vervallen, maar op verzoek van aanbieder(s) is deze weer teruggeplaatst in versie 25.0.8.0.

Update May 14, 2025 Er is een correctie doorgevoerd op het veld ErfpachtEindDt : de regel in het veld verwees naar ErfpachtcanonAfgekochtJN maar dit moest zijn ErfpachtCanonEeuwigDurendAfgekochtJN. Op Overzicht nieuwe Object-entiteit m.i.v. HDN25 stond dit al vermeld. Tevens was het veld ErfpachtCanonAfgekochtJN onterecht verplicht gemaakt. Deze verplichting is gewijzigd in een conditionele verplichting. Beide wijzigingen resulteren in versie 25.0.9.0. Organisaties kunnen zelf bepalen of ze hun schema hiervoor willen updaten.

Zie Overzicht nieuwe Object-entiteit m.i.v. HDN25 voor alle wijzigingen. Er is ook een Mappingtabel Object wijzigingen gemaakt.

Geraakte ketenafspraken:

KET-006-1: Het doorgeven van koopsom grond in een hypotheekaanvraagarchived

KET-007-1: Minderwerk in koopaanneemsom verwerkenarchived

Samenvatting:

De entiteit //Object bestaat uit veel velden. Dit zorgt ervoor dat, de entiteit onoverzichtelijk is, er fouten ontstaan in het verplichten van velden, stellen van regels en het doorgeven/mappen van de data. Ook ontvangen aanbieders niet altijd alle informatie die benodigd is en/of foutieve informatie. Met de vernieuwde inrichting is de entiteit veel overzichtelijker en duidelijker wat er ingevuld moet worden in specifieke situaties.

Met deze change zijn adviespakketten veel beter in staat gestructureerde data te versturen en ontvangen aanbieders betrouwbaardere data. Daarnaast is ook gekeken naar het gebruik van Verduurzamingsvelden, waarbij het veld Verduurzaming​Besproken​J​N is komen te vervallen, omdat dit inmiddels integraal onderdeel is van alle adviespakketten.

Let op. Voor schemabeheerders geldt dat de regels op deze velden opnieuw moeten worden ingesteld.