Skip to main content

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

No comments to display

Back to top