Veelgestelde vragen (FAQ)

Welke zoekcriteria moet ik gebruiken?

De standaardwaarde is ''laagste investeringskosten''. Bij deze zoekmethode wordt ook gezocht naar vergelijkbare woningen die een hoger energielabel hebben dan het opgegeven doel.

Bij de andere drie zoekcriteria gebeurt dit niet.

Voorbeeld: De beginsituatie is een woning met energielabel F. Wanneer je zoekt naar label C, worden woningen met label C, B en A meegenomen in de vergelijking. Als een woning met label B lagere investeringskosten heeft dan woningen met label C, dan wordt de B-variant als resultaat teruggegeven.

Moet ik alle kenmerken meesturen in de request?

Nee. Alleen de invoer die nodig is om de woning te identificeren is verplicht.

Voor de overige kenmerken haalt de API standaardwaarden uit de database. Het is daarom niet nodig om voor elke feature input mee te sturen.

Waarom krijg ik een Ecowaarde van 0,0 terug?

Dit kan verschillende oorzaken hebben:

• Het adres wordt niet correct herkend wanneer bijvoorbeeld "addition": "string" wordt meegestuurd. De API interpreteert dit dan als een huisnummertoevoeging.

• Het huidige energielabel en het doel- of voorgestelde energielabel zijn gelijk.

• Er is een fout in de API-call, bijvoorbeeld doordat de invoer niet voldoet aan het schema.

Waarom is de Ecowaarde relatief laag?

In combinatie met andere woningkenmerken kan een kleine verduurzamingsstap al leiden tot een labelverbetering (bijvoorbeeld van E naar D). De marktwaarde-stijging blijft in dat geval vaak beperkt.

Waarom krijg ik andere resultaten wanneer ik een budget gebruik?

Wanneer je een budget of maximale investering opgeeft, gebruikt de API standaard het zoekcriterium flexibel (code: 2).

Wanneer je geen maximuminvestering opgeeft, gebruikt de API strict (code: 0).

Wil je dit aanpassen, geef dan expliciet de gewenste search_options mee in de API-call.

Waarom tellen de besparingen van de afzonderlijke maatregelen niet op tot de totale besparing?

Maatregelen beïnvloeden elkaar. De API houdt rekening met het gecombineerde effect van maatregelen. Daardoor kan de totale besparing afwijken van de optelsom van de individuele besparingen.

Waarom wordt een woning niet gevonden?

Wanneer de Verduurzaming API een adres niet kan vinden of er onvoldoende data beschikbaar is voor berekeningen, krijg je de foutmelding:

Address not found in database, combination of zip code and house number

Dit kan onder andere komen doordat:

• Het adres niet bekend is bij Kadaster of gemeente

• Essentiële woningdata ontbreekt (bijvoorbeeld woningtype)

• Het object geen woonfunctie heeft maar bijvoorbeeld een bedrijfspand, winkel of boerderij is

Hoe kan ik advies geven voor woningen die van het gas af willen?

Dit kan op verschillende manieren.

Optie 1: advies zonder aardgasgebruik

“natural_gas”: 2,

Optie 2: focus op isolatie en warmtepomp uitsluiten

“heat_pump_allowed”: 0,
"lock_measures": {
     "lock": [
       "installation", “shower”, “solar_panels”
     ]
},

Wat als een woning al maatregelen heeft genomen of een ander energielabel heeft?

Je kunt de huidige situatie aanpassen door zelf kenmerken mee te sturen in de input. Bijvoorbeeld wanneer een woning al zonnepanelen of vloerisolatie heeft.

Om een zo realistisch mogelijk uitgangspunt te krijgen, kun je onder andere de volgende gegevens meegeven:

• Woonoppervlak

• Woningtype

• Bouwjaar

• Aantal bewoners

• Gas- of warmtenetverbruik

• Aanwezige zonnepanelen

• Huidige installatie

• Huidige isolatie van vloer, gevel en dak

• Ventilatiesysteem

• Aanwezige douche-WTW

Let op: het energielabel dat in het advies wordt gebruikt is niet het definitieve energielabel uit EP-online (RVO). Dit label kan namelijk gebaseerd zijn op oudere normen of op onbekende maatregelen.

Waarom ondersteunt deze API geen appartementen?

Op dit moment ondersteunt de Sustainability API geen appartementen.

Bij appartementen worden verduurzamingsmaatregelen meestal geregeld via de Vereniging van Eigenaren (VvE), omdat onderdelen zoals:

• dak

• gevels

• vloer

• kozijnen

vaak gemeenschappelijk eigendom zijn.

Daarom zijn individuele maatregelen zoals isolatie, zonnepanelen of warmtepompen vaak alleen mogelijk met toestemming van de VvE.

Dit zal apart beschikbaar zijn in de Verduurzaming API v2 Appartementen.

Hoe houdt de API rekening met de NTA 8800-norm?

De berekeningen voor verduurzamingsmaatregelen en energie-impact zijn gebaseerd op de NTA 8800-norm voor energielabels.

Waarom krijg ik een 400-foutmelding met de melding dat het doel niet binnen de investeringslimiet kan worden bereikt?

Deze fout ontstaat meestal wanneer er te veel beperkingen zijn opgegeven, bijvoorbeeld:

• een te hoog doel-energielabel

• een te lage maximale investering

• maatregelen die zijn gelockt of uitgesloten

Mogelijke oplossingen:

• verhoog of verwijder max_investment

• verlaag target_label (bijvoorbeeld van A naar C)

• verwijder lock_measures of exclude_measures