---
title: "Structured Data Import"
description: "Mit Structured Data Import importieren Sie Massendaten aus CSV-, Excel- (XLSX) oder XLS-Dateien ganz einfach in Orbit."
url: "https://support.pr-2.orbit.do/de/advanced-features/structured-data-import"
locale: "de"
apps: ["mission"]
lastReviewed: "2026-10-23"
---

# Structured Data Import

Mit Structured Data Import importieren Sie Massendaten aus CSV-, Excel- (XLSX) oder XLS-Dateien ganz einfach in Orbit.

## Überblick

Mit Structured Data Import importieren Sie Massendaten aus CSV-, Excel- (XLSX) oder XLS-Dateien ganz einfach in Orbit. So legen Sie mehrere Shipments in einem einzigen Vorgang an.

## Wichtige Funktionen

* Interaktiver Datei-Upload mit Vorschau
* Intelligente Spaltenzuordnung mit Feldprüfung
* Prüfung der Daten und Korrektur von Fehlern
* Unterstützung komplexer Datenstrukturen, auch verschachtelter Felder
* Flexible Datumsformate (DD.MM.YYYY für das deutsche Format)

## So funktioniert es

### 1. Datei hochladen

Klicken Sie zuerst im TransportComposer auf die Import-Schaltfläche. Die Import-Schaltfläche ist nur sichtbar, wenn die verwendete TransportShape strukturierte Datenimporte unterstützt.

Sie können hochladen:

* CSV-Dateien
* Excel-Dateien (.xlsx und .xls)

![Screenshot vom 14.05.2025 um 10.33.17](https://support.pr-2.orbit.do/images/structured-data-import/screenshot-2025-05-14-at-10-33-17.png)

*Die Schaltfläche für Structured Data Import im TransportComposer*

### 2. Felder zuordnen

Das System führt Sie durch die Zuordnung der Spalten Ihrer Datei zu den passenden Orbit-Feldern. Die Zuordnungsansicht bietet:

* Automatische Vorschläge für die Zuordnung
* Vorschau Ihrer Daten
* Möglichkeit, Zuordnungen zu ändern und zu korrigieren

### 3. Daten prüfen

Vor dem endgültigen Import prüft das System Ihre Daten gegen festgelegte Regeln:

* Prüfung der Feldformate
* Prüfung der Pflichtfelder
* Prüfung der Geschäftslogik
* Prüfung der Adressen

### 4. Prüfen und importieren

Nach der Prüfung:

* Sehen Sie sich Fehler und Warnungen an
* Korrigieren Sie, was nötig ist, direkt in der Ansicht
* Bestätigen und schließen Sie den Import ab

Für jedes Shipment und jede Order, die der Import anlegt oder ändert, nennt der Verlauf in Orbit MissionControl den Operator, der die Datei hochgeladen hat, zum Beispiel **Erstellt über CSV-Import** von Julia Weber. Enthält ein Import fehlerhafte Daten, sehen Sie so, wen aus Ihrem Team Sie darauf ansprechen. Ältere Importe, bei denen nicht erfasst wurde, wer sie hochgeladen hat, zeigen **CSV-Import** statt eines Namens.

## Empfehlungen

* Sorgen Sie für klare Spaltenüberschriften in Ihren CSV- und Excel-Dateien
* Verwenden Sie einheitliche Datumsformate (DD.MM.YYYY empfohlen)
* Prüfen Sie, ob alle Pflichtfelder gefüllt sind
* Für Shipments mit mehreren Ladungen (Load) nutzen Sie nummerierte Spalten (z. B. load\_1\_type, load\_1\_count)

## Beispiel

Einen Beispiel-Import für Shipments können Sie in den Workbench Einstellungen für den [TransportComposer](https://support.pr-2.orbit.do/de/core-features/transport-composer) mit der [Transport Shape](https://support.pr-2.orbit.do/de/advanced-features/transport-shape) „Basic Shipment“ einrichten. Testen Sie den Import mit der Beispiel-CSV-Datei.

[Importable Example Shipments.csv](https://www.notion.so/joinorbit/Structured-Data-Import-1ea062a5be3e80c99aa5e3ed1489035e?source=copy_link#1f2062a5be3e804d9064d63b5f548b32)

## Fehlerbehandlung

Wenn beim Import Fehler auftreten:

* Das System markiert die betroffenen Zeilen und Felder
* Sie können Fehler direkt in der Ansicht korrigieren
* Teilimporte werden unterstützt: Erfolgreiche Datensätze werden importiert, fehlgeschlagene können Sie korrigieren

## Einschränkungen

* Höchstens 10 Ladungen pro Shipment im CSV-Format
* Zeitstempel werden in der Zeitzone UTC+1 verarbeitet
* Für die Zuordnung des Shippers ist entweder eine E-Mail-Adresse oder eine shipperId nötig