Aufträge rein. Touren raus.
Übergeben Sie Aufträge aus dem System, das Sie ohnehin betreiben, und erhalten Sie eine sequenzierte Tour zurück — mit Ihren eigenen Kennungen intakt. Drei Endpunkte, kein SDK nötig.
Drei Aufrufe, und das ist die ganze Fläche
| Verb | Pfad | Zweck |
|---|---|---|
| POST | /v1/integration-token | Client-Zugangsdaten gegen ein Bearer-Token tauschen, eine Stunde gültig |
| POST | /v1/integration-import | Einen Auftrag mit seinen Stopps importieren, die Adressen geocodieren, die Tour optimieren und den Fahrer zuweisen — in einer Anfrage |
| GET | /v1/integration-jobs | Auftrags- und Stoppstatus: Fortschrittszahlen, Zustand je Stopp, die optimierte Reihenfolge |
Importieren, geocodieren, optimieren, zuweisen
POST /v1/integration-import HTTP/1.1
Authorization: Bearer {token}
Content-Type: application/json
{
"external_job_id": "WMS-2026-07-30-A",
"driver_email": "driver@fleet.com.au",
"optimize": true,
"stops": [
{ "external_stop_id": "SO-88214",
"address": "3/216 Brunswick St, Fitzroy VIC 3065",
"parcel_count": 2,
"duration_minutes": 4 }
]
}{
"job_id": "job_7Yq2c",
"external_job_id": "WMS-2026-07-30-A",
"assigned_to": "driver@fleet.com.au",
"optimized": true,
"stops_imported": 142,
"stops": [
{ "external_stop_id": "SO-88214",
"stop_id": "stp_9f2",
"sequence": 38,
"status": "pending" }
],
"warnings": []
}Ihre Kennungen bleiben erhalten
Jede Kennung, die Sie senden, kommt auf dem Rückweg wieder — am Auftrag und an jedem Stopp. Sie müssen nie eine Zuordnungstabelle zwischen Ihren Auftragsnummern und unseren führen.
| external_job_id | Ihre eigene Sammelreferenz — kommt an jedem Stopp zurück, sodass Sie keine Zuordnungstabelle führen müssen |
| external_stop_id | Ihre Auftrags- oder Sendungsnummer, durchgereicht bis zu Status und Abschluss |
| address | Eine einzelne Adresszeile; wird beim Import geocodiert, Fehlschläge kommen als Warnungen zurück |
| parcel_count | Wird für Lade- und Handhabungsannahmen am Stopp verwendet |
| duration_minutes | Servicezeit an der Tür — im Modell verbraucht, nicht wegdefiniert |
| driver_email | Weist die fertige Tour einem Fahrer zu, der bereits im Konto ist |
Was passiert, wenn etwas schiefgeht
Idempotente Schreibvorgänge
Ein erneuter Import derselben external_job_id aktualisiert den Auftrag, statt einen zweiten anzulegen. Ein Wiederholungsversuch nach einem Timeout ist unbedenklich.
Teilerfolg
Ein Stopp, der sich nicht geocodieren lässt, kommt in warnings[] zurück, während der Rest des Auftrags importiert wird. Die Anfrage schlägt nicht komplett fehl, weil eine Adresse fehlerhaft ist.
Versionierung
Die Version steht im Pfad. Innerhalb einer Version werden Felder ergänzt, aber nie entfernt oder umgewidmet — eine heute geschriebene Integration liest also weiter korrekt.
Sandbox-Schlüssel sind kostenlos
Entwickeln Sie gegen eine Sandbox, bevor Sie sich festlegen. Fragen Sie an, und wir schicken Zugangsdaten und ein durchgerechnetes Beispiel für Ihr eigenes Datenformat.