Improving the advice

The Sustainability API offers a lot of functions to improve the output from customers- and/or suppliers perspective. This page explains the different functions

Use the functions for the best possible sustainability advice

1. Questioning the home owner for the current situation and energy usage

   1. Property details

   2. Measures taken

2. Preferences of the home owner

3. Preferences of the provider

4. Presentation of the sustainability advice

Questioning the home owner for the current situation and energy usage

Description

Home data and consumption Postal Code * House number * House number addition Surface area (m2) House type Construction year Inhabitants Gas usage (m3) Electricity usage (kWh) City heating heat consumption

API input

"post_code": "2771DS", "house_number": "87", "addition": "A", "inner_surface_area": 130, "house_type": 1, "build_year": 2000, "inhabitants": 3, "gas_usage": 3000, "electricity_usage": 3500, "heat_usage": null

Explanation

The address is used to request all home data and to make estimates with regard to current measures and consumption. It is possible, but not required, to overwrite the surface area (residential usable area), the housing type, year of construction, number of inhabitants and cubic gas consumption.

* is required

Questioning current measures

Description

Present solar panels Existing installation Present insulation windows Existing insulation floor, facade and roof Existing ventilation Present shower HRV

API input

"solar_panels": 10, "installation": 4, "bedroom_windows": 1, "living_room_windows": 1, "wall_insulation": 1, "roof_insulation": 1, "floor_insulation": 1, "ventilation": 0, "shower": 0,

Explanation

With the year of construction, housing type, gas consumption and the surface area known, an estimate is made of the current measures in place. It is possible to overwrite this to generate an advice that is more in line with the current situation of the property.

Preferences of the customer

Description

Exclude measure in advice Maximum budget Target energy label as a minimum Boiler replacement is allowed Recommend heat pump Search criteria sustainability Gas consumption allowed Roof utilization for solar panels

API input

“lock_measures”: {“lock”: [“wall_insulation”]}, “max_investment”: 20000, “target_label”: “A”, “replace_boiler”: true, “heat_pump_allowed”: true, “search_criteria”: 1, “natural_gas”: 0, “solar_panels_surface”: 1,

Explanation

It is possible to lock measures so that they are not included in the advice. Indicate whether the boiler may be replaced and whether a heat pump may be recommended. A maximum budget or the goal of sustainability can be taken into account: best return, lowest investment costs, lowest energy bill or best energy label. It is also possible to exclude natural gas consumption and to indicate to what extent the roof may be used for solar panels.

Preferences of the provider

Description

Exclude sub-measure in advice Strict search within target energy label Show number of panels or wattage Minimum number of solar panels advice Only heat pump from certain insulation level Cost figures Cost table

API input

“exclude_measure”: [8004,8005], “energylabel_strict”, “watt_panels”: false, “minimum_solar_panels”: 5, “heatpump_insulation_req”: 2, “custom_costs”: [{“code”: 3, “value”: 0.8}], “improvement_costs": [{"code": 10001,"material": 15,"work": 10, "saving_material": 14,"saving_work": 9}]

Explanation In addition to locking entire measures, a sub-measure such as the biomass boiler can also be excluded. It is also possible to search strictly within one energy label as a target. By default we show the number of solar panels as output, but wattage is also possible. You can also enforce the minimum number of solar panels that are recommended. Just like from which insulation level a heat pump is recommended. Finally, it is possible to overwrite all used installation costs and cost indicators such as VAT and energy prices.

Presentation of the advice

Description

Estimated energy label current & new Eco value: market value increase Investment required CO2 reduction Investment, savings CO2 reduction and BENG2 impact in % per measure Current definitive energy label (RVO)

API input

"label": {"current": "G", "potential": "A"}, "eco_value": 37087.0, "total_investment": 28597.3, "CO2": {"current": 10632,"potential": 4099}, "investment": 2994.39,"saving": 1107, "co2_reduce": 2541, "BENG2": "23.8%", "definitive": "C", "definitive_type": NTA8800,"definitive_validity": 05072031},

Explanation The API makes an estimate of the current and new energy label based on. the NTA 8800. A calculation is made of the increased market value after sustainability. The required costs and CO2 reduction are also shown in total, as well as the relative impact on the energy label for each measure. The definitive energy label is collected from the RVO.