Welche Daten werden aus IGEL nach iDWELL übertragen?

Übersicht Datenfelder für den Export nach iDWELL
Geschrieben von iDWELL Kundensupport
Aktualisiert vor 4 Tagen

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 E-Mail max@email.de email {{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 E-Mail 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:

 

Für iDWELL Hilfe kontaktieren Sie uns bitte unter support@idwell.com, schauen Sie auf unserem YouTube Kanal vorbei oder besuchen Sie unsere Masterclasses 😊💡👍
Hat das Ihre Frage beantwortet?