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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.altum.ai/verduurzamen/verduurzaming-api-v2/waarschuwingen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.