Download OpenAPI specification:
API for external companies to submit tour plans containing orders. Delivery times use the Europe/Berlin timezone, including daylight saving time.
Submit a tour plan and its associated orders as JSON.
| tourplan_nr required | string Tour plan identifier. |
required | Array of objects (Order) non-empty Orders associated with the tour plan. |
{- "tourplan_nr": "31288",
- "auftraege": [
- {
- "auftrags_nr": "615964",
- "konto": "14188",
- "kunde_bez": "Balk / Heise NEU",
- "adresse": "Friedensallee",
- "hausnummer": "2",
- "plz": "15834",
- "ort": "Rangsdorf",
- "auftrag_gewicht": 245.9,
- "abladedauer": "20",
- "fahrzeugpraeferenz": "1,2,3,4,5",
- "zustellbemerkung": "",
- "typ": "Lieferauftrag",
- "lieferdatum": "2026-09-15",
- "prioritaet": 100,
- "anlieferzeit_start": "08:00:00",
- "anlieferzeit_ende": "12:00:00"
}
]
}{- "tourplan_nr": "31288",
- "anzahl_auftraege": 1,
}Returns the saved routes, including manual changes, for a tour plan belonging to the authenticated company. Values that are unavailable or no longer valid after manual changes are returned as null. Timings, distances, and geometry describe the current route only when they have been calculated for that route.
| tourplan_nr required | string Example: 31288 |
{- "tourplan_nr": "31288",
- "unternehmen_id": "0e05e017-bfb7-486b-ba7b-650f5187dbd8",
- "datum": "2019-08-24",
- "erstellt_am": "2019-08-24T14:15:22Z",
- "status": "berechnet",
- "routen": [
- {
- "strecke_meter": 0,
- "fahrzeit_sekunden": 0,
- "fahrer": {
- "id": 0,
- "name": "string"
}, - "fahrzeug": {
- "id": 0,
- "name": "string",
- "kennzeichen": "string"
}, - "geometrie": "string",
- "schritte": [
- {
- "typ": "start",
- "reihenfolge": 1,
- "ankunftszeit": "2026-09-15T08:30:00+02:00",
- "abfahrtszeit": "2026-09-15T08:50:00+02:00",
- "servicezeit_sekunden": 0,
- "wartezeit_sekunden": 0,
- "position": {
- "breitengrad": -90,
- "laengengrad": -180
}, - "anschrift": {
- "adresse": "string",
- "hausnummer": "string",
- "ort": "string",
- "plz": "string"
}, - "auftraege": [
- {
- "auftrags_nr": "615964",
- "konto": "14188",
- "kunde_bez": "Balk / Heise NEU",
- "adresse": "Friedensallee",
- "hausnummer": "2",
- "plz": "15834",
- "ort": "Rangsdorf",
- "auftrag_gewicht": 245.9,
- "abladedauer": "20",
- "fahrzeugpraeferenz": "1,2,3,4,5",
- "zustellbemerkung": "",
- "typ": "Lieferauftrag",
- "lieferdatum": "2026-09-15",
- "prioritaet": 100,
- "anlieferzeit_start": "08:00:00",
- "anlieferzeit_ende": "12:00:00"
}
]
}
]
}
], - "nicht_zugewiesene_auftraege": [
- {
- "auftrag": {
- "auftrags_nr": "615964",
- "konto": "14188",
- "kunde_bez": "Balk / Heise NEU",
- "adresse": "Friedensallee",
- "hausnummer": "2",
- "plz": "15834",
- "ort": "Rangsdorf",
- "auftrag_gewicht": 245.9,
- "abladedauer": "20",
- "fahrzeugpraeferenz": "1,2,3,4,5",
- "zustellbemerkung": "",
- "typ": "Lieferauftrag",
- "lieferdatum": "2026-09-15",
- "prioritaet": 100,
- "anlieferzeit_start": "08:00:00",
- "anlieferzeit_ende": "12:00:00"
}, - "grund": "string"
}
]
}