Flotten-Compliance — Validate API Online
Prüft die aufgezeichneten Tätigkeiten eines Fahrers anhand der Lenk- und Ruhezeitvorschriften der Verordnung EU 561/2006 (oder des AETR) sowie der Arbeitszeitrichtlinie 2002/15/EG. Senden Sie die Zeitleiste als JSON-POST-Body – die aktuelle Schicht plus bis zu 28 Tage oder mehr an fahrtenschreiberähnlicher Historie – und erhalten Sie alle Verstöße mit Rechtsgrundlage (Artikel), Zeitstempel und Schweregrad (Stufen der Verordnung (EU) 2016/403), Warnungen sowie das, was dem Fahrer jetzt noch bleibt: tägliche Lenkzeit sowie die Budgets für 56 h pro Woche und 90 h pro Doppelwoche, Zeitpunkt der nächsten fälligen Pause, täglichen Ruhezeit und wöchentlichen Ruhezeit, genutzte verlängerte Tage und verkürzte Ruhezeiten sowie einen etwaigen Ausgleich für verkürzte wöchentliche Ruhezeiten samt Frist. Abgedeckt sind 4-h-30-Pausen (inkl. Aufteilung 15 + 30), 9/10-h-Tage, tägliche Ruhezeiten von 11/9 h und 3 + 9 h, sechs 24-Stunden-Zeiträume zwischen wöchentlichen Ruhezeiten, Abfolgen verkürzter wöchentlicher Ruhezeiten und Ausgleich, Mehrfahrerbetrieb (9 h Ruhezeit innerhalb von 30 h), unterbrochene Ruhezeit bei Fähre/Zug sowie bei 2002/15 der 48-h-Durchschnitt, die 60-h-Woche, Pausen nach 6 h und die 10-h-Obergrenze bei Nachtarbeit. Seit v1.1: die Ausnahme nach Art. 12 (bis zu 1 h, bzw. 2 h nach einer 30-min-Pause, über die täglichen und wöchentlichen Grenzen hinaus, um den Betriebsort oder den Wohnort für eine wöchentliche Ruhezeit zu erreichen) mit dem fälligen Ausgleich und dessen Frist, die 4-Wochen-Rückkehr zum Betriebssitz oder nach Hause nach Art. 8(8a), die 12-Tage-Abweichung nach Art. 8(6a) für gelegentliche grenzüberschreitende Personenbeförderung im Omnibusverkehr sowie nationale Nachtzeitfenster nach 2002/15 je Land. route_plan_state kann direkt an route-plan übergeben werden.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/validate
— Kontingentklasse: heavy
| Parameter | Beschreibung |
|---|---|
activities | (JSON-Body, erforderlich) Fahreraktivitäten, entweder mit der ältesten zuerst oder in beliebiger Reihenfolge. Jede Aktivität: {type: drive | other_work | availability | break | rest, start, end} – ISO-8601 (ein Datum mit Uhrzeit ohne Offset wird in tz interpretiert) oder Unix-Sekunden. Optional bei Ruhezeiten: 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 Lenkzeiten: art12_exceed (true = Fahren über das Limit hinaus gemäß EU 561 Art. 12, um für eine wöchentliche Ruhezeit den Betriebssitz oder den Wohnort zu erreichen). Lücken zwischen Aktivitäten gelten als Ruhezeit (werden in warnings gemeldet); Überschneidungen werden abgelehnt. |
history | (JSON-Body) Ältere Tätigkeiten im gleichen Format (z. B. die letzten 28 Tage aus dem Tachographen); wird mit activities zusammengeführt. |
tz | (JSON-Body) IANA-Zeitzone für Kalenderwochen (Montag 00:00) und das Nachtfenster, Standard UTC. |
ruleset | (JSON-Body) eu561 (Standard) oder aetr. limits listet die angewendeten Abweichungen des AETR auf. |
crew | (JSON-Body) single (Standard) oder double (Mehrfahrerbetrieb). |
now | (JSON-Body) Auswertungszeitpunkt, Standard ist das Ende der letzten Tätigkeit; Zeit nach der letzten Tätigkeit zählt als Ruhezeit. |
last_weekly_rest_end | (JSON-Body) Ende der letzten wöchentlichen Ruhezeit vor der Zeitleiste, wenn die Zeitleiste sie nicht enthält. |
international_goods | (JSON-Body, eu561) true = der Fahrer befindet sich im internationalen Güterverkehr außerhalb des Niederlassungsmitgliedstaats (zwei aufeinanderfolgende verkürzte wöchentliche Ruhezeiten nach Art. 8(6) zulässig). |
passenger_12day | (JSON-Body) true oder {abroad_24h: bool} = einzelner gelegentlicher internationaler Personenverkehrsdienst: Die wöchentliche Ruhezeit darf nach einer regelmäßigen wöchentlichen Ruhezeit um bis zu zwölf 24-Stunden-Zeiträume verschoben werden (EU 561 Art. 8(6a), AETR Art. 8(6)(b)); geprüft werden die darauf folgenden Ruhezeiten und das Fahren bei Nacht (22:00-06:00: Mehrfachbesatzung oder eine Lenkzeit von 3 h). |
country | (JSON-Body) ISO-Ländercode für das nationale Nachtzeitfenster gemäß 2002/15 (identisch mit wtd.country). |
include_wtd | (JSON-Body) false = Prüfungen nach Richtlinie 2002/15/EG überspringen (Standard true). |
wtd | (JSON-Body) Optionen für 2002/15: reference_weeks 1-52 (Standard 17), reference_mode rolling | fixed, reference_start, night_window HH:MM-HH:MM (Standard 00:00-04:00), country (ISO-Code eines EU/EWR-Landes: nationales Nachtzeitfenster, siehe Limits), carriage goods | passengers. |
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.compliant | true, wenn kein Verstoß gefunden wurde; violation_count und by_severity (most_serious, very_serious, serious, minor) zählen sie. |
data.violations[] | code, ref (Regelartikel, z. B. "EU 561/2006 Art. 7"), severity, at (wann der Grenzwert überschritten wurde), value_min / limit_min / excess_min, period_start oder week_start, open (zum Auswertungszeitpunkt noch andauernd), message. Einträge nach 2002/15 enthalten banded=false. |
data.warnings[] | Dinge, bei denen gehandelt werden sollte, die aber noch keine Verstöße sind: code, message, optional ref und at (z. B. extended_day_in_use, weekly_drive_almost_used, history_short, gaps_counted_as_rest, four_week_rule_pending). |
data.remaining.driving | drive_left_now_min (der kleinste der Tages-, Wochen- und Zweiwochenwerte), daily_drive_left_min, weekly_drive_left_min, fortnight_drive_left_min, next_break (due_after_drive_min, required_min, split_first_part_taken), next_daily_rest (regular_latest_start, reduced_latest_start, min_duration_min, overdue), next_weekly_rest (latest_start, periods_used, min_duration_min, reduced_allowed), extended_days_used_this_week, reduced_daily_rests_used, reduced_weekly_rest_compensation[] (owed_min, deadline, basis), compensation_owed_min, art12_compensation[] (extension_start, owed_min, deadline, how), art12_compensation_owed_min, next_weekly_rest.passenger_12day_latest_start. |
data.remaining.working_time | 2002/15: week_work_left_min, worked_this_week_min, reference_period (average, budget_left_min), shift (work_min, breaks_min, next_break_due_after_work_min, night_work_in_shift, shift_work_left_min). |
data.route_plan_state | Fahrerzustand in den Parameternamen von route-plan (driven_since_break_min, driven_today_min, duty_started_min_ago, driven_week_min, driven_fortnight_min, extended_days_used, reduced_rests_used). |
data.duty_periods[] | Jede Dienstperiode zwischen täglichen/wöchentlichen Ruhezeiten: start, end, drive_min, extended, rest_type, rest_start, rest_end, rest_min (+ ferry_interruptions). |
data.weekly_rests[] | Gefundene wöchentliche Ruhezeiten: start, end, duration_min, type regular | reduced, periods_since_previous, compensation_owed_min, derogation. |
data.weeks | Pro Kalenderwoche: driving.drive_min und working_time.work_min, mit complete. |
data.rolling | Nur zur Information: die meiste Lenkzeit in einem beliebigen 168-h- und 336-h-Fenster (die rechtliche Prüfung verwendet Kalenderwochen). |
data.assumptions[] | Wie unvollständige Eingaben interpretiert wurden (z. B. keine wöchentliche Ruhezeit vor der bekannten Zeitleiste). |
data.exceptions | art12[]: jede Inanspruchnahme der Ausnahme nach EU 561 Art. 12 — start, end, flagged_drive_min, max_extra_min, break_before_min, following_rest, status (accepted | pending_weekly_rest | conditions_not_met | not_needed), daily_excess_min, weekly_excess_min, compensation_owed_min, compensation_deadline, compensated_at. passenger_12day[]: from, weekly_rest_start, periods_24h, max_periods_24h. |
data.weekly_rests[].location | Der für diese Ruhezeit übermittelte Standort (residence | operational_centre | elsewhere). |
data.wtd.params | night_window, night_window_source (param | country:CC | country_unverified:CC | default), night_window_verified, night_window_ref (nationale Quelle). |
curl -X POST "https://nakordoni.eu/api/v2/data/fleet/compliance/validate" \
-H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX" \
-H "Content-Type: application/json" \
-d '{
"tz": "Europe/Warsaw",
"ruleset": "eu561",
"crew": "single",
"activities": [
{
"type": "rest",
"start": "2026-10-19T19:00:00",
"end": "2026-10-20T06:00:00"
},
{
"type": "other_work",
"start": "2026-10-20T06:00:00",
"end": "2026-10-20T06:20:00"
},
{
"type": "drive",
"start": "2026-10-20T06:20:00",
"end": "2026-10-20T10:50:00"
},
{
"type": "break",
"start": "2026-10-20T10:50:00",
"end": "2026-10-20T11:35:00"
},
{
"type": "drive",
"start": "2026-10-20T11:35:00",
"end": "2026-10-20T14:00:00"
}
]
}'
Aktualisiert