• iX-Haus-Lizenz für das Modul Webservice HKD EED. Der Webservice On-Site-Role für iX-Haus ist hierüber ab der Version 20.21.0 (KW 50) verfügbar.
• Internetverbindung
• Ebenso ist mit den Heizkostendiensten die Übertragung der Daten zu vereinbaren. Damit erhalten Sie die erforderlichen Zugangsdaten zum Webinterface des Heizkostendienstleisters. Für die Bereitstellung entsprechender Serverdienste ist jeder Heizkostendienstleister selbst verantwortlich.
• Für eine weitere Automatisierung der Datenlieferung mittels Scheduler wird eine ix-Haus plus-Lizenz für das Modul Scheduler benötigt.

Diese Diagnoseansicht wird i. d. R. für die Inbetriebnahme des Webservices für eine erste Kommunikation mit dem Server eingesetzt. Der Zugriff verändert die gespeicherten Daten nicht.

Für die ausgewählten Flächen wird der Status beim Heizkostendienst (HKD) abgefragt und die erhaltenen Daten im Rohformat angezeigt. Mit der Funktion kann geprüft werden, ob die Kommunikation mit dem Server funktioniert, der Login-Name und das Passwort richtig sind und ob die URL korrekt ist.

1. Markieren Sie die gewünschte/n Fläche/n.
2. Starten Sie aus dem Kontextmenü Anzeigen der aktuellen Daten vom HKD.
3. Die angezeigten Daten werden in einer Textbox im JSON-Format angezeigt.

Es wird zuerst anhand der Datumswerte geprüft, ob eine Übertragung erforderlich ist. Wenn sich die lokalen Daten seit der letzten erfolgreichen Übertragung nicht verändert haben, wird die Fläche nicht erneut übertragen.

1. Markieren Sie in der Übersicht des Moduls die gewünschte/n Fläche/n.
2. Rufen Sie aus dem Kontextmenü Übertrage aktuelle Daten zum HKD auf.

Im Katalog HKD Webservice Server zum HKD Webservice On-Site-Role müssen die Zugangsdaten zur Serverkommunikation für die einzelnen Dienstleister, mit denen Sie zusammenarbeiten, hinterlegt werden. Zu jedem Heizkostendienst können Sie hier mit Bezug auf eine Kundennummer das zugehörige Login und Passwort des Heizkostendienstleisters hinterlegen.

Im bereitgestellten Grid zum HKD Webservice On-Site-Role werden sämtliche Flächen angezeigt, für die in den Flächenstammdaten bereits Informationen zum Datenaustausch im Rahmen der Heizkosten (Heizkostendienstleister, Kundennummer, Ordnungsnummern) hinterlegt worden sind.

In der Listenansicht (Grid) lassen sich verschiedene Aktionen, wie beispielsweise der Export von Nutzerwechseln, manuell aufrufen.

Für einen regelmäßigen Datenexport steht im Scheduler eine zusätzliche Aufgabe zur Verfügung.

Im Bereich der Schnittstellenadministration werden die durchgeführten Aktionen und eventuelle Fehlermeldungen und Hinweise dokumentiert.

Für das automatische Übertragen der Daten kann ein Job im Scheduler angelegt werden. Das Modul Scheduler muss gesondert lizenziert werden!

Neben den Daten zur Ausführungsfrequenz und der zeitlichen Steuerung sind unter den Parametern der Benutzer aus iX-Haus sowie die laufende Nummer des Heizkostendienstes aus dem Katalog der Heizkostendienste in iX-Haus zu erfassen. Über den Modus lässt sich steuern, ob die Aufgabe Daten überträgt oder den Status abfragt. Weitere Informationen zum Scheduler entnehmen Sie bitte der zugehörigen Dokumentation im iX-Wiki.

Detailansicht des Schedulers beim Einrichten einer automatischen Übertragung

Über die Kontextmenüfunktion tragen Sie das Datum für die Übertragung eine oder mehrere Flächen ein. Der Eintrag erfolgt im Flächenstamm unter Heizkosten als Verbrauchsinformationen EED ab:. Im Regelfall werden nur leere Felder verändert. Nur mit der Option Überschreibe vorhandene Daten werden auch bereits vorhandene Daten geändert.

1. Markieren Sie in der Übersicht des Moduls die gewünschte/n Fläche/n.
2. Rufen Sie aus dem Kontextmenü Setze Startdatum für Übertragung auf.
3. Sollen vorhandene Daten überschrieben werden, um Datumswerte zu ändern, markieren Sie Überschreibe vorhandene Daten.
4. Starten Sie die Eintragung(en) mit OK

Zugang: iX-Haus plus > Schnittstellen > Webservice HKD EED > Katalog > Heizkostendienste
Beschränkter Zugang: iX-Haus > Fachadministration > Kataloge > Heizkostendienste

