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:
- Alle Zellen markieren (Strg + A)
- Rechtsklick → Zellen formatieren
- 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:
| Spaltenname | Beschreibung |
|---|---|
| advisor_email | E-Mail des zuständigen Beraters |
| applicant_email | E-Mail des Antragstellers |
| applicant_gender | male · female · other |
| applicant_first_name | Vorname |
| applicant_last_name | Nachname |
| applicant_phone_number | Telefonnummer |
| applicant_employment_status | Beschäftigungsstatus (siehe Schritt 7) |
| applicant_employment_country | Beschäftigungsland (englischer Ländername, z. B. Germany) |
| resident_status | Aufenthaltsstatus (siehe Schritt 7) |
| applicant_monthly_net_income | Monatliches Nettoeinkommen |
| property_city | Stadt der Immobilie |
| property_postal_code | PLZ der Immobilie |
| applying_alone | on_own oder with_others |
| finance_type | Finanzierungsart (siehe Schritt 6) |
| bank_savings_amount_towards_down_payment | Eigenkapital / Ersparnisse |
Schritt 6: Zusätzliche Pflichtfelder je Finanzierungsart
Je nach Wert in finance_type müssen weitere Felder befüllt sein:
| finance_type | Zusätzlich verpflichtend |
|---|---|
| new_from_developer | property_listed_price |
| buy_existing | property_listed_price |
| self_construction | construction_costs + own_land → bei true: land_value, bei false: land_purchase_price |
| modernization | renovation_costs + current_value |
| refinance | refinance_amount_needed + current_value |
| capital_raising | capital_amount_needed + current_value |
| personal_loan | personal_loan_amount |
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 (optional) 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.
| Spaltenname | Beschreibung |
|---|---|
| todo_category | Kategorie (z. B. call, appointment, email, custom) |
| todo_description | Freier Beschreibungstext |
| todo_date | Datum im Format DD.MM.YYYY |
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.
War dieser Artikel hilfreich?
Das ist großartig!
Vielen Dank für das Feedback
Leider konnten wir nicht helfen
Vielen Dank für das Feedback
Feedback gesendet
Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren