1. Auftragsdetails

Grundidee

Auftragsdetails ergänzen einen Auftrag um fachliche Informationen, die für:

die Disposition
die Ausführung durch den Fahrer
und die Rückmeldung ins Quellsystem

relevant sind.

Während Felder wie order, location oder tourGuid primär für die technische Planung benötigt werden, beschreiben Auftragsdetails den inhaltlichen Kontext des Auftrags.

Typische Auftragsdetails

Zu den wichtigsten Auftragsdetails gehören insbesondere:

plannedDeliveryDate
workTime
driverMessage
visitTimeWindows
contact
phone

`plannedDeliveryDate`

Beschreibt das geplante Liefer- bzw. Ausführungsdatum des Auftrags.

Typische Verwendung:

fachliche Einordnung des Auftrags
Tageszuordnung in der Planung
Filterung und Synchronisation in externe Systeme

Beispiel

"plannedDeliveryDate": "2026-02-02"

`workTime`

Beschreibt die geplante Zeit vor Ort bzw. die erwartete Belade-/Entlade- oder Servicezeit.

Diese Zeit wird bei der Planung berücksichtigt und beeinflusst die zeitliche Struktur der Tour.

Typische Verwendung:

Beladezeit
Entladezeit
Service-/Montagezeit
Aufenthaltsdauer beim Kunden

Beispiel

"workTime": 20

Hinweis: Die Einheit und Interpretation sollten innerhalb der Integration einheitlich verwendet werden.

`driverMessage`

Freitextfeld für fahrerrelevante Informationen.

Dieses Feld ist besonders wichtig, da hier sehr viele auftragsbezogene Hinweise für die Ausführung mitgegeben werden können.

Mögliche Inhalte:

Anlieferhinweise
Tor-/Rampennummern
Zusatzinformationen zum Kunden
interne Hinweise
strukturierte Inhalte

Wichtiger Hinweis:
👉 Das Feld unterstützt HTML.
Dadurch können Inhalte formatiert werden, z. B.:

Hervorhebungen
Absätze
Tabellen
Bilder
strukturierte Hinweise

Beispiel

"driverMessage": "<b>Rampe 2</b><br>Bitte zuerst beim Pförtner melden.<br><table><tr><td>Code</td><td>4711</td></tr></table>"

Empfehlung: Dieses Feld gezielt für fahrerrelevante Inhalte nutzen und nicht mit rein technischen Informationen überladen.

`visitTimeWindows`

Definiert zulässige Zeitfenster für die Durchführung des Auftrags.

Diese Zeitfenster können bei der Tourenplanung und Optimierung berücksichtigt werden und geben vor, wann ein Auftrag besucht oder beliefert werden darf.

Beispiel

"visitTimeWindows": [
{
"day": 1,
"startTime": "08:00",
"endTime": "12:00"
}
]

Typische Verwendung:

Kunden dürfen nur vormittags angefahren werden
Anlieferung nur innerhalb definierter Slots
Abbildung von Öffnungszeiten oder Anmeldezeiten

`contact`

Name des Ansprechpartners zum Auftrag.

Dieses Feld ist insbesondere für Fahrer und Disposition relevant, wenn vor Ort ein konkreter Ansprechpartner vorhanden ist.

Beispiel

"contact": "Max Müller"

`phone`

Telefonnummer des Ansprechpartners.

Typische Verwendung:

Rückfragen bei Anlieferung
Abstimmung bei Verzögerungen
Kontaktaufnahme im Ausführungsfall

Beispiel

"phone": "+49 5551 12345"

Beispiel: Auftrag mit erweiterten Auftragsdetails

{
"order": "ORDER-10001",
"plannedDeliveryDate": "2026-02-02",
"workTime": 20,
"driverMessage": "<b>Rampe 2</b><br>Bitte zuerst beim Pförtner melden.",
"visitTimeWindows": [
{
"day": 1,
"startTime": "08:00",
"endTime": "12:00"
}
],
"contact": "Max Müller",
"phone": "+49 5551 12345"
}

Bedeutung für Integrationen

Diese Felder sind besonders wichtig, wenn:

Aufträge fachlich vollständig aus einem ERP/TMS übernommen werden sollen
Fahrer in der App mehr als nur Adresse und Reihenfolge sehen sollen
Planungslogik durch Zeitfenster und Aufenthaltszeiten verbessert werden soll
Ansprechpartner und Hinweise direkt am Auftrag verfügbar sein sollen