Der Katalog in iX-Haus plus basiert auf dem iX-Haus Katalog Heizkostendienste. Er ist hier mit den Abschnitten Webservice: On-Site-Role und Webservice: Dokumente erweitert um die Spalten Bereit für On-Site-Role Protokoll, Basispfad für die API 'On-Site-Roles', Keine e-Mail Übertragung, Keine S-BIR Übertragung, Kein GET-Befehl, Bereit für Webservice Dokumente und Basispfad für die API 'Webservice Dokumente'. Der Katalog Heizkostendienste kann somit an zwei Stellen aufgerufen werden. Unter iX-Haus Fachadministration werden jedoch nicht alle Felder des Katalogs angeboten!

Bitte beachten Sie, dass ein Katalogeintrag aktiviert sein muss und die korrekte Version des vereinbarten Datentauschs (2.1 oder 3.x) zugeordnet ist.
Wenn bei einem Heizkostendienst mehrere Kundennummern hinterlegt sind, können eine Reihe von einheitlichen Übertragungsparametern gleichzeitig erfasst werden.

Zugang: iX-Haus plus > Schnittstellen > Webservice HKD EED > Katalog > HKD Webservice Server

Zugang: iX-Haus plus > Schnittstellen > Webservice HKD EED > HKD Webservice On-Site-Role

Die Hauptansicht zum Modul (Grid) erreichen Sie über die Auswahl HKD Webservice On-Site-Role. In der Hauptansicht werden alle Flächen mit Daten für die Heizkostendienstleister angezeigt. Neben den in den Flächen erfassten Daten zum Heizkostendienstleister (u. a. Kundennummer, Ordnungsnummer) sind drei Datumswerte wichtig:

• Startdatum der Übertragung: Das Datum gibt vor, ab wann eine Fläche mit dem Webservice übertragen werden darf. Das Feld finden Sie im Flächenstamm unter Heizkosten als Verbrauchsinformationen EED ab:
• Letzter Abgleich: Bei einer erfolgreichen Übertragung der Daten zum Server des Heizkostendienstes wird das Datum Letzter Abgleich automatisch gesetzt.
• Letzte Änderung der iX-Haus Daten: Bei jedem Datensatz in iX-Haus und iX-Haus Plus wird automatisch gespeichert, wann der Datensatz zum letzten Mal verändert worden ist. In dieser Spalte werden die Änderungsdaten aus allen verknüpften Datensätzen ausgewertet und der größte Datumswert ausgegeben.

In der Spalte Status der Übertragung wird zu jedem Datensatz der letzte Status der Übertragung dargestellt. In Fällen, in denen die aktuellen Daten für eine Fläche manuell oder über ein Testsystem an den Heizkostendienst übertragen werden, wird bei einem anschließenden Abgleich der Daten erkannt, dass die Daten bereits validiert sind. Es werden keine neuen Daten übertragen, der Status der Übertragung wird jedoch nun auch ohne Details bei einem erfolgreichen Abgleich auf OK gesetzt

Per Doppelklick öffnen Sie eine Detailsicht zu einer Fläche. In der Detailansicht existieren zu jeder Fläche Register mit weiteren Daten.

Die Spalte PM Nummer enthält den 20-stelligen Ordnungsbegriff, der seitens iX-Haus vorgegeben und verwendet wird (ARGE-Ordnungsbegriff Auftraggeber). Der HKD-Ordnungsbegriff enthält den 13-stelligen Ordnungsbegriff des Heizkostendienstleisters. Die Ordnungsbegriffe Auftraggeber und Heizkostendienstleister entstammen der ARGE-Definition während PM Nummer und HKD Ordnungsnummer Begrifflichkeiten aus On-Site-Roles-Definitionen sind.

Register Belegungen

Im Register Belegungen werden die Verträge für die aktuelle Fläche angezeigt. Bei Zeilen ohne einen Personeneintrag handelt es sich um einen Leerstand.

Register Status der Übertragung

Das Register Status der Übertragung informiert detailliert über den Status der letzten Übertragung.

Register weitere Empfänger

Im Register weitere Empfänger werden Sonderfälle wie weitere Bewohner, die ggf. übermittelt werden, aufgeführt. Derzeit bietet iX-Haus hier zwei Datenquellen an.

1. Bei einer WEG mit Objekt für die Sondereigentumsverwaltung werden hier zugeordnete Belegungen aus dem SEV-Objekt angezeigt. Die Verbindung der Flächen zwischen dem WEG-Objekt und dem SEV-Objekt muss dafür im Flächenstamm hinterlegt sein. (Flächenstammregister Übersicht, Felder Fläche WEG und Fläche SE). Die Felder sind nur bei einem entsprechendem Objekttyp (WEG mit Sondereigentum, WEG mit Garantiemiete) sichtbar.
2. Bei einer WEG ohne gesondertes SEV-Objekt (Objekttyp WEG) können im Flächenstamm im Register WEG Mieter Mieterdaten dokumentiert werden (verfügbar ab Version iX-Haus 20.21.0/KW50).

Kontextmenübefehle

Markieren Sie die gewünschten Datensätze in der Listenansicht und öffnen Sie per Kontextmenü (rechte Maustaste) die weiteren Aktionen. Neben Standardmenüpunkten stehen fur die Tabelle HKD Webservice On-Site-Role folgende Funktionen zur Verfügung: