Skip to main content
Qargo

Datenimport – Fahrzeugdaten importieren

Ein umfassender Leitfaden zum Import von Fahrzeugdaten, der die Massenerstellung von Fahrzeugen des eigenen Unternehmens und seiner Subunternehmer ermöglicht. Dies ist ein entscheidender Schritt, um die Flotte für die Zuweisung vorzubereiten.

Inhaltsverzeichnis
  1. 📖 Wichtige Begriffe
  2. ✅ Wichtige Importanforderungen für Fahrzeuge
  3. 🛠️ Datenimport Schritt für Schritt
  4. Schritt 1: Vorlage herunterladen
  5. Schritt 2: Excel-Vorlage ausfüllen
  6. Schritt 3: Zum Upload einreichen
  7. 📝 Details der Vorlage für den Fahrzeugimport
  8. 🔎 Häufige Fehler beim Fahrzeugimport beheben
  9. ✨ Bewährte Vorgehensweisen beim Fahrzeugimport
  10. ➡️ Nächste Schritte
  11. 📈 Anwendungsfälle für den Fahrzeugimport

Der Import von Fahrzeugdaten ermöglicht die Massenerstellung von Fahrzeugen, die entweder zum eigenen Unternehmen oder zu einem Subunternehmer gehören. Dies ist ein entscheidender Schritt, um das Qargo-System für die Zuweisung von Transportaufträgen und die Verwaltung der Flotte vorzubereiten. Dieser Artikel beschreibt die konkreten Anforderungen, bewährte Vorgehensweisen und häufige Probleme beim Import von Fahrzeugdaten.


📖 Wichtige Begriffe

Zur besseren Verständlichkeit werden in diesem Leitfaden die folgenden Begriffe verwendet.

  • Fahrzeug: Ein Lkw, Traktor, Trailer, Chassis, Van oder jede andere Fahrzeugart, die für den Transport eingesetzt wird.
  • Kennzeichen: Die eindeutige Kennung eines Fahrzeugs. Es wird auch als amtliches Kennzeichen bezeichnet.
  • Subunternehmer: Ein Unternehmen, das Transportservices für die eigene Organisation erbringt.
  • Code: Eine eindeutige Kennung eines Fahrzeugs aus einem externen System. Damit lassen sich Daten zuverlässig aktualisieren.

✅ Wichtige Importanforderungen für Fahrzeuge

Vor dem Import von Fahrzeugdaten sind die folgenden Anforderungen und Warnhinweise zu beachten, um die Datenintegrität sicherzustellen.

  • Voraussetzung Subunternehmer: Bevor ein Fahrzeug eines Subunternehmers importiert werden kann, muss der Unternehmensdatensatz des Subunternehmers bereits im Qargo-System vorhanden sein. Der Import schlägt fehl, wenn der angegebene Subunternehmer nicht gefunden wird.
  • Eindeutige Identifizierung: Qargo erkennt bestehende Fahrzeuge an ihrem eindeutigen Kennzeichen.
  • Pflichtfelder: Name und Fahrzeugtyp (z. B. Traktor, Van, Motorwagen) sind Pflichtfelder. Ein Import schlägt fehl, wenn diese Felder leer bleiben.

🛠️ Datenimport Schritt für Schritt

Schritt 1: Vorlage herunterladen

Für den Upload von Fahrzeugdaten steht eine spezielle Tabellenvorlage zur Verfügung. Um die Daten bearbeiten und hochladen zu können, muss eine Kopie der Vorlage heruntergeladen werden:

  1. Auf den Link klicken: Vorlage für den Import von Fahrzeugdaten
  2. Nach dem Öffnen der Vorlage Datei > Herunterladen auswählen
  3. Die Vorlage (im Format .xlsx oder .csv) auf dem Computer speichern und mit der Eingabe der Unternehmensdaten beginnen.

Schritt 2: Excel-Vorlage ausfüllen

