In der beigefügten Tabelle können Sie genau nachvollziehen, welche Datenfelder aus HausPerfekt 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 & HausPerfekt (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 HausPerfekt, 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: API (HausPerfekt-Schnittstelle / Aareon Connect); alternativ Dateiexport (CSV) via FTP
Richtung: Die Stammdaten werden aus HausPerfekt nach iDWELL übertragen. HausPerfekt ist das führende System – Änderungen an Stammdaten nehmen Sie bitte immer in HausPerfekt 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
Personen werden nur importiert, wenn ihrer Vertragsrolle eine Objektnummer und eine Einheitennummer zugeordnet sind.
Die Verknüpfung von Person, Vertrag, Einheit und Gebäude erfolgt über die Vertragsrolle (Funktion) in HausPerfekt.
Einige Felder (z. B. Postanschrift, Bankdaten, Kaution, Partnerdaten, Bankdaten des Objekts) werden nur beim CSV-Export übertragen; über die API stehen sie derzeit nicht zur Verfügung.
Werte wie "Keine Information" bzw. "Keine Info" werden als leere Werte behandelt.
Rollen werden ohne Zusatz übernommen (z. B. "Mieter SEV" → "Mieter"); "Leerstand" gilt als leer, Personen ohne Rolle werden als Bewohner angelegt.
Ist in iDWELL die Einstellung "Gebäude archivieren" aktiv, werden Gebäude nach ihrem Vertragsende automatisch archiviert (CSV-Export).
Übersicht der übertragenen Datenfelder
| Ebene | Feldname in iDWELL | Praxisbeispiel | Feldname in HausPerfekt | Variable in iDWELL | Zusatzinformationen |
| Gebäude | Gebäude-ID | 997 | ObjektNummer (Einheit) bzw. Objektnummer (Objekt) | - | CSV-Export: ObjNr (Spalte BG). |
| Gebäude | Code | 997 | ObjektNummer (Einheit) bzw. Objektnummer (Objekt) | - | CSV-Export: ObjNr (Spalte BG). |
| Gebäude | Basis-Adresse | Musterstr. 1, 01234 Berlin | Suchbegriff (Objekt) | - | CSV-Export: Obj_Adresse (Spalte BI). |
| Gebäude | Objektnummer | 997 | Objektnummer (Objekt) | {{building_info_object_number}} | CSV-Export: Spalte BK. |
| Gebäude | Straße | Musterstr. 1 | Straße (Objekt) | {{building_info_street}} | Nur über die API verfügbar. |
| Gebäude | Postleitzahl | 01234 | Postleitzahl (Objekt) | {{building_info_postal_code}} | Nur über die API verfügbar. |
| Gebäude | Ort | Berlin | Ort (Objekt) | {{building_info_location}} | Nur über die API verfügbar. |
| Gebäude | Baujahr | 1985 | Baujahr (Objekt) | {{building_info_construction_year}} | Nur über die API verfügbar. |
| Gebäude | Objekttyp | WEG | Typ (Objekt) | {{building_info_living_type}} | CSV-Export: Spalte BL. |
| Gebäude | Vertragsbeginn | 01.01.2024 | – (nur CSV-Export, Spalte BM) | {{building_info_contract_start}} | Wird nur beim CSV-Export übertragen (Spalte BM); über die API derzeit nicht verfügbar. |
| Gebäude | Vertragsende | 31.12.2028 | – (nur CSV-Export, Spalte BN) | {{building_info_contract_end}} | Wird nur beim CSV-Export übertragen (Spalte BN); über die API derzeit nicht verfügbar. Ist in iDWELL die Einstellung "Gebäude archivieren" aktiv, wird das Gebäude nach diesem Datum automatisch archiviert. |
| Gebäude | IBAN | DE12 3456 7890 1234 5678 90 | – (nur CSV-Export, Spalte BP) | {{building_info_bank_iban}} | Wird nur beim CSV-Export übertragen (Spalte BP); über die API derzeit nicht verfügbar. |
| Gebäude | BIC | MUSTDEXXX | – (nur CSV-Export, Spalte BQ) | {{building_info_bank_bic}} | Wird nur beim CSV-Export übertragen (Spalte BQ); über die API derzeit nicht verfügbar. |
| Gebäude | Bankname | Musterbank | – (nur CSV-Export, Spalte BR) | {{building_info_bank_name}} | Wird nur beim CSV-Export übertragen (Spalte BR); über die API derzeit nicht verfügbar. |
| Gebäude | Kontoinhaber | WEG Musterstr. 1 | – (nur CSV-Export, Spalte BS) | {{building_info_bank_account_owner}} | Wird nur beim CSV-Export übertragen (Spalte BS); über die API derzeit nicht verfügbar. |
| Einheit | Externe ID | 997-001 | ObjektNummer + Einheitennummer (Einheit) | - | Zusammengesetzt aus Objektnummer und Einheitennummer. |
| Einheit | Tür / Einheit | 001 | Einheitennummer (Einheit) | - | CSV-Export: WhgNr (Spalte AW). |
| Einheit | Einheitennummer | 001 | Einheitennummer (Einheit) | - | CSV-Export: WhgNr (Spalte AW). |
| Einheit | Adresseingang | Erdgeschoss links | Wohnungslage (Einheit) | {{flat_info_entrance}} | CSV-Export: Spalte AY. |
| Einheit | Nutzfläche | 85,5 | quadratmeterflaeche (Einheit) | - | Fläche in m². CSV-Export: qm (Spalte AX). |
| Einheit | Einheitentyp | Wohnung | Wohnungstyp (Einheit) | {{flat_info_room_type}} | CSV-Export: Spalte AZ. |
| Einheit | Art der Mietzahlung | Lastschrift | – (nur CSV-Export, Spalte BC) | {{flat_info_rent_payment_type}} | Wird nur beim CSV-Export übertragen (Spalte BC); über die API derzeit nicht verfügbar. Der Wert "Keine Information" wird als leer behandelt. |
| Einheit | Vertrags-ID | 997-001-12345 | Funktion (Vertragsrolle) | {{flat_contract_id}} | CSV-Export: Spalte AR. |
| Einheit | Vertragsbeginn | 01.05.2020 | Von (Vertragsrolle) | {{flat_contract_start}} | CSV-Export: Spalte AT. |
| Einheit | Laufzeit | unbefristet | – (nur CSV-Export, Spalte AU) | {{flat_contract_duration}} | Wird nur beim CSV-Export übertragen (Spalte AU); über die API derzeit nicht verfügbar. |
| Einheit | Vertragsende | 30.04.2025 | Bis (Vertragsrolle) | {{flat_contract_end}} | CSV-Export: Spalte AV. |
| Mieter/Eigentümer | Externe Benutzer-ID | 10045 | Adressnummer (Adresse) | - | Eindeutige Adressnummer der Person in HausPerfekt. Beim CSV-Export wird stattdessen Vorname + Nachname (Spalten B + C) verwendet. |
| Mieter/Eigentümer | Vorname | Max | Vorname (Adresse) | {{recipient_first_name}} | CSV-Export: Spalte B. |
| Mieter/Eigentümer | Nachname | Mustermann | Name1 (Adresse) | {{recipient_second_name}} | CSV-Export: Spalte C. |
| Mieter/Eigentümer | max@email.de | Emails → Email (Adresse) | {{recipient_email}} | Alle hinterlegten E-Mail-Adressen werden übernommen. CSV-Export: Spalten E und F. | |
| Mieter/Eigentümer | Telefon | 0170 123456 | Telefonnummern → Nummer (Adresse) | {{recipient_phone}} | Alle hinterlegten Telefonnummern werden übernommen. CSV-Export: Spalten G bis J. |
| Mieter/Eigentümer | Rolle | Mieter | Funktionsart (Vertragsrolle) | {{recipient_role}} | CSV-Export: Spalte K. Zusätze werden entfernt (z. B. "Mieter SEV" → "Mieter"). "Leerstand" gilt als leerer Wert; Personen ohne Rolle werden als Bewohner angelegt. |
| Mieter/Eigentümer | Anrede | Herr | Anrede (Adresse) | {{recipient_info_salutation}} | Wird unverändert übernommen. CSV-Export: Spalte L. |
| Mieter/Eigentümer | Titel | Dr. | Titel (Adresse) | {{recipient_info_title}} | CSV-Export: Spalte M. |
| Mieter/Eigentümer | Vollständiger Name | Max Mustermann | Suchbegriff (Adresse) | {{recipient_info_full_name}} | CSV-Export: Spalte O. |
| Mieter/Eigentümer | Zweitname | Johann | – (nur CSV-Export, Spalte N) | {{recipient_info_middle_name}} | Wird nur beim CSV-Export übertragen (Spalte N); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Postanschrift: Vollständige Adresse | Hauptstraße 1, 10115 Berlin | – (nur CSV-Export, Spalte U) | {{recipient_info_address}} | Wird nur beim CSV-Export übertragen (Spalte U); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Postanschrift: Straße | Hauptstraße 1 | – (nur CSV-Export, Spalte V) | {{recipient_info_street}} | Wird nur beim CSV-Export übertragen (Spalte V); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Postanschrift: PLZ | 10115 | – (nur CSV-Export, Spalte X) | {{recipient_info_info_postcode}} | Wird nur beim CSV-Export übertragen (Spalte X); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Postanschrift: Ort | Berlin | – (nur CSV-Export, Spalte Y) | {{recipient_info_city}} | Wird nur beim CSV-Export übertragen (Spalte Y); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Postanschrift: Land | Deutschland | – (nur CSV-Export, Spalte Z) | {{recipient_info_country}} | Wird nur beim CSV-Export übertragen (Spalte Z); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | IBAN | DE12 3456 7890 1234 5678 90 | – (nur CSV-Export, Spalte AB) | {{recipient_info_iban}} | Wird nur beim CSV-Export übertragen (Spalte AB); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | BIC | MUSTDEXXX | – (nur CSV-Export, Spalte AC) | {{recipient_info_bic}} | Wird nur beim CSV-Export übertragen (Spalte AC); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Bankname | Musterbank | – (nur CSV-Export, Spalte AD) | {{recipient_info_bank_name}} | Wird nur beim CSV-Export übertragen (Spalte AD); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Zahlungsart | Lastschrift | – (nur CSV-Export, Spalte AE) | {{recipient_info_payment_type}} | Wird nur beim CSV-Export übertragen (Spalte AE); über die API derzeit nicht verfügbar. Der Wert "Keine Info" wird als leer behandelt. |
| Mieter/Eigentümer | Kaution | 1500.00 | – (nur CSV-Export, Spalte AG) | {{recipient_info_deposit}} | Wird nur beim CSV-Export übertragen (Spalte AG); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Partner: Anrede | Frau | – (nur CSV-Export, Spalte AI) | {{recipient_info_partner_salutation}} | Wird nur beim CSV-Export übertragen (Spalte AI); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Partner: Titel | Dr. | – (nur CSV-Export, Spalte AJ) | {{recipient_info_partner_title}} | Wird nur beim CSV-Export übertragen (Spalte AJ); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Partner: Vorname | Maria | – (nur CSV-Export, Spalte AK) | {{recipient_info_partner_first_name}} | Wird nur beim CSV-Export übertragen (Spalte AK); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Partner: Nachname | Mustermann | – (nur CSV-Export, Spalte AM) | {{recipient_info_partner_info_last_name}} | Wird nur beim CSV-Export übertragen (Spalte AM); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Partner: Vollst. Name | Maria Mustermann | – (nur CSV-Export, Spalte AN) | {{recipient_info_partner_full_name}} | Wird nur beim CSV-Export übertragen (Spalte AN); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Partner: E-Mail | maria@email.de | – (nur CSV-Export, Spalte AO) | {{recipient_info_partner_email}} | Wird nur beim CSV-Export übertragen (Spalte AO); über die API derzeit nicht verfügbar. |
| Mieter/Eigentümer | Partner: Telefon | 0170 654321 | – (nur CSV-Export, Spalte AP) | {{recipient_info_partner_phone}} | Wird nur beim CSV-Export übertragen (Spalte AP); über die API derzeit nicht verfügbar. |
Hier finden Sie mehr Informationen:
