Orders erin. Routes eruit.
Stuur opdrachten vanuit het systeem dat u toch al draait en krijg een gesequencede route terug, met uw eigen kenmerken intact. Drie endpoints, geen SDK nodig.
Drie aanroepen, en dat is het hele oppervlak
| Werkwoord | Pad | Doel |
|---|---|---|
| POST | /v1/integration-token | Client-gegevens inwisselen voor een bearer-token, één uur geldig |
| POST | /v1/integration-import | Een opdracht met stops importeren, de adressen geocoderen, de route optimaliseren en de chauffeur toewijzen — in één verzoek |
| GET | /v1/integration-jobs | Opdracht- en stopstatus: voortgangstellers, status per stop, de geoptimaliseerde volgorde |
Importeren, geocoderen, optimaliseren, toewijzen
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": []
}Uw kenmerken blijven behouden
Elk kenmerk dat u meestuurt, komt er weer uit — op de opdracht en op elke stop. U hoeft nooit een koppeltabel bij te houden tussen uw ordernummers en de onze.
| external_job_id | Uw eigen batchreferentie — komt terug op elke stop, dus u hoeft geen koppeltabel bij te houden |
| external_stop_id | Uw order- of zendingnummer, doorgegeven tot aan status en afronding |
| address | Eén adresregel; wordt bij import gegeocodeerd, mislukkingen komen terug als waarschuwingen |
| parcel_count | Wordt gebruikt voor aannames over lading en handling op de stop |
| duration_minutes | Servicetijd aan de deur — verbruikt in het model, niet weggeredeneerd |
| driver_email | Wijst de afgeronde route toe aan een chauffeur die al op het account staat |
Wat er gebeurt als er iets misgaat
Idempotente schrijfacties
Dezelfde external_job_id opnieuw importeren werkt de opdracht bij in plaats van een tweede aan te maken. Opnieuw proberen na een time-out is veilig.
Gedeeltelijk succes
Een stop die niet gegeocodeerd kan worden, komt terug in warnings[] terwijl de rest van de opdracht wordt geïmporteerd. Het verzoek faalt niet in zijn geheel omdat één adres fout is.
Versionering
De versie staat in het pad. Binnen een versie worden velden toegevoegd, maar nooit verwijderd of hergebruikt, dus een integratie die vandaag geschreven is, blijft werken.
Sandbox-sleutels zijn gratis
Bouw eerst tegen een sandbox voordat u zich ergens aan vastlegt. Vraag het ons en we sturen inloggegevens en een uitgewerkt voorbeeld op uw eigen datavorm.