Samenvatting	Deze ketenafspraak beschrijft welke opties er zijn om de JSON-velden `messageType` en `receiverCode` te vullen in de API-call voor het aanmaken van een record op het HDN-platform.
Ingangsdatum huidige versie	Mar 5, 2026
Laatst gewijzigd per HDN-versie	HDN-25 Minor week 7
Impact op	OfferTeaanvraag (AX)/ Beheerverzoek (MX)/Informatieaanvraag (iA)/InformatieBericht (iX)/ KredietAanvraag (KX)/ Levenaanvraag (lx) / Offerte (Ox) / Statusmelding (Sx)/WaarborgBERICHT (wx)/ Doc.aanvraagBericht (DA)/ DocumentBERICHT (DX) /BRONAAnvraagBERICHT / BAsisreg.personenBERICHT/ DesktopTaxatiebericht/ DIgitaleidentificatiebericht/ loonDIENSTinkomstenBericht/ objectBericht/ pensioenOverichtBericht/ studieleningBericht / Voorafingev.aangiftebericht/ EigenaarsInformatieBericht/ EigenDOMSformatieBericht/ EnergieverbruikBericht/ Hypotheekinformatiebericht/ Taxatiebericht/ Modelmatigewaardebep.
Relevant voor rollen	Rol 1: Softwarepakketten (voorkant) Rol 2: Tussenstations zonder aanpassingen Rol 3: Tussenstations met aanpassingen Rol 4: Aanbieder
Type ketenafspraak	Berichtvulling
Van toepassing op de velden	API: `header.requestSchema.messageType`(JSON veld) `header.requestSchema.receiverCode` (JSON veld) `header.responseSchema.messageType` (JSON veld)
Van toepassing op de entiteiten

Deze ketenafspraak is ook te raadplegen in de HDN-documentatie op https://docs.hdn.nl/docs/hdn-api-v2-8/135917766aaf5-creates-a-record-in-a-dossier .

Ketenafspraak

Vereisten voor Rol 1: Softwarepakketten (voorkant), Rol 2: Tussenstations zonder aanpassingen, Rol 3: Tussenstations met aanpassingen, Rol 4 Aanbieder:

Bij het plaatsen van een Record op het HDN Platform kan voor de vulling van het veld header.requestSchema.messageType gebruik worden gemaakt van de waarden in Tabel 1.
Bij het plaatsen van een Record op het HDN Platform kan voor de vulling van het veld header.requestSchema.receiverCode gebruik worden gemaakt van de waarden in Tabel 2.
NB: Wanneer er voor de gegeven receiverCode geen schema gevonden kan worden, wordt teruggevallen op het schema van organisatie HDN.
Bij het plaatsen van een Record op het HDN Platform kan voor de vulling van het veld header.responseSchema.messageType gebruik worden gemaakt van de waarden in Tabel 3.

Tabel 1: Mapping bericht met requestSchema.messageType

Deze waardelijst kan ook buiten de HDN-majorreleases worden bijgewerkt. Dit is bijvoorbeeld het geval bij het ondersteunen van een nieuw type HDN-bericht dat kan worden verzonden.

Te versturen bericht	Vulling messageType
OfferTeaanvraag (AX)	AX OfferteAanvraag
Niet in gebruik	BX Beheerbericht
Doc.aanvraagBericht (DA)	DA DocumentAanvraagBericht
DocumentBERICHT (DX)	DX DocumentBericht
Informatieaanvraag (iA)	IA InformatieAanvraagBericht
InformatieBericht (iX)	IX InformatieBericht
KredietAanvraag (KX)	KX KredietAanvraag
Levenaanvraag (lx)	LX LevenAanvraag
Beheerverzoek (MX)	MX BeheerVerzoek
Offerte (Ox)	OX Offerte
Statusmelding (Sx)	SX StatusMelding
WaarborgBERICHT (wx)	WX WaarborgBericht
IVOBericht (Zx)	ZX InkomensverklaringOndernemerAanvraag
BRONAAnvraagBERICHT	BronAanvraagBericht
OntslagHoofdAanspr	OntslagHoofdelijkeAansprakelijkheid

Tabel 2: Mogelijke waarden requestSchema.receiverCode

Deze waardelijst kan ook buiten de HDN-majorreleases worden bijgewerkt. Dit is bijvoorbeeld het geval bij het toetreden van een nieuwe organisatie met een organisatiespecifiek schema.

