Step 1 – Auftrag anlegen (Create Order)

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedeffleet.de/swagger/data/api/2#/Order/Order_Create

Grundidee dieses Schrittes

Ein Auftrag bildet in DeDeFleet den zentralen Planungspunkt für alle weiteren Prozesse der Tourenplanung.

Ein Auftrag beschreibt eine konkrete Tätigkeit, die an einem bestimmten Ort ausgeführt werden soll, zum Beispiel:

• eine Lieferung

• eine Abholung

• einen Service- oder Montagetermin

• einen Besuch beim Kunden oder Mitarbeiter

Dabei enthält der Auftrag alle Informationen, die für die Planung und spätere Durchführung relevant sind, unter anderem:

• Zielort (Location)

• erwartete Arbeitszeit

• optionale Zusatzinformationen für Fahrer oder Disposition

• optionale Anforderungen (z. B. Skills, Kapazitäten, Prioritäten)

---

Rolle des Auftrags im System

In DeDeFleet ist der Auftrag:

• nicht automatisch eine Tour

• nicht automatisch verplant

• nicht automatisch fahrbar

Ein Auftrag ist zunächst ein eigenständiges Planungselement, das:

• im System angelegt wird

• anschließend manuell oder automatisiert einer Tour zugewiesen werden kann

👉 Erst durch die Zuweisung zu einer Tour wird aus einem Auftrag ein konkreter Bestandteil einer geplanten Fahrt.

---

Warum ist die Location so wichtig?

Jeder Auftrag benötigt genau eine Location als Ziel.

Die Location definiert:

• wo der Auftrag ausgeführt wird

• welche Entfernung und Fahrzeit berücksichtigt wird

• welche Routen- und Optimierungslogik greift

Je nach Integrationsgrad kann diese Location:

• direkt über eine Adresse beschrieben werden

• auf bestehende Stammdaten (Location, Kunde, Mitarbeiter) verweisen

• über Koordinaten definiert sein

Die Art, wie die Location übergeben wird, bestimmt:

• ob neue Stammdaten angelegt werden

• ob bestehende Daten wiederverwendet werden

• wie tief die Integration in DeDeFleet erfolgt

👉 Genau an dieser Stelle entscheidet sich der weitere Integrationspfad.

---

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.

Wert	Bedeutung
0	id ist eine bekannte Location-Nummer in DeDeFleet
1	id ist eine bekannte Kundennummer in DeDeFleet
2	Location wird über Adressdaten definiert
3	Location wird über Koordinaten (Latitude/Longitude) definiert
4	id ist eine bekannte Mitarbeiternummer in DeDeFleet

Technische Umsetzung (API)

Endpoint

POST /orders

Vollständige URL

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

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

Variante B – Bestehende Location referenzieren (Advanced)

➡️ Für fortgeschrittene Integrationen

Eigenschaften

• Auftrag verweist auf eine bereits existierende Location oder einen Kunden

• Zentrale Pflege der Stammdaten

• Vermeidung von Dubletten

Typische location.type Werte

• 0 – bekannte Location

• 1 – bekannter Kunde

• 4 – bekannter Mitarbeiter

Beispiel: Auftrag mit referenzierter Location

{
  "type": 0,
  "order": "ORDER-10002",
  "location": {
    "type": 0,
    "id": "LOC-4711"
  }
}

Ergebnis im System

• ✔ Auftrag wird erstellt

• ✔ Bestehende Stammdaten werden verwendet

• ❌ Auftrag ist unverplant

Zusammenfassung Step 1

• ✔ Auftrag wird per API angelegt

• ✔ Location wird abhängig vom location.type interpretiert

• ✔ Auftrag ist im System sichtbar

• ✔ Auftrag ist nicht verplant

• ✔ Grundlage für die Tourenplanung ist geschaffen