Datenimport (CSV)

Mit dem Datenimport können Sie Stammdaten aus anderen Systemen (z.B. immocloud, Haufe, Excel-Listen) per CSV-Datei in Formdock übernehmen.

Zugang

Öffnen Sie Einstellungen > Import & Export (?tab=einstellungen&sub=datenimport) und wählen Sie den Tab Import.

Dort finden Sie zwei Import-Karten:

Kontakte

Import-Typ Beschreibung
Kontakte Alle Kontakttypen (Vermieter, Eigentümer, Mieter, Firmen, WEGs, Organisationen) mit Adresse, Bankverbindung und Steuernummer. Die Rolle wird über die Spalte roles in der CSV zugewiesen.

Immobilien

Import-Typ Beschreibung
Gebäude & Einheiten Gebäude und Wohneinheiten mit Adresse, Fläche, Zimmerzahl und Vermieter-Zuordnung (über E-Mail oder Name)

Empfohlene Reihenfolge

  1. Kontakte zuerst importieren (Eigentümer/Vermieter vor Mietern)
  2. Immobilien importieren (Vermieter-Zuordnung über E-Mail oder Name)

Wichtig: Eigentümer/Vermieter müssen vor Immobilien importiert werden, damit die Zuordnung beim Immobilien-Import funktioniert.

Ablauf (pro Import-Typ)

1. Beispiel-CSV herunterladen

Klicken Sie auf "Beispiel-CSV" bei der gewünschten Import-Karte. Die Datei enthaelt alle unterstützten Spalten mit Beispieldaten und kann direkt als Vorlage verwendet werden.

2. CSV-Datei vorbereiten

  • Öffnen Sie die Beispiel-CSV in Excel oder LibreOffice
  • Fuellen Sie Ihre Daten ein (Pflichtfelder beachten)
  • Speichern Sie als CSV (UTF-8, Semikolon)

3. Importieren

  • Klicken Sie auf "Importieren" bei der gewünschten Import-Karte
  • Wählen Sie Ihre CSV-Datei aus (max. 5 MB)
  • Klappen Sie optional "Unterstützte Felder anzeigen" auf, um alle verfügbaren Spalten mit Pflicht-Kennzeichnung zu sehen
  • Klicken Sie auf "Hochladen und prüfen"

4. Vorschau und Bestätigung

Formdock zeigt eine Vorschau der erkannten Datensätze:

  • Korrekt zugeordnete Felder
  • Validierungsfehler (z.B. fehlende Pflichtfelder, ungültige IBAN)
  • Mögliche Duplikate

Nach der Prüfung bestätigen Sie den Import.

CSV-Format

Eigenschaft Vorgabe
Trennzeichen Semikolon (;)
Zeichensatz UTF-8 (empfohlen)
Erste Zeile Spaltenüberschriften
Dateigroesse max. 5 MB
Dateityp .csv oder .txt

Pflichtfelder pro Import-Typ

Import-Typ Pflichtfeld(er)
Kontakte contact_type (private / company / community / organization)
Immobilien name, property_type (building / apartment / commercial / parking / garage / storage / other)

Rollen für Kontakte

Über die Spalte roles weisen Sie einem Kontakt eine oder mehrere Rollen zu (kommagetrennt):

Rolle Anzeigename
tenant Mieter
landlord Vermieter
owner Eigentümer
bautraeger Bautraeger
service_provider Dienstleister
craftsman Handwerker
property_management Immobilienverwaltung
broker Makler
bank Bank
caretaker Hausmeister
acquaintance Bekannter
applicant Mietinteressent

Alternative Zugänge

Neben dem zentralen Datenimport in den Einstellungen finden Sie auch direkte Import-Links auf den jeweiligen Listenseiten.