# 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](https://docs.altum.ai/verduurzamen/verduurzaming-api-v2-appartementen).<br>

### 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**

###