Geldige waarden receiverCode
AA ABN AMRO Bank
AE Aegon Verzekeringen
AG ABN AMRO Hypotheken Groep
AK ASN Bank
AQ Attens Hypotheken
AR Argenta
AU ASR
AW Abel Hypotheken
AZ Allianz
BB BijBouwe
BD Brand New Day
BL BLG Hypotheken
BN BNP Paribas Personal Finance
BQ bunq
BS Bouwsteen Hypotheken
CA Cardif
CB Centraal Beheer
CC Credo Hypotheken
CE Credivance
CF Credit Life
CL Colibri Hypotheken
CS Callas
CW Clarian Wonen
DA DELA
DD Dynamic Hypotheken
DL Delta Lloyd
DM Defam
DN DNGB
DY Dynamic
DZ Dazure
EB HDN Externe bronnen
GH Groene Hart Hypotheken
GO Goudse Verzekeringen B.V.
GV Generali Verzekeringen
HQ HQ Hypotheken
HR Hera Life
HT Hypotrust
HV HollandWoont
IE iValidatie
IM Impact Hypotheken
IN ING
IQ IQWOON
IT Interbank
JU Jungo
KB Knab
KH KBC
LA ASR Leven
LB F. van Lanschot Bankiers
LG Legal & General
LK Van Lanschot Kempen
LL Lloyds Bank
LT Lot Hypotheken
LV Leidsche Verzekeringen
ME Merius
MT Munt Hypotheken
MY MoneYou
NA Nationale Notaris
NI NIBC Bank N.V.
NK Nationale Nederlanden Kredieten
NN Nationale Nederlanden Hypotheken
NS Nestr Hypotheken
NX N26 Hypotheken
NZ NWWI
OG Onderlinge 's Gravenhage U.A.
OO Oosteroever Hypotheken B.V.
OR Orange Credit Hypotheken B.V.
OV Obvion
PP Philips Pensioenfonds
RB Rabobank
RF Robuust Hypotheken
RG RegioBank
SD Scildon
SF Selectief Hypotheken
SM Someday
SN SNS Bank
SY Syntrus Achmea Hypotheken
TB Triodos Bank N.V.
TH Tulp Hypotheken
TL Tellius Hypotheken
TN Taxateurs Unie
TV TAF
VA Vista Hypotheken
VB Volksbank
VE Venn Hypotheken
VF Vandaag Hypotheken
VR Verder Hypotheken
WB WestlandUtrecht Bank
WF Woonfonds Hypotheken
WX Woonnu

Tabel 3: Mapping bericht met responseSchemas.messageType

Deze waardelijst kan ook buiten de HDN-majorreleases worden bijgewerkt. Dit is bijvoorbeeld het geval bij het ondersteunen van een nieuw type bronbericht dat kan worden ontvangen.

Gewenst te ontvangen bericht	Vulling messageType
BAsisreg.personenBERICHT	BasisRegistratiePersonenBericht
DesktopTaxatiebericht	DesktoptaxatieBericht
DIgitaleidentificatiebericht	DigitaleIdentificatieBericht
loonDIENSTinkomstenBericht	LoondienstInkomstenBericht
objectBericht	ObjectBericht
pensioenOverichtBericht	PensioenOverzichtBericht
studieleningBericht	StudieLeningBericht
Voorafingev.aangiftebericht	VoorafIngevuldeAangifteBericht
EigenaarsInformatieBericht	EigenaarsinformatieBericht
EigenDOMSformatieBericht	EigendomsinformatieBericht
EnergieverbruikBericht	EnergieVerbruikBericht
Hypotheekinformatiebericht	HypotheekinformatieBericht
Taxatiebericht	TaxatieBericht
Modelmatigewaardebep.	ModelmatigeWaardebepalingBericht

Aanleiding en achtergrond

Deze ketenafspraak is opgesteld naar aanleiding van het verdwijnen van de /Header/ entiteit in de HDN25 release. Voorheen waren in deze entiteit de veld BerichtSoorten OntvangerCode te vinden. Deze velden bevatten waardelijsten die ook bij het versturen van een bericht op het HDN-platform worden gebruikt. Omdat de /Header/ niet meer in de berichtsschema’s staat, is het niet meer mogelijk de correcte waarden te communiceren. Middels deze ketenafspraak wordt in deze behoefte voorzien.

Versiegeschiedenis

Versie	Wijzigingen	Datum	HDN Versie

Versie	Wijzigingen	Datum	HDN Versie
1.0	Initiële ketenafspraak	May 24, 2025	HDN-25
1.1	Toevoeging code receiverCode WB WestlandUtrecht Bank	Oct 2, 2025	HDN-25-Minor Week 40
1.2	Toevoeging receiverCode NS Nestr Hypotheken	Mar 5, 2026	HDN-25 Minor week 7