energyConsumptionContainsWarmWater wird unnötigerweise mitgeliefert

[Heiko Wissmann]

Hallo Zusammen,

mir ist beim Import von IS24 zu unserem System aufgefallen, dass das Feld energyConsumptionContainsWarmWater bei jeder Konstellation von Erstellungsdatum und Art des Ausweises mit übergeben wird.

In meinen Augen kann das Feld drei Werte haben: Ja, Nein und nicht gesetzt. Bei uns im System ist dies auch der Fall, aber wenn immer NOT_APPLICABLE übergeben wird, sowohl wenn der Wert explizit auf "Nein" gesetzt wird (kein Haken im Formular) als auch wenn der Wert im Formular garnicht vorhanden ist.

Müssen wir nun selber einen Filter implementieren, der auf den einen Zustand testet bei dem der Wert relevant ist, um den richtigen Wert einzutragen oder wird das Verhalten noch geändert, so dass der Wert sofern er nicht relevant ist überhaupt nicht übertragen wird?

Viele Grüße,

Heiko Wißmann

[Andreas Vilinski]

Noch ein Hinweis von mir:

Laut Wiki und XSD kann das Feld nur YES oder NOT_APPLICABLE sein.

In Energie-Wiki steht fälschlicherweise YES, NO, NOT_APPLICABLE

Beim versuch ein Objekt mit NO zu posten kriegt man den Fehler:

Schema-Validierung ist fehlgeschlagen.: The request is not schema valid. [MESSAGE: org.xml.sax.SAXParseException; lineNumber: 91; columnNumber: 41; cvc-enumeration-valid: Value 'NO' is not facet-valid with respect to enumeration '[YES, NOT_APPLICABLE]'. It must be a value from the enumeration.]

[Fabian Mielke]

@Andreas: habe ich im "Energie-Wiki" angepasst. Vielen Dank für den Hinweis.

@Heiko: Ich bekomme den Fall wie du ihn beschrieben hast rekonstruiert. POST via API oder im Web ohne energyConsumptionContainsWarmWater, beim GET via API erhält man ein energyConsumptionContainsWarmWater=NOT_APPLICABLE. Das passiert an der Stelle mit allen Feldern, die "NOT_APPLICABLE" oder "NO_INFORMATION" fähig sind. Wir tragen dabei nichts in die Datenbank, sondern die API gibt lediglich eine Art "null" zurück. Wenn du das jetzt via GET in dein System lädst, ist dieser Wert genau so "nicht" gesetzt. Wenn man jetzt einen Energieausweis hat, wobei energyConsumptionContainsWarmWater gar nicht relevant ist, funktioniert der Request trotzdem, weil er ja auf NOT_APPLICABLE steht. In dem Fall ist NOT_APPLICABLE fragwürdig, weil es gleichzeitig null, nicht benötigt und nein bedeutet. Ändern wird sich daran aber nichts. Der Wert enthält also so lange kein Warmwasser bis er auf YES gesetzt ist.

Also es wird seitens der API kein Verhalten geändert, aber ein Filter ist auch nicht von Nöten, da energyConsumptionContainsWarmWater=NOT_APPLICABLE nicht von der Validierung nicht abgewiesen wird und wie null funktioniert.

MfG Fabian

[Michael Ganß]

Hier ist die Doku immer noch falsch:

http://api.immobilienscout24.de/useful/energy-certificate-2014.html

"Energieverbrauch für Warmwasser enthalten (energyConsumptionContainsWarmWater),

Values: YES, NO, NOT_APPLICABLE

Relevant for certificates, created before 30th april 2014: If the heating for warm water is not included energyConsumptionContainsWarmWater=false), then the value for energy consumption (Endenergieverbrauch) has to raised by a lump sum of 20 kilowatt hours/year/sqm."

[Angelina Staeck | IS24]

Hallo Michael,

danke für deinen Hinweis, wir haben die Doku dementsprechend angepasst.

MfG

Angelina