Die Vorlage öffnen und mit den erforderlichen Daten befüllen. Die Vorlage enthält Spaltenüberschriften, die den Feldern in Qargo entsprechen.

  • Pflichtfelder: Alle Pflichtfelder ausfüllen (eine vollständige Liste der Pflichtfelder steht im nächsten Abschnitt dieses Artikels). Ein Import schlägt fehl, wenn diese Felder leer bleiben.
  • Formatierung: Auf das vorgegebene Datenformat (z. B. Datumsangaben, Zahlen, Text) genau achten.

Schritt 3: Zum Upload einreichen

  1. Während des Onboardings: Für den Upload der ersten Geschäftsdaten direkt mit dem Onboarding-Manager zusammenarbeiten. Dieser begleitet durch den Prozess und stellt einen erfolgreichen Import sicher.
  2. Nach dem Onboarding: Für alle künftigen Datenaktualisierungen und Importe an den Account-Manager wenden. Dieser unterstützt beim Upload und bietet fortlaufenden Support.

📝 Details der Vorlage für den Fahrzeugimport

Die folgende Tabelle erläutert die Excel-Vorlage für den Fahrzeugimport Feld für Feld, einschließlich Datenformaten, Pflichtfeldern und bewährten Vorgehensweisen für das Befüllen jeder Spalte.

Spaltenname Erforderlich/optional Hinweise Beispiel
vehicle_type Erforderlich TRACTOR/VAN/RIGID/TRAILER TRAILER
name Erforderlich In Qargo angezeigter Fahrzeugname 12BLT2 oder VAN2
code Optional
note Optional
manufacturer Optional Exagon
model Optional B12
vin_number Optional
license_plate Optional 12BLT2
axle_configuration Optional D. h. 4 x 2: 4 sind die Trailerräder und 2 die angetriebenen Räder (Traktor/Zugeinheit).\
Die Achskonfiguration muss korrekt eingegeben werden, um in einigen Ländern, z. B. Frankreich, eine genaue Mautberechnung zu gewährleisten. 4 x 2
roof type Optional CLOSED, OPEN oder FLATBED CLOSED
fuel_type Optional DIESEL, BIOFUELS, LPG, ELECTRIC, HYBRID_ELECTRIC DIESEL
emission_class Optional EURO_3
subcontractor_company Optional
co3_object_id Optional
co3_active Optional TRUE oder FALSE
verizon_connect_object_id Optional
verizon_connect_active Optional TRUE oder FALSE
transics_object_id Optional
transics_active Optional TRUE oder FALSE
trimble_object_id Optional
trimble_active Optional TRUE oder FALSE
webfleet_object_id Optional
webfleet_active Optional TRUE oder FALSE
samsara_object_id Optional
samsara_active Optional TRUE oder FALSE
generic_object_id Optional
generic_active Optional TRUE oder FALSE
generic_integration_code Optional
archived Optional TRUE oder null
tare_weight Optional Kilogramm 1.0
gross_weight Optional Tonnen 1
capacity_weight Optional 1
capacity_volume Optional m³ 1.000
capacity_ldm Optional 1
capacity_pallet_spaces Optional 1
capacity_length Optional Meter 1.000
capacity_width Optional Meter 1.000
capacity_height Optional Meter 1.000
exterior_height Optional Meter 1.000
exterior_width Optional Meter 1.000
exterior_length Optional Meter 1.000
validity_start_timestamp Optional JJ/MM/TT 2020/01/20
validity_end_timestamp Optional JJ/MM/TT 2026/01/20
validity_description Optional
custom_fields__example Optional Zum Import von Werten benutzerdefinierter Felder. Hinweis: Das Format verwendet einen doppelten Unterstrich (__), um das Präfix custom_fields mit der eindeutigen Feld-ID zu verbinden

🔎 Häufige Fehler beim Fahrzeugimport beheben

