CSV-Datei für den Kontakt-Import vorbereiten

Wenn du Kontaktdaten in FinLink importieren möchtest, schickst du uns eine aufbereitete CSV-Datei – wir übernehmen dann den Import für dich. Diese Anleitung erklärt, wie du die Datei korrekt vorbereitest. Ein Template findest du am Ende des Artikels.

Schritt 1: Dateiformat wählen

• Verwende ausschließlich das CSV-Format (.csv).
• Wenn du mit Excel arbeitest: Speichere die fertige Datei über Datei → Speichern unter → CSV UTF-8 (durch Trennzeichen getrennt).
• Als Trennzeichen ist Komma (,) oder Semikolon (;) erlaubt.

Schritt 2: Zeichenkodierung auf UTF-8 setzen

• Die Datei muss in UTF-8 kodiert sein, sonst werden Umlaute (ä, ö, ü) und Sonderzeichen beim Import falsch dargestellt.
• In Excel wählst du beim Speichern explizit „CSV UTF-8" als Dateiformat.

Schritt 3: Alle Zellen als Text formatieren

Bevor du Daten eingibst oder die Datei speicherst, müssen alle Spalten als Text formatiert sein – nicht als Zahl, Währung oder Datum.

In Excel:

1. Alle Zellen markieren (Strg + A)
2. Rechtsklick → Zellen formatieren
3. Kategorie „Text" auswählen → OK

Warum ist das wichtig?

• Zahlen mit Tausendertrennzeichen werden sonst falsch importiert:
  • ❌ 100.000,99 → wird als 100 gelesen
  • ✅ 100000,99 → wird korrekt importiert
• Datumsfelder werden sonst automatisch konvertiert und landen im falschen Format.

Schritt 4: Datumsfelder korrekt befüllen

Alle Datumsfelder (applicant_dob, todo_date) müssen im Format DD.MM.YYYY eingetragen sein, z. B. 15.03.1985.

Stelle sicher, dass die Zellen als Text formatiert sind (siehe Schritt 3), bevor du die Daten eingibst.

Schritt 5: Pflichtfelder befüllen

Folgende Spalten müssen in jeder Zeile einen gültigen Wert enthalten:

Schritt 6: Zusätzliche Pflichtfelder je Finanzierungsart

Je nach Wert in finance_type müssen weitere Felder befüllt sein:

Schritt 7: Erlaubte Werte pro Feld

Folgende Felder akzeptieren nur exakt diese Werte (englisch, Kleinschreibung beachten):

• applicant_employment_status = [employed_unlimited, self_employed, managing_partner, freelancer, wealthy, retired, civil_servant, home_maker, other, parental_leave, worker, self_employed_craftsman]
• resident_status = [full_resident, european, limited_resident, spousal_visa, no_resident, unlimited_resident]
• finance_type = [new_from_developer, buy_existing, self_construction, modernization, refinance, capital_raising, personal_loan]
• property_type = [apartment, single_family, double_family, two_family, middle_terraced, land, apartment_building, residential_and_commercial_building]
• property_use (optional) = [primary_residence, rental, partial_rental]
• found_property (optional) = [ready_to_buy, still_looking]

Schritt 8: Todos hinzufügen (optional)

Wenn du zu einem Kontakt direkt ein Todo anlegen möchtest, befülle alle drei Todo-Felder. Fehlt eines davon, wird kein Todo erstellt.

Alle erlaubten todo_category-Werte: call · appointment · email · birthday_applicant · prolongation · refinancing · cancellation · document_center_document · documents_some_uploaded · documents_all_uploaded · application_submitted · application_submitted_with_client_notes · notary_appointment · update_information_request · client_requested_offer · client_applied_for_offer · get_in_touch_client · offer_rejected · custom · ehyp_offer_rejected

Schritt 9: Datei prüfen und absenden

Bevor du die Datei an den Support sendest, prüfe kurz:

• Dateiformat ist .csv
•  Zeichenkodierung ist UTF-8
•  Alle Zellen sind als Text formatiert
•  Alle Pflichtfelder sind befüllt
•  Finanzierungsart-spezifische Felder sind vollständig
• Datumsfelder folgen dem Format DD.MM.YYYY
•  Enum-Felder enthalten nur erlaubte Werte (Kleinschreibung)

Schicke die fertige Datei anschließend an support@finlink.de – wir melden uns, sobald der Import abgeschlossen ist.