Inputuitleg voor versie 01-01-2025
Deze pagina gaat over de invoerfuncties voor de eindpunten die bedoeld zijn voor versie 01-01-2025. Er wordt een volledige uitleg gegeven van de functies, en ook de structuur van de invoer en de blokk
WWS Punten API — 01-01-2025 Regels
Overzicht
Deze pagina beschrijft de JSON-structuur die vereist is voor het indienen van woninggegevens bij de API voor het berekenen van WWS-punten volgens de 01-01-2025 regels. Elke sectie van de JSON komt overeen met verschillende aspecten van een woning, waaronder kamers, keukenvoorzieningen, parkeren, sanitaire voorzieningen en meer. De specificatie is opgesplitst in:
A. Zelfstandige woonruimten
B. Niet-zelfstandige woonruimten
A. Zelfstandige woonruimten
Algemene Woningkenmerken
house_type
str
"row house"
Verplichte string die het woningtype beschrijft.
build_year
int
1995
Moet een positief geheel getal zijn. Wordt gebruikt als er geen geldig energielabel/index is.
energy_label
str
"A", "B", ""
Optioneel — toegestane waarden in code; indien leeg en energy_index_existence is True, is energy_index verplicht.
energy_index_existence
bool
True
Als True en energy_label is leeg, is energy_index verplicht en wordt gebruikt voor puntberekening.
energy_index
float
1.45
Wordt alleen gebruikt als energy_label leeg is en energy_index_existence True is.
energy_performance_compensation
bool
True
Booleaanse vlag voor compensatieberekening.
disability_costs
float
1200.0
Geen negatieve waarden toegestaan.
disabled_people
int
1
Geheel getal ≥ 0.
monument
str
"national", "municipal", "provincial", ""
Kleine letters string; alleen toegestane waarden.
doorbell
bool
True
Booleaanse vlag.
woz_value
float
250000.0
Moet ≥ 0 zijn; minimum WOZ gebruikt in berekening: 77582.
woz_valuation_year
int
2023
Moet 2023 of 2024 zijn.
usable_surface_area
float
85.5
Moet ≥ 0 zijn.
corop_area_amsterdam_or_utrecht
bool
True
Booleaanse vlag.
care_home
bool
True
Booleaanse vlag.
1. rooms blok
Overzicht: Beschrijft elke niet-keuken, niet-sanitaire ruimte.
type_of_room
str
"room"
"room" of "other".
attic_without_fixed_staircase
bool
True
Relevant als type "other" is en het een zolder is.
surface_area
float
12.5
Moet ≥ 0 zijn.
shared_addresses
int
1
≥ 1.
heated
bool
True
Booleaanse vlag.
cooled
bool
True
Booleaanse vlag.
Voorbeeld:
"rooms": [
{
"type_of_room": "room",
"attic_without_fixed_staircase": false,
"surface_area": 10.0,
"shared_addresses": 1,
"heated": true,
"cooled": true
}
]2. kitchen blok
type_of_room
string
"room"
"room" of "other".
open_kitchen
boolean
false
Waar als open naar een andere ruimte.
surface_area
number
10.0
Oppervlakte in m².
countertop_length
number
2.5
Aanrechtlengte in meters.
shared_addresses
integer
1
Adressen die keuken delen.
heated
boolean
true
Heeft verwarming.
cooled
boolean
true
Heeft koeling.
kitchen_features
object
zie onder
Sleutels zijn voorzieningen, waarden zijn aantallen.
Voorbeeld:
"kitchen": [
{
"type_of_room": "room",
"open_kitchen": false,
"surface_area": 10,
"countertop_length": 2.5,
"shared_addresses": 1,
"heated": true,
"cooled": true,
"kitchen_features": {
"extractor_system": 1,
"induction_hob": 1
}
}
]Dezelfde structuur als 2024, geen wijzigingen, alleen shared_addresses wordt gebruikt (geen shared_spaces hier). Alle keukenvoorzieningen zijn gehele getallen.
3. sanitary blok
type_of_room
str
"room"
"room" of "other".
surface_area
float
10.0
≥ 0.
heated
bool
True
Booleaanse vlag.
cooled
bool
True
Booleaanse vlag.
shower_facility
str
"shower/bath"
"bath", "shower", "shower/bath".
toilet
int
2
Aantal.
wall_hung_toilet
int
1
Aantal — let op: int, niet bool.
shared_addresses
int
1
≥ 1.
sanitary_features
dict[str,int/bool]
{ "washbasin": 1, ... }
Voorzieningen aantallen of booleaanse waarden.
Voorbeeld:
"sanitary": [
{
"type_of_room": "room",
"surface_area": 10,
"heated": true,
"cooled": true,
"shower_facility": "shower",
"toilet": 1,
"shared_addresses": 1,
"sanitary_features": {
"washbasin": 1
}
}
]4. toilet blok
type_of_room
string
"room"
"room" of "other".
surface_area
number
2.0
m².
heated
boolean
true
Heeft verwarming.
cooled
boolean
false
Heeft koeling.
wall_hung_toilet
boolean
false
Hangend toilet.
washbasin
integer
1
Aantal.
shared_addresses
integer
1
Adressen die delen.
Dezelfde velden als 2024, maar hier is wall_hung_toilet bool.
5. outdoor blok
surface_area
number
50.0
m².
shared_addresses
integer
1
Adressen die delen.
Hetzelfde als 2024, alleen shared_addresses bestaat.
6. parking blok
parking_type
integer
2
Parkeertype code.
shared_addresses
integer
1
Adressen die delen.
charging_station
boolean
false
Heeft laadpaal.
Hetzelfde als 2024, alleen shared_addresses bestaat.
B. Niet-zelfstandige woonruimten
Algemene Woningkenmerken
Hetzelfde als zelfstandige behalve:
glass_surface_living_room(boolean)lowest_window_frame_living_room(boolean)accessibility_via_landlord(boolean)corop_regionin plaats van Amsterdam/Utrecht vlag.
Belangrijk: Elk blok in B heeft zowel shared_addresses als shared_spaces.
1. rooms blok (B)
Hetzelfde als A kamers plus:
shared_spaces(int) — aantal woonruimten dat de kamer deelt.
2. kitchen blok (B)
Hetzelfde als A keuken plus:
shared_spaces(int) — aantal woonruimten dat de keuken deelt.
3. sanitary blok (B)
Hetzelfde als A sanitair plus:
shared_spaces(int) — aantal woonruimten dat de sanitaire voorziening deelt.
4. toilet blok (B)
Hetzelfde als A toilet plus:
shared_spaces(int) — aantal woonruimten dat de toiletvoorziening deelt.
(Nog steeds: wall_hung_toilet is hier bool.)
5. outdoor blok (B)
Hetzelfde als A buitenruimte plus:
shared_spaces(int).
6. parking blok (B)
Hetzelfde als A parkeren plus:
shared_spaces(int).
Body Request Voorbeeld voor Zelfstandige Woning 01/01/2025
{
"house_type": "Eengezinswoning",
"rooms": [
{
"type_of_room": "room",
"attic_without_fixed_staircase": false,
"surface_area": 25.5,
"shared_addresses": 1,
"heated": true,
"cooled": false
},
{
"type_of_room": "room",
"attic_without_fixed_staircase": false,
"surface_area": 15.0,
"shared_addresses": 1,
"heated": true,
"cooled": false
},
{
"type_of_room": "other",
"attic_without_fixed_staircase": false,
"surface_area": 8.0,
"shared_addresses": 1,
"heated": false,
"cooled": false
}
],
"kitchen": [
{
"type_of_room": "room",
"open_kitchen": true,
"surface_area": 10.0,
"countertop_length": 2.5,
"shared_addresses": 1,
"heated": true,
"cooled": false,
"kitchen_features": {
"extractor_system": 1,
"induction_hob": 1,
"ceramic_hob": 0,
"gas_hob": 0,
"refrigerator": 1,
"freezer": 1,
"oven_electric": 1,
"oven_gas": 0,
"microwave": 1,
"dishwasher": 1,
"extra_cupboard_space_per_60cm": 2,
"one_hand_mixer_tap": 1,
"one_hand_mixer_tap_with_boiling_function": 0,
"thermostatic_mixer_tap": 0,
"thermostatic_mixer_tap_with_boiling_function": 0
}
}
],
"parking": [
{
"parking_type": 1,
"surface_area": 12.0,
"shared_addresses": 1,
"charging_station": true
}
],
"sanitary": [
{
"type_of_room": "other",
"surface_area": 6.0,
"heated": true,
"cooled": false,
"shower_facility": "shower/bath",
"toilet": 1,
"wall_hung_toilet": 1,
"shared_addresses": 1,
"sanitary_features": {
"washbasin": 1,
"multi_person_washbasin": 0,
"cupboard_space": true,
"power_outlet": 1,
"build_in_cupboard": 1,
"complete_separation_of_shower": 1,
"bath_with_bubble_function": 0,
"one_hand_mixer_tap": 1,
"thermostatic_mixer_tap": 0,
"towel_radiator": 1
}
}
],
"outdoor": [
{
"surface_area": 30.0,
"shared_addresses": 1
}
],
"toilet": [
{
"type_of_room": "other",
"surface_area": 1.5,
"heated": false,
"cooled": false,
"wall_hung_toilet": true,
"washbasin": 1,
"shared_addresses": 1
}
],
"build_year": 2010,
"energy_label": "A+",
"energy_index_existence": false,
"energy_index": 0,
"energy_performance_compensation": true,
"disability_costs": 0,
"disabled_people": 0,
"monument": "",
"doorbell": true,
"woz_value": 350000,
"woz_valuation_year": 2023,
"usable_surface_area": 95.0,
"corop_area_amsterdam_or_utrecth": false,
"care_home": false
}Body Request Voorbeeld voor Niet-zelfstandige Woning 01/01/2025
{
"rooms": [
{
"type_of_room": "room",
"attic_without_fixed_staircase": false,
"surface_area": 18.0,
"shared_spaces": 1,
"shared_addresses": 1,
"heated": true,
"cooled": false
}
],
"kitchen": [
{
"type_of_room": "room",
"open_kitchen": false,
"surface_area": 12.0,
"countertop_length": 3.5,
"shared_spaces": 4,
"shared_addresses": 1,
"heated": true,
"cooled": false,
"kitchen_features": {
"extractor_system": 1,
"induction_hob": 0,
"ceramic_hob": 0,
"gas_hob": 1,
"refrigerator": 2,
"freezer": 1,
"oven_electric": 1,
"oven_gas": 0,
"microwave": 1,
"dishwasher": 1,
"extra_cupboard_space_per_60cm": 3,
"one_hand_mixer_tap": 1,
"one_hand_mixer_tap_with_boiling_function": 0,
"thermostatic_mixer_tap": 0,
"thermostatic_mixer_tap_with_boiling_function": 0
}
}
],
"parking": [],
"sanitary": [
{
"type_of_room": "other",
"surface_area": 5.0,
"heated": true,
"cooled": false,
"shower_facility": "shower",
"toilet": 1,
"wall_hung_toilet": 0,
"shared_spaces": 4,
"shared_addresses": 1,
"sanitary_features": {
"washbasin": 2,
"multi_person_washbasin": 0,
"cupboard_space": true,
"power_outlet": 2,
"build_in_cupboard": 0,
"complete_separation_of_shower": 1,
"bath_with_bubble_function": 0,
"one_hand_mixer_tap": 2,
"thermostatic_mixer_tap": 0,
"towel_radiator": 0
}
}
],
"outdoor": [
{
"surface_area": 50.0,
"shared_spaces": 4,
"shared_addresses": 1
}
],
"toilet": [
{
"type_of_room": "other",
"surface_area": 1.2,
"heated": false,
"cooled": false,
"wall_hung_toilet": false,
"washbasin": 1,
"shared_spaces": 4,
"shared_addresses": 1
}
],
"build_year": 1985,
"energy_label": "C",
"energy_index_existence": false,
"energy_index": 0,
"disability_costs": 0,
"disabled_people": 0,
"monument": "",
"doorbell": true,
"glass_surface_living_room": 1.5,
"lowest_window_frame_living_room": 1.2,
"accessibility_via_landlord": false,
"woz_value": 500000,
"woz_valuation_year": 2024,
"usable_surface_area": 150.0,
"corop_region": "utrecht",
"care_home": false
}Last updated