Dieser Abschnitt behandelt konkrete Fehler, die beim Import von Fahrzeugdaten auftreten können.

  • Datensatz des Subunternehmers nicht gefunden: Dies ist der häufigste Fehler bei Fahrzeugen von Subunternehmern. Er tritt auf, wenn der Name des Subunternehmers in der Vorlage nicht exakt mit einem bestehenden Unternehmen in Qargo übereinstimmt. Der Subunternehmer muss im System vorhanden sein, bevor seine Fahrzeuge importiert werden können.

  • Fehlende Pflichtfelder: Der Import schlägt für jede Zeile fehl, in der Fahrzeugname oder Typ leer bleibt.

  • Name des Tabellenblatts: Das Tabellenblatt in der Excel-Vorlage muss exakt „Import“ heißen. Jeder andere Name führt beim Hochladen der Datei zu einem Fehler.

  • Ungültiger Fahrzeugtyp: Sicherstellen, dass der eingegebene Fahrzeugtyp (z. B. „TRAILER“) eine gültige Option in der Qargo-Plattform ist.

  • Groß- und Kleinschreibung bei Spaltenüberschriften: Spaltenüberschriften müssen mit der korrekten Groß- und Kleinschreibung eingegeben werden (z. B. vat_number, nicht VAT_number). Bei falscher Schreibweise erkennt das System die Überschrift nicht. Die Daten in dieser Spalte werden dann ohne Hinweis ignoriert und nicht importiert.

  • Fehler durch führendes Apostroph: Daten in einer Zelle dürfen nicht mit einem Apostroph (’) beginnen. Wird ein Apostroph verwendet, erkennt das System den Wert nicht, und es kann ein Fehler auftreten. Diese Regel gilt nur dann nicht, wenn der Artikel ausdrücklich angibt, dass für ein bestimmtes Feld ein Apostroph zu verwenden ist.

  • Benutzerdefinierte Felder: Der Spaltenname muss der Konvention custom_field__[ID] folgen (dabei den doppelten Unterstrich beibehalten, der das Präfix custom_field mit der eindeutigen Feld-ID verbindet). Die jeweilige ID ist in den Organisationseinstellungen von Qargo zu finden. Auf die Schaltfläche zum Kopieren neben dem benutzerdefinierten Feld klicken, um dessen ID zu kopieren:


✨ Bewährte Vorgehensweisen beim Fahrzeugimport

Für einen reibungslosen und genauen Import empfehlen sich die folgenden Vorgehensweisen.

  • Vollständige Subunternehmerdaten sicherstellen: Vor dem Import von Fahrzeugen der Subunternehmer prüfen, ob alle zugehörigen Subunternehmer bereits erfolgreich als Unternehmen in das System importiert wurden.
  • Einheitliche Daten pflegen: Genau auf die Felder Subunternehmer und Kennzeichen achten. Schon Tippfehler oder eine abweichende Groß- und Kleinschreibung führen dazu, dass die Verknüpfung fehlschlägt.
  • Feld „Code“ nutzen: Das Feld Code ist zwar optional, seine Verwendung wird jedoch dringend empfohlen. Es bietet eine zuverlässige Möglichkeit, Fahrzeugdatensätze zu aktualisieren, und verhindert Konflikte.

➡️ Nächste Schritte

Nach dem erfolgreichen Import können die Fahrzeuge in Kombinationen mit Fahrern verknüpft und in Aufträgen verwendet werden. Die nächsten sinnvollen Schritte sind:

  • Fahrer importieren: Bei Bedarf können nun eigene Fahrer oder Fahrer von Subunternehmern importiert werden.
  • Kombinationen konfigurieren: Fahrzeuge lassen sich durch das Erstellen von Kombinationen gesammelt mit Fahrern verknüpfen.

📈 Anwendungsfälle für den Fahrzeugimport

Der Import von Fahrzeugdaten ist ein äußerst wertvolles Werkzeug für mehrere zentrale Geschäftsprozesse.

  • Ersteinrichtung der Flotte: Der wichtigste Anwendungsfall ist das Befüllen eines Qargo-Mandanten mit einer kompletten Fahrzeugflotte, einschließlich eigener Fahrzeuge und der Fahrzeuge regelmäßig eingesetzter Subunternehmer.
  • Onboarding einer neuen Flotte: Wird eine neue Geschäftseinheit oder Flotte übernommen, lassen sich deren Fahrzeugdetails gesammelt in das Qargo-System übernehmen.