Flotten-Compliance — Plan Check API Online
Prüft geplante Schichten oder Fahrtage vor der Disposition. Senden Sie die Schichten und die Länder, in denen sie stattfinden, als JSON-POST-Body; für jede Schicht werden die betroffenen Lkw-Fahrverbote zurückgegeben (Wochenend-, Sonntags-, Feiertags- und weitere Verbote aus unserem Lkw-Fahrverbotskalender, gefiltert nach Fahrzeuggewicht), die berührten gesetzlichen Feiertage und Wochenendtage, die Verstöße gegen EU 561 / AETR und 2002/15, die der Plan verursachen würde, sowie der früheste zulässige Start: nach der erforderlichen täglichen oder wöchentlichen Ruhezeit und außerhalb aller blockierenden Verbote.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/plan-check
— Kontingentklasse: heavy
| Parameter | Beschreibung |
|---|---|
shifts | (JSON-Body, erforderlich, max. 60, Zeitspanne max. 62 Tage) [{start, end, countries?, drive_min?, other_work_min?, activities?}]. Ohne activities wird die Schicht so aufgebaut: zuerst andere Arbeit, dann Lenken in Blöcken von 4 h 30 mit 45 min Pausen. Jede Aktivität: {type: drive | other_work | availability | break | rest, start, end} – ISO-8601 (ein Datum mit Uhrzeit ohne Offset wird in tz gelesen) oder Unix-Sekunden. Optional bei rests: ferry (true auf einer Fähre oder einem Zug), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere – Rückkehrprüfung nach 4 Wochen gemäß EU 561 Art. 8(8a)). Optional bei drives: art12_exceed (true = Lenken über das Limit hinaus gemäß EU 561 Art. 12, um das Betriebszentrum oder den Wohnort für eine wöchentliche Ruhezeit zu erreichen). Lücken zwischen Aktivitäten zählen als Ruhezeit (in warnings gemeldet); Überschneidungen werden abgelehnt. |
countries | (JSON-Body) ISO-Ländercodes für Schichten, die keine eigenen angeben, z. B. ["DE","AT"]. |
tz | (JSON-Body) IANA-Zeitzone des Plans (Datum mit Uhrzeit ohne Offset), Standard UTC. Verbotsfenster verwenden die jeweilige Zeitzone des Landes. |
weight_t | (JSON-Body) Fahrzeuggewicht in Tonnen; Verbote mit einer Gewichtsschwelle gleich oder über diesem Wert werden übersprungen. Weggelassen = alle Verbote werden berücksichtigt. |
history | (JSON-Body) Letzte Tätigkeiten vor dem Plan (Format wie bei validate), damit Ruhezeiten und Budgets übernommen werden. |
last_weekly_rest_end | (JSON-Body) Ende der letzten wöchentlichen Ruhezeit vor dem Plan. |
ruleset | (JSON-Body) eu561 (Standard) oder aetr. crew single | double. international_goods, include_wtd, wtd wie bei validate. |
allow_reduced_daily_rest | (JSON-Body) true = Vorschläge dürfen eine verkürzte tägliche Ruhezeit von 9 h verwenden (Standard: 11 h). |
allow_reduced_weekly_rest | (JSON-Body) true = Vorschläge dürfen eine verkürzte wöchentliche Ruhezeit von 24 h verwenden (Standard: 45 h). |
blocking_types | (JSON-Body) Verbotsarten, die einen vorgeschlagenen Start verschieben (Standard Sunday, Saturday, Holiday, Holiday Eve, General; nur landesweite Verbote). Andere werden weiterhin markiert. |
Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.
| Feld | Beschreibung |
|---|---|
data.shifts[] | Pro Schicht: index, start, end, countries, duration_min, flags[], violations[], suggested_start, suggested_end, delay_min, delay_reasons[] (daily_rest, weekly_rest, truck_ban:<CC>:<type>). |
data.shifts[].flags[] | type truck_ban (country, date, restriction_type, from, until, scope, details, min_weight_t, blocking, overlap_min), public_holiday (country, date, names, truck_ban_recorded) oder weekend (country, date, day). |
data.violations[] | Jeder Verstoß des Plans gegen EU 561 / AETR / 2002/15, im Format von validate. |
data.remaining_after_plan | Lenkzeitbudgets und nächste Ruhezeiten nach der letzten geplanten Schicht (validate remaining.driving). |
data.summary | shift_count, shifts_flagged, shifts_moved, violation_count, ban_windows_considered, countries, ruleset, crew. |
data.warnings[] | z. B. shift_layout_overflows, holidays_unavailable; data.assumptions[] gibt an, wie fehlende Eingaben interpretiert wurden. |
curl -X POST "https://nakordoni.eu/api/v2/data/fleet/compliance/plan-check" \
-H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX" \
-H "Content-Type: application/json" \
-d '{
"countries": [
"DE"
],
"tz": "Europe/Berlin",
"weight_t": 40,
"shifts": [
{
"start": "2026-11-07T06:00:00",
"end": "2026-11-07T16:45:00"
},
{
"start": "2026-11-08T06:00:00",
"end": "2026-11-08T15:00:00"
}
]
}'
Aktualisiert