snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/de/user-guide/data-migration/capabilities/error-handling.mdx

@@ -0,0 +1,76 @@
+---
+title: Fehlerbehandlung und Validierung
+description: Überprüfen und beheben Sie Importfehler direkt in der Benutzeroberfläche, bevor Sie den Import bestätigen.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Vorabvalidierung
+
+Nachdem Sie Ihre Datei hochgeladen und die Felder zugeordnet haben, validiert Twenty Ihre Daten, **bevor** sie importiert werden. So können Sie Fehler erkennen und beheben, ohne Ihre vorhandenen Daten zu beeinträchtigen.
+
+## Wie es funktioniert
+
+1. **Hochladen** Ihrer CSV-Datei
+2. **Zuordnen** Ihrer Spalten zu Twenty-Feldern
+3. **Überprüfen** der gelb hervorgehobenen potenziellen Fehler
+4. **Fehlerbehebung** direkt in der Benutzeroberfläche
+5. **Bestätigen** des Imports
+
+<VimeoEmbed videoId="1145273857" title="Video-Demonstration" />
+
+## Fehleranzeige
+
+Zeilen mit Fehlern sind **gelb** hervorgehoben. Sie können:
+
+* **Die Zelle direkt bearbeiten**, um den Fehler zu beheben
+* **Die Zeile entfernen**, um sie vollständig zu überspringen
+
+Diese Inline-Bearbeitung spart Zeit – Sie müssen nicht zu Ihrer Tabellenkalkulation zurückkehren, Fehler beheben und erneut hochladen.
+
+## Häufige Fehlertypen
+
+### Doppelte Werte
+
+**Ursache**: Ein eindeutiges Feld (E-Mail, Domain) existiert bereits in Twenty oder kommt in Ihrer Datei doppelt vor.
+
+**Lösung**:
+
+* Bearbeiten Sie den doppelten Wert in der Import-Benutzeroberfläche
+* Entfernen Sie eine der doppelten Zeilen
+
+Weitere Details dazu, wie die Eindeutigkeit erzwungen wird, finden Sie unter [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints).
+
+### Ungültiges Format
+
+**Ursache**: Daten entsprechen nicht dem erwarteten Format (z. B. ungültige E-Mail, falsches Datumsformat).
+
+**Lösung**: Bearbeiten Sie die Zelle, um das korrekte Format zu verwenden.
+
+Siehe [Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping) für das erwartete Format jedes Feldtyps.
+
+### Erforderliche Felder fehlen
+
+**Ursache**: Ein erforderliches Feld ist leer.
+
+**Lösung**: Geben Sie im erforderlichen Feld einen Wert ein oder entfernen Sie die Zeile.
+
+### Beziehung nicht gefunden
+
+**Ursache**: Der referenzierte Datensatz existiert nicht (z. B. eine Unternehmensdomain, die nicht importiert wurde).
+
+**Lösung**:
+
+* Importieren Sie zuerst die übergeordneten Datensätze
+* Oder korrigieren Sie den Referenzwert
+
+Siehe [Beziehungen importieren](/l/de/user-guide/data-migration/capabilities/import-relations) für die korrekte Importreihenfolge und wie Datensätze verknüpft werden.
+
+## Tipps für weniger Fehler
+
+1. **Laden Sie die Vorlage herunter** um das erwartete Format zu sehen, bevor Sie Ihre Datei importieren
+2. **Bereinigen Sie Ihre Daten** zunächst in der Tabellenkalkulation
+3. **Importieren Sie Dateien in der richtigen Reihenfolge**, um Beziehungen zu importieren (Unternehmen → Personen → Verkaufschancen)
+4. **Testen Sie mit kleinen Stapeln** vor dem vollständigen Import
+5. **Auf Duplikate prüfen** vor dem Hochladen
+6. **Jede Datei auf 10.000 Datensätze begrenzen**

packages/twenty-docs/l/de/user-guide/data-migration/capabilities/field-mapping.mdx

