# Changelog ### 4.8- 2025-07-02 * EPOnline versie-update van V4 naar V5. ### 4.7- 2025-03-06 * De service is geoptimaliseerd om een ​​groter aantal API-verzoeken beter te kunnen verwerken ### 4.6 - 2024-12-11 * Correctie toegevoegd voor het berekende jaarlijkse gasverbruik "gas\_usage", gebaseerd op statistische gemiddelden van huizen in Nederland. ### 4.5 - 2024-12-05 * Twee nieuwe 400 error reacties toegevoegd wanneer de gebruiker niet de vereiste parameters van een custom kost of een verbeteringskost opgeeft. * "detail": "For a given custom cost make sure the parameter 'value' is provided." * "detail": "For a given improvement cost make sure all four parameters: 'material', 'work', 'saving\_material' and 'saving\_work' are provided." * Toegevoegd BENG1 current en potential outputs. ### 4.4 - 2024-11-06 * Input "target\_label" is verwijderd uit de criteria voor het toepassen van aanvullende maatregel informatie. ### 4.3 - 2024-10-02 * Toevoeging "points" output per maatregel. Deze punten worden gebruikt om de "comfortscore" te berekenen. Zie [Comfortscore](/verduurzamen/verduurzaming-api/comfort-score.md). ### 4.2 - 2024-09-16 * EPOnline versie-update van V3 naar V4. ### 4.1 - 2024-8-23 * De berekening van de huidige maatregelen bijgewerkt om aanvullende maatregelen informatie op te nemen voor een betere nauwkeurigheid, als er geen maatregel input van de gebruiker is. ### 3.25 - 2024-8-16 * Wijzigingen in de input "exclude\_measure". Waarden \[1001, 1002, 2001, 2002] zijn nu beschikbaar, waarde \[8009] is verwijderd. ### 3.24 - 2024-7-31 * Gebruikerswaarde voor invoer zonnepanelen wordt nu correct meegenomen in de berekening van de resultaten per maatregelen * De berekening van de opgewekte elektriciteit van pv-panelen in de resultaten per maatregelen is aangepast * Een bug in de berekening van de gaskosten is opgelost * HRe/WKK-ketel is verwijderd als optie voor installatiemaatregel ### 3.23 - 2024-06-21 * De aangepaste waarde voor gasverbruik geldt nu ook voor de output "ResultaatPerMaatregel" in het geval van een hybride warmtepomp. ### 3.22 - 2024-6-18 * Bug opgelost bij het verwerken van aangepaste invoer WP -zonnepanelen die onjuiste resultaten veroorzaken. * Berekeningsfactor aangepast van de energieoutput van zonnepanelen op BENG2. Verlaagd van 4.756 naar 4.21 om de lokale zonnepanalen input per m2 beter te laten aansluiten. ### 3.21 - 2024-6-14 * Bug opgelost waarbij correctie voor gasverbruik op basis van geleverde waarde niet werd toegepast in het geval van een hybride warmtepomp. ### 3.20 - 2024-04-19 * Nieuwe optionele parameter "replace\_windowframes" - gebruikt om extra verbeteringskosten per glasgerelateerde codes 50002, 50003, 50103, 50203 toe te voegen bij het vervangen van glas en raamkozijnen. De kosten kunt u zien in de PDF bij [kostentabel](https://docs.altum.ai/apis/sustainability-api/cost-table-input). Activeer met "replace\_windowframes" : 1 ### 3.19 - 2024-03-14 * Probleem opgelost met incidenteel inconsistente resultaten veroorzaakt door inconsistente verwerking van de nieuwe kostentabel ### 3.18 - 2024-01-10 * De kosten van de maatregelen zijn sinds 1 januari 2024 veranderd. Zie [link](https://docs.altum.ai/apis/sustainability-api/cost-table-input) ### 3.17 - 2023-12-13 * Toevoeging "city\_heating" huidige en potentiële verbruik outputs, het jaarlijkse warmteverbruik in GJ. ### 3.16 - 2023-12-01 * Toevoeging "floor\_surface", "flat\_roof\_surface", "pitched\_roof\_surface", "wall\_surface", "glass\_living\_room\_surface", "glass\_bedrooms\_surface" outputs ### 3.15 - 2023-11-27 * Er is een probleem opgelost waarbij "custom\_costs" niet correct werden verwerkt ### 3.14 - 2023-11-7 * Toevoeging electricity\_savings output, de jaarlijkse besparing op het elektriciteitsverbruik in kWh voor de specifieke maatregel. * Toevoeging gas\_savings output, de jaarlijkse besparing op het gasverbruik in m^3 voor de specifieke maatregel. ### 3.13 - 2023-10-9 * Error codes bijgewerkt in document voor 400 Address Not Found (voorheen 301) en 400 No Measures (voorheen 311) * Toevoeging watt\_panels input om invoer solar\_panels veld te interpreteren als wattpiek capaciteit zonnepanelen. Voorbeeld invoer: "solar\_panels": 15000, "watt\_panels": 0 ### 3.12 - 2023-8-29 * Toevoeging /bag endpoint voor opvragen verduurzamingadvies o.b.v. BAG ID (VBO) ### 3.11 - 2023-8-8 * Huisnummer letter toevoegingen worden nu zowel gezocht in kapitalen (A) als onderkast (a) gezocht ### 3.10 - 2023-7-16 * Toevoegen huidige elektriciteitsverbruik is nu mogelijk via het optionele invoerveld: "electricity\_usage". Met het bestaande invoerveld "gas\_usage" kun je nu het complete beeld aan huidig energieverbruik opvoeren. ### 3.09 - 2023-4-25 * Fixed issue where the custom "gas\_usage" input was not properly accounted for the "saving" results per measure. ### 3.08 - 2023-2-22 * Optimized general performance of the API call to 2 seconds on average * Added optional boolean "**eco\_delta: 0**" input to deactivate fetching of the Ecovalue output. Which will then display "null" for this value. This results in a \~ 1 second performance improvement per API call ### 3.07 - 2022-10-19 * Added feature to overwrite solar panel watt peak per square meter with "**solarpanel\_watt\_peak**" * Added default watt peak output solar panels to 212 * API output now showing gas and energy prices used as well as the solarpanel watt peak performance per square meter: ``` "energy_prices": { "variable_gas_price": 0.774, "variable_electricity_price": 0.223, "solarpanel_watt_peak_per_m2": 250 }, ``` ### 3.06 - 2022-6-28 * Exclude specific measures instead or next to a category of measures with the function [**exclude\_measure**](/verduurzamen/verduurzaming-api/maatregelen-uitsluiten.md)**.** * Set a minimum number of solar panels to be adviced when provided as measure via the function: **minimum\_solar\_panels** Warning: in some cases this might result into NOT suggesting solar panels as measure at all ### 3.05 - 2022-5-24 * Added function to set a minimum requirement for insulation when suggest a (hybrid) heatpump via the input feature "heatpump\_insulation\_req": 0, 1, 2 or 3. Default is 0. This feature can be used to ensure a heatpump (Installation 7 or 8, 30, 31) is only returned as a measure when all insulation levels (wall, floor, roof) satisfy the 'heatpump\_insulation\_req' input. In other words: when 'heatpump\_insulation\_req' is 2, a heatpump is only considered as a resulting measure when Wall insulation, Floor insulation and Roof insulation all have at least a value of 2 (=good). ### 3.04 - 2022-4-1 * New optional parameter build\_year (from 1000 and to 2030) to parse as input. With an accompanying error 303 message: "Build year not found in database. Use build\_year parameter." * New optional parameter inner\_surface\_area (greater than 0). New response for 303 error: "Inner surface area not found in database. Use inner\_surface\_area parameter instead." * New optional parameter `fetch_definitive_label` - used as flag to fetch the label, its validity and norm type from EP-online. Default is 0. * More robust handling of possible Ecovalue delta model downtime. * Mitigation of non-uniform build years, incl. an option to specify year in input. ### 3.03 - 2021-10-13 * Input a budget "max\_investment" with no target energylabel "target\_label" will assume utilizing max budget with search criteria the lowest annual yearly energy costs "search\_criteria: 1" * Issue resolved with input of an adjusted cost table * Added a function for creating a strict search function for the target energy label. This function is called "energylabel\_strict" and has a boolean syntax, where 0=yes and 1=no. When given energy label A as target and strict search is yes, the advice will search up to the lower bound of the A label * Added the ability to input search criteria where the target is lowest BENG2 value which relates to the energy label. Example: "search\_criteria: 4" ### 3.02 - 2021-10-11 * Added BENG2 current and potential * Added BENG2 percentual impact per measure * Fixed an issue with input cost table * Optimized performance * Add parameter input of heat usage for which **Stadsverwarming** is assumed as Installation when heat usage is added to a request **Added input** ``` "heat_usage": 100, ``` **Added output** ``` "BENG2": { "current": 405, "potential": 154 } --- "floor_insulation": { "before": { "desc": "Geen", "value": 0 }, "after": { "desc": "Zeer goed", "value": 3 }, "investment": 3892.71, "saving": 1393, "co2_reduce": 3196, "BENG2": "23.8%" } ``` ### 3.01 - 2021-10-8 * Added gas- and electricity usage of potential situation to the output ``` "usage_potential": { "gas": 422, "energy": 74 }, ``` ### 3.0 - 2021-10-1 * Change API to NTA 8800 norm and altum.ai/sustainability as endpoint * Added Ventilation as output measure * Target label is now a minimum instead of maximum * Definitive Energy label output is now fetched live from EP-online * Added GET function to fetch based on BAG /sustainability?bagid= ### 2.11 - 2021-7-27 * Added error code 303: "detail": "House type not found in database. Use house\_type parameter instead." ### 2.10 - 2021-2-25 * Fixed a bug regarding cost table input ### 2.09 - 2021-1-8 * Fixed a bug in a module which caused the service to generate an error ### 2.08 - 2020-11-30 * Added possibility to input and overwrite default costs uses for finding measures, calculating investments, savings and return on investments: * Example of the "improvement\_costs" below: ``` {"data": {"post_code": "2771DS", "house_number":"87", "solar_panels":"10", "output_variant":"medium", "watt_panels":"true", "max_investment":"800", "target_label": "A", "improvement_costs": [{"code":10001,"material":4,"work":4}] }} ``` ### 2.07 - 2020-11-09 #### Fixed * Small bug fixed in regard to suggesting wall insulation for objects built before 1930. #### Changed * It is possible to insert the house-type and overwrite the default. The new parameter is optional and if not present in the input, the house-type from the database will be used. ### 2.06 - 2020-10-12 #### Added * A more accurate source is used for the default housing type, which will improve the quality of the advice #### Fixed * The specified inner surface area as input is also given as output from the API, in addition to being used for the calculations * There is a fix for an issue with house numbers as input where these are entered as eg "12a" which caused an error in the application --- # 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/changelog.md?ask= ``` 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.