# Waarschuwingen

In tegenstelling tot fouten, blokkeren **waarschuwingen** het request niet. Ze geven aan dat bepaalde invoerwaarden ongeldig of overbodig waren, en dat de API deze automatisch heeft gecorrigeerd of aangepast naar geldige waarden.

* Het request wordt nog steeds succesvol verwerkt.
* De respons bevat een lijst met waarschuwingen (indien aanwezig).
* Elke waarschuwing bevat een `code` en een `beschrijving` die uitlegt wat er is aangepast.

### Waarschuwingscode `01`

**Beschrijving:**\
Deze waarschuwing verschijnt wanneer de opgegeven waarde voor `inner_surface_area` lager is dan de minimale limiet die door de API wordt toegestaan.\
\
Wanneer dit gebeurt, past de API de waarde automatisch aan naar de minimale geldige limiet. 

**Voorbeeld:**

```json
{
  "code": "01",
  "description": "inner_surface_area: 30.0 is below the minimum limit of 53.8. Value has been adjusted to inner_surface_area: 53.8."
}
```

### Waarschuwingscode `02`

**Beschrijving:**\
Deze waarschuwing verschijnt wanneer de opgegeven waarde voor `inner_surface_area` hoger is dan de maximale limiet die door de API wordt toegestaan.\
\
Wanneer dit gebeurt, past de API de waarde automatisch aan naar de maximale geldige limiet. 

**Voorbeeld:**

```json
{
  "code": "02",
  "description": "inner_surface_area: 200.0 is outside the maximum limit of 33.75. Value has been adjusted to inner_surface_area: 33.75."
}
```

### Waarschuwingscode `03`

**Beschrijving:**\
Deze waarschuwing verschijnt wanneer de opgegeven waarde voor een van de volgende maatregelen -  `wall_insulation`, `floor_insulation`, `sloped_roof_insulation`, of `flat_roof_insulation` - niet geldig is voor het opgegeven `build_year`.

In dat geval past de API de maatregel automatisch aan naar een andere geldige waarde.

**Voorbeeld:**

<pre class="language-json"><code class="lang-json">{
<strong>  "code": "03",
</strong>  "description": "wall_insulation: 2 is not allowed for build_year: 2010. Allowed values: [4]. Set wall_insulation: 4."
}
</code></pre>

### Waarschuwingscode `04`

**Beschrijving:**\
Deze waarschuwing verschijnt wanneer de opgegeven waarde voor `living_room_windows` of `bedroom_windows` niet geldig is voor het opgegeven `build_year`.

In dat geval past de API het veld automatisch aan naar een andere geldige waarde.

**Voorbeeld:**

```json
{
  "code": "04",
  "description": "living_room_windows: 1 is not valid for build_year: 2010. Allowed values: [2, 3, 4]. Value has been adjusted to living_room_windows: 3."
}
```

### Waarschuwingscode `05`

**Beschrijving:**\
Deze waarschuwing verschijnt wanneer `heat_usage` wordt meegegeven in combinatie met een `installation` type dat hier niet mee compatibel is.

* Het veld `heat_usage` is **alleen geldig wanneer `installation = 7`**.
* Voor alle andere installatietypes negeert de API `heat_usage`.

**Voorbeeld:**

```json
{
  "code": "05",
  "description": "heat_usage is not valid with installation: 2. Value has been ignored."
}
```

### Waarschuwingscode `08`

**Beschrijving:**\
Deze waarschuwing verschijnt wanneer `pv_total_watt_peak` expliciet wordt ingesteld voor een zonnepaneel. Aangezien `pv_total_watt_peak` al kan worden berekend als:&#x20;

```
pv_total_watt_peak = pv_area × specific_watt_peak
```

De API negeert de velden  `pv_area` en `specific_watt_peak` voor dat paneel om conflicterende of dubbele invoer te voorkomen.

**Details:**

* Geldt afzonderlijk voor elk zonnepaneel (`solar panel 1`, `solar panel 2`, …).
* Er moet slechts één invoermethode worden gebruikt:  `pv_total_watt_peak` direct instellen, **of** `pv_area` and `specific_watt_peak` opgeven.

**Voorbeeld:**

```json
{
  "code": "08",
  "description": "For solar panel 1, pv_total_watt_peak is already set. pv_area and specific_watt_peak have been ignored."
}
```

### Waarschuwingscode `11`

**Beschrijving:**\
Deze waarschuwing verschijnt wanneer het huidige energielabel al overeenkomt met de `target_label`.

In dat geval is geen verdere aanpassing nodig, omdat de woning al aan het gewenste doel voldoet.

**Voorbeeld:**

<pre class="language-json"><code class="lang-json"><strong>{
</strong><strong>  "code": "11",
</strong>  "description": "Current building with energy label A already meets target_label B."
}

of

{
  "code": "11",
  "description": "Current building with energy label A already meets default target_label A."
}
</code></pre>

### Waarschuwingscode `61`

**Beschrijving:**\
Deze waarschuwing verschijnt wanneer een geselecteerd materiaal voor een filter niet geldig is.

In dat geval verwijdert de API het filter automatisch.

**Voorbeeld:**

<pre class="language-json"><code class="lang-json"><strong>{
</strong><strong>  "code": "61",
</strong>  "description": "No possible filters for wall_filters with selected material EPS_pearls. Removing filter."
}
</code></pre>