API: Engelmann

Mit diesem Importer ruft ERAS2 Ablesewerte direkt aus dem Engelmann-System ab. Eine Datei ist dafür nicht nötig.

Für die Nutzung dieser Schnittstelle ist eine gesonderte Lizenz erforderlich.

Voraussetzungen

Sie benötigen einen API-Token, den Sie von Engelmann erhalten.

Einrichtung

In der Liste der für Sie zur Verfügung stehenden Importer finden Sie den Eintrag API Engelmann Abruf. Nach der Auswahl tragen Sie unter Optionen ein:

Feld	Bedeutung
`Token:`	Der API-Token von Engelmann.
`Ablesewerte ab`	Werte mit einem früheren Datum werden nicht übernommen. Vorbelegt ist heute vor zwei Monaten.
`Estate Filter:`	Optional. Es werden nur Liegenschaften abgerufen, deren Name bei Engelmann diesen Text enthält. Achten Sie auf Groß- und Kleinschreibung. Leer bedeutet: alle Liegenschaften.
`Probedurchlauf`	Ruft alle Daten ab und schreibt das Protokoll, übernimmt aber nichts in ERAS2. Gut geeignet für den ersten Test.
`Ablesungen vor dem Einbaudatum übernehmen`	Ohne Haken werden Werte verworfen, die vor dem Einbaudatum des Geräts liegen.

Was übernommen wird

Monatswerte mit der Ableseart MO.
Stichtagswerte mit der Ableseart HA.
Liefert ein Gerät weder Monats- noch Stichtagswerte, wird der aktuelle Wert als MO übernommen.
Einheiten: Heizkostenverteiler-Einheiten, m³, kWh und MWh. Werte mit einer anderen Einheit werden nicht übernommen und im Protokoll vermerkt.
Meldet Engelmann einen Gerätefehler, wird er mit Fehlertext am Ablesewert vermerkt.
Rauchwarnmelder erhalten den Status in Ordnung oder Fehler.

Zuordnung zu Ihren Objekten

Jede Engelmann-Liegenschaft wird einem ERAS2-Objekt zugeordnet. ERAS2 prüft dazu bis zu fünf Geräte der Liegenschaft über die Gerätenummer und nimmt das Objekt, zu dem die meisten davon gehören.

Ist keines dieser Geräte in ERAS2 bekannt, wird die Liegenschaft übersprungen und im Protokoll mit „Kein Objekt gefunden …“ vermerkt.
Geräte, die im zugeordneten Objekt fehlen, erscheinen im Bericht mit „Gerät mit der Nummer … wurde nicht gefunden.“

Ablauf und Protokoll

Während des Abrufs zeigt ERAS2 den Fortschritt je Liegenschaft. Am Ende fasst das Protokoll zusammen, wie viele Liegenschaften zugeordnet wurden, wie viele fehlgeschlagen sind und wie viele Werte übernommen wurden. Ein laufender Abruf lässt sich mit Abbrechen beenden.

Ist der Token ungültig, bricht der Import mit einer technischen Fehlermeldung ab. Prüfen Sie in diesem Fall zuerst den Token.