> 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/unternehmen-und-beziehungen/unternehmen-per-csv-importieren.md). # Unternehmen per CSV importieren Lege Unternehmensdatensätze per CSV an oder aktualisiere sie kontrolliert, prüfe Feldzuordnungen und verhindere ungewollte Datenverluste. Mit einem CSV-Import kannst du viele Unternehmen auf einmal anlegen, vorhandene Datensätze aktualisieren oder beides in einem Durchgang erledigen. Der Importassistent führt dich dabei durch vier Schritte: **Start**, **Hochladen**, **Zuordnen** und **Prüfen**. Erst im letzten Schritt wird der Import wirklich gestartet. > **Wichtig:** Ein gestarteter Import lässt sich nicht rückgängig machen. Beginne immer mit einer kleinen Testdatei mit fünf bis zehn Zeilen. ## Was du vorab vorbereitest Für einen sicheren Import brauchst du eine CSV-Datei mit einer klaren ersten Zeile. Diese Überschriften nutzt der Assistent, um deine Spalten den Unternehmensfeldern zuzuordnen. Prüfe die Datei vor dem Upload: * Die Datei ist im CSV-Format gespeichert und höchstens 30 MB groß. * Die erste Zeile enthält eindeutige Spaltenüberschriften. * Pflichtangaben sind vollständig, ohne unnötige Leerzeichen und durchgängig im selben Format erfasst. * Es gibt keine doppelten Spaltennamen und keine unbenötigten leeren Spalten. * Datumsangaben, Telefonnummern und E-Mail-Adressen haben ein einheitliches, gültiges Format. * Eigene Unternehmensfelder existieren bereits im Standort. Der Import kann fehlende eigene Felder nicht selbst anlegen. Vor einem größeren Aktualisierungsimport exportierst du den vorhandenen Unternehmensbestand am besten zuerst. Diese Datei hilft dir beim Vergleichen, falls du später eine Änderung nachvollziehen musst. ## Den richtigen Importmodus wählen Im Schritt **Hochladen** wählst du aus, wie der Assistent mit jeder Zeile umgehen soll. | Modus | Was passiert | Wann er passt | | ----------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------ | | **Unternehmen anlegen** | Es werden nur neue Unternehmensdatensätze erstellt. | Du übernimmst einen Bestand erstmals. | | **Unternehmen aktualisieren** | Es werden nur eindeutig erkannte Unternehmen geändert. | Du möchtest vorhandene Angaben korrigieren oder ergänzen. | | **Unternehmen anlegen und aktualisieren** | Erkannte Unternehmen werden geändert, nicht erkannte Unternehmen werden neu angelegt. | Deine Datei enthält neue und bereits vorhandene Unternehmen. | Für den Modus **Aktualisieren** brauchst du eine verlässliche Kennung. Die sicherste Wahl ist die Unternehmens-ID aus einem früheren Export. Ähnliche Namen allein können verwechselt werden und sind keine sichere Grundlage für einen Massenabgleich. ## Import Schritt für Schritt durchführen ### 1. Import starten 1. Öffne **Kontakte > Unternehmen**. 2. Wähle oben **Importieren**. 3. Stelle sicher, dass du den Import für **Unternehmen** startest, nicht für einen anderen Datentyp. Die Unternehmensliste zeigt Suche, Filter und die vorhandenen Datensätze. Prüfe deshalb vor dem Start noch einmal, ob du im richtigen Bereich arbeitest. ### 2. Datei hochladen und Abgleich festlegen 1. Ziehe die CSV-Datei in das Upload-Feld oder wähle sie von deinem Gerät aus. 2. Warte, bis der Upload vollständig angezeigt wird. 3. Wähle den Importmodus aus der Tabelle oben. 4. Bei Aktualisierungen oder beim kombinierten Modus legst du unter **Dubletten finden anhand von** die Kennung fest. Wähle nach Möglichkeit die Unternehmens-ID oder ein eindeutig gepflegtes Unternehmensfeld. 5. Klicke auf **Weiter**. Die Datei wird vor dem nächsten Schritt geprüft. Wird der Upload abgelehnt, korrigiere zunächst Dateiformat, Kopfzeilen und Größenlimit statt dieselbe Datei unverändert erneut hochzuladen. ### 3. Jede Spalte richtig zuordnen Im Schritt **Zuordnen** zeigt der Assistent für jede CSV-Spalte eine Vorschau, den Zuordnungsstatus und ein Auswahlfeld für das Ziel-Feld. | Sichtbare Angabe | Was du damit prüfst | | ------------------------------- | ----------------------------------------------------------------- | | Spaltenüberschrift in der Datei | Welche Information die CSV-Spalte enthalten soll. | | Vorschau | Ob die ersten Werte tatsächlich zum erwarteten Feld passen. | | Status | Ob die Spalte bereits zugeordnet wurde. | | Ziel-Feld | In welchem Unternehmensfeld der Wert gespeichert wird. | | Leere Werte aktualisieren | Ob eine leere Zelle dieses einzelne Ziel-Feld überschreiben darf. | Die automatische Zuordnung ist nur ein Vorschlag. Lies jede Zeile gegen: Eine Spalte `Website` darf nicht versehentlich dem Feld `E-Mail` zugeordnet sein, auch wenn beide Werte ähnlich aussehen. Überflüssige Spalten kannst du bewusst auslassen. Öffne außerdem die sichtbaren Bereiche für die erforderlichen Felder. Der Assistent unterscheidet dabei zwischen Anforderungen für **Unternehmen anlegen** und **Unternehmen aktualisieren**. Prüfe die Anforderungen für genau den Modus, den du gewählt hast. ### 4. Leere Werte pro Spalte schützen Neben jeder Zuordnung gibt es eine Einstellung für leere Werte. Sie wirkt nicht pauschal für die ganze Datei, sondern für das jeweilige Ziel-Feld. * Ist **Nicht mit leerem Wert aktualisieren** aktiv, bleibt ein vorhandener Wert bestehen, wenn die Zelle in deiner CSV leer ist. * Deaktivierst du den Schutz, kann eine leere CSV-Zelle den vorhandenen Wert im entsprechenden Feld löschen. Lass den Schutz bei normalen Aktualisierungen aktiviert. Deaktiviere ihn nur für Felder, die du bewusst leeren möchtest, und teste genau diesen Fall zuerst mit einem einzelnen Testunternehmen. ### 5. Zusammenfassung prüfen und Import starten Im Schritt **Prüfen** siehst du die hochgeladene Datei und eine Zusammenfassung der Zuordnung. Kontrolliere dort besonders: 1. Importmodus, 2. Anzahl der zu verarbeitenden Zeilen, 3. jede Feldzuordnung, 4. die Kennung für Dubletten, 5. den Schutz leerer Werte je Feld. Erst wenn diese fünf Punkte stimmen, wählst du **Massenimport starten**. Notiere bei einem größeren Import den Dateinamen und den Zeitpunkt. Das erleichtert die spätere Prüfung in den Sammelaktionen. ## Was bei Dubletten geschieht Beim Abgleich wertet die Plattform die gewählte Unternehmens-ID, vorhandene eindeutige Unternehmensfelder oder bestehende Datensätze aus. Das Ergebnis einer Zeile kann unterschiedlich sein: * ein neues Unternehmen wird angelegt, * ein vorhandenes Unternehmen wird aktualisiert, * eine mögliche Dublette wird erkannt, * die Zeile wird wegen einer Prüfung als fehlerhaft markiert. Bei einem Konflikt speicherst du die Problemmeldung aus dem Bericht und korrigierst nur die betroffenen Zeilen. So vermeidest du, dass korrekte Datensätze unnötig erneut verarbeitet werden. ## Fortschritt und Berichte in den Sammelaktionen prüfen Nach dem Start öffnest du die Übersicht der **Sammelaktionen** für Unternehmen. Eine Importzeile zeigt unter anderem: * Bezeichnung der Aktion bzw. den Dateinamen, * Vorgangstyp **Import**, * Status, * ausführende Person, * Zeitpunkt der Erstellung und Fertigstellung, * Statistik und weitere Aktionen. Öffne die Details und prüfe die Anzahl verarbeiteter, erfolgreicher, fehlerhafter und mit Warnungen versehener Zeilen. Wenn verfügbar, kannst du den Ablauf dort pausieren, fortsetzen oder abbrechen. Lade Fehler- und Erfolgsberichte unmittelbar herunter. Damit erstellst du eine kleine Korrekturdatei statt den gesamten Bestand erneut zu importieren. ## Wichtige Grenzen Ein Unternehmensimport erstellt oder aktualisiert nur Unternehmensdatensätze. Verknüpfungen zu Kontakten oder Chancen entstehen dadurch nicht automatisch. Prüfe benötigte Zuordnungen nach dem Import separat. Ein Import kann nicht zurückgenommen werden. Ein vorheriger Export ist eine hilfreiche Vergleichsdatei, ersetzt aber keine automatische Wiederherstellung. Daher sind die kleine Testdatei, die Zuordnungsprüfung und der Schutz vor leeren Werten die wichtigsten Sicherheitsstufen. ## Praxisbeispiel: Monatliche Datenpflege Ein Team erhält monatlich eine Datei mit neuen und geänderten Unternehmen. 1. Es exportiert den aktuellen Bestand als Vergleich. 2. Es erstellt eine Testdatei mit acht Zeilen: drei neue, drei vorhandene und zwei mit absichtlich leeren Zusatzfeldern. 3. Im Importassistenten wählt das Team **Unternehmen anlegen und aktualisieren** und die Unternehmens-ID als Kennung. 4. Es prüft für jede Spalte die Vorschau und lässt den Schutz vor leeren Werten bei den Zusatzfeldern aktiviert. 5. Nach dem Test kontrolliert es in den Sammelaktionen die acht Ergebnisse und korrigiert bei Bedarf nur die problematischen Zeilen. 6. Erst danach startet es den vollständigen Monatsimport und prüft wieder einige angelegte und aktualisierte Unternehmen. So schützt das Team bestehende Daten und erkennt fehlerhafte Zuordnungen, bevor sie viele Datensätze betreffen. ## Häufige Probleme lösen ### Die Datei wird nicht akzeptiert Prüfe CSV-Format, Dateigröße, Kopfzeile und doppelte Spaltennamen. Entferne nicht benötigte leere Spalten und vereinheitliche Datum, E-Mail-Adresse sowie Telefonnummern. ### Daten landen im falschen Feld Das ist eine fehlerhafte Zuordnung. Öffne die Zuordnungsansicht, vergleiche Spaltenüberschrift und Vorschauwert mit dem Ziel-Feld und korrigiere die Zuordnung vor dem Start. Bei einem bereits gestarteten Import korrigierst du die betroffenen Zeilen gezielt anhand des Berichts. ### Bestehende Angaben wurden plötzlich gelöscht Prüfe bei den betroffenen Spalten, ob der Schutz vor leeren Werten deaktiviert war. Eine leere Zelle kann dann den gespeicherten Wert überschreiben. Teste diese Einstellung künftig zuerst mit einem einzelnen Testunternehmen. ### Einige Unternehmen wurden nicht aktualisiert Kontrolliere die gewählte Kennung. Ohne passende Unternehmens-ID oder ein eindeutig gepflegtes Feld kann der Assistent den Datensatz nicht zuverlässig finden. Lade den Fehlerbericht herunter und vergleiche die dort genannten Zeilen mit dem vorhandenen Unternehmen. ## Kurz-Checkliste * CSV mit eindeutigen Kopfzeilen und Testdatei vorbereitet * Importmodus und Kennung bewusst gewählt * Jede Zuordnung anhand der Vorschau kontrolliert * Leere Werte pro Feld geschützt * Zusammenfassung vor dem Start geprüft * Ergebnisse und Berichte in den Sammelaktionen kontrolliert --- # 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/unternehmen-und-beziehungen/unternehmen-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.