Shoda vozového parku — Validate API Online
Zkontrolujte zaznamenanou činnost řidiče podle pravidel řízení a odpočinku EU 561/2006 (nebo AETR) a pracovní doby podle směrnice 2002/15/ES. Časovou osu odešlete jako tělo požadavku JSON POST – aktuální směnu plus historii podobnou tachografu za 28 dní nebo více – a získáte všechna porušení s článkem pravidla, časovým razítkem a závažností (pásma podle nařízení (EU) 2016/403), varování a to, co řidiči zbývá právě teď: denní řízení, týdenní budget 56 h a dvoutýdenní 90 h, kdy je třeba další přestávka, denní odpočinek a týdenní odpočinek, využité prodloužené dny a zkrácené odpočinky a případnou náhradu za zkrácený týdenní odpočinek s termínem. Pokrývá přestávky 4 h 30 (vč. dělení 15 + 30), dny 9/10 h, denní odpočinek 11/9 h a 3 + 9 h, šest 24hodinových období mezi týdenními odpočinky, sekvence zkrácených týdenních odpočinků a náhrady, dvojí osádku (9 h odpočinku do 30 h), přerušený odpočinek na trajektu/vlaku a podle 2002/15 průměr 48 h, 60h týden, přestávky po 6 h a limit 10 h noční práce. Od v1.1: výjimka podle čl. 12 (do 1 h, nebo 2 h po 30min přestávce, nad denní a týdenní limity k dosažení provozního střediska nebo domova na týdenní odpočinek) s náhradou a jejím termínem, 4týdenní návrat na základnu nebo domů podle čl. 8 odst. 8a, 12denní odchylka podle čl. 8 odst. 6a pro příležitostné mezinárodní autobusové služby a národní noční okna 2002/15 podle zemí. route_plan_state lze předat přímo do route-plan.
POST https://nakordoni.eu/api/v2/data/fleet/compliance/validate
— třída kvóty: heavy
| Parametr | Popis |
|---|---|
activities | (tělo JSON, povinné) Činnosti řidiče, od nejstarší, nebo v libovolném pořadí. Každá činnost: {type: drive | other_work | availability | break | rest, start, end} — ISO-8601 (datum a čas bez posunu se čte v tz) nebo unixové sekundy. Volitelné u odpočinků: ferry (true na trajektu nebo ve vlaku), sleeper_cabin, scheduled_journey_h, in_vehicle, location (residence | operational_centre | elsewhere — kontrola návratu každé 4 týdny podle EU 561 Art. 8(8a)). Volitelné u jízd: art12_exceed (true = jízda přes limit podle EU 561 Art. 12 za účelem dojetí do provozního střediska nebo domů na týdenní odpočinek). Mezery mezi činnostmi se počítají jako odpočinek (hlášeno ve warnings); překryvy se odmítají. |
history | (JSON tělo) Starší aktivity ve stejném formátu (např. posledních 28 dní z tachografu); sloučí se s activities. |
tz | (JSON tělo) Časové pásmo IANA pro kalendářní týdny (pondělí 00:00) a noční okno, výchozí UTC. |
ruleset | (JSON tělo) eu561 (výchozí) nebo aetr. limits uvádí rozdíly AETR, které se uplatňují. |
crew | (JSON tělo) single (výchozí) nebo double (vícečlenná osádka). |
now | (JSON tělo) Čas vyhodnocení, výchozí konec poslední aktivity; čas po poslední aktivitě se počítá jako odpočinek. |
last_weekly_rest_end | (JSON tělo) Konec posledního týdenního odpočinku před časovou osou, pokud jej časová osa neobsahuje. |
international_goods | (JSON tělo, eu561) true = řidič je v mezinárodní nákladní dopravě mimo členský stát usazení (podle čl. 8 odst. 6 jsou povoleny dva po sobě jdoucí zkrácené týdenní odpočinky). |
passenger_12day | (tělo JSON) true nebo {abroad_24h: bool} = jednorázová příležitostná mezinárodní osobní doprava: týdenní odpočinek lze odložit až o dvanáct 24hodinových období po pravidelném týdenním odpočinku (EU 561 Art. 8(6a), AETR Art. 8(6)(b)); kontrolují se odpočinky po něm a noční jízda (22:00-06:00: více řidičů v osádce nebo 3h doba řízení). |
country | (JSON tělo) ISO kód země pro vnitrostátní noční okno podle 2002/15 (stejný jako wtd.country). |
include_wtd | (JSON tělo) false = přeskočit kontroly podle směrnice 2002/15/ES (výchozí true). |
wtd | (JSON tělo) Možnosti 2002/15: reference_weeks 1-52 (výchozí 17), reference_mode rolling | fixed, reference_start, night_window HH:MM-HH:MM (výchozí 00:00-04:00), country (ISO kód země EU/EHP: vnitrostátní noční okno, viz limity), carriage goods | passengers. |
Pole odpovědi — uvnitř objektu data v obálce odpovědi. [] označuje seznam, takže data.items[].name je pole name každého prvku. Pole bývá null, chybí nebo je prázdný seznam, když pro něj nemáme hodnotu — zástupný údaj nedoplňujeme.
| Pole | Popis |
|---|---|
data.compliant | true, když nebylo nalezeno žádné porušení; violation_count a by_severity (most_serious, very_serious, serious, minor) je počítají. |
data.violations[] | code, ref (článek pravidla, např. "EU 561/2006 Art. 7"), severity, at (kdy byl limit překročen), value_min / limit_min / excess_min, period_start nebo week_start, open (stále probíhá v okamžiku vyhodnocení), message. Záznamy 2002/15 mají banded=false. |
data.warnings[] | Věci, na které je třeba reagovat a které ještě nejsou porušením: code, message, volitelné ref a at (např. 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 (nejmenší z denního, týdenního a dvoutýdenního limitu), 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 | Stav řidiče v názvech parametrů 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[] | Každé pracovní období mezi denními/týdenními odpočinky: start, end, drive_min, extended, rest_type, rest_start, rest_end, rest_min (+ ferry_interruptions). |
data.weekly_rests[] | Nalezené týdenní odpočinky: start, end, duration_min, type regular | reduced, periods_since_previous, compensation_owed_min, derogation. |
data.weeks | Za každý kalendářní týden: driving.drive_min a working_time.work_min, s complete. |
data.rolling | Pouze informativně: nejdelší řízení v kterémkoli okně 168 h a 336 h (zákonný test používá kalendářní týdny). |
data.assumptions[] | Jak byl interpretován neúplný vstup (např. žádný týdenní odpočinek před známou časovou osou). |
data.exceptions | art12[]: každé využití výjimky podle 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 | Poloha odeslaná u tohoto odpočinku (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 (národní zdroj). |
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"
}
]
}'
Aktualizováno