# 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](https://docs.altum.ai/verduurzamen/verduurzaming-api/comfort-score). ### 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**](https://docs.altum.ai/verduurzamen/verduurzaming-api/maatregelen-uitsluiten)**.** * 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