---
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-4.orbit.do/de/advanced-features/structured-data-import"
locale: "de"
lastReviewed: "2025-07-10"
---

# 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-4.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

## 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-4.orbit.do/de/core-features/transport-composer) mit der [Transport Shape](https://support.pr-4.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