@@ -0,0 +1,198 @@
+---
+title: Feldzuordnung
+description: Wie die Feldzuordnung beim Datenimport funktioniert.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Wie die Feldzuordnung funktioniert
+
+Wenn Sie eine Datei hochladen, analysiert Twenty Ihre Spalten und versucht, sie bestehenden Feldern zuzuordnen.
+
+### Automatische Zuordnung
+
+Twenty versucht, Spalten anhand der folgenden Kriterien abzugleichen:
+
+* Spaltenüberschriften (genaue oder ähnliche Übereinstimmungen)
+* Erkennung des Datentyps (Datum, Zahlen, E-Mails)
+* Häufige Feldmuster
+
+<Note>**Schneller Tipp:** Exportieren Sie ein paar Zeilen aus dem Objekt, das Sie importieren möchten. Die exportierte Datei enthält genau die Spaltennamen, die Twenty erwartet, sodass die automatische Zuordnung beim Import reibungslos funktioniert.</Note>
+
+### Optionen für die manuelle Zuordnung
+
+Für jede Spalte können Sie:
+
+* **Einem Feld zuordnen**: Wählen Sie das passende Twenty-Feld aus einem Dropdown aus
+* **Nicht zuordnen**: Überspringen Sie die Spalte vollständig (Daten werden nicht importiert)
+
+<Note>**Felder müssen vor dem Import existieren.** Der Import erzeugt Datensätze, nicht Felder. Erstellen Sie benutzerdefinierte Felder vor dem Import unter **Einstellungen → Datenmodell**.</Note>
+
+## Kompatibilität der Feldtypen
+
+Alle im Datenmodell verfügbaren Feldtypen werden für den Import unterstützt.
+
+Sie können auch `id`-Werte importieren, um neuen Datensätzen eine bestimmte ID zuzuweisen oder vorhandene zu aktualisieren.
+
+<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />
+
+## Anforderungen an das Datenformat
+
+<Note>**Einige Felder haben eine spezielle Syntax.** Wir empfehlen, vor der Vorbereitung Ihres Imports die Beispieldatei herunterzuladen, um die erwartete Syntax für jeden Feldtyp zu sehen.</Note>
+
+### Adressfelder
+
+Adresse ist ein verschachteltes Feld mit mehreren Spalten. Einige können leer bleiben.
+
+* **Adresse / Adresszeile 1**: Adresszeile 1
+* **Adresse / Adresszeile 2**: Adresszeile 2
+* **Adresse / Stadt**: Stadtname
+* **Adresse / Bundesland**: Bundesland oder Provinz
+* **Adresse / Land**: Ländername
+* **Adresse / Postleitzahl**: Postleitzahl/ZIP-Code
+
+### Array-Felder
+
+Verwenden Sie folgendes Format:
+
+```
+["value1","value2"]
+```
+
+### Boolesche Felder
+
+Verwenden Sie `TRUE` oder `FALSE` (Großbuchstaben) – nicht `true` oder `false`
+
+### Währungsfelder
+
+Währung ist ein verschachteltes Feld mit zwei Spalten, die **beide ausgefüllt werden müssen**:
+
+* **Betrag / Betrag**: Der Zahlenwert (z. B. `1234.56`)
+* **Betrag / Währung**: Der Währungscode (z. B. `USD`, `EUR`)
+
+### Datumsfelder
+
+Unterstützte Formate:
+
+* `YYYY-MM-DD` (empfohlen)
+* `MM/DD/YYYY`
+* `DD/MM/YYYY`
+* ISO-8601-Format
+
+### Domain-Felder
+
+* Es wird empfohlen, das Format `https://domain.com` zu verwenden, um Duplikate zu vermeiden, da dies das Format für Unternehmen ist, die durch die Postfach- und Kalender-Synchronisierungen erstellt werden.
+* Es können ein `Domain Label` und eine `Domain URL` ausgefüllt werden: Best Practice ist, im Label `domain.com` und in der URL `https://domain.com` anzugeben
+* Domains müssen im Objekt Unternehmen eindeutig sein
+* **Domains müssen innerhalb der zu importierenden Datei eindeutig sein**
+
+### E-Mail-Felder
+
+* Müssen ein gültiges E-Mail-Format haben
+* E-Mails müssen im Objekt Personen eindeutig sein
+* **E-Mails müssen innerhalb der zu importierenden Datei eindeutig sein**
+* Für zusätzliche E-Mails: Verwenden Sie **E-Mails / Primäre E-Mail** für die Haupt-E-Mail und **E-Mails / Zusätzliche E-Mails** mit diesem Format:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### ID-Felder
+
+Die Angabe einer `id` während des Imports ist optional. Twenty erzeugt automatisch eine, wenn keine angegeben wird.
+
+Anwendungsfälle für die Zuordnung einer `id`-Spalte:
+
+* **Spezifische ID festlegen**: Wählen Sie die UUID für neu erstellte Datensätze
+* **Vorhandene Datensätze aktualisieren**: Gegen vorhandene Datensätze abgleichen, um sie zu aktualisieren, anstatt Duplikate zu erstellen. In diesem Fall wird empfohlen, die anderen eindeutigen Felder nicht zuzuordnen: Die Zuordnung nur eines eindeutigen Feldes sorgt für einen reibungsloseren Import.
+
+<Note>Wenn Sie eine `id` angeben, muss sie im UUID-Format sein (z. B. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+### JSON-Felder
+
+Verwenden Sie gültiges JSON-Format:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### Link-Felder
+
+Ähnlich wie Domain-Felder:
+
+* Füllen Sie sowohl die Spalten für Label und URL aus: **Links / Link-URL** und **Links / Link-Label**
+* Verwenden Sie das vollständige URL-Format: `https://example.com`
+* Für sekundäre Links verwenden Sie die Spalte **Links / Sekundäre Links** mit diesem Format:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### Mehrfachauswahl-Felder
+
+Verwenden Sie die **API-Namen** (nicht die Anzeigenamen) in folgendem Format:
+
+```
+["VALUE1","VALUE2"]
+```
+
+Siehe [hier](#finding-api-names-for-select-fields), wo Sie die API-Namen finden.
+
+<Note>Neue Auswahloptionen werden durch den Import nicht automatisch erstellt. Sie müssen vor dem Import unter **Einstellungen → Datenmodell** hinzugefügt werden.</Note>
+
+<Warning>
+**Importiere Überschreibungen, es fügt nicht hinzu.**
+
+Wenn ein Datensatz bereits `VALUE2` und `VALUE3` ausgewählt hat und Sie `["VALUE1"]` importieren, hat der Datensatz nach dem Import nur noch `VALUE1`. Die bisherigen Auswahlen werden ersetzt, nicht zusammengeführt.
+</Warning>
+
+### Zahlenfelder
+
+* Nur Zahlen
+* Dezimalzahlen verwenden einen Punkt: `1234.56`
+* Keine Tausendertrennzeichen
+
+### Telefonfelder
+
+Telefon ist ein verschachteltes Feld mit mehreren Spalten, die **ausgefüllt werden müssen**
+
+* **Telefone / Primäre Telefonnummer**: Die Telefonnummer (z. B. `4159095555`)
+* **Telefone / Ländercode der primären Telefonnummer**: Ländercode (z. B. `US`)
+* **Telefone / Vorwahl der primären Telefonnummer**: Vorwahl (z. B. `+1`)
+
+### Bewertungsfelder
+
+Verwenden Sie das API-Namensformat: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4`, `RATING_5`
+
+### Relationsfelder
+
+Weitere Informationen finden Sie in unserem dedizierten Artikel: [Beziehungen zwischen Objekten importieren](/l/de/user-guide/data-migration/capabilities/import-relations)
+
+### Auswahlfelder
+
+Verwenden Sie den **API-Namen** der Option (nicht den Anzeigenamen):
+
+```
+VALUE1
+```
+
+Siehe [hier](#finding-api-names-for-select-fields), wo Sie die API-Namen finden.
+<Note>Neue Auswahloptionen werden durch den Import nicht automatisch erstellt. Sie müssen vor dem Import unter **Einstellungen → Datenmodell** hinzugefügt werden.</Note>
+
+### Textfelder
+
+* Keine besondere Formatierung erforderlich
+* Führende/abschließende Leerzeichen werden entfernt
+
+## API-Namen finden
+
+Für Select-, Multi-Select- und Array-Felder mit vordefinierten Optionen müssen Sie die **API-Namen** verwenden, nicht die Anzeigenamen.
+
+### So finden Sie API-Namen
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie das Objekt und das Feld aus
+3. Aktivieren Sie den **Erweiterten Modus** (Schalter unten rechts auf der Einstellungsseite)
+4. Zeigen Sie den API-Namen für jede Option an
+
+<VimeoEmbed videoId="1144910809" title="Video-Demonstration" />

packages/twenty-docs/l/de/user-guide/data-migration/capabilities/file-formats.mdx

@@ -0,0 +1,48 @@
+---
+title: Unterstützte Dateiformate
+description: Unterstützte Dateiformate für den Datenimport in Twenty.
+---
+
+## Unterstützte Formate
+
+Twenty unterstützt drei Dateiformate für den Import:
+
+| Format             | Erweiterung | Notizen                      |
+| ------------------ | ----------- | ---------------------------- |
+| **CSV**            | .csv        | Empfohlen, am kompatibelsten |
+| **Excel**          | .xlsx       | Modernes Excel-Format        |
+| **Excel (Legacy)** | .xls        | Älteres Excel-Format         |
+
+## Datei-Anforderungen
+
+| Anforderung          | Wert                                                |
+| -------------------- | --------------------------------------------------- |
+| **Zeichenkodierung** | UTF-8 empfohlen                                     |
+| **Datensatzlimit**   | 10.000 Datensätze pro Datei                         |
+| **Struktur**         | Die erste Zeile muss Spaltenüberschriften enthalten |
+| **Inhalt**           | Ein Objekttyp pro Datei                             |
+
+## CSV: Beste Praktiken
+
+* **Trennzeichen**: Verwenden Sie Komma (`,`) oder Semikolon (`;`)
+* **Textbegrenzer**: Verwenden Sie doppelte Anführungszeichen (`"`) für Text, der Kommas enthält
+* **Zeilenenden**: Sowohl Windows (CRLF) als auch Unix (LF) werden unterstützt
+* **Leere Werte**: Zellen leer lassen, nicht "NULL" oder "N/A" verwenden
+
+## Excel: Beste Praktiken
+
+Beim Export aus Excel:
+
+* Formeln entfernen (nur Werte exportieren)
+* Leere Zeilen am Ende löschen
+* Sicherstellen, dass keine zusammengeführten Zellen vorhanden sind
+* Nur das erste Tabellenblatt verwenden
+
+## Große Datensätze
+
+Für Datenmengen mit mehr als 10.000 Datensätzen:
+
+* In mehrere Dateien aufteilen
+* Oder den [API-Import](/l/de/user-guide/data-migration/how-tos/import-data-via-api) für unbegrenzte Datensätze verwenden
+
+<Note>Für sehr große Migrationen (über 100.000 Datensätze) ist die API deutlich schneller und zuverlässiger als CSV-Importe.</Note>

packages/twenty-docs/l/de/user-guide/data-migration/capabilities/import-relations.mdx

@@ -0,0 +1,148 @@
+---
+title: Beziehungen zwischen Objekten importieren
+description: Beziehungen zwischen Datensätzen per CSV importieren.
+---
+
+## Übersicht
+
+Twenty unterstützt das Importieren von Beziehungen zwischen Objekten beim CSV-Import. So können Sie im Rahmen Ihrer Datenmigration Datensätze verknüpfen (z. B. Personen mit Unternehmen verknüpfen).
+
+<Note>**Aktuell für den Import unterstützt**: Eins-zu-viele-Beziehungen, die auf jeder Seite auf einen einzelnen Objekttyp verweisen (z. B. Personen → Unternehmen). Beziehungen, die auf mehrere Objekttypen zeigen, werden für Import/Export noch nicht unterstützt.</Note>
+
+## Wie Beziehungen in Twenty funktionieren
+
+### Eins zu Viele / Viele zu Eins
+
+Twenty unterstützt Standardbeziehungen, bei denen ein Datensatz mit vielen anderen verknüpft wird:
+
+* **Ein Unternehmen → Viele Personen**: Ein Unternehmen kann mehrere Mitarbeitende haben, aber jede Person gehört zu einem Unternehmen
+* **Ein Unternehmen → Viele Opportunities**: Ein Unternehmen kann mehrere Deals haben, aber jede Opportunity gehört zu einem Unternehmen
+
+### Beziehungen, die auf mehrere Objekttypen zeigen können
+
+Einige Beziehungen können verschiedene Objekttypen verbinden. Dies funktioniert auf zwei Arten:
+
+**Muster 1: Viele Datensätze, die jeweils mit einem Datensatz aus unterschiedlichen Objekttypen verknüpft sind**
+
+Mehrere Notizen oder Aufgaben können auf einmal an mehrere Objekttypen angehängt werden:
+
+* **Notizen** können gleichzeitig mit einer Person, einem Unternehmen und einer Opportunity verknüpft werden
+* **Aufgaben** können gleichzeitig mit einer Person, einem Unternehmen und einer Opportunity verknüpft werden
+
+Hier befinden sich die Notizen/Aufgaben auf der "Viele"-Seite. Jede ist mit genau einem Datensatz pro Objekttyp verknüpft.
+
+<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
+
+**Muster 2: Ein Datensatz, der Verknüpfungen von vielen Datensätzen unterschiedlicher Objekttypen erhält**
+
+Ein Projekt kann Verknüpfungen von mehreren Datensätzen über verschiedene Objekttypen hinweg erhalten:
+
+* **Ein Projekt** kann viele Personen mit ihm verknüpft haben, viele Unternehmen mit ihm verknüpft haben und viele Notizen, die daran angehängt sind
+
+Hier befindet sich das Projekt auf der "Eins"-Seite. Mehrere Datensätze aus verschiedenen Objekten können alle mit demselben Projekt verknüpft sein.
+
+<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
+
+<Warning>
+**Einschränkung beim Import/Export**: Beziehungen, die auf mehrere Objekttypen verweisen (z. B. Notizen → Personen/Unternehmen/Opportunities), werden beim CSV-Import oder -Export **noch nicht unterstützt**.
+
+* **Import**: Es können nur Eins-zu-viele-Beziehungen importiert werden, die auf jeder Seite auf einen einzelnen Objekttyp verweisen
+* **Export**: Spalten für Beziehungen, die auf mehrere Objekttypen verweisen, bleiben derzeit leer
+
+Dies steht auf unserer Roadmap.
+</Warning>
+
+### Was heute nicht unterstützt wird
+
+**Viele-zu-viele-Beziehungen** sind noch nicht verfügbar. Sie können derzeit beispielsweise keine Beziehung erstellen, bei der:
+
+* Viele Personen mit vielen Projekten verknüpft sind
+
+<Note>Viele zu viele Beziehungen sind für H2 2026 geplant.</Note>
+
+## Datensätze während des Imports verknüpfen
+
+<Note>**Erinnerung**: Es können nur Eins-zu-viele-Beziehungen importiert werden, die auf einen einzelnen Objekttyp verweisen (z. B. Personen → Unternehmen). Beziehungen, die auf mehrere Objekttypen verweisen (z. B. Notizen → Personen/Unternehmen/Opportunities), werden noch nicht unterstützt.</Note>
+
+### Schritt 1: Identifizieren Sie die "Eins"- und "Viele"-Seiten
+
+Bestimmen Sie zunächst, welches Objekt auf der "Eins"-Seite und welches auf der "Viele"-Seite der Beziehung steht.
+
+**Beispiel**:
+
+* **Unternehmen** ist die "Eins"-Seite (ein Unternehmen hat viele Mitarbeitende)
+* **Personen** ist die "Viele"-Seite (jede Person gehört zu einem Unternehmen)
+
+### Schritt 2: Sicherstellen, dass die Datensätze der "Eins"-Seite existieren
+
+Bevor Sie die "Viele"-Seite importieren, müssen die Datensätze der "Eins"-Seite in Twenty bereits existieren.
+
+* Importieren oder erstellen Sie zuerst die Datensätze der "Eins"-Seite (z. B. Unternehmen)
+* Validieren Sie deren eindeutigen Bezeichner. Dies kann sein:
+  * Die `id` (Twenty-UUID)
+  * Ein als eindeutig festgelegtes Feld (z. B. `domain` für Unternehmen oder eine externe ID aus Ihrem vorherigen System)
+
+<Warning>Der Import schlägt fehl, wenn auf einen nicht vorhandenen Datensatz verwiesen wird.</Warning>
+
+### Schritt 3: Bereiten Sie Ihre CSV-Datei vor
+
+Fügen Sie in Ihrer CSV-Datei der "Viele"-Seite eine Spalte hinzu, die auf den Datensatz der "Eins"-Seite verweist.
+
+**Beispiel**: Für eine Personen-CSV-Datei, die mit Unternehmen verknüpft wird:
+
+```
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**Wichtig**:
+
+* Der Wert muss dem eindeutigen Feld im Unternehmensdatensatz **exakt entsprechen**
+* Für Domains verwenden Sie die **Domain-URL** (z. B. `https://acme.com`), nicht das Domain-Label
+* Ordnen Sie pro Beziehung nur **einen** eindeutigen Bezeichner zu: Das führt zu einem reibungsloseren Import
+
+### Schritt 4: Stellen Sie sicher, dass das Beziehungsfeld existiert
+
+Vergewissern Sie sich vor dem Hochladen Ihrer Datei, dass das Beziehungsfeld zwischen Ihren Objekten existiert.
+
+Falls es nicht existiert:
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie Ihr Objekt aus (z. B. Personen)
+3. Erstellen Sie ein Beziehungsfeld, das auf das Zielobjekt zeigt (z. B. Unternehmen)
+
+### Schritt 5: Beziehung hochladen und zuordnen
+
+1. Laden Sie Ihre CSV-Datei über die Import-Benutzeroberfläche hoch
+2. Suchen Sie im Schritt der Feldzuordnung Ihre Beziehungsspalte (z. B. `companyDomain`)
+3. Ordnen Sie sie dem Beziehungsfeld zu (z. B. Unternehmen)
+4. Twenty verknüpft automatisch jeden Datensatz mit dem passenden übergeordneten Datensatz
+
+### Verfügbare eindeutige Felder für Beziehungen
+
+| Objekt                                              | Verfügbare eindeutige Felder                             |
+| --------------------------------------------------- | -------------------------------------------------------- |
+| **Unternehmen**                                     | `id`, `domain`, jedes benutzerdefinierte eindeutige Feld |
+| **Personen**                                        | `id`, `email`, jedes benutzerdefinierte eindeutige Feld  |
+| **Arbeitsbereichsmitglieder**                       | `id`, `email` (nicht Name)                               |
+| **Andere Standard- und benutzerdefinierte Objekte** | `id`, jedes als eindeutig markierte Feld                 |
+
+<Note>**Verknüpfung mit Workspace-Mitgliedern**: Wenn die Beziehung auf Workspace-Mitglieder verweist (Ihr Team, das sich bei Twenty anmeldet), referenzieren Sie sie über ihre **E-Mail-Adresse**, nicht über ihren Namen.</Note>
+
+<Note>Wir empfehlen, `domain` für Unternehmen und `email` für Personen zu verwenden, da diese menschenlesbar sind und sich in Tabellenkalkulationen leicht pflegen lassen.</Note>
+
+<Note>**Erinnerung**: Softgelöschte Datensätze (sichtbar unter Befehlsmenü → Gelöschte Datensätze anzeigen) zählen für die Einzigartigkeitskriterien. Wenn Sie einen Datensatz mit demselben eindeutigen Wert wie ein gelöschter Datensatz importieren, wird der gelöschte Datensatz wiederhergestellt. Weitere Details finden Sie unter [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints).</Note>
+
+## Regel für die Importreihenfolge
+
+<Warning>
+**Importieren Sie immer zuerst die "Eins"-Seite!**
+
+1. Zuerst **Unternehmen** (keine Abhängigkeiten)
+2. **Personen** an zweiter Stelle (mit Unternehmen verknüpft)
+3. **Opportunities** an dritter Stelle (mit Unternehmen/Personen verknüpft)
+4. **Benutzerdefinierte Objekte** entsprechend ihren Abhängigkeiten
+
+Der übergeordnete Datensatz muss existieren, bevor Sie darauf verweisen können.
+</Warning>

packages/twenty-docs/l/de/user-guide/data-migration/capabilities/uniqueness-constraints.mdx

@@ -0,0 +1,72 @@
+---
+title: Eindeutigkeitsbeschränkungen
+description: Wie Twenty während des Imports die Dateneindeutigkeit erzwingt.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Überblick
+
+Twenty erzwingt die Eindeutigkeit bei bestimmten Feldern, um doppelte Datensätze zu verhindern und die Datenintegrität sicherzustellen. Das Verständnis dieser Einschränkungen ist für erfolgreiche Importe entscheidend.
+
+## Standardmäßige eindeutige Felder
+
+| Objekt                         | Eindeutige Felder        |
+| ------------------------------ | ------------------------ |
+| **Personen**                   | `id`, `email`            |
+| **Unternehmen**                | `id`, `domain`           |
+| **Benutzerdefinierte Objekte** | nur `id` (standardmäßig) |
+
+<Note>Das Feld `id` ist die interne Kennung von Twenty und wird für jeden Datensatz automatisch generiert. Es verwendet das UUID-Format (z. B. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+## Benutzerdefinierte eindeutige Felder
+
+Sie können unter **Einstellungen → Datenmodell** zusätzliche eindeutige Felder definieren:
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie ein Objekt aus
+3. Klicken Sie auf ein Feld
+4. Aktivieren Sie **Eindeutig** in den Feldeinstellungen
+
+### Anwendungsfälle für benutzerdefinierte eindeutige Felder
+
+* **Externe IDs**: IDs aus anderen Systemen speichern (Salesforce-ID, HubSpot-ID)
+* **Geschäftskennungen**: Mitarbeiternummern, Kundencodes
+* **Alternative Kontaktinformationen**: LinkedIn-Profil, Telefonnummer
+
+<Note>Der Feldname `id` ist für die interne ID von Twenty reserviert. Verwenden Sie für externe Kennungen einen anderen Namen wie `externalId` oder `legacyId`.</Note>
+
+## Importverhalten
+
+### Erstellen neuer Datensätze
+
+Wenn ein eindeutiger Feldwert nicht existiert, wird ein neuer Datensatz erstellt.
+
+### Aktualisieren vorhandener Datensätze
+
+Wenn ein eindeutiger Feldwert mit einem vorhandenen Datensatz übereinstimmt, wird dieser Datensatz mit den neuen Daten **aktualisiert**.
+<Warning>Um **vorhandene Datensätze zu aktualisieren**, wird empfohlen, **nur ein eindeutiges Feld abzugleichen**.</Warning>
+
+### Soft-gelöschte Datensätze
+
+<Warning>
+**Gelöschte Datensätze zählen für die Eindeutigkeit.**
+
+Soft-gelöschte Datensätze (sichtbar unter Befehlsmenü → Gelöschte Datensätze anzeigen) werden in die Eindeutigkeitsprüfungen einbezogen. Wenn Sie einen Datensatz mit demselben eindeutigen Wert wie ein gelöschter Datensatz importieren, wird der gelöschte Datensatz mit den neuen Daten **wiederhergestellt**.
+</Warning>
+
+## Duplikaterkennung während des Imports
+
+Während der Validierungsphase:
+
+* Duplikate in Ihrer Datei werden gelb hervorgehoben
+* Sie können doppelte Zeilen in der Benutzeroberfläche bearbeiten oder entfernen, bevor Sie den Import starten
+
+<VimeoEmbed videoId="1145246326" title="Video-Demonstration" />
+
+## Beste Praktiken
+
+1. **Entfernen Sie Duplikate** aus Ihrer Datei vor dem Import
+2. **Prüfen Sie vorhandene Datensätze** in Twenty vor dem Import
+3. **Verwenden Sie externe IDs**, wenn Sie aus anderen Systemen migrieren
+4. **Fügen Sie eindeutige Felder hinzu**, wenn Sie vorhandene Datensätze aktualisieren möchten

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/export-faq.mdx

@@ -0,0 +1,32 @@
+---
+title: FAQ exportieren
+description: Häufig gestellte Fragen zum Export von Daten.
+---
+
+<AccordionGroup>
+<Accordion title="Können wir alle Arbeitsbereichsdaten exportieren, bevor wir stornieren, einschließlich benutzerdefinierter Objekte, benutzerdefinierter Felder, Beziehungen, Notizen, Aufgaben, Chancen, Anhänge, Workflows, Berechtigungen und Audit-Historie?">
+Workspace-Daten können vor dem Abbruch mit einigen Ausnahmen exportiert werden: Dashboards, Workflows und Berechtigungen müssen manuell übertragen werden; Audit-Protokolle können nicht übertragen werden.
+</Accordion>
+<Accordion title="Welche Elemente können derzeit nicht exportiert oder migriert werden?">
+Die meisten Elemente können exportiert oder mit einigen Ausnahmen migriert werden:
+* Workflows, Dashboards und alle Einstellungen (API-Schlüssel, Webhooks, Audit-Protokolle, Benutzereinstellungen, etc.) muss manuell migriert werden
+* durch die Installation dieser App in einem anderen Arbeitsbereich erzeugte Objekte und Felder können migriert werden. Sie sollten nicht manuell migriert werden
+* einige Datensätze, wie Workflow-Versionen und Workflow-Ausführungen, sind nicht übertragbar und werden voraussichtlich verloren gehen
+* einige Objekte wie Nachrichten und Kalenderobjekte sollten nicht exportiert werden, da sie erstellt werden, wenn ein Konto verbunden und periodisch synchronisiert ist. Sie werden erneut synchronisiert, sobald Sie Ihr Konto verbinden (solange Sie Zugriff auf dieses Konto haben wenn es ein Konto eines Teammitglieds ist, das deine Firma verlassen hat, dann müssen diese Nachrichten exportiert werden, sonst werden sie verloren)
+</Accordion>
+<Accordion title="Gibt es eine offizielle Wolke zu selbstgehosteten Migrationsprozessen oder einen unterstützten Migrationsdienst?">
+Ab sofort gibt es keine offizielle Cloud-zu-selbst gehostete Migrationsprozedur. Die Grundidee ist:
+* installiere zuerst Apps, um app-eigene Objekte und Felder einzuführen
+* von Benutzern hinzugefügte Objekte und Felder replizieren
+* verwenden Sie ein Skript mit API-Schlüsseln oder KI-Tools, um alle Daten von einem Arbeitsbereich in einen anderen zu migrieren
+* alle nicht übertragbaren Objekte müssen manuell migriert werden
+
+Bitte beachten Sie ein paar Dinge:
+* Sie können bis zu 50 Anfragen pro Minute auf den Pro Plan oder 100 Anfragen pro Minute auf den Organisationsplan schicken, bevor Sie eine Anfrage/Min. Grenze setzen
+* jede API-Anfrage kann bis zu 200 Datensätze haben
+* einige Daten in Feldern wie Erstellt von Timeline Aktivitäten und aktualisiert von werden beim Import verloren gehen und vom System überschrieben
+</Accordion>
+<Accordion title="Werden exportierte Dateien in offenen und dokumentierten Formaten bereitgestellt?">
+Exportierte Dateien in der Oberfläche befinden sich im Excel-Format, und alle API-Anfragen können im JSON-Format gespeichert werden.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/export-your-data.mdx

@@ -0,0 +1,209 @@
+---
+title: Exportieren Sie Ihre Daten
+description: Vollständige Schritt-für-Schritt-Anleitung zum Exportieren von Daten aus Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Überblick
+
+Exportieren Sie die Daten Ihres Arbeitsbereichs als CSV für Backups, Berichte oder Migrationen.
+
+**Anwendungsfälle:**
+
+* **Regelmäßige Backups** — behalten Sie Kopien Ihrer Daten
+* **Externe Berichterstattung** — analysieren Sie Daten in Excel, Google Sheets oder BI-Tools
+* **Migration** — übertragen Sie Daten in ein anderes System
+* **Massenaktualisierungen** — exportieren, bearbeiten und erneut importieren, um Datensätze zu aktualisieren
+
+## Was Sie wissen müssen
+
+### Exportbeschränkungen
+
+* **Maximal 20.000 Datensätze** pro Export
+* Nur **sichtbare Spalten** werden exportiert
+* Nur **gefilterte Datensätze** werden exportiert (basierend auf Ihrer aktuellen Ansicht)
+
+<Note>Für größere Exporte (mehr als 20.000 Datensätze) verwenden Sie Filter, um stapelweise zu exportieren, oder nutzen Sie die [API](/l/de/developers/extend/api).</Note>
+
+### Berechtigungen
+
+Sie benötigen die Berechtigung **"Export CSV"**, um Daten zu exportieren. Kontaktieren Sie Ihren Workspace-Admin, wenn Sie diese Option nicht haben.
+
+## Schritt 1: Zum Objekt navigieren
+
+Gehen Sie zu dem Objekt, das Sie exportieren möchten:
+
+* **People** — für Kontakte
+* **Companies** — für Organisationen
+* **Opportunities** — für Deals
+* **Benutzerdefinierte Objekte** — jedes Objekt, das Sie erstellt haben
+
+## Schritt 2: Ansicht konfigurieren
+
+**Wichtig:** Der Export enthält nur das, was in Ihrer aktuellen Ansicht sichtbar ist.
+
+### Spalten hinzufügen/entfernen
+
+1. Klicken Sie auf **Optionen → Felder** (oder auf das **+** am Ende der Spalten)
+2. Wählen Sie die Felder aus, die Sie exportieren möchten
+3. Deaktivieren Sie Felder, die Sie nicht benötigen
+
+### Datensätze filtern (optional)
+
+Wenn Sie nur einen Teil der Daten benötigen:
+
+1. Klicken Sie auf **Filter**
+2. Fügen Sie Filterbedingungen hinzu (z. B. "Erstellungsdatum > 1. Januar 2024")
+3. Es werden nur übereinstimmende Datensätze exportiert
+
+### Datensätze sortieren (optional)
+
+1. Klicken Sie auf eine Spaltenüberschrift, um zu sortieren
+2. Der Export übernimmt Ihre Sortierreihenfolge
+
+<Note>**Erstellen Sie eine dedizierte Exportansicht.** Speichern Sie eine Ansicht, die speziell für Exporte konfiguriert ist, damit Sie sie nicht jedes Mal neu konfigurieren müssen.</Note>
+
+## Schritt 3: Daten exportieren
+
+1. Klicken Sie auf das Symbol **⋮** oben rechts in der Tabelle
+2. Wählen Sie **Ansicht exportieren**
+3. Wählen Sie den Speicherort für die CSV-Datei
+4. Warten Sie, bis der Download abgeschlossen ist
+
+## Was exportiert wird
+
+| Enthalten                                         | Nicht enthalten                       |
+| ------------------------------------------------- | ------------------------------------- |
+| Alle sichtbaren Spalten                           | Ausgeblendete Spalten                 |
+| Datensätze, die den aktuellen Filtern entsprechen | Herausgefilterte Datensätze           |
+| Benutzerdefinierte Feldwerte                      | Felder, die nicht in der Ansicht sind |
+| Datensatz-IDs                                     | Dateianhänge                          |
+| Beziehungs-IDs                                    | Bilder                                |
+
+### Relationsfelder
+
+Beziehungs-IDs werden nur auf der **"Many"-Seite** einer Beziehung exportiert:
+
+* **People-Export** enthält eine `companyId`-Spalte (Beziehung People → Company)
+* **Companies-Export** enthält NICHT `peopleIds` (Companies ist die "One"-Seite)
+
+Das bedeutet, Sie können den People-Export zum Re-Import verwenden und die Verknüpfung zur Company beibehalten, müssen jedoch People nach Companies erneut importieren, um die Beziehungen wiederherzustellen.
+
+## Exportieren für bestimmte Zwecke
+
+### Für Backups
+
+1. Erstellen Sie eine Ansicht, in der **alle Felder** sichtbar sind
+2. Entfernen Sie alle Filter, um alle Datensätze einzubeziehen
+3. Exportieren Sie jeden Objekttyp separat
+4. Speichern Sie Exporte an einem sicheren Ort
+5. Richten Sie eine wiederkehrende Erinnerung ein (wöchentlich/monatlich)
+
+### Für externe Berichterstattung
+
+1. Nehmen Sie nur die Felder auf, die Sie für die Analyse benötigen
+2. Wenden Sie Filter an, um sich auf relevante Daten zu konzentrieren
+3. Erwägen Sie, nach dem Feld zu sortieren, das Sie analysieren werden
+
+### Für Massenaktualisierungen
+
+1. Exportieren Sie die Datensätze, die Sie aktualisieren möchten
+2. Fügen Sie den eindeutigen Bezeichner ein (`email`, `domain` oder `id`)
+3. Bearbeiten Sie die exportierte Datei
+4. Erneut importieren, um Datensätze zu aktualisieren
+   Siehe: [So aktualisieren Sie vorhandene Datensätze](/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import)
+
+### Für Migration
+
+Wenn Sie zum Zweck der Migration in ein anderes System exportieren:
+
+1. **Exportieren Sie jedes Objekt separat** — People, Companies, Opportunities usw.
+2. **ID-Felder einbeziehen** — diese helfen, Beziehungen beizubehalten
+3. **Feldzuordnungen dokumentieren** — notieren Sie, wie Twenty-Felder Ihrem Zielsystem zugeordnet werden
+
+## Umgang mit großen Datensätzen (mehr als 20.000 Datensätze)
+
+Das Exportlimit beträgt 20.000 Datensätze. Für größere Datensätze:
+
+### Option 1: Stapelweiser Export
+
+1. Fügen Sie einen Filter hinzu (z. B. "Erstellungsdatum"-Bereiche)
+2. Exportieren Sie den ersten Stapel
+3. Ändern Sie den Filter
+4. Exportieren Sie den nächsten Stapel
+5. Kombinieren Sie die Dateien in Ihrer Tabellenkalkulation
+
+**Beispielfilter für die Stapelverarbeitung:**
+
+* Nach Datumsbereich (Januar, Februar, März ...)
+* Nach Eigentümer/in (Teammitglied A, Teammitglied B ...)
+* Nach Status (Aktiv, Inaktiv ...)
+
+### Option 2: Verwenden Sie die API
+
+Die API hat kein Datensatzlimit:
+
+1. Holen Sie sich Ihren API-Schlüssel unter **Einstellungen → Entwickler**
+2. Verwenden Sie die GraphQL-API, um Datensätze abzufragen
+3. Verarbeiten Sie die Ergebnisse in Ihrer Anwendung
+
+Siehe: [API-Dokumentation](/l/de/developers/extend/api)
+
+## Tipps und Best Practices
+
+### Exportansichten erstellen
+
+Speichern Sie Ansichten, die speziell für Exporte konfiguriert sind:
+
+1. Konfigurieren Sie Spalten und Filter
+2. Klicken Sie auf **Ansichtsoptionen** → **Als neue Ansicht speichern**
+3. Benennen Sie sie "Export - [Zweck]"
+
+### Sichern Sie Ihre Exporte
+
+Exportierte Dateien können sensible Daten enthalten:
+
+* Speichern Sie sie an sicheren Orten
+* Löschen Sie alte Exporte, wenn sie nicht mehr benötigt werden
+* Seien Sie vorsichtig beim Teilen von Exportdateien
+
+### Vor dem Export prüfen
+
+<Check>Die richtigen Spalten sind sichtbar</Check>
+<Check>Filter sind korrekt gesetzt (oder für den Vollexport entfernt)</Check>
+<Check>Sie haben eine Exportberechtigung</Check>
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Warum fehlen in meinem Export einige Spalten?">
+    Es werden nur sichtbare Spalten exportiert. Fügen Sie die benötigten Spalten vor dem Export über **Optionen → Felder** hinzu.
+  </Accordion>
+
+  <Accordion title="Warum enthält mein Export nicht alle Datensätze?">
+    Überprüfen Sie Ihre Filter. Der Export enthält nur Datensätze, die Ihren aktuellen Ansichtsfiltern entsprechen. Entfernen Sie Filter, um alle Datensätze zu exportieren.
+  </Accordion>
+
+  <Accordion title="Kann ich mehr als 20.000 Datensätze exportieren?">
+    Nicht in einem einzigen Export. Verwenden Sie Filter, um stapelweise zu exportieren, oder nutzen Sie die API für größere Datensätze.
+  </Accordion>
+
+  <Accordion title="Welches Format hat die Exportdatei?">
+    CSV (durch Kommas getrennte Werte). Lässt sich in Excel, Google Sheets oder jeder Tabellenkalkulationsanwendung öffnen.
+  </Accordion>
+
+  <Accordion title="Sind Beziehungs-IDs enthalten?">
+    Ja, aber nur auf der "Many"-Seite von Beziehungen. Beispielsweise enthält ein People-Export `companyId`, ein Companies-Export enthält jedoch keine People-IDs.
+  </Accordion>
+
+  <Accordion title="Kann ich Exporte automatisieren?">
+    Nicht direkt über die UI. Verwenden Sie die API, um automatisierte Export-Workflows zu erstellen.
+  </Accordion>
+</AccordionGroup>
+
+## Nächste Schritte
+
+* [So aktualisieren Sie vorhandene Datensätze](/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import) — bearbeiten Sie Ihren Export und importieren Sie ihn erneut
+* [So importieren Sie Daten über die API](/l/de/user-guide/data-migration/how-tos/import-data-via-api) — für große Datensätze
+* [API-Dokumentation](/l/de/developers/extend/api) — erstellen Sie benutzerdefinierte Export-Workflows

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/fix-import-errors.mdx

@@ -0,0 +1,430 @@
+---
+title: Importfehler beheben
+description: Umfassende Anleitung zur Fehlerbehebung bei CSV-Importfehlern.
+---
+
+## Übersicht
+
+Import funktioniert nicht? Diese Anleitung hilft Ihnen, häufige Importfehler Schritt für Schritt zu erkennen und zu beheben.
+
+## Wie die Importvalidierung funktioniert
+
+Nachdem Sie Ihre Datei hochgeladen und die Spalten zugeordnet haben, validiert Twenty Ihre Daten:
+
+1. **Validierung läuft** — Twenty prüft jede Zeile auf Fehler
+2. **Fehler werden hervorgehoben** — problematische Zeilen erscheinen in **gelb**
+3. **Sie können direkt korrigieren** — bearbeiten Sie Zellen direkt in der Import-UI
+4. **Oder Zeilen entfernen** — problematische Datensätze vollständig überspringen
+
+<Note>**Beheben Sie Fehler in der UI.** Sie müssen nicht zu Ihrer Tabellenkalkulation zurückkehren. Bearbeiten Sie Zellen direkt während des Imports, um Zeit zu sparen.</Note>
+
+## Schritt-für-Schritt-Fehlerbehebung
+
+### Schritt 1: Fehlertyp bestimmen
+
+Klicken Sie auf eine hervorgehobene Zeile, um die spezifische Fehlermeldung anzuzeigen. Häufige Fehlertypen:
+
+| Fehlermeldung                                                                  | Was es bedeutet                                                        |
+| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
+| Doppelte Werte, gelb hervorgehoben                                             | Wert existiert bereits in Twenty oder kommt in Ihrer Datei doppelt vor |
+| `{field} is not a valid {type}` (fahren Sie mit der Maus über die gelbe Zelle) | Daten entsprechen nicht dem erwarteten Format                          |
+| Erforderliches Feld hervorgehoben                                              | Erforderliches Feld ist leer                                           |
+| `Can't connect to {object}. No unique record found...` (Import schlägt fehl)   | Referenzierter Datensatz existiert nicht                               |
+| `Too many records. Up to 10000 allowed` (Upload blockiert)                     | Die Datei enthält mehr als 10.000 Datensätze                           |
+
+### Schritt 2: Fehler beheben
+
+Befolgen Sie die unten stehenden spezifischen Anweisungen für jeden Fehlertyp.
+
+---
+
+## Fehler: Doppelter Wert
+
+### Was Sie sehen werden
+
+Zeilen mit doppelten Werten werden in der Import-UI **gelb hervorgehoben**, bevor der Import startet.
+
+### Was es bedeutet
+
+Ein eindeutiges Feld (E-Mail, Domain) entweder:
+
+* Existiert bereits in Twenty
+* Kommt in Ihrer Datei doppelt vor
+
+### So beheben Sie den Fehler
+
+**Option 1: Doppelt vorhandenen Wert bearbeiten**
+
+1. Klicken Sie auf die Zelle mit dem Fehler
+2. In einen eindeutigen Wert ändern
+3. Mit dem Import fortfahren
+
+**Option 2: Die doppelte Zeile entfernen**
+
+1. Klicken Sie auf das X neben der Zeile
+2. Die Zeile wird während des Imports übersprungen
+
+**Option 3: Twenty den vorhandenen Datensatz aktualisieren lassen**
+
+1. Stellen Sie sicher, dass Ihre Datei einen eindeutigen Bezeichner enthält (`email`, `domain` oder `id`)
+2. Ordnen Sie das Feld mit dem eindeutigen Bezeichner zu
+3. Twenty aktualisiert den vorhandenen Datensatz, statt ein Duplikat zu erstellen
+
+<Note>
+**Sie können eindeutige Felder ebenfalls aktualisieren.**
+
+* Wenn Sie die `id` beibehalten, aber die `email` ändern → die E-Mail wird aktualisiert
+* Wenn Sie die `email` beibehalten, aber die `id` ändern → die ID wird aktualisiert
+
+Solange ein eindeutiger Bezeichner übereinstimmt, aktualisiert Twenty den Datensatz.
+</Note>
+
+### So vermeiden Sie diesen Fehler
+
+Vor dem Import:
+
+1. Sortieren Sie Ihre Tabellenkalkulation nach dem eindeutigen Feld
+2. Entfernen Sie doppelte Zeilen
+3. Prüfen Sie, ob Datensätze bereits in Twenty existieren
+
+<Warning>
+**Soft-gelöschte Datensätze zählen für die Eindeutigkeit.**
+
+Überprüfen Sie das Befehlsmenü → Gelöschte Datensätze anzeigen. Die dortigen Datensätze erzwingen weiterhin die Eindeutigkeit. Löschen Sie sie dauerhaft oder stellen Sie sie wieder her und aktualisieren Sie sie.
+</Warning>
+
+Weitere Details: [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)
+
+---
+
+## Fehler: Ungültiges Format
+
+### Was Sie sehen werden
+
+Der Zellwert ist gelb hervorgehoben. Fahren Sie mit der Maus darüber, um die Fehlermeldung zu sehen:
+
+```
+{field name} is not a valid {field type}
+```
+
+### Was es bedeutet
+
+Die Daten entsprechen nicht dem erwarteten Format für diesen Feldtyp.
+
+### So beheben Sie den Fehler — nach Feldtyp
+
+#### E-Mail
+
+**Problem:** Ungültiges E-Mail-Format
+**Lösung:** Verwenden Sie das Format `name@domain.com`
+
+```
+❌ john.smith@
+❌ john smith@acme.com
+✓ john.smith@acme.com
+```
+
+#### Domäne
+
+**Problem:** Uneinheitliches Format kann Duplikate verursachen
+**Lösung:** Verwenden Sie das Format `https://domain.com` (empfohlen)
+
+```
+⚠️ acme.com         (valid, but not recommended)
+⚠️ www.acme.com     (valid, but not recommended)
+✅ https://acme.com  (recommended)
+```
+
+<Note>Alle Formate sind gültig, aber `https://domain.com` wird empfohlen, da es dem von der E-Mail-/Kalendersynchronisierung verwendeten Format entspricht. Die Verwendung anderer Formate kann doppelte Unternehmen erzeugen.</Note>
+
+#### Datum
+
+**Problem:** Nicht erkanntes Datumsformat
+**Lösung:** Verwenden Sie in der gesamten Datei durchgängig das Format `YYYY-MM-DD`
+
+```
+✓ 2024-03-15        (YYYY-MM-DD)
+❌ 03/15/2024        (MM/DD/YYYY)
+❌ 15/03/2024        (DD/MM/YYYY)
+```
+
+#### Telefon
+
+**Problem:** Erforderliche Spalten fehlen
+**Lösung:** Alle Telefonspalten einschließen
+
+| Spalte                                  | Beispiel     |
+| --------------------------------------- | ------------ |
+| **Phones / Primary Phone Number**       | `4159095555` |
+| **Phones / Primary Phone Country Code** | `US`         |
+| **Phones / Primary Phone Calling Code** | `+1`         |
+
+#### Boolesch
+
+**Problem:** Falscher boolescher Wert
+**Lösung:** Verwenden Sie `TRUE` oder `FALSE` in Großbuchstaben
+
+```
+❌ true
+❌ yes
+❌ 1
+✓ TRUE
+✓ FALSE
+```
+
+#### Auswahl / Mehrfachauswahl
+
+**Problem:** Wert stimmt nicht mit vorhandenen Optionen überein
+**Lösung:** Verwenden Sie **API-Namen**, nicht Anzeigenamen
+
+So finden Sie API-Namen:
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie das Objekt und das Feld aus
+3. Aktivieren Sie den **Erweiterten Modus** (Schalter unten rechts)
+4. Verwenden Sie den API-Namen (z. B. `OPTION_1`, nicht "Option 1")
+
+```
+❌ High Priority
+✓ HIGH_PRIORITY
+```
+
+#### Währung
+
+**Problem:** Betrag oder Währungscode fehlt
+**Lösung:** Beide Spalten ausfüllen
+
+| Spalte                | Beispiel  |
+| --------------------- | --------- |
+| **Amount / Amount**   | `1234.56` |
+| **Amount / Currency** | `USD`     |
+
+#### Nummer
+
+**Problem:** Nichtnumerische Zeichen
+**Lösung:** Nur Zahlen, Punkt für Dezimalstellen
+
+```
+❌ $1,234.56
+❌ 1,234.56
+✓ 1234.56
+```
+
+Vollständige Formatreferenz: [Referenz zur Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)
+
+---
+
+## Fehler: Erforderliches Feld fehlt
+
+### Was Sie sehen werden
+
+Die Zeile ist gelb hervorgehoben, und die Zelle des erforderlichen Felds ist markiert.
+
+### Was es bedeutet
+
+Ein erforderliches Feld ist in dieser Zeile leer.
+
+### So beheben Sie den Fehler
+
+**Option 1: Einen Wert eingeben**
+
+1. Klicken Sie auf die leere Zelle
+2. Geben Sie einen Wert ein
+3. Mit dem Import fortfahren
+
+**Option 2: Die Zeile entfernen**
+
+1. Wenn Ihnen die Daten fehlen, klicken Sie auf X, um die Zeile zu überspringen
+
+### So vermeiden Sie diesen Fehler
+
+Identifizieren Sie vor dem Import die erforderlichen Felder:
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie Ihr Objekt aus
+3. Prüfen Sie, welche Felder als erforderlich markiert sind
+
+---
+
+## Fehler: Relation nicht gefunden
+
+### Was Sie sehen werden
+
+Dieser Fehler tritt **nach Beginn des Imports** auf — der Import schlägt mit einer Meldung wie dieser fehl:
+
+```
+Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
+```
+
+Das bedeutet, dass es in Twenty kein Unternehmen mit diesem spezifischen Bezeichner gibt.
+
+<Note>Im Gegensatz zu anderen Fehlern wird dieser im Schritt der Datenüberprüfung nicht erkannt. Der Import startet und schlägt dann fehl, wenn die fehlende Relation auftritt.</Note>
+
+### Was es bedeutet
+
+Sie versuchen, auf einen Datensatz zu verweisen, der in Twenty nicht existiert.
+
+### So beheben Sie den Fehler
+
+**Option 1: Importieren Sie zuerst die übergeordneten Datensätze**
+
+1. Brechen Sie den aktuellen Import ab
+2. Importieren Sie die übergeordneten Datensätze (z. B. Unternehmen)
+3. Importieren Sie anschließend die untergeordneten Datensätze (z. B. Personen)
+
+**Option 2: Korrigieren Sie den Referenzwert**
+
+1. Überprüfen Sie den Referenzwert in Ihrer Datei
+2. Stellen Sie sicher, dass er genau mit einem vorhandenen Datensatz übereinstimmt
+3. Format prüfen: Domains sollten das Format `https://domain.com` haben
+
+**Option 3: Entfernen Sie die Relation**
+
+1. Leeren Sie die Zelle, um ohne die Relation zu importieren
+2. Fügen Sie die Relation später manuell hinzu
+
+### So vermeiden Sie diesen Fehler
+
+1. **In der richtigen Reihenfolge importieren:**
+   * Zuerst Unternehmen
+   * Dann Personen (mit Unternehmensreferenzen)
+   * Als Drittes Opportunities
+
+2. **Referenzwerte überprüfen:**
+   * Exportieren Sie übergeordnete Datensätze, um exakte Bezeichner zu erhalten
+   * Verwenden Sie das Domain-Format `https://domain.com`
+   * Prüfen Sie auf Tippfehler und Groß-/Kleinschreibung
+
+<Warning>
+**Der Import schlägt fehl, wenn auf einen nicht vorhandenen Datensatz verwiesen wird.**
+
+Importieren Sie übergeordnete Objekte immer vor untergeordneten Objekten.
+</Warning>
+
+Weitere Details: [Beziehungen importieren](/l/de/user-guide/data-migration/capabilities/import-relations)
+
+---
+
+## Fehler: Datei zu groß
+
+### Was Sie sehen werden
+
+Dieser Fehler tritt **beim Hochladen Ihrer Datei** auf — der Upload wird vollständig blockiert:
+
+```
+Too many records. Up to 10000 allowed
+```
+
+Sie können erst mit dem Schritt der Datenüberprüfung fortfahren, wenn Sie die Dateigröße reduziert haben.
+
+### Was es bedeutet
+
+Ihre Datei enthält mehr als 10.000 Datensätze.
+
+### So beheben Sie den Fehler
+
+**Option 1: In mehrere Dateien aufteilen**
+
+1. Teilen Sie Ihre Daten in Dateien mit 10.000 oder weniger Datensätzen auf
+2. Importieren Sie jede Datei separat
+3. Halten Sie die Importreihenfolge ein (Unternehmen vor Personen)
+
+**Option 2: API-Import verwenden**
+Für sehr große Datensätze verwenden Sie die API, die keine Datensatzbegrenzung hat.
+Siehe: [So importieren Sie Daten über die API](/l/de/user-guide/data-migration/how-tos/import-data-via-api)
+
+---
+
+## Fehler: Feld nicht erkannt
+
+### Was es bedeutet
+
+Eine Spalte in Ihrer Datei kann nicht zugeordnet werden, weil das Feld in Twenty nicht existiert.
+
+### So beheben Sie den Fehler
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie das Objekt aus, das Sie importieren
+3. Klicken Sie auf **+ Feld hinzufügen**
+4. Erstellen Sie das benutzerdefinierte Feld mit dem passenden Typ
+5. Laden Sie Ihre Datei erneut hoch
+
+<Note>Der CSV-Import erstellt Datensätze, nicht Felder. Alle Felder müssen vor dem Import vorhanden sein.</Note>
+
+---
+
+## Fehler: Benutzerrelation leer
+
+### Was es bedeutet
+
+Sie versuchen, einen Datensatz einem Benutzer zuzuweisen (Owner, Assignee), aber die Relation wird nicht zugeordnet.
+
+### Häufige Ursachen
+
+1. **Benutzer hat seine Einladung nicht angenommen** — der Benutzer existiert noch nicht in Twenty
+2. **Benutzer-ID aus altem System verwendet** — Twenty kann IDs aus einem anderen System nicht zuordnen
+3. **Falsches E-Mail-Format** — die E-Mail entspricht nicht dem Twenty-Konto des Benutzers
+
+### So beheben Sie den Fehler
+
+1. Stellen Sie sicher, dass alle Benutzer **ihre Einladung** zu Ihrem Twenty-Arbeitsbereich **angenommen haben**
+2. Verwenden Sie die **E-Mail-Adresse** des Benutzers (nicht seinen Namen oder die alte System-ID)
+3. Verwenden Sie dieselbe E-Mail, mit der sie Twenty beigetreten sind
+
+<Warning>
+**Benutzer müssen Einladungen vor dem Import annehmen.**
+
+Wenn ein Benutzer seine Einladung nicht angenommen hat, haben Datensätze, die auf ihn verweisen, leere Benutzerrelationen.
+</Warning>
+
+---
+
+## Checkliste vor dem Import
+
+Vermeiden Sie Fehler, indem Sie vor dem Import Folgendes prüfen:
+
+### Dateianforderungen
+
+<Check>Datei ist im CSV-, XLSX- oder XLS-Format</Check>
+<Check>Datei enthält weniger als 10.000 Datensätze</Check>
+<Check>Datei verwendet UTF-8-Kodierung</Check>
+
+### Datenqualität
+
+<Check>Keine doppelten E-Mails (für Personen)</Check>
+<Check>Keine doppelten Domains (für Unternehmen)</Check>
+<Check>Alle Datumsangaben verwenden ein einheitliches Format</Check>
+<Check>Alle Domains verwenden das Format `https://domain.com`</Check>
+
+### Feldformate
+
+<Check>Boolesche Felder verwenden `TRUE` oder `FALSE` (Großbuchstaben)</Check>
+<Check>Auswahlfelder verwenden API-Namen, nicht Anzeigenamen</Check>
+<Check>Telefonfelder enthalten alle erforderlichen Spalten</Check>
+<Check>Währungsfelder enthalten sowohl Betrag als auch Währungscode</Check>
+
+### Beziehungen
+
+<Check>Übergeordnete Datensätze vor untergeordneten Datensätzen importiert</Check>
+<Check>Relationsspalten verweisen auf vorhandene Datensätze</Check>
+<Check>Domain-Format entspricht exakt dem Format von Twenty</Check>
+
+### Datenmodell
+
+<Check>Alle benutzerdefinierten Felder existieren in Einstellungen → Datenmodell</Check>
+<Check>Auswahloptionen existieren vor dem Import</Check>
+
+---
+
+## Gibt es weiterhin Probleme?
+
+Wenn Sie die obigen Lösungen ausprobiert haben:
+
+1. **Beispieldatei herunterladen** — sehen Sie das genaue Format, das Twenty erwartet
+2. **Bestehende Datensätze exportieren** — vergleichen Sie Ihre Datei mit funktionierenden Daten
+3. **Testen Sie mit einer kleinen Stichprobe** — probieren Sie zuerst 5-10 Zeilen
+4. **Prüfen Sie die Referenzartikel:**
+   * [Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)
+   * [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)
+   * [Beziehungen importieren](/l/de/user-guide/data-migration/capabilities/import-relations)
+   * [Fehlerbehandlung](/l/de/user-guide/data-migration/capabilities/error-handling)

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/import-companies-via-csv.mdx

@@ -0,0 +1,201 @@
+---
+title: Unternehmen über CSV importieren
+description: Vollständige Schritt-für-Schritt-Anleitung zum Importieren von Unternehmen in Twenty.
+---
+
+## Übersicht
+
+Diese Anleitung führt Sie durch den Import Ihrer Unternehmen in Twenty. **Unternehmen sollten zuerst importiert werden**, da Personen und Verkaufschancen mit Unternehmen verknüpft werden.
+
+## Bevor Sie beginnen
+
+### Checkliste der Voraussetzungen
+
+<Check>
+Ihre Datei ist im CSV-, XLSX- oder XLS-Format
+</Check>
+
+<Check>
+Die Datei enthält weniger als 10.000 Datensätze
+</Check>
+
+<Check>
+Keine doppelten Domains in Ihrer Datei
+</Check>
+
+<Check>
+Alle benutzerdefinierten Felder existieren in **Einstellungen → Datenmodell**
+</Check>
+
+<Note>
+Müssen Sie mehr als 10.000 Unternehmen importieren? Teilen Sie in mehrere Dateien auf oder verwenden Sie den [API-Import](/l/de/user-guide/data-migration/how-tos/import-data-via-api).
+</Note>
+
+## Schritt 1: Bereiten Sie Ihre Unternehmensdaten vor
+
+### Erforderliche und empfohlene Felder
+
+| Feld                          | Erforderlich? | Format               | Notizen                        |
+| ----------------------------- | ------------- | -------------------- | ------------------------------ |
+| **Name**                      | Empfohlen     | Text                 | Anzeigename des Unternehmens   |
+| **Domain**                    | Empfohlen     | `https://domain.com` | Eindeutiger Bezeichner         |
+| **Adresse**                   | Optional      | Mehrere Spalten      | Siehe unten                    |
+| **Mitarbeiter**               | Optional      | Nummer               | Anzahl der Mitarbeiter         |
+| **Benutzerdefinierte Felder** | Optional      | Variiert             | Muss im Datenmodell existieren |
+
+### Domain-Format
+
+<Warning>
+**Verwenden Sie für Domains das Format `https://domain.com`.**
+
+Dies entspricht dem Format, das verwendet wird, wenn Unternehmen durch E-Mail-/Kalender-Synchronisierung automatisch erstellt werden, und verhindert später Duplikate.
+</Warning>
+
+**Domain-Spalten:**
+
+* **Domain / Domain Label**: `acme.com`
+* **Domain / Domain URL**: `https://acme.com`
+
+### Adressformat
+
+Adresse ist ein verschachteltes Feld mit mehreren Spalten:
+
+```
+Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
+123 Main Street,San Francisco,CA,USA,94105
+```
+
+### Beispielhafte CSV-Struktur
+
+```csv
+name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
+Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
+Widget Co,https://widgets.co,widgets.co,New York,USA,50
+```
+
+<Note>
+**Profi-Tipp:** Klicken Sie während des Imports auf **Beispieldatei herunterladen**, um die genauen Spaltennamen zu sehen, die Twenty erwartet.
+</Note>
+
+## Schritt 2: Zugriff auf die Importfunktion
+
+**Option 1: Aus der Unternehmensansicht**
+
+1. Navigieren Sie zu **Unternehmen** in der linken Seitenleiste
+2. Klicken Sie auf das Symbol **⋮** oben rechts
+3. Wählen Sie **Datensätze importieren**
+
+**Option 2: Über das Befehlsmenü**
+
+1. Drücken Sie `Cmd + K` (Mac) oder `Strg + K` (Windows)
+2. Geben Sie "import" ein
+3. Wählen Sie **Datensätze importieren**
+4. Wählen Sie **Unternehmen**
+
+## Schritt 3: Laden Sie Ihre Datei hoch
+
+1. Klicken Sie auf **Datei auswählen**
+2. Wählen Sie Ihre CSV-, XLSX- oder XLS-Datei aus
+3. Warten Sie, bis Twenty Ihre Datei analysiert
+
+## Schritt 4: Ordnen Sie Ihre Spalten zu
+
+Twenty versucht automatisch, Ihre Spalten den Feldern zuzuordnen. Prüfen und anpassen:
+
+1. **Automatische Zuordnungen prüfen** — vergewissern Sie sich, dass sie korrekt sind
+2. **Falsche Zuordnungen korrigieren** — klicken Sie auf das Dropdown, um das richtige Feld auszuwählen
+3. **Spalten überspringen** — wählen Sie **Do not map** für Spalten, die Sie nicht importieren möchten
+
+### Wichtige Zuordnungsregeln
+
+* **Domain**: Ordnen Sie **Domain / Domain URL** zu (nicht Domain Label)
+* **Adresse**: Ordnen Sie jeden Teil der jeweiligen Spalte zu (Stadt, Bundesstaat usw.)
+* **Auswahlfelder**: Werte müssen mit vorhandenen Optionen übereinstimmen (oder Sie ordnen sie im nächsten Schritt zu)
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
+
+## Schritt 5: Werte von Auswahlfeldern zuordnen
+
+Wenn Sie Auswahl- oder Mehrfachauswahlfelder haben:
+
+1. Twenty zeigt Ihre Werte neben den vorhandenen Optionen an
+2. Ordnen Sie jeden Wert in Ihrer Datei einer Twenty-Option zu
+3. Oder erstellen Sie bei Bedarf neue Optionen
+
+<Note>
+Auswahloptionen verwenden **API-Namen**, nicht Anzeigenamen. Prüfen Sie **Einstellungen → Datenmodell** → Aktivieren Sie den **Erweiterten Modus**, um API-Namen zu sehen.
+</Note>
+
+## Schritt 6: Fehler prüfen und beheben
+
+Bevor der Import abgeschlossen wird, validiert Twenty Ihre Daten:
+
+1. Klicken Sie auf **Nächste Schritte**
+2. Zeilen mit Fehlern sind **gelb** hervorgehoben
+3. **Fehler direkt beheben** — klicken Sie auf eine Zelle und bearbeiten Sie den Wert
+4. **Problematische Zeilen entfernen** — klicken Sie auf das X, um die Zeile zu überspringen
+
+### Häufige Fehler beim Unternehmensimport
+
+| Fehler                        | Ursache                            | Lösung                                                       |
+| ----------------------------- | ---------------------------------- | ------------------------------------------------------------ |
+| **Doppelte Domain**           | Domain existiert bereits in Twenty | Aus Datei entfernen oder bestehenden Datensatz aktualisieren |
+| **Ungültiges Domain-Format**  | Falsches Format                    | Verwenden Sie `https://domain.com`                           |
+| **Erforderliches Feld fehlt** | Erforderliches Feld ist leer       | Wert ausfüllen oder Zeile entfernen                          |
+
+## Schritt 7: Import abschließen
+
+1. Importzusammenfassung prüfen
+2. Klicken Sie auf **Bestätigen**, um zu importieren
+3. Warten Sie, bis der Import abgeschlossen ist
+4. Überprüfen Sie dies, indem Sie einige Datensätze prüfen
+
+## Nach dem Import von Unternehmen
+
+Jetzt können Sie Datensätze importieren, die mit Unternehmen verknüpft sind:
+
+1. **[Personen importieren](/l/de/user-guide/data-migration/how-tos/import-contacts-via-csv)** — verknüpfen Sie sie über die Domain mit Unternehmen
+2. **Verkaufschancen importieren** — verknüpfen Sie sie mit Unternehmen
+3. **Import verifizieren** — prüfen Sie stichprobenartig einige Datensätze, um sicherzustellen, dass die Daten korrekt sind
+
+## Vorhandene Unternehmen aktualisieren
+
+So aktualisieren Sie Unternehmen, statt neue zu erstellen:
+
+1. Fügen Sie die Spalte `domain` oder `id` in Ihrer Datei hinzu
+2. Twenty gleicht Datensätze anhand dieses eindeutigen Bezeichners ab
+3. Vorhandene Unternehmen werden aktualisiert; neue werden erstellt
+
+Details finden Sie unter [So aktualisieren Sie vorhandene Datensätze](/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import).
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Warum können zwei Unternehmen nicht dieselbe Domain haben?">
+    Die Domain ist ein eindeutiger Bezeichner in Twenty. Das verhindert doppelte Unternehmen und stellt sicher, dass die E-Mail-Synchronisierung E-Mails dem richtigen Unternehmen korrekt zuordnet.
+  </Accordion>
+
+  <Accordion title="Was ist, wenn ich Unternehmen ohne Domain habe?">
+    Sie können die Domain leer lassen. Wir empfehlen jedoch, wenn möglich Domains hinzuzufügen, um die Datenqualität zu verbessern und E-Mails automatisch zuzuordnen.
+  </Accordion>
+
+  <Accordion title="Kann ich Unternehmen ohne verknüpfte Personen importieren?">
+    Ja! Sie können zunächst Unternehmen importieren und später Personen importieren und sie mithilfe der Unternehmensdomain verknüpfen.
+  </Accordion>
+
+  <Accordion title="Was passiert, wenn ich eine bereits vorhandene Domain importiere?">
+    Wenn Sie einen eindeutigen Bezeichner (Domain oder id) angeben, der mit einem vorhandenen Unternehmen übereinstimmt, aktualisiert Twenty dieses Unternehmen, statt ein Duplikat zu erstellen.
+  </Accordion>
+
+  <Accordion title="Wie behebe ich Fehler vom Typ 'doppelte Domain'?">
+    Entfernen Sie entweder das Duplikat aus Ihrer Datei oder fügen Sie die `id` des Unternehmens hinzu, um stattdessen den vorhandenen Datensatz zu aktualisieren.
+  </Accordion>
+</AccordionGroup>
+
+## Fehlerbehebung
+
+Gibt es Probleme? Prüfen Sie:
+
+* [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors)
+* [Referenz zur Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)
+* [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx

@@ -0,0 +1,242 @@
+---
+title: Kontakte über CSV importieren
+description: Vollständige Schritt-für-Schritt-Anleitung zum Importieren von Personen/Kontakten in Twenty.
+---
+
+## Übersicht
+
+Diese Anleitung führt Sie durch den Import Ihrer Kontakte (Personen) in Twenty.
+
+## Bevor Sie beginnen
+
+### Checkliste der Voraussetzungen
+
+<Check>
+Ihre Datei ist im CSV-, XLSX- oder XLS-Format
+</Check>
+
+<Check>
+Die Datei enthält weniger als 10.000 Datensätze
+</Check>
+
+<Check>
+Keine doppelten E-Mail-Adressen in Ihrer Datei
+</Check>
+
+<Check>
+**Unternehmen zuerst importiert** (wenn Personen mit Unternehmen verknüpft werden)
+</Check>
+
+<Check>
+Alle benutzerdefinierten Felder existieren in **Einstellungen → Datenmodell**
+</Check>
+
+<Warning>
+**Unternehmen vor Personen importieren**
+
+Wenn Sie Personen mit Unternehmen verknüpfen möchten, importieren Sie zuerst Unternehmen. Das Unternehmen muss existieren, bevor Sie darauf verweisen können.
+</Warning>
+
+## Schritt 1: Bereiten Sie Ihre Kontaktdaten vor
+
+### Erforderliche und empfohlene Felder
+
+| Feld                          | Erforderlich? | Format            | Notizen                               |
+| ----------------------------- | ------------- | ----------------- | ------------------------------------- |
+| **E-Mail**                    | Empfohlen     | `name@domain.com` | Muss eindeutig sein                   |
+| **Vorname**                   | Empfohlen     | Text              |                                       |
+| **Nachname**                  | Empfohlen     | Text              |                                       |
+| **Unternehmen**               | Optional      | Domain oder ID    | Verknüpft mit vorhandenem Unternehmen |
+| **Telefon**                   | Optional      | Mehrere Spalten   | Siehe unten                           |
+| **Berufsbezeichnung**         | Optional      | Text              |                                       |
+| **Benutzerdefinierte Felder** | Optional      | Variiert          | Muss im Datenmodell existieren        |
+
+### E-Mail-Format
+
+* Muss ein gültiges E-Mail-Format haben: `name@domain.com`
+* **Muss eindeutig sein** — keine Duplikate in Ihrer Datei oder in Twenty
+* Für zusätzliche E-Mails verwenden Sie die Spalte **Emails / Additional Emails**:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Telefonformat
+
+Telefon ist ein **verschachteltes Feld**, das mehrere Spalten erfordert:
+
+| Spalte                                  | Beispiel     |
+| --------------------------------------- | ------------ |
+| **Phones / Primary Phone Number**       | `4159095555` |
+| **Phones / Primary Phone Country Code** | `US`         |
+| **Phones / Primary Phone Calling Code** | `+1`         |
+
+### Verknüpfung mit Unternehmen
+
+Fügen Sie eine Spalte mit dem eindeutigen Bezeichner des Unternehmens hinzu:
+
+| Spaltenname     | Format     | Beispiel                               |
+| --------------- | ---------- | -------------------------------------- |
+| `companyDomain` | URL-Format | `https://acme.com`                     |
+| `companyId`     | UUID       | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
+
+<Note>
+**Domain-URL-Format verwenden** (`https://acme.com`), nicht die Bezeichnung. Dies entspricht der Art, wie Unternehmen in Twenty gespeichert werden.
+</Note>
+
+### Beispielhafte CSV-Struktur
+
+```csv
+firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
+John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
+Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
+```
+
+<Note>
+**Profi-Tipp:** Klicken Sie während des Imports auf **Beispieldatei herunterladen** oder exportieren Sie einige vorhandene Personen, um die genauen Spaltennamen zu sehen, die Twenty erwartet.
+</Note>
+
+## Schritt 2: Zugriff auf die Importfunktion
+
+**Option 1: Aus der Personenansicht**
+
+1. Navigieren Sie zu **Personen** in der linken Seitenleiste
+2. Klicken Sie auf das Symbol **⋮** oben rechts
+3. Wählen Sie **Datensätze importieren**
+
+**Option 2: Über das Befehlsmenü**
+
+1. Drücken Sie `Cmd + K` (Mac) oder `Strg + K` (Windows)
+2. Geben Sie "import" ein
+3. Wählen Sie **Datensätze importieren**
+4. Wählen Sie **Personen**
+
+## Schritt 3: Laden Sie Ihre Datei hoch
+
+1. Klicken Sie auf **Datei auswählen**
+2. Wählen Sie Ihre CSV-, XLSX- oder XLS-Datei aus
+3. Warten Sie, bis Twenty Ihre Datei analysiert
+
+## Schritt 4: Ordnen Sie Ihre Spalten zu
+
+Twenty versucht automatisch, Ihre Spalten den Feldern zuzuordnen. Prüfen und anpassen:
+
+1. **Automatische Zuordnungen prüfen** — vergewissern Sie sich, dass sie korrekt sind
+2. **Falsche Zuordnungen korrigieren** — klicken Sie auf das Dropdown, um das richtige Feld auszuwählen
+3. **Spalten überspringen** — wählen Sie **Do not map** für Spalten, die Sie nicht importieren möchten
+
+### Wichtige Zuordnungsregeln
+
+| Spaltentyp           | Zuordnen zu                    | Notizen                                    |
+| -------------------- | ------------------------------ | ------------------------------------------ |
+| Unternehmensreferenz | **Company**-Beziehungsfeld     | Verwenden Sie Domain ODER ID, nicht beides |
+| E-Mail               | **E-Mail**                     | Primäre E-Mail-Adresse                     |
+| Zusätzliche E-Mails  | **Emails / Additional Emails** | Array-Format                               |
+| Telefon              | Getrennte Spalten              | Nummer, Ländercode, Telefonvorwahl         |
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
+
+### Zuordnung der Unternehmensbeziehung
+
+Beim Zuordnen der Unternehmensspalte:
+
+1. Suchen Sie Ihre Unternehmensreferenzspalte (z. B. `companyDomain`)
+2. Ordnen Sie sie dem **Company**-Beziehungsfeld zu
+3. Twenty verknüpft jede Person mit dem passenden Unternehmen
+
+<Warning>
+**Ordnen Sie für Beziehungen nur EINEN eindeutigen Bezeichner zu.**
+
+Ordnen Sie nicht sowohl `companyId` als auch `companyDomain` zu. Wählen Sie eines — vorzugsweise die Domain, da sie menschenlesbar ist.
+</Warning>
+
+## Schritt 5: Werte von Auswahlfeldern zuordnen
+
+Wenn Sie Auswahl- oder Mehrfachauswahlfelder haben (wie z. B. Lead-Quelle):
+
+1. Twenty zeigt Ihre Werte neben den vorhandenen Optionen an
+2. Ordnen Sie jeden Wert in Ihrer Datei einer Twenty-Option zu
+3. Oder erstellen Sie bei Bedarf neue Optionen
+
+<Note>
+Auswahloptionen verwenden **API-Namen**, nicht Anzeigenamen. Prüfen Sie **Einstellungen → Datenmodell** → Aktivieren Sie den **Erweiterten Modus**, um API-Namen zu sehen.
+</Note>
+
+## Schritt 6: Fehler prüfen und beheben
+
+Bevor der Import abgeschlossen wird, validiert Twenty Ihre Daten:
+
+1. Klicken Sie auf **Nächste Schritte**
+2. Zeilen mit Fehlern sind **gelb** hervorgehoben
+3. **Fehler direkt beheben** — klicken Sie auf eine Zelle und bearbeiten Sie den Wert
+4. **Problematische Zeilen entfernen** — klicken Sie auf das X, um die Zeile zu überspringen
+
+### Häufige Fehler beim Kontaktimport
+
+| Fehler                        | Ursache                                              | Lösung                                                               |
+| ----------------------------- | ---------------------------------------------------- | -------------------------------------------------------------------- |
+| **Doppelte E-Mail**           | E-Mail existiert bereits in Twenty oder in der Datei | Duplikat entfernen oder bestehenden Datensatz aktualisieren          |
+| **Ungültiges E-Mail-Format**  | E-Mail-Format ist falsch                             | Auf `name@domain.com` korrigieren                                    |
+| **Relation nicht gefunden**   | Unternehmen existiert nicht                          | Importieren Sie zuerst Unternehmen oder korrigieren Sie die Referenz |
+| **Erforderliches Feld fehlt** | Erforderliches Feld ist leer                         | Wert ausfüllen oder Zeile entfernen                                  |
+
+## Schritt 7: Import abschließen
+
+1. Importzusammenfassung prüfen
+2. Klicken Sie auf **Bestätigen**, um zu importieren
+3. Warten Sie, bis der Import abgeschlossen ist
+4. Überprüfen Sie dies, indem Sie einige Datensätze und deren Unternehmensverknüpfungen kontrollieren
+
+## Nach dem Import von Kontakten
+
+Ihre Kontakte sind jetzt in Twenty! Nächste Schritte:
+
+1. **Unternehmensverknüpfungen überprüfen** — öffnen Sie einige Personen-Datensätze, um zu bestätigen, dass sie mit dem richtigen Unternehmen verknüpft sind
+2. **Verkaufschancen importieren** — verknüpfen Sie sie bei Bedarf mit Personen und Unternehmen
+3. **E-Mail-Synchronisierung einrichten** — verbinden Sie Ihr Postfach, um den E-Mail-Verlauf in Kontaktdatensätzen zu sehen
+
+## Vorhandene Kontakte aktualisieren
+
+So aktualisieren Sie Kontakte, statt neue zu erstellen:
+
+1. Fügen Sie die Spalte `email` oder `id` in Ihrer Datei hinzu
+2. Twenty gleicht Datensätze anhand dieses eindeutigen Bezeichners ab
+3. Vorhandene Kontakte werden aktualisiert; neue werden erstellt
+
+Details finden Sie unter [So aktualisieren Sie vorhandene Datensätze](/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import).
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Warum können zwei Personen nicht dieselbe E-Mail haben?">
+    E-Mail ist ein eindeutiger Bezeichner in Twenty. Das verhindert doppelte Kontakte und stellt sicher, dass die E-Mail-Synchronisierung E-Mails der richtigen Person korrekt zuordnet.
+  </Accordion>
+
+  <Accordion title="Was ist, wenn ich Personen ohne E-Mail habe?">
+    Sie können das E-Mail-Feld leer lassen. Wir empfehlen jedoch, wenn möglich E-Mail-Adressen hinzuzufügen, um die Datenqualität und die E-Mail-Synchronisierung zu verbessern.
+  </Accordion>
+
+  <Accordion title="Wie verknüpfe ich Personen beim Import mit Unternehmen?">
+    Fügen Sie eine Spalte mit der Domain des Unternehmens (z. B. `https://acme.com`) oder der ID hinzu. Verbinden Sie diese Spalte beim Mapping mit dem Unternehmens-Relationsfeld.
+  </Accordion>
+
+  <Accordion title="Was ist, wenn das Unternehmen noch nicht existiert?">
+    Importieren Sie zuerst Unternehmen und dann Personen. Das Unternehmen muss existieren, bevor Sie darauf verweisen können.
+  </Accordion>
+
+  <Accordion title="Kann ich die ID aus meinem vorherigen CRM importieren?">
+    Ja! Erstellen Sie in Ihrem Datenmodell ein benutzerdefiniertes Feld, das als "eindeutig" markiert ist, um die externe ID zu speichern. Hinweis: Der Feldname `id` ist für die interne ID von Twenty reserviert.
+  </Accordion>
+
+  <Accordion title="Wie behebe ich Fehler vom Typ 'Relation nicht gefunden'?">
+    Das Unternehmen, auf das Sie verweisen, existiert nicht. Importieren Sie entweder zuerst das Unternehmen oder prüfen Sie, dass die Domain/ID exakt mit einem vorhandenen Unternehmen übereinstimmt.
+  </Accordion>
+</AccordionGroup>
+
+## Fehlerbehebung
+
+Gibt es Probleme? Prüfen Sie:
+
+* [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors)
+* [So importieren Sie Beziehungen](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+* [Referenz zur Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/import-data-via-api.mdx

@@ -0,0 +1,176 @@
+---
+title: Daten über die API importieren
+description: Wann und wie Sie die APIs von Twenty für groß angelegte Datenimporte verwenden.
+---
+
+## Übersicht
+
+Twenty stellt sowohl **GraphQL**- als auch **REST-APIs** für den programmatischen Datenimport bereit. Verwenden Sie die API, wenn der CSV-Import für Ihr Datenvolumen nicht praktikabel ist oder wenn Sie automatisierte, wiederkehrende Importe benötigen.
+
+## Wann Sie den API-Import verwenden sollten
+
+| Szenario                             | Empfohlene Methode                |
+| ------------------------------------ | --------------------------------- |
+| Unter 10.000 Datensätzen             | CSV-Import                        |
+| 10.000–50.000 Datensätze             | CSV-Import (in Dateien aufteilen) |
+| **Über 50.000 Datensätze**           | **API-Import**                    |
+| Einmalige Migration                  | Beides (je nach Volumen)          |
+| **Wiederkehrende Importe**           | **API-Import**                    |
+| **Echtzeitsynchronisierung**         | **API-Import**                    |
+| **Integration mit anderen Systemen** | **API-Import**                    |
+
+<Note>Für Datensätze im Bereich von Hunderttausenden ist die API deutlich schneller und zuverlässiger als mehrere CSV-Importe.</Note>
+
+## API-Rate-Limits
+
+Twenty setzt Rate-Limits durch, um die Systemstabilität zu gewährleisten:
+
+| Limit                           | Wert                     |
+| ------------------------------- | ------------------------ |
+| **Anfragen pro Minute**         | 100                      |
+| **Datensätze pro Batch-Aufruf** | 60                       |
+| **Maximaler Durchsatz**         | ~6.000 Datensätze/Minute |
+
+<Warning>
+**Planen Sie Ihren Import unter Berücksichtigung dieser Limits.**
+
+Für 100.000 Datensätze bei maximalem Durchsatz rechnen Sie mit etwa 17 Minuten Importzeit. Fügen Sie Pufferzeit für Fehlerbehandlung und Wiederholungen hinzu.
+</Warning>
+
+## Erste Schritte
+
+### Schritt 1: API-Schlüssel abrufen
+
+1. Gehen Sie zu **Einstellungen → Entwickler**
+2. Klicken Sie auf **+ API-Schlüssel erstellen**
+3. Geben Sie Ihrem API-Schlüssel einen aussagekräftigen Namen
+4. Kopieren Sie den API-Schlüssel sofort (er wird nicht erneut angezeigt)
+5. Bewahren Sie ihn sicher auf
+
+<Warning>
+**Halten Sie Ihren API-Schlüssel geheim.**
+
+Jeder, der Ihren API-Schlüssel besitzt, kann auf die Daten Ihres Arbeitsbereichs zugreifen und sie ändern. Checken Sie ihn niemals in Code-Repositories ein und geben Sie ihn nicht öffentlich weiter.
+</Warning>
+
+### Schritt 2: Wählen Sie Ihre API
+
+Twenty unterstützt zwei API-Typen:
+
+| API         | Am besten geeignet für                                           | Dokumentation                               |
+| ----------- | ---------------------------------------------------------------- | ------------------------------------------- |
+| **GraphQL** | Flexible Abfragen, Abruf verknüpfter Daten, komplexe Operationen | [API-Dokumentation](/l/de/developers/extend/api) |
+| **REST**    | Einfache CRUD-Operationen, vertraute REST-Muster                 | [API-Dokumentation](/l/de/developers/extend/api) |
+
+Beide APIs unterstützen:
+
+* Erstellen, Lesen, Aktualisieren und Löschen von Datensätzen
+* **Batch-Operationen** — bis zu 60 Datensätze pro Aufruf erstellen oder aktualisieren
+
+**Verwenden Sie für Importe Batch-Operationen**, um den Durchsatz innerhalb der Rate-Limits zu maximieren.
+
+### Schritt 3: Importreihenfolge planen
+
+Wie bei CSV-Importen ist die **Reihenfolge bei Relationen wichtig**:
+
+1. Zuerst **Unternehmen** (keine Abhängigkeiten)
+2. **Personen** an zweiter Stelle (können mit Unternehmen verknüpft werden)
+3. **Opportunities** an dritter Stelle (können mit Unternehmen und Personen verknüpft werden)
+4. **Aufgaben/Notizen** (können mit allen oben genannten verknüpft werden)
+5. **Benutzerdefinierte Objekte** (gemäß ihren Abhängigkeiten)
+
+## Beste Praktiken
+
+### Anfragen bündeln
+
+* Senden Sie Datensätze nicht einzeln
+* Fassen Sie bis zu **60 Datensätze pro API-Aufruf** zusammen
+* Dies maximiert den Durchsatz innerhalb der Rate-Limits
+
+### Mit Rate-Limits umgehen
+
+* Implementieren Sie Verzögerungen zwischen den Anfragen (mindestens 600 ms für dauerhafte Importe)
+* Verwenden Sie exponentielles Backoff, wenn Sie an Grenzen stoßen
+* Überwachen Sie 429-Antworten (Too Many Requests)
+
+### Daten zuerst validieren
+
+* Bereinigen und validieren Sie Ihre Daten vor dem Import
+* Prüfen Sie, ob Pflichtfelder ausgefüllt sind
+* Überprüfen Sie, ob die Formate den Anforderungen von Twenty entsprechen (siehe [Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping))
+
+### Alles protokollieren
+
+* Protokollieren Sie jeden importierten Datensatz (einschließlich IDs)
+* Protokollieren Sie Fehler mit vollem Kontext
+* Dies hilft bei der Fehleranalyse und der Überprüfung des Abschlusses
+
+### Zuerst testen
+
+* Testen Sie mit einer kleinen Stichprobe (10–20 Datensätze)
+* Überprüfen Sie, ob die Daten in Twenty korrekt angezeigt werden
+* Führen Sie anschließend den vollständigen Import aus
+
+### Upsert verwenden, um Duplikate zu vermeiden
+
+Die GraphQL-API unterstützt **Batch-Upsert** — aktualisieren, wenn der Datensatz existiert, ansonsten erstellen. Dies verhindert Duplikate beim erneuten Ausführen von Importen.
+
+## Objekt- und Feldnamen finden
+
+So sehen Sie verfügbare Objekte und Felder:
+
+1. Gehen Sie zu **Einstellungen → API und Webhooks**
+2. Durchsuchen Sie die **Metadaten-API**
+3. Sehen Sie alle Standard- und benutzerdefinierten Objekte mit ihren Feldern
+
+Die Dokumentation zeigt alle Standard- und benutzerdefinierten Objekte, deren Felder und die erwarteten Datentypen.
+
+## Professionelle Dienstleistungen
+
+Bei komplexen API-Migrationen können unsere Partner helfen:
+
+| Dienst                               | Enthalten                                         |
+| ------------------------------------ | ------------------------------------------------- |
+| **Datenmodell-Design**               | Entwerfen Sie Ihre optimale Datenstruktur         |
+| **Migrationsskripte**                | Schreiben und Ausführen der Importskripte         |
+| **Daten-Transformation**             | Bearbeitung komplexer Zuordnungen und Bereinigung |
+| **Validierung & Qualitätssicherung** | Überprüfen, dass die Migration abgeschlossen ist  |
+
+**Am besten geeignet für:**
+
+* Migrationen mit über 100.000 Datensätzen
+* Komplexe Daten-Transformationen
+* Straffe Zeitpläne
+* Teams ohne Entwicklerressourcen
+
+Kontaktieren Sie uns unter [contact@twenty.com](mailto:contact@twenty.com) oder informieren Sie sich über unsere [Implementierungsservices](/l/de/user-guide/getting-started/capabilities/implementation-services).
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Was ist der Unterschied zwischen GraphQL und REST?">
+    Mit GraphQL können Sie in einer einzelnen Abfrage genau die Daten anfordern, die Sie benötigen, und es eignet sich besser für komplexe Operationen. REST verwendet standardmäßige HTTP-Methoden (GET, POST, PUT, DELETE) und ist möglicherweise vertrauter, wenn Sie mit herkömmlichen APIs gearbeitet haben.
+  </Accordion>
+
+  <Accordion title="Kann ich vorhandene Datensätze über die API aktualisieren?">
+    Ja! Verwenden Sie Update-Mutationen (GraphQL) oder PUT/PATCH-Anfragen (REST) mit der `id` des Datensatzes.
+  </Accordion>
+
+  <Accordion title="Wie gehe ich mit Duplikaten um?">
+    Fragen Sie zunächst nach vorhandenen Datensätzen mit eindeutigen Kennungen (E-Mail, Domain). Aktualisieren, wenn vorhanden; erstellen, wenn nicht.
+  </Accordion>
+
+  <Accordion title="Kann ich Datensätze über die API löschen?">
+    Ja, verwenden Sie Lösch-Mutationen (GraphQL) oder DELETE-Anfragen (REST).
+  </Accordion>
+
+  <Accordion title="Gibt es ein SDK für Python oder Node.js?">
+    Derzeit nicht, aber beide APIs funktionieren mit jedem HTTP-Client in jeder Sprache.
+  </Accordion>
+</AccordionGroup>
+
+## API-Dokumentation
+
+Für vollständige Implementierungsdetails, Codebeispiele und Schema-Referenz:
+
+* [API-Dokumentation](/l/de/developers/extend/api)

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx

@@ -0,0 +1,225 @@
+---
+title: Beziehungen zwischen Objekten per CSV importieren
+description: Vollständige Schritt-für-Schritt-Anleitung zum Verknüpfen von Datensätzen während des CSV-Imports.
+---
+
+## Übersicht
+
+Diese Anleitung führt Sie durch den Import von Beziehungen zwischen Objekten – zum Beispiel das Verknüpfen von Personen mit Unternehmen oder von Opportunities mit Personen.
+
+<Note>**Was kann importiert werden:** Nur Eins-zu-Viele-Beziehungen, die auf einen einzelnen Objekttyp verweisen. Beziehungen, die auf mehrere Objekttypen verweisen (z. B. Notizen, die sowohl mit Personen als auch mit Unternehmen verknüpft sind), werden beim Import noch nicht unterstützt.</Note>
+
+## Beziehungen verstehen
+
+### Was ist eine "Eins-zu-Viele"-Beziehung?
+
+In einer Eins-zu-Viele-Beziehung:
+
+* **Ein** Unternehmen hat **viele** Personen (Mitarbeitende)
+* **Ein** Unternehmen hat **viele** Opportunities
+* **Eine** Person hat **viele** Aufgaben
+
+Die "Eins"-Seite ist die **übergeordnete**. Die "Viele"-Seite ist die **untergeordnete**.
+
+### Häufige Beziehungen in Twenty
+
+| Beziehung                   | "Eins"-Seite (übergeordnet) | "Viele"-Seite (untergeordnet) |
+| --------------------------- | --------------------------- | ----------------------------- |
+| Unternehmen → Personen      | Unternehmen                 | Personen                      |
+| Unternehmen → Opportunities | Unternehmen                 | Opportunities                 |
+| Personen → Aufgaben         | Person                      | Aufgaben                      |
+| Personen → Notizen          | Person                      | Notizen                       |
+
+## Schritt 1: Identifizieren Sie die "Eins"- und "Viele"-Seiten
+
+Bestimmen Sie vor dem Import, welches Objekt übergeordnet und welches untergeordnet ist.
+
+**Fragen Sie sich:** "Hat EIN [Objekt A] VIELE [Objekt B]?"
+
+* Ein Unternehmen → Viele Personen ✓ (Unternehmen ist übergeordnet)
+* Eine Person → Viele Unternehmen ✗ (Das ist falsch – eine Person gehört zu einem Unternehmen)
+
+## Schritt 2: Importieren Sie zuerst die übergeordneten Datensätze
+
+Das übergeordnete Objekt ("Eins"-Seite) muss in Twenty existieren, bevor Sie darauf verweisen können.
+
+**Importreihenfolge:**
+
+1. Zuerst **Unternehmen** (keine Abhängigkeiten)
+2. **Personen** an zweiter Stelle (mit Unternehmen verknüpfen)
+3. **Opportunities** an dritter Stelle (mit Unternehmen und/oder Personen verknüpfen)
+4. **Aufgaben/Notizen** (mit einem der oben genannten verknüpfen)
+
+<Warning>
+**Wenn der übergeordnete Datensatz nicht existiert, schlägt der Import fehl.**
+
+Stellen Sie stets sicher, dass Unternehmen importiert sind, bevor Sie Personen mit Unternehmensreferenzen importieren.
+</Warning>
+
+## Schritt 3: Notieren Sie den eindeutigen Bezeichner des übergeordneten Objekts
+
+Sie müssen auf den übergeordneten Datensatz mit einem eindeutigen Bezeichner verweisen. Verfügbare Optionen:
+
+| Übergeordnetes Objekt          | Verfügbare eindeutige Bezeichner                                                           |
+| ------------------------------ | ------------------------------------------------------------------------------------------ |
+| **Unternehmen**                | `id` (UUID), `domain` (empfohlen) oder ein beliebiges benutzerdefiniertes eindeutiges Feld |
+| **Personen**                   | `id` (UUID), `email` oder ein beliebiges benutzerdefiniertes eindeutiges Feld              |
+| **Arbeitsbereichsmitglieder**  | `id` (UUID), `email` (nicht Name)                                                          |
+| **Benutzerdefinierte Objekte** | `id` (UUID) oder ein beliebiges als eindeutig markiertes Feld                              |
+
+<Note>**Empfehlung:** Verwenden Sie `domain` für Unternehmen und `email` für Personen. Diese sind menschenlesbar und in Ihrer Tabelle leicht zu überprüfen.</Note>
+
+### Den Bezeichner finden
+
+Wenn Sie die `id` benötigen:
+
+1. Exportieren Sie die übergeordneten Datensätze aus Twenty
+2. Der Export enthält die Spalte `id`
+3. Verwenden Sie diese IDs in Ihrer Datei mit untergeordneten Datensätzen
+
+## Schritt 4: Überprüfen Sie, ob das Beziehungsfeld existiert
+
+Stellen Sie vor dem Import sicher, dass das Beziehungsfeld zwischen Ihren Objekten existiert.
+
+**So prüfen oder erstellen Sie es:**
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie Ihr untergeordnetes Objekt aus (z. B. Personen)
+3. Suchen Sie nach einem Beziehungsfeld, das auf das übergeordnete Objekt zeigt (z. B. Unternehmen)
+4. Wenn es nicht existiert, erstellen Sie es:
+   * Klicken Sie auf **+ Feld hinzufügen**
+   * Wählen Sie den Typ **Relation**
+   * Wählen Sie das übergeordnete Objekt
+
+## Schritt 5: Bereiten Sie Ihre CSV-Datei vor
+
+Fügen Sie Ihrer untergeordneten CSV eine Spalte hinzu, die mit dem eindeutigen Bezeichner auf das übergeordnete Objekt verweist.
+
+### Beispiel: Personen, die mit Unternehmen verknüpft werden
+
+**Ihre Personen-CSV:**
+
+```csv
+firstName,lastName,email,jobTitle,companyDomain
+John,Smith,john@acme.com,CEO,https://acme.com
+Jane,Doe,jane@widgets.co,CTO,https://widgets.co
+Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
+```
+
+Die Spalte `companyDomain` verweist auf die Domain des Unternehmens.
+
+### Formatvorgaben
+
+| Kennung | Format          | Beispiel                               |
+| ------- | --------------- | -------------------------------------- |
+| Domäne  | URL-Format      | `https://acme.com`                     |
+| E-Mail  | Standard-E-Mail | `john@acme.com`                        |
+| ID      | UUID            | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
+
+<Warning>
+**Das Domain-Format ist wichtig!**
+
+Verwenden Sie `https://domain.com` (nicht nur `domain.com`). Dies entspricht der Art, wie Twenty Unternehmensdomains speichert, und verhindert Zuordnungsfehler.
+</Warning>
+
+### Wichtige Regeln
+
+1. **Exakte Übereinstimmung erforderlich** — der Wert muss exakt dem übergeordneten Datensatz entsprechen
+2. **Nur EINEN eindeutigen Bezeichner zuordnen** — geben Sie nicht sowohl `companyId` als auch `companyDomain` an
+3. **Groß-/Kleinschreibung beachten** — `Acme.com` ≠ `acme.com`
+
+## Schritt 6: Beziehung hochladen und zuordnen
+
+1. Navigieren Sie zum untergeordneten Objekt (z. B. Personen)
+2. Klicken Sie auf **⋮** → **Datensätze importieren**
+3. Laden Sie Ihre CSV-Datei hoch
+4. Im Schritt zur Feldzuordnung:
+   * Suchen Sie Ihre Beziehungsspalte (z. B. `companyDomain`)
+   * Ordnen Sie sie dem **Company**-Beziehungsfeld zu
+5. Schließen Sie die übrige Zuordnung ab
+6. Prüfen Sie Fehler und bestätigen Sie
+
+Twenty verknüpft automatisch jeden untergeordneten Datensatz mit dem passenden übergeordneten Datensatz.
+
+## Schritt 7: Überprüfen Sie den Import
+
+Nach dem Import:
+
+1. Öffnen Sie einige untergeordnete Datensätze (z. B. Personen)
+2. Überprüfen Sie, ob das Beziehungsfeld das richtige übergeordnete Objekt anzeigt (z. B. Unternehmen)
+3. Öffnen Sie einen übergeordneten Datensatz und prüfen Sie den Bereich mit den zugehörigen Datensätzen
+
+## Häufige Fehler, die Sie vermeiden sollten
+
+| Fehler                                     | Problem                                                   | Lösung                                                                           |
+| ------------------------------------------ | --------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| **Falsche Importreihenfolge**              | Personen vor Unternehmen importieren                      | Importieren Sie immer zuerst übergeordnete, dann untergeordnete Datensätze       |
+| **Falsches Domain-Format**                 | Verwendung von `acme.com` statt `https://acme.com`        | Verwenden Sie das vollständige URL-Format mit `https://`                         |
+| **Mehrere eindeutige Felder**              | Zuordnung sowohl von `companyId` als auch `companyDomain` | Ordnen Sie nur EINEN eindeutigen Bezeichner zu                                   |
+| **Beziehungsfeld fehlt**                   | Das Beziehungsfeld existiert nicht im Datenmodell         | Erstellen Sie es vor dem Import unter **Einstellungen → Datenmodell**            |
+| **Nicht vorhandene Datensätze**            | Der übergeordnete Datensatz existiert in Twenty nicht     | Importieren Sie zunächst übergeordnete Datensätze oder prüfen Sie auf Tippfehler |
+| **Unterschiedliche Groß-/Kleinschreibung** | `Acme.com` in der Datei, aber `acme.com` in Twenty        | Achten Sie auf exakt übereinstimmende Groß-/Kleinschreibung                      |
+
+## Verknüpfen mit Teammitgliedern
+
+Beim Verknüpfen mit Teammitgliedern (Ihrem Team):
+
+* Verwenden Sie ihre **E-Mail-Adresse**, nicht ihren Namen
+* Beispiel: `owner@yourcompany.com`, nicht "John Smith"
+
+```csv
+taskName,assignedTo
+Follow up with client,john@yourcompany.com
+Review proposal,jane@yourcompany.com
+```
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Was ist, wenn mein übergeordneter Datensatz keine Domain oder E-Mail hat?">
+    Sie haben zwei Optionen:
+    1. Verwenden Sie die Twenty-`id` (exportieren Sie übergeordnete Datensätze, um ihre IDs zu erhalten)
+    2. Erstellen Sie ein benutzerdefiniertes eindeutiges Feld in Ihrem Datenmodell, um eine externe ID aus Ihrem vorherigen System zu speichern
+  </Accordion>
+
+  <Accordion title="Kann ich Beziehungen bei bestehenden Datensätzen aktualisieren?">
+    Ja! Geben Sie den eindeutigen Bezeichner des untergeordneten Datensatzes (z. B. `email` für Personen) und den neuen Beziehungswert an. Beim Import wird die Beziehung aktualisiert.
+  </Accordion>
+
+  <Accordion title="Kann ich Viele-zu-Viele-Beziehungen importieren?">
+    Viele-zu-Viele-Beziehungen werden beim Import noch nicht unterstützt. Dies ist für H1 2026 geplant.
+  </Accordion>
+
+  <Accordion title="Kann ich mit mehreren Objekttypen verknüpfen (z. B. Notizen mit Personen UND Unternehmen)?">
+    Beziehungen, die auf mehrere Objekttypen zeigen, werden für Import/Export noch nicht unterstützt. Dies steht auf unserer Roadmap.
+  </Accordion>
+
+  <Accordion title="Was passiert, wenn ein übergeordneter Datensatz nicht existiert?">
+    Der Import zeigt für diese Zeile einen Fehler an. Sie können entweder:
+    * Importieren Sie zuerst den übergeordneten Datensatz und importieren Sie dann erneut
+    * Korrigieren Sie den Referenzwert
+    * Entfernen Sie die Zeile aus dem Import
+  </Accordion>
+
+  <Accordion title="Warum wird meine Beziehung nicht korrekt verknüpft?">
+    Häufige Ursachen:
+    * Falsches Format (verwenden Sie für Domains `https://domain.com`)
+    * Abweichende Groß-/Kleinschreibung (prüfen Sie die exakte Schreibweise)
+    * Übergeordneter Datensatz existiert nicht (zuerst übergeordnete Datensätze importieren)
+    * Zuordnung mehrerer Bezeichner (verwenden Sie nur einen)
+  </Accordion>
+</AccordionGroup>
+
+<Warning>
+**Denken Sie daran: soft gelöschte Datensätze zählen für die Eindeutigkeit.**
+
+Wenn Sie "not found"-Fehler erhalten, der Datensatz aber zu existieren scheint, prüfen Sie im Befehlsmenü → Gelöschte Datensätze anzeigen. Der übergeordnete Datensatz wurde möglicherweise soft gelöscht.
+</Warning>
+
+## Fehlerbehebung
+
+Gibt es Probleme? Prüfen Sie:
+
+* [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors)
+* [Funktionen zum Import von Beziehungen](/l/de/user-guide/data-migration/capabilities/import-relations)
+* [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx

@@ -0,0 +1,289 @@
+---
+title: Migration von anderen CRMs
+description: Schritt-für-Schritt-Anleitung zur Migration Ihrer Daten von jedem CRM zu Twenty.
+---
+
+## Übersicht
+
+Diese Anleitung führt Sie durch die Migration Ihrer Daten von jedem CRM zu Twenty. Der Prozess umfasst die Überprüfung Ihrer Daten, die Vorbereitung Ihres Twenty-Arbeitsbereichs, den Export aus Ihrem aktuellen System und den Import in Twenty.
+
+<Note>Ansichten, Workflows und Berechtigungen müssen nach der Migration manuell neu erstellt werden. Planen Sie Zeit für diese Konfigurationsarbeiten ein.</Note>
+
+## Schritt 1: Überprüfen Sie Ihre aktuellen Daten
+
+Eine Migration ist eine Chance für einen Neuanfang. Übernehmen Sie keinen Ballast.
+
+**Was Sie behalten sollten:**
+
+* Aktive Kontakte und Unternehmen
+* Offene Opportunities und Deals
+* Wichtige Notizen und Aktivitäten
+* Benutzerdefinierte Felder, die Sie tatsächlich verwenden
+
+**Was Sie zurücklassen sollten:**
+
+* Veraltete Kontakte (keine Aktivität seit über 2 Jahren)
+* Doppelte Datensätze
+* Testdaten
+* Nicht verwendete benutzerdefinierte Felder
+
+## Schritt 2: Ihr Datenmodell abbilden
+
+Erstellen Sie ein Zuordnungsdokument zwischen Ihrem aktuellen CRM und Twenty:
+
+| Ihr CRM                    | Twenty                         |
+| -------------------------- | ------------------------------ |
+| Konto / Organisation       | **Unternehmen**                |
+| Kontakt / Person           | **Personen**                   |
+| Deal / Opportunity         | **Opportunity**                |
+| Aktivität                  | **Aufgabe** oder **Notiz**     |
+| Benutzerdefiniertes Objekt | **Benutzerdefiniertes Objekt** |
+
+**Dokumentieren Sie für jedes Feld:**
+
+* Name des Quellfelds
+* Das Zielfeld in Twenty
+* Erforderliche Formatumwandlungen (Datumsangaben, Telefonnummern usw.)
+
+<Note>Halten Sie dieses Mapping-Dokument während des Imports griffbereit — Sie werden darauf verweisen, wenn Sie Spalten zuordnen.</Note>
+
+## Schritt 3: Richten Sie Ihren Twenty-Arbeitsbereich ein
+
+Bereiten Sie Ihren Twenty-Arbeitsbereich vor, bevor Sie Daten importieren:
+
+### Benutzerdefinierte Objekte und Felder erstellen
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Erstellen Sie alle benötigten benutzerdefinierten Objekte
+3. Fügen Sie Standard- und benutzerdefinierten Objekten benutzerdefinierte Felder hinzu
+4. Konfigurieren Sie die Feldeinstellungen (eindeutig, erforderlich, Auswahloptionen usw.)
+
+<Warning>
+**Felder müssen vor dem Import vorhanden sein.**
+
+Der CSV-Import erstellt Datensätze, nicht Felder. Erstellen Sie alle benutzerdefinierten Felder vor dem Import unter Einstellungen → Datenmodell.
+</Warning>
+
+### Laden Sie Ihr Team ein
+
+<Warning>
+**Laden Sie Benutzer ein, BEVOR Sie Daten importieren.**
+
+Wenn Ihre Daten Benutzerreferenzen enthalten (Account Owner, Assignee usw.), müssen diese Benutzer vor dem Import in Twenty existieren. Andernfalls können diese Beziehungen nicht zugeordnet werden.
+</Warning>
+
+1. Gehen Sie zu **Einstellungen → Mitglieder**
+2. Laden Sie alle Teammitglieder ein
+3. **Warten Sie, bis alle** ihre Einladung angenommen haben
+4. Überprüfen Sie, ob alle Benutzer in Ihrer Mitgliederliste erscheinen
+
+## Schritt 4: Export aus Ihrem aktuellen CRM
+
+Exportieren Sie Ihre Daten aus Ihrem aktuellen CRM:
+
+1. Suchen Sie nach einer **Export**-Funktion (in der Regel unter Einstellungen, Datenverwaltung oder Admin)
+2. Exportieren Sie nach Möglichkeit im **CSV-Format**
+3. Exportieren Sie jeden Objekttyp separat (Unternehmen, Kontakte, Deals usw.)
+4. Schließen Sie alle Felder ein, die Sie migrieren möchten
+
+**Exportieren Sie diese Objekte (zur Referenz in dieser Reihenfolge):**
+
+1. Unternehmen / Konten / Organisationen
+2. Kontakte / Personen
+3. Deals / Opportunities
+4. Notizen und Aktivitäten
+5. Benutzerdefinierte Objekte
+
+## Schritt 5: Daten bereinigen und formatieren
+
+Öffnen Sie jede exportierte CSV in einer Tabellenkalkulationsanwendung und bereiten Sie sie für Twenty vor.
+
+### Duplikate entfernen
+
+1. Sortieren Sie nach dem eindeutigen Feld (E-Mail für Personen, Domain für Unternehmen)
+2. Doppelte Zeilen entfernen oder zusammenführen
+3. Überprüfen Sie, dass in Twenty keine Duplikate vorhanden sind
+
+### Felder korrekt formatieren
+
+| Feldtyp           | Erforderliches Format                            |
+| ----------------- | ------------------------------------------------ |
+| **Domain**        | `https://domain.com`                             |
+| **E-Mail**        | `name@domain.com` (muss eindeutig sein)          |
+| **Datum**         | `YYYY-MM-DD`                                     |
+| **Telefon**       | Drei Spalten: Nummer, Ländercode, Telefonvorwahl |
+| **Boolesch**      | `TRUE` oder `FALSE` (in Großbuchstaben)          |
+| **Auswahlfelder** | Verwenden Sie API-Namen, nicht Anzeigenamen      |
+
+<Warning>
+**Das Domain-Format ist entscheidend.**
+
+Verwenden Sie `https://domain.com` (nicht `domain.com` oder `www.domain.com`). Dies entspricht dem Format von Twenty und verhindert Duplikate, wenn Sie die E-Mail-/Kalendersynchronisierung verbinden.
+</Warning>
+
+Siehe [So bereiten Sie Ihre CSV-Dateien vor](/l/de/user-guide/data-migration/how-tos/prepare-your-csv-files) für vollständige Formatierungsanforderungen für alle Feldtypen.
+
+### Beziehungsspalten hinzufügen
+
+Um Datensätze zu verknüpfen (z. B. Personen mit Unternehmen), fügen Sie eine Spalte mit dem eindeutigen Bezeichner des übergeordneten Elements hinzu.
+
+**Beispiel: People-CSV mit Unternehmensverknüpfung**
+
+```csv
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+Siehe [So importieren Sie Beziehungen](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) für detaillierte Anweisungen zum Verknüpfen von Datensätzen.
+
+### Benutzerreferenzen aktualisieren
+
+Wenn Ihre Daten Benutzerzuweisungen enthalten (Eigentümer, Zuständiger):
+
+1. Fügen Sie eine Spalte mit der **E-Mail des Benutzers** hinzu (nicht nur dessen ID aus dem Altsystem)
+2. Verwenden Sie dieselben E-Mail-Adressen, mit denen die Benutzer Ihrem Twenty-Arbeitsbereich beigetreten sind
+
+Siehe [So bereiten Sie Ihre CSV-Dateien vor](/l/de/user-guide/data-migration/how-tos/prepare-your-csv-files) für den vollständigen Formatierungsleitfaden.
+
+## Schritt 6: In Twenty importieren
+
+<Warning>
+**Die Importreihenfolge ist wichtig!**
+
+Importieren Sie immer in dieser Reihenfolge:
+1. Zuerst **Unternehmen** (keine Abhängigkeiten)
+2. **Personen** an zweiter Stelle (mit Unternehmen verknüpfen)
+3. **Opportunities** an dritter Stelle (mit Unternehmen/Personen verknüpfen)
+4. **Notizen und Aufgaben** (mit Datensätzen verknüpfen)
+5. **Benutzerdefinierte Objekte** entsprechend ihren Abhängigkeiten
+
+Der übergeordnete Datensatz muss existieren, bevor Sie darauf verweisen können.
+</Warning>
+
+### Jedes Objekt importieren
+
+Führen Sie Folgendes der Reihe nach für jede CSV-Datei aus:
+
+1. Navigieren Sie zum Objekt in Twenty
+2. Klicken Sie auf **⋮ → Datensätze importieren**
+3. Laden Sie die CSV-Datei hoch
+4. Ordnen Sie die Spalten den Feldern zu:
+   * Ordnen Sie die E-Mail-Spalten der Benutzer den entsprechenden Beziehungsfeldern zu
+   * Ordnen Sie Beziehungsspalten (wie `companyDomain`) den Beziehungsfeldern zu
+5. Überprüfen und beheben Sie eventuelle Fehler in der Benutzeroberfläche
+6. Bestätigen Sie den Import
+7. Überprüfen Sie einige Datensätze, bevor Sie mit der nächsten Datei fortfahren
+
+**Detaillierte Anleitungen:**
+
+* [So importieren Sie Unternehmen](/l/de/user-guide/data-migration/how-tos/import-companies-via-csv)
+* [So importieren Sie Kontakte](/l/de/user-guide/data-migration/how-tos/import-contacts-via-csv)
+* [So importieren Sie Beziehungen](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+
+## Schritt 7: Große Migrationen (50.000+ Datensätze)
+
+Für große Migrationen:
+
+| Datenmenge               | Empfohlener Ansatz               |
+| ------------------------ | -------------------------------- |
+| Unter 10.000 Datensätzen | Einzelner CSV-Import             |
+| 10.000–50.000 Datensätze | In mehrere CSV-Dateien aufteilen |
+| Über 50.000 Datensätze   | Verwenden Sie die API            |
+
+**Für API-Importe:**
+
+* Schneller und zuverlässiger für große Datensätze
+* Unterstützt Batch-Operationen (bis zu 60 Datensätze pro Aufruf)
+* Siehe [So importieren Sie Daten über die API](/l/de/user-guide/data-migration/how-tos/import-data-via-api)
+
+## Schritt 8: Einrichtung nach der Migration
+
+Schließen Sie nach dem Import der Daten die Konfiguration Ihres Arbeitsbereichs ab:
+
+### Ansichten neu erstellen
+
+* Richten Sie gespeicherte Ansichten mit Filtern, Sortierungen und Spaltenkonfigurationen ein
+* Erstellen Sie alle benötigten Kanban- oder Kalenderansichten
+
+### Workflows neu erstellen
+
+* Erstellen Sie Ihre Automatisierungen in **Einstellungen → Workflows** neu
+* Beginnen Sie mit den kritischsten Workflows
+* Testen Sie jeden Workflow, bevor Sie sich darauf verlassen
+
+### Rollen und Berechtigungen konfigurieren
+
+* Richten Sie Rollen unter **Einstellungen → Mitglieder → Rollen** ein
+* Weisen Sie Benutzer den entsprechenden Rollen zu
+
+### E-Mail und Kalender verbinden
+
+* Jeder Benutzer verbindet sein eigenes Konto unter **Einstellungen → Konten**
+* Twenty beginnt, E-Mails mit Kontaktdatensätzen zu synchronisieren
+* Siehe [E-Mail & Kalender](/l/de/user-guide/calendar-emails/overview)
+
+### Schulen Sie Ihr Team
+
+* Gehen Sie die neue Oberfläche gemeinsam durch
+* Dokumentieren Sie alle teamspezifischen Prozesse
+
+## Häufige Probleme und Lösungen
+
+| Problem                       | Ursache                                  | Lösung                                                                                                                             |
+| ----------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| **Duplikatfehler**            | E-Mail/Domain existiert bereits          | Entfernen Sie Duplikate aus der Datei oder fügen Sie einen eindeutigen Bezeichner hinzu, um vorhandene Datensätze zu aktualisieren |
+| **Beziehung nicht gefunden**  | Übergeordneter Datensatz existiert nicht | Importieren Sie zuerst übergeordnete Objekte (Unternehmen vor Personen)                                                            |
+| **Fehlende Felder**           | Benutzerdefiniertes Feld existiert nicht | Erstellen Sie das Feld vor dem Import unter Einstellungen → Datenmodell                                                            |
+| **Fehler bei Auswahlfeldern** | Verwendung von Anzeigenamen              | Verwenden Sie API-Namen (aktivieren Sie den erweiterten Modus in den Einstellungen, um sie zu finden)                              |
+| **Benutzerbeziehung leer**    | Benutzer hat Einladung nicht angenommen  | Stellen Sie sicher, dass alle Benutzer ihre Einladungen annehmen, bevor Sie Daten importieren                                      |
+
+Siehe [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors) für detaillierte Schritte zur Fehlerbehebung.
+
+## Checkliste nach der Migration
+
+### Datenintegrität
+
+<Check>Alle Datensätze importiert (Anzahlen mit Quellsystem vergleichen)</Check>
+<Check>Beziehungen funktionieren korrekt (Personen mit Unternehmen verknüpft)</Check>
+<Check>Benutzerzuweisungen korrekt zugeordnet (Eigentümer, Zuständiger)</Check>
+<Check>Benutzerdefinierte Felder befüllt</Check>
+<Check>Keine unerwarteten Duplikate</Check>
+
+### Konfiguration
+
+<Check>Ansichten neu erstellt</Check>
+<Check>Workflows neu erstellt und getestet</Check>
+<Check>Rollen und Berechtigungen konfiguriert</Check>
+<Check>E-Mail-/Kalendersynchronisierung verbunden</Check>
+
+### Bereitschaft des Teams
+
+<Check>Team für neues System geschult</Check>
+<Check>Zugriffsplan für altes CRM entschieden (zur Referenz behalten? Wann deaktivieren?)</Check>
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Kann ich Workflows automatisch migrieren?">
+    Derzeit nicht. Workflows müssen in Twenty manuell neu erstellt werden.
+  </Accordion>
+
+  <Accordion title="Was ist mit Dateianhängen?">
+    Dateianhänge sind in CSV-Exporten nicht enthalten. Sie müssen sie manuell erneut hochladen, über die API migrieren oder unser Team für Unterstützung kontaktieren.
+  </Accordion>
+
+  <Accordion title="Kann ich während der Migration beide Systeme weiter betreiben?">
+    Ja, wir empfehlen, Ihr altes CRM weiter zu betreiben, bis Sie überprüft haben, dass die Migration abgeschlossen ist. Achten Sie einfach darauf, nicht an beiden Orten neue Daten zu erstellen.
+  </Accordion>
+
+  <Accordion title="Wie lange dauert die Migration normalerweise?">
+    Das hängt von der Datenmenge und der Komplexität ab. Kleine Migrationen (unter 10.000 Datensätzen) können in wenigen Stunden durchgeführt werden. Große Migrationen können mehrere Tage dauern, einschließlich Datenbereinigung und Tests.
+  </Accordion>
+</AccordionGroup>
+
+## Brauchen Sie Hilfe?
+
+<Tip>
+  Möchten Sie Hilfe bei Ihrer Migration? [Finde einen zertifizierten Zwanzig Partner](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-migrate-crm), um deine Daten, Pipelines und Benutzer end-to-end zu bewegen.
+</Tip>

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx

@@ -0,0 +1,173 @@
+---
+title: Migration von Selbstgehostet zu Cloud
+description: Schritt-für-Schritt-Anleitung zur Migration Ihrer selbstgehosteten Twenty-Instanz zu Twenty Cloud.
+---
+
+## Übersicht
+
+Diese Anleitung führt Sie durch die Migration Ihrer Daten von einer selbstgehosteten Twenty-Instanz zu Twenty Cloud. Der Prozess umfasst das Einrichten Ihres Cloud-Arbeitsbereichs, das Exportieren Ihrer Daten und deren erneutes Importieren.
+
+<Note>Ansichten, Workflows und Rollen müssen nach der Migration manuell neu erstellt werden. Planen Sie Zeit für diese Konfigurationsarbeiten ein.</Note>
+
+## Schritt 1: Erstellen Sie Ihren Cloud-Arbeitsbereich
+
+1. Gehen Sie zu [app.twenty.com](https://app.twenty.com) und erstellen Sie einen neuen Arbeitsbereich
+2. Schließen Sie den Einrichtungsassistenten ab
+3. Notieren Sie sich die URL Ihres neuen Arbeitsbereichs
+
+## Schritt 2: Datenmodell neu erstellen
+
+Erstellen Sie vor dem Import der Daten Ihre benutzerdefinierten Objekte und Felder neu:
+
+1. Gehen Sie in Ihrer Cloud-Instanz zu **Einstellungen → Datenmodell**
+2. Erstellen Sie benutzerdefinierte Objekte, die Ihrer selbstgehosteten Konfiguration entsprechen
+3. Fügen Sie Standard- und benutzerdefinierten Objekten benutzerdefinierte Felder hinzu
+4. Konfigurieren Sie die Feldeinstellungen (eindeutig, erforderlich usw.)
+
+<Note>Machen Sie Screenshots Ihres selbstgehosteten Datenmodells als Referenz oder halten Sie beide Instanzen nebeneinander geöffnet.</Note>
+
+## Schritt 3: Alle Benutzer einladen
+
+<Warning>
+**Wichtig: Laden Sie Benutzer ein, BEVOR Sie Daten importieren.**
+
+Benutzer müssen ihre Einladungen annehmen, bevor Sie Datensätze importieren, die auf sie verweisen (z. B. das Feld 'Account Owner'). Wenn Benutzer noch nicht vorhanden sind, können diese Beziehungen nicht zugeordnet werden.
+</Warning>
+
+1. Gehen Sie in Ihrer Cloud-Instanz zu **Einstellungen → Mitglieder**
+2. Laden Sie alle Teammitglieder ein, die in der selbstgehosteten Instanz Konten hatten
+3. **Warten Sie, bis alle** ihre Einladung angenommen haben
+4. Überprüfen Sie, ob alle Benutzer in Ihrer Mitgliederliste erscheinen
+
+## Schritt 4: Daten aus der selbstgehosteten Instanz exportieren
+
+Exportieren Sie jedes Objekt aus Ihrer selbstgehosteten Instanz:
+
+1. Navigieren Sie zu jedem Objekt (Unternehmen, Personen, Opportunities usw.)
+2. Konfigurieren Sie die Ansicht so, dass **alle Spalten** angezeigt werden, die Sie migrieren möchten
+3. Klicken Sie auf **⋮ → Ansicht exportieren**
+4. Speichern Sie jede CSV-Datei mit einem eindeutigen Namen (z. B. `companies-export.csv`)
+
+**Exportieren Sie in dieser Reihenfolge** (als Referenz für den Import):
+
+1. Unternehmen
+2. Personen
+3. Opportunities
+4. Benutzerdefinierte Objekte (entsprechend ihren Abhängigkeiten)
+5. Aufgaben, Notizen
+
+## Schritt 5: Verweise auf Arbeitsbereichsmitglieder aktualisieren
+
+Die exportierten CSVs enthalten Benutzer-IDs aus Ihrer selbstgehosteten Instanz. Diese IDs stimmen nicht mit Ihrer Cloud-Instanz überein, daher müssen Sie sie durch E-Mail-Adressen ersetzen.
+
+**Für jede CSV-Datei mit Benutzerverweisen (Owner, Assignee usw.):**
+
+1. Öffnen Sie die CSV-Datei in einem Tabellenkalkulationsprogramm
+2. Fügen Sie neben jeder Benutzer-ID-Spalte eine neue Spalte hinzu (z. B. `accountOwnerEmail` neben `accountOwnerId`)
+3. Tragen Sie die **E-Mail-Adresse** jedes Benutzers ein
+4. Sie können die alte ID-Spalte löschen oder belassen (sie wird beim Import übersprungen)
+
+**Beispiel:**
+
+Vor:
+
+```csv
+name,domain,accountOwnerId
+Acme Corp,https://acme.com,old-uuid-123
+```
+
+Nach:
+
+```csv
+name,domain,accountOwnerEmail
+Acme Corp,https://acme.com,john@yourcompany.com
+```
+
+<Note>Verwenden Sie dieselben E-Mail-Adressen, mit denen die Benutzer die Einladung zu Ihrem Cloud-Arbeitsbereich angenommen haben.</Note>
+
+## Schritt 6: Importreihenfolge planen
+
+Importieren Sie die Dateien in der richtigen Reihenfolge, um Beziehungen beizubehalten:
+
+1. Zuerst **Unternehmen** (keine Abhängigkeiten)
+2. **Personen** an zweiter Stelle (mit Unternehmen verknüpft)
+3. **Opportunities** an dritter Stelle (mit Unternehmen und Personen verknüpft)
+4. **Benutzerdefinierte Objekte** (entsprechend ihren Abhängigkeiten)
+5. Zuletzt **Aufgaben und Notizen** (mit anderen Datensätzen verknüpft)
+
+Siehe [So importieren Sie Beziehungen](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) für Details zum Beibehalten von Beziehungen.
+
+## Schritt 7: In die Cloud importieren
+
+Führen Sie Folgendes der Reihe nach für jede CSV-Datei aus:
+
+1. Navigieren Sie in Ihrer Cloud-Instanz zum Objekt
+2. Klicken Sie auf **⋮ → Datensätze importieren**
+3. Laden Sie die CSV-Datei hoch
+4. Ordnen Sie die Spalten den Feldern zu:
+   * Ordnen Sie die E-Mail-Spalten der Benutzer den entsprechenden Beziehungsfeldern zu
+   * Ordnen Sie andere Spalten wie üblich zu
+5. Überprüfen und beheben Sie eventuelle Fehler
+6. Bestätigen Sie den Import
+7. Überprüfen Sie einige Datensätze, bevor Sie mit der nächsten Datei fortfahren
+
+## Schritt 8: Konfiguration neu erstellen
+
+Erstellen Sie nach dem Import der Daten manuell neu:
+
+### Ansichten
+
+* Erstellen Sie gespeicherte Ansichten mit Filtern, Sortierungen und Spaltenkonfigurationen neu
+* Richten Sie ggf. Kanban- oder Kalenderansichten ein
+
+### Workflows
+
+* Erstellen Sie Automatisierungen in **Einstellungen → Workflows** neu
+* Testen Sie jeden Workflow, bevor Sie sich darauf verlassen
+
+### Rollen und Berechtigungen
+
+* Richten Sie Rollen unter **Einstellungen → Mitglieder → Rollen** ein
+* Weisen Sie Benutzer den entsprechenden Rollen zu
+
+### Integrationen
+
+* Stellen Sie für jeden Benutzer die E-Mail- und Kalendersynchronisierung wieder her
+* Konfigurieren Sie alle API-Integrationen mit neuen API-Schlüsseln neu
+
+## Checkliste nach der Migration
+
+<Check>Alle Daten erfolgreich importiert</Check>
+<Check>Beziehungen zwischen Objekten funktionieren korrekt</Check>
+<Check>Benutzerzuweisungen (Owner, Assignee) korrekt zugeordnet</Check>
+<Check>Ansichten neu erstellt</Check>
+<Check>Workflows neu erstellt und getestet</Check>
+<Check>Rollen und Berechtigungen konfiguriert</Check>
+<Check>E-Mail-/Kalendersynchronisierung wiederhergestellt</Check>
+<Check>API-Integrationen mit neuen Schlüsseln aktualisiert</Check>
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Kann ich Workflows automatisch migrieren?">
+    Derzeit nicht. Workflows müssen in Ihrer Cloud-Instanz manuell neu erstellt werden.
+  </Accordion>
+
+  <Accordion title="Was ist mit Dateianhängen und Bildern?">
+    Dateianhänge sind in CSV-Exporten nicht enthalten. Sie müssen Anhänge manuell erneut hochladen, sie über die API migrieren oder unser Team für Unterstützung bei großen Migrationen kontaktieren.
+  </Accordion>
+
+  <Accordion title="Kann ich während der Migration beide Instanzen weiter betreiben?">
+    Ja, wir empfehlen, Ihre selbstgehostete Instanz weiter auszuführen, bis Sie überprüft haben, dass die Cloud-Migration abgeschlossen ist. Achten Sie darauf, nicht an beiden Orten neue Daten zu erstellen.
+  </Accordion>
+
+  <Accordion title="Was ist, wenn ein Benutzer seine Einladung noch nicht angenommen hat?">
+    Datensätze, die sich auf diesen Benutzer beziehen, werden nicht importiert oder die Beziehung bleibt leer. Stellen Sie sicher, dass alle Benutzer ihre Einladungen annehmen, bevor Sie Daten importieren.
+  </Accordion>
+</AccordionGroup>
+
+## Brauchen Sie Hilfe?
+
+<Tip>
+  Migrieren Sie einen großen oder komplexen Workspace? [Holen Sie sich einen zertifizierten Twenty-Partner](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-migrate-cloud), der den Umzug Ende-zu-Ende übernimmt. *(Oder binden Sie unser Team ein: [contact@twenty.com](mailto:contact@twenty.com).)*
+</Tip>

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx

@@ -0,0 +1,267 @@
+---
+title: CSV-Dateien vorbereiten
+description: Vollständige Schritt-für-Schritt-Anleitung zum Formatieren deiner Daten für den Import in Twenty.
+---
+
+## Übersicht
+
+Diese Anleitung führt dich durch die Vorbereitung deiner CSV-Datei für einen erfolgreichen Import. Befolge diese Schritte, um Fehler zu vermeiden.
+
+## Schritt 1: Dateianforderungen prüfen
+
+Bevor du beginnst, stelle sicher, dass deine Datei diese Anforderungen erfüllt:
+
+| Anforderung            | Details                     |
+| ---------------------- | --------------------------- |
+| **Format**             | CSV, XLSX oder XLS          |
+| **Größenbeschränkung** | 10.000 Datensätze pro Datei |
+| **Zeichenkodierung**   | UTF-8 empfohlen             |
+| **Struktur**           | Ein Objekttyp pro Datei     |
+
+<Note>Für Datenmengen mit mehr als 10.000 Datensätzen teile die Daten in mehrere Dateien auf oder verwende den [API-Import](/l/de/user-guide/data-migration/how-tos/import-data-via-api).</Note>
+
+## Schritt 2: Beispieldatei herunterladen
+
+**Dies ist der wichtigste Schritt.** Die Beispieldatei zeigt dir die exakten Spaltennamen und das Format, das Twenty erwartet.
+
+1. Wechsle zur Objektansicht (Personen, Unternehmen usw.)
+2. Klicke auf **⋮** → **Datensätze importieren**
+3. Klicke auf **Beispieldatei herunterladen**
+4. Verwende diese Datei als Vorlage
+
+<Note>**Profi-Tipp:** Exportiere stattdessen einige vorhandene Datensätze. So erhältst du reale Beispiele dafür, wie Daten formatiert sein sollten, und die Spaltennamen werden beim Import automatisch zugeordnet.</Note>
+
+## Schritt 3: Doppelte Werte entfernen
+
+Twenty erzwingt die Eindeutigkeit bestimmter Felder. Duplikate führen zu Importfehlern.
+
+| Objekt                         | Eindeutige Felder                                         |
+| ------------------------------ | --------------------------------------------------------- |
+| **Personen**                   | `id`, `email`                                             |
+| **Unternehmen**                | `id`, `domain`                                            |
+| **Benutzerdefinierte Objekte** | `id`, plus jedes Feld, das du als eindeutig markiert hast |
+
+**Vor dem Import:**
+
+1. Sortiere deine Tabelle nach dem eindeutigen Feld (E-Mail oder Domain)
+2. Entferne oder führe doppelte Zeilen zusammen
+3. Prüfe auf Duplikate, die in Twenty bereits existieren
+
+<Warning>**Softgelöschte Datensätze zählen für die Eindeutigkeit.** Datensätze unter Befehlsmenü → Gelöschte Datensätze anzeigen führen zu Duplikatfehlern. Lösche sie dauerhaft oder stelle sie wieder her und aktualisiere sie.</Warning>
+
+## Schritt 4: Jeden Feldtyp korrekt formatieren
+
+Verschiedene Feldtypen erfordern spezifische Formate. Hier ist die vollständige Übersicht:
+
+### Textfelder
+
+* Keine spezielle Formatierung erforderlich
+* Führende und nachgestellte Leerzeichen werden automatisch entfernt
+
+### E-Mail-Felder
+
+* Muss ein gültiges E-Mail-Format haben: `name@domain.com`
+* Muss eindeutig sein (keine Duplikate in der Datei oder in Twenty)
+* Für zusätzliche E-Mails verwende dieses Format in der Spalte **Emails / Additional Emails**:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Domain-Felder
+
+* **Empfohlenes Format**: `https://domain.com`
+* Dies entspricht dem Format der Postfach-/Kalendersynchronisierung (verhindert Duplikate)
+* Beide Spalten ausfüllen:
+  * **Domain / Domain Label**: `domain.com`
+  * **Domain / Domain URL**: `https://domain.com`
+* Muss innerhalb deiner Datei und in Twenty eindeutig sein
+
+### Telefonfelder
+
+Telefon ist ein **verschachteltes Feld**, das mehrere Spalten benötigt:
+
+| Spalte                                  | Beispiel     |
+| --------------------------------------- | ------------ |
+| **Phones / Primary Phone Number**       | `4159095555` |
+| **Phones / Primary Phone Country Code** | `US`         |
+| **Phones / Primary Phone Calling Code** | `+1`         |
+
+### Adressfelder
+
+Adresse ist ein **verschachteltes Feld** mit mehreren Spalten (einige können leer bleiben):
+
+* **Adresse / Adresse 1**: Straßenadresse Zeile 1
+* **Adresse / Adresse 2**: Straßenadresse Zeile 2 (optional)
+* **Adresse / Stadt**: Stadtname
+* **Adresse / Bundesland**: Bundesstaat oder Provinz
+* **Adresse / Land**: Name des Landes
+* **Adresse / Postleitzahl**: Postleitzahl/ZIP-Code
+
+### Datumsfelder
+
+Verwenden Sie in Ihrer Datei ein einheitliches Format:
+
+* `YYYY-MM-DD` (empfohlen): `2024-03-15`
+* ISO 8601: `2024-03-15T10:30:00Z`
+
+### Zahlenfelder
+
+* Nur Zahlen (kein Text)
+* Verwenden Sie den Punkt für Dezimalstellen: `1234.56`
+* Keine Tausendertrennzeichen (nicht `1,234.56`)
+
+### Währungsfelder
+
+Währung ist ein **verschachteltes Feld** und erfordert zwei Spalten, die **beide ausgefüllt werden müssen**:
+
+| Spalte               | Beispiel  |
+| -------------------- | --------- |
+| **Betrag / Betrag**  | `1234.56` |
+| **Betrag / Währung** | `USD`     |
+
+### Boolesche Felder
+
+Großschreibung verwenden: `TRUE` oder `FALSE`
+
+<Warning>Kleinschreibung `true` oder `false` funktioniert nicht.</Warning>
+
+### Auswahlfelder
+
+Verwenden Sie den **API-Namen** der Option, nicht den Anzeigenamen.
+
+**So finden Sie API-Namen:**
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie das Objekt und das Feld aus
+3. Aktivieren Sie den **Erweiterten Modus** (Schalter unten rechts)
+4. Kopieren Sie den API-Namen (z. B. `OPTION_1`, nicht "Option 1")
+
+<Note>Neue Auswahloptionen werden nicht automatisch erstellt. Fügen Sie sie vor dem Import unter **Einstellungen → Datenmodell** hinzu.</Note>
+
+### Mehrfachauswahlfelder
+
+Verwenden Sie API-Namen im Array-Format:
+
+```
+["VALUE1","VALUE2"]
+```
+
+### Array-Felder
+
+Verwenden Sie das JSON-Array-Format:
+
+```
+["value1","value2"]
+```
+
+### Bewertungsfelder
+
+Verwenden Sie das Format: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4` oder `RATING_5`
+
+### Links/URL-Felder
+
+Füllen Sie beide Spalten aus:
+
+* **Links / Link-Label**: `Twenty`
+* **Links / Link-URL**: `https://twenty.com`
+
+Für sekundäre Links verwenden Sie die Spalte **Links / Sekundäre Links**:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### JSON-Felder
+
+Verwenden Sie ein gültiges JSON-Format:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### ID-Felder
+
+* **Optional**: Twenty erstellt IDs automatisch, wenn sie nicht angegeben werden
+* **Format**: UUID (z. B. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`)
+* **Anwendungsfall**: ID angeben, um bestehende Datensätze zu aktualisieren, statt neue zu erstellen
+
+## Schritt 5: Beziehungsspalten hinzufügen (bei Verknüpfung von Datensätzen)
+
+Um Datensätze mit anderen Objekten zu verknüpfen (z. B. Personen mit Unternehmen), fügen Sie eine Spalte mit dem eindeutigen Bezeichner des zugehörigen Datensatzes hinzu.
+
+**Beispiel**: Verknüpfung von Personen mit Unternehmen
+
+Fügen Sie Ihrer Personen-CSV eine Spalte hinzu:
+
+```
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**Wichtige Regeln für Beziehungen:**
+
+* Der übergeordnete Datensatz muss bereits in Twenty vorhanden sein
+* Verwenden Sie das **Domain-URL**-Format (`https://domain.com`), nicht die Bezeichnung
+* Ordnen Sie nur EINEN eindeutigen Bezeichner zu (nicht sowohl `companyId` ALS AUCH `companyDomain`)
+* Für Workspace-Mitglieder verwenden Sie deren **E-Mail** (nicht den Namen)
+
+<Warning>
+**Die Importreihenfolge ist wichtig!**
+
+Importieren Sie die "One"-Seite vor der "Many"-Seite:
+1. **Unternehmen** zuerst
+2. **Personen** als Zweites (mit Unternehmensreferenz)
+3. **Opportunities** als Drittes
+
+Der übergeordnete Datensatz muss vorhanden sein, bevor Sie darauf verweisen können.
+</Warning>
+
+Siehe [Beziehungen importieren](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) für detaillierte Anleitungen.
+
+## Schritt 6: Sicherstellen, dass Felder in Twenty vorhanden sind
+
+Der Import erstellt **Datensätze**, nicht **Felder**. Alle Felder, die Sie importieren möchten, müssen bereits in Ihrem Datenmodell vorhanden sein.
+
+**Vor dem Import:**
+
+1. Gehen Sie zu **Einstellungen → Datenmodell**
+2. Wählen Sie Ihr Objekt aus
+3. Erstellen Sie alle benötigten benutzerdefinierten Felder
+4. Notieren Sie die exakten Feldnamen (sie müssen mit Ihren Spaltenüberschriften übereinstimmen)
+
+## Schritt 7: Abschluss-Checkliste
+
+Überprüfen Sie vor dem Hochladen Ihrer Datei:
+
+<Check>Datei ist im CSV-, XLSX- oder XLS-Format</Check>
+<Check>Datei enthält weniger als 10.000 Datensätze</Check>
+<Check>Zeichencodierung ist UTF-8</Check>
+<Check>Keine doppelten E-Mails (für Personen) oder Domains (für Unternehmen)</Check>
+<Check>Datumsangaben verwenden durchgehend ein einheitliches Format</Check>
+<Check>Domains verwenden das Format `https://domain.com`</Check>
+<Check>Boolesche Felder verwenden `TRUE` oder `FALSE` (Großschreibung)</Check>
+<Check>Auswahlfelder verwenden API-Namen, nicht Anzeigenamen</Check>
+<Check>Alle benutzerdefinierten Felder existieren in Einstellungen → Datenmodell</Check>
+<Check>Übergeordnete Datensätze vor untergeordneten Datensätzen importiert</Check>
+<Check>Beziehungsspalten verweisen auf vorhandene Datensätze</Check>
+
+## Häufige Fehler, die Sie vermeiden sollten
+
+| Fehler                                                | Lösung                                                         |
+| ----------------------------------------------------- | -------------------------------------------------------------- |
+| Verwendung von `true` statt `TRUE`                    | Boolesche Werte müssen in Großbuchstaben sein                  |
+| Verwendung von Anzeigenamen für Auswahlfelder         | API-Namen in den Einstellungen suchen und verwenden            |
+| Import von Personen vor Unternehmen                   | Importieren Sie stets zuerst die übergeordneten Objekte        |
+| Fehlender Währungscode für Währungsfelder             | Sowohl die Spalte Betrag als auch die Spalte Währung ausfüllen |
+| Falsches Domain-Format                                | `https://domain.com` konsequent verwenden                      |
+| Zuordnung mehrerer eindeutiger Felder für Beziehungen | Nur EINES zuordnen (Domain ODER ID, nicht beides)              |
+
+## Nächste Schritte
+
+Ihre Datei ist bereit! Jetzt:
+
+* [Unternehmen importieren](/l/de/user-guide/data-migration/how-tos/import-companies-via-csv) (diese zuerst importieren)
+* [Kontakte importieren](/l/de/user-guide/data-migration/how-tos/import-contacts-via-csv)
+* [Importfehler beheben](/l/de/user-guide/data-migration/how-tos/fix-import-errors)

packages/twenty-docs/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx

@@ -0,0 +1,198 @@
+---
+title: Vorhandene Datensätze per Import aktualisieren
+description: Vollständige Schritt-für-Schritt-Anleitung zur Massenaktualisierung von Datensätzen per CSV-Import.
+---
+
+## Übersicht
+
+Müssen Sie viele Datensätze auf einmal aktualisieren? Statt sie einzeln zu bearbeiten, verwenden Sie den CSV-Import, um vorhandene Datensätze massenhaft zu aktualisieren.
+
+**Anwendungsfälle:**
+
+* Positionsbezeichnungen für mehrere Personen aktualisieren
+* Unternehmensinformationen in großem Umfang ändern
+* Daten zu neuen benutzerdefinierten Feldern hinzufügen
+* Datenfehler in vielen Datensätzen korrigieren
+
+## Wie es funktioniert
+
+Wenn Sie eine Datei importieren, die einen **eindeutigen Bezeichner** enthält, der mit einem vorhandenen Datensatz übereinstimmt, aktualisiert Twenty diesen Datensatz, anstatt ein Duplikat zu erstellen.
+
+| Wenn der eindeutige Bezeichner...              | Twenty wird...                                                      |
+| ---------------------------------------------- | ------------------------------------------------------------------- |
+| Stimmt mit einem vorhandenen Datensatz überein | **Aktualisiert** den vorhandenen Datensatz                          |
+| Stimmt mit keinem Datensatz überein            | **Erstellt** einen neuen Datensatz                                  |
+| Fehlt in Ihrer Datei                           | **Erstellt** einen neuen Datensatz (mit automatisch generierter ID) |
+
+<Warning>
+**Mehrfachauswahl-Felder werden überschrieben, nicht zusammengeführt.**
+
+Wenn in einem Datensatz `Option A` und `Option B` ausgewählt sind und Sie `["Option C"]` importieren, hat der Datensatz nach dem Import nur noch `Option C`. Der Import ersetzt alle bisherigen Auswahlen — er fügt ihnen nichts hinzu.
+
+Um vorhandene Werte beizubehalten, schließen Sie sie alle in Ihren Import ein: `["Option A","Option B","Option C"]`
+</Warning>
+
+## Schritt 1: Exportieren Sie Ihre aktuellen Daten
+
+Exportieren Sie zunächst die Datensätze, die Sie aktualisieren möchten:
+
+1. Navigieren Sie zum Objekt (Personen, Unternehmen usw.)
+2. **Fügen Sie die benötigten Spalten hinzu** — klicken Sie auf **Optionen → Felder**, um die Felder anzuzeigen, die Sie aktualisieren möchten
+3. **Filtern Sie bei Bedarf** — grenzen Sie auf genau die Datensätze ein, die Sie aktualisieren möchten
+4. Klicken Sie auf **⋮** → **Ansicht exportieren**
+5. Speichern Sie die CSV-Datei
+
+<Note>**Warum zuerst exportieren?** Die exportierte Datei hat das richtige Format, enthält eindeutige Bezeichner und wird beim Import automatisch zugeordnet.</Note>
+
+### Was exportiert wird
+
+* Alle sichtbaren Spalten in Ihrer aktuellen Ansicht
+* Die eindeutigen Bezeichner des Datensatzes (`id`, `email`, `domain`)
+* Aktuelle Feldwerte, die Sie ändern können
+
+## Schritt 2: Bearbeiten Sie die CSV-Datei
+
+Öffnen Sie die exportierte Datei in Ihrer Tabellenkalkulation (Excel, Google Sheets usw.):
+
+1. **Behalten Sie die Spalte mit dem eindeutigen Bezeichner bei** — löschen Sie `id`, `email` oder `domain` nicht
+2. **Aktualisieren Sie die Werte** in den Spalten, die Sie ändern möchten
+3. **Entfernen Sie Spalten, die Sie nicht aktualisieren müssen** (optional, aber übersichtlicher)
+4. **Ändern Sie die Werte der eindeutigen Bezeichner nicht** — sonst erstellt Twenty neue Datensätze
+
+### Beispiel: Aktualisieren von Positionsbezeichnungen
+
+**Exportierte Datei:**
+
+```csv
+id,email,firstName,lastName,jobTitle
+550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
+550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
+550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
+```
+
+**Nach Ihren Änderungen:**
+
+```csv
+id,email,firstName,lastName,jobTitle
+550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
+550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
+550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
+```
+
+<Warning>
+**Ändern Sie die Werte der eindeutigen Bezeichner nicht.**
+
+Wenn Sie `john@acme.com` in `john.smith@acme.com` ändern, erstellt Twenty einen neuen Datensatz, anstatt den vorhandenen zu aktualisieren.
+</Warning>
+
+## Schritt 3: Importieren Sie die aktualisierte Datei
+
+1. Navigieren Sie zum Objekt
+2. Klicken Sie auf **⋮** → **Datensätze importieren**
+3. Laden Sie Ihre bearbeitete CSV-Datei hoch
+4. **Stellen Sie sicher, dass der eindeutige Bezeichner zugeordnet ist** — prüfen Sie, ob `email`, `domain` oder `id` korrekt zugeordnet ist
+5. Überprüfen Sie die Feldzuordnungen
+6. Auf Fehler prüfen
+7. Klicken Sie auf **Bestätigen**
+
+Twenty gleicht Datensätze anhand des eindeutigen Bezeichners ab und aktualisiert sie mit neuen Werten.
+
+## Den richtigen eindeutigen Bezeichner wählen
+
+| Objekt                         | Empfohlen                   | Alternative | Notizen                                                |
+| ------------------------------ | --------------------------- | ----------- | ------------------------------------------------------ |
+| **Personen**                   | `e-Mail`                    | `id`        | E-Mail ist menschenlesbar                              |
+| **Unternehmen**                | `domäne`                    | `id`        | Domain ist menschenlesbar                              |
+| **Benutzerdefinierte Objekte** | Beliebiges eindeutiges Feld | `id`        | Verwenden Sie Ihr benutzerdefiniertes eindeutiges Feld |
+
+<Note>**Verwenden Sie nur EINEN eindeutigen Bezeichner.** Ordnen Sie nicht sowohl `email` ALS AUCH `id` zu. Dies kann zu Verwirrung und Fehlern führen.</Note>
+
+### Benutzerdefinierte eindeutige Felder verwenden
+
+Wenn Sie ein benutzerdefiniertes Feld als eindeutig markiert haben (z. B. eine externe ID aus einem anderen System):
+
+1. Schließen Sie dieses Feld in Ihren Export und Import ein
+2. Ordnen Sie es beim Import zu
+3. Twenty gleicht anhand dieses Feldes ab
+
+## Schritt 4: Überprüfen Sie die Aktualisierungen
+
+Nach dem Import:
+
+1. Öffnen Sie einige aktualisierte Datensätze
+2. Prüfen Sie, ob die Änderungen übernommen wurden
+3. Stellen Sie sicher, dass keine doppelten Datensätze erstellt wurden
+
+## Was ist mit Feldern, die nicht in Ihrer Datei enthalten sind?
+
+**Felder, die nicht in Ihrer Importdatei enthalten sind, bleiben unverändert.**
+
+| Ihre Datei enthält ...       | Ergebnis                                                            |
+| ---------------------------- | ------------------------------------------------------------------- |
+| `email`, `jobTitle`          | Nur `jobTitle` wird aktualisiert; andere Felder bleiben unverändert |
+| `email`, `jobTitle`, `phone` | `jobTitle` und `phone` werden aktualisiert                          |
+
+Das heißt, Sie müssen nur die Felder einschließen, die Sie ändern möchten (plus den eindeutigen Bezeichner).
+
+## Aktualisierungen und neue Datensätze kombinieren
+
+Sie können vorhandene Datensätze aktualisieren UND neue im selben Import erstellen:
+
+```csv
+email,firstName,lastName,jobTitle
+john@acme.com,John,Smith,Senior Manager    ← Updates existing (email matches)
+newperson@acme.com,New,Person,Analyst      ← Creates new (email doesn't match)
+```
+
+## Häufige Fehler, die Sie vermeiden sollten
+
+| Fehler                                     | Problem                                                        | Ergebnis                                              | Lösung                                                  |
+| ------------------------------------------ | -------------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------- |
+| **Eindeutigen Bezeichner ändern**          | `john@acme.com` in `john.smith@acme.com` geändert              | Erstellt einen neuen Datensatz statt zu aktualisieren | Eindeutige Bezeichner unverändert lassen                |
+| **Mehrere eindeutige Felder**              | Zuordnung sowohl von `email` ALS AUCH `id`                     | Mögliche Abgleichkonflikte                            | Ordnen Sie nur EINEN eindeutigen Bezeichner zu          |
+| **Kein eindeutiger Bezeichner**            | Datei enthält nur `firstName`, `lastName`, `jobTitle`          | Alle Zeilen erstellen neue Datensätze                 | Schließen Sie immer `email`, `domain` oder `id` ein     |
+| **Unterschiedliche Groß-/Kleinschreibung** | Datei enthält `John@acme.com`, aber Twenty hat `john@acme.com` | Erstellt neuen Datensatz                              | Exportieren Sie aus Twenty, um exakte Werte zu erhalten |
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="Was ist, wenn einige Datensätze noch nicht existieren?">
+    Datensätze mit eindeutigen Bezeichnern, die nicht mit vorhandenen Datensätzen übereinstimmen, werden als neue Datensätze erstellt. So können Sie im selben Import aktualisieren und erstellen.
+  </Accordion>
+
+  <Accordion title="Kann ich einen Feldwert löschen/leeren?">
+    Ja, lassen Sie die Zelle in Ihrer CSV leer. Der Import löscht den Wert dieses Feldes im vorhandenen Datensatz.
+  </Accordion>
+
+  <Accordion title="Was passiert mit Feldern, die ich nicht in den Import aufnehme?">
+    Felder, die nicht in Ihrer Importdatei enthalten sind, bleiben in vorhandenen Datensätzen unverändert. Es werden nur die Felder aktualisiert, die Sie einschließen.
+  </Accordion>
+
+  <Accordion title="Kann ich Beziehungsfelder (z. B. Unternehmen) aktualisieren?">
+    Ja! Fügen Sie den eindeutigen Bezeichner der Beziehung hinzu (z. B. `companyDomain`) und ordnen Sie ihn dem Beziehungsfeld zu. Die Beziehung wird aktualisiert.
+  </Accordion>
+
+  <Accordion title="Woher weiß ich, welche Datensätze aktualisiert bzw. erstellt werden?">
+    Im Überprüfungsschritt des Imports zeigt Twenty Ihnen anhand der Übereinstimmungen der eindeutigen Bezeichner, wie viele Datensätze aktualisiert bzw. erstellt werden.
+  </Accordion>
+
+  <Accordion title="Kann ich eine Massenaktualisierung rückgängig machen?">
+    Es gibt kein automatisches Rückgängigmachen. Wir empfehlen, Ihre Daten vor Massenaktualisierungen als Sicherung zu exportieren.
+  </Accordion>
+</AccordionGroup>
+
+## Beste Praktiken
+
+1. **Zuerst exportieren** — beginnen Sie immer mit einem Export, um das richtige Format sicherzustellen
+2. **Vor dem Aktualisieren sichern** — exportieren Sie Ihre Daten, bevor Sie umfangreiche Änderungen vornehmen
+3. **Mit einigen Datensätzen testen** — versuchen Sie zunächst, 5-10 Datensätze zu aktualisieren, bevor Sie eine große Menge verarbeiten
+4. **Verwenden Sie menschenlesbare Bezeichner** — `email` und `domain` sind leichter zu überprüfen als `id`
+5. **Nur notwendige Spalten einschließen** — weniger Spalten bedeuten geringere Fehlerwahrscheinlichkeit
+
+## Fehlerbehebung
+
+Gibt es Probleme? Prüfen Sie:
+
+* [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors)
+* [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)
+* [Referenz zur Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)

packages/twenty-docs/l/de/user-guide/data-migration/overview.mdx

@@ -0,0 +1,83 @@
+---
+title: Datenmigration
+description: Importieren und exportieren Sie Ihre CRM-Daten über CSV-Dateien oder die API.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Importmethoden
+
+Twenty unterstützt zwei Hauptmethoden zum Importieren von Daten:
+
+| Methode        | Am besten geeignet                                | Volumenlimit                |
+| -------------- | ------------------------------------------------- | --------------------------- |
+| **CSV-Import** | Standardmigrationen, regelmäßige Aktualisierungen | 10.000 Datensätze pro Datei |
+| **API-Import** | Groß angelegte Migrationen, Automatisierung       | Unbegrenzt                  |
+
+<Note>Für sehr große Datensätze (Hunderttausende von Datensätzen) verwenden Sie die API. Unsere [Implementierungspartner](/l/de/user-guide/getting-started/capabilities/implementation-services) können bei Bedarf diese Skripte ausführen.</Note>
+
+## Grundlagen des CSV-Imports
+
+Sie können Daten für jedes Objekt mit CSV-, XLSX- oder XLS-Dateien importieren. Jede Datei sollte **nur einen Objekttyp** enthalten (z. B. nur Personen-Datensätze).
+
+<Note>**Felder müssen vor dem Import existieren.** Das Hochladen einer CSV erstellt Datensätze, erstellt jedoch keine Felder. Wenn Sie benutzerdefinierte Felder benötigen, erstellen Sie diese zuerst unter **Einstellungen → Datenmodell**.</Note>
+
+### Schritte
+
+1. Navigieren Sie zu dem Objekt, in das Sie Daten importieren möchten
+2. Klicken Sie oben rechts auf das Symbol **⋮** (dies ist das Befehlsmenü) und klicken Sie auf **Datensätze importieren**
+3. Laden Sie die Vorlagendatei herunter, um sicherzustellen, dass Ihre Daten im erwarteten Format vorliegen
+4. Laden Sie Ihre formatierte CSV-Datei hoch
+5. Ordnen Sie Ihre Spalten den Twenty-Feldern zu
+6. Überprüfen Sie Fehler (gelb hervorgehoben) und beheben Sie sie, indem Sie sie direkt in der Benutzeroberfläche bearbeiten
+7. Bestätigen Sie den Import
+
+### Beziehungen zwischen Objekten importieren
+
+Sie können Beziehungen zwischen Objekten mit der CSV-Importfunktion importieren. Sie müssen auf das verknüpfte Objekt über ein eindeutiges Feld dieses Objekts verweisen: die `id`, die `email` für Personen und Workspace-Mitglieder, die `domain` für Unternehmen, jedes andere im Datenmodell als eindeutig festgelegte Feld für andere Objekte.
+
+<Note>**Gelöschte Datensätze zählen zur Eindeutigkeit.** Softgelöschte Datensätze (sichtbar unter Befehlsmenü → Gelöschte Datensätze anzeigen) werden in die Eindeutigkeitsprüfungen einbezogen. Wenn Sie einen Datensatz mit demselben eindeutigen Wert wie ein gelöschter Datensatz importieren, wird der gelöschte Datensatz wiederhergestellt.</Note>
+
+<Warning>
+**Die Importreihenfolge ist wichtig!**
+
+Beim Import verknüpfter Objekte laden Sie die Dateien in dieser Reihenfolge hoch:
+1. **Unternehmen** zuerst (die „one“-Seite der Beziehungen)
+2. **Personen** an zweiter Stelle (über companyId mit Unternehmen verknüpft)
+3. **Opportunities** an dritter Stelle (mit Unternehmen/Personen verknüpft)
+4. **Benutzerdefinierte Objekte** mit Beziehungen zuletzt
+
+Warum? Die „one“-Seite einer Eins-zu-viele-Beziehung muss existieren, bevor Sie darauf verweisen können. Beispielsweise muss der Unternehmensdatensatz existieren, bevor Sie eine Person mit der ID dieses Unternehmens importieren.
+</Warning>
+
+Weitere Informationen finden Sie in [diesem Artikel](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) mit einer Schritt-für-Schritt-Anleitung zum Vorgehen.
+
+## Daten exportieren
+
+Exportieren Sie die Daten Ihres Arbeitsbereichs für Backups, Berichte oder Migrationen.
+
+### Schritte
+
+1. Navigieren Sie zu dem Objekt, das Sie exportieren möchten
+2. Konfigurieren Sie die Ansicht mit den benötigten Spalten
+3. Klicken Sie auf **⋮** → **Ansicht exportieren**
+4. Speichern Sie die CSV-Datei
+
+<Note>**Nur sichtbare Spalten werden exportiert.** Die CSV-Datei enthält nur die Spalten, die in Ihrer aktuellen Ansicht angezeigt werden. Fügen Sie vor dem Export Spalten hinzu oder blenden Sie sie aus, um zu steuern, welche Daten enthalten sind.</Note>
+
+<Note>**Exportgrenzen**: Bis zu 20.000 Datensätze pro Export.</Note>
+
+## Berechtigungen
+
+Datenimport und -export erfordern bestimmte Berechtigungen:
+
+* **Import**: Erfordert die Berechtigung "Import CSV"
+* **Export**: Erfordert die Berechtigung "Export CSV"
+
+Wenden Sie sich an Ihren Arbeitsbereichsadministrator, wenn Sie diese Berechtigungen nicht haben.
+
+## Nächste Schritte
+
+* [Bereiten Sie Ihre CSV-Dateien vor](/l/de/user-guide/data-migration/how-tos/prepare-your-csv-files)
+* [Beziehungen zwischen Objekten importieren](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+* [Über die API für große Datensätze importieren](/l/de/user-guide/data-migration/how-tos/import-data-via-api)