Kunden- und Fahrzeugdaten in Werkstatt.NXT importieren

Kunden- und Fahrzeugdaten in Werkstatt.NXT importieren

Damit du grundlegende Kunden- und Fahrzeugdaten aus einem anderen System nach Werkstatt.NXT übernehmen kannst, bietet Werkstatt.NXT eine Importfunktion an. Diese kannst du entweder selbst verwenden oder - wenn du unsicher bist - kannst du unseren Support anfragen.

Im folgenden erklären wir dir, welches Format die zum Import verwendeten Daten haben müssen und wie der Importprozess abläuft.

Nimm dir Zeit!

Der Import von Daten aus einer Software in eine andere Software ist immer ein kritischer Prozess, den man nicht “mal eben” durchführen sollte. Nimm dir Zeit dafür, der Importprozess kann je nach Menge der Daten eine Weile in Anspruch nehmen.

Importformat

Das Importformat definiert, welches Dateiformat und welche Informationsstruktur die Dateien haben müssen, damit Werkstatt.NXT sie versteht. Du musst also gewährleisten, dass die von dir hochgeladenen Dateien dem Importformat entsprechen, damit der Import richtig funktioniert.

Datei für Kundendaten

Die Datei muss im CSV-Format vorliegen. Die einzelnen Spalten innerhalb der CSV-Datei müssen durch ein Semikolon (;) getrennt sein.

Die CSV-Datei muss in der ersten Zeile folgende Spalten in exakt der folgenden Schreibweise enthalten:

  • AlteKundennummer
    • Hier kann optional die Kundennummer aus dem alten System eingetragen werden.
  • Debitorennummer
    • Hier kann optional die Debitorennummer des Kunden eingetragen werden.
  • Anrede
    • Hier kann optional die Anrede der Kunden eingetragen werden
    • Unterstützte Felder: keine Angabe, Herr, Frau
  • Titel
    • Hier kann optional der Titel des Kunden eingetragen werden
  • Vorname
    • Falls es sich bei dem Kunden um eine Person handelt, muss hier der Vorname eingetragen werden
  • Nachname
    • Falls es sich bei dem Kunden um eine Person handelt, muss hier der Nachname eingetragen werden
  • Organisationsname
    • Falls es sich bei dem Kunden um eine Organisation handelt, muss hier der Organisationsname eingetragen werden
    • Die Spalte muss leergelassen werden, falls es sich bei dem Kunden um eine Person handelt
  • Strasse
    • Die Straße der Postanschrift des Kunden
  • Hausnummer
    • Die Hausnummer der Postanschrift des Kunden
  • PLZ
    • Die Postleitzahl der Postanschrift des Kunden
  • Ort
    • Der Ort der Postanschrift des Kunden
  • Telefon
    • Optional: Die Telefonnummer des Kunden 
    • nur eine Nummer möglich
  • Email
    • Optional: Die E-Mail-Adresse des Kunden
    • nur eine E-Mail-Adresse möglich
  • ZahlungszielInTagen
    • Optional: Das Zahlungsziel für den Kunden in Tagen
  • Bemerkung
    • Optional: Eine Freitextbemerkung zum Kunden

Beispieldatei: https://static.helpjuice.com/helpjuice_production/uploads/upload/image/9021/4090508/1716552561094-DatenImport_TestCase36461_Kunden_valid_noUnkownColumns_4.csv

Die Beispieldatei enthält die notwendigen Spalten als auch ein paar Beispiele. Du kannst die mit einem Texteditor oder Tabellenkalkulationsprogramm bearbeiten.

 

Datei für Fahrzeugdaten

Die Datei muss im CSV-Format vorliegen. Die einzelnen Spalten innerhalb der CSV-Datei müssen durch ein Semikolon (;) getrennt sein.

