In der beigefügten Tabelle können Sie genau nachvollziehen, welche Datenfelder aus iX-Haus in welche entsprechenden Felder in iDWELL übertragen werden. Sie sehen auf einen Blick, wie die Datenzuordnung (Mapping) erfolgt.
Tabelle mit Datenfeldern ansehen
Um die Datenqualität und eine transparente Zusammenarbeit sicherzustellen, bitten wir Sie, die folgenden Hinweise zu beachten:
-
Aktualität und Vollständigkeit: Diese Dokumentation basiert auf der aktuellsten Version des Datenaustauschs zwischen iDWELL & iX-Haus (Stand: November 2026). Die korrekte und vollständige Befüllung der Quellfelder in Ihrem ERP-System liegt in Ihrer Verantwortung. Fehlerhafte Quelldaten führen zu fehlerhaften Zieldaten in iDWELL.
-
Änderungen der Datenübertragung: Bei zukünftigen Änderungen der Datenübertragung durch uns werden wir diese Dokumentation zeitnah aktualisieren und Sie entsprechend informieren. Sollten Sie eigenständig Änderungen an den Datenfeldern oder der Übertragungslogik in Ihrem ERP-System vornehmen, müssen Sie uns umgehend informieren.
-
Diese Dokumentation dient ausschließlich informatorischen Zwecken. Sie ist keine rechtsverbindliche Zusicherung bestimmter Eigenschaften oder Funktionen des Datenaustausches zu iX-Haus, es sei denn, dies ist explizit in Ihrem Hauptvertrag oder einer Service Level Agreement (SLA) anders geregelt.
-
Wir übernehmen keine Haftung für Schäden, die durch die Nutzung, Interpretation oder fehlerhafte Anwendung dieser Dokumentation entstehen, oder für Schäden, die durch unautorisierte Änderungen an der Konfiguration oder der Datenstruktur in Ihrem ERP-System verursacht werden.
So funktioniert der Datenaustausch
Übertragungsweg: Schnittstelle (API) – automatischer Datenabruf aus iX-Haus über einen Connector
Richtung: Die Stammdaten werden aus iX-Haus nach iDWELL übertragen. iX-Haus ist das führende System – Änderungen an Stammdaten nehmen Sie bitte immer in iX-Haus vor, da manuelle Änderungen in iDWELL bei der nächsten Synchronisation überschrieben werden können.
Dokumente: Über diese Schnittstelle werden ausschließlich Stammdaten übertragen, keine Dokumente.
Wichtige Regeln beim Import
Objektnummern werden einheitlich 5-stellig mit führenden Nullen übernommen, Einheitennummern im Format 00000.000000.
Objektgruppen mit der Bezeichnung "**** GELÖSCHT ****" werden nicht importiert.
Bei Bankdaten von Mietern/Eigentümern wird eine virtuelle IBAN bevorzugt; die Bankverbindung des Objekts stammt aus der Objektbank, ersatzweise aus der Finanzbuchhaltung.
Kaution und Saldo werden aus den Buchungen berechnet (Kaution: Summe der Kautionsbuchungen; Saldo: offene Posten des aktuellsten Wirtschaftsjahres).
Mehrere E-Mail-Adressen oder Telefonnummern pro Person werden getrennt und alle gespeichert; die erste ist jeweils die Hauptadresse bzw. Hauptnummer.
Objektbetreuer (iX-Haus-Benutzer) werden mit Vorname, Nachname, Telefon und E-Mail als Verwalter übernommen und den Objekten ihres Teams zugeordnet; deaktivierte Benutzer werden archiviert.
Hauseigentümer und Dienstleister werden mit ihren Objekten verknüpft.
Übersicht der übertragenen Datenfelder
| Ebene | Feldname in iDWELL | Praxisbeispiel | Feldname in iX-Haus | Variable in iDWELL | Zusatzinformationen |
| Gebäude | Gebäude-ID | 4711 | HDR_ID (Objekte) | - | Interne, eindeutige Kennung des Objekts in iX-Haus. Dient der eindeutigen Zuordnung bei jedem Abgleich. |
| Gebäude | Objektnummer | 00997 | OBJNR (Objekte) | {{building_info_object_number}} | Wird links mit Nullen auf 5 Stellen aufgefüllt (z. B. 997 → 00997). |
| Gebäude | Code | 00997 | OBJNR (Objekte) | - | Wie Objektnummer, 5-stellig mit führenden Nullen. |
| Gebäude | Basis-Adresse | Musterstr. 1, 01234 Berlin | O_STR + O_ORT (Objekte) | - | Kombination aus Straße und PLZ/Ort des Objekts. |
| Gebäude | Straße | Musterstr. 1 | O_STR (Objekte) | {{building_info_street}} | |
| Gebäude | Postleitzahl | 01234 | O_ORT (Objekte) | {{building_info_postal_code}} | Die PLZ wird aus dem kombinierten Feld PLZ/Ort herausgelöst. |
| Gebäude | Ort | Berlin | O_ORT (Objekte) | {{building_info_location}} | Der Ort wird aus dem kombinierten Feld PLZ/Ort herausgelöst. |
| Gebäude | Objekttyp | WEG | OBJTYP (Objekte) | {{building_info_living_type}} | Der Typ-Code aus iX-Haus wird in Klartext umgewandelt: 1 = Mietobjekt, 2 = WEG, 4 = Sondereigentumsobjekt, 5 = Garantieobjekt, 16 = Hauptbuchhaltung, 512 = Mandantenobjekt, 1024 = Verwaltungsobjekt. |
| Gebäude | Baujahr | 1995 | P_BAUJAHR (Objekte) | {{building_info_construction_year}} | |
| Gebäude | Vertragsbeginn | 01.01.2024 | DWVERWALTUNGSBEGINN (Objekte) | {{building_info_contract_start}} | Beginn der Verwaltung des Objekts. |
| Gebäude | Vertragsende | 31.12.2028 | DWVERWALTUNGSENDE (Objekte) | {{building_info_contract_end}} | Ende der Verwaltung des Objekts. |
| Gebäude | Rechnungsanschrift | Musterweg 5, 01234 Berlin | ANS_4 + ANS_5 (Eigentümer) | {{building_info_address_invoice}} | Wird aus der Adresse des Objekteigentümers übernommen. Bei mehreren Eigentümern wird der erste verwendet. |
| Gebäude | Bankname | Musterbank | Bankname der Objektbankverbindung | {{building_info_bank_name}} | Es wird die Bankverbindung des Objekts verwendet. Ist keine Objektbank hinterlegt, wird die Bankverbindung der Finanzbuchhaltung übernommen. |
| Gebäude | IBAN | DE12 3456 7890 1234 5678 90 | IBAN der Objektbankverbindung | {{building_info_bank_iban}} | Siehe Bankname. |
| Gebäude | BIC | MUSTDEXXX | SWIFT/BIC der Objektbankverbindung | {{building_info_bank_bic}} | Siehe Bankname. |
| Gebäude | Gebäudegruppe | Gruppe Nord | ID + GRPNR (Objektgruppen) | - | Objekte werden der in iX-Haus hinterlegten Objektgruppe zugeordnet. Gruppen mit der Bezeichnung "**** GELÖSCHT ****" werden nicht übernommen. |
| Einheit | Externe ID | 4711-889 | HDR_ID (Objekte) - HDR_ID (Flächen) | - | Zusammengesetzt aus der ID des Objekts und der ID der Fläche/Einheit. |
| Einheit | Tür / Einheit | 00997.000005 | OBJNR + FLSTMNR (Flächen) | - | Format: Objektnummer 5-stellig, Punkt, Flächennummer 6-stellig (jeweils mit führenden Nullen). |
| Einheit | Nutzfläche | 85,5 | Flächenwert der Flächenart Nr. 1 (Flächenanteile) | - | Es wird der jeweils aktuellste Flächenwert in m² übernommen. |
| Einheit | Zimmeranzahl | 3 | Flächenwert mit Umlageschlüssel "Zimmer" (Flächenanteile) | - | Es wird der Wert des Umlageschlüssels übernommen, dessen Bezeichnung "Zim" enthält, und als ganze Zahl gespeichert. |
| Einheit | Einheitentyp | Wohnung | KBEZ (Flächenart) | {{flat_info_room_type}} | Kurzbezeichnung der Flächenart (z. B. Wohnung, Gewerbe, Stellplatz). |
| Einheit | Adresseingang | Musterstr. 1, 01234 Berlin | STR + ORT (Flächen) | {{flat_info_entrance}} | Adresse direkt aus den Flächendaten der Einheit. |
| Einheit | Vertrags-ID | 0099712 | OBJNR + NO (Personenkonten) | {{flat_contract_id}} | Zusammengesetzt aus Objektnummer und Nummer des Personenkontos. Identifiziert das Vertragsverhältnis eindeutig. |
| Einheit | Vertragsbeginn | 01.05.2020 | BEGIN (Belegungen) | {{flat_contract_start}} | Einzugsdatum bzw. Beginn des Vertragsverhältnisses. |
| Einheit | Vertragsende | 30.04.2025 | END (Belegungen) | {{flat_contract_end}} | Auszugsdatum bzw. Ende des Vertragsverhältnisses. |
| Mieter/Eigentümer | Externe Benutzer-ID | 12345 | HDR_ID (Adressen) | - | Eindeutige Kennung der Person in iX-Haus. Über diese ID werden Person und Vertrag verknüpft. |
| Mieter/Eigentümer | Vorname | Max Mustermann | ANS_2 (Adressen), alternativ NAM (Adressen) | {{recipient_first_name}} | Es wird die Profil-Namenszeile ANS_2 verwendet; ist diese leer, der Name aus NAM. Der Name wird vollständig in dieses Feld übernommen, ein separater Nachname wird für Mieter/Eigentümer nicht übertragen. |
| Mieter/Eigentümer | max@email.de | EMAIL (Adressen) | {{recipient_email}} | Mehrere E-Mail-Adressen in einem Feld werden getrennt (Komma, Semikolon, Slash). Die erste Adresse wird Haupt-E-Mail, alle weiteren werden zusätzlich gespeichert. | |
| Mieter/Eigentümer | Telefon | +49 170 123456 | TEL_1, TEL_2, TEL_3 (Adressen) | {{recipient_phone}} | Alle drei Nummern werden vereinheitlicht übernommen; die erste vorhandene Nummer wird Haupttelefonnummer. |
| Mieter/Eigentümer | Rolle | Mieter | LBUCHTYP (Personenkonten) | {{recipient_role}} | Die Rolle wird aus dem Buchungstyp des Personenkontos abgeleitet. |
| Mieter/Eigentümer | Anrede | Sehr geehrter Herr | ANR_1 (Adressen) | {{recipient_info_salutation}} | Die Anrede aus iX-Haus wird auf die deutschen Standardanreden in iDWELL umgesetzt. |
| Mieter/Eigentümer | Titel | Dr. | ANS_1 (Adressen) | {{recipient_info_title}} | |
| Mieter/Eigentümer | Klasse / Status | Wohnung | KBEZ (Flächenart der verknüpften Einheit) | {{recipient_info_status}} | Es wird der Einheitentyp der Einheit übernommen, mit der die Person verknüpft ist. |
| Mieter/Eigentümer | Postanschrift: Vollständige Adresse | Hauptstraße 1, 10115 Berlin | ANS_5 + ANS_6 (Adressen) | {{recipient_info_address}} | Zusammengesetzt aus Straße sowie PLZ und Ort. |
| Mieter/Eigentümer | Postanschrift: Straße | Hauptstraße 1 | ANS_5 (Adressen) | {{recipient_info_street}} | |
| Mieter/Eigentümer | Postanschrift: PLZ | 10115 | ANS_6 (Adressen) | {{recipient_info_info_postcode}} | Die PLZ wird aus dem kombinierten Feld PLZ/Ort herausgelöst. |
| Mieter/Eigentümer | Postanschrift: Ort | Berlin | ANS_6 (Adressen) | {{recipient_info_city}} | Der Ort wird aus dem kombinierten Feld PLZ/Ort herausgelöst. |
| Mieter/Eigentümer | IBAN | DE12 3456 7890 1234 5678 90 | IBAN der Personenbankverbindung | {{recipient_info_iban}} | Ist für die Person eine virtuelle IBAN hinterlegt, wird diese bevorzugt übernommen; sonst die reguläre Bankverbindung. |
| Mieter/Eigentümer | BIC | MUSTDEXXX | SWIFT/BIC der Personenbankverbindung | {{recipient_info_bic}} | |
| Mieter/Eigentümer | Bankname | Musterbank | Bankname der Personenbankverbindung | {{recipient_info_bank_name}} | |
| Mieter/Eigentümer | Kaution | 1500.00 | Kautionsbuchungen des Personenkontos | {{recipient_info_deposit}} | Summe aller Kautionsbuchungen der Person: Einzahlungen werden addiert, Auszahlungen abgezogen. |
| Mieter/Eigentümer | Saldo | -250.00 | Offene Posten des Personenkontos | {{recipient_info_open_amount}} | Summe der offenen Posten (Soll/Haben) im jeweils aktuellsten Wirtschaftsjahr. |
| Mieter/Eigentümer | Notiz (Finanzen) | Musterbank, DE12 …, MUSTDEXXX | BANK_BNK, BANK_IBAN, BANK_BIC (Personenkonten) | - | Die direkt am Personenkonto hinterlegte Bankverbindung wird zusätzlich als Notiz im Bereich Finanzen abgelegt. |
| Mieter/Eigentümer | Partner: Anrede | Sehr geehrte Frau | ANR_2 (Adressen) | {{recipient_info_partner_salutation}} | Wird auf die deutschen Standardanreden in iDWELL umgesetzt. |
| Mieter/Eigentümer | Partner: Vollst. Name | Maria Mustermann | ANS_3 (Adressen) | {{recipient_info_partner_full_name}} | |
| Hauseigentümer | Externe ID | 501 | NO (Eigentümer) | - | Eindeutige Nummer des Eigentümers in iX-Haus. |
| Hauseigentümer | Vorname | Immobilien | ANS_2 (Eigentümer) | {{recipient_first_name}} | Eigentümer werden mit der Rolle Hauseigentümer angelegt. |
| Hauseigentümer | Nachname | AG | ANS_3 (Eigentümer) | {{recipient_second_name}} | |
| Hauseigentümer | Postanschrift: Vollständige Adresse | Musterweg 5, 01234 Berlin | ANS_4 + ANS_5 (Eigentümer) | {{recipient_info_address}} | Wird zusätzlich als Rechnungsanschrift des Objekts verwendet. |
| Hauseigentümer | Postanschrift: Straße | Musterweg 5 | ANS_4 (Eigentümer) | {{recipient_info_street}} | |
| Hauseigentümer | Postanschrift: PLZ / Ort / Land | 01234 / Berlin / Deutschland | ANS_5 (Eigentümer) | {{recipient_info_info_postcode}}, {{recipient_info_city}}, {{recipient_info_country}} | PLZ, Ort und Land werden aus dem kombinierten Adressfeld herausgelöst. |
| Hauseigentümer | Zugeordnete Objekte | 00997 | OBJNR (Objekt-Eigentümer-Zuordnung) | - | Der Eigentümer wird allen ihm in iX-Haus zugeordneten Objekten verknüpft. |
| Dienstleister | Externe ID | 70001 | NO (Kreditoren) | - | Eindeutige Kreditorennummer in iX-Haus. |
| Dienstleister | Name | Muster Haustechnik GmbH | ANS_2 (Kreditoren) | - | |
| Dienstleister | info@muster-haustechnik.de | EMAIL (Kreditoren) | - | ||
| Dienstleister | Telefon | +49 30 123456 | TEL_1 (Kreditoren) | - | Vereinheitlicht übernommen. |
| Dienstleister | Adresse | Werkstr. 3, 01234 Berlin | ANS_4 + ANS_5 (Kreditoren) | - | |
| Dienstleister | Kategorie / Gewerk | Sanitär | GEWERK (Kreditoren) | - | Alle Gewerke eines Dienstleisters werden als Kategorien gesammelt übernommen. |
| Dienstleister | Beschreibung | Tel. 2: …, USt-ID: DE123456789, St.-Nr.: 12/345/67890 | TEL_2, TEL_3, USTID, STEUERNR (Kreditoren) | - | Weitere Telefonnummern, USt-ID und Steuernummer werden als Text in der Beschreibung des Dienstleisters abgelegt. |
| Dienstleister | Zugeordnete Objekte | 00997 | OBJNR (Buchungskreise) | - | Der Dienstleister wird den Objekten zugeordnet, für die er in iX-Haus als Kreditor geführt wird. |
Hier finden Sie mehr Informationen:
