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:

{
  "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 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:

{
  "code": "03",
  "description": "wall_insulation: 2 is not allowed for build_year: 2010. Allowed values: [4]. Set wall_insulation: 4."
}

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:

{
  "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:

{
  "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:

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:

{
  "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:

{
  "code": "11",
  "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."
}

Waarschuwingscode 50

Beschrijving: Deze waarschuwing verschijnt wanneer een doelmaatregel niet geldig is.

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

Voorbeeld:

{
  "code": "50",
  "description": "target_floor_insulation: 3 is not a valid improvement measure from level 1. Calculated investment costs with value set to 4."
}

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:

{
  "code": "61",
  "description": "No possible filters for wall_filters with selected material EPS_pearls. Removing filter."
}