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überAdresseanlegen(empfohlenerEinstieg)

➡️

EinstiegundeinfacheIntegrationen

  • Schnellster

    Weg

    Typischer

    Einsatz

    • ERP / WMS übergibt Lieferadresse

    • Erste Tests oder Proof-of-Concept

    • Geringe Komplexität

    Wert Bedeutung
    0 id ist eine bekannte IdealLocation-Nummer fürin denDeDeFleet
    1 id ist eine bekannte Kundennummer

    Eigenschaften

    in
      DeDeFleet
    2Location wird vollständig über Adressdaten beschrieben

    definiert
    3Location wird über KeineKoordinaten Vorab-Stammdaten(Latitude/Longitude) erforderlich

    definiert
    4 id zumist ersteneine erfolgreichenbekannte API-Call

    Mitarbeiternummer in DeDeFleet

    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.

    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-Aufruf

    Pflichtfelder bei location.type = 2

    • street

    • postal

    • city

    • country

    Optional:

    • name

    • latitude

    • longitude

    Beispiel: Auftrag mit Adress-Location

    {
  "type": 0,
  "order": "ORDER-10001",
  "delivery": "DEL-10001",
  "location": {
    "type": 2,
    "name": "Musterkunde GmbH",
    "street": "Hauptstraße 12",
    "postal": "37154",
    "city": "Northeim",
    "country": "DE"
  }
}

    Ergebnis im System

    • ✔ Auftrag wird erstellt

    • ✔ Location wird automatisch angelegt

    • ❌ Auftrag ist unverplant

    ➡️ Weiter im Guide:
    Step 2 – Touren anlegen

     

    Back to top