---
title: "Datenimport – Containerdaten importieren"
description: "Ein umfassender Leitfaden zum Import von Containerdaten. Dieser Prozess ermöglicht die Massenanlage von Containern des eigenen Unternehmens und seiner Subunternehmer und stellt einen sofort verfügbaren Katalog für die Auftragserstellung bereit."
url: https://help.qargo.com/de/articles/410131-datenimport-containerdaten-importieren
locale: de
updated: 2026-08-07
---

# Datenimport – Containerdaten importieren

Der Import von Containerdaten ermöglicht die Massenanlage von Containern, die entweder dem eigenen Unternehmen oder einem Subunternehmer gehören können. Für Organisationen, die eigene Containerflotten verwalten, ist dies ein entscheidender Schritt. So steht eine sofort verfügbare Datenbank für die Auftragserstellung bereit. Dieser Artikel beschreibt die spezifischen Anforderungen, bewährte Vorgehensweisen und häufige Probleme beim Import von Containerdaten.

* * *

## 📖 Wichtige Begriffe {#h_bb93f4d3d4}

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

-   **Container:** Eine wiederverwendbare Transport- und Lagereinheit.
-   **Container-Nr.:** Die eindeutige Kennung eines Containers.
-   **Subunternehmer:** Ein Unternehmen, das einen Container besitzt oder betreibt.
-   **Code:** Eine eindeutige Kennung eines Containers aus einem externen System, mit der sich genaue Datenaktualisierungen sicherstellen lassen.


* * *

## ✅ Wichtige Importanforderungen für Container {#h_a8dc0ba2c5}

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

-   **Voraussetzung Subunternehmer:** Bevor ein Container 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 identifiziert bestehende Container anhand ihrer eindeutigen **Container-Nr.**
-   **Pflichtfeld:** Der **Name** des Containers ist ein Pflichtfeld. Ein Import schlägt fehl, wenn dieses Feld leer bleibt.


* * *

## 🛠️ Datenimport Schritt für Schritt {#h_0320dd7921}

## Schritt 1: Vorlage herunterladen {#h_256dbde572}

