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 und welche Stammdaten bereits im System vorhanden sind.

👉 Der weitere Ablauf im Integrationsguide 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 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.

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 erfolgreichen API-Call

Typischer Einsatz

  • ERP / WMS übergibt Lieferadresse

  • Erste Tests oder Proof-of-Concept

  • Geringe Komplexitä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 '{ ... }'

⚠️ Sicherheitshinweis:
Für produktive Integrationen wird die Übergabe des Tokens im HTTP-Header empfohlen, da Tokens in URLs in Logs oder Browser-Historien erscheinen können.

 

 

Back to top