Die CSV-Datei muss in der ersten Zeile folgende Spalten in exakt der folgenden Schreibweise enthalten:

  • Kennzeichen
    • KFZ-Kennzeichen des Fahrzeugs
  • FIN
    • Fahrzeugidentifikationsnummer des Fahrzeugs
    • 17-Stellen
  • HSN
    • Herstellerschlüsselnummer der KBA-Nummer
    • 4-Stellen
  • TSN
    • Typschlüsselnummer der KBA-Nummer
    • 3-Stellen
  • Hersteller 
    • Name des Fahrzeugherstellers
  • Modell
    • Name des Fahrzeugmodells
  • KTyp
    • Die KTyp-Nummer des Fahrzeugs. (interne Nummer im TecDoc-Fahrzeugstamm
  • Kilometerstand
    • Der Kilometerstand des Fahrzeugs in km
  • Erstzulassung
    • Das Erstzulassungsdatum des Fahrzeugs
    • Format: JJJJ-MM-DDT00:00:00
    • Beispiel: 1957-10-19T00:00:00 für Erstzulassungsdatum am 19.10.1957
  • Motorcode
    • Motorcode des Fahrzeugmotors
  • Motornummer
    • Motornummer des Fahrzeugmotors
  • Farbcode
    • Farbcode der Fahrzeuglackierung
  • Nächste HU
    • Das Datum, an dem die nächste Hauptuntersuchung fällig wird
    • Format: JJJJ-MM-DDT00:00:00
    • Beispiel: 1957-10-19T00:00:00 für Erstzulassungsdatum am 19.10.1957
  • ZulaessigesGesamtgewicht
    • Das zulässige Gesamtgewicht des Fahrzeug in kg
  • Bemerkung
    • Optionale Bemerkung zum Fahrzeug
  • AlteKundennummer
    • Die Kundennumer des Kunden, dem das Fahrzeug im alten System zugeordnet war.

Beispieldatei: https://static.helpjuice.com/helpjuice_production/uploads/upload/image/9021/4090507/1716552561104-DatenImport_TestCase36461_Fahrzeuge_valid_noUnkownColumns_5.csv

Die Beispieldatei enthält die notwendigen Spalten als auch ein paar Beispiele. Du kannst die mit einem Texteditor oder Tabellenkalkulationsprogramm bearbeiten.

Importprozess

Neuen Import anlegen

Um einen neuen Import zu starten, navigiere in die Hilfe und klick auf Daten importieren.


Unter "Hilfe" kann im Bereich “Datenimport” der Importprozess mit Klick auf “Daten importieren” gestartet werden.

Du wirst auf die Importübersicht weitergeleitet. Je nachdem ob du bereits Importe durchfgeführt hast, werden dort vergangene Importe und deren Ergebnis dargestellt.

Klicke auf die Schaltfläche Neuen Import starten, um einen neuen Import anzulegen. Du wirst auf die Seite “Kunden- und Fahrzeugdaten hochladen” weitergeleitet.


In dieser Importübersicht wurden zuvor bereits Importe durchgeführt. Zwei davon wurden abgeschlossen, zwei wurden verworfen, d.h. die Daten wurden doch nicht importiert. Mit Klick auf “Neuen Import starten” kann ein neuer Import angelegt werden.
Importlimit beachten

In der Importübersicht wird die direkt eine Infobox zum Importlimit angezeigt: Aktuell kannst du solange Kunden- und Fahrezugdaten importieren bis 1000 Kunden und 1000 Fahrzeuge sich in deiner Werkstatt.NXT-Werkstatt befinden.

Immer nur ein Import gleichzeitig

Sobald ein Import angelegt wurde, wird dieser analysiert und muss dann von dir abgeschlossen oder verworfen werden. Solange kann kein neuer Import angelegt werden.

Kunden- und Fahrzeugdaten zur Analyse hochladen

Auf der Seite “Kunden- und Fahrzeugdaten hochladen” kannst du nun die im Abschnitt “Importformat” definierten Dateien hochladen. Klicke dazu jeweils auf die Schaltfläche Kundendaten hinzufügen bzw. Fahrzeugdaten hinzufügen und wähle dann die richtige Datei aus.


In diesem Beispiel wurde die Datei “DatenImport_Demo_Kunden.csv” bereits ausgewählt. Die Datei für Fahrzeugdaten muss noch ausgewählt werden.

 


Mit Klick auf Daten zur Analye hochalden werden die von dir ausgewählten Dateien zur Analyse an unsere Server geschickt.

Wenn du beide Dateien ausgewählt hast, klicke auf den Button Daten zur Analyse hochladen. Nach einer kurzen Wartezeit, wirst auf eine Informationsseite weitergeleitet.


Auf der Infoseite erhältst du eine Übersicht, was mit den Daten passiert und dass du etwas länger warten musst.
Bitte abwarten

Sobald die Analyse abgeschlossen ist, kannst du den Importprozess fortsetzen. Dies kann je nach Menge der Daten länger dauern. In der Zwischenzeit kannst du Werkstatt.NXT normal weiterverwenden.

Analysierte Daten auf Richtigkeit prüfen und bei Bedarf korrigieren

E-Mail abwarten

Wenn du eine E-Mail erhalten hast, kannst du einfach auf den Button in der E-Mail klicken oder den darunterstehenden Link kopieren und in die Adresszeile deines Browser eingeben, um mit dem Importprozess fortzufahren.

Die E-Mail sieht in etwa so aus. Klicke auf den Button Daten prüfen und Import fortsetzen un den Import fortzusetzen.

Du landest dann auf der folgenden Seite.

Mit Klick auf Details anzeigen kannst du dir genauer anzeigen lassen, welche Spalten und Zeilen Werkstatt.NXT erkannt hat und welche nicht.

Mit Klick auf Import verwerfen kannst du den Import verwerfen, sodass keine hochgeladenen Daten importiert werden. Die Daten werden dann von unseren Servern entfernt.

Mit Klick auf Daten prüfen kannst du den Importprozess fortsetzen und die Kunden- sowie die Fahrzeugdaten auf Korrektheit prüfen und ggf. bearbeiten.

Daten prüfen

Nach Klick auf Daten prüfen wirst du auf eine Liste mit allen in der hochgeladenen Kundendatei gefundenen Kundendatensätzen weitergeleitet.

In der Liste kannst du erkennen, wie viele Datensätze erkannt wurden und bei welchen Datensätzen Fehler vorhanden sind, die Werkstatt.NXT daran hindern den Datensatz zu importieren.

In diesem Fall wurden insgesamt 4 Kunden in der hochgeladenen Datei erkannt. Bei einem Kunden sind jedoch fehlerhafte oder fehlende Daten enthalten.

Mit Klick auf den Button mit dem “Bearbeiten”-Icon am Listeneintrag, kannst du die fehlerhaften Datensätze nochmals prüfen und korrigieren. In diesem Beispiel nehem wir den vierten Datensatz in dem laut Werkstatt.NXT “Mehr als ein Fehler vorhanden” ist.

Ein Dialog erscheint, der es dir erlaubt, die Kundendaten zu bearbeiten. Dabei werden alle fehlerhaften Felder visuell hervorgehoben, sodass du erkennen kannst, wo Fehler vorhanden sind:

Bei diesem Kunden fehlt die Postleitzahl in der Postanschrift sowie das Zahlungsiel in Tagen. Darüberhinaus wurden Sonderzeichen nicht korrekt erkannt. Diese kannst du entsprechend ausbessen.

Nachdem du Korrekturen vorgenommen hast, klicke auf Speichern, um die Änderungen abzuspeichern.

Danach wird der Fehler in der Liste nicht mehr angezeigt. Wenn keine Fehler mehr bestehen, wir der Kundendatensatz automatisch für den Import ausgewählt.

Auch der vierte Listeneintrag ist nun, da der Fehler behoben wurde ausgewählt (Checkbox links)

Wiederhole den Prozess bei Bedarf für jeden Kunden mit Fehlern, den du importieren möchtest. Danach kannst du mit dem Button Weiter mit ausgwählten Kunden zum nächsten Schritt “Fahrzeugdaten prüfen” navigieren.

Die Prüfung der Fahrzeugdaten erfolgt analog zu den Kundendaten mithilfe einer Liste. Bei Fehlerhaften Datensätzen kannst du die Fahrzeugdaten mit Klick auf den Bearbeiten-Button korrigieren.

Die Prüfung der Fahrzeugdaten erfolgt analog mit einer Liste der in der hochgeladenen Datei erkannten Fahrzeugdaten.

Wiederhole den Prozess bei Bedarf für jedes Fahrzeug mit Fehlern, das du importieren möchtest. Danach kannst du mit dem Button Weiter mit ausgwählten Fahrzeugen zum nächsten Schritt “Zusammenfassung” navigieren.

Import abschließen

Im letzten Schritt “Zusammenfassung” wird nochmal zusammengefasst wie viele Kunden- und Fahrzeugdatensätze importiert werden und wie viele nicht importiert werden.

Die Zusammenfassung zeigt in diesem Beispiel an, dass 4 Kunden für den Import ausgewählt sind und 4 Fahrzeuge für den Import ausgewählt sind. 1 Fahrzeugdatensatz ist aufgrund eines nicht behobenen Fehler nicht für den Import ausgewählt und wird deshalb auch nicht importiert.

Falls du hier Fehler entdeckst oder dir etwas komisch vorkommt, kannst du über den Button Zurück nochmal in die Kunden- bzw. Fahrzeugdatenliste gehen und prüfen, ob alle Fehler beseitigt wurden und alle gewünschten Kunden/Fahrzeuge für den Import ausgewählt sind.

Klicke auf “Import jetzt durchführen” um die ausgewählten Kunden- und Fahrzeugdatensätze als Kunden und Fahrzeuge zu importieren.

Nach einer kurzen Ladezeit erhätlst du eine Erfolgsmeldung. Du kannst nun mit den Kunden und Fahrzeugen in Werkstatt.NXT arbeiten und diese in Angeboten, Aufträgen, Rechnungen und Terminen verwenden.


    • Related Articles

    • Was sind Schnittstellen in Werkstatt.NXT?

      Werkstatt.NXT bietet Schnittstellen zu verschiedenen digitalen Systemen von Drittherstellern an, um dir die Integration von Werkstatt.NXT in deinen bestehenden Arbeitsalltag und deine Prozesse so leicht wie möglich zu machen. Schnittstellentypen Je ...
    • Werkstatt.NXT Partner-Varianten

      Wir bieten Werkstatt.NXT in einer Version für alle an: werkstatt-nxt.com. Diese Version erkennst du am blau-goldenen Farbschema. Wir nennen diese Variante Werkstatt.NXT Native. Darüberhinaus haben wir Partner mit denen wir gemeinsam Partner-Varianten ...
    • Wie funktioniert die Erkennung bestehender Kunden und Fahrzeuge?

      Wenn du oder einer deiner Mitarbeiter den Fahrzeugscheinscanner verwendet, um einen Kunden und ein Fahrzeug anzulegen, kann es vorkommen, dass der Kunde und/oder das Fahrzeug bereits in Werkstatt.NXT angelegt wurde. Um zu vermeiden, dass derselbe ...
    • Was kann ich in Werkstatt.NXT herunterladen?

      Unter dem Menüpunkt Downloads findest du eine Übersicht über alles Inhalte in Werkstatt.NXT, die du in großen Mengen auf einmal herunterladen und exportieren kannst. Aktuell können folgende Daten heruntergeladen werden: Angebotsdaten Auftragsdaten ...
    • Was ist ein Kunde in Werkstatt.NXT?

      Die Basics Ein Kunde in Werkstatt.NXT einer deiner Kunden. Das hört sich einfach an, doch wir möchten es an dieser Stelle klarstellen. Kunden in Werkstatt.NXT können angelegt und wichtige Informationen wie Name, Anschrift und noch mehr erfasst ...