In der beigefügten Tabelle können Sie genau nachvollziehen, welche Datenfelder aus IGEL 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 & IGEL (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 IGEL, 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 (IGEL-Schnittstelle), automatische Synchronisation nachts
-
Richtung: Die Stammdaten werden aus IGEL nach iDWELL übertragen. IGEL ist das führende System – Änderungen an Stammdaten nehmen Sie bitte immer in IGEL vor, da manuelle Änderungen in iDWELL bei der nächsten Synchronisation überschrieben werden können.
-
Rückübertragung nach IGEL: in iDWELL erstellte Servicemeldungen werden an IGEL übertragen, inkl. öffentlicher Kommentare, angehängter Dateien und Bewertungen; optional auch Statusänderungen (Offen, Terminiert, Erledigt, Abgelehnt). Voraussetzung ist eine Zuordnung der iDWELL-Kategorien zu den IGEL-Meldungsarten.
-
Dokumente: Übernommen werden Gebäudedokumente (dem Objekt zugeordnet) und Mieter-/Eigentümerdokumente (dem Bestandnehmervertrag zugeordnet, Ablage im Profil der Person), außerdem Dokumente zu Servicemeldungen und deren Kommentaren sowie das Gebäudebild. Office-Dateien (doc, docx, docm, xls, xlsx, xlsm, pptx, pptm) werden standardmäßig nicht übernommen. Je nach Konfiguration können nur bestimmte IGEL-Dokumentarten importiert bzw. für Mieter/Eigentümer sichtbar geschaltet werden. Geänderte Dokumente (neues Erfassungsdatum oder Dateiname) werden erneut geladen.
Wichtige Regeln beim Import
-
Die Synchronisation läuft automatisch jede Nacht; zusätzlich kann sie manuell gestartet werden.
-
Für Gebäude, die in iDWELL archiviert oder gelöscht wurden, werden keine Daten mehr übernommen (außer eine Wiederherstellung ist aktiviert).
-
Einzelne IGEL-Objekte können vom Import ausgeschlossen werden.
-
Es wird die als Hauptadresse gekennzeichnete Objektadresse verwendet, ansonsten die erste Adresse. Straße und Ort sind Pflicht.
-
Existiert eine Adresse bereits bei einem anderen Gebäude, wird die Objektnummer vorangestellt.
-
Eine Einheitennummer muss zusammen mit dem Eingang innerhalb eines Gebäudes eindeutig sein.
-
Pro Einheit wird der erste Bestandnehmervertrag verknüpft; weitere Mitbewohner werden über die Vertragspartner des Vertrags übernommen.
-
Verträge mit Vertragsende in der Vergangenheit werden nicht mehr verknüpft.
-
Personen werden nur importiert, wenn sie einem Bestandnehmervertrag oder Objekt zugeordnet sind. Personen ohne aktive Einheit und ohne Eigentum werden archiviert.
-
Die erste E-Mail-Adresse bzw. Telefonnummer wird als Login verwendet, weitere werden als zusätzliche Kontakte gespeichert. Ist eine E-Mail-Adresse bereits bei einer anderen Person vergeben, wird sie je nach Schnittstellenversion als Kontakt gespeichert.
-
Namen und Login-Daten, die in iDWELL manuell geändert wurden, werden nicht überschrieben.
-
Zuständige Verwalter werden nur bestehenden Verwalter-Nutzern in iDWELL zugeordnet (Abgleich über E-Mail), aber nie neu angelegt (optional).
-
Dienstleister (Professionisten) werden optional importiert.
-
Servicemeldungen aus IGEL werden optional importiert, wahlweise begrenzt auf die letzten 1, 3 oder 6 Monate. Status-Zuordnung: O → Offen, B → Terminiert, E → Erledigt, A → Abgelehnt.
-
Je nach Konfiguration werden bereits vorhandene Gebäude, Adressen, Einheiten und Profile bei der Synchronisation aktualisiert oder unverändert gelassen.
Übersicht der übertragenen Datenfelder
| Ebene | Feldname in iDWELL | Praxisbeispiel | Feldname in IGEL | Variable in iDWELL | Zusatzinformationen |
| Gebäude | Externe ID | 997 | obj_id | - | Eindeutige IGEL-Objektkennung. |
| Gebäude | Objektnummer | 997 | objekt | {{building_info_object_number}} | |
| Gebäude | Straße | Musterstraße | strasse (Hauptadresse) | {{building_info_street}} | Verwendet wird die Hauptadresse (kz_hauptadresse = J), sonst die erste Adresse. |
| Gebäude | Hausnummer | 1 | ordnr (Hauptadresse) | {{building_info_door_number}} | |
| Gebäude | Postleitzahl | 01234 | plz (Hauptadresse) | {{building_info_postal_code}} | |
| Gebäude | Ort | Berlin | ort (Hauptadresse) | {{building_info_location}} | |
| Gebäude | Vollständige Adresse | Musterstraße 1, 01234 Berlin | strasse + ordnr, plz + ort | {{building_info_full_address}} | Je nach Schnittstellenversion werden Objektnummer und Objektart vorangestellt (z. B. 997_E_Musterstraße 1, 01234 Berlin). |
| Gebäude | Anrede | An die WEG | art | {{building_info_salutation}} | MP → „An die Mietenpoolteilnehmer“, E → „An die WEG“, M → „An die HI“. |
| Gebäude | Objekttyp | Wohnungseigentum | art_name | {{building_info_living_type}} | Neue Werte werden in iDWELL automatisch als Auswahlwert angelegt. |
| Gebäude | Baujahr | 1965 | baujahr | {{building_construction_year}} | |
| Gebäude | Vertragsbeginn (Verwaltung) | 01.01.2020 | von | {{building_info_contract_start}} | Uhrzeit wird entfernt. |
| Gebäude | Vertragsende (Verwaltung) | 31.12.2030 | bis | {{building_info_contract_end}} | |
| Gebäude | Rechnungsanschrift | Max Mustermann | eigentuemer → vorname + nachname | {{building_address_invoice}} | Name des ersten Objekteigentümers. |
| Gebäude | Hausmeister | Herr Max Müller | zustaendigkeiten (Typ „Hausbesorger“) → anrede + vorname + nachname | {{building_info_housekeeper}} | Ist kein Hausbesorger hinterlegt, wird „Kein Hausbesorger“ eingetragen. |
| Gebäude | IBAN | DE12 3456 ... | bk_iban | {{building_info_bank_iban}} | |
| Gebäude | BIC | DEUT... | bk_bic | {{building_info_bank_bic}} | |
| Gebäude | Bankname | Sparkasse | bk_bez | {{building_info_bank_name}} | |
| Gebäude | Kontoinhaber | WEG Musterstraße 1 | bk_kto_bez | {{building_info_bank_account_owner}} | |
| Gebäude | Gebäudebild | Foto Hausansicht | img_id | - | Wird als Bild des Gebäudes gesetzt. |
| Gebäude | Zuständige Verwalter | Max Verwalter | zustaendigkeiten → per_id | - | Optional. Zuordnung nur zu bestehenden Verwalter-Nutzern (Abgleich über E-Mail); Verwalter werden nicht neu angelegt. |
| Gebäude | Gebäudegruppen | Gruppe Nord | Attribute KUNDEN / GRUPPE der Objekteigentümer | - | Gruppen werden bei Bedarf angelegt; manuell in iDWELL angelegte Gruppen bleiben erhalten. |
| Einheit | Externe ID | 997.001 | top_id | - | Eindeutige IGEL-Kennung der Einheit. |
| Einheit | Tür / Bezeichnung | Top 1 | name | - | Pflichtfeld; muss zusammen mit dem Eingang im Gebäude eindeutig sein. |
| Einheit | Einheitennummer | 10476588 | top_id (letzte 8 Ziffern) | {{flat_info_unit_number}} | |
| Einheit | Nutzfläche | 85,5 | nfl | - | Fläche in m². |
| Einheit | Eingang | Stiege 1 | eingang | - | |
| Einheit | Etage | 3 | eta | - | |
| Einheit | Adresseingang | Musterstraße 1 | strasse + ordnr der Objektadresse mit gleichem Eingang | {{flat_info_entrance}} | |
| Einheit | Einheitentyp | Wohnung | art_name | {{flat_info_room_type}} | |
| Einheit | Ausstattungskategorie | Kategorie A | ist_kat_name | {{flat_info_category}} | |
| Einheit | Art der Mietzahlung | Lastschrift | bestandnehmer → zahlart_name | {{flat_info_rent_payment_type}} | |
| Einheit | Eigentumsanteil | 120/1000 | ant / ant_n | {{flat_info_property_share}} | Anteil und Gesamtanteile. |
| Einheit | Notiz | Balkon saniert 2022 | text | {{flat_info_notes}} | |
| Einheit | Vertrags-ID | 12345 | bestandnehmer → kto_nr | {{flat_contract_id}} | |
| Einheit | Zweite Vertrags-ID | 10012345 | bestandnehmer → tovp_id (letzter Teil) | {{flat_purchase_contract_number}} | |
| Einheit | Vertragsbeginn | 01.05.2020 | bestandnehmer → von | {{flat_contract_start}} | |
| Einheit | Vertragsende | 30.04.2025 | bestandnehmer → bis | {{flat_contract_end}} | Liegt das Ende in der Vergangenheit, wird der Vertrag nicht mehr verknüpft. |
| Mieter/Eigentümer | Externe Benutzer-ID | 12345 | per_id | - | |
| Mieter/Eigentümer | Vorname | Max | vorname | {{recipient_first_name}} | |
| Mieter/Eigentümer | Nachname | Mustermann | nachname | {{recipient_second_name}} | |
| Mieter/Eigentümer | max@email.de | {{recipient_email}} | Mehrere Adressen werden getrennt (Komma, Semikolon); die erste dient als Login, weitere werden als Kontakte gespeichert. | ||
| Mieter/Eigentümer | Telefon | +49170123456 | telefon | {{recipient_phone}} | Erste Nummer wird mit Ländervorwahl übernommen; weitere werden als Kontakte gespeichert. |
| Mieter/Eigentümer | Rolle | Mieter | bestandnehmer → typ | {{recipient_role}} | M → Mieter; WE / HE → Eigentümer. |
| Mieter/Eigentümer | Anrede | Herr | anrede | {{recipient_info_salutation}} | |
| Mieter/Eigentümer | Titel | Dr. | titel | {{recipient_info_title}} | |
| Mieter/Eigentümer | Zweitname | Peter | nachname_2 | {{recipient_info_middle_name}} | |
| Mieter/Eigentümer | Namenszusatz | MSc | titel_nach | {{recipient_info_name_info}} | |
| Mieter/Eigentümer | Vollständiger Name | Herr Max Mustermann | anrede + vorname + nachname | {{recipient_info_full_name}} | |
| Mieter/Eigentümer | Status | Hauptmieter | bestandnehmer → status_name | {{recipient_info_status}} | |
| Mieter/Eigentümer | Postanschrift: Straße | Hauptstraße | strasse | {{recipient_info_street}} | |
| Mieter/Eigentümer | Postanschrift: Türnummer | 1 | ordnr | {{recipient_info_address_2}} | |
| Mieter/Eigentümer | Postanschrift: PLZ | 10115 | plz | {{recipient_info_info_postcode}} | |
| Mieter/Eigentümer | Postanschrift: Ort | Berlin | ort | {{recipient_info_city}} | |
| Mieter/Eigentümer | Postanschrift: Land | Deutschland | land | {{recipient_info_country}} | |
| Mieter/Eigentümer | Vollst. Postanschrift | Hauptstraße 1, 10115 Berlin | strasse + ordnr, plz + ort | {{recipient_info_address}} | |
| Mieter/Eigentümer | IBAN | DE12 3456 ... | bestandnehmer → bk_iban | {{recipient_info_iban}} | |
| Mieter/Eigentümer | BIC | DEUT... | bestandnehmer → bk_bic | {{recipient_info_bic}} | |
| Mieter/Eigentümer | Bankname | Sparkasse | bestandnehmer → bk_bez | {{recipient_info_bank_name}} | |
| Mieter/Eigentümer | Zahlungsart | Lastschrift | bestandnehmer → zahlart_name | {{recipient_info_payment_type}} | |
| Mieter/Eigentümer | Saldo | 425,00 | bestandnehmer → kto_saldo | {{recipient_info_open_amount}} | |
| Mieter/Eigentümer | Kaution | 1.500,00 | bestandnehmer → kaut_sum | {{recipient_info_deposit}} | |
| Mieter/Eigentümer | Partner: Anrede | Frau | Vertragspartner → anrede | {{recipient_info_partner_salutation}} | Daten des zweiten Vertragspartners aus dem Bestandnehmervertrag. |
| Mieter/Eigentümer | Partner: Titel | Mag. | Vertragspartner → titel | {{recipient_info_partner_title}} | |
| Mieter/Eigentümer | Partner: Vorname | Maria | Vertragspartner → vorname | {{recipient_info_partner_first_name}} | |
| Mieter/Eigentümer | Partner: Zweitname | Anna | Vertragspartner → nachname_2 | {{recipient_info_partner_info_middle_name}} | |
| Mieter/Eigentümer | Partner: Nachname | Mustermann | Vertragspartner → nachname | {{recipient_info_partner_info_last_name}} | |
| Mieter/Eigentümer | Partner: E-Mail | maria@email.de | Vertragspartner → email | {{recipient_info_partner_email}} | |
| Mieter/Eigentümer | Partner: Telefon | 030123456 | Vertragspartner → telefon | {{recipient_info_partner_phone}} | |
| Hauseigentümer | Hauseigentümer | Immobilien AG | eigentuemer → per_id | - | Bereits importierte Eigentümer werden dem Gebäude als Hauseigentümer zugeordnet; dafür wird eine eigene Eigentümer-Einheit angelegt. |
| Dienstleister | Name | Muster Haustechnik GmbH | professionisten → vorname + nachname | - | Optionaler Import der Professionisten als Dienstleister. |
| Dienstleister | Adresse | Werkstraße 5, 01234 Berlin | strasse + ordnr, plz + ort | - | |
| Dienstleister | info@muster-haustechnik.de | ansprechpartner → email | - | Erste E-Mail des ersten Ansprechpartners. Ein bestehender Dienstleister mit gleicher E-Mail wird aktualisiert statt neu angelegt. | |
| Dienstleister | Telefon | 030987654 | ansprechpartner → telefon | - | |
| Dienstleister | Beschreibung | 997 Heizungswartung | objekt + professionisten → text | - | Wird über alle Gebäude gesammelt. |
| Dienstleister | Gebäude | Musterstraße 1 | Objekte, in denen der Dienstleister hinterlegt ist | - | Der Dienstleister wird allen betreffenden Gebäuden zugeordnet. |
| Dokumente | Gebäudedokument | Hausordnung.pdf | dokumente (Zuordnung Objekt) | - | Ablage im Gebäudeordner. |
| Dokumente | Mieter-/Eigentümerdokument | Vorschreibung_2025.pdf | dokumente (Zuordnung Bestandnehmervertrag) | - | Ablage im Profil der Person; nicht für veraltete Verträge oder archivierte Profile. |
| Dokumente | Dokument zur Servicemeldung | Foto_Schaden.jpg | Workflow-Schritte → dokument_meta | - | Wird der Servicemeldung bzw. dem Kommentar angehängt. |
| Dokumente | Dateiname | Hausordnung.pdf | name / filename (Dokument-Metadaten) | - | Office-Dateien werden standardmäßig nicht übernommen. |
Hier finden Sie mehr Informationen:
- Regeln für eine korrekte Stammdatenübertragung aus IGEL
- Wie oft und wann werden die Stammdaten aus IGEL synchronisiert?
- Wie wird ein Aushang aus IGEL am schwarzen Brett gesteuert?
- Wie werden Dokumente aus IGEL in die App überspielt?
- Können Kunden aus IGEL zur App eingeladen werden?
- Wie werden Servicemeldungen aus der App im IGEL WF-Manager bearbeitet?
- Integrationsprotokoll - Erklärung
- Integrationsprotokoll - Fehlermeldungsanalyse