Für das Hochladen von Containerdaten steht eine eigene 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 Containerdaten](https://docs.google.com/spreadsheets/d/18iCOvgK_GFgtOPK6h02Vb1Dq7hKqKnwretYO5j4nrC0/edit?usp=sharing)
2.  Nach dem Öffnen der Vorlage **Datei** aufrufen und **Herunterladen** auswählen
3.  Die Vorlage **(im Format .xlsx oder .csv)** auf dem Computer speichern und mit der Eingabe der Unternehmensdaten beginnen.

![](https://help.qargo.com/media/035e09bc7dbc-image.png)

:::callout{tone="info"}
📚 Immer eine leere Vorlage verwenden, die direkt hier heruntergeladen oder vom Qargo-Team bereitgestellt wurde. Die Wiederverwendung einer alten Vorlage kann zu Importfehlern führen.
:::

## Schritt 2: Excel-Vorlage ausfüllen {#h_2cf9e27d5d}

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 findet sich 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) ist genau zu achten.


## Schritt 3: Zum Hochladen einreichen {#h_33834aab0f}

1.  **Während des Onboardings:** Die ersten Geschäftsdaten direkt gemeinsam mit dem zuständigen **Onboarding-Manager** hochladen. Dabei erfolgt eine Begleitung durch den gesamten Prozess, und ein erfolgreicher Import wird sichergestellt.
2.  **Nach dem Onboarding:** Für alle künftigen Datenaktualisierungen und Importe den zuständigen **Account-Manager** kontaktieren. Dieser unterstützt beim Hochladen und bietet fortlaufenden Support.


* * *

## 📝 Details der Vorlage für den Containerimport {#h_723b086936}

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

| **Spaltenname** | **Pflicht/optional** | **Anmerkungen** | **Beispiel** |
| --- | --- | --- | --- |
| name | Pflicht | In Qargo angezeigter Containername |  |
| code | Optional |  |  |
| manufacturer | Optional |  | Exagon |
| container\_number | Optional |  | 1212 |
| standard\_size | Optional |  | Feet\_25 |
| note | Optional |  |  |
| subcontractor\_company | Optional |  |  |
| gross\_weight | Optional | Tonnen | 1 |
| tare\_weight | Optional | Kilogramm | 1.0 |
| capacity\_volume | Optional | m³ | 1.000 |
| capacity\_weight | Optional |  | 1 |
| exterior\_length | Optional | Meter | 1.000 |
| exterior\_width | Optional | Meter | 1.000 |
| exterior\_height | Optional | Meter | 1.000 |
| custom\_fields\_\_example | Optional | Zum Importieren von Werten benutzerdefinierter Felder. Hinweis: Das Format verwendet einen doppelten Unterstrich (`__`), um das Präfix **custom\_fields** mit der eindeutigen Feld-ID zu verbinden |  |

### Standardgröße: zulässige Werte {#h_b0b8beeb1c}

Die Spalte `standard_size` akzeptiert die folgenden Werte. Das Format muss exakt übereinstimmen (das Feld unterscheidet nicht zwischen Groß- und Kleinschreibung, das unten gezeigte Muster aus Unterstrich und Großschreibung wird jedoch empfohlen):

| **Wert** | **Größe** |
| --- | --- |
| `Feet_20` | 20 ft |
| `Feet_23` | 23 ft |
| `Feet_24` | 24 ft |
| `Feet_25` | 25 ft |
| `Feet_26` | 26 ft |
| `Feet_30` | 30 ft |
| `Feet_35` | 35 ft |
| `Feet_40` | 40 ft |

* * *

## 🔎 Häufige Fehler beim Containerimport beheben {#h_7279833172}

Dieser Abschnitt behandelt spezifische Fehler, die beim Import von Containerdaten auftreten können.

-   **Datensatz des Subunternehmers nicht gefunden:** Dies ist der häufigste Fehler bei Containern 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 dessen Container importiert werden können.
-   **Tabellenblattname:** Das Tabellenblatt in der Excel-Vorlage muss exakt **„Import“** heißen. Jeder andere Name führt beim Hochladen der Datei zu einem Fehler.
-   **Fehlendes Pflichtfeld:** Der Import schlägt für jede Zeile fehl, in der der Name des **Containers** leer bleibt.
-   **Groß-/Kleinschreibung bei Spaltenüberschriften:** Spaltenüberschriften müssen in der korrekten Groß-/Kleinschreibung eingegeben werden (z. B. `vat_number`, nicht `VAT_number`). Bei falscher Schreibweise werden die Daten dieser Spalte ohne Meldung ignoriert und nicht importiert, da das System die Überschrift nicht erkennt.
-   **Fehler durch führenden 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 vorgibt, 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 abrufbar. Auf die Kopierschaltfläche neben dem benutzerdefinierten Feld klicken, um dessen ID zu kopieren:

    ![](https://help.qargo.com/media/a6013003827e-796a5c17-3b5e-4a0d-9642-08cfd8176cd4.png)


* * *

## ✨ Bewährte Vorgehensweisen beim Import von Containern {#h_90ca1ae879}

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

-   **Vollständige Subunternehmerdaten sicherstellen:** Vor dem Import von Containern der Subunternehmer prüfen, ob alle zugehörigen Subunternehmer bereits erfolgreich als Unternehmen in das System importiert wurden.
-   **Datenkonsistenz wahren:** Auf die Schreibweise sowie die Groß- und Kleinschreibung der **Subunternehmernamen** und **Container-Nr.** genau achten. Jede Abweichung führt dazu, dass die Verknüpfung fehlschlägt.
-   **Code des Containers nutzen:** Das Feld **Code** des Containers ist zwar optional, seine Verwendung wird jedoch dringend empfohlen. Es bietet eine zuverlässige Möglichkeit, Containerdatensätze zu aktualisieren, und verhindert Konflikte, die durch doppelte Nummern entstehen können.

* * *

## ➡️ Nächste Schritte {#h_122fb131d9}

Nach dem erfolgreichen Import können die Container bei der Auftragserstellung verwendet werden. Die nächsten sinnvollen Schritte sind:

-   **Produkte importieren:** Bei Bedarf können die bei der Auftragserstellung verwendeten Produkte gesammelt importiert werden.
-   **Aufträge importieren:** Ein Beispielsatz von Testaufträgen kann importiert werden, um eine Sandbox-Umgebung zu befüllen.


* * *

## 📈 Anwendungsfälle für den Containerimport {#h_0d31aa2d5e}

Der Import von Containerdaten ist ein wertvolles Werkzeug für mehrere zentrale Geschäftsprozesse.

-   **Ersteinrichtung der Flotte:** Der wichtigste Anwendungsfall besteht darin, einen Qargo-Mandanten mit einer gesamten Containerflotte zu befüllen, einschließlich eigener Container und Container regelmäßiger Subunternehmer.
-   **Onboarding einer neuen Flotte:** Wenn eine neue Geschäftseinheit oder Containerflotte hinzukommt, können deren Details gesammelt in das Qargo-System übernommen werden.


## Verwandte Artikel

- [Datenimport – Fahrzeugdaten importieren](https://help.qargo.com/de/articles/410124-datenimport-fahrzeugdaten-importieren.md)
- [Datenimport – Fahrerdaten importieren](https://help.qargo.com/de/articles/410123-datenimport-fahrerdaten-importieren.md)
- [Datenimport: Kontaktdaten importieren](https://help.qargo.com/de/articles/410121-datenimport-kontaktdaten-importieren.md)
- [Datenimport – Kontaktstandortdaten importieren](https://help.qargo.com/de/articles/494334-datenimport-kontaktstandortdaten-importieren.md)
- [Datenimport: Produktdaten importieren](https://help.qargo.com/de/articles/410133-datenimport-produktdaten-importieren.md)
