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
Overzicht Deze pagina beschrijft de JSON-structuur die vereist is voor het indienen van gegevens over een woning bij de API voor het berekenen van WWS-punten volgens de regels van 01-01-2025. Elk deel van de JSON correspondeert met verschillende aspecten van een woning, waaronder kamers, keukenkenmerken, parkeren, sanitaire voorzieningen en meer.
De specificatie is opgedeeld in: A. Onafhankelijke woonruimtes B. Niet-onafhankelijke woonruimtes
A. Onafhankelijke woonruimtes
Algemene woningkenmerken
house_type
str
"rijtjeshuis"
Vereiste string die het type woning beschrijft.
build_year
int
1995
Moet een positief geheel getal zijn. Gebruikt zonder geldig energielabel/index.
energy_label
str
"A", "B", ""
Optioneel — toegestane waarden in de code; als leeg en energy_index_existence is True, is energy_index verplicht.
energy_index_existence
bool
True
Indien True en energy_label leeg, is energy_index verplicht en wordt gebruikt bij puntberekening.
energy_index
float
1.45
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
"nationaal", "gemeentelijk", "provinciaal", ""
Kleine letters; alleen toegestane waarden.
doorbell
bool
True
Booleaanse vlag.
woz_value
float
250000.0
Moet ≥ 0 zijn; minimum WOZ voor 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. Kamers blok
Overzicht: Beschrijft elke kamer die geen keuken of sanitaire ruimte is.
type_of_room
str
"room"
"room" of "other".
attic_without_fixed_staircase
bool
True
Relevant als type "other" is en het een zolder betreft.
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. Keuken blok
type_of_room
string
"room"
"room" of "other".
open_kitchen
boolean
false
True als open naar een andere kamer.
surface_area
number
10.0
Oppervlakte in m².
countertop_length
number
2.5
Lengte van het aanrecht in meters.
shared_addresses
integer
1
Aantal adressen dat de keuken deelt.
heated
boolean
true
Heeft verwarming.
cooled
boolean
true
Heeft koeling.
kitchen_features
object
zie hieronder
Sleutels zijn kenmerken, 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
}
}
]Zelfde structuur als 2024, alleen shared_addresses wordt gebruikt (geen shared_spaces). Alle keukenfeatures zijn gehele aantallen.
3. Sanitair 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, geen bool.
shared_addresses
int
1
≥ 1.
sanitary_features
dict[str,int/bool]
{"washbasin":1, ...}
Aantallen of booleans.
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
Wandtoilet.
washbasin
integer
1
Aantal.
shared_addresses
integer
1
Aantal adressen dat deelt.
Zelfde velden als 2024, maar hier is wall_hung_toilet een boolean.
5. Buitenblok
surface_area
number
50.0
m².
shared_addresses
integer
1
Aantal adressen dat deelt.
Zelfde als 2024, alleen shared_addresses bestaat hier.
6. Parkeerblok
parking_type
integer
2
Code parkeer type.
shared_addresses
integer
1
Aantal adressen dat deelt.
charging_station
boolean
false
Beschikt over laadpaal.
Zelfde als 2024, alleen shared_addresses bestaat hier.
B. Niet-onafhankelijke woonruimtes
Algemene woningkenmerken Zelfde als onafhankelijk behalve:
glass_surface_living_room (boolean)
lowest_window_frame_living_room (boolean)
accessibility_via_landlord (boolean)
corop_region in plaats van Amsterdam/Utrecht vlag
Belangrijk: Elk blok in B heeft zowel shared_addresses als shared_spaces.
1. Kamers blok (B)
Zelfde als A kamers plus:
shared_spaces (int) — aantal woonruimtes die de kamer delen.
2. Keuken blok (B)
Zelfde als A keuken plus:
shared_spaces (int) — aantal woonruimtes die de keuken delen.
3. Sanitair blok (B)
Zelfde als A sanitair plus:
shared_spaces (int) — aantal woonruimtes die de sanitaire voorziening delen.
4. Toilet blok (B)
Zelfde als A toilet plus:
shared_spaces (int) — aantal woonruimtes die het toilet delen. (Nog steeds: wall_hung_toilet is bool hier.)
5. Buitenblok (B)
Zelfde als A buiten plus:
shared_spaces (int).
6. Parkeerblok (B)
Zelfde als A parkeren plus:
shared_spaces (int).
Voorbeeld Body Request voor Onafhankelijke 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
}Last updated