Skip to main content

Step 1 – Auftrag anlegen (Create Order)

Grundidee dieses Schrittes

Ein Auftrag benötigt immer eine Location als Ziel.
Diese Location kann auf unterschiedliche Weise definiert werden – abhängig davon, wie weit die Integration gehen soll.soll und welche Stammdaten bereits im System vorhanden sind.

👉 Der weitere Ablauf im GuideIntegrationsguide richtet sich danach, wie die Location angegeben wird.

Entscheidungslogik

Wenn Sie neu mit der Integration starten:
➡️ Beginnen Sie mit Variante A – Location über Adresse anlegen.

Wenn Sie bereits mit Locations/KundenLocations oder Kundenstammdaten arbeiten:
➡️ Springen Sie direkt zu Variante B – Location referenzieren.


Auswahl: Wie wird die Location definiert?

Beim Anlegen eines Auftrags stehen zwei empfohlene Varianten zur Verfügung:Verfügung.

Variante A – Location über Adresse anlegen (empfohlener Einstieg)

➡️ Ideal für den Einstieg und einfache Integrationen

Eigenschaften

  • Location wird vollständig über Adressdaten beschrieben

  • Keine Vorab-Stammdaten erforderlich

  • Schnellster Weg zum ersten Auftragerfolgreichen API-Call

➡️Typischer Empfohlener Startpunkt für neue Integrationen

Variante B – Bestehende Location referenzieren (Advanced)

➡️ Für fortgeschrittene IntegrationenEinsatz

  • AuftragERP verweist/ aufWMS eineübergibt bereits existierende LocationLieferadresse

  • StammdatenErste werdenTests zentraloder gepflegtProof-of-Concept

  • ReduziertGeringe Dubletten und DatenpflegeKomplexität

Technische Umsetzung (API)

Endpoint

POST /orders

 

Vollständige URL

https://ortung.dedefleet.de/data/api/2

Authentifizierung

Für ➡alle API-Aufrufe ist ein gültiger Bearer Token erforderlich, der zuvor im DeDeFleet-Portal erzeugt wurde.

Der Token kann auf zwei Arten übergeben werden.

Variante 1 (empfohlen) – Bearer Token im HTTP-Header

Authorization: Bearer <BEARER_TOKEN>
Accept: application/json
Content-Type: application/json
Beispiel (curl)
curl -X POST "https://ortung.dedefleet.de/data/api/2/orders" \
  -H "Authorization: Bearer <BEARER_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Variante 2 – Bearer Token als URL-Parameter

?token=<BEARER_TOKEN>
Beispiel
?token=<BEARER_TOKEN>
Beispiel (curl)
curl -X POST "https://ortung.dedefleet.de/data/api/2/orders?token=<BEARER_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

⚠️ WirdSicherheitshinweis:
Für produktive Integrationen wird die Übergabe des Tokens im HTTP-Header empfohlen, da Tokens in einemURLs separatenin AbschnittLogs beschriebenoder Browser-Historien erscheinen können.

 

 

Back to top