etg24-Integration

Die etg24-Integration gleicht Ihre Objekte, Einheiten, Eigentümer und Mieter zwischen Abrechnung360 und dem ETG24-Kundenportal ab — in beide Richtungen. Dabei gilt ausnahmslos: gelöscht per Schnittstelle wird nie — weder in abrechnung360 noch in ETG24.

Aktivierung

Die Integration wird unter Konto & Einstellungen › Erweiterungen aktiviert. Danach erscheint dort der Eintrag etg24, der sowohl den Zugang als auch die Abgleichübersicht enthält. Siehe Erweiterungen im Überblick.

Verbindung der Systeme herstellen

Bevor etwas abgeglichen werden kann, müssen sich die beiden Programme gegenseitig kennen. Dazu erzeugen Sie in ETG24 einen API-Schlüssel und hinterlegen ihn in Abrechnung360. Sie brauchen dafür einen ETG24-Zugang mit Administratorrechten. Die Einrichtung dauert wenige Minuten und ist nur einmal je Verwaltung nötig.

1. In ETG24: Add-ons und Integrationen öffnen

   Melden Sie sich in Ihrem ETG24-Portal an und klicken Sie in der linken Navigation auf Einstellungen. Wählen Sie dort die Kachel Add-ons und Integrationen.

   

2. Individuelle Integrationen aktivieren

   Öffnen Sie in der Liste den Eintrag Individuelle Integrationen (Speziallösung). Steht rechts oben noch nicht Aktiv, aktivieren Sie die Integration zuerst — solange sie deaktiviert ist, funktionieren auch bereits angelegte Schlüssel nicht.

   

3. Einen API-Schlüssel anlegen

   Wechseln Sie innerhalb der Integration links auf Konfiguration und klicken Sie unten auf API-Schlüssel hinzufügen.

   

4. Titel vergeben und erstellen

   Tragen Sie als Titel Abrechnung360 ein und bestätigen Sie mit Erstellen. Der Titel dient nur der Wiedererkennung: Wollen Sie die Verbindung später widerrufen, finden Sie daran den richtigen Schlüssel. Legen Sie deshalb für jede Software einen eigenen Schlüssel an und verwenden Sie keinen doppelt.

   

5. Schlüssel kopieren

   ETG24 zeigt den vollständigen Schlüssel nur dieses eine Mal an. Kopieren Sie ihn über das Symbol rechts neben dem Feld und schließen Sie das Fenster erst, wenn der Schlüssel in Abrechnung360 gespeichert ist. Ist das Fenster doch zu früh zu: Schlüssel in ETG24 löschen und einen neuen anlegen — mehr passiert nicht.

   

6. Schlüssel in Abrechnung360 hinterlegen

   Wechseln Sie zu Abrechnung360, öffnen Sie Konto & Einstellungen › etg24 und fügen Sie den Schlüssel in das Feld API-Schlüssel ein. Legen Sie darunter fest, was abgeglichen werden soll, und klicken Sie auf Speichern. Anschließend prüfen Sie die Verbindung mit Verbindung testen — danach erscheinen Ihre Objekte in der Übersicht darunter.

   

API-Schlüssel geheim halten

Der API-Schlüssel ist ausschließlich in Abrechnung360 zu hinterlegen. Geben Sie ihn nicht per E-Mail an Unbeteiligte weiter und veröffentlichen Sie ihn nicht in Online-Foren oder Support-Gruppen. Ist ein Schlüssel an anderer Stelle bekannt geworden, löschen Sie ihn in ETG24 unter Konfiguration › API-Schlüssel und legen einen neuen an.

Was abgeglichen werden soll

In der Registerkarte etg24 legen Sie unterhalb des Schlüssels fest, welche Daten der Abgleich umfasst.

Einstellung	Wirkung
API-Schlüssel	Zugang zu Ihrem ETG24-Konto
Testumgebung verwenden	Gleicht gegen die ETG24-Testumgebung statt der Produktivumgebung ab
Automatisch abgleichen	Ein nächtlicher Lauf übernimmt neue ETG24-Objekte und gleicht alle nicht ignorierten Objekte ab — ohne Anmeldung
Eigentümer synchronisieren	Eigentumsverhältnisse inkl. Kontakten als Eigentümerverträge
Mieter synchronisieren	Mietverhältnisse inkl. Kontakten als Mieterverträge, Leerstand als Leerstandsvertrag

Objekte mit Adresse und Einheiten werden immer abgeglichen. Die Einstellungen lassen sich jederzeit ändern — der Schlüssel bleibt dabei hinterlegt.

Objekte abgleichen

Unterhalb der Verbindungseinstellungen zeigt die Übersicht den Abgleichstatus je Objekt. Abgeglichen werden nur verknüpfte Objekte — für alles andere entscheiden Sie einmalig.

Status	Bedeutung	Aktion
Verknüpft	Objekt existiert beidseitig und ist zugeordnet	wird bei jedem Lauf abgeglichen
Nur in abrechnung360	Objekt fehlt in ETG24	In ETG24 anlegen
Neu in ETG24	Objekt fehlt in Abrechnung360	Übernehmen
Ignoriert	vom Abgleich ausgenommen	Wieder abgleichen

1. Verknüpfen

   Wählen Sie zu einem Objekt das Gegenstück, das dieselbe Liegenschaft abbildet. Einheiten werden über die Nummer, Eigentums- und Mietverhältnisse über Einheit und Beginn zugeordnet. Gespeichert wird nur die Zuordnung — in ETG24 ändert sich dabei nichts.

2. Jetzt abgleichen

   Über Jetzt abgleichen (alle) oder Abgleichen je Zeile stoßen Sie den Abgleich an. Die Übersicht zeigt danach je Objekt „N übernommen, M übertragen“ bzw. aufgetretene Fehler.

3. Ergebnis prüfen

   Die Detailseite eines Objekts listet jede Änderung mit Richtung (→ abrechnung360 = übernommen, → ETG24 = übertragen), Typ, Bezeichnung, Status und einem Hinweis.

Ist Automatisch abgleichen aktiv, übernimmt ein nächtlicher Lauf neue ETG24-Objekte und gleicht alle verknüpften, nicht ignorierten Objekte ab — ganz ohne angemeldeten Benutzer. Neu auftauchende Objekte, die Sie nicht möchten, setzen Sie einmalig auf Ignoriert.