Energy Certificates

From 1st of May 2014, a new law came into effect. All real estate offerings (exposes) need to contain an energy certificate ("Energieausweis") if you have an energy certificate for the object. This also applies to GEG2020 which came into effect on 1st of Nov 2020.

Note:

Which fields need to be filled in and when, depends on several factors. See the matrix below for the answers.
The following real estate types are NOT affected: Grundstück (livingRentSite, livingBuysite), Typenhaus (houseType), Garage (garageRent, garageBuy), Altenpflege (seniorCare), international objects.
WADL and XSD schema contains the EnEv2014 fields. This also applies to GEG2020 where the new attribute "CO2-consumption" is not mandatory for real estate offerings (exposes) — but mandatory for viewings. To avoid breaking existing API-contracts it's currently not possible to have a field on CO2-consumption.
Landing page for energy certificate with functional info: here
Validation is turned ON. Please send only relevant fields. Relevant fields are dependent on creationDate, buildingEnergyRatingType and object type (commercial or non-commercial). You can find the relevant fields in the matrix below.
If you get errors like "{energyCertificateField}_NOT_VALID_FOR_THIS_CERTIFICATE" your request doesn't pass the energy certificate validation. Its code is public now (Java validation of EnEv fields), so you can validate your request locally before sending it to the IS24 API.
Include the query parameter usenewenergysourceenev2014values=true in GET/PUT/POST requests to the realestate API to be able to use the 8 new values in the field energySourceEnev2014.

Heizungsart (HeatingTypeEnev2014)

Deprecated field name: HeatingType

New field name: HeatingTypeEnev2014

Field type: enum

Old values:

STOVE_HEATING (Ofenheizung)
SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung)
CENTRAL_HEATING (Zentralheizung)
NO_INFORMATION (keine Angabe)

New values:

COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk)
ELECTRIC_HEATING (Elektro-Heizung)
DISTRICT_HEATING (Fernwärme)
FLOOR_HEATING (Fußbodenheizung)
GAS_HEATING (Gas-Heizung)
WOOD_PELLET_HEATING (Holz-Pelletheizung)
NIGHT_STORAGE_HEATER (Nachtspeicherofen)
OIL_HEATING (Öl-Heizung)
SOLAR_HEATING (Solar-Heizung)
HEAT_PUMP (Wärmepumpe)

Befeuerungsart (energySourceEnev2014)

Deprecated field name: firingType

New field name: energySourceEnev2014

Field type: enum

Old values:

NO_INFORMATION (keine Angabe)
GEOTHERMAL (Erdwärme)
SOLAR_HEATING (Solar)
PELLET_HEATING (Holzpellets)
GAS (Gas)
OIL (Öl)
DISTRICT_HEATING (Fernwärme)
ELECTRICITY (Strom)
COAL (Kohle)

New values:

ACID_GAS (Erdgas leicht)
SOUR_GAS (Erdgas schwer)
LIQUID_GAS (Flüssiggas)
STEAM_DISTRICT_HEATING (Fernwärme Dampf)
WOOD (Holz)
WOOD_CHIPS (Holz-Hackschnitzel)
COAL_COKE (Kohle/Koks)
LOCAL_HEATING (Nahwärme)
HEAT_SUPPLY (Wärmelieferung)

values when "usenewenergysourceenev2014values=true":

BIO_ENERGY (Bioenergie)
WIND_ENERGY (Windenergie)
HYDRO_ENERGY (Wasserenergie)
ENVIRONMENTAL_THERMAL_ENERGY (Umweltwärme)
COMBINED_HEAT_AND_POWER_FOSSIL_FUELS (KWK fossil)
COMBINED_HEAT_AND_POWER_RENEWABLE_ENERGY (KWK erneuerbar)
COMBINED_HEAT_AND_POWER_REGENERATIVE_ENERGY (KWK regenerativ)
COMBINED_HEAT_AND_POWER_BIO_ENERGY (KWK Bio)

Energieausweis-Verfügbarkeit (energyCertificateAvailability)

Because there are real estate objects which don't need an energy certificate (see list at the top), or an energy certificate is not available yet, there is a new field to be backwards compatible. In the XSD schema you can find this field on top of "energyCertificate" (type="EnergyPerformanceCertificate"). This new field can turn the EnEv Java Validation on or off.

Field name: energyCertificateAvailability

Field type: enum

Values: AVAILABLE, NOT_AVAILABLE_YET, NOT_REQUIRED

Validation on: null or AVAILABLE

Validation off: NOT_AVAILABLE_YET or NOT_REQUIRED

Energieausweis-Erstellungsdatum (energyCertificateCreationDate)

Field name: energyCertificateCreationDate

Field type: enum

Values: BEFORE_01_MAY_2014, FROM_01_MAY_2014, NOT_APPLICABLE

Energieeffizienzklasse (energyEfficiencyClass)

Field name: energyEfficiencyClass

Field type: enum

Values: NOT_APPLICABLE, A+, A, B, C, D, E, F, G, H