> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kontakte-und-unternehmen/import-und-datenpflege/kontakte-und-chancen-per-csv-importieren.md). # Kontakte und Chancen per CSV importieren Bereite CSV-Dateien sauber vor, ordne Felder nachvollziehbar zu und löse typische Importfehler gezielt. Page "Kontakte und Chancen per CSV importieren" — id: AZnEv25u1JtHl9Xh1bg5, path: /one-loop-plattform/kontakte-und-unternehmen/import-und-datenpflege/kontakte-und-chancen-per-csv-importieren *** ### description: >- Bereite CSV-Dateien sauber vor, ordne Felder nachvollziehbar zu und löse typische Importfehler gezielt. ## Kontakte und Chancen per CSV importieren ### Das Ergebnis Mit einem CSV-Import übernimmst du viele Kontakte oder Chancen in einem Durchgang. Der Import erstellt neue Datensätze, aktualisiert vorhandene oder erledigt beides zusammen. Eine saubere Datei und eine sorgfältige Feldzuordnung verhindern falsche Daten, unerkannte Dubletten und unvollständige Chancen. > Ein Import lässt sich nicht mit einem einzelnen Rückgängig-Befehl aufheben. Starte deshalb immer mit einer kleinen Testdatei, bevor du die gesamte Liste übernimmst. ### Wann du diesen Import verwendest Nutze den Import, wenn du Daten aus einer Tabelle, einem anderen System oder einer Veranstaltungsliste übernehmen möchtest. Du kannst dabei: * nur Kontakte anlegen oder aktualisieren, * Kontakte und zugehörige Chancen in derselben CSV-Datei importieren, * nur Chancen importieren, wenn die zugehörigen Kontakte bereits im Standort vorhanden sind, * eine Korrekturdatei mit einzelnen fehlerhaften Zeilen erneut importieren. Für neue Adressen ohne zugehörige Chance reicht meist der Kontaktimport. Wähle einen kombinierten Import nur, wenn jede Zeile wirklich sowohl Kontakt- als auch Chancendaten enthält. ### Wo der Import beginnt Es gibt zwei Einstiege. Beide führen durch denselben Ablauf aus **Start**, **Upload**, **Zuordnen** und **Prüfen**: 1. Öffne **Kontakte** und wähle **Kontakte importieren**, wenn deine Datei hauptsächlich Kontakte enthält. 2. Öffne **Vertrieb** → **Chancen** und wähle oben **Import**, wenn du Chancen prüfen oder bearbeiten möchtest. Wenn ein Einstieg oder die Schaltfläche nicht sichtbar ist, fehlt dir wahrscheinlich die nötige Berechtigung. Bitte in diesem Fall die verantwortliche Person, dir den Import freizugeben. ### Vor dem Upload prüfen * Der Import akzeptiert ausschließlich Dateien im Format **CSV**. * Die Datei darf höchstens **30 MB** groß sein und enthält nur eine Tabelle. * Die erste Zeile enthält Spaltenüberschriften und darf nicht leer sein. * Jede Kontaktzeile braucht mindestens Vorname, E-Mail-Adresse oder Rufnummer. * Lege benötigte eigene Felder vor dem Import im Standort an; erst dann kannst du CSV-Spalten darauf abbilden. * Sorge für eindeutige Spaltenüberschriften und entferne unnötige Leerzeilen. * Verwende nur Daten, die du für diesen Zweck verwenden darfst. Bereinige doppelte Zeilen vor dem Upload. Der Import kann bestehende Dubletten nicht automatisch fachlich zusammenführen. ### Dateiinhalt richtig formatieren Jede Zeile steht für einen Kontakt oder eine Chance, jede Spalte für eine Eigenschaft. Verwende je Feldtyp ein einheitliches Format. Prüfe neue oder ungewöhnliche Werte zuerst mit einer einzelnen Testzeile. | Feldtyp | Geeignete Schreibweise | Wichtig | | ----------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------- | | Datum | 2026-08-21, 2026/08/21, 08-21-2026 oder 08/21/2026 | Nicht mehrere Datumsformate in einer Spalte mischen | | Rufnummer | Möglichst international, zum Beispiel +41441234567 | Keine Buchstaben oder unvollständigen Nummern verwenden | | Auswahl mit mehreren Werten | Werte mit Komma, Semikolon oder Punkt trennen | Schrägstriche sind dafür nicht geeignet | | Einzelauswahl | Genau ein gültiger Wert pro Zelle | Der Wert muss zu einer vorhandenen Auswahl passen | | Verantwortliche Person | Vollständiger Vor- und Nachname | Die Person muss im Standort eindeutig vorhanden sein | | Tags | Mehrere Werte mit Komma, Semikolon oder Punkt trennen | Schreibweisen vorab vereinheitlichen | | Zusätzliche E-Mails oder Rufnummern | Eigene CSV-Spalte verwenden; mehrere Einträge mit Komma trennen | Nicht in das Hauptfeld mischen | | Zahlfelder | Nur Zahlen und ein einheitliches Dezimalformat verwenden | Sonderzeichen und gemischte Formate vermeiden | Bei einem Länder- oder Zeitzonenfeld verwendet die Plattform nur exakt erkennbare Werte. Nutze die vorgegebene Schreibweise aus einer erfolgreichen Testzeile, zum Beispiel Germany (DE) oder Europe/Berlin, und ändere Groß- und Kleinschreibung nicht willkürlich. ### Die vier Schritte im Import #### 1. Start: Inhalt und Änderungsart wählen Wähle zuerst, ob du **Kontakte**, **Chancen** oder beide Datenarten importierst. Wenn Kontakte und Chancen gewählt sind, legst du für beide separat fest, ob sie: * nur neu angelegt, * nur aktualisiert oder * neu angelegt und aktualisiert werden sollen. Treffe diese Auswahl bewusst. Ein Aktualisierungsimport kann vorhandene Daten verändern; ein reiner Neuanlage-Import aktualisiert dagegen keine bereits erkannten Datensätze. #### 2. Upload: Datei kontrolliert hochladen Ziehe die CSV-Datei in den Upload-Bereich oder wähle sie über die Dateiauswahl. Kontrolliere den Dateinamen und die Vorschau, bevor du fortfährst. Sobald Spalten fehlen, zusammengezogen aussehen oder Sonderzeichen falsch dargestellt werden, beende den Vorgang und speichere die Datei erneut als CSV. #### 3. Zuordnen: Jede Spalte fachlich prüfen Im Schritt **Zuordnen** schlägt die Plattform passende Zielfelder vor. Diese Vorschläge sind nur ein Ausgangspunkt. Prüfe in jeder Spalte die Beispielwerte: 1. Ordne jede benötigte Spalte dem passenden Zielfeld zu. 2. Achte darauf, ob die Ansicht vollständige Zuordnungen mit einem grünen Hinweis markiert. 3. Öffne gelbe Warnhinweise und korrigiere die angezeigte fehlende oder unklare Zuordnung. 4. Lass Spalten, die nicht übernommen werden sollen, bewusst unzugeordnet. Bestätige die dazu angezeigte Option nur dann, wenn diese Spalten wirklich entfallen dürfen. Ordne eine Spalte nie allein wegen ihrer Überschrift zu. Entscheidend sind die Werte in den Beispielzeilen. | CSV-Inhalt | Passendes Zielfeld | Wichtiger Hinweis | | ----------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------- | | Frühere interne Kennung | Kontakt-ID | Nur für eine sichere Aktualisierung aus einem früheren Export verwenden | | Vor- und Nachname | Vorname, Nachname oder Name | Überschriften und Werte konsistent halten | | E-Mail und Rufnummer | E-Mail, Rufnummer oder zusätzliche E-Mail- bzw. Rufnummernfelder | Formate vor dem Import vereinheitlichen | | Anschrift | Straße, Ort, Bundesland, Postleitzahl und Land | Einzelne Adressbestandteile getrennt zuordnen | | Geschäftliche Angaben | Unternehmen, Herkunft, Typ oder verantwortliche Person | Die verantwortliche Person muss im Standort eindeutig vorhanden sein | | Ergänzende Angaben | Website, Geburtsdatum, Zeitzone, Notizen oder eigene Felder | Datums- und Zeitangaben vorher mit einer Testzeile prüfen | #### 4. Prüfen: Wirkung vor dem Start festlegen Im letzten Schritt siehst du die ausgewählten Zuordnungen noch einmal. Je nach Import kannst du zusätzlich: * die neuen Kontakte einer Liste zuordnen, * sie mit einem eindeutigen Tag kennzeichnen, * sie in einen bereits vorbereiteten Workflow aufnehmen. Wähle diese Optionen nur, wenn sie zum Test und zur gewünschten Nachbearbeitung passen. Ein eindeutiger Tag hilft dir, die importierte Auswahl später wiederzufinden. Prüfe danach die abschließende Bestätigung zur Datenverwendung und starte den Import erst, wenn alle Angaben stimmen. ### Kontakte und Chancen in einer Datei Bei einem kombinierten Import stehen Kontakt- und Chancendaten in derselben CSV-Zeile. Prüfe für jede Chance besonders den Kontaktbezug, den Namen der Chance und die Pipeline. Beim Aktualisieren einer vorhandenen Chance gehört zusätzlich die Chancen-ID in die Datei. Je nach Importauswahl fordert die Zuordnung weitere Angaben wie Phase oder Status an. Die Importansicht zeigt dir, was für deine Auswahl noch fehlt. Verwende eine Pipeline nur, wenn sie im Standort bereits existiert und ihr Name exakt zur Angabe in der Datei passt. Wenn du ausschließlich Chancen importierst, muss jede Chance eindeutig zu einem vorhandenen Kontakt passen. Fehlt dieser Bezug, korrigiere die betroffene Zeile oder importiere zunächst die Kontakte. ### Vorhandene Kontakte sicher aktualisieren Für eine Aktualisierung muss der Import einen vorhandenen Kontakt eindeutig erkennen. Die aktuelle Abgleichreihenfolge lautet: 1. Kontakt-ID 2. E-Mail-Adresse 3. Rufnummer Die Regeln zur Dublettenerkennung im Standort gelten auch beim Import. Ändere deshalb nicht gleichzeitig die Datei und die Einstellungen zur Dublettenerkennung. Teste zuerst einige bekannte Kontakte und prüfe danach, ob wirklich die erwarteten Datensätze aktualisiert wurden. Wenn die Option **Leere Werte nicht aktualisieren** angezeigt wird, aktiviere sie, sofern leere CSV-Zellen bestehende Inhalte nicht löschen sollen. So bleiben vorhandene Werte erhalten, wenn die Datei für dieses Feld keine Angabe enthält. ### Importfortschritt und Fehler prüfen Nach dem Start erscheint der Vorgang in den Sammelaktionen. Öffne dort den Import und kontrolliere Status, Statistik und Details. 1. Warte, bis der Status abgeschlossen ist. 2. Prüfe, wie viele Zeilen erfolgreich verarbeitet wurden. 3. Öffne die Details und den Fehlerbereich, falls Warnungen oder Fehler angezeigt werden. 4. Lade das Fehlerprotokoll herunter, wenn einzelne Zeilen fehlgeschlagen sind. 5. Korrigiere nur die betroffenen Zeilen in einer neuen CSV-Datei. 6. Importiere die Korrekturdatei und prüfe danach die betroffenen Kontakte oder Chancen direkt. Eine Korrekturdatei ist sicherer als ein erneuter Import der gesamten Ausgangsdatei. So vermeidest du doppelte oder unerwartete Aktualisierungen. ### Häufige Fehler gezielt beheben | Meldung oder Symptom | Ursache | Lösung | | -------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | | Datei wird nicht akzeptiert | Kein CSV-Format, zu groß oder keine eindeutige Tabelle | Datei als CSV exportieren, auf höchstens 30 MB verkleinern und gegebenenfalls aufteilen | | Keine sinnvolle Zuordnung | Erste Zeile ist leer oder Überschriften fehlen | Überschriften ergänzen und Datei neu speichern | | Kontakt kann nicht angelegt werden | Vorname, E-Mail-Adresse und Rufnummer fehlen | Mindestens eine dieser Angaben ergänzen | | Eigenes Feld fehlt bei der Zuordnung | Feld wurde im Standort noch nicht angelegt | Feld zuerst anlegen, danach den Import neu starten | | Bestehender Kontakt wurde nicht erkannt | Kennung passt nicht zur Abgleichreihenfolge oder zu den Regeln für Dubletten | Kontakt-ID, E-Mail oder Rufnummer bereinigen und mit einer kleinen Testdatei prüfen | | Bestehender Wert wurde geleert | Leere Werte wurden als Aktualisierung übernommen | Einstellung zum Nicht-Aktualisieren leerer Werte aktivieren, wenn sie verfügbar ist | | Chance ist unvollständig oder wird abgelehnt | Kontaktbezug, Chancenname, Pipeline oder eine in der Ansicht verlangte Angabe fehlt | Fehlende Spalten ergänzen und die Pipeline-Bezeichnung exakt prüfen | | Länder- oder Zeitzonenwert wird abgelehnt | Wert stimmt nicht exakt mit dem erwarteten Format überein | Schreibweise aus einer erfolgreichen Testzeile übernehmen | | Einzelne Zeilen fehlen im Ergebnis | Die Zeilen enthalten einen Fehler, obwohl der restliche Import abgeschlossen wurde | Details und Fehlerprotokoll öffnen; nur diese Zeilen korrigiert erneut importieren | ### Sicher testen, bevor du die ganze Datei importierst Bereite zunächst zehn echte, aber leicht überprüfbare Zeilen vor. Gib ihnen ein eindeutiges Tag, importiere sie und prüfe: * Wurden neue Kontakte erstellt oder die richtigen bestehenden Kontakte aktualisiert? * Sind Namen, Rufnummern, eigene Felder und Auswahlwerte im richtigen Feld? * Erscheinen Chancen in der erwarteten Pipeline und mit dem erwarteten Status? * Wurde keine unbeabsichtigte Liste, Kennzeichnung oder Automatisierung ausgelöst? * Sind Fehler und Warnungen nachvollziehbar behoben? Erst wenn diese Prüfung erfolgreich ist, importierst du die vollständige Datei. ### Praxisbeispiel Ein Team möchte Messekontakte und passende Chancen übernehmen. Es erstellt eine CSV mit Vorname, E-Mail, Rufnummer, Unternehmen, Pipeline, Phase, Status, Chancenname und dem Tag Messe Herbst. Zuerst werden zehn Zeilen importiert und bei Kontakten und Chancen kontrolliert. Dabei stellt das Team fest, dass eine Pipeline-Bezeichnung nicht exakt passt, korrigiert nur diese Zeilen und importiert sie erneut. Erst wenn Felder, Zuordnung und verantwortliche Personen stimmen, folgt die gesamte Datei. Anschließend wird nach dem Tag gefiltert; fehlerhafte Datensätze lassen sich damit sicher wiederfinden. ### Danach weiterarbeiten Nach einem erfolgreichen Import kannst du die Auswahl mit [Listen, Filtern und Tags](/help/plattform/one-loop-plattform/kontakte-und-unternehmen/listen-filter-und-tags.md) strukturieren oder eigene Felder für Kontakte und Chancen ergänzen. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/kontakte-und-unternehmen/import-und-datenpflege/kontakte-und-chancen-per-csv